old-faithful.net provides archives that have been generated by Triton One as part of the Old Faithful project. You can use this data either by cloning it locally or by partially/fully serving it from old-faithful.net. A simple mode of operation can be to clone the index files locally but source the data from old-faithful.net. A similar mode of operation can be used with Filecoin.
For running a local server, it is usually easiest to have access to the tools folder from the repository. It provides some useful scripts to interface with the archives and indexes hosted on old-faithful.net as well as running the faithful-cli rpc server.
You can use the RPC server with absolutely nothing downloaded locally. A helper script is available from the repository:
$ ./tools/run-rpc-server-remote.sh 0
For ongoing testing, we strongly recommend that you download at least the indexes for best performance. If you have local indexes downloaded you can use the following helper script:
$ ./tools/run-rpc-server-local-indexes.sh 0 ./epoch0
There is a utility script in the
tools folder that will download the indexes hosted on old-faithful.net. The indexes will also be available on Filecoin.
$ mkdir epoch0 $ cd epoch0 $ ../tools/download-indexes.sh 0 ./epoch0 $ ../tools/download-gsfa.sh 0 ./epoch0
If you have a local copy of a CAR archive and the indexes and run a RPC server servicing data from them. For example:
/usr/local/bin/faithful-cli rpc-server-car \ --listen $PORT \ epoch-455.car \ epoch-455.car.*.cid-to-offset.index \ epoch-455.car.*.slot-to-cid.index \ epoch-455.car.*.sig-to-cid.index \ epoch-455.car-*-gsfa-index
You can download the CAR files either via Filecoin or via the bucket provided by Triton. There are helper scripts in the
tools folder. To download the full epoch data:
$ mkdir epoch0 $ cd epoch0 $ ../tools/download-epoch.sh 0 $ ../tools/download-indexes.sh 0 $ ../tools/download-gsfa.sh 0
Once files are downloaded there are also utility scripts to run the server:
$ ./tools/run-rpc-server-local.sh 0 ./epoch0
This will host epoch 0 from the data available in the folder epoch0.