代理钱包

在不转移账户所有权的前提下委托交易权限

代理钱包 (Agent Wallet) 允许您将永续合约账户的交易权限委托给另一个钱包，而无需交出账户本身的所有权。这适用于机器人、自动化交易，或在组织内部分配权限，同时让主钱包始终保留账户的管理员身份。

工作原理

每个永续合约账户都由一个管理员权限凭证控制。借助代理钱包，管理员钱包可以向第二个钱包（即代理）授予助理级权限。每次授权都会铸造一个由接收方钱包持有的权限凭证对象，一个账户最多可同时拥有 10 个有效代理钱包（协议参数）。此后，代理钱包即可代表该账户执行受支持的交易操作。代理可以执行除提取保证金资产之外的所有操作，但不能授予或撤销其他代理钱包，也不能撤销集成商代码 (Builder Codes) 的授权（代理可以添加授权，但只有管理员能移除）。

为什么使用代理钱包

• 用专用钱包运行自动化策略

• 分离签名密钥，便于风险管理

• 让长期资金库/管理员钱包与交易执行隔离

• 需要时可立即撤销权限

任何形式的自动化都应使用代理钱包。不要将资金库/管理员钱包复用于机器人执行。

授予代理钱包

从账户管理员钱包提交一笔交易，指定：

• accountId

• recipientAddress — 接收代理权限的钱包

链上确认后，接收方即可以助理级权限代表该账户交易。

接口： POST /api/perpetuals/account/transactions/grant-agent-wallet

撤销代理钱包

从账户管理员钱包提交一笔交易，指定：

• accountId

• 要撤销的助理权限凭证的 accountCapId

确认后，被撤销的钱包立即失去其委托权限。

代理也可以随时销毁自己的权限凭证以放弃权限，无需管理员钱包参与。

接口： POST /api/perpetuals/account/transactions/revoke-agent-wallet

在运行机器人？代理钱包无需持有 SUI。参见无 Gas 交易 (GasPool)，从中央资金池代付 Gas。