Change Weight via Multi-Sig
Change a validator's weight using Safe wallet multi-sig approval
Changing a validator's weight adjusts their influence in consensus. This operation follows the same two-phase pattern as adding a validator, with multi-sig approval required for each phase.
When to Change Weight
Common reasons to adjust validator weights:
- Performance-based: Reward well-performing validators with higher weight
- Governance adjustments: Rebalance influence among validators
- Scaling: Increase weight as a validator proves reliable
- Temporary reduction: Lower weight during maintenance or issues
Prerequisites
- ✅ The validator must be in Active status
- ✅ New weight must respect churn limits
- ✅ Access to your Safe wallet with required signers
Phase 1: Initiate Weight Change
Identify the Validator
You'll need the Validation ID of the validator whose weight you want to change.
Get this from:
- The Query Validator Set tool
- Previous transaction records
- Your validator management documentation
Access Your Safe Wallet
- Go to wallet.ash.center
- Connect and select your Safe
- Navigate to "New Transaction" → "Transaction Builder"
Configure the Transaction
| Field | Value |
|---|---|
| To Address | Your PoA Manager address |
| Value | 0 |
| Contract Method | changeValidatorWeight |
Parameters:
- Validation ID: The unique identifier of the validator
- New Weight: The desired new weight value
Submit and Collect Approvals
- Review the transaction parameters
- Submit the transaction
- Coordinate with signers for approvals
- Wait for threshold to be reached
Execute the Transaction
Once approved:
- Execute the transaction
- Wait for confirmation
- A Warp message is sent to the P-Chain
Phase 2: Complete Weight Change
Wait for P-Chain Processing
The P-Chain processes the weight update and returns a signed acknowledgment.
Prepare Completion Transaction
In your Safe wallet:
- Create a new transaction
- Target your PoA Manager
- Call
completeValidatorWeightUpdate - Provide the message index
Collect Approvals and Execute
Same approval process:
- Submit the transaction
- Collect signer approvals
- Execute when threshold is reached
Churn Limits
Weight changes are subject to churn limits set during VMC initialization. You cannot change more than the maximum churn percentage of total weight within the churn period.
Understanding Churn
| Setting | Description | Typical Value |
|---|---|---|
| Churn Period | Time window for tracking changes | 24 hours (86400 seconds) |
| Max Churn % | Maximum weight change allowed per period | 20% |
Example: If total weight is 1000 and max churn is 20%, you can only change up to 200 weight units per period.
Handling Churn Errors
If your weight change exceeds churn limits:
- Wait: The churn period will reset
- Smaller Changes: Break into multiple smaller changes
- Plan Ahead: Schedule large changes across multiple periods
Verification
After completion:
- Query the validator set to confirm the new weight
- Verify in block explorer or contract read
- Monitor consensus participation with new weight
Diagram: Complete Weight Change Flow
Is this guide helpful?
