跳转到主要内容

​
概述

OrbitFlare RPC 节点接受使用 JSON-RPC 2.0 规范的 HTTP 请求。此 API 允许您与 Solana 区块链交互，用于查询数据和提交交易。

​
请求格式

要发起 JSON-RPC 请求，请发送具有以下规格的 HTTP POST 请求：
  • 端点：https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY
  • 请求头：Content-Type: application/json
  • 请求体：包含以下字段的 JSON 对象：
字段类型描述
jsonrpcstring必须为 “2.0”
idstring/number唯一请求标识符
methodstringRPC 方法名称
paramsarray方法参数数组

​
请求示例

curl https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": [
    "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"
  ]
}'

​
响应格式

响应将是包含以下内容的 JSON 对象：
字段类型描述
jsonrpcstring始终为 “2.0”
idstring/number与请求标识符匹配
resultvaries方法的结果数据
errorobject错误详情（如适用）

​
确认级别

许多方法接受 commitment 参数来指定数据的确认程度：
  • processed：最新区块（最快，未确认）
  • confirmed：由超级多数确认（速度和最终性之间的平衡）
  • finalized：由超级多数最终确认（最慢，完全确认）
带确认级别的示例： 
curl https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": [
    "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri",
    {"commitment": "finalized"}
  ]
}'

​
批量请求

您可以通过提供请求对象数组在单次 HTTP 调用中发送多个请求： 
curl https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY -X POST -H "Content-Type: application/json" -d '[
  {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBalance",
    "params": ["83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"]
  },
  {
    "jsonrpc": "2.0",
    "id": 2,
    "method": "getBlockHeight",
    "params": []
  }
]'

​
常见类型

类型描述
PubkeyBase-58 编码的公钥字符串
HashBase-58 编码的 SHA-256 哈希字符串
SignatureBase-58 编码的 Ed25519 签名
Slot整数区块高度/slot 编号

​
健康检查

您可以通过 GET 请求检查节点健康状态： 
curl "https://fra.rpc.orbitflare.com/health?api_key=YOUR_LICENSE_KEY"
可能的响应：
  • ok：节点健康且数据最新
  • behind { slots: number }：节点落后 N 个 slot
  • error：节点不健康

​
可用方法

账户和程序

  • getAccountInfo
  • getMultipleAccounts
  • getProgramAccounts
  • getMinimumBalanceForRentExemption

区块和 Slot

  • getBlock
  • getBlocks
  • getBlockHeight
  • getSlot
  • getSlotLeader

交易

  • getTransaction
  • getSignatureStatuses
  • getSignaturesForAddress
  • sendTransaction
  • simulateTransaction

代币

  • getTokenAccountBalance
  • getTokenAccountsByDelegate
  • getTokenAccountsByOwner
  • getTokenSupply

​
速率限制

速率限制因订阅套餐而异。有关每个套餐的精确 RPS 和 TPS 值，请参阅身份验证与限制页面。

​
最佳实践

  1. 使用适当的确认级别
    • 界面更新使用 processed
    • 大多数操作使用 confirmed
    • 关键操作使用 finalized
  2. 优化请求
    • 尽可能使用批量请求
    • 实施适当的缓存
    • 选择合适的轮询间隔
  3. 处理错误
    • 实施适当的错误处理
    • 使用指数退避进行重试
    • 监控请求失败

​
另请参阅

身份验证与限制

API 密钥设置、端点格式、速率限制和连接限制。

错误代码

HTTP 状态码、JSON-RPC 错误及其处理方式。

WebSocket API

账户、Slot、日志等的实时订阅。

​
支持

如需有关我们 RPC 服务的技术支持或问题咨询：