Struct cosmwasm_vm::Instance

source · [−]

pub struct Instance<A: BackendApi, S: Storage, Q: Querier> { /* private fields */ }

Implementations

source

impl<A, S, Q> Instance<A, S, Q> where
 A: BackendApi + 'static,
 S: Storage + 'static,
 Q: Querier + 'static,

source

pub fn from_code(
 code: &[u8 ],
 backend: Backend<A, S, Q>,
 options: InstanceOptions,
 memory_limit: Option<Size>
) -> VmResult<Self>

This is the only Instance constructor that can be called from outside of cosmwasm-vm, e.g. in test code that needs a customized variant of cosmwasm_vm::testing::mock_instance*.

source

pub fn api(&self) -> &A

source

pub fn recycle(self) -> Option<Backend<A, S, Q>>

Decomposes this instance into its components. External dependencies are returned for reuse, the rest is dropped.

source

pub fn required_features(&self) -> HashSet<String>

Returns the features required by this contract.

This is not needed for production because we can do static analysis on the Wasm file before instatiation to obtain this information. It’s only kept because it can be handy for integration testing.

source

pub fn memory_pages(&self) -> usize

Returns the size of the default memory in pages. This provides a rough idea of the peak memory consumption. Note that Wasm memory always grows in 64 KiB steps (pages) and can never shrink (https://github.com/WebAssembly/design/issues/1300#issuecomment-573867836).

source

pub fn get_gas_left(&self) -> u64

Returns the currently remaining gas.

source

pub fn create_gas_report(&self) -> GasReport

Creates and returns a gas report. This is a snapshot and multiple reports can be created during the lifetime of an instance.

source

pub fn set_storage_readonly(&mut self, new_value: bool)

Sets the readonly storage flag on this instance. Since one instance can be used for multiple calls in integration tests, this should be set to the desired value right before every call.

source

pub fn with_storage<F: FnOnce(&mut S) -> VmResult<T>, T>(
&mut self,
func: F
) -> VmResult<T>

source

pub fn with_querier<F: FnOnce(&mut Q) -> VmResult<T>, T>(
&mut self,
func: F
) -> VmResult<T>

Auto Trait Implementations

impl<A, S, Q> !RefUnwindSafe for Instance<A, S, Q>

impl<A, S, Q> Send for Instance<A, S, Q>

impl<A, S, Q> Sync for Instance<A, S, Q>

impl<A, S, Q> Unpin for Instance<A, S, Q> where
A: Unpin,

impl<A, S, Q> !UnwindSafe for Instance<A, S, Q>

Blanket Implementations

source

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

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

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 T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

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

const: unstable · 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 F where
 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

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

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 for T where
U: From<T>,

const: unstable · 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

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

source

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

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

source

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

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

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

Struct cosmwasm_vm::Instance

Implementations

impl<A, S, Q> Instance<A, S, Q> where A: BackendApi + 'static, S: Storage + 'static, Q: Querier + 'static,

pub fn from_code( code: &[u8], backend: Backend<A, S, Q>, options: InstanceOptions, memory_limit: Option<Size>) -> VmResult<Self>

pub fn api(&self) -> &A

pub fn recycle(self) -> Option<Backend<A, S, Q>>

pub fn required_features(&self) -> HashSet<String>

pub fn memory_pages(&self) -> usize

pub fn get_gas_left(&self) -> u64

pub fn create_gas_report(&self) -> GasReport

pub fn set_storage_readonly(&mut self, new_value: bool)

pub fn with_storage<F: FnOnce(&mut S) -> VmResult<T>, T>( &mut self, func: F) -> VmResult<T>

pub fn with_querier<F: FnOnce(&mut Q) -> VmResult<T>, T>( &mut self, func: F) -> VmResult<T>

Auto Trait Implementations

impl<A, S, Q> !RefUnwindSafe for Instance<A, S, Q>

impl<A, S, Q> Send for Instance<A, S, Q>

impl<A, S, Q> Sync for Instance<A, S, Q>

impl<A, S, Q> Unpin for Instance<A, S, Q> where A: Unpin,

impl<A, S, Q> !UnwindSafe for Instance<A, S, Q>

Blanket Implementations

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

fn type_id(&self) -> TypeId

impl<T> ArchivePointee for T

type ArchivedMetadata = ()

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

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

fn borrow(&self) -> &T

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

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

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

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

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> Instrument for T

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

fn in_current_span(self) -> Instrumented<Self>

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

fn into(self) -> U

impl<T> Pointable for T

const ALIGN: usize

type Init = T

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

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

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

unsafe fn drop(ptr: usize)

impl<T> Pointee for T

type Metadata = ()

impl<T> Same<T> for T

type Output = T

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

type Error = Infallible

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

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

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

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

impl<T> WithSubscriber for T

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

fn with_current_subscriber(self) -> WithDispatch<Self>

impl<A, S, Q> Instance<A, S, Q> where
A: BackendApi + 'static,
S: Storage + 'static,
Q: Querier + 'static,

pub fn from_code(
code: &[u8 ],
backend: Backend<A, S, Q>,
options: InstanceOptions,
memory_limit: Option<Size>
) -> VmResult<Self>

pub fn with_storage<F: FnOnce(&mut S) -> VmResult<T>, T>(
&mut self,
func: F
) -> VmResult<T>

pub fn with_querier<F: FnOnce(&mut Q) -> VmResult<T>, T>(
&mut self,
func: F
) -> VmResult<T>

impl<A, S, Q> Unpin for Instance<A, S, Q> where
A: Unpin,

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

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

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

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

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

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

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

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

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

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