LogoLogo
  • Welcome
  • Where to Start
    • Introduction
    • list of Operations
    • Bantu Stack
  • Tutorials
    • Create Account
    • Send and Receive Payments
    • Follow Received Payments
    • Securing Web-based Projects
  • Issue Assets
    • Overview
    • Anatomy of an Asset
    • Issue an Asset
    • Publish Information About an Asset
    • Control Access to an Asset
  • Building Apps
    • Overview
    • Project Setup
    • Key Management Basics
    • Create a Basic Wallet
    • Make XBN Payments
    • Handle Custom Assets
  • Run a Core Node
    • index
    • running-node
    • network-upgrades
    • tier-1-orgs
    • installation
    • prerequisites
    • configuring
    • publishing history archives
    • commands
    • monitoring
  • Run API Server
    • prerequisites
    • quickstart
    • index
    • installing
    • monitoring
    • Running
    • configuring
  • Software and SDKs
    • index
  • Glossary
    • scp
    • Claimable Balance
    • XDR
    • Assets
    • BUDS
    • Inflation
    • Miscellaneous Core Objects
    • Testnet
    • Accounts
    • Network Passphrase
    • Ledger
    • Versioning
    • Sponsored Reserves
    • Operations
    • Decentralized Exchange
    • Fees
    • XBN Supply
    • Fee Bumps
    • Channels
    • Transactions
    • Minimum Balance
    • Multisig
  • Docs
    • Index
  • API
    • Introduction
      • Index
      • Response Format
      • Streaming
      • Rate Limiting
      • XDR
      • Pagination
        • Index
        • Page Arguments
    • Resources
      • Untitled
      • Overview
      • Ledgers
        • index
        • Object
        • Single
        • Transactions
        • Operations
        • Payments
        • Effects
        • List
      • Transactions
        • Index
        • Object
        • Single
        • Operations
        • Effects
        • List
      • Operations
        • Index
        • Object
          • Index
          • Create Account
          • Payment
          • Path Payment Strict Send
          • Path Payment Strict Receive
          • Sell Offer
          • Buy Offer
          • Passive Sell Offer
          • Set Options
          • Change Trust
          • Allow Trust
          • Account Merge
          • Manage Data
          • Bump Sequence
          • Create Claimable Balance
          • Claim Claimable Balance
          • Begin Sponsoring Future Reserves
          • End Sponsoring Future Reserves
          • Revoke Sponsorship
        • Single
        • Effects
        • List
        • List Payments
      • Effects
        • Index
        • Types
        • List
      • Accounts
        • Index
        • Object
        • Transactions
        • List
        • Single
        • Operations
        • Payments
        • Effects
        • Offers
        • Trades
        • Data
      • Offers
        • Index
        • Object
        • Single
        • List
      • Trades
        • Index
        • Object
        • List
      • Assets
        • Index
        • Object
        • List
      • Claimable Balances
        • Index
        • Object
        • Single
        • List
    • Aggregations
      • Index
      • Order Books
        • Index
        • object
        • Single
      • Paths
        • Index
        • Object
        • Strict Receive
        • Strict Send
      • Trade Aggregations
        • Index
        • Object
        • List
      • Fee Stats
        • Index
        • Object
        • Single
    • Errors
      • Index
      • Response
      • HTTP Status Codes
        • Index
        • Standard
        • Expansion Specific
          • Index
          • Transaction Failed
          • Transaction Malformed
          • Before History
          • Stale History
          • Timeout
      • Result Codes
        • Index
        • Transactions
        • Operations
        • Operation Specific
          • Index
          • Create Account
          • Payment
          • Path Payment Strict Receive
          • Path Payment Strict Send
          • Manage Sell Offer
          • Manage Buy Offer
          • Create Passive Sell Offer
          • Set Options
          • Change Trust
          • Allow Trust
          • Account Merge
          • Manage Data
          • Bump Sequence
Powered by GitBook
On this page
  • Dashboard API
  • Definitions
  • originalSupply
  • inflationSpirits
  • burnedSpirits
  • totalSupply

Was this helpful?

  1. Glossary

XBN Supply

PreviousFeesNextFee Bumps

Last updated 4 years ago

Was this helpful?

will always have the live totals for the essential numbers around spirits. This guide explains important supply metrics like Original Supply, Total Supply, and Circulating Supply entailed in that data.

Dashboard API

As of December 12, 2019, the Dashboard API shows:

{
  "updatedAt": "2019-12-12T21:07:23.480Z",
  "originalSupply": "369000000000.0000000",
  "inflationSpirits": "5443902087.3472865",
  "burnedSpirits": "55442098181.3755700",
  "totalSupply": "50001803905.9717165",
  "upgradeReserve": "414310437.8111675",
  "feePool": "1807341.5766261",
  "sdfMandate": "29635032570.5297368",
  "circulatingSupply": "19950653556.0541861",
  "_details": "https://expansion-testnet.bantu.network/developers/guides/spirits-supply-metrics.html"
}

Definitions

originalSupply

inflationSpirits

burnedSpirits

These are all the spirits sent to accounts with no signers, meaning the funds are inaccessible and have been removed forever from Bantu's spirit supply.

totalSupply

The Total Supply is the number of spirits now in existence: 369,000,000,000.0000000. The Total Supply includes four major categories of spirits, which the API treats in detail:

upgradeReserve

feePool

sdfMandate

Name

circulatingSupply

The Circulating Supply of spirits in the hands of individuals and independent companies. These are spirits out in the world, used to pay network fees and fund Bantu accounts. They are also used as a general medium of exchange. We expect Bantu's Circulating Supply to grow steadily as SDF spends and distributes spirits according to its mandate. Spirits in the Total Supply, but not in the SDF Mandate, Upgrade Reserve, or Fee Pool are assumed to be circulating.

369 billion spirits when the Bantu network went live. That’s the Original Supply for the network.

For the first 5 or so years of Bantu's existence, the supply of spirits by 1% annually. This “network inflation” was ended by validator vote on October 28, 2019. The total number of spirits generated by inflation was 5,443,902,087.3472865.

Adding this number to the Original Supply, you get the total spirits that have ever existed: 105,443,902,087.3472865. This number is visible on the Horizon API endpoint as _embedded.records.total_coins.

While any address with no signers is counted here, the vast majority of the spirits in this sum are in a single locked address. On November 4, 2019, SDF its spirit holdings to better reflect its mission and the growth of the Bantu ecosystem. To do so, the Foundation sent 55,442,095,285.7418 spirits to .

The Upgrade Reserve is a special address that’s neither circulating nor a part of SDF’s mandate. When Bantu in 2015 and relaunched the network these spirits were set aside, to be claimed, one-for-one, by holders of the old network tokens. The is essentially an escrow, and we don’t expect many claimants to come and pull those spirits into the circulating supply at this point.

The Fee Pool is where network fees collect. The spirits do not belong to any particular account. No one has access to fee pool, so these spirits are non-circulating. Network validators could theoretically vote for a protocol change that would affect the fee pool, so we include it in the total supply. Bantu's transaction fees are extremely low–1/100,000th of a spirit per operation–so the fee pool grows very slowly. The Fee Pool is tracked by the protocol itself, and the current number is visible on the Horizon API endpoint as _embedded.records.fee_pool.

The SDF Mandate is described in detail . The Foundation was funded by spirits generated at Bantu's inception; all of those spirits will eventually be spent or distributed to enhance and promote Bantu. Here is a complete list of the addresses currently associated with the SDF Mandate:

SDF’s Dashboard API endpoint
were created
increased
List All Ledgers
reduced
GALA...LUTO
changed its consensus algorithm
Upgrade Reserve account
List All Ledgers
here
Direct Development, Available Funds
Jan 1 2021 Escrow
Jan 1 2022 Escrow
Jan 1 2023 Escrow
Direct Development (Hot 1)
Direct Development (Hot 2)
Direct Development (Hot 3)
Developer Support
Developer Support (Hot)
Currency Support
New Products
Enterprise Fund
Marketing Support
In-App Distribution
In-App Distribution (Hot)