diff --git a/README.md b/README.md index 8e656ed..ce2c0e9 100644 --- a/README.md +++ b/README.md @@ -10,3 +10,6 @@ Stacks to run a node for laconic testnet Follow steps in [testnet-onboarding-demo.md](./testnet-onboarding-demo.md) to run demo for onboarding testnet participants in laconicd chain +## Join LORO testnet + +Follow steps in [testnet-onboarding-validator.md](./testnet-onboarding-validator.md) to onboard your participant and join as a validator on the LORO testnet diff --git a/testnet-onboarding-validator.md b/testnet-onboarding-validator.md index 50a0b60..65be8b6 100644 --- a/testnet-onboarding-validator.md +++ b/testnet-onboarding-validator.md @@ -29,7 +29,7 @@ * Send transaction request to the wallet - * From wallet, approve and send transaction to laconicd chain + * From wallet, approve and send transaction to stage0 laconicd chain ## Join as a validator on stage1 @@ -123,7 +123,7 @@ # Use the provided node id CERC_PEERS="" - # A custom human readable name for this node (default: TestnetNode) + # A custom human readable name for this node CERC_MONIKER= ``` @@ -163,53 +163,77 @@ laconic-so deployment --dir testnet-laconicd-deployment start ### Join as testnet validator -* Import a key pair: +* Create a validator from the onboarding app: - ```bash - KEY_NAME=alice + * Visit the [validator creation](https://loro-signup.laconic.com/validator) page - # Restore existing key with mnemonic seed phrase - # You will be prompted to enter mnemonic seed - laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys add $KEY_NAME --recover" + * Select the Laconic account (same as the one used while onboarding) using which you wish to send the create validator request - # Query the keystore for your account's address - laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys show $KEY_NAME -a" - ``` + * This should display the details of your onboarded participant -* Check balance for your account: + * You can proceed if the participant has `validator` role - ```bash - laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd query bank balances " - ``` + * Enter your node's moniker (use the same one used while [configuring](#configuration) the `testnet-laconicd-deployment`) -* Create required validator configuration: + * Fetch and enter your validator's pubkey: - ```bash - # Note: - # Edit the staking amount and other fields as required - # Replace with your node's moniker in command below + ```bash + laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd cometbft show-validator" | jq -r .key + ``` - laconic-so deployment --dir testnet-laconicd-deployment exec laconicd 'cat < my-validator.json - { - "pubkey": $(laconicd cometbft show-validator), - "amount": "1000000000000000alnt", - "moniker": "", - "commission-rate": "0.1", - "commission-max-rate": "0.2", - "commission-max-change-rate": "0.01", - "min-self-delegation": "1" - } - EOF' - ``` + * Send the transaction request to wallet -* Create a validator: + * From wallet, approve and send transaction to stage1 laconicd chain - ```bash - laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd tx staking create-validator my-validator.json \ - --fees 500000alnt \ - --chain-id=laconic_9000-1 \ - --from $KEY_NAME" - ``` +* Alternatively, create a validator using the laconicd CLI: + + * Import a key pair: + + ```bash + KEY_NAME=alice + + # Restore existing key with mnemonic seed phrase + # You will be prompted to enter mnemonic seed + laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys add $KEY_NAME --recover" + + # Query the keystore for your account's address + laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys show $KEY_NAME -a" + ``` + + * Check balance for your account: + + ```bash + laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd query bank balances " + ``` + + * Create required validator configuration: + + ```bash + # Note: + # Edit the staking amount and other fields as required + # Replace with your node's moniker in command below + + laconic-so deployment --dir testnet-laconicd-deployment exec laconicd 'cat < my-validator.json + { + "pubkey": $(laconicd cometbft show-validator), + "amount": "1000000000000000alnt", + "moniker": "", + "commission-rate": "0.1", + "commission-max-rate": "0.2", + "commission-max-change-rate": "0.01", + "min-self-delegation": "1" + } + EOF' + ``` + + * Create a validator: + + ```bash + laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd tx staking create-validator my-validator.json \ + --fees 500000alnt \ + --chain-id=laconic_9000-1 \ + --from $KEY_NAME" + ``` * View staking validators: @@ -243,3 +267,7 @@ laconic-so deployment --dir testnet-laconicd-deployment start # Remove deployment directory (deployment will have to be recreated for a re-run) rm -r testnet-laconicd-deployment ``` + +## Troubleshooting + +* If you face any issues in the onboarding app or the web-wallet, clear your browser cache and reload