Updating Masternode Information #
Periodically, it may be necessary to update Masternode information if any information relating to the owner or operator changes. Examples may include a change in IP address, change in owner/operator payout address or changes to the nominated voting/operator keys. It is also possible to revoke a masternode’s registered status (in the event of a security breach, for example) to force both owner and operator to update their details.
Changing the BLS operator key or creating a new ProTx based on the same collateral transaction will reset your position in the payment queue. Changing your IP address or making changes to the voting or various payout addresses will not reset your position in the payment queue.
Owner Commands #
ProUpRegTx #
A Provider Update Registrar Transaction (ProUpRegTx) is used to update information relating to the owner. An owner can update the operator’s BLS public key (e.g. to nominate a new operator), the voting address and their own payout address. A ProUpRegTx can be created from Absolute Core debug console using the following syntax:
protx update_registrar proTxHash operatorKeyAddr votingKeyAddr payoutAddress (feeSourceAddress)
The update_registrar is split into the following segments:
- ProTxHash: The transaction id of the initial ProRegTx
- Operator Public Key Address: An updated BLS public key, or “” to use the last on-chain operator key
- Voting Address: An updated voting key address, or “” to use the last on-chain voting key
- Payout Address: An updated Absolute address for owner payments, or “” to use the last on-chain operator key
- feeSourceAddress (optional): An address used to fund ProTx fee. PayoutAddress will be used if not specified.
Example command to update payout address:
protx update_registrar cedce432ebabc9366f5eb1e3abc219558de9fbd2530a13589b698e4bf917b8ae "" "" yi5kVoPQQ8xaVoriytJFzpvKomAQxg6zea
Operator Commands #
ProUpServTx #
A Provider Update Service Transaction (ProUpServTx) is used to update information relating to the operator. An operator can update the IP address and port fields of a masternode entry. If a non-zero Operator Reward was set in the initial ProRegTx, the operator may also set the Operator Payout Address field in the ProUpServTx. If operator Payout Address is not set and Operator Reward is non-zero, the owner gets the full Masternode reward. A ProUpServTx can be created from the Absolute Core debug console using the following syntax:
protx update_service proTxHash ipAndPort operatorKey (operatorPayoutAddress feeSourceAddress)
The update_service is split into the following segments:
- ProTxHash: The transaction id of the initial ProRegTx
- IP And Port: IP and port in the form “ip:port”
- Operator Key: The operator BLS private key associated with the registered operator public key
- Operator Payout Address (optional): The address used for operator reward payments. Only allowed when the ProRegTx had a non-zero operatorReward value. Enter “” to use the last on-chain operator payout address,or as a placeholder when specifying a feeSourceAddress.
- feeSourceAddress (optional): An address used to fund ProTx fee. operatorPayoutAddress will be used if not specified.
Example command:
protx update_service d6ec9a03e1251ac8c34178f47b6d763dc4ea6d96fd6eddb3c7aae2359e0f474a 140.82.59.51:10002 4308daa8de099d3d5f81694f6b618381e04311b9e0345b4f8b025392c33b0696 yf6Cj6VcCfDxU5yweAT3NKKvm278rVbkhu
Result:
fad61c5f21cf3c0832f782c1444d3d2e2a8dbff39c5925c38033730e64ecc598
The masternode is now removed from the PoSe-banned list, and the IP:port and operator reward addresses are updated.
ProUpRevTx #
A Provider Update Revocation Transaction (ProUpRevTx) is used by the operator to terminate service or signal the owner that a new BLS key is required. It will immediately put the masternode in the PoSe-banned state. The owner must then issue a ProUpRegTx to set a new operator key. After the ProUpRegTx is mined to a block, the new operator must issue a ProUpServTx to update the service-related metadata and clear the PoSe- banned state (revive the masternode). A ProUpRevTx can be created from the Absolute Core debug console using the following syntax:
protx revoke proTxHash operatorKey reason (feeSourceAddress)
The update_registrar is split into the following segments:
- ProTxHash: The transaction id of the initial ProRegTx
- Operator Key: The operator BLS private key associated with the registered operator public key
reason: Integer value indicating the revocation reason - Fee Source Address (optional): An address used to fund ProTx fee. operatorPayoutAddress will be used if not specified.
Example command:
protx revoke 9f5ec7540baeefc4b7581d88d236792851f26b4b754684a31ee35d09bdfb7fb6 565950700d7bdc6a9dbc9963920bc756551b02de6e4711ef