Skip to content

ARCHITECTURE.md

Latest commit

 

History

History
88 lines (67 loc) · 2.53 KB

ARCHITECTURE.md

File metadata and controls

88 lines (67 loc) · 2.53 KB
Raw

Arquitectura del Sistema — LabSWAP

Documento de arquitectura técnica para los laboratorios de swap en Stellar.

1. Visión General

Motor Nivel Lógica de precio Contratos Labs
SDEX Protocolo Cruce de libro de órdenes No (nativo) Lab 1, Lab 3
AMM Soroban Contrato inteligente x*y=k Sí Lab 2, Lab 3

2. Diagrama de Arquitectura

graph TB
    subgraph Usuario["👤 Usuario"]
        SENDER[Sender Account]
        RECEIVER[Receiver Account]
    end

    subgraph Lab1["🔄 Lab 1 — SDEX / Path Payments"]
        F1[01-fund-accounts]
        O1[02-publish-offer]
        P1[03-query-paths]
        PP1[04-path-payment]
        V1[05-verify]
    end

    subgraph Lab2["⚡ Lab 2 — AMM Soroban"]
        Q2[02-quote]
        S2[03-swap]
        V2[04-verify]
    end

    subgraph Lab3["📊 Lab 3 — Benchmark"]
        BM[run-matrix.ts]
    end

    subgraph Contratos["📜 Contratos Soroban"]
        AMM[AmmSimple<br/>CB2VAYZJMJ5FGSCUK73DCXITNPKCNN4J466BVBEMWIZ3FU4QMTUOHV76]
        TKA[Token A<br/>CAGZ57WF5Z6T6AMG2YH6MUXLA6SMWASQQ62DXJQRJO5IQKX7OKHTZHTS]
        TKB[Token B<br/>CDOOW7CLAMWBAOSP2OWDJRCCIU6VJS6PGIAEOK4QGMM72TFULF3E3VZN]
    end

    subgraph Red["🌐 Stellar Testnet"]
        H[Horizon]
        R[Soroban RPC]
    end

    SENDER --> F1 --> O1 --> PP1 --> V1
    P1 --> H
    PP1 --> H

    SENDER --> Q2 --> S2 --> V2
    Q2 --> R
    S2 --> R
    V2 --> R
    S2 --> AMM --> TKA
    AMM --> TKB

    BM --> H
    BM --> R
    R --> Contratos
Loading

3. Contratos Desplegados en Testnet

Contrato ID Funciones
AMM Simple CB2VAYZJMJ5FGSCUK73DCXITNPKCNN4J466BVBEMWIZ3FU4QMTUOHV76 initialize, swap, swap_exact_out, get_reserves, get_price
Token A CAGZ57WF5Z6T6AMG2YH6MUXLA6SMWASQQ62DXJQRJO5IQKX7OKHTZHTS initialize, mint, transfer, balance
Token B CDOOW7CLAMWBAOSP2OWDJRCCIU6VJS6PGIAEOK4QGMM72TFULF3E3VZN initialize, mint, transfer, balance

4. Variables de Entorno

Copiar .env.example a .env y rellenar con valores reales. Nunca commitear .env.

5. Seguridad

  • .env y logs/ están en .gitignore
  • Nunca commitear secretos (S...)
  • Verificar: grep -r "S[A-Z][A-Z0-9]{40,}" --exclude-dir=node_modules .

6. Referencias