README.md

ORRO PROTOCOL

The world's first decentralized reputation and trust engine for the creative economy.

Table of Contents

• Introduction

• Installation

• Usage

• Architecture

• Roadmap

• Tokenomics

• Community

• Contributing

• Security

• Licence

Introduction

ORRO is a Solana-based protocol for verifiable creative reputation. Creators build a "Live Lead" through time-stamped fragments—proving merit without faking portfolios or buying likes. Key features:

• Endorsements: Signed messages for private/public trust shares.

• Fragments: Customizable, compressed provenance trails (IPFS/Arweave storage).

• Reputation Scores: Trust score 1:1 Fragment mint (golden ratio).

• Gossip Box: Lightening fast "moderated" community chat with AI assistance.

Installation

• Prerequisitest: Rust 1.75+, Anchor CLI v0.29+, Solana CLI v1.18+

Bash
# Clone repo (Rust + Anchor for Solana programs)

git clone https://github.com/orroprotocol/core.git
cd core

# Install dependencies

cargo install --locked anchor-cli

# Build programs

anchor build

# Test locally

anchor test

Usage

Example: Create a fragment in Rust (Anchor program):

Rust
use anchor_lang::prelude::*;

#[program]
pub mod orro {
    use super::*;

    pub fn create_fragment(ctx: Context<CreateFragment>, hash: [u8; 32]) -> Result<()> {
        let fragment = &mut ctx.accounts.fragment;
        fragment.creator = *ctx.accounts.signer.key;
        fragment.timestamp = Clock::get()?.unix_timestamp;
        fragment.hash = hash;
        Ok(())
    }
}

#[derive(Accounts)]
pub struct CreateFragment<'info> {
    #[account(init, payer = signer, space = 8 + 32 + 8 + 32)]
    pub fragment: Account<'info, Fragment>,
    #[account(mut)]
    pub signer: Signer<'info>,
    pub system_program: Program<'info, System>,
}

#[account]
pub struct Fragment {
    pub creator: Pubkey,
    pub timestamp: i64,
    pub hash: [u8; 32],
}

For full API, see https://github.com/orroprotocol/core/blob/main/docs/api-reference/index.md

Architecture

graph TD
    %% Layers
    subgraph Frontend [Frontend Layer]
        UI[ORRO.art Web App]
        Wallet[Solana Wallet Adapter]
    end

    subgraph Logic [Application Logic]
        SDK[Solana Web3.js]
        Irys[Irys SDK Gateway]
    end

    subgraph Blockchain [Solana On-Chain]
        Program[ORRO Rust Program]
        Ledger[(Grit Ledger Account)]
        Tokens[(Token State Vault)]
    end

    subgraph Storage [Permanent Storage]
        Arweave[(Arweave / Irys)]
        Metadata[JSON Proofs]
    end

    %% Connections
    UI --> Wallet
    Wallet --> SDK
    SDK --> Program
    Program --> Ledger
    Program --> Tokens
    
    UI --> Irys
    Irys --> Storage
    Storage --> Metadata
    Metadata -.->|Immutable Link| Ledger

Loading

Roadmap

graph LR
    %% Phase 1
    subgraph P1 [Phase 1: Alpha Genesis]
        A[Core Architecture] --> B[Token Launch]
        B --> C{Guaranteed Buy-Back Shield}
    end

    %% Phase 2
    subgraph P2 [Phase 2: Product Build]
        C --> D[Grit Ledger 1-999]
        D --> E[Wallet Beta]
    end

Loading

Pre-beta: Security audit in progress. To join the beta test apply for an invite code in the Telegram community here: @orroprotocol.

Tokenomics

To keep ORRO fair, stable, and truly creator-owned, we use a simple utility token $ORRO — never designed for speculation, but as a tool for reputation and system stability.

• Fair Start for Everyone Total supply: 1 billion tokens. To prevent whales accumulation, every account is capped at ~$100 worth (10,000 $ORRO). This means the platform can only ever be fully owned by up to 100,000 real users — not a handful of investors (which we think is a healthy maximum user cap for the application).

• The ORRO Community Fund No "developer slush fund." Instead, a small 5% fee from system activity flows into the ORRO community fund. This grows quietly and is used only for emergencies (e.g., network congestion compensation) or community initiatives — fully transparent and governed by reputation-weighted votes.

• Pay-As-You-Go (No Subscriptions) Using ORRO is extremely affordable. Most users preload ~$10 in $ORRO to cover everyday actions (using the newly developed My Studio toolset, saving fragments, voting, etc.). For typical creators, this lasts months — costing less than $1.49 per month to keep your Live Creation Lead active.

• Safety & Compliance To meet global age-verification laws (e.g., under-16 restrictions in Australia and the UK) and enhance credibility, users can earn a Verified Badge by meeting all eligible criteria e.g. a Solana wallet with 1.0 balance, a verified Email Address and a fully setup Profile). This keeps the community safe and makes your reputation even more valuable to partners.

Community

Join our community today!

X: https://twitter.com/orroprotocol

Telegram: https://t.me/orroprotocol

Contributing

We welcome PRs! See CONTRIBUTING.md for guidelines.

1. Fork the repo.
2. Create branch: git checkout -b feature/your-feature.
3. Commit: git commit -m "feat: add X".
4. Push & PR.

Security

• Audits: Pre-beta security audit in progress (OtterSec/Kudelski).
• Breaches: Report to orroprotocol@proton.me — bounties up to 1,000 $ORRO for critical finds.

License

MIT License — see LICENSE for details.

Built with 💜 by @darkerdarkofficial and the ORRO Community.