Setting Up Seed Node

Setup

Info

Please note that whitelisting will be required for operating a Zilliqa seed node. Currently, whitelisting is granted on a case by case basis and usually for reason such as supporting exchange infrastracture.

Step 1: Download `Zilliqa-rosetta` latest release fromhttps://github.com/Zilliqa/zilliqa-rosetta/releases

Step 2: Build `Zilliqa-rosetta` Docker image from Zilliqa and Scilla source code

sh ./build_docker.sh

If you need to build Zilliqa-rosetta with a specific Zilliqa and Scilla version, you can using the following

docker build \
--build-arg ROSETTA_COMMIT_OR_TAG=<ROSETTA_TAG> \
--build-arg SCILLA_COMMIT_OR_TAG=<SCILLA_TAG> \
--build-arg COMMIT_OR_TAG=<ZILLIQA_TAG> \
-t rosetta:1.0 .

Please note compiling Zilliqa and Scilla may take some time.

Step 3: Create `config.yaml` for `Zilliqa-rosetta`. We have also provided a sample of testnet and mainnet configuration

Step 4: Generation of keypair for whitelisting (only for public key whitelisting method)

If you are using public key whtielisting method and wish to generate a keypair, you can do the following

mkdir secrets

docker run --rm \
--env GENKEYPAIR="true" \
rosetta:1.0 > secrets/mykey.txt

Remember to inform the Zilliqa team of your public key for whitelisting purpose

Step 5:Running `Zilliqa-rosetta`

docker run -d \
--env BLOCKCHAIN_NETWORK="<NETWORK_TO_USE>" \
--env IP_ADDRESS="<SEED_NODE_HOST_IP>" \
--env MULTIPLIER_SYNC="<Y_or_N>" \
--env SEED_PRIVATE_KEY="<SEED_PRIVATE_KEY>" \
--env TESTNET_NAME="<NAME_OF_THE_TESTNET>" \
--env BUCKET_NAME="<NAME_OF_THE_PERSISTENCE_BUCKET>" \
-v $(pwd)/secrets/mykey.txt:/run/zilliqa/mykey.txt \
-p 4201:4201 -p 4301:4301 -p 4501:4501 -p 33133:33133 -p 8080:8080 \
--name rosetta rosetta:1.0

Variable	Description
`NETWORK_TO_USE`	`testnet` or `mainnet`
`SEED_NODE_HOST_IP`	Public IP for Zilliqa seed node
`SEED_PRIVATE_KEY`	prviate key of the whitelisted keypair. Optional field
`NAME_OF_THE_TESTNET`	Refer to `network meta`
`NAME_OF_THE_PERSISTENCE_BUCKET`	Refer to `network meta`

Maintanance

Restarting Zilliqa Rosetta

docker stop <container name>
docker start <container name>