GuidesRecipesAPI ReferenceChangelog
Guides

USDC_SOL Deposit Addresses in Sandbox

How do I generate a USDC deposit address on Solana 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.