Struct ValidatorConfigV2 

pub struct ValidatorConfigV2 {
    pub config: <Config as StorableType>::Handler,
    pub validators: <Vec<ValidatorRecord> as StorableType>::Handler,
    pub address_to_index: <Mapping<Address, u64> as StorableType>::Handler,
    pub pubkey_to_index: <Mapping<B256, u64> as StorableType>::Handler,
    pub next_network_identity_rotation_epoch: <u64 as StorableType>::Handler,
    pub active_ingress_ips: <Mapping<B256, bool> as StorableType>::Handler,
    pub active_indices: <Vec<u64> as StorableType>::Handler,
    address: Address,
    storage: StorageCtx,
}

Fields

config: <Config as StorableType>::Handler

validators: <Vec<ValidatorRecord> as StorableType>::Handler

address_to_index: <Mapping<Address, u64> as StorableType>::Handler

pubkey_to_index: <Mapping<B256, u64> as StorableType>::Handler

next_network_identity_rotation_epoch: <u64 as StorableType>::Handler

active_ingress_ips: <Mapping<B256, bool> as StorableType>::Handler

active_indices: <Vec<u64> as StorableType>::Handler

address: Address

storage: StorageCtx

Implementations

impl ValidatorConfigV2

pub fn new() -> Self

Creates an instance of the precompile.

Caution: This does not initialize the account, see Self::initialize.

fn __new(address: Address) -> Self

fn __initialize(&mut self) -> Result<()>

fn emit_event(&mut self, event: impl IntoLogData) -> Result<()>

pub fn emitted_events(&self) -> &Vec<LogData>

Available on crate features test-utils only.

pub fn clear_emitted_events(&mut self)

Available on crate features test-utils only.

pub fn assert_emitted_events(&self, expected: Vec<impl IntoLogData>)

Available on crate features test-utils only.

impl ValidatorConfigV2

pub fn initialize(&mut self, owner: Address) -> Result<()>

Initializes the validator config V2 precompile.

The contract is fully operational immediately: is_init is set to true and all mutating functions (add_validator, rotate_validator, etc.) are unlocked.

For V1 migration, the contract is NOT initialized — instead migrate_validator manually copies validators and initialize_if_migrated flips is_init once all have been migrated.

pub fn owner(&self) -> Result<Address>

Returns the current owner of the contract.

pub fn get_initialized_at_height(&self) -> Result<u64>

Returns the block height at which the contract was initialized.

Only meaningful when is_initialized returns true.

pub fn is_initialized(&self) -> Result<bool>

Returns whether V2 has been initialized (either directly or via migration).

When false, the CL reads from V1 and mutating operations (except deactivate_validator and migration functions) are blocked.

pub fn validator_count(&self) -> Result<u64>

Returns the total number of validators ever added, including deactivated entries and rotation snapshots.

fn get_active_validator(&self, idx: u64) -> Result<ValidatorRecord>

Returns the validator at the given global index, or errors if the index is out of bounds or the validator has been deactivated.

fn read_validator_at(&self, index: u64) -> Result<Validator>

pub fn validator_by_index(&self, index: u64) -> Result<Validator>

Returns the validator registry at the given global index in the validators array.

Errors

• ValidatorNotFound — index is out of bounds

pub fn validator_by_address(&self, addr: Address) -> Result<Validator>

Looks up a validator registry by its address.

Returns the current entry for the address (after any rotations or transfers).

Errors

• ValidatorNotFound — the address has never been registered

pub fn validator_by_public_key(&self, pubkey: B256) -> Result<Validator>

Looks up a validator by its Ed25519 public key.

For rotated validators, the old public key resolves to the deactivated snapshot, while the new key resolves to the in-place active entry.

Errors

• ValidatorNotFound — the public key has never been registered

pub fn get_active_validators(&self) -> Result<Vec<Validator>>

Returns only active validators (where deactivatedAtHeight == 0).

NOTE: the order of returned validator records is NOT stable and should NOT be relied upon.

pub fn get_next_network_identity_rotation_epoch(&self) -> Result<u64>

Returns the epoch at which a network identity rotation will be triggered.

See set_network_identity_rotation_epoch.

fn validate_endpoints(ingress: &str, egress: &str) -> Result<()>

fn ingress_key(ingress: &str) -> Result<B256>

Parses ingress as an <ip>:<port> pair and returns the hash of the ingress’ binary representation.

For V4 addresses, that’s keccak256(octets(ip) || big_endian(port)).

For V6 addresses, that’s keccak256(octets(ip) || big_endian(scope_id) || big_endian(port)).

fn require_unique_ingress(&self, ingress: &str) -> Result<B256>

fn update_ingress_ip_tracking( &mut self, old_ingress: &str, new_ingress: &str, ) -> Result<()>

fn append_validator( &mut self, addr: Address, pubkey: B256, ingress: String, egress: String, fee_recipient: Address, added_at_height: u64, deactivated_at_height: u64, ) -> Result<u64>

fn require_new_address(&self, addr: Address) -> Result<()>

Allows reusing addresses of deactivated validators.

fn require_new_pubkey(&self, pubkey: B256) -> Result<()>

fn verify_validator_signature( &self, kind: SignatureKind, pubkey: &B256, signature: &[u8], validator_address: Address, ingress: &str, egress: &str, ) -> Result<()>

Verifies a validator signature for add or rotate operations.

Constructs the message according to the validator config v2 specification and verifies the Ed25519 signature using the appropriate namespace.

pub fn add_validator( &mut self, sender: Address, call: addValidatorCall, ) -> Result<u64>

Adds a new validator to the set (owner only).

Requires a valid Ed25519 signature, using the VALIDATOR_NS_ADD namespace, over keccak256(chainId || contractAddr || validatorAddr || len(ingress) || ingress || len(egress) || egress || feeRecipient) which proves that the caller controls the private key corresponding to publicKey.

Errors

• NotInitialized — the contract has not been initialized
• Unauthorized — sender is not the owner
• InvalidPublicKey — publicKey is zero or not a valid Ed25519 key
• PublicKeyAlreadyExists — the public key is already registered
• InvalidValidatorAddress — validatorAddress is zero
• AddressAlreadyHasValidator — the address belongs to an active validator
• NotIpPort / NotIp — endpoints fail validation
• IngressAlreadyExists — the new ingress is already in use
• InvalidSignature — signature verification fails

pub fn deactivate_validator( &mut self, sender: Address, call: deactivateValidatorCall, ) -> Result<()>

Deactivates a validator by setting its deactivatedAtHeight to the current block height (owner or the validator itself).

The validator’s entry remains in storage for historical queries and its public key stays reserved forever. The ingress IP is freed for reuse.

Does NOT require initialization — can be called during the migration window.

Uses swap-and-pop on active_indices for O(1) removal.

Errors

• ValidatorNotFound — idx is out of bounds
• ValidatorAlreadyDeleted — the validator is already deactivated
• Unauthorized — sender is neither the owner nor the validator

pub fn transfer_ownership( &mut self, sender: Address, call: transferOwnershipCall, ) -> Result<()>

Transfers ownership of the contract to a new address (owner only).

Errors

• InvalidOwner — newOwner is address(0)
• Unauthorized — sender is not the owner
• NotInitialized — the contract has not been initialized

pub fn set_network_identity_rotation_epoch( &mut self, sender: Address, call: setNetworkIdentityRotationEpochCall, ) -> Result<()>

Sets the epoch at which a rotation of the network identity will be triggered.

If E is ahead of the network’s current epoch, the network will perform a Distribute-Key-Generation (DKG) ceremony to rotate its identity at the new epoch E.

• If the DKG ceremony is successful, then epoch E+1 will run with a new network identity.
• If E is not ahead of the network epoch this value is ignored.

pub fn rotate_validator( &mut self, sender: Address, call: rotateValidatorCall, ) -> Result<()>

Rotates a validator to a new identity (owner or the validator itself).

Atomically:

1. Appends a deactivated snapshot of the old identity to the tail of validators
2. Overwrites the slot in-place with new pubkey, endpoints, and addedAtHeight = now

The validator’s global index, active_idx, address_to_index pointer, and position in active_indices are all preserved — only pubkey_to_index is updated (old key -> snapshot, new key -> original slot).

Requires a valid Ed25519 signature, using the VALIDATOR_NS_ROTATE namespace, over keccak256(chainId || contractAddr || validatorAddr || len(ingress) || ingress || len(egress) || egress) which proves that the caller controls the private key corresponding to publicKey.

Errors

• ValidatorNotFound / ValidatorAlreadyDeleted — idx is invalid
• NotInitialized / Unauthorized — auth failure
• InvalidPublicKey / PublicKeyAlreadyExists — the new key is invalid
• NotIpPort / NotIp / IngressAlreadyExists — endpoint validation failure
• InvalidSignature — signature verification fails

pub fn set_fee_recipient( &mut self, sender: Address, call: setFeeRecipientCall, ) -> Result<()>

Updates the fee recipient address for a validator (owner or the validator itself).

Errors

• NotInitialized — the contract has not been initialized
• ValidatorNotFound / ValidatorAlreadyDeleted — idx is invalid
• Unauthorized — sender is neither the owner nor the validator

pub fn set_ip_addresses( &mut self, sender: Address, call: setIpAddressesCall, ) -> Result<()>

Updates a validator’s ingress and egress addresses (owner or the validator itself).

Errors

• NotInitialized — the contract has not been initialized
• ValidatorNotFound / ValidatorAlreadyDeleted — idx is invalid
• Unauthorized — sender is neither the owner nor the validator
• NotIpPort / NotIp — the new endpoints fail validation
• IngressAlreadyExists — the new ingress is already in use.

pub fn transfer_validator_ownership( &mut self, sender: Address, call: transferValidatorOwnershipCall, ) -> Result<()>

Transfers a validator entry to a new address (owner or the validator itself).

Updates the validator’s address in the lookup maps: deletes the old address_to_index entry and creates a new one pointing to the same slot.

Errors

• ValidatorNotFound / ValidatorAlreadyDeleted — idx is invalid
• NotInitialized / Unauthorized — auth failure
• InvalidValidatorAddress — newAddress is zero
• AddressAlreadyHasValidator — newAddress belongs to an active validator

fn require_migration_owner(&mut self, caller: Address) -> Result<Config>

On the very first migration call the V2 owner is still zero, so we copy it from V1 before checking authorization. Returns the (potentially updated) config for reuse.

Errors

• AlreadyInitialized — V2 is already initialized
• Unauthorized — caller is not the owner (after copying from V1 if needed)

pub fn migrate_validator( &mut self, sender: Address, call: migrateValidatorCall, ) -> Result<()>

Migrates a single validator from V1 to V2 (owner only).

Must be called once per V1 validator, in reverse index order. On the first call, copies the owner from V1 if V2’s owner is address(0).

Validators are skipped (not reverted) when:

• The public key is not a valid Ed25519 key
• The egress address cannot be parsed as a SocketAddr
• The public key or ingress IP is a duplicate of an already-migrated entry

Active V1 validators get deactivatedAtHeight = 0; inactive ones get deactivatedAtHeight = block.number.

Errors

• Unauthorized — sender is not the owner
• AlreadyInitialized — V2 is already initialized
• InvalidMigrationIndex — idx is out of order

pub fn initialize_if_migrated(&mut self, sender: Address) -> Result<()>

Finalizes V1 -> V2 migration by setting is_init = true.

Should only be called after all V1 validators have been migrated via migrate_validator. Copies nextDkgCeremony from V1. After this call, the CL reads from V2 instead of V1 and all mutating functions are unlocked.

Errors

• Unauthorized — sender is not the owner
• AlreadyInitialized — V2 is already initialized
• MigrationNotComplete — validator_count + skipped < v1.validator_count

impl ValidatorConfigV2

pub fn create_precompile(cfg: &CfgEnv<TempoHardfork>) -> DynPrecompile

Creates the EVM precompile for this type.

Trait Implementations

impl ContractStorage for ValidatorConfigV2

fn address(&self) -> Address

Contract address.

fn storage(&self) -> &StorageCtx

Contract storage accessor.

fn storage_mut(&mut self) -> &mut StorageCtx

Contract storage mutable accessor.

fn is_initialized(&self) -> Result<bool>

Returns true if the contract has been initialized (has bytecode deployed).

impl Default for ValidatorConfigV2

fn default() -> Self

Returns the “default value” for a type.

impl Precompile for ValidatorConfigV2

fn call(&mut self, calldata: &[u8], msg_sender: Address) -> PrecompileResult

Dispatches an EVM call to this precompile.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 1024 bytes