sui_dryRunTransactionBlock

POST

/{apiKey}

Deprecation notice

Action required: Support for Sui JSON-RPC will end on September 25, 2026. Please migrate to Sui gRPC before then to avoid disruption. You can find our migration guide here.

Executes a transaction in dry-run mode, which simulates transaction execution and returns expected effects, gas cost summary, object changes, and events — without actually committing to chain.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

stringrequired

Base64-encoded BCS TransactionKind.

Responses

200

Simulated result of executing the transaction.

POST/v2/{apiKey}

curl --request POST \  --url https://sui-mainnet.g.alchemy.com/v2/docs-demo \  --header 'Content-Type: application/json' \  --data '{  "jsonrpc": "2.0",  "id": 1,  "method": "sui_dryRunTransactionBlock",  "params": [    "AAPDdSGd1K6HApnQ1UMmEIOXvtBFDAEFAAAAAAAAADDat41YRxp4SW63HCxud7omjwOQOg6huYDqcvdFeE95OGaVEnTPlWWtjAYAAAAAACBCRYDRhl1WPPDl5P0n7fK6uWgf/Leb4oRS1KAESZ/KmwEAAAAAAAAAAQAAAAAAAAA="  ]}'

200Success

{  "jsonrpc": "2.0",  "id": 1,  "result": {    "digest": "DNtx7EmGqSywGbnSC1CKoqmBFEXGvApXpRVt6bU855xP",    "effects": {      "messageVersion": "v1",      "status": {        "status": "success"      },      "executedEpoch": "0",      "gasUsed": {        "computationCost": "100",        "storageCost": "100",        "storageRebate": "10",        "nonRefundableStorageFee": "0"      },      "transactionDigest": "8UExPV121BEfWkbymSPDYhh23rVNh3MSWtC5juJ9JGMJ",      "mutated": [        {          "owner": {            "AddressOwner": "0x61fbb5b4f342a40bdbf87fe4a946b9e38d18cf8ffc7b0000b975175c7b6a9576"          },          "reference": {            "objectId": "0xe8d8c7ce863f313da3dbd92a83ef26d128b88fe66bf26e0e0d09cdaf727d1d84",            "version": 2,            "digest": "EnRQXe1hDGAJCFyF2ds2GmPHdvf9V6yxf24LisEsDkYt"          }        },        {          "owner": {            "AddressOwner": "0x7ba91ddc7e717cf708c937060f04048736ec33fb1746d999a5e58cd5c677ed80"          },          "reference": {            "objectId": "0x4f82f1c8587b98d64c00bfb46c3843bd8bf6ccfa7c65a86138698cd1fdcac3dc",            "version": 2,            "digest": "Cv7n2YaM7Am1ssZGu4khsFkcKHnpgVhwFCSs4kLjrtLW"          }        }      ],      "gasObject": {        "owner": {          "ObjectOwner": "0x61fbb5b4f342a40bdbf87fe4a946b9e38d18cf8ffc7b0000b975175c7b6a9576"        },        "reference": {          "objectId": "0xe8d8c7ce863f313da3dbd92a83ef26d128b88fe66bf26e0e0d09cdaf727d1d84",          "version": 2,          "digest": "EnRQXe1hDGAJCFyF2ds2GmPHdvf9V6yxf24LisEsDkYt"        }      },      "eventsDigest": "55TNn3v5vpuXjQfjqamw76P9GZD522pumo4NuT7RYeFB"    },    "objectChanges": [      {        "type": "transferred",        "sender": "0x61fbb5b4f342a40bdbf87fe4a946b9e38d18cf8ffc7b0000b975175c7b6a9576",        "recipient": {          "AddressOwner": "0x7ba91ddc7e717cf708c937060f04048736ec33fb1746d999a5e58cd5c677ed80"        },        "objectType": "0x2::example::Object",        "objectId": "0x4f82f1c8587b98d64c00bfb46c3843bd8bf6ccfa7c65a86138698cd1fdcac3dc",        "version": "2",        "digest": "B3xLC8EbyvTxy5pgiwTNUzHLa6kS7uwD6sZdErKB8F8f"      }    ],    "events": []  }}

Was this page helpful?

sui_dryRunTransactionBlock

Path Parameters

apiKey

Request

tx_bytes

Responses

200