Saltar al contenido principal

Envoltorio del resultado de la transacción

Ambos endpoints REST devuelven objetos TransactionResult.

Transacción analizada

Transferencias nativas

nativeTransfers contiene movimientos de SOL en lamports. Las transferencias nativas incluyen las instrucciones transfer y create_account del programa del sistema, además de las transferencias sintéticas de SOL close_account de SPL Token.

Transferencias de tokens

tokenTransfers contiene movimientos de SPL Token y Token-2022. Las transferencias de tokens incluyen transfer, transfer_checked, transfer_checked_with_fee, burn, burn_checked, mint_to y mint_to_checked. Se omiten las transferencias de tokens con cantidad cero.

Resúmenes

summary tiene la misma estructura dondequiera que aparezca: en la transacción y en cada instrucción reconocida:
parsedData es el payload estructurado que respalda el resumen, cuando está disponible; por ejemplo, los metadatos de un intercambio con el protocolo, el tipo, las cantidades, los mints y cualquier intercambio interno a lo largo de la ruta. Su estructura varía según el tipo de resumen y el protocolo. Los importes de los swaps en parsedData, como in_amount, actual_out_amount, y los input_amount y output_amount de cada swap interno, son los importes informados por la plataforma. No son los importes que la billetera del usuario realmente envió o recibió, por lo que no consideran las comisiones de transferencia de Token-2022 ni otras deducciones aplicadas fuera del swap. Para obtener el importe exacto que recibió el usuario, compara los saldos de la cuenta de tokens del usuario antes y después de la transacción. Los tipos de resumen actuales incluyen:
  • add_liquidity
  • create_account
  • create_token_account
  • remove_liquidity
  • swap
  • transfer

Instrucciones analizadas

Las cuentas de instrucciones decodificadas tienen esta estructura:
Las claves args decodificadas y los nombres de las cuentas usan snake_case (source_account, in_amount), tal como se publican en la IDL del programa. Los argumentos enteros suelen devolverse como cadenas ("1500000000000") porque los valores u64 no caben en los números de JavaScript.

Errores decodificados

Cuando una transacción falla con un error de programa personalizado y la API puede identificar el error del programa que provocó el fallo, decodedError puede incluir:

Ejemplo completo

Un resultado completo de Parse Transactions para un swap de SOL a PUMP en Jupiter, que muestra el envoltorio, las transferencias, los resúmenes y cada instrucción: