Home - peer-network/peer_backend GitHub Wiki

🧠 Peer Network β€” Developer Wiki Home

Welcome to the official Wiki for Peer Network β€” a decentralized, token-powered social platform.

This page serves as the single orientation point for new developers, internal contributors, and external collaborators working across the project’s backend, mobile/web clients, and blockchain components.


πŸš€ What is Peer Network?

Peer Network is a blockchain-integrated social network where users:

  • Post content (text, images, videos)
  • Earn tokens for engagement
  • Chat and connect in real-time
  • Monetize participation via a decentralized reward system

βš™οΈ Under the hood:

  • Users earn Gems for actions
  • Gems are converted into Peer Tokens
  • Tokens are tracked on the Solana blockchain
  • Up to 96% of revenue is redistributed to users

🧱 Architecture Overview

The system is made up of multiple coordinated repositories:

Component Description
peer_backend Main GraphQL API: users, content, chat, wallet, moderation
peer_android_frontend Kotlin-based native Android app
peer_ios_frontend Swift-based native iOS app
peer_web_frontend Web client for browser access
solana_client Blockchain integration via Solana smart contracts

Each client connects to the backend via GraphQL, and the backend handles blockchain interaction and rewards.


πŸ” Versioning Strategy

We use semantic versioning across all repos:

βœ… Definitions

  • MAJOR (e.g. 2.0.0)
    Breaking architectural changes (e.g. full rewrite, token system redesign)

  • MINOR (e.g. 1.5.0)
    New features (backwards-compatible)

    • βœ… Backend leads MINOR version
    • βœ… All frontend repos align (Android, iOS, Web)
  • PATCH (e.g. 1.5.1)
    Bugfixes or local changes β€” don’t require other repos to sync

πŸ“Œ Example:

  • Backend releases 1.5.0
  • Frontend clients update to 1.5.0
  • WebApp fixes a small bug β†’ 1.5.1

πŸ“š Project Documentation

Explore the technical structure and update history using the pages below:


πŸ‘₯ Who Should Read This?

This documentation is for:

  • πŸ”° New developers onboarding to Peer Network
  • πŸ§ͺ Cross-team engineers working across services
  • 🌍 External contributors (the repository is public)

πŸ“© If you're contributing to any part of the project, make sure to read the Versionining strategy and check GraphQL Schema Overview before integrating.