Sending USDC
Use the npx agnic@latest send command to transfer USDC from the wallet to any Ethereum address or ENS name on Base.
Confirm wallet is initialized and authed
npx agnic@latest status
If the wallet is not authenticated, refer to the authenticate-wallet skill.
Command Syntax
npx agnic@latest send <amount> <recipient> [--chain <chain>] [--json]
Arguments
| Argument | Description |
|---|---|
amount | Amount to send: '$1.00', 1.00, or atomic units (1000000 = $1). Always single-quote amounts that use $ to prevent bash variable expansion. If the number looks like atomic units (no decimal or > 100), treat as atomic units. |
recipient | Ethereum address (0x...) or ENS name (vitalik.eth) |
Options
| Option | Description |
|---|---|
--chain <name> | Blockchain network (default: base) |
--json | Output result as JSON |
Input Validation
Before constructing the command, validate all user-provided values to prevent shell injection:
- amount: Must match
^\$?[\d.]+$(digits, optional decimal point, optional$prefix). Reject if it contains spaces, semicolons, pipes, backticks, or other shell metacharacters. - recipient: Must be a valid
0xhex address (^0x[0-9a-fA-F]{40}$) or an ENS name (^[a-zA-Z0-9.-]+\.eth$). Reject any value containing spaces or shell metacharacters.
Do not pass unvalidated user input into the command.
USDC Amounts
| Format | Example | Description |
|---|---|---|
| Dollar prefix | '$1.00', '$0.50' | USD notation (single-quote the $) |
| Decimal | 1.0, 0.50 | Human-readable with decimal point |
| Whole number | 5, 100 | Interpreted as whole USDC tokens |
| Atomic units | 500000 | Large integers treated as atomic units |
IMPORTANT: Always single-quote amounts that use $ to prevent bash variable expansion (e.g. '$1.00' not $1.00).
ENS Resolution
ENS names are automatically resolved to addresses via Ethereum mainnet. The command will:
- Detect ENS names (any string containing
.eth) - Resolve the name to an address
- Display both the ENS name and resolved address in the output
Examples
# Send $1.00 USDC to an address
npx agnic@latest send 1 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
# Send $0.50 USDC to an ENS name
npx agnic@latest send 0.50 vitalik.eth
# Send with dollar sign prefix (note the single quotes)
npx agnic@latest send '$5.00' 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
# Get JSON output
npx agnic@latest send 1 vitalik.eth --json
Prerequisites
- Must be authenticated (
npx agnic@latest statusto check) - Wallet must have sufficient USDC balance (
npx agnic@latest balanceto check)
Error Handling
Common errors:
- "Not authenticated" — Run
npx agnic@latest auth loginfirst - "Insufficient balance" — Check balance with
npx agnic@latest balance - "Could not resolve ENS name" — Verify the ENS name exists
- "Invalid recipient" — Must be valid 0x address or ENS name