Words matter and we seek clarity in the terminology, so we can have clarity in our thinking and communication. Key concepts that we mention below are defined here:
Operator- This is a person (or people) who control an Injective Chain validator node. This is also called
valoperor "Validator Operator" in the Cosmos SDK staking module.
Validator- This is an Injective Chain validating node (signs blocks)
Orchestrator- This is the off-chain
peggoservice which performs the following roles for the
Eth Signer- Signs transactions used to move tokens between the two chains using Ethereum private keys.
Claimsusing Injective Chain account private keys which are submitted to the Peggy module where they are then aggregated into
Relayer- Submits Valset updates and Batch transactions to the Peggy contract on Ethereum. It earns fees from the transactions in a batch.
Validator Set- The set of Injective Chain validators, along with their respective voting power as determined by their stake weight, also referred to as a Valset. These are ed25519 public keys (prefixed by
injvalcons) used to sign Tendermint blocks.
Claim- an Ethereum event signed and submitted to Injective by a single
Attestation- an aggregation of claims that eventually becomes
observedby all orchestrators.
Peggy Contract- The Ethereum contract that holds all of the ERC-20 tokens. It also maintains a compressed checkpointed representation of the Injective Chain validator set using
Delegate Keysand normalized powers. For example if a validator has 5% of the Injective Chain validator power, their delegate key will have 5% of the voting power in the
Peggy Contract. These values are regularly updated on the contract to keep the Valset checkpoint in sync with the real Injective Chain validator set.
Peggy Tx pool- a transaction pool that exists in the store of Injective -> Ethereum transactions waiting to be placed into a transaction batch.
Transaction batch- A transaction batch is a set of Ethereum transactions (i.e. withdrawals) to be sent from the Peggy Ethereum contract at the same time. Batching the transactions reduces the individual costs of processing the withdrawals on Ethereum. Batches have a maximum size (currently around 100 transactions) and are only involved in the Injective -> Ethereum flow.
Peggy Batch pool- A transaction pool like structure that exists in the Injective Chain store, separate from the
Peggy Tx pool. It stores transactions that have been placed in batches that are in the process of being signed or being submitted by the
EthBlockConfirmationDelay- An agreed upon number of Ethereum blocks confirmations that all oracle attestations are delayed by. No
Orchestratorwill attest to have seen an event occur on Ethereum until this number of blocks has elapsed as denoted by their trusted Ethereum full node. This prevents short forks/chain reorganizations from causing disagreements on the Injective Chain. The current value used is 12 block confirmations.
Observed- Events on Ethereum are considered
Eth Signersof 66% of the active Injective validator set during a given block has submitted an oracle message attesting to seeing the event.
Validator set delta- This is a term for the difference between the validator set currently in the Peggy Ethereum contract and the actual validator set on the Injective Chain. Since the validator set may change every single block there is essentially guaranteed to be some nonzero
Validator set deltaat any given time.
Peggy ID- This is a random 32 byte value required to be included in all Peggy signatures for a particular contract instance. It is passed into the contract constructor on Ethereum and used to prevent signature reuse when contracts may share a validator set or subsets of a validator set.
Peggy contract code hash- This is the code hash of a known good version of the Peggy contract solidity code. It will be used to verify exactly which version of the bridge will be deployed.
Voucher- Represents a bridged ETH token on the Injective Chain side. Their denom is has a
peggyprefix and a hash that is build from contract address and contract token. The denom is considered unique within the system.
Counterpart- to a
Voucheris the locked ETH token in the contract
Delegate keys- when an
Operatorsets up the
Delegate Keysby sending a message containing these keys using their
Validatoraddress. There is one delegate Ethereum key, used for signing messages on Ethereum and representing this
Validatoron Ethereum and one delegate Injective Chain account key that is used to submit