Skip to main content

Fund escrow

Paid reads use your app identity’s Data Portability escrow balance. You only fund it — the SDK resolves the escrow contract for the network you select, so there’s no contract address to configure in your app. Escrow is funded from the Fund escrow section of the same signed-in Developers page you used to create the app identity, on the same network. Escrow balances are per network — fund the network your app runs on (Choose your network).
1

Open and sign in to Vana Account developers

Open account.vana.org/developers and sign in.
2

Confirm the network

Set the Protocol network toggle to the network your app uses: Testnet (Moksha) while developing, Mainnet for your live app.
3

Enter the app identity address in Fund escrow

In the Fund escrow section, the Funding source is your connected External wallet. Set App identity address to the grantee app address you created or registered — this is the address that pays for Personal Server reads.
4

Enter the amount and fund

Enter the Amount to deposit — native VANA on testnet, USDC.e on mainnet — click Fund escrow, and submit the wallet transaction.
5

Wait for the balance to update

Wait until the app’s available balance updates.
Getting funds: on Moksha, get testnet VANA from faucet.vana.com/moksha (10 VANA per address per 24 hours). On mainnet, see Fund your wallet. Data request creation and user approval can succeed before escrow is funded, but data reads fail with Insufficient finalized balance until the app address has finalized escrow balance.

Check current fees

Creating an access request does not spend escrow. Payment happens when your backend reads approved data from the user’s Personal Server. A paid read can include:
You don’t set or pay fees yourself. When a read needs payment, the Personal Server returns a 402 challenge with the exact amount owed; the SDK pays it from your escrow and retries. Fee amounts and assets are set by Vana onchain in FeeRegistry and can change, so treat any number below as an example, not a fixed price.
FeeRegistry: On testnet, fees currently use native VANA. In testing, the first paid read for a grant requires about 0.01 VANA from escrow because it includes grant registration plus data access. Treat that as an example, not a fixed price. On mainnet, fees use USDC.e. Fee assets and prices can differ by environment, so check Vana Account and FeeRegistry before funding escrow for a paid-read test.