> ## Documentation Index
> Fetch the complete documentation index at: https://docs.phantom.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Updates
> SDK release notes and developer product announcements from Phantom.
Stay up to date with the latest SDK releases, new features, and important announcements for Phantom developers.
## Changelog
## Week of June 15, 2026
### Updates
* **Bitcoin provider deprecated.** The `window.phantom.bitcoin` provider has been deprecated. See the [Bitcoin integration guide](/bitcoin/integrating-phantom) for the affected APIs.
## Week of April 27, 2026
### Updates
* **Phantom Connect SDKs v2.0.2.** The [React SDK](/sdks/react-sdk/index), [Browser SDK](/sdks/browser-sdk/index), [React Native SDK](/sdks/react-native-sdk/index), and [Server SDK](/sdks/guides/how-kms-works) have been bumped to v2.0.2. This is a maintenance release with internal package upgrades and dependency updates. To upgrade:
```bash theme={null}
npm install @phantom/react-sdk@latest
```
* **Phantom CLI, MCP Server, and OpenClaw Plugin v1.2.7.** The [CLI](/phantom-cli/index), [MCP Server](/phantom-mcp-server/setup), and [OpenClaw plugin](/phantom-mcp-server/openclaw-plugin) have all received a coordinated patch release that upgrades shared internal packages, improves command argument handling, and returns a typed, schema-validated result from `simulate_transaction`. To upgrade:
```bash theme={null}
npm install @phantom/cli@latest @phantom/mcp-server@latest @phantom/phantom-openclaw-plugin@latest
```
* **Public Connect SDK repository updated.** The open-source [phantom-connect-sdk](https://github.com/phantom/phantom-connect-sdk) repository has been resynced with the latest internal changes so the published source matches the latest npm packages.
## Week of April 20, 2026
### Updates
* **App ID and Client ID support in the OpenClaw plugin.** The [OpenClaw plugin](/phantom-mcp-server/openclaw-plugin) now accepts `PHANTOM_APP_ID` and `PHANTOM_CLIENT_ID` in its configuration. If you registered your app in the [Phantom Portal](/phantom-portal/portal), you can pass your App ID so that tool calls are attributed to your application.
* **Deferred authentication in the OpenClaw plugin.** The plugin no longer attempts to authenticate when it loads. Authentication is deferred until the first tool call, which speeds up agent startup and avoids errors in environments where a browser is not immediately available.
* **Bitcoin provider deprecation notice.** The `window.phantom.bitcoin` provider will be deprecated in an upcoming release. If your app uses the Bitcoin injected provider, plan to migrate off it.
* **Phantom Connect SDK repo sync.** The public [phantom-connect-sdk](https://github.com/phantom/phantom-connect-sdk) repository has been updated with the latest internal changes. This keeps the open-source codebase in sync with the latest shipped versions of the [React SDK](/sdks/react-sdk/index), [Browser SDK](/sdks/browser-sdk/index), and [React Native SDK](/sdks/react-native-sdk/index). The CLI, MCP Server, and OpenClaw plugin are versioned separately — see the release block below.
## Phantom CLI v1.2, MCP Server v1.2, and OpenClaw Plugin v1.2 — April 2026
**Affected packages:** `@phantom/cli`, `@phantom/mcp-server`, `@phantom/phantom-openclaw-plugin`
### Updates
* **Stricter tool input validation.** All tool inputs are now validated with typed schemas instead of loose JSON Schema checks. Invalid parameters are caught earlier with clearer error messages, reducing failed tool calls for both CLI users and AI agents.
* **MCP Server and OpenClaw Plugin now powered by the CLI.** The [MCP Server](/phantom-mcp-server/setup) and [OpenClaw plugin](/phantom-mcp-server/openclaw-plugin) now import all tools directly from `@phantom/cli`. This means bug fixes and improvements to any tool are immediately available across all three surfaces — terminal, MCP agents, and OpenClaw agents — without separate releases.
* **Improved OpenClaw plugin session handling.** The OpenClaw plugin now creates its own session manager instance during tool registration, improving reliability when multiple tools run concurrently in the same agent session.
To upgrade:
```bash theme={null}
npm install @phantom/cli@latest @phantom/mcp-server@latest @phantom/phantom-openclaw-plugin@latest
```
See the [CLI documentation](/phantom-cli/index), [MCP Server setup guide](/phantom-mcp-server/setup), and [tool reference](/phantom-mcp-server/tools) for details.
## Phantom CLI v1.0.0, MCP Server v1.1.0, and OpenClaw Plugin v1.1.0 — April 2026
**Affected packages:** `@phantom/cli`, `@phantom/mcp-server`, `@phantom/phantom-openclaw-plugin`
### New features
* **Phantom CLI.** The new [`@phantom/cli`](https://www.npmjs.com/package/@phantom/cli) package gives you a standalone terminal interface for your Phantom wallet. Sign transactions, transfer tokens, swap across chains, and trade Hyperliquid perpetuals — all from the command line. Authenticate once with `phantom login` and your session refreshes automatically. See the [CLI documentation](/phantom-cli/index) for the full command reference.
* **MCP server mode built in.** Run `phantom --mcp` to start the CLI as an MCP stdio server, exposing every command as a tool for AI agents. The `@phantom/mcp-server` package (now v1.1.0) wraps this mode in a dedicated binary for agents that need a standalone entry point.
### Updates
* **Unified architecture.** The MCP Server now delegates to the CLI for all wallet operations. This means both surfaces share the same tools and stay in sync automatically — any improvement to the CLI is immediately available to MCP agents.
* **Improved OpenClaw plugin session handling.** The [OpenClaw plugin](https://www.npmjs.com/package/@phantom/phantom-openclaw-plugin) now uses a shared session manager, improving reliability when multiple tools run in the same agent session.
See the [CLI documentation](/phantom-cli/index), [MCP Server setup guide](/phantom-mcp-server/setup), and [tool reference](/phantom-mcp-server/tools) for details.
## Phantom Connect SDKs v2.0.1 — Stable release - April 2026
**Affected SDKs:** React SDK, Browser SDK, React Native SDK, Server SDK
The Phantom Connect SDKs v2.0.1 is the first stable release of the 2.0 line. The [v2.0.0-beta.0](/updates#phantom-connect-sdks-v2-0-beta-april-2026) introduced OAuth2 PKCE-based authentication; this release graduates that to stable and includes a performance improvement that speeds up wallet connections.
To upgrade from the beta or from 1.x:
```bash theme={null}
npm install @phantom/react-sdk@latest
```
### Updates
* **Faster wallet connections.** The SDKs no longer fetch all organization wallets during the connection flow. Wallet resolution now uses a direct tag-based lookup, which reduces latency — especially for accounts with many wallets.
* **More reliable token refresh.** Access tokens are now refreshed synchronously before API calls instead of in the background, preventing rare cases where an expired token could reach the server.
See the [React SDK](/sdks/react-sdk/index), [Browser SDK](/sdks/browser-sdk/index), [React Native SDK](/sdks/react-native-sdk/index), or [Server SDK](/sdks/guides/how-kms-works) documentation to get started.
## Phantom MCP Server and OpenClaw Plugin — Text-mode login and usability improvements - April 2026
The [Phantom MCP Server](https://www.npmjs.com/package/@phantom/mcp-server) and [OpenClaw plugin](https://www.npmjs.com/package/@phantom/phantom-openclaw-plugin) now support text-mode authentication and include several usability improvements for AI agents.
### New features
* **Text-mode login.** The `phantom_login` tool now accepts a `displayMode` parameter. Set it to `"text"` to receive the device authorization URL and code as text instead of opening a browser — useful for headless or remote environments where a browser is not available.
* **Version reporting.** `get_connection_status` now includes `mcpServerVersion` (MCP Server) or `openClawPluginVersion` (OpenClaw plugin) in its response, making it easier to verify which version your agent is running.
### Updates
* **Simplified tool inputs.** The `walletId` parameter has been removed from `get_perp_markets` and `transfer_tokens` — the authenticated wallet is used automatically.
* **Improved balance tool guidance.** `get_token_balances` now clarifies that it does not include Hyperliquid perpetuals account balances and suggests calling `get_perp_account` for perps exposure.
* **Lazy authentication in OpenClaw.** The OpenClaw plugin no longer blocks on authentication during plugin registration. Authentication is deferred until the first tool call, which speeds up agent startup.
### Bug fixes
* **Hyperliquid withdrawal bridge provider.** Fixed the bridge provider identifier used in Hyperliquid spot withdrawals, resolving potential failures when bridging funds out.
See the [setup guide](/phantom-mcp-server/setup) and [tool reference](/phantom-mcp-server/tools) for full documentation.
## Phantom MCP Server v1.0.4 and OpenClaw Plugin v1.0.3 - April 2026
The [Phantom MCP Server](https://www.npmjs.com/package/@phantom/mcp-server) v1.0.4 improves session handling, EVM reliability, and Hyperliquid withdrawals. The [OpenClaw plugin](https://www.npmjs.com/package/@phantom/phantom-openclaw-plugin) v1.0.3 picks up the same fixes.
### Updates
* **Reworked `withdraw_from_hyperliquid_spot`.** Now uses a quote-first flow with dry-run preview before executing. Optionally receive a different token on the destination chain with the `buyToken` parameter. This brings the total tool count to 29. See the [tool reference](/phantom-mcp-server/tools) for details.
* **Improved automatic token refresh.** Read-only and idempotent tools are now retried automatically after a token refresh; other tools return a simple "retry now" response instead of requiring full re-authentication.
* **Improved EVM transaction reliability.** `transfer_tokens` now fetches gas estimates, gas prices, and nonces in parallel, reducing latency and avoiding stale-nonce errors on busy networks.
## Phantom MCP Server v1.0.3 - April 2026
The [Phantom MCP Server](https://www.npmjs.com/package/@phantom/mcp-server) v1.0.3 adds automatic session refresh, Hypercore explorer links, and several reliability improvements.
### New features
* **Automatic session refresh.** Expired OAuth sessions are now refreshed automatically in the background. Previously, an expired token required full re-authentication. Now, the MCP Server detects 401 errors, refreshes the token, and retries the request — so your workflow is not interrupted.
* **Hypercore explorer links.** Transaction results for swaps targeting Hypercore/Hyperliquid L1 now include a link to the [Hyperliquid explorer](https://app.hyperliquid.xyz/explorer).
### Updates
* **Simplified tool inputs.** Several tools no longer require an optional `walletId` parameter — the authenticated wallet is used automatically.
* **OpenClaw plugin.** The [@phantom/phantom-openclaw-plugin](https://www.npmjs.com/package/@phantom/phantom-openclaw-plugin) now sends analytics headers and supports dynamic OAuth token refresh, improving session reliability for [OpenClaw](https://openclaw.com) agents.
### Bug fixes
* **EVM token transfers.** Fixed a race condition in EVM transfers where the transaction nonce was not fetched before signing, which could cause failures under concurrent usage.
See the [setup guide](/phantom-mcp-server/setup) and [tool reference](/phantom-mcp-server/tools) for full documentation.
## Phantom MCP Server v1.0.2 — Stable release - April 2026
The [Phantom MCP Server](https://www.npmjs.com/package/@phantom/mcp-server) v1.0.2 is the first stable release with 28 tools across wallet operations, swaps, and perpetuals trading.
### What's new in v1.0
* **No fees on swaps.** All swaps executed through `buy_token` and `portfolio_rebalance` are fee-free — no transaction fees, platform fees, or commission.
* **Cross-chain swaps.** `buy_token` supports Solana ↔ EVM swaps in both directions, including targeting Hypercore/Hyperliquid.
* **Perpetuals trading on Hyperliquid.** Full trading lifecycle — open/close positions, manage leverage, view markets and history. See below for details.
* **Transaction simulation.** `simulate_transaction` previews asset changes, security warnings, and blocking conditions without submitting on-chain.
* **ERC-20 allowance checking.** `get_token_allowance` checks whether an approval is needed before a swap.
* **Reworked Hyperliquid funding flow.** `deposit_to_hyperliquid` and `withdraw_from_hyperliquid_spot` now use a quote-first flow, support more destination chains (Solana, Ethereum, Base, Arbitrum, Polygon), and can receive non-USDC tokens via the `buyToken` parameter.
* **OpenClaw plugin.** The new `@phantom/phantom-openclaw-plugin` package brings Phantom wallet tools directly into [OpenClaw](https://openclaw.com) agents.
See the [setup guide](/phantom-mcp-server/setup) and [tool reference](/phantom-mcp-server/tools) for full documentation.
## Phantom MCP Server — Perpetuals trading and transaction simulation (beta) - April 2026
These features are now stable in v1.0.2. See the entry above for the latest.
The [Phantom MCP Server](https://www.npmjs.com/package/@phantom/mcp-server) added perpetuals trading on Hyperliquid and transaction simulation in the `1.0.0-beta.0` prerelease, bringing the tool count from 13 to 25.
### Perpetuals trading on Hyperliquid
Your AI assistant can now trade perpetual futures on [Hyperliquid](https://hyperliquid.xyz) directly through the MCP Server. New tools cover the full trading lifecycle:
* **Account and market data** — `get_perp_account`, `get_perp_markets`, `get_perp_positions`, `get_perp_orders`, and `get_perp_trade_history` for reading account balances, available markets, open positions, active orders, and historical trades.
* **Trading** — `open_perp_position` and `close_perp_position` for opening and closing positions with configurable leverage, margin type, and order type (market or limit). `cancel_perp_order` cancels open orders.
* **Position management** — `update_perp_leverage` to change leverage and margin type (cross or isolated) per market.
* **Funding** — `deposit_to_hyperliquid` bridges assets to Hyperliquid, `transfer_spot_to_perps` moves USDC from your spot account into the perps account, and `withdraw_from_perps` transfers USDC back out.
### Transaction simulation
The new `simulate_transaction` tool previews the effects of a transaction — including expected asset changes, security warnings, and blocking conditions — without submitting anything on-chain. Available for both Solana and EVM transactions.
### ERC-20 token allowance checking
The new `get_token_allowance` tool returns the ERC-20 allowance granted by an owner to a spender on any supported EVM chain. Use it before a swap to check whether an approval transaction is needed.
See the [Phantom MCP Server documentation](/phantom-mcp-server) to get started.
## Phantom MCP Server v1.0 — GA release - April 2026
See v1.0.2 above for the latest stable release and cumulative feature list.
The [Phantom MCP Server](https://www.npmjs.com/package/@phantom/mcp-server) has graduated from beta to a stable release. If you were using the `1.0.0-beta.0` prerelease, install the stable version:
```bash theme={null}
npx -y @phantom/mcp-server@latest
```
### Dedicated agent wallets
Agents now receive their own dedicated wallet when they authenticate, instead of connecting to your personal wallet. This means agents must be funded before they can perform on-chain actions. After authenticating, use `get_wallet_addresses` to check the agent's wallet address and send funds to it.
### Cross-chain swaps
The `buy_token` tool now supports swaps between Solana and EVM chains (Ethereum, Base, Polygon, Arbitrum), in addition to same-chain swaps. Pass a different `buyChainId` than `sellChainId` to initiate a cross-chain swap.
## Phantom Connect SDK — now open source - April 2026
The Phantom Connect SDK source code is now publicly available on GitHub at [github.com/phantom/phantom-connect-sdk](https://github.com/phantom/phantom-connect-sdk).
The repository includes all Phantom Connect packages:
* **Client SDKs** — [React SDK](/sdks/react-sdk/index), [React Native SDK](/sdks/react-native-sdk/index), and [Browser SDK](/sdks/browser-sdk/index) for web and mobile wallet integration
* **Server SDK** — backend wallet creation, transaction signing, and message signing
* **MCP Server** — the [Phantom MCP Server](/phantom-mcp-server/index) and [OpenClaw plugin](/phantom-mcp-server/openclaw-plugin) for AI agent wallet access
* **Example apps** — production-ready demos for [React](https://github.com/phantom/phantom-connect-sdk/tree/main/examples/react-sdk-demo-app), [React Native](https://github.com/phantom/phantom-connect-sdk/tree/main/examples/react-native-sdk-demo-app), [Next.js](https://github.com/phantom/phantom-connect-sdk/tree/main/examples/with-nextjs), [Wagmi](https://github.com/phantom/phantom-connect-sdk/tree/main/examples/with-wagmi), and [vanilla JS](https://github.com/phantom/phantom-connect-sdk/tree/main/examples/browser-sdk-demo-app)
You can browse the full implementation, open issues, and submit pull requests.
## Phantom Connect SDKs v2.0 (beta) - April 2026
**Affected SDKs:** React SDK, Browser SDK, React Native SDK
The Phantom Connect SDKs are now available as a `2.0.0-beta.0` prerelease with an updated authentication flow. The new auth system uses an OAuth2 PKCE-based flow for improved security and session management.
To try the beta, install the prerelease version from npm:
```bash theme={null}
npm install @phantom/react-sdk@beta
```
See the [React SDK](/sdks/react-sdk/index), [Browser SDK](/sdks/browser-sdk/index), or [React Native SDK](/sdks/react-native-sdk/index) documentation to get started.
## Phantom MCP Server v0.2.4 - March 2026
The [Phantom MCP server](https://www.npmjs.com/package/@phantom/mcp-server) has been updated to v0.2.4 with 3 new tools, bringing the total from 10 to 13.
### Portfolio rebalancing
The new `portfolio_rebalance` tool lets your AI assistant analyze your current Solana portfolio allocation and rebalance it to target percentages via token swaps. Supports dry-run mode to preview the swap plan before executing.
### Other new tools
* `phantom_login` — Re-authenticate, switch accounts, or refresh an expired session
* `pay_api_access` — Pay for daily API access when quota is consumed
See the [Phantom MCP server documentation](/phantom-mcp-server) to get started.
## Phantom MCP server v0.2.1 - March 2026
The [Phantom MCP server](https://www.npmjs.com/package/@phantom/mcp-server) has been updated to v0.2.1 with expanded multi-chain support. The tool set has grown from 5 to 10 tools, adding dedicated EVM transaction signing, EIP-191 and EIP-712 message signing, token balance retrieval, and a connection status check. `transfer_tokens` now works across both Solana and EVM chains.
See the [Phantom MCP server documentation](/phantom-mcp-server) to get started.
## Phantom Connect v1.0.7 - March 2026
**Affected SDKs:** React SDK, Browser SDK, React Native SDK
### New features
**Dapp-sponsored transactions**
All three SDKs now support dapp-sponsored transactions for Solana, enabling double-signing flows where your backend co-signs a transaction before Phantom finalizes it. This is ideal for dapp fee-payer use cases where your app covers transaction fees on behalf of users.
Learn how to implement dapp-sponsored transactions in the sign-and-send transactions guide for the [React SDK](/sdks/react-sdk/sign-and-send-transaction), [Browser SDK](/sdks/browser-sdk/sign-and-send-transaction), or [React Native SDK](/sdks/react-native-sdk/sign-and-send-transaction).
## Phantom Cursor plugin - March 2026
The [Phantom Cursor plugin](https://cursor.com/marketplace/phantom) is now available on the Cursor Marketplace. Install it to give your AI coding agent wallet capabilities, SDK knowledge, and Phantom best practices directly in Cursor.
The plugin bundles subagents, skills, rules, and MCP servers into a single install. Your agent can scaffold complete Phantom Connect projects, write integration code that follows best practices, execute wallet operations across Solana, Ethereum, Bitcoin, and Sui, and search Phantom documentation in real time.
Install from the [Cursor Marketplace](https://cursor.com/marketplace/phantom) or learn more in the [Cursor plugin documentation](/resources/cursor-plugin).
## Phantom Connect v1.0.2 - January 15, 2026
**Affected SDKs:** React SDK, Browser SDK, React Native SDK
#### Bug fixes
**Detect account changes when using injected provider**
Fixed an issue where the SDK wouldn't detect when users switch accounts in their injected wallet provider (for example, Phantom extension). The SDK now automatically detects account changes and updates the connection state accordingly.
**Improved wallet detection for mobile wallets**
Fixed an issue where mobile wallets weren't properly detected and displayed in the wallet discovery list. The SDK now correctly detects and displays all available mobile wallets.
**Prevent connection to unsupported networks**
Fixed an issue where the SDK would attempt to connect to networks that aren't supported by certain wallet providers, which could cause connection errors. The SDK now correctly validates network support before attempting connections.
## December 2025
### Phantom Connect SDK MCP server
Your AI coding assistant can now search Phantom documentation directly. The Phantom Connect SDK MCP server gives Cursor, VS Code, Claude, and Claude Code real-time access to our docs for accurate answers while you code. Use the contextual menu on any docs page to auto-install, or check out the [Phantom Connect SDK MCP server setup guide](/resources/mcp-server).
### Spending limits
Users can now set spending limits when connecting to apps via Phantom Connect. This security feature allows users to control how much an app can spend on their behalf, with on-chain enforcement. Learn more in the [spending limits documentation](/spending-limits).
### Phantom Connect SDKs
The Phantom Connect SDKs provide a streamlined way to integrate Phantom wallet functionality into your applications. Check out the SDK documentation:
* [React SDK](/sdks/react-sdk/index) - For React web applications
* [React Native SDK](/sdks/react-native-sdk/index) - For mobile applications
* [Browser SDK](/sdks/browser-sdk/index) - For vanilla JavaScript applications