pub struct SourceChain<AuthorDb = DbWrite<DbKindAuthored>, DhtDb = DbWrite<DbKindDht>> { /* private fields */ }

Implementations§

source§

impl SourceChain

Writable functions for a source chain with write access.

source

pub async fn unlock_chain(&self) -> SourceChainResult<()>

source

pub async fn accept_countersigning_preflight_request( &self, preflight_request: PreflightRequest, agent_index: u8 ) -> SourceChainResult<CounterSigningAgentState>

source

pub async fn put_with_action( &self, action: Action, maybe_entry: Option<Entry>, chain_top_ordering: ChainTopOrdering ) -> SourceChainResult<ActionHash>

source

pub async fn put_countersigned( &self, entry: Entry, chain_top_ordering: ChainTopOrdering, weight: EntryRateWeight ) -> SourceChainResult<ActionHash>

source

pub async fn put<U: ActionUnweighed<Weight = ()>, B: ActionBuilder<U>>( &self, action_builder: B, maybe_entry: Option<Entry>, chain_top_ordering: ChainTopOrdering ) -> SourceChainResult<ActionHash>

Put a new record at the end of the source chain, using a ActionBuilder for an action type which has no weight data. If needing to put an action with weight data, use SourceChain::put_weighed instead.

source

pub async fn put_weighed<W, U: ActionUnweighed<Weight = W>, B: ActionBuilder<U>>( &self, action_builder: B, maybe_entry: Option<Entry>, chain_top_ordering: ChainTopOrdering, weight: W ) -> SourceChainResult<ActionHash>

Put a new record at the end of the source chain, using a ActionBuilder and the specified weight for rate limiting.

source

pub async fn put_weightless<W: Default, U: ActionUnweighed<Weight = W>, B: ActionBuilder<U>>( &self, action_builder: B, maybe_entry: Option<Entry>, chain_top_ordering: ChainTopOrdering ) -> SourceChainResult<ActionHash>

source

pub fn flush<'life0, 'life_self, 'async_recursion>( &'life_self self, network: &'life0 (dyn HolochainP2pDnaT + Send + Sync) ) -> Pin<Box<dyn Future<Output = SourceChainResult<Vec<SignedActionHashed>>> + Send + 'async_recursion>>where 'life0: 'async_recursion, 'life_self: 'async_recursion,

source§

impl<AuthorDb, DhtDb> SourceChain<AuthorDb, DhtDb>where AuthorDb: ReadAccess<DbKindAuthored>, DhtDb: ReadAccess<DbKindDht>,

source

pub async fn new( vault: AuthorDb, dht_db: DhtDb, dht_db_cache: DhtDbQueryCache, keystore: MetaLairClient, author: AgentPubKey ) -> SourceChainResult<Self>

source

pub async fn raw_empty( vault: AuthorDb, dht_db: DhtDb, dht_db_cache: DhtDbQueryCache, keystore: MetaLairClient, author: AgentPubKey ) -> SourceChainResult<Self>

Create a source chain with a blank chain head. You probably don’t want this. This type is only useful for when a source chain really needs to be constructed before genesis runs.

source

pub fn public_only(&mut self)

source

pub fn keystore(&self) -> &MetaLairClient

source

pub fn author_db(&self) -> &AuthorDb

source

pub fn snapshot(&self) -> SourceChainResult<Scratch>

Take a snapshot of the scratch space that will not remain in sync with future updates.

source

pub fn scratch(&self) -> SyncScratch

source

pub fn agent_pubkey(&self) -> &AgentPubKey

source

pub fn to_agent_pubkey(&self) -> Arc<AgentPubKey>

source

pub fn cell_id(&self) -> CellId

source

pub fn scratch_records(&self) -> SourceChainResult<Vec<Record>>

This has to clone all the data because we can’t return references to constructed data.

source

pub async fn zomes_initialized(&self) -> SourceChainResult<bool>

source

pub fn set_zomes_initialized(&self, value: bool)

source

pub fn is_empty(&self) -> SourceChainResult<bool>

source

pub fn persisted_head_info(&self) -> Option<HeadInfo>

Accessor for the chain head that will be used at flush time to check the “as at” for ordering integrity etc.

source

pub fn chain_head(&self) -> SourceChainResult<Option<HeadInfo>>

source

pub fn chain_head_nonempty(&self) -> SourceChainResult<HeadInfo>

source

pub fn len(&self) -> SourceChainResult<u32>

source

pub async fn valid_cap_grant( &self, check_function: GrantedFunction, check_agent: AgentPubKey, check_secret: Option<CapSecret> ) -> SourceChainResult<Option<CapGrant>>

source

pub async fn query(&self, query: QueryFilter) -> SourceChainResult<Vec<Record>>

Query Actions in the source chain. This returns a Vec rather than an iterator because it is intended to be used by the query host function, which crosses the wasm boundary

source

pub async fn is_chain_locked(&self, lock: Vec<u8>) -> SourceChainResult<bool>

source

pub fn countersigning_op(&self) -> SourceChainResult<Option<DhtOp>>

If there is a countersigning session get the StoreEntry op to send to the entry authorities.

Trait Implementations§

source§

impl<AuthorDb: Clone, DhtDb: Clone> Clone for SourceChain<AuthorDb, DhtDb>

source§

fn clone(&self) -> SourceChain<AuthorDb, DhtDb>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl From<SourceChain<DbWrite<DbKindAuthored>, DbWrite<DbKindDht>>> for SourceChainRead

source§

fn from(chain: SourceChain) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

§

impl<AuthorDb = DbWrite<DbKindAuthored>, DhtDb = DbWrite<DbKindDht>> !RefUnwindSafe for SourceChain<AuthorDb, DhtDb>

§

impl<AuthorDb, DhtDb> Send for SourceChain<AuthorDb, DhtDb>where AuthorDb: Send, DhtDb: Send,

§

impl<AuthorDb, DhtDb> Sync for SourceChain<AuthorDb, DhtDb>where AuthorDb: Sync, DhtDb: Sync,

§

impl<AuthorDb, DhtDb> Unpin for SourceChain<AuthorDb, DhtDb>where AuthorDb: Unpin, DhtDb: Unpin,

§

impl<AuthorDb = DbWrite<DbKindAuthored>, DhtDb = DbWrite<DbKindDht>> !UnwindSafe for SourceChain<AuthorDb, DhtDb>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
§

impl<T> Any for Twhere T: Any,

§

fn into_any(self: Box<T, Global>) -> Box<dyn Any, Global>

§

fn into_any_rc(self: Rc<T, Global>) -> Rc<dyn Any, Global>

§

fn type_name(&self) -> &'static str

§

impl<T> AnySync for Twhere T: Any + Send + Sync,

§

fn into_any_arc(self: Arc<T, Global>) -> Arc<dyn Any + Sync + Send, Global>

§

impl<T> ArchivePointee for T

§

type ArchivedMetadata = ()

The archived version of the pointer metadata for this type.
§

fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata ) -> <T as Pointee>::Metadata

Converts some archived metadata to the pointer metadata for itself.
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<F, W, T, D> Deserialize<With<T, W>, D> for Fwhere W: DeserializeWith<F, T, D>, D: Fallible + ?Sized, F: ?Sized,

§

fn deserialize( &self, deserializer: &mut D ) -> Result<With<T, W>, <D as Fallible>::Error>

Deserializes using the given deserializer
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> FutureExt for T

§

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
§

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more
source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Pointable for T

§

const ALIGN: usize = mem::align_of::<T>()

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> Pointee for T

§

type Metadata = ()

The type for metadata in pointers and references to Self.
source§

impl<T> Same<T> for T

§

type Output = T

Should always be Self
§

impl<SS, SP> SupersetOf<SS> for SPwhere SS: SubsetOf<SP>,

§

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more
§

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).
§

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.
§

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.
source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> Upcastable for Twhere T: Any + Send + Sync + 'static,

§

fn upcast_any_ref(&self) -> &(dyn Any + 'static)

upcast ref
§

fn upcast_any_mut(&mut self) -> &mut (dyn Any + 'static)

upcast mut ref
§

fn upcast_any_box(self: Box<T, Global>) -> Box<dyn Any, Global>

upcast boxed dyn
§

impl<V, T> VZip<V> for Twhere V: MultiLane<T>,

§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more