> ## 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.

# 历史数据

> 访问自创世以来的完整 Solana 区块链历史

## 概述

OrbitFlare 运行完整归档节点，保留自 Solana 启动以来的每一个区块、交易和账户状态。标准 RPC 提供商通常会裁剪较旧的数据以节省存储空间，仅保留最近的 epoch。使用 OrbitFlare，您可以查询 Solana 历史中的任何 slot。

## 使用场景

历史区块链数据支持多种重要工作流：

* **事件恢复**：在索引器停机或 webhook 失败后回填缺失的交易
* **合规**：检索用于审计和监管要求的交易记录
* **研究**：分析链上趋势、代币分布和协议指标的历史变化
* **浏览器应用**：构建显示完整历史的区块浏览器和仪表板

## 相关 RPC 方法

这些方法支持在 OrbitFlare 归档节点上的历史查询：

### 区块方法

| 方法                                                            | 描述                      |
| ------------------------------------------------------------- | ----------------------- |
| [getBlock](/rpc/methods/getBlock)                             | 检索任何 slot 的完整区块数据       |
| [getBlocks](/rpc/methods/getBlocks)                           | 获取两个 slot 之间的已确认区块列表    |
| [getBlocksWithLimit](/rpc/methods/getBlocksWithLimit)         | 从某个 slot 开始获取指定数量的已确认区块 |
| [getBlockTime](/rpc/methods/getBlockTime)                     | 获取区块的预估 Unix 时间戳        |
| [getBlockHeight](/rpc/methods/getBlockHeight)                 | 获取当前区块高度                |
| [getFirstAvailableBlock](/rpc/methods/getFirstAvailableBlock) | 获取有区块数据的最低 slot         |

### 交易方法

| 方法                                                              | 描述          |
| --------------------------------------------------------------- | ----------- |
| [getTransaction](/rpc/methods/getTransaction)                   | 按签名检索已确认的交易 |
| [getSignaturesForAddress](/rpc/methods/getSignaturesForAddress) | 获取某地址的交易签名  |
| [getSignatureStatuses](/rpc/methods/getSignatureStatuses)       | 获取交易签名的状态   |

### 账户方法

| 方法                                                      | 描述            |
| ------------------------------------------------------- | ------------- |
| [getAccountInfo](/rpc/methods/getAccountInfo)           | 获取账户数据（仅当前状态） |
| [getMultipleAccounts](/rpc/methods/getMultipleAccounts) | 单次调用获取多个账户的数据 |
| [getProgramAccounts](/rpc/methods/getProgramAccounts)   | 获取程序拥有的所有账户   |

### Slot 方法

| 方法                                                  | 描述               |
| --------------------------------------------------- | ---------------- |
| [getSlot](/rpc/methods/getSlot)                     | 获取当前 slot        |
| [minimumLedgerSlot](/rpc/methods/minimumLedgerSlot) | 获取节点拥有数据的最低 slot |

## 示例

### 从历史中检索区块

使用 [getBlock](/rpc/methods/getBlock) 获取 slot 100,000,000 的区块数据：

```bash theme={null}
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](/rpc/methods/getBlockTime) 查询特定区块的生产时间：

```bash theme={null}
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](/rpc/methods/getBlocks) 获取两个 slot 之间的所有已确认区块：

```bash theme={null}
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](/rpc/methods/getTransaction) 按签名检索交易详情：

```bash theme={null}
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](/rpc/methods/getSignaturesForAddress) 检索地址的签名：

```bash theme={null}
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 示例

### 获取历史区块数据

```typescript theme={null}
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](/rpc/methods/getSignaturesForAddress) 和 [getTransaction](/rpc/methods/getTransaction) 构建完整历史：

```typescript theme={null}
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;
}
```

### 按时间范围查询区块

查找特定时间段内的区块：

```typescript theme={null}
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;
}
```

## 性能提示

1. **批量请求**：使用 JSON-RPC 批量请求在一次调用中获取多个区块或交易

2. **大查询分页**：[getSignaturesForAddress](/rpc/methods/getSignaturesForAddress) 方法每次调用最多返回 1000 个签名——使用 `before` 参数进行分页

3. **谨慎并行化**：以 10-20 个为一批并行获取交易，以平衡速度和速率限制

4. **缓存不可变数据**：历史区块和交易一旦确认就不会改变——在本地缓存它们

5. **使用 `maxSupportedTransactionVersion`**：始终包含此参数以处理版本化交易

## 限制

**账户状态历史**：Solana 节点存储当前账户状态，而非历史快照。您可以检索修改了某账户的交易，但无法获取该账户在特定过去 slot 的余额或数据。

**速率限制**：历史查询可能消耗更多资源。检查您计划的速率限制并实施适当的节流。

## 更快的交易历史

要高效查询地址历史，请使用 [getTransactionsForAddress](/fetching-data/getTransactionsForAddress)，它将签名查找和交易检索合并为单次调用，并提供过滤和排序选项。

## 管理回填

对于需要大规模历史数据交付而无需自行编写 ETL 管道的团队，OrbitFlare 提供**管理回填**服务。

<Note>
  管理回填是一项企业服务。[在 Discord 上联系团队](https://discord.gg/orbitflare)或发送邮件至 [sales@orbitflare.com](mailto:sales@orbitflare.com) 讨论您的需求。
</Note>

### 服务内容

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 流式传输](/data-streaming/yellowstone) 端点。