> ## 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
> simulateTransaction muestra una vista previa de los registros, el uso de unidades de cómputo y los cambios en las cuentas de una transacción de Solana sin enviarla. Úsalo para estimar comisiones y detectar errores.
## Parámetros de la solicitud
La transacción firmada, como una cadena codificada en base58 o base64.
Codificación utilizada para los datos de la transacción.
* `base58`
* `base64`
Omite las comprobaciones preliminares de la transacción.
Nivel de confirmación que se usará para las comprobaciones preliminares.
* `confirmed`
* `finalized`
* `processed`
Si es verdadero, verifica las firmas de la transacción.
Si es verdadero, reemplaza el hash de bloque reciente de la transacción por el más reciente.
Slot mínimo en el que se realizarán las comprobaciones preliminares de la transacción.
Si es verdadero, incluye las instrucciones internas en la respuesta.
Arreglo de cuentas que se devolverán, como cadenas codificadas en base58.
Formato de codificación de los datos de cuenta devueltos.
* `base64`
* `base58`
* `base64+zstd`
* `jsonParsed`
## OpenAPI
````yaml es/openapi/rpc-http/simulateTransaction.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API avanzada de simulación de transacciones de Solana para probar y depurar
transacciones de blockchain antes de enviarlas a la red de 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 de Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC de Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: simulateTransaction
description: >
Simula transacciones de Solana sin ejecutarlas en la blockchain. Esta
potente
herramienta de depuración permite a los desarrolladores probar la
ejecución de transacciones, verificar el comportamiento de los
programas,
estimar el consumo de unidades de cómputo, detectar errores y
previsualizar los cambios en el estado de las cuentas
antes de enviar las transacciones a la red. Es esencial para desarrollar
aplicaciones de Solana,
probar contratos inteligentes y optimizar transacciones.
operationId: simulateTransaction
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La versión del protocolo JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Un identificador único para la solicitud.
example: '1'
default: '1'
method:
type: string
enum:
- simulateTransaction
description: El nombre del método RPC que se invocará.
example: simulateTransaction
default: simulateTransaction
params:
type: array
description: Parámetros para simular una transacción.
default:
- >-
AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDArczbMia1tLmq7zz4DinMNN0pJ1JtLdqIJPUw3YrGCzYAMHBsgN27lcgB6H2WQvFgyZuJYHa46puOQo9yQ8CVQbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCp20C7Wj2aiuk5TReAXo+VTVg8QTHjs0UjNMMKCvpzZ+ABAgEBARU=
- encoding: base64
items:
oneOf:
- type: string
description: >-
La transacción firmada como una cadena codificada
(base58 o base64).
example: >-
AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDArczbMia1tLmq7zz4DinMNN0pJ1JtLdqIJPUw3YrGCzYAMHBsgN27lcgB6H2WQvFgyZuJYHa46puOQo9yQ8CVQbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCp20C7Wj2aiuk5TReAXo+VTVg8QTHjs0UjNMMKCvpzZ+ABAgEBARU=
- type: object
description: Objeto de configuración para la simulación.
properties:
encoding:
type: string
description: >-
Codificación utilizada para los datos de la
transacción.
enum:
- base58
- base64
example: base64
skipPreflight:
type: boolean
description: >-
Omite las comprobaciones preliminares de la
transacción.
example: false
preflightCommitment:
type: string
description: >-
Nivel de confirmación que se utilizará en la
comprobación preliminar.
enum:
- confirmed
- finalized
- processed
example: finalized
sigVerify:
type: boolean
description: Si es true, verifica las firmas de la transacción.
example: false
replaceRecentBlockhash:
type: boolean
description: >-
Si es true, reemplaza el blockhash reciente de la
transacción por el más reciente.
example: false
minContextSlot:
type: integer
description: >-
Slot mínimo en el que se realizarán las
comprobaciones preliminares de la transacción.
example: 1000
innerInstructions:
type: boolean
description: >-
Si es true, incluye las instrucciones internas en
la respuesta.
example: false
accounts:
type: object
properties:
addresses:
type: array
description: >-
Arreglo de cuentas que se devolverán, como
cadenas codificadas en base58.
items:
type: string
example: 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
encoding:
type: string
description: >-
Formato de codificación de los datos de cuenta
devueltos.
enum:
- base64
- base58
- base64+zstd
- jsonParsed
example: base64
responses:
'200':
description: La transacción se simuló correctamente.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
result:
type: object
description: Resultado de la transacción simulada.
properties:
context:
type: object
description: Contexto de la respuesta de simulación.
properties:
apiVersion:
type: string
description: La versión de la API del nodo RPC.
example: 2.3.3
slot:
type: integer
description: Slot en el que se obtuvieron los datos.
example: 393226680
value:
type: object
description: Detalles del resultado de la transacción simulada.
properties:
accounts:
type:
- array
- 'null'
items:
type: object
description: >-
Detalles de las cuentas asociadas con la
transacción.
example:
lamports: 5000
owner: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
err:
type:
- object
- 'null'
description: >-
Error si la transacción falló; null si se completó
correctamente.
example: null
innerInstructions:
type:
- array
- 'null'
description: >-
Instrucciones internas ejecutadas durante la
transacción.
example: null
loadedAccountsDataSize:
type:
- integer
- 'null'
description: >-
Tamaño total en bytes de todos los datos de cuenta
cargados durante la simulación.
example: 413
logs:
type:
- array
- 'null'
items:
type: string
description: >-
Registros de ejecución del programa generados por
la simulación de la transacción.
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: >-
Información del blockhash de reemplazo cuando
replaceRecentBlockhash está habilitado.
properties:
blockhash:
type: string
description: El blockhash de reemplazo.
example: 6oFLsE7kmgJx9PjR4R63VRNtpAVJ648gCTr3nq5Hihit
lastValidBlockHeight:
type: integer
description: >-
La última altura de bloque válida para el
blockhash de reemplazo.
example: 381186895
returnData:
type:
- object
- 'null'
properties:
programId:
type: string
example: 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
data:
type: array
items:
type: string
example:
- Kg==
- base64
description: Datos devueltos por la transacción, si los hay.
example: null
unitsConsumed:
type:
- integer
- 'null'
description: >-
Total de unidades de cómputo consumidas durante la
simulación.
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: >-
Solicitud incorrecta: parámetros de solicitud no válidos o solicitud
con formato incorrecto.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: 'No autorizado: la clave de API no es válida o no está presente.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: 'Demasiadas solicitudes: se superó el límite de solicitudes.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: 'Error interno del servidor: ocurrió un error en el servidor.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: >-
Servicio no disponible: el servicio no está disponible
temporalmente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: >-
Tiempo de espera de la puerta de enlace agotado: se agotó el tiempo
de espera de la solicitud.
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: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: El código de error.
example: -32602
message:
type: string
description: El mensaje de error.
data:
type: object
description: Datos adicionales sobre el error.
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Tu clave de API de Helius. Puedes obtener una gratis en el
[panel](https://dashboard.helius.dev/api-keys).
````