セキュリティアーキテクチャ

​

概要

​

4つのセキュリティレイヤー

​

レイヤー1：IDと認証

• APIキー（awx_...）— 長期間有効、アカウントを識別します。環境変数に安全に保存してください。
• セッショントークン — 短期間有効、特定のエージェントと操作にスコープされます。自動的にローテーションされます。

// API key authenticates your account
const aw = new AgentWallex({ apiKey: process.env.AGENTWALLEX_API_KEY! });

// Session tokens are managed internally by the SDK
// Each agent gets its own scoped session

​

レイヤー2：ポリシーエンジン

• 支出制限（トランザクションごと、日次、月次）
• アドレスホワイトリストとブラックリスト
• トークン制限
• 速度制御（レート制限）
• 時間ベースのスケジュールルール
• 人間承認ルーティング

​

レイヤー3：MPC署名（Paratro）

• 完全な秘密鍵はメモリ内で決して再構築されません
• 3つのうち任意の2つのシャードでトランザクションに署名可能
• 単一のシャードの侵害ではウォレットは侵害されません
• 鍵生成は分散鍵生成（DKG）を使用 — 単一の当事者が完全な鍵を見ることはありません

​

レイヤー4：人間介在

• 設定可能なしきい値を超えるトランザクション
• 新しい（未知の）アドレスへのトランザクション
• 異常監視によって検出された異常パターン

{
  "event": "approval.requested",
  "data": {
    "transactionId": "tx_pending_123",
    "agentId": "agent_abc123",
    "amount": "2500.00",
    "reason": "Amount exceeds humanApprovalThreshold (1000)",
    "expiresAt": "2025-01-15T11:00:00Z"
  }
}

​

2層ポリシーアーキテクチャ

​

ビジネスレイヤー（開発者設定）

​

インフラストラクチャセーフティネット（Paratro強制）

​

鍵管理ライフサイクル

​

鍵生成

1. 3つのMPCノードのそれぞれがランダムなシェアを生成します。
2. シェアが暗号的に結合されて公開鍵が生成されます。
3. 対応する秘密鍵は分散シャードとしてのみ存在します。

​

鍵ローテーション

​

緊急凍結

await aw.agents.freeze("agent_abc123");

curl -X PUT https://api.agentwallex.com/api/v1/agents/agent_abc123/status \
  -H "X-API-Key: awx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"status": "inactive"}'

​

監査ログ

• すべてのAPIリクエスト（IP、ユーザーエージェント、タイムスタンプ付き）
• すべてのポリシー評価（理由付きの合格/不合格）
• すべての署名操作
• すべての凍結/凍結解除イベント
• すべてのWebhook配信

curl -X GET "https://api.agentwallex.com/api/v1/audit-logs?page_num=1&page_size=20" \
  -H "X-API-Key: awx_your_api_key"