Foundational Concepts
CryptoArena is an experimental venture at the bleeding edge of defi & blockchain technology.
Our distribution blockchain is a Layer 2 solution built as a Parachain that shares its security and interoperability with Polkadot's Relay Chain (Layer 1) and the rest of L2s in the network.
This section is a handy reference guide for concepts and terminology relating to our the technologies involved in our solution and related to our ecosystem.
Parachains share in the security of the overall network and can interact without trust bonds much like smart contracts on Ethereum can interact without trust bonds — they share state and validation logic with the greater network.
Because Polkadot provides the security and validity guarantees, parachains are not subject to normal blockchain attack scenarios, like a 51% attack. Polkadot validators will reject invalid blocks, so a parachain only needs a single honest collator to submit blocks.
This model opens up a new area of crypto-economics that could include token-less parachains, proof-of-stake parachains that use either a native parachain token or dot tokens, or other collator selection mechanisms. Block author information is normally part of the block header’s digest and is easy to verify.
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.
An internal codename for "Al's Finality Gadget", which is named after Alistair Stewart who invented it. AfG is synonymous with GRANDPA.
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 argumentsError- used to inform users why a function invocation (Call) failedEvent- pallets can emit events to make users aware of some state changesLog- an extensible header itemMetadata- information that allows inspection of the aboveOrigin- specifies the source of a function invocation (Call)
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.
Approval voting is used by the FRAME Elections Phragmen pallet that materializes as a governing Council on a number of Substrate-based chains.
The node that is responsible for the creation of a block; block authors may be referred to as block "producers". In a proof-of-work chain these nodes are called "miners".
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.
A hybrid consensus scheme where Aura is used for block production and short-term probabilistic finality, with deterministic finality provided through GRANDPA.
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 O(n²), where n is the number of nodes (participants) in the system.
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.
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.
A mnemonic phrase 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 //Alice.
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 type of Byzantine (erroneous/malicious) behavior that involves backing multiple mutually-exclusive options within the consensus mechanism.
A function used by some proof-of-work consensus systems, notably that which is used by the Ethereum blockchain. It was developed by a team led by Tim Hughes.
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.
A means of executing a function call in a given runtime with a set of dependencies. There are two executor implementations present in Substrate, Wasm and Native.
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.
GRANDPA is the deterministic finality gadget that is used by the Polkadot Network.
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 B, p approaches 1.
A piece of data that can be used to prove that a particular block is finalized.
Forks occur when two blocks have the same parent. Forks must be resolved so that only one canonical chain exists.
Flaming Fir is a Parity-maintained Substrate-based blockchain that exists for developing and testing the Substrate blockchain development framework.
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. decl_event!, decl_error!, decl_storage!, decl_module! and compose pallets (e.g. construct_runtime! 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 frame_support 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 node that is able to synchronize a block chain in a maximally secure manner through execution (and thus verification) of all logic. Full clients stand in contrast to light clients.
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 deterministic finality gadget for blockchains that is implemented in the Rust programming language. The formal specification is maintained by the Web3 Foundation
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.
Macros are features of some programming languages, including Rust, that allow developers to "write code that writes code". FRAME provides a number of macros that make it easy to compose a runtime.
Metadata is information about a system, such as a blockchain, that makes it easier to interact with that system. Blockchain runtimes that are built with FRAME expose lots of helpful metadata.
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.
A parachain is a blockchain that derives shared infrastructure and security from a "relay chain". You can learn more about parachains on the Polkadot Wiki.
A module that can be used to extend the capabilities of a FRAME-based runtime. Pallets bundle domain-specific logic along with related runtime primitives like events, and storage items.
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.
An instant finality, Byzantine fault tolerant (BFT) consensus algorithm. One of a number of adaptions of pBFT for blockchains. Refer to its implementation on GitHub.
Rococo is the Polkadot Network's parachain test network. It is a Substrate-based blockchain that is an evolving testbed for the capabilities of heterogeneous blockchain networks.
The block execution logic of a blockchain, i.e. the state transition function. In Substrate, this is stored as a WebAssembly binary in the chain state.
A fixed, equal interval of time used by consensus engines such as Aura and BABE. In each slot, a subset of authorities is permitted (or obliged, depending on the engine) to author a block.
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.
The logic of a blockchain that determines how the state changes when a block is processed. In Substrate, this is effectively equivalent to the runtime.
FRAME primitives that provide type-safe data persistence capabilities to the runtime. Learn more about storage items in the Knowledge Base article for runtime storage.
A flexible framework for building modular, efficient, and upgradeable blockchains. Substrate is written in the Rust programming language and is maintained by Parity Technologies.
A type of extrinsic that can be safely gossiped between nodes on the network thanks to efficient verification through signatures or signed extensions.
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.
Westend is a Parity-maintained, Substrate-based blockchain that serves as the test network for the Polkadot Network.
