🔬 Arquitetura Circles of Trust

Documentação técnica sobre como funciona o protocolo por trás do P2P.me.

Visão Geral do Sistema

O Circles of Trust é um sistema de reputação descentralizada que substitui verificação centralizada por validação comunitária.

┌──────────────────────────────────────────────────┐
│                   P2P.me App                      │
├──────────────────────────────────────────────────┤
│                  Camada do Protocolo              │
│  ┌──────────┐  ┌──────────┐  ┌──────────────┐   │
│  │ Usuários │  │ Merchants│  │ Admins Circle│   │
│  └────┬─────┘  └────┬─────┘  └──────┬───────┘   │
│       │             │               │            │
│       └─────────────┼───────────────┘            │
│                     ▼                            │
│           ┌─────────────────┐                    │
│           │ Circles of Trust│                    │
│           │    Protocolo    │                    │
│           └────────┬────────┘                    │
│                    │                             │
│       ┌────────────┼────────────┐               │
│       ▼            ▼            ▼               │
│  ┌─────────┐ ┌──────────┐ ┌──────────┐         │
│  │ Staking │ │ Disputas │ │ Rewards  │         │
│  └─────────┘ └──────────┘ └──────────┘         │
├──────────────────────────────────────────────────┤
│              Base Blockchain (L2)                 │
└──────────────────────────────────────────────────┘

Componentes Principais

Circles

• Grupos de merchants gerenciados por um admin
• Cada Circle tem stake próprio (fundo de proteção)
• Limite de 300 merchants por Circle
• Identificados por endereço na blockchain

Staking

• Stake do admin: Mínimo $250 em tokens P2P
• Stake do merchant: Mínimo $250 USDC
• Stakes servem como colateral para disputas
• Slashing automático em casos de má conduta

Delegação de Capital

• Investidores podem delegar capital a Circles
• Capital delegado aumenta capacidade dos merchants
• Rewards distribuídos proporcionalmente

Fluxo de Transação

Usuário inicia compra
        │
        ▼
┌───────────────────┐
│ Seleciona Circle  │ ← Ranking por score/volume
└────────┬──────────┘
         │
         ▼
┌───────────────────┐
│ Match com Merchant│
└────────┬──────────┘
         │
         ▼
┌───────────────────┐
│ Escrow on-chain   │ ← Cripto travada no contrato
└────────┬──────────┘
         │
         ▼
┌───────────────────┐
│ Pagamento fiat    │ ← Off-chain (PIX, etc)
└────────┬──────────┘
         │
    ┌────┴────┐
    │         │
 Sucesso   Disputa
    │         │
    ▼         ▼
Libera     Admin
 fundos   arbitra

Sistema de Disputas

Fluxo

1. Usuário abre disputa com evidências
2. Merchant responde com sua versão
3. Circle Admin analisa e decide
4. Decisão executada on-chain
5. Parte perdedora pode contestar

Penalidades

Infração	Penalidade
Merchant abandona transação	Slashing parcial do stake
Admin decide incorretamente (2x)	Slashing do stake
Fraude comprovada	Ban + slashing total

Distribuição de Rewards

Por transação (1.8% total)

Destinatário	%
Merchant	60%
Delegadores	20%
Fundo do Circle	10%
Admin do Circle	10%

Exemplo: Transação de $1,000

• Merchant: $12
• Delegadores: $4
• Fundo do Circle: $2
• Admin do Circle: $2

Smart Contracts

Principais contratos

• CircleRegistry.sol — Registro de Circles
• MerchantRegistry.sol — Registro de Merchants
• StakingPool.sol — Gerenciamento de stakes
• DisputeResolver.sol — Resolução de disputas
• RewardsDistributor.sol — Distribuição de rewards

Rede

• Mainnet: Base (Ethereum L2)
• Testnet: Base Sepolia

Links

• Código-fonte (em breve)
• Contratos verificados (em breve)
• Documentação da API (em breve)