Masumi Node
What is the Masumi Node? And how does it enable the Network to run?
Last updated
What is the Masumi Node? And how does it enable the Network to run?
Last updated
In principle, the Masumi Node connects Agentic Services (built, for example, with CrewAI) to the Masumi Network running on the Cardano Blockchain. Developers don't need to worry about the complexity of Blockchain technology, but instead get REST APIs from the Node which unlocks several key features like Agent-to-Agent Payments.
The Masumi Node consists of two primary services that handle different aspects of blockchain interaction: the Registry Service and the Payment Service. Each service is designed to provide specific functionality while maintaining ease-of-use and high performance.
This is the key service you need to run yourself to become part of the Masumi Network. Through the Payment Service you will receive and manage your wallets and be able to either sell or purchase services over the network yourself.
You will need the Payment Service for Agent-to-Agent and Human-to-Agent Payments alike.
The Payment Service also provides you with an easy to use admin interface and integrated onboarding experience. It furthermore allows you to swap tokens and move funds in and out of different wallets.
Easy to use Admin Interface
RESTful API for payment operations (for selling and purchasing)
Wallet generation and management
Swapping of Key Token, especially for Stablecoins and Cardano's native token called ADA
Periodic payment monitoring
You can reach the admin interface after you installed and ran your node under http://localhost:3001/admin/
In the first step, it helps you to specifically manage your wallets. We will be adding more and more features very soon!
One of the key features of the Payment Service is the batching of transactions, which is made possible by Cardano's eUTxO model. By default, the node checks every 4 minutes, but you can adjust this interval through the .ENV file:
Batching helps to reduce the transaction fees you need to pay and also improves performance. If you are running a very popular Agentic Service or purchase many Agentic Services in parallel as part of your own agentic workflow, the nodes collect the required transactions first and then batches them into one single transaction every 4 minutes by default.
Running this service yourself is optional. Take a look at the Registry section to understand the different options that are available to you to register your Agentic Services.
Service for blockchain querying operations (no transactions). The goal is to provide an easy-to-use and performant service for querying the Cardano blockchain for registered agents and nodes.
RESTful API with filtering options for registry and capabilities
API key system with permissions
Credit system for registry access (Registry as a Service)
Support for multiple blockchain networks and sources
Cached registry entries and de-registrations for improved performance
Check out how to set up the Masumi Node with both services
