> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockgence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clave pública de firma de la evidencia (abierta, sin créditos)

> La clave pública con que se firman los documentos sellados, para comprobar quién los emitió.

Abierta: sin API key, sin sesión y sin créditos. Se puede cachear 5 minutos.
- `configured`: la clave con que firma este servidor (`key_id`, `public_key`, `public_key_pem` y su estado en el
 registro publicado), o `null`, con el motivo en `configured_note`.
- `published`: el registro versionado de claves de Blockgence, con las vigentes, las retiradas y las revocadas y su
 período. Es lo que conviene comparar con `--expect-key`, mejor si se coteja con la web, que no depende de este
 servidor.
- `matches_published`: si la configurada es la vigente publicada (`null` sin clave).

Trae además el mensaje que se firma (`signed_message`), qué prueba la firma y qué no, y los pasos para verificar.



## OpenAPI

````yaml /openapi.json get /v1/evidence/signing-key
openapi: 3.1.0
info:
  title: blockgence API
  description: >

    **blockgence** expone como API todo el motor de *blockchain intelligence*:

    rastreo de fondos (tracing), atribución de entidades y screening de riesgo

    explicable (glass-box), sobre múltiples chains EVM.


    ### Autenticación

    Todas las rutas `/v1/*` requieren una **API key**. Mandala en el header

    `X-API-Key: <key>` (o `Authorization: Bearer <key>`). La key te la entrega
    tu

    organización o el administrador. En esta página: **Authorize** → pegá la
    key, y cada

    «Try it out» → «Execute» es una request real, que se cobra igual que desde
    tu código.

    Las rutas de verificación de evidencia (`/v1/evidence/*`) son abiertas.


    ### Límites

    Cada tier tiene un **rate-limit por minuto** y una **cuota mensual de
    créditos**.

    Cada endpoint consume créditos según su costo (`/trace` es el más caro); el
    costo puede

    variar por método y sub-ruta. **Solo se cobran las respuestas exitosas
    (status < 400)**:

    una request que termina en error queda registrada con 0 créditos. Consultá
    tu consumo en

    tiempo real con `GET /v1/account`.


    ### Fallas de la fuente de datos

    Si la fuente de datos falla al leer lo que pediste, la respuesta es `503
    source_unavailable`

    (sin cobro), con la fuente, la chain, la consulta, el motivo y si conviene
    reintentar. Si

    falla un salto intermedio, la respuesta es 200 y lo declara en
    `degraded_sources` (y en el

    `coverage_gaps` del nodo o la arista): ahí, la ausencia de datos no es
    ausencia de movimientos.


    ### Chains soportadas

    `ethereum`, `bsc`, `polygon`, `arbitrum`, `base`, `optimism`; además `tron`
    (rastreo, ficha, fondeo, probe y tx: ver «Tron» en `docs/API.md`). Qué
    fuente sirve cada consulta y con qué límite está en `GET /v1/chains` (0
    créditos). Conocidas y no consultadas (valen en `/screening` y `/address`,
    donde la chain la define el formato de la address): `monero`, `bitcoin`,
    `litecoin`, `solana`.

    Cualquier otra chain es `400`: nunca se sustituye por Ethereum.
  contact:
    name: blockgence
    url: https://www.blockgence.com/
  version: 1.0.0
servers:
  - url: https://app.blockgence.com
    description: Producción
security: []
tags:
  - name: Platform
    description: >-
      Qué chains hay y qué puede servir cada una (registro y matriz de
      capacidades), con qué fuentes y con qué metodología. Costo: 0 créditos.
  - name: Tracking
    description: >-
      Rastreo del flujo de fondos y lecturas de una address o una tx: grafo
      bidireccional con consistencia temporal, fondeo, contrapartes, bridges,
      swaps, mixers, labels y datos on-chain.
  - name: Screening
    description: >-
      Screening de riesgo: ¿esta address es riesgosa? Recomendación
      allow/review/block, con las razones y su fuente.
  - name: Contracts
    description: Inspector de contratos y simulación de transacciones antes de firmar.
  - name: Tokens
    description: 'Ficha de un token: emisor, supply, holders y señales de riesgo.'
  - name: Compromise
    description: 'Vector de compromiso de una wallet robada: cómo se perdió el control.'
  - name: Incident
    description: >-
      Respuesta a incidentes: víctima, hack y estafa. Playbook, freeze de fondos
      en emisores, post-mortem y entregables.
  - name: Copilot
    description: >-
      Copiloto forense con IA: investigá en lenguaje natural, con narrativa
      citada (streaming SSE).
  - name: Cases
    description: >-
      Casos: guardar, compartir y exportar investigaciones, con su evidencia,
      actividad y anotaciones.
  - name: Permissions
    description: >-
      Approvals, delegaciones y firmas que dan acceso a los fondos de una
      address (ERC-20, Permit2, EIP-7702).
  - name: Guard
    description: >-
      Blockgence Guard: vigilancia activa de wallets y protocolos, con alertas
      por webhook y correo.
  - name: Travel Rule
    description: >-
      Travel Rule sin red: desafío de titularidad, contraparte, conciliación y
      validación de mensajes IVMS101.
  - name: Auditoría
    description: >-
      Auditoría de smart contracts: pedir una revisión, su estado y hallazgos,
      las addresses desplegadas y las notas del equipo.
  - name: Evidencia
    description: >-
      Verificación de la evidencia sellada: clave pública de firma y sellos de
      tiempo. Abiertas: no piden API key ni cobran.
  - name: Monero
    description: >-
      Ficha pública de una tx de Monero y prueba de pago XMR (tx key u
      OutProof/InProof), verificada localmente y sellada. Monero no publica
      remitentes ni montos: no se rastrea.
  - name: Account
    description: Tu consumo y límites (self-service).
  - name: Icons
    description: >-
      Logos de entidades para renderizar grafos en tu UI. Cache-first
      (TrustWallet, 1inch, favicons oficiales). Costo: 0 créditos.
  - name: Meta
    description: Health y estado operacional (sin auth).
paths:
  /v1/evidence/signing-key:
    get:
      tags:
        - Evidencia
      summary: Clave pública de firma de la evidencia (abierta, sin créditos)
      description: >-
        La clave pública con que se firman los documentos sellados, para
        comprobar quién los emitió.


        Abierta: sin API key, sin sesión y sin créditos. Se puede cachear 5
        minutos.

        - `configured`: la clave con que firma este servidor (`key_id`,
        `public_key`, `public_key_pem` y su estado en el
         registro publicado), o `null`, con el motivo en `configured_note`.
        - `published`: el registro versionado de claves de Blockgence, con las
        vigentes, las retiradas y las revocadas y su
         período. Es lo que conviene comparar con `--expect-key`, mejor si se coteja con la web, que no depende de este
         servidor.
        - `matches_published`: si la configurada es la vigente publicada (`null`
        sin clave).


        Trae además el mensaje que se firma (`signed_message`), qué prueba la
        firma y qué no, y los pasos para verificar.
      operationId: signing_key_v1_evidence_signing_key_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.