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
Breaking changes — see migration guide below.
- 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:
# 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 — Progressive EOA → Smart Account → Delegated architecture
- Security Model — TEE key management with AWS Nitro Enclaves
- Trust & Risk — 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 reference covering all wallet capabilities
Interfaces
- CLI documentation with full command reference
- AI Assistant guide for the conversational wallet interface
- Example Prompts — ready-to-use prompts for common tasks
Advanced