Draft doc on how to setup a network #257
Conversation
NETWORK_SETUP.md
Outdated
| lotus-seed --sector-dir /storage/<maddr>/pre-seal-2 pre-seal ... --num-sectors 4 --sector-offset 8 | ||
| ``` | ||
|
|
||
| Note: The |
basic example targets starting the Nerpa network with the minimum pieces required for a public devnet all other information is organized under an advanaced usage section
NETWORK_SETUP.md
Outdated
| faucet. | ||
|
|
||
| TODO: This should be a command in lotus-seed to add accounts | ||
| TODO: There needs to a way to set the actor ID 90 account. |
There was a problem hiding this comment.
lotus-seed genesis set-remainder --account <addr> "/storage/<network>/genesis.json"
| } | ||
| } | ||
| } | ||
| ``` |
There was a problem hiding this comment.
This is the jq to do this
jq --arg VerifyKey ${verifreg_rootkey} '.VerifregRootKey.Meta.Signers = [$VerifyKey] ' < "${genpath}/genesis.json" > ${genesistmp}
mv ${genesistmp} "${genpath}/genesis.json"
Also some new commands:
lotus-seed genesis set-vrk --multsig ./multisig.csv
lotus-seed genesis set-vrk --account <addr>
The multisig option is similar to what is described in the doc at the moment (setting signers), where as the account flag uses a standard account actor address. Multisigs are better for long lived networks with multiple users that can operate the verified registery (as you can add / remove signers). Where as the account type is simplier and works well for short lived networks.
NETWORK_SETUP.md
Outdated
| without having to distribute new multiaddrs. Bootstrap nodes must all be publicly dial-able and have a static port, as | ||
| lotus by default uses a random port assigned by the kernel. | ||
|
|
||
| To compile bootstrap multiaddrs into the `lotus` binary, place the multiaddrs in `./build/bootstrap/bootstrappers.pi`. |
There was a problem hiding this comment.
./build/bootstrap/bootstrappers.pi is now a per network configuration.
There was a problem hiding this comment.
I thought I wrote about how to create new networks someplace, as this is mostly written to use the single network per branch.
There was a problem hiding this comment.
Here is at least a complete PR on how to update lotus to add a new network: https://github.com/filecoin-project/lotus/pull/6387/files
It doesn't go into details about the parameter configuration of the network. I believe that is what I wrote about prior, just not sure where it went.
…-ognots code editing instructions and some restructuring
This is still an incomplete document but I want to open the PR to get feedback on it's current state to help me further improve the document as a big part of this is going to be to simply try to answer the questions people have. I've spent the last year learning this all and things are that obvious to me will not be obvious to others.