Managing Cashu Mint with Orchard

7. Orchard

With the Cashu Mint operational, in this chapter we configure Orchard, the web tool that allows us to manage the Mint visually. Orchard is under active development, so we recommend being prudent with its use.

7.1 Initializing Orchard

Access Orchard via https://orchard.cashu4community.xyz (you will do so through your respective domains). The first thing we find is the Orchard initialization screen that asks for the SETUP_KEY. Remember that we generated this in the Infrastructure Configuration step and should have copied it. If you cannot find this key, you can view it in the file app-data/orchard/.env.

Orchard Initial Setup
  1. Insert the SETUP_KEY that was generated when we configured the infrastructure. If we didn't save it, we can find it in the .env file within app-data/orchard/.env.
  2. Enter the username (it can be admin, orchard, or as you wish).
  3. Enter a password and confirm it.
  4. Click the Start button to save the changes.

7.2 Dashboard

Orchard allows displaying information from the Bitcoin node (if we have one installed), Lightning node, and the Cashu Mint. The Bitcoin node and Lightning node sections are informational only; there is not much to do there, so we will focus on the Cashu Mint.

Orchard Mint Dashboard
  1. Displays Mint information such as its name, URL, description, among other data.
  2. Displays active NUTs in the Cashu Mint.
  3. Displays data related to Keysets.
  4. In the Activities view, it shows number of operations, Mint and Melt operations count, % of completed operations, among other data.

7.3 Info Section

In the Info section we can update all Mint information regarding contact details. All can be updated from this view.

Orchard Info Section
  1. After updating the Mint data, we proceed to save it.

All this information can be edited in the app-data/cashu/.env file in the Mint Information section:

# Mint information
MINT_INFO_NAME="Cashu4CS"
MINT_INFO_DESCRIPTION="The short mint description"
MINT_INFO_DESCRIPTION_LONG="A Cashu4Community Mint for educational purpose"
MINT_INFO_CONTACT=[["email","contact@cashu4community.xyz"], ["twitter","@cashu4community"]]
MINT_INFO_MOTD="Message to users"
MINT_INFO_ICON_URL="https://cashu4community.xyz/images/icons/cashu4community_logo_transparente.png"
MINT_INFO_URLS=["https://mint.cashu4community.xyz"]
MINT_INFO_TOS_URL="https://mint.host/tos"

7.4 Config Section

Currently the Config section is not functional, and everything shown here is informational, such as the maximum and minimum in a mint or melt operation, enabling or disabling Redis, among other options. By the way, these options are present in the .env file. According to the developer, these functions via RPC are not implemented.

Orchard Config Section

7.5 Keysets Section

From this section we can configure a new keyset without having to use the command line. It has one limitation at the moment: it only works with version v1 keysets; the latest Nutshell update incorporates version v2.

Orchard Keysets Section
  1. If we want to add a new Keyset, we can do it here.
  2. List of existing Keysets in the Mint.
  3. After selecting the fee to use, we select the keyset version. At the moment Orchard only supports v1.
Note: If you are using Nutshell version 0.20, it is recommended to generate new Keysets via mint-cli (you can see this in the Cashu Mint documentation).
Orchard New Keyset

7.6 Database Section

This section displays information stored in the database such as Mint and Melt operations. You can perform database backups among other display options.

Orchard Database Section
  1. By clicking the Create Backup button we can perform a database backup.
Previous ← Cashu Mint Next Service Updates →