Presentamos la Parsed Events API y Parsed Streams

¿Por qué es difícil leer las transacciones de Solana?

Cuando consultas nodos RPC estándar para saber qué ocurrió en una transacción, obtienes una lista de direcciones de cuentas sin nombres y datos de instrucciones como un bloque base58 opaco.

Para convertir eso en "esta billetera intercambió 1,500 SOL por PUMP en Jupiter", tradicionalmente tienes que:

1. Obtener la transacción e identificar cada programa con el que interactuó
2. Encontrar el IDL de cada programa (su interfaz publicada), si existe
3. Decodificar los datos de la instrucción (normalmente Borsh) con ese IDL
4. Asociar las cuentas posicionales con sus funciones: ¿la tercera dirección es la autoridad o el destino? Solo la interfaz del programa lo sabe
5. Recorrer de forma recursiva las instrucciones internas (CPI), donde ocurre la mayor parte de la actividad real, como los movimientos de tokens dentro de un intercambio
6. Repetir el proceso para cada programa que te interese y mantener tus decodificadores actualizados a medida que los programas publican nuevas versiones

Son semanas de trabajo de ingeniería antes de poder responder una sola pregunta, y es una de las curvas de aprendizaje más pronunciadas al comenzar con Solana. Los datos de la cadena son públicos, pero no son legibles.

Creamos una capa de decodificación del lado del servidor para que no tengas que hacerlo.

¿Qué incluye una respuesta de Parsed Events?

Cada transacción se devuelve decodificada mediante el catálogo de IDL de Helius. 

Aquí tienes un intercambio real de Jupiter, reducido a lo más relevante:

{
  "summary": {
    "type": "swap",
    "description": "GV6UUm… swapped 1500 SOL for 64672839.26195 PUMP via Jupiter",
    "parsedData": {
      "protocol": "jupiter",
      "in_amount": "1500000000000",
      "actual_out_amount": "64672839261950",
      "input_mint": "So11111111111111111111111111111111111111112",
      "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
    }
  },
  "instructions": [
    {
      "programName": "jupiter",
      "instructionName": "shared_accounts_route_v2",
      "decoded": {
        "args": { "in_amount": "1500000000000", "slippage_bps": 2200 },
        "accounts": [
          { "name": "user_transfer_authority", "pubkey": "GV6UUm…", "isSigner": true },
          { "name": "source_mint", "pubkey": "So1111…" }
        ]
      }
    }
  ]
}

En lugar de adivinar qué significa la tercera dirección de una lista de cuentas, puedes leer "name": "user_transfer_authority". 

Los argumentos también llegan decodificados: "slippage_bps": 2200 en lugar de bytes sin procesar.

Además, el summary de la transacción podría mostrarse textualmente a los usuarios.

Cada resultado también incluye la comisión y quién la paga, transferencias nativas de SOL, transferencias de SPL y Token-2022, y errores decodificados de programas personalizados cuando hay metadatos disponibles. 

Para los programas que no están en el catálogo, las instrucciones recurren a datos y cuentas sin procesar, por lo que siempre tienes algo con lo cual trabajar.

Parsed Streams: transacciones decodificadas que recibes automáticamente

Parsed Streams es un servicio WebSocket que supervisa cada transacción confirmada, la decodifica y te envía las que coinciden con tu filtro a nivel de instrucción y del lado del servidor.

Nunca tienes que gestionar un flujo masivo de datos ni mantener un decodificador.

Un filtro se crea a partir de cinco campos:

1. programs
2. instructionNames
3. accounts (por inclusión o por función con nombre)
4. includeCpi
5. includeFailed

Por ejemplo, "cada instrucción de ruta de Jupiter que interactúe con esta billetera" se expresa así:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "parsedTransactionSubscribe",
  "params": [
    {
      "programs": ["JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"],
      "instructionNames": ["route", "shared_accounts_route"]
    }
  ]
}

Cada notificación contiene la transacción decodificada completa, y matchedIndexes señala las instrucciones que coincidieron con tu filtro.

¿Cómo obtienes los nombres de las instrucciones de los programas de Solana?

Adivinar los nombres de las instrucciones es la causa más común de que un filtro no encuentre coincidencias sin mostrar ningún error. Para obtener los nombres de las instrucciones de los programas de Solana, llama a describeProgram con la dirección de cualquier programa. Este devuelve las instrucciones, los eventos y las funciones de las cuentas con las que compara el sistema de coincidencias:

{
  "id": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4",
  "name": "jupiter",
  "instructions": ["route", "shared_accounts_route", "exact_out_route"],
  "events": ["SwapEvent"],
  "roles": ["user_transfer_authority", "destination_token_account"]
}

Busca el programa, agrega los nombres a tu filtro y luego suscríbete. 

La guía para rastrear intercambios de Jupiter explica todo este flujo de principio a fin.

La Parsed Events API: transacciones decodificadas bajo demanda

Para las consultas en lugar de los datos en vivo, la Parsed Events API aplica bajo demanda la misma decodificación basada en el catálogo de IDL.

Parse Transactions recibe firmas y las devuelve decodificadas.

Parsed Transaction History pagina todo el historial decodificado de una dirección y devuelve primero las transacciones más recientes.

curl -X POST "https://mainnet.helius-rpc.com/v1/parsed-events/transactions?api-key=YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"transactions": ["5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"]}'

Ambos métodos también están disponibles mediante GraphQL, por lo que puedes seleccionar solo los campos analizados que necesita tu aplicación.

Parsed Events frente a Enhanced Transaction API

Parsed Events es el sucesor de Enhanced Transactions API. 

Mientras que Enhanced Transactions clasificaba las transacciones en una lista fija de tipos de eventos, Parsed Events decodifica cada instrucción mediante el catálogo de IDL y utiliza datos sin procesar como alternativa, en lugar de UNKNOWN, para los programas no reconocidos.

Si actualmente usas la Enhanced Transactions API, la guía de migración relaciona cada endpoint, parámetro y campo de respuesta, e incluye un prompt que tu agente puede ejecutar para completar la migración por ti.

¿Qué herramienta de análisis es adecuada para mí?

Los dos nuevos productos comparten un mismo motor de decodificación, por lo que una transacción tiene el mismo aspecto sin importar si llegó mediante un stream o una llamada REST. Y lo más importante: puedes crear un prototipo con datos históricos mediante Parsed Events y pasar a datos en vivo con Parsed Streams sin cambiar tu código de análisis.

Comienza ahora

Parsed Streams y la Parsed Events API están en beta abierta y disponibles en todos los planes de pago. Obtén tu clave de API en el panel de Helius.

Para conectarte, usa los siguientes endpoints:

Parsed Streams: 

wss://fs-beta.helius-rpc.com/?api-key=YOUR_API_KEY

Parsed Events API: 

https://mainnet.helius-rpc.com/v1/parsed-events/...?api-key=YOUR_API_KEY

Guías

La guía de inicio rápido de Parsed Streams te ayuda a recibir tu primera notificación decodificada en pocos minutos. La guía de inicio rápido de Parsed Events hace lo mismo con tu primera firma analizada. 

Si tienes preguntas, contáctanos por Telegram o Discord.