Guía de uso

Cómo se usa el ecosistema RadhikaChain, de lo público a lo interno. Estados honestos en cada flujo.

1. Pagar un servicio (flujo x402)

1. El cliente llama al endpoint del servicio (p. ej. catálogo de amenazas) sin token.
2. El gateway responde HTTP 402 con un challenge de pago (x402) en los headers.
3. El cliente paga el monto en USDC (Base) con la clave de idempotencia del challenge.
4. El gateway verifica el pago (facilitator) y devuelve el recurso.

Reglas de conciliación documentadas: misma clave de idempotencia + mismo payload = un único efecto; clave repetida con payload distinto = rechazo; presupuesto agotado = no se autoriza otro gasto. Estado: PARTIAL — catálogo de capacidades operativo; la cobertura de servicios se amplía por upstream.

2. Trabajar con PRANA (presupuestos y recompensas)

• PRANA es el token interno de presupuestos, trabajos y recompensas. Conversión dura: 1 PRANA = 1 USDC solo con reserva verificada.
• Unidades: uPRANA = 10^6; uRADH = 10^8.
• El estado canónico de la economía vive en PostgreSQL (regla del proyecto: Postgres es canónico, JSON no).
• Advertencia honesta: el contenedor del engine mantuvo estado solo en un JSON sin volumen (riesgo conocido documentado; corrección en curso).

3. Consultar el MCP (agentes y forense)

• El servidor MCP expone herramientas forenses, de evidencia y de telemetría vía JSON-RPC (endpoint /mcp, ~55 herramientas, conformance verificada).
• DharmaGate actúa de escudo: valida identidad/agente y asienta PoI on-chain de forma fail-closed (si no puede asentar, rechaza).
• Los agentes se autentican por header HTTP o Basic Auth con tokens del grupo.

4. Desarrollar contratos

• Framework: Foundry (contracts/ del monorepo). Tests: 8 suites (.t.sol), fuzzing con Echidna.
• Redes soportadas y verificadas por RPC live: Arc (chain_id 5042) y GOAT (chain_id 2345).
• Flujo obligatorio antes de mainnet: análisis estático → fuzzing → invariantes → revisión → testnet → paquete de transacciones → aprobación explícita del operador → verificación on-chain independiente.

5. Indexar y consultar código (Orbit, interno)

• glab orbit index <repo> indexa un checkout al grafo DuckDB local.
• glab orbit grep|context|repo-map|sql consultan el grafo — el "wiki interno" de código.
• glab orbit mcp sirve el grafo a agentes MCP.

6. Límites conocidos hoy

• El bridge cross-chain no está operativo (solo backstrap del lado Bitcoin).
• Arc Jobs (ERC-8183) solo existe en testnet.
• El token envuelto y el bridge son operaciones distintas; cada una se verifica por separado antes de anunciarse.