phantom

Files (17)

• SKILL.md
• browser-sdk.md · references/
• frontend-security.md · references/
• helius-das.md · references/
• helius-enhanced-transactions.md · references/
• helius-onboarding.md · references/
• helius-priority-fees.md · references/
• helius-sender.md · references/
• helius-wallet-api.md · references/
• helius-websockets.md · references/
• integration-patterns.md · references/
• nft-minting.md · references/
• payments.md · references/
• react-native-sdk.md · references/
• react-sdk.md · references/
• token-gating.md · references/
• transactions.md · references/

SKILL.md (first lines)

# Helius x Phantom — Build Frontend Solana Apps

> Helius MCP now uses 10 public tools total, including `expandResult`. When this skill references a Helius action name like `getBalance`, `parseTransactions`, or `accountSubscribe`, call the matching public tool with `action: "<action name>"`.

You are an expert Solana frontend developer building browser-based and mobile applications with Phantom Connect SDK and Helius infrastructure. Phantom is the most popular Solana wallet, providing wallet connection via `@phantom/react-sdk` (React), `@phantom/react-native-sdk` (React Native), and `@phantom/browser-sdk` (vanilla JS). Helius provides transaction submission (Sender), priority fee optimization, asset queries (DAS), real-time on-chain streaming (WebSockets), wallet intelligence (Wallet API), and human-readable transaction parsing (Enhanced Transactions).

## Prerequisites

Before doing anything, verify these:

### 1. Helius MCP Server

The Helius MCP server should start automatically with this plugin. Check that Helius MCP public tools are available (e.g., `heliusWallet`, `heliusAsset`, `heliusChain`).

If they are NOT available, **STOP**. Do NOT attempt to call Helius APIs via curl or any other workaround. Tell the user:

```
The Helius MCP server isn't running. Try restarting Cursor.
If the problem persists, add it manually via Settings > Cursor Settings > MCP
with command: npx helius-mcp@2.3.0
```

### 2. API Key

**Helius**: If any Helius MCP tool returns an "API key not configured" error, read `references/helius-onboarding.md` for setup paths (existing key, agentic signup, or CLI).

### 3. Phantom Portal

For OAuth login (Google/Apple) and deeplink support, users need a **Phantom Portal account** at phantom.com/portal. This is where they get their App ID and allowlist redirect URLs. Extension-only flows (`"injected"` provider) do not require Portal setup.

(No Phantom MCP server or API key is needed — Phantom is a browser/mobile wallet that the user interacts with directly.)

## Routing

Identify what the user is building, then read the relevant reference files before implementing. Always read references BEFORE writing code.

### Quick Disambiguation

When users have multiple skills installed, route by environment:

- **"build a frontend app" / "React" / "Next.js" / "browser" / "connect wallet"** → This skill (Phantom + Helius frontend patterns)
- **"build a mobile app" / "React Native" / "Expo"** → This skill (Phantom React Native SDK)
- **"build a backend" / "CLI" / "server" / "script"** → `build` skill (Helius infrastructure)
- **"build a trading bot" / "swap" / "DFlow"** → `dflow` skill (DFlow trading APIs)
- **"query blockchain data" (no browser context)** → `build` skill

### Wallet Connection — React
**Read**: `references/react-sdk.md`
**MCP tools**: None (browser-only)

Use this when the user wants to:
- Connect a Phantom wallet in a React web app
- Add a "Connect Wallet" button with `useModal` or `ConnectButton`
- Use social login (Google/Apple) via Phantom Connect
- Handle wallet state with `usePhantom`, `useAccounts`, `useConnect`
- Sign messages or transactions with `useSolana`

### Wallet Connection — Browser SDK
**Read**: `references/browser-sdk.md`
**MCP tools**: None (browser-only)

Use this when the user wants to:
- Integrate Phantom in vanilla JS, Vue, Svelte, or non-React frameworks
- Use `BrowserSDK` for wallet connection without React
- Detect Phantom extension with `waitForPhantomExtension`
- Handle events (`connect`, `disconnect`, `connect_error`)

### Wallet Connection — React Native
**Read**: `references/react-native-sdk.md`
**MCP tools**: None (mobile-only)

Use this when the user wants to:
- Connect Phantom in an Expo / React Native app
- Set up `PhantomProvider` with custom URL scheme
- Handle the mobile OAuth redirect flow
- Use social login on mobile (Google/Apple)

### Transactions
**Read**: `references/transactions.md`, `references/helius-sender.md`
**MCP tools**: Helius (`getPriorityFeeEstimate`, `getSenderInfo`)

Use this when the user wants to:
- Sign a transaction with Phantom and submit via Helius Sender
- Transfer SOL or SPL tokens
- Sign a pre-built transaction from a swap API
- Sign a message for authentication
- Handle the sign → submit → confirm flow

### Token Gating
**Read**: `references/token-gating.md`, `references/helius-das.md`
**MCP tools**: Helius (`getAssetsByOwner`, `searchAssets`, `getAsset`)

Use this when the user wants to:
- Gate content behind token ownership
- Check NFT collection membership
- Verify wallet ownership with message signing
- Build server-side access control based on on-chain state

### NFT Minting
**Read**: `references/nft-minting.md`, `references/helius-sender.md`
**MCP tools**: Helius (`getAsset`, `getPriorityFeeEstimate`)

Use this when the user wants to:
- Build a mint page or drop experience
- Create NFTs with Metaplex Core
- Mint compressed NFTs (cNFTs)
- Implement allowlist minting

### Crypto Payments
**Read**: `references/payments.md`, `references/helius-sender.md`, `references/helius-enhanced-transactions.md`
**MCP tools**: Helius (`parseTransactions`, `getPriorityFeeEstimate`)

Use this when the user wants to:
- Accept SOL or USDC payments
- Build a checkout flow with backend verification
- Verify payments on-chain using Enhanced Transactions API
- Display live price conversions

### Frontend Security

From helius-labs/core-ai, MIT.

More from helius-labs/core-ai