ContributorNFT Payouts

The ContributorNFT system provides long-term payout capabilities for approved contributors to the TRN platform, including developers, creatives, and other foundational participants. Each NFT is associated with a payout vault and governed by rules to ensure timely claims and legacy handoff when necessary.


Overview

  • Each ContributorNFT represents a stake in the long-term value of the platform.

  • These NFTs receive allocations from the DAO vault, derived from overall platform earnings.

  • Each NFT has its own auto-funded vault.

  • Contributors may claim their earnings at any time, subject to real-time index verification via the TRNUsageOracle.

  • Vault balances do not auto-withdraw to contributors; manual claim is required.

  • Vaults must be emptied by the contributor at least once per quarter (every 90 days).

  • If not claimed by the contributor within the defined timeframe, the balance is automatically transferred to a designated beneficiary address set during NFT issuance.


Payout Flow

1. Allocation

  • The DAO allocates a percentage of total platform earnings to ContributorNFT vaults via the DailyVaultSplitter.

  • Each ContributorNFT has a pre-defined allocation ratio.

  • These funds are deposited directly into the vault address linked to each NFT.

2. Claiming

  • Contributors can claim funds from their vault at any time.

  • The TRNUsageOracle checks the contributor’s account status (e.g. outstanding debts, fruit balance, Merkle eligibility) before allowing the claim to finalize.

  • Upon successful verification, funds are transferred to the user’s seamless wallet.

3. Quarterly Enforcement

  • Each ContributorNFT includes a timestamp tracking the last successful claim.

  • If 90 days pass without the vault being emptied, the system triggers an automated sweep of the vault contents to the predefined beneficiary.

  • This mechanism ensures that inactive contributors do not indefinitely accrue unclaimed earnings, preserving DAO capital efficiency.


Example

  • Contributor A has a vault linked to their ContributorNFT #12.

  • They receive 1,500 TRN into their vault from daily platform distributions.

  • They forget to claim it for 92 days.

  • On Day 91, a background job (or sequencer-triggered process) detects inactivity.

  • The 1,500 TRN is automatically routed to the NFT’s assigned beneficiary account.

  • Contributor A still holds the NFT but forfeits the unclaimed funds.


On-Chain Enforcement

  • Vault inactivity timers are enforced by the vault contract itself.

  • Beneficiaries are immutable post-issuance and must be defined upfront.

  • DAO governance may override beneficiary terms only with a supermajority vote and valid cause (e.g., contributor death, fraud).


Key Module References

  • ContributorNFT.sol — defines minting, assignment, and beneficiary logic.

  • ContributorVault.sol — manages deposits, claims, and inactivity enforcement.

  • TRNUsageOracle.sol — validates claim eligibility and enforces system consistency.

  • DailyVaultSplitter.sol — handles daily earnings flow into ContributorNFT vaults.

Last updated