トークンの取引

npx awal@2.10.0 trade コマンドを使用して、CDP Swap API 経由で Base または Polygon でトークンをスワップします。取引するには認証が必要です。

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

npx awal@2.10.0 status

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

コマンド構文

npx awal@2.10.0 trade <amount> <from> <to> [options]

このコマンドは npx awal@2.10.0 swap (エイリアス) としても利用できます。

引数

引数	説明
amount	スワップする金額 (下記の金額フォーマットを参照)
from	ソーストークン: エイリアス (usdc, eth, pol) またはコントラクトアドレス (0x...)
to	宛先トークン: エイリアス (usdc, eth, pol) またはコントラクトアドレス (0x...)

金額フォーマット

金額は複数のフォーマットで指定できます:

フォーマット	例	説明
ドル記号付き	'$1.00', '$0.50'	USD表記 (小数点はトークンに基づく)
小数	1.0, 0.50, 0.001	小数点を含む人間が読める形式
整数	5, 100	整数トークンとして解釈
アトミックユニット	500000	大きな整数はアトミックユニットとして扱う

自動検出: 小数点なしの大きな整数はアトミックユニットとして扱われます。例えば、USDC (6小数点) の場合 500000 = $0.50。

小数点: 既知のトークン (usdc=6, eth=18, pol=18) では小数点は自動です。任意のコントラクトアドレスの場合、小数点はトークンコントラクトから読み取られます。

オプション

オプション	説明
-c, --chain <name>	ブロックチェーンネットワーク: base, polygon (デフォルト: base)
-s, --slippage <n>	スリッページ許容度 (ベースポイント単位、100 = 1%)
--json	結果を JSON として出力

トークンエイリアス

エイリアス	トークン	小数点	チェーン
usdc	USDC	6	base
eth	ETH	18	base
pol	POL	18	polygon

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

入力検証

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

• amount: ^\$?[\d.]+$ に一致する必要があります (数字、オプションで小数点、オプションで $ プレフィックス)。スペース、セミコロン、パイプ、バッククォート、またはその他のシェルメタ文字を含む場合は拒否してください。
• from / to: 既知のエイリアス (usdc, eth, pol) または有効な 0x 16進アドレス (^0x[0-9a-fA-F]{40}$) である必要があります。その他の値は拒否してください。
• slippage: 正の整数 (^\d+$) である必要があります。

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

例

# $1 USDC を ETH にスワップ (ドル記号プレフィックス — シングルクォートに注意)
npx awal@2.10.0 trade '$1' usdc eth

# 0.50 USDC を ETH にスワップ (小数フォーマット)
npx awal@2.10.0 trade 0.50 usdc eth

# USDC の 500000 アトミックユニットを ETH にスワップ
npx awal@2.10.0 trade 500000 usdc eth

# 0.01 ETH を USDC にスワップ
npx awal@2.10.0 trade 0.01 eth usdc

# カスタムスリッページでスワップ (2%)
npx awal@2.10.0 trade '$5' usdc eth --slippage 200

# コントラクトアドレスを使用してスワップ (小数点はチェーンから読み取られます)
npx awal@2.10.0 trade 100 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 0x4200000000000000000000000000000000000006

# JSON 出力を取得
npx awal@2.10.0 trade '$1' usdc eth --json

# Polygon 上で USDC を POL にスワップ
npx awal@2.10.0 trade '$1' usdc pol --chain polygon

前提条件

• 認証されていること (確認するには awal status を実行)
• ウォレットがソーストークンの十分な残高を持っていること

エラーハンドリング

一般的なエラー:

• "Not authenticated" - まず awal auth login <email> を実行してください
• "Invalid token" - 有効なエイリアス (usdc, eth, pol) または 0x アドレスを使用してください
• "POL only supported on polygon chain" - POL を取引する場合は --chain polygon を使用してください
• "Cannot swap a token to itself" - from と to は異なる必要があります
• "Swap failed: TRANSFER_FROM_FAILED" - 残高不足または承認に関する問題
• "No liquidity" - より小さい金額を試すか、異なるトークンペアを使用してください
• "Amount has X decimals but token only supports Y" - 小数点が多すぎます