Practical overview
When it fits
Use it when prototyping or operating a usage-based payment layer for Old Faithful historical Solana queries, particularly transaction and block requests.
Who it is for
- Developers building pay-per-query access to historical Solana data.
- Data consumers who want to query archived Solana blocks or transactions through the included dashboard.
Documented uses
- Gate historical Solana RPC queries behind HTTP 402 payment requirements.
- Charge USDC per query or batch payment across a block range.
- Retrieve Epoch 800 historical block and transaction data through Old Faithful.
- Return transaction-signature receipts alongside query results.
Requirements & limits
The documented primary flow requires a connected Solana wallet and USDC for query payments. The repository is public and specifies an MIT license.
- The documented archive is Epoch 800, with slots 345,600,000–345,855,967.
- The README describes dynamic pricing by RPC method and range-based payment batching; local configuration examples show prices for transaction, block and signature queries.
- Docker setup requires Docker Desktop and the Old Faithful CLI; local development requires Node.js 18+, pnpm and the CLI.
- The documented settlement path uses Solana mainnet and Helius RPC configuration.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up the Docker services locally
Start Old Faithful and bring up the gateway, facilitator and dashboard using the documented Docker setup.
Before you start
- Docker Desktop
- Old Faithful CLI binary at /tmp/faithful-cli
- The old-faithful-epoch-800.yml archive configuration
Steps
Start Old Faithful with
/tmp/faithful-cli rpc --listen :8899 old-faithful-epoch-800.yml.From the project directory, run
docker-compose up --build.Use the dashboard at
http://localhost:3001; the README also lists the client demo at/client, gateway at port 4021 and facilitator at port 3000.
Expected outcome
The documented local services are brought up, with dashboard, client demo, gateway and facilitator addresses provided.
Guide limitations
- The setup depends on the Old Faithful CLI and Epoch 800 configuration.
- This recipe covers local setup; it does not establish that the services were executed or verified.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 15 October 2026
- Original website title
- praptisharma28/x402-Triton-Gateway · Official homepage title · retained in its source language

