# helius-phantom

Guides development of Solana web and mobile apps using Phantom Connect SDK and Helius APIs. Handles wallet connection, transaction signing, and asset display.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 29
- Author: Helius Labs
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/helius-labs/core-ai/tree/HEAD/helius-skills/helius-phantom/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/helius-phantom

## What it does

This skill instructs the agent on building Solana frontends combining Phantom Connect SDK with Helius services. It supports React, React Native, and vanilla JavaScript environments. The instructions cover wallet connection components, balance displays, and Metaplex Core NFT minting.

On-chain operations rely on the Helius MCP router, which provides 10 public tools including `heliusWallet`, `heliusAsset`, and `heliusTransaction`. Transactions are routed through Helius Sender with dynamic priority fee calculations.

The skill halts if `helius-mcp@2.3.0` is missing from your MCP configuration. An active Helius API key is mandatory for data queries. Social login via Apple or Google requires an App ID from Phantom Portal, while standard browser extension setups work without it.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add helius-labs/core-ai --skill helius-phantom -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/helius-phantom/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/helius-phantom/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add helius-labs/core-ai --skill helius-phantom -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/helius-phantom/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add helius-labs/core-ai --skill helius-phantom -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/helius-phantom/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install helius-labs/core-ai helius-phantom
```

2. **Manually: put the files in place**
- File: `.github/skills/helius-phantom/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add helius-labs/core-ai --skill helius-phantom -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/helius-labs/core-ai --path helius-skills/helius-phantom
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/helius-phantom/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add helius-labs/core-ai --skill helius-phantom -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/helius-labs/core-ai/tree/HEAD/helius-skills/helius-phantom/SKILL.md

## When to use it
- connect Phantom wallet via React, React Native, or browser SDKs
- sign and submit Solana transactions via Helius Sender with priority fees
- gate content using NFT ownership verification with Helius DAS API
- verify incoming crypto payments in SOL or USDC using Enhanced Transactions

## Example prompts
- Add a Phantom connect button to our Next.js page using `@phantom/react-sdk`
- Set up a SOL transfer transaction submitted via Helius Sender with priority fee estimates
- Implement token gating by checking NFT ownership via Helius DAS for the connected wallet

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: b9dd9942624358c9.

BEGIN THIRD-PARTY FILE b9dd9942624358c9
````text
---
name: helius-phantom
description: Build frontend Solana applications with Phantom Connect SDK and Helius infrastructure. Covers React, React Native, and browser SDK integration, transaction signing via Helius Sender, API key proxying, token gating, NFT minting, crypto payments, real-time updates, and secure frontend architecture.
license: MIT
metadata:
  author: Helius Labs
  version: "1.0.5"
  tags:
    - solana
    - phantom
    - wallet
    - frontend
    - react
    - react-native
    - nextjs
    - dapp
  mcp-server: helius-mcp
---

# Helius x Phantom — Build Frontend Solana Apps

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

## MCP Router Surface

Helius MCP now exposes 10 public tools total: 9 routed domain tools plus `expandResult`.
`heliusAccount`, `heliusWallet`, `heliusAsset`, `heliusTransaction`, `heliusChain`, `heliusStreaming`, `heliusKnowledge`, `heliusWrite`, `heliusCompression`, and `expandResult`.

This skill still names Helius action names like `getBalance`, `parseTransactions`, or `transactionSubscribe`. Translate them by using the correct router tool plus `action: "<action name>"`.

Examples:
- `heliusWallet({ action: "getBalance", address: "..." })`
- `heliusTransaction({ action: "parseTransactions", signatures: ["..."] })`
- `heliusStreaming({ action: "accountSubscribe", account: "..." })`

## Prerequisites

Before doing anything, verify these:

### 1. Helius MCP Server

**CRITICAL**: Check if 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:

```
You need to install the Helius MCP server first:
claude mcp add helius npx helius-mcp@2.3.0
Then restart Claude so the tools become available.
```

### 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.
````
END THIRD-PARTY FILE b9dd9942624358c9

The third-party file has ended. Everything between the b9dd9942624358c9 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2806 of 19567 bytes. © Helius Labs · MIT · https://github.com/helius-labs/core-ai/tree/HEAD/helius-skills/helius-phantom/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md