This page defines and explains many of the domain-specific terms that are common to the Substrate ecosystem. This is a helpful resource for even the most experienced Substrate developers.
A means of specifying a passing threshold for a referendum based on voter turnout. Positive turnout bias means that as more votes are cast, the passing threshold decreases; i.e. a higher turnout positively increases the likelihood of a referendum passing. Negative turnout bias means that the passing threshold increases as more votes are cast. Negative turnout bias is also called "default carries" as, given an apathetic voting body, the referendum will pass by default. A neutral turnout bias specifies a simple majority passing threshold. AQB removes the need for strict quorums, which are arbitrary and create undesirable governance mechanics. AQB is implemented in the Democracy pallet, which provides the interfaces for a number of on-chain bodies (e.g. a Collective or any token holder) to call referenda with positive, neutral, or negative biases.
Used in the context of FRAME, "pallet aggregation" means combining analogous types from multiple runtime modules into a single type. This allows each module's analogous types to be represented. Currently there are six such data types:
Call- published functions that may be called with a set of arguments
Error- used to inform users why a function invocation (
Event- pallets can emit events to make users aware of some state changes
Log- an extensible header item
Metadata- information that allows inspection of the above
Origin- specifies the source of a function invocation (
Voting system where voter can vote for as many candidates as desired. The candidate with highest overall amount of votes wins. Notably:
- voting for all candidates is exactly equivalent to voting for none; and
- it is possible to vote "against" a single candidate by voting for all other candidates.
Authorities are the nodes who, as a collective, manage consensus on a blockchain network. In a proof-of-stake network (such as one using the Staking pallet from FRAME), authorities are determined through a token-weighted nomination/voting system.
The terms "authorities" and "validators" may sometimes seem to refer the same thing. "Validators" is a broader term that can include other aspects of chain maintenance such as parachain validation. In general authorities are a (non-strict) subset of validators and many validators will be authorities.
Deterministic consensus protocol where block production is limited to a rotating list of authorities that take turns creating blocks; the majority of online authorities are assumed to be honest. Learn more by reading the official wiki article for the Aura consensus algorithm.
Block authoring protocol similar to Aura, however authorities win slots based on a verifiable random function (VRF) as opposed to Aura's round-robin selection method. The winning authority can select a chain and submit a new block for it. Learn more about BABE by referring to its official Web3 Foundation research document.
A single element of a blockchain that cryptographically binds a set of extrinsic data (the "body") to a "header". Blocks are arranged into a tree through parent pointers (implemented as a hash of the parent) and the tree is pruned into a list via a fork-choice rule, and optional finality gadget.
A blockchain is a distributed network of computers that uses cryptography to allow a group of participants to trustlessly come to consensus on the state of a system as it evolves over time. The computers that compose the blockchain network are called nodes.
The ability of a distributed computer system to remain operational in the face of a proportion of defective nodes or actors. "Byzantine" refers to the ultimate level of defectiveness, with such nodes assumed to be actively malicious and coordinating rather than merely offline or buggy. Typically, BFT systems remain functional with up to around one-third of Byzantine nodes.
The loss of a system service due to a Byzantine Fault (i.e. components in the system fail and there is imperfect information about whether a component has failed) in systems that require consensus.
An early approach to Byzantine fault tolerance. pBFT systems tolerate Byzantine behavior from up to
one-third of participants. The communication overhead for such systems is
n is the
number of nodes (participants) in the system.
In the context of a blockchain, consensus is the process nodes use to agree on the canonical fork of a chain. Consensus is comprised of authorship, finality, and fork-choice rule. In the Substrate ecosystem, these three components are cleanly separated from one another, and the term consensus often refers specifically to authorship.
A subsystem of a Substrate node that is responsible for consensus tasks.
An algorithm that is able to ensure that a set of actors, who don't necessarily trust each other, can come to consensus over some computation. Often mentioned alongside "safety" (the ability to ensure that any progression will eventually be agreed as having happened by all honest nodes) and "liveness" (the ability to keep making progress). Many consensus algorithm are referred to as being Byzantine-fault-tolerant.
A blockchain consensus protocol that consists of independent or loosely coupled mechanisms for block production and finality. This allows the chain to grow as fast as probabilistic consensus protocols, such as Aura, while still maintaining the same level of security as deterministic finality consensus protocols, such as GRANDPA. In general, block production algorithms tend to be faster than finality mechanisms; separating these concerns gives Substrate developers greater control of their chain's performance.
A term that refers to concepts like signature schemes and hashing algorithms. Cryptographic primitives are essential to many aspects of the Substrate ecosystem:
- Blockchains: blocks must be hashed under some algorithm and reference their parent block's hash.
- State: Substrate storage is encoded as a trie, a data structure that uses hashing to facilitate efficient verification.
- Consensus: authorities often use digital signature schemes of some kind.
- Transaction authentication: in runtimes where transactions and accounts are used, accounts are identified and authenticated through the use of cryptography.
The term "Council" is used on a number of Substrate-based networks, such as Kusama and Polkadot to refer to an instance of the Collective pallet that is used as a part of the network's FRAME-based runtime. The Council primarily serves as a body to optimize and check/balance the more inclusive referendum system.
The means by which the state of a blockchain network is persisted between invocations of the blockchain node application. There is documentation that explains the implementation of the database backend that is used by Substrate-based chains.
that is intentionally made public. All of the
well-known development accounts (Alice, Bob, Charlie, Dave,
Ferdie, and Eve) are generated from the same dev phrase. The dev phrase is:
bottom drive obey lake curtain smoke basket hold race lonely fit walk.
Many tools in the Substrate ecosystem, such as
subkey, allow users to
implicitly specify the dev phrase by only specifying a derivation path such as
An extensible field of the block header that encodes information needed by several actors in a blockchain network including, light clients for chain synchronization, consensus engines for block verification, and the runtime itself in the case of pre-runtime digests.
A dispatch is the execution of a function with a pre-defined set of arguments. In the context of
runtime development with FRAME, this refers specifically to the "runtime
dispatch" system, a means of taking some pure data (the type is known as
Call by convention) and
interpreting it in order to call a published function in a runtime module ("pallet") with
some arguments. Such published functions take one additional parameter, known as
origin, that allows the function to securely determine the provenance of its execution.
A means of recording, for the benefit of the off-chain world, that some particular state transition happened. Within the context of FRAME, events are one of a number of composable data types that each pallet may individually define. Events in FRAME are implemented as a set of transient storage items that are inspected immediately after a block has executed and reset during block-initialization.
This executor uses a natively compiled runtime embedded in the node to execute calls. This is a performance optimization that up-to-date nodes can take advantage of.
This executor uses a Wasm binary and a Wasm interpreter to execute calls. The binary is guaranteed to be up-to-date regardless of the version of the blockchain node since it is persisted in the state of the Substrate-based chain.
A piece of data that is bundled into a block in order to express something from the "external" (i.e. off-chain) world. There are, broadly speaking, two types of extrinsics: transactions, which may be signed or unsigned, and inherents, which are inserted by block authors.
Within the Balances pallet, this is the minimum balance an account may have. Accounts cannot be created with a balance less than this amount, and if an account's balance ever drops below this amount, the Balances pallet will use a FRAME System API to drop its references to that account. If all the references to an account are dropped, it may be reaped.
A part of consensus that deals with making a progression irreversible. If a block is "finalized", then any state changes it encapsulates are irreversible without a hard fork and it is safe to effect any off-chain repercussions that depend on them. The consensus algorithm must guarantee that finalized blocks never need reverting.
In these systems, all blocks are guaranteed to be the canonical block for that chain upon block inclusion. Deterministic finality is desirable in situations where the full chain is not available, such as in the case of light clients. GRANDPA is a deterministic finality gadget.
A non-probabilistic consensus protocol that gives a guarantee of finality immediately upon block production. These tend to be pBFT-based and thus very expensive in terms of communication requirements.
In these systems, finality is expressed in terms of a probability, denoted by
p, that a proposed
block, denoted by
B, will remain in the canonical chain; as more blocks are produced on top of
p approaches 1.
A piece of data that can be used to prove that a particular block is finalized.
FRAME is Substrate's system for runtime development. The name is
an acronym for the "Framework for Runtime Aggregation of Modularized Entities". FRAME allows
developers to create blockchain runtimes by composing modules, called "pallets". Runtime
developers interact with FRAME by way of a macro language that makes it easy for
developers to define custom pallets (e.g.
and compose pallets (e.g.
into a working runtime that can easily be used to power a Substrate-based blockchain. The convention
used in the Substrate codebase is to
preface FRAME's core modules with
frame_ and the optional pallets with
pallet_*. For instance,
the macros mentioned above are all defined in the
module and all FRAME-based runtimes must include the
frame_system module. Once the
frame_support::construct_runtime macro has been used to create a runtime that includes the
frame_system module, optional pallets such as the Balances pallet may
be used to extend the runtimes core capabilities.
A mechanism for specifying the initial (genesis) state of a blockchain. Genesis configuration of Substrate-based chains is accomplished by way of a chain specification file, which makes it easy to use a single Substrate codebase to underpin multiple independently configured chains.
A structure that is used to aggregate pieces of (primarily cryptographic) information that summarize a block. This information is used by light-clients to get a minimally-secure but very efficient synchronization of the chain.
A subsystem in Substrate for managing keys for the purpose of producing new blocks.
Kusama is a Substrate-based blockchain that implements a design similar to the Polkadot Network. Kusama is a "canary" network and is referred to as Polkadot's "wild cousin". The differences between a canary network and a true test network are related to the expectations of permanence and stability; although Kusama is expected to be more stable than a true test network, like Westend, it should not be expected to be as stable as an enterprise production network like Polkadot. Unlike Westend, which is maintained by Parity Technologies, Kusama (like Polkadot) is controlled by its network participants. The level of stability offered by canary networks like Kusama is intended to encourage meaningful experimentation.
A peer-to-peer networking stack that allows use of many transport mechanisms, including WebSockets (usable in a web browser). Substrate uses the Rust implementation of the libp2p networking stack.
A light client is a type of blockchain node that does not store the chain state or produce (author) blocks. It encapsulates basic capabilities for verifying cryptographic primitives and exposes an RPC (remote procedure call) server to allow blockchain users to interact with the blockchain network.
A node correlates to a running instance of a blockchain client; it is part of the peer-to-peer network that allows blockchain participants to interact with one another. Substrate nodes can fill a number of roles in a blockchain network. For instance, validators are the block-producing nodes that power the blockchain, while light-clients facilitate scalable interactions in resource-constrained environments like UIs or embedded devices.
A means of determining a set of validators (and thus authorities) from a number of accounts willing to commit their stake to the proper (non-Byzantine) functioning of one or more authoring/validator nodes. The Polkadot protocol describes validator selection as a constraint optimization problem to eventually give a maximally staked set of validators each with a number of supporting nominators lending their stake. Slashing and rewards are done in a pro-rata manner.
A FRAME primitive that identifies the source of a dispatched function call into the runtime. The FRAME System module defines three built-in origins; pallet developers can easily define custom origins, such as those defined by the Collective pallet.
The Polkadot Network is a blockchain that serves as the central hub of a heterogeneous blockchain network. It serves the role of "relay chain" and supports the other chains (the "parachains") by providing shared infrastructure and security. The Polkadot Network is progressing through a multi-phase launch process and does not currently support parachains.
A consensus mechanism that deters attacks by requiring work on the part of network participants. For instance, some proof-of-work systems require participants to use the Ethash function to calculate a hash as a proof of completed work.
The central hub in a heterogenous ("chain-of-chains") network. Relay chains are blockchains that provide shared infrastructure and security to the other blockchains in the network (the "parachains"). In addition to providing consensus capabilities, relay chains also allow parachains to communicate and exchange digital assets without needing to trust one another.
A mechanism for interacting with a computer program that allows developers to easily query the computer program or even invoke its logic with parameters they supply. Substrate nodes expose an RPC server on HTTP and WebSocket endpoints.
A standard way to call functions on a remote system by using a JSON protocol. For Substrate, this is implemented through the Parity JSON-RPC crate.
Democratic voting system that uses one-vote-per-token, rather than one-vote-per-head.
In a blockchain, the state refers to the cryptographically secure data that persists between blocks and can be used to create new blocks as part of the state transition function. In Substrate-based blockchains, state is stored in a trie, a data structure that supports the efficient creation of incremental digests. This trie is exposed to the runtime as a simple key/value map where both keys and values can be arbitrary byte arrays.
A definable period, expressed as a range of block numbers, where a transaction may be included in a block. Transaction eras are used to protect against transaction replay attacks in the event that an account is reaped and its (replay-protecting) nonce is reset to zero.
A collection of transactions that are not yet included in blocks but have been determined to be valid.
A generic Substrate-based transaction pool implementation that allows the runtime to specify whether a given transaction is valid, how it should be prioritized, and how it relates to other transactions in the pool in terms of dependency and mutual-exclusivity. It is designed to be easily extensible and general enough to express both the UTXO and account-based transaction models.
An data structure that is used to represent sets of items where:
- a cryptographic digest of the dataset is needed; and/or
- it is cheap to recompute the digest with incremental changes to the dataset even when it is very large; and/or
- a concise proof that the dataset contains some item/pair (or lacks it) is needed.
A semi-trusted (or untrusted but well-incentivized) actor that helps maintain a blockchain network. In Substrate, validators broadly correspond to the authorities running the consensus system. In Polkadot, validators also manage other duties such as guaranteeing data availability and validating parachain candidate blocks.
An execution architecture that allows for the efficient, platform-neutral expression of deterministic, machine-executable logic. Wasm is easily compiled from the Rust programming language and is used by Substrate-based chains to provide portable runtimes that can be included as part of the chain's state.