Skip to main content

Account Balances

An AccountBalance is a record storing the Account's balance at a given point in time.

Only Accounts with the flag history set retain historical balances.

Fields

timestamp

This is the time the account balance was updated, as nanoseconds since UNIX epoch.

The timestamp refers to the same Transfer.timestamp which changed the Account.

The amounts refer to the account balance recorded after the transfer execution.

Constraints:

  • Type is 64-bit unsigned integer (8 bytes)

debits_pending

Amount of pending debits.

Constraints:

  • Type is 128-bit unsigned integer (16 bytes)

debits_posted

Amount of posted debits.

Constraints:

  • Type is 128-bit unsigned integer (16 bytes)

credits_pending

Amount of pending credits.

Constraints:

  • Type is 128-bit unsigned integer (16 bytes)

credits_posted

Amount of posted credits.

Constraints:

  • Type is 128-bit unsigned integer (16 bytes)

reserved

This space may be used for additional data in the future.

Constraints:

  • Type is 56 bytes
  • Must be zero