send-usdc

トークンの送金

npx [email protected] send コマンドを使用して、ウォレットから Base、Polygon、Solana 上の任意のアドレスにトークンを送金します。

ウォレットが初期化され、認証済みであることを確認する

npx [email protected] status

ウォレットが認証されていない場合は、authenticate-wallet スキルを参照してください。

コマンドの構文

npx [email protected] send <amount> <recipient> [--chain <chain>] [--asset <asset>] [--json]

引数

引数	説明
amount	送金額：'$1.00'、'1.00'、または最小単位（1000000 = $1）。$ を含む金額は、bash による変数展開を防ぐため、必ずシングルクォートで囲んでください。小数点がない、または 100 を超えるなど、最小単位の値に見える場合は、最小単位として扱います。大半の場合、ユーザーが 100 USDC を超える額を送金することはないものとします
recipient	Ethereum アドレス（0x...）、ENS 名（vitalik.eth）、または Solana アドレス（Base58）

オプション

オプション	説明
--chain <name>	ブロックチェーンネットワーク：base、polygon、solana（デフォルト：base）
--asset <symbol>	送金するトークン：usdc、eth、pol、sol（デフォルト：usdc）
--json	結果を JSON 形式で出力する

入力値の検証

コマンドを組み立てる前に、シェルインジェクションを防ぐため、ユーザーが指定したすべての値を検証してください。

• amount：^\$?[\d.]+$（数字、任意の小数点、任意の $ 接頭辞）に一致する必要があります。空白、セミコロン、パイプ、バッククォート、その他のシェルメタ文字が含まれている場合は拒否してください。
• recipient：有効な 0x 形式の 16 進数アドレス（^0x[0-9a-fA-F]{40}$）、ENS 名（^[a-zA-Z0-9.-]+\.eth$）、または Solana アドレス（^[1-9A-HJ-NP-Za-km-z]{32,44}$）である必要があります。空白またはシェルメタ文字を含む値は拒否してください。
• chain：base、polygon、solana のいずれかである必要があります。それ以外の値は拒否してください。
• asset：usdc、eth、pol、sol のいずれかである必要があります。それ以外の値は拒否してください。

検証していないユーザー入力をコマンドに渡さないでください。

例

# Send $1.00 USDC to an address on Base (default)
npx [email protected] send 1 0x1234...abcd

# Send $0.50 USDC to an ENS name
npx [email protected] send 0.50 vitalik.eth

# Send with dollar sign prefix (note the single quotes)
npx [email protected] send '$5.00' 0x1234...abcd

# Send ETH on Base
npx [email protected] send 0.01 0x1234...abcd --asset eth

# Send USDC on Polygon
npx [email protected] send 1 0x1234...abcd --chain polygon

# Send USDC to a Solana address
npx [email protected] send 1 AxW7...5fGz --chain solana

# Get JSON output
npx [email protected] send 1 vitalik.eth --json

ENS の解決

ENS 名は Ethereum メインネット経由で自動的にアドレスに解決されます。コマンドは次の処理を行います。

1. ENS 名を検出します（16 進数アドレスではなく、ドットを含む文字列）
2. 名前をアドレスに解決します
3. 出力に ENS 名と解決されたアドレスの両方を表示します

前提条件

• 認証済みである必要があります（確認するには npx [email protected] status、サインインするには npx [email protected] auth login を実行してください。詳しくは authenticate-wallet スキルを参照してください）
• ウォレットに十分な USDC 残高が必要です（確認するには npx awal balance を実行してください）

エラー処理

よくあるエラー：

• "Not authenticated" - 最初に awal auth login <email> を実行してください
• "Insufficient balance" - awal balance で残高を確認してください
• "Could not resolve ENS name" - ENS 名が存在することを確認してください
• "Invalid recipient" - 有効な 0x アドレス、ENS 名、または Solana Base58 アドレスである必要があります
• "SOL only supported on Solana chains" - SOL の送金には --chain solana を使用してください
• "ETH/POL only supported on EVM chains" - base では ETH、polygon では POL を使用してください