Accounts are the central data structure in DigitalBits. Accounts are identified by a public key and saved in the ledger. Everything else in the ledger, such as offers or trustlines, are owned by a particular account.

Accounts are created with the Create Account operation.

Account access is controlled by public/private key cryptography. For an account to perform a transaction–e.g., make a payment–the transaction must be signed by the private key that corresponds to that account’s public key. You can also set up more complicated multi-signature schemes for authorizing transactions on an account.

Account fields

Accounts have the following fields:

Account ID

The public key that was first used to create the account. You can replace the key used for signing the account’s transactions with a different public key, but the original account ID will always be used to identify the account.


The number of digitalbits held by the account. The balance is denominated in 1/10,000,000th of a digitalbit, the smallest divisible unit of a digitalbit.

Sequence number

The current transaction sequence number of the account. This number starts equal to the ledger number at which the account was created.

Number of subentries

Number of other entries the account owns. This number is used to calculate the account’s minimum balance.


Currently there are three flags, used by issuers of assets.

  • Authorization required (0x1): Requires the issuing account to give other accounts permission before they can hold the issuing account’s credit.
  • Authorization revocable (0x2): Allows the issuing account to revoke its credit held by other accounts.
  • Authorization immutable (0x4): If this is set then none of the authorization flags can be set and the account can never be deleted.

Home domain

A domain name that can optionally be added to the account. Clients can look up a digitalbits.toml from this domain. This should be in the format of a fully qualified domain name such as

The federation protocol can use the home domain to look up more details about a transaction’s memo or address details about an account. For more on federation, see the federation guide.


Operations have varying levels of access. This field specifies thresholds for low-, medium-, and high-access levels, as well as the weight of the master key. For more info, see multi-sig.


Used for multi-sig. This field lists other public keys and their weights, which can be used to authorize transactions for this account.

Edit this doc in GitHub


Stay up to date on the latest happenings at DigitalBits. Get the latest news.