Struct ActorRuntime 

pub struct ActorRuntime<S: Syscalls, BS: Blockstore> {
    pub syscalls: S,
    pub blockstore: BS,
}

ActorRuntime provides access to system resources via Syscalls and the Blockstore.

It provides higher level utilities than raw syscalls for actors to use to interact with the IPLD layer and the FVM runtime (e.g. messaging other actors).

Fields

syscalls: S

blockstore: BS

Implementations

impl<S: Syscalls + Clone, BS: Blockstore + Clone> ActorRuntime<S, BS>

pub fn new_fvm_runtime() -> ActorRuntime<FvmSyscalls, Blockstore>

impl<S: Syscalls, BS: Blockstore> ActorRuntime<S, BS>

pub fn new(syscalls: S, blockstore: BS) -> ActorRuntime<S, BS>

pub fn new_test_runtime() -> ActorRuntime<FakeSyscalls, MemoryBlockstore>

Creates a runtime suitable for tests, using mock syscalls and a memory blockstore.

pub fn new_shared_test_runtime() -> ActorRuntime<FakeSyscalls, SharedMemoryBlockstore>

Creates a runtime suitable for more complex tests, using mock syscalls and a memory blockstore.

Clones of this runtime will reference the same blockstore.

pub fn actor_id(&self) -> ActorID

Returns the address of the current actor as an ActorID.

pub fn caller(&self) -> ActorID

pub fn send( &self, to: &Address, method: MethodNum, params: Option<IpldBlock>, value: TokenAmount, ) -> MessagingResult<Response>

Sends a message to an actor.

pub fn resolve_id(&self, address: &Address) -> MessagingResult<ActorID>

Attempts to resolve the given address to its ID address form.

Returns MessagingError::AddressNotResolved if the address could not be resolved.

pub fn resolve_or_init(&self, address: &Address) -> MessagingResult<ActorID>

Resolves an address to an ID address, sending a message to initialize an account there if it doesn’t exist.

If the account cannot be created, this function returns MessagingError::AddressNotInitialized.

pub fn initialize_account(&self, address: &Address) -> MessagingResult<ActorID>

pub fn root_cid(&self) -> Result<Cid, ActorError>

Get the root cid of the actor’s state.

pub fn set_root(&self, cid: &Cid) -> Result<(), ActorError>

Set the root cid of the actor’s state.

pub fn same_address(&self, address_a: &Address, address_b: &Address) -> bool

Attempts to compare two addresses, seeing if they would resolve to the same Actor without actually instantiating accounts for them.

If a and b are of the same type, simply do an equality check. Otherwise, attempt to resolve to an ActorID and compare.

pub fn bs(&self) -> &BS

Trait Implementations

impl<S: Syscalls, BS: Blockstore> Blockstore for ActorRuntime<S, BS>

Convenience impl encapsulating the blockstore functionality.

fn get(&self, k: &Cid) -> Result<Option<Vec<u8>>>

Gets the block from the blockstore.

fn put_keyed(&self, k: &Cid, block: &[u8]) -> Result<()>

Put a block with a pre-computed cid.

fn has(&self, k: &Cid<64>) -> Result<bool, Error>

Checks if the blockstore has the specified block.

fn put<D>(&self, mh_code: Code, block: &Block<D>) -> Result<Cid<64>, Error>

where Self: Sized, D: AsRef<[u8]>,

Puts the block into the blockstore, computing the hash with the specified multicodec.

fn put_many<D, I>(&self, blocks: I) -> Result<(), Error>

where Self: Sized, D: AsRef<[u8]>, I: IntoIterator<Item = (Code, Block<D>)>,

Bulk put blocks into the blockstore.

fn put_many_keyed<D, I>(&self, blocks: I) -> Result<(), Error>

where Self: Sized, D: AsRef<[u8]>, I: IntoIterator<Item = (Cid<64>, D)>,

Bulk-put pre-keyed blocks into the blockstore.

impl<S: Clone + Syscalls, BS: Clone + Blockstore> Clone for ActorRuntime<S, BS>

fn clone(&self) -> ActorRuntime<S, BS>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + Syscalls, BS: Debug + Blockstore> Debug for ActorRuntime<S, BS>

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

Formats the value using the given formatter.

impl<S: Syscalls, BS: Blockstore> Messaging for ActorRuntime<S, BS>

fn send( &self, to: &Address, method: MethodNum, params: Option<IpldBlock>, value: TokenAmount, ) -> Result<Response>

Sends a message to an actor.