16
中文 (Chinese) / Re: 重钱包命令Cli-wallet 老版本,手动复制出来。未排版。抄死我了
« on: April 27, 2019, 12:15:28 pm »
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
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