📘
Old Faithful
  • Introduction
    • Content Identifiers
    • Indexes
  • Usage & Installation
    • Looking up CIDs
    • Retrieving from Filecoin
    • gRPC Methods
    • RPC Methods
    • RPC server
      • Local file system
      • HTTP
      • Filecoin v1 retrievals
      • Filecoin v2 retrievals
    • Accessing OF1 from old-faithful.net
    • Geyser
    • Software integrations
  • Generating
    • Historical blocks
    • Warehouse nodes
    • Creating indexes
  • Hosting
    • Making a local copy
    • Filecoin
  • Validation
    • Reproducibility
    • Epoch 208
Powered by GitBook
On this page
  • Tooling to produce CAR files from Solana snapshots
  • A full, verified genesis archive: OF1
  • An RPC server supporting multiple sources of retrievals
  • Geyser integration & Rust library

Introduction

What's Old Faithful, what are CAR files, how to run Faithful RPC

NextContent Identifiers

Last updated 1 month ago

The Old Faithful project has several parts:

Tooling to produce CAR files from Solana snapshots

The core of the Old Faithful is history archives in Content Addressable aRchives (CAR) format (, ). These represent a verifiable, immutable view of Solana's history. The CAR files that this project generates follow a specifically developed for Solana’s historical archives.

The content's addressable nature means that each epoch, block, transaction, and shredding is uniquely identified by a content hash. By knowing this content hash, a user can retrieve a specific object of interest in a trustless manner, i.e., retrieve an object verifiably from a non-trusted source.

The tooling operates on (end of epoch) snapshots generated using the default solana-ledger-tool that's used by Solana warehouse nodes to record the full epoch into a single archive. No changes to the default Solana tools are required to produce such archives for Old Faithful.

A full, verified genesis archive: OF1

The second component of the Old Faithful project is OF1, a full genesis archive that contains every block from the genesis until the current epoch.

There's a hot copy of the archive hosted by Triton , and the cold copy is published to various Filecoin Storage Providers (SPs).

You can clone and run your own copy of this archive. We strongly recommend doing this if you are an infrastructure provider, indexer, or heavy user.

An RPC server supporting multiple sources of retrievals

Old Faithful has an RPC server that you can run that supports retrievals from an Old Faithful archive (like OF1) via gRPC and the standard Solana JSON-RPC methods for fetching block and transaction data.

Retrievals can be made via IPFS, the Filecoin network, or even by hosting the CAR files yourself on disk, a CEPH cluster, S3 or alternative compatible object storage services, HTTP (CDN), etc.

The only real requirement is that the retrieval source you provide either publishes a standard Unix filesystem API or supports an HTTP API with range requests support.

Geyser integration & Rust library

There is a Geyser integration that provides an easy way to perform ETL with already existing Solana Geyser plugins. You can run this on an epoch CAR file and receive Geyser notifications with blocks and transactions.

overview
specs
schema
Read more about Generating Old Faithful archives.
https://files.old-faithful.net
Read more about hosting your own copy of Old Faithful archives.
Read more about running the RPC server.
Read more about using the Geyser integration.