Metodología: Rail Readiness Levels (RRL)
Versión 1.0 · 2026-10-25
Esta página explica cómo asignamos el nivel RRL a cada ficha del directorio. RRL mide cuánta evidencia pública y verificable hay de que una organización opera un riel de pago para agentes. No mide calidad, seguridad ni reputación.
Principios
- Un nivel por riel y por ficha. El nivel no es de la organización. Una organización que usa x402 y ACP tiene dos niveles, uno por riel.
- El nivel se gana con evidencia. Solo cuenta lo que podemos observar y linkear. Lo que declara el vendedor no alcanza por sí solo.
- Todo nivel muestra su evidencia. Cada ficha muestra el nivel, el link a la evidencia, la fecha en que la observamos (con hora de Argentina, ART, cuando hay sondeo) y la fecha de la próxima revisión.
- Pocos niveles, con reglas para bajar. Hay cuatro niveles, de RRL 0 a RRL 3. Cada uno tiene reglas explícitas para subir y para bajar.
- La salud es otro eje. Que un servicio esté caído esta semana no cambia su nivel hasta que se cumple una regla de degradación.
Dos familias de rieles
Los criterios cambian según cómo se puede verificar el riel.
- Rieles con 402 (x402 y MPP). El servicio responde a un pedido sin pago con un código HTTP 402 y un desafío de pago que podemos leer. Los cobros se liquidan en una red pública, así que también se pueden verificar.
- Rieles sin 402 (AP2, ACP, PAP, UCP y otros). No existe un desafío 402 público que podamos sondear. La evidencia sale de fuentes primarias, como la documentación de la organización o del dueño del protocolo, y de manifiestos públicos cuando el riel los define.
Rieles y métodos que hoy no llegan a RRL 3
Algunos rieles y métodos de pago no dejan un pagador público que podamos verificar. Sin esa evidencia no podemos aplicar la regla de 2 pagadores distintos del dueño. Por eso hoy su nivel máximo es RRL 2 · Piloto:
- L402 (Lightning). El pago no deja un pagador visible en una red pública.
- MPP con tarjeta. El cobro se procesa fuera de una red pública.
- Sesiones MPP. Los pagos van por un canal de pago y no por un cobro individual que podamos atribuir a un pagador.
Si alguno de estos casos pasa a tener un pagador público verificable, actualizamos esta página y la regla se aplica igual que en el resto de los rieles con 402.
Niveles
RRL 0 · Indexado
La ficha aparece en una fuente pública de descubrimiento, como un catálogo de servicios o un listado de terceros, pero todavía no la verificamos.
- Criterio: existe al menos una fuente pública que lista el servicio o la organización con el riel.
- Evidencia linkeada: la fuente de descubrimiento y la fecha en que la leímos.
- Baja o sale: si en 4 semanas no sube de nivel, la ficha se archiva. Una ficha archivada se reabre si aparece evidencia nueva.
RRL 1 · Anunciado
La organización anunció oficialmente que usa o va a usar el riel.
- Criterio, para las dos familias: hay un anuncio, documentación o especificación publicada por la propia organización o por el dueño del protocolo, con fecha. Una nota de prensa sola no alcanza.
- Evidencia linkeada: la fuente primaria y su fecha.
- Baja: si el anuncio se retira o se desmiente, la ficha baja a RRL 0. Si pasan 180 días sin evidencia nueva, la ficha sigue en RRL 1 con la marca “anuncio sin novedades”.
RRL 2 · Piloto
El riel funciona, pero todavía no hay evidencia suficiente de cobros reales.
Rieles con 402
- Criterio: el endpoint responde un 402 válido en el sondeo semanal.
- x402: un desafío legible con al menos una opción de pago en
accepts, que indique esquema, red, activo y dirección de cobro (payTo). - MPP: un encabezado
WWW-Authenticate: Paymentcon identificador, realm, método e intent o request.
- x402: un desafío legible con al menos una opción de pago en
- Y además se cumple una de estas condiciones:
- En los últimos 30 días no hay cobros suficientes para RRL 3.
- Solo cobra en una red de prueba.
- Evidencia linkeada: el registro del sondeo, con fecha, código HTTP y huella del encabezado de pago.
Rieles sin 402
- Criterio: se cumple una de estas condiciones:
- La organización documenta un sandbox, una beta o una integración pública.
- Hay un piloto con un comercio nombrado.
- El riel define un manifiesto público y lo encontramos, pero tiene errores de validación.
- Evidencia linkeada: la página del sandbox o del piloto, o el resultado de la validación del manifiesto, con fecha.
Baja
- Con 402: después de 2 sondeos semanales seguidos sin un 402 válido, la ficha baja a RRL 1 y la salud pasa a “Caído”.
- Sin 402: si la revisión de 90 días no puede confirmar la fuente, la ficha se marca “revisión vencida”. Si la fuente ya no existe, baja a RRL 1.
RRL 3 · Producción
El riel cobra de verdad y hay evidencia reciente.
Rieles con 402
- Alcance: x402 y MPP con cobros individuales liquidados en una red pública. Los casos de la sección “Rieles y métodos que hoy no llegan a RRL 3” quedan como máximo en RRL 2.
- Criterio: se cumplen las dos condiciones:
- El último sondeo semanal recibió un 402 válido.
- En los últimos 30 días vimos cobros liquidados hacia el
payTodeclarado en ese 402, hechos por al menos 2 pagadores distintos del dueño.
- Qué es un pagador distinto del dueño: una billetera que pagó y que no es el
payTo. Tampoco puede estar vinculada alpayTopor su origen de fondos, por transferencias delpayTohacia ella ni por montos que vuelven en círculo. Los vínculos se buscan con datos públicos de la red, y cualquiera puede revisar las transacciones linkeadas en un explorador público. - Pagos que no cuentan:
- Los pagos de Lupa no cuentan para los 2 pagadores. Esto incluye los pagos de verificación y los pagos del sello “Pagado por Lupa”.
- Tampoco cuentan los cobros en redes de prueba.
- Evidencia linkeada:
- Los hashes de 2 transacciones de pagadores distintos, con link a un explorador público.
- El registro del último sondeo.
- Ventana: los 30 días son móviles. Se recalculan en cada sondeo semanal.
Rieles sin 402
- Criterio: se cumplen las dos condiciones:
- La organización documenta disponibilidad general (GA) del riel.
- Hay al menos 2 comercios nombrados que operan con el riel, cada uno con una fuente pública y fechada.
- Si el riel define un manifiesto público, el manifiesto además tiene que validar sin errores en el sondeo semanal.
- Evidencia linkeada: la fuente primaria de la disponibilidad general, con fecha, la fuente de cada uno de los 2 comercios y el resultado de la validación del manifiesto, si corresponde.
- La regla de 2 pagadores no aplica: en estos rieles no podemos observar pagos de forma pública. Por eso su RRL 3 exige 2 comercios nombrados y la ficha lo indica.
Baja
- Si en los últimos 30 días quedan menos de 2 pagadores distintos del dueño, la ficha baja a RRL 2.
- Con 2 sondeos semanales seguidos sin un 402 válido, baja a RRL 2 y la salud pasa a “Caído”. Con 3 sondeos seguidos baja a RRL 1.
- Si cambia el
payTo, la ficha baja a RRL 2 hasta que veamos 2 pagadores distintos del dueño hacia la dirección nueva. - Sin 402: si la revisión de 90 días no confirma la fuente, la ficha se marca “revisión vencida”. Si la organización retira la disponibilidad general o quedan menos de 2 comercios nombrados operando, baja a RRL 2.
Cómo se sube
- Una ficha sube como máximo un nivel por sondeo semanal. La excepción es una ficha nueva, que puede entrar directo en el nivel que su evidencia permita.
- Para subir, la evidencia tiene que estar vigente el día del sondeo. Una evidencia vieja no sirve para subir aunque haya sido válida.
- Ninguna ficha sube por pedido del vendedor. El vendedor puede enviarnos evidencia y la verificamos igual que cualquier otra.
- Antes de publicar un RRL 3 nuevo, revisamos a mano los pagadores. Mientras tanto la ficha queda en RRL 2 con el motivo “pagadores en revisión manual”.
Sondeo semanal
- Una vez por semana hacemos un pedido sin pago a cada endpoint con 402 registrado y guardamos el código HTTP, el encabezado de pago y la fecha.
- Nunca pagamos durante el sondeo semanal. Los pagos de verificación solo se hacen para el sello “Pagado por Lupa”.
- En la misma pasada buscamos en la red los cobros hacia cada
payTodeclarado en los últimos 30 días y contamos los pagadores distintos del dueño. - Los manifiestos públicos de rieles sin 402 (por ejemplo PAP o UCP) se validan en la misma pasada cuando el riel los define.
- Las fuentes primarias de rieles sin 402 se revisan cada 90 días.
Qué se linkea en cada nivel
| Nivel | Con 402 | Sin 402 |
|---|---|---|
| RRL 0 · Indexado | Fuente de descubrimiento y fecha de lectura | Fuente de descubrimiento y fecha de lectura |
| RRL 1 · Anunciado | Anuncio, documentación o spec oficial, con fecha | Anuncio, documentación o spec oficial, con fecha |
| RRL 2 · Piloto | Registro del sondeo: fecha, código HTTP y huella del encabezado | Página del sandbox o del piloto, o validación del manifiesto |
| RRL 3 · Producción | Hashes de 2 transacciones de pagadores distintos y registro del sondeo | Fuente primaria de la disponibilidad general, fuentes de 2 comercios nombrados y validación del manifiesto |
Sello “Pagado por Lupa”
El sello no es un nivel. Indica que hicimos una llamada pagada real al servicio y que el servicio entregó lo que prometía.
- Evidencia linkeada: el hash de nuestro pago y la fecha.
- Vencimiento: el sello vence a los 90 días. También vence antes si cambia el
payTo, el precio o el formato de la respuesta. - Medición parcial: por ahora el sello cubre 48 de los 90 días. La completamos en las próximas semanas.
- Relación con el nivel: el sello no sube el nivel. Los pagos de Lupa no cuentan para los 2 pagadores distintos del dueño.
Eje de salud
La salud es independiente del nivel y refleja el último sondeo.
- Operativo: el último sondeo recibió un 402 válido.
- Degradado: el último sondeo falló o el desafío vino incompleto, pero el sondeo anterior estaba bien.
- Caído: 2 sondeos semanales seguidos sin un 402 válido, o el primer sondeo de un riel sin un 402 válido.
- Sin sondeo: el riel no tiene un 402 público, como AP2 o ACP. La ficha no muestra salud medida.
Qué no mide RRL
- No sondeamos AP2 ni ACP con un 402. Estos rieles no exponen un desafío 402 público. Su nivel depende de fuentes primarias y de la revisión cada 90 días.
- No verifica pagadores en L402, MPP con tarjeta ni sesiones MPP. Por eso estos casos llegan como máximo a RRL 2.
- No contamos pagadores en redes no EVM (por ejemplo Solana): esos rieles quedan en RRL 2 hasta tener un método verificable.
- No mide calidad ni seguridad. Un RRL 3 indica que hay cobros reales recientes. No dice que el servicio sea bueno, seguro o barato.
- No mide volumen. Dos pagadores alcanzan para RRL 3. El nivel no compara servicios por cantidad de ventas.
- No garantiza que los pagadores sean independientes. El método de pagadores distintos detecta los vínculos visibles en la red. Un dueño que usa billeteras sin rastro común puede pasar el filtro.
- Métricas de terceros. Cuando mostramos un dato que no medimos nosotros, lo rotulamos con su fuente, por ejemplo “según CDP”, y lo linkeamos. Esos datos nunca deciden el nivel por sí solos.
Campos de cada ficha
| Campo | Contenido |
|---|---|
rail | Riel de la ficha |
rrl | Nivel, de 0 a 3 |
evidence_type | source, probe, settlement o paid_probe |
evidence_url | Link a la evidencia |
observed_at | Fecha (y hora, cuando hay sondeo) de la observación, en ART |
probe_id | Identificador del sondeo |
next_review | Fecha de la próxima revisión |
health | Operativo, Degradado, Caído o Sin sondeo |
degraded_reason | Motivo de la última baja o marca, si hay |
Cómo reportar un error
Si una ficha tiene un nivel, una evidencia o un dato equivocado, escribinos a lupa@mail.grokbot.com. Incluí:
- el link a la ficha y el riel
- qué dato está mal
- la evidencia que lo corrige: un link público, un hash de transacción o una fuente primaria con fecha
Revisamos cada reporte con el mismo método que cualquier otra evidencia. Si el reporte se confirma, corregimos la ficha y lo dejamos registrado en su historial con la fecha.