Send Usdc

1---2name: send-usdc3description: Send USDC to an Ethereum address or ENS name. Use when you or the user want to send money, pay someone, transfer USDC, tip, donate, or send funds to a wallet address or .eth name. Covers phrases like "send $5 to", "pay 0x...", or "transfer to vitalik.eth".4user-invocable: true5disable-model-invocation: false6allowed-tools: ["Bash(npx awal@2.0.3 status*)", "Bash(npx awal@2.0.3 send *)", "Bash(npx awal@2.0.3 balance*)"]7---8 9# Sending USDC10 11Use the `npx awal@2.0.3 send` command to transfer USDC from the wallet to any Ethereum address or ENS name on Base.12 13## Confirm wallet is initialized and authed14 15```bash16npx awal@2.0.3 status17```18 19If the wallet is not authenticated, refer to the `authenticate-wallet` skill.20 21## Command Syntax22 23```bash24npx awal@2.0.3 send <amount> <recipient> [--chain <chain>] [--json]25```26 27## Arguments28 29| Argument    | Description                                                                                                                                                                                                                          |30| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |31| `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. Assume that people won't be sending more than 100 USDC the majority of the time |32| `recipient` | Ethereum address (0x...) or ENS name (vitalik.eth)                                                                                                                                                                                   |33 34## Options35 36| Option           | Description                        |37| ---------------- | ---------------------------------- |38| `--chain <name>` | Blockchain network (default: base) |39| `--json`         | Output result as JSON              |40 41## Input Validation42 43Before constructing the command, validate all user-provided values to prevent shell injection:44 45- **amount**: Must match `^\$?[\d.]+$` (digits, optional decimal point, optional `$` prefix). Reject if it contains spaces, semicolons, pipes, backticks, or other shell metacharacters.46- **recipient**: Must be a valid `0x` hex address (`^0x[0-9a-fA-F]{40}$`) or an ENS name (`^[a-zA-Z0-9.-]+\.eth$`). Reject any value containing spaces or shell metacharacters.47 48Do not pass unvalidated user input into the command.49 50## Examples51 52```bash53# Send $1.00 USDC to an address54npx awal@2.0.3 send 1 0x1234...abcd55 56# Send $0.50 USDC to an ENS name57npx awal@2.0.3 send 0.50 vitalik.eth58 59# Send with dollar sign prefix (note the single quotes)60npx awal@2.0.3 send '$5.00' 0x1234...abcd61 62# Get JSON output63npx awal@2.0.3 send 1 vitalik.eth --json64```65 66## ENS Resolution67 68ENS names are automatically resolved to addresses via Ethereum mainnet. The command will:69 701. Detect ENS names (any string containing a dot that isn't a hex address)712. Resolve the name to an address723. Display both the ENS name and resolved address in the output73 74## Prerequisites75 76- Must be authenticated (`npx awal@2.0.3 status` to check, `npx awal@2.0.3 auth login` to sign in, see skill `authenticate-wallet` for more information)77- Wallet must have sufficient USDC balance (`npx awal balance` to check)78 79## Error Handling80 81Common errors:82 83- "Not authenticated" - Run `awal auth login <email>` first84- "Insufficient balance" - Check balance with `awal balance`85- "Could not resolve ENS name" - Verify the ENS name exists86- "Invalid recipient" - Must be valid 0x address or ENS name