Changelog

Release history for all embarkAI SDK packages.

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

2026-09-11

@embarkai/core v0.4.15 — Repository Links

• Package metadata points to github.com/embark-ai/core; the publish pipeline installs workspace dependencies before publishing

@embarkai/ui-kit v0.4.95 — Repository Links

• Companion release: package metadata points to github.com/embark-ai/ui-kit

@embarkai/mcp v0.2.3 — Repin core to 0.4.15

• Depends on @embarkai/core 0.4.15: TSS, auth and vault endpoints on api.embarkai.io, so keys issued by dashboard.embarkai.io authenticate
• Dependency updates; package links point to github.com/embark-ai/mcp

2026-09-02

@embarkai/ui-kit v0.4.94 — Menus Refactor

• Internal menus management refactored

2026-08-31

@embarkai/ui-kit v0.4.92 – v0.4.93 — Motion & Theme CSS

• framer-motion replaced by motion
• Theme CSS shrunk

2026-08-27

@embarkai/ui-kit v0.4.91 — Backup Screen Fix

• Fix: new users no longer get stuck on the backup screen after creating a backup
• Fix: useExternalWalletConnect return type annotated so the type declarations build

2026-08-13

@embarkai/ui-kit v0.4.90 — Transaction History Visibility

• Transaction history is hidden on chains that do not support it

2026-08-12

@embarkai/ui-kit v0.4.89 — Per-Chain Balance Display

• showBalanceAs accepts a per-chain map; balance view fixes

2026-08-11

@embarkai/core v0.4.14 — Pulsar Blockscout Config

• Lumia Pulsar testnet chain config gains a Blockscout API URL

@embarkai/ui-kit v0.4.87 – v0.4.88 — Resume Page After Auth

• v0.4.88: the page requested before authentication is opened again once the user signs in
• v0.4.87: companion to core 0.4.14

2026-08-10

@embarkai/ui-kit v0.4.85 – v0.4.86 — Error Boundary

• New ErrorBoundary component with a fallback renderer (ErrorBoundaryProps.FallbackComponent)
• v0.4.86: fallback rendering fix

2026-08-05

@embarkai/ui-kit v0.4.83 – v0.4.84 — Expandable Export

• Expandable exported as a UI component
• Active email OTP challenges are preserved
• v0.4.84: maintenance release

2026-08-04

@embarkai/core v0.4.13 — wagmi Config Hotfix

• Hotfix in the wagmi config

@embarkai/ui-kit v0.4.82 — External Wallet Flows

• Expandable reworked without render-key hacks
• Better external wallet connection flows

2026-08-03

@embarkai/core v0.4.12 — wagmi Without RainbowKit

• wagmi config no longer depends on RainbowKit
• Base Account and Coinbase connectors disabled in the wagmi config

@embarkai/ui-kit v0.4.81 — External Wallets Without RainbowKit

• External wallets connect through wagmi connectors directly; RainbowKit removed

2026-07-30

@embarkai/ui-kit v0.4.80 — Bridge Menu Toggle

• The bridge menu can be disabled from the Provider config

2026-07-29

@embarkai/ui-kit v0.4.79 — Maintenance release

2026-07-24

@embarkai/ui-kit v0.4.78 — Maintenance release

2026-07-23

@embarkai/ui-kit v0.4.77 — Mobile Onboarding

• Mobile onboarder
• Better nickname handling and onboarder target detection

2026-07-22

@embarkai/ui-kit v0.4.75 – v0.4.76 — Onboarding Tours

• More onboarding tours, including the keyshare backup menu
• v0.4.76: maintenance release

2026-07-20

@embarkai/ui-kit v0.4.74 — Forking Tours

• Onboarder tours can fork

2026-07-18

@embarkai/ui-kit v0.4.70 – v0.4.73 — Onboarder

• New onboarder module: guided tours over the wallet UI (onboarder, ONBOARDING_TOURS)
• v0.4.71 – v0.4.73: onboarding fixes

2026-07-16

@embarkai/core v0.4.10 — Backend Token Verification

• New EmbarkAIAuthService in @embarkai/core/auth/node verifies embarkAI access tokens against the public JWKS

@embarkai/core v0.4.11 — Pulsar Bundler Fix

• Lumia Pulsar testnet bundler URL fixed

@embarkai/ui-kit v0.4.68 – v0.4.69 — Companion Releases

• Companion bumps to core 0.4.10 and 0.4.11

2026-07-15

@embarkai/ui-kit v0.4.65 – v0.4.67 — Balance Feed Fixes

• USD asset rate handler fix
• Balance feed provider fixes

2026-07-14

@embarkai/core v0.4.7 — JWT Refresh Outcomes

• RefreshOutcome ('refreshed' | 'session_dead' | 'unavailable') and ensureFreshSession() distinguish a dead session from an unavailable auth service
• Session expiry is surfaced as SESSION_EXPIRED instead of a generic MPC error after long idle

@embarkai/core v0.4.8 — Non-Blockscout Assets

• New non-Blockscout asset client for chains without a Blockscout indexer

@embarkai/core v0.4.9 — Balance Fixes

• Core token list for BSC Testnet; balance fixes

@embarkai/ui-kit v0.4.59 – v0.4.64 — Session Expiry & Balances

• SessionExpiredError surfaced after long idle instead of a generic MPC error
• Balances on chains without Blockscout
• v0.4.61 – v0.4.64: BalanceFeedProvider hotfixes and balance fixes

2026-07-13

@embarkai/ui-kit v0.4.58 — Buy Menu

• Buy menu updates

2026-07-11

@embarkai/ui-kit v0.4.57 — On-Ramp History

• New getInProgressOnrampTransactionsList export

2026-07-10

@embarkai/core v0.4.6 — Network Config & Health Tests

• BSC mainnet chain config updated
• Transaction flow health tests added

@embarkai/ui-kit v0.4.56 — Companion Release

• Companion bump to core 0.4.6

2026-07-09

@embarkai/ui-kit v0.4.55 — Maintenance release

2026-07-08

@embarkai/core v0.4.5 — Cleanup

• Refactor cleanup

@embarkai/ui-kit v0.4.51 – v0.4.54 — Portfolio & Nickname Fixes

• Fix: project asset portfolio balances
• Fix: nickname flow for new users
• v0.4.51 – v0.4.52: cleanup releases

2026-07-07

@embarkai/core v0.4.3 — BSC Testnet Bundler

• BSC Testnet bundler URL reverted

@embarkai/core v0.4.4 — Maintenance release

@embarkai/ui-kit v0.4.49 – v0.4.50 — Companion Releases

• Companion bumps to core 0.4.3 and 0.4.4

2026-07-06

@embarkai/core v0.4.2 — Network Registry

• Network registry refactored; BSC mainnet chain config added

@embarkai/ui-kit v0.4.47 – v0.4.48 — Nickname for New Users

• New users set a nickname during onboarding
• Logging out also disconnects the external wallet
• v0.4.48: backup flow fix for new users

2026-07-04

@embarkai/ui-kit v0.4.44 – v0.4.46 — Bridge & Ramp History

• Bridge and on-ramp history updates
• v0.4.45 – v0.4.46: maintenance releases

2026-07-03

@embarkai/ui-kit v0.4.42 – v0.4.43 — Maintenance releases

2026-07-02

@embarkai/core v0.4.0 — wagmi Config in Core

• wagmiConfig, VIEM_CHAINS, getViemChain and transport URLs are built in @embarkai/core and exported from the root and from @embarkai/core/read

@embarkai/core v0.4.1 — Transport URL Fix

• Transport URL fixes

@embarkai/ui-kit v0.4.39 – v0.4.41 — Companion Releases

• Depends on core 0.4.0 / 0.4.1; v0.4.41 hotfix

2026-07-01

@embarkai/ui-kit v0.4.37 – v0.4.38 — Profiles Flow

• Better profiles flow
• v0.4.38: maintenance release

2026-06-30

@embarkai/ui-kit v0.4.34 – v0.4.36 — Binance On-Ramp Refactor

• Binance on-ramp refactored
• v0.4.35: bridge error fix; v0.4.36: maintenance release

2026-06-29

@embarkai/core v0.3.9 — Endpoints on api.embarkai.io

• TSS, auth and vault endpoints moved to api.embarkai.io in the built-in network configs

@embarkai/ui-kit v0.4.33 — Endpoints on api.embarkai.io

• Companion to core 0.3.9: services default to api.embarkai.io
• On-ramp API calls flow through the iframe
• Fix: cached Sumsub KYC tokens are no longer reused
• Build-time __EMBARK_ASSET_API_URL__ honored

2026-06-23

@embarkai/ui-kit v0.4.32 — chainId Option for Asset Hooks

• useBlockscoutAssets accepts a chainId option

2026-06-22

@embarkai/ui-kit v0.4.31 — Bridge UX

• Bridge UX updates

2026-06-17

@embarkai/core v0.3.8 — Lumia Pulsar Testnet

• The Lark testnet config is renamed to Lumia Pulsar Testnet

@embarkai/ui-kit v0.4.30 — Companion Release

• Companion to core 0.3.8; bridge UX flow updates

2026-06-16

@embarkai/core v0.3.7 — Testnet Config & Dependencies

• Lark testnet chain config added
• Dependency updates

@embarkai/ui-kit v0.4.29 — Bridge From External Wallet

• Bridge assets from an external wallet to the embarkAI account
• Fix: bridging tokens

2026-06-15

@embarkai/ui-kit v0.4.27 – v0.4.28 — Bridge History & Locales

• Bridge transaction history and bridge locales
• Tracing added; dependency updates
• v0.4.28: bridge menu crash fix

2026-06-10

@embarkai/ui-kit v0.4.26 — Hyperlane Bridge in Iframe

• The Hyperlane bridge runs inside the secure iframe

2026-06-09

@embarkai/ui-kit v0.4.25 — Maintenance release

2026-06-08

@embarkai/core v0.3.6 — Prism Legacy Gas

• Prism fee calculation uses legacy gas pricing

@embarkai/ui-kit v0.4.23 – v0.4.24 — DUMMY_SIGNATURE Fix

• DUMMY_SIGNATURE fix; companion to core 0.3.6

2026-06-05

@embarkai/ui-kit v0.4.22 — Hyperlane Bridge

• Bridge flow updates; Hyperlane dependencies are loaded lazily

2026-05-29

@embarkai/ui-kit v0.4.21 — Maintenance release

2026-05-28

@embarkai/ui-kit v0.4.19 – v0.4.20 — Security Menu

• Security menu updates
• v0.4.20: maintenance release

2026-05-27

@embarkai/core v0.3.4 — User Profile by ID

• ServerWalletClient: user profile lookup by userId

@embarkai/core v0.3.5 — Maintenance release

@embarkai/ui-kit v0.4.18 — Send/Receive Menus & Batch Transactions

• Dedicated Send and Receive menus
• Batch transactions from the UI Kit (sendBatchUserOperation)
• appUrl in connected-app metadata; connected apps fixes
• Hyperbridge groundwork

2026-05-26

@embarkai/ui-kit v0.4.17 — Maintenance release

2026-05-25

@embarkai/ui-kit v0.4.16 — Portfolio Token Identification

• Improved token identification in the portfolio
• Windows CSS copy build step fixed

2026-05-16

@embarkai/ui-kit v0.4.13 — Maintenance release

2026-05-14

@embarkai/ui-kit v0.4.10 – v0.4.12 — Profile Hooks

• v0.4.11: profile hooks reworked; connected and trusted apps fixes
• v0.4.10: wallet modal click blocking fix
• v0.4.12: verification code expiration timer fix

2026-05-08

@embarkai/ui-kit v0.4.9 — Blockscout Types

• Blockscout address and holders data type fix

2026-04-29

@embarkai/ui-kit v0.4.6 – v0.4.8 — Native Wallet Signatures & Custom Chains

• Native wallet signature hook for external wallets (useNativeWalletSignature)
• EIP-712 signing fixes
• v0.4.8: custom chain support

2026-04-27

@embarkai/ui-kit v0.4.4 – v0.4.5 — X Link Fix

• Fix: X (Twitter) link error message
• v0.4.5: maintenance release

2026-04-22

@embarkai/ui-kit v0.4.3 — Maintenance release

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 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