Replay Contract
As a DSP, you will want the ability to replay a contract’s vRAM (IPFS) related transactions to load that data into your IPFS cluster. We provide a file that does just that replay-contract.js.
To do this you will need to sign up for an API key from dfuse.io, you can select the Server to Server option from the dropdown when creating it. Dfuse offers free keys that last 24 hours, so there’s no need to pay.
There are some mandatory and optional environment variables.
Hyperion may also be used thanks to Christoph Michel: replay-contract-hyperion.js. List of endpoints here: https://hyperion.docs.eosrio.io/endpoint/, status of endpoint (UP/DOWN) here: https://bloks.io/hyperion
The dfuse GET /v0/search/transactions API has been discontinued, so Hyperion is currently the only option unless you have access to your own dfuse API.

Mandatory:

1
# contract to replay
2
export CONTRACT=
3
export NODEOS_CHAINID="aca376f206b8fc25a6ed44dbdc66547c36c6c33e3a119ffbeaef943642f0e906" # < mainnet | kylin > "5fff1dae8dc8e2fc4d5b23b2c7665c97f9e9d8edf2b6485a86ba311c25639191"
4
export DSP_ALLOW_API_NON_BROADCAST=true # enables the `/event` DSP API endpoint to accept non-blocking service events such as xcommits.
5
# make sure NO TRAILING FORWARD SLASH
6
# this good: export DSP_ENDPOINT=http://kylin-dsp-1.liquidapps.io
7
# this leads to an error export DSP_ENDPOINT=http://kylin-dsp-1.liquidapps.io/
8
export DSP_ENDPOINT=
9
# using Dfuse?
10
export DFUSE_API_KEY=
11
# using Hyperion?
12
export HYPERION_ENDPOINT=https://eos.hyperion.eosrio.io
13
export HYPERION_SORT_DIRECTION=asc # can also be desc, ascending starts from first block, descending starts from head block of chains
Copied!

Sidechain:

If replaying an account on a sidechain, must add the following environment variables.
  • SIDECHAIN if using a sidechain, must specify sidechain name (sidechain names can be found here)
  • SIDECHAIN_DSP_PORT if using a sidechain, must specify sidechain DSP’s port
  • DSP_LIQUIDX_CONTRACT the liquidx contract name must be set liquidx.dsp on mainnet if cleaning a sidechain
  • NODEOS_MAINNET_ENDPOINT set mainnet nodeos endpoint

Optional:

1
export LAST_BLOCK= # defaults to 35000000, this is the last block to sync from, find the first vRAM transaction for the contract and set the block before it
2
export DFUSE_ENDPOINT= # defaults to 'eos.dfuse.eosnation.io', can set to `kylin.dfuse.eosnation.io`
3
export BLOCK_COUNT_PER_QUERY= # defaults to 1000000
4
export NODEOS_SECURED= # defaults to true
5
export NODEOS_HOST= # defaults to localhost
6
export NODEOS_PORT= # defaults to 13115
Copied!
Once you’ve set those, simply run with:
1
sudo find / -name replay-contract.js
2
node /root/.nvm/versions/node/v10.16.0/lib/node_modules/@liquidapps/dsp/utils/ipfs-service/replay-contract.js
3
# or hyperion
4
node /root/.nvm/versions/node/v10.16.0/lib/node_modules/@liquidapps/dsp/utils/ipfs-service/replay-contract-hyperion.js
5
6
# sent 6513 saved 7725.26KB 6.42KB/s Block:77756949
Copied!
You should set DSP_ALLOW_API_NON_BROADCAST=false and restart the DSP API once you have completed your replay. This is to prevent external actors from pushing unauthorized transactions to the DSP. As a note, the sign service will never process externally sourced transactions as a safety precaution.

How to know if it is running correctly:

In the IPFS logs, you SHOULD see this log because this is a replay. You will not see this log for normal IPFS related transactions, only ones sent from the replay script.
1
logger.warn(`commit PASSIVE_DSP_NODE ${process.env.PASSIVE_DSP_NODE} || replay: ${replay} || exception ${exception}`)
Copied!
You should NOT see this log because you have set DSP_ALLOW_API_NON_BROADCAST=true.
1
logger.warn(`Attempt to broadcast event for non broadcastable request, not processing trx, to enable non-broadcast events, set the allow_api_non_broadcast config.toml var to true under [dsp] section - ${JSON.stringify(act.event)}`);
Copied!