Using the CLI Wallet

A guide for node operators
1. Overview
When installing a node, the CLI wallet is crucial for completing the process. It's necessary for generating public-private key-pairs for security, block signing, and managing a backup node. It's also needed for creating a Witness or SON account. This guide will cover these topics and list all the most common functions that node operators use.
2. CLI Wallet Fundamentals
2.1. So... What is a CLI wallet?
CLI stands for "Command Line Interface" which means that the program uses the text-based command line window to take user input and show its output.
The Peerplays CLI wallet is a program (named cli_wallet) that is installed along with the node software when installing a Peerplays node on a server. It's used as a way to store your Peerplays account keys locally, and as a way to interact with the Peerplays chain for account and asset related transactions. You can also use the CLI wallet to lookup information from the chain.
2.2. CLI wallet security
The wallet is encrypted with a password of your choosing. Additionally it stores all keys locally, never exposing your keys to anyone as it signs transactions locally before transmitting them to the connected node. The node then broadcasts the signed transactions to the network.
The wallet creates a local wallet.json file that contains the encrypted private keys required to access the funds in your account.
2.3. CLI wallet prerequisites
2.3.1. Installation
If you have installed a Peerplays witness, API, seed, or SON node you already have the CLI wallet installed.
2.3.2. Connections
The CLI wallet requires a connection to a running node to reach the blockchain. You can run the wallet using your own node or another node which allows external connections. Either way, the node needs to be synced with the chain.
2.4. Running the CLI wallet
2.4.1. Using your own node
Once your node has synced with the blockchain, you can simply run the program:
Manual or GitLab Installed Nodes
Docker Installed Nodes
Manual or GitLab Installed Nodes
cli_wallet
Docker Installed Nodes
cd /home/ubuntu/peerplays-docker
sudo ./run.sh wallet
Since the node must be running, you will either have to open a new command line window or run the node in the background to run the CLI wallet.
2.4.2. Using an external node
You can choose to connect to someone else's running and synced node. In that case you can specify the connection as a program parameter:
Manual or GitLab Installed Nodes
Docker Installed Nodes
Manual or GitLab Installed Nodes
cli_wallet -s <Websocket Address>
Docker Installed Nodes
cd /home/ubuntu/peerplays-docker
sudo ./run.sh remote_wallet <Websocket Address>
The <Websocket Address> in the code above must be replaced with the address of some public node. The address will use the websocket or secure websocket protocol (ws:// or wss:// respectively). Some node operators may have mapped their websocket address to a more friendly looking domain name which can be used here as well.
It is completely safe to use the CLI wallet with an external node because your private keys are never sent to the remote server. 👍
2.5. Setting the password
If you have started the CLI wallet successfully, you will receive the new >>> prompt. At this point you'll be asked to set a password. Here's what you'll see:
Please use the set_password method to initialize a new wallet before continuing
new >>>
Type set_password followed by a password of your choice and hit enter. It will look like this:
new >>> set_password supersecretpassword
If the password was saved successfully, the prompt will change to locked >>>. At this point, the CLI wallet is locked and nobody can access it without the password you just set.
Be sure to remember / back up / save / write down your password (securely of course) because it can't be recovered if you lose it.
2.5. Unlocking the wallet
Then to unlock your wallet, you'll use the unlock command with your password and hit enter.
locked >>> unlock supersecretpassword
If successful, the prompt will now read unlocked >>>. Your wallet is now unlocked and ready for use.
2.6. Locking the wallet
After the CLI wallet has been unlocked, if there are any funds in the wallet, they are accessible. In general, lock the wallet and only unlock when it’s needed.
To lock it, type lock and hit enter.
unlocked >>> lock
The prompt will return to locked >>>.
2.7. Reset the password
If the current password needs to be changed, unlock the wallet and use set_password to do so.
Type set_password and the new password, then hit enter.
unlocked >>> set_password mynewsupersecretpw
2.8. Getting help
You can get more detailed information by issuing the gethelp command. Detailed explanations for most calls are available. For example:
unlocked >>> gethelp "list_account_balances"
You can also use the help command to get a list of all commands supported by the wallet. Note that you can use the help and gethelp commands even if the wallet is locked!
unlocked >>> help
3. Wallet Command Reference for Node Operators
Table of Contents
Commands for node installs
suggest_brain_key
get_private_key_from_password
import_key
upgrade_account
create_vesting_balance
create_witness
create_son
update_witness
update_son
get_private_key
dump_private_keys
get_account
get_witness
get_son
vote_for_witness
vote_for_son
3.1. suggest_brain_key
Suggests a safe brain key to use for creating your account keys. A brain key is a long passphrase that provides enough entropy to generate cryptographic keys. This function will suggest a suitably random string that should be easy to write down (and, with effort, memorize).
The GUI Wallet generates a brain key for your password when creating a new account. But in the case of the GUI Wallet, rather than a long passphrase (i.e. set of words), it generates a string of 52 random letters (a-z & A-Z) and numbers (0-9).
For example, the suggest_brain_key method could give you:
"EDIFICE PALLID ANOESIA STRIDE PARREL SPORTY AXIFORM INOPINE SWOONED TONETIC CORKER OATEN PUSHER MIN CERN TACT"
And the GUI Wallet could produce the password of:
EyqFQDRpydZJDgTV8EJIcpmPLhfmdq6Yjbo45pNsBe7wSJSpvq0v
Although they look different, both are brain keys and will work for generating public and private keys.
return type, namespace, & method
brain_key_info graphene::wallet::wallet_api::suggest_brain_key()const;
Function Call
Return
Function Call
Parameters
name
data type
description
details
ℹ This command has no parameters!
n/a
n/a
n/a
Example Call
suggest_brain_key
Return
Return Format
struct brain_key_info
{
   string brain_priv_key;
   string wif_priv_key;
   public_key_type pub_key;
};
Example Successful Return
suggest_brain_key
{
  "brain_priv_key": "EDIFICE PALLID ANOESIA STRIDE PARREL SPORTY AXIFORM INOPINE SWOONED TONETIC CORKER OATEN PUSHER MIN CERN TACT",
  "wif_priv_key": "5JyK47o1xFmA6fE4Z4Pgzcdd7dGhQnorW2sTPzPxeXH7QaT4eN6",
  "pub_key": "PPY6TK9mXBaFr8ewaJa9zpgbRQVN7VkvAKay4hHGA2hDceDQvrRBv"
}
Note that the returned "pub_key" value will be prefixed with:
"PPY" in mainnet (Alice) as per the example above
"TEST" in the public testnet (Beatrice)
3.2. get_private_key_from_password
Returns the public-private key-pair for the owner, active, or memo role for a given account and its password.
return type, namespace, & method
pair<public_key_type, string> graphene::wallet::wallet_api::get_private_key_from_password(
    string account,
    string role,
    string password
    )const;
Function Call
Return
Function Call
Parameters
name
data type
description
details
account
string
The account name we're creating keys for.
no quotes required.
role
string
The role we're creating keys for. One of: owner, active, or memo
no quotes required.
password
string
A brain key. It might be the password provided by the GUI wallet, or obtained from the suggest_brain_keycommand (brain_priv_key).
quotes required if there are spaces!
Example Call
get_private_key_from_password myaccountname1 owner "EDIFICE PALLID ANOESIA STRIDE PARREL SPORTY AXIFORM INOPINE SWOONED TONETIC CORKER OATEN PUSHER MIN CERN TACT"
Return
Return Format
pair<public_key_type, string>
[
  //the public key,
  //the private key
]
Example Successful Return
get_private_key_from_password myaccountname1 owner "EDIFICE PALLID ANOESIA STRIDE PARREL SPORTY AXIFORM INOPINE SWOONED TONETIC CORKER OATEN PUSHER MIN CERN TACT"
[
  "PPY8fAzCBgJhfL6YWsJUycw6SvU7VZnNgq4t5vuzEVP168PHVKJXn",
  "5Kbhg1xaW7hceZhqJSqg3yZ4gsAUdFaA5uD4yBiHME2SYLsa7bU"
]
3.3. import_key
Imports the private key for an existing account for use in the CLI Wallet. The private key must match either an owner key or an active key for the named account.
return type, namespace, & method
bool graphene::wallet::wallet_api::import_key(
    string account_name_or_id, 
    string wif_key);
Function Call
Return
Function Call
Parameters
name
data type
description
details
account_name_or_id
string
The name or id of the account that owns the key.
no quotes required.
wif_key
string
The private key.
no quotes required.
Example Call
import_key myaccountname1 5Kbhg1xaW7hceZhqJSqg3yZ4gsAUdFaA5uD4yBiHME2SYLsa7bU
Return
Return Format
true
#if successful
​
false
#if an error
Example Successful Return
import_key myaccountname1 5Kbhg1xaW7hceZhqJSqg3yZ4gsAUdFaA5uD4yBiHME2SYLsa7bU
true
3.4. upgrade_account
Upgrades an account to prime status. This makes the account holder a 'lifetime member'. This is necessary for the account to become a Witness or SON.
return type, namespace, & method
signed_transaction graphene::wallet::wallet_api::upgrade_account(
    string name, 
    bool broadcast);
Function Call
Return
Function Call
Parameters
name
data type
description
details
name
string
The name or id of the account to upgrade.
no quotes required.
broadcast
bool
true to broadcast the transaction on the network.
n/a
Note that this operation currently costs 5 PPY. That fee may change in the future.
Example Call
upgrade_account myaccountname1 true
Return
Return Format
{
  "ref_block_num": number,
  "ref_block_prefix": number,
  "expiration": "datetime",
  "operations": [],
  "extensions": [],
  "signatures": []
}
Example Successful Return
upgrade_account myaccountname1 true
{
  "ref_block_num": 10412,
  "ref_block_prefix": 1003801100,
  "expiration": "2015-02-05T00:11:00",
  "operations": [[
      8,{
        "fee": {
          "amount": 500000,
          "asset_id": "1.3.0"
        },
        "account_to_upgrade": "1.2.1234",
        "upgrade_to_lifetime_member": true,
        "extensions": []
      }
    ]
  ],
  "extensions": [],
  "signatures": [
    "268bd8....."
  ]
}
3.5. create_vesting_balance
Creates a vesting deposit owned by the given account. This is used to supply vested assets to operate certain nodes, such as a SON node. In the case of SONs, 100 PPY (at the time of writing) must be set aside in two separate vesting deposits (50 PPY each) to dedicate to the operation of the SON node transactions.
return type, namespace, & method
signed_transaction graphene::wallet::wallet_api::create_vesting_balance(
    string owner_account, 
    string amount,
    string asset_symbol,
    vesting_balance_type vesting_type,
    bool broadcast);
Function Call
Return
Function Call
Parameters
name
data type
description
details
owner_account
string
The name or id of the vesting balance owner and creator.
no quotes required.
amount
string
The amount to vest.
In nominal units. For example, enter 0.5 for half of a PPY.
asset_symbol
string
The symbol of the asset to vest.
no quotes required.
vesting_type
vesting_balance_type
One of normal, gpos, or son.
no quotes required.
broadcast
bool
true to broadcast the transaction on the network.
n/a
Example Call
create_vesting_balance myaccountname-son 50 PPY son true
Return
Return Format
{
  "ref_block_num": number,
  "ref_block_prefix": number,
  "expiration": "datetime",
  "operations": [],
  "extensions": [],
  "signatures": []
}
3.6. create_witness
Creates a witness object owned by the given account. An account can have at most one witness object.
return type, namespace, & method
signed_transaction graphene::wallet::wallet_api::create_witness(
    string owner_account, 
    string url,
    bool broadcast);
Function Call
Return
Function Call
Parameters
name
data type
description
details
owner_account
string
The name or id of the account which is creating the witness.
no quotes required.
url
string
a URL to include in the witness record in the blockchain. Clients may display this when showing a list of witnesses.
May be blank.
broadcast
bool
true to broadcast the transaction on the network.
n/a
Example Call
create_witness myaccountname1 "www.my-awesome-witness.com" true
Return
Return Format
{
  "ref_block_num": number,
  "ref_block_prefix": number,
  "expiration": "datetime",
  "operations": [],
  "extensions": [],
  "signatures": []
}
3.7. create_son
Creates a SON object owned by the given account. An account can have at most one SON object.
return type, namespace, & method
signed_transaction graphene::wallet::wallet_api::create_son(
    string owner_account,
    string url,
    vesting_balance_id_type deposit_id,
    vesting_balance_id_type pay_vb_id,
    flat_map<sidechain_type, string> sidechain_public_keys,
    bool broadcast);
Function Call
Return
Function Call
Parameters
name
data type
description
details
owner_account
string
The name or id of the account which is creating the SON.
no quotes required.
url
string
a URL to include in the SON record in the blockchain. Clients may display this when showing a list of SONs.
May be blank.
deposit_id
vesting_balance_id_type
vesting balance id for SON deposit.
This is the son vesting balance.
pay_vb_id
vesting_balance_id_type
vesting balance id for SON pay_vb
This is the normal vesting balance.
sidechain_public_keys
flat_map
The new set of sidechain public keys.
n/a
broadcast
bool
true to broadcast the transaction on the network.
n/a
Example Call
create_son myaccountname-son "www.my-awesome-son.com" 1.13.79 1.13.80 [[bitcoin, 023b907586045625367ecd62c5d889591586c87e57fa49be21614209489f00f1b9]] true
​
# The above command is structured like this:
# create_son <username> "<SON proposal url>" <son vesting balance ID> <normal vesting balance ID> [[bitcoin, <bitcoin public key>]] true
Return
Return Format
{
  "ref_block_num": number,
  "ref_block_prefix": number,
  "expiration": "datetime",
  "operations": [],
  "extensions": [],
  "signatures": []
}
Example Successful Return
create_son myaccountname-son "www.my-awesome-son.com" 1.13.79 1.13.80 [[bitcoin, 023b907586045625367ecd62c5d889591586c87e57fa49be21614209489f00f1b9]] true
{
  "ref_block_num": 10412,
  "ref_block_prefix": 1003801100,
  "expiration": "2015-02-05T00:11:00",
  "operations": [[
      101,{
        "fee": {
          "amount": 0,
          "asset_id": "1.3.0"
        },
        "owner_account": "1.2.12345",
        "url": "www.my-awesome-son.com",
        "deposit": "1.13.79",
        "signing_key": "PPY2j4hy47qY...",
        "sidechain_public_keys": [[
            "bitcoin",
            "bc1abc1234..."
          ]
        ],
        "pay_vb": "1.13.80"
      }
    ]
  ],
  "extensions": [],
  "signatures": [
    "268bd8....."
  ]
}
3.8. update_witness
Update a witness object owned by the given account.
return type, namespace, & method
signed_transaction graphene::wallet::wallet_api::update_witness(
    string witness_name,
    string url,
    string block_signing_key,
    bool broadcast);
Function Call
Return
Function Call
Parameters
name
data type
description
details
witness_name
string
The name of the witness's owner account. Also accepts the ID of the owner account or the ID of the witness.
no quotes required.
url
string
Same as for create_witness. An empty string makes it remain the same.
n/a
block_signing_key
string
The new block signing public key. The empty string makes it remain the same.
n/a
broadcast
bool
true to broadcast the transaction on the network.
n/a
Example Call
update_witness myaccountname-witness "www.my-awesome-witness.com" PPY62L3VYXS8XqorUe2kn63j4TAQpX4YkMJkfFfmmD1nd8Qjo4Bxz true
Return
Return Format
{
  "ref_block_num": number,
  "ref_block_prefix": number,
  "expiration": "datetime",
  "operations": [],
  "extensions": [],
  "signatures": []
}
Example Successful Return
update_witness myaccountname-witness "www.my-awesome-witness.com" PPY62L3VYXS8XqorUe2kn63j4TAQpX4YkMJkfFfmmD1nd8Qjo4Bxz true
{
  "ref_block_num": 10412,
  "ref_block_prefix": 1003801100,
  "expiration": "2015-02-05T00:11:00",
  "operations": [[
      21,{
        "fee": {
          "amount": 50000,
          "asset_id": "1.3.0"
        },
        "witness": "1.6.99",
        "witness_account": "1.2.1234",
        "new_signing_key": "PPY62L3VYXS8XqorUe2kn63j4TAQpX4YkMJkfFfmmD1nd8Qjo4Bxz",
        "new_initial_secret": "5n00bd4aus04a9057c09b19b05f723f2e23deb32"
      }
    ]
  ],
  "extensions": [],
  "signatures": [
    "268bd8....."
  ]
}
3.9. update_son
Update a SON object owned by the given account.
return type, namespace, & method
signed_transaction graphene::wallet::wallet_api::create_son(
    string owner_account,
    string url,
    string block_signing_key,
    flat_map<sidechain_type, string> sidechain_public_keys,
    bool broadcast);
Function Call
Return
Function Call
Parameters
name
data type
description
details
owner_account
string
The name of the SON's owner account. Also accepts the ID of the owner account or the ID of the SON.
no quotes required.
url
string
Same as for create_son. The empty string makes it remain the same.
n/a
block_signing_key
string
vesting balance id for SON deposit.
This is the son vesting balance.
sidechain_public_keys
flat_map
The new set of sidechain public keys. An empty string makes it remain the same.
n/a
broadcast
bool
true to broadcast the transaction on the network.
n/a
Example Call
update_son myaccountname-son "www.my-awesome-son.com" PPY8kvUXLpoXE9rJHwppR48LkqSouAzFZomAPb3hW9gnkSHZCsozi [[bitcoin, 023b907586045625367ecd62c5d889591586c87e57fa49be21614209489f00f1b9]] true
​
# The above command is structured like this:
# create_son <username> "<SON proposal url>" <new block signing public key> [[bitcoin, <bitcoin public key>]] true
Return
Return Format
{
  "ref_block_num": number,
  "ref_block_prefix": number,
  "expiration": "datetime",
  "operations": [],
  "extensions": [],
  "signatures": []
}
Example Successful Return
update_son myaccountname-son "www.my-awesome-son.com" PPY8kvUXLpoXE9rJHwppR48LkqSouAzFZomAPb3hW9gnkSHZCsozi [[bitcoin, 023b907586045625367ecd62c5d889591586c87e57fa49be21614209489f00f1b9]] true
{
  "ref_block_num": 10412,
  "ref_block_prefix": 1003801100,
  "expiration": "2015-02-05T00:11:00",
  "operations": [[
      102,{
        "fee": {
          "amount": 0,
          "asset_id": "1.3.0"
        },
        "son_id": "1.33.99",
        "owner_account": "1.2.12345",
        "new_url": "www.my-awesome-son.com",
        "new_signing_key": "PPY8kvUXLpoXE9rJHwppR48LkqSouAzFZomAPb3hW9gnkSHZCsozi",
        "new_sidechain_public_keys": [[
            "bitcoin",
            "bc1..."
          ]
        ]
      }
    ]
  ],
  "extensions": [],
  "signatures": [
    "268bd8....."
  ]
}
3.10. get_private_key
Get the WIF private key corresponding to a public key. The private key must already be in the wallet.
return type, namespace, & method
string graphene::wallet::wallet_api::get_private_key(
    public_key_type pubkey);
Function Call
Return
Function Call
Parameters
name
data type
description
details
pubkey
public_key_type
The public key you wish to get the private key for.
no quotes required.
Example Call
get_private_key PPY8kvUXLpoXE9rJHwppR48LkqSouAzFZomAPb3hW9gnkSHZCsozi
Return
Return Format
string
Example Successful Return
get_private_key PPY5D13DULV2gKLQ324bmyTVFGW2wm9QYz6uVEmnUmkifRyxcSifk
"5JCLzEW4T4ALFKZeKef7qF8T2MhndmtZoj2sbcXhNTVZWen2Xn1"
3.11. dump_private_keys
Displays all private keys owned by the wallet. The keys are printed in WIF format. You can import these keys into another wallet using import_key().
return type, namespace, & method
map<public_key_type, string> graphene::wallet::wallet_api::dump_private_keys();
Function Call
Return
Function Call
Parameters
name
data type
description
details
ℹ This command has no parameters!
n/a
n/a
n/a
Example Call
dump_private_keys
Return
Return Format
[[
    "Public Key String 1",
    "Private Key String 1"
  ],[
    "Public Key String 2",
    "Private Key String 2"
  ],[
    "Public Key String 3",
    "Private Key String 3"
  ],[
    "Public Key String n...",
    "Private Key String n..."
  ]
]
Example Successful Return
dump_private_keys
[[
    "PPY7sxBKU1...",
    "5Jh04o8q..."
  ],[
    "PPY6oAqs9...",
    "5JMR32LV..."
  ],[
    "PPY586S...",
    "5JN59ePX..."
  ],[
    And so on...
  ]
]
3.12. get_account
Returns information about the given account.
return type, namespace, & method
account_object graphene::wallet::wallet_api::get_account(
    string account_name_or_id);
Function Call
Return
Function Call
Parameters
name
data type
description
details
account_name_or_id
string
The name or id of the account to provide information about.
No quotes required.
Example Call
get_account 1.2.12345
Return
Return Format
{
  "id": "string",
  "membership_expiration_date": "datetime",
  "registrar": "string",
  "referrer": "string",
  "lifetime_referrer": "string",
  "network_fee_percentage": number,
  "lifetime_referrer_fee_percentage": number,
  "referrer_rewards_percentage": number,
  "name": "string",
  "owner": {
    "weight_threshold": number,
    "account_auths": [],
    "key_auths": [],
    "address_auths": []
  },
  "active": {
    "weight_threshold": number,
    "account_auths": [],
    "key_auths": [],
    "address_auths": []
  },
  "options": {
    "memo_key": "string",
    "voting_account": "string",
    "num_witness": number,
    "num_committee": number,
    "votes": [],
    "extensions": []
  },
  "statistics": "string",
  "whitelisting_accounts": [],
  "blacklisting_accounts": [],
  "whitelisted_accounts": [],
  "blacklisted_accounts": [],
  "owner_special_authority": [],
  "active_special_authority": [],
  "top_n_control_flags": number
}
Example Successful Return
get_account 1.2.12345
{
  "id": "1.2.12345",
  "membership_expiration_date": "2106-02-07T06:28:15",
  "registrar": "1.2.12345",
  "referrer": "1.2.12345",
  "lifetime_referrer": "1.2.12345",
  "network_fee_percentage": 10000,
  "lifetime_referrer_fee_percentage": 0,
  "referrer_rewards_percentage": 0,
  "name": "myawesome-son",
  "owner": {
    "weight_threshold": 1,
    "account_auths": [],
    "key_auths": [[
        "PPY8XGp5...",
        1
      ]
    ],
    "address_auths": []
  },
  "active": {
    "weight_threshold": 1,
    "account_auths": [],
    "key_auths": [[
        "PPY2j4ySFX...",
        1
      ]
    ],
    "address_auths": []
  },
  "options": {
    "memo_key": "PPY15sZ1A...",
    "voting_account": "1.2.8",
    "num_witness": 0,
    "num_committee": 0,
    "votes": [],
    "extensions": []
  },
  "statistics": "2.6.12345",
  "whitelisting_accounts": [],
  "blacklisting_accounts": [],
  "whitelisted_accounts": [],
  "blacklisted_accounts": [],
  "owner_special_authority": [
    0,{}
  ],
  "active_special_authority": [
    0,{}
  ],
  "top_n_control_flags": 0
}
3.13. get_witness
Returns information about the given witness.
return type, namespace, & method
witness_object graphene::wallet::wallet_api::get_witness(
    string owner_account);
Function Call
Return
Function Call
Parameters
name
data type
description
details
owner_account
string
The name or id of the witness account owner, or the id of the witness.
No quotes required.
Example Call
get_witness 1.6.99
Return
Return Format
{
  "id": "string",
  "witness_account": "string",
  "last_aslot": number,
  "signing_key": "string",
  "next_secret_hash": "string",
  "previous_secret": "string",
  "vote_id": "string",
  "total_votes": number,
  "url": "string",
  "total_missed": number,
  "last_confirmed_block_num": number
}
Example Successful Return
get_witness 1.6.99
{
  "id": "1.6.99",
  "witness_account": "1.2.1234",
  "last_aslot": 0,
  "signing_key": "PPY62L3VYX...",
  "next_secret_hash": "7197f...",
  "previous_secret": "0000000000000000000000000000000000000000",
  "vote_id": "1:99",
  "total_votes": 0,
  "url": "www.my-awesome-witness.com",
  "total_missed": 0,
  "last_confirmed_block_num": 0
}
3.14. get_son
Returns information about the given SON.
return type, namespace, & method
son_object graphene::wallet::wallet_api::get_son(
    string owner_account);
Function Call
Return
Function Call
Parameters
name
data type
description
details
owner_account
string
The name or id of the SON account owner, or the id of the SON.
No quotes required.
Example Call
get_son 1.33.99
Return
Return Format
{
  "id": "string",
  "son_account": "string",
  "vote_id": "string",
  "total_votes": number,
  "url": "string",
  "deposit": "string",
  "signing_key": "string",
  "pay_vb": "string",
  "statistics": "string",
  "status": "string",
  "sidechain_public_keys": [[
      "string",
      "string"
    ]
  ]
}
Example Successful Return
get_son 1.33.99
{
  "id": "1.33.99",
  "son_account": "1.2.12345",
  "vote_id": "3:114",
  "total_votes": 0,
  "url": "www.my-awesome-son.com",
  "deposit": "1.13.79",
  "signing_key": "PPY2j4ySF...",
  "pay_vb": "1.13.80",
  "statistics": "2.25.4",
  "status": "inactive",
  "sidechain_public_keys": [[
      "bitcoin",
      "bc1..."
    ]
  ]
}
3.15. 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 PPY owned by that account at the time the votes are tallied. Note that you can't vote against a witness, you can only vote for the witness or not vote for the witness.
return type, namespace, & method
signed_transaction graphene::wallet::wallet_api::vote_for_witness(
    string voting_account,
    string witness,
    bool approve,
    bool broadcast);
Function Call
Return
Function Call
Parameters
name
data type
description
details
voting_account
string
The name or id of the account who is voting with their PPY.
No quotes required.
witness
string
The name or id of the witness' owner account.
No quotes required.
approve
bool
true if you wish to vote in favor of that witness, false to remove your vote in favor of that witness.
n/a
broadcast
bool
true to broadcast the transaction on the network.
n/a
Example Call
vote_for_witness 1.2.12345 some-witness true true
Return
Return Format
{
  "ref_block_num": number,
  "ref_block_prefix": number,
  "expiration": "datetime",
  "operations": [],
  "extensions": [],
  "signatures": []
}
3.16. vote_for_son
Vote for a given SON. An account can publish a list of all SONs they approve of. This command allows you to add or remove SONs from this list. Each account's vote is weighted according to the number of PPY owned by that account at the time the votes are tallied. Note that you can't vote against a SON, you can only vote for the SON or not vote for the SON.
return type, namespace, & method
signed_transaction graphene::wallet::wallet_api::vote_for_son(
    string voting_account,
    string son,
    bool approve,
    bool broadcast);
Function Call
Return
Function Call
Parameters
name
data type
description
details
voting_account
string
The name or id of the account who is voting with their PPY.
No quotes required.
witness
string
The name or id of the SON's owner account.
No quotes required.
approve
bool
true if you wish to vote in favor of that SON, false to remove your vote in favor of that SON.
n/a
broadcast
bool
true to broadcast the transaction on the network.
n/a
Example Call
vote_for_son 1.2.12345 some-son true true
Return
Return Format
{
  "ref_block_num": number,
  "ref_block_prefix": number,
  "expiration": "datetime",
  "operations": [],
  "extensions": [],
  "signatures": []
}
The Basics - Previous
Hardware Requirements
Next - The Basics
Auto-Starting a Node
Last updated 4 days ago
name	data type	description	details
ℹ This command has no parameters!	n/a	n/a	n/a