Skip to main content

TransactionEffects

The results of executing a transaction.

type TransactionEffects {
  balanceChanges(
    first: Int
    after: String
    last: Int
    before: String
  ): BalanceChangeConnection
  balanceChangesJson: JSON
  checkpoint: Checkpoint
  dependencies(
    first: Int
    after: String
    last: Int
    before: String
  ): TransactionConnection
  digest: String!
  effectsBcs: Base64
  effectsDigest: String
  effectsJson: JSON
  epoch: Epoch
  events(
    first: Int
    after: String
    last: Int
    before: String
  ): EventConnection
  executionError: ExecutionError
  gasEffects: GasEffects
  lamportVersion: UInt53
  objectChanges(
    first: Int
    after: String
    last: Int
    before: String
  ): ObjectChangeConnection
  status: ExecutionStatus
  timestamp: DateTime
  transaction: Transaction
  unchangedConsensusObjects(
    first: Int
    after: String
    last: Int
    before: String
  ): UnchangedConsensusObjectConnection
}

Fields​

TransactionEffects.balanceChanges ● BalanceChangeConnection object​

The effect this transaction had on the balances (sum of coin values per coin type) of addresses and objects.

TransactionEffects.balanceChanges.first ● Int scalar​
TransactionEffects.balanceChanges.after ● String scalar​
TransactionEffects.balanceChanges.last ● Int scalar​
TransactionEffects.balanceChanges.before ● String scalar​

TransactionEffects.balanceChangesJson ● JSON scalar​

The balance changes as a JSON array, matching the gRPC proto format.

TransactionEffects.checkpoint ● Checkpoint object​

The checkpoint this transaction was finalized in.

TransactionEffects.dependencies ● TransactionConnection object​

Transactions whose outputs this transaction depends upon.

TransactionEffects.dependencies.first ● Int scalar​
TransactionEffects.dependencies.after ● String scalar​
TransactionEffects.dependencies.last ● Int scalar​
TransactionEffects.dependencies.before ● String scalar​

TransactionEffects.digest ● String! non-null scalar​

A 32-byte hash that uniquely identifies the transaction contents, encoded in Base58.

Note that this is different from the execution digest, which is the unique hash of the transaction effects.

TransactionEffects.effectsBcs ● Base64 scalar​

The Base64-encoded BCS serialization of these effects, as TransactionEffects.

TransactionEffects.effectsDigest ● String scalar​

A 32-byte hash that uniquely identifies the effects contents, encoded in Base58.

TransactionEffects.effectsJson ● JSON scalar​

The effects as a JSON blob, matching the gRPC proto format (excluding BCS).

TransactionEffects.epoch ● Epoch object​

The epoch this transaction was finalized in.

TransactionEffects.events ● EventConnection object​

Events emitted by this transaction.

TransactionEffects.events.first ● Int scalar​
TransactionEffects.events.after ● String scalar​
TransactionEffects.events.last ● Int scalar​
TransactionEffects.events.before ● String scalar​

TransactionEffects.executionError ● ExecutionError object​

Rich execution error information for failed transactions.

TransactionEffects.gasEffects ● GasEffects object​

Effects related to the gas object used for the transaction (costs incurred and the identity of the smashed gas object returned).

TransactionEffects.lamportVersion ● UInt53 scalar​

The latest version of all objects (apart from packages) that have been created or modified by this transaction, immediately following this transaction.

TransactionEffects.objectChanges ● ObjectChangeConnection object​

The before and after state of objects that were modified by this transaction.

TransactionEffects.objectChanges.first ● Int scalar​
TransactionEffects.objectChanges.after ● String scalar​
TransactionEffects.objectChanges.last ● Int scalar​
TransactionEffects.objectChanges.before ● String scalar​

TransactionEffects.status ● ExecutionStatus enum​

Whether the transaction executed successfully or not.

TransactionEffects.timestamp ● DateTime scalar​

Timestamp corresponding to the checkpoint this transaction was finalized in.

null for executed/simulated transactions that have not been included in a checkpoint.

TransactionEffects.transaction ● Transaction object​

The transaction that ran to produce these effects.

TransactionEffects.unchangedConsensusObjects ● UnchangedConsensusObjectConnection object​

The unchanged consensus-managed objects that were referenced by this transaction.

TransactionEffects.unchangedConsensusObjects.first ● Int scalar​
TransactionEffects.unchangedConsensusObjects.after ● String scalar​
TransactionEffects.unchangedConsensusObjects.last ● Int scalar​
TransactionEffects.unchangedConsensusObjects.before ● String scalar​

Returned By​

multiGetTransactionEffects query ● transactionEffects query

Member Of​

ExecutionResult object ● SimulationResult object ● Transaction object