AtomOne Docs

x/photon ​

Abstract ​

This module manages the PHOTON token (base denom uphoton), introduced by ADR 002 as the only fee token in AtomOne. PHOTONs are minted by burning ATONEs at a rate capped by a maximum PHOTON supply of 1 B. Minting is achieved via a single message (MsgMintPhoton), and the module enforces PHOTON fees with an AnteDecorator.

Contents ​

Concepts ​

ATONE to PHOTON conversion ​

PHOTON is minted by burning ATONE at a conversion rate:

photon_minted = atone_burned * (photon_max_supply - photon_supply) / atone_supply

This ensures PHOTON’s supply never exceeds 1 B tokens. The module checks for non-zero PHOTON to mint before completing the transaction. This is because rounding errors can cause the calculated amount to be zero when burning small fractions of ATONE’s supply.

Fee enforcement ​

An AnteDecorator ensures PHOTON (uphoton) is the only fee token for most transactions. A small set of messages (initially just MsgMintPhoton) can be set as exceptions and accept other fees such ATONE, as defined by the txfee_exceptions parameter.

State ​

x/photon stores no extra balance data, and relies on x/bank. The only tracked module data are parameters, such as whether minting is enabled.

Messages ​

MsgMintPhoton ​

Burns a specified ATONE amount in exchange for newly minted PHOTON. The minted tokens go to the caller’s account. If mint_disabled is true, this message fails.

Parameters ​

KeyTypeDefault
mint_disabledboolfalse
txfee_exceptions[]string["MsgMintPhoton"]

Client ​

gRPC ​

  • Query/ConversionRate: Returns the current conversion rate.
  • Query/Params: Returns mint_disabled and txfee_exceptions.

REST ​

Endpoints mirror the gRPC queries, allowing retrieval of conversion rate and parameters.

  • /atomone/photon/v1/conversion_rate: Returns the current conversion rate.
  • /atomone/photon/v1/params: Returns mint_disabled and txfee_exceptions.

References ​

See ADR 002 and AtomOne Constitution Article 3 Section 5 for more details.

IMPORTANT: Participating in AtomOne requires sharing only your public keys, NOT your private keys. In connection with AtomOne, you should never be asked to share your private key or any seed or recovery phrase. This means that you should never be contacted by email, phone call, or other form of messaging, nor receive instructions or a request to share your private key or seed or recovery phrase. Any request for your private key or seed or recovery phrase should alert you immediately to potential fraud. Beware of bad actors who seek to obtain access to your wallet or digital identity. Keeping your private key and seed or recovery phrases secure is critically important, and failure to do so could result in theft of your digital identity and loss of whatever you may own, including digital assets, that are associated with your digital identity. Certain statements included on this website (or in any linked materials) are forward-looking statements. Please visit the Terms of Service page for further details about eligibility and your usage of the AtomOne website.


DISCLAIMER: Nothing on this website is, and nothing on this website is intended to be, an offer of tokens or securities.


This website is a community-owned and operated resource, created and maintained by All in Bits (AiB), a contributing member of the AtomOne ecosystem. It is not an official website of AtomOne, and the information contained within does not represent the official views, decisions, or governance of the AtomOne community or its DAOs. The content and opinions expressed herein are those of the AiB. Use of this website is at your own discretion, and no guarantees are made regarding the accuracy, completeness, or reliability of the information provided.