fdx call deploySmartAccount \
  --chainKey <chain>

deploySmartAccount Parameters

Parameter	Required	Description
`--chainKey`	Yes	Blockchain to deploy on (e.g. `ethereum`, `polygon`, `base`, `arbitrum`)
`--initialOwners`	No	Comma-separated list of owner addresses
`--threshold`	No	Number of signatures required to execute transactions

Examples

# Deploy a simple smart account on Ethereum
fdx call deploySmartAccount --chainKey ethereum

# Deploy a 2-of-3 multi-sig
fdx call deploySmartAccount \
  --chainKey ethereum \
  --initialOwners 0xOwner1...,0xOwner2...,0xOwner3... \
  --threshold 2

Managing Ownership

Add owners, remove owners, or change the signing threshold on an existing smart account:

fdx call manageSmartAccountOwnership \
  --chainKey <chain> \
  --accountAddress <smartAccountAddress> \
  --action <action>

manageSmartAccountOwnership Parameters

Parameter	Required	Description
`--chainKey`	Yes	Blockchain of the smart account
`--accountAddress`	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

# Add a new owner
fdx call manageSmartAccountOwnership \
  --chainKey ethereum \
  --accountAddress 0xSmartAccount... \
  --action addOwner \
  --ownerAddress 0xNewOwner...

# Remove an owner
fdx call manageSmartAccountOwnership \
  --chainKey ethereum \
  --accountAddress 0xSmartAccount... \
  --action removeOwner \
  --ownerAddress 0xOldOwner...

# Change the threshold to 3-of-5
fdx call manageSmartAccountOwnership \
  --chainKey ethereum \
  --accountAddress 0xSmartAccount... \
  --action changeThreshold \
  --newThreshold 3

Viewing Smart Account Details

Check the smart account's holdings and activity:

fdx call getWalletOverview \
  --chainKey <chain> \
  --accountAddress <smartAccountAddress>

Flow

Check authentication with fdx status
Deploy a smart account with fdx call deploySmartAccount
Note the returned smart account address
Manage ownership as needed with fdx call manageSmartAccountOwnership
Use the smart account address in send-tokens or swap-tokens skills via --fromAccountAddress

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

smart-accounts

Smart Account Management

Confirm wallet is authenticated

Deploying a Smart Account