Solana Transaction Simulation - HashDit API Documentation

curl --request POST \
  --url https://service.hashdit.io/v2/hashdit/solana-emulate \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "sol_transactions": [
    {
      "transaction": "AfgyfPp6V8GhP...base64...==",
      "encoding": "base64",
      "name": "user-swap"
    }
  ],
  "requested_items": {
    "balance_changes": true,
    "involved_address_risks": true
  }
}
'

{
  "code": "0",
  "status": "ok",
  "data": {
    "exec_summary": {
      "result_code": "000000000",
      "result_description": "Successful simulation.",
      "error_data": null
    },
    "results": [
      {
        "from": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "to": "11111111111111111111111111111111",
        "compute_units_consumed": 12345,
        "called_addresses": [
          "11111111111111111111111111111111"
        ],
        "involved_addresses": [
          "11111111111111111111111111111111",
          "DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy",
          "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
        ],
        "involved_addresses_risks": [
          {
            "address": "DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy",
            "risk_level": 1
          }
        ],
        "balance_changes": [
          {
            "token_address": "native",
            "tokenName": "Solana",
            "symbol": "SOL",
            "divisor": "9",
            "change_list": [
              {
                "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amount_change": "-1.000005",
                "delta_value": "-1000005000"
              },
              {
                "address": "DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy",
                "amount_change": "1.0",
                "delta_value": "1000000000"
              }
            ]
          }
        ],
        "error": null,
        "name": "user-swap",
        "block_height": 355123456,
        "request_id": "a4883040-96fe-4192-ad34-99ff9cdf0e5e"
      }
    ]
  }
}

POST

hashdit

solana-emulate

curl --request POST \
  --url https://service.hashdit.io/v2/hashdit/solana-emulate \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "sol_transactions": [
    {
      "transaction": "AfgyfPp6V8GhP...base64...==",
      "encoding": "base64",
      "name": "user-swap"
    }
  ],
  "requested_items": {
    "balance_changes": true,
    "involved_address_risks": true
  }
}
'

{
  "code": "0",
  "status": "ok",
  "data": {
    "exec_summary": {
      "result_code": "000000000",
      "result_description": "Successful simulation.",
      "error_data": null
    },
    "results": [
      {
        "from": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "to": "11111111111111111111111111111111",
        "compute_units_consumed": 12345,
        "called_addresses": [
          "11111111111111111111111111111111"
        ],
        "involved_addresses": [
          "11111111111111111111111111111111",
          "DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy",
          "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
        ],
        "involved_addresses_risks": [
          {
            "address": "DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy",
            "risk_level": 1
          }
        ],
        "balance_changes": [
          {
            "token_address": "native",
            "tokenName": "Solana",
            "symbol": "SOL",
            "divisor": "9",
            "change_list": [
              {
                "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amount_change": "-1.000005",
                "delta_value": "-1000005000"
              },
              {
                "address": "DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy",
                "amount_change": "1.0",
                "delta_value": "1000000000"
              }
            ]
          }
        ],
        "error": null,
        "name": "user-swap",
        "block_height": 355123456,
        "request_id": "a4883040-96fe-4192-ad34-99ff9cdf0e5e"
      }
    ]
  }
}

Request fields accept both camelCase and snake_case. See Request Field Names.

Simulate one or more Solana transactions before they are broadcast. Same envelope, errors, and headers as Transaction Simulation, with Solana-shaped per-transaction fields. Each item in sol_transactions is one of two shapes: a serialized transaction (transaction + optional encoding), or a structured transaction (feePayer + instructions). Alias transactions is also accepted for the array.

Unlike the EVM endpoint, unrecognized fields on this endpoint are dropped, not forwarded. A typo is silently ignored rather than rejected.

This endpoint has no approve_changes, ownership_changes, call_graph, balance_table, logs, revert, or revert_reason. Solana has no ERC-20 approvals or EVM-style internal calls as primitives. Per-transaction failure is reported in error (null on success).

Native SOL balance changes use token_address: "native".

`risk_level` Scale

Used in involved_addresses_risks. Same scale as Transaction Simulation.

Value	Meaning
`0`	No known risk.
`1`	Low risk.
`2`–`5`	Increasing risk.
`-1`	Not present in HashDit’s database — unknown, not safe.

A failed simulation is still a successful API call. The envelope stays code: "0", status: "ok". Read exec_summary.result_code and results[i].error. Only infrastructure failures produce non-"0" codes. compute_units_consumed is 0 on simulator failure.

Headers

X-API-KEY

string

required

Your HashDit API key

Body

application/json

Solana transactions to simulate

sol_transactions

(Serialized transaction · object | Structured transaction · object)[]

required

Transactions to simulate. Minimum 1. Alias transactions also accepted. Each item is either a serialized transaction or a structured transaction.

Minimum array length: 1

Serialized (transaction) or structured (feePayer + instructions).

Serialized transaction
Structured transaction

Show child attributes

requested_items

object

Show child attributes

Response

Successful API call. A failed simulation still returns code: "0" and status: "ok" — read exec_summary.result_code and results[i].error.

code

string

API status code. "0" indicates the API call succeeded, including when a simulation reports error.

Example:

"0"

status

string

Example:

"ok"

data

object

Show child attributes

​risk_level Scale

Headers

Body

Response

`risk_level` Scale