Skip to content

Cryptocoatl/flow3

BranchesTags

Repository files navigation

FLOW3 - Planetary Regeneration Coordination Protocol

AI Creator Economy • Multi-Chain Payments • Privacy-Preserving Identity • DAO Evolution

Deploy with Vercel

🌍 Vision

FLOW3 is a planetary regeneration coordination protocol where Stewards complete Planetary Missions to regenerate Earth through AI storytelling, real-world actions, and collective coordination.

Core Principles:

  • Peace economy over extraction
  • Regenerative finance over speculation
  • Planetary coordination over competition
  • Privacy-preserving identity
  • Progressive decentralization

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────────────────┐
│                              FLOW3 PLATFORM                                 │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐       │
│  │   Web App   │  │  Telegram   │  │    Base     │  │   Flow AI   │       │
│  │   (PWA)     │  │  Mini App   │  │  Mini App   │  │   Studio    │       │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘       │
│         │                │                │                │               │
│         └────────────────┼────────────────┼────────────────┘               │
│                          ▼                                                  │
│  ┌──────────────────────────────────────────────────────────────────────┐  │
│  │                         UNIFIED API LAYER                            │  │
│  │  ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐        │  │
│  │  │  Credits   │ │  Missions  │ │ Gamification│ │  Payments  │        │  │
│  │  │  Service   │ │  Service   │ │   Engine   │ │  Service   │        │  │
│  │  └────────────┘ └────────────┘ └────────────┘ └────────────┘        │  │
│  │  ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐        │  │
│  │  │  Referral  │ │   Social   │ │ ZK Privacy │ │    AI      │        │  │
│  │  │  Service   │ │ Verify Svc │ │  Service   │ │  Service   │        │  │
│  │  └────────────┘ └────────────┘ └────────────┘ └────────────┘        │  │
│  └──────────────────────────────────────────────────────────────────────┘  │
│                          │                                                  │
│                          ▼                                                  │
│  ┌──────────────────────────────────────────────────────────────────────┐  │
│  │                      DATA & IDENTITY LAYER                           │  │
│  │  ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐        │  │
│  │  │  Supabase  │ │   Privy    │ │    EAS     │ │  Multichain│        │  │
│  │  │  Postgres  │ │  Identity  │ │ Attestation│ │  Payments  │        │  │
│  │  └────────────┘ └────────────┘ └────────────┘ └────────────┘        │  │
│  └──────────────────────────────────────────────────────────────────────┘  │
│                                                                             │
│  ┌──────────────────────────────────────────────────────────────────────┐  │
│  │                      BLOCKCHAIN LAYER (BASE)                         │  │
│  │  ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐        │  │
│  │  │   $FLOW    │ │    DAO     │ │    ZK      │ │  Multichain│        │  │
│  │  │   Token    │ │   Proxy    │ │  Attestor  │ │   Bridge   │        │  │
│  │  └────────────┘ └────────────┘ └────────────┘ └────────────┘        │  │
│  └──────────────────────────────────────────────────────────────────────┘  │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

🚀 One-Click Deploy

Prerequisites

  • Vercel account
  • Supabase project
  • Privy account
  • Stripe account

Deploy Steps

  1. Clone & Install
git clone https://github.com/flowbond-tech/flow3.git
cd flow3
pnpm install
  1. Setup Supabase
# Create project at supabase.com
# Run migrations
pnpm db:migrate
  1. Configure Environment
cp .env.example .env.local
# Fill in your keys
  1. Deploy
pnpm deploy
# Or click the Vercel button above

📁 Monorepo Structure

flow3/
├── apps/
│   ├── web/                     # Next.js PWA (Main Platform)
│   ├── api/                     # Serverless API Routes
│   ├── telegram-miniapp/        # Telegram WebApp
│   ├── base-miniapp/            # Base/Coinbase Wallet Mini App
│   └── flow-ai-studio/          # AI Video Generation
│
├── packages/
│   ├── shared-ui/               # Shared React Components
│   ├── shared-types/            # TypeScript Types
│   ├── flow3-sdk/               # Client SDK
│   ├── prompt-engine/           # AI Prompt Templates
│   └── brand-universe-sdk/      # Sponsor Brand System
│
├── services/
│   ├── credits-service/         # Narrative Energy Ledger
│   ├── missions-service/        # Planetary Missions
│   ├── referral-service/        # Referral & Rewards
│   ├── social-verification/     # Social Platform Verify
│   ├── gamification-engine/     # XP, Levels, Badges
│   ├── zk-privacy-service/      # Privacy Commitments
│   └── payments-service/        # Multi-chain Payments
│
├── contracts/
│   ├── FlowToken.sol            # $FLOW Token
│   ├── DaoAttestationProxy.sol  # DAO Governance
│   └── ZkAutoAttestor.sol       # ZK Verification
│
├── infra/
│   ├── supabase/                # Database Migrations
│   ├── vercel.json              # Deployment Config
│   └── docker-compose.yml       # Local Development
│
├── docs/
│   ├── architecture.md
│   ├── protocol-manifesto.md
│   ├── privacy.md
│   ├── gamification.md
│   └── decentralization-roadmap.md
│
├── turbo.json
├── package.json
└── README.md

🎮 Steward Progression

Role XP Required Abilities
Explorer 0 Basic missions, AI generation
Creator 1,000 Create campaigns, referrals
Amplifier 5,000 Viral multipliers, squad creation
Curator 25,000 Content curation, sponsor relations
Mythic Steward 100,000 DAO voting, governance

🪙 Narrative Energy (Credits)

Credits power all platform actions:

Action Cost Earn
AI Video Generation (Standard) 200 -
AI Video Generation (Ultra) 800 -
Complete Mission - 50-500
Referral (inviter) - 100
Referral (invitee) - 50
Daily Login - 10
Viral Content Bonus - 10-1000

💳 Payment Methods

Method One-Time Subscription Chains
Stripe ✅ ✅ Fiat, USDC
Reown AppKit ✅ ✅ Solana, Base, ETH, Polygon
TON Connect ✅ ⏳ TON, USDT-TON
Coinbase Commerce ✅ - BTC, ETH, USDC

🔐 Privacy Model

FLOW3 uses privacy-preserving identity:

  1. No PII On-Chain - Only commitment hashes
  2. Encrypted Storage - AES-GCM for all sensitive data
  3. Selective Disclosure - ZK proofs for verification
  4. User Sovereignty - Users control their data
commitment = keccak256(platform || username || secretSalt)

🏛️ Decentralization Roadmap

Phase Mode Attestation
Phase 1 Central Backend relayer signs EAS
Phase 2 DAO Safe multisig via DaoAttestationProxy
Phase 3 ZK zkVerify contract auto-attests

🛠️ Development

# Install dependencies
pnpm install

# Start all apps in dev mode
pnpm dev

# Run specific app
pnpm dev --filter=web

# Run tests
pnpm test

# Build all
pnpm build

# Database migrations
pnpm db:migrate

# Generate types
pnpm generate:types

📚 Documentation

🔑 Environment Variables

# Privy (Auth)
NEXT_PUBLIC_PRIVY_APP_ID=
PRIVY_APP_SECRET=

# Supabase
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=

# Stripe
STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=

# Reown/WalletConnect
NEXT_PUBLIC_REOWN_PROJECT_ID=

# TON
TON_API_KEY=
TON_PAYMENT_WALLET=

# Multi-chain Wallets
SOLANA_RPC_URL=
SOLANA_PAYMENT_WALLET=
BASE_RPC_URL=
BASE_PAYMENT_WALLET=

# AI Services
RUNWAY_API_KEY=

# EAS (Base)
EAS_CONTRACT_ADDRESS=
FLOW3_SCHEMA_UID=

# Encryption
ENCRYPTION_KEY=

# Mode
DECENTRALIZATION_MODE=central

🤝 Contributing

See CONTRIBUTING.md

📄 License

MIT - See LICENSE

Built with 💚 for planetary regeneration

FlowBond Tech • flowbond.tech

About

FLOW3 Platform - Planetary Regeneration Protocol for the FlowBond ecosystem

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages