Social Graph
Follow relationships, post routing, and trust-weighted engagement dynamics.
📚 Overview
The Social Graph system enables decentralized relationship tracking across all users of the TRN platform. It determines who sees what, how content is routed, and how AI personalization models weigh relevance — all while maintaining transparent, on-chain mappings and scalable off-chain indexing.
The graph is primarily built around follow events and their associated mappings, but supports additional structures such as curation feeds, retrn logic, and resonance-based targeting used by the AI.
🧱 Key Components
FollowGraph
On-chain contract storing all user follow mappings
RetrnIndex
Records which posts have been re-shared by users
BoostingModule
Connects boosted content to followers of creators or curators
AI Targeting Layer
Uses similarity, resonance, and follow metadata to route ads or content
FlagEscalator
Tracks which users report what — may tie into the social graph later
👥 FollowGraph
The FollowGraph contract is the backbone of the system.
Every user can follow any number of other users.
All follows are recorded on-chain for transparency and integrity.
This mapping is used to determine:
What content enters a user's follow feed
How retrns are routed to followers
Who sees boosted posts tied to creators or curators
These follow relationships are indexed off-chain to allow for efficient querying at scale, while write operations (follow/unfollow) are fully on-chain.
🔁 Retrns & Feed Routing
The RetrnIndex works hand-in-hand with the FollowGraph
:
When a user retrns a post, that content is saved to their own curated feed.
Followers of that user see the retrned post in their follow feed.
Retrns do not affect the original boosted state — they reference the original post.
This design maintains post origin integrity while enabling curation-based discovery.
📣 Boosted Post Visibility
A boosted post is not routed solely to followers.
However, if a follower boosts or retrns a post, their followers see it too.
Boosting a post creates a new wrapper post that links back to the original and carries boosted logic (budget, targeting, cycle, etc.).
The combination of boost campaigns and social routing ensures wide but relevant reach, guided by the resonance of the content.
🧠 AI Personalization Integration
The AI layer uses the social graph to:
Map user interests based on who they follow
Weight curated content (retrns) more heavily than random posts
Dynamically adjust content matching based on user behavior and social alignment
Select ad viewers who follow creators in a related domain (or resonate similarly)
All of this is achieved without giving algorithmic feed control to creators or influencers. The resonance of the content itself determines reach, not follower count.
🔍 Flagging & Trust Overlays (Future Extension)
While not active yet, the moderation and reputation systems (e.g. FlagEscalator
, ModerationLog
) may later integrate with the Social Graph to apply trust overlays or enhance resistance against coordinated abuse.
For now, all content appears regardless of user reputation, unless explicitly burned, geo-blocked, or flagged by AI moderation.
✅ Enforcement Rules
Users can only retrn once per post per day
RetrnIndex
Users cannot retrn their own posts
RetrnIndex
Boosted posts are boosted separately from retrns
BoostingModule
Burned posts are never re-served to a user again
ModerationLog
CountryNFT restrictions apply at post hash level
GeoOracle
Only real follow events are recorded — no bot inflation
FollowGraph
+ AI
🔗 Related Modules
FollowGraph
Records all follow/unfollow relationships
RetrnIndex
Tracks daily retrns and enforces per-user/per-post limits
BoostingModule
Connects boosted wrapper posts to source and followers
GeoOracle
Blocks post visibility by country or jurisdiction
AI Targeting
Enhances personalization using graph + similarity embeddings
ModerationLog
Ensures flagged/burned posts do not appear in social feeds again
Last updated