Skip to main content
Las wallets son el componente fundamental de pan. Representan cuentas de usuario que funcionan en múltiples blockchains con una sola dirección.

¿Qué es una Wallet en pan?

Una wallet de pan es una cuenta no-custodial que:
  • Una dirección, múltiples chains: La misma dirección funciona en Ethereum, Arbitrum, Base, etc.
  • No-custodial: Tu no tienes acceso a las llaves privadas (gestionadas por Privy)
  • Ligada a un usuario: Cada wallet pertenece a un userId de tu aplicación
  • Multi-token: Soporta múltiples tokens por chain
Todos accesibles con la misma dirección 0x742d35Cc...
Una dirección, múltiples chains: La misma dirección 0x742d35Cc... funciona en todas las redes EVM.

Crear una Wallet

Parámetros

Respuesta

userId debe ser unico. Si intentas crear una wallet con un userId que ya existe, recibiras un error. Usa el endpoint GET para recuperar wallets existentes.

Obtener una Wallet

El endpoint usa userId, no walletId. Esto facilita mapear usuarios de tu aplicación a wallets de pan.

Consultar Balances

Obtiene balances de todas las chains y tokens con una sola llamada:

Estructura de Balance

Cada token en el balance incluye:

Chains Soportadas

Mainnet

Testnet (Disponible ahora)

Actualmente pan opera en testnets. Mainnet estará disponible pronto.

Tokens Soportados

USDC (Principal)

Otros Tokens

Como Funciónan las Wallets Multi-chain

pan utiliza Privy para generar wallets. La magia de “una dirección, múltiples chains” funciona porque:
  1. Derivación Determinística: La misma llave privada genera la misma dirección en todas las chains EVM
  2. Privy como Custodio Tecnico: Privy maneja las llaves de forma segura
  3. Tu Aplicacion No Tiene Acceso: Las llaves nunca salen de la infraestructura de Privy
1

Tu app llama a pan

wallet.create({ userId: '123' })
2

pan solicita wallet a Privy

Privy genera llave privada, deriva dirección, y la almacena encriptada
3

pan guarda el mapeo

Se registra la relacion userId → walletId en la base de datos
4

pan retorna la wallet

Tu app recibe { id, address, chains[] }
La llave privada nunca sale de Privy. Tu aplicación solo recibe la dirección publica.

Arquitectura de Seguridad

Limites de Wallets

Los límites de wallets dependen de tu plan:

Verificar Uso

Metadata

El campo metadata te permite almacenar datos adicionales con cada wallet:
No almacenes datos sensibles (contrasenas, tokens de sesion, etc.) en metadata. Aunque están almacenados de forma segura, es mejor práctica mantenerlos separados.

Patrones Comunes

Crear Wallet al Registrarse

Obtener o Crear Wallet

Mostrar Balances al Usuario

Fondear Wallets

En Testnet (Demo)

pan ofrece un endpoint para fondear wallets de prueba:

En Produccion

En produccion, los usuarios depositan fondos directamente a su dirección de wallet:

Próximos Pasos

Consultar Balances

Guía detallada sobre consulta de balances

Intents

Aprende sobre operaciones basadas en intents

Crear Wallets API

Referencia completa del endpoint

Seguridad

Mejores prácticas de seguridad