Skip to main content

Hiro Archive

What is the Hiro Archive

The purpose of the Hiro Archive is to enable developers and users of the Hiro ecosystem to download and use any of the published datasets needed to run a Stacks environment. This is a public service Hiro offers as a benefit to the Stacks community.

How to download

Important note: the hirosystems-archive bucket has been deprecated and should no longer be used.

Hiro pushes out new datasets nightly. All available artifacts can be found here:

How to use

The artifacts hosted can be used to quickly spin up a new stacks-blockchain node or comprehensive stacks-blockchain-api deployment.

Importing the stacks-blockchain chainstate

The location of the chainstate is configurable by modifying the working_dir parameter under the [node] section of the Config.toml file.

Un-tar the file after downloading:

# mainnet
curl -O mainnet-stacks-blockchain-latest.tar.gz
tar -zxvf mainnet-stacks-blockchain-latest.tar.gz

# testnet
curl -O testnet-stacks-blockchain-latest.tar.gz
tar -zxvf testnet-stacks-blockchain-latest.tar.gz

Importing the stacks-blockchain-api Postgresql database

A working Postgresql database is required.

curl -O stacks-blockchain-api-pg-14-latest.dump
runuser -l postgres -c 'pg_restore -v -C -d stacks-blockchain-api-pg-14-latest.dump'

runuser -l postgres -c "psql -c \"alter user postgres with password {{ your awesome password }};\""

Replay stacks-blockchain-api events

If you need to replay stacks-blockchain events in the API after importing the Postgresql data, you can generate a tab-separated values (TSV) file via the export/import process documented here.