Account API

Account C API

C API for querying account data.

Function

bool account_balance_get(void *balance, uint32_t len)
retrieve the balance of the account provided

Function docs

• account_balance_get()

  bool account_balance_get(void *balance, uint32_t len)

• Parameter:
  • balance - a pointer to a series of memory that stores balance data
  • len - length of memory for storing balance data
• Return:
  If the account is retrieved as returned: true
• Premise:
  Data is a valid pointer to a memory range at least datalen bytes long
  Data is the pointer to the balance object*((uint64_t*)data) to store the primary key

Example:

balance b;
b.account = N(myaccount);
balance(b, sizeof(balance));

Account CPP API

C++ API for querying account data. Example: account balance.

Class

struct eosio::account::account_balance　　
Binary structure of account balance

Function

• bool eosio::accout::get(account_balance &acnt)
  Return an account balance structure

Function description

• bool eosio::account::get(account_balance & acnt)

  
  return an account balance structure

• Parameter:
  • acnt - account
• Return
  If the account balance is found，it showstrue

eosio::account::account_balance type description

Binary structure of account balance

#include<account.hpp>

Common property

• account_name account

  account name of the balance checked

• asset eos_balance

  account balance

• asset staked_balance

  staked balance of account

• asset unstaking_balance

  unstaking balance of account

• time last_unstaking_time

  
  last unstaking time of account

Description

Example:

account_balance test1_balance;
test1_balance.account = N(test1);
if (account_api::get(test1_balance))
{
   eosio::print("test1 balance=", test1_balance.eos_balance, "\n");
}

Data description docs

account

account_name eosio::account::account_balance::account

    account name of the balance checked

eos_balance

asset eosio::account::account_balance::eos_balance

 account balance

last_unstaking_time

time eosio::account::account_balance::last_unstaking_time

 unstaking balance of account

staked_balance

asset eosio::account::account_balance::staked_balance

staked balance of account

unstaking_balance

asset eosio::account::account_balance::unstaking_balance

last unstaking time of account

Source docs

contracts/eosiolib/account.hpp