BitShares Forum
Main => 中文 (Chinese) => Topic started by: btsw on April 27, 2019, 12:13:46 pm
-
cliwallet code
下面这两个不用管,命令行复制时顺带的。
unlocked >>>
locked >>>
1.
signed_transaction withdraw_vesting(string witness_name, string amount, string asset_symbol, bool broadcast)
unlocked >>> gethelp withdraw_vesting
gethelp withdraw_vesting
Withdraw a vesting balance.
Parameters:
witness_name: The account name of the witness, also accepts account ID
or vesting balance ID type. (type: string)
amount: The amount to withdraw. (type: string)
asset_symbol: The symbol of the asset to withdraw. (type: string)
broadcast: true if you wish to broadcast the transaction (type: bool)
2.
signed_transaction whitelist_account(string authorizing_account, string account_to_list, account_whitelist_operation::account_listing new_listing_status, bool broadcast)
unlocked >>> gethelp withdraw_vesting
gethelp withdraw_vesting
Withdraw a vesting balance.
Parameters:
witness_name: The account name of the witness, also accepts account ID
or vesting balance ID type. (type: string)
amount: The amount to withdraw. (type: string)
asset_symbol: The symbol of the asset to withdraw. (type: string)
broadcast: true if you wish to broadcast the transaction (type: bool)
unlocked >>> gethelp whitelist_account
gethelp 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.
Parameters:
authorizing_account: the account who is doing the whitelisting (type:
string)
account_to_list: the account being whitelisted (type: string)
new_listing_status: the new whitelisting status (type:
account_whitelist_operation::account_listing)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction changing the whitelisting status
3.
signed_transaction approve_proposal(const string & fee_paying_account, const string & proposal_id, const approval_delta & delta, bool broadcast)
unlocked >>> gethelp approve_proposal
gethelp approve_proposal
Approve or disapprove a proposal.
Parameters:
fee_paying_account: The account paying the fee for the op. (type: const
string &)
proposal_id: The proposal to modify. (type: const string &)
delta: Members contain approvals to create or remove. In JSON you can
leave empty members undefined. (type: const approval_delta &)
broadcast: true if you wish to broadcast the transaction (type: bool)
Returns
the signed version of the transaction
4.
signed_transaction bid_collateral(string bidder_name, string debt_amount, string debt_symbol, string additional_collateral, bool broadcast)
unlocked >>> gethelp bid_collateral
gethelp bid_collateral
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.
Parameters:
bidder_name: the name or id of the account making the bid (type:
string)
debt_amount: the amount of debt of the named asset to bid for (type:
string)
debt_symbol: the name or id of the MPA to bid for (type: string)
additional_collateral: the amount of additional collateral to bid for
taking over debt_amount. The asset type of this amount is
determined automatically from debt_symbol. (type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction creating/updating the bid
5.
vector<blind_receipt> blind_history(string key_or_account)
gethelp bid_collateral
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.
Parameters:
bidder_name: the name or id of the account making the bid (type:
string)
debt_amount: the amount of debt of the named asset to bid for (type:
string)
debt_symbol: the name or id of the MPA to bid for (type: string)
additional_collateral: the amount of additional collateral to bid for
taking over debt_amount. The asset type of this amount is
determined automatically from debt_symbol. (type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction creating/updating the bid
unlocked >>> gethelp blind_history
gethelp blind_history
Returns
all blind receipts to/form a particular account
6.
blind_confirmation blind_transfer(string from_key_or_label, string to_key_or_label, string amount, string symbol, bool broadcast)
unlocked >>> gethelp blind_history
gethelp blind_history
Returns
all blind receipts to/form a particular account
unlocked >>> gethelp blind_transfer
gethelp blind_transfer
Used to transfer from one set of blinded balances to another
7.
signed_transaction borrow_asset(string borrower_name, string amount_to_borrow, string asset_symbol, string amount_of_collateral, bool broadcast)
unlocked >>> gethelp borrow_asset
gethelp borrow_asset
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.
Parameters:
borrower_name: the name or id of the account associated with the
transaction. (type: string)
amount_to_borrow: the amount of the asset being borrowed. Make this
value negative to pay back debt. (type: string)
asset_symbol: the symbol or id of the asset being borrowed. (type:
string)
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 the 'bitasset_options'
for the asset being borrowed. (type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction borrowing the asset
8.signed_transaction borrow_asset_ext(string borrower_name, string amount_to_borrow, string asset_symbol, string amount_of_collateral, call_order_update_operation::extensions_type extensions, bool broadcast)
pair<transaction_id_type, signed_transaction> broadcast_transaction(signed_transaction tx)
unlocked >>> gethelp borrow_asset_ext
gethelp borrow_asset_ext
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.
Parameters:
borrower_name: the name or id of the account associated with the
transaction. (type: string)
amount_to_borrow: the amount of the asset being borrowed. Make this
value negative to pay back debt. (type: string)
asset_symbol: the symbol or id of the asset being borrowed. (type:
string)
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 the 'bitasset_options'
for the asset being borrowed. (type: string)
extensions: additional options (type:
call_order_update_operation::extensions_type)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction borrowing the asset
9.signed_transaction cancel_order(object_id_type order_id, bool broadcast)
unlocked >>> gethelp cancel_order
gethelp cancel_order
Cancel an existing order
Parameters:
order_id: the id of order to be cancelled (type: object_id_type)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction canceling the order
10.
signed_transaction claim_asset_fee_pool(string symbol, string amount, bool broadcast)
unlocked >>> gethelp claim_asset_fee_pool
gethelp claim_asset_fee_pool
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.
Parameters:
symbol: the name or id of the asset whose fee pool you wish to claim
(type: string)
amount: the amount of the core asset to withdraw (type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction claiming from the fee pool
11.
signed_transaction create_account_with_brain_key(string brain_key, string account_name, string registrar_account, string referrer_account, bool broadcast)
unlocked >>> gethelp create_account_with_brain_key
gethelp create_account_with_brain_key
usage: create_account_with_brain_key BRAIN_KEY ACCOUNT_NAME REGISTRAR REFERRER BROADCAST
example: create_account_with_brain_key "my really long brain key" "newaccount" "1.3.11" "1.3.11" true
example: create_account_with_brain_key "my really long brain key" "newaccount" "someaccount" "otheraccount" true
This method should be used if you would like the wallet to generate new keys derived from the brain key.
The BRAIN_KEY will be used as the owner key, and the active key will be derived from the BRAIN_KEY. Use
register_account if you already know the keys you know the public keys that you would like to register.
12.
signed_transaction create_asset(string issuer, string symbol, uint8_t precision, asset_options common, fc::optional<bitasset_options> bitasset_opts, bool broadcast)
unlocked >>> gethelp create_asset
gethelp create_asset
usage: ISSUER SYMBOL PRECISION_DIGITS OPTIONS BITASSET_OPTIONS BROADCAST
PRECISION_DIGITS: the number of digits after the decimal point
Example value of OPTIONS:
{
"max_supply": "1000000000000000",
"market_fee_percent": 0,
"max_market_fee": "1000000000000000",
"issuer_permissions": 79,
"flags": 0,
"core_exchange_rate": {
"base": {
"amount": 0,
"asset_id": "1.3.0"
},
"quote": {
"amount": 0,
"asset_id": "1.3.1"
}
},
"whitelist_authorities": [],
"blacklist_authorities": [],
"whitelist_markets": [],
"blacklist_markets": [],
"description": "",
"extensions": []
}
Example value of BITASSET_OPTIONS:
{
"feed_lifetime_sec": 86400,
"minimum_feeds": 1,
"force_settlement_delay_sec": 86400,
"force_settlement_offset_percent": 0,
"maximum_force_settlement_volume": 2000,
"short_backing_asset": "1.3.0",
"extensions": []
}
BITASSET_OPTIONS may be null
13.
signed_transaction create_committee_member(string owner_account, string url, bool broadcast)
unlocked >>> gethelp create_committee_member
gethelp create_committee_member
Creates a committee_member object owned by the given account.
An account can have at most one committee_member object.
Parameters:
owner_account: the name or id of the account which is creating the
committee_member (type: string)
url: 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. (type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction registering a committee_member
14.
signed_transaction create_witness(string owner_account, string url, bool broadcast)
unlocked >>> gethelp create_witness
gethelp create_witness
Creates a witness object owned by the given account.
An account can have at most one witness object.
Parameters:
owner_account: the name or id of the account which is creating the
witness (type: string)
url: a URL to include in the witness record in the blockchain. Clients
may display this when showing a list of witnesses. May be blank.
(type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction registering a witness
15.
signed_transaction create_worker(string owner_account, time_point_sec work_begin_date, time_point_sec work_end_date, share_type daily_pay, string name, string url, variant worker_settings, bool broadcast)
unlocked >>> gethelp create_worker
gethelp create_worker
Create a worker object.
Parameters:
owner_account: The account which owns the worker and will be paid
(type: string)
work_begin_date: When the work begins (type: time_point_sec)
work_end_date: When the work ends (type: time_point_sec)
daily_pay: Amount of pay per day (NOT per maint interval) (type:
share_type)
name: Any text (type: string)
url: Any text (type: string)
worker_settings: {"type" : "burn"|"refund"|"vesting",
"pay_vesting_period_days" : x} (type: variant)
broadcast: true if you wish to broadcast the transaction. (type: bool)
16
void dbg_generate_blocks(std::string debug_wif_key, uint32_t count)
void dbg_make_mia(string creator, string symbol)
void dbg_make_uia(string creator, string symbol)
void dbg_push_blocks(std::string src_filename, uint32_t count)
void dbg_stream_json_objects(const std::string & filename)
void dbg_update_object(fc::variant_object update)
17
vector<brain_key_info> derive_owner_keys_from_brain_key(string brain_key, int number_of_desired_keys)
map<public_key_type, string> dump_private_keys()
unlocked >>> gethelp derive_owner_keys_from_brain_key
gethelp derive_owner_keys_from_brain_key
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.
Parameters:
brain_key: Brain key (type: string)
number_of_desired_keys: Number of desired keys (type: int)
Returns
A list of keys that are deterministically derived from the brainkey
18
vector<brain_key_info> derive_owner_keys_from_brain_key(string brain_key, int number_of_desired_keys)
map<public_key_type, string> dump_private_keys()
unlocked >>> gethelp derive_owner_keys_from_brain_key
gethelp derive_owner_keys_from_brain_key
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.
Parameters:
brain_key: Brain key (type: string)
number_of_desired_keys: Number of desired keys (type: int)
Returns
A list of keys that are deterministically derived from the brainkey
19
void flood_network(string prefix, uint32_t number_of_transactions)
20
signed_transaction fund_asset_fee_pool(string from, string symbol, string amount, bool broadcast)
unlocked >>> gethelp fund_asset_fee_pool
gethelp fund_asset_fee_pool
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.
Parameters:
from: the name or id of the account sending the core asset (type:
string)
symbol: the name or id of the asset whose fee pool you wish to fund
(type: string)
amount: the amount of the core asset to deposit (type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction funding the fee pool
21.
account_object get_account(string account_name_or_id)
unlocked >>> gethelp get_account
gethelp get_account
Returns information about the given account.
Parameters:
account_name_or_id: the name or id of the account to provide
information about (type: string)
Returns
the public account data stored in the blockchain
22.
uint64_t get_account_count()
unlocked >>> gethelp get_account_count
gethelp get_account_count
Returns the number of accounts registered on the blockchain
Returns
the number of registered accounts
23.
vector<operation_detail> get_account_history(string name, int limit)
unlocked >>> gethelp get_account_history
gethelp 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.
Parameters:
name: the name or id of the account (type: string)
limit: the number of entries to return (starting from the most recent)
(type: int)
Returns
a list of 'operation_history_objects'
24
account_history_operation_detail get_account_history_by_operations(string name, vector<uint16_t> operation_types, uint32_t start, int limit)
unlocked >>> gethelp get_account_history_by_operations
gethelp get_account_history_by_operations
Get operations relevant to the specified account filtering by operation
type, with transaction id
Parameters:
name: the name or id of the account, whose history shoulde be queried
(type: string)
operation_types: The IDs of the operation we want to get operations in
the account( 0 = transfer , 1 = limit order create, ...) (type:
vector<uint16_t>)
start: the sequence number where to start looping back throw the
history (type: uint32_t)
limit: the max number of entries to return (from start number) (type:
int)
Returns
account_history_operation_detail
25.
account_id_type get_account_id(string account_name_or_id)
unlocked >>> gethelp get_account_id
gethelp get_account_id
Lookup the id of a named account.
Parameters:
account_name_or_id: the name of the account to look up (type: string)
Returns
the id of the named account
26
vector<limit_order_object> get_account_limit_orders(const string & name_or_id, const string & base, const string & quote, uint32_t limit, optional<limit_order_id_type> ostart_id, optional<price> ostart_price)
unlocked >>> gethelp get_account_limit_orders
gethelp get_account_limit_orders
Parameters:
name_or_id: The name or ID of an account to retrieve (type: const
string &)
base: Base asset (type: const string &)
quote: Quote asset (type: const string &)
limit: The limitation of items each query can fetch (max: 101) (type:
uint32_t)
ostart_id: Start order id, fetch orders which price are lower than or
equal to this order (type: optional<limit_order_id_type>)
ostart_price: Fetch orders with price lower than or equal to this price
(type: optional<price>)
Returns
List of orders from 'name_or_id' to the corresponding account
27
asset_object get_asset(string asset_name_or_id)
unlocked >>> gethelp get_asset
gethelp get_asset
Returns information about the given asset.
Parameters:
asset_name_or_id: the symbol or id of the asset in question (type:
string)
Returns
the information about the asset stored in the block chain
28
uint64_t get_asset_count()
unlocked >>> gethelp get_asset_count
gethelp get_asset_count
Returns assets count registered on the blockchain.
Returns
assets count
29
asset_bitasset_data_object get_bitasset_data(string asset_name_or_id)
unlocked >>> gethelp get_bitasset_data
gethelp get_bitasset_data
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()'.
Parameters:
asset_name_or_id: the symbol or id of the BitAsset in question (type:
string)
Returns
the BitAsset-specific data for this asset
30
optional<signed_block_with_info> get_block(uint32_t num)
31
vector<call_order_object> get_call_orders(string a, uint32_t limit)
32
vector<collateral_bid_object> get_collateral_bids(string asset, uint32_t limit, uint32_t start)
unlocked >>> gethelp get_collateral_bids
gethelp get_collateral_bids
Returns the collateral_bid object for the given MPA
Parameters:
asset: the name or id of the asset (type: string)
limit: the number of entries to return (type: uint32_t)
start: the sequence number where to start looping back throw the
history (type: uint32_t)
Returns
a list of 'collateral_bid_objects'
31
committee_member_object get_committee_member(string owner_account)
unlocked >>> gethelp get_committee_member
gethelp get_committee_member
Returns information about the given committee_member.
Parameters:
owner_account: the name or id of the committee_member account owner, or
the id of the committee_member (type: string)
Returns
the information about the committee_member stored in the block chain
32
dynamic_global_property_object get_dynamic_global_properties()
unlocked >>> gethelp get_dynamic_global_properties
gethelp get_dynamic_global_properties
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.
Returns
the dynamic global properties
33.
full_account get_full_account(const string & name_or_id)
locked >>> gethelp get_full_account
gethelp get_full_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.
Parameters:
name_or_id: Must be the name or ID of an account to retrieve (type:
const string &)
Returns
All info about the specified account
34
global_property_object get_global_properties()
locked >>> gethelp get_global_properties
gethelp get_global_properties
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.
Returns
the global properties
35
vector<limit_order_object> get_limit_orders(string a, string b, uint32_t limit)
vector<bucket_object> get_market_history(string symbol, string symbol2, uint32_t bucket, fc::time_point_sec start, fc::time_point_sec end)
36
variant get_object(object_id_type id)
locked >>> gethelp get_object
gethelp get_object
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 have 'get_account()', but this function will
work for any object.
Parameters:
id: the id of the object to return (type: object_id_type)
Returns
the requested object
37
order_book get_order_book(const string & base, const string & quote, unsigned limit)
用法 get_order_book CNY CTS 20
base 是基价 用来标价的
quote 是目标资产 20是查询有效条目数。
出来的是 价位 目标资产数量 折合基价资产数量 计加以上总价
38
string get_private_key(public_key_type pubkey)
locked >>> gethelp get_order_book
gethelp get_order_book
No help defined for method get_order_book
locked >>> gethelp get_private_key
gethelp get_private_key
Get the WIF private key corresponding to a public key. The private key must
already be in the wallet.
39
operation get_prototype_operation(string operation_type)
locked >>> gethelp get_prototype_operation
gethelp get_prototype_operation
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.
Parameters:
operation_type: the type of operation to return, must be one of the
operations defined in 'graphene/chain/operations.hpp' (e.g.,
"global_parameters_update_operation") (type: string)
Returns
a default-constructed operation of the given type
40
vector<operation_detail> get_relative_account_history(string name, uint32_t stop, int limit, uint32_t start)
locked >>> gethelp get_relative_account_history
gethelp get_relative_account_history
Returns the relative operations on the named account from start number.
Parameters:
name: the name or id of the account (type: string)
stop: Sequence number of earliest operation. (type: uint32_t)
limit: the number of entries to return (type: int)
start: the sequence number where to start looping back throw the
history (type: uint32_t)
Returns
a list of 'operation_history_objects'
41
vector<force_settlement_object> get_settle_orders(string a, uint32_t limit)
42
transaction_id_type get_transaction_id(const signed_transaction & trx)
locked >>> gethelp get_settle_orders
gethelp get_settle_orders
No help defined for method get_settle_orders
locked >>> gethelp get_transaction_id
gethelp get_transaction_id
This method is used to convert a JSON transaction to its transactin ID.
43
vector<vesting_balance_object_with_info> get_vesting_balances(string account_name)
locked >>> gethelp get_vesting_balances
gethelp get_vesting_balances
Get information about a vesting balance object.
Parameters:
account_name: An account name, account ID, or vesting balance object
ID. (type: string)
44
witness_object get_witness(string owner_account)
locked >>> gethelp get_witness
gethelp get_witness
Returns information about the given witness.
Parameters:
owner_account: the name or id of the witness account owner, or the id
of the witness (type: string)
Returns
the information about the witness stored in the block chain
45
string gethelp(const string & method)
46
signed_transaction global_settle_asset(string symbol, price settle_price, bool broadcast)
locked >>> gethelp global_settle_asset
gethelp global_settle_asset
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
flag set
When this operation is executed all balances are converted into the backing
asset at the settle_price and all open margin positions are called at the
settle price. If this asset is used as backing for other bitassets, those
bitassets will be force settled at their current feed price.
Parameters:
symbol: the name or id of the asset to force settlement on (type:
string)
settle_price: the price at which to settle (type: price)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction settling the named asset
47
bool import_account_keys(string filename, string password, string src_account_name, string dest_account_name)
48
bool import_account_keys(string filename, string password, string src_account_name, string dest_account_name)
map<string, bool> import_accounts(string filename, string password)
49
vector<signed_transaction> import_balance(string account_name_or_id, const vector<string> & wif_keys, bool broadcast)
locked >>> gethelp import_accounts
gethelp import_accounts
No help defined for method import_accounts
locked >>> gethelp import_balance
gethelp import_balance
This call will construct transaction(s) that will claim all balances
controled by wif_keys and deposit them into the given account.
50
locked >>> gethelp import_key
gethelp import_key
usage: import_key ACCOUNT_NAME_OR_ID WIF_PRIVATE_KEY
example: import_key "1.3.11" 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3
example: import_key "usera" 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3
-
51
variant info()
52
bool is_locked()
locked >>> gethelp is_locked
gethelp is_locked
Checks whether the wallet is locked (is unable to use its private keys).
This state can be changed by calling 'lock()' or 'unlock()'.
Returns
true if the wallet is locked
53
bool is_new()
locked >>> gethelp is_new
gethelp is_new
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.
Returns
true if the wallet is new
54
bool is_public_key_registered(string public_key)
locked >>> gethelp is_public_key_registered
gethelp is_public_key_registered
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
Parameters:
public_key: Public key (type: string)
Returns
Whether a public key is known
55
signed_transaction issue_asset(string to_account, string amount, string symbol, string memo, bool broadcast)
locked >>> gethelp issue_asset
gethelp issue_asset
Issue new shares of an asset.
Parameters:
to_account: the name or id of the account to receive the new shares
(type: string)
amount: the amount to issue, in nominal units (type: string)
symbol: the ticker symbol of the asset to issue (type: string)
memo: a memo to include in the transaction, readable by the recipient
(type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction issuing the new shares
56
vector<asset> list_account_balances(const string & id)
locked >>> gethelp list_account_balances
gethelp 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 nonzero balance
Parameters:
id: the name or id of the account whose balances you want (type: const
string &)
Returns
a list of the given account's balances
57
map<string, account_id_type> list_accounts(const string & lowerbound, uint32_t limit)
locked >>> gethelp list_accounts
gethelp 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.
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 after 'lowerbound' (type: const string &)
limit: the maximum number of accounts to return (max: 1000) (type:
uint32_t)
Returns
a list of accounts mapping account names to account ids
58
vector<asset_object> list_assets(const string & lowerbound, uint32_t limit)
locked >>> gethelp list_assets
gethelp list_assets
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.
Parameters:
lowerbound: the symbol of the first asset to include in the list.
(type: const string &)
limit: the maximum number of assets to return (max: 100) (type:
uint32_t)
Returns
the list of asset objects, ordered by symbol
59
map<string, committee_member_id_type> list_committee_members(const string & lowerbound, uint32_t limit)
locked >>> gethelp list_committee_members
gethelp list_committee_members
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 setting 'lowerbound' to the empty
string '""', and then each iteration, pass the last committee_member name
returned as the 'lowerbound' for the next 'list_committee_members()' call.
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 after 'lowerbound' (type: const string
&)
limit: the maximum number of committee_members to return (max: 1000)
(type: uint32_t)
Returns
a list of committee_members mapping committee_member names to
committee_member ids
60
vector<account_object> list_my_accounts()
locked >>> gethelp list_my_accounts
gethelp 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.
Returns
a list of account objects
61
map<string, witness_id_type> list_witnesses(const string & lowerbound, uint32_t limit)
locked >>> gethelp list_witnesses
gethelp list_witnesses
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 setting 'lowerbound' to the empty string
'""', and then each iteration, pass the last witness name returned as the
'lowerbound' for the next 'list_witnesss()' call.
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 after 'lowerbound' (type: const string &)
limit: the maximum number of witnesss to return (max: 1000) (type:
uint32_t)
Returns
a list of witnesss mapping witness names to witness ids
62
bool load_wallet_file(string wallet_filename)
locked >>> gethelp load_wallet_file
gethelp load_wallet_file
Loads a specified Graphene wallet.
The current wallet is closed before the new wallet is loaded.
Parameters:
wallet_filename: the filename of the wallet JSON file to load. If
'wallet_filename' is empty, it reloads the existing wallet file
(type: string)
Returns
true if the specified wallet is loaded
63
void lock()
locked >>> gethelp lock
gethelp lock
Locks the wallet immediately.
64
string normalize_brain_key(string s)
locked >>> gethelp network_get_connected_peers
gethelp network_get_connected_peers
No help defined for method network_get_connected_peers
locked >>> gethelp normalize_brain_key
gethelp normalize_brain_key
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.
Parameters:
s: the brain key as supplied by the user (type: string)
Returns
the brain key in its normalized form
65
signed_transaction propose_fee_change(const string & proposing_account, fc::time_point_sec expiration_time, const variant_object & changed_values, bool broadcast)
locked >>> gethelp propose_fee_change
gethelp propose_fee_change
Propose a fee change.
Parameters:
proposing_account: The account paying the fee to propose the tx (type:
const string &)
expiration_time: Timestamp specifying when the proposal will either
take effect or expire. (type: fc::time_point_sec)
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. (type: const
variant_object &)
broadcast: true if you wish to broadcast the transaction (type: bool)
Returns
the signed version of the transaction
66
transaction preview_builder_transaction(transaction_handle_type handle)
signed_transaction propose_builder_transaction(transaction_handle_type handle, time_point_sec expiration, uint32_t review_period_seconds, bool broadcast)
signed_transaction propose_builder_transaction2(transaction_handle_type handle, string account_name_or_id, time_point_sec expiration, uint32_t review_period_seconds, bool broadcast)
67
signed_transaction propose_parameter_change(const string & proposing_account, fc::time_point_sec expiration_time, const variant_object & changed_values, bool broadcast)
locked >>> gethelp propose_parameter_change
gethelp propose_parameter_change
Creates a transaction to propose a parameter change.
Multiple parameters can be specified if an atomic change is desired.
Parameters:
proposing_account: The account paying the fee to propose the tx (type:
const string &)
expiration_time: Timestamp specifying when the proposal will either
take effect or expire. (type: fc::time_point_sec)
changed_values: The values to change; all other chain parameters are
filled in with default values (type: const variant_object &)
broadcast: true if you wish to broadcast the transaction (type: bool)
Returns
the signed version of the transaction
68+
signed_transaction publish_asset_feed(string publishing_account, string symbol, price_feed feed, bool broadcast)
locked >>> gethelp publish_asset_feed
gethelp publish_asset_feed
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.
Parameters:
publishing_account: the account publishing the price feed (type:
string)
symbol: the name or id of the asset whose feed we're publishing (type:
string)
feed: the price_feed object containing the three prices making up the
feed (type: price_feed)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction updating the price feed for the given asset
69
locked >>> gethelp quit
gethelp quit
Quitting from BitShares wallet.
The current wallet will be closed.
70
string read_memo(const memo_data & memo)
locked >>> gethelp read_memo
gethelp read_memo
Read a memo.
Parameters:
memo: JSON-enconded memo. (type: const memo_data &)
Returns
string with decrypted message..
71
blind_receipt receive_blind_transfer(string confirmation_receipt, string opt_from, string opt_memo)
locked >>> gethelp receive_blind_transfer
gethelp receive_blind_transfer
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.
Parameters:
opt_from: if not empty and the sender is a unknown public key, then the
unknown public key will be given the label 'opt_from' (type:
string)
confirmation_receipt: a base58 encoded stealth confirmation (type:
string)
opt_memo: a self-defined label for this transfer to be saved in local
wallet file (type: string)
72
signed_transaction register_account(string name, public_key_type owner, public_key_type active, string registrar_account, string referrer_account, uint32_t referrer_percent, bool broadcast)
locked >>> gethelp register_account
gethelp register_account
usage: register_account ACCOUNT_NAME OWNER_PUBLIC_KEY ACTIVE_PUBLIC_KEY REGISTRAR REFERRER REFERRER_PERCENT BROADCAST
example: register_account "newaccount" "CORE6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV" "CORE6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV" "1.3.11" "1.3.11" 50 true
Use this method to register an account for which you do not know the private keys.
73
void remove_builder_transaction(transaction_handle_type handle)
void replace_operation_in_builder_transaction(transaction_handle_type handle, unsigned operation_index, const operation & new_op)
74
signed_transaction reserve_asset(string from, string amount, string symbol, bool broadcast)
locked >>> gethelp reserve_asset
gethelp reserve_asset
Burns the given user-issued asset.
This command burns the user-issued asset to reduce the amount in
circulation.
Parameters:
from: the account containing the asset you wish to burn (type: string)
amount: the amount to burn, in nominal units (type: string)
symbol: the name or id of the asset to burn (type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction burning the asset
75
save_wallet_file
locked >>> gethelp save_wallet_file
gethelp save_wallet_file
Saves the current wallet to the given filename.
Parameters:
wallet_filename: the filename of the new wallet JSON file to create or
overwrite. If 'wallet_filename' is empty, save to the current
filename. (type: string)
76
signed_transaction sell_asset(string seller_account, string amount_to_sell, string symbol_to_sell, string min_to_receive, string symbol_to_receive, uint32_t timeout_sec, bool fill_or_kill, bool broadcast)
locked >>> gethelp sell_asset
gethelp sell_asset
Place a limit order attempting to sell one asset for another.
Buying and selling are the same operation on Graphene; if you want to buy
BTS with USD, you should sell USD for BTS.
The blockchain will attempt to sell the 'symbol_to_sell' for as much
'symbol_to_receive' as possible, as long as the price is at least
'min_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.
Parameters:
seller_account: the account providing the asset being sold, and which
will receive the proceeds of the sale. (type: string)
amount_to_sell: the amount of the asset being sold to sell (in nominal
units) (type: string)
symbol_to_sell: the name or id of the asset to sell (type: string)
min_to_receive: the minimum amount you are willing to receive in return
for selling the entire amount_to_sell (type: string)
symbol_to_receive: the name or id of the asset you wish to receive
(type: string)
timeout_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
account (type: uint32_t)
fill_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. (type: bool)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction selling the funds
77
string serialize_transaction(signed_transaction tx)
locked >>> gethelp serialize_transaction
gethelp serialize_transaction
Converts a signed_transaction in JSON form to its binary representation.
Parameters:
tx: the transaction to serialize (type: signed_transaction)
Returns
the binary form of the transaction. It will not be hex encoded, this
returns a raw string that may have null characters embedded in it
78
signed_transaction set_desired_witness_and_committee_member_count(string account_to_modify, uint16_t desired_number_of_witnesses, uint16_t desired_number_of_committee_members, bool broadcast)
locked >>> gethelp set_desired_witness_and_committee_member_count
gethelp set_desired_witness_and_committee_member_count
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.
Parameters:
account_to_modify: the name or id of the account to update (type:
string)
desired_number_of_witnesses: desired number of active witnesses (type:
uint16_t)
desired_number_of_committee_members: desired number of active committee
members (type: uint16_t)
broadcast: true if you wish to broadcast the transaction (type: bool)
Returns
the signed transaction changing your vote proxy settings
79
signed_transaction set_voting_proxy(string account_to_modify, optional<string> voting_account, bool broadcast)
locked >>> gethelp set_voting_proxy
gethelp set_voting_proxy
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.
Parameters:
account_to_modify: the name or id of the account to update (type:
string)
voting_account: the name or id of an account authorized to vote
account_to_modify's shares, or null to vote your own shares (type:
optional<string>)
broadcast: true if you wish to broadcast the transaction (type: bool)
Returns
the signed transaction changing your vote proxy settings
80
signed_transaction settle_asset(string account_to_settle, string amount_to_settle, string symbol, bool broadcast)
locked >>> gethelp settle_asset
gethelp settle_asset
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
global_property_object.
Parameters:
account_to_settle: the name or id of the account owning the asset
(type: string)
amount_to_settle: the amount of the named asset to schedule for
settlement (type: string)
symbol: the name or id of the asset to settlement on (type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction settling the named asset
-
81
signed_transaction sign_builder_transaction(transaction_handle_type transaction_handle, bool broadcast)
82
memo_data sign_memo(string from, string to, string memo)
locked >>> gethelp sign_memo
gethelp sign_memo
Sign a memo message.
Parameters:
from: the name or id of signing account; or a public key. (type:
string)
to: the name or id of receiving account; or a public key. (type:
string)
memo: text to sign. (type: string)
83
signed_transaction sign_transaction(signed_transaction tx, bool broadcast)
locked >>> gethelp sign_transaction
gethelp sign_transaction
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
Parameters:
tx: the unsigned transaction (type: signed_transaction)
broadcast: true if you wish to broadcast the transaction (type: bool)
Returns
the signed version of the transaction
84
brain_key_info suggest_brain_key()
locked >>> gethelp sign_transaction
gethelp sign_transaction
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
Parameters:
tx: the unsigned transaction (type: signed_transaction)
broadcast: true if you wish to broadcast the transaction (type: bool)
Returns
the signed version of the transaction
locked >>> gethelp suggest_brain_key
gethelp 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).
Returns
a suggested brain_key
85
signed_transaction transfer(string from, string to, string amount, string asset_symbol, string memo, bool broadcast)
locked >>> gethelp transfer
gethelp transfer
usage: transfer FROM TO AMOUNT SYMBOL "memo" BROADCAST
example: transfer "1.3.11" "1.3.4" 1000.03 CORE "memo" true
example: transfer "usera" "userb" 1000.123 CORE "memo" true
86
pair<transaction_id_type, signed_transaction> transfer2(string from, string to, string amount, string asset_symbol, string memo)
locked >>> gethelp transfer
gethelp transfer
usage: transfer FROM TO AMOUNT SYMBOL "memo" BROADCAST
example: transfer "1.3.11" "1.3.4" 1000.03 CORE "memo" true
example: transfer "usera" "userb" 1000.123 CORE "memo" true
locked >>> gethelp transfer2
gethelp transfer2
This method works just like transfer, except it always broadcasts and
returns the transaction ID along with the signed transaction.
87
blind_confirmation transfer_from_blind(string from_blind_account_key_or_label, string to_account_id_or_name, string amount, string asset_symbol, bool broadcast)
locked >>> gethelp transfer_from_blind
gethelp transfer_from_blind
Transfers funds from a set of blinded balances to a public account balance.
88
blind_confirmation transfer_to_blind(string from_account_id_or_name, string asset_symbol, vector<pair<string, string>> to_amounts, bool broadcast)
locked >>> gethelp transfer_to_blind
gethelp transfer_to_blind
Transfers a public balance from 'from_account_id_or_name' to one or more
blinded balances using a stealth transfer.
89
void unlock(string password)
locked >>> gethelp unlock
gethelp unlock
Unlocks the wallet.
The wallet remain unlocked until the 'lock' is called or the program exits.
Parameters:
password: the password previously set with 'set_password()' (type:
string)
90
signed_transaction update_asset(string symbol, optional<string> new_issuer, asset_options new_options, bool broadcast)
locked >>> gethelp update_asset
gethelp update_asset
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.
Parameters:
symbol: the name or id of the asset to update (type: string)
new_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 asset (type:
optional<string>)
new_options: the new asset_options object, which will entirely replace
the existing options. (type: asset_options)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction updating the asset
91
signed_transaction update_asset_feed_producers(string symbol, flat_set<string> new_feed_producers, bool broadcast)
locked >>> gethelp update_asset_feed_producers
gethelp update_asset_feed_producers
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.
Parameters:
symbol: the name or id of the asset to update (type: string)
new_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 list (type: flat_set<string>)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction updating the bitasset's feed producers
92
signed_transaction update_asset_issuer(string symbol, string new_issuer, bool broadcast)
locked >>> gethelp update_asset_issuer
gethelp update_asset_issuer
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.
Parameters:
symbol: the name or id of the asset to update (type: string)
new_issuer: if changing the asset's issuer, the name or id of the new
issuer. (type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction updating the asset
93
signed_transaction update_bitasset(string symbol, bitasset_options new_options, bool broadcast)
locked >>> gethelp update_bitasset
gethelp update_bitasset
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.
Parameters:
symbol: the name or id of the asset to update, which must be a
market-issued asset (type: string)
new_options: the new bitasset_options object, which will entirely
replace the existing options. (type: bitasset_options)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction updating the bitasset
94
signed_transaction update_witness(string witness_name, string url, string block_signing_key, bool broadcast)
locked >>> gethelp update_witness
gethelp update_witness
Update a witness object owned by the given account.
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. (type: string)
url: Same as for create_witness. The empty string makes it remain the
same. (type: string)
block_signing_key: The new block signing public key. The empty string
makes it remain the same. (type: string)
broadcast: true if you wish to broadcast the transaction. (type: bool)
95
signed_transaction update_worker_votes(string account, worker_vote_delta delta, bool broadcast)
locked >>> gethelp update_worker_votes
gethelp update_worker_votes
Update your votes for a worker
Parameters:
account: The account which will pay the fee and update votes. (type:
string)
delta: {"vote_for" : [...], "vote_against" : [...], "vote_abstain" :
[...]} (type: worker_vote_delta)
broadcast: true if you wish to broadcast the transaction. (type: bool)
96+
signed_transaction upgrade_account(string name, bool broadcast)
locked >>> gethelp upgrade_account
gethelp upgrade_account
Upgrades an account to prime status. This makes the account holder a
'lifetime member'.
Parameters:
name: the name or id of the account to upgrade (type: string)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction upgrading the account
97
signed_transaction vote_for_committee_member(string voting_account, string committee_member, bool approve, bool broadcast)
locked >>> gethelp vote_for_committee_member
gethelp vote_for_committee_member
Vote for a given committee_member.
An account can publish a list of all committee_memberes they approve of.
This command allows you to add or remove committee_memberes from this list.
Each account's vote is weighted according to the number of shares of the
core asset owned by that account at the time the votes are tallied.
Parameters:
voting_account: the name or id of the account who is voting with their
shares (type: string)
committee_member: the name or id of the committee_member' owner account
(type: string)
approve: true if you wish to vote in favor of that committee_member,
false to remove your vote in favor of that committee_member (type:
bool)
broadcast: true if you wish to broadcast the transaction (type: bool)
Returns
the signed transaction changing your vote for the given
committee_member
98
signed_transaction vote_for_witness(string voting_account, string witness, bool approve, bool broadcast)
locked >>> gethelp vote_for_witness
gethelp vote_for_witness
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 shares of the core
asset owned by that account at the time the votes are tallied.
Parameters:
voting_account: the name or id of the account who is voting with their
shares (type: string)
witness: the name or id of the witness' owner account (type: string)
approve: true if you wish to vote in favor of that witness, false to
remove your vote in favor of that witness (type: bool)
broadcast: true if you wish to broadcast the transaction (type: bool)
Returns
the signed transaction changing your vote for the given witness
100
signed_transaction whitelist_account(string authorizing_account, string account_to_list, account_whitelist_operation::account_listing new_listing_status, bool broadcast)
locked >>> gethelp whitelist_account
gethelp 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.
Parameters:
authorizing_account: the account who is doing the whitelisting (type:
string)
account_to_list: the account being whitelisted (type: string)
new_listing_status: the new whitelisting status (type:
account_whitelist_operation::account_listing)
broadcast: true to broadcast the transaction on the network (type:
bool)
Returns
the signed transaction changing the whitelisting status
101
signed_transaction withdraw_vesting(string witness_name, string amount, string asset_symbol, bool broadcast)
locked >>> gethelp withdraw_vesting
gethelp withdraw_vesting
Withdraw a vesting balance.
Parameters:
witness_name: The account name of the witness, also accepts account ID
or vesting balance ID type. (type: string)
amount: The amount to withdraw. (type: string)
asset_symbol: The symbol of the asset to withdraw. (type: string)
broadcast: true if you wish to broadcast the transaction (type: bool)