Launch a Cli Wallet

The following will explain about the installation and how to use the console wallet (not GUI).

Steps

1.Installation and build

  • 1a) Install and build it from Graphene-Core - Graphene offers you to install Graphene-Core into different platforms; Ubuntu (x64), OSx, and Windows. Please refer installation-guide.

  • 1b) Use the CLI-Wallet tools for Windows (x64) - This option you do not need to install BitShates Core. To obtain the tool, go to a Graphene release page and download the Graphene-Core-*-x64-cli-tools.zip.

To reduce compilation time, you can tell the compile infrastructure to only compile the witness node by running.:

$ make cli-wallet

instead of:

$ make

2. Launching a cli_wallet

The cli_wallet creates a local wallet.json file that contains the encrypted private keys required to access the funds in your account. It requires a running witness node (not necessarily locally) and connects to it on launch.

programs/cli_wallet/cli_wallet -s ws://127.0.0.1:8090

Depending on the actual chain that you want to connect to your may need to specify –chain-id.

Examples

The below section shows two example patterns how to launch the cli_wallet. The first example, we use the public API server node to connect the cli_wallet and also open WebSocket RPC or RPC-HTTP ports. The cli_wallet opens an RPC port for Wallet operations (i.e., spend, buy, sell…). The second example, we use an IP address (localhost) and also open the port for HTTP-RPC.

  • <Examples>

    • 1.Connecting a Cli-Wallet by using the public API server node

    • 2.Connecting a Cli-Wallet by an IP address (localhost)

<Example 1> Connecting a Cli-Wallet by using the public API server node

We use the public API node of OpenLedger wss://node.market.rudex.org and connect via secured WebSocket connection:

./programs/cli_wallet/cli_wallet -s wss://node.market.rudex.org
                                 -H 127.0.0.1:8092
                                 -r 127.0.0.1:8093

This will open the cli-wallet and two RPC ports. In order to allow RPC calls for wallet operations (spend, buy, sell, …), you need to specify the RPC port(s) and set a parameter to choose between WebSocket RPC -r or RPC-HTTP -H requests.

Note

The cli-wallet can open a RPC port so that you can interface your application with it. You have the choices of Websocket RPC via the -r parameter, and HTTP RPC via the -H parameter

<Example 2> Connecting a Cli-Wallet by an IP address (localhost)

./programs/cli_wallet/cli_wallet -s ws://127.0.0.1:8090
                                 -H 127.0.0.1:8091

This will open the port 8091 for HTTP-RPC requests and has the capabilities to handle accounts (by Wallet API Calls) while the witness_node can only answer queries to the blockchain.

After opening the cli-wallet, if you have not had a local wallet yet, you will receive >>> new prompt to provide a pass-phrase for the local wallet. Once a wallet has been created (default wallet file is wallet.json), then it will prompt with locked >>>.


3.Unlock the Cli_Wallet

If you open the cli-wallet successfully, you will receive new >>> prompt (if no local wallet found, you will be asked to set a password). The following shows how to use cli_wallet unlock/lock commands.

Please use the set_password method to initialize a new wallet before continuing
new >>>

4. Gain Access to Blockchain

In Graphene, balances are contained in accounts. To claim an account that exists in the Graphene genesis, imports the private key for an existing account. The private key must match either an owner key or an active key for the named account.

  • import_key

>>> import_key <name> "<wifkey>"

Funds are stored in genesis balance objects. These funds can be claimed, with no fee, by using the import_balance command. This call will construct transaction(s) that will claim all balances controlled by wif_keys and deposit them into the given account.

  • import_balance

>>> import_balance <name> ["*"] true

5. Create Accounts

Note

To register an account, the registrar needs to be a lifetime member. You can use upgrade_account to upgrade the account to be Lifetime member (LTM) status.

We upgrade faucet account because faucet is the registrar in this example below.

>>> upgrade_account faucet true

  • register_account

>>> register_account <name> <owner-public_key> <active-public_key> <registrar_account> <referrer_account> <referrer_percent> <broadcast>

This command allows you to register an account using only a public key.

<Example>

>>> register_account alpha GPH4zSJHx7D84T1j6HQ7keXWdtabBBWJxvfJw72XmEyqmgdoo1njF GPH4zSJHx7D84T1j6HQ7keXWdtabBBWJxvfJw72XmEyqmgdoo1njF faucet faucet 0 true

6. Transfer Funds by using the Cli-wallet

In transfer, if the broadcast flag is False, the wallet will construct and sign, but not, broadcast the transaction.

  • transfer:

    unlocked >> transfer <from> <to> <amount> <asset> <memo> <broadcast>

<Example> `faucet` wants to send 100000 `CORE` to `alpha` user.:

unlocked >> transfer faucet alpha 100000 CORE "here is the cash" true

The wallet will return the actually signed transaction.

Note

In order to transfer, the wallet must be unlocked. If the broadcast flag is False, the wallet will construct and sign, but not broadcast the transaction. This can be very useful for a cold storage setup or to verify transactions.

<Example> Open a new Wallet for `alpha` user:

>>> import_key alpha 5HuCDiMeESd86xrRvTbexLjkVg2BEoKrb7BAA5RLgXizkgV3shs

>>> upgrade_account alpha true

>>> create_witness alpha "http://www.alpha" true

7. Obtain the private key

The get_private_key command allows us to obtain the private key corresponding to the block signing key.:

>>> get_private_key(<pubkey>)


>>> get_private_key GPH6viEhYCQr8xKP3Vj8wfHh6WfZeJK7H9uhLPDYWLGCRSj5kHQZM

Tip

If you want to import your current GUI wallet fund(s), see