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 id(&self) -> &AccountId

Grab the current contract’s account identifier

pub fn as_account(&self) -> &Account

Casts the current Contract into an Account type. This does nothing on chain/network, and is merely allowing Account::* functions to be used from this Contract.

pub fn call<'a, 'b, T: Network>(
    &self,
    worker: &'a Worker<T>,
    function: &'b str
) -> CallTransaction<'a, 'b, T>

Call the current contract’s function using the contract’s own account details 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 account to call into a different contract besides the current one, use contract.as_account().call instead.

pub async fn view<T: Network>(
    &self,
    worker: &Worker<T>,
    function: &str,
    args: Vec<u8>
) -> Result<ViewResultDetails>

Call a view function into the current contract. Returns a result that yields a JSON string object.

pub async fn view_code<T: Network>(&self, worker: &Worker<T>) -> Result<Vec<u8>>

View the WASM code bytes of this contract.

pub async fn view_state<T: Network>(
    &self,
    worker: &Worker<T>,
    prefix: Option<&[u8]>
) -> Result<HashMap<Vec<u8>, Vec<u8>>>

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

pub async fn view_account<T: Network>(
    &self,
    worker: &Worker<T>
) -> Result<AccountDetails>

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

pub async fn delete_contract<T: Network>(
    self,
    worker: &Worker<T>,
    beneficiary_id: &AccountId
) -> Result<CallExecutionDetails>

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<'a, T: Network>(&self, worker: &'a Worker<T>) -> Transaction<'a>

Start a batch transaction, using the current contract as the signer and making calls into this contract. 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.