ThesaurosDocs
Customer experience

Add funds to Earn

Understand the wallet steps behind a deposit and the states your app should show.

To try a deposit now, open your Individual test account, request test USDC, and select Deposit. Your balance and activity persist across sign-ins. The workspace guide also covers Institution accounts.

The steps below describe the wallet integration a partner product implements. In a wallet-based Earn flow, depositing involves permission to spend the asset and a transaction into the vault. Your application can make those steps feel continuous while keeping their status clear.

1. Connect and check availability

Open the Thesauros app from the product links, or the Earn experience in your partner app. Connect the intended wallet. Check the network, supported asset and any access status shown for that account.

Confirm deployment access with the integrating partner. The test account is available after sign-in; see account access.

2. Review the amount

Enter the amount and review the asset, receiving vault, estimated shares and network cost. Keep enough native network currency for transaction fees where the wallet requires it.

Use the assets and conversion choices currently offered in your app. Historical materials described bundled swaps; that does not establish swap availability in every current deployment.

3. Approve and confirm

If the token allowance is insufficient, the wallet asks for an approval first. Check the spender and allowance amount. After approval is confirmed, review and sign the deposit transaction.

If a signature is rejected, the app should return to an actionable state. If the transaction is submitted, show it as pending until the receipt establishes the result.

4. Confirm the position

After confirmation, show the updated balance and activity entry. Reporting may arrive after the wallet receipt; a temporary indexing delay should not prompt a duplicate deposit.

For developers, positions and activity explains the boundary between wallet settlement and API reporting. The sandbox can model the journey without moving assets.

Build with us.

Bring your product flow. We'll map the integration together.

Discuss your integration
Continue readingReturn funds to the wallet

Find an integration guide, API method or SDK example.

Thesauros documentationSearch runs in your browser