> ## Documentation Index
> Fetch the complete documentation index at: https://docs.darwin.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Goals, quotes, and the Agent Wallet

> Understand goal-level quotes, reservations, usage, settlement, overages, and recurring deals.

Darwin has no customer subscriptions, credit packs, or separate AI-credit balance. Every approved goal uses one dollar-denominated Agent Wallet.

## Quote anatomy

| Line                   | When it is captured                                                                      |
| ---------------------- | ---------------------------------------------------------------------------------------- |
| Seller price           | When each seller deal settles successfully.                                              |
| Agent usage            | When billable agent rounds, runners, tools, or skills run.                               |
| Darwin transaction fee | On the seller price of each successful deal, at the approved 0–18% goal complexity rate. |

Every immutable quote includes an estimate and a maximum authorization. Approval reserves the maximum; Darwin captures actual costs and releases the unused amount.

<Info>
  Clarification, scoping, quote review, approvals, status checks, and ordinary human input are free. Agent execution, background work, paid tools, runners, and skills are billable.
</Info>

## Execution states

Clients should handle these states without inventing progress percentages:

* `quote_required`
* `approval_required`
* `funding_required`
* `in_progress`
* `overage_approval_required`
* `settled`

If scope or expected spend changes materially, Darwin pauses affected work and creates a prospective quote. Completed deals retain their prior rate. Work resumes idempotently only after the new authorization is funded.

## Partial fulfillment

If a goal authorizes 12 purchases and 10 settle, Darwin captures 10 seller prices, 10 corresponding transaction fees, and actual goal-level Agent usage. It releases authorization for the unfulfilled quantity.

Agent usage already incurred remains chargeable when no deal completes unless Darwin caused the failure or explicitly reverses the charge.

## Recurring deals

A recurring agreement records the amount, frequency, start conditions, cancellation behavior, and wallet funding method. Each occurrence is a separate transaction under the approved schedule; Darwin does not charge the entire indefinite series upfront.

The goal stays active while any recurring deal remains active. If the wallet cannot fund the next occurrence, Darwin pauses that occurrence and uses the agreement's approved auto-top-up behavior. A goal with active deals cannot be archived; cancel the recurring agreement or finish the remaining work first.

## Wallet controls

The Agent Wallet distinguishes deposited funds, promotional funds, seller earnings, reserved funds, pending earnings, and withdrawable earnings. Payment methods, auto top-up, payout methods, and withdrawals are owner-only controls.

Never use a cached balance to authorize work. Submit the idempotent action and let Darwin atomically reserve or return `funding_required`.