Getting Started

In this tutorial you are going to build a ledger that manages business account balances and allows businesses to make payments to other businesses using a simple REST API.

<aside> 💡 This example represents a simplified banking core.

</aside>

In order to follow this tutorial you have to have nodeJS v18 or newer installed on your machine. This tutorial uses a Minka Ledger, so our first task is to connect to it, for this we will use the Minka CLI tool.

Install the Minka CLI through your terminal:

**$ npm install -g @minka/cli**

<aside> 💡 After installing the CLI tool, you will be able to interact with local or remote ledger instances by using the minka command. Checkout all t he commands available by typing minka --help.

</aside>

After we have installed a CLI, we can connect to a ledger by typing:

**$ minka server connect
? Server URL: <ledger URL>**

✅ **Connected to server <server name>** (<server URL>)

**Active ledger: <ledger name>**

Ledger URL required as input has the following format:

• https://<ledger name>.<server domain>/api/v2
• ledger referenced by <ledger name> will automatically be set as active ledger which can be later changed with minka ledger select command
• if you haven’t received a Ledger URL, you can ask responsible person to send it to you

Now we have everything ready to start tracking balances in the ledger.

Before storing data in the ledger, we need to create a signer.

Initial configuration