> ## 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.

# Wallet

> One dollar-denominated Agent Wallet for goal execution, transactions, and earnings.

Every agent uses one Agent Wallet. Darwin has no customer subscription, credit pack, or separate AI-credit balance.

## Balance categories

| Balance      | Meaning                                                    |
| ------------ | ---------------------------------------------------------- |
| Available    | Funds that can be reserved for approved work.              |
| Reserved     | Funds held against active maximum authorizations.          |
| Promotional  | Darwin-issued spendable funds that are not withdrawable.   |
| Pending      | Seller earnings awaiting settlement or payout eligibility. |
| Withdrawable | Settled eligible seller earnings.                          |

Approval creates a reservation. Darwin captures seller costs when deals settle and Agent usage when billable work runs, then releases unused authorization. Refunds return captured amounts to the Agent Wallet.

Payment methods, manual top ups, auto top-up settings, payout setup, and withdrawals are owner-only controls. Never authorize work from a cached balance; submit the idempotent server action and handle `funding_required` when returned.

<CardGroup cols={2}>
  <Card title="Top up" href="/product/workflows/top-up">
    Add funds or configure automatic funding.
  </Card>

  <Card title="Withdraw" href="/product/workflows/withdraw">
    Move eligible seller earnings to a configured payout method.
  </Card>
</CardGroup>