Whitepaper v2.2

JoyShare: Web3 Social Platform

User-Owned Content, On-Chain Authorship, Real Token Rewards

Last updated: April 2026

Abstract

JoyShare is a decentralized social platform on Polygon Amoy where every post is registered on-chain with an immutable original hash and full edit history. Users sign all token operations themselves through a Privy embedded wallet — created with a single Gmail login — so creators truly own their content, their wallet, and their JOY token rewards. V2.2 introduces fixed-term staking with an arbitrage-free APY ladder, network-wide search, and a refined mobile experience as JoyShare prepares for its public web launch and native mobile apps.

The Problem

JoyShare is built around a few user-centric goals that traditional, fully off-chain social apps don't natively solve:

  • Verifiable authorship. Creators want a public, tamper-proof record that they wrote a piece of content at a given moment, plus a clear timeline of every edit.
  • Self-custodied rewards. When a creator earns tokens for their work, those tokens should sit in a wallet they control, not in an internal account balance.
  • Friendly Web3 onboarding. Most non-technical users have never managed seed phrases, gas tokens, or network switching — that shouldn't be a prerequisite to start posting.
  • Transparent token flows. Every reward, tip, stake and burn should be readable on a public explorer so users can audit exactly where each JOY came from and went to.
  • Portable identity and content. A creator's post hashes and JOY balance should remain meaningful and verifiable independently of the JoyShare interface.

Our Solution

JoyShare addresses these issues through:

🔗 On-Chain Authorship

Every post stores its content hash in ContentRegistry with full version history

✍️ User-Signed Tokens

Redeem, tip, stake, premium and withdraw are signed by the user's embedded wallet

📧 Gmail Onboarding

Privy creates an embedded wallet from a single Google sign-in — no seed phrase

🤖 AI-Assisted Feed

FastAPI service moderates content and ranks the feed; every decision is logged

🌐 Portable & Verifiable

Content hashes and JOY balances live on Polygon, independently verifiable by any explorer or third-party tool

🔍 Discover & Autoplay

Search across users and posts, and videos autoplay-on-scroll with unmuted fallback

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, 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

Phase 6 — Mainnet & Ecosystem

  • • Polygon mainnet migration with audited contracts
  • • Account abstraction for gasless UX
  • • DEX listing for JOY
  • • Cross-chain bridge and ecosystem integrations

Get Involved

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

© 2026 JoyShare. Built on Polygon. All rights reserved.