MỚI: Solana Privacy Rings hiện đã hoạt động trên mainnet
Helius dành cho Agent
Blog/Cập nhật

Helius dành cho Agent

Developer Experience Engineer0xIchigo trên X0xIchigo trên LinkedIn0xIchigo trên GitHub
Đọc trong 9 phút

Các agent AI cần công cụ có cấu trúc, quy trình rõ ràng và ngữ cảnh phù hợp để xây dựng ứng dụng sẵn sàng cho môi trường production trên Solana.

Nếu thiếu những yếu tố này, agent sẽ phỏng đoán lệnh gọi API, tạo ra endpoint không tồn tại, mã hóa cứng các khoản phí vốn cần thay đổi linh hoạt và bỏ lỡ những phương án nhanh hơn như Helius Sender và LaserStream.

Để giải quyết vấn đề này, chúng tôi ra mắt một bộ công cụ dành cho các agent xây dựng trên Helius:

  1. Helius MCP Server
  2. Helius Skills
  3. Helius CLI
  4. Helius Claude Code Plugin

Chúng tôi cũng không ngừng tối ưu các SDK TypeScript và Rust, cùng tài liệu hướng dẫn, để agent tự động và trợ lý AI có thể đề xuất cũng như sử dụng hiệu quả các công cụ này dễ dàng hơn. 

Dưới đây là chức năng của từng công cụ và cách chúng phối hợp với nhau:

Helius MCP Server: Bộ công cụ

Model Context Protocol (MCP) là một tiêu chuẩn mã nguồn mở do Anthropic giới thiệu, cho phép các mô hình AI kết nối an toàn với nguồn dữ liệu, công cụ và API bên ngoài. Tiêu chuẩn này thay thế các tích hợp tùy chỉnh bằng một giao diện phổ quát, được chuẩn hóa. 

Helius MCP Server mở quyền truy cập Helius—và Solana—cho mọi MCP client.

Nếu không có MCP, một agent muốn kiểm tra số dư ví phải mở shell, tạo lệnh curl, gửi lệnh, phân tích đầu ra JSON rồi hy vọng rằng endpoint và tham số đều chính xác.

Khi quy trình này lặp lại với mọi lệnh gọi API trong một workflow, các tương tác sẽ trở nên chậm, mong manh và dễ lỗi vì phải khởi tạo một phiên shell cho từng lệnh.

Với MCP, không cần thực hiện bất kỳ bước nào như vậy.

Agent gọi getBalance dưới dạng một lệnh gọi công cụ có cấu trúc và nhận phản hồi có kiểu dữ liệu. Không cần shell. Không cần curl. Không cần phân tích đầu ra—mọi thứ hoạt động ngay.

Điều tương tự áp dụng cho parseTransaction, getAssetsByOwner, createWebhook và hơn 60 công cụ khác. Giờ đây, agent có thể sử dụng trực tiếp Helius với đúng tham số và nhận lại dữ liệu có cấu trúc. 

Helius MCP server cung cấp các công cụ cho:

  • Đăng ký tự động: tạo tài khoản, lấy khóa API, nâng cấp, v.v.
  • Dữ liệu blockchain trực tiếp: RPC, DAS API, ZK Compression và nhiều hơn nữa
  • Truyền phát dữ liệu:  WebSockets (tiêu chuẩn và nâng cao), LaserStream gRPC (độ trễ ở cấp shred)
  • Gửi giao dịch: Priority Fee API, chuyển SPL và Sender
  • Webhook: Tạo, cập nhật và xóa thông báo dựa trên sự kiện
  • Ví và lịch sử: số dư, chuyển khoản, phân tích giao dịch, danh tính ví và thực hiện phân tích nguồn tiền
  • Kiến thức về Solana: SIMD, tham chiếu mã nguồn Agave và Firedancer, nội dung blog Helius và tìm kiếm tài liệu Solana chính thức

Cài đặt nhanh

Để thêm Helius MCP Server bằng Claude Code, hãy chạy:

Mã
claude mcp add helius npx helius-mcp@latest

Với Codex, hãy chạy:

Mã
codex mcp add helius -- npx helius-mcp@latest

Với Cursor, VS Code hoặc các công cụ tương tự, hãy thêm vào cấu hình MCP:

Mã
{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Sau đó, đặt khóa API bằng công cụ setHeliusApiKey hoặc biến môi trường (ví dụ: HELIUS_API_KEY) và bắt đầu triển khai.

Đối với người dùng mới, agent có thể tự động tạo tài khoản cho bạn—agent tạo một cặp khóa và gọi signup bằng email cùng tên của bạn; sau đó bạn thanh toán gói mong muốn qua liên kết thanh toán (hoặc nạp tiền vào cặp khóa để tự động thanh toán). 

Helius Skills: Bộ não

MCP cho phép agent truy cập hơn 60 công cụ. Tuy nhiên, chỉ có quyền truy cập là chưa đủ—một agent có danh mục công cụ cũng giống như một nhà phát triển mở sẵn các tab tài liệu nhưng không có kinh nghiệm. Agent có thể gọi công cụ, nhưng không biết nên chọn công cụ nào, cách kết hợp chúng cho một tác vụ cụ thể hoặc những lỗi nào cần tránh. 

Skill chính là bộ não. Đây là các bộ hướng dẫn chuyên môn—những prompt được xây dựng kỹ lưỡng với logic định tuyến, tệp tham chiếu và quy tắc—giúp agent trở thành một nhà phát triển Solana thành thạo.

Khi một skill được nạp, agent biết rằng searchAssets tốt hơn getProgramAccounts khi tra cứu NFT, priority fee cần được truy xuất linh hoạt qua getPriorityFeeEstimates và giao dịch nên đi qua Sender để đạt tỷ lệ được đưa vào block cao nhất. Skill cung cấp cho agent kiến thức chuyên sâu theo lĩnh vực.

Hôm nay, chúng tôi ra mắt bốn Helius Skills chính:

Build

Skill Build dành cho hoạt động phát triển Solana cốt lõi. Skill này định tuyến đến đúng công cụ cho DAS, Sender, WebSockets, LaserStream, Webhook, Enhanced Transactions, phân tích ví và quy trình tiếp nhận người dùng. Đây là skill mặc định để xây dựng mọi thứ trên Solana bằng Helius. 

DFlow

Skill DFlow dành cho việc xây dựng ứng dụng giao dịch. Skill này kết hợp các API DFlow (tức là hoán đổi giao ngay, thị trường dự đoán, truyền phát theo thời gian thực, Proof KYC) với hạ tầng Helius để gửi giao dịch, tối ưu phí và giám sát on-chain. 

Phantom

Skill Phantom dành cho việc xây dựng ứng dụng frontend bằng Phantom Connect SDK. Skill này bao quát kết nối ví, kiểm soát quyền truy cập bằng token, đúc NFT, thanh toán bằng tiền mã hóa, hiển thị danh mục đầu tư và kiến trúc frontend an toàn.

SVM

Skill SVM giúp agent hiểu cơ chế nội bộ của giao thức Solana. Khám phá cách bytecode sBPF được thực thi, các cân nhắc trong thiết kế Alpenglow, kinh tế học validator và nhiều chủ đề khác bằng cách truy xuất nội dung trực tiếp từ blog Helius, SIMD và mã nguồn Agave/Firedancer. Không cần khóa API.

Cách Skill hoạt động

Skill không phụ thuộc vào mô hình. Mỗi skill đều đi kèm các biến thể system prompt dựng sẵn để hoạt động trên mọi nền tảng, không chỉ Claude.

Sử dụng openai.developer.md cho OpenAI API, claude.system.md cho Claude API hoặc full.md cho Cursor Rules, hướng dẫn tùy chỉnh của ChatGPT hay bất kỳ công cụ nào khác. Xem tổng quan về Skill để biết cách thiết lập theo từng nền tảng.

Skill được cài đặt tự động khi sử dụng Helius Claude Code Plugin. Các skill độc lập có thể được cài đặt dưới dạng Agent Skills—tự động kích hoạt, không cần lệnh slash:

Mã
# Clone our AI tooling repo
git clone https://github.com/helius-labs/core-ai.git

# Navigate to helius-skills
cd core-ai/helius-skills

# Install your desired skill
./helius/install.sh            # Build skill → ~/.claude/skills/helius/
./helius-dflow/install.sh      # DFlow skill → ~/.claude/skills/helius-dflow/
./svm/install.sh               # SVM skill   → ~/.claude/skills/svm/

Với các skill này, agent có thể xây dựng hầu như mọi ứng dụng Solana—từ frontend giao dịch, ứng dụng thị trường dự đoán cho đến bộ xử lý thanh toán stablecoin—và áp dụng đúng mẫu thiết kế ngay từ đầu.

Helius Claude Code Plugin: Gói tích hợp

MCP cung cấp công cụ, còn skill đóng vai trò bộ não. Helius Claude Code Plugin là gói tích hợp—chỉ cần cài đặt một lần để kết nối mọi thành phần. Mọi thứ hoạt động ngay.

Plugin này tích hợp Helius MCP, DFlow MCP, cả bốn skill và các tệp tham chiếu chuyên sâu cho mọi sản phẩm Helius.

Không cần cấu hình MCP thủ công. Không cần thiết lập riêng từng skill.

Chỉ cần cài đặt một lần, agent sẽ có quyền truy cập blockchain có cấu trúc và kiến thức chuyên sâu về Solana trong cùng một phiên.

Cài đặt nhanh

Dưới đây là cách cài đặt Helius Plugin từ marketplace của Claude Code:

Mã
/plugin marketplace add helius-labs/core-ai
/plugin install helius@helius-labs

Chỉ vậy thôi. Plugin tự động khởi động cả hai MCP server và hiện cung cấp bốn lệnh slash:

SkillLệnhChức năng
Build/helius:buildPhát triển Solana cốt lõi với tất cả API Helius
Phantom/helius:phantomXây dựng dApp frontend bằng Phantom Connect SDK và Helius
DFlow/helius:dflowXây dựng ứng dụng giao dịch bằng DFlow và Helius
SVM/helius:svmKiến thức chuyên sâu về giao thức Solana

Quy trình thiết lập khóa API giống như với MCP độc lập: sử dụng khóa hiện có, bật đăng ký tự động hoặc sử dụng Helius CLI. 

Cách hoạt động trong thực tế

Sau khi cài đặt plugin, bạn có thể biến một prompt duy nhất thành một ứng dụng hoạt động hoàn chỉnh. Ví dụ:

“Hãy xây dựng cho tôi một CLI báo cáo thuế để tôi có thể truy xuất hoạt động on-chain của Toly bằng địa chỉ ví 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY. Bắt đầu với tháng trước (tháng 2) và xuất tệp CSV liệt kê tất cả sự kiện chịu thuế của Toly. Hãy xây dựng để công cụ hoạt động với mọi ví và mọi khoảng thời gian.”

Claude hoàn thành chỉ với một prompt:   

Skill /helius:build được kích hoạt và đề xuất chính xác getTransactionsByAddress cùng tính năng phân trang và lọc theo dấu thời gian để trả về lịch sử giao dịch được phân tích đầy đủ dựa trên hoạt động gần đây của Toly.

Không cần chọn công cụ thủ công hay nhập thêm prompt trung gian. Agent đọc đúng tệp tham chiếu, gọi đúng công cụ MCP và tạo ra một CLI hoạt động với mọi ví cùng mọi khoảng ngày.

Tất nhiên, agent có thể xây dựng các ứng dụng phức tạp hơn, chẳng hạn như bot giao dịch:

Trong ví dụ này, chúng tôi cài đặt Helius Claude Code Plugin và yêu cầu Claude xây dựng một bot giao dịch theo dõi token PumpFun theo thời gian thực, truyền phát dữ liệu tạo token và giao dịch qua LaserStream.

Chúng tôi cũng yêu cầu bot hiển thị dữ liệu thị trường và cung cấp biểu đồ cơ bản để có thể thực hiện giao dịch mô phỏng. Chỉ vậy thôi. Claude đã xây dựng bot giao dịch này, hoàn chỉnh với khả năng truyền phát token trực tiếp và giao dịch, trong chưa đầy 10 phút.

Đó là điểm khác biệt giữa việc cung cấp công cụ cho agent và trang bị cho agent kiến thức chuyên môn.

Helius CLI

Helius CLI là một giao diện dòng lệnh đầy đủ tính năng với hơn 95 lệnh CLI, bao quát mọi tác vụ từ quản lý tài khoản, truy vấn Solana, gửi giao dịch, quản lý webhook, truyền phát theo thời gian thực, staking, ZK Compression và nhiều hơn nữa.

Mặc dù chúng tôi khuyến nghị dùng MCP cho các workflow dựa trên AI—lệnh gọi công cụ có cấu trúc hiệu quả hơn việc khởi tạo phiên shell và phân tích đầu ra—CLI vẫn là lựa chọn phù hợp cho script shell, xây dựng pipeline CI/CD hoặc làm việc trong môi trường không hỗ trợ MCP. Mọi lệnh đều hỗ trợ tùy chọn --json để tạo đầu ra máy có thể đọc và trả về mã thoát có cấu trúc, cho phép quy trình tự động xử lý lỗi bằng chương trình.

Cài đặt nhanh

Đối với người dùng mới, quy trình rất đơn giản:

Mã
# Install the CLI
npm install -g helius-cli
helius keygen                    # Generate keypair

# Signup requires a valid email and name
helius signup --email you@example.com --first-name Jane --last-name Doe
# Pay via the printed link with any wallet, then:
helius signup --resume           # Finalize and get API key
helius projects                  # List projects
helius apikeys <project-id>      # Get API keys

Đối với người dùng hiện tại, chỉ cần:

Mã
helius config set-api-key YOUR_API_KEY

SDK được tối ưu cho Agent

Đối với các agent xây dựng ứng dụng bằng mã, chúng tôi đã phát hành tài liệu được tối ưu cho agent dành cho TypeScript SDK và Rust SDK.

Các trang này trình bày những mẫu thiết kế được khuyến nghị cho workflow phổ biến của agent, bao gồm gửi giao dịch qua Sender, xử lý theo lô, dữ liệu theo thời gian thực, phân trang và xử lý lỗi. 

TypeScript SDK

Helius TypeScript SDK cung cấp các phương thức an toàn kiểu dữ liệu cho mọi lệnh gọi API Helius. Điểm quan trọng đối với agent là các phương thức dành riêng cho Helius rút gọn workflow Solana nhiều bước thành một lệnh gọi duy nhất. 

Ví dụ: getTransactionsForAddress thay thế mẫu hai bước tiêu chuẩn đã lỗi thời gồm truy xuất chữ ký rồi truy xuất giao dịch—chỉ cần một lệnh gọi với khả năng lọc phía server, phạm vi thời gian và hỗ trợ tài khoản token: 

Mã
import { createHelius } from "helius-sdk";

const helius = createHelius({ apiKey: "YOUR_API_KEY" });

// Single call: full transaction history with token activity
const txs = await helius.getTransactionsForAddress([
  "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
  {
    transactionDetails: "full",
    limit: 100,
    filters: { tokenAccounts: "balanceChanged" },
  },
]);

Tương tự, sendSmartTransaction tự động xử lý mô phỏng, ước tính compute unit, priority fee và xác nhận.

sendTransactionWithSender nâng khả năng này lên một cấp độ mới, được tối ưu để gửi giao dịch với độ trễ siêu thấp.

Xem các phương pháp tốt nhất cho TypeScript để tìm hiểu về xử lý theo lô, phân trang, dữ liệu theo thời gian thực qua webhook và WebSockets, truy xuất tài khoản tăng dần, xử lý lỗi và những sai sót phổ biến mà agent nên tránh. 

Rust SDK

Helius Rust SDK cung cấp các binding Rust bất đồng bộ với cùng các phương thức Helius, rất phù hợp với workflow agent hiệu năng cao:

Mã
use helius::Helius;
use helius::types::*;

let helius = Helius::new("YOUR_API_KEY", Cluster::MainnetBeta)?;

// Same single-call pattern as TypeScript
let txs = helius.rpc().get_transactions_for_address(
    "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY".to_string(),
    GetTransactionsForAddressOptions {
        transaction_details: Some(TransactionDetails::Full),
        limit: Some(100),
        filters: Some(GetTransactionsFilters {
            token_accounts: Some(TokenAccountsFilter::BalanceChanged),
            ..Default::default()
        }),
        ..Default::default()
    },
).await?;

Rust SDK cũng cung cấp các biến thể lỗi có kiểu dữ liệu (ví dụ: HeliusError::RateLimitExceeded), nhờ đó agent có thể đối sánh trực tiếp theo lỗi thay vì phân tích chuỗi.

Xem các phương pháp tốt nhất cho Rust để tìm hiểu các mẫu tương tự trong Rust (tức là xử lý theo lô, phân trang, Sender, chiến lược thử lại và các sai sót phổ biến). 

Bắt đầu

Helius cung cấp cho agent bộ công cụ toàn diện nhất để xây dựng ứng dụng sẵn sàng cho môi trường production trên Solana. Dưới đây là cách bắt đầu:

Đọc tài liệu, khám phá kho mã GitHub, đề xuất một tích hợp skill và liên hệ đội ngũ hỗ trợ nếu bạn có bất kỳ câu hỏi nào.

Đăng ký nhận tin từ Helius

Luôn cập nhật những thông tin mới nhất về phát triển Solana và nhận thông báo khi chúng tôi đăng bài

Hình ảnh phóng to