Documentación Local2Coin

Documentación Local2Coin

Local2Coin está construido sobre la infraestructura de pago multi-canal open-source de P2Pagos.

P2Pagos utiliza:

• /mono como el repositorio orquestador basado en Nuxt.
• /wallet como la wallet de liquidación self-custodial móvil, basada en un fork de Aqua Wallet.
• /dashboard como la mini app Nuxt integrada en /wallet para configuraciones y flujos.
• /marketplace como la capa multi-usuario closed-source construida sobre /mono.
• BTCPay Server como el backend para la infraestructura de liquidación.

El stack está diseñado alrededor de:

• rieles de entrada
• servicios modulares
• liquidación self-custodial
• arquitectura de pago multi-canal
• movimiento de dinero transfronterizo práctico
• dependencia reducida de un solo procesador, banco, país o canal

Roles de los repositorios

Arquitectura

/mono

/mono es el repositorio orquestador de P2Pagos.

Ensambla rieles de pago, flujos de negocio, servicios de infraestructura y utilidades compartidas en un único workspace basado en Nuxt.

Este repositorio aún está siendo ordenado y debe leerse como una base orquestadora inicial, no como un producto terminado.

Estructura

/
├── nuxt.config.js      app Nuxt raíz — carga todos los módulos del workspace
├── app.vue
├── pages/
├── server/
├── rails/              módulos de rieles de pago
├── flows/              módulos de flujos de negocio
├── services/           módulos de servicios de infraestructura
└── utils/              utilidades compartidas

Lo que /mono no es

• No es un marketplace terminado.
• No es un SDK público pulido.
• No está suficientemente estable para garantizar uso amplio en producción.

Módulos de /mono

Rieles

Los módulos de rieles de pago inyectan páginas, composables y handlers de servidor en la app host. También pueden ejecutarse de forma autónoma como servidores Nitro.

Flujos

Módulos de funcionalidades de alto nivel con páginas y componentes UI.

Servicios

Módulos de infraestructura que funcionan tanto como apps Nitro autónomas como módulos Nuxt integrables.

Rieles de entrada multi-canal

Módulos de servicio

Desarrollo local de /mono

pnpm install
pnpm dev
pnpm build
pnpm preview

Carga de módulos en /mono

La app Nuxt raíz carga los módulos del workspace a través de nuxt.config.js.

Agregar un módulo requiere:

1. Añadir "@p2pagos/<name>": "workspace:*" a las dependencias del package.json raíz.
2. Añadir '@p2pagos/<name>' al array modules en nuxt.config.js.

flows/booking requiere @nuxt/ui. Debe estar presente en nuxt.config.js antes o junto al módulo de booking.

Variables de entorno de /mono

services/tor

rails/robosats

rails/peach

services/ip

services/market

Problemas conocidos de /mono

/wallet

/wallet es la wallet móvil self-custodial de P2Pagos, basada en un fork de Aqua Wallet.

Este repositorio existe porque Aqua ya proporciona una base sólida para la capa de liquidación que P2Pagos necesita, al tiempo que permite extenderla hacia flujos de pago específicos de P2Pagos, gestión de configuración e integraciones con marketplaces.

Por qué Aqua Wallet

Aqua Wallet fue seleccionada como base de este fork porque ya ofrece:

Cambios planificados en /wallet

El fork actual está pensado para evolucionar hacia la wallet móvil de liquidación y configuración de P2Pagos.

Los cambios planificados incluyen:

• Añadir soporte de wallet Polygon self-custodial derivado de la seed phrase existente, para soportar USDT en Polygon.
• Si es necesario para futuros rieles que liquiden en USDT en otras cadenas, extender soporte a través de interoperabilidad basada en USDT0, usando Polygon como red ancla principal.
• Reemplazar la pestaña de marketplace de Aqua por una pestaña Pagos dedicada, impulsada por la mini app Nuxt /dashboard.
• Integrar tasas de cambio de yadio.io, más representativas del precio real en mercados emergentes que fuentes solo de exchanges como Kraken.
• Mejorar continuamente la funcionalidad base incorporando regularmente cambios upstream de Aqua.
• Eliminar la distinción entre Saving Account para BTC y Spending Accounts para otros activos, para adaptarse mejor al modelo de producto orientado a pagos de P2Pagos.
• Añadir ruso y eliminar idiomas innecesarios, alineando la wallet con el conjunto de idiomas por defecto: EN, ES, PT, FR, IT, RU.
• Hacer un rebranding de la aplicación como parte de la familia de productos P2Pagos.

USDT en Polygon

Una de las principales incorporaciones planificadas es el soporte self-custodial de USDT en Polygon.

El objetivo es dar a los usuarios acceso a un activo de liquidación ampliamente usable en los rieles de pago integrables, preservando el mismo modelo de propiedad de wallet ya utilizado para Bitcoin y activos Liquid.

La implementación está diseñada en torno a:

• derivar el soporte de wallet Polygon de la misma seed phrase existente;
• soportar USDT en Polygon como activo de liquidación de primera clase;
• usar un stack EVM en Flutter para derivación de cuentas Polygon, firma e interacción con contratos;
• evaluar web3dart y onchainlabs_flutter;
• minimizar la exposición del usuario a la complejidad operativa del token nativo;
• gestionar las comisiones de red a través de un flujo ERC-4337 paymaster;
• abstraer las comisiones de la experiencia normal del usuario;
• cobrar comisiones en USDT en lugar de requerir gestión manual de MATIC.

Esto está pensado para hacer la liquidación en USDT operativamente más simple para usuarios que necesitan liquidación final en stablecoins sin fragmentación innecesaria de wallets.

Integración de la mini app /dashboard

La mini app /dashboard se integrará en la wallet mediante un enfoque basado en WebView.

Modelo de seguridad:

La app Nuxt integrada no recibe acceso directo a los secretos.

El puente está limitado a los datos y acciones requeridos para la UI de pagos:

• direcciones de recepción
• contexto básico de wallet
• solicitudes de firma

Esto mantiene el material sensible de claves dentro de la capa nativa de wallet mientras permite construir flujos y configuraciones específicos de P2Pagos en Nuxt.

Alcance de /wallet

El repositorio /wallet debe leerse como la capa de wallet móvil de la arquitectura más amplia de P2Pagos.

No es solo un fork de wallet genérico.

Su propósito es proporcionar:

• liquidación self-custodial para Bitcoin, activos Liquid y futuros rieles soportados;
• conexión segura a BTCPay Server e infraestructura de pago relacionada;
• una interfaz integrada para /dashboard y flujos relacionados con pagos;
• una base móvil para usuarios que interactúan con instancias de /mono y entornos de marketplace conectados.

Resumen del flujo de liquidación

Modelo operativo

Estado actual

P2Pagos está en evolución.

Algunos componentes existen como integraciones funcionales. Otros son parciales, experimentales, planificados o aún siendo ensamblados en el orquestador principal.

Los repositorios deben leerse como trabajo de infraestructura activo, no como un conjunto de productos terminados.