Skip to main content

概述

AgentWallex 建立在一个核心原则之上:AI 代理绝不应该接触私钥。取而代之的是,交易通过多方计算(MPC)签名,没有任何单一方持有完整密钥。 平台通过四个独立的安全层实施保护。每笔交易必须通过所有层级,才能被广播到区块链。

四层安全体系

第一层:身份认证

每个 API 请求都通过双令牌系统进行认证:
  • API 密钥awx_...)— 长期有效,标识您的账户。请安全存储在环境变量中。
  • 会话令牌 — 短期有效,限定于特定代理和操作。自动轮换。
关键属性:

第二层:策略引擎

每笔交易在签名之前必须通过策略引擎。策略按顺序评估 — 第一个违规即停止交易。 策略引擎支持:
  • 消费限额(单笔、每日、每月)
  • 地址白名单和黑名单
  • 代币限制
  • 频率控制(速率限制)
  • 基于时间的调度规则
  • 人工审批路由
详情请参阅策略引擎的完整配置说明。

第三层:MPC 签名(Paratro)

AgentWallex 使用 Paratro 的 2-of-3 阈值 MPC 协议: 关键安全属性:
  • 完整的私钥永远不会在内存中重建
  • 3 个分片中的任意 2 个即可签署交易
  • 单个分片被泄露不会危及钱包安全
  • 密钥生成使用分布式密钥生成(DKG)— 没有任何单一方看到过完整密钥

第四层:人工审批

对于高价值或异常交易,AgentWallex 可以路由至人工审批:
  • 超过可配置阈值的交易
  • 发往新(未见过的)地址的交易
  • 异常监控检测到的异常模式
审批可通过仪表盘、API 或 Webhook 集成处理。

双层策略架构

AgentWallex 在两个独立层级执行策略:

业务层(开发者配置)

您的自定义规则 — 消费限额、白名单、频率控制。这些通过 API 或仪表盘设置,可随时更新。

基础设施安全网(Paratro 执行)

在 MPC 签名层执行的硬限制,无法通过 API 调用覆盖:
即使您的 API 密钥被泄露,基础设施安全网也能防止灾难性损失。攻击者无法覆盖 Paratro 执行的限制。

密钥管理生命周期

密钥生成

密钥使用分布式密钥生成(DKG)创建。在任何时候都没有任何一方看到完整的私钥:
  1. 3 个 MPC 节点中的每一个独立生成一个随机分片。
  2. 分片通过密码学方式组合以生成公钥。
  3. 对应的私钥仅以分布式分片的形式存在。

密钥轮换

密钥分片会定期轮换,且不会更改钱包地址。这称为”主动密钥共享” — 旧的分片在轮换后变得无效。

紧急冻结

任何授权方都可以立即冻结钱包:
冻结的钱包在被明确解冻之前无法签署任何交易(有强制冷却期)。

审计日志

每个操作都会被不可变地记录:
  • 所有 API 请求(包括 IP、用户代理、时间戳)
  • 所有策略评估(通过/失败及原因)
  • 所有签名操作
  • 所有冻结/解冻事件
  • 所有 Webhook 投递
通过 API 查询审计日志: