Table of Contents

Welcome to the technical documentation for the TRN decentralized engagement, moderation, and monetization ecosystem. This guide is intended for developers, DAO contributors, auditors, and investors seeking a full understanding of the smart contract logic and off-chain architecture underlying the TRN platform.

This documentation is based entirely on finalized design decisions captured in extensive stakeholder conversations.

🧭 Documentation Index

The TRN Platform is composed of the following core subsystems. Each section will be linked to a deeper module page:

🪙 Token Economy

Core logic of TRN and BRN token interaction and constraints.

  • TRN Token

  • BRN Token

  • TRN↔BRN Internal AMM

  • TRN↔USD Internal AMM

  • TRNUsageOracle

  • Fruit Balance System

  • Mint Throttle Controller

📦 Vaults & Distribution

How funds are held, processed, and allocated daily across actors.

  • DailyVaultSplitter

  • PostVaultSplitter

  • StabilityVault

  • CountryEscrowSplitter

  • InvestorNFT Vaults

  • ContributorNFT Payouts

📈 Engagement System

How content views, boosts, burns, and retrns are recorded and rewarded.

  • ViewIndex

  • RetrnIndex

  • BoostingModule

  • Bless/Burn Tracker

  • LottoModule

🧠 Moderation & Governance

Enforcement of community rules, DAO control, and abuse mitigation.

  • ModerationLog

  • FlagEscalator

  • BurnRegistry

  • GeoOracle

  • CountryRulesetManager

  • CouncilNFT / MasterNFT Governance

  • Voting + ProposalFactory

🧾 Subscription System

Gated content logic and permissioned access enforcement.

  • SubscriptionNFT

  • SubscriptionManager

🧑‍🤝‍🧑 Social Graph

Follower logic, content routing, and feed personalization.

  • FollowGraph

👁 Identity & Access

Secure user-level state management, debt tracking, and real-time limits.

  • TRNUsageOracleViewAdapter

  • AI Bot Verifier

  • DebtSettlementModule

  • KYC Withdrawal Layer

  • 7 Key Shards

🔄 AMM & Liquidity

Internal liquidity constraints and swap behavior.

  • Private TRN↔BRN AMM

  • Private TRN↔USD AMM

  • Swap Limits & Stability Trigger

📡 AI & Oracles

All AI agents, targeting logic, embeddings, and moderation interfaces.

  • Boost Targeting AI

  • Content Similarity Embeddings

  • SemanticTrustOracle

📝 Future TBD Modules

These are not to be implemented yet but may be introduced in future updates:

  • SavingsAccountModule.sol — Optional interest-bearing TRN holding

  • DAOParameterManager.sol — On-chain toggle panel for DAO policies

  • PostAppealQueue.sol — Optional appeal pipeline for burned content

  • UserPrivacyRelay.sol — Optional stealth address abstraction for post authors

  • AnonymousPost.sol — Optional stealth address for anonymous posting

PreviousWelcomeNextToken Economy

Last updated