mcpField
4
404-agent-wallet

404-agent-wallet

github.com/notfound-404-officeその他0990 回インストール2 日前に更新
リポジトリ

404-agent-wallet について

404 Agent Walletは、エージェントが同梱CLIで404ウォレット操作を準備・管理するためのスキルです。ローカルでの証明生成、秘密情報の保護、送信前のプレビューと明示的な確認を重視します。

主な機能

  1. 01同梱CLIと証明リソースのセットアップ
  2. 02暗号化ウォレットシードの作成と管理
  3. 03認可パケットの準備と確認
  4. 04実行前のBAWトランザクションプレビュー
  5. 05入金、ミント、注文、ウォレット履歴への対応

活用シーン

  1. 01ブロードキャスト前のウォレット取引準備
  2. 02送信確認前のBAW呼び出しレビュー
  3. 03MarketV2一括購入の見積もりと準備
  4. 04ウォレット単位のノートと注文イベントの同期

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/notfound-404-office/agent-skills --skill 404-agent-wallet

インストール後、Claude Code で/404-agent-walletを入力して読み込まれたか確認します。

詳細

404 Agent Wallet

機能の利用条件: このエージェントがローカルツールを使用できない、またはコードを実行できない場合は、AI Mint を実行できないと伝えて終了してください。証明が生成された、ミントが実行された、またはトランザクションがチェーンに到達したと決して主張しないでください。

404 ウォレットとトランザクションの操作には、同梱の CLI を使用してください。セットアップの前、またはウォレット、プロトコル、Binance Agentic Wallet の操作を行う前に、references/usage.md を読んでください。

エージェントやインストール先にかかわらず、このスキルで実際に読み込まれた SKILL.md のディレクトリを基準にスクリプトの場所を解決してください。そこで node scripts/setup.mjs を一度実行してください。このスクリプトは同梱の SDK、完全な回路と証明アセットを使用し、ロックされたフロントエンドとリレイヤーの依存関係をインストールして、証明リソースを復元します。その後は、ユーザーに SDK パスの設定を求めずに node --experimental-strip-types scripts/404.mjs ... を使用してください。ローカルのチェックアウトでは、任意で --root を指定できます。ホスト固有の隠しディレクトリを前提にしないでください。

境界

  • BSC メインネットのチェーン ID 56 のみをサポートします。チェーン操作には、ローカルで検証済みのデプロイ設定を必須としてください。デプロイアドレスを捏造したり、Sepolia や Launchpad の例を 404 の BSC デプロイとして再利用したりしないでください。
  • 同梱の公開デプロイ設定は config/bsc-mainnet-404.json です。内容を確認したうえで --config を明示して指定してください。秘密鍵は含まれていません。
  • 404 の秘密ウォレットは Binance Agentic Wallet と分離してください。ローカルの暗号化された 404 シードがプライベートノートを管理します。BAW は準備済みの呼び出しを送信し、ガスを提供し、その呼び出しにエンコードされた正確な値を持ち込む場合があります。MetaMask を導入しないでください。
  • 既存の ZK 証明生成器と回路を維持してください。認可の準備時に、ローカルで実際の証明が生成される場合があります。これを置き換えたり、回避したり、モックだと説明したりしないでください。
  • 認可パケットと BAW のプレビュー状態は、所持者が利用できる認証情報として扱ってください。プライベートな 0700 ディレクトリ内の、プライベートな 0600 ファイルにのみ保存してください。
  • 各パケットは、ハッシュで結び付けられた .intent.json ファイルと一緒に保管してください。エンコードされた呼び出しだけでなく、金額、受取人、アクションも確認してください。証明だけでは、プライベートな意図のすべては明らかになりません。重複送信の保護を回避するために、試行記録を削除しないでください。
  • このスキルでは、ミントはツールを利用できるエージェントの経路でのみ実行します。制御されたランタイムまたは安全な認証情報を利用できない場合は、そこで停止してください。手動でウェブミントを行ったと主張して代用しないでください。以降の送信、出金、市場操作については、ユーザーがウェブサイトまたはエージェントを独自に選択できます。
  • Swap や流動性操作を捏造しないでください。このリリースでは単一注文の約定と MarketV2 の一括スイープをサポートしますが、Swap、流動性の追加、流動性の削除のコマンドはサポートしません。
  • 404Bundle は任意で使用できるアトミックアクションのラッパーです。Pool を通じてネイティブ手数料の証明を検証した後、ひも付けられた呼び出しを 1 つ実行します。プロトコル互換性のためにデプロイされていますが、このウォレットスキルから直接呼び出すことはありません。
  • ウォレット履歴はウォレット単位のものであり、Pool の公開トランザクションフィードではありません。シード、証明、ヌリファイアを決して公開しないでください。また、チェーンにもローカルジャーナルにも記録されていないプライベートな意図を推測しないでください。
  • ウォレットアドレスでは、決定的な pm/address/N の導出に --address-index N を指定できます。N=0..255 を使用でき、既定値の N=0 では従来の動作が維持されます。これはローカルでのアドレス導出であり、オンチェーンアカウントは作成されません。

シークレットの取り扱い

  • 404 シードはローカルプロセス内で作成し、プロジェクトの暗号化された保管庫形式でのみ保存してください。有効な24語のバックアップを使えば、同じシードを復元できます。
  • チャットでパスワード、ニーモニック、シード、ウィットネス、完全な証明を要求、受領、表示、貼り付け、読み取りしないでください。シークレットファイルの内容を表示するために cat などを使わないでください。
  • ツールが利用できる App の会話と、その制御されたバックグラウンドランタイムを主要な方法として使用してください。ユーザーは、プラットフォームの Secret manager またはローカルのシークレット用チャネルを通じてパスワードを提供します。パスワードはそのランタイム内の 0600 の --password-file としてのみ公開してください。
  • TTY 入力は、初期化またはメンテナンス用の任意の手段です。ローカルターミナルで入力を非表示にしてパスワードを求め、作成またはインポート時には2回入力を求めてください。パスワード値をコマンドラインに直接渡さないでください。
  • 保護されたパスワードファイルもローカル TTY もない場合は、プライベート操作を中止してください。チャットで認証情報を尋ねたり、実行が成功したと主張したりしないでください。
  • デフォルトではニーモニックのバックアップを作成または表示しないでください。ユーザーが明示的に要求した場合に限り wallet create --mnemonic-file FILE を使用し、その後、0600 のファイルをオフラインストレージに移すよう伝えてください。
  • チャットのみで動作するボットは、このスキルをインストールしただけでファイルシステム、プロセス、ウォレット、トランザクションを操作する権限を得るわけではありません。未実装のウェブインテント/ディープリンクフローが存在すると主張しないでください。

トランザクションのワークフロー

  1. prepare を実行します。ブロードキャストせずに、プライベートな承認パケットを作成し、入力ノートを予約します。
  2. inspect を実行し、チェーン、ターゲット、操作、値、calldata の概要を正確に表示します。
  3. baw preview を実行します。シミュレーションは行いますが、実行はしません。parsedTx、simulationResult、risks、authorityChanges を表示します。
  4. この成功済みで有効期限内のプレビューと、その requestId に対して明示的な確認を得ます。「リスク管理に従って」などの一般的な指示は、トランザクションの確認にはなりません。requireConfirmation=false でも、この会話上の確認要件はなくなりません。
  5. その後に限り、baw execute ... --confirm REQUEST_ID を実行します。自動的に実行しないでください。

プレビューが失敗した場合、有効期限が切れた場合、インターセプトされた場合、またはリスク管理によって拒否された場合は中止してください。管理策を回避したり、プレビュー/実行を自動的にやり直したりしないでください。PENDING_CONFIRMATION または結果不明の場合は、アダプターの baw status のみを実行してください。存在しない baw contract-call status コマンドや result コマンドを作り出さないでください。

ユーザーが準備済みの支払いをキャンセルまたは変更した場合は、prepare void --journal-id ORIGINAL_ID --out NEW_FILE を使用してください。エクスポート済みリクエストの場合、これにより競合する支払いが準備されます。同じ確認済み BAW フローを通じて、このキャンセルを検査して送信してください。チェーン上で確認された場合に限り、古い支払いが無効になり、そのノートが解放されます。資金のロックを解除するためにジャーナルや試行記録を削除しないでください。エクスポート済みキャンセルの準備を繰り返すと、別のものを作成する代わりに、保存済みの承認が復元されます。プライベート入力のないリクエストは、この方法では無効化できません。

ロック解除済みで未予約の資金には balance.available を、回路の2つの入力で支出可能な最大額には balance.max を使用してください。これは総残高ではありません。total には reserved と locked の金額も含まれます。total をすぐに支出可能な額として説明しないでください。

Mint は引き続き1トランザクションにつき1ロット、送信する BAW アドレスあたり最大10ロットです。そのアドレスはメンバーシップ NFT を保有している必要があります。これらのチェックを緩和しないでください。

BAW 資金による入金には、prepare deposit --amount AMOUNT --asset native|token を使用してください。パケットの送信先は Pool shield です。native の入金では、パケットにエンコードされた正確な BNB 値が使われます。一方、token の入金では native 値はゼロとなり、BAW ウォレットにトークンの使用許可が必要です。ターゲット、資産、金額、値を検査してから、通常の BAW プレビューおよび確認フローを使用してください。 MarketV2 の注文では、生のノート単位を使用します。両方の側がダストを厳密に上回る必要があります。トークン量は生単位で 1_000_000_000(10 404)を超え、ネイティブ通貨量はノート単位で 10_000(0.0001 BNB)を超える必要があります。CLI は証明を生成する前に、これら以下の金額を拒否します。整数の丸めにより、ほぼ全量を約定する部分約定では、売り側の残量がダスト以下になることがあります。この場合、約定処理とコントラクトの両方がその約定を拒否します。その際は、注文全体を約定するか、キャンセルして金額を調整したうえで再出品してください。fill では、--sell-asset に選択した注文の売却対象アセットを指定します。CLI は注文を再読み込みし、証明を生成する前に不一致を拒否します。

マーケットメーカーのアセットに関する警告: このリスクが該当するのは、メーカーが、必要な ECDSA 署名を後から生成できないコントラクト制御ウォレットを使用している場合のみです。通常の EOA メーカーには影響しません。現在、マーケット注文のキャンセルとメーカーのアセット解放には ECDSA 署名しか使用できません。ERC-1271 コントラクト署名やその他のコントラクト認可経路はサポートされていないため、メーカーのアセットが永久にロックされる可能性があります。

一括購入では、通常のトークン量と任意の BNB 予算をユーザーから受け取ります。quote sweep --amount DECIMAL [--budget DECIMAL] --out FILE を実行します。CLI はオンチェーンの出品、手数料、ダスト制約を読み込み、正確な約定内容を記したファイルを出力します。ユーザーに生単位の JSON を作成させないでください。実際の購入量、元本、プロトコル手数料、合計金額、注文数を、要求数量との差分があればそれも含めて提示します。予算には元本と購入者のプロトコル手数料が含まれます。BAW Gas は別途必要です。返された prepare フィールドを prepare sweep に内部で渡します。価格や手数料を作り出さないでください。約定が 20 件以下の場合は 1 つのパケットを使用し、その後、上記のとおり内容を確認し、プレビューを表示して、正確な確認を得てください。

ウォレットの履歴については、結果を返す前に、デプロイブロックから固定された検証済みのヘッドまで同期します。このウォレットのノートと注文イベントのみを復元します。これには、ウォレットのメーカーキーのスキャンで見つかった受動的な約定も含まれます。ローカルのジャーナルエントリーには非公開の意図ラベルを追加できます。ジャーナルがない場合、非公開フィールドで利用できないものは作り出さず、不明として報告してください。ノートの合計にはお釣りのノートも含まれるため、受取額・支出額・純額は送金額とは一致しません。

コメント