Tích hợp Kit Client

Cập nhật lần cuối: 2026-03-09

Những gì bạn sẽ xây dựng

Kit client (createKitKoraClient) là cách được khuyến nghị để tích hợp Kora vào các ứng dụng Solana. Nó bao bọc tính năng trừu tượng hóa phí của Kora vào kiến trúc plugin của Kit, cung cấp cho bạn một client tự động xử lý:

• Quản lý blockhash
• Ước tính phí và chèn lệnh thanh toán phí
• Ký giao dịch thông qua Kora
• Gửi và xác nhận giao dịch
• Tối ưu hóa compute budget (ước tính CU dựa trên mô phỏng)

Điều này có nghĩa là bạn có thể sử dụng các plugin chương trình Kit như tokenProgram() và để Kora xử lý toàn bộ độ phức tạp của phí gas ở hậu trường.

Yêu cầu tiên quyết

• Đã hoàn thành Hướng dẫn bắt đầu nhanh Kora — chạy máy chủ Kora và validator cục bộ
• Quen thuộc với Solana Kit và hệ thống plugin của nó

Cài đặt

pnpm add @solana/kora @solana/kit

Các thư viện ngang hàng (@solana-program/token, @solana-program/compute-budget, @solana/kit-plugin-*) được tự động cài đặt bởi hầu hết các trình quản lý gói. Xem Cài đặt nếu bạn cần cài đặt thủ công.

Tạo Client

createKitKoraClient kết hợp nhiều plugin Kit thành một client duy nhất đáp ứng ClientWithPayer, ClientWithTransactionPlanning, và ClientWithTransactionSending.

import { createKitKoraClient } from "@solana/kora";
import { address } from "@solana/kit";

const client = await createKitKoraClient({
  endpoint: "http://localhost:8080", // Kora RPC endpoint
  rpcUrl: "http://127.0.0.1:8899", // Solana RPC for CU estimation
  feeToken: address("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"), // USDC mint
  feePayerWallet: userSigner // TransactionSigner for fee payment
});

feePayerWallet phải là TransactionSigner — đây là ví ủy quyền thanh toán phí token SPL cho nhà điều hành Kora. Nhà điều hành Kora xử lý các khoản phí mạng SOL.

Các tùy chọn cấu hình

Sử dụng với Kit Program Plugins

Kit client có thể kết hợp với các Kit program plugins. Ví dụ, với tokenProgram():

import { createKitKoraClient } from "@solana/kora";
import { tokenProgram } from "@solana-program/token";
import { address } from "@solana/kit";

const koraClient = await createKitKoraClient({
  endpoint: "http://localhost:8080",
  rpcUrl: "http://127.0.0.1:8899",
  feeToken: address("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"),
  feePayerWallet: userSigner
});

// Compose with the token program plugin
const client = koraClient.use(tokenProgram());

// Use token program methods — Kora handles all fee abstraction
await client.token.instructions
  .transferToATA({
    source: userTokenAccount,
    destination: recipientAddress,
    amount: 1_000_000n, // 1 USDC
    authority: userSigner
  })
  .sendTransaction();

Bên dưới, Kit client thực hiện:

1. Lên kế hoạch giao dịch với blockhash do Kora quản lý và các lệnh ngân sách tính toán
2. Ước tính phí và chèn (hoặc cập nhật) lệnh thanh toán SPL cho nhà vận hành Kora
3. Ký một phần giao dịch bằng ví của người dùng
4. Gửi giao dịch đến Kora để đồng ký và gửi lên Solana

Truy cập các phương thức Kora RPC

Kit client cũng cung cấp toàn bộ API Kora thông qua namespace .kora (từ koraPlugin):

// Get server configuration
const config = await client.kora.getConfig();

// Get supported fee tokens
const { tokens } = await client.kora.getSupportedTokens();

// Estimate fees for an arbitrary transaction
const estimate = await client.kora.estimateTransactionFee({
  transaction: base64EncodedTx,
  fee_token: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
});

Tất cả các phản hồi từ phương thức .kora đều sử dụng các giá trị được định kiểu theo Kit (Address, Blockhash, Signature) thay vì chuỗi thô.

Hỗ trợ Token-2022

Để thanh toán phí bằng token Token-2022, truyền tùy chọn tokenProgramId:

import { TOKEN_2022_PROGRAM_ADDRESS } from "@solana-program/token-2022";

const client = await createKitKoraClient({
  endpoint: "http://localhost:8080",
  rpcUrl: "http://127.0.0.1:8899",
  feeToken: address("your-token-2022-mint"),
  feePayerWallet: userSigner,
  tokenProgramId: TOKEN_2022_PROGRAM_ADDRESS
});

Ngân sách tính toán

Theo mặc định, Kit client mô phỏng giao dịch với Solana RPC để xác định giới hạn đơn vị tính toán tối ưu. Điều này dẫn đến phân bổ CU chặt chẽ hơn và phí thấp hơn.

Để ghi đè bằng giá trị cố định:

const client = await createKitKoraClient({
  // ...
  computeUnitLimit: 200_000,
  computeUnitPrice: 1_000_000n // priority fee in micro-lamports
});

Khi nào nên sử dụng từng Client

Các bước tiếp theo

• Luồng giao dịch đầy đủ — Hướng dẫn chi tiết ở mức thấp hơn sử dụng trực tiếp KoraClient
• Tài liệu tham khảo API — Tất cả các phương thức RPC có sẵn
• Cấu hình Kora — Các tùy chọn cấu hình phía máy chủ