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

# Kỹ năng Phantom

> Kỹ năng chuyên sâu để xây dựng ứng dụng frontend Solana bằng Phantom Connect SDK và Helius — tích hợp ví, ký giao dịch, kiểm soát truy cập bằng token và thanh toán.

Kỹ năng **Phantom** giúp trợ lý AI của bạn trở thành chuyên gia xây dựng ứng dụng frontend Solana. Kỹ năng này kết hợp [Phantom Connect SDK](https://phantom.com) — tích hợp ví cho React, React Native và JavaScript thuần — với hạ tầng Helius để gửi giao dịch, tối ưu phí, truy vấn tài sản và cập nhật theo thời gian thực.

Sau khi cài đặt, AI sẽ tự động đọc đúng các tệp tham chiếu và gọi đúng [công cụ MCP](/docs/vi/agents/mcp) dựa trên yêu cầu của bạn — không cần chọn công cụ thủ công.

<Info>
  **Claude Code:** `/helius:phantom` (qua [plugin](/docs/vi/agents/claude-code-plugin)) hoặc được tự động gọi (độc lập). **Codex:** `$helius-phantom` (được tự động phát hiện từ `.agents/skills/`). **API / Cursor / ChatGPT:** Sử dụng các [biến thể lời nhắc hệ thống](/docs/vi/agents/skills/overview#sử-dụng-kỹ-năng-trên-nhiều-nền-tảng) dựng sẵn.
</Info>

## Phạm vi hỗ trợ

Kỹ năng Phantom định tuyến AI giữa các SDK Phantom và công cụ Helius:

| Lĩnh vực                          | Tệp tham chiếu                                   | Công cụ MCP được sử dụng                                    |
| --------------------------------- | ------------------------------------------------ | ----------------------------------------------------------- |
| **Kết nối ví — React**            | `react-sdk.md`                                   | —                                                           |
| **Kết nối ví — Trình duyệt**      | `browser-sdk.md`                                 | —                                                           |
| **Kết nối ví — React Native**     | `react-native-sdk.md`                            | —                                                           |
| **Giao dịch**                     | `transactions.md`, `helius-sender.md`            | `getPriorityFeeEstimate`, `getSenderInfo`                   |
| **Kiểm soát truy cập bằng token** | `token-gating.md`, `helius-das.md`               | `getAssetsByOwner`, `searchAssets`, `getAsset`              |
| **Đúc NFT**                       | `nft-minting.md`, `helius-sender.md`             | `getAsset`, `getPriorityFeeEstimate`                        |
| **Thanh toán bằng tiền mã hóa**   | `payments.md`, `helius-enhanced-transactions.md` | `parseTransactions`, `getPriorityFeeEstimate`               |
| **Bảo mật frontend**              | `frontend-security.md`                           | —                                                           |
| **Hiển thị danh mục đầu tư**      | `helius-das.md`, `helius-wallet-api.md`          | `getAssetsByOwner`, `getWalletBalances`, `getTokenBalances` |
| **Cập nhật theo thời gian thực**  | `helius-websockets.md`                           | `transactionSubscribe`, `accountSubscribe`                  |
| **Lịch sử giao dịch**             | `helius-enhanced-transactions.md`                | `parseTransactions`, `getTransactionHistory`                |
| **Mẫu tích hợp**                  | `integration-patterns.md`                        | Nhiều công cụ (tùy theo mẫu)                                |

## Quy tắc chính

Kỹ năng Phantom áp dụng các mẫu quan trọng để ngăn những lỗi frontend phổ biến:

* **Luôn sử dụng `@phantom/react-sdk`** cho React (không bao giờ sử dụng `window.phantom.solana` hoặc `@solana/wallet-adapter-react`)
* **Luôn sử dụng `@phantom/browser-sdk`** cho JavaScript thuần và **`@phantom/react-native-sdk`** cho React Native
* **Không bao giờ để lộ khóa API Helius trong mã máy khách** — chỉ `https://sender.helius-rpc.com/fast` an toàn khi dùng trên trình duyệt mà không cần khóa API
* **Chuyển tiếp mọi thứ khác qua backend** — không bao giờ mở WebSocket Helius trực tiếp từ trình duyệt
* **Luôn gửi giao dịch qua Helius Sender** với `skipPreflight: true`, `maxRetries: 0` và khoản tip Jito
* **Sử dụng công cụ MCP `getPriorityFeeEstimate`** — không bao giờ mã hóa cứng phí ưu tiên

## Mẫu kết hợp

Kỹ năng này cung cấp năm mẫu tham chiếu toàn trình cho các ứng dụng phức tạp:

1. **Giao diện hoán đổi** — Bộ tổng hợp → Phantom ký → gửi qua Helius Sender
2. **Trình xem danh mục đầu tư** — Kết nối Phantom → proxy backend → DAS/Wallet API
3. **Bảng điều khiển thời gian thực** — Kết nối Phantom → WebSocket máy chủ → chuyển tiếp đến máy khách
4. **Chuyển token** — Tạo VersionedTransaction → Phantom ký → gửi qua Sender
5. **Thư viện NFT** — Ví Phantom → truy vấn DAS qua backend → hiển thị NFT

## Điều kiện tiên quyết

Kỹ năng này yêu cầu [máy chủ Helius MCP](/docs/vi/agents/mcp). Với ví nhúng (đăng nhập bằng Google/Apple), bạn cũng cần tài khoản [Phantom Portal](https://phantom.com/portal) có App ID và các URL chuyển hướng nằm trong danh sách cho phép.

Nếu cài đặt qua [plugin Claude Code](/docs/vi/agents/claude-code-plugin), máy chủ MCP sẽ tự động khởi động. Đối với cài đặt độc lập, hãy thêm máy chủ theo cách thủ công:

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

## Cài đặt độc lập

Nếu muốn sử dụng kỹ năng Phantom mà không cần toàn bộ plugin, hãy cài đặt trực tiếp:

<Steps>
  <Step title="Clone the repository">
    ```bash theme={"system"}
    git clone https://github.com/helius-labs/core-ai.git
    cd core-ai/helius-skills/helius-phantom
    ```
  </Step>

  <Step title="Run the install script">
    ```bash theme={"system"}
    ./install.sh
    ```

    Thao tác này cài đặt kỹ năng và các tệp tham chiếu của kỹ năng vào `~/.claude/skills/helius-phantom/`.

    **Tùy chọn:**

    * `./install.sh --project` — cài đặt vào dự án hiện tại (`.claude/skills/helius-phantom/`)
    * `./install.sh --path /custom/path` — cài đặt vào một thư mục tùy chỉnh
  </Step>

  <Step title="Install the Helius MCP server">
    ```bash theme={"system"}
    claude mcp add helius npx helius-mcp@latest
    ```
  </Step>

  <Step title="Set your API key">
    ```bash theme={"system"}
    export HELIUS_API_KEY=YOUR_API_KEY
    ```

    Hoặc sử dụng công cụ MCP `setHeliusApiKey` trong Claude Code. Nếu cần tài khoản mới, hãy xem [Helius CLI](/docs/vi/agents/cli) hoặc sử dụng quy trình đăng ký tự động qua [công cụ MCP](/docs/vi/agents/mcp).
  </Step>
</Steps>

## Lời nhắc mẫu

Sau khi cài đặt, hãy yêu cầu bằng tiếng Anh tự nhiên:

* "Xây dựng giao diện hoán đổi với ví Phantom"
* "Xây dựng trình xem danh mục đầu tư hiển thị token sau khi kết nối Phantom"
* "Làm cách nào để chuyển tiếp khóa API Helius của tôi qua proxy trong Next.js?"
* "Xây dựng bảng điều khiển thời gian thực có kết nối ví"
* "Thêm tính năng kiểm soát truy cập bằng token vào ứng dụng React của tôi bằng Phantom"
* "Xây dựng trang đúc NFT bằng Phantom và Metaplex Core"

AI tự động chọn đúng công cụ và đọc đúng tệp tham chiếu.

## Nội dung đi kèm

Kỹ năng này cài đặt hai thành phần:

* **`SKILL.md`** — Logic định tuyến, quy tắc và ngữ cảnh chuyên sâu định hướng hành vi của AI
* **`prompts/`** — Các biến thể lời nhắc hệ thống dựng sẵn (`openai.developer.md`, `claude.system.md`, `full.md`) — xem [thiết lập nền tảng](/docs/vi/agents/skills/overview#sử-dụng-kỹ-năng-trên-nhiều-nền-tảng)
* **`references/`** — 16 tệp tài liệu chuyên sâu:
  * `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` — Các mẫu ký giao dịch
  * `token-gating.md` — Kiểm soát truy cập bằng token
  * `nft-minting.md` — Đúc NFT bằng Phantom
  * `payments.md` — Luồng thanh toán bằng tiền mã hóa
  * `frontend-security.md` — Chuyển tiếp khóa API qua proxy và CORS
  * `integration-patterns.md` — Các mẫu kết hợp toàn trình
  * `helius-das.md` — Tài liệu tham chiếu DAS API
  * `helius-sender.md` — Tài liệu tham chiếu Sender
  * `helius-priority-fees.md` — Tài liệu tham chiếu phí ưu tiên
  * `helius-wallet-api.md` — Tài liệu tham chiếu Wallet API
  * `helius-websockets.md` — Tài liệu tham chiếu WebSocket
  * `helius-enhanced-transactions.md` — Tài liệu tham chiếu Enhanced Transactions
  * `helius-onboarding.md` — Tài liệu tham chiếu thiết lập tài khoản

## Tìm hiểu thêm

<CardGroup cols={2}>
  <Card title="Helius MCP" icon="plug" href="/docs/vi/agents/mcp">
    Máy chủ MCP cung cấp các công cụ cho kỹ năng này
  </Card>

  <Card title="Claude Code Plugin" icon="puzzle-piece" href="/docs/vi/agents/claude-code-plugin">
    Cài đặt MCP và các kỹ năng chỉ bằng một lần nhấp
  </Card>

  <Card title="Build Skill" icon="hammer" href="/docs/vi/agents/skills/build">
    Phát triển Solana tổng quát với Helius
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/helius-labs/core-ai">
    Mã nguồn và theo dõi vấn đề
  </Card>
</CardGroup>