Telcoin Platform

Telcoin Platform

TAN: Issuance Calculation Script

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

System Overview

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.

  • Developers Issuance
    • Referrals: Developers receive issuance based on pro-rata share of referral fees earned by stakers compared to other developers
    • TELx Volume: Developers receive issuance based on pro-rata share of TELx volume compared to other developers
    • Telcoin Network Volume: Developers receive issuance based on pro-rata share of transaction fees paid on Telcoin Network compared to other developers
  • Stakers Issuance
    • Corporate Stakers: Receive issuance based on pro-rata share of total swap volume of corporate stakers and their referred users
    • Retail Stakers: Receive issuance based on pro-rata share of total swap volume of retail stakers and their referred users

    How it Works

    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.

    Calculators

    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. * Swap volume incentives include both retail and corporate incentives. * 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.

    For retail bucket:

    CorporateA makes a swap worth 1 ETH:

  • If referrer is CorporateB, no incentive points allocated
  • If referrer is RetailA, RetailA gets 1 incentive point
  • If referrer is nobody, no incentive points allocated

    • RetailA makes a swap worth 1 ETH:

  • If referrer is CorporateA, RetailA gets 1 incentive point
  • If referrer is RetailB, RetailA gets 1 incentive point and RetailB gets 1 incentive point
  • If referrer is nobody, RetailA gets 1 incentive point

    • For corporate bucket:

    RetailA makes a swap worth 1 ETH:

  • If referrer is RetailB, no incentive points allocated
  • If referrer is CorporateA, CorporateA gets 1 incentive point
  • If referrer is nobody, no incentive points allocated

    • CorporateA makes a swap worth 1 ETH:

  • If referrer is RetailA, CorporateA gets 1 incentive point
  • If referrer is CorporateB, CorporateA gets 1 incentive point and CorporateB gets 1 incentive point
  • If referrer is nobody, CorporateA gets 1 incentive point

    • Retail and corporate incentives are calculated separately.