zerion

Zerion

14 の EVM チェーンと Solana に対応する、暗号資産ウォレット向けの統合 API ＋ CLI です。zerion バイナリは npm から提供されます。このスキルは、すべての Zerion 機能のエントリーポイントです。機能やパートナーのドキュメントはネストされたファイルにあり、必要に応じて読み込まれます。

セットアップ — 実行前に確認してください

スキルは zerion バイナリを呼び出します。各セットアップ手順は何度実行しても安全なので、まず状態を確認し、不足している作業だけを行ってください。

zerion --version     # needs 1.11.0+ — older CLIs ignore --quote and run the swap or bridge instead of pricing it
zerion wallet list   # which wallets exist, and whether the user's address is one of them

• zerion が見つからない、またはバージョンが 1.11.0 より古い → npx -y zerion-cli@latest init -y。CLI とこのスキルをインストールまたはアップグレードします。既存のログイン状態とウォレットは保持され、処理がブロックされることはありません。
• API キーがない — init が "next": "zerion login --browser" を報告する場合、またはコマンドが missing_api_key で失敗する場合 → zerion login --browser をバックグラウンドで実行してください。ユーザーによる承認を最大 5 分間待ちます。標準エラー出力に表示される URL をすぐにユーザーに伝え、待っている間も読み取り専用の調査を続けてください。
• ユーザーが指定したアドレスが wallet list に表示されない → 読み取り専用で登録してください：zerion wallet add <address> --name <name>。秘密鍵、パスフレーズ、エージェントトークンは不要です。すべてのトランザクションは app.zerion.io に送られ、ユーザーが署名します。
• コマンドが unsupported_node で失敗する → ユーザーの Node.js が古すぎます（下記の最小バージョンを参照）。エラーメッセージの提案に従ってアップグレードするよう伝えてください。依存関係にパッチを適用したり、回避用のパッケージを作成したりしないでください。
• シェルコマンドを実行できない → 推測せず、その旨を伝えてください。
• サンドボックス化されたエージェント（例：Codex のデフォルトサンドボックス）：init と login にはネットワークアクセスとワークスペース外への書き込み（グローバル npm インストール、~/.zerion）が必要です。回避策を探すのではなく、そのための許可を求めてください。

Node.js ≥ 22.12（または Node 20 では ≥ 20.19）が必要です。npm パッケージは zerion-cli、インストールされるバイナリは zerion です。

認証

3 つの方式があります。分析にはいずれかを選択してください。取引には常に API キーを使用します。

A) API キー（推奨）

zerion login --browser               # approve in the browser; the key is saved to config
export ZERION_API_KEY="zk_dev_..."   # or set one you already have

dashboard.zerion.io で取得してください。開発者キーは zk_dev_ で始まります。制限：120 リクエスト／分、5K リクエスト／日。

B) x402 従量課金（登録不要、分析のみ）

x402 protocol 経由で、リクエストごとに $0.01 USDC を支払います。EVM（Base）または Solana に対応しています。

export WALLET_PRIVATE_KEY="0x..."     # EVM (Base) — 0x-prefixed hex
export WALLET_PRIVATE_KEY="5C1y..."   # Solana — base58 keypair
zerion portfolio <address> --x402

# Or enable globally
export ZERION_X402=true

両方のチェーンを同時に使用する場合：

export EVM_PRIVATE_KEY="0x..."
export SOLANA_PRIVATE_KEY="5C1y..."
export ZERION_X402_PREFER_SOLANA=true   # optional

C) MPP 従量課金（分析のみ、EVM Tempo）

Tempo 上の MPP 経由で、リクエストごとに $0.01 USDC を支払います。

export TEMPO_PRIVATE_KEY="0x..."      # or reuse WALLET_PRIVATE_KEY
zerion portfolio <address> --mpp

# Or enable globally
export ZERION_MPP=true

取引コマンド（swap、bridge、send）は、ZERION_X402／ZERION_MPP の設定にかかわらず、常に API キーを使用します。ローカルでの署名にはエージェントトークンも必要です。読み取り専用ウォレットでの署名はウェブアプリで行うため、エージェントトークンは不要です。

機能 — 必要に応じて読み込む

以下の機能を実行する前に、コマンド、フラグ、例外ケース、使用例の全容を確認するため、該当するファイルを読み込んでください。

タスク	読み込むファイル
ウォレット分析：ポートフォリオ、ポジション、履歴、PnL、ウォッチリスト	capabilities/analyze.md
オンチェーン取引：スワップ、ブリッジ、送金	capabilities/trading.md
ブラウザー上での人間による確認：読み取り専用ウォレット、確認しきい値、--review	capabilities/trading.md § "署名ルートとウェブアプリへの引き継ぎ"
複数のアクションを1つの署名セッション／確認にまとめる（--prepare + bundle）	capabilities/bundle.md
オフチェーン署名：EIP-191 メッセージ、EIP-712 型付きデータ	capabilities/sign.md
ウォレット管理：作成、インポート、読み取り専用ウォレットの追加、一覧表示、資金の追加、確認しきい値、バックアップ、エクスポートキー、削除	capabilities/wallet.md
自律取引のためのエージェントトークンとセキュリティポリシー	capabilities/agent-management.md
0x Swap API v2（直接統合、Permit2/AllowanceHolder、ガスレス）	capabilities/swap-0x.md
DeFi ポジションの解消：出金、ステーキング解除、償還、報酬の請求、返済	capabilities/defi-exit.md

複数の機能を組み合わせるリクエスト — 作業を段階に分け、それぞれに対応するファイルを読み込んでください。「すべてのポジションを解消して、Blast 上のトークンを売却し、その後すべてを Ethereum に移す」は、analyze.md（保有状況を確認）→ defi-exit.md（プロトコル上の処理）→ trading.md（Blast 上でスワップし、その後ブリッジ）→ bundle.md（各ステップにつき1つの署名セッション）です。

組み合わせのルール：

• ローカルで署名するにはエージェントトークンが必要です。ユーザーがトークンを持っていない場合は、まず capabilities/agent-management.md を参照してください。読み取り専用ウォレット（wallet add）では、すべてのトランザクションにウェブアプリで署名し、トークンは不要です。
• 取引前に分析を実行して、残高とポジションを確認してください。

オンチェーンのタスクすべてに適用されるルール

これらは、1回のスワップ、DeFi ポジションの解消、「Blast 上のすべてを売却して Ethereum に移す」など、トランザクションで完了するあらゆる作業に適用されます。

状態の読み取り

• リクエストの範囲はユーザーが指定し、CLI はその範囲内に何が存在するか、またその数量がどれだけかを確認するための信頼できる情報源です。読み取り結果に含まれていても、ユーザーが依頼していないポジションやトークンには手を付けないでください。ユーザーが指定したものが見つからない場合は、その旨を伝えてください。ポートフォリオ全体を出力するのではなく、--chain、--defi、または --positions で読み取り範囲を指定してください。
• 取引する数量については、オンチェーンの正確な生の残高を読み取ってください（eth_call → balanceOf）。positions の丸められた数値は使用しないでください。切り上げられた数量を使うと、最後の wei の処理でリバートする可能性があります。$ETH_RPC_URL が設定されていればそれを使用してください。設定されていない場合は、zerion chains --json の rpcUrls を順に試し、エラーになるもの、または eth_chainId がチェーンの chainIdHex と一致しないものはスキップしてください。これらは公開エンドポイントなので、キーは不要です。ブラウザーに似た User-Agent を送信してください。一部の公開エンドポイントではデフォルトのものが拒否されるためです。どのエンドポイントからも応答がない場合は、自分で RPC を選ぶのではなく、そのチェーンを読み取れないと伝えてください。
• チェーンで何かができないとユーザーに伝える前に、zerion chains を確認してください。 ガス代と受取額 — 署名リンクを作成する前に
• 各アクションについて、すべての処理のガス代を合計します（承認、請求、スワップはそれぞれガス代がかかります）。実際の呼び出しに対する eth_estimateGas × 現在の手数料 × CLI 出力にあるネイティブトークンの価格で算出します。その額を、スワップ手数料と価格への影響を差し引いた後、実際にウォレットに戻る額と比較します。
• コンバージョンの価格を確認するには zerion swap <chain> <amount> <from> <to> --quote、チェーン間の移動の価格を確認するには zerion bridge … --quote を使います（すべてのルートを表示し、ルートが1つだけの場合も実行はしません）。どちらも、ウォレットに入力トークンがなくても動作します（例：請求で受け取るトークン）。その場合は enoughBalance: false と表示され、ネットワークガス代とプロトコル手数料を含まない参考価格が示されるため、両方を考慮してください。CLI の内部機能をインポートしたり、より正確な額を得るために他人のアドレスで見積もりを取ったりしないでください。
• 受取額がガス代を十分に上回る → 続行します。ガス代が受取額と同程度、またはそれ以上 → 停止して確認します。各項目のガス代、受取額、差引額をドル建てで示し、問題のある項目をすべて1つのメッセージにまとめてから、返答を待ちます。黙って省略したり、そのまま進めたりしないでください。
• 各トランザクションが価値を移動させることを eth_call で確認し、何もしない処理は省略します（その処理と省略する理由を伝えます）。トークンに取引先がない場合は、その旨を伝えて停止します。見積もりが繰り返し失敗する状態で再試行しないでください。

トランザクションの作成

• スワップ、ブリッジ、送金には zerion swap／bridge／send を使います。これらのコマンドは見積もり、価格設定、スリッページ設定、承認処理を行います。スワップ、送金、承認を生のコールデータとしてエンコードしてはならず、DEX やアグリゲーターの API を自分で呼び出してもいけません。見積もりとトランザクションには、必ず同じルートを使ってください。
• 手動で作成するのは、どのコマンドにも対応していないプロトコル固有の呼び出し（出金、ステーキング解除、償還、請求、返済）のみです。capabilities/defi-exit.md を参照してください。
• すべての swap、bridge、send で、バンドルに含めるための --prepare 実行も含め、毎回 --wallet <name> を明示します。デフォルトのウォレットに依存しないでください。（bundle 自体は、各グループの address から署名者を取得します。）
• 残高全額を売却する場合は、オンチェーンの正確な額より少し少ない額で見積もりを取り（切り捨て、切り上げはしない）、端数は許容します。
• ユーザーから別の指定がない場合、スリッページは次のとおりです。ステーブルコイン間は --slippage 0.3、それ以外は --slippage 1。
• 関連するトランザクションは zerion bundle でまとめ、ユーザーが一度だけ署名すればよいようにします（capabilities/bundle.md）。先行する処理で受け取るトークンを使う処理は、同じバンドルに含められません。--prepare と bundle は、将来の入金ではなくウォレットの現在残高を確認します。先行する処理を送信し、オンチェーンでの確定を待ってから、次の処理を準備してください。 署名
• Web アプリ経由（読み取り専用ウォレット、レビューしきい値、--review）では、署名リンクを開いても何も実行されません。ユーザーの署名が承認になります。プランとリンクを同じメッセージに記載し、先に確認を求めるために止まらないでください。上記のガスチェックだけが例外です。ローカル経由では、CLI がすぐに署名してブロードキャストするため、実行前にプランが正しいことを確認してください。
• Web アプリのリンクを共有するときは、ユーザーに表示される内容を伝えてください。リンクを開くと app.zerion.io が表示され、操作前に署名アドレス、残高の変化、手数料、セキュリティチェックを含むレビュー全体が表示されます。その後、ウォレットが未接続の場合は接続を求められます。トランザクションはそのアドレスからしか実行できないため、署名アドレスを所有するウォレットを接続する必要があります。
• swap、bridge、send、bundle はリンクを stderr に出力した後、署名を最大 300 s 待つためにブロックします。バックグラウンドで実行し、数秒以内にリンクを読み取り、すぐに表示してください。
• swap、bridge、send は署名の前に Signing route: <route> — <reason> を stderr に出力し、bundle は Bundle route: <route> を出力します。この行がなければ、コマンドはそこまで到達していません。修正してください。
• timeout または rejected は、CLI が監視を停止したことだけを意味します。ユーザーはその後に署名している可能性があります。何かを再生成する前に、オンチェーン（残高、承認済み使用額、最近のトランザクション）を確認してください。Zerion のインデクサーは数分遅れるため、確認に使わないでください。
• リンクは、それを出力した実行に属します。その実行が終了した後は、同じリンクを再共有しないでください。CLI は結果を監視していませんが、トランザクションはリンクに含まれているため、まだ署名できる可能性があります。チェーン上で何も実行されていないことを確認できた場合は、コマンドを再実行して新しいリンクを取得し、新しいリンクだけに署名するようユーザーに伝えてください。両方に署名すると、操作が二重に実行される可能性があります。
• 複数ステップのフローでは、1 つ目の処理がオンチェーンで確定したらすぐに次の処理を見積もり、依頼されるのを待たずにリンクを送ってください。
• app.zerion.io のリンクを自分で作成することは絶対にしないでください。有効なリンクを生成できるのは CLI だけです。トランザクションは URL フラグメントに含まれています。コマンドに失敗した場合は、コマンドを修正してください。

対象範囲

• 依頼されたことを実行してください。気づいたその他のこと（売却を検討する価値のある別のポジションや、使われていない残高など）は提案として列挙し、その後は待ってください。ユーザーが選んでいないもののリンクを生成しないでください。1 つ選んだからといって、他のものまで対象になるわけではありません。
• ローンとレバレッジポジションは個別に注意喚起してください。どちらかを解消するとヘルスファクターが変動し、残りにリスクが及ぶ可能性があります。

署名ルート — 取引は常にローカルで署名されるとは限りません

すべての取引とメッセージの署名は、自動的に決まる次のいずれかのルートで行われます。署名を行う前に判定されます。

• ローカル署名（デフォルト） — CLI がエージェントトークンをパスフレーズとして署名し、ブロードキャストします。1 回で完了し、無人で実行できます。
• ウェブアプリへの引き継ぎ — CLI がトランザクションを app.zerion.io のリンクにエンコードし、ブラウザーを開いて、人間がそこで署名するまで待機します（デフォルトの待機時間は 300 s）。URL は stderr にも出力されるため、ヘッドレスエージェントはブラウザーが開くのを待つ代わりに、ユーザーに渡すことができます。

次のいずれかに該当すると引き継ぎが行われます。コマンドを無人で完了できるかどうかに影響するため、取引を実行する前に必ず確認してください。

トリガー	設定方法
読み取り専用ウォレット（鍵素材なし）	zerion wallet add <address|ens> --name <name>
売却側の USD 評価額がウォレットのレビューしきい値を超える場合 — 取引のみ	zerion wallet set-review-threshold <wallet> <usd|off>
明示的な強制	コマンドで --review を指定

メッセージには USD 評価額がないため、sign-message / sign-typed-data ではしきい値は無視されます。適用されるトリガーは読み取り専用と --review のみです（capabilities/sign.md）。

CLI はすべての取引で Signing route: <route> — <reason> を stderr に出力し、JSON 出力には signedVia: "local" | "web-app" が含まれるため、どのルートが使われたかを常に確認できます。引き継ぎの結果は completed / rejected / failed / timeout（または Ctrl-C による中断時は aborted）となり、同じ JSON の status として報告されます。終了コード 0 になるのは completed の場合のみで、それ以外の結果では構造化された stderr エラーとともに 0 以外で終了します。無人実行はこれを考慮して計画してください。

例外は consolidate --execute です。これは常にローカルで署名し、ルートを確認しません。スイープは N 個の独立したトランザクションであり、しきい値はトランザクションごとに適用される上限だからです。そのため、鍵素材が必要です。読み取り専用ウォレットでは、すべての行が失敗します。スイープ全体をレビュー経由にするには、代わりに zerion bundle --group "$(zerion consolidate <chain> <token> --prepare)" を使ってください。

詳細は capabilities/trading.md を、読み取り専用ウォレットとしきい値については capabilities/wallet.md を参照してください。

パートナー連携 — オプトイン

これらは、コア CLI を基盤とする特化型のフローです。ユーザーはパートナー名を指定する（または、それに該当するフローを説明する）必要があります。その後、partners/<name>.md を読み込みます。

パートナー	機能	読み込むファイル
Bankr	Twitter/X ネイティブのトレーディングボットのパターン	partners/bankr.md
Li.Fi Earn	クロスチェーンの利回りルーティング	partners/lifi-earn.md
Monad addresses	Monad チェーンのアドレスツール	partners/monad-addresses.md
Moonpay (onramp)	法定通貨から暗号資産へのオンランプ	partners/moonpay-onramp.md
Moonpay (Iron)	Iron ステーブルコインのフロー	partners/moonpay-iron.md
Moonpay (Predict)	予測市場との連携	partners/moonpay-predict.md
Sendai ideas	暗号資産のアイデア発掘と検証、競合マッピング、DeFi TVL 調査	partners/sendai-ideas.md
Somnia (blockchain)	Somnia L1 の運用	partners/somnia-blockchain.md
Somnia (reactivity)	Somnia のリアクティブなスマートコントラクト	partners/somnia-reactivity.md
Trails (cross-chain swap)	クロスチェーンスワップのルーティング	partners/trails-crosschainswap.md
Trails (deposit)	クロスチェーン入金フロー	partners/trails-deposit.md
Umbra	プライベート（ステルスアドレス）送金	partners/umbra-privatetxn.md
Uniswap LP	流動性ポジションの管理	partners/uniswap-lp.md
Uniswap x402	x402 の従量課金でスワップ	partners/uniswap-x402.md
Vaults.fyi (deposit)	ボールトへの入金	partners/vaultsfyi-deposit.md
Vaults.fyi (market intel)	利回り市場のインテリジェンス	partners/vaultsfyi-market-intel.md
Vaults.fyi (rebalance)	ポジションの自動リバランス	partners/vaultsfyi-rebalance.md
Vaults.fyi (risk monitor)	リスクダッシュボード	partners/vaultsfyi-risk-monitor.md
Vaults.fyi (strategist)	複数の戦略を扱う利回りエージェント	partners/vaultsfyi-strategist.md
Vaults.fyi (watchlist)	ボールトのウォッチリスト	partners/vaultsfyi-watchlist.md
Vaults.fyi (yield optimizer)	利回りの最適化	partners/vaultsfyi-yield-optimizer.md
Yellow	複数当事者によるオフチェーン決済ルーム	partners/yellow-settlement-room.md
Consolidate	チェーン上のすべてのトークンを 1 つの対象に集約	partners/consolidate.md
Treasury liquidation	すべてのチェーンにわたるウォレットの資金を引き出す、および／またはマルチチェーンポートフォリオ全体を 1 つのトークンに集約	partners/treasury-liquidation.md

ルール： パートナーのドキュメントを事前に読み込んではいけません。ユーザーがパートナーを明示的に指定するか、それに固有のフローを求めた場合にのみ読み込んでください。

新しいパートナー連携を作成する場合は、partner-skill-creator.md を読み込みます。

出力規約

すべてのコマンドは JSON を標準出力に出力します（デフォルト — エージェントに適した形式）。エラーは構造化 JSON として標準エラー出力に出力されます。

{ "error": { "code": "missing_api_key", "message": "..." } }

フラグ：--json（デフォルト）、--pretty（TTY では自動的に有効化）、--quiet。

対応チェーン

Zerion は 60 以上のチェーンに対応しており、今後も追加されます。チェーンごとに利用できる機能は異なります。一部のチェーンではスワップ と ブリッジ と送金に対応し、送金または読み取りのみに対応するチェーンもあります。そのため、zerion chains（または supportsTrading／supportsBridge／supportsSending フラグに加え、各 EVM チェーンの chainId、chainIdHex、パブリックな rpcUrls を確認できる zerion chains --json）を信頼できる唯一の情報源として使用してください。

⚠️ 以下の静的リストを根拠に、チェーンが非対応だとユーザーに伝えてはいけません。 これはスナップショットであり、チェーンが追加されると古くなります。必要なチェーンがここに記載されていない場合、または特定の操作に対応しているか不明な場合は、作業を止めずに zerion chains を実行し、フラグを確認してください。（14 チェーンしか記載されていなかったこのリストが原因で、エージェントが robinhood、monad、hyperevm、さらに稼働中の約 20 のチェーンについて、「Zerion では移動できない」と誤って報告したことがあります。）

稼働中カタログのスナップショット（zerion chains で確認してください）：0g、abstract、ape、arbitrum、astar-zkevm、aurora、avalanche、base、berachain、binance-smart-chain、blast、bob、celo、cronos-zkevm、cyber、degen、ethereum、fantom、fraxtal、gravity-alpha、hyperevm、ink、katana、lens、linea、lisk、manta-pacific、mantle、megaeth、metis-andromeda、mode、monad、okbchain、opbnb、optimism、plasma、polygon、polygon-zkevm、polynomial、rari、re-al、redstone、robinhood、ronin、scroll、sei、solana、somnia、soneium、sonic、swellchain、taiko、tempo、tomochain、tron、unichain、wonder、world、xdai、xinfin-xdc、zero、zkcandy、zklink-nova、zksync-era、zora。

Solana は、同一チェーン内のスワップと、EVM チェーンとの双方向ブリッジに対応しています。形式の異なるチェーン間のブリッジ（Solana ↔ EVM）では、対象チェーンの形式に合った宛先を --to-wallet <name> または --to-address <addr> で明示する必要があります。

コマンド形式：

• 同一チェーン内のスワップ：zerion swap <chain> <amount> <from-token> <to-token>
• クロスチェーンブリッジ：zerion bridge <from-chain> <from-token> <amount> <to-chain> <to-token>

すべてのフラグについては capabilities/trading.md を参照してください。

メタデータ付きの最新カタログを確認するには、zerion chains を使用してください。

よくあるエラーコード

コード	原因	対処方法
missing_api_key	ZERION_API_KEY が設定されていません	環境変数を設定するか、分析には --x402 を使用してください
no_agent_token	取引／署名用のエージェントトークンがありません	capabilities/agent-management.md を参照してください
no_wallet	ウォレットが指定されておらず、デフォルトもありません	--wallet <name> を指定するか、defaultWallet 設定を指定してください
wallet_not_found	ローカルのボルトにウォレットがありません	zerion wallet list で確認してください
unsupported_chain	--chain の値が無効です	有効な ID は zerion chains で確認してください
readonly_chain_mismatch	読み取り専用ウォレットのアドレス形式が、明示的に指定されたチェーンと一致しません	EVM（0x…）の読み取り専用ウォレットは Solana で署名できず、その逆も同様です。読み取りコマンドには --chain は不要です
api_error 401	API キーが無効です	dashboard.zerion.io でキーを確認してください
api_error 429	レート制限に達しました	待機する、頻度を下げる、または x402 に切り替えてください

キー管理

キーストアウォレットは、Open Wallet Standard（OWS）ボルト（~/.ows/）を介して AES-256-GCM で暗号化されます。秘密鍵がデバイスの外に出ることはありません。ローカルルートでは、ここで署名が行われます。Zerion API がキーを受け取ることはありません。

読み取り専用ウォレットはキー情報を一切保持せず、~/.zerion/readonly-wallets.json に名前とアドレスのみを保存します。そのため、署名は上記のウェブアプリへの引き渡しを通じてのみ行われます。

~/.zerion/config.json（モード 0o600）には、エージェントトークン、レビューしきい値、デフォルトのウォレット、デフォルトのチェーン、スリッページが保存されます。

リソース

• API ドキュメント：developers.zerion.io
• ダッシュボード：dashboard.zerion.io
• x402 プロトコル：x402.org
• CLI ソース：github.com/zeriontech/zerion-ai