🔬 Arquitectura Circles of Trust

Documentación técnica sobre cómo funciona el protocolo detrás de P2P.me.

Visión General del Sistema

Circles of Trust es un sistema de reputación descentralizada que sustituye la verificación centralizada por validación comunitaria.

┌──────────────────────────────────────────────────┐
│                   P2P.me App                      │
├──────────────────────────────────────────────────┤
│                  Capa del Protocolo               │
│  ┌──────────┐  ┌──────────┐  ┌──────────────┐   │
│  │ Usuarios │  │ Merchants│  │ Admins Circle│   │
│  └────┬─────┘  └────┬─────┘  └──────┬───────┘   │
│       │             │               │            │
│       └─────────────┼───────────────┘            │
│                     ▼                            │
│           ┌─────────────────┐                    │
│           │ Circles of Trust│                    │
│           │    Protocolo    │                    │
│           └────────┬────────┘                    │
│                    │                             │
│       ┌────────────┼────────────┐               │
│       ▼            ▼            ▼               │
│  ┌─────────┐ ┌──────────┐ ┌──────────┐         │
│  │ Staking │ │ Disputas │ │ Rewards  │         │
│  └─────────┘ └──────────┘ └──────────┘         │
├──────────────────────────────────────────────────┤
│              Base Blockchain (L2)                 │
└──────────────────────────────────────────────────┘

Componentes Principales

Circles

• Grupos de merchants gestionados por un admin
• Cada Circle tiene stake propio (fondo de protección)
• Límite de 300 merchants por Circle
• Identificados por dirección en la blockchain

Staking

• Stake del admin: Mínimo $250 en tokens P2P
• Stake del merchant: Mínimo $250 USDC
• Los stakes sirven como colateral para disputas
• Slashing automático en casos de mala conducta

Delegación de Capital

• Los inversores pueden delegar capital a Circles
• El capital delegado aumenta la capacidad de los merchants
• Los rewards se distribuyen proporcionalmente

Flujo de Transacción

Usuario inicia compra
        │
        ▼
┌───────────────────┐
│ Selecciona Circle │ ← Ranking por score/volumen
└────────┬──────────┘
         │
         ▼
┌───────────────────┐
│ Match con Merchant│
└────────┬──────────┘
         │
         ▼
┌───────────────────┐
│ Escrow on-chain   │ ← Cripto bloqueada en el contrato
└────────┬──────────┘
         │
         ▼
┌───────────────────┐
│ Pago fiat         │ ← Off-chain (transferencia, etc)
└────────┬──────────┘
         │
    ┌────┴────┐
    │         │
 Éxito     Disputa
    │         │
    ▼         ▼
Libera     Admin
 fondos   arbitra

Sistema de Disputas

Flujo

1. El usuario abre disputa con evidencias
2. El merchant responde con su versión
3. El Circle Admin analiza y decide
4. Decisión ejecutada on-chain
5. La parte perdedora puede contestar

Penalidades

Infracción	Penalidad
Merchant abandona transacción	Slashing parcial del stake
Admin decide incorrectamente (2x)	Slashing del stake
Fraude comprobado	Ban + slashing total

Distribución de Rewards

Por transacción (1.8% total)

Destinatario	%
Merchant	60%
Delegadores	20%
Fondo del Circle	10%
Admin del Circle	10%

Ejemplo: Transacción de $1,000

• Merchant: $12
• Delegadores: $4
• Fondo del Circle: $2
• Admin del Circle: $2

Smart Contracts

Contratos principales

• CircleRegistry.sol — Registro de Circles
• MerchantRegistry.sol — Registro de Merchants
• StakingPool.sol — Gestión de stakes
• DisputeResolver.sol — Resolución de disputas
• RewardsDistributor.sol — Distribución de rewards

Red

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

Links

• Código fuente (próximamente)
• Contratos verificados (próximamente)
• Documentación de la API (próximamente)