Documentation Index
Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt
Use this file to discover all available pages before exploring further.
OrbitFlare 运行完整归档节点，保留自 Solana 启动以来的每一个区块、交易和账户状态。标准 RPC 提供商通常会裁剪较旧的数据以节省存储空间，仅保留最近的 epoch。使用 OrbitFlare，您可以查询 Solana 历史中的任何 slot。
使用场景
历史区块链数据支持多种重要工作流：
- 事件恢复：在索引器停机或 webhook 失败后回填缺失的交易
- 合规：检索用于审计和监管要求的交易记录
- 研究：分析链上趋势、代币分布和协议指标的历史变化
- 浏览器应用：构建显示完整历史的区块浏览器和仪表板
相关 RPC 方法
这些方法支持在 OrbitFlare 归档节点上的历史查询：
区块方法
| 方法 | 描述 |
|---|
| getBlock | 检索任何 slot 的完整区块数据 |
| getBlocks | 获取两个 slot 之间的已确认区块列表 |
| getBlocksWithLimit | 从某个 slot 开始获取指定数量的已确认区块 |
| getBlockTime | 获取区块的预估 Unix 时间戳 |
| getBlockHeight | 获取当前区块高度 |
| getFirstAvailableBlock | 获取有区块数据的最低 slot |
交易方法
账户方法
Slot 方法
| 方法 | 描述 |
|---|
| getSlot | 获取当前 slot |
| minimumLedgerSlot | 获取节点拥有数据的最低 slot |
从历史中检索区块
使用 getBlock 获取 slot 100,000,000 的区块数据：
curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
"jsonrpc": "2.0",
"id": 1,
"method": "getBlock",
"params": [
100000000,
{
"encoding": "json",
"transactionDetails": "full",
"rewards": false,
"maxSupportedTransactionVersion": 0
}
]
}'
获取区块时间戳
使用 getBlockTime 查询特定区块的生产时间：
curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
"jsonrpc": "2.0",
"id": 1,
"method": "getBlockTime",
"params": [100000000]
}'
列出范围内的区块
使用 getBlocks 获取两个 slot 之间的所有已确认区块：
curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
"jsonrpc": "2.0",
"id": 1,
"method": "getBlocks",
"params": [100000000, 100000100]
}'
获取交易
使用 getTransaction 按签名检索交易详情：
curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
"jsonrpc": "2.0",
"id": 1,
"method": "getTransaction",
"params": [
"5wHu1qwD7q5menP8rgbzknAHruqg7rq1BwLNjmKnMwVH2VNhVvPLT6jGfKNLwKUTG4Xn2vRvDz5Q6Z8zCLN5gLp1",
{
"encoding": "json",
"maxSupportedTransactionVersion": 0
}
]
}'
获取地址的交易历史
使用 getSignaturesForAddress 检索地址的签名：
curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
"jsonrpc": "2.0",
"id": 1,
"method": "getSignaturesForAddress",
"params": [
"Vote111111111111111111111111111111111111111",
{"limit": 100}
]
}'
TypeScript 示例
获取历史区块数据
import { Connection } from '@solana/web3.js';
const connection = new Connection('https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY');
async function getHistoricalBlock(slot: number) {
const block = await connection.getBlock(slot, {
maxSupportedTransactionVersion: 0,
});
if (block) {
console.log(`Block ${slot}:`);
console.log(` Transactions: ${block.transactions.length}`);
console.log(` Block time: ${block.blockTime}`);
console.log(` Parent slot: ${block.parentSlot}`);
}
return block;
}
// Fetch a block from early 2023
const block = await getHistoricalBlock(175000000);
构建完整交易历史
结合 getSignaturesForAddress 和 getTransaction 构建完整历史：
import { Connection, PublicKey } from '@solana/web3.js';
const connection = new Connection('https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY');
async function getFullTransactionHistory(address: string) {
const pubkey = new PublicKey(address);
const allTransactions = [];
let before: string | undefined;
// Paginate through all signatures
while (true) {
const signatures = await connection.getSignaturesForAddress(pubkey, {
limit: 1000,
before,
});
if (signatures.length === 0) break;
// Fetch full transaction data in batches
for (let i = 0; i < signatures.length; i += 10) {
const batch = signatures.slice(i, i + 10);
const txs = await Promise.all(
batch.map(sig =>
connection.getTransaction(sig.signature, {
maxSupportedTransactionVersion: 0,
})
)
);
allTransactions.push(...txs.filter(tx => tx !== null));
}
before = signatures[signatures.length - 1].signature;
}
return allTransactions;
}
按时间范围查询区块
查找特定时间段内的区块：
async function getBlocksInTimeRange(startTime: number, endTime: number) {
// Get a starting slot estimate
const currentSlot = await connection.getSlot();
const currentTime = Math.floor(Date.now() / 1000);
// Solana produces ~2-3 blocks per second
const slotsPerSecond = 2.5;
const estimatedStartSlot = currentSlot - Math.floor((currentTime - startTime) * slotsPerSecond);
const blocks = [];
let slot = estimatedStartSlot;
while (true) {
const blockTime = await connection.getBlockTime(slot);
if (blockTime && blockTime >= startTime && blockTime <= endTime) {
const block = await connection.getBlock(slot, {
maxSupportedTransactionVersion: 0,
});
if (block) blocks.push({ slot, block });
}
if (blockTime && blockTime > endTime) break;
slot++;
}
return blocks;
}
性能提示
-
批量请求：使用 JSON-RPC 批量请求在一次调用中获取多个区块或交易
-
大查询分页：getSignaturesForAddress 方法每次调用最多返回 1000 个签名——使用
before 参数进行分页
-
谨慎并行化：以 10-20 个为一批并行获取交易，以平衡速度和速率限制
-
缓存不可变数据：历史区块和交易一旦确认就不会改变——在本地缓存它们
-
使用
maxSupportedTransactionVersion：始终包含此参数以处理版本化交易
账户状态历史：Solana 节点存储当前账户状态，而非历史快照。您可以检索修改了某账户的交易，但无法获取该账户在特定过去 slot 的余额或数据。
速率限制：历史查询可能消耗更多资源。检查您计划的速率限制并实施适当的节流。
更快的交易历史
要高效查询地址历史，请使用 getTransactionsForAddress，它将签名查找和交易检索合并为单次调用，并提供过滤和排序选项。
管理回填
对于需要大规模历史数据交付而无需自行编写 ETL 管道的团队，OrbitFlare 提供管理回填服务。
服务内容
OrbitFlare 工程师将结构化的 Solana 历史数据直接提取并交付到您的存储系统：
| 输出格式 | 支持的目标存储 |
|---|
| JSON（换行分隔） | AWS S3、Google Cloud Storage |
| Parquet | AWS S3、Google Cloud Storage |
| SQL | PostgreSQL、ClickHouse |
可交付内容
- 特定程序、钱包或代币铸造地址的所有交易
- 任意 slot 范围的完整区块数据
- 代币转账历史（SPL Token / Token-2022）
- 基于您需求的自定义查询和数据结构
服务级别协议
| 项目 | 详情 |
|---|
| 交付时间 | 标准回填 3–5 个工作日 |
| 数据覆盖范围 | 创世块（2020 年 3 月）至今 |
| 格式 | JSON、Parquet 或 SQL——由您选择 |
| 专属支持 | 任务期间分配专属工程师 |
适用场景
管理回填最适合以下情况：
- 初始化新的索引器或分析数据库
- 一次性合规或审计数据请求
- 历史机器学习/AI 训练数据集
- 长时间停机后的数据回填
如需持续流式传输新数据，请改用 gRPC 流式传输 端点。