Account Calls
Account Calls
list_my_accounts
Lists all accounts controlled by this wallet. This returns a list of the full account objects for all accounts whose private keys we possess
A list of account objects
list_accounts
Lists all accounts registered in the blockchain. This returns a list of all account names and their account ids, sorted by account name.
Use the lowerbound
and limit parameters to page through the list. To retrieve all accounts, start by setting lowerbound
to the empty string ""
, and then each iteration, pass the last account name returned as the lowerbound
for the next list_accounts()
call.
lowerbound
: the name of the first account to return. If the named account does not exist, the list will start at the account that comes afterlowerbound
limit
: the maximum number of accounts to return (max: 1000)
list_account_balances
List the balances of an account. Each account can have multiple balances, one for each type of asset owned by that account. The returned list will only contain assets for which the account has a non-zero balance.
id
: the name or id of the account whose balances you want
register_account
Registers a third party’s account on the blockchain.
This function is used to register an account for which you do not own the private keys. When acting as a registrar, an end user will generate their own private keys and send you the public keys. The registrar will use this function to register the account on behalf of the end user.
See also create_account_with_brain_key()
name
: the name of the account, must be unique on the blockchain. Shorter names are more expensive to register; the rules are still in flux, but in general names of more than 8 characters with at least one digit will be cheap.owner
: the owner key for the new accountactive
: the active key for the new accountregistrar_account
: the account which will pay the fee to register the userreferrer_account
: the account who is acting as a referrer, and may receive a portion of the user’s transaction fees. This can be the same as the registrar_account if there is no referrer.referrer_percent
: the percentage (0 - 100) of the new user’s transaction fees not claimed by the blockchain that will be distributed to the referrer; the rest will be sent to the registrar. Will be multiplied by GRAPHENE_1_PERCENT when constructing the transaction.broadcast
: true to broadcast the transaction on the network
upgrade_account
Upgrades an account to prime status. This makes the account holder a ‘lifetime member’.
name
: the name or id of the account to upgradebroadcast
: true to broadcast the transaction on the network
create_account_with_brain_key
Creates a new account and registers it on the blockchain.
See also suggest_brain_key(), register_account()
brain_key
: the brain key used for generating the account’s private keysaccount_name
: the name of the account, must be unique on the blockchain. Shorter names are more expensive to register; the rules are still in flux, but in general names of more than 8 characters with at least one digit will be cheap.registrar_account
: the account which will pay the fee to register the userreferrer_account
: the account who is acting as a referrer, and may receive a portion of the user’s transaction fees. This can be the same as the registrar_account if there is no referrer.broadcast
: true to broadcast the transaction on the network
transfer
Transfer an amount from one account to another.
from
: the name or id of the account sending the fundsto
: the name or id of the account receiving the fundsamount
: the amount to send (in nominal units to send half of a BTS, specify 0.5)asset_symbol
: the symbol or id of the asset to sendmemo
: a memo to attach to the transaction. The memo will be encrypted in the transaction and readable for the receiver. There is no length limit other than the limit imposed by maximum transaction size, but transaction increase with transaction sizebroadcast
: true to broadcast the transaction on the network
transfer2
This method works just like transfer, except it always broadcasts and returns the transaction ID (hash) along with the signed transaction.
from
: the name or id of the account sending the fundsto
: the name or id of the account receiving the fundsamount
: the amount to send (in nominal units to send half of a BTS, specify 0.5)asset_symbol
: the symbol or id of the asset to sendmemo
: a memo to attach to the transaction. The memo will be encrypted in the transaction and readable for the receiver. There is no length limit other than the limit imposed by maximum transaction size, but transaction increase with transaction size
whitelist_account
Whitelist and blacklist accounts, primarily for transacting in whitelisted assets.
Accounts can freely specify opinions about other accounts, in the form of either whitelisting or blacklisting them. This information is used in chain validation only to determine whether an account is authorized to transact in an asset type which enforces a whitelist, but third parties can use this information for other uses as well, as long as it does not conflict with the use of whitelisted assets.
An asset which enforces a whitelist specifies a list of accounts to maintain its whitelist, and a list of accounts to maintain its blacklist. In order for a given account A to hold and transact in a whitelisted asset S, A must be whitelisted by at least one of S’s whitelist_authorities and blacklisted by none of S’s blacklist_authorities. If A receives a balance of S, and is later removed from the whitelist(s) which allowed it to hold S, or added to any blacklist S specifies as authoritative, A’s balance of S will be frozen until A’s authorization is reinstated.
authorizing_account
: the account who is doing the whitelistingaccount_to_list
: the account being whitelistednew_listing_status
: the new whitelisting statusbroadcast
: true to broadcast the transaction on the network
get_vesting_balances
Get information about a vesting balance object or vesting balance objects owned by an account.
account_name
: An account name, account ID, or vesting balance object ID.
withdraw_vesting
Withdraw a vesting balance.
witness_name
: The account name of the witness, also accepts account ID or vesting balance ID type.amount
: The amount to withdraw.asset_symbol
: The symbol of the asset to withdraw.broadcast
: true if you wish to broadcast the transaction
get_account
Returns information about the given account.
account_name_or_id
: the name or ID of the account to provide information about
get_account_id
Lookup the id of a named account.
account_name_or_id
: the name or ID of the account to look up
get_account_history
Returns the most recent operations on the named account.
This returns a list of operation history objects, which describe activity on the account.
name
: the name or id of the accountlimit
: the number of entries to return (starting from the most recent)
approve_proposal
Approve or disapprove a proposal.
fee_paying_account
: The account paying the fee for the op.proposal_id
: The proposal to modify.delta
: Members contain approvals to create or remove. In JSON you can leave empty members undefined.broadcast
: true if you wish to broadcast the transaction
Last updated