zerion-trading

Zerion — トレーディング

オンチェーンの取引アクション（スワップ、ブリッジ、送金）を実行します。すべてのコマンドは、アクティブなエージェントトークンを署名用パスフレーズとして使用し、トランザクションの構築、署名、ブロードキャストを一度に行います。

セットアップ

zerion コマンドの実行時に command not found が表示された場合は、一度インストールしてください。

npm install -g zerion-cli

Node.js ≥ 20 が必要です。認証については、zerion 統合スキルを参照してください。すべての取引に API キーとエージェントトークンが必要です。 従量課金（--x402、--mpp）はここでは適用されません。

使用する場面

• 「X を Y にスワップ」／「トークンを変換」／「取引」
• 「X をチェーン Y にブリッジ」（クロスチェーン）
• 「アドレスにトークンを送金」（ネイティブ ETH／SOL または ERC-20）

取引前の残高確認には zerion-analyze を使用してください。エージェントトークンの設定には zerion-agent-management を使用してください。オフチェーン署名（permit、EIP-712）には zerion-sign を使用してください。

事前確認

zerion wallet list                       # confirm wallet exists, see active policies
zerion agent list-tokens                 # confirm agent token is set

エージェントトークンがない場合、次回の取引試行時に CLI がトークン作成のインラインプロンプトを表示します（TTY の場合のみ）。CI／パイプ経由の環境では、zerion agent create-token --passphrase-file <0600-path> を使って事前にトークンを作成してください。詳しくは zerion-agent-management を参照してください。

スワップ（同一チェーン）

同じチェーン上でトークンを別のトークンに変換します。クロスチェーン変換には bridge を使用してください。

# zerion swap <chain> <amount> <from-token> <to-token>
zerion swap base 1 USDC ETH
zerion swap ethereum 0.1 ETH USDC
zerion swap arbitrum 100 USDC DAI
zerion swap monad 1 USDC MON

# Solana same-chain swap
zerion swap solana 0.1 SOL USDC

# Specific wallet (overrides defaultWallet)
zerion swap base 1 USDC ETH --wallet <name>

# Custom slippage (default 2%, max 3%)
zerion swap base 1 USDC ETH --slippage 3

# Confirmation timeout (default 120s)
zerion swap base 1 USDC ETH --timeout 300

トークンは、シンボル（ETH、USDC、SOL）、0x アドレス（EVM）、Solana のミント、または検索結果との完全一致で指定できます。シンボルが曖昧な場合は、明示的なアドレスを使用してください。

# List swap-available tokens for a chain
zerion swap tokens                       # all chains
zerion swap tokens base                  # filter to Base
zerion swap tokens solana                # filter to Solana
zerion swap tokens monad                 # filter to Monad

ブリッジ（クロスチェーン）

チェーン間でトークンを移動します（必要に応じてスワップも行います）。単純な転送の場合は両側で同じトークンを指定し、ブリッジとスワップを行う場合は異なる to-token を指定してください。

プロバイダーの選択：

フラグ	動作
(none), 複数のオファー	すべての見積もり（プロバイダー、出力、所要時間、手数料）を一覧表示して終了します。トランザクションには署名しません。
(none), オファーが1件	利用可能なルートが1つのみの場合、自動実行します（選択は不要です）。
--cheapest	出力が最も多いオファーを実行します（従来の自動実行の動作と同じです）。
--fast	所要時間が最も短いオファー（estimated_time_seconds）を実行します。所要時間のデータがないオファーしかない場合は、--cheapest にフォールバックします。

ルール：

• --fast と --cheapest を同時に指定すると拒否されます。
• サポートされるフラグ形式：値を指定しない --fast（parseFlags が次の位置引数を値として解釈しないよう、コマンドラインの最後に指定する必要があります）、--fast=true／--fast=false、および --no-fast（--fast=false と同じです）。--cheapest にも同じ形式が適用されます。それ以外（例：--fast=cheapest、--fast arbitrum）を指定すると、invalid_flag_value エラーになります。
• --slippage は検証されます。0 から 100 までの数値である必要があります。--slippage=abc、--slippage=2abc、--slippage=-5、--slippage=200 はすべて invalid_slippage エラーで拒否されます。数値は厳密に解析され、部分的な文字列一致は認められません。

# zerion bridge <from-chain> <from-token> <amount> <to-chain> <to-token> [--fast | --cheapest]

# List all bridge providers (no execution) — agent can compare and choose
zerion bridge base USDC 5 arbitrum USDC

# Same-token bridge — execute the cheapest (highest output) route
zerion bridge base USDC 5 arbitrum USDC --cheapest
zerion bridge ethereum USDC 100 polygon USDC --cheapest
zerion bridge base USDC 10 monad USDC --cheapest

# Execute the fastest route (lowest estimated_time_seconds)
zerion bridge base USDC 5 arbitrum USDC --fast

# Bridge + swap on destination
zerion bridge base USDC 5 arbitrum ETH --cheapest
zerion bridge base USDC 5 monad MON --cheapest

# Native token bridge
zerion bridge base ETH 0.001 optimism ETH --cheapest

# Bridge EVM → Solana (mnemonic wallet has both accounts → no extra flag needed)
zerion bridge ethereum USDC 50 solana USDC --cheapest

# Bridge Solana → EVM
zerion bridge solana USDC 50 ethereum USDC --cheapest

# Cross-format bridge to a different local wallet
zerion bridge ethereum USDC 50 solana USDC --to-wallet <sol-wallet> --cheapest
zerion bridge solana USDC 50 ethereum USDC --to-wallet <evm-wallet> --cheapest

# Bridge to a raw destination address (must match the target chain's format)
zerion bridge ethereum USDC 50 solana USDC --to-address <solana-pubkey> --cheapest
zerion bridge solana USDC 50 ethereum USDC --to-address 0x... --cheapest

# Slippage / timeout flags work the same as swap (strategy flag still last)
zerion bridge base USDC 5 arbitrum ETH --slippage 3 --timeout 300 --cheapest

クロスチェーンの宛先ルール

Solana と EVM 間のブリッジ（アドレス形式が異なる場合）では、宛先の受取人は次の優先順位で解決されます。

1. --to-address <addr> — 受取人を直接指定します。対象チェーンの形式（EVM の場合は 0x…、Solana の場合は base58 公開鍵）に一致する必要があります。EVM では ENS 名も使用できます。
2. --to-wallet <name> — 対象チェーン上の対応するアカウントを使用するローカルウォレットです。
3. フォールバック — 対象チェーンにアカウントがある場合は、送信元ウォレット自体を使用します（ニーモニックから生成されたウォレットなら、いずれも該当します）。

宛先ウォレットには、対象チェーンに対応するアカウントが必要です。EVM 専用ウォレットは solana で受け取れず、Solana 専用ウォレットは EVM チェーンで受け取れません。

API が swap cannot be performed with the given parameters を返した場合、要求されたペアに対応するルートは現在ありません。トークンが両方のチェーンに実装されていることを確認し（zerion search <symbol>）、別の金額を試し、両方のチェーンがブリッジに対応していることを確認してください（zerion chains）。

送金（transfer）

ネイティブトークン、ERC-20、ネイティブ SOL の送金に対応しています。--chain を指定しない場合は、受取人アドレスの形式から自動的に推測されます（0x… → デフォルトの ethereum、base58 → solana）。

# EVM: native + ERC-20
zerion send ETH 0.01 --to 0x... --chain base
zerion send USDC 10 --to vitalik.eth --chain ethereum
zerion send MON 0.5 --to 0x... --chain monad
zerion send USDC 10 --to 0x... --chain monad

# Solana: native SOL (chain auto-detected from base58 recipient)
zerion send SOL 0.1 --to 2Nsnn…
zerion send SOL 0.1 --to 2Nsnn… --chain solana   # explicit form

指定できる受取人：0x アドレス（EVM）、ENS 名（送金時に解決）、Solana の base58 公開鍵。Solana の SPL トークン送金は、CLI ではまだサポートされていません。まず zerion swap solana <amount> <token> SOL で SOL に交換してください。

トークン検索（シンボルをアドレスに解決）

zerion search <query>                    # by name, symbol, or address
zerion search PEPE --chain ethereum
zerion search MON --chain monad
zerion search "uniswap" --limit 5

チェーンの検証

zerion chains                            # full chain catalog

--chain／--to-chain／--from-chain を指定する前に、チェーン ID がサポートされていることを確認するために使用します。

出力とグローバルフラグ

フラグ	説明
--wallet <name>	送金元ウォレット（デフォルト：設定の値）
--to-wallet <name>	bridge の送金先ウォレット（Solana ↔ EVM）
--to-address <addr>	bridge の送金先アドレス（宛先チェーンの形式と一致する必要があります）
--to <addr>	send の受取人アドレス
--slippage <pct>	スリッページ許容値（デフォルト 2%、最大 3%）
--timeout <sec>	承認のタイムアウト（デフォルト 120s）
--json / --pretty / --quiet	出力モード（デフォルトは JSON）

取引前の安全チェックリスト

1. エージェントトークンが正しいウォレットに紐付いていることを確認する — zerion agent list-tokens でウォレットの紐付けを確認できます。
2. ポリシーで操作が許可されていることを確認する — zerion agent list-policies（例：--deny-transfers は send による直接送金をブロックし、--chains base は他のチェーンでのスワップをブロックします）。
3. スリッページ — デフォルトは 2% です。ステーブルペアでは小さめ（0.5%）、流動性の低いトークンでは大きめ（3～5%）に設定します。
4. クロスチェーンのタイムアウト — ブリッジには 1～5 分かかる場合があります。時間のかかるルートでは --timeout 300 を使用してください。

よくあるエラー

コード	原因	対処法
no_agent_token	取引にはエージェントトークンが必要です	zerion-agent-management スキルを使用してください
policy_denied	有効なポリシーによって操作がブロックされました	agent show-policy <id> を確認し、ポリシーを変更するか、制限のないトークンを使用してください
unsupported_chain	無効なチェーンです	zerion chains を実行してください
insufficient_balance	<from-token> の残高が不足しています	zerion portfolio --wallet <name> で確認してください
quote_failed	トークン間／チェーン間のルートがありません	別のペアまたはチェーンを試してください
slippage_exceeded	価格が --slippage の許容範囲を超えて変動しました	スリッページを増やすか、再試行してください
tx_timeout	--timeout 内に承認が完了しませんでした	タイムアウトを延長し、エクスプローラーでトランザクションハッシュを確認してください
invalid_destination	クロスチェーンの送金先が指定されていないか、形式が正しくありません	--to-chain の形式に合った --to-wallet <name> または --to-address <addr> を指定してください