Create an Entity Package
Entity packages are only required at the beginning of a network. If the network is already running then this will no longer be used.
In order to join at the beginning of the Mainnet, we require that you send an Entity Package so that a genesis document can be created for the network.
To create an Entity Package you must create a tarball (
.tar.gz) that contains the following files:
entity/entity_genesis.json- This is the
entity_genesis.jsonfrom the entity you initialized.
entity/entity.json- This is the
entity.jsonfile from the entity you initialized.
node/node_genesis.json- This is the
node_genesis.jsonfrom the node you initialized.
During genesis creation we will only accept a single node.
The following commands should be executed on your local system, where you initialized your Entity and Node:
mkdir -p package/entity package/node
cp /localhostdir/entity/*.json package/entity
cp /localhostdir/node/node_genesis.json package/node
cd package && tar -zcvf ../<YOUR-GITHUB-USERNAME>-entity.tar.gz entity node
Submitting Your Entity Package (For Mainnet)
The deadline for Mainnet Entity Packages is 2020-09-03T23:59:00 UTC.
To submit your Entity Package, we've created a repository that will consume and validate the Entity packages.
- Fork the oasisprotocol/mainnet-entities repository.
- Add your Entity Package to the
entities/directory of the repository.
- Create a pull request against the
masterbranch of the oasisprotocol/mainnet-entities repository. Once your Entity Package passes all validation checks we will handle the merging of your pull request.
If there are any issues, you can always resubmit your entity package.