Skip to Content
Changelog

Changelog

Release history for all EmbarkAI SDK packages.

Versions are tracked independently per package. Source repositories: @embarkai/core , @embarkai/ui-kit , @embarkai/mcp .

2026-04-17

@embarkai/ui-kit v0.4.2  — Safari Passkey & On-Ramp

  • Safari passkey support — WebAuthn in cross-origin iframes requires a focused document and user gesture on Safari. The SDK now shows a confirmation modal before the passkey ceremony automatically (Safari only).
  • On-ramp improvements — Reworked Binance ramp + FinchPay common flow, on-ramp history with SSE updates
  • Fix: honor build-time URLs (__EMBARK_TSS_URL__, __EMBARK_SHARE_VAULT_URL__) in iframe server-backup — prevents local dev from hitting production endpoints
  • Fix: bundle lodash-es into iframe to prevent bare import errors

@embarkai/core v0.3.3  — Dynamic Paymasters

  • Dynamic paymaster resolution — New resolveProjectPaymaster() function in @embarkai/core/paymasters automatically resolves the Paymaster address from Dashboard project policies, with in-memory cache and fallback to built-in chain config
  • ServerWalletManager: new dashboardApiUrl option for custom Dashboard API endpoints; paymaster resolution order is now: explicit override → Dashboard policy → built-in chain default
  • New exported types: ResolvedPaymaster, ResolveProjectPaymasterParams
  • Source code excluded from npm package (files: ["dist"])

@embarkai/mcp v0.2.2  — Dependency Alignment

  • Companion bump to align with @embarkai/core v0.3.3

2026-04-02

@embarkai/ui-kit v0.4.1  — FinchPay & Pro Mode

  • FinchPay on-ramp widget — Iframe-based on-ramp integration for fiat-to-crypto
  • Pro Mode — Persistent activation toggle with Guardians menu item for power users
  • Dedicated restore screen with LIST_OK size parsing for Guardian device
  • Dynamic paymasters support (companion to core 0.3.3)
  • Fix: verification code timer reset
  • Fix: Guardian restore flow and disable password autofill

2026-03-25

@embarkai/ui-kit v0.4.0  — Guardian Device Backup

  • Guardian hardware keyshare backup — WebSerial binary protocol client for Guardian devices. Back up and restore MPC keyshares to a dedicated hardware device instead of (or in addition to) the cloud vault.
  • DeviceManageScreen for Guardian keyshare management
  • Guardian option in backup/restore menus
  • Iframe envelope encrypt/decrypt messages for Guardian backup
  • Serial reliability improvements: handle already-open ports, boot log drain

@embarkai/core v0.3.2  — Companion Release

  • Version bump to align with ui-kit v0.4.0.

2026-03-17

@embarkai/ui-kit v0.3.5  — Blockscout Assets

  • New useBlockscoutAssets hook for fetching all token balances and NFTs from Blockscout API
  • New getExplorerUrl() helper for resolving block explorer URLs per active chain

2026-03-10

@embarkai/core v0.3.1  — AAD Binding for Server Wallet Vault

  • AAD binding for server wallet vault encryption — Upgrade server wallet backup encryption from v1 (no AAD) to v2 with AES-GCM additionalData binding. Prevents metadata tampering attacks on stored envelopes.
  • Encrypt with canonical sorted AAD keys and deviceId embarkai-server-wallet
  • Decrypt with 3-level fallback: canonical → legacy key order → no AAD (v1)

@embarkai/core v0.3.0  — Companion Release

  • Version bump to align with ui-kit v0.3.0 (envelope encryption v2).

@embarkai/ui-kit v0.3.4  — Canonical AAD Key Order

  • Fix canonical AAD key order — serializeAad() now sorts keys alphabetically for deterministic AES-GCM additionalData. Decrypt functions try canonical order first, then fall back to legacy key order for pre-fix v2 backups.

@embarkai/ui-kit v0.3.3  — WalletConnect Flow Reliability

  • Remove duplicate WagmiProvider to fix session conflicts
  • Reactive disconnect flow using useEffect instead of setTimeout
  • Guard stale session triggers with modalWasOpened flag
  • Loading spinner in auth dialog while awaiting wallet signature
  • Increased timeouts: signature 120s, session 5 minutes

@embarkai/ui-kit v0.3.2  — Modal Close Detection Fix

  • Fix false modal-close detection — Track whether RainbowKit modal was actually opened before detecting its closure.

@embarkai/ui-kit v0.3.1  — Wallet Login via WalletConnect

  • Wallet login auth flow — Sign in with external wallets via WalletConnect
  • Auto-clear stale WalletConnect sessions with timeout feedback

@embarkai/ui-kit v0.3.0  — Envelope Encryption v2 & Session Fix

  • Envelope encryption v2 — Bind AAD as real AES-GCM additionalData in backup encryption (schemaVersion 2), preventing metadata tampering
  • Fix stale session on keyshare recovery

@embarkai/ui-kit v0.2.8  — Iframe Communication Fixes

  • Fix channelToken race condition in iframe communication
  • Support both LUMIA_PASSPORT_* and IFRAME_MSG_* message types for backwards compatibility

2026-03-02

@embarkai/ui-kit v0.2.7  — Multi-Provider Profiles & Iframe Fixes

  • Multiple email & wallet providers — Users can link multiple emails and wallets in the Profiles menu
  • Wallet metadata — Shows wallet name (e.g. “MetaMask”) instead of generic “Wallet” label
  • Consistent address truncation format (0xABCD...1234)
  • Fix lucide-react bare import leaking into iframe bundle
  • Sync iframe ↔ SDK message types after rebranding

2026-03-01

@embarkai/core v0.2.0  — Dual-Mode Wallet

  • Dual-mode wallet support — New WalletMode type ("smart" | "eoa") enabling both AA smart wallets and direct EOA signing
  • External wallet store (Zustand-based) for managing connections
  • DirectWalletHandler for WalletConnect session synchronization
  • allowedWallets filtering for RainbowKit connector

@embarkai/ui-kit v0.2.0  — Dual-Mode Wallet

  • Dual-mode wallet UI — Support for both smart wallet (AA) and direct EOA signing modes via RainbowKit
  • New wallet mode hooks for managing state and switching
  • DirectWalletHandler component for automatic WalletConnect session sync
  • allowedWallets prop for filtering available wallets

2026-02-25

@embarkai/core v0.1.6  — Gas Estimation & Bundler Fixes

  • Fix multipliers compressor in gas estimation
  • Bundler compatibility fixes for UserOperation submission

@embarkai/core v0.1.5  — Simplified Config & Hydration Fix

  • Simplified provider configuration — reduced required init options
  • Fix store hydration and active chain ID initialization

@embarkai/core v0.1.4  — Restore localStorage Keys

  • Restore original localStorage keys to prevent session loss during rebranding migration from @lumiapassport/*

@embarkai/core v0.1.3  — Wallet Restore & Auto-Connect Fixes

  • Fix callback handlers for wallet restore and auto-connect flows

@embarkai/core v0.1.2  — Connect Button Fix

  • Fix connect button initialization
  • Resolve naming and import inconsistencies from rebranding

@embarkai/core v0.1.1  — Rebranding Fixes

  • Fix env file paths to use .env.embarkai
  • Fix imports to @embarkai scope across all modules

@embarkai/ui-kit v0.1.6  — Nickname Callback & Gas Fix

  • Call onAccountUpdate callback when nickname changes
  • Fix gas estimation via core update

@embarkai/ui-kit v0.1.5  — Simplified Config & Migration Guide

  • Simplified provider configuration
  • CSS scope naming alignment for theme variables
  • Fix store hydration and active chain ID initialization
  • Added migration guide from @lumiapassport/ui-kit

@embarkai/ui-kit v0.1.4  — Restore localStorage Keys

  • Restore original localStorage keys to prevent session loss during rebranding migration

@embarkai/ui-kit v0.1.3  — Wallet Restore & Auto-Connect Fixes

  • Fix callback handlers for wallet restore and auto-connect flows

@embarkai/ui-kit v0.1.2  — Connect Button Fix

  • Fix connect button initialization and rebranding import inconsistencies

@embarkai/ui-kit v0.1.1  — Rebranding Fixes

  • Fix env file paths, imports, and internal naming alignment

@embarkai/mcp v0.2.1  — Rebranding Alignment

  • Rename environment variables: LUMIA_PASSPORT_* → EMBARK_*
  • Rename binary entrypoint: lumia-passport-mcp → embarkai-mcp
  • Move viem and dkls23-wasm from peer to regular dependencies

@embarkai/mcp v0.2.0  — Auto-Restore Keyshare from Vault

  • Auto-restore keyshare from vault on startup — New walletBackupPassword config option eliminates manual keyshare management

2026-02-08

@embarkai/core v0.1.0  — Initial Release

  • Server wallet management via createServerWalletManager
  • Full ERC-4337 UserOperation lifecycle (create, sign, submit, receipt)
  • MPC/TSS threshold signature scheme for secure key management
  • Multi-chain support: Lumia Prism, Lumia Beam, Ethereum Sepolia, BSC Testnet, Arbitrum Sepolia, Base Sepolia
  • Cached public client with RPC fallback, multicall batching, log pagination
  • JWT authentication with access/refresh token management
  • Storage adapters: MemoryKeyshareStorage, FileKeyshareStorage, custom interface
  • ShareVault integration for keyshare backup/restore
  • Contract encoding helpers for ERC-20, ERC-721, ERC-1155, and arbitrary ABIs
  • Bundler operations: sendUserOperationRaw, sendUserOperationWithRetry, getUserOperationReceipt
  • Paymaster support for sponsored (gasless) transactions

@embarkai/ui-kit v0.1.0  — Initial Release

  • Authentication: Email OTP, Passkey/WebAuthn, Telegram Mini App, external wallets
  • MPC key management with iframe isolation
  • ERC-4337 smart contract wallets with gas abstraction
  • Provider, ConnectWalletButton, ThemeToggle, LangToggle components
  • Hooks: session, balance, address, chain, loading status, dialog control
  • Transaction API: useSendTransaction, sendUserOperation, prepareUserOperation, deployAccount
  • EIP-712 signTypedData for structured message signing
  • Multi-chain support with chain switching
  • Light/dark theme system with CSS variable customization
  • i18n with 25+ built-in translations
  • KeyshareBackup component for vault backup/restore
  • ERC-3643 compliance hook
  • Nickname resolution for human-readable addresses

@embarkai/mcp v0.1.0  — Initial Release

  • 7 blockchain tools: get_wallet_info, get_balance, transfer, read_contract, get_transaction_status, list_supported_chains, switch_chain
  • Multi-chain support with runtime chain switching
  • Auto wallet creation via MPC/TSS on first use
  • Native and ERC-20 balance/transfer support
  • Stdio transport for Claude Code, Claude Desktop, and MCP-compatible clients
  • Programmatic API via createMcpServer() and startMcpServer()
  • embarkai-mcp CLI command
Last updated on
@embarkai/mcpFAQ