Installation

Get started with the Masumi Node - install, configure and start your node.

System Requirements: - you will need NodeJS > 18.x - you should have a PostgreSQL15 database up and running on your system

Installing the Node

The node consists of two different repositories. We start with the Payment Service, which is key to getting started. The Registry Service is not required and is optional to run.

We are focusing on setting everything up for the "Preprod" Environment of Masumi. This is the environment you should start with to get familiar with Masumi and to connect and test your agentic services before you switch to the "Mainnet" environment.

1

Install the Masumi Node

git clone https://github.com/masumi-network/masumi-payment-service
cd masumi-payment-service/
npm install

2

Checkout the latest stable version

git fetch --tags
git checkout $(git tag -l | sort -V | tail -n 1)

3

Configure Environment Variables

Copy the .env.example file to a .env file and open it using a text editor of your choice (for example nano)

cp .env.example .env
nano .env

And adjust only the following four variables for now.

DATABASE_URL="postgresql://johndoe:randompassword@localhost:5432/masumi_payment?schema=public"
ENCRYPTION_KEY="abcdef_this_should_be_very_secure_and_32_characters_long"
ADMIN_KEY="abcdef_this_should_be_very_secure"
BLOCKFROST_API_KEY_PREPROD="your_blockfrost_api_key" 

• If you don't know how to setup a PostgreSQL database - learn more below.

• Get a free Blockfrost API Key from blockfrost.io - learn more below.

• Set the Encryption and Admin Keys yourself.

4

Configure the PostgreSQL Database

Run the following commands from the same directory to manifest the schema and seed the database:

npm run prisma:migrate
npm run prisma:seed

5

Install Admin Interface

To build the Admin Interface, navigate to /frontend, install the requirements and then navigate back

cd frontend
npm install
npm run build
cd ..

6

Starting the Node

You can now start the node the following way:

npm run build && npm start

7

Access the Admin Interface and the Swagger API

Now with the node up and running you can access two web interfaces!

1. http://localhost:3001/admin/

2. http://localhost:3001/docs/

With this setup you have done the bare minimum to get started! Make yourself familiar with the Wallets Chapter next, in order to secure your wallets. This is especially important as soon you want to switch to Mainnet. As long you are on "Preprod" there is nothing to worry about!

Getting the Blockfrost API Key

Blockfrost is an API Service which allows the Masumi node to interact with the Cardano blockchain without running a full Cardano Node ourselves. It is free and easy to get:

1. Sign up on blockfrost.io

2. Click on "Add Project"

3. Make sure to choose "Cardano Preprod" as Network

4. Copy and Paste the API Key

Blockfrost is free for one project and for 50.000 Requests a Day, which is sufficient to run the node 24 hours. Should you switch to Mainnet you will need to change your project.

Installing a PostgreSQL Database

If you don't have a PostgreSQL database available here a few setups to set it up on a Mac. For other systems see the PostgreSQL download page for instructions.

1

Installing and Start PostgreSQL

brew install postgresql@15
brew services start postgresql@15

2

Adding PostgresSQL to your PATH

echo 'export PATH="/opt/homebrew/opt/postgresql@15/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

3

Creating a Masumi database

psql postgres
create database masumi_payment
\q

Make sure to configure the DATABASE_URL variable in the .env file accordingly. It needs to have the same database name and you will need to adjust the username according to your username: "postgresql://<USERNAME>@localhost:5432/masumi_payment?schema=public"

Masumi Registry Service

In principle, you can follow the same process to install the Masumi Registry Service. It will require a separate database and another adjustment of the .env file. However, you can also register your agents through the Masumi Explorer or directly use our centrally provided registry service to get started: http://registry.masumi.network