Glossary
The glossary assumes familiarity with basic concepts of Chia blockchain and Chialisp.
Approval mod. One of five (?) coin types that have permission to issue and/or melt BYC or CRT. See the corresponding section on the Statutes page for details.
Arg. Short for argument. A value that is passed into a mod or function. A value passed into a mod that is considered part of the mod itself, is referred to as a curried arg.
Argument. See arg.
Asset ID. The treehash of a CAT's tail.
Bill. The program version of a governance proposal. More specifically, the program curried into the BILL curried arg of a CRT coin in governance mode.
Burn. Remove a CAT from existence by running the CAT's tail program. Another term for melting.
CAT. A Chia Asset Token.
CAT singleton. A CAT whose inner puzzle ensures that the coin is also a singleton. CAT singletons are custom singletons.
Coin. A coin on Chia blockchain.
Condition. One of the outputs of a coin spent on the Chia blockchain. For additional info see here.
Currying. Setting an arg of a mod to a fixed value so that it is considered part of the mod itself. For additional info see here.
Curried arg. A value curried into a mod.
Custom condition. A condition that is output by Statutes specifically because governance voted for it. Custom conditions are used for one-off operations where there is no benefit in storing any of the pertaining information in Statutes. See the corresponding section on the Statutes page for details.
Custom singleton. A singleton that is not a standard singleton.
Data provider. An individual or entity that publishes XCH/USD prices in an Announcer.
Deployment. The act of creating eve protocol coins on-chain. This can either refer to protocol deployment, the deployment of Announcers by data providers, or the deployment of collateral or savings vaults by users.
Enactment. The act of executing a governance proposal on-chain. Requires a final spend of the governance coin that contains the proposed bill. The proposed bill becomes effective immediately upon enactment.
Enforced state. A coin state that is fully or partially enforced by the coin's puzzle mod. Typically used in the context of eve coins.
Eve coin. The very first coin in the lineage of a singleton.
Eve spend. Spend of an eve coin.
Eve state. The state of an eve coin.
Fixed arg. An curried arg that cannot be changed by protocol operations and whose value is known prior to protocol deployment. These are typically mods or mod hashes.
Fixed state. The fixed args of a coin's state. In case of the protocol, the fixed state always includes the treehash of the coin's mod after the other fixed args are curried, but before any immutable or mutable args are curried. In the protocol's source code, this arg is always named MOD_HASH.
Governance. TODO
Governance mode. A CRT coin is in governance mode when its inner puzzle is the governance.clsp mod.
Governance proposal. See proposal.
Hogging. The practice of (repeatedly) spending a coin in order to deny other users the ability to perform a spend. Amounts to a denial-of-service attack.
Immutable arg. A curried arg that cannot be changed by protocol operations and whose exact value is not known prior to deployment. Immutable args never change once the protocol is deployed. An example is the Statutes struct, which depends on the Statute's launcher ID.
Immutable state. The immutable args of a coin's state.
Issue. Bring a CAT into existence by running the CAT's tail program.
Keeper. An individual or entity that performs operations on the protocol without being a user or data provider. For more details see here.
Launcher. A coin from which another coin, typically a singleton, is created.
Lineage. The succession of coins and coin spends that lead from a launcher or eve coin to the current singleton coin.
Mod. Short for module. A Chialisp module. Essentially another word for program.
Module. See mod.
MOD_HASH. A fixed arg that can be found in all protocol coin mods. The treehash of the coin's mod after all other fixed args have been curried in.
Mojo. The smallest unit of the XCH cryptocurrency. 1 trillion mojos = 1 XCH.
Mutable arg. A curried arg that can be changed by one or more protocol operations.
Mutable state. The mutable args of a coin's state. This includes state variables with limited mutability, e.g. a launcher ID which is set once in the eve spend and immutable from then on.
Operation. An action that a user or keeper can perform on the protocol. Examples include depositing collateral into a collateral vault, withdrawing from a savings vault, triggering a liquidation auction, or recovering bad debt. Operations require one or more protocol coins to be spent simultaneously. For example, announcing an Announcer price only requires one coin to be spent, the Announcer itself. Performing the win operation at the end of a Recharge Auction requires the Recharge Auction coin, Statutes, a CRT coin, and all Treasury coins to be spent. Operations are not to be confused with Chialisp operators.
OPERATIONS. A fixed arg that is present in most protocol coin mods. A list of program hashes, each of which corresponds to an operation.
Owner. TODO
Program. Another word for mod. Preferred over mod in the most general contexts.
Proposal. Short for governance proposal. A proposal by CRT token holders to update a Statute or pass custom conditions. A proposal is considered effective if it has been committed on-chain in form of a bill.
Protocol. Unless specified otherwise, refers to Circuit protocol.
Protocol coin. A coin that is part of the protocol. A complete list of protocol coin types can be found here.
Protocol condition. The following conditions when prefixed by the protocol prefix:
SEND_MESSAGERECEIVE_MESSAGECREATE_COIN_ANNOUNCEMENTCREATE_PUZZLE_ANNOUNCEMENTREMARK
See here for details.
Protocol deployment. Refers the creation of the eve coins of Statutes, Announcer Registry and Oracle.
Protocol prefix. The 3-byte string CRT used to identify protocol conditions.
Puzzle. A curried mod whose treehash is being used as the puzzle hash of a coin. More info here.
Puzzle mod. A puzzle with all mutable args, immutable args and MOD_HASH uncurried.
Singleton. A coin that can have at most one descendant of same type (TODO: not quite correct in case of savings vaults, which can squeeze out other savings vaults in eve state). Note that as opposed to the standard singleton, the parent of a singleton may not be a standard launcher, and may have launched multiple singletons, even of same type. Some singletons may live forever, whereas others are meltable.
Standard singleton. A coin with puzzle mod singleton_top_layer_v1_1.clsp. In general Chia parlance, standard singletons are simply called singletons. However, in the context of the protocol it is more convenient to use the term singleton in a broader sense.
State. The curried args of a coin's puzzle. State consists of three mutually exclusive sets of curried args: fixed state, immutable state, mutable state.
Statutes struct. The conventional singleton struct of the Statutes coin. Consists of standard singleton mod hash, ID of the coin that launched the Statutes singleton, hash of the standard singleton launcher mod. Found as an immutable arg STATUTES_STRUCT in many protocol coin puzzles.
Tail. The Token and Asset Issuance Limitations of a CAT. A program whose treehash is meant to be curried into the TAIL_PROGRAM_HASH arg of the CAT mod. The tail sets the rules according to which a CAT may be minted, issued or melted. A CAT tail's treehash is also referred to as its asset ID.
Treehash. The canonical hash of a Chialisp program or expression. Defined by the sha256tree function.
Type. The type of a protocol coin is defined by the innermost inner puzzle mod which is still defined by the protocol. If there is no inner puzzle, then the outer puzzle mod defines the type.
For example, Savings vaults and Treasury coins are different types of coins, even though they share the same outer puzzle - the standard CAT mod with BYC tail curried in. An example of a coin type that's based on its outer puzzle are Announcers. An example of a coin type with multiple nested inner puzzles are savings vaults. Although a savings vault's inner puzzle (savings_vault.clsp) has itself an inner puzzle (curried into INNER_PUZZLE arg), the latter can be freely chosen by the owner of the savings vault, and hence does not subdivide savings vaults into multiple types.
Unique singleton. A singleton of a type that only exists once in the entire protocol. There are three unique singletons in the protocol: Statutes, Oracle and Announcer Registry.
User. Somebody who uses the protocol to borrow or earn interest on Bytecash.