Struct DriveAbciValidationConstants 

pub struct DriveAbciValidationConstants {
    pub maximum_vote_polls_to_process: u16,
    pub maximum_contenders_to_consider: u16,
    pub minimum_pool_notes_for_outgoing: u64,
    pub shielded_anchor_retention_blocks: u64,
    pub shielded_anchor_pruning_interval: u64,
    pub shielded_proof_verification_fee: u64,
    pub shielded_per_action_processing_fee: u64,
    pub shielded_storage_bytes_per_action: u64,
    pub shielded_implicit_fee_cap: u64,
    pub shielded_identity_create_denominations: &'static [u64],
}

Fields

maximum_vote_polls_to_process: u16

maximum_contenders_to_consider: u16

minimum_pool_notes_for_outgoing: u64

Minimum number of encrypted notes in the shielded pool before outgoing transitions (Unshield, ShieldedWithdrawal) are allowed. This ensures a sufficient anonymity set before funds can leave the pool.

shielded_anchor_retention_blocks: u64

Number of blocks of anchors to retain. Anchors older than this are pruned at the end of each block. Clients must use an anchor no older than this many blocks when building shielded transactions.

shielded_anchor_pruning_interval: u64

Anchor pruning is only performed every N blocks to avoid unnecessary GroveDB work on every block. Must evenly divide shielded_anchor_retention_blocks.

shielded_proof_verification_fee: u64

Per-bundle fee (in credits) for Halo 2 ZK proof verification. Benchmarked at ~30x per-action signature verification cost.

shielded_per_action_processing_fee: u64

Per-action fee (in credits) for processing: RedPallas spend auth signature verification, nullifier duplicate check, and tree insertion.

shielded_storage_bytes_per_action: u64

Per-action long-term storage allowance, in bytes, priced at the full storage rate (disk + processing credits per byte) by compute_minimum_shielded_fee — the flat storage component every pool-paid shielded transition carries per action.

The physical payload is 344 bytes: 312 in the BulkAppendTree — 32 (cmx) + 32 (rho) + 32 (cv_net, stored unencrypted for OVK recovery) + 216 (the DashMemo Orchard TransmittedNoteCiphertext: epk(32) || enc_ciphertext(104) || out_ciphertext(80)) — plus 32 in the nullifier tree. The allowance may exceed that to cover what the metering actually charges per append under the GroveVersion in force (Merk node framing, dense path records, the amortized chunk-blob framing).

shielded_implicit_fee_cap: u64

Maximum surplus (in credits) that a ShieldFromAssetLock may implicitly donate to the fee pools when no surplus_output address is set. Above this cap the transition is rejected so a client cannot accidentally forfeit a large asset-lock remainder. 20,000,000,000 credits = 0.2 Dash.

shielded_identity_create_denominations: &'static [u64]

Allowed exit denominations (in credits) for IdentityCreateFromShieldedPool. 0.1, 0.3, 0.5, 1.0 DASH = {10, 30, 50, 100} × 10^9 credits. The exit amount is restricted to this small fixed set so every identity-creation exit of a given size is indistinguishable on-chain, maximizing the anonymity set (mirroring the exact-fee uniformity already enforced for ShieldedTransfer). Empty pre-v12 so the transition is gated off until the shielded family activates.

Implementations

impl DriveAbciValidationConstants

pub fn max_retained_shielded_anchors(&self) -> Option<u64>

Maximum number of shielded anchors the retention policy can keep on disk at once.

This is a corollary of the anchor recording and pruning algorithm, and must stay in sync with it:

• at most one anchor is recorded per block (Drive::record_anchor_if_changed only writes when the pool root changes), and
• pruning removes every anchor older than shielded_anchor_retention_blocks on each shielded_anchor_pruning_interval boundary (Platform::prune_shielded_pool_anchors_v0).

Between two prune boundaries the retained set therefore spans at most shielded_anchor_retention_blocks + shielded_anchor_pruning_interval distinct heights, so that sum is the worst-case count.

Callers that must bound work against the retained set (e.g. the unpaginated V0 shielded-anchors query) should derive their limits from this value rather than re-deriving the bound from the raw constants, so they stay coupled to the pruning algorithm. Returns None only if the configured policy overflows u64.

Trait Implementations

impl Clone for DriveAbciValidationConstants

fn clone(&self) -> DriveAbciValidationConstants

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DriveAbciValidationConstants

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

Formats the value using the given formatter.

impl Default for DriveAbciValidationConstants

fn default() -> DriveAbciValidationConstants

Returns the “default value” for a type.