Skip to main content
Version: 1.1.0

Glossary

TermMeaning
CenterChainThe Cosmos SDK application chain documented here. Roughly one second block time.
CENThe native protocol coin, used for fees, staking, and governance. Its base denom on chain is ucen, its display denom is cen.
Token factory denomA denom created by an account, of the form factory/{creator}/{subdenom}. It behaves as an ordinary bank denom everywhere except in the modules below.
Denom adminThe account that may mint, burn, and change the policy of a token factory denom. The creator is the first admin.
AuthorityThe gov module address. Every module's privileged operations are gated on it.
CapabilityA module-wide switch that enables a message. A capability that is not configured makes the message fail with ErrCapabilityNotEnabled.
Technical issuerThe issuer of an NFT class. Its account address is the first segment of the class id, so a class is namespaced by its issuer.
Class id{issuer}/{product_ref}, at most 256 bytes, printable ASCII, exactly one separator.
Token id{class_id}/{sequence}. Assigned by the module, never by the sender.
Token metadata immutabilityA class-level flag, fixed at creation, that makes MsgSetNFTMetadata fail. No message changes it.
LockAn escrow over an NFT. The holder keeps ownership, but nobody else can move or burn the token until the lock is released.
BlacklistA per-denom list of addresses that may not send or receive that denom. The check is absolute: it applies under an open policy too.
Restricted denomA denom whose transfers to addresses that do not already hold it are rejected, unless the sender is its admin or a delegate.
DelegateAn address that bypasses the restricted-denom rule for one denom. It does not grant minting or burning.
PoolableA flag saying a denom may enter a liquidity pool. Token factory denoms must set it; LP denoms have it set automatically.
PoolA two-denom constant-product market with reserves, an LP share supply, and a fee.
LP shareThe token representing a position in a pool. Its denom is always factory/liquidity/pool/{pool_id}.
Parts per million (ppm)The fee unit. The fee scale is 1,000,000, and every fee division floors.
Swap fee shareThe fraction of the LP fee that goes to stakers rather than staying in the pool's cumulative LP fee counter.
Farm positionAn owner's staked LP shares in one pool, held as a total plus a list of deposit lots.
LotOne farm deposit, recording the height it was made and the height it unlocks at. Withdrawals are strictly FIFO across lots.
Emission scheduleA block-height-bounded stream of ucen from a pool owner to that pool's stakers.
ListingA fixed-price offer to sell one NFT, escrowed with a lock and a refundable deposit.
Class market configThe per-class secondary-trading policy: enabled or not, royalty, and the denoms a listing may be priced in.
Yield addressThe account that holds distributed income before it is claimed. Defaults to the income module account.
Income configurationThe registration of a denom or NFT class as income-bearing, with its yield address.
StreamOne (eligibility denom, reward denom) pair, holding the global reward-per-share index.
Account streamA holder's checkpoint in a stream: the index they last settled at, and the amount waiting for them.
ClaimableAn amount earmarked for one specific NFT token, pushed by an administrator and paid on claim.
AuthorizationA limited, single-use, time-boxed permission, bound by kind to the settlement it may be spent on. See Two-phase execution.
Authorization kindSWAP, PULL, or BURN. Fixes which settlement message may consume an authorization. UNSPECIFIED is rejected for a new authorization.
PullSettling a kind=PULL authorization: the authorized input is transferred to the executor, and nothing is minted or burned.
Burn authorizationSettling a kind=BURN authorization: the authorized input is burned by the executor, who must be the denom admin or, for an NFT, the class issuer.
Holder asset protectionThe rule that no role can burn or move a holder's token or NFT without the holder's own signature. See Holder asset protection.
Order idholder plus the per-holder monotonic sequence. It is the key marking a single use, and the order id written into an NFT lock.
ReservationThe max_from amount an open authorization holds against a holder's balance. A spend that would break it is rejected at the store layer.
Keeper injectionWiring one module's keeper into another at startup, so it can call it directly. This is how modules that are not hooks find each other.
Send restrictionA function appended to the bank's restriction list and consulted on every transfer. income prepends one, tokenfactory appends one.
Burn hookA named callback run on every NFT burn, in sorted order. The first error aborts the burn.
Invariant alarmAn event emitted in EndBlock when a solvency or conservation check fails. It never returns an error, so finalization continues.

Authority by module​

ModuleAuthority isWho can act instead
Token factorygov for params and the pool denylistThe denom admin for everything denom-scoped, except burning another holder's balance
Liquiditygov for params, emergency pause, closure, IBC denomsThe pool owner for pool-scoped changes
NFTgov for a class issuer changeThe class issuer for everything but burning another holder's token, which no role can do
NFT marketgov for paramsThe class issuer for the class market config
Incomegov for paramsConfigured income admins, plus the relevant denom admin or class issuer