USDC_SOL Deposit Addresses in Sandbox

Overview

Solana charges "rent" to create a token account on-chain. The Cybrid Platform abstracts this
away in production, but in sandbox you must fund a SOL account yourself before a USDC_SOL
deposit address can be created.

This guide is the sandbox companion to
On-Chain Crypto Deposits. For
broader sandbox behavior, see
Sandbox Transfers.

ℹ️

Sandbox only

This procedure is not required in production. Cybrid pays Solana rent automatically and
invoices you at the end of the month (0.01 SOL per token deposit address generated).

Prerequisites

• A sandbox bank with deposit addresses enabled for both SOL and USDC_SOL. If you receive
  an error in Step 3 or 8, contact Cybrid support to enable them.
• A verified customer (or use a bank-level account).
• A devnet SOL source — e.g., the
  Solana Devnet faucet — to fund Step 5.

SOL setup (fund the rent)

1. Enable trading symbols: turn on SOL-USD and USDC_SOL-USD for your bank.
2. Create a SOL trading account for the customer (or bank).
3. Create a deposit address for the SOL account via POST /api/deposit_addresses.
4. Retrieve the deposit address by polling
   GET /api/deposit_addresses/{deposit_address_guid} until state is created.
5. Fund the address: send at least 0.01 SOL on Solana devnet to the address.
6. Confirm the deposit: check platform_available on the SOL trading account.

USDC_SOL setup (generate the deposit address)

1. Create a USDC_SOL trading account for the same customer.
2. Create a deposit address for the USDC_SOL account via POST /api/deposit_addresses.
   The platform consumes ~0.01 SOL from the rent-funded SOL account to create the on-chain
   token account.
3. Retrieve the deposit address by polling until state is created.
4. Send USDC on Solana devnet to the address.
5. Confirm the deposit: check platform_available on the USDC_SOL trading account.

Troubleshooting

• storing state never transitions: the SOL rent account is empty or has less than 0.01
  SOL. Re-fund the SOL deposit address from Step 5 and retry.
• POST /api/deposit_addresses returns an error: deposit addresses are not enabled on
  your bank for the given asset. Contact Cybrid support to enable SOL and USDC_SOL.