Metas de la semana

• [x] Entregable 4: más tests, QA y CI, con una revisión programada del demo de mainnet
• [x] Arreglar los bugs que encuentren los tests nuevos
• [x] Entregable 5: una API que no es nuestra cobrando con los paquetes 1.0
• [x] Pagos de esa API en testnet con USDC y con XLM

Resumen

Qué es Local402. Local402 permite cobrar por una API en la moneda local, con x402 en Stellar. x402 es un estándar abierto para pagar por HTTP: la API responde "402 Payment Required" con el precio, y el cliente (una persona o un agente de IA) paga y repite la petición. El vendedor pone el precio en cualquiera de 24 monedas o en UF; quien paga usa USDC, XLM o EURC en una sola transacción y el vendedor recibe el monto exacto en USDC.

Esta semana. Es la última del sprint y trae dos entregables, adelantados una semana. El 4: los tests, el QA y el CI. Los tests de TypeScript pasaron de 86 a 140 y los del contrato de 11 a 17, encontraron dos bugs reales que quedaron arreglados, y una prueba programada revisa el demo de mainnet cada seis horas. El 5: kuyfi, un escáner de seguridad para contratos de Soroban que hizo otro desarrollador, pasó a los paquetes 1.0 y cobra 500 pesos chilenos por escaneo en testnet, pagados con USDC o con XLM. El cambio entró a su repositorio: su autor aceptó el pull request.

Changelog

Agregado

Entregable 4, tests, QA y CI (CI es la integración continua: los tests corren solos en cada cambio):

• Tests del oráculo, el que convierte pesos a USDC: huecos en el historial, una sola lectura, precios en cero, un RPC que falla o se cuelga. Si el RPC se cae, usa el último precio bueno por diez minutos como máximo, y después deja de cobrar.
• Tests de las guardas del cliente, las que protegen a quien paga: presupuesto, precio máximo y pagos al mismo tiempo.
• Un test por cada regla que el facilitador revisa antes de gastar. Los pagos con XLM o EURC se prueban contra una red simulada, sin internet: la firma del que paga, el monto exacto para el vendedor y que nadie toque los fondos del facilitador. Para comprobar que estos tests sirven, rompí a propósito cada regla: siempre falla un test.
• 6 tests nuevos del contrato FxPay sobre rutas y reembolsos: si el router intenta llevarse más de lo cotizado, o entrega menos, se revierte el pago entero.
• Un reporte de cobertura (npm run coverage), que mide qué parte del código ejecutan los tests.
• Una prueba programada en GitHub Actions: cada seis horas pide el precio a cada ruta pagada del demo de mainnet y lo compara con el oráculo. Nunca paga y no usa ninguna llave.

Entregable 5, una API externa cobrando con Local402:

• kuyfi pasó de local402-server 0.1 a 1.0, en el pull request #5 de su repositorio, que su autor aceptó el 1 de noviembre.