Struct near_workspaces::Account

pub struct Account { /* private fields */ }

Account is directly associated to an account 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 Account

pub fn from_file(path: impl AsRef<Path>) -> Self

Create a new account with the given path to the credentials JSON file

pub fn id(&self) -> &AccountId

Grab the current account identifier

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

Call a contract on the network specified within worker, and return a CallTransaction object that we will make use to populate the rest of the call details.

pub async fn transfer_near<T: Network>(
    &self,
    worker: &Worker<T>,
    receiver_id: &AccountId,
    amount: u128
) -> Result<CallExecutionDetails>

Transfer NEAR to an account specified by receiver_id with the amount specified by amount. Returns the execution details of this transaction

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

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

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

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

pub fn create_subaccount<'a, 'b, T: Network>(
    &self,
    worker: &'a Worker<T>,
    new_account_id: &'b str
) -> CreateAccountTransaction<'a, 'b, T>

Create a new sub account. Returns a CreateAccountTransaction object that we can make use of to fill out the rest of the details. The subaccount id will be in the form of: “{new_account_id}.{parent_account_id}”

pub async fn deploy<T: Network>(
    &self,
    worker: &Worker<T>,
    wasm: &[u8]
) -> Result<CallExecution<Contract>>

Deploy contract code or WASM bytes to the account, and return us a new Contract object that we can use to interact with the contract.

pub fn batch<'a, T: Network>(
    &self,
    worker: &'a Worker<T>,
    contract_id: &AccountId
) -> Transaction<'a>

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

pub async fn store_credentials(&self, save_dir: impl AsRef<Path>) -> Result<()>

Store the credentials of this account locally in the directory provided.