> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Phantom Skill

> Phantom Connect SDK 및 Helius 인프라를 사용하여 프론트엔드 Solana 애플리케이션을 구축합니다. React, React Native, 브라우저 SDK 통합, 트랜잭션 서명, 토큰 게이팅, NFT 발행, 결제, 안전한 프론트엔드 아키텍처를 다룹니다.

**Phantom** 스킬은 AI 어시스턴트를 프론트엔드 Solana 애플리케이션 구축 전문가로 만들어줍니다. [Phantom Connect SDK](https://phantom.com) — React, React Native, 및 vanilla JS 지갑 통합 — 함께 Helius 인프라를 통해 트랜잭션 제출, 수수료 최적화, 자산 조회 및 실시간 업데이트를 제공합니다.

설치되면, AI는 올바른 참조 파일을 자동으로 읽고 요청에 따라 올바른 [MCP 도구](/docs/ko/agents/mcp)를 호출합니다. 수동 도구 선택은 필요하지 않습니다.

<Info>
  **Claude Code:** `/helius:phantom` ([plugin](/docs/ko/agents/claude-code-plugin) 통해) 또는 자동 호출 (독립 실행형). **Codex:** `$helius-phantom` (`.agents/skills/`에서 자동 발견됨). **API / Cursor / ChatGPT:** 사전에 정의된 [시스템 프롬프트 변형](/docs/ko/agents/skills/overview#플랫폼-간-기술-사용)을 사용하십시오.
</Info>

## 다루는 내용

Phantom 스킬은 AI를 Phantom SDK와 Helius 도구를 따라 라우팅합니다:

| 도메인                      | 참조 파일                                            | 사용된 MCP 도구                                                  |
| ------------------------ | ------------------------------------------------ | ----------------------------------------------------------- |
| **지갑 연결 — React**        | `react-sdk.md`                                   | —                                                           |
| **지갑 연결 — 브라우저**         | `browser-sdk.md`                                 | —                                                           |
| **지갑 연결 — React Native** | `react-native-sdk.md`                            | —                                                           |
| **트랜잭션**                 | `transactions.md`, `helius-sender.md`            | `getPriorityFeeEstimate`, `getSenderInfo`                   |
| **토큰 게이팅**               | `token-gating.md`, `helius-das.md`               | `getAssetsByOwner`, `searchAssets`, `getAsset`              |
| **NFT 발행**               | `nft-minting.md`, `helius-sender.md`             | `getAsset`, `getPriorityFeeEstimate`                        |
| **암호화 결제**               | `payments.md`, `helius-enhanced-transactions.md` | `parseTransactions`, `getPriorityFeeEstimate`               |
| **프론트엔드 보안**             | `frontend-security.md`                           | —                                                           |
| **포트폴리오 표시**             | `helius-das.md`, `helius-wallet-api.md`          | `getAssetsByOwner`, `getWalletBalances`, `getTokenBalances` |
| **실시간 업데이트**             | `helius-websockets.md`                           | `transactionSubscribe`, `accountSubscribe`                  |
| **트랜잭션 기록**              | `helius-enhanced-transactions.md`                | `parseTransactions`, `getTransactionHistory`                |
| **통합 패턴**                | `integration-patterns.md`                        | 여러 개 (패턴 의존적)                                               |

## 주요 규칙

Phantom 스킬은 일반적인 프론트엔드 실수를 방지하는 중요한 패턴을 강제합니다:

* **항상 `@phantom/react-sdk`를 사용하세요** React의 경우 (절대 `window.phantom.solana` 또는 `@solana/wallet-adapter-react` 사용하지 마십시오)
* **Vanilla JS의 경우 `@phantom/browser-sdk`를 사용하고** React Native의 경우 \*\*`@phantom/react-native-sdk`\*\*를 사용하세요
* **Helius API 키를 클라이언트 코드에 노출하지 마세요** — `https://sender.helius-rpc.com/fast`만 API 키 없이 브라우저 안전
* **나머지는 모두 백엔드를 통해 프록시하십시오** — 브라우저에서 Helius WebSockets를 직접 열지 마십시오
* **항상 Helius Sender를 통해 트랜잭션 제출** 상위 `skipPreflight: true`, `maxRetries: 0`, 및 Jito 팁과 함께
* **`getPriorityFeeEstimate`** MCP 도구 사용 — 우선 수수료를 하드코딩하지 마십시오

## 복합 패턴

스킬은 복잡한 애플리케이션에 대한 다섯 가지 종단 간 참조 패턴을 제공합니다:

1. **스왑 UI** — Aggregator → Phantom 서명 → Helius Sender 제출
2. **포트폴리오 뷰어** — Phantom 연결 → 백엔드 프록시 → DAS/Wallet API
3. **실시간 대시보드** — Phantom 연결 → 서버 WebSocket → 클라이언트 릴레이
4. **토큰 전송** — VersionedTransaction 빌드 → Phantom 서명 → Sender 제출
5. **NFT 갤러리** — Phantom 지갑 → 백엔드 DAS 쿼리 → NFT 표시

## 필수 조건

이 스킬에는 [Helius MCP 서버](/docs/ko/agents/mcp)가 필요합니다. 내장 지갑 (Google/Apple 로그인)의 경우 [Phantom Portal](https://phantom.com/portal) 계정과 앱 ID 및 허용된 리디렉션 URL이 필요합니다.

[Claude Code plugin](/docs/ko/agents/claude-code-plugin)을 통해 설치하면 MCP 서버가 자동으로 시작됩니다. 독립 설치의 경우, 수동으로 추가하세요:

```bash theme={"system"}
claude mcp add helius npx helius-mcp@latest
```

## 독립 설치

전체 플러그인 없이 Phantom 스킬을 원하신다면, 직접 설치하세요:

<Steps>
  <Step title="저장소 복제">
    ```bash theme={"system"}
    git clone https://github.com/helius-labs/core-ai.git
    cd core-ai/helius-skills/helius-phantom
    ```
  </Step>

  <Step title="설치 스크립트 실행">
    ```bash theme={"system"}
    ./install.sh
    ```

    이 스킬과 참조 파일을 `~/.claude/skills/helius-phantom/`에 설치합니다.

    **옵션:**

    * `./install.sh --project` — 현재 프로젝트에 설치 (`.claude/skills/helius-phantom/`)
    * `./install.sh --path /custom/path` — 커스텀 디렉토리에 설치
  </Step>

  <Step title="Helius MCP 서버 설치">
    ```bash theme={"system"}
    claude mcp add helius npx helius-mcp@latest
    ```
  </Step>

  <Step title="API 키 설정">
    ```bash theme={"system"}
    export HELIUS_API_KEY=YOUR_API_KEY
    ```

    또는 `setHeliusApiKey` MCP 도구를 Claude Code 내부에서 사용하세요. 새로운 계정이 필요하다면, [Helius CLI](/docs/ko/agents/cli)를 참조하거나 [MCP 도구](/docs/ko/agents/mcp)를 통해 자동 등록 절차를 사용하세요.
  </Step>
</Steps>

## 예제 프롬프트

설치 후, 간단한 영어로 요청하세요:

* "Phantom 지갑으로 스왑 UI 구축"
* "Phantom 연결 후 토큰을 표시하는 포트폴리오 뷰어 구축"
* "Helius API 키를 Next.js에서 프록시하는 방법?"
* "지갑 연결과 함께 실시간 대시보드 구축"
* "Phantom을 사용하여 React 앱에 토큰 게이팅 추가"
* "Phantom과 Metaplex Core로 NFT 발행 페이지 구축"

AI는 올바른 도구를 선택하고 올바른 참조 파일을 자동으로 읽습니다.

## 포함된 내용

스킬은 두 가지 구성 요소를 설치합니다:

* **`SKILL.md`** — AI의 동작을 안내하는 라우팅 로직, 규칙 및 전문가 컨텍스트
* **`prompts/`** — 사전에 구축된 시스템 프롬프트 변형 (`openai.developer.md`, `claude.system.md`, `full.md`) — [플랫폼 설정](/docs/ko/agents/skills/overview#플랫폼-간-기술-사용)을 참조하세요
* **`references/`** — 다음과 같은 16개의 심층 문서 파일:
  * `react-sdk.md` — Phantom React SDK (`@phantom/react-sdk`)
  * `browser-sdk.md` — Phantom Browser SDK (`@phantom/browser-sdk`)
  * `react-native-sdk.md` — Phantom React Native SDK (`@phantom/react-native-sdk`)
  * `transactions.md` — 트랜잭션 서명 패턴
  * `token-gating.md` — 토큰 게이트 접근 제어
  * `nft-minting.md` — Phantom을 사용한 NFT 발행
  * `payments.md` — 암호화 결제 흐름
  * `frontend-security.md` — API 키 프록시 및 CORS
  * `integration-patterns.md` — 종단 간 복합 패턴
  * `helius-das.md` — DAS API 참조
  * `helius-sender.md` — 송신자 참조
  * `helius-priority-fees.md` — 우선 수수료 참조
  * `helius-wallet-api.md` — 지갑 API 참조
  * `helius-websockets.md` — WebSocket 참조
  * `helius-enhanced-transactions.md` — 향상된 트랜잭션 참조
  * `helius-onboarding.md` — 계정 설정 참조

## 추가 정보

<CardGroup cols={2}>
  <Card title="Helius MCP" icon="plug" href="/docs/ko/agents/mcp">
    이 스킬의 도구를 지원하는 MCP 서버
  </Card>

  <Card title="Claude Code Plugin" icon="puzzle-piece" href="/docs/ko/agents/claude-code-plugin">
    MCP + 스킬의 원클릭 설치
  </Card>

  <Card title="Build Skill" icon="hammer" href="/docs/ko/agents/skills/build">
    Helius로 일반 Solana 개발
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/helius-labs/core-ai">
    소스 코드 및 이슈 추적
  </Card>
</CardGroup>