Getting started with the wallet

Openchain Server exposes a public 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.

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.

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.

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:

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.

Select the endpoint and the first slot, and click “Confirm”.

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

You should then see a confirmation of the transaction.

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

Tip

You can use the “Edit Asset Definition” box in the asset issuance page to define 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.

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.

Admin tools

The wallet also has admin tools built-in.

Ledger tree view

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

Alias editor

The alias editor lets you configure 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.