> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raziel.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Raziel credits: deposit and manage your USDC balance

> Add USDC to your Raziel account via Solana wallet transfer. No card required. Credits appear within 60 seconds. Minimum $0.05 balance to route requests.

Your Raziel balance is USDC on Solana. Deposit directly from any Solana wallet — no card, no checkout flow. The gateway checks your balance before forwarding each request and returns HTTP 402 if it falls below \$0.05.

## How balance works

Every account has a unique 16-character `deposit_memo`. The on-chain indexer uses this memo to match incoming USDC transfers to the correct account. Without it, the transfer lands in the deposit wallet but your balance does not increase.

<Warning>
  Always include your `deposit_memo` as an SPL memo instruction when sending USDC. Transfers without the memo cannot be credited to your account.
</Warning>

## How to deposit

<Steps>
  <Step title="Sign in and open the deposit page">
    Navigate to **Customer → Deposit**. The page shows your vault address and a QR code you can scan from a mobile wallet.
  </Step>

  <Step title="Copy your deposit memo">
    Your `deposit_memo` is displayed on the deposit page. It is a unique 16-character string tied to your account. Copy it exactly.
  </Step>

  <Step title="Send USDC from your Solana wallet">
    Transfer any amount of USDC (SPL) to the vault address. Include your `deposit_memo` as an SPL memo on the same transaction.

    ```text theme={null}
    Recipient:  <vault address shown on deposit page>
    Token:      USDC (SPL, Solana mainnet-beta)
    Memo:       <your 16-char deposit_memo>
    ```
  </Step>

  <Step title="Wait for confirmation">
    The indexer picks up confirmed transactions and credits your balance. This takes approximately 60 seconds under normal network conditions.
  </Step>
</Steps>

<Note>
  Credits appear within \~60 seconds of on-chain confirmation. Solana finality is fast, but network congestion can add a few seconds. If your balance has not updated after 2 minutes, check that the memo was included and the transaction is confirmed.
</Note>

## Balance and usage

Your current balance is shown on the dashboard home. It updates in real time after each request is metered. For a per-request breakdown — token counts, model, cost, and timestamp — navigate to **Customer → Usage** in the dashboard.

## Minimum balance requirement

Requests are forwarded only when your balance is at or above **\$0.05 USDC**. If the balance drops below this threshold mid-session, the next request returns HTTP `402` with `auth_error: insufficient balance`.

<Tip>
  Keep a buffer well above \$0.05. A single large context window on Opus can cost several cents. Topping up before a long session avoids a 402 mid-task.
</Tip>

There is no minimum deposit amount. You can add any amount at any time as long as the resulting balance meets the \$0.05 floor before your next request.

## Reference

| Field                         | Value                                    |
| ----------------------------- | ---------------------------------------- |
| Network                       | Solana (mainnet-beta)                    |
| Token                         | USDC (SPL)                               |
| Memo field                    | Required — 16-char `deposit_memo`        |
| Credit delay                  | \~60 seconds after on-chain confirmation |
| Minimum balance               | \$0.05 USDC                              |
| Response when balance too low | HTTP 402                                 |