Skip to main content
pan es infraestructura financiera para fintechs. Te permite ofrecer productos avanzados a tus usuarios sin construir la complejidad internamente. La API está construida alrededor de tres conceptos fundamentales: Wallets, Intents, y Planes de Ejecución.

​
Los Tres Pilares

Wallets

Cuentas multi-chain que abstraen la complejidad de blockchain

Intents

Objetivos de alto nivel que pan ejecuta automaticamente

Planes de Ejecución

Estrategias optimizadas para lograr tus intents

​
El Flujo de pan

1

Crea una Wallet

Las wallets son la base de pan. Cada wallet soporta múltiples blockchains con una sola dirección, eliminando la necesidad de manejar direcciones separadas por chain.
const wallet = await pan.wallet.create({
  userId: 'usuario_123'
});
// wallet.address: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
// Funcióna en Ethereum, Arbitrum, Base, etc.
2

Consulta Balances

Consulta balances de todas las chains y tokens con una sola llamada API. pan maneja la complejidad de consultar múltiples blockchains y formatear los resultados.
const balances = await pan.wallet.getBalances(wallet.id);
// {
//   "arbitrum": [{ symbol: "USDC", balance: "500.00" }],
//   "base": [{ symbol: "USDC", balance: "300.00" }],
//   "ethereum": [{ symbol: "USDC", balance: "200.00" }]
// }
3

Crea un Intent

Expresa lo que quieres lograr (ej. “prestar $1000 USDC”) en lugar de especificar transacciones exactas. El sistema inteligente de pan maneja el resto.
const intent = await pan.lend({
  walletId: wallet.id,
  amount: 1000,
  asset: 'USDC'
  // No específicas chain - pan encuentra el mejor APY
});
4

pan Genera un Plan

pan analiza:
  • Balances actuales del wallet
  • APYs disponibles en cada chain
  • Costos de bridge y gas
  • Tiempo estimado
Y genera un plan optimizado:
{
  "strategy": "multi-bridge",
  "steps": [
    { "type": "bridge", "from": "ethereum", "to": "base", "amount": "200" },
    { "type": "bridge", "from": "arbitrum", "to": "base", "amount": "500" },
    { "type": "deposit", "protocol": "aave", "chain": "base", "amount": "1000" }
  ],
  "expectedApy": 8.52
}
5

Monitorea Ejecución

Sigue el progreso en tiempo real. pan proporciona actualizaciones detalladas, planes de ejecución, y reportes de errores completos.
const status = await pan.getIntent(intent.id);
// status: "executing"
// completedSteps: 2 de 3

​
Beneficios Clave

Basado en Intents

Expresa objetivos, no transaccionesEn lugar de escribir código para:
  1. Verificar balances
  2. Aprobar tokens
  3. Calcular rutas de bridge
  4. Ejecutar transacciones
  5. Manejar errores
Simplemente dices: “Presta 1000 USDC donde mejor pague”

Multi-chain Nativo

Una dirección, todas las chains
  • Dirección unica funciona en ETH, Arbitrum, Base, etc.
  • Balances unificados con una sola consulta
  • Bridges automáticos cuando es necesario
  • Sin manejo de direcciones por chain

Automatizado

Cero gestion de blockchainpan maneja automaticamente:
  • Nonces de transacciones
  • Precios de gas
  • Reintents en caso de fallo
  • Confirmaciones de transacción
  • Secuencia de operaciones

Seguro por Defecto

Infraestructura enterprise-grade
  • Wallets no-custodiales via Privy
  • Claves encriptadas
  • Auditorias de seguridad
  • Sin acceso a claves privadas

​
Modelo de Datos

pan usa un modelo de datos jerarquico: 
Developer
├── API Keys (dev, prod)
└── Wallets
    ├── Balances (por chain)
    └── Intents (operaciones)
CampoTipoDescripción
idstringIdentificador único
emailstringEmail del desarrollador
planstringPlan de suscripción
CampoTipoDescripción
idstringID único (pan_wallet_...)
userIdstringUsuario en tu app
addressstringDirección blockchain
CampoTipoDescripción
idstringID único
actionstringlend, withdraw, bridge
statusstringpending, executing, completed

​
Desarrolladores y API Keys

Los desarrolladores se autentican usando API keys que identifican su cuenta. Cada cuenta de desarrollador tiene:
  • Plan de suscripción: Determina límites (wallets, creditos)
  • Multiples API keys: Para diferentes entornos
  • Multiples wallets: Para diferentes usuarios en tu aplicación

​
Wallets

Las wallets representan cuentas de usuarios en tu aplicación. Cada wallet:
  • Tiene un identificador único (walletId)
  • Soporta múltiples blockchains con una sola dirección
  • Puede ejecutar múltiples intents
  • Mantiene balances en todas las chains soportadas

​
Intents

Los intents representan objetivos financieros de alto nivel. Cuando creas un intent, pan:
  1. Analiza el estado actual del wallet
  2. Evalua protocolos DeFi disponibles
  3. Genera un plan de ejecución optimizado
  4. Ejecuta el plan automaticamente

​
Planes de Ejecución

Los planes de ejecución son estrategias detalladas que describen como pan lograra un intent. Incluyen:
  • Lista de operaciones (swaps, bridges, deposits)
  • Orden de ejecución
  • Costos esperados y timing
  • Estrategias alternativas si es necesario

​
Ejemplo de Flujo Completo

Veamos un ejemplo real paso a paso:
1

Crear wallet

const wallet = await pan.wallet.create({
  userId: 'alice_123',
  metadata: { email: 'alice@ejemplo.com' }
});
Resultado: Wallet creada con dirección 0x742d35Cc...
2

Consultar balance

Despues de que Alice deposita fondos externamente:
const balances = await pan.wallet.getBalances(wallet.id);
Resultado: Alice tiene 500 USDC en Ethereum y 500 USDC en Arbitrum
3

Consultar yields

const yields = await pan.yields.getAll();
Resultado:
  • Base: 8.52% APY
  • Arbitrum: 7.23% APY
  • Ethereum: 5.15% APY
4

Crear intent

const intent = await pan.lend({
  walletId: wallet.id,
  amount: 1000,
  asset: 'USDC'
});
pan analiza y crea un plan:
  • Estrategia: multi-bridge (consolidar en mejor yield)
  • Paso 1: Bridge 500 USDC de Ethereum a Base
  • Paso 2: Bridge 500 USDC de Arbitrum a Base
  • Paso 3: Depositar 1000 USDC en Aave Base
  • APY esperado: 8.52%
5

Monitorear ejecución

// Polling cada 5 segundos
let intent = await pan.getIntent(intent.id);
while (intent.status === 'executing') {
  console.log(`Progreso: ${intent.results.completedSteps}/${intent.executionPlan.steps.length}`);
  await sleep(5000);
  intent = await pan.getIntent(intent.id);
}
Estados: pending → planning → executing → completed

​
Comparacion: Con vs Sin pan

Sin pan

// 1. Configurar providers (por chain)
const ethProvider = new JsonRpcProvider(ETH_RPC);
const arbProvider = new JsonRpcProvider(ARB_RPC);
const baseProvider = new JsonRpcProvider(BASE_RPC);

// 2. Configurar wallets (por chain)
const ethWallet = new Wallet(PRIVATE_KEY, ethProvider);
// ... repetir para cada chain

// 3. Consultar balances (multiples llamadas)
const ethBalance = await usdcEth.balanceOf(address);
const arbBalance = await usdcArb.balanceOf(address);
// ... etc

// 4. Calcular mejor yield
const ethApy = await getAaveApy('ethereum');
const arbApy = await getAaveApy('arbitrum');
// ... comparar y decidir

// 5. Aprobar tokens (si es necesario)
const approveTx = await usdc.approve(bridge, amount);
await approveTx.wait();

// 6. Ejecutar bridge
const bridgeTx = await acrossBridge.deposit(...);
await bridgeTx.wait();
// Esperar fill en destino...

// 7. Aprobar para Aave
const approveAaveTx = await usdc.approve(aavePool);
await approveAaveTx.wait();

// 8. Depositar en Aave
const depositTx = await aavePool.supply(...);
await depositTx.wait();

// 9. Manejar errores, reintentos, etc.
// ... 100+ líneas mas

Con pan

import { Pan } from '@pan/sdk';

const pan = new Pan({
  apiKey: process.env.PAN_API_KEY
});

// Una sola llamada hace todo
const intent = await pan.lend({
  walletId: 'wallet_abc123',
  amount: 1000,
  asset: 'USDC'
});

// Monitorear progreso
const result = await pan.waitForIntent(intent.id);

console.log('Completado!');
console.log(`APY: ${result.results.apy}%`);
console.log(`Gas: $${result.results.totalGasCostUsd}`);

​
Próximos Pasos

Wallets en Detalle

Aprende como funcionan las wallets multi-chain

Intents Explicados

Entiende como funciona la ejecución basada en intents

Planes de Ejecución

Explora como pan optimiza estrategias de ejecución

Referencia API

Documentación completa de endpoints