Graphene::Wallet¶
-
namespace
wallet
¶ Typedefs
-
using
transaction_handle_type
= uint32_t¶
-
typedef multi_index_container<blind_receipt, indexed_by<ordered_unique<tag<by_commitment>, const_mem_fun<blind_receipt, const commitment_type&, &blind_receipt::commitment>>, ordered_unique<tag<by_to>, const_mem_fun<blind_receipt, std::pair<public_key_type, fc::time_point>, &blind_receipt::to_date>>, ordered_non_unique<tag<by_to_asset_used>, const_mem_fun<blind_receipt, std::tuple<public_key_type, asset_id_type, bool>, &blind_receipt::to_asset_used>>, ordered_unique<tag<by_from>, const_mem_fun<blind_receipt, std::pair<public_key_type, fc::time_point>, &blind_receipt::from_date>>>>
blind_receipt_index_type
¶
-
typedef multi_index_container<key_label, indexed_by<ordered_unique<tag<by_label>, member<key_label, string, &key_label::label>>, ordered_unique<tag<by_key>, member<key_label, public_key_type, &key_label::key>>>>
key_label_index_type
¶
Functions
-
template<typename
T
>
static_variant_mapcreate_static_variant_map
()¶
-
object *
create_object
(const variant &v)¶ This class takes a variant and turns it into an object of the given type, with the new operator.
-
struct
blind_balance
¶ - #include <wallet_structs.hpp>
-
struct
blind_confirmation
¶ - #include <wallet_structs.hpp>
Contains the confirmation receipt the sender must give the receiver and the meta data about the receipt that helps the sender identify which receipt is for the receiver and which is for the change address.
-
class
utility
¶ - #include <wallet_structs.hpp>
Public Static Functions
-
vector<brain_key_info>
derive_owner_keys_from_brain_key
(const string &brain_key, uint32_t number_of_desired_keys = 1)¶ Derive any number of possible owner keys from a given brain key.
NOTE: These keys may or may not match with the owner keys of any account. This function is merely intended to assist with account or key recovery.
- See
- Return
A list of keys that are deterministically derived from the brainkey
- Parameters
brain_key
: Brain keynumber_of_desired_keys
: Number of desired keys
-
brain_key_info
suggest_brain_key
()¶ Suggests a safe brain key to use for creating your account.
create_account_with_brain_key()
requires you to specify a ‘brain key’, a long passphrase that provides enough entropy to generate cyrptographic keys. This function will suggest a suitably random string that should be easy to write down (and, with effort, memorize).- Return
a suggested brain_key
-
vector<brain_key_info>
-
struct
vesting_balance_object_with_info
: public graphene::chain::vesting_balance_object¶ - #include <wallet_structs.hpp>
-
class
wallet_api
¶ - #include <wallet.hpp>
This wallet assumes it is connected to the database server with a high-bandwidth, low-latency connection and performs minimal caching. This API could be provided locally to be used by a web interface.
Unnamed Group
-
bool
set_key_label
(const public_key_type &key, const string &label) const¶ These methods are used for stealth transfers This method can be used to set a label for a public key
- Note
No two keys can have the same label.
- Return
true if the label was set, otherwise false
- Parameters
key
: a public keylabel
: a user-defined string as label
-
string
get_key_label
(const public_key_type &key) const¶ Get label of a public key.
- Return
the label if already set by
set_key_label()
, or an empty string if not set- Parameters
key
: a public key
-
public_key_type
create_blind_account
(const string &label, const string &brain_key) const¶ Generates a new blind account for the given brain key and assigns it the given label.
- Return
the public key of the new account
- Parameters
label
: a labelbrain_key
: the brain key to be used to generate a new blind account
-
vector<asset>
get_blind_balances
(const string &key_or_label) const¶ Return the total balances of all blinded commitments that can be claimed by the given account key or label.
- Return
the total balances of all blinded commitments that can be claimed by the given account key or label
- Parameters
key_or_label
: a public key in Base58 format or a label
-
map<string, public_key_type, std::less<>>
get_blind_accounts
() const¶ Get all blind accounts.
- Return
all blind accounts
-
map<string, public_key_type, std::less<>>
get_my_blind_accounts
() const¶ Get all blind accounts for which this wallet has the private key.
- Return
all blind accounts for which this wallet has the private key
-
public_key_type
get_public_key
(const string &label) const¶ Get the public key associated with a given label.
- Return
the public key associated with the given label
- Parameters
label
: a label
Public Functions
-
variant
info
() const¶ Returns info about head block, chain_id, maintenance, participation, current active witnesses and committee members.
- Return
runtime info about the blockchain
-
variant_object
about
() const¶ Returns info such as client version, git version of graphene/fc, version of boost, openssl.
- Return
compile time info and client and dependencies versions
-
optional<signed_block_with_info>
get_block
(uint32_t num) const¶ Returns info about a specified block.
- Return
info about the block, or null if not found
- Parameters
num
: height of the block to retrieve
-
uint64_t
get_account_count
() const¶ Returns the number of accounts registered on the blockchain
- Return
the number of registered accounts
-
vector<account_object>
list_my_accounts
() const¶ Lists all accounts controlled by this wallet. This returns a list of the full account objects for all accounts whose private keys we possess.
- Return
a list of account objects
-
map<string, account_id_type, std::less<>>
list_accounts
(const string &lowerbound, uint32_t limit) const¶ 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 settinglowerbound
to the empty string""
, and then each iteration, pass the last account name returned as thelowerbound
for the nextlist_accounts()
call.- Return
a list of accounts mapping account names to account ids
- Parameters
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)
-
vector<asset>
list_account_balances
(const string &account_name_or_id) const¶ 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 nonzero balance
- Return
a list of the given account’s balances
- Parameters
account_name_or_id
: the name or id of the account whose balances you want
-
vector<extended_asset_object>
list_assets
(const string &lowerbound, uint32_t limit) const¶ Lists all assets registered on the blockchain.
To list all assets, pass the empty string
""
for the lowerbound to start at the beginning of the list, and iterate as necessary.- Return
the list of asset objects, ordered by symbol
- Parameters
lowerbound
: the symbol of the first asset to include in the list.limit
: the maximum number of assets to return (max: 100)
-
uint64_t
get_asset_count
() const¶ Returns assets count registered on the blockchain.
- Return
assets count
-
vector<operation_detail>
get_account_history
(const string &account_name_or_id, uint32_t limit) const¶ Returns the most recent operations on the named account.
This returns a list of operation history objects, which describe activity on the account.
- Return
a list of
operation_history_objects
- Parameters
account_name_or_id
: the name or id of the accountlimit
: the number of entries to return (starting from the most recent)
-
vector<operation_detail>
get_relative_account_history
(const string &account_name_or_id, uint32_t stop, uint32_t limit, uint32_t start) const¶ Returns the relative operations on the named account from start number.
- Return
a list of
operation_history_objects
- Parameters
account_name_or_id
: the name or id of the accountstop
: Sequence number of earliest operation.limit
: the number of entries to returnstart
: the sequence number where to start looping back throw the history
-
full_account
get_full_account
(const string &name_or_id) const¶ Fetch all objects relevant to the specified account.
This function fetches all relevant objects for the given account. If the string of
name_or_id
cannot be tied to an account, that input will be ignored.- Return
All info about the specified account
- Parameters
name_or_id
: Must be the name or ID of an account to retrieve
-
vector<bucket_object>
get_market_history
(const string &symbol, const string &symbol2, uint32_t bucket, const time_point_sec &start, const time_point_sec &end) const¶ Get OHLCV data of a trading pair in a time range.
- Return
A list of OHLCV data, in “least recent first” order.
- Parameters
symbol
: symbol or ID of the base assetsymbol2
: symbol or ID of the quote assetbucket
: length of each time bucket in seconds.start
: the start of a time range, E.G. “2018-01-01T00:00:00”end
: the end of the time range
-
vector<limit_order_object>
get_account_limit_orders
(const string &name_or_id, const string &base, const string "e, uint32_t limit = 101, const optional<limit_order_id_type> &ostart_id = {}, const optional<price> &ostart_price = optional<price>()) const¶ Fetch all orders relevant to the specified account sorted descendingly by price.
- Return
List of orders from
name_or_id
to the corresponding account- Note
if
name_or_id
cannot be tied to an account, empty result will be returnedostart_id
andostart_price
can benull
, if so the api will return the “first page” of orders. ifostart_id
is specified and valid, its price will be used to do page query preferentially, otherwise theostart_price
will be used
- Parameters
name_or_id
: The name or ID of an account to retrievebase
: Base assetquote
: Quote assetlimit
: The limitation of items each query can fetch (max: 101)ostart_id
: Start order id, fetch orders which price are lower than or equal to this orderostart_price
: Fetch orders with price lower than or equal to this price
-
vector<limit_order_object>
get_limit_orders
(const string &a, const string &b, uint32_t limit) const¶ Get limit orders in a given market.
- Return
The limit orders, ordered from least price to greatest
- Parameters
a
: symbol or ID of asset being soldb
: symbol or ID of asset being purchasedlimit
: Maximum number of orders to retrieve
-
vector<call_order_object>
get_call_orders
(const string &asset_symbol_or_id, uint32_t limit) const¶ Get call orders (aka margin positions) for a given asset.
- Return
The call orders, ordered from earliest to be called to latest
- Parameters
asset_symbol_or_id
: symbol or ID of the debt assetlimit
: Maximum number of orders to retrieve
-
vector<force_settlement_object>
get_settle_orders
(const string &a, uint32_t limit) const¶ Get forced settlement orders in a given asset.
- Return
The settle orders, ordered from earliest settlement date to latest
- Parameters
a
: Symbol or ID of asset being settledlimit
: Maximum number of orders to retrieve
-
vector<collateral_bid_object>
get_collateral_bids
(const string &asset_symbol_or_id, uint32_t limit = 100, uint32_t start = 0) const¶ Returns the collateral_bid object for the given MPA
- Return
a list of
collateral_bid_objects
- Parameters
asset_symbol_or_id
: the symbol or id of the assetlimit
: the number of entries to returnstart
: the sequence number where to start looping back throw the history
-
global_property_object
get_global_properties
() const¶ Returns the block chain’s slowly-changing settings. This object contains all of the properties of the blockchain that are fixed or that change only once per maintenance interval (daily) such as the current list of witnesses, committee_members, block interval, etc.
- See
get_dynamic_global_properties()
for frequently changing properties- Return
the global properties
-
account_history_operation_detail
get_account_history_by_operations
(const string &account_name_or_id, const flat_set<uint16_t> &operation_types, uint32_t start, uint32_t limit) const¶ Get operations relevant to the specified account filtering by operation type, with transaction id
- Return
account_history_operation_detail
- Parameters
account_name_or_id
: the name or id of the account, whose history shoulde be queriedoperation_types
: The IDs of the operation we want to get operations in the account ( 0 = transfer , 1 = limit order create, …)start
: the sequence number where to start looping back throw the historylimit
: the max number of entries to return (from start number)
-
dynamic_global_property_object
get_dynamic_global_properties
() const¶ Returns the block chain’s rapidly-changing properties. The returned object contains information that changes every block interval such as the head block number, the next witness, etc.
- See
get_global_properties()
for less-frequently changing properties- Return
the dynamic global properties
-
account_object
get_account
(const string &account_name_or_id) const¶ Returns information about the given account.
- Return
the public account data stored in the blockchain
- Parameters
account_name_or_id
: the name or ID of the account to provide information about
-
extended_asset_object
get_asset
(const string &asset_symbol_or_id) const¶ Returns information about the given asset.
- Return
the information about the asset stored in the block chain
- Parameters
asset_symbol_or_id
: the symbol or id of the asset in question
-
asset_bitasset_data_object
get_bitasset_data
(const string &asset_symbol_or_id) const¶ Returns the BitAsset-specific data for a given asset. Market-issued assets’s behavior are determined both by their “BitAsset Data” and their basic asset data, as returned by
get_asset()
.- Return
the BitAsset-specific data for this asset
- Parameters
asset_symbol_or_id
: the symbol or id of the BitAsset in question
-
fc::optional<fc::variant>
get_htlc
(const htlc_id_type &htlc_id) const¶ Returns information about the given HTLC object.
- Return
the information about the HTLC object
- Parameters
htlc_id
: the id of the HTLC object.
-
account_id_type
get_account_id
(const string &account_name_or_id) const¶ Lookup the id of a named account.
- Return
the id of the named account
- Parameters
account_name_or_id
: the name or ID of the account to look up
-
string
get_account_name
(const string &account_name_or_id) const¶ Lookup the name of an account.
- Return
the name of the account
- Parameters
account_name_or_id
: the name or ID of the account to look up
-
asset_id_type
get_asset_id
(const string &asset_symbol_or_id) const¶ Lookup the id of an asset.
- Return
the id of the given asset
- Parameters
asset_symbol_or_id
: the symbol or ID of an asset to look up
-
string
get_asset_symbol
(const string &asset_symbol_or_id) const¶ Lookup the symbol of an asset.
- Return
the symbol of the given asset
- Parameters
asset_symbol_or_id
: the symbol or ID of an asset to look up
-
string
get_asset_name
(const string &asset_symbol_or_id) const¶ Lookup the symbol of an asset. Synonym of get_asset_symbol.
- Return
the symbol of the given asset
- Parameters
asset_symbol_or_id
: the symbol or ID of an asset to look up
-
variant
get_object
(const object_id_type &id) const¶ Returns the blockchain object corresponding to the given id.
This generic function can be used to retrieve any object from the blockchain that is assigned an ID. Certain types of objects have specialized convenience functions to return their objects e.g., assets have
get_asset()
, accounts haveget_account()
, but this function will work for any object.- Return
the requested object
- Parameters
id
: the id of the object to return
-
string
get_wallet_filename
() const¶ Returns the current wallet filename.
This is the filename that will be used when automatically saving the wallet.
- See
- Return
the wallet filename
-
string
get_private_key
(const public_key_type &pubkey) const¶ Get the WIF private key corresponding to a public key. The private key must already be in the wallet.
- Return
the WIF private key
- Parameters
pubkey
: a public key in Base58 format
-
transaction_handle_type
begin_builder_transaction
() const¶ Create a new transaction builder.
- Return
handle of the new transaction builder
-
void
add_operation_to_builder_transaction
(transaction_handle_type transaction_handle, const operation &op) const¶ Append a new operation to a transaction builder.
- Parameters
transaction_handle
: handle of the transaction builderop
: the operation in JSON format
-
void
replace_operation_in_builder_transaction
(transaction_handle_type handle, uint32_t operation_index, const operation &new_op) const¶ Replace an operation in a transaction builder with a new operation.
- Parameters
handle
: handle of the transaction builderoperation_index
: the index of the old operation in the builder to be replacednew_op
: the new operation in JSON format
-
asset
set_fees_on_builder_transaction
(transaction_handle_type handle, const string &fee_asset = GRAPHENE_SYMBOL) const¶ Calculate and update fees for the operations in a transaction builder.
- Return
total fees
- Parameters
handle
: handle of the transaction builderfee_asset
: symbol or ID of an asset that to be used to pay fees
-
transaction
preview_builder_transaction
(transaction_handle_type handle) const¶ Show content of a transaction builder.
- Return
a transaction
- Parameters
handle
: handle of the transaction builder
-
signed_transaction
sign_builder_transaction
(transaction_handle_type transaction_handle, bool broadcast = true) const¶ Sign the transaction in a transaction builder and optionally broadcast to the network.
- Return
a signed transaction
- Parameters
transaction_handle
: handle of the transaction builderbroadcast
: whether to broadcast the signed transaction to the network
-
signed_transaction
sign_builder_transaction2
(transaction_handle_type transaction_handle, const vector<public_key_type> &signing_keys = vector<public_key_type>(), bool broadcast = true) const¶ Sign the transaction in a transaction builder and optionally broadcast to the network.
- Return
a signed transaction
- Parameters
transaction_handle
: handle of the transaction buildersigning_keys
: Keys that must be used when signing the transactionbroadcast
: whether to broadcast the signed transaction to the network
-
pair<transaction_id_type, signed_transaction>
broadcast_transaction
(const signed_transaction &tx) const¶ Broadcast signed transaction
- Return
the transaction ID along with the signed transaction.
- Parameters
tx
: signed transaction
-
signed_transaction
propose_builder_transaction
(transaction_handle_type handle, const time_point_sec &expiration = time_point::now() + fc::minutes(1), uint32_t review_period_seconds = 0, bool broadcast = true) const¶ Create a proposal containing the operations in a transaction builder (create a new proposal_create operation, then replace the transaction builder with the new operation), then sign the transaction and optionally broadcast to the network.
Note: this command is buggy because unable to specify proposer. It will be deprecated in a future release. Please use
propose_builder_transaction2()
instead.- Return
a signed transaction
- Parameters
handle
: handle of the transaction builderexpiration
: when the proposal will expirereview_period_seconds
: review period of the proposal in secondsbroadcast
: whether to broadcast the signed transaction to the network
-
signed_transaction
propose_builder_transaction2
(transaction_handle_type handle, const string &account_name_or_id, const time_point_sec &expiration = time_point::now() + fc::minutes(1), uint32_t review_period_seconds = 0, bool broadcast = true) const¶ Create a proposal containing the operations in a transaction builder (create a new proposal_create operation, then replace the transaction builder with the new operation), then sign the transaction and optionally broadcast to the network.
- Return
a signed transaction
- Parameters
handle
: handle of the transaction builderaccount_name_or_id
: name or ID of the account who would pay fees for creating the proposalexpiration
: when the proposal will expirereview_period_seconds
: review period of the proposal in secondsbroadcast
: whether to broadcast the signed transaction to the network
-
void
remove_builder_transaction
(transaction_handle_type handle) const¶ Destroy a transaction builder.
- Parameters
handle
: handle of the transaction builder
-
bool
is_new
() const¶ Checks whether the wallet has just been created and has not yet had a password set.
Calling
set_password
will transition the wallet to the locked state.- Return
true if the wallet is new
-
bool
is_locked
() const¶ Checks whether the wallet is locked (is unable to use its private keys).
This state can be changed by calling
lock()
orunlock()
.- Return
true if the wallet is locked
-
void
lock
() const¶ Locks the wallet immediately.
-
void
unlock
(const string &password) const¶ Unlocks the wallet.
The wallet remain unlocked until the
lock
is called or the program exits.When used in command line, if typed “unlock” without a password followed, the user will be prompted to input a password without echo.
- Parameters
password
: the password previously set withset_password()
-
void
set_password
(const string &password) const¶ Sets a new password on the wallet.
The wallet must be either ‘new’ or ‘unlocked’ to execute this command.
When used in command line, if typed “set_password” without a password followed, the user will be prompted to input a password without echo.
- Parameters
password
: a new password
-
map<public_key_type, string>
dump_private_keys
() const¶ Dumps all private keys owned by the wallet.
The keys are printed in WIF format. You can import these keys into another wallet using
import_key()
- Return
a map containing the private keys, indexed by their public key
-
string
help
() const¶ Returns a list of all commands supported by the wallet API.
This lists each command, along with its arguments and return types. For more detailed help on a single command, use
gethelp()
- Return
a multi-line string suitable for displaying on a terminal
-
string
gethelp
(const string &method) const¶ Returns detailed help on a single API command.
- Return
a multi-line string suitable for displaying on a terminal
- Parameters
method
: the name of the API command you want help with
-
bool
load_wallet_file
(const string &wallet_filename = "") const¶ Loads a specified BitShares wallet.
The current wallet is closed before the new wallet is loaded.
- Warning
This does not change the filename that will be used for future wallet writes, so this may cause you to overwrite your original wallet unless you also call
set_wallet_filename()
- Return
true if the specified wallet is loaded
- Parameters
wallet_filename
: the filename of the wallet JSON file to load. Ifwallet_filename
is empty, it reloads the existing wallet file
-
void
quit
() const¶ Quit from the wallet.
The current wallet will be closed and saved.
-
void
save_wallet_file
(const string &wallet_filename = "") const¶ Saves the current wallet to the given filename.
- Warning
This does not change the wallet filename that will be used for future writes, so think of this function as ‘Save a Copy As…’ instead of ‘Save As…’. Use
set_wallet_filename()
to make the filename persist.- Parameters
wallet_filename
: the filename of the new wallet JSON file to create or overwrite. Ifwallet_filename
is empty, save to the current filename.
-
void
set_wallet_filename
(const string &wallet_filename) const¶ Sets the wallet filename used for future writes.
This does not trigger a save, it only changes the default filename that will be used the next time a save is triggered.
- Parameters
wallet_filename
: the new filename to use for future saves
-
brain_key_info
suggest_brain_key
() const¶ Suggests a safe brain key to use for creating your account.
create_account_with_brain_key()
requires you to specify a ‘brain key’, a long passphrase that provides enough entropy to generate cyrptographic keys. This function will suggest a suitably random string that should be easy to write down (and, with effort, memorize).- Return
a suggested brain_key
-
vector<brain_key_info>
derive_owner_keys_from_brain_key
(const string &brain_key, uint32_t number_of_desired_keys = 1) const¶ Derive any number of possible owner keys from a given brain key.
NOTE: These keys may or may not match with the owner keys of any account. This function is merely intended to assist with account or key recovery.
- See
- Return
A list of keys that are deterministically derived from the brainkey
- Parameters
brain_key
: Brain keynumber_of_desired_keys
: Number of desired keys
-
bool
is_public_key_registered
(const string &public_key) const¶ Determine whether a textual representation of a public key (in Base-58 format) is currently linked to any registered (i.e. non-stealth) account on the blockchain
- Return
Whether a public key is known
- Parameters
public_key
: Public key
-
string
serialize_transaction
(const signed_transaction &tx) const¶ Converts a signed_transaction in JSON form to its binary representation.
- Return
the binary form of the transaction, hex encoded.
- Parameters
tx
: the transaction to serialize
-
bool
import_key
(const string &account_name_or_id, const string &wif_key) const¶ Imports the private key for an existing account.
The private key must match either an owner key or an active key for the named account.
- See
- Return
true if the key was imported
- Parameters
account_name_or_id
: the account owning the keywif_key
: the private key in WIF format
-
map<string, bool, std::less<>>
import_accounts
(const string &filename, const string &password) const¶ Imports accounts from a BitShares 0.x wallet file. Current wallet file must be unlocked to perform the import.
- Return
a map containing the accounts found and whether imported
- Parameters
filename
: the BitShares 0.x wallet file to importpassword
: the password to encrypt the BitShares 0.x wallet file
-
bool
import_account_keys
(const string &filename, const string &password, const string &src_account_name, const string &dest_account_name) const¶ Imports from a BitShares 0.x wallet file, find keys that were bound to a given account name on the BitShares 0.x chain, rebind them to an account name on the 2.0 chain. Current wallet file must be unlocked to perform the import.
- Return
whether the import has succeeded
- Parameters
filename
: the BitShares 0.x wallet file to importpassword
: the password to encrypt the BitShares 0.x wallet filesrc_account_name
: name of the account on BitShares 0.x chaindest_account_name
: name of the account on BitShares 2.0 chain, can be same or different tosrc_account_name
-
vector<signed_transaction>
import_balance
(const string &account_name_or_id, const vector<string> &wif_keys, bool broadcast) const¶ This call will construct transaction(s) that will claim all balances controled by wif_keys and deposit them into the given account.
- Parameters
account_name_or_id
: name or ID of an account that to claim balances towif_keys
: private WIF keys of balance objects to claim balances frombroadcast
: true to broadcast the transaction on the network
-
string
normalize_brain_key
(const string &s) const¶ Transforms a brain key to reduce the chance of errors when re-entering the key from memory.
This takes a user-supplied brain key and normalizes it into the form used for generating private keys. In particular, this upper-cases all ASCII characters and collapses multiple spaces into one.
- Return
the brain key in its normalized form
- Parameters
s
: the brain key as supplied by the user
-
signed_transaction
register_account
(const string &name, const public_key_type &owner, const public_key_type &active, const string ®istrar_account, const string &referrer_account, uint32_t referrer_percent, bool broadcast = false) const¶ Registers a third party’s account on the blockckain.
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
- Return
the signed transaction registering the account
- Parameters
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
-
signed_transaction
upgrade_account
(const string &account_name_or_id, bool broadcast) const¶ Upgrades an account to prime status. This makes the account holder a ‘lifetime member’.
- Return
the signed transaction upgrading the account
- Parameters
account_name_or_id
: the name or id of the account to upgradebroadcast
: true to broadcast the transaction on the network
-
signed_transaction
create_account_with_brain_key
(const string &brain_key, const string &account_name, const string ®istrar_account, const string &referrer_account, bool broadcast = false) const¶ Creates a new account and registers it on the blockchain.
- See
- See
- Return
the signed transaction registering the account
- Parameters
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. Names with only latin letters and at least one vowel are premium names and expensive to register. Names with only consonants, or at least with a digit, a dot or a minus sign are 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
-
signed_transaction
transfer
(const string &from, const string &to, const string &amount, const string &asset_symbol_or_id, const string &memo, bool broadcast = false) const¶ Transfer an amount from one account to another.
- Return
the signed transaction transferring funds
- Parameters
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_or_id
: 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
-
pair<transaction_id_type, signed_transaction>
transfer2
(const string &from, const string &to, const string &amount, const string &asset_symbol_or_id, const string &memo) const¶ This method works just like transfer, except it always broadcasts and returns the transaction ID (hash) along with the signed transaction.
- Return
the transaction ID (hash) along with the signed transaction transferring funds
- Parameters
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_or_id
: 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
-
transaction_id_type
get_transaction_id
(const signed_transaction &trx) const¶ This method is used to convert a JSON transaction to its transactin ID.
- Return
the ID (hash) of the transaction
- Parameters
trx
: a JSON transaction
-
memo_data
sign_memo
(const string &from, const string &to, const string &memo) const¶ Sign a memo message.
- Return
the signed memo data
- Parameters
from
: the name or id of signing account, or a public key, or a label of a public keyto
: the name or id of receiving account, or a public key, or a label of a public keymemo
: text to sign
-
string
read_memo
(const memo_data &memo) const¶ Read a memo.
- Return
string with decrypted message.
- Parameters
memo
: JSON-encoded memo.
-
signed_message
sign_message
(const string &signer, const string &message) const¶ Sign a message using an account’s memo key. The signature is generated as in https://github.com/xeroc/python-graphenelib/blob/d9634d74/graphenecommon/message.py#L64 .
- Return
the signed message in an abstract format
- Parameters
signer
: the name or id of signing accountmessage
: text to sign
-
bool
verify_message
(const string &message, const string &account, int32_t block, const string &msg_time, const fc::ecc::compact_signature &sig) const¶ Verify a message signed with sign_message using the given account’s memo key.
- Return
true if signature matches
- Parameters
message
: the message textaccount
: the account name of the messageblock
: the block number of the messagemsg_time
: the timestamp of the messagesig
: the message signature
-
bool
verify_signed_message
(const signed_message &message) const¶ Verify a message signed with sign_message
- Return
true if signature matches
- Parameters
message
: the signed_message structure containing message, meta data and signature
-
bool
verify_encapsulated_message
(const string &message) const¶ Verify a message signed with sign_message, in its encapsulated form.
- Return
true if signature matches
- Parameters
message
: the complete encapsulated message string including separators and line feeds
-
vector<blind_receipt>
blind_history
(const string &key_or_account) const¶ Get all blind receipts to/form a particular account
- Return
all blind receipts to/form the account
- Parameters
key_or_account
: a public key in Base58 format or an account
-
blind_receipt
receive_blind_transfer
(const string &confirmation_receipt, const string &opt_from, const string &opt_memo) const¶ Given a confirmation receipt, this method will parse it for a blinded balance and confirm that it exists in the blockchain. If it exists then it will report the amount received and who sent it.
- Return
a blind receipt
- Parameters
confirmation_receipt
: a base58 encoded stealth confirmationopt_from
: if not empty and the sender is a unknown public key, then the unknown public key will be given the labelopt_from
opt_memo
: a self-defined label for this transfer to be saved in local wallet file
-
blind_confirmation
transfer_to_blind
(const string &from_account_name_or_id, const string &asset_symbol_or_id, const vector<pair<string, string>> &to_amounts, bool broadcast = false) const¶ Transfers a public balance from
from_account_name_or_id
to one or more blinded balances using a stealth transfer.- Return
a blind confirmation
- Parameters
from_account_name_or_id
: name or ID of an account to transfer fromasset_symbol_or_id
: symbol or ID of the asset to be transferredto_amounts
: map from key or label to amountbroadcast
: true to broadcast the transaction on the network
-
blind_confirmation
transfer_from_blind
(const string &from_blind_account_key_or_label, const string &to_account_name_or_id, const string &amount, const string &asset_symbol_or_id, bool broadcast = false) const¶ Transfers funds from a set of blinded balances to a public account balance.
- Return
a blind confirmation
- Parameters
from_blind_account_key_or_label
: a public key in Base58 format or a label to transfer fromto_account_name_or_id
: name or ID of an account to transfer toamount
: the amount to be transferredasset_symbol_or_id
: symbol or ID of the asset to be transferredbroadcast
: true to broadcast the transaction on the network
-
blind_confirmation
blind_transfer
(const string &from_key_or_label, const string &to_key_or_label, const string &amount, const string &symbol_or_id, bool broadcast = false) const¶ Transfer from one set of blinded balances to another.
- Return
a blind confirmation
- Parameters
from_key_or_label
: a public key in Base58 format or a label to transfer fromto_key_or_label
: a public key in Base58 format or a label to transfer toamount
: the amount to be transferredsymbol_or_id
: symbol or ID of the asset to be transferredbroadcast
: true to broadcast the transaction on the network
-
signed_transaction
sell_asset
(const string &seller_account, const string &amount_to_sell, const string &symbol_or_id_to_sell, const string &min_to_receive, const string &symbol_or_id_to_receive, uint32_t timeout_sec = 0, bool fill_or_kill = false, bool broadcast = false) const¶ Place a limit order attempting to sell one asset for another.
Buying and selling are the same operation on BitShares. If you want to buy BTS with USD, you should sell USD for BTS.
The blockchain will attempt to sell the
symbol_or_id_to_sell
for as muchsymbol_or_id_to_receive
as possible, as long as the price is at leastmin_to_receive
/amount_to_sell
.In addition to the transaction fees, market fees will apply as specified by the issuer of both the selling asset and the receiving asset as a percentage of the amount exchanged.
If either the selling asset or the receiving asset is whitelist restricted, the order will only be created if the seller is on the whitelist of the restricted asset type.
Market orders are matched in the order they are included in the block chain.
- Return
the signed transaction selling the funds
- Parameters
seller_account
: the account providing the asset being sold, and which will receive the proceeds of the sale.amount_to_sell
: the amount of the asset being sold to sell (in nominal units)symbol_or_id_to_sell
: the symbol or id of the asset to sellmin_to_receive
: the minimum amount you are willing to receive in return for selling the entire amount_to_sellsymbol_or_id_to_receive
: the symbol or id of the asset you wish to receivetimeout_sec
: if the order does not fill immediately, this is the length of time the order will remain on the order books before it is cancelled and the un-spent funds are returned to the seller’s accountfill_or_kill
: if true, the order will only be included in the blockchain if it is filled immediately. if false, an open order will be left on the books to fill any amount that cannot be filled immediately.broadcast
: true to broadcast the transaction on the network
-
signed_transaction
borrow_asset
(const string &borrower, const string &amount_to_borrow, const string &asset_symbol_or_id, const string &amount_of_collateral, bool broadcast = false) const¶ Borrow an asset or update the debt/collateral ratio for the loan.
This is the first step in shorting an asset. Call
sell_asset()
to complete the short.- Return
the signed transaction borrowing the asset
- Parameters
borrower
: the name or id of the account associated with the transaction.amount_to_borrow
: the amount of the asset being borrowed. Make this value negative to pay back debt.asset_symbol_or_id
: the symbol or id of the asset being borrowed.amount_of_collateral
: the amount of the backing asset to add to your collateral position. Make this negative to claim back some of your collateral. The backing asset is defined in thebitasset_options
for the asset being borrowed.broadcast
: true to broadcast the transaction on the network
-
signed_transaction
borrow_asset_ext
(const string &borrower, const string &amount_to_borrow, const string &asset_symbol_or_id, const string &amount_of_collateral, const call_order_update_operation::extensions_type &extensions, bool broadcast = false) const¶ Borrow an asset or update the debt/collateral ratio for the loan, with additional options.
This is the first step in shorting an asset. Call
sell_asset()
to complete the short.- Return
the signed transaction borrowing the asset
- Parameters
borrower
: the name or id of the account associated with the transaction.amount_to_borrow
: the amount of the asset being borrowed. Make this value negative to pay back debt.asset_symbol_or_id
: the symbol or id of the asset being borrowed.amount_of_collateral
: the amount of the backing asset to add to your collateral position. Make this negative to claim back some of your collateral. The backing asset is defined in thebitasset_options
for the asset being borrowed.extensions
: additional optionsbroadcast
: true to broadcast the transaction on the network
-
signed_transaction
cancel_order
(const limit_order_id_type &order_id, bool broadcast = false) const¶ Cancel an existing order
- Return
the signed transaction canceling the order
- Parameters
order_id
: the id of order to be cancelledbroadcast
: true to broadcast the transaction on the network
-
signed_transaction
create_asset
(const string &issuer, const string &symbol, uint8_t precision, const asset_options &common, const optional<bitasset_options> &bitasset_opts, bool broadcast = false) const¶ Creates a new user-issued or market-issued asset.
Many options can be changed later using
update_asset()
Right now this function is difficult to use because you must provide raw JSON data structures for the options objects, and those include prices and asset ids.
- Return
the signed transaction creating a new asset
- Parameters
issuer
: the name or id of the account who will pay the fee and become the issuer of the new asset. This can be updated latersymbol
: the ticker symbol of the new assetprecision
: the number of digits of precision to the right of the decimal point, must be less than or equal to 12common
: asset options required for all new assets. Note that core_exchange_rate technically needs to store the asset ID of this new asset. Since this ID is not known at the time this operation is created, create this price as though the new asset has instance ID 1, and the chain will overwrite it with the new asset’s ID.bitasset_opts
: options specific to BitAssets. This may be null unless themarket_issued
flag is set in common.flagsbroadcast
: true to broadcast the transaction on the network
-
signed_transaction
issue_asset
(const string &to_account, const string &amount, const string &symbol_or_id, const string &memo, bool broadcast = false) const¶ Create the specified amount of the specified asset and credit into the specified account.
- Return
the signed transaction issuing the new supply
- Parameters
to_account
: the name or id of the account to receive the new supplyamount
: the amount to issue, in nominal unitssymbol_or_id
: the ticker symbol or id of the asset to issuememo
: a memo to include in the transaction, readable by the recipientbroadcast
: true to broadcast the transaction on the network
-
signed_transaction
update_asset
(const string &symbol_or_id, const optional<string> &new_issuer, const asset_options &new_options, bool broadcast = false) const¶ Update the core options on an asset. There are a number of options which all assets in the network use. These options are enumerated in the asset_object::asset_options struct. This command is used to update these options for an existing asset.
- Note
This operation cannot be used to update BitAsset-specific options. For these options,
update_bitasset()
instead.- Return
the signed transaction updating the asset
- Parameters
symbol_or_id
: the symbol or id of the asset to updatenew_issuer
: if changing the asset’s issuer, the name or id of the new issuer. null if you wish to remain the issuer of the assetnew_options
: the new asset_options object, which will entirely replace the existing options.broadcast
: true to broadcast the transaction on the network
-
signed_transaction
update_asset_issuer
(const string &symbol_or_id, const string &new_issuer, bool broadcast = false) const¶ Update the issuer of an asset Since this call requires the owner authority of the current issuer to sign the transaction, a separated operation is used to change the issuer. This call simplifies the use of this action.
- Note
This operation requires the owner key to be available in the wallet.
- Return
the signed transaction updating the asset
- Parameters
symbol_or_id
: the symbol or id of the asset to updatenew_issuer
: if changing the asset’s issuer, the name or id of the new issuer.broadcast
: true to broadcast the transaction on the network
-
signed_transaction
update_bitasset
(const string &symbol_or_id, const bitasset_options &new_options, bool broadcast = false) const¶ Update the options specific to a BitAsset.
BitAssets have some options which are not relevant to other asset types. This operation is used to update those options an an existing BitAsset.
- See
- Return
the signed transaction updating the bitasset
- Parameters
symbol_or_id
: the symbol or id of the asset to update, which must be a market-issued assetnew_options
: the new bitasset_options object, which will entirely replace the existing options.broadcast
: true to broadcast the transaction on the network
-
signed_transaction
update_asset_feed_producers
(const string &symbol_or_id, const flat_set<string> &new_feed_producers, bool broadcast = false) const¶ Update the set of feed-producing accounts for a BitAsset.
BitAssets have price feeds selected by taking the median values of recommendations from a set of feed producers. This command is used to specify which accounts may produce feeds for a given BitAsset.
- Return
the signed transaction updating the bitasset’s feed producers
- Parameters
symbol_or_id
: the symbol or id of the asset to updatenew_feed_producers
: a list of account names or ids which are authorized to produce feeds for the asset. this list will completely replace the existing listbroadcast
: true to broadcast the transaction on the network
-
signed_transaction
publish_asset_feed
(const string &publishing_account, const string &symbol_or_id, const price_feed &feed, bool broadcast = false) const¶ Publishes a price feed for the named asset.
Price feed providers use this command to publish their price feeds for market-issued assets. A price feed is used to tune the market for a particular market-issued asset. For each value in the feed, the median across all committee_member feeds for that asset is calculated and the market for the asset is configured with the median of that value.
The feed object in this command contains three prices: a call price limit, a short price limit, and a settlement price. The call limit price is structured as (collateral asset) / (debt asset) and the short limit price is structured as (asset for sale) / (collateral asset). Note that the asset IDs are opposite to eachother, so if we’re publishing a feed for USD, the call limit price will be CORE/USD and the short limit price will be USD/CORE. The settlement price may be flipped either direction, as long as it is a ratio between the market-issued asset and its collateral.
- Return
the signed transaction updating the price feed for the given asset
- Parameters
publishing_account
: the account publishing the price feedsymbol_or_id
: the symbol or id of the asset whose feed we’re publishingfeed
: the price_feed object containing the three prices making up the feedbroadcast
: true to broadcast the transaction on the network
-
signed_transaction
fund_asset_fee_pool
(const string &from, const string &symbol_or_id, const string &amount, bool broadcast = false) const¶ Pay into the fee pool for the given asset.
User-issued assets can optionally have a pool of the core asset which is automatically used to pay transaction fees for any transaction using that asset (using the asset’s core exchange rate).
This command allows anyone to deposit the core asset into this fee pool.
- Return
the signed transaction funding the fee pool
- Parameters
from
: the name or id of the account sending the core assetsymbol_or_id
: the symbol or id of the asset whose fee pool you wish to fundamount
: the amount of the core asset to depositbroadcast
: true to broadcast the transaction on the network
-
signed_transaction
claim_asset_fee_pool
(const string &symbol_or_id, const string &amount, bool broadcast = false) const¶ Claim funds from the fee pool for the given asset.
User-issued assets can optionally have a pool of the core asset which is automatically used to pay transaction fees for any transaction using that asset (using the asset’s core exchange rate).
This command allows the issuer to withdraw those funds from the fee pool.
- Return
the signed transaction claiming from the fee pool
- Parameters
symbol_or_id
: the symbol or id of the asset whose fee pool you wish to claimamount
: the amount of the core asset to withdrawbroadcast
: true to broadcast the transaction on the network
-
signed_transaction
reserve_asset
(const string &from, const string &amount, const string &symbol_or_id, bool broadcast = false) const¶ Burns an amount of given asset to its reserve pool.
This command burns an amount of given asset to reduce the amount in circulation.
- Note
you cannot burn market-issued assets.
- Return
the signed transaction burning the asset
- Parameters
from
: the account containing the asset you wish to burnamount
: the amount to burn, in nominal unitssymbol_or_id
: the symbol or id of the asset to burnbroadcast
: true to broadcast the transaction on the network
-
signed_transaction
global_settle_asset
(const string &symbol_or_id, const price &settle_price, bool broadcast = false) const¶ Forces a global settling of the given asset (black swan or prediction markets).
In order to use this operation, asset_to_settle must have the
global_settle
permission setWhen this operation is executed all open margin positions are called at the settle price. A pool will be formed containing the collateral got from the margin positions. Users owning an amount of the asset may use
settle_asset()
to claim collateral instantly at the settle price from the pool. If this asset is used as backing for other bitassets, those bitassets will not be affected.- Note
this operation is used only by the asset issuer.
- Return
the signed transaction settling the named asset
- Parameters
symbol_or_id
: the symbol or id of the asset to globally settlesettle_price
: the price at which to settlebroadcast
: true to broadcast the transaction on the network
-
signed_transaction
settle_asset
(const string &account_to_settle, const string &amount_to_settle, const string &symbol_or_id, bool broadcast = false) const¶ Schedules a market-issued asset for automatic settlement.
Holders of market-issued assests may request a forced settlement for some amount of their asset. This means that the specified sum will be locked by the chain and held for the settlement period, after which time the chain will choose a margin posision holder and buy the settled asset using the margin’s collateral. The price of this sale will be based on the feed price for the market-issued asset being settled. The exact settlement price will be the feed price at the time of settlement with an offset in favor of the margin position, where the offset is a blockchain parameter set in the asset’s bitasset options.
- Return
the signed transaction settling the named asset
- Parameters
account_to_settle
: the name or id of the account owning the assetamount_to_settle
: the amount of the asset to schedule for settlementsymbol_or_id
: the symbol or id of the asset to settlebroadcast
: true to broadcast the transaction on the network
-
signed_transaction
bid_collateral
(const string &bidder, const string &debt_amount, const string &debt_symbol_or_id, const string &additional_collateral, bool broadcast = false) const¶ Creates or updates a bid on an MPA after global settlement.
In order to revive a market-pegged asset after global settlement (aka black swan), investors can bid collateral in order to take over part of the debt and the settlement fund, see BSIP-0018. Updating an existing bid to cover 0 debt will delete the bid.
- Return
the signed transaction creating/updating the bid
- Parameters
bidder
: the name or id of the account making the biddebt_amount
: the amount of debt of the named asset to bid fordebt_symbol_or_id
: the symbol or id of the MPA to bid foradditional_collateral
: the amount of additional collateral to bid for taking over debt_amount. The asset type of this amount is determined automatically fromdebt_symbol_or_id
.broadcast
: true to broadcast the transaction on the network
-
signed_transaction
whitelist_account
(const string &authorizing_account, const string &account_to_list, account_whitelist_operation::account_listing new_listing_status, bool broadcast = false) const¶ 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.
- Return
the signed transaction changing the whitelisting status
- Parameters
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
-
signed_transaction
create_committee_member
(const string &owner_account, const string &url, bool broadcast = false) const¶ Creates a committee_member object owned by the given account.
An account can have at most one committee_member object.
- Return
the signed transaction registering a committee_member
- Parameters
owner_account
: the name or id of the account which is creating the committee_memberurl
: a URL to include in the committee_member record in the blockchain. Clients may display this when showing a list of committee_members. May be blank.broadcast
: true to broadcast the transaction on the network
-
map<string, witness_id_type, std::less<>>
list_witnesses
(const string &lowerbound, uint32_t limit) const¶ Lists all witnesses registered in the blockchain. This returns a list of all account names that own witnesses, and the associated witness id, sorted by name. This lists witnesses whether they are currently voted in or not.
Use the
lowerbound
and limit parameters to page through the list. To retrieve all witnesss, start by settinglowerbound
to the empty string""
, and then each iteration, pass the last witness name returned as thelowerbound
for the nextlist_witnesss()
call.- Return
a list of witnesss mapping witness names to witness ids
- Parameters
lowerbound
: the name of the first witness to return. If the named witness does not exist, the list will start at the witness that comes afterlowerbound
limit
: the maximum number of witnesss to return (max: 1000)
-
map<string, committee_member_id_type, std::less<>>
list_committee_members
(const string &lowerbound, uint32_t limit) const¶ Lists all committee_members registered in the blockchain. This returns a list of all account names that own committee_members, and the associated committee_member id, sorted by name. This lists committee_members whether they are currently voted in or not.
Use the
lowerbound
and limit parameters to page through the list. To retrieve all committee_members, start by settinglowerbound
to the empty string""
, and then each iteration, pass the last committee_member name returned as thelowerbound
for the nextlist_committee_members()
call.- Return
a list of committee_members mapping committee_member names to committee_member ids
- Parameters
lowerbound
: the name of the first committee_member to return. If the named committee_member does not exist, the list will start at the committee_member that comes afterlowerbound
limit
: the maximum number of committee_members to return (max: 1000)
-
witness_object
get_witness
(const string &owner_account) const¶ Returns information about the given witness.
- Return
the information about the witness stored in the block chain
- Parameters
owner_account
: the name or id of the witness account owner, or the id of the witness
-
committee_member_object
get_committee_member
(const string &owner_account) const¶ Returns information about the given committee_member.
- Return
the information about the committee_member stored in the block chain
- Parameters
owner_account
: the name or id of the committee_member account owner, or the id of the committee_member
-
signed_transaction
create_witness
(const string &owner_account, const string &url, bool broadcast = false) const¶ Creates a witness object owned by the given account.
An account can have at most one witness object.
- Return
the signed transaction registering a witness
- Parameters
owner_account
: the name or id of the account which is creating the witnessurl
: a URL to include in the witness record in the blockchain. Clients may display this when showing a list of witnesses. May be blank.broadcast
: true to broadcast the transaction on the network
-
signed_transaction
update_witness
(const string &witness_name, const string &url, const string &block_signing_key, bool broadcast = false) const¶ Update a witness object owned by the given account.
- Return
the signed transaction
- Parameters
witness_name
: The name of the witness’s owner account. Also accepts the ID of the owner account or the ID of the witness.url
: Same as for create_witness. The empty string makes it remain the same.block_signing_key
: The new block signing public key. The empty string makes it remain the same.broadcast
: true if you wish to broadcast the transaction.
Create a worker object.
- Return
the signed transaction
- Parameters
owner_account
: The account which owns the worker and will be paidwork_begin_date
: When the work beginswork_end_date
: When the work endsdaily_pay
: Amount of pay per day (NOT per maint interval)name
: Any texturl
: Any textworker_settings
: {“type” : “burn”|”refund”|”vesting”, “pay_vesting_period_days” : x}broadcast
: true if you wish to broadcast the transaction.
-
signed_transaction
update_worker_votes
(const string &account, const worker_vote_delta &delta, bool broadcast = false) const¶ Update your votes for workers
- Return
the signed transaction
- Parameters
account
: The account which will pay the fee and update votes.delta
: {“vote_for” : […], “vote_against” : […], “vote_abstain” : […]}broadcast
: true if you wish to broadcast the transaction.
-
signed_transaction
htlc_create
(const string &source, const string &destination, const string &amount, const string &asset_symbol_or_id, const string &hash_algorithm, const string &preimage_hash, uint32_t preimage_size, uint32_t claim_period_seconds, const string &memo, bool broadcast = false) const¶ Create a hashed time lock contract
- Return
the signed transaction
- Parameters
source
: The account that will reserve the funds (and pay the fee)destination
: The account that will receive the funds if the preimage is presentedamount
: the amount of the asset that is to be tradedasset_symbol_or_id
: The asset that is to be tradedhash_algorithm
: the algorithm used to generate the hash from the preimage. Can be RIPEMD160 or SHA256.preimage_hash
: the hash of the preimagepreimage_size
: the size of the preimage in bytesclaim_period_seconds
: how long after creation until the lock expiresmemo
: the memobroadcast
: true if you wish to broadcast the transaction
-
vector<vesting_balance_object_with_info>
get_vesting_balances
(const string &account_name) const¶ Get information about a vesting balance object or vesting balance objects owned by an account.
- Return
a list of vesting balance objects with additional info
- Parameters
account_name
: An account name, account ID, or vesting balance object ID.
-
signed_transaction
withdraw_vesting
(const string &witness_name, const string &amount, const string &asset_symbol_or_id, bool broadcast = false) const¶ Withdraw a vesting balance.
- Return
the signed transaction
- Parameters
witness_name
: The account name of the witness, also accepts account ID or vesting balance ID type.amount
: The amount to withdraw.asset_symbol_or_id
: The symbol or id of the asset to withdraw.broadcast
: true if you wish to broadcast the transaction
-
signed_transaction
vote_for_committee_member
(const string &voting_account, const string &committee_member, bool approve, bool broadcast = false) const¶ Vote for a given committee_member.
An account can publish a list of all committee_members they approve of. This command allows you to add or remove committee_members from this list. Each account’s vote is weighted according to the number of voting stake owned by that account at the time the votes are tallied.
- Note
you cannot vote against a committee_member, you can only vote for the committee_member or not vote for the committee_member.
- Return
the signed transaction changing your vote for the given committee_member
- Parameters
voting_account
: the name or id of the account who is voting with their stakecommittee_member
: the name or id of the committee_member’s owner accountapprove
: true if you wish to vote in favor of that committee_member, false to remove your vote in favor of that committee_memberbroadcast
: true if you wish to broadcast the transaction
-
signed_transaction
vote_for_witness
(const string &voting_account, const string &witness, bool approve, bool broadcast = false) const¶ Vote for a given witness.
An account can publish a list of all witnesses they approve of. This command allows you to add or remove witnesses from this list. Each account’s vote is weighted according to the number of voting stake owned by that account at the time the votes are tallied.
- Note
you cannot vote against a witness, you can only vote for the witness or not vote for the witness.
- Return
the signed transaction changing your vote for the given witness
- Parameters
voting_account
: the name or id of the account who is voting with their stakewitness
: the name or id of the witness’ owner accountapprove
: true if you wish to vote in favor of that witness, false to remove your vote in favor of that witnessbroadcast
: true if you wish to broadcast the transaction
-
signed_transaction
set_voting_proxy
(const string &account_to_modify, const optional<string> &voting_account, bool broadcast = false) const¶ Set the voting proxy for an account.
If a user does not wish to take an active part in voting, they can choose to allow another account to vote their stake.
Setting a vote proxy does not remove your previous votes from the blockchain, they remain there but are ignored. If you later null out your vote proxy, your previous votes will take effect again.
This setting can be changed at any time.
- Return
the signed transaction changing your vote proxy settings
- Parameters
account_to_modify
: the name or id of the account to updatevoting_account
: the name or id of an account authorized to vote account_to_modify’s stake, or null to vote your own stakebroadcast
: true if you wish to broadcast the transaction
-
signed_transaction
set_desired_witness_and_committee_member_count
(const string &account_to_modify, uint16_t desired_number_of_witnesses, uint16_t desired_number_of_committee_members, bool broadcast = false) const¶ Set your vote for the number of witnesses and committee_members in the system.
Each account can voice their opinion on how many committee_members and how many witnesses there should be in the active committee_member/active witness list. These are independent of each other. You must vote your approval of at least as many committee_members or witnesses as you claim there should be (you can’t say that there should be 20 committee_members but only vote for 10).
There are maximum values for each set in the blockchain parameters (currently defaulting to 1001).
This setting can be changed at any time. If your account has a voting proxy set, your preferences will be ignored.
- Return
the signed transaction changing your vote proxy settings
- Parameters
account_to_modify
: the name or id of the account to updatedesired_number_of_witnesses
: desired number of active witnessesdesired_number_of_committee_members
: desired number of active committee membersbroadcast
: true if you wish to broadcast the transaction
-
signed_transaction
sign_transaction
(const signed_transaction &tx, bool broadcast = false) const¶ Signs a transaction.
Given a fully-formed transaction that is only lacking signatures, this signs the transaction with the necessary keys and optionally broadcasts the transaction
- Return
the signed version of the transaction
- Parameters
tx
: the transaction to be signedbroadcast
: true if you wish to broadcast the transaction
-
signed_transaction
sign_transaction2
(const signed_transaction &tx, const vector<public_key_type> &signing_keys = vector<public_key_type>(), bool broadcast = true) const¶ Signs a transaction.
Given a fully-formed transaction that is only lacking signatures, this signs the transaction with the inferred necessary keys and the explicitly provided keys, and optionally broadcasts the transaction
- Return
the signed version of the transaction
- Parameters
tx
: the transaction to be signedsigning_keys
: Keys that must be used when signing the transactionbroadcast
: true if you wish to broadcast the transaction
-
flat_set<public_key_type>
get_transaction_signers
(const signed_transaction &tx) const¶ Get transaction signers.
Returns information about who signed the transaction, specifically, the corresponding public keys of the private keys used to sign the transaction.
- Return
the set of public_keys
- Parameters
tx
: the signed transaction
-
vector<flat_set<account_id_type>>
get_key_references
(const vector<public_key_type> &keys) const¶ Get key references.
Returns accounts related to given public keys.
- Return
the set of related accounts
- Parameters
keys
: public keys to search for related accounts
-
operation
get_prototype_operation
(const string &operation_type) const¶ Returns an uninitialized object representing a given blockchain operation.
This returns a default-initialized object of the given type. It can be used during early development of the wallet when we don’t yet have custom commands for creating all of the operations the blockchain supports.
Any operation the blockchain supports can be created using the transaction builder’s
add_operation_to_builder_transaction()
, but to do that from the CLI you need to know what the JSON form of the operation looks like. This will give you a template you can fill in. It’s better than nothing.- Return
a default-constructed operation of the given type
- Parameters
operation_type
: the type of operation to return, must be one of the operations defined ingraphene/protocol/operations.hpp
(e.g., “global_parameters_update_operation”)
-
signed_transaction
propose_parameter_change
(const string &proposing_account, const time_point_sec &expiration_time, const variant_object &changed_values, bool broadcast = false) const¶ Creates a transaction to propose a parameter change.
Multiple parameters can be specified if an atomic change is desired.
- Return
the signed version of the transaction
- Parameters
proposing_account
: The account paying the fee to propose the txexpiration_time
: Timestamp specifying when the proposal will either take effect or expire.changed_values
: The values to change. All other chain parameters are filled in with default valuesbroadcast
: true if you wish to broadcast the transaction
-
signed_transaction
propose_fee_change
(const string &proposing_account, const time_point_sec &expiration_time, const variant_object &changed_values, bool broadcast = false) const¶ Propose a fee change.
- Return
the signed version of the transaction
- Parameters
proposing_account
: The account paying the fee to propose the txexpiration_time
: Timestamp specifying when the proposal will either take effect or expire.changed_values
: Map of operation type to new fee. Operations may be specified by name or ID. The “scale” key changes the scale. All other operations will maintain current values.broadcast
: true if you wish to broadcast the transaction
-
signed_transaction
approve_proposal
(const string &fee_paying_account, const string &proposal_id, const approval_delta &delta, bool broadcast) const¶ Approve or disapprove a proposal.
- Return
the signed version of the transaction
- Parameters
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
-
order_book
get_order_book
(const string &base, const string "e, uint32_t limit = 50) const¶ Returns the order book for the market base:quote.
- Return
Order book of the market
- Parameters
base
: symbol or ID of the base assetquote
: symbol or ID of the quote assetlimit
: depth of the order book to retrieve, for bids and asks each, capped at 50
-
signed_transaction
add_transaction_signature
(const signed_transaction &tx, bool broadcast = false) const¶ Signs a transaction.
Given a fully-formed transaction with or without signatures, signs the transaction with the owned keys and optionally broadcasts the transaction.
- Return
the signed transaction
- Parameters
tx
: the transaction to add signature tobroadcast
: true if you wish to broadcast the transaction
-
blind_confirmation
blind_transfer_help
(const string &from_key_or_label, const string &to_key_or_label, const string &amount, const string &symbol, bool broadcast = false, bool to_temp = false) const¶ Used to transfer from one set of blinded balances to another
-
signed_transaction
account_store_map
(const string &account, const string &catalog, bool is_to_remove, const flat_map<string, optional<string>> &key_values, bool broadcast) const¶ Manage account storage map(key->value) by using the custom operations plugin.
Each account can optionally add random information in the form of a key-value map to be retrieved by any interested party.
- Return
The signed transaction
- Parameters
account
: The account name or ID that we are adding additional information to.catalog
: The name of the catalog the operation will insert data to.is_to_remove
: true if you want to remove stuff from a catalog.key_values
: The map to be inserted/removed to/from the catalogbroadcast
: true if you wish to broadcast the transaction
-
vector<account_storage_object>
get_account_storage
(const string &account, const string &catalog) const¶ Get
account_storage_object
of an account by using the custom operations plugin.Storage data added to the map with account_store_map will be returned.
- Return
An
account_storage_object
or empty.- Parameters
account
: Account name or ID to get stored data from.catalog
: The catalog to retrieve.
-
bool
-
struct
wallet_data
¶ - #include <wallet_structs.hpp>
-
namespace
detail
¶ Functions
-
static const string graphene::wallet::detail::ENC_HEADER("-----BEGIN BITSHARES SIGNED MESSAGE-----n")
-
static const string graphene::wallet::detail::ENC_META("-----BEGIN META-----n")
-
static const string graphene::wallet::detail::ENC_SIG("-----BEGIN SIGNATURE-----n")
-
static const string graphene::wallet::detail::ENC_FOOTER("-----END BITSHARES SIGNED MESSAGE-----")
-
string
address_to_shorthash
(const graphene::protocol::address &addr)¶
-
fc::ecc::private_key
derive_private_key
(const std::string &prefix_string, int sequence_number)¶
-
string
normalize_brain_key
(string s)¶
-
static string
meta_extract
(const string &meta, const string &key)¶
-
template<typename
WorkerInit
>
static WorkerInit_create_worker_initializer
(const variant &worker_settings)¶
-
struct
operation_printer
¶ - #include <operation_printer.hpp>
Public Types
-
typedef std::string
result_type
¶ Return the decrypted memo if a memo exists, otherwise return an empty string.
-
typedef std::string
-
class
wallet_api_impl
¶ - #include <wallet_api_impl.hpp>
Public Functions
-
bool
copy_wallet_file
(string destination_filename)¶ make a copy of the wallet file Note: this will not overwrite. It simply adds a version suffix.
- Parameters
destination_filename
: the filename to save it to
-
set<public_key_type>
get_owned_required_keys
(signed_transaction &tx, bool erase_existing_sigs = true)¶ Get the required public keys to sign the transaction which had been owned by us
NOTE, if
erase_existing_sigs
set to true, the original trasaction’s signatures will be erased- Parameters
tx
: The transaction to be signederase_existing_sigs
: The transaction could have been partially signed already, if set to false, the corresponding public key of existing signatures won’t be returned. If set to true, the existing signatures will be erased and all required keys returned.
-
bool
-
-
using