gRPCExecuteTransaction

sui-mainnet.nodit.io:443 sui.rpc.v2.TransactionExecutionService/ExecuteTransactionunary

Submits and executes a signed transaction on the network.

TransportgRPC

Request and response messages are identical for both transports. Only the wire protocol, headers, and client library differ.

Protocol
Native gRPC over HTTP/2 with TLS. Suited to server-side clients and grpcurl.
Content-Type
application/grpc
Headers
x-api-key
Streaming
Server, client, and bidirectional streaming are all supported.
Errors
grpc-status and grpc-message are delivered as HTTP/2 trailers.
Request Body
transactionobject

Transaction to execute.

signaturesobject[]

Set of UserSignatures authorizing the execution of the provided transaction.

pathsstring[]

The set of field mask paths (e.g. "object_id", "version", "digest").

Responses
digeststring

Transaction digest.

transactionobject

The transaction itself.

bcsobject

Transaction serialized as BCS.

namestring

Name that identifies the type of the serialized value.

valuestring

Bytes of a BCS serialized value.

digeststring

Transaction digest.

versioninteger

Version of the transaction structure.

kindobject

Kind of the transaction.

kindstring

Kind discriminator.

programmable_transactionobject

A programmable (user) transaction.

inputsobject[]

Inputs to the transaction.

commandsobject[]

Commands to execute.

change_epochobject

A change-epoch system transaction.

epochinteger

The next epoch ID.

protocol_versioninteger

Protocol version for the next epoch.

storage_chargeinteger

Total storage charge for the epoch.

computation_chargeinteger

Total computation charge for the epoch.

storage_rebateinteger

Total storage rebate for the epoch.

non_refundable_storage_feeinteger

Non-refundable storage fee.

epoch_start_timestampstring

Timestamp of the epoch start.

system_packagesobject[]

System packages to install.

genesisobject

The genesis transaction.

objectsobject[]

Genesis objects.

consensus_commit_prologueobject

A consensus commit prologue transaction.

epochinteger

Epoch of the commit.

roundinteger

Consensus round.

commit_timestampstring

Timestamp of the commit.

consensus_commit_digeststring

Digest of the consensus commit.

sub_dag_indexinteger

Sub-DAG index.

consensus_determined_version_assignmentsobject

Version assignments determined by consensus.

additional_state_digeststring

Digest of additional state.

authenticator_state_updateobject

An authenticator state update transaction.

epochinteger

Epoch of the update.

roundinteger

Consensus round.

new_active_jwksobject[]

Newly active JWKs.

authenticator_object_initial_shared_versioninteger

Initial shared version of the authenticator object.

end_of_epochobject

An end-of-epoch transaction.

transactionsobject[]

End-of-epoch operations to run.

randomness_state_updateobject

A randomness state update transaction.

epochinteger

Epoch of the update.

randomness_roundinteger

Randomness round.

random_bytesstring

Random bytes.

randomness_object_initial_shared_versioninteger

Initial shared version of the randomness object.

senderstring

Address of the sender.

gas_paymentobject

Gas payment information.

objectsobject[]

Set of gas objects to use for payment.

object_idstring

The object id of this object.

versioninteger

The version of this object.

digeststring

The digest of this object.

ownerstring

Owner of the gas objects, either the transaction sender or a sponsor.

priceinteger

Gas unit price to use when charging for computation. Must be greater than or equal to the network's current RGP (reference gas price).

budgetinteger

Total budget willing to spend for the execution of a transaction.

expirationobject

Transaction expiration (TTL).

kindstring

Kind of the expiration.

epochinteger

Maximum epoch after which the transaction expires.

min_epochinteger

Minimum epoch before which the transaction is invalid.

min_timestampstring

Minimum valid timestamp.

max_timestampstring

Maximum valid timestamp.

chainstring

ChainId used for replay protection.

nonceinteger

Uniqueness identifier.

signaturesobject[]

Signatures on the transaction.

bcsobject

This signature serialized as BCS. When provided as input this will support both the form that is length prefixed as well as not length prefixed.

namestring

Name that identifies the type of the serialized value.

valuestring

Bytes of a BCS serialized value.

schemestring

The signature scheme of this signature.

simpleobject

Simple signature if scheme is ed25519 | secp256k1 | secp256r1.

schemestring

The signature scheme of this signature.

signaturestring

Signature bytes.

public_keystring

Public key bytes.

multisigobject

The multisig aggregated signature if scheme is MULTISIG.

signaturesobject[]

The plain signatures encoded with signature scheme. The signatures must be in the same order as they are listed in the committee.

schemestring

The signature scheme of this signature.

signaturestring

Signature bytes if scheme is ed25519 | secp256k1 | secp256r1.

zkloginobject

The zklogin authenticator if scheme is ZKLOGIN.

passkeyobject

The passkey authenticator if scheme is PASSKEY.

bitmapinteger

Bitmap indicating which committee members contributed to the signature.

legacy_bitmapstring

If present, means this signature's on-chain format uses the old legacy multisig format.

committeeobject

The multisig committee used to validate this signature.

membersobject[]

A list of committee members and their corresponding weight.

thresholdinteger

The threshold of signatures needed to validate a signature from this committee.

zkloginobject

The zklogin authenticator if scheme is ZKLOGIN.

inputsobject

Zklogin proof and inputs required to perform proof verification.

proof_pointsobject

The groth16 proof points.

iss_base64_detailsobject

Base64 details of the iss claim.

header_base64string

Base64-encoded JWT header.

address_seedstring

Base10-encoded field element address seed.

max_epochinteger

Maximum epoch for which the proof is valid.

signatureobject

The ephemeral signature.

schemestring

The signature scheme of this signature.

signaturestring

Signature bytes.

public_keystring

Public key bytes.

public_identifierobject

The public identifier (similar to a public key) for this zklogin authenticator.

issstring

OIDC provider issuer.

address_seedstring

Base10-encoded field element address seed.

jwk_idobject

The id of the JWK used to authorize this zklogin authenticator.

issstring

OIDC provider issuer.

kidstring

Key ID from the OIDC provider.

passkeyobject

The passkey authenticator if scheme is PASSKEY.

authenticator_datastring

Opaque authenticator data for this passkey signature.

client_data_jsonstring

Structured, unparsed JSON for this passkey signature.

signatureobject

A secp256r1 signature.

schemestring

The signature scheme of this signature.

signaturestring

Signature bytes.

public_keystring

Public key bytes.

effectsobject

Effects of the transaction.

bcsobject

Effects serialized as BCS.

namestring

Name that identifies the type of the serialized value.

valuestring

Bytes of a BCS serialized value.

digeststring

Digest of the effects.

versioninteger

Version of the effects structure.

statusobject

Execution status.

successboolean

Whether execution succeeded.

errorobject

Error information if execution failed.

descriptionstring

Human-readable description.

commandinteger

Index of the command that errored.

kindstring

Kind of the execution error.

abortobject

Move abort details.

size_errorobject

Size error details.

command_argument_errorobject

Command argument error details.

type_argument_errorobject

Type argument error details.

package_upgrade_errorobject

Package upgrade error details.

index_errorobject

Index error details.

object_idstring

ObjectId related to the error.

coin_deny_list_errorobject

Coin deny list error details.

congested_objectsobject

Objects that were congested.

epochinteger

Epoch of execution.

gas_usedobject

Summary of gas used.

computation_costinteger

Computation cost.

storage_costinteger

Storage cost.

storage_rebateinteger

Storage rebate.

non_refundable_storage_feeinteger

Non-refundable storage fee.

transaction_digeststring

Digest of the executed transaction.

gas_objectobject

The gas object after execution.

object_idstring

ObjectId of the changed object.

input_statestring

Input state of the object.

input_versioninteger

Input version.

input_digeststring

Input digest.

input_ownerobject

Owner before the change.

kindstring

Kind of ownership.

addressstring

Address or ObjectId of the owner.

versioninteger

The initial_shared_version if kind is SHARED or start_version if kind is CONSENSUS_ADDRESS.

output_statestring

Output state of the object.

output_versioninteger

Output version.

output_digeststring

Output digest.

output_ownerobject

Owner after the change.

kindstring

Kind of ownership.

addressstring

Address or ObjectId of the owner.

versioninteger

The initial_shared_version if kind is SHARED or start_version if kind is CONSENSUS_ADDRESS.

accumulator_writeobject

Accumulator write operation, if any.

addressstring

Address of the accumulator.

accumulator_typestring

Type of the accumulator.

operationstring

The accumulator operation.

value_kindobject

Kind of the accumulator value.

integer_valueinteger

Integer value.

integer_tupleinteger[]

Integer tuple of length 2.

event_digest_valueobject[]

Event digest accumulator entries.

id_operationstring

ID operation (created/deleted/etc.).

object_typestring

Type of the object.

events_digeststring

Digest of the emitted events.

dependenciesstring[]

Transactions this transaction depends on.

lamport_versioninteger

Lamport version of written objects.

changed_objectsobject[]

Objects changed during execution.

object_idstring

ObjectId of the changed object.

input_statestring

Input state of the object.

input_versioninteger

Input version.

input_digeststring

Input digest.

input_ownerobject

Owner before the change.

kindstring

Kind of ownership.

addressstring

Address or ObjectId of the owner.

versioninteger

The initial_shared_version if kind is SHARED or start_version if kind is CONSENSUS_ADDRESS.

output_statestring

Output state of the object.

output_versioninteger

Output version.

output_digeststring

Output digest.

output_ownerobject

Owner after the change.

kindstring

Kind of ownership.

addressstring

Address or ObjectId of the owner.

versioninteger

The initial_shared_version if kind is SHARED or start_version if kind is CONSENSUS_ADDRESS.

accumulator_writeobject

Accumulator write operation, if any.

addressstring

Address of the accumulator.

accumulator_typestring

Type of the accumulator.

operationstring

The accumulator operation.

value_kindobject

Kind of the accumulator value.

integer_valueinteger

Integer value.

integer_tupleinteger[]

Integer tuple of length 2.

event_digest_valueobject[]

Event digest accumulator entries.

id_operationstring

ID operation (created/deleted/etc.).

object_typestring

Type of the object.

unchanged_consensus_objectsobject[]

Consensus objects not changed during execution.

kindstring

Kind of the unchanged consensus object.

object_idstring

ObjectId of the object.

versioninteger

Version of the object.

digeststring

Digest of the object.

object_typestring

Type of the object.

auxiliary_data_digeststring

Digest of auxiliary data.

unchanged_loaded_runtime_objectsobject[]

Loaded runtime objects that were not changed.

object_idstring

The object id of this object.

versioninteger

The version of this object.

digeststring

The digest of this object.

eventsobject

Events emitted by the transaction.

bcsobject

TransactionEvents serialized as BCS.

namestring

Name that identifies the type of the serialized value.

valuestring

Bytes of a BCS serialized value.

digeststring

Digest of the TransactionEvents.

eventsobject[]

Set of events emitted by a transaction.

package_idstring

Package ID of the invoked function.

modulestring

Module name of the top-level function of a MoveCall command that triggered this event to be emitted.

senderstring

Address of the transaction sender.

event_typestring

Type of the emitted event.

contentsobject

BCS serialized bytes of the event.

namestring

Name that identifies the type of the serialized value.

valuestring

Bytes of a BCS serialized value.

jsonobject

JSON rendering of the event.

checkpointinteger

Checkpoint including this transaction.

timestampstring

Timestamp of execution.

balance_changesobject[]

Balance changes caused by the transaction.

addressstring

The affected account address.

coin_typestring

Coin type.

amountstring

Balance change amount.

objectsobject

Objects related to the transaction.

objectsobject[]

Objects, sorted by object_id and version.

bcsobject

This Object serialized as BCS.

namestring

Name that identifies the type of the serialized value.

valuestring

Bytes of a BCS serialized value.

object_idstring

ObjectId of the object.

versioninteger

Version of the object.

digeststring

The digest of this Object.

ownerobject

Owner of the object.

kindstring

Kind of ownership.

addressstring

Address or ObjectId of the owner.

versioninteger

The initial_shared_version if kind is SHARED or start_version if kind is CONSENSUS_ADDRESS.

object_typestring

Type of the object.

has_public_transferboolean

DEPRECATED. Whether the object has public transfer.

contentsobject

BCS bytes of a Move struct value. Only set for Move structs.

namestring

Name that identifies the type of the serialized value.

valuestring

Bytes of a BCS serialized value.

packageobject

Package data if the object is a package.

storage_idstring

Package ObjectId (storage ID).

original_idstring

ID of the first published version.

versioninteger

Version of the package.

modulesobject[]

Modules in the package.

type_originsobject[]

Type origins for the package's types.

linkageobject[]

Transitive dependencies (linkage table).

previous_transactionstring

Digest of the transaction that created or last mutated this object.

storage_rebateinteger

Storage rebate for the object.

jsonobject

JSON rendering of the object.

balanceinteger

Current balance if this object is a 0x2::coin::Coin<T>.

displayobject

Template-based display rendering.

outputobject

Substituted display fields.

errorsobject

Fields that failed to render.

X-API-KEY
RequestCU229
grpcurl
grpcurl \
  -import-path . -proto sui/rpc/v2/transaction_execution_service.proto \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -d '{
  "transaction": {
    "bcs": {
      "value": "<base64-encoded BCS-serialized TransactionData>"
    }
  },
  "signatures": [
    {
      "bcs": {
        "value": "<base64-encoded user signature>"
      }
    }
  ],
  "read_mask": {
    "paths": []
  }
}' \
  sui-mainnet.nodit.io:443 sui.rpc.v2.TransactionExecutionService/ExecuteTransaction
Response
Example · 200
{
  "transaction": {}
}