deposit_funds
Deposits ERC-20 or native tokens into an entity's protocol treasury (e.g. seller deposit). For ERC-20, call approve_exchange_token first. Returns unsigned transaction data.
Category: Funds.
Returns unsigned tx? Likely yes — sign locally and broadcast via send_signed_transaction or a meta-tx relay.
Input schema
| Field | Type | Required | Description |
|---|---|---|---|
entityId | string | yes | Numeric ID of the entity to credit. Must match signerAddress's seller account. |
tokenAddress | string | yes | ERC-20 token to deposit. Use address(0) for native ETH. |
amount | — | yes | Amount in wei. For ERC-20, approve_exchange_token must be called first. Pass as string. |
configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server. |
signerAddress | — | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
executionMode | direct | metaTx | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Related
- Reference → MCP tools — full catalogue.
- Build for AI agents → The 3-step signing pattern — what to do with returned unsigned transactions.
- Concepts → Signing & meta-transactions — canonical signing reference.