transaction

Module defining transaction types.

This module provides a complete representation of TON transactions as they appear in the blockchain. It includes structures for all phases of transaction execution: storage, credit, compute, action, and bounce.

Examples:

val tx = results.at(0).tx.load();

// Check gas usage
val gas = tx.getUsedGas();
println("Gas used: {}", gas);

// Inspect account status change
val description = tx.description.load();
if (description is TlbTransOrd) {
    val compute = description.computePh;
    if (compute is TlbTrComputeVm) {
        println("VM exit code: {}", compute.exitCode);
    }
}

Definitions

`TlbAccountStatus`

enum TlbAccountStatus: uint2 {
    Uninitialized
    Frozen
    Active
    NonExisting
}

Type alias for transaction account status values used by TlbTransaction.origStatus and TlbTransaction.endStatus.

Source code

`TlbDepthBalanceInfo`

struct TlbDepthBalanceInfo {
    splitDepth: uint8 // #<= 30
    balance: TlbCurrencyCollection
}

Represents depth and balance information for split accounts.

Source code

`TlbTransaction`

struct (0b0111) TlbTransaction {
    /// Account address as 256-bit hash.
    accountAddr: bits256
    /// Logical time of the transaction.
    lt: uint64
    /// Hash of the previous transaction.
    prevTransHash: bits256
    /// Logical time of the previous transaction.
    prevTransLt: uint64
    /// Current time (Unix timestamp).
    now: uint32
    /// Number of outgoing messages.
    outmsgCnt: uint15
    /// Account status before transaction.
    origStatus: TlbAccountStatus
    /// Account status after transaction.
    endStatus: TlbAccountStatus
    /// In and out messages.
    messages: Cell<TlbTransactionMessages>
    /// Total fees collected.
    totalFees: TlbCurrencyCollection
    /// State update information.
    stateUpdate: Cell<TlbHashUpdate<TlbAccount>>
    /// Transaction description.
    description: Cell<TlbTransactionDescr>
}

Represents a transaction in the TON blockchain.

Source code

`TlbTransaction.loadBody`

fun TlbTransaction.loadBody<Msg>(self): Msg

Loads the in message body of the transaction with given type.

Fails if transaction has no inbound message (messages.inMsg is TlbNone), because this method unwraps it before typed decoding.

After an inbound message exists, if message type does not match Msg, loading fails with exit code 63. Internal and external-in transaction bodies are both supported.

Example:

val txs = net.send(address, msg);
val tx = txs.findTransaction<IncreaseCounter>({ to: address })!;
val body = tx.loadBody<IncreaseCounter>();
println(body.increaseBy);

Source code

`TlbTransaction.loadInMsg`

fun TlbTransaction.loadInMsg<Msg>(self): TlbMessage<Msg>

Loads the in message of the transaction with given type.

Fails if transaction has no inbound message (messages.inMsg is TlbNone), because this method unwraps it before typed decoding.

After an inbound message exists, if message type does not match Msg, loading fails with exit code 63. Internal and external-in transaction messages are both supported.

transaction

On this page