Terra Core modules
The Terra Core is the official Golang reference implementation of the Terra protocol. The Terra Core is built using the Cosmos SDK, which provides a robust framework for blockchains that run atop the Tendermint consensus protocol.
How to use the Terra Core module specifications
Each module specification begins with a short description of the module's main function within the architecture of the system and an explanation of how it contributes to implementing Terra's features.
The body of each module specification provides a more detailed description of its main processes and algorithms alongside any concepts you might need to know. The body of each module specification also contains links to more granular information, such as specific state variables, message handlers, and other functions.
These specifications are not an exhaustive reference and are provided as a companion guide for users who need to work directly with the Terra Core codebase or understand it. Though all the important functions in each module are described, more trivial functions, such as getters and setters, are omitted for clarity. Module logic is also located in either the message handler or block transitions, such as begin-blocker and end-blocker.
The end of each module specification includes lists of various module parameters alongside their default values with a brief explanation of their purpose, associated events / tags, and errors issued by the module.
The Terra Core is organized into the following individual modules that implement different parts of the Terra protocol. They are listed in the order in which they are initialized during genesis:
genaccounts- import & export genesis account
distribution: distribute rewards between validators and delegators
- reward distribution
- community pool
staking: validators and Luna
auth: ante handler
- vesting accounts
bank- sending funds from account to account
slashing- low-level Tendermint slashing (double-signing, etc)
gov: on-chain governance
- parameter updating
crisis- reports consensus failure state with proof to halt the chain
- filter and handle
- filter and handle
Many of the modules in Terra Core inherit from the Cosmos SDK and are configured to work with Terra through customization in either genesis parameters or by augmenting their functionality with additional code.
The following processes are executed during each block transition:
1. Distribution: Issuance of rewards for the previous block.
2. Slashing: Checking of infraction evidence or downtime of validators for double-signing and downtime penalties.
3. Messages are routed to their appropriate modules and then processed by the appropriate message handlers.
4. Crisis: Check all registered invariants and assert that they remain true.
5. Governance: Remove inactive proposals, check active proposals whose voting periods have ended for passes, and run the registered proposal handler of the passed proposal.
6. Staking: The new set of active validators is determined from the top 130 Luna stakers. Validators that lose their spot within the set start the unbonding process.
- Luna is the Terra protocol's native staking asset. Delegators earn mining rewards when they stake their Luna to an active validator. Luna is also used to create and vote on governance proposals.
The microunit () is the smallest atomic unit of Luna.