> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pan.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Protocolos Integrados

> Protocolos DeFi utilizados por pan

## Protocolos Principales

pan integra protocolos DeFi de primera línea para ofrecer:

* **Rendimiento** via Aave V3
* **Bridges** via Across Protocol

## Aave V3

<Card title="Aave" icon="building-columns">
  Protocolo de prestamos descentralizado más grande del mundo.
  pan deposita USDC en Aave para generar rendimiento automatico.
</Card>

### ¿Qué es Aave?

Aave es un protocolo de lending/borrowing descentralizado donde:

* **Depositantes** proveen liquidez y ganan intereses
* **Prestatarios** toman prestado pagando intereses

pan actua como depositante, ganando los intereses que pagan los prestatarios.

### APY en Aave

El APY (Annual Percentage Yield) varia segun:

| Factor                 | Impacto en APY                |
| ---------------------- | ----------------------------- |
| Utilizacion del pool   | Mayor utilización = Mayor APY |
| Demanda de prestamos   | Mas demanda = Mayor APY       |
| Liquidez total         | Mas liquidez = Menor APY      |
| Condiciones de mercado | Volatilidad = Mayor demanda   |

### APY Tipicos de USDC

| Chain    | APY Rango | Notas                             |
| -------- | --------- | --------------------------------- |
| Ethereum | 3-8%      | Mayor liquidez, APY estable       |
| Arbitrum | 4-10%     | Mas volatil, frecuentemente mayor |
| Base     | 4-12%     | Pool más nuevo, puede ser mayor   |

<Note>
  Los APYs son dinamicos y cambian constantemente. Consulta el endpoint
  `/yields` para obtener tasas actuales.
</Note>

### Direcciónes de Aave V3

#### Mainnet - Pool (Lending Pool)

| Chain    | Pool                                         | Pool Data Provider                           |
| -------- | -------------------------------------------- | -------------------------------------------- |
| Ethereum | `0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2` | `0x41393e5e337606dc3821075Af65AeE84D7688CBD` |
| Arbitrum | `0x794a61358D6845594F94dc1DB02A252b5b4814aD` | `0x69FA688f1Dc47d4B5d8029D5a35FB7a548310654` |
| Base     | `0xA238Dd80C259a72e81d7e4664a9801593F98d1c5` | `0x2d8A3C5677189723C4cB8873CfC9C8976FDF38Ac` |

#### Testnet - Pool (Lending Pool)

| Chain            | Pool                                         | Pool Data Provider                           |
| ---------------- | -------------------------------------------- | -------------------------------------------- |
| Sepolia          | `0x6Ae43d3271ff6888e7Fc43Fd7321a503ff738951` | `0x3e9708d80f7B3e43118013075F7e95CE3AB31F31` |
| Arbitrum Sepolia | `0xBfC91D59fdAA134A4ED45f7B584cAf96D7792Eff` | `0x12373B5085e3b42D42C1D4ABF3B3Cf4Df0E0Fa01` |
| Base Sepolia     | `0x07eA79F68B2B3df564D0A34F8e19D9B1e339814b` | `0x9e198B4FaCf5435A3f6De9C19c5A1c53618Cf7F0` |

#### aUSDC (Token de deposito)

| Chain            | Dirección aUSDC                              |
| ---------------- | -------------------------------------------- |
| Ethereum         | `0x98C23E9d8f34FEFb1B7BD6a91B7FF122F4e16F5c` |
| Arbitrum         | `0x724dc807b04555b71ed48a6896b6F41593b8C637` |
| Base             | `0x4e65fE4DbA92790696d040ac24Aa414708F5c0AB` |
| Arbitrum Sepolia | `0x460b97BD498E1157530AEb3086301d5225b91216` |

### Seguridad de Aave

| Métrica       | Valor              |
| ------------- | ------------------ |
| TVL Total     | >\$10 billones     |
| Anos operando | 5+ anos            |
| Auditorias    | 20+ auditorias     |
| Bug bounties  | \$250,000+ pagados |
| Governance    | Token AAVE         |

### Como pan Usa Aave

```
1. Usuario ejecuta lend() con pan
2. pan aprueba USDC para Aave Pool
3. pan llama supply() en Aave Pool
4. Aave mintea aUSDC al wallet del usuario
5. aUSDC genera rendimiento automaticamente
```

```typescript theme={null}
// Simplificado - lo qué hace pan internamente
async function depositToAave(wallet: Wallet, amount: bigint) {
  const pool = new Contract(AAVE_POOL, aavePoolAbi, wallet);

  // Aprobar
  await usdc.approve(AAVE_POOL, amount);

  // Depositar
  await pool.supply(
    USDC_ADDRESS,  // asset
    amount,        // amount
    wallet.address, // onBehalfOf
    0              // referralCode
  );
}
```

## Across Protocol

<Card title="Across" icon="bridge">
  Protocolo de bridge cross-chain más rápido y seguro.
  pan usa Across para mover fondos entre chains.
</Card>

### ¿Qué es Across?

Across es un bridge optimista que permite mover tokens entre chains de forma:

* **Rapida** - Minutos en lugar de horas
* **Barata** - Fees competitivos
* **Segura** - Respaldado por UMA Protocol

### Como Funcióna

```
1. Usuario quiere mover 1000 USDC de Arbitrum a Base
2. pan envia USDC al contrato Across en Arbitrum
3. Relayers de Across adelantan los fondos en Base
4. El sistema UMA verifica la transacción
5. Relayers son reembolsados del pool de Arbitrum
```

### Tiempos de Bridge

| Ruta                | Tiempo Tipico |
| ------------------- | ------------- |
| Arbitrum → Base     | 2-5 minutos   |
| Base → Arbitrum     | 2-5 minutos   |
| Ethereum → Arbitrum | 10-20 minutos |
| Ethereum → Base     | 10-20 minutos |
| Arbitrum → Ethereum | 5-15 minutos  |
| Base → Ethereum     | 5-15 minutos  |

### Fees de Bridge

| Componente  | Descripción                 |
| ----------- | --------------------------- |
| LP Fee      | \~0.04-0.12% del monto      |
| Relayer Fee | Variable segun liquidez     |
| Gas         | Depende de la chain destino |

Ejemplo para bridge de 1000 USDC:

* LP Fee: \~\$0.60
* Relayer Fee: \~\$0.50
* Gas destino: \~$0.50 (L2) o ~$5 (Ethereum)
* **Total: \~$1.60 (L2) o ~$6 (a Ethereum)**

### Direcciónes de Across

#### SpokePool - Testnet (Usado actualmente)

| Chain            | Dirección                                    |
| ---------------- | -------------------------------------------- |
| Sepolia          | `0x5ef6C01E11889d86803e0B23e3cB3F9E9d97B662` |
| Arbitrum Sepolia | `0x7E63A5f1a8F0B4d0934B2f2327DAED3F6bb2ee75` |
| Base Sepolia     | `0x53c2D9B6E5feE26DFAf9947135bf1f8FFe70ef06` |

#### SpokePool - Mainnet (Proximo)

| Chain    | Dirección                                    |
| -------- | -------------------------------------------- |
| Ethereum | `0x5c7BCd6E7De5423a257D81B442095A1a6ced35C5` |
| Arbitrum | `0xe35e9842fceaCA96570B734083f4a58e8F7C5f2A` |
| Base     | `0x09aea4b2242abC8bb4BB78D537A67a245A7bEC64` |

<Info>
  **API de Across**: pan usa `https://testnet.across.to/api` para obtener quotes y verificar estado de bridges en testnet.
</Info>

### Seguridad de Across

| Métrica           | Valor                  |
| ----------------- | ---------------------- |
| Volumen bridgeado | >\$5 billones          |
| Uptime            | 99.9%+                 |
| Auditorias        | OpenZeppelin, Spearbit |
| Respaldo          | UMA Protocol oracle    |

### Como pan Usa Across

```
1. Usuario ejecuta bridge() o lend() cross-chain
2. pan calcula mejor ruta y fees
3. pan aprueba tokens para SpokePool
4. pan llama depositV3() en Across
5. Relayers entregan en destino
6. pan continua con siguiente paso (ej: depositar en Aave)
```

```typescript theme={null}
// Simplificado - lo qué hace pan internamente
async function bridgeWithAcross(params: BridgeParams) {
  const spokePool = new Contract(SPOKE_POOL, spokePoolAbi, wallet);

  // Obtener quote
  const quote = await getAcrossQuote(params);

  // Aprobar
  await usdc.approve(SPOKE_POOL, params.amount);

  // Iniciar bridge
  await spokePool.depositV3(
    wallet.address,         // depositor
    wallet.address,         // recipient
    USDC_ADDRESS,           // inputToken
    USDC_DESTINATION,       // outputToken
    params.amount,          // inputAmount
    quote.outputAmount,     // outputAmount
    params.destinationChain, // destinationChainId
    ADDRESS_ZERO,           // exclusiveRelayer
    quote.timestamp,        // quoteTimestamp
    quote.fillDeadline,     // fillDeadline
    0,                      // exclusivityDeadline
    '0x'                    // message
  );
}
```

## Flujo Completo de Intents

### Intent de Lend (Sin Bridge)

```
Usuario tiene USDC en Arbitrum, quiere depositar

1. pan verifica balance en Arbitrum
2. pan deposita en Aave Arbitrum
   └─ approve USDC → Aave Pool
   └─ supply USDC → recibe aUSDC
3. Intent completado
```

### Intent de Lend (Con Bridge)

```
Usuario tiene USDC en Base, quiere depositar en Arbitrum

1. pan verifica balance en Base
2. pan ejecuta bridge Base → Arbitrum
   └─ approve USDC → Across SpokePool
   └─ depositV3 → Across
   └─ [espera] Relayer entrega en Arbitrum
3. pan deposita en Aave Arbitrum
   └─ approve USDC → Aave Pool
   └─ supply USDC → recibe aUSDC
4. Intent completado
```

### Intent de Lend (Multi-Bridge)

```
Usuario tiene USDC distribuido en Ethereum + Base

1. pan analiza balances
   └─ Ethereum: 500 USDC
   └─ Base: 500 USDC
2. pan ejecuta bridges en paralelo
   └─ Bridge 1: Ethereum → Arbitrum (500 USDC)
   └─ Bridge 2: Base → Arbitrum (500 USDC)
3. pan espera ambos bridges
4. pan deposita 1000 USDC en Aave Arbitrum
5. Intent completado
```

## Seguridad General

### Riesgos y Mitigaciones

| Riesgo              | Mitigacion                          |
| ------------------- | ----------------------------------- |
| Bug en Aave         | Auditorias extensivas, bug bounties |
| Bug en Across       | Oracle UMA, disputa window          |
| Hack de bridge      | Límite de liquidez, monitoring      |
| Depeg de USDC       | Circle regulado, reservas auditadas |
| Smart contract risk | Non-custodial, user owns keys       |

### pan NO Tiene Acceso A

* Tus claves privadas (custodial por Privy)
* Tus fondos directamente (todo via contratos publicos)
* Capacidad de mover fondos sin tu permiso

### Contratos Verificados

Todos los contratos que pan utiliza estan:

* Verificados en Etherscan/Arbiscan/Basescan
* Open source
* Auditados múltiples veces

## Próximos Protocolos

<Info>
  Estamos evaluando integrar:

  * **Compound V3** - Alternativa a Aave
  * **Morpho** - Optimizador de yields
  * **Stargate** - Bridge adicional
  * **Lido** - ETH staking
</Info>

## FAQ

<AccordionGroup>
  <Accordion title="¿Puedo elegir el protocolo de yield?">
    Actualmente pan usa Aave V3 en todas las chains.
    En el futuro agregaremos opciones para elegir protocolo.
  </Accordion>

  <Accordion title="¿Qué pasa si Aave es hackeado?">
    Aave tiene uno de los mejores track records en DeFi con \$10B+ en TVL
    y 5+ anos sin incidentes mayores. Sin embargo, siempre existe riesgo
    de smart contract. pan no puede proteger contra bugs en protocolos
    subyacentes.
  </Accordion>

  <Accordion title="¿Puedo usar otro bridge?">
    Actualmente pan usa exclusivamente Across Protocol por su velocidad
    y seguridad. Los fondos se mueven via contratos verificados y
    auditados de Across.
  </Accordion>

  <Accordion title="¿Mis fondos están asegurados?">
    pan no ofrece seguro de fondos. Los protocolos subyacentes (Aave, Across)
    tienen sus propios mecanismos de seguridad pero no garantias.
    Considera usar protocolos de seguro DeFi como Nexus Mutual si deseas
    cobertura adicional.
  </Accordion>
</AccordionGroup>