Mavryk Reward Distributor (MRD)

Build Status Docs Status Stable Documentation Status

DISCLAIMER : MAVRYK REWARD DISTRIBUTOR IS PROVIDED AS IS. IT IS UNDER CONSTANT DEVELOPMENT. EVENT THOUGH IT IS WELL TESTED, PLEASE USE IT WITH CARE. ALWAYS MAKE A PRE-RUN IN DRY MODE BEFORE MAKING ACTUAL PAYMENTS. IF YOU WANT TO RUN IN SERVICE MODE DO IT AFTER YOU ARE CONFIDENT WITH THE APPLICATION. IN SERVICE MODE ONLY UPDATE IF NEEDED.

What’s MRD?

MRD is an open-source software for distributing delegation rewards from validators to delegators. This is a full scale application which can continuously run in the background as a Linux service. However it does not have to be used as a service, but it can also be used interactively. The tool convinces with its simplicity and yet leaves no configuration wish unfulfilled. Whether minimum delegation threshold, or special fees for some delegators - the MRD covers just about all possible constellations. Furthermore, the tool supports complex payments, pays in batches. It uses MvKT API as backend. MRD is developed and tested extensively by the community and the source code which can be found in the following Github repo.

Since 2024, Mavryk offers two kind of rewards: delegating rewards and staking rewards. MRD pays out delegation rewards. Staking rewards are paid by the protocol, and MRD does not concern itself with them.

Who needs MRD?

The MRD is needed by validators who want to pay delegation rewards. There are a few payout tools available in the Mavryk ecosystem. However, the MRD is probably the most used open source payout tool by validators. It ranges from small validators with a couple of delegators to large validators with more than thousand delegators. The maintainers strive to keep up with the growing Mavryk ecosystem. This in turn enables MRD users to participate in the exploration of new business areas like baking for liquidity pools or DAOs.

Another payout distribution software is [MavPay](https://github.com/mavryk-network/mavpay) but it still a WIP.

What else do you need for MRD?

There are currently the following options to run MRD:

  1. If you want to inject your own transactions, at least a Mavryk rolling node is needed.

  2. If you don’t want to inject your own transactions, only the Mavryk signer is needed.

However, for all options the Mavryk signer is needed.

MvKT

The backend of the Mavryk Reward Distributor is Powered by MvKT API under the following terms:

MvKT API is free for everyone and for both commercial and non-commercial usage.

If your application or service uses the MvKT API in any forms: directly on frontend or indirectly on backend, you should mention that fact on your website or application by placing the label “Powered by MvKT API” with a direct link to api.mavryk.network.