diff --git a/docs/account.md b/docs/account.md index 653deba9..e7acc667 100644 --- a/docs/account.md +++ b/docs/account.md @@ -519,6 +519,29 @@ transaction. ### Entity Management {#entity} +#### Initialize Entity {#entity-init} + +When setting up a validator node for the first time, you will need to provide +the path to the file containing your entity descriptor as well as register it in +the network registry. Use `account entity init` to generate the entity +descriptor file containing the public key of the selected account. + +![code shell](../examples/account/entity-init.in.static) + +![code json](../examples/account/entity-init.out.static) + +By default, the file content will be printed to the standard output. You can use +`-o` parameter to store it to a file, for example: + +![code shell](../examples/account/entity-init-o.y.in) + +:::info + +[Account](#account) selector is available for the +`account entity init` command. + +::: + #### Register your Entity {#entity-register} In order for validators to become part of the validator set and/or the compute diff --git a/examples/account/allow-paratime.y.out b/examples/account/allow-paratime.y.out index 2d5dba9b..78fc3e01 100644 --- a/examples/account/allow-paratime.y.out +++ b/examples/account/allow-paratime.y.out @@ -3,7 +3,7 @@ Method: staking.Allow Body: Beneficiary: oasis1qqczuf3x6glkgjuf0xgtcpjjw95r3crf7y2323xd Amount change: +10.0 TEST -Nonce: 1 +Nonce: 2 Fee: Amount: 0.0 TEST Gas limit: 1278 diff --git a/examples/account/allow.y.out b/examples/account/allow.y.out index ad0138ab..3cad3244 100644 --- a/examples/account/allow.y.out +++ b/examples/account/allow.y.out @@ -3,7 +3,7 @@ Method: staking.Allow Body: Beneficiary: oasis1qpl4axynedmdrrgrg7dpw3yxc4a8crevr5dkuksl Amount change: +10.0 TEST -Nonce: 1 +Nonce: 2 Fee: Amount: 0.0 TEST Gas limit: 1278 diff --git a/examples/account/amend-commission-schedule.y.out b/examples/account/amend-commission-schedule.y.out index 52742acd..b8ae9911 100644 --- a/examples/account/amend-commission-schedule.y.out +++ b/examples/account/amend-commission-schedule.y.out @@ -12,7 +12,7 @@ Body: (2) start: epoch 335000 minimum rate: 0.9% maximum rate: 1.9% -Nonce: 1 +Nonce: 2 Fee: Amount: 0.0 TEST Gas limit: 1361 diff --git a/examples/account/burn.y.out b/examples/account/burn.y.out index 4b7a3ce5..ff1b1e5b 100644 --- a/examples/account/burn.y.out +++ b/examples/account/burn.y.out @@ -2,7 +2,7 @@ You are about to sign the following transaction: Method: staking.Burn Body: Amount: 2.5 TEST -Nonce: 1 +Nonce: 2 Fee: Amount: 0.0 TEST Gas limit: 1235 diff --git a/examples/account/delegate.y.out b/examples/account/delegate.y.out index a1963865..e099a20a 100644 --- a/examples/account/delegate.y.out +++ b/examples/account/delegate.y.out @@ -3,7 +3,7 @@ Method: staking.AddEscrow Body: To: oasis1qpkl3vykn9mf4xcq9eevmey4ffrzf0ajtcpvd7sk Amount: 20.0 TEST -Nonce: 1 +Nonce: 2 Fee: Amount: 0.0 TEST Gas limit: 1271 diff --git a/examples/account/entity-deregister.y.out b/examples/account/entity-deregister.y.out index 08c90a3f..6a96808e 100644 --- a/examples/account/entity-deregister.y.out +++ b/examples/account/entity-deregister.y.out @@ -2,7 +2,7 @@ You are about to sign the following transaction: Method: registry.DeregisterEntity Body: {} -Nonce: 1 +Nonce: 2 Fee: Amount: 0.0 TEST Gas limit: 1231 diff --git a/examples/account/entity-init-o.y.in b/examples/account/entity-init-o.y.in new file mode 100644 index 00000000..5611e88e --- /dev/null +++ b/examples/account/entity-init-o.y.in @@ -0,0 +1 @@ +oasis account entity init -o entity.json diff --git a/examples/account/entity-init-o.y.out b/examples/account/entity-init-o.y.out new file mode 100644 index 00000000..e69de29b diff --git a/examples/account/entity-init.in.static b/examples/account/entity-init.in.static new file mode 100644 index 00000000..981c224c --- /dev/null +++ b/examples/account/entity-init.in.static @@ -0,0 +1 @@ +oasis account entity init diff --git a/examples/account/entity-init.out.static b/examples/account/entity-init.out.static new file mode 100644 index 00000000..7f10c096 --- /dev/null +++ b/examples/account/entity-init.out.static @@ -0,0 +1,5 @@ +{ + "id": "Bx6gOixnxy15tCs09ua5DcKyX9uo2Forb32O6Hyjoc8=", + "nodes": [], + "v": 2 +} diff --git a/examples/account/entity-register.y.out b/examples/account/entity-register.y.out index 99840c84..ea9103db 100644 --- a/examples/account/entity-register.y.out +++ b/examples/account/entity-register.y.out @@ -16,7 +16,7 @@ Body: "signature": "DAwn+N8hKmQMbZda/fFJSEgErDAAdebXLfIPOpqUkJowJLUAL+nfrUMz5SVkKc0TnqQOavoSAVFz1yoRJ3QuBA==" } } -Nonce: 1 +Nonce: 2 Fee: Amount: 0.0 TEST Gas limit: 2471 diff --git a/examples/account/node-unfreeze.y.out b/examples/account/node-unfreeze.y.out index 0c0b0a96..00538de2 100644 --- a/examples/account/node-unfreeze.y.out +++ b/examples/account/node-unfreeze.y.out @@ -4,7 +4,7 @@ Body: { "node_id": "fasTG3pMOwLfFA7JX3R8Kxw1zFflqeY6NP/cpjcFu5I=" } -Nonce: 1 +Nonce: 2 Fee: Amount: 0.0 TEST Gas limit: 1274 diff --git a/examples/account/show.out b/examples/account/show.out index 1b694939..3a80d6f5 100644 --- a/examples/account/show.out +++ b/examples/account/show.out @@ -1,7 +1,7 @@ Address: oasis1qp87hflmelnpqhzcqcw8rhzakq4elj7jzv090p3e === CONSENSUS LAYER (testnet) === - Nonce: 1 + Nonce: 2 Total: 0.0 TEST Available: 0.0 TEST diff --git a/examples/account/undelegate.y.out b/examples/account/undelegate.y.out index 0dd2ad31..dac2cc32 100644 --- a/examples/account/undelegate.y.out +++ b/examples/account/undelegate.y.out @@ -3,7 +3,7 @@ Method: staking.ReclaimEscrow Body: From: oasis1qpkl3vykn9mf4xcq9eevmey4ffrzf0ajtcpvd7sk Shares: 20000000000 -Nonce: 1 +Nonce: 2 Fee: Amount: 0.0 TEST Gas limit: 1275