Skip to content
Whitepaper v2.2

JoyShare — An AI-Driven Decentralized Social Platform for Content Sharing with Blockchain

Constructive Content · AI Content Analysis · On-Chain Data Integrity

Last updated: May 2026

Abstract

JoyShare is an AI-driven, decentralized social platform on Polygon Amoy designed to surface positive, constructive content while guaranteeing data integrity for every post. A FastAPI AI service analyses every submission for toxicity and quality, and ranks the feed so high-quality voices reach further. Every accepted post is hashed and registered on-chain in ContentRegistry with a full edit history — the original and every revision are tamper-proof and independently verifiable. Users sign all token operations themselves through a Privy embedded wallet (created with one Gmail sign-in), so creators truly own their content, their wallet, and their JOY rewards. V2.2 adds fixed-term staking with an arbitrage-free APY ladder, network-wide search, and a refined mobile experience as JoyShare prepares for public launch.

The Problem

JoyShare is developed to address several core limitations commonly observed in mainstream social media ecosystems:

  • Engagement-driven recommendation systems. Algorithms optimized for maximum user time and interaction frequently amplify polarizing, sensational, or emotionally charged content over constructive, high-value contributions. While this drives short-term engagement, it contributes to echo chambers, reduced content quality, and creator pressure to prioritize virality over substance.
  • Absence of verifiable data integrity and provenance. Centralized platforms retain full control over user-generated content, allowing modification, deletion, or removal without cryptographic proof of originality or an immutable record accessible to creators.
  • Custodial management of creator rewards. Earnings are held in platform-controlled accounts, exposing creators to policy changes, platform fees, sudden program adjustments, and potential loss of funds in cases of account suspension or platform instability.
  • Persistent usability and adoption barriers in decentralized alternatives. Although solutions like Lens Protocol, Farcaster, and Bluesky have made meaningful UX improvements, many Web3 platforms still present cognitive and technical hurdles (wallet management, gas fees, multi-chain complexity) that limit mainstream adoption beyond crypto-native users.

Our Solution

JoyShare addresses these problems through six tightly-integrated pillars:

🤖 AI Content Analysis

A FastAPI AI service scores every post for toxicity and quality, and ranks the feed so positive, constructive voices surface first. Every decision is logged in ai_moderation_log for review.

🌱 Constructive Community

Reward design and AI ranking favour helpful, original contributions. JOY accrues to creators who add value — not to engagement-bait or low-effort content.

🔗 On-Chain Data Integrity

Every post stores its IPFS content hash in ContentRegistry with a full version chain. Originals and edits are tamper-proof — verifiable on Polygonscan independently of JoyShare.

✍️ User-Signed Tokens

Redeem, tip, stake, premium and withdraw are all signed by the user's embedded wallet. JoyShare never custodies user JOY.

📧 Frictionless Onboarding

Privy creates a self-custody embedded wallet from a single Google sign-in — no seed phrase, no extension, no manual gas top-up.

🌐 Portable & Verifiable

Content hashes, edit histories and JOY balances live on Polygon — independently verifiable by any explorer or third-party tool, even if the JoyShare front-end goes offline.

JOY Token Economics

Supply

Hard cap: 100,000,000 JOY — minted once at deploy. No further minting, ever.

Redemption Reserve (creator rewards)70,000,000 JOY
Staking Reward Pool20,000,000 JOY
Project Treasury10,000,000 JOY

Token Utility

  • Redeem off-chain points for on-chain JOY
  • Tip other creators directly wallet-to-wallet (95/5 split with 5% burn)
  • Stake JOY for rewards from the treasury-funded pool
  • Buy PLUS or PRO premium (50% treasury, 50% burn)
  • Withdraw to a linked external wallet (e.g. MetaMask)

Earning Points

Create Post10 points
Leave a Comment5 points
Receive a Like2 points

Premium multiplies every earning action — 1.5× on Plus, 2× on Pro.

Conversion

Flat linear rate enforced on-chain: 50 points = 1 JOY. Calling redeemPoints() burns the user's point balance and transfers JOY directly to their embedded wallet from the redemption reserve. No cooldowns, no tiers, no manual approval.

Token Flow — User-Signed Model

All major token operations are signed by the user's embedded wallet and emit detailed events, fully auditable on Polygonscan.

OperationSignerFlow
Redeem PointsEmbedded walletReserve → user
TipEmbedded walletSender → receiver (95/5 burn)
StakeEmbedded walletUser → JoyStake
Buy PremiumEmbedded walletUser → JoyPremium (50/50)
WithdrawEmbedded walletUser → external address

Fixed-Term Staking (V3)

V3 replaces continuous-emission staking with fixed-term positions. Each position locks the principal for a chosen term and pays a reward computed at stake time; the APY can't drift mid-term. The ladder is designed to be arbitrage-free against chained shorter locks — longer locks pay disproportionately more per day, so splitting one 180-day stake into 12 consecutive 15-day stakes produces strictly less reward.

LockAPYReward on 1,000 JOY
15 days5%~2.05 JOY
30 days10%~8.22 JOY
90 days20%~49.32 JOY
180 days35%~172.60 JOY
  • Rewards are paid from the 20M JOY treasury-funded pool; the contract tracks reservedReward so a stake reverts rather than over-promising.
  • Up to 20 concurrent positions per user — you can ladder different terms.
  • Early exit forfeits the entire reward and returns principal only; the forfeited reward flows back into the pool's free capacity.
  • The tier schedule can be updated for future stakes — open positions keep their original APY snapshot.

Posts & Edit History

  • Each new post registers an original content hash in ContentRegistry.
  • Editing a post calls addVersion(), appending a new hash linked to the original.
  • The UI shows an Edited badge and a timeline of every previous version with Polygonscan links.
  • Author-only mutations are enforced on-chain — only the original author can append a new version, and prior hashes can never be rewritten or deleted.

NFT Badge System

🌟

Newcomer

Reach Level 1

🚀

Contributor

Reach Level 5

👑

Leader

Reach Level 10

💎

Master

Reach Level 25

🏆

Legend

Reach Level 50

Technology Stack

Blockchain

  • Polygon Amoy (chainId 80002)
  • Solidity 0.8.20 / Hardhat
  • ERC-20 JOY (100M hard cap)
  • ERC-721 Badge NFTs

Frontend

  • Next.js 14 (App Router)
  • TypeScript (strict)
  • Ethers.js v6
  • Tailwind CSS

Auth & Wallet

  • Privy (Gmail → embedded wallet)
  • MetaMask (withdrawals only)
  • Zustand + TanStack Query v5

Backend & Storage

  • Supabase (PostgreSQL + RLS)
  • IPFS via Pinata
  • Python FastAPI AI service
  • Token-indexer edge function

Roadmap

Phase 1 — V1 Foundation

  • Initial contracts, points, badges
  • Vault-based custodial flow
  • Core social features

Phase 2 — V2 User-Signed Tokens

  • 100M hard-cap JoyToken
  • User-signed redeem / tip / stake / premium / withdraw
  • On-chain post edit history
  • Follow graph & direct messaging

Phase 3 — V2.2 Discovery & Mobile UX (Q2 2026)

  • V3 fixed-term staking with arbitrage-free APY ladder
  • Network-wide search for users and posts
  • Video autoplay-on-scroll, clickable avatars, premium badge on profile
  • Mobile-first navigation drawer and full vi/en localization

Phase 4 — Public Web Launch (Q3 2026) 🔄

  • Production deploy to a dedicated joyshare.io domain (Vercel + custom DNS, HTTPS, www redirect)
  • SEO-ready landing page, OpenGraph and Twitter cards for shared posts
  • Public beta on Polygon Amoy with onboarding tour and faucet flow
  • Status page, error tracking and basic uptime monitoring

Phase 5 — Native Mobile App (Q4 2026) 🔄

  • Capacitor-based iOS and Android builds wrapping the web app
  • Native push notifications for tips, follows and replies
  • Camera and gallery integration for one-tap posting
  • Submission to Apple App Store and Google Play

Team

JoyShare is a solo project — designed, built, and operated by a single developer. Every line of code, every contract, and every product decision sits with one person.

Tiino Nguyen

Founder · Full-stack & Smart Contract Engineer

Sole creator of JoyShare — responsible for product, frontend (Next.js), backend (Supabase), Solidity contracts, AI moderation service, and the entire deploy pipeline. Ships features end-to-end and operates the platform single-handedly.

Connect on LinkedIn

Get Involved

Join our growing community and help shape the future of decentralized social media.