Vaults & Distribution

The TRN ecosystem uses a modular, deterministic vault system to manage all token flows — including earnings, subscriptions, boosts, burns, and DAO distributions. Every TRN movement is tracked and enforced via the TRNUsageOracle, and then processed through a set of specialized vault modules.

These vaults work together at the end of each Merkle cycle to ensure accurate, transparent, and real-time-compatible distributions.

📊 Overview of Vault Roles

Vault Module

Primary Role

DailyVaultSplitter

Master splitter for each day’s Merkle earnings. Feeds all downstream vaults.

PostVaultSplitter

Allocates TRN from view/retrn/subscription actions to content creators, DAO, and burn routing.

StabilityVault

Holds reserve TRN to protect against AMM shocks; later used to activate liquidity smoothing.

CountryEscrowSplitter

Routes region-tagged TRN shares to CountryNFTs.

InvestorNFT Vaults

Distributes 33% of DAO earnings to 100 InvestorNFT holders.

ContributorNFT Payouts

Sends rewards to platform builders, employees, and core contributors.

🔁 System Flow (Step-by-Step)

1. During the Day (Real-Time Accounting)

All TRN usage is processed via the TRNUsageOracle and reflected in the fruit balance ledger.
No tokens are moved between wallets during the day.
Instead, all usage is logged and validated against debt thresholds and eligibility criteria.

2. End-of-Day Merkle Batch

At the start of the new UTC day:

A Merkle tree of all fruit balances is finalized.
Net earnings and spends are tallied and routed into the DailyVaultSplitter.

🧩 DailyVaultSplitter

This is the root module that receives all cleared earnings and splits them into:

PostVaultSplitter — user-based actions (views, retrns, subscriptions, etc.)
CountryEscrowSplitter — earnings tagged to geographic jurisdictions.
InvestorNFT Vault — 33% of the DAO’s share.
ContributorNFT Payout queue.
StabilityVault allocation (TBD % for emergency smoothing).
DAO Reserve (final remaining portion after all allocations).

This module is non-configurable by default. All split percentages are set at deployment or via DAO proposal.

🧵 PostVaultSplitter

Used for all platform activity-based earnings, including:

Views: 1 TRN paid per post.
Retrns: Generates revenue for the original creator.
Boosted Posts: Earn 90% of the booster’s budget (if not burned).
Subscriptions: Daily payout to creator from each subscriber.

Allocation:

90% of each action → content creator.
10% → routed to DAO via DailyVaultSplitter.

If a post is burned, all pending TRN in the post’s vault is reclaimed and sent directly to the DAO instead of the creator.

🇨🇳 CountryEscrowSplitter

For region-tagged earnings:

This module tracks which CountryNFTs are responsible for the visibility or moderation of content.
When posts are viewed in a country, a jurisdiction tag is added by the GeoOracle.
These jurisdictional earnings are split and escrowed for the corresponding CountryNFT.

CountryNFT holders receive distributions based on:

Post visibility within their jurisdiction.
Subscription activity tied to their region.

🛡 StabilityVault

A non-user-facing vault seeded with a portion of platform earnings.
Not activated at launch for flash loan stabilization.
When the DAO determines the ecosystem is mature, this vault begins:
- Providing liquidity to the TRN↔USD AMM during pressure events.
- Absorbing price volatility to preserve peg limits.

This vault may also become the anchor for flash-loan-based arbitrage recovery once the ecosystem is large enough.

💼 InvestorNFT Vaults

10% of total platform earnings go to the DAO.
From that DAO share, 33% is reserved for 100 InvestorNFTs.
The vault auto-distributes daily, pro-rata, based on 1 NFT = 1 share.
InvestorNFTs do not stack. Ownership of multiple NFTs results in multiple shares.

🧑‍💻 ContributorNFT Payouts

These are programmatic distributions for platform builders, developers, advisors, and team.
Like the InvestorNFT vault, this is handled via a payout queue.
ContributorNFTs may have fixed schedules or daily streaming (TBD in DAO setup).
All funds flow through DailyVaultSplitter.

🧮 Key Enforcement Rules

Nothing is user-claimable unless cleared via the Merkle drop.
All vault flows are enforced via the TRNUsageOracle.
No manual withdrawals occur. All earnings are auto-routed.
All vault balances are reconciled nightly.