Struct MerklePaymentCandidateNode 

pub struct MerklePaymentCandidateNode {
    pub pub_key: Vec<u8>,
    pub price: Uint<256, 4>,
    pub reward_address: Address,
    pub merkle_payment_timestamp: u64,
    pub signature: Vec<u8>,
    pub committed_key_count: u32,
    pub commitment_pin: Option<[u8; 32]>,
}

A node’s signed quote for potential reward eligibility.

Nodes create this in response to a client’s quote request. The pub_key field stores the raw ML-DSA-65 public key bytes, and signature stores the ML-DSA-65 signature over bytes_to_sign().

Fields

pub_key: Vec<u8>

Node’s public key bytes (ML-DSA-65)

price: Uint<256, 4>

Node-calculated price for storing data

reward_address: Address

Node’s Ethereum address for payment

merkle_payment_timestamp: u64

Quote timestamp (provided by the client)

signature: Vec<u8>

Signature over bytes_to_sign

committed_key_count: u32

ADR-0004: the number of keys in the storage commitment this price was derived from. 0 for a baseline (no-commitment) quote. Tail-placed with #[serde(default)] so an old-format candidate (lacking these fields) decodes as 0/None rather than misaligning onto signature.

commitment_pin: Option<[u8; 32]>

ADR-0004: the pin (commitment hash) of the storage commitment this price was derived from. None for a baseline quote.

Implementations

impl MerklePaymentCandidateNode

pub fn bytes_to_sign( price: &Uint<256, 4>, reward_address: &Address, timestamp: u64, committed_key_count: u32, commitment_pin: &Option<[u8; 32]>, ) -> Vec<u8>

Get the bytes to sign.

ADR-0004: the commitment binding (committed_key_count, commitment_pin) is appended to the signed payload so the per-node ML-DSA-65 signature covers it — making a count/pin mismatch genuine “two artifacts signed by the same key” evidence. The pin is tagged (0 = none, 1 = present) so a baseline candidate can never collide with one pinning an all-zero hash. This is a coordinated breaking change: ant-protocol must verify the same 5-field message (its verify_merkle_candidate_signature reconstructs this exact payload).

Trait Implementations

impl Clone for MerklePaymentCandidateNode

fn clone(&self) -> MerklePaymentCandidateNode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MerklePaymentCandidateNode

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MerklePaymentCandidateNode

fn deserialize<__D>( __deserializer: __D, ) -> Result<MerklePaymentCandidateNode, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for MerklePaymentCandidateNode

impl PartialEq for MerklePaymentCandidateNode

fn eq(&self, other: &MerklePaymentCandidateNode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for MerklePaymentCandidateNode

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MerklePaymentCandidateNode