Tài Liệu Vận Hành Kora

Vận Hành Node Kora Là Gì?

Với vai trò vận hành node Kora, bạn chạy một dịch vụ paymaster giúp tài trợ phí giao dịch Solana cho người dùng của mình. Node của bạn chấp nhận thanh toán bằng token SPL và sử dụng SOL của bạn để thanh toán phí mạng thực tế, cho phép thực hiện giao dịch không tốn gas cho ứng dụng của bạn.

Tại Sao Nên Chạy Node Kora?

Trải Nghiệm Người Dùng Tốt Hơn: Người dùng của bạn giao dịch mà không cần SOL (đơn giản hóa quá trình tham gia, tăng tỷ lệ giữ chân, v.v.)
Nguồn Thu Nhập: Thu phí bằng các token mà doanh nghiệp bạn ưa thích (USDC, BONK, v.v.)

Bắt Đầu Nhanh

Muốn thử nghiệm local trước? Khởi động node Kora local chỉ trong vài phút: → Hướng Dẫn Bắt Đầu Nhanh Local

Khái Niệm Cốt Lõi

Với vai trò vận hành node Kora, bạn chịu trách nhiệm chạy một dịch vụ paymaster an toàn cho phép giao dịch không tốn gas cho người dùng của mình. Node của bạn có bốn trách nhiệm chính:

1. Xác Thực Giao Dịch

Cấu hình node của bạn để chỉ chấp nhận các giao dịch đáp ứng yêu cầu kinh doanh của bạn thông qua kora.toml:

Danh sách token cho phép: Xác định các token SPL nào bạn chấp nhận làm phương thức thanh toán (hỗ trợ cả SPL và Token-2022)
Danh sách program cho phép: Đưa vào danh sách trắng các program Solana mà người dùng có thể tương tác
Giới hạn giao dịch: Đặt mức phí tối đa bạn sẵn sàng thanh toán và giới hạn chữ ký
Danh sách tài khoản bị chặn: Ngăn chặn tương tác với các địa chỉ có vấn đề
Oracle định giá: Cấu hình Jupiter hoặc định giá giả lập để tính phí
Token thanh toán: Chỉ định loại token bạn sẽ chấp nhận làm phương thức thanh toán
Chính sách feepayer: Kiểm soát các thao tác mà feepayer của bạn có thể thực hiện (chuyển khoản, đốt, phê duyệt, v.v.)
Tiện ích mở rộng Token-2022: Chặn các tiện ích mở rộng Token-2022 cụ thể để tăng cường bảo mật
Bộ nhớ đệm: Bật bộ nhớ đệm Redis để cải thiện hiệu suất bằng cách giảm các lệnh gọi RPC
Giới hạn sử dụng: Đặt giới hạn giao dịch cho mỗi ví để ngăn chặn lạm dụng, đảm bảo sử dụng công bằng hoặc thưởng cho người dùng với các giao dịch được trợ cấp đến một giới hạn nhất định

→ Tài liệu Tham khảo Cấu hình Kora.toml Đầy đủ → Mẫu kora.toml

2. Ký Giao dịch

Node của bạn cần các keypair Solana để ký giao dịch với tư cách là người trả phí. Đối với các triển khai sản xuất, Kora hỗ trợ cấu hình đa người ký để cải thiện độ tin cậy và phân phối khóa tài khoản. Hãy xem xét việc triển khai luân chuyển khóa, kiểm soát truy cập, sao lưu và các chiến lược khác cho bảo mật người ký. Các tùy chọn ký có sẵn:

Khóa Riêng Cục bộ: Lưu trữ khóa riêng trực tiếp trong môi trường máy chủ (dưới dạng base58, tệp .json hoặc mảng u8)
Turnkey: Quản lý khóa riêng được đơn giản hóa. Tạo ví, ký giao dịch và tự động hóa các hành động onchain.
Privy: Cơ sở hạ tầng crypto dễ dàng. Tạo ví whitelabel an toàn và ký giao dịch.
HashiCorp Vault: Quản lý Bí mật & Bảo vệ Dữ liệu Nhạy cảm

→ Hướng dẫn Cấu hình Người ký Đầy đủ

3. Thanh toán Phí Giao dịch

Duy trì đủ SOL để chi trả phí mạng cho khối lượng giao dịch dự kiến của bạn:

Giám sát số dư: Theo dõi số dư SOL và thiết lập cảnh báo số dư thấp (Kora cung cấp các số liệu Prometheus tích hợp sẵn - xem Giám sát)
Tự động hóa: Triển khai quy trình nạp SOL tự động cho các môi trường sản xuất
Lập kế hoạch công suất: Lên kế hoạch cho trường hợp sử dụng dự kiến, khối lượng người dùng, v.v.

Điều quan trọng là bạn phải hiểu cách Kora ước tính phí và cách cấu hình node của bạn để tối đa hóa doanh thu. Xem Hướng dẫn Ước tính Phí để biết thêm chi tiết.

4. Giám sát Hoạt động

Liên tục theo dõi các chỉ số về bảo mật, hiệu suất và kinh doanh của node:

Giám sát bảo mật: Các mẫu bất thường, xác thực thất bại và vi phạm giới hạn tốc độ
Cảnh báo vận hành: Tình trạng hệ thống, cảnh báo số dư và sự kiện bảo mật
Theo dõi tài chính: Chi phí SOL so với doanh thu token, phân tích khả năng sinh lời
Giám sát số dư người ký: Theo dõi số dư người ký và thiết lập cảnh báo số dư thấp

Kora cung cấp một endpoint /metrics tùy chọn để cung cấp dữ liệu performance theo thời gian thực ở định dạng Prometheus.

→ Hướng Dẫn Tham Khảo Giám Sát Kora

5. Tối Ưu Hóa Hiệu Suất (Tùy Chọn)

Đối với các triển khai có lưu lượng truy cập cao, hãy bật caching Redis để giảm các lần gọi RPC và cải thiện thời gian phản hồi:

Account caching: Lưu cache dữ liệu account Solana với thời gian tồn tại (TTL) có thể cấu hình
Dự phòng tự động: Tự động chuyển sang các lần gọi RPC trực tiếp nếu Redis không khả dụng
Quản lý cache: Khả năng hết hạn tự động và làm mới bắt buộc cho các thao tác quan trọng

Kora CLI

Crate kora-cli là một binary Rust sẵn sàng cho môi trường production, cung cấp mọi thứ bạn cần để chạy một node paymaster Kora. Nó được phân phối dưới dạng tệp thực thi độc lập mà bạn có thể cài đặt toàn cục hoặc triển khai trong các container.

Tùy Chọn Cài Đặt

Cài Đặt Toàn Cục (khuyến nghị cho phát triển)

cargo install kora-cli

Hoặc build từ mã nguồn (khuyến nghị cho việc đóng góp)

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

Cách Sử Dụng Cơ Bản

Máy chủ Kora RPC expose một endpoint JSON-RPC (mặc định: http://localhost:8080). Khởi chạy nó bằng lệnh kora rpc:

# Run with specified kora.toml and signers.toml
kora --config path/to/kora.toml rpc start --signers-config path/to/signers.toml

# Help
kora rpc --help

Để biết thêm thông tin về cách sử dụng Kora CLI, xem Hướng Dẫn CLI.

Các ứng dụng có thể truy cập Máy Chủ Kora RPC thông qua Kora TS SDK

Cấu Hình

Mọi node Kora RPC đều phải được cấu hình với ít nhất:

một endpoint Solana RPC (được chỉ định qua cờ --rpc-url hoặc biến môi trường RPC_URL) [mặc định: http://127.0.0.1:8899]
cấu hình (các) signer Solana (được chỉ định qua cờ --signers-config signers.toml)
một tệp cấu hình, kora.toml (được chỉ định qua cờ --config path/to/kora.toml)

kora.toml

Trước khi triển khai, bạn cần tạo và cấu hình một kora.toml để chỉ định:

Giới hạn tốc độ và xác thực
Địa chỉ đích thanh toán
Tính khả dụng của phương thức RPC
Quy tắc xác thực giao dịch
Chính sách bảo mật (danh sách trắng hoặc danh sách đen của các SPL token, program, account, token extension, v.v.)
Mô hình định giá phí
Chính sách fee payer nâng cao (bảo vệ chống lại hành vi signer không mong muốn)
Thu thập số liệu
Cấu hình caching Redis (tùy chọn)

signers.toml

Bạn cũng cần tạo một tệp signers.toml để chỉ định:

(Các) người ký cho node của bạn
Chiến lược lựa chọn người ký
Cấu hình và các khóa áp dụng cho từng người ký

Triển khai trên Railway

Thêm nhiều hướng dẫn tích hợp sắp ra mắt

Cần Trợ giúp?

Solana Stack Exchange - Đặt câu hỏi/chia sẻ kiến thức (đảm bảo sử dụng thẻ kora)
GitHub Issues - Báo cáo lỗi hoặc nhận trợ giúp
Chạy kora rpc --help để xem tất cả các cờ và tùy chọn cấu hình có sẵn