Documentation

Build, share, and support on StoryOnChain

Learn the mission, how to onboard, and how to help others. Everything is designed for fast, transparent, peer-to-peer support on Base.

Start here
Live on Base
Snapshot
99.9% token airdrop
Top story + future CTO lead the project forward.
Wallet-native
Sign in, verify, and receive support directly.
Community safety
Upvotes, reports, and verification keep stories accountable.
Introduction

Welcome to StoryOnChain

I created StoryOnChain because I know firsthand how quickly everything can collapse in the crypto markets. After years of trading, I recently lost my entire portfolio in a single downturn. The experience forced me to face a difficult truth: even in a hyper-connected industry, most people struggle alone when things fall apart.

Instead of walking away, I chose to build something that turns my failure into a foundation for others.

StoryOnChain is a platform where anyone can connect their wallet, submit their story, share their Twitter link, and ask for support directly from the community on Base. It is simple, transparent, and built for people who need a place to be heard.

To show that this project is driven by community values rather than profit, I am committing 99.9% of the platform’s token supply to be airdropped to the top story post—the user whose story resonates the most with the community and who also wishes to step in as CTO of the project. That individual will help lead StoryOnChain forward and shape its long-term direction.

I will keep only 0.1%, strictly for infrastructure and operational maintenance, following an effective altruism model so the platform can survive and grow sustainably.

StoryOnChain is not just a charity board. It is a second chance for me—and possibly for someone else who has been through the same struggle. If the market can take everything in an instant, then together we can build something that gives back with meaning, purpose, and real community impact.

Mission & Pledge

Why it exists

Create a safety net for crypto participants who get wiped out or need help, while showing that community care can be faster than market swings.

Token pledge

99.9% of the platform token supply will be airdropped to the top story (and future CTO). 0.1% is retained only for maintenance and long-term sustainability under an effective altruism model.

Who it’s for

  • Traders and degens who took a heavy loss
  • Builders and creators who need a bridge to keep building
  • Anyone in the crypto community facing hardship

Getting Started

Step 1: Connect

Click the “Connect Wallet” button. We support MetaMask and other Web3 wallets. Make sure you’re on the Base network.

Step 2: Verify

Sign the authentication message to prove ownership. It’s free and gasless.

Step 3: Submit or Support

Share your story with a Twitter link, or browse existing requests to upvote and donate.

Ways to Help

Donate directly

Send on-chain support straight to a recipient’s wallet on Base.

Upvote requests

Help genuine cases surface by giving them visibility.

Share signals

Amplify verified requests on Twitter/X or community chats.

How It Works

📝 Submit help request

Provide a title, reason, and Twitter/X link. Your wallet address stays attached for direct support.

👍 Community upvoting

Each wallet can upvote once per request to surface genuine stories and prevent spam.

💰 Direct donations

Funds move wallet to wallet on Base with no platform fees and fast settlement.

🚩 Community moderation

Report suspicious or inappropriate requests so the community can keep things clean.

Features

🔐 Wallet Authentication

Secure message signing for identity verification.

✅ Input Validation

Zod schema validation for data integrity.

⏱️ Rate Limiting

Prevents spam with time-based restrictions.

🌐 Base Network

Fast, low-cost transactions on Layer 2.

🔗 Twitter Integration

Link posts for social verification.

📊 Transparent Data

All requests and votes publicly visible.

Roadmap

Q1: Stability & Trust

  • Improve verification flow and spam protections
  • Publish treasury and donation transparency dashboards
  • Document the 99.9% token donation draw process

Q2: Community Tools

  • Reputation signals for wallets and reporters
  • Better discovery filters for urgent or verified requests
  • Social sharing templates to boost visibility

Q3: Sustainability

  • Finalize effective altruism funding model for ops
  • Establish grants for builders improving the platform
  • Iterate on token utility aligned with the mission

Smart Contracts

StoryOnChain uses a hybrid approach: database storage for requests and metadata, with direct wallet-to-wallet transfers for donations.

  • No gas fees for creating or upvoting requests
  • Faster user experience with instant updates
  • Direct peer-to-peer donations with no platform fees
  • Full control over your funds at all times

Security

⚠️ Verify before donating

Always check the Twitter/X post link to verify authenticity. Look for history and community engagement.

🔒 Non-custodial

We never have access to your funds. All donations go directly from your wallet to the recipient’s wallet.

🛡️ Rate limiting

Built-in rate limiting prevents spam and abuse while keeping the experience smooth.

Frequently Asked Questions

What fees does StoryOnChain charge?

Zero. We do not take any fees from donations. You only pay standard Base network gas fees when sending ETH.

What blockchain does this run on?

StoryOnChain operates on Base, an Ethereum Layer 2 network that offers fast transactions with minimal fees.

Can I edit or delete my help request?

Requests cannot be edited or deleted once submitted. This keeps history transparent and prevents manipulation.

How do I know if a request is legitimate?

Check the Twitter/X link, review upvote count, and assess story quality. Community upvotes help surface genuine requests.

What happens to reported requests?

Reports are stored and reviewed. Multiple reports can lead to removal or wallet restrictions.

Contact

Need help or want to collaborate?

Join our community on Twitter and Telegram for support and updates.