> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# simulateTransaction
> Simule uma transação Solana para visualizar logs, uso de unidades de computação e alterações de conta sem enviá-la para a rede — usado para estimar taxas, detectar falhas e depurar instruções antes de assinar.
## Parâmetros da Solicitação
A transação assinada, como uma string codificada (base58 ou base64).
Codificação usada para os dados da transação.
* `base58`
* `base64`
Pular as verificações de transação preliminares.
Nível de compromisso a ser usado para a verificação preliminar.
* `confirmed`
* `finalized`
* `processed`
Se verdadeiro, verificar as assinaturas da transação.
Se verdadeiro, substituir o blockhash recente da transação pelo mais recente.
Slot mínimo no qual realizar verificações preliminares de transações.
Se verdadeiro, incluir instruções internas na resposta.
Array de contas a serem retornadas, como strings codificadas em base-58.
Formato de codificação para dados de conta retornados.
* `base64`
* `base58`
* `base64+zstd`
* `jsonParsed`
## OpenAPI
````yaml pt-BR/openapi/rpc-http/simulateTransaction.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API avançada de simulação de transações Solana para testar e depurar
transações blockchain antes de confirmá-las na rede Solana.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: simulateTransaction
description: >-
Simular transações Solana sem executá-las no blockchain. Essa poderosa
ferramenta de depuração permite que os desenvolvedores testem a execução
de transações, verifiquem o comportamento do programa, estimem o consumo
de unidades de computação, detectem erros e visualizem alterações no
estado da conta antes de confirmar as transações na rede. Essencial para
o desenvolvimento de aplicativos Solana, testes de contratos
inteligentes e otimização de transações.
operationId: simulateTransaction
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: A versão do protocolo JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Um identificador único para a solicitação.
example: '1'
default: '1'
method:
type: string
enum:
- simulateTransaction
description: O nome do método RPC a ser invocado.
example: simulateTransaction
default: simulateTransaction
params:
type: array
description: Parâmetros para simular uma transação.
default:
- >-
AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDArczbMia1tLmq7zz4DinMNN0pJ1JtLdqIJPUw3YrGCzYAMHBsgN27lcgB6H2WQvFgyZuJYHa46puOQo9yQ8CVQbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCp20C7Wj2aiuk5TReAXo+VTVg8QTHjs0UjNMMKCvpzZ+ABAgEBARU=
- encoding: base64
items:
oneOf:
- type: string
description: >-
A transação assinada, como uma string codificada
(base58 ou base64).
example: >-
AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDArczbMia1tLmq7zz4DinMNN0pJ1JtLdqIJPUw3YrGCzYAMHBsgN27lcgB6H2WQvFgyZuJYHa46puOQo9yQ8CVQbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCp20C7Wj2aiuk5TReAXo+VTVg8QTHjs0UjNMMKCvpzZ+ABAgEBARU=
- type: object
description: Objeto de configuração para a simulação.
properties:
encoding:
type: string
description: Codificação utilizada para os dados da transação.
enum:
- base58
- base64
example: base64
skipPreflight:
type: boolean
description: Pular as verificações de transações preflight.
example: false
preflightCommitment:
type: string
description: Nível de compromisso a ser usado para o preflight.
enum:
- confirmed
- finalized
- processed
example: finalized
sigVerify:
type: boolean
description: >-
Se verdadeiro, verifique as assinaturas da
transação.
example: false
replaceRecentBlockhash:
type: boolean
description: >-
Se verdadeiro, substitua o blockhash recente da
transação pelo mais recente.
example: false
minContextSlot:
type: integer
description: >-
Slot mínimo no qual realizar verificações de
transações preflight.
example: 1000
innerInstructions:
type: boolean
description: >-
Se verdadeiro, inclua instruções internas na
resposta.
example: false
accounts:
type: object
properties:
addresses:
type: array
description: >-
Matriz de contas a serem retornadas, como
strings codificadas em base-58.
items:
type: string
example: 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
encoding:
type: string
description: >-
Formato de codificação para os dados da conta
retornados.
enum:
- base64
- base58
- base64+zstd
- jsonParsed
example: base64
responses:
'200':
description: Transação simulada com sucesso.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identificador que corresponde à solicitação.
example: '1'
result:
type: object
description: Resultado da transação simulada.
properties:
context:
type: object
description: Contexto da resposta da simulação.
properties:
apiVersion:
type: string
description: A versão da API do nó RPC.
example: 2.3.3
slot:
type: integer
description: Slot no qual os dados foram buscados.
example: 393226680
value:
type: object
description: Detalhes do resultado da transação simulada.
properties:
accounts:
type:
- array
- 'null'
items:
type: object
description: Detalhes da conta associada à transação.
example:
lamports: 5000
owner: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
err:
type:
- object
- 'null'
description: Erro se a transação falhou, nulo se bem-sucedida.
example: null
innerInstructions:
type:
- array
- 'null'
description: >-
Instruções internas executadas durante a
transação.
example: null
loadedAccountsDataSize:
type:
- integer
- 'null'
description: >-
Tamanho total em bytes de todos os dados da conta
carregados durante a simulação.
example: 413
logs:
type:
- array
- 'null'
items:
type: string
description: >-
Logs de execução do programa da simulação de
transação.
example:
- >-
Program
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
invoke [1]
- 'Program log: Instruction: Transfer'
- >-
Program
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
consumed 1714 of 200000 compute units
- >-
Program
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
success
replacementBlockhash:
type:
- object
- 'null'
description: >-
Informações do blockhash de substituição quando
replaceRecentBlockhash está ativado.
properties:
blockhash:
type: string
description: O blockhash de substituição.
example: 6oFLsE7kmgJx9PjR4R63VRNtpAVJ648gCTr3nq5Hihit
lastValidBlockHeight:
type: integer
description: >-
A última altura de bloco válida para o
blockhash de substituição.
example: 381186895
returnData:
type:
- object
- 'null'
properties:
programId:
type: string
example: 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
data:
type: array
items:
type: string
example:
- Kg==
- base64
description: Dados retornados pela transação, se houver.
example: null
unitsConsumed:
type:
- integer
- 'null'
description: >-
Total de unidades de computação consumidas durante
a simulação.
example: 1714
example:
jsonrpc: '2.0'
id: 1
result:
context:
apiVersion: 2.3.3
slot: 393226680
value:
accounts: null
err: null
innerInstructions: null
loadedAccountsDataSize: 413
logs:
- >-
Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
invoke [1]
- 'Program log: Instruction: Transfer'
- >-
Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
consumed 1714 of 200000 compute units
- >-
Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
success
replacementBlockhash:
blockhash: 6oFLsE7kmgJx9PjR4R63VRNtpAVJ648gCTr3nq5Hihit
lastValidBlockHeight: 381186895
returnData: null
unitsConsumed: 1714
'400':
description: >-
Requisição inválida - Parâmetros inválidos da solicitação ou
requisição malformada.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: Não autorizado - Chave API inválida ou ausente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: Muitas solicitações - Limite de taxa excedido.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: Erro interno do servidor - Ocorreu um erro no servidor.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: Serviço Indisponível - O serviço está temporariamente indisponível.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: Tempo de espera do gateway - A solicitação expirou.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Gateway timeout
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: O código de erro.
example: -32602
message:
type: string
description: A mensagem de erro.
data:
type: object
description: Dados adicionais sobre o erro.
id:
type: string
description: Identificador que corresponde à solicitação.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave API Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````