TAN: Issuance Calculation Script

The TAN Issuance Calculation Script, as the name suggests, calculates the allocation of TAN Issuance to various users.

There are multiple performance metrics tracked and incentives programs calculated.

There are “calculators” and “datasources.” Datasources are passed to calculators which are responsible for determining allocations for a specific metric/program.

All datasources get data ONLY from the Ethereum JSON-RPC. Some datasources fetch events, some fetch blocks, some store things on disk, others only store things in memory, etc.

After each calculator is ran, incentives per user are capped by their staked amount.

GasFeesIncentivesCalculator

This calculator is used to calculate the Telcoin Network gas fees incentives for developers. Each developer gets a share of the total incentives based on the amount of gas fees paid by their executors

ReferralsIncentivesCalculator

This class calculates the referrals incentives for developers. If an executor of a developer initiates a transaction that increases the claimable amount of any staker, it counts toward the referrals incentives of the developer. This class works across multiple chains.

TELxVolumeIncentivesCalculator

This class calculates the TELx volume incentives. Each developer gets a share of the total incentives based on the amount of TELx volume generated by their executors. This calculator works across multiple chains.

SwapVolumeIncentivesCalculator

Calculates swap volume incentives for a given group of users. Swaps are detected by looking at token transfers. If there is one token transfer from a user and one token transfer to a user in the same tx, then it is considered a swap. This calculator works across multiple chains.