> ## Documentation Index
> Fetch the complete documentation index at: https://developers.fd.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Wallet

> Agent Wallet changelog — new features, improvements, and updates.

## June 30, 2026

### Payments (x402)

* `authorizePayment` now accepts `preferredAsset` and `preferredNetwork` — choose the settlement token and chain when a merchant offers several
* Hardened x402 authorization: the payment header is built from the server's 402 challenge rather than the request URL, and token metadata is now optional

### Security

* EVM transactions are now signed directly inside the secure enclave, removing an external signing dependency
* Expanded the signing audit trail (the original message and encoding are recorded), and signing requests now carry the end-user's IP and user-agent for stronger attribution

## June 9, 2026

### Yield

* New yield provider: **IXS** — APY sourced off-chain and refreshed on a schedule; a multi-provider architecture lets new strategies plug in, and `discoverYieldStrategies` now surfaces IXS alongside the existing on-chain options
* Vault-based strategies settle withdrawals asynchronously — the new `getRedemptionRequests` tool lets an agent track pending redemptions and their status

## June 5, 2026

### MCP Server

* Strengthened the server instructions and tool descriptions — including a trust-model summary — so agents call wallet tools more reliably
* Corrected read-only annotations on the tools that don't move funds

## May 26, 2026

### Networks

* **Sui support** (mainnet and testnet) — transfers, balances, and transaction history on Sui. Sui joins the EVM chains, Solana, and Bitcoin.

### Wallet

* Token resolution now resolves symbols from your own wallet balances and internal token sources — including Sui coin types — so you can refer to tokens by symbol instead of pasting a contract address

## March 31, 2026

### CLI v0.4.2

* Minimized npm package surface with `files` whitelist

## March 30, 2026

### CLI v0.4.1

* Persistent configuration via `~/.fdx/config.json`
* New `fdx config set|get|unset <key> <value>` subcommands for managing CLI settings
* Config source labels in `fdx config` output: `(env)`, `(config)`, `(default)`

## March 16, 2026

### CLI v0.4.0

<Warning>
  **Breaking changes** — see migration guide below.
</Warning>

* New `fdx wallet <method>` subcommand for Wallet MCP tools (transfers, swaps, yield, x402 payments)
* New `fdx prism <method>` subcommand for Prism MCP tools (payments, settlements, accounts)
* New `fdx services` command — list available services and their URLs
* Multi-service routing — CLI routes tool calls to Wallet or Prism based on subcommand
* Dynamic tool discovery — available methods are fetched from each MCP server at runtime
* New environment variables: `FDX_WALLET_MCP_URL` / `FDX_PRISM_MCP_URL` for per-service URL overrides

**Breaking changes:**

* `fdx call <method>` is deprecated — use `fdx wallet <method>` or `fdx prism <method>` instead
* `WalletClient` renamed to `FdxClient` in SDK exports (no backward-compat alias)
* `FDX_MCP_SERVER` env var deprecated — use `FDX_WALLET_MCP_URL` / `FDX_PRISM_MCP_URL`

**Migration:**

```bash theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
# Before (v0.3.x)
fdx call getWalletOverview --chainKey ethereum

# After (v0.4.0+)
fdx wallet getWalletOverview --chainKey ethereum
fdx prism listPayments               # Prism tools
fdx services                         # list available services
```

***

## February 28, 2026

### CLI

* Replaced Device Authorization Grant with email OTP — authentication is now fully headless, no browser required
* New auth commands: `fdx register --email <email>`, `fdx login --email <email>`, `fdx verify --code <otp>`
* Pending verification state is persisted to the OS credential store and survives between CLI invocations
* Expired access tokens are now refreshed automatically using the stored refresh token
* Windows PowerShell rendering fixed — spinner and checkmarks now use ASCII characters and display correctly

## February 24, 2026

### CLI

* `fdx login` introduced as the primary authentication command (`fdx setup` remains a hidden backward-compatible alias)
* `fdx call <method> --help` now shows required and optional parameters, types, descriptions, and a usage example for each tool
* "Did you mean?" fuzzy matching for mistyped or partially typed method names
* `fdx call` groups tools into categories: Wallet, Transfer, Swap, Yield, Payment, Account, Support
* CLI arguments are automatically coerced to the correct type (numbers, integers) based on the tool schema
* New `getTokenPrice` tool — look up the current USD price and 24h change for any token
* New `resolveNameService` tool — resolve ENS (`.eth`), SNS (`.sol`), and Unstoppable Domain names to addresses and vice versa
* Updated tool parameter signatures for `transferTokens`, `depositForYield`, `withdrawFromYield`, `authorizePayment`, `getAccountActivity`, and `discoverYieldStrategies`
* Removed `deploySmartAccount` and `manageSmartAccountOwnership` tools

## February 19, 2026

### CLI

* Switched authentication to Device Authorization Grant (RFC 8628) — `fdx setup` no longer opens a browser; authentication happens via device code
* Added HTTPS validation for all discovered OAuth endpoints
* Improved error handling for expired OS credential store sessions and missing refresh tokens
* Fixed a bug where `null` client ID was sent as a literal string `"null"` during token refresh

## February 17, 2026

### Documentation Launch

* Full Agent Wallet documentation published in the Developer Hub
* [Wallet Architecture](/agent-wallet/wallet-architecture) — Progressive EOA → Smart Account → Delegated architecture
* [Security Model](/agent-wallet/concepts/security) — TEE key management with AWS Nitro Enclaves
* [Trust & Risk](/agent-wallet/concepts/trust) — Pocket money philosophy and progressive trust

### MCP Server

* MCP Server documentation for connecting AI agents via Model Context Protocol
* Client setup guides for Claude Desktop, Cursor, Windsurf, and custom clients
* [Agent Skills](/agent-wallet/ai-integration/agent-skills) reference covering all wallet capabilities

### Interfaces

* [CLI](/agent-wallet/ai-integration/cli) documentation with full command reference
* [AI Assistant](/agent-wallet/ai-integration/ai-assistant) guide for the conversational wallet interface
* [Example Prompts](/agent-wallet/resources/example-prompts) — ready-to-use prompts for common tasks

### Advanced

* [Multi-Wallet Strategy](/agent-wallet/advanced/multi-agent) patterns for multi-wallet deployments
