Smart Account Management
Deploy multi-signature smart accounts on any supported EVM chain and manage their ownership (add/remove owners, change signing threshold).
Confirm wallet is authenticated
CODEBLOCK0
If the wallet is not authenticated, refer to the authenticate skill.
Deploying a Smart Account
Create a new smart account on a specific chain:
CODEBLOCK1
deploySmartAccount Parameters
| Parameter | Required | Description |
|---|
| INLINECODE1 | Yes | Blockchain to deploy on (e.g. ethereum, polygon, base, arbitrum) |
| INLINECODE6 |
No | Comma-separated list of owner addresses |
|
--threshold | No | Number of signatures required to execute transactions |
Examples
CODEBLOCK2
Managing Ownership
Add owners, remove owners, or change the signing threshold on an existing smart account:
CODEBLOCK3
manageSmartAccountOwnership Parameters
| Parameter | Required | Description |
|---|
| INLINECODE8 | Yes | Blockchain of the smart account |
| INLINECODE9 |
Yes | Smart account address to manage |
|
--action | Yes | Action to perform (e.g.
addOwner,
removeOwner,
changeThreshold) |
|
--ownerAddress | No | Owner address to add or remove (required for
addOwner/
removeOwner) |
|
--newThreshold | No | New signing threshold (required for
changeThreshold) |
Examples
CODEBLOCK4
Viewing Smart Account Details
Check the smart account's holdings and activity:
CODEBLOCK5
Flow
- 1. Check authentication with INLINECODE19
- Deploy a smart account with INLINECODE20
- Note the returned smart account address
- Manage ownership as needed with INLINECODE21
- Use the smart account address in
send-tokens or swap-tokens skills via INLINECODE24
Important: Ownership changes on multi-sig accounts are sensitive operations. Always confirm the action, addresses, and new threshold with your human before executing. Removing too many owners or setting the threshold too high can lock the account.
Prerequisites
- - Must be authenticated (
fdx status to check, see authenticate skill) - Smart accounts are deployed on EVM chains only (not Solana)
Error Handling
- - "Not authenticated" — Run
fdx setup first, or see authenticate skill - "Invalid account address" — Verify the smart account address exists on the specified chain
- "Threshold exceeds owner count" — Threshold must be ≤ number of owners
智能账户管理
在任何支持的EVM链上部署多重签名智能账户,并管理其所有权(添加/移除所有者、更改签名阈值)。
确认钱包已认证
bash
fdx status
如果钱包未认证,请参考authenticate技能。
部署智能账户
在特定链上创建新的智能账户:
bash
fdx call deploySmartAccount \
--chainKey <链>
deploySmartAccount 参数
| 参数 | 必填 | 说明 |
|---|
| --chainKey | 是 | 部署的区块链(例如 ethereum、polygon、base、arbitrum) |
| --initialOwners |
否 | 所有者地址列表,用逗号分隔 |
| --threshold | 否 | 执行交易所需的签名数量 |
示例
bash
在以太坊上部署简单智能账户
fdx call deploySmartAccount --chainKey ethereum
部署2/3多重签名
fdx call deploySmartAccount \
--chainKey ethereum \
--initialOwners 0xOwner1...,0xOwner2...,0xOwner3... \
--threshold 2
管理所有权
在现有智能账户上添加所有者、移除所有者或更改签名阈值:
bash
fdx call manageSmartAccountOwnership \
--chainKey <链> \
--accountAddress <智能账户地址> \
--action <操作>
manageSmartAccountOwnership 参数
| 参数 | 必填 | 说明 |
|---|
| --chainKey | 是 | 智能账户所在的区块链 |
| --accountAddress |
是 | 要管理的智能账户地址 |
| --action | 是 | 要执行的操作(例如 addOwner、removeOwner、changeThreshold) |
| --ownerAddress | 否 | 要添加或移除的所有者地址(addOwner/removeOwner 必填) |
| --newThreshold | 否 | 新的签名阈值(changeThreshold 必填) |
示例
bash
添加新所有者
fdx call manageSmartAccountOwnership \
--chainKey ethereum \
--accountAddress 0xSmartAccount... \
--action addOwner \
--ownerAddress 0xNewOwner...
移除所有者
fdx call manageSmartAccountOwnership \
--chainKey ethereum \
--accountAddress 0xSmartAccount... \
--action removeOwner \
--ownerAddress 0xOldOwner...
将阈值更改为3/5
fdx call manageSmartAccountOwnership \
--chainKey ethereum \
--accountAddress 0xSmartAccount... \
--action changeThreshold \
--newThreshold 3
查看智能账户详情
检查智能账户的持仓和活动:
bash
fdx call getWalletOverview \
--chainKey <链> \
--accountAddress <智能账户地址>
流程
- 1. 使用 fdx status 检查认证状态
- 使用 fdx call deploySmartAccount 部署智能账户
- 记录返回的智能账户地址
- 根据需要,使用 fdx call manageSmartAccountOwnership 管理所有权
- 在 send-tokens 或 swap-tokens 技能中,通过 --fromAccountAddress 使用智能账户地址
重要提示: 多重签名账户的所有权变更是敏感操作。执行前务必与您的相关人员确认操作、地址和新阈值。移除过多所有者或设置过高的阈值可能导致账户被锁定。
前提条件
- - 必须已认证(使用 fdx status 检查,参见 authenticate 技能)
- 智能账户仅部署在EVM链上(非Solana)
错误处理
- - 未认证 — 先运行 fdx setup,或参见 authenticate 技能
- 无效的账户地址 — 验证智能账户地址在指定链上存在
- 阈值超过所有者数量 — 阈值必须 ≤ 所有者数量