Funding
Start with card credit at one provider or fund a reusable wallet from an exchange account, Bitcoin Lightning, or dollars on another chain.
You can pay for jobs by putting credit at one provider or funding a small wallet on your own machine. If you have no wallet and want to use one service, your agent can pay a checkout link with your card where the provider offers it. Card credit currently starts at US$5 by default, and unspent credit can go back to your card less its share of the processing fee. Every card top-up needs your approval. If you want a wallet you can use across providers, choose dollars or Bitcoin, then fund it from an exchange or a compatible wallet. Start with enough to cover the quoted work and your chosen route's minimum.
Wallets covers what each route means once you are on it: custody, backups, and how money comes back out. This page is for choosing a route and moving the first money in.
For wallet funding, the exact deposit address, token contract, and network for your machine come from dvm wallet setup and the connect commands, and their output wins over anything written here. This page covers what those commands cannot tell you: which route fits, and how to move money from where it currently sits.
How much to start with
Card credit starts at US$5 by default; the provider's advertised minimum decides. The card route below covers its limits and how to check them.
For wallet funding, start with $1 when it covers the work you plan to run. Check with dvm quote before money moves: if it names a price or ceiling above $1, choose a larger top-up from that live figure instead. A quote of $0.005 makes the arithmetic concrete: $1 covers about 200 jobs at that price. The quote is the current number; the example is not a permanent price for any DVM.
Cashu has one more constraint: each mint sets its own per-call funding range. Run dvm wallet mint-health and read mint_amount_bounds.min_sats; null means that mint advertises no minimum. dvm wallet fund without --mint refuses an amount below every available configured mint's floor before it opens a Lightning quote. An explicit --mint is different: it emits mint_bounds_warning and attempts the named mint anyway. Use the live field rather than copying a number from this page.
Three questions before any route
For card credit at one provider, go straight to starting from nothing. For a reusable wallet, answer these in plain words before opening an account or funding an address. An agent helping you fund a wallet should ask them first.
Dollars, or Bitcoin?
If your wallet balance should stay a fixed number of dollars, use one of the two stablecoin routes: USDC.e on the Tempo network, or native USDC on Base. Both are stablecoins, dollar tokens redeemable one-for-one with their issuer, and neither path involves Bitcoin at any step.
If a small Bitcoin balance is fine, the Lightning routes open: a Lightning wallet, whether one you already use or one you set up for this, can keep your agent topped up on its own. At pocket-money scale the drift in dollar value is cents. Bitcoin is also the only money here whose value does not depend on an issuer honouring redemptions; at these amounts, picking it is a matter of principle more than price.
Does it matter who can freeze it, and who can see it?
Decide this consciously: the two kinds of money behave differently here.
A dollar stablecoin is an IOU from its issuer. The issuer can freeze addresses at the token contract, and Tempo and Base are both public ledgers, so anyone who knows your address can read your agent's payment history.
Bitcoin has no issuer and no freeze switch. Its ledger is public too, but Lightning payments settle off it: paying a provider leaves nothing on the chain for a stranger to look up. Two caveats. A custodial Lightning wallet puts a company back in a position to freeze your account, so the property fully holds only with a self-custodial one. And ecash, the most private option, hands custody of the underlying Bitcoin to a mint; the ecash section spells out that trade.
If this matters to you, fund over Lightning, prefer self-custody, and read the Cashu route below. If it does not, the other two questions decide.
Top up by hand, or let it refill?
A one-off top-up works on every route. Card credit lands at one provider; wallet funding lands on your machine. The agent spends the balance down, and you top up again when you choose.
Standing replenishment is what the Lightning float is for. You connect a Lightning wallet over NWC and the agent refills itself from it without waking you. The connection policy lives in the Lightning wallet, not on the agent's machine: when you create the connection you give it a budget, say $20 a month, renewing, and the wallet refuses payments outside it. Your agent cannot raise a limit it cannot reach. dvm checks each invoice principal against its own local budget too, but NIP-47 cannot attach a per-payment routing-fee maximum or establish whether the wallet policy includes fees; the wallet chooses the route and fee. The float section covers what the float pays for and which wallets enforce budgets properly.
The dollar routes sit in between: your agent can refill prepaid balances from the stablecoin wallet it holds, but refilling that wallet is still a withdrawal you make yourself.
Which route to take
No route is the default. Choose by what you want to use:
If you want to pay one provider in plain dollars without a wallet, use card credit where it is offered. You approve each top-up, and your agent pays a checkout link with your card. See starting from nothing for the minimum, refund terms, and regional options.
For a reusable wallet, dvm wallet setup presents four routes. Given your answers above, the guidance is:
- You want standing replenishment: connect a Lightning wallet as the float. It can be one you run yourself or a hosted one like Coinos; hosted means custodial, so keep it to pocket money. Which wallet works has the requirements.
- You believe in permissionless, censorship-resistant, self-sovereign, privacy-preserving, debasement-proof money: use Bitcoin, which here means the Lightning routes. The float is the everyday form; Cashu adds payment privacy on top of it.
- You want dollars and can get USDC.e onto the Tempo network, directly or over a bridge: use Tempo. It offers the better exit path of the two dollar routes, because every fee, including the fee on pulling your money back out, is paid in the same dollar token.
- You want dollars and your exchange withdraws native USDC to Base: use x402 on Base. Day-to-day payments need no second token here either. The exception is the self-serve exit from a payment channel, a transaction you submit yourself and pay for in ETH; that is the one moment this route asks you to hold a second asset, and only a small amount of it.
- Payment privacy is worth real trade-offs to you: Cashu, covered below.
Start from what you already have
You are starting from nothing
Start with card credit if you want to use one provider and it takes cards. Put US$5 on that service at the current default minimum, spend it on jobs, and ask for what you do not use back to your card, less a proportional share of Stripe's processing fee. First-party DVMs that take cards cap credit at US$20. This balance pays only that provider's jobs; a card never pays a job directly. Every top-up needs your approval.
Your agent needs CLI 0.19.0 or later and a provider advertising credit.stripe.checkout: true in its /v1/info. It gets a Stripe-hosted checkout link and, with a browser and your saved card, pays it itself once you approve the amount. An agent without a browser or a card hands the link to you. US$5 is the current default; the provider's advertised card minimum decides. Read credit.stripe.min_micro in /v1/info or the provider's card terms in the quote before approving: 5000000 means US$5. Paying by card has the commands and the balance check.
Outside the US and Canada, use that hosted checkout link too; it has no region limit. As of November 2026, Stripe Link connects agents only in the US and Canada. Link is optional, and hosted checkout needs no wallet.
If you want a reusable wallet or Bitcoin, choose among the wallet routes above. An exchange account can fund stablecoins or Bitcoin Lightning and gives you somewhere to cash back out later; follow the exchange route. Exchanges and wallet-app onramps require identity checks. A purchase inside a wallet app can be more self-contained but typically costs several percent; Alby Hub, a self-custodial Bitcoin Lightning wallet, sells Bitcoin in-app through its onramp partners.
You use a crypto exchange
An account you already trust usually beats a new signup, so check what yours can do before opening anything.
For the dollar routes, the check is the withdrawal screen. Open withdraw for USDC (or USDC.e) and read the network list. Support pages lag and third-party summaries go stale; the withdraw screen shows what your account, in your region, at your verification tier, can do today. Your agent cannot see that screen, so this step is yours: tell it which networks are listed and it can take it from there.
For Bitcoin the question is different. It is not about networks on a list but about whether the exchange sends over Lightning at all, so look for a Lightning option on the Bitcoin withdrawal screen. An exchange that only offers on-chain withdrawals can still fund a Lightning wallet, just slower and with higher fees.
The rest of the arc is the same everywhere. Your agent runs the connect command for the chosen route (dvm wallet tempo-connect, dvm wallet x402-connect) and hands you the deposit address as a copyable message plus a QR code. You withdraw a small test amount, choosing the exact asset and network the local facts name; the wrong dollar token, or the right token on the wrong chain, arrives as real money the wallet reads as $0.00. Your agent confirms with dvm wallet balance, and the rest of the money follows the same path.
Two dated examples, verified 2026-08-18 against the providers' own pages. They are illustrations; the withdraw screen decides.
| Exchange | What it opens | Notes |
|---|---|---|
| Kraken | USDC.e on Tempo · native USDC on Base · Bitcoin over Lightning | One account reaches all three routes. Tempo support is live since July 10, 2026 with geographic restrictions. Kraken also lists USDT0 on Tempo and USDC.e on other networks, so read the ticker and the network. Lightning withdrawals pay an invoice your wallet generates |
| Coinbase | native USDC on Base · Bitcoin over Lightning | USDC withdrawals to Base were fee-free at the time of verification. No Tempo route. Lightning sends are invoice-only, carry a small fee, and are not offered in every region |
You run a compatible Lightning wallet
Connect it as the float with dvm wallet pair: it gives you a private link and a session code to compare, and the wallet's connection string stays out of the chat. Compatibility is the catch. The wallet has to be reachable whenever the agent runs low, and it has to enforce a budget on the connection itself; which wallet works names wallets that qualify and the categories that don't. Once connected, dvm wallet fund '$5' completes on its own, and later refills do too, subject to the wallet policy. The result separates invoice principal, wallet-reported routing fee, and total debit; an omitted fee is shown as unknown rather than zero.
You hold dollars on another chain
USDC already on Base spends as-is through the x402 route. USDC anywhere else can be bridged to the Tempo network, where bridged USDC arrives as USDC.e, the asset that rail settles in; the Tempo funding guide lists working bridges. A bridge is an extra moving part with its own fee, so when the dollars sit on an exchange anyway, a direct withdrawal on a supported network is usually the simpler move.
You hold Bitcoin
If it is in a Lightning wallet, connect that wallet as the float and you are done; your Bitcoin stays yours and replenishment becomes automatic. If it sits on an exchange, withdraw over Lightning into such a wallet first. No route spends on-chain Bitcoin directly, and none of the dollar routes needs you to sell: holding Bitcoin points you at the Lightning side, nothing more.
The privacy-specialist route: Cashu
Ecash bought over Lightning is the most private way to pay here, and right now it is for people who know what they are taking on: a third-party mint holds the underlying Bitcoin, mints have been unreliable in our own testing, and recovery depends on backed-up files, not on the twelve words alone. If that reads as an acceptable trade, dvm wallet setup --rail cashu walks the whole path: wallet, mint choice, a mint-health check before money moves, then a small first fund. Keep the balance at pocket money. The custody model and the multi-mint failover are in ecash over Lightning.
Two mints are accepted here. The first-party DVMs and the platform run on this pair, and ecash held at any other mint cannot pay them. A specific job's dvm quote names the mints that job takes, so read the quote when it disagrees with this table.
| Mint | What it is |
|---|---|
https://mint.coinos.io | The primary, and the built-in default a wallet with no mint configured funds at. |
https://mint.lnvoltz.com | The failover the wallet substitutes when the primary cannot serve what you are doing. |
Add both, then check them before any money moves:
dvm wallet mint-add https://mint.coinos.io
dvm wallet mint-add https://mint.lnvoltz.com
dvm wallet mint-healthTreat mint-health as a gate rather than a formality: a mint can answer and still be unable to issue the tokens you are paying for. You do not have to act on that reading yourself. dvm wallet fund with no --mint probes the mint it is about to use, and when that mint cannot issue the amount it funds at the next configured mint that can, reporting the substitution as status: "fallback_mint" with the mint it settled on. Naming a mint with --mint turns that off: an explicit choice the mint cannot serve is an error rather than a substitution, and its hint names the configured mints that could have taken the amount.
Holding a balance at both earns its keep at pay time too, since a payment whose mint cannot serve it moves to the next mint the DVM accepts instead of failing. Spread across mints covers that.
Have a person pay a Lightning invoice
Get the invoice
When a person will pay by hand, have your agent ask for an invoice and exit instead of waiting for the payment:
dvm wallet fund '$5' --no-float --no-waitThe single quotes stop the shell reading $5 as a variable. --no-float keeps a connected Lightning float from paying the invoice itself. --no-wait prints one awaiting_payment event and exits. The invoice is priced in sats at the current rate, and display states both figures. Relay three fields from it:
relay.copy_text, the invoice itself, alone in its own message so it copies cleanly on a phone.- The QR image at
qr_image_path, in a separate message. expires_at, the deadline the mint set for this invoice. Ask the person to pay well before it. Whenexpires_atisnull, the mint gave no deadline: ask for payment within a few minutes, because the CLI drops an invoice still unpaid when it checks it more than 10 minutes after creating it.
wallet fund shows the whole event.
Who can pay it
Any Lightning wallet can pay it. It is a plain invoice from the mint. The person paying needs no wallet connection and no budget on one. The requirements in which wallet works apply to the float, not to this invoice. Each mint sets its own funding range, and an amount no configured mint will issue fails before any invoice exists (see how much to start with).
Check that it was paid
Nothing watches for the payment once the command exits. As soon as the person says they have paid, and before expires_at, run dvm wallet show. It asks the mint about every invoice still pending and turns a paid one into ecash locked to your wallet, and the balance it reports includes it. Don't leave this until after expires_at: a mint can refuse to issue ecash for an invoice once its deadline passes, even one paid in time. dvm wallet balance does not collect pending invoices, and dvm request does not collect them before it pays. The invoice itself is not proof that anything was paid. wallet fund lists what each check reports.
Once collected, the ecash pays jobs like any other balance, within the limits you set in budgets such as --auto-pay-below. It needs no prepaid credit; credits are a separate balance held at one provider.
If it expires
The CLI drops an invoice that is still unpaid when it checks it after expires_at, or more than 10 minutes after creating it when expires_at is null. dvm wallet show lists a dropped invoice under sweep.expired. Do not let anyone pay an invoice listed there: a payment to it is not collected. Tell the person not to pay the old invoice, run dvm wallet fund again, and relay only the new one. When a new fund reports existing_unpaid_quotes and a warning, an earlier invoice is still open: ask the person to pay only one of them.
After the first transfer
For card credit, follow the card balance check. For wallet funding:
- Verify before adding more. Run
dvm wallet balanceonce the transfer confirms, anddvm doctorif anything looks off; both name the exact token and network the wallet reads, which turns "it says zero" into a diagnosis. After paying a Lightning invoice by hand, rundvm wallet showfirst: it collects the payment, andwallet balancedoes not (check that it was paid). - Back up what the route created. The Tempo and x402 keys live in your config file and are not covered by the twelve-word phrase; back up more than the words says what to copy.
- Keep the balance small: days of spending, not months. It is the hard ceiling on what your agent can spend, and dvmkit is alpha software.
- To get money back out later, including out of an open payment channel when a provider stops answering, see getting value back out.
When something looks wrong
| What you see | What it usually is | Do this |
|---|---|---|
| Your exchange doesn't list the network you need | A regional or account-tier gap, not an error | Pick another rail the same exchange reaches, or bridge from a network it does list |
| Transfer confirmed, balance reads $0.00 | The wrong dollar token, or the right token on another chain | dvm wallet balance names what this wallet reads; compare it against what you sent. On Tempo this is almost always the wrong dollar |
| Balance won't load at all | The chain endpoint refusing reads, not missing money | dvm doctor names the endpoint and the variable that moves it; see custom chain endpoints |
| Lightning invoice paid, no ecash arrived | The mint hasn't issued yet, or is degraded | dvm wallet mint-health first; dvm wallet show reconciles pending mints on every run |
| You want to replace or remove an x402 key that still has channel money | The refusal (x402_wallet_in_use) is protecting the deposit | Empty the channel first, cooperatively or by the timed exit; see getting value back out |
The CLI diagnoses all of these itself, in words meant to be relayed: when your agent passes you a display message from dvm, it can be taken at face value.