Struct noble_contracts::Module

pub struct Module<T: Config>(_)
 where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>;

Contracts module.

Implementations

impl<T: Config> Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

Can also be called using Call.

pub fn update_schedule(
    origin: T::Origin,
    schedule: Schedule<T>
) -> DispatchResult

Updates the schedule for metering contracts.

The schedule must have a greater version than the stored schedule.

NOTE: Calling this function will bypass origin filters.

pub fn put_code(origin: T::Origin, code: Vec<u8>) -> DispatchResult

Stores the given binary Wasm code into the chain’s storage and returns its codehash. You can instantiate contracts only with stored code.

NOTE: Calling this function will bypass origin filters.

pub fn call(
    origin: T::Origin,
    dest: <T::Lookup as StaticLookup>::Source,
    value: BalanceOf<T>,
    gas_limit: Gas,
    data: Vec<u8>
) -> DispatchResultWithPostInfo

Makes a call to an account, optionally transferring some balance.

• If the account is a smart-contract account, the associated code will be executed and any value will be transferred.
• If the account is a regular account, any value will be transferred.
• If no account exists and the call value is not less than existential_deposit, a regular account will be created and any value will be transferred.

NOTE: Calling this function will bypass origin filters.

pub fn instantiate(
    origin: T::Origin,
    endowment: BalanceOf<T>,
    gas_limit: Gas,
    code_hash: CodeHash<T>,
    data: Vec<u8>,
    salt: Vec<u8>
) -> DispatchResultWithPostInfo

Instantiates a new contract from the code_hash generated by put_code, optionally transferring some balance.

The supplied salt is used for contract address deriviation. See fn contract_address.

Instantiation is executed as follows:

• The destination address is computed based on the sender, code_hash and the salt.
• The smart-contract account is created at the computed address.
• The ctor_code is executed in the context of the newly-created account. Buffer returned after the execution is saved as the code of the account. That code will be invoked upon any call received by this account.
• The contract is initialized.

NOTE: Calling this function will bypass origin filters.

pub fn claim_surcharge(
    origin: T::Origin,
    dest: T::AccountId,
    aux_sender: Option<T::AccountId>
) -> DispatchResultWithPostInfo

Allows block producers to claim a small reward for evicting a contract. If a block producer fails to do so, a regular users will be allowed to claim the reward.

In case of a successful eviction no fees are charged from the sender. However, the reward is capped by the total amount of rent that was payed by the contract while it was alive.

If contract is not evicted as a result of this call, Error::ContractNotEvictable is returned and the sender is not eligible for the reward.

NOTE: Calling this function will bypass origin filters.

impl<T: Config> Module<T> where
    T::AccountId: UncheckedFrom<T::Hash> + AsRef<[u8]>, 

Public APIs provided by the contracts module.

pub fn bare_call(
    origin: T::AccountId,
    dest: T::AccountId,
    value: BalanceOf<T>,
    gas_limit: Gas,
    input_data: Vec<u8>
) -> ContractExecResult

Perform a call to a specified contract.

This function is similar to Self::call, but doesn’t perform any address lookups and better suitable for calling directly from Rust.

It returns the exection result and the amount of used weight.

pub fn get_storage(address: T::AccountId, key: [u8; 32]) -> GetStorageResult

Query storage of a specified contract under a specified key.

pub fn rent_projection(
    address: T::AccountId
) -> RentProjectionResult<T::BlockNumber>

pub fn contract_address(
    deploying_address: &T::AccountId,
    code_hash: &CodeHash<T>,
    salt: &[u8]
) -> T::AccountId

Determine the address of a contract,

This is the address generation function used by contract instantation. Its result is only dependend on its inputs. It can therefore be used to reliably predict the address of a contract. This is akin to the formular of eth’s CRATE2 opcode. There is no CREATE equivalent because CREATE2 is strictly more powerful.

Formula: hash(deploying_address ++ code_hash ++ salt)

impl<T: Config + 'static> Module<T> where
    T::AccountId: UncheckedFrom<T::Hash> + AsRef<[u8]>, 

pub fn current_schedule() -> Schedule<T>

Current cost schedule for contracts.

Trait Implementations

impl<T: Config> Callable<T> for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

type Call = Call<T>

impl<T: Clone + Config> Clone for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

fn clone(&self) -> Module<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Copy + Config> Copy for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

impl<T: Config> Debug for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>,
    T: Debug, 

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

Formats the value using the given formatter.

impl<T: Eq + Config> Eq for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

impl<T: Config> GetNobleVersion for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

fn current_version() -> NobleVersion

Returns the current version of the noble.

fn storage_version() -> Option<NobleVersion>

Returns the version of the noble that is stored in storage.

impl<T: Config> IntegrityTest for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

pub fn integrity_test()

Run integrity test.

impl<T: Config> ModuleErrorMetadata for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

fn metadata() -> &'static [ErrorMetadata]

impl<T: Config + Config> OffchainWorker<<T as Config>::BlockNumber> for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

pub fn offchain_worker(_n: BlockNumber)

This function is being called after every block import (when fully synced).

impl<T: Config + Config> OnFinalize<<T as Config>::BlockNumber> for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

pub fn on_finalize(_n: BlockNumber)

The block is being finalized. Implement to have something happen.

impl<T: Config> OnGenesis for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

fn on_genesis()

Something that should happen at genesis.

impl<T: Config + Config> OnInitialize<<T as Config>::BlockNumber> for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

fn on_initialize(_block_number_not_used: <T as Config>::BlockNumber) -> Weight

The block is being initialized. Implement to have something happen.

impl<T: Config> OnRuntimeUpgrade for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

fn on_runtime_upgrade() -> Weight

Perform a module upgrade.

impl<T: PartialEq + Config> PartialEq<Module<T>> for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

fn eq(&self, other: &Module<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Module<T>) -> bool

This method tests for !=.

impl<T: Config> StructuralEq for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>, 

impl<T: Config> StructuralPartialEq for Module<T> where
    T::AccountId: UncheckedFrom<T::Hash>,
    T::AccountId: AsRef<[u8]>,