Struct near_workspaces::Contract

pub struct Contract { /* private fields */ }

Contract is directly associated to a contract in the network provided by the Worker that creates it. This type offers methods to interact with any network, such as creating transactions and calling into contract functions.

Implementations

impl Contract

pub fn from_secret_key(
    id: AccountId,
    sk: SecretKey,
    worker: &Worker<impl Network + 'static>
) -> Self

Create a Contract object from an AccountId and SecretKey.

pub fn id(&self) -> &AccountId

Grab the current contract’s account identifier

pub fn as_account(&self) -> &Account

Treat this Contract object as an Account type. This does nothing on chain/network, and is merely allowing Account::* functions to be used from this Contract.

pub fn as_account_mut(&mut self) -> &mut Account

Treat this Contract object as an Account type. This does nothing on chain/network, and is merely allowing Account::* functions to be used from this Contract.

pub fn signer(&self) -> &InMemorySigner

Grab the signer of the account. This signer is used to sign all transactions sent to the network.

pub fn call(&self, function: &str) -> CallTransaction<'_>

Call the current contract’s function using the contract’s own account secret key to do the signing. Returns a CallTransaction object that we will make use to populate the rest of the call details.

If we want to make use of the contract’s secret key as a signer to call into another contract, use contract.as_account().call instead.

pub fn view(&self, function: &str) -> Query<'_, ViewFunction>

Call a view function into the current contract. Returns a result which can be deserialized into borsh or JSON.

pub fn view_code(&self) -> Query<'_, ViewCode>

View the WASM code bytes of this contract.

pub fn view_state(&self) -> Query<'_, ViewState>

View a contract’s state map of key value pairs.

pub fn view_account(&self) -> Query<'_, ViewAccount>

Views the current contract’s details such as balance and storage usage.

pub fn view_access_key(&self, pk: &PublicKey) -> Query<'_, ViewAccessKey>

Views the current contract’s access key, given the PublicKey associated to it.

pub fn view_access_keys(&self) -> Query<'_, ViewAccessKeyList>

Views all the AccessKeys of the current contract. This will return a list of AccessKeys along with each associated PublicKey.

pub async fn delete_contract(
    self,
    beneficiary_id: &AccountId
) -> Result<ExecutionFinalResult>

Deletes the current contract, and returns the execution details of this transaction. The beneciary will receive the funds of the account deleted

pub fn batch(&self) -> Transaction<'_>

Start a batch transaction, using the current contract’s secret key as the signer, making calls into itself. Returns a Transaction object that we can use to add Actions to the batched transaction. Call transact to send the batched transaction to the network.

Trait Implementations

impl Clone for Contract

fn clone(&self) -> Contract

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Contract

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

Formats the value using the given formatter.