Alchemy CLIで速くできる12のこと

オンチェーンプロジェクトは、かつてどれも同じ手順で始まっていた。ダッシュボードを開き、APIキーをコピーし、秘密鍵を.envに貼り付け、npm installで3つのSDKを入れ、ようやく本題のコードを書く。コーディングエージェントは、どのRPCメソッドを呼ぶべきか調べるだけでセッションの半分を費やしていた。Alchemy CLIは、このセットアップにかかる手間を、パイプしたり、スクリプト化したり、コーディングエージェントに渡せるコマンドに圧縮する。ターミナルが、オンチェーンへの最短経路になる。

この記事では、CLIが1つのコマンドでこなす12個の処理を紹介する。サインイン、エージェントウォレットの起動、任意のチェーンの読み取り、書き込みのシミュレーション、トークン送信、スワップ、ブリッジ、そして同じツールをCursor、Claude Code、Codexに組み込むこと。紹介するコマンドはすべて今日から使える。

Alchemy CLIとは

Alchemy CLIは単一のnpmパッケージ、@alchemy/cliであり、我々が提供するすべてのAPI surface(Core RPC、Data API、swap、bridge、simulate、webhook、admin、wallet)を一貫したサブコマンドのセットでラップしたものだ。npm i -g @alchemy/cli@latestで一度インストールし、alchemy authを実行すれば、同じフラグセットがすべてのコマンドで機能する。--jsonをjqにパイプし、--no-interactiveでスクリプトをゲートする。ターミナルで動く同じsurfaceが、AIコーディングエージェントの中でも動く。

要点はこうだ。これまでダッシュボードやSDK経由で行っていたワークフローが、開発者がスクリプト化でき、エージェントが呼び出せる1本のコマンドラインに圧縮される。

認証とアイデンティティを1つのターミナルで

1. alchemy authで一度サインインする

alchemy authはブラウザを開き、アカウントにサインインさせ、セッションをディスクに保存する。すべてのプロジェクトのすべての.envにAPIキーを貼り付ける必要はもうない。alchemy auth login --forceでチームを切り替え、alchemy auth statusで状態を確認し、alchemy auth logoutでクリアする。

「キーをコピーし、貼り付け、gitignoreに入れ、ローテーションする」というループを、プロジェクトごとに繰り返してきたのが、この1コマンドで置き換わる。

2. alchemy wallet connectでエージェントウォレットを起動する

CLIにはPrivyがカストディを担うエージェントウォレットが同梱されている。Privyは埋め込みウォレットのプロバイダーで、ウォレットの秘密鍵を自社側で保持する。alchemy wallet connect --mode sessionはローカルで新しいP-256鍵ペアを生成し、Privyのバックエンドに時限付きのセッションを登録し、2段階で署名する。CLIがセッションキーのペイロードに署名し、Privyがウォレットに署名する。秘密鍵はPrivyの外に出ることはなく、セッションキーもデバイスの外に出ることはない。

ダッシュボードから、またはalchemy wallet disconnectで失効させれば、そのセッションは即座に使えなくなる。ローカル鍵を使うワークフローにはalchemy wallet connect --mode local --chain evm --import ~/.wallet/keyを使う。どちらの方法でも、秘密鍵が.envの中に置かれることはない。

3. --x402で従量課金にする

任意のコマンドに--x402を設定すると、CLIは接続済みのウォレットで我々のAPIに対して認証を行う。APIキーは使わない。リクエストが有料のエンドポイントに当たると、そのエンドポイントはHTTP 402を返し、CLIがx402の支払いペイロードに署名し、リクエストが完了する。x402はCoinbaseが公開しているHTTPネイティブな支払いのためのオープンな仕様で、決済はBase上のUSDCで行われる。エージェントはわずか1ドルのコンピュートクレジットから始められ、ダッシュボードへの登録は不要だ。

これで、エージェント(あるいは一度も登録したことのない人間の開発者)が、本番のワークロードが叩いているのと同じAPIにアクセスできる。APIキーも、ダッシュボードも、契約も不要だ。

fetchのボイラープレートを書かずに任意のチェーンを読む

4. 任意のチェーンで任意のJSON-RPCメソッドを叩く

alchemy evm rpcは、任意のJSON-RPCメソッドを、-nで選択したネットワークにそのまま渡す。fetchのエンベロープを手書きする必要も、5行のスクリプトのためにSDKをインストールする手間もない。

Solanaの場合、JSON-RPCにはalchemy solana rpcを、Digital Asset Standardのメソッドには alchemy solana dasを使う。形式は、サポートしているすべてのチェーンで同じままだ。

5. マルチチェーンのポートフォリオを1回の呼び出しで取得する

alchemy evm data portfolio tokensは、あるウォレットが関わったすべてのチェーンにまたがるトークン残高を返す。7つのRPCプロバイダーをつなぎ合わせる必要も、チェーンごとにeth_callを各ERC-20コントラクトに叩く必要もない。

NFTコレクションについても同じことをするにはportfolio nftsを組み合わせる。これらと同じエンドポイントが、本番環境で我々のData APIのインデクサーを支えている。

6. 残高、転送履歴、NFTを一行のコマンドで問い合わせる

残高、トークンのメタデータ、転送履歴、NFTは、それぞれData API surface上の単一のサブコマンドとして提供されている。--metadataを付けると、名前、シンボル、decimals、ロゴURLがインラインで返る。

かつては4つの異なるSDKクライアントにまたがっていた読み取り処理が、いまでは1つのCLI上の4つのフラグとして提供される。

シェルからトランザクションを書き込む

7. 送信前にシミュレートする

alchemy evm simulate asset-changesは、あるトランザクションが引き起こすトークンとETHの動きすべてについて、人間が読める形の差分を返す。simulate executionはフルトレースを返す。読み手は、そのコールがオンチェーンに反映される前に、それが実際に何をするのかを正確に把握できる。

メインネットの資金を扱うevm sendやcontract callを実行する前には、これを実行しておく。「ホットウォレットを壊してやり直す」という事態を防げる。

8. ENS名宛に一行で送金する

alchemy evm sendはENSを解決し、ガスを処理し、現在アクティブなウォレット(セッション、ローカル、Privyカストディのいずれか)で署名する。--x402と組み合わせれば、同じ呼び出しが手順2で接続したウォレットを経由する。

9. 同じシェルからapprove、swap、bridgeを行う

alchemy evm swap executeは、同一チェーン内のスワップを見積もりから実行まで一貫して処理する。alchemy xchain bridge executeはクロスチェーン版だ。alchemy evm approveは、どのDEXスワップでも最初に必要になるERC-20のallowanceを処理する。

Alchemy CLIのドキュメントによれば、同一チェーンでのスワップはEthereum、Base、Arbitrum、Optimism、Polygon、BSCを含む11のEVMメインネットで利用できる。クロスチェーンのブリッジも今日時点でCLIから利用できる。ダッシュボードのウィザードが、シェル上の3行に圧縮される。

コーディングエージェントにCLIを組み込む

10. alchemy agent-promptで完全なエージェントマニフェストを出力する

alchemy agent-promptは、すべてのコマンド、フラグ、エラーコード、実行例を記述したJSONドキュメントを出力する。これをエージェントのシステムプロンプトにパイプすれば、エージェントはフラグ名を推測しなくてよくなる。

このマニフェストには、実行ポリシー、事前チェック、認証マトリクス、オプション付きのコマンドツリー、リトライ仕様付きのエラーカタログ、実行可能な例が含まれている。Cursor、Claude Code、Codex、その他どのコーディングエージェントでも、このファイルをそのままシステムプロンプトに組み込める。実践例はHow to build onchain agentsを参照。

11. Alchemy Skillsをインストールする

alchemy install skillsはAlchemy Skillsバンドルをエージェントクライアントにインストールする。Skillsは、コーディングエージェントに、実行時にドキュメントを読まずにCLIの使い方を教える、機械可読なワークフローだ。

このバンドルは4つのsurfaceをカバーする。CLI自体、APIキー経由のアプリ統合、MCP、そしてウォレットベースの支払いフローだ。1つのコマンドで、「エージェントが毎セッションドキュメントを読み漁る」状態から、「エージェントがすでにワークフローを知っている」状態に切り替わる。

12. MCPを接続する

alchemy install mcpはAlchemy MCPサーバーをエージェントクライアントに接続する。MCP(Model Context Protocol)は、エージェントが実行時にツールを発見し呼び出せるようにするオープンな仕様だ。ホスト型のサーバーはhttps://mcp.alchemy.com/mcpにあり、admin、すべてのRPCメソッド、Data API surfaceにまたがる150以上のツールを、100以上のチェーンに対して公開している。

Claude Codeの場合は次の通り。

Skills、エージェントプロンプト用のマニフェスト、そしてMCPが揃うことで、CLIはエージェントのツールインベントリの中で二次的な依存先ではなく、第一級の機能になる。

5回の呼び出しで完結するエージェントデモ: 利回り比較、ブリッジ、供給

Alchemy Skillsリポジトリに同梱されている定番のデモは、Polygon、Arbitrum、OptimismでUSDCの供給APYを読み取り、0.2 USDCをBaseから最も利回りの高いチェーンへブリッジし、Aave V3に供給する。この記事で扱ってきたのと同じsurfaceを使った、5回のCLI呼び出しだ。

上のデモでは、エージェントがUSDCに最適なAaveマーケットを見つけ、資金を適切なチェーンにブリッジし、プールに預け入れる。今日までは、このワークフローには秘密鍵を保持するカスタムのエージェントコードか、ウォレットSDKとコーディングアシスタントの間の手作りの統合のいずれかが必要だった。いまでは、いくつかのコマンドとダッシュボードのクリックだけで済む。

最初のコマンドを実行する

ここまで12個のコマンドを見てきた。2分で始められる手順は次の通り。インストールし、サインインし、ウォレットを接続し、送信する。

SDKの乱立も、.envに置かれた秘密鍵も、ダッシュボードへの往復も不要だ。どんなオンチェーンのワークフローであれ、CLIは1つのプロンプトからそれを実行する。ターミナルが、オンチェーンへの最短経路になる。