Kora

Kora là cơ sở hạ tầng ký Solana của bạn. Cho phép giao dịch không phí gas để người dùng thanh toán phí bằng bất kỳ token nào—USDC, BONK, hoặc token gốc của ứng dụng bạn—hoặc xử lý bất kỳ việc ký giao dịch nào yêu cầu người ký đáng tin cậy.

Tại sao chọn Kora?

• Trải nghiệm người dùng tốt hơn: Người dùng không bao giờ cần SOL
• Kiểm soát doanh thu: Thu phí bằng USDC, token của bạn hoặc bất cứ thứ gì khác
• Sẵn sàng sản xuất: Xác thực an toàn, giới hạn tốc độ, giám sát tích hợp sẵn
• Tích hợp dễ dàng: API JSON-RPC + SDK TypeScript
• Triển khai linh hoạt: Railway, Docker hoặc bất kỳ nền tảng đám mây nào

Kiến trúc

• Ngôn ngữ: Rust với SDK TypeScript
• Giao thức: JSON-RPC 2.0
• Người ký: Khóa riêng Solana, Turnkey, Privy
• Xác thực: Khóa API, HMAC hoặc không có
• Triển khai: Tùy chọn triển khai linh hoạt (Docker, Railway, v.v.)

Tính năng

• Quy tắc xác thực và danh sách cho phép có thể cấu hình
• Hỗ trợ đầy đủ Token-2022 với lọc phần mở rộng
• Bộ nhớ đệm Redis để cải thiện hiệu suất
• Giới hạn tốc độ và bảo vệ chi tiêu
• Quản lý khóa an toàn (Turnkey, Privy, Vault)
• Xác thực HMAC và khóa API
• Số liệu và giám sát Prometheus
• Chính sách bảo vệ người trả phí nâng cao

Bắt đầu nhanh

Cài đặt Kora:

cargo install kora-cli

Sử dụng cơ bản:

kora rpc [OPTIONS] # --help for full list of options

→ Hướng dẫn Bắt đầu nhanh - Chạy Kora cục bộ trong vài phút

→ Hướng dẫn Vận hành Node - Chạy paymaster

SDK TypeScript

Kora cung cấp giao diện JSON-RPC đơn giản với ba tùy chọn client:

// Option 1: Standalone client
import { KoraClient } from "@solana/kora";
const kora = new KoraClient({ rpcUrl: "http://localhost:8080" });
const signed = await kora.signTransaction({ transaction });

// Option 2: Kit client (recommended) — handles planning, fees, signing, and sending
import { createKitKoraClient } from "@solana/kora";
import { address } from "@solana/kit";
const client = await createKitKoraClient({
  endpoint: "http://localhost:8080",
  rpcUrl: "https://api.mainnet-beta.solana.com",
  feeToken: address("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"),
  feePayerWallet: userSigner
});

→ Tài liệu tham khảo API - Các phương thức JSON-RPC và SDK TypeScript

Phát triển cục bộ

Yêu cầu

• Rust 1.86+ hoặc
• Solana CLI 2.2+
• Node.js 20+ và pnpm (cho SDK)

Cài đặt

git clone https://github.com/solana-foundation/kora.git
cd kora
git checkout v2.0.5
just install

Xây dựng

just build

Chạy Máy chủ

Cách sử dụng cơ bản:

kora rpc [OPTIONS]

Hoặc để chạy với cấu hình thử nghiệm, hãy chạy:

just run

Kiểm thử Cục bộ

Và chạy tất cả các bài kiểm thử:

just test-all

Cộng đồng & Hỗ trợ

• Có thắc mắc? Hỏi trên Solana Stack Exchange (sử dụng thẻ kora)
• Gặp vấn đề? Báo cáo trên GitHub Issues

Tài nguyên Khác

• Kora CLI Crates.io - Crate Rust để chạy node Kora
• @solana/kora NPM Package - SDK TypeScript để tương tác với node Kora

Nguồn

• GitHub Repository

Được xây dựng và duy trì bởi Solana Foundation.

Cấp phép theo MIT. Xem LICENSE để biết chi tiết.