Struct CredentialSlot 

pub struct CredentialSlot { /* private fields */ }

A delegated fetch’s voucher credential, which the application can swap at any time. Clones share one slot.

A source provider reads Self::current when it builds a lane, and puts its key and capability in the lane’s PoolContext. After a Self::swap, the fetch ends every live lane on the old key at its next voucher boundary, paid for what it received, and opens new lanes under the new credential. A registered signer’s terms are write-once on chain, so a new capability names a new signer key.

Implementations

impl CredentialSlot

pub fn new( signer: Arc<PrivateKeySigner>, capability: SignedCapability, ) -> Result<Self, CredentialMismatch>

A slot that holds capability for signer, with the CREDENTIAL_SWAP_WAIT wait.

Errors

CredentialMismatch when the capability names another signer.

pub fn with_swap_wait(self, wait: Duration) -> Self

Wait wait for a swap at the exhausted candidate set. The slot and every clone of it share the wait.

pub fn record_spend(&self, signer: Address, spent: U256)

Record that earlier fetches signed spent micro-USDC of vouchers under signer, across every lane the application’s local records hold for it, at any provider. The fetch counts it toward the capability’s spend for the running-low signal and the FundingNeeded cause, on top of what its own lanes sign past their recorded priors. One key’s record is held at a time; a key with no record counts from zero.

pub fn swap( &self, signer: Arc<PrivateKeySigner>, capability: SignedCapability, ) -> Result<(), CredentialMismatch>

Put capability for signer in the slot. Every fetch that holds the slot retires its lanes on the old key and goes on under this one.

Errors

CredentialMismatch when the capability names another signer. The slot keeps its credential.

pub fn current(&self) -> Credential

The credential a new lane signs under.

pub fn generation(&self) -> u64

How many swaps the slot has taken.

pub fn pool_id(&self) -> B256

The pool the current capability draws from.

pub fn swap_wait(&self) -> Duration

How long a fetch at the exhausted candidate set waits for a swap.

pub fn funding_events(&self) -> Receiver<Option<FundingEvent>>

The fetch’s funding signal: the latest FundingEvent, or None while the credential covers the work. The value changes when the signal changes.

Trait Implementations

impl Clone for CredentialSlot

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CredentialSlot

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

Formats the value using the given formatter.