Export Blockchain State

Introduction

IRIShub can export the blockchain state and output to a json-format string which can be used as the genesis file of a new blockchain.

By default, IRIShub stores snapshots of every 10,000 blocks and the last 100 blocks. You can export the blockchain state from any existing snapshot height.

If you want to export the state from a nonexisting snapshot height, you need to reset the blockchain state to the specified height first.

Usage

iris export [flags]

Flags

Name, shorthandtypeRequiredDefaultDescription
--for-zero-heightboolfalseDo some clean up work before exporting state. If you want to use the exported state to start a new blockchain, please add this flag. Otherwise, just leave out it
--heightuint0Export state from a particular height, default value is 0 which means to export the latest state
--homestring$HOME/.irisSpecify the directory which stores node config and blockchain data
--output-filestringgenesis.jsonTarget file to save exported state

Examples

Export the current blockchain state

iris export --home=<path-to-your-home>

Export blockchain state from a particular height, the height must be an existing snapshot height

iris export --height 10000 --home=<path-to-your-home>

If you want to export the blockchain state from a particular height and use the exported state as genesis state of another blockchain

iris export --height 10000 --for-zero-height --home=<path-to-your-home>