Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
99 lines (54 sloc) 3.69 KB

Getting started with the wallet

Openchain Server exposes a :ref:`public HTTP API <http-api>`, which can be called by any program capable of making HTTP calls.

To wrap all those operations in a user-friendly user interface, we also provide a client: the Openchain Wallet.

The Openchain Wallet is an open source web based interface, available at wallet.openchain.org.

Connecting to a server

The wallet is a client side application running in the browser, and capable of connecting to any Openchain endpoint. It can connect to multiple endpoints at the same time, and pull information and submit transactions to multiple instances of Openchain, however the first time you use it, you need to connect to at least one endpoint.

/images/wallet-1.png

The first page invites you to connect to an endpoint. Click the link to use the test endpoint provided by Coinprism, then click "Check endpoint". The wallet will then try to connect to the Openchain instance and retrieve the instance information.

/images/wallet-2.png

Confirm to connect to this endpoint.

Note

The Openchain wallet will memorize the endpoint you are connecting to, so you will only have to perform this step once.

Logging in

The wallet will now ask you to provide a mnemonic seed used to derive your private key and address.

/images/wallet-3.png

Click "Create a new wallet" if you want to generate a new mnemonic, and reuse one you have already generated. Click "Sign in" to confirm.

After the key has been derived from your seed, you should see your home screen:

/images/wallet-4.png

You are now able to receive payments on the Openchain instance by giving your account path to the payer (/p2pkh/n2yYKCsho8gDrr53SUtzgtKCBypD3JMUxo/ in the example above).

Issue an asset

The test endpoint provided by Coinprism has third party asset issuance enabled, so we can now issue an asset.

To do this, click the "Assets" tab.

/images/wallet-5.png

Select the endpoint and the first slot, and click "Confirm".

/images/wallet-6.png

Click "Issue Asset" and type an amount to issue (10000 for example). Press "Issue".

You should then see a confirmation of the transaction.

/images/wallet-7.png

Your account should have been updated with the newly issued asset.

/images/wallet-8.png

Tip

You can use the "Edit Asset Definition" box in the asset issuance page to define :ref:`metadata <asset-metadata>` about your asset, such as a name and icon.

Send a payment

Now that we have funds, we can send them.

Click the newly issued asset to be taken to the "Send" page.

/images/wallet-9.png

Type a valid destination, such as /p2pkh/mfiCwNxuFYMtb5ytCacgzDAineD2GNCnYo/, and a valid amount.

Press "Send" to confirm. If the transaction went through successfully, you should see the transaction confirmation screen.

/images/wallet-7.png

Admin tools

The wallet also has admin tools built-in.

Ledger tree view

The ledger tree view displays a visual representation of the :ref:`account hierarchy <account-hierarchy>`. The details of the record selected on the left will be showed on the right hand side.

/images/wallet-10.png

Alias editor

The alias editor lets you configure :ref:`aliases <aliases>` for specific paths. After an alias has been set, it is possible to send funds to the alias directly using the @ prefix. The wallet will automatically resolve the alias.

Note

In the default permission layout, aliases can only be modified by an administrator.