Skip to content

Latest commit

 

History

History
82 lines (48 loc) · 1.95 KB

README.md

File metadata and controls

82 lines (48 loc) · 1.95 KB

get-komodo-rewards

Calculate the accrued rewards for a given Komodo UTXO

Build Status codecov npm

Calculates the rewards in satoshis for a given Komodo UTXO. Heavily tested and 100% compliant with komodod consensus.

Originally built for our Ledger KMD Reward Claim app. Released as a re-usable module for the benefit of the Komodo ecosystem.

Install

npm install get-komodo-rewards

Usage

Pass in a utxo object and an integer of the accrued rewards in satoshis will be returned.

const getKomodoRewards = require('get-komodo-rewards');

const utxo = {
  tiptime: 1552292091,
  locktime: 1552248193,
  height: 1263192,
  satoshis: 3206795322480
};

const rewards = getKomodoRewards(utxo);
// 205000320

Tip

tiptime should be the current tiptime from komodod.

If you don't have access to this you can use a client-side generated UNIX timestamp at the cost of slightly reduced accuracy. If you do this, use a timestamp ~10 minutes in the past to avoid over calculating the rewards and creating an invalid transaction.

API

getKomodoRewards(utxo)

Returns a the accrued rewards in satoshis.

utxo

Type: Object

An object containing the following properties of the UTXO:

tiptime

Type: number

The current tiptime of the Komodo blockchain.

locktime

Type: number

The locktime value of the UTXO.

height

Type: number

The height of the UTXO.

satoshis

Type: number

The value of the UTXO in satoshis.

License

MIT © Atomic Labs
MIT © Luke Childs