Skip to main content

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

Last modified on April 2, 2026