Phantom Connect SDKs

The Phantom Connect client SDKs (React, React Native, Browser) let your app authenticate users and create embedded wallets. All client SDKs support Google and Apple social login. Web SDKs (React, Browser) additionally support Phantom Login, mobile deep links, and browser extension connections. Users who connect with the Phantom extension use their existing wallet without creating a new embedded wallet. This page also links out to two adjacent surfaces that are not Connect client SDKs and have their own setup paths: the Phantom Server SDK (backend wallet infrastructure, accessed via organization credentials) and the Phantom CLI (terminal tool, authenticated with phantom login).

​

Prerequisites (client SDKs)

The React, React Native, and Browser SDKs require that you sign up for an account in Phantom Portal:

1. Sign up at Phantom Portal.
2. Register your app.
3. Configure allowed domains and redirect URLs.
4. Get your App ID.

The Server SDK and CLI do not use this Portal flow — see the setup notes under each section below.

​

Explore our SDKs

Each SDK is designed for specific use cases and environments, providing wallet integration across web and mobile platforms.

​

Web apps

​

React SDK

Use the React SDK when building React web apps that need wallet connectivity. It provides React hooks for integration with your component architecture. Ideal use cases:

• DeFi platforms built with React
• NFT marketplaces
• Web3 gaming interfaces
• Token management dashboards

​

Browser SDK

Use the Phantom Connect Browser SDK for JavaScript/TypeScript apps or any web framework that isn’t React (such as Vue, Angular, Svelte). Ideal use cases:

• Vanilla JavaScript apps
• Vue.js or Angular apps
• Server-side rendered apps
• Progressive Web Apps (PWAs)

​

Mobile apps

​

React Native SDK

Use the Phantom Connect React Native SDK to build native mobile wallet experiences on iOS and Android with React Native. Supports secure OAuth authentication with Google and Apple. Ideal use cases:

• Mobile-first DeFi apps
• Mobile gaming with blockchain integration
• Mobile NFT galleries
• Cross-platform wallet apps

​

Backend apps

​

Server SDK

Use the Server SDK when you need programmatic control over wallet creation and transaction signing from your backend. Ideal for custodial services and APIs where the server manages wallets on behalf of users. Ideal use cases:

• Custodial wallet services
• Automated transaction processing
• Backend APIs managing user wallets
• Gaming platforms with server-controlled assets
• Enterprise blockchain solutions

Setup. The Server SDK does not use the Phantom Portal signup flow. After your organization is provisioned, you’ll receive an Organization ID, an API private key, and an App ID, which you pass to new ServerSDK(...). See Server SDK — Get started for the full setup walkthrough.

​

Command line

​

Phantom CLI

Use the Phantom CLI to interact with your wallet from the terminal. Sign transactions, transfer tokens, swap, manage balances, and trade perpetuals. The CLI also runs as an MCP server for AI agent integration. Ideal use cases:

• Developer workflows and scripting
• AI agent integration via MCP
• Automated token transfers and swaps
• Perpetuals trading from the command line

Setup. The CLI does not require Phantom Portal signup. Install with npm install -g @phantom/cli, then run phantom login to authenticate via Google, Apple, or your Phantom extension in the browser. See Phantom CLI — Installation for details.

​

Client vs server SDKs

​

Client SDKs (React, Browser, React Native)

User-controlled wallets:

• Users connect their existing Phantom wallets
• Users maintain full control of private keys
• Authentication via social login or browser extension
• Best for apps where users manage their own assets

​

Server SDK

Server-controlled wallets:

• Your backend creates and manages wallets programmatically
• Server controls private keys (securely encrypted)
• Authentication via API credentials
• Best for custodial solutions and automated workflows

​

Security models

All Phantom Connect SDKs are built with enterprise-grade security:

• Trusted Execution Environments (TEEs) for secure operations
• Hardware Security Modules (HSMs) for key encryption
• Multi-layer encryption with threshold cryptography
• Cryptographically signed audit trails for compliance
• Organization-based access control with configurable policies

​

Transaction security for embedded wallets

All transactions signed for embedded wallets pass through Phantom’s advanced simulation system before execution. This security layer:

• Simulates transactions before they’re broadcast to detect potential threats
• Automatically blocks malicious transactions that could drain funds or exploit vulnerabilities
• Blocks transactions from origins that have been reported as malicious
• Provides an additional layer of protection for your users’ assets

​

Chain support

All Phantom Connect SDKs support the following blockchain networks:

​

Authentication options

All client SDKs support social login (Google and Apple) and seven-day active sessions. Web SDKs (React, Browser) additionally support:

• Phantom Login: Authenticate with an existing Phantom account
• Mobile deep link: Connect via the Phantom mobile app on mobile devices
• Browser extension: Connect directly to the Phantom browser extension

​

Server SDK

• API credentials: Organization ID, App ID, and Private Key
• Programmatic access: No user interaction required

​

Example apps

Explore complete, production-ready examples built by the Phantom team:

​

Key management and signing

All Phantom Connect SDKs support KMS-backed wallets. The SDK completes a Connect sign-in and stamps requests so KMS can validate, authorize, and sign.

​

AI-powered setup

Use the Phantom Cursor plugin to scaffold any SDK project with AI. The plugin includes skills for React, React Native, and Browser SDK setup. Your Cursor agent handles installation, configuration, and boilerplate automatically.

​

Need help?