Struct WasmShardedNotesTree 

pub struct WasmShardedNotesTree { /* private fields */ }

Rust-owned sharded notes tree. Field elements cross this bulk boundary as canonical packed 32-byte big-endian values, avoiding one JS↔wasm call and one decimal-string allocation per Poseidon node.

Implementations

impl WasmShardedNotesTree

pub fn new( depth: u32, shard_height: u32, ) -> Result<WasmShardedNotesTree, JsError>

pub fn restore(snapshot: &[u8]) -> Result<WasmShardedNotesTree, JsError>

Restore a versioned snapshot previously returned by Self::snapshot.

pub fn restore_parts( depth: u32, shard_height: u32, packed_completed_roots: &[u8], packed_live_leaves: &[u8], ) -> Result<WasmShardedNotesTree, JsError>

Restore public tree state from storage tables before account-scoped witnesses are marked/adopted.

pub fn append(&mut self, note_id: &[u8]) -> Result<(), JsError>

Append one canonical 32-byte note commitment.

pub fn append_many(&mut self, packed_note_ids: &[u8]) -> Result<(), JsError>

Append N concatenated 32-byte note commitments in one wasm call.

pub fn mark_owned( &mut self, note_id: &[u8], leaf_index: u32, ) -> Result<(), JsError>

pub fn unmark_owned(&mut self, note_id: &[u8]) -> Result<bool, JsError>

pub fn adopt_frozen_witness( &mut self, note_id: &[u8], leaf_index: u32, packed_siblings: &[u8], ) -> Result<(), JsError>

pub fn witness(&self, note_id: &[u8]) -> Result<WasmInclusionProof, JsError>

pub fn rewind_live_to(&mut self, leaf_count: u32) -> Result<Vec<u8>, JsError>

Rewind only within the current live shard. Restore an earlier persisted snapshot when a rollback crosses a completed-shard boundary.

pub fn root(&self) -> Vec<u8>

pub fn depth(&self) -> u32

pub fn shard_height(&self) -> u32

pub fn shard_size(&self) -> u32

pub fn leaf_count(&self) -> u32

pub fn completed_shard_count(&self) -> u32

pub fn owned_note_count(&self) -> u32

pub fn completed_shard_roots(&self) -> Vec<u8>

pub fn completed_shard_root(&self, shard_index: u32) -> Result<Vec<u8>, JsError>

pub fn live_leaves(&self) -> Vec<u8>

pub fn drain_dirty_owned_notes(&mut self) -> Vec<WasmOwnedNoteWitness>

pub fn owned_notes(&self) -> Vec<WasmOwnedNoteWitness>

pub fn snapshot(&self) -> Result<Vec<u8>, JsError>

Deterministic versioned binary state. Storage layers should associate chain/deployment/block metadata with this opaque tree blob.

Trait Implementations

impl From<WasmShardedNotesTree> for JsValue

fn from(value: WasmShardedNotesTree) -> Self

Converts to this type from the input type.

impl FromWasmAbi for WasmShardedNotesTree

type Abi = WasmPtr<WasmRefCell<WasmShardedNotesTree>>

The Wasm ABI type that this converts from when coming back out from the ABI boundary.

unsafe fn from_abi(js: Self::Abi) -> Self

Recover a Self from Self::Abi.

impl IntoWasmAbi for WasmShardedNotesTree

type Abi = WasmPtr<WasmRefCell<WasmShardedNotesTree>>

The Wasm ABI type that this converts into when crossing the ABI boundary.

fn into_abi(self) -> Self::Abi

Convert self into Self::Abi so that it can be sent across the wasm ABI boundary.

impl LongRefFromWasmAbi for WasmShardedNotesTree

type Abi = WasmPtr<WasmRefCell<WasmShardedNotesTree>>

Same as RefFromWasmAbi::Abi

type Anchor = RcRef<WasmShardedNotesTree>

Same as RefFromWasmAbi::Anchor

unsafe fn long_ref_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi

impl OptionFromWasmAbi for WasmShardedNotesTree

fn is_none(abi: &Self::Abi) -> bool

Tests whether the argument is a “none” instance. If so it will be deserialized as None, and otherwise it will be passed to FromWasmAbi.

impl OptionIntoWasmAbi for WasmShardedNotesTree

fn none() -> Self::Abi

Returns an ABI instance indicating “none”, which JS will interpret as the None branch of this option.

impl RefFromWasmAbi for WasmShardedNotesTree

type Abi = WasmPtr<WasmRefCell<WasmShardedNotesTree>>

The Wasm ABI type references to Self are recovered from.

type Anchor = RcRef<WasmShardedNotesTree>

The type that holds the reference to Self for the duration of the invocation of the function that has an &Self parameter. This is required to ensure that the lifetimes don’t persist beyond one function call, and so that they remain anonymous.

unsafe fn ref_from_abi(js: Self::Abi) -> Self::Anchor

Recover a Self::Anchor from Self::Abi.

impl RefMutFromWasmAbi for WasmShardedNotesTree

type Abi = WasmPtr<WasmRefCell<WasmShardedNotesTree>>

Same as RefFromWasmAbi::Abi

type Anchor = RcRefMut<WasmShardedNotesTree>

Same as RefFromWasmAbi::Anchor

unsafe fn ref_mut_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi

impl SupportsConstructor for WasmShardedNotesTree

impl SupportsInstanceProperty for WasmShardedNotesTree

impl SupportsStaticProperty for WasmShardedNotesTree

impl TryFromJsValue for WasmShardedNotesTree

fn try_from_js_value(value: JsValue) -> Result<Self, JsValue>

Performs the conversion.

fn try_from_js_value_ref(value: &JsValue) -> Option<Self>

Performs the conversion.

impl VectorFromWasmAbi for WasmShardedNotesTree

type Abi = <Box<[JsValue]> as FromWasmAbi>::Abi

unsafe fn vector_from_abi(js: Self::Abi) -> Box<[WasmShardedNotesTree]>

impl VectorIntoWasmAbi for WasmShardedNotesTree

type Abi = <Box<[JsValue]> as IntoWasmAbi>::Abi

fn vector_into_abi(vector: Box<[WasmShardedNotesTree]>) -> Self::Abi

impl WasmDescribe for WasmShardedNotesTree

fn describe()

impl WasmDescribeVector for WasmShardedNotesTree

fn describe_vector()