Kora 运营商文档

什么是 Kora 节点运营商？

作为 Kora 节点运营商，您运行一个支付主服务，为用户赞助 Solana 交易费用。您的节点接受 SPL 代币支付，并使用您的 SOL 支付实际网络费用，从而为您的应用程序实现无 Gas 交易。

为什么要运行 Kora 节点？

更好的用户体验：您的用户无需持有 SOL 即可进行交易（简化入门流程、提高留存率等）
收入来源：以您企业偏好的代币（USDC、BONK 等）收取费用

快速入门

想先在本地试用吗？几分钟内启动本地 Kora 节点： → 本地快速入门指南

核心概念

作为 Kora 节点运营商，您负责运行一个安全的支付主服务，为用户实现无 Gas 交易。您的节点有四项关键职责：

1. 验证交易

通过 kora.toml 配置您的节点，使其仅接受符合您业务要求的交易：

代币白名单：定义您接受作为支付的 SPL 代币（支持 SPL 和 Token-2022）
程序白名单：将用户可以交互的 Solana 程序加入白名单
交易限制：设置您愿意支付的最高费用和签名限制
账户黑名单：防止与问题地址的交互
定价预言机：配置 Jupiter 或模拟定价以进行费用计算
支付代币：指定您将接受的代币类型作为支付
费用支付方策略：控制您的费用支付方可以执行的操作（转账、销毁、批准等）
Token-2022 扩展：阻止特定的 Token-2022 扩展以增强安全性
缓存：启用 Redis 缓存以通过减少 RPC 调用来提高性能
使用限制：设置每个钱包的交易限制以防止滥用、确保公平使用，或在一定限额内为用户提供补贴交易奖励

→ 完整的 Kora.toml 配置参考 → Kora.toml 示例

2. 签署交易

您的节点需要 Solana keypair 来作为费用支付方签署交易。对于生产环境部署，Kora 支持多签名者配置，以提高可靠性和账户锁定分布。建议实施密钥轮换、访问控制、备份以及其他签名者安全策略。可用的签名选项：

本地私钥：将私钥直接存储在服务器环境中（支持 base58、.json 文件或 u8 数组格式）
Turnkey：简化私钥管理。创建钱包、签署交易并自动化链上操作。
Privy：轻松的加密基础设施。安全地创建白标钱包并签署交易。
HashiCorp Vault：管理机密信息与保护敏感数据

→ 完整的签名者配置指南

3. 支付交易费用

维持足够的 SOL 余额以支付预期交易量的网络费用：

余额监控：跟踪 SOL 余额并设置低余额警报（Kora 提供内置的 Prometheus 指标 - 请参阅监控）
自动化：为生产环境实施自动 SOL 充值流程
容量规划：根据预期用例、用户量等进行规划

了解 Kora 如何估算费用以及如何配置节点以最大化收益至关重要。详情请参阅费用估算指南。

4. 监控运营

持续跟踪节点的安全性、性能和业务指标：

安全监控：异常模式、验证失败和速率限制违规
运营警报：系统健康状况、余额警告和安全事件
财务跟踪：SOL 成本与代币收益对比、盈利能力分析
签名者余额监控：跟踪签名者余额并设置低余额警报

Kora 提供了一个可选的 /metrics 端点,以 Prometheus 格式提供实时性能数据。

→ Kora 监控参考指南

5. 优化性能(可选)

对于高流量部署,启用 Redis 缓存可减少 RPC 调用并提高响应时间:

账户缓存:使用可配置的生存时间(TTL)缓存 Solana 账户数据
自动回退:如果 Redis 不可用,会优雅地回退到直接 RPC 调用
缓存管理:针对关键操作的自动过期和强制刷新功能

Kora CLI

kora-cli crate 是一个生产就绪的 Rust 二进制文件,提供运行 Kora 支付方节点所需的一切功能。它作为独立可执行文件分发,您可以全局安装或在容器中部署。

安装选项

全局安装(推荐用于开发)

cargo install kora-cli

或从源代码构建(推荐用于贡献)

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

基本用法

Kora RPC 服务器公开了一个 JSON-RPC 端点(默认:http://localhost:8080)。使用 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

有关使用 Kora CLI 的更多信息,请参阅 CLI 指南。

应用程序可以通过 Kora TS SDK 访问 Kora RPC 服务器

配置

每个 Kora RPC 节点至少必须配置:

一个 Solana RPC 端点(通过 --rpc-url 标志或 RPC_URL 环境变量指定)[默认:http://127.0.0.1:8899]
Solana 签名者配置(通过 --signers-config signers.toml 标志指定)
一个配置文件 kora.toml(通过 --config path/to/kora.toml 标志指定)

kora.toml

在部署之前,您需要创建并配置一个 kora.toml 来指定:

速率限制和身份验证
支付目标地址
RPC 方法可用性
交易验证规则
安全策略(SPL 代币、程序、账户、Token Extensions 等的白名单或黑名单)
费用定价模型
增强的费用支付方策略(防止不需要的签名者行为)
指标收集
Redis 缓存配置(可选)

signers.toml

您还需要创建一个 signers.toml 文件来指定：

节点的签名者
签名者选择策略
每个签名者的配置和适用密钥

Railway 部署

更多集成指南即将推出

需要帮助？

Solana Stack Exchange - 提问/分享学习心得（请务必使用 kora 标签）
GitHub Issues - 报告错误或获取帮助
运行 kora rpc --help 查看所有可用的标志和配置选项