Struct PswapLineageRecord 

pub struct PswapLineageRecord {
    pub original_note_id: NoteId,
    pub current_tip_note_id: NoteId,
    pub current_depth: u32,
    pub remaining_offered: AssetAmount,
    pub remaining_requested: AssetAmount,
    pub state: PswapLineageState,
    /* private fields */
}

Persistent record of one PSWAP order’s chain state. The order id and creator are mirrored here so the common read paths — keying, filtering — stay lookup-free. Only the remaining amounts are stored; the asset pair’s faucets, the script/recipient, and the note_type all live on the depth-0 note, fetched on demand from output_notes by original_note_id (see store::get_original_pswap) when reconstruction, a depth-0 reclaim, or asset-pair-tag derivation needs them.

Fields

original_note_id: NoteId

Fetch handle for the depth-0 PSWAP note in output_notes. Stable for the order’s lifetime; distinct from current_tip_note_id, which advances each round.

current_tip_note_id: NoteId

Current tip’s note id. Equals original_note_id at depth 0; otherwise a remainder we didn’t originate.

current_depth: u32

0 for the original tip; +1 per round. Matches PswapNoteAttachment::depth().

remaining_offered: AssetAmount

Remaining offered amount. The order’s offered faucet is chain-invariant and recovered from the depth-0 note when needed (e.g. for tag derivation).

remaining_requested: AssetAmount

Remaining requested amount (requested faucet recovered the same way).

state: PswapLineageState

Implementations

impl PswapLineageRecord

pub fn new_depth_zero( original_note_id: NoteId, pswap: &PswapNote, ) -> PswapLineageRecord

Builds the depth-0 record for a PSWAP the wallet has just emitted. Mirrors the order id and creator off the note and seeds the mutable tip state: the tip is the original note, depth is 0, and remaining_* equal the initial offered/requested amounts.

pub fn order_id(&self) -> Felt

Stable identifier (== the depth-0 note’s serial[1]) shared by every note in the chain.

pub fn creator_account_id(&self) -> AccountId

Account that created the order (recipient of every payback).

Trait Implementations

impl Clone for PswapLineageRecord

fn clone(&self) -> PswapLineageRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PswapLineageRecord

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

Formats the value using the given formatter.

impl Deserializable for PswapLineageRecord

fn read_from<R>( source: &mut R, ) -> Result<PswapLineageRecord, DeserializationError>

where R: ByteReader,

Reads a sequence of bytes from the provided source, attempts to deserialize these bytes into Self, and returns the result.

fn min_serialized_size() -> usize

Returns the minimum serialized size for one instance of this type.

fn read_from_bytes(bytes: &[u8]) -> Result<Self, DeserializationError>

Attempts to deserialize the provided bytes into Self and returns the result.

fn read_from_bytes_with_budget( bytes: &[u8], budget: usize, ) -> Result<Self, DeserializationError>

Deserializes Self from bytes with a byte budget limit.

impl Serializable for PswapLineageRecord

Encodes the record’s fields in declaration order: the original_note_id fetch handle, the mirrored order id and creator, then the mutable tip state. Only the remaining amounts are written — the faucets and full note live on the depth-0 note, recovered via original_note_id when needed.

fn write_into<W>(&self, target: &mut W)

where W: ByteWriter,

Serializes self into bytes and writes these bytes into the target.

fn to_bytes(&self) -> Vec<u8>

Serializes self into a vector of bytes.

fn get_size_hint(&self) -> usize

Returns an estimate of how many bytes are needed to represent self.