RetrnIndex

The RetrnIndex is the canonical smart contract responsible for tracking retrns — reposting or curating content into a user’s social graph. This module ensures that retrns are valid, unique per user per post per day, and rewardable. It enables a trust-based, decentralized curation mechanism, where retrning quality content helps it spread and earns TRN for curators.

Retrns are not shares — they are endorsements that integrate posts into the retrning user’s follower feed. This turns users into curators and gives them a way to participate in platform earnings if their retrns gain traction.

✅ Core Responsibilities

  • Record valid retrns (one per user per post per day).

  • Link retrns back to the original post for view counting and earning credit.

  • Sync with the ViewIndex and TRNUsageOracle to ensure retrned views are accounted for properly.

  • Enable earnings to flow both to the original creator and to the retrning curator.

  • Ensure retrned content honors all GeoOracle and moderation restrictions.

📌 Retrn Mechanics

When a user retrns a post:

  1. RetrnIndex checks:

    • The user hasn’t retrned this post today.

    • The post is not restricted in their country (via GeoOracle).

    • The post is not their own.

  2. If valid:

    • A new retrn post is created in their feed (curator entry).

    • The retrn points to the original post CID, not to another retrn.

    • No cost is incurred by the retrning user.

  3. Views of this retrned post route through the ViewIndex, which applies all standard earning logic to the original post, not the retrn.

⛔ Retrn Rules (Locked-In)

Rule
Description

1️⃣ Per Post/Per Day

A user may retrn any given post once per day.

❌ No Self-Retrn

Users cannot retrn their own posts.

🔗 Retrns point to Originals

Always references the original post CID, even if retrning a retrn.

🚫 Respect Moderation

If the post is geo-blocked or burned, the retrn fails or becomes inert.

🎯 Feed Visibility

Retrned posts show up in the user's follower feed, just like a post.

💰 Earnings Flow

Earnings from views of a retrn are split between the original creator and the retrning curator.

🧠 Boosted Post Integration

  • Boosted posts cannot be retrned directly.

  • If a boosted post is retrned, the retrn links to the original post, not the boosted wrapper.

  • Once retrned, that retrn can earn TRN like any normal post — the boost ends at the retrn boundary.

This system enables content to organically move beyond a boost campaign’s limited cycle, if the retrn resonates with others.

🎁 Earnings via Retrn

When another user views a retrned post:

  • That view is logged via ViewIndex as if it were a direct view of the original post.

  • However, earnings are split:

    • A portion goes to the original creator.

    • A portion goes to the retrning curator.

This incentivizes users to surface great content to their followers.

The exact split percentage is enforced via the PostVaultSplitter.

🔒 Moderation and Restrictions

Retrns honor all content moderation and geo-restrictions:

  • If a post is restricted in the user’s country (GeoOracle), the retrn will be blocked.

  • If a post is burned, retrns to it will cease to appear in feeds, and any future retrn attempts will be rejected.

  • Once retrned, the retrn itself is immutable and recorded in the ledger.

🧾 File & Contract References

File Name
Description

RetrnIndex.sol

Smart contract for logging and enforcing retrns.

ViewIndex.sol

View accounting and deduplication logic.

PostVaultSplitter.sol

Handles revenue distribution between original poster and retrning curator.

GeoOracle.sol

Enforces geo-restriction policies per CID.

TRNUsageOracle.sol

Ledger used to determine user eligibility and credit.

🔁 Retrn Flow Summary

textCopyEditUser A sees a great post from User B →
User A retrns it (once that day) →
The retrn appears in A’s follower feed →
User C views the retrn →
ViewIndex logs it as a view of B’s original post →
Earnings split between B (creator) and A (curator)

💡 Why Retrn?

Retrns form the backbone of organic content circulation on the TRN platform. Unlike traditional shares:

  • They are deliberate.

  • They are monetized.

  • They are limited in frequency.

Retrns empower authentic discovery and human-curated reach, forming a decentralized social graph that rewards good taste and resonance.

PreviousViewIndexNextBoostingModule

Last updated