Adding a Validator Node with Multisig Wallet
This guide will walk you through the process of adding a validator node using your consortium member address with Camino Wallet.
Please ensure that you use the correct wallet address for this guide:
| Network | URL | Note |
|---|---|---|
| Camino (mainnet): | https://suite.camino.network/ | Production version: Please use this if you are unsure which version to choose. |
| Columbus (testnet): | https://dev.suite.camino.network/ | Development version: Please use this version if you would like to test new features. |
Please be advised that both of these wallets have access to both the mainnet and testnet. However, one of them is the production version while the other is designated for staging and development purposes.
Always verify that the domain is camino.network while using the wallet.
Overview
To add a validator node using Camino Wallet and a multisig wallet, you will need to follow these steps:
- Activate your Multisig Wallet
- Check and verify the requirements
- Retrieve your node's private key
- Register your node with your wallet
- Initiate the Register Node transaction
- Collect signatures from other members of the wallet
- Execute the transaction
- Add your node as a validator
- Set the end dates
- Initiate the Add Validator transaction
- Collect signatures from other members of the wallet
- Execute the transaction
- Verify that the validator is online
The Multi-Signature features of Camino Wallet are currently undergoing rapid development. Please note that these features are subject to updates, changes, or fixes.
1. Activate your Multisig Wallet
Firstly, you will need to activate your multisig wallet. To do this, log in to your wallet using your key phrase and navigate to the Manage Keys section (or click the switch button at the top right).
If you are a member of a multisig wallet, an import wallets dialog box will appear. Click the Import Wallets button to pull in the multisig wallets that you are a member of.
Next, click the small star icon on the right side of the multisigaddress to activate it.
For more detailed information, please refer to the Multisig Wallets & Aliases documentation.
2. Requirements
Before you begin the process of adding a validator node, there are a few requirements you must fulfill.
Below is a list of these requirements for the mainnet (camino) and testnet (columbus).
Camino Mainnet & Columbus Testnet
- NodeID: This is the address of your node, similar to a regular wallet address.
- Node's PrivateKey: You will need this to prove ownership of the NodeID.
Keep it safe and secure! - 100,000 non-bonded CAMs in your P-Chain wallet. And a few CAMs for paying for transaction fees.
- Consortium Member: Your wallet address must be a consortium member.
If you are unsure about this, please reach out to us on Discord for clarification. If you participated in the pre-sale, provided a wallet address, and are a travel-related company, you are already a Consortium Member. - KYC/KYB Verified: You must be Know-Your-Customer (KYC) or Know-Your-Business (KYB) verified.
Checking Requirements Using Camino Wallet
You can verify if you meet these requirements by accessing the Validator tab after logging in and activating the multisig wallet.
You will be presented with a page similar to this:
3. Retrieving Your Node's Private Key
To register your node to your consortium address, you need to prove that you own the node. Therefore, the wallet needs to sign the register node transaction with the node's private key. This is why you need to provide your node's private key to the wallet.
For more information on how to retrieve your node's private key, please refer to the Retrieving Your Node's Private Key guide.
4. Register Your Node with your Multisig Wallet
Once you have fulfilled the requirements outlined above, you can proceed to register your node. You should see a page as in the Fig.3 screenshot.
Simply enter your node's private key into the designated field and click on the REGISTER VALIDATOR NODE button.
Initiating the Register Node Transaction
After providing your private key, you will be presented with the initiate transaction dialog. Here, you can verify the NodeID displayed with your node's ID to ensure that the provided private key is correct.
Pay close attention to the warnings displayed in the dialog box. Once the transaction is initiated, it cannot be undone. It must either be signed by other members of the wallet and executed or it must be left to expire.
This effectively prevents you from initiating new transactions and using the multisig wallet.
Currently, the expiration time for pending transactions is two weeks and cannot be canceled or changed. However, in the near future, it will be possible to cancel signature-pending transactions.
Multisig Confirmations Pending
Once you have initiated the transaction, it will be stored off-chain. The other members of the multisig wallet can then sign the transaction by logging into the wallet and navigating to the Validator section.
Above the "execute transaction" button, you can view the threshold and the number of collected signatures.
Signing the Pending Transactions
If you are a member of a multisig wallet with a pending transaction, you can go to the Validator section to access a similar page. This page allows you to sign the transaction and execute it if you choose to do so. Alternatively, you may choose to leave the execution of the transaction to other members of the wallet.
And after it is signed:
Execute the Register Node Transaction
Click the "execute transaction" button after the threshold has been satisfied. Once the transaction is included in the blockchain, you can proceed with adding the validator node.
5. Adding your Node as a Validator
After you registered your node with your multisig wallet, you will be presented with the "Setting up a Validator Node" section.
Set Validation & Transaction End Dates
Please note that the "Confirm" button under the duration is currently disabled. This is because the validation end date must be at least 6 months in the future. Therefore, you will need to update this date accordingly.
Additionally, please update the "Transaction End Date" field. The description of this field can be misleading, as this is actually the date and time when the transaction will be executed. Therefore, please choose a sensible date and time, taking into consideration that other members of the multisig wallet will also need to sign the transaction.
Please note that it is important to set the validation and transaction end dates to appropriate values.
| Validation End Date | This should be set to a date that is at least 6 months (183 days) in the future. |
|---|---|
| Transaction End Date | This should be set to a relatively short time in the future, such as 30 or 60 minutes. |
Once you have set the appropriate dates, the page will appear as shown below. Click the Confirm button to proceed.
Initiating the Add Validator Transaction
Afterward, you will be shown a summary of the transaction along with a warning that the action cannot be undone. Review the details carefully, and if you are satisfied, click the Submit button to proceed.
Collect Signatures
After initiating the transaction, you will be presented with a screen similar to the one shown below. As with the Register Node transaction, you will need to collect enough signatures to execute the transaction.
Signing the Pending Transaction
Next, the other members of the multisig wallet need to log in to the wallet and sign the transaction. The following screen shows what a member would see:
And after it is signed:
Executing the Transaction
At this point, any member of the multisig wallet can execute the transaction. After clicking the "Execute Transaction" button and submitting the transaction for execution, you will see a screen similar to the one below, which indicates when the transaction will be executed. Note that this is the date you previously selected.
6. Verify that your Validator is online
Once the transaction execution time has been reached and the transaction has been executed, you should see a screen similar to the one below:
You may refer to this documentation for more information on how to check the status of your validator node using the Camino Explorer.