Skip to main content

Envoltório de resultado de transação

Ambos os endpoints REST retornam objetos TransactionResult.

Transação analisada

Transferências nativas

nativeTransfers contém movimentos de SOL em lamports. As transferências nativas incluem instruções do System Program transfer e create_account, além de transferências sintéticas de SOL do Token SPL close_account.

Transferências de Token

tokenTransfers contém movimentos de Token SPL e Token-2022. As transferências de token incluem transfer, transfer_checked, transfer_checked_with_fee, burn, burn_checked, mint_to, e mint_to_checked. Transferências de token com saldo zero são omitidas.

Resumos

summary tem um formato único em todos os lugares onde aparece — na transação e em cada instrução reconhecida:
parsedData é o payload estruturado por trás do resumo, quando disponível — por exemplo, metadados de swaps com o protocolo, tipo, quantias, emissões, e quaisquer swaps internos ao longo do caminho. Seu formato varia conforme o tipo de resumo e protocolo. Os valores de swap em parsedData, como in_amount, actual_out_amount e os input_amount e output_amount de cada swap interno, são os valores informados pela plataforma. Eles não são os valores que a carteira do usuário realmente enviou ou recebeu, portanto, não consideram as taxas de transferência do Token-2022 nem outras deduções aplicadas fora do swap. Para obter o valor exato recebido pelo usuário, compare os saldos da conta de token do usuário antes e depois da transação. Os tipos de resumo atuais incluem:
  • add_liquidity
  • create_account
  • create_token_account
  • remove_liquidity
  • swap
  • transfer

Instruções analisadas

As contas de instrução decodificadas têm esta estrutura:
As chaves args decodificadas e os nomes das contas usam snake_case (source_account, in_amount), conforme publicado na IDL do programa. Argumentos inteiros geralmente são retornados como strings ("1500000000000"), pois valores u64 não cabem em números do JavaScript.

Erros decodificados

Quando uma transação falha com um erro de programa personalizado e a API consegue identificar o erro do programa que causou a falha, decodedError pode incluir:

Exemplo completo

Um resultado completo de Parse Transactions para um swap de SOL por PUMP no Jupiter, mostrando o envelope, as transferências, os resumos e todas as instruções: