Struct Tangle 

pub struct Tangle<B> { /* private fields */ }

A Tangle wrapper designed to encapsulate milestone state.

Implementations

impl<B: StorageBackend> Tangle<B>

pub fn new(config: TangleConfig, storage: ResourceHandle<B>) -> Self

Create a new Tangle instance with the given configuration and storage handle.

pub async fn shutdown(self)

Shut down the tangle, terminating any and all worker tasks.

pub fn config(&self) -> &TangleConfig

Get the configuration of this tangle.

pub async fn insert( &self, message: Message, message_id: MessageId, metadata: MessageMetadata, ) -> Option<MessageRef>

Insert a message into the tangle.

pub async fn add_milestone(&self, idx: MilestoneIndex, milestone: Milestone)

Add a milestone to the tangle.

pub async fn remove_milestone(&self, index: MilestoneIndex)

Remove a milestone from the tangle.

pub async fn get_milestone(&self, index: MilestoneIndex) -> Option<Milestone>

Get the milestone from the tangle that corresponds to the given milestone index.

pub async fn get_milestone_message( &self, index: MilestoneIndex, ) -> Option<MessageRef>

Get the message associated with the given milestone index from the tangle.

pub async fn get_milestone_message_id( &self, index: MilestoneIndex, ) -> Option<MessageId>

Get the message ID associated with the given milestone index from the tangle.

pub async fn contains_milestone(&self, idx: MilestoneIndex) -> bool

Return whether the tangle contains the given milestone index.

pub fn get_latest_milestone_index(&self) -> MilestoneIndex

Get the index of the latest milestone.

pub fn update_latest_milestone_index(&self, new_index: MilestoneIndex)

Update the index of the lastest milestone.

pub fn get_solid_milestone_index(&self) -> MilestoneIndex

Get the latest solid milestone index.

pub fn update_solid_milestone_index(&self, new_index: MilestoneIndex)

Update the latest solid milestone index.

pub fn get_confirmed_milestone_index(&self) -> MilestoneIndex

Get the latest confirmed milestone index.

pub fn update_confirmed_milestone_index(&self, new_index: MilestoneIndex)

Update the latest confirmed milestone index.

pub fn get_snapshot_index(&self) -> MilestoneIndex

Get the snapshot index.

pub fn update_snapshot_index(&self, new_index: MilestoneIndex)

Update the snapshot index.

pub fn get_pruning_index(&self) -> MilestoneIndex

Get the pruning index.

pub fn update_pruning_index(&self, new_index: MilestoneIndex)

Update the pruning index.

pub fn get_entry_point_index(&self) -> MilestoneIndex

Get the entry point index.

pub fn update_entry_point_index(&self, new_index: MilestoneIndex)

Update the entry point index.

pub fn is_synced(&self) -> bool

Return whether the tangle is within the default sync threshold.

pub fn get_sync_threshold(&self) -> u32

Get the number of milestones until the tangle is synced.

pub fn is_synced_threshold(&self, threshold: u32) -> bool

Return whether the tangle is within the given sync threshold.

pub fn is_confirmed(&self) -> bool

Return whether the tangle is fully confirmed.

pub fn is_confirmed_threshold(&self, threshold: u32) -> bool

Return whether the tangle is within the given confirmation threshold.

pub async fn get_solid_entry_point_index( &self, sep: &SolidEntryPoint, ) -> Option<MilestoneIndex>

Get the milestone index associated with the given solid entry point.

pub async fn add_solid_entry_point( &self, sep: SolidEntryPoint, index: MilestoneIndex, )

Add the given solid entry point to the given milestone index.

pub async fn get_solid_entry_points( &self, ) -> HashMap<SolidEntryPoint, MilestoneIndex>

Returns a copy of all solid entry points.

pub async fn remove_solid_entry_point(&self, sep: &SolidEntryPoint)

Removes the given solid entry point from the set of solid entry points.

pub async fn clear_solid_entry_points(&self)

Clear all solid entry points.

pub async fn replace_solid_entry_points( &self, new_seps: impl IntoIterator<Item = (SolidEntryPoint, MilestoneIndex)>, )

Replaces all solid entry points.

pub async fn is_solid_entry_point(&self, id: &MessageId) -> bool

Returns whether the message associated with given solid entry point is a solid entry point.

pub async fn is_solid_message(&self, id: &MessageId) -> bool

Returns whether the message associated with the given message ID is solid.

pub async fn omrsi(&self, id: &MessageId) -> Option<IndexId>

Get the oldest milestone root snapshot index.

pub async fn ymrsi(&self, id: &MessageId) -> Option<IndexId>

Get the youngest milestone root snapshot index.

pub async fn insert_tip(&self, message_id: MessageId, parents: Vec<MessageId>)

Insert the given message ID and parents as a tip.

pub async fn update_tip_scores(&self)

Update tip scores.

pub async fn get_messages_to_approve(&self) -> Option<Vec<MessageId>>

Return messages that require approving.

pub async fn reduce_tips(&self)

Reduce tips.

pub async fn non_lazy_tips_num(&self) -> usize

Return the number of non-lazy tips.

pub async fn get(&self, message_id: &MessageId) -> Option<MessageRef>

Get the data of a vertex associated with the given message_id.

pub async fn contains(&self, message_id: &MessageId) -> bool

Returns whether the message is stored in the Tangle.

pub async fn get_metadata( &self, message_id: &MessageId, ) -> Option<MessageMetadata>

Get the metadata of a vertex associated with the given message_id.

pub async fn get_vertex( &self, message_id: &MessageId, ) -> Option<impl Deref<Target = Vertex> + '_>

Get the metadata of a vertex associated with the given message_id.

pub async fn update_metadata<R, Update>( &self, message_id: &MessageId, update: Update, ) -> Option<R>

where Update: FnOnce(&mut MessageMetadata) -> R,

Updates the metadata of a vertex.

pub async fn get_children( &self, message_id: &MessageId, ) -> Option<Vec<MessageId>>

Returns the children of a vertex, if we know about them.