Metas de la semana

• [x] Los cuatro paquetes en 1.0, publicados en npm
• [x] Un ejemplo que cobra en moneda local en menos de 20 líneas y compila en CI
• [x] Changelog y guía de migración de 0.x a 1.0

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 (pesos chilenos, reales, euros, rupias, nairas...) o en UF. Quien paga lo hace en USDC, XLM o EURC en una sola transacción, y el vendedor recibe el monto exacto en USDC. Es código abierto y funciona en la red principal de Stellar.

Esta semana. Los cuatro paquetes de Local402 pasan a 1.0. Son las bibliotecas que un desarrollador instala desde npm: local402-pricing (el precio), local402-fx (el cambio de moneda), local402-client (el que paga) y local402-server (el que cobra). Ahora revisan su configuración al arrancar, cada rechazo tiene un código de error que no cambia entre versiones, y un vendedor ya no puede entregar cotizaciones sin firmar. Una cotización es el precio convertido a USDC en ese momento; la firma permite comprobar después que la emitió el vendedor. Hay un ejemplo de 14 líneas que cobra una ruta en pesos chilenos y se compila en CI, las pruebas automáticas que corren en GitHub con cada cambio.

Changelog

Agregado

• Local402Error, exportado por cada paquete, con un code estable para cada rechazo y cada error de configuración. Están todos en docs/errors.md.
• NO_PAYMENT_OPTION: si el vendedor no acepta ningún esquema o red del cliente, el cliente lo dice y lista lo que el vendedor sí acepta, en vez de fallar dentro de x402.
• examples/quickstart: una ruta con precio en pesos, en 14 líneas, compilada en CI.
• Un CHANGELOG.md y una guía de migración de 0.x a 1.0.
• Un test que prueba que un cliente 0.1 y un vendedor 1.0 (y al revés) siguen pagándose.

Cambiado

• Un vendedor necesita un secreto de cotización (LOCAL402_QUOTE_SECRET, 32 caracteres como mínimo). En 0.x solo avisaba y servía cotizaciones sin firmar, y un reintento que caía en otra instancia podía rechazar un pago ya firmado.
• La configuración se valida al construirla, no en la primera petición: una red mal escrita, una dirección que no es de Stellar o una URL que no es http(s) fallan al arrancar con INVALID_CONFIG.
• Un precio en cero se rechaza al declarar la ruta.

Corregido