Jail/Unjail
Introduction
In the unfortunate event of losing too much rating score, a validator will be jailed. This means they will be removed from the Sovereign Shard, will not participate in consensus, and consequently, will not earn any rewards. Currently, a node will be jailed if its rating falls to 10 or below. Learn more on the Rating page.
How to Unjail a Validator
Unjailing a validator is a straightforward process that involves submitting a transaction to the Staking Smart Contract. This transaction, known as an unjailing transaction, is essentially a fine payment that facilitates the return of your jailed validator to the network. Upon successful execution, the validator is reinstated in the following epoch, starting anew with a rating of 50.
Requirements for Unjailing Transactions
Proper Encoding: The transaction must include all necessary information, correctly encoded.
Sufficient Gas Limit: Ensure the gas limit is high enough to carry out the transaction without issues.
BLS Public Keys: Examples may showcase BLS public keys. Important: These keys are randomly generated for demonstrative purposes only and do not correspond to actual nodes. Avoid using them in your real staking transactions.
Steps to Unjail Your Validator
Through the Online Wallet: Navigate to OneFinity Wallet where you can easily submit your unjailing transaction.
Using Command-Line Tools: Alternatively, tools like
ofpyallow for command-line submission of unjailing transactions.
Remember, choosing to unjail your validator is an opportunity to reintegrate into the network and contribute once again as a fresh participant.
The following pages will describe both approaches in each specific case.
Prerequisites
In order to submit an unjailing transaction, you require the following:
A wallet with at least 300 ONE (the cost of unjailing a single validator). If you want to unjail multiple validators at once, you need to multiply that minimum amount with the number of validators. For example, unjailing 3 validators at once will require 900 ONE. Make sure you have enough in your wallet.
The BLS public keys of the validators you want to unjail. You absolutely do not require the secret key of the validators. The BLS public keys of the validators are found in the
validatorKey.pemfiles. Please read Validator Keys to find out how to extract the public key only. Remember that the BLS public key consists of exactly 192 hexadecimal characters (that is,0to9andatofonly).
Unjailing Nodes Through the Wallet
To unjail nodes, carefully follow the steps outlined below, ensuring that you replace the placeholders with your actual data.
Open the Wallet: Navigate to Onefinity Wallet.
Fee Limit Section: Expand this section in the form to reveal the "Gas limit" field. The value for "Gas limit" is calculated based on how many nodes you intend to unjail. Use the following formula:
6000000 * [Number of Nodes]. Examples:For 1 node:
6000000For 2 nodes:
12000000For 3 nodes:
18000000
This action also enables the "Fee limit" field to auto-calculate the transaction cost.
Amount Field: Determine the amount of ONE needed by multiplying
[Number of Nodes]by300 ONE. Examples:For 1 node:
300 ONEFor 2 nodes:
600 ONEFor 3 nodes:
900 ONE
To Field: Insert the Staking SmartContract address responsible for unjailing.
Send: Hit the "Send" button once all fields are correctly filled.
Ensure you understand each information piece and adjust accordingly with your specific details.
Data field
When entering information into the "Data" field, it's imperative that you follow the specific format outlined below. The information you input must be precisely structured, as the Staking Smart Contract utilizes this data to identify which nodes you intend to unjail. You have the flexibility to unjail multiple nodes simultaneously.
Unjailing a single node
If you want to unjail a single node, the format of the "Data" field is simple:
To correctly populate the "Data" field, do not directly copy and paste the template provided. Instead, you must substitute <BLS1> with the actual BLS public key from the node you wish to stake with. Locate this key within the validatorKey.pem file associated with the desired node. This step ensures accurate and secure staking configurations.
For an unjailing transaction of a single node, the "Data" field appears thus: Do not remove the @ symbol, which separates information within "Data". Replace <BLS1>, removing the angle:
unJail@b617d8bc442bda59510f77e04a1680e8b2d3293c8c4083d94260db96a4d732deaaf9855fa0cef2273f5a67b4f442c725efc06a5d366b9f15a66da9eb8208a09c9ab4066b6b3d38c3cf1ea7fab6489a90713b3b56d87de68c6558c80d7533bf27
Unjailing multiple nodes at once
Unjailing multiple nodes simultaneously follows a similar process to unjailing a single node. Simply concatenate the BLS public keys of each additional node you want to unjail, using @ as a separator, in the "Data" field. Ensure you're familiar with the process for unjailing a single node by reviewing "Unjailing a single node" section beforehand. Remember to adjust the "Amount" and "Gas Limit" fields based on the total number of nodes you're unjailing.
For a single node:
For two nodes:
And for three nodes:
To augment the existing format with additional nodes, incorporate the specific BLS public keys of your nodes by substituting @<BLS…> with the relevant keys. You can locate these public keys in the validatorKey.pem files for each node. It's crucial to ensure that you're only using the BLS public keys and not exposing any BLS secret keys. For guidance on reading and understanding the contents of validatorKey.pem files, please refer to the Validator Keys documentation.
For example, the "Data" field for an unjailing transaction for two nodes looks like this:
unJail@b617d8bc442bda59510f77e04a1680e8b2d3293c8c4083d94260db96a4d732deaaf9855fa0cef2273f5a67b4f442c725efc06a5d366b9f15a66da9eb8208a09c9ab4066b6b3d38c3cf1ea7fab6489a90713b3b56d87de68c6558c80d7533bf27@f921a0f76ed70e8a806c6f9119f87b12700f96f732e6070b675e0aec10cb0723803202a4c40194847c38195db07b1001f6d50c81a82b949e438cd6dd945c2eb99b32c79465aefb9144c8668af67e2d01f71b81842d9b94e4543a12616cb5897d
Unjailing through ofpy
Ensure you have the latest version of ofpy installed before proceeding. If you haven't installed ofpy, please follow these instructions (LINK TO INSTRUCTIONS). By utilizing ofpy for submitting the unjailing transaction, you eliminate the need to manually craft the "Data" section. ofpy allows for the automatic construction and direct submission of the transaction to the network in a single, streamlined command.
Your Wallet PEM file
To send transactions on your behalf without using the online OneFinity Wallet, ofpy must be able to sign for you. For this reason, you have to generate a PEM file using your Wallet mnemonic.
Please follow the guide Deriving the Wallet PEM file CHECK LINK!. Make sure you know exactly where the PEM file was generated, because you'll need to reference its path in the ofpy commands.
After the PEM file was generated, you can issue transactions from ofpypydirectly.
The unjailing transaction
The following commands assume that the PEM file for your Wallet was saved with the name walletKey.pem in the current folder, where you are issuing the commands from.
The command to submit an unjailing transaction with ofpy is this:
Notice that we are using the walletKey.pem file. Moreover, before executing this command, you need to replace the following:
Replace
<unjail-value>with the amount of EGLD required for unjailing your validators. You need to calculate this value with respect to the number of nodes you are unjailing. See the beginning of the Unjailing through the Wallet section for info on how to do it.Replace all the
<BLS…>with the actual BLS public keys of your nodes, which you can find inside their individualvalidatorKey.pemfiles. Make sure you do not write the BLS secret keys! Read the page Validator Keys to see how to interpret thevalidatorKey.pemfiles.
Additionally, it's important to note that "Gas Limit" calculations are not provided by default. However, by using the --estimate-gas option with mxpy, the gas limit can be automatically estimated for you.
Here's an example for an unjailing command for one validator:
IMPORTANT
You must take denomination into account when specifying the value parameter in ofpy.
For two validators, the command becomes this one:
Notice that the two BLS public keys are separated by a comma, with no extra space between them.
Last updated
