nodeos State History

nodeos Configuration

Caution: either use a firewall to block access to the state-history endpoint, or leave it as 127.0.0.1:8080 to disable remote access.

Fast start without history on existing chains

This option creates a database which tracks the chain state, but lacks most historical information.

• Get the following:
  • A portable snapshot (data/snapshots/snapshot-xxxxxxx.bin)
  • Optional: a block log which includes the block the snapshot was taken at
• Make sure data/state does not exist
• Start nodeos with the --snapshot option, and the options listed in "Nodeos configuration" above
• Start a filler with --fpg-create (if PostgreSQL) and --fill-trim.

Whenever you run a filler after this point, use the --fill-trim option. Only use --fpg-create the first time.

Creating a portable snapshot with full state-history

• Enable the producer_api_plugin on a node with full state-history. Caution when using producer_api_plugin: either use a firewall to block access to http-server-address, or change it to 127.0.0.1:8888 to disable remote access.
• Create a portable snapshot: curl http://127.0.0.1:8888/v1/producer/create_snapshot | json_pp
• Wait for nodeos to process several blocks after the snapshot completed. The goal is for the state-history files to contain at least 1 more block than the portable snapshot has, and for the block log to contain the block after it has become irreversible.
• Stop nodeos
• Make backups of:
  • The newly-created portable snapshot (data/snapshots/snapshot-xxxxxxx.bin)
  • The contents of data/state-history:
    • chain_state_history.log
    • trace_history.log
    • chain_state_history.index: optional. Restoring will take longer without this file.
    • trace_history.index: optional. Restoring will take longer without this file.
  • Optional: the contents of data/blocks, but excluding data/blocks/reversible.

Restoring a portable snapshot with full state-history

• Get the following:
  • A portable snapshot (data/snapshots/snapshot-xxxxxxx.bin)
  • The contents of data/state-history
  • Optional: a block log which includes the block the snapshot was taken at. Do not include data/blocks/reversible.
• Make sure data/state does not exist
• Start nodeos with the --snapshot option, and the options listed in "Nodeos configuration" above

If nodeos fails to receive blocks from the network, then try the above using net_api_plugin. Use cleos net disconnect and cleos net connect to reconnect nodes which timed out. Caution when using net_api_plugin: either use a firewall to block access to http-server-address, or change it to 127.0.0.1:8888 to disable remote access.