有料 x402 リクエストの実行

npx awal@2.10.0 x402 pay コマンドを使用して、Base 上の自動 USDC 支払いで有料 API エンドポイントを呼び出します。

ウォレットが初期化および認証されていることを確認

npx awal@2.10.0 status

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

コマンド構文

npx awal@2.10.0 x402 pay <url> [-X <method>] [-d <json>] [-q <params>] [-h <json>] [--max-amount <n>] [--json]

オプション

オプション	説明
-X, --method <method>	HTTP メソッド (デフォルト: GET)
-d, --data <json>	リクエストボディを JSON 文字列として指定
-q, --query <params>	クエリパラメータを JSON 文字列として指定
-h, --headers <json>	カスタム HTTP ヘッダを JSON 文字列として指定
--max-amount <amount>	USDC アトミックユニット単位での最大支払額 (1000000 = $1.00)
--correlation-id <id>	関連操作をグループ化
--json	JSON として出力

USDC 金額

X402 は USDC アトミックユニット (小数点以下 6 桁) を使用します:

アトミックユニット	USD
1000000	$1.00
100000	$0.10
50000	$0.05
10000	$0.01

重要: bash 変数展開を防ぐため、$ を含む金額は常にシングルクォートで囲んでください (例: '$1.00' ではなく $1.00)。

入力検証

コマンドを構築する前に、シェルインジェクションを防ぐため、ユーザーが提供するすべての値を検証してください:

• url: https:// または http:// で始まる有効な URL である必要があります。スペース、セミコロン、パイプ、バッククォート、またはシェルメタ文字を含む場合は拒否してください。
• data (-d): 有効な JSON である必要があります。シェル展開を防ぐため、常にシングルクォートで囲んでください。
• max-amount: 正の整数 (^\d+$) である必要があります。

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

例

# GET リクエストを実行 (自動支払い)
npx awal@2.10.0 x402 pay https://example.com/api/weather

# ボディ付き POST リクエストを実行
npx awal@2.10.0 x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}'

# 最大支払額を $0.10 に制限
npx awal@2.10.0 x402 pay https://example.com/api/data --max-amount 100000

前提条件

• 認証済みである必要があります (npx awal@2.10.0 status で確認、authenticate-wallet スキルを参照)
• ウォレットに十分な USDC 残高がある必要があります (npx awal@2.10.0 balance で確認)
• エンドポイント URL が不明な場合は、search-for-service スキルを使用してサービスを検索してください

エラーハンドリング

• 「Not authenticated」- 最初に awal auth login <email> を実行するか、authenticate-wallet スキルを参照してください
• 「No X402 payment requirements found」- URL が x402 エンドポイントではない可能性があります。search-for-service を使用して有効なエンドポイントを検索してください
• 「Insufficient balance」- USDC でウォレットにチャージしてください。fund スキルを参照してください