Bankr Agent - Safety & Access Control

安全性とアクセス制御

Bankr API と CLI を使用する際の包括的な安全性ガイダンスです。

API キーの種類

Bankr は、機能フラグを備えた単一のキー形式（bk_...）を使用します。

フラグ	制御対象	デフォルト
agentApiEnabled	/agent/* エンドポイント	false
llmGatewayEnabled	llm.bankr.bot の LLM Gateway	false
readOnly	エージェントを読み取り専用ツールに制限	false

フラグは bankr.bot/api で管理できます。

読み取り専用 API キー

readOnly: true の場合、すべての書き込みツールがエージェントのセッションから除外されます。

許可： 残高、価格、分析、ポートフォリオ、リサーチ
ブロック： スワップ、送金、NFT の購入、ステーキング、注文、トークンのローンチ、レバレッジ、Polymarket での賭け、請求

読み取り専用キーでは、/agent/sign および /agent/submit エンドポイントは 403 を返します。

IP ホワイトリスト

API キーに allowedIps を設定すると、使用を特定の IP に制限できます。ホワイトリストにない IP からのリクエストは 403 で拒否されます。

• 空の配列 = すべての IP を許可（デフォルト）
• 空でない配列 = リストされた IP のみがキーを使用可能

専用エージェントウォレット

自律型エージェントを構築する場合は、個人のウォレットではなく、Bankr アカウントを別途作成してください。

• リスクの限定 — キーが侵害されても、エージェントウォレットの資金のみが影響を受けます
• 明確な会計管理 — エージェントの取引を個人の利用状況から分離できます
• 独立した制御 — 個人での利用に影響を与えず、より厳格なアクセス制御を適用できます
• 簡単な取り消し — メインのウォレットに影響を与えずに、エージェントアカウントを無効化できます

推奨される資金額

チェーン	ガス用バッファ	取引資金
Base	0.01-0.05 ETH	必要に応じて
Polygon	5-10 MATIC	必要に応じて
Ethereum	0.05-0.1 ETH	必要に応じて
Solana	0.1-0.5 SOL	必要に応じて

レート制限

ティア	1 日あたりの上限
Standard	100 メッセージ/日
Bankr Club	1,000 メッセージ/日
Custom	API キーごとに設定

リセットは午前 0 時ではなく、最初のメッセージから 24 時間後です（ローリング方式）。

キーの管理

• キーは環境変数（BANKR_API_KEY、BANKR_LLM_KEY）に保存し、ソースコードには決して含めないでください
• ~/.bankr/ と .env を .gitignore に追加してください
• bankr.bot/api で定期的にキーをローテーションしてください
• 侵害された場合は直ちに失効させてください
• 必要に応じて、Agent API と LLM Gateway には別々のキーを使用してください

トランザクションの安全性

• まずテストする — 規模を拡大する前に、Base/Polygon で少額を試してください
• 送金先を確認する — 送金前にアドレスを二重に確認してください
• ガス用バッファ — ガス代に十分なネイティブトークンを確保してください
• 即時実行 — /agent/submit は確認プロンプトなしで実行されます
• calldata を理解する — 任意のトランザクションについて、信頼できるソースかどうかを確認してください

デプロイ前チェックリスト

• 個人アカウントではなく、専用のエージェントウォレットを使用する
• 用途に応じた限られた金額を入金する
• エージェントがデータの照会のみを行う場合は、読み取り専用に設定する
• サーバーサイドのエージェントには IP ホワイトリストを設定する
• キーを環境変数に保存する
• まず少額でテストする
• レート制限（429）とアクセス制御（403）に対するエラー処理を実装する