Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.useveil.co/llms.txt

Use this file to discover all available pages before exploring further.

This walkthrough takes you from a fresh install through a completed sandbox offramp. All steps run against the sandbox environment.

​
Prerequisites

  • Node.js 22 or later
  • A Veil developer account (sandbox onboarding complete: KYC approved, bank account added). If you haven’t done this yet, start with the Developer sandbox guide.
1

Install the CLI

npm install -g @useveil/cli
Verify:
veil health
Expected output: ok with the API version.
2

Pair your machine

veil login
The CLI opens your browser. Approve the pairing request. After confirmation:
Paired as you@example.com on device "macbook-pro-a3f2".
Sandbox mode: ready
Live mode:    locked
Confirm you’re in sandbox:
veil mode
Expected: sandbox.
3

Create a wallet on Base

veil wallets create --chain base --name "sandbox-base"
The CLI prints the wallet ID and deposit address:
Created wallet: sandbox-base (base)
Address: 0xabc...
Save the wallet ID — you’ll use it when creating the offramp.
4

Fund the wallet with test tokens

Use the Veil faucet in the dashboard to send USDC_TEST to your new wallet. Open the Wallets tab, click your Base Sepolia wallet, and press Fund. See Get test tokens for details.After a moment, the balance appears:
veil wallets show <wallet-id>
Look for a USDC_TEST balance in the output.
5

Quote the offramp

Check the rate and fees before committing:
veil offramp quote --token USDC --amount 10 --wallet-id <wallet-id>
The CLI prints the exchange rate, output amount, fees, and a balance check.
6

Create the offramp

veil offramp create --wallet-id <wallet-id> --amount 10 --token USDC
The CLI shows the pre-send summary and asks you to confirm:
About to send 10 USDC from wallet <wallet-id> to your primary bank (fee ~0.10 USD, you receive ~9.90 USD).
? Continue? (y/N)
Enter y. Veil executes the transaction and sends a six-digit code to your email:
Sent a 6-digit code to y***@example.com. The code expires in 10 minutes.
? Enter the 6-digit code:
Enter the code from your email. On success, the CLI prints the transaction details:
ID: txn_abc123
Type: offramp
Status: pending
Amount In: 10 USDC
Amount Out: 9.90 USD
Fee: 0.10
...
7

Check the transaction status

veil offramp show txn_abc123
Or list recent transactions:
veil transactions list --type offramp
Sandbox offramps settle quickly. Once settled, the status changes to completed and the wire reference appears.

​
What’s next