> For the complete documentation index, see [llms.txt](https://ch-docs.aftermath.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ch-docs.aftermath.finance/yong-xu-he-yue/architecture/account/agent-wallets.md).

# 代理钱包

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

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

### 工作原理

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

### 为什么使用代理钱包

* 用专用钱包运行自动化策略
* 分离签名密钥，便于风险管理
* 让长期资金库/管理员钱包与交易执行隔离
* 需要时可立即撤销权限

{% hint style="warning" %}
任何形式的自动化都应使用代理钱包。不要将资金库/管理员钱包复用于机器人执行。
{% endhint %}

### 授予代理钱包

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

* `accountId`
* `recipientAddress` — 接收代理权限的钱包

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

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

### 撤销代理钱包

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

* `accountId`
* 要撤销的助理权限凭证的 `accountCapId`

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

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

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

{% hint style="info" %}
在运行机器人？代理钱包无需持有 SUI。参见[无 Gas 交易 (GasPool)](/yong-xu-he-yue/architecture/account/gasless-trading.md)，从中央资金池代付 Gas。
{% endhint %}