秘密鍵をCursorに貼り付けるのはやめよう：コーディングエージェントにウォレットを持たせる方法

あなたは開発の真っ只中にいる。Cursor内のエージェントはコントラクト呼び出しを書き終え、ネットワークも選択し、テストトランザクションを送信する準備ができている。計画と署名済みトランザクションの間にあるのは、鍵だけだ。そこであなたは秘密鍵をエージェントが読み取れる.envファイルに貼り付け、作業を続ける。

この一手順こそが、多くの経験豊富な開発者が実際の資金に関わるものからAIを遠ざけている理由だ。秘密鍵はオール・オア・ナッシングだ。一度エージェントがそれを読み取れるようになれば、そのウォレット内のすべてを、どのチェーンでも、恒久的に、取り消す手段なく動かせるようになる。そしてエージェントは設計上確率的だ。ほとんどの場合は非常に優秀だが、時々自信満々に間違える。

もっと良いやり方がある。鍵を渡さずにウォレットをエージェントに渡すのだ。以下はAlchemy CLIのagent walletsでそれがどう機能するか、そして実際の限界がどこにあるかについてだ。

問題は鍵であって、エージェントではない

エージェントをリスクとして扱いたくなるが、エージェントは本当の問題ではない。秘密鍵はそもそも共有されることを想定して設計されていない。「これだけの金額まで送信可能」「これらのチェーンのみ」「次の1時間だけ」「今すぐ停止」といった概念は一切ない。単一の秘密が完全な制御権を与え、それを使う唯一の方法はそれを露出させることだ。

これまで、開発者には2つの選択肢があり、どちらも実際のコストを伴った。鍵を.envに貼り付けて、エージェントが資金を完全に制御することを受け入れる方法もある。これは、迷ったプロンプト一つでウォレットが空になるリスクと隣り合わせだ。あるいは、ウォレットSDKをカスタムバックエンドに組み込み、認証・署名・失効の仕組みを自分で作り直す方法もある。これはほとんどのチームが引き受けるべきではない何週間もの作業だ。前者はリスクが高すぎ、後者はコストが高すぎる。

実際に欲しいのは、スタックの他の場所ですでにアクセスについて考えている方法に近いものだ。ルートパスワードを配布したりはしない。スコープ付きの認証情報を発行し、それができることを設定し、終わったら失効させる。ウォレットも同じように機能すべきだ。

Agent walletsの仕組み

Alchemy CLIのagent walletsを使えば、ダッシュボードからウォレットを作成し、ターミナルにスコープと期限が定められたセッションを付与し、エージェントにコマンドラインから実際のトランザクションを送信させることができる。秘密鍵はCLIに触れることも、Alchemyに触れることも、.envファイルに置かれることもない。これは3つの層として捉えると分かりやすく、それぞれ異なる主体が所有している。

カストディ層：鍵は他の誰かが保持する

ウォレットの秘密鍵は、当社のembedded wallet partnerであるPrivyが、彼らのインフラ上で保持している。あなたのノートパソコンにも、リポジトリにも、当社のシステムにもない。これがリスク計算を変える要因だ。.envに貼り付けようとしていた秘密は、今やあなたもエージェントも直接扱うことのないものになる。

セッション層：エージェントは秘密ではなく権限を得る

alchemy wallet connectを実行すると、CLIはあなたのマシン上で新しいP-256キーペアを生成し、そのペアの秘密側はデバイスから離れることはない。ブラウザがAlchemyダッシュボードを開き、そこでウォレットを選択しセッションを承認する。承認によって、あなたのCLIの公開鍵がそのウォレットの署名者として追加され、特定の機能にスコープされ、あなたが設定した有効期限で制限される。

それ以降、すべての署名呼び出しは2段階のチャレンジになる。当社のバックエンドがPrivyが期待する正確なペイロードを構築し、あなたのCLIがそのまさに正確なバイト列をローカルで署名し、その後初めてリクエストがPrivyに届く。セッションが期限切れになっているか、失効しているか、何らかのバインディングチェックに失敗した場合、次の署名試行は当社のインフラを離れる前に拒否される。エージェントはそれが保持する秘密を通してではなく、あなたが定義したセッションを通して動作している。

コントロール層：キルスイッチはあなたが持つ

ダッシュボードは、ウォレットが作成または失効される唯一の場所であり、失効はワンクリックで即座に反映される。ターミナルからalchemy wallet disconnectを実行することもできる。セッションが意図しないことを始めたら、それを終了させれば署名は止まる。セッションが正しく振る舞うことをただ願うしかない状態には決してならない。いつでも終了させられるからだ。

エージェントが実際にできること

セッションが有効になると、エージェントは完全なトランザクションのサーフェスを扱えるようになる。EVMチェーンでは、ネイティブトークンとERC-20の送信、コントラクト呼び出し、ERC-20承認の管理、スワップ、mainnet間のブリッジが可能だ。Solanaでは、SOLとSPLトークンを送信できる。トランザクションはWallet APIsを通じて実行されるため、Gas Managerによるガススポンサーシップ、バッチ処理、自動リトライ、ERC-20によるガス支払いもそれに付随する。

CLIはエージェント向けのツールサーフェスとして構築されているため、あなたのエージェントはこれらのコマンドを自力で習得する。--jsonフラグは構造化された出力を返し、--no-interactiveはコマンドがプロンプトでブロックされるのを防ぎ、alchemy agent-promptはすべてのコマンド、フラグ、エラーコードを記述したJSONドキュメントを出力する。それをシステムプロンプトに投入すれば、エージェントはそのサーフェス全体を一度に学習する。統合すべきSDKはなく、ドキュメントから推測すべきものも何もない。

誰のためのもので、どのようなフローに適合するか

これはCursorやClaude Codeで暮らし、オンチェーンで開発する開発者のためのものだ。DeFiプロトコルを統合する人、決済フローを組み立てる人、コントラクトをテストする人であり、署名が必要な時点で止まるのではなく、エージェントに実際にトランザクションを実行させたい人だ。エージェントにコードを書かせ、オンチェーン部分を自分で手動で仕上げたことがあるなら、これがそのギャップを埋める。2つのフローがそれがどこで役立つかを示している。

1つ目はビルド・アンド・テストのループだ。あるプロトコルと統合していて、エージェントがコードを書いた。それが実際に機能するかを知るには、誰かが実際のトランザクションを送信しなければならない。コントラクトに資金を投入し、呼び出し、結果の状態を確認し、調整し、再び実行する。これを手動で行うということは、すべてのトランザクションを自分で承認し貼り付けることを意味し、それはまさにエージェントを導入して取り除きたかった単調な作業そのものだ。セッションを使えば、ウォレットを作成し、少額の残高を入金し、短い期限にスコープされたセッションを承認し、エージェントにループ全体を実行させることができる。エージェントは送信し、結果を読み取り、繰り返す。あなたはそれを見守り、セッションが期限切れになれば、そのアクセスは自動的に終了する。

2つ目は、複数ステップのオンチェーンタスクを実行するエージェントだ。作業の中には、単一の呼び出しではなく一連のシーケンスであるものもある。mainnetでトークンをスワップし、収益をL2にブリッジし、それからポジションに預け入れる、といった具合だ。結果を記述し、各ステップを自分で実行する代わりに、エージェントにセッションを通してそのステップを実行させることができる。セッションはエージェントがどの機能を、どのくらいの期間使えるかを制限する——動かせる量を制限するわけではない——ので、タスクに必要な分だけウォレットに資金を入れ、短い期限を設定し、終わったら失効させる。

境界についての正直な視点

資金を扱うツールは、作り手がその限界について明確であるほど信頼しやすくなる。本番環境でこれに頼る前に知っておく価値のある限界がいくつかある。

ガスと手数料のスポンサーシップポリシーはトランザクション手数料を制御する。ウォレットの支出上限ではないので、Gas Managerのポリシーをエージェントが動かせる金額の上限として扱ってはならない。スワップとブリッジは現時点ではEVM mainnetのみだ。セッション署名者は直接の生のEVMトランザクション署名を行わない。アクションはwallet_prepareCallsやwallet_sendCallsといったAlchemy Wallet API呼び出しを通じて実行される。そしてセッションは、ダッシュボードであなたが設定した通りに正確にスコープされる。つまり、あなたが設定した期限と機能こそが実際の境界であり、単なる提案ではない。

これらはどれも回避策ではなく、システムがそのように機能するよう意図されたものだ。ウォレットがカストディを保持し、セッションが権限を運び、あなたはそれを終了させる能力を持ち続ける。

はじめ方

CLIのagent walletsは現在利用可能で、待機リストも別料金プランもない。Node 22以上とAlchemyアカウントが必要だ。エージェントが制御可能なウォレットに至るには3つのコマンドで済む。

connectのステップでダッシュボードが開き、そこでセッションを承認し、そのスコープと期限を設定する。状態を変更するワークフローの前には、まずエージェントにセッションを検証させる。

作業が終わったら、セッションを終了する。

オンチェーンで最も要求の厳しいプロダクトを構築しているチームは、すでにAlchemy上で動いており、100以上のチェーンにわたり年間1兆ドル以上を動かしている。agent walletsの要点は、その同じインフラが今や、鍵を渡すことなく、あなたのコーディングエージェントに渡すウォレットを支えているということだ。秘密鍵をCursorに貼り付ける代わりに、エージェントにスコープされたセッションを与え、いつでも失効させる能力を保持できる。

agent walletsのドキュメントを読む、Alchemy for agentsを探索する、あるいはCLIをインストールして試してみてほしい。

FAQ

秘密鍵を共有せずに、AIコーディングエージェントにウォレットを与えるにはどうすればよいですか?

Alchemyダッシュボードでウォレットを作成し、ターミナルでalchemy wallet connect --mode sessionを実行してください。CLIがローカルでキーペアを生成し、ダッシュボードがスコープと期限付きのセッションを承認します。エージェントはそのセッションを通じてトランザクションを送信し、秘密鍵はウォレットプロバイダーの元に留まり、決して露出しません。

秘密鍵は実際にどこに保存されているのですか?

ウォレットの秘密鍵は、Alchemyのembedded wallet partnerであるPrivyが、彼らのインフラ上で保持しています。それがあなたのマシンやリポジトリ、.envファイルに書き込まれることは決してなく、CLIやAlchemy自身のシステムに触れることもありません。エージェントは鍵自体ではなく、承認されたセッションを通じて動作します。

エージェントのウォレットへのアクセスを失効させることはできますか?

はい。Alchemyダッシュボードからワンクリックでセッションを失効させるか、ターミナルでalchemy wallet disconnectを実行してください。失効は即座に反映され、そのセッションからの次の署名試行は拒否されます。セッションは、承認時に設定した時刻になると自動的に期限切れにもなります。

agent walletでエージェントは何ができますか?

EVMチェーンでは、エージェントはネイティブトークンとERC-20の送信、コントラクト呼び出し、承認の管理、スワップ、mainnet間のブリッジを行えます。Solanaでは、SOLとSPLトークンを送信できます。トランザクションはAlchemyのWallet APIsを通じて実行されるため、ガススポンサーシップ、バッチ処理、リトライ、ERC-20によるガス支払いが利用可能です。

スポンサーシップポリシーはエージェントが使える金額を制限しますか?

いいえ。ガスと手数料のスポンサーシップポリシーはトランザクション手数料を制御するものであり、ウォレットの残高を制御するものではありません。これらは支出上限ではありません。エージェントができることの実際の境界は、ダッシュボードでセッションに設定した機能と期限です。したがって、セッションは意図的にスコープしてください。

始めるには何が必要ですか?

Node 22以上とAlchemyアカウントが必要です。CLIのagent walletsは待機リストも別料金プランもなく利用可能です。npm i -g @alchemy/cli@latestでインストールし、alchemy authを実行した後、alchemy wallet connect --mode sessionでダッシュボードからセッションを承認してください。