An operator is an entity who participates in hosting worker nodes to execute business case logic in a network of worker nodes. The operator is represented by their dedicated EWX account.
An EWX account may be created using the publicly available Polkadot wallets. EWX is currently supported by below wallets:
The EWX account MUST NOT be used as a worker node account because they serve different purposes. The operator account nominates a worker node account which can represent the operator when submitting worker node results to EWX.
An EWX account can hold EWT for staking and claiming rewards.
Balances Pallet
The Balances Pallet is a core module in the Polkadot SDK, responsible for managing token balances, enabling secure transfers, and supporting the blockchain’s economic operations. It provides robust mechanisms for balance management, transaction fees, and account lifecycle, ensuring a stable and efficient economic framework for Substrate-based blockchains.
Key functionalities:
Account Balances Management: Maintains and tracks balances for all accounts, divided into free balance (spendable) and reserved balance (locked for specific purposes).
Token Transfers: Enables secure token transfers between accounts with features like keep-alive transfers to prevent accounts from being reaped.
Locks and Imbalances: Introduces runtime locks to temporarily restrict access to balances during specific operations (e.g., governance or staking) and handles imbalances through secure issuance or burning of tokens to maintain economic integrity across the system.
Proxy Pallet
The Proxy Pallet is a versatile module in the Polkadot SDK that facilitates secure delegation of account operations. It allows users to authorize other accounts, called proxies, to perform specific actions on their behalf. This feature enables enhanced account management, operational flexibility, and secure delegation, particularly beneficial in multi-sig setups and automation scenarios.
Key functionalities:
Account Delegation: Enables accounts to delegate specific operations to proxy accounts with configurable levels of permissions and supports use cases such as transaction signing, staking operations, and runtime-specific actions.
Proxy Types and Permissions: Defines distinct proxy types to grant granular permissions, ensuring proxies can only execute authorized actions.
Time-Limited and Announced Proxies: Introduces time-limited proxies that automatically expire after a predefined duration, enhancing security. It also implements delayed announcements for high-risk actions, allowing users to monitor and cancel actions if necessary.
Security and Revocation: Includes mechanisms for account owners to revoke proxy permissions at any time, ensuring full control while it protects against unauthorized actions through runtime checks and adherence to defined proxy types.
Multisig Pallet
The Multisig Pallet in the Polkadot SDK provides a robust mechanism for multi-signature account management, enabling secure and coordinated actions among multiple participants. This pallet is integral for collaborative decision-making and securing high-value operations in decentralized ecosystems.
Key functionalities:
Creation of Multisig Agreements: Facilitates the creation of multi signature agreements among multiple accounts with a defined threshold of required approvals. Supports both single-use and reusable multi signature setups for flexibility in different use cases.
Threshold-Based Execution: Allows execution of transactions once the required threshold of signatures has been collected and ensures that no action is performed unless the predefined consensus is reached among signatories.
Time-Locked Approvals: Introduces optional time-locks for multisig operations, giving signatories a limited window to approve or reject a proposal and ensures timely decision-making and reduces risks associated with prolonged inactivity.
Scheduler Pallet
The Scheduler Pallet provides a powerful framework for scheduling time-based and event-driven tasks within the runtime. It is integral for automating and orchestrating on-chain operations at specified block heights or based on dynamic triggers.
Key functionalities:
Scheduled Task Management: Enables the scheduling of on-chain calls to execute at a specified block number or recurring intervals and supports delayed execution, enabling precise control over task timing for one-off or periodic operations.
Flexible Call Dispatching: Allows scheduling of any callable extrinsics, making it versatile for automating runtime functionality. It also supports tasks requiring root-level permissions or limited by specific user-defined filters.
Priority and Weight Control: Assigns priorities to scheduled tasks to determine execution order in case of conflicts and manages weight allocation to prevent overloading blocks with scheduled calls.
Rescheduling and Cancellation: Provides mechanisms to modify or cancel scheduled tasks before execution.
How to Participate in the EWX Network as a Staker and Support Network Security and Solution Accountability.
This step-by-step guide explains how EWT holders can participate in securing the Energy Web X (EWX) network and support Verified Compute Cloud (VCC) solution accountability through liquid staking and solution group participation.
Step 1: Acquire Energy Web Tokens (EWT)
EWT can be acquired via decentralised and centralised exchanges. A list of supported exchanges is available here.
If you currently hold EWT on Ethereum or EWC, before you can stake, you must first bridge your tokens to Energy Web X (EWX) using the official Energy Web Bridge.
Note: Bridging tokens from EWC to EWX is a one-way function i.e., once tokens are bridged to EWX, they cannot be bridged back to EWC. Bridging tokens from Ethereum to EWX is a two-way function i.e. tokens can be moved back and forth using lock, mint, and burn unlock mechanics.
Step 2: Set Up a Compatible Wallet
First, install an . Once installed, create a new account or import an existing one. Be mindful to securely back up your recovery phrase. Next, enable the Energy Web X network in your wallet settings to view your EWT balance and transact EWT. You can see the steps below to setup your wallet
- Download the wallet of your choice either from appstore or playstore
- Click the create new account tap, add your password
- Write down your seed phrase safely
- Verify your seed phrase
- Your wallet is ready
- Click the drop down button
- Click Manage networks
- Search Energy Web in the search bar
- Toggle on the Energy Web X network
- Select Manage tokens, and toggle on the EWX token
You can see a visual guide on how to setup your wallet .
Step 3: Liquid Stake Your EWT (stEWT)
Liquid staking on Energy Web X allows you to stake EWT and receive a liquid token representation called stEWT. stEWT is transferable and can be used across the ecosystem, including for participation in Verified Compute Cloud solutions. Liquid staking does not mint any new EWT; the overall EWT supply cap remains unchanged.
To liquid stake, open the and select “Liquid Staking”. Then enter the amount of EWT you wish to stake, confirm and sign the transaction in your wallet. Once completed, your wallet will display a stEWT balance.
Note: The exchange rate between EWT and stEWT may change gradually over time due to auto compounding of staking rewards. Click here for or read more .
Step 4: Complete KYC to Stake on Verified Compute Solutions
Now that you have liquid staked your EWT, you can participate in Verified Compute Cloud solution groups. Some VCC solutions require participants to complete know-your-customer (KYC) identity verification before subscribing. The SAFc Registry is one example of a VCC solution that requires KYC.
To initiate KYC, open or download the . Navigate to “Discover”, and locate the relevant Verified Compute Cloud solution group. Click “Initiate KYC” and sign the transaction in your wallet. A KYC form will open in a new browser tab, which you can follow to complete the KYC. Click for a tutorial on how to initiate the KYC identity verification.
Then complete the following KYC process, implemented by a third party verification service provider:
Enter your email address and submit the form.
Check your inbox for the verification email.
When you receive the verification email, click Verify My Identity.
Complete the identity verification flow.
Once your identity has been verified, you can return to the . The solution group status will change to Opt In. Click for a tutorial on how to complete the KYC identity verification.
Step 5: Subscribe to a Verified Compute Cloud Solution Group
To subscribe, click on the “Opt In” button in the , and then complete the Sign Up as Operator flow. To sign up as an operator you need to follow the steps below:
1. Have your EWX account to the marketplace.
2. Have some in the account for transaction fee.
3. Select any of the solution group that is available for subscription and click Opt-in
4. Enter the name you desired for your operator account in the text field, select country of residence and then hit "Continue"
5. Confirm the transaction in your wallet
6. Once approved, wait for the transaction to be executed
7. You will see a success message along with the transaction URL to Polkadot explorer. Your operator account is now registered.
For more information and guide you can check
Choose the amount of stEWT to allocate. Confirm and sign the transaction. Click for a tutorial on how to subscribe to a solution group.
When you subscribe to a VCC Solution Group, you commit stEWT as slashable collateral to support enforcement of the VCC Protocol. Your participation signals support for solution integrity and accountability. Rewards may accrue over time depending on successful service delivery and the relevant VCC Protocol conditions.
Step 6: Claim Your Rewards
Any applicable rewards for successful service delivery are generated automatically, subject to the VCC Protocol conditions, and are claimable via the . To claim, please follow these steps:
Navigate to your subscribed solution group
View “Available Rewards”
Click “Claim Rewards”
Confirm and sign the transaction in your wallet.
Once this claim process is completed, the generated rewards are credited to your account.
Note that awards paid in USDC may not yet be visible directly in the . Updates are in progress to enable this feature, and in the meantime USDC balances can be viewed via supported wallets (e.g. , or Subscan).
Energy Web Tokens
The Energy Web Token (EWT) is the native utility token to access services and orchestrate stakeholders within its blockchain system. In the context of Energy Web Chain, EWT compensates validators for processing transactions, and are used to pay for transactions.
Energy Web X leverages and complements the existing Energy Web Chain by introducing new technical capabilities that streamline the deployment and operation of Worker Node networks.
To maximize the security of every Energy Web solution using worker nodes, EWT will be required to interact with worker nodes and Energy Web X. Most notably, Energy Web Tokens will be required to:
Reward worker node networks: worker nodes are software packages that need to be run by individuals and/or businesses. To attract entities to run worker nodes, enterprises will need to include rewards, paid in EWT, that compensate worker node operators for their work.
Operate worker nodes: to become a trusted party to run worker nodes, individuals and/or businesses will be required to stake EWT. Staking requirements and reward schedules are mass customizable - enterprises launching worker node networks can configure different thresholds and award schedules at their discretion.
Validate Energy Web X: Energy Web X validators will need to stake a significant number of Energy Web Tokens in order to become validators on Energy Web X.
For clarity, instead of launching a new token with the Energy Web X blockchain, Energy Web X will be powered by the existing EWT. Users have the ability to “lift” Energy Web Tokens from the existing Energy Web Chain onto Energy Web X. Lifted Energy Web Tokens can then be used for the functions described above. With this mechanism in place, EWT holders will be able to “lower” Energy Web Tokens back to the main Energy Web Chain at their discretion. Over time, token holders will be able to lower EWT to other layer one blockchains (for example, main net Ethereum) making Energy Web solutions interoperable with any blockchain ecosystem.
Utility tokens like EWT are different from other digital assets in the blockchain sphere such as coins, non-fungible tokens, and stablecoins. To learn more about the distinctions between these assets, see this article,.
Marketplace App (desktop-based)
The Marketplace App is a decentralized desktop application which provides an intuitive interface for the general community with limited technical background to easily participate in running worker nodes on their local machines. It also provides an interface to lift and lower EWTs. It supports Windows, MacOS, and Ubuntu systems.
The Marketplace Desktop App
Energy Web Platform Governance Motions, 2019-2025
Energy Web Chain (EWC) has been governed by Validators based in fifteen countries, representing publicly known and geographically diverse entities, many of whom are subject to strong domestic regulatory supervision regimes. The EWC Validators ranged from large energy-sector market participants (including utilities, grid operators, and cleantech developers) to blockchain and energy startups and had over time grown to about 40 entities. All major Energy Web platform governance motions prior to 2025 technology and governance upgrade are listed below:
Energy Web Platform Governance Motions:
June 2019
EWC Launch and Initial Token Allocation
Following a period of research, development and testing (including support to the first Proof-of-Authority (Kovan) blockchain network and the establishment of ), EWC was officially launched on 16 June 2019 (“Launch”) when the genesis block was approved by the parties responsible for EWC governance (the “Validators”) via system contracts. At Launch, the development of the EW Chain was complete, its protocol was deployed for production, and it was fully operational. Since that time, EWF and other third parties have continued to develop software development kits (SDKs) and decentralized applications; however, it is to be noted developers and users of the EW Chain are not required to access or use the SDKs in order to interact with the EWC (or upgraded EWX), and that EWC/EWX remain operational without any further development of SDKs or deployment of additional decentralized applications.
EWC validators also approved an initial allocation of 21.2 million EWT to 102 entities (including some individuals) that provided funds for Energy Web platform development (“Participants”). Participants that purchased EWT prior to April 1, 2018 were not permitted to transfer or otherwise dispose of their EWT until at least September 16, 2019. Participants who made their purchase after April 1, 2018 were required to not transfer their EWT until at least December 16, 2019. The Validators also approved an allocation of 20.9 million EWT to the Foundation (EWF) and 10 million to its founders, with approximately 35% of the EWF allocation earmarked to pay operational expenses. Including payments to EWF staff and service providers who support and implement the decisions and directives of the Validators (see Table 1 below). The purpose was described in more detail in the and the updated , while the , the and the detailed the subsequent technical updates, leading up to the Energy Web 2025 Upgrade.
Table 1: EWT Token Allocation, June 2019
Rough Consensus Model: Validators adopted an interim off-chain “rough consensus” approach for adding/removing validators, protocol/client updates, and governance changes, relying on EWF support to protect a transparent decision framework while the validator set was still small.
July and August 2019
Validator Eligibility Criteria: In July 2019, Validators approved criteria requiring validators to be legally registered organizations, active EWF Members, and to have proven technical competence by having run a Volta testnet validator.
Energy Web Token (EWT) Listing: In July 2019, Validators discussed exchanges’ listing as a key step to decentralize token supply and support utility token classification, and supported moving forward, beginning with the Liquid exchange listing, tasking EWF to administratively support the registration process, and then consider other exchanges, including the US once there is more regulatory clarity. In August a Liquid Listing Date was approved for September. Validators also discussed the risks of maintaining a default minimum gas price of zero and supported a recommendation to raise the minimum to 1 Gwei (0.000000001 EWT). This was intended to reduce exposure to spam or DDoS attacks while keeping fees low relative to Ethereum. Validators noted the need to recalibrate the minimum gas price over time in response to market conditions, balancing security with affordability for developers and users.
September 2019
Validator Eligibility / Transition from Affiliate to Member Program: Validators deliberated on the shift from the one-time EWF Affiliate MOU to an annual EWF Membership model beginning in 2020 as a key requirement for validator eligibility. The new structure requires members to actively support EWF’s mission, contribute to the ecosystem, pay fees or provide in-kind contributions, and demonstrate commercial activity or developer engagement. Validators discussed safeguards for smaller companies, including potential staking or multi-sig payout mechanisms. They agreed that the updated criteria would apply equally to existing and new entrants.
Transitioning from Interim Governance Model: With nearly 20 validators across 14 time zones, validators agreed that the rough consensus model based on monthly calls was no longer scalable. EWF was tasked with documenting the governance processes and introducing signaling vote tools by year-end, with formal validator votes replacing reliance on silence as tacit agreement, thereby creating a clearer audit trail for validator decisions.
October 2019
Formal Voting Mechanism: Validators agreed to replace the rough consensus model with a formal off-chain voting process on the EW Chain Governance Forum (Discourse). Voting delegation was disallowed, participation will be monitored by EWF, one voting event (five business days) per month will be scheduled, and decisions will pass by simple majority (no incentives/penalties for now). The first vote was scheduled for the week of November 11, 2019.
Validator Eligibility / EW Membership: Validators prioritized two mechanisms for future eligibility rules: (i) requiring small companies (<$5m annual revenue) to stake block rewards for a set period, and (ii) clearer membership criteria and transparency for EWF Members. A formal proposal to require small companies to stake mined tokens for one year, applying either to all or only to new entrants from 2020, was prepared for a November vote.
November 2019
Validator Token Staking: Validators discussed and rejected a motion to demand from new validators to lock block rewards in escrow for 1 year to build reputation and deter malicious behavior. The decision tally was as follows: 9 Yes, 13 No, 2 abstained.
Emergency Operating Procedures: Validators retired the legacy “Node Control” tool and established formal EOPs, authorizing temporary removal of validators or node updates by EWF in emergencies (e.g. unplanned forks, malicious/benign failures), subject to validator review within 48 hours. The decision tally was as follows: 17 Yes, 3 No. Validators also discussed the need for better visibility into node stability, with suggestions including dashboards, netstats-style pages, and sharing monitoring scripts. EWF was tasked with investigating the feasibility and resource requirements for a netstats-like monitoring tool while emphasizing that each validator remains responsible for monitoring its own node.
December 2019
Ethereum Istanbul Hard Fork Alignment: Validators approved adoption of Ethereum’s Istanbul hard fork (EIPs 152, 1108, 1344, 1884, 2028, 2200) to align EWC with Ethereum mainnet improvements. Implemented via a 5-stage rollout plan (Volta test updates, validator client upgrades, chainspec updates, fork observation). The decision tally was as follows: 14 Yes, 2 Abstain. In two subsequent discussions in December they deliberated on the governance of the EWT Community Fund and the 2020 validator eligibility criteria but no new decisions were made.
January 2020
Validator Eligibility 2020 and Beyond: Validators confirmed that their participation in the EWF Membership program remains the primary eligibility criterion, as it provides KYC and financial commitment required under PoA mechanism. Validators who did not renew membership were removed on 17 January 2020. Future improvements to the membership process and potentially a queue for new applicants was discussed. No minimum validator count was set, but diversity across regions and business models was emphasized. There were also additional discussions on the governance mechanism for the Community Fund, which is open to the entire ecosystem, but no specific decisions were made on that topic.
February 2020
Nethermind Client Funding: Validators approved a community funding allocation for development of a Nethermind AuRa client (sealing mode, telemetry integration, Docker support, docs). Deliverables were funded in two phases totaling 2,877 EWT. The decision tally was as follows: 19 Yes (unanimous).
April 2020
Update on EWT Status: EWF reported to validators on the assignment to engage with external counsel and regulators to ensure utility classification. As a result, it was agreed that EWF would proceed with the global, including US-accessible exchange listings, starting with Bitmart on 8 May 2020. The validators were also informed that the EWC-ETH bridge is now production ready, enabling listings on Ethereum-based DEXs such as IDEX. Energy Web Wallet integration with Ledger via MyCrypto was also reported.
Technical Updates on Operating, Monitoring, and Maintaining Validator Nodes: EWF reported that it is setting up ENS on Volta and EWC, offering one free domain per member for the first year (future pricing TBD), pursuant to received directives from the validators. Validators noted the transition from Parity to OpenEthereum, with v2.7.x being the final Parity-branded update and introducing a non-backwards-compatible chain DB format. Concerns were raised about validator liability if third parties use alternative clients and it was agreed that a working group and governance forum post would be created to explore liability limitations and user terms.
May 2020
Community Fund Governance: Validators reviewed a draft governance model for the Community Fund, prepared by EWF based on prior validator discussion. It allocates one-third of tokens respectively to (i) an EW Chain Account governed by validators for technology development, (ii) an EW Operating Account for the Foundation’s mission and development of additional open-source components, and (iii) a Decarbonization Account for grants and environmental certificates. Validators supported the model in principle, with feedback on clarifying scope between validator vs. Foundation governance, structuring grants to mitigate token volatility, and ensuring proposals are denominated in EWT. EWF was tasked with refining the document, creating a new forum section for EWC Account proposals, and incorporating all validator inputs.
June 2020
New Member / Validator Onboarding Process: Validators reviewed a new formal application process requiring validator entities to pass KYC/AML, demonstrate legitimate business activities aligned with EWF’s mission, and provide references. The EWF NetOps team was tasked with reviewing applications and sharing them with validators for comment and approval. Validators supported a case-by-case approach for non-energy companies and suggested creating a template to categorize validators and publish public-facing information.
Community Fund Governance: Validators deliberated and approved the updated, three-part Community Fund model in principle: (i) ⅓ reserved for EW Chain core infrastructure, governed by validators; (ii) ⅓ reserved for EWC operations and development of a utility layer, including EW-DOS development, with governance delegated to EWF; (iii) ⅓ reserved for an “Impact” fund to support wider adoption of EW technology. Grants to be denominated in EWT. Final approval was expected by July, after which funding proposals could be accepted. Validators also agreed to publish external discussion summaries for enhanced transparency, while maintaining validator-only forums for the discussions. They also noted the release of Parity 2.7.2-stable, the last Parity-branded client before OpenEthereum. Plans were approved to update Volta and EWC nodes by the end of June, with further testing required for OpenEthereum compatibility. Validators also discussed the resilience benefits of multi-client diversity and considered a future Community Fund proposal to fund Nethermind development to production grade, including telemetry and installation scripts.
July and August 2020
Energy Web Community Fund: The three-part governance mechanism for the Community Fund was formally implemented. In July 2020, validators adopted Proposal 04 to award 2,877 EWT to Nethermind to develop a production-ready client for EWC to improve chain resiliency, funded from Chain Reserve on a deliverables-based schedule, by a vote of 20 in favor and 4 not voting. The Operations Reserve funded the Innovation Challenge, awarding 3,700 EWT to winning and runner-up teams. EWF also reported on building a monitoring tool to track balances across reserves. The new Nethermind Client Testing began mid-August 2020 when validators agreed to a soft target of at least three nodes adopting Nethermind once stable, while leaving final client choice to each validator.
New Member / Validator Applications: Validators noted that the new formal application and KYC process for prospective members came into effect, though no new applications were received in July 2020. In August 2020, two new applicants were approved under the formal application and KYC process – Vodafone and Zytech Solar.
December 2020
Bug Bounty Program: Validators established an EW-DOS Technical Committee, composed of representatives from validator organizations, to manage bug reports, with tiered EWT rewards (Low–Critical), with work funded from Community Fund reserves. The decision tally was as follows: 21 Yes (unanimous).
May 2021
Upgrade OpenEthereum Client & Berlin Hard Fork for Validator Nodes: Validators agreed to align EWC with Ethereum’s Berlin upgrade by moving validator nodes to OpenEthereum v3.2.5 and activating EIPs 2565 (ModExp gas), 2718 (typed tx envelope), 2929 (state access gas increases), and 2930 (access lists). Execution followed a staged plan across Volta to EWC, with defined observation windows and rollback contingencies. The decision tally was as follows: 37 Yes (unanimous).
August 2021
Community Fund Grant: Anyblock Analytics Validator Accounting Tool: Validators approved a funding allocation for an accounting dashboard to help validators track and verify EWT rewards (block rewards/fees) and transactions. The decision tally was as follows: 28 Yes (unanimous).
September 2021
London Upgrade, EIP-1559 & related EIPs: Validators agreed to implement Ethereum’s London Upgrade on EWC (EIPs 1559, 3198, 3529, 3541, 3554), with a streamlined process vs. Berlin Upgrade: all validators to update within set windows; self-reporting via forms; non-compliant nodes to be temporarily removed; staged Volta observation, EWC activation with public comms. The decision tally was as follows: 37 Yes (unanimous).
November 2021
Community Fund Grant: Trust Wallet, Bl0x: Validators approved a funding allocation (grant) to Bl0x to add native EWT to Trust Wallet (chain/address/signing logic, tests, open-source PRs), implement WalletConnect, and co-author user documentation. The decision tally was as follows: 35 Yes (unanimous).
December 2021
Validator Code of Conduct Update : Validators amended the Code of Conduct to integrate objective enforcement including thresholds around Node health, uptime, meeting attendance, voting participation (rolling 6 months). Any violations are to trigger escalation suspensions/expulsion; compliance tracked via a public validator dashboard. The decision tally was as follows: 23 Yes, 9 No.
March 2025
Energy Web Architecture Upgrade Proposal (Zurich Hard Fork): Validators approved the Energy Web 2025 Upgrade, transforming the Energy Web platform architecture from membership-based PoA validation on EWC to permissionless, nominated PoS validation on EWX Polkadot parachain, with the following key features: EWT migration to ERC-20 on Ethereum, on-chain treasury governance replacing exclusively validator-managed Community Fund and decentralising platform governance overall, as well as permissionless staking options (collators, liquid restaking; Verified Compute Cloud staking with stEWT facilitated by Worker Node Network pallet) and multi-asset enablement as BYOT for verified compute reward payout fees.
Block Reward Contract
Overview
The Block Reward contract manages block reward payouts to validators. Block rewards are issued as native Energy Web tokens that are minted by the engine.
Two entities are rewarded by each created block:
The block author (validator)
Documentation and Source Code
Block Reward Payouts
Block Authors
Block authors are rewarded each time they seal a block. The amount issued to block authors decreases over time, as depicted by the Discreet S Curve.
Calculator:
Energy Web Community Fund
A portion of block rewards goes to the Community Fund. Unlike the amount awarded to block authors, the amount that goes to the Community Fund remains constant over time.
The amount is chosen to add up to roughly 37.9 million tokens over a 10 year period. The community fund can change its own address and set a payout address too.
With 5 second step size: Payout-per-block = 600900558100000000 wei
Visual representation of the community reward distribution is depicted below in Fig. 3.
Interaction with Block Reward Contract
Contract Address and ABI
Validator-Set Contract
Overview
Validator Set contracts provide information on current validators and private functionality to add and remove validators.
Validator set components
Documentation and Source Code
Components
For upgradeability purposes, the contracts are divided into 2 parts. See below Fig. 1.
RelaySet Contract
This contract implements the required interface expected by the engine and it is the contract defined in the chainspec seen by the engine. It relays most of the function calls to the RelayedSet contract, which holds the actual logic. The logic contract can be replaced (upgraded), so it is possible to change the behavior of validator management without conducting a hard fork.
RelayedSet Contract
This contract implements the logic and manages the validator list. The owner of the validator set interacts with this contract for managing the validators. This contract maintains two validator sets:
Thecurrent validator set (the validators who are actively sealing)
The migration validator set, which is the new set we migrate to in case of a change (validator addition or removal).
Validator States
Validators and potential validators have four states in these contracts:
Activevalidator: Validator is in the active validator set, sealing new blocks
Not a validator: The address nothing has to do with validation.
Pending To Be Added Validator: Validator is already added by the owner and their acceptance is pending, but not active yet until it is finalized. This implies that the validator cannot report, be reported, or produce blocks yet.
Reporting
The RelayedSet contract logs malicious or benign reports by emitting corresponding log events that can be seen by anyone. Reporting can only be on and about active sealing validators.
The events contain the reporter- and reported address, and the block number which the validator was reported on.
Interaction with RelayedSet (logic) Contract
Callable functions
Events you can listen to, in addition to report events:
Interaction with Relay Contract
Callable functions
Events you can listen to:
Disconnecting an operator account
To disconnect, click on the operator address located on the top-right of the screen and then click on the disconnect icon as highlighted below:
Once disconnected, you will no longer able to use certain features, such as lifting, lowering or subscribing
Disconnect Wallet
Checking $stEWT balance
Your total $stEWT balance of the currently connected EWX account is available on the left panel of the Marketplace app or at the account dialog on the upper right corner of the screen.
Total $stEWT balance
Submit KYC Details
Complete Your KYC Verification - Step by Step Guide
Welcome! This guide will help you complete your KYC (Know Your Customer) verification. Don't worry - we'll walk you through every step.
What is KYC? KYC is a simple identity check that helps keep the platform safe for everyone. It's quick and easy to complete.
How Did You Get Here?
There are two ways you might have arrived at this page. Don't worry - we'll show you exactly what to do for both!
Option 1: You Came Here Directly
You typed in the website address yourself or clicked a direct link.
What you'll need to do:
Choose your solution group
Enter your email
Connect your wallet
Submit your information
Option 2: You Came from a Marketplace
You clicked a link from another app (like a Marketplace).
Good news! Some information is already filled in for you, and you don't need to connect your wallet - it's already done!
What you'll need to do:
Enter your email
Submit your information
That's it! Much simpler, right?
If You Came Here Directly
Follow these simple steps:
Step 1: Open the Page
When the page loads, you'll see a form that says "Add your details".
You'll see:
A form with the title "Add your details"
A dropdown menu for "Solution Group" (it will be empty)
A box for your email (it will be empty)
A button at the bottom that says "Connect Wallet"
Step 2: Choose Your Solution Group
Click on the "Solution Group" dropdown menu. A list will appear.
What to do:
Look through the list
Click on the option that matches your situation
The list will close and your choice will appear in the box
Step 3: Enter Your Email Address
Click in the "Email" box and type your email address.
Important tips:
Make sure you type it correctly - you'll need to receive emails at this address
Double-check for typos before moving on
Use an email address you check regularly
Step 4: Connect Your Wallet
Click the "Connect Wallet" button at the bottom of the form.
What happens: A popup window will appear showing different wallet options. You'll see wallets like:
Polkadot{.js}
SubWallet
Talisman
WalletConnect
How to connect:
Look through the list and find your wallet
If you don't see it, scroll down - there are more options under "More"
Click on your wallet
Your wallet app will ask you to approve the connection - click "Approve" or "Connect"
Don't have a wallet? You'll need to install one first. Look for wallet extensions in your browser's extension store.
Step 5: Submit Your Information
After your wallet is connected, you'll see a "Submit" button. Click it!
What happens:
You'll see a message that says "Submitting Details..."
You need to sign a message (your EWX address) - as an ownership challenge
Please wait - this usually takes just a few seconds
Don't close the page while it's processing
Step 6: See Your Results
You'll see one of two messages:
✅ If it worked:
You'll see: "Details Submitted Successfully"
The message will tell you to check your email for the next steps
Click "Back to Home" when you're ready
Important:
❌ If something went wrong:
You'll see an error message explaining what happened
Click "Retry" to try again
If you see "Verification Already Ongoing", click "Resend Link" to get a new email
If You Came from a Marketplace
Great news - this is even easier! Follow these steps:
Step 1: Check the Form
When you arrive, some information is already filled in for you.
You'll see:
The "Solution Group" is already filled in (you can't change it - that's normal!)
The "Email" box is empty - you need to fill this in
The button at the bottom says "Submit" (not "Connect Wallet")
Remember: You don't need to connect your wallet - it's already done for you!
Step 2: Enter Your Email
Click in the "Email" box and type your email address.
Make sure:
You type it correctly
You use an email address you check regularly
You double-check for any typos
Step 3: Submit Your Information
Click the "Submit" button.
What happens:
You'll see "Submitting Details..."
Wait a few seconds - don't close the page
You'll see a success message when it's done
Step 4: See Your Results
You'll see one of two messages:
✅ If it worked:
You'll see: "Details Submitted Successfully"
Click "Back to Home" when you're ready
Important: Check your email inbox - you'll receive an email with a link to continue
❌ If something went wrong:
You'll see an error message
Click "Retry" to try again
If you see "Verification Already Ongoing", click "Resend Link"
What Happens Next?
After you successfully submit your information, here's what happens:
Step 1: Check Your Email
Within a few minutes, you'll receive an email with a link to continue your verification.
What to do:
Open your email inbox
Check your spam or junk folder if you don't see it right away
Look for an email about KYC verification
Click the link in the email
Can't find the email? Don't worry - sometimes emails take a few minutes to arrive. Check again in 5-10 minutes.
Step 2: Complete Your Identity Verification
When you click the link, you'll go to a verification website called SumSub.
What you'll need to do:
Follow the instructions on the screen
You'll need to take photos of:
Your government ID (like a driver's license or passport)
How long does this take?
Taking the photos: Just a few minutes
Getting approved: Usually a few hours to a few days (they need to check your documents)
Don't worry if it takes a while - this is normal! They're making sure everything is correct.
Step 3: Get Your Approval Email
Once your verification is approved, you'll receive another email.
This email will tell you:
That your verification was successful
Important information about your account
A link to go back to the marketplace
What to do:
Click the link in the email
You'll return to the marketplace
You're all set! You can now use the marketplace with your verified account
Messages You Might See
Here are some messages you might see and what they mean:
"Submitting Details..."
This means your information is being sent
Please wait - don't close the page
This usually takes just a few seconds
"Details Submitted Successfully"
Great! Everything worked
Check your email for the next step
You're doing great!
"Submission Failed"
Something went wrong, but don't worry
Read the message - it will tell you what happened
You can try again by clicking "Retry"
"Resending Verification Link..."
A new email is being sent to you
Check your inbox in a few minutes
"Verification Link Resent"
Your new email has been sent
Check your inbox (and spam folder)
Wallet Connection Messages
Your wallet might ask you to sign something
This is normal and safe
Just follow the prompts in your wallet
Common Questions
Why can't I change the Solution Group?
If you came from a marketplace, the Solution Group is automatically set for you. This makes sure you're using the right settings. You can't change it, and that's okay - it's supposed to be that way!
Do I need to connect my wallet?
It depends how you got here:
Came from a marketplace? No! Your wallet is already connected. Just enter your email and submit.
Came here directly? Yes, you need to connect your wallet. Click "Connect Wallet" and choose your wallet from the list.
Why is the Submit button grayed out?
The Submit button only works when everything is ready:
You've chosen a Solution Group (or it's already filled in)
You've entered your email address
Your wallet is connected (only if you came here directly)
Make sure all the boxes are filled in correctly!
What happens after I submit?
Here's the simple version:
You submit your information ✅
You get an email with a link to verify your identity 📧
You click the link and take photos of your ID and yourself 📸
That's it! The whole process usually takes a few days from start to finish.
Having Problems? We Can Help!
The form won't submit
Try these things:
Check your email - Is it typed correctly? It should look like: [email protected]
Check the Solution Group - Did you choose one? (Or is it already filled in?)
Check your wallet - Is it connected? (Only needed if you came here directly)
I can't connect my wallet
Try these solutions:
Do you have a wallet? You need to install a wallet extension first
Is your wallet unlocked? Make sure your wallet is open and unlocked
Try refreshing the page - Sometimes this helps
I see an error message
Don't panic! Here's what to do:
Read the message - It will tell you what went wrong
Look for a "Retry" button - Click it to try again
Look for a "Resend Link" button - Click it to get a new email
I didn't receive the email
Try these steps:
Check your spam folder - Sometimes emails end up there
Wait a few minutes - Emails can be delayed
Check your email address - Did you type it correctly?
I made a mistake in my email address
No problem! Here's what to do:
Go back to the form (either directly or from the marketplace)
Fill everything out again with the correct email:
Choose your Solution Group (or it will be pre-filled)
Tip: Double-check your email address before clicking Submit to avoid this!
Can I change my email after submitting?
Unfortunately, no. Once you submit, you can't change your email. If you need to use a different email, you'll need to start the process over with the correct email address.
I don't see the SumSub verification email
Try these steps:
Check your spam folder - It might be there
Wait 5-10 minutes - Emails can be delayed
Check your email address - Make sure you typed it correctly
I don't see the approval email after completing SumSub
Don't worry - this is normal!
Check your spam folder
Be patient - Approval can take a few business days
Make sure you finished the SumSub verification completely
How long does everything take?
Here's a realistic timeline:
Submitting the form: Just a few seconds
Getting the first email: Usually within a few minutes
Completing SumSub verification: About 5-10 minutes to take the photos
Total time: Usually 1-3 business days from start to finish.
What if my SumSub verification gets rejected?
Don't worry! This happens sometimes. Here's what to do:
Check your email - You'll get an email explaining why
Read the reason - It will tell you what went wrong
Fix the problem - Maybe your photo wasn't clear, or your ID wasn't readable
Can I use the same email more than once?
Yes! You can use the same email address, but each time you submit, it creates a new verification process. If you need to start over, you can submit again with the same email.
Do I have to finish everything in one sitting?
Good news: No, you don't!
The form: Try to complete this in one go
SumSub verification: Do this when you get the email (the link might expire after a while)
Returning to marketplace: Do this when you get the approval email
You can take breaks between steps - just don't wait too long!
I came from a marketplace but don't see the Submit button
Try these things:
Did you enter your email? Make sure the email box has your address in it
Is the Solution Group filled in? It should be - if not, try refreshing
Try refreshing the page - Sometimes this fixes it
Still Need Help?
If you're stuck, try these steps:
Read through this guide again - You might have missed a step
Check any error messages - They usually tell you what's wrong
Try refreshing the page and starting over
Remember: Everyone needs help sometimes. Don't be afraid to ask!
You've Got This! 💪
The KYC process might seem complicated at first, but it's really just a few simple steps:
Fill out the form
Check your email
Take some photos
Wait for approval
This process helps keep everyone safe on the platform. Thank you for taking the time to complete it!
Good luck, and don't hesitate to reach out if you need help! 😊
After Submitting KYC Details
The KYC Verification comes with three (3) statuses:
When KYC verification is in processing phase, the Marketplace app shows the respective status on the screen.
KYC Verification Successful
When KYC verification succeeds, the operator will be whitelisted in the target solution group and will be allowed to subscribe to it. The screen will display the KYC status as "KYC Verified".
To proceed with the subscription process, please refer to page.
For solution groups that enable KYC verification, not everyone is eligible to participate in submitting solution results as votes. In such case, an info icon will be shown in the Dashboard to provide such detail:
KYC Verification Rejected
When KYC verification is rejected, the operator is no longer allowed to subscribe to the target solution group.
Subscribing to a solution group
Prerequisite
Click Opt-in to subscribe to a solution group
If no operator account is connected then "Connect" button will be displayed instead
A pop-up will appear for you to enter your subscription amount. Once you're satisfied with the value, click Continue
You may also use the slider, click on the percentage buttons or "Max" where the app will calculate the amount based on your account balance
Subscription amount must be within min/max subscription amount
Review your subscription amount and click Confirm
Approve the transaction in your wallet
Wait for the transaction being executed
You will see a success message along with the transaction URL to Polkadot explorer
Go to the Dashboard page to view or
For new subscriptions, the worker nodes will only start voting in the next reward period
Topping-up subscription amount
Prerequisites
Find the Top-up button either in Dashboard or Manage subscription
A pop-up will appear, enter your top-up amount in the text field
You may also use the slider or pre-defined buttons that will calculate based on your account balance
Review your top-up amount before clicking on Confirm
Approve the transaction in your wallet
Wait for the transaction being executed
You will see a success message along with the transaction URL to Polkadot explorer
Your subscription amount will be displayed as + <value> as an indicator that the top-up amount will be added to the total subscription in the next reward period
Unsubscribing delay
Some of the solution groups have Unsubscription Delay enabled. This means that unsubscription will only take place after a certain reward period(s).
Solution group with unsubscription delay
You will see the information related to unsubscription delay when you click Opt-in.
Unsubscription delay info
FAQ: Server-based Worker Nodes
FAQ section is ever-growing, to accomodate frequently asked questions gathered by users. If you have some ideas for further information to be included here, please let us know!
Q: Is there an alternative way to bootstrap an operator account rather than using Marketplace App?
Yes, follow these steps to manually create an operator account:
Visit .
Select MAINNET EWX, depending on your use case.
Go to .
As the operator, call the extrinsic
Q: How many Worker Accounts can be assigned to single Operator Account ?
For now, single Operator to Worker account assignment is supported. You can always disconnect previously connected Worker Account and replace it with different one.
Q: Can I switch between Managed/Self-hosted versions of Worker Node ?
Yes, you can switch and move to new Worker any moment. If you dont want to tamper with blockchain-setup you just need to use the same Worker Account Seed in your new Worker. Keep in mind that old Worker Node instance should be stopped right after new one is set up.
Q: Where I can find blockchain explorers for EWX?
You can use or explorer.
Q: Can I move between Launchpad/Marketplace Desktop App based worker/Server Based Worker Node?
Yes, you can move to another type of worker any time you want. The only thing you need is to use the same Worker Account Seed for configuration of your new worker.
Once new worker is set-up turned on on desired platform , please always remember to turn-off previous instance to omit double-voting which can potentially lead to unintended behaviour.
Q: Where and when will I be able to check whether my Worker is voting correctly?
When you subscribe to any Solution Group using your Operator Account linked to Worker Account configured for your Worker, there is a max-24-hours period before any votes from your Worker will be accepted by EWX.
After that time, your worker will start executing Solutions WorkLogic from Solutions that are in Active state in non-expired Solution Groups that your Operator Account is subscribed to.
You should be able to view votes being submitted from your Worker
Q: Are there any limits on Worker Node instances that I can set up?
There is no limit on amount of Worker single user can set-up, but keep in mind that single Operator Account can have only single Worker Account linked
You can set-up multiple Worker Nodes on the same machine if resources are allowing for that.
Single Worker can handle multiple Solution Group subscription and therefore run multiple solutions simultaneously.
Q: Are there any tools where I can find EWX and Worker Nodes related stats?
While there is no official EW-built dashboard, there are several community/partner built dashboards that you can check.
Q: For one solution I see 50 votes while for other only 5 votes that are being casted by my Worker Node per reward period (24-hours), is that normal?
Each solution represent unique logic therefore different quantities of votes could be perfectly normal behaviour to expect.
As business process captured within solution logic is different, therefore also schedules and triggers can be also totally different.
E.g one solution can demand a steady voting every 30 min, while other can have an asynchronous triggers coming from real us of a given app.
Please keep in mind, that system does not reward quantity of voting itself, but rather quantity of votes when votes were needed - meaning it incentives your worker to run 24/7 instead of casting large amount of votes at random times.
Sample Enterprise Use-Cases
Below are some examples of how a Worker Nodes are being used within Projects that EW is conducting with various of partners.
The Green Proofs for Bitcoin (GP4BTC) platform is a solution to bring consistent metrics and much-needed transparency into the climate impacts of individual Bitcoin mining companies so industry stakeholders can make better decisions to align with a net-zero future.
EWC Client Update – OpenEthereum 2.7.2: Significant issues with Parity/OpenEthereum 2.7.2 led validators to downgrade Volta nodes and keep EWC nodes on v2.5.13-stable. No further client updates will proceed until OpenEthereum issues are resolved.
Return how much was minted for an account so far in wei
mintedInBlock(uint256)
Returns how much was minted in certain block in wei
mintedForAccountInBlock(address, uint256)
Returns how much was minted for a certain account in a certain block in wei
communityFundAmount()
Returns the constant payout for the community per block in wei
communityFund()
Returns community fund address
payoutAddresses(address)
Returns an address' payout address
setPayoutAddress(address)
Sets payout address for sender
resetPayoutAddress()
Resets payout address for sender
getBlockReward(uint256)
Returns blockreward amount for a certain block number
checkRewardPeriodEnded()
Returns true if blockreward period has ended (based on blocknumber), false otherwise. The blockreward period right now ends after 10 years. After that no blockrewards or community fund payouts are minted.
Fig. 2.: Discrete inverse S curve use for block rewards. Calculated for a 5 second step size, 10 million ethers total payout over 10 years
Fig. 3.: Community reward distribution.
Pending To Be Removed Validator: Validator is pending to be removed (removed by the owner), but it is not finalized, and so is still active as a validator. This implies that as long as the removal is not finalized, the validator is actively producing blocks, can report and can be reported on.
getMigrationValidators()
Returns the migration validator set. If there are no changes, it returns the same list as getValidators().
getUnion()
Returns the union of current and migration sets. Useful for tracking the statuses of all affected validators in case of an ongoing change
getValidatorsNum()
Returns the number of currently active validators
isPendingToBeAdded(address)
Returns true if address is pending to be added to the active list.
isPendingToBeRemoved(address)
Returns true if address is pending to be removed from the active list.
isPending(address)
Returns true if address is pending to be added or removed.
isActiveValidator(address)
Returns true if address is an active validator, meaning it partakes in producing new blocks. Note that a validator who is pending to be removed is still active.
isFinalizedValidator(address)
Returns true if address is a finalized validator, meaning it is active and NOT pending to be removed either.
Returns true if there are ongoing changes to the active set, false otherwise. If true, implies that current validators list equals migration validators list.
addressStatus(address)
Returns the state of an address, two integers: an integer representing the validator state, and an index value. The index is the position of the validator address in the currentValidators array. It is only relevant if the address is an active validator, should be ignored otherwise.
The validator state mappings are:
NonValidator: 0
Finalized: 1
PendingToBeAdded: 2
PendingToBeRemoved: 3
getValidators()
Returns currently active block producing validators
As the operator, call the extrinsic workerNodePallet.registerWorker, passing the address of your worker.
Finally, as the operator, call the extrinsic workerNodePallet.subscribeOperatorToSolutionGroup. To obtain the group, go to Developer -> Chain state -> workerNodePallet -> solutionsGroups.
In Worker Node logs
In Marketplace App UI after checking details of Solution Groups you subscribed to
By querying EWX chainstate as shown in Picture (Use Operator Address here)
By querying as shown in Screenshot (Use Worker Address here)
In order to better understand the Energy Web Ecosystem, this section provides a high level introduction to the core concepts and terminologies which will be used across this documentation.
Energy Web X
Energy Web X is an ecosystem comprising multiple applications and services including but not limited to the EWX blockchain, EWX Token Bridge, Lift & Lower Pallets, worker nodes, and worker node networks.
EWX is a substrate-based blockchain under EWF. It is the backbone of the entire EWX ecosystem. The EWX Token Bridge is an EWC Smart Contract which facilitates the migration of EWT from EWC to EWX. The lift and lower pallets are equivalent to EVM-based smart contracts which enables the lifting and lowering of EWTs between EWC and EWX.
Token Lifting
Lifting is the process of migrating EWT from EWC to EWX. EWT will be needed by participants to register as worker node operators and to stake to solution groups containing the Smart Flows.
Token Lowering
Lowering is the exact opposite of token lifting. It is the process of migrating EWT from EWX to EWC. Normally, this will be used to withdraw rewards claimed after gaining them by operating worker nodes.
Server-based Worker Node
The server-based worker node is a decentralized application mainly offered to enterprises to be deployed in highly configurable execution environments on-cloud or on-premises. Deployment can be done via Dockerization.
It is mainly composed of the worker node dApp and a Node RED server bundled in a single package. It automatically syncs the subscriptions of the worker node account set in its environment variable and subsequently runs any active solutions for diligent execution and submission of votes.
Reward Period
Reward period is the schedule for worker nodes to participate in vote submissions and gain rewards. The solution registrar defines the duration of reward periods. For example, if rewards are to be paid daily, the reward period needs to be set to a 24-hour estimated equivalent in blocks. Each block is approximately 12 seconds in duration.
Subscription
A subscription is an EWT staking action initiated by the worker node operator to agree and commit in actively participating in executing a group of solutions subject to the solution group’s terms and conditions. In return, the operators expect to gain rewards by diligently performing the solution executions while having the possibility to get slashed when underperforming. The solution registrar sets the stake amounts and other configurations upon the creation of the solution group and solutions.
Voting and Consensus
A vote is initiated upon the submission of the Merkle-tree root hash of the calculated data for each specific use-case. All votes are tied to a voting round.
A voting round is determined by the unique identifier provided by each BC when the Smart Flow fetches the data from the respective BC system for each specific use-case.
For the current implementation, each worker computes the consensus right after its successful submission of a vote in a voting round. The worker fetches the previous vote submissions from EWX under the current voting round. The worker groups the root hashes and counts the submissions from unique operators per unique root hash.
The consensus is determined when a particular root hash contains the majority of submitted votes.
When the majority of votes is not met, the voting round becomes stale and no response coming from the network of worker nodes is expected. However, this scenario may be confirmed externally by directly querying on-chain using a third-party application which will not be available in this phase.
EWF will develop a more robust consensus orchestrator environment and will be available towards Q4 2024. More details will be shared once requirements are finalized at EWF.
InEExS Project Consensus Mechanism
In the case of the InEExS Project, consensus is determined using the formula below:
M = TO * 0.5 + 1
Wherein, M = majority of votes, and TO = Total operators subscribed in the solution group.
XCM Pallet
The XCM Pallet is a critical module in the Polkadot SDK that facilitates Cross-Consensus Messaging (XCM), enabling secure and interoperable communication between different chains. This pallet is fundamental to Polkadot’s interoperability framework, allowing Parachains, relay chains, and other consensus systems to exchange messages and assets seamlessly.
Key functionalities:
Cross-Consensus Communication: Implements a universal messaging protocol for interaction between different consensus systems and allows Parachains and relay chains to send and receive messages reliably, forming the backbone of Polkadot’s interoperability.
Asset Transfer and Management: Supports transferring assets, such as tokens or NFTs, across chains using the XCM protocol.
Instruction Execution: Provides an instruction set for executing operations on remote chains, such as account creation, staking, or governance participation.
Fee Payment and Weight Management: Handles fee payments for executing XCM instructions, ensuring proper incentivization of involved parties.
Assets Pallet
The Assets Pallet is a core component in the Polkadot SDK that provides comprehensive tools for managing and interacting with fungible token assets. This pallet enables the creation, transfer, and governance of assets on-chain, supporting decentralized ecosystems with robust asset functionality.
Key functionalities:
Asset Creation and Registration: Allows users or entities to create new fungible assets with customizable properties such as total supply, name, and metadata. It also enforces administrative roles for managing the lifecycle of assets, including minting and burning.
Asset Transfer and Balances Management: Enables secure and efficient transfer of assets between accounts and tracks account balances for each asset type, with configurable rules for minimum balances and dust handling.
Minting and Burning Mechanisms: Provides authorized administrators the ability to mint new tokens to increase supply or burn tokens to reduce supply. It also ensures precise control over asset supply and its distribution across holders.
Permissioned Operations: Supports a robust permissions system to define administrative roles such as asset owners, issuers, and freezers.
Offences Pallet
The Offences Pallet is a critical component in the Substrate framework designed to detect, record, and manage misbehavior within the network. It ensures the integrity of the system by imposing penalties on validators and other actors who deviate from expected behavior, such as equivocation or inactivity.
Key functionalities:
Misbehavior Detection: Facilitates the detection of offenses, such as double-signing or equivocation, leveraging integrated modules or external monitoring tools while it supports configurable offense types to adapt to specific network requirements and threat models.
Offense Reporting and Recording: Provides a structured mechanism to report misbehavior, with offenses recorded on-chain for transparency and accountability. It also tracks offenders and their associated penalties to discourage repeated violations.
Penalty Enforcement: Imposes penalties on validators or network participants based on the severity and frequency of their offenses. Penalties can include slashing, staking disqualifications, or temporary bans to maintain network integrity.
Historical Tracking: Maintains a history of offenses and their resolutions to enable governance or runtime modules to make informed decisions regarding actors’ reliability. Supports configurable retention policies to manage storage efficiently while preserving essential historical data.
Token-Manager Pallet
The Token-Manager Pallet is designed for managing tokens and handling token operations within a Substrate-based blockchain. This pallet facilitates various features, including secure token transfers, scheduling of token “lowering” operations to Ethereum (tier1), and interaction with external token contracts. It also enables the governance of token-related actions through nonces and proofs, ensuring a seamless operation between blockchain tiers.
Key functionalities:
Token Balance Management: Tracks the balances of individual accounts for different tokens. This allows the management and querying of token balances by specifying the token ID and account ID. Each account’s nonce is tracked, representing the number of transfers conducted, ensuring the integrity of transaction sequences.
Lowering Operations: Supports “lowering” tokens from tier2 to tier1, interfacing with an Ethereum contract. This operation can be executed directly or scheduled for later execution. Lowering operations require confirmations and signatures, with proof requirements verified before sending transactions, ensuring secure, authenticated transfers.
Proof and Transaction Management: Handles proofs for token transfers, including the ability to regenerate proofs for pending or failed lower transactions. Stores and retrieves data about lower transactions in various states: ready-to-claim, pending, and failed, providing robust tracking and error recovery mechanisms.
Ethereum-events pallet
The Ethereum-events pallet handles the management of Ethereum events and their processing within the blockchain environment. It supports tracking event submissions, validation, and challenges while providing secure mechanisms for event processing and recording.
Key functionalities:
Event Tracking and Management: Efficiently tracks and manages Ethereum events, including ingress counters, to maintain order and ensure unique identification of events.
Event Validation Pipeline: Handles the lifecycle of Ethereum events from submission to processing, with mechanisms to mark events as unchecked, pending, or processed.
Challenge and Validation System: Allows validators to challenge event validity, enforcing quorum-based decision-making for robust and decentralized validation.
Event Integrity Protection: Ensures that events cannot be processed more than once, maintaining a consistent and secure state in the blockchain’s event records.
The Marketplace App
The Marketplace App is a decentralized desktop application which provides an intuitive interface for the general community having limited technical background to easily participate in running worker nodes on their local machines.
It supports Windows, MacOS, and Ubuntu systems.
Download and Installation
Download and install the Marketplace app on your machine from the download links provided in the official EWX Website.
Funding an operator account
Funding an operator account requires liquid tokens called $stEWT. To acquire $stEWT, please follow the steps described in the Liquid stake to get $stEWTsection.
Your operator account balance will be displayed on the left panel and also in the popover menu when you click on your operator address
Operator account balance
Collator Off-boarding FAQ
Disclaimer: Energy Web is not responsible for individual staking decisions, including staking, unstaking, or taking no action, in relation to collator onboarding, offboarding, or growth events.
1. Will delegators receive rewards from a collator they are delegating to, if said collator is deregistered before a growth event?
No. If a collator is deregistered before the growth snapshot, neither the collator nor its delegators will receive rewards for that growth period, even if the collator had already accrued points earlier in the period. Reward eligibility is determined at the growth snapshot, and collators must still be active at that point to be included.
Worker Nodes and Worker Node Networks
A worker node is a decentralized application (dApp) which enables enterprises to construct distributed computing networks which securely execute sensitive business operations. Each worker node can execute multiple solutions at the same time; subject to the limits of each operator system.
Worker nodes were originally developed to solve a paradox that hinders advanced renewable energy tracking solutions like 24x7 matching and green electric vehicle charging: credibility relies on accurate, publicly verifiable results (e.g., proof that digital representations of renewables are not double counted). But inputs from separate organizations, such as granular renewable energy production and electricity demand data, are commercially sensitive and need to remain private. Complex commercial, legal, and technical requirements often make it challenging for a single actor to unilaterally access and process all requisite data. The ability to establish a shared source of truth from segregated, individual information sources has been an ongoing challenge in multilateral settings; the challenge is even greater for energy market participants seeking to exchange and process granular data to procure services from distributed energy resources.
The Energy Web Worker Node toolkit solves these challenges by enabling enterprises to configure, launch, and maintain distributed computing networks that ingest data from external sources, execute custom workflows based on business logic, and vote on results in order to establish consensus without revealing or modifying the underlying data. Worker Nodes apply concepts and components from blockchain technology in a novel, enterprise-friendly architecture to provide all stakeholders with cryptographic proof that mutually agreed rules and processes are followed correctly, ensure computational outputs from business processes are correct, and preserve the privacy and integrity of underlying data for auditing purposes.
System Architecture
The Energy Web Chain is comprised of different components that provide the functionalities determined by the blockchain’s protocol.
Broadly speaking, protocols are defined rules and standards. Internet protocols, like HTTP protocol for example, define standard procedures for the transfer of data over the internet.
A blockchain network is no different. In a decentralized and self-executing system like a public blockchain, protocols are of significant importance in establishing how the system works, and then ensuring that the system continues to self-execute as designed.
Protocols exist to determine specific aspects of blockchain behavior, such as:
How transactions are validated
Linking a worker account to an operator account
Before your worker node is able to cast votes, your worker account needs to be linked to an operator account first. This is a one-time step only and you will not be prompted to link again in the future (unless it's being unlinked).
Prerequisites
FAQ: Marketplace App
Lifting & Lowering
What is lifting?
Lifting is the process of migrating EWTs from Energy Web Chain (EWC) to Energy Web X (EWX).
Energy Web Chain Governance & Validators
Learn about the EWC Governance and the role of Validators in depth in our .
Eth-Bridge Pallet
The Eth-Bridge Pallet is a component responsible for facilitating interactions between a Substrate-based blockchain and an Ethereum-based network. It implements the BridgeInterface and provides functionality for publishing transactions and generating lower proofs. This enables other pallets that implement BridgeInterfaceNotification to execute functions on the Ethereum-based smart contract or request proofs for token operations.
Key functionalities:
Transaction Publishing and Management: Accepts and processes transaction requests from external pallets, handling them sequentially to ensure that they are executed in the order they are received. Publishes transactions by packaging and encoding them to be compatible with Ethereum, complete with timestamps and unique transaction IDs to track and verify their status.
SAFc
SAFc is an innovative system designed to promote the adoption of Sustainable Aviation Fuel (SAF) by issuing and managing SAF certificates. These certificates serve as verifiable proof that a specific volume of SAF has been produced or utilized, ensuring transparency and accountability in the aviation industry's transition to greener fuels.
Preimages Pallet
The Preimages Pallet is a specialized component in the Substrate runtime that facilitates the storage, retrieval, and management of large data blobs (preimages) on-chain. It is particularly useful for governance and other modules requiring access to detailed proposals or large datasets while minimizing storage costs.
Key functionalities:
Efficient Storage of Preimages: Allows users to submit and store large preimage data off-chain initially, ensuring cost-effective on-chain storage.
Avn Pallet
The Avn Pallet provides functionality that is common for other pallets such as handling offchain worker validations, managing a list of validator accounts and their signing keys.
Key functionalities:
Validator List: Maintains a list of active validators, each represented by an address and a cryptographic key.
Bridge Contract Address
KYC Verification
Some solution groups published in the Energy Web X ecosystem require operators to submit KYC details for verification before they are allowed to subscribe.
This section provides step by step processes in the KYC verification.
Green Proofs for Electrical Vehicles (GP4EV)
The Green Proofs for EVs (GP4EV) system plays a crucial role in ensuring that electric vehicle (EV) charging is green by managing and verifying green certificates for each charging session. All the data sent to workers in this process originates from the Green Proofs application, which transforms this data into operations like issuing, transferring, or retiring certificates.
Green Proofs as a Service (GPSaaS)
The Green Proofs system ensures that energy usage is verified as green by managing and validating green certificates for various energy operations. All data sent to workers originates from the Green Proofs application, which transforms it into operations like issuing, transferring, or retiring certificates.
Green Proofs
Learn about Energy Web's different Green Proofs solutions in our devoted section on .
Creating an EWC account
To create an EWC account, first choose your preferred wallet by either downloading the app or using Ledger (via ). Alternatively, you also may refer to our interactive guide .
Create a new account with seed phrase
Save the seed phrase somewhere safe and verify
Deployment Guide
There are two options on how to deploy your Worker Node:
If you would like to run Worker Node in fully managed (SaaS) or in Bring your own cloud (BYOC) mode, please our Worker Node offering.
Please refer toDocumentation for full details.
Alternatively If you would like to use open-sourced version, please follow instructions covered in .
Delegators wishing to maximise rewards should ensure they re-delegate their stake to an active collator prior to a growth snapshot. Alternatively, they can stake through liquid staking and have the pallet manage reallocations automatically (see Q3 below).
2. What happens if I don’t unstake before a collator I’m delegating to is deregistered?
You do not need to take any action. Once the collator is deregistered, all delegations to that collator are automatically unlocked in the accounts of the delegators.
3. What happens to liquid staking when a collator is deregistered?
Any stake delegated by the Liquid Staking pallet to a deregistered collator is automatically reallocated.
During the next restake phase, those tokens are restaked to another collator in the WhitelistedCollators set, specifically the collator with the lowest total stake, ensuring balanced distribution. Liquid staking users do not need to take any action.
4. How will I know if a collator has been deregistered?
Collator status changes are reflected by querying chain-state via Polkadot.JS, listening to on-chain events, and are displayed in collator dashboards on SubScan and various community run sites.
Furthermore, Energy Web aims to communicate any deregistration events in advance to the community so appropriate action can be taken.
5. What if my collator goes offline but is not yet deregistered?
The aim is to have all collators who wish to deregister, deregistered prior to going offline.
An offline collator that remains registered would be eligible for rewards if they are registered and have accrued points at the time of the growth snapshot. Note that inactivity and poor performance would reduce points and therefore rewards.
Delegators who prefer not to wait can re-delegate at any time. If the collator is later deregistered, the process described in above answers applies.
6. Can a deregistered collator rejoin the network later?
Yes. A collator that has been deregistered may reapply and be onboarded again in the future, subject to seat availability and the collator onboarding and governance process. The collator would onboard with a new Collator address. Previous delegations are not automatically restored.
Currently, there are 2 types of worker nodes available:
Server-based Worker Node
Marketplace Desktop Application
Who gets to validate transactions and when
How validators are compensated
How peer nodes interact with each other
The system components below ensure that the Energy Web blockchain adheres to Ethereum's protocols, and the protocols established by OpenEthereum's Proof-of-Authority consensus engine. (OpenEthereum is the Ethereum client that is used by the Energy Web Chain.
The validator node architecture monitors validator behavior to ensure consistent and secure blockchain operation. Read more about the validator node architecture here.
How long does it take to reflect my lifted EWT to my account?
Lifted tokens take approximately 30 minutes to reflect in your EWX account after successful transaction from the Marketplace app.
What is lowering?
Lowering is the process of migrating EWTs from Energy Web X (EWX) to Energy Web Chain (EWC).
How long does it take to reflect my lowered EWT to my account?
Lowered tokens take approximately 24 hours to reflect in your EWC account after successful transaction from the Marketplace app.
Consensus and Confirmation Collection: Manages the collection of ECDSA confirmations from authors to prove consensus for a transaction, ensuring that all required signatures are gathered before submission. Utilizes a confirmation system where authors can add their confirmations until the required threshold is met, after which the transaction is ready to be dispatched to Ethereum.
Dispatching Transactions to Ethereum: Appoints an author responsible for sending a transaction to Ethereum once sufficient confirmations have been collected.
On-Chain and Off-Chain Coordination: Integrates with off-chain workers (OCWs) to monitor unresolved transactions and prompt authors to act as needed. It also alerts the originating pallet with the outcome of a transaction through the BridgeInterfaceNotification callback, enabling state commitment or rollback based on the results.
On-Demand Retrieval: Enables on-chain modules, such as governance proposals, to reference and retrieve preimages only when they need to be executed or evaluated.
Preimage Validation: Includes a framework to validate and verify the integrity of preimages against hashes before use and ensures that the preimage data corresponds accurately to its referenced hash.
Access and Ownership Control: Supports fine-grained access controls, ensuring only authorized entities can submit or clear preimages and allows multiple modules and users to leverage preimages securely without conflict.
: Stores the address of an associated bridge contract on the Ethereum network.
Off-Chain Worker Integration: Provides mechanisms for off-chain workers to run only once per block to avoid duplicate operations. Includes functionality for interacting with external services for retrieving finalized blocks and requesting signatures.
Signature Verification: Offers tools to validate Ethereum ECDSA signatures, ensuring that signatures are produced by known validators.
The Marketplace App requires some $EWT on EWX chain. To acquire it, simply bridge $EWT either from EWC or ETH chains to EWX chain. Follow the steps described in Bridging $EWT using the Energy Web X Bridging Web App.
Energy Web Chain
The Energy Web Chain (EWC) is a publicly-accessible EVM-based blockchain formed as a software infrastructure with permissioned validators hosted by EWF Affiliate organizations. It relies on a Proof-of-Authority consensus mechanism with capacity for a 30x performance improvement and 2-3 orders of magnitude lower energy consumption compared to Ethereum.
Connected worker account
Click Enable Solution Group either from Dashboard or Manage Subscription page
Enable Solution Group in Dashboard
Enable Solution Group in Manage Subscription
Read through the important information regarding participating into a worker node network. Click Continue to proceed or Dashboard to cancel
Participate into worker node network message
Click Continue to proceed
Proceed to connect worker account
Approve the transaction in your wallet
Pending confirmation
Wait for the transaction to finish execution
Executing transaction
Once you see the transaction successful message, your worker account and operator account are now linked 🔗
Link worker transaction successful
Energy Web Chain
The Energy Web Chain (EWC) is an open-source, public blockchain derived from Ethereum blockchain technology. It is the foundational trust and persistence layer of EW-DOS.
The blockchain performs three key functions in EW-DOS:
Facilitates on-chain verification and transactions between parties
Executes smart contracts that are used by EW-DOS's decentralized applications, SDKs and utility packages.
You can read more about the Proof-of-Authority consensus mechanism .
The blockchain provides trust in several ways that allow for a decentralized system that is self-executing and without central authority or oversight of on-chain transactions:
The data in each block is immutable and unchangeable. Each is linked to the previous block by a cryptographically created hash. If one block is tampered with, the hash of every subsequent block in the chain would be need to be updated. Because Validators' consensus is required to create new blocks, a block with an alternative transaction history would be rejected by Validators.
Smart contracts provide automated logic for on-chain actions. Transactions on the chain are governed by code called that contain explicit logic and requirements for actions to occur. When specific conditions are met, the code will self-execute. Once a smart contract is deployed on the blockchain, it cannot be changed or reversed, removing the risk that anyone can update the logic of the contract for personal gain.
Persistence on the Energy Web Chain
The Energy Web Chain stores the following information:
Smart contracts for that are created through EW-DOS's identity and access management library.
Smart contracts that govern validator consensus behavior and remuneration. These are known as .
Smart contracts that implement other Ethereum network protocols, such as permissioning and protocols.
If you're not familiar with Smart Contracts, you can read Ethereum's introduction to smart contracts .
You can see a list of repositories containing EW-DOS smart contracts .
Energy Web Tokens
The Energy Web Chain native token
What is the Energy Web Token?
The Energy Web Token (EWT) is the native utility token of the Energy Web Decentralized Operating System (EW-DOS). Tokens are used in EW-DOS to pay for gas fees on the Energy Web Chain, and for staking to secure the Energy Web X blockchain as well as Worker Node Networks. You will need EWT in your digital wallet (we recommend using MetaMask) if you want to make transactions or use applications or smart contracts that are deployed on the Energy Web Chain main network.
EWT on the Energy Web Chain
Like other public blockchains, the Energy Web Chain uses EWT as a utility token to access services and orchestrate stakeholders within its blockchain system. In the context of the Energy Web Chain, EWT compensate validators for processing transactions, and are used to pay for transactions - for example, registering a new asset or organization in .
Utility tokens like EWT are different from other digital assets in the blockchain sphere such as coins, non-fungible tokens, and stablecoins. To learn more about the distinctions between these assets, see this article, .
EWT on Energy Web X
Energy Web X will leverage and complement the existing Energy Web Chain by introducing new technical capabilities that streamline the deployment and operation of .
To maximize the security of every Energy Web solution using worker nodes, EWT will be required to interact with worker nodes and Energy Web X. Most notably, Energy Web Tokens will be required to:
Reward worker node networks: worker nodes are software packages that need to be run by individuals and/or businesses. In order to attract entities to run worker nodes, enterprises will need to include rewards, paid in EWT, that compensate worker node operators for their work.
Operate worker nodes: in order to become a trusted party to run worker nodes, individuals and/or businesses will be required to stake EWT. Staking requirements and reward schedules are mass customizable—enterprises launching worker node networks can configure different thresholds and award schedules at their discretion.
Validate Energy Web X: Energy Web X validators will need to stake a significant number of Energy Web Tokens in order to become validators on Energy Web X.
For clarity, instead of launching a new token with the Energy Web X blockchain, Energy Web X will be powered by the existing or EWT. Users have the ability to “lift” Energy Web Tokens from the existing Energy Web Chain onto Energy Web X. Lifted Energy Web Tokens can then be used for the functions described above. With this mechanism in place, EWT holders will be able to “lower” Energy Web Tokens back to the main Energy Web Chain at their discretion. Over time, token holders will be able to lower EWT to other layer one blockchains (for example, main net Ethereum) making Energy Web solutions interoperable with any blockchain ecosystem.
Get EWT
You can buy EWT on any of the exchanges listed . You can also bridge EWTB ERC20 tokens acquired on Ethereum mainnet back to EW Chain by .
Additional Resources:
****
EWX: Architecture
Each set of worker nodes deployed by Energy Web, Energy Web customers of any energy enterprise is governed and anchored to unique pallets on Energy Web X(in traditional Web 3 language a pallet on a substrate-based blockchain is similar to a smart contract on an EVM but more powerful and flexible). Whit this architecture in place, Energy Web has. scalable way to launch worker nodes.
In the context of Energy Web X (EWX) and Substrate, a pallet is a modular, reusable component that defines specific blockchain functionality. Pallets are a foundational concept in Substrate, the framework on which EWX is built. They are similar to smart contracts in Ethereum-based systems but are more powerful and flexible due to their deep integration with the blockchain’s runtime. Each pallet is essentially a code module written in Rust that encapsulates logic for particular features such as token transfers, governance, staking, or custom business logic. In EWX, pallets are used to govern and anchor the behavior of worker nodes, manage rewards, enforce rules for participation, and ensure secure, transparent computation results. By leveraging pallets, EWX provides a highly customizable and efficient environment where enterprises can deploy solutions tailored to their unique needs, with strong on-chain governance and interoperability. These pallets form the building blocks of the blockchain runtime, enabling a scalable and robust ecosystem for Energy Web’s use cases.
Energy Web X’s purpose is to introduce new technical capabilities, leverage and complement the existing Energy Web Chain. To maximize the security of every Energy Web solution using worker nodes, EWT wis required to interact with worker nodes and Energy Web X that can be “lifted” from EWC to EWX and “lowered” back to EWC from EWX.
Worker Nodes are sofware packages that need to be run by individuals and/or businesses. In order to attract entities to run worker nodes, enterprises need to include rewards that pay worker node operator for performing their work. All worker node rewards are paid out in EWT.
Worker Nodes are sofware packages that need to be run by individuals and/or businesses. In order to attract entities to run worker nodes, enterprises need to include rewards that pay worker node operator for performing their work. All worker node rewards are paid out in EWT.
In order to become a trusted part and run worker nodes, individuals and/or businesses require to lock EWT. Enterprises launching worker node networks can configure different thresholds and award schedules at their discretion.
In Energy Web X, solutions represent business applications or use cases that are implemented through worker node networks. These solutions can be grouped into solution groups, which define shared governance parameters, reward structures, and operational criteria. Solution groups are crucial for aligning the behavior of worker nodes across similar or related solutions.
The lifetime of a solution group is configurable, allowing enterprises to set specific timeframes during which worker nodes can participate and earn rewards. Solution groups also allow flexibility: their lifetimes can be extended to accommodate ongoing or evolving business needs, and their reward structures can be raised to incentivize higher performance or attract more participants. This dynamic lifetime and reward management ensure that worker nodes are continually aligned with the goals of the enterprises that rely on them.
Solutions and solution groups establish the configuration that governs how worker node submissions are evaluated and consensus is reached on-chain. This configuration includes eligibility requirements, service-level expectations, and thresholds for agreeing on the correctness of off-chain computed results. By leveraging these configurable parameters, Energy Web X ensures a robust and secure consensus mechanism that validates and anchors the outputs of decentralized off-chain computations. This process is critical to maintaining trust and accuracy across all solutions powered by worker nodes.
EnergyWebX SmartFlow: The First Truly Decentralized SLA
SLAs today rely on trust, manual verification, and centralized enforcement—leading to disputes, inefficiencies, and unnecessary costs. Worse, they ignore sustainability.
EnergyWebX SmartFlow is the first truly Decentralized SLA. Enterprises can now automate, enforce, and verify SLAs in a way that is trustless, transparent, and climate-conscious:
Set performance, uptime, and honesty thresholds—enforced on-chain
Unlock payments ONLY when SLAs are met
Eliminate disputes—SLA compliance recorded & validated on-chain
Define a Carbon SLA—setting a maximum carbon footprint for ESG reporting
With EnergyWebX SmartFlow there is no middlemen, no disputes, no unverifiable claims. Just real-time, automated, and verifiably green SLAs.
Enterprises are already integrating SmartFlow worker nodes into their solutions. .
Exporting worker account
Prerequisites
Click on Export Account located on the left panel of your Dashboard page
Click Confirm to reveal the worker account mnemonic
Enter your password and click Continue
Click on Backup Mnemonic to backup as file or Close to close the pop-up
Importing worker account
Prerequisites
Click on Set Worker Account on the left panel located under Total EWT Balance in your Dashboard
Click Next (with default to "In this machine") to proceed
Click Import Seed Phrase
Open your mnemonic backup file and copy the contents. Then, click on Paste from clipboard and click Continue
Enter password and re-enter it again for verification before clicking on Import Worker Node Account
Once completed, a success message will be shown
Proof-of-Authority Consensus Mechanism
In a centralized system, such as a bank or a broker, a designated authority or central operating system would be in charge of adding transactions or information to the system, making sure that each transaction is trustworthy, up to date with the whole system, and does not duplicate previous transactions.
In contrast, public blockchains are decentralized, peer-to-peer systems that have no central authority or oversight like this. Designated actors are responsible for processing transactions, creating new blocks and maintaining the integrity and history of previous blocks.
The system for determining these actors and how they are selected is called a consensus mechanism. These mechanisms determine the process of who can confirm transactions and create new blocks on the blockchain and the protocol for how they do so. Because there is no central oversight, consensus needs to be designed in a way that prevents or disincentivizes malicious or uninformed actors from corrupting the integrity of the chain.
There are many consensus algorithms. You may have heard of some widely used ones like Proof-of-Work or Proof-of-Stake. Each mechanism has its own way of determining who is eligible to process transactions and create new blocks, and how how actors are selected to do so.
The Energy Web Chain uses the Proof-of-Authority (PoA) consensus mechanism.
All consensus mechanisms have disadvantages and advantages and are chosen based on the purpose and use case of the blockchain it will be serving.
Creating a worker account
Prerequisite
Click on Set Worker Account on the left panel located under Total EWT Balance in your Dashboard
Click Next (with default to "In this machine") to proceed
Click Generate account
Click Confirm
Create a password and re-enter it for verification. Click Create Worker Node Account. You will be prompted to enter this password during app start up in order to unlock your worker account
Click Backup Mnemonic and store the file somewhere safe before clicking on Continue
Verify the mnemonic based on your backup file in the next screen and click Continue
Congratulations, your worker account is successfully created 🎉
Delegated Staking on Energy Web X
What is Delegated Staking?
Delegated staking allows $EWT holders to directly participate in securing the Energy Web X network by nominating (delegating stake to) active collator candidates. In return, delegators share in block production rewards and network growth rewards generated by the underlying staking system.
Delegated staking involves direct interaction with the Parachain Staking Pallet, whereby in the staking call the user must select a collator candidate and amount of $EWT.
Unlike staking through the Liquid Staking Pallet he staked balance becomes locked and non-transferable.
How Delegated Staking Works on EWX
Energy Web X uses the Parachain Staking Pallet to govern network security, growth and reward distribution.
The Delegated Staking Flow:
Users Delegate Stake to Collators
For each stake delegation, delegators choose a collator from the candidate pool with which to bond their $EWT, this is called a nomination.
Each nomination increases the collator's total stake.
Token holders can perform delegated staking either through the , within supported third-party wallets, or through .
Subscriptions
Start earning rewards by subscribing to any of the solution group available on Marketplace. Browse through the solution group list on the Discover page, and pick on a solution group of your interest to see its details such as minimum/maximum subscription amount, base reward, active solution group reward and more.
Solution group requirements
Guides available for subscriptions:
FAQs
What does subscription with withdrawal delay means?
Withdrawal delay means that unsubscription will only take place after a certain number of blocks are processed. During that delay, your worker node will continue running. Read more here:
I want to subscribe to a solution group but it’s showing “expired”. What does “expired” means?
It means that the the subscription period has ended. If you've subscribed to a solution group that is expired, then you will see Expired status displayed next to its name in the Dashboard.
I want to subscribe to a solution group but it’s showing “private”. What does “private” means?
It means that the solution group only allow whitelisted operators to subscribe.
Is there any limit for subscription and top up token amount?
Yes, you can check the limit in the solution group's requirements.
Staking On Energy Web X
Energy Web X (EWX) operates on a Proof-of-Stake (PoS) consensus mechanism, where participants secure the network and earn rewards by staking the native Energy Web Token ($EWT).
Staking aligns the incentives of token holders with the long-term stability and performance of the network, ensuring that those who contribute resources and maintain uptime are rewarded proportionally.
On EWX, collators produce blocks and maintain parachain consensus, while delegators support them by staking their $EWT. Rewards are distributed at the end of each growth period based on collator performance and the relative amount of stake.
Validators (collators) must meet minimum self-stake and performance requirements to remain active, while delegators can nominate trusted collators to share in their rewards. The network automatically adjusts staking pools and reward allocations to maintain fairness and decentralization.
Staking on EWX not only helps secure the network but also powers the economic engine behind its Verified Compute (formerly Worker Node Network) ecosystem, ensuring reliable, transparent, and incentive-aligned participation across Energy Web’s decentralized infrastructure.
Energy Web X supports two methods for token holders to stake their $EWT and contribute to network Security:
and;
.
With delegated staking, users stake their $EWT directly with the Parachain Staking Pallet by selecting one or more collator candidates. The staked tokens are locked and non-transferable, and users earn rewards proportional to their share of each nominated collator’s total stake.
Liquid staking allows users to deposit $EWT into a pooled staking system managed by the Liquid Staking Pallet, which stakes the combined funds across a curated set of collators. In return, users receive stEWT, a liquid, transferable voucher token whose value increases over time through the exchange rate as staking rewards compound.
Delegated Staking with the Energy Web X Staking Web App
🎬 Video Walkthrough
Flow 1: Delegating Stake
Connect your wallet (e.g. SubWallet, Nova Wallet, or Polkadot.js) to the EWX Staking App.
Select a collator you wish to delegate to from the available list.
Enter the amount of EWT you want to stake.
Review and sign the transaction with your connected wallet.
Once confirmed, your delegation will appear under your active staking positions.
Flow 2 – Increasing Stake
Select a collator you’ve already delegated to and wish to increase your stake with.
Enter the additional amount of EWT to increase your staking position.
Click Increase Stake, then confirm and sign the transaction using your wallet.
Flow 3 – Unstaking
Navigate to the Unstake tab.
Select the collator from which you want to unstake.
Confirm and sign the transaction in your wallet.
Creating an operator account
Sign up as an operator
Prerequisites
Select any of the solution group that is available for subscription and click Opt-in
Enter the name you desired for your operator account in the text field, select country of residence and then hit Continue
Confirm the transaction in your wallet
Once approved, wait for the transaction to be executed
You will see a success message along with the transaction URL to Polkadot explorer. Your operator account is now registered 🥳
Server-based Worker Nodes
What is a Worker Node?
A Worker Node is a lightweight off-chain processing unit with an ability to execute business logic in a form of NodeRed flow file.
A Worker Node executing logic can actively contribute in meaningful way to range of use cases. Examples can be found here: Worker Node Usage Use Cases.
Worker Nodes functionalities and EWX blockchain connection enable transparency and verification capabilities for your system. Additionally, thanks to its lightweight architecture, worker nodes are perfectly suitable and a good fit for applications that require decentralized execution components.
How can it be used?
Worker Node, apart from its initial set-up, is entirely controlled by Blockchain based actions. That means that after your initial Worker set-up is completed, no additional changes will be needed.
Blockchain based action controlling Worker Node behavior could be applied via the Marketplace App - an EW built Blockchain Operator UI, or by directly interacting with blockchain.
To understand more about how Worker Nodes can be used, please go to the section.
High level architecture within EWX ecosystem
Below you can find a High Level Architecture to understand how worker node fit into the wider EWX ecosystem.
Server Based Worker Node uniqueness
Server based Worker Node main differentiation is visible when you compare it to the Marketplace Desktop App.
The Marketplace Desktop App contains both Worker Node running engine as well as Blockchain Interaction UI.
For Server based Worker Nodes, the Blockchain Interaction UI was de-coupled from Worker Engine to achieve the best from both sides.
When you would like to use Server Based Worker Node?
You want to have a reliable PROD-level set-up for your Worker Node
You don't want/can't use desktop application for blockchain set-up management/worker engine (e.g. because you don't want to keep your desktop running 24/7)
You anticipate heavier loads to be run on top of your Worker Node
80% (2.0M EWT) → Growth rewards for collators & delegators
20% (0.5M EWT) → Community Fund Treasury
Reward Calculation Flow:
Performance-based allocation: Rewards per era are distributed to collators proportional to their points (blocks authored, equivocation handling, etc.).
Reward payout delay:2 eras after the end of reward period.
Transaction Fees
Collected fees form an additional reward pot.
Distributed per era using the same points → stake → commission logic as growth rewards.
Validator / Collator Parameters
MaxCandidates: 100 (max collators in the pool).
TotalSelected: 20 active collators selected per era (configurable).
MaxTopNominationsPerCandidate: 300 (top delegators by stake per collator are counted).
Validator Onboarding Token Requirements
EWX self-stake: ≥5,000 EWT (+ ~10 EWT gas buffer).
EWC: ≥1 EWT (to sync with Tier-1 chain).
Ethereum: ≥0.15 ETH (to support bridge syncing ops)
Token Management
The Marketplace app supports $EWT and $stEWT tokens. Below are the guides in acquiring them.
Guides available for token management:
FAQs
How long will it take for my balance to appear in my operator account after liquid staking?
It takes around less than 5 minutes to reflect the amount of $stEWT in your account depending on the amount of requests being processed by the EWX pallet.
Managing subscriptions
Dashboard
You can manage your subscriptions from Marketplace app's Dashboard. Here you are able to view list of solution groups that you've subscribed and unsubscribed (with unclaimed rewards only).
What you can do in Dashboard:
Check subscription amount, , current reward period and at a glance
subscription amount
Manage Subscription
The features in Manage Subscription page are pretty much the same as Dashboard except for Unsubscribe and infos related to voting. Read more:
ZEL Request Partitioning
High Level Concept: ZEL Request
A ZEL Request refers to a "Zero Export Limit" request. This request is made by generators or dispatchable assets to set their output to zero, often indicating that they are not able to inject power into the grid for a specific reason.
ZEL Requests can be relevant in several scenarios, such as:
Maintenance: When maintenance is being conducted on a generator, it may need to curtail its output temporarily.
Technical Issues: If there are technical problems that prevent a generator from operating safely or effectively, a ZEL Request signals that they will not produce energy.
Market Conditions: During high levels of generation leading to potential oversupply in the grid, generators might reduce output to maintain stability.
Market operators use these requests to manage the overall balance of the electricity supply and demand, ensuring system security and reliability.
The process starts when a retailer sends their ZEL request which needs to be partitioned accordingly, and forwarded to their respective aggregators. The partitioning process needs to take place in a fully trust-less and secured environment where data are pseudo-anonymized to protect aggregators' business interests.
ZEL Request Partitioniong Solution
The ZEL Request Partitioning solution aims to test the above business case. Below are the steps which constitute its solution flow:
Fetch ZEL request from the request sender every 30 minutes
Parse the request into JSON Object
Fetch to aggregator mapping from the NMI Registry. The NMI Registry is a backend API service which simply contains the mapping between NMI and aggregator.
Operating Envelopes Partitioning
High Level Concept: Operating Envelopes
The Operating Envelopes Partitioning is the most crucial step in the overall operating envelope passthrough process.
An "operating envelope passthrough" refers to a mechanism that allows for adjustments in the operational limits or envelopes of generating units or electrical systems. These envelopes define the safe operating conditions for various generation assets and network elements, helping ensure reliability and stability in the energy supply.
When unforeseen circumstances arise, such as significant changes in demand, generation availability, or system disturbances, the operating envelope can be exceeded. The passthrough mechanism enables market operators to make necessary adjustments to account for these situations, ensuring that the operation of the market remains secure and efficient. This process is vital for managing risks and maintaining grid reliability amidst changing conditions.
The process starts when the DNSP/DSO sends their operating envelope which needs to be partitioned accordingly, and forwarded to their respective aggregators. The partitioning process needs to take place in a fully trust-less and secured environment where data are pseudo-anonymized to protect aggregators' business interests.
OEP Solution
The OEP solution aims to test the above business case. Below are the steps which constitute the OEP solution flow:
Fetch OEP request from the operating envelope sender every 30 minutes
Parse the operating envelope into JSON Object
Fetch to aggregator mapping from the NMI Registry. The NMI Registry is a backend API service which simply contains the mapping between NMI and aggregator.
Energy Web Block Explorer
The block explorer interface provides the most important on-chain information about blocks, transactions, accounts and . Below is an overview of what information you can view on the Block Explorer.
Note that there is a separate site for the Volta Testnet Block Explorer.
Volta Testnet Block Explorer:
Main Network Block Explorer:
Operator and Worker Accounts
Operator account
Marketplace app requires an operator account to make the most of the features it offers. Connect your EWX account, fund your account and sign it up as an operator by following these guides:
Worker Nodes
What are Worker Nodes?
To learn more about worker nodes, see .
Types of Worker Nodes
Unsubscribing from a solution group
Prerequisites
Initiating KYC Verification
Solution groups requiring KYC verification can be identified with the KYC required marker.
To initiate for KYC verification, please follow below simple steps:
Connect your operator account to the EWX Marketplace app
Click on the solution to request for KYC verification
Connecting to operator account
The Marketplace app allows you to browse through a list of available solution groups with or without a wallet being connected. Without the connection however, you won't be able to perform token lifting, lowering or subscription. To connect:
Click on Connect button either on the left-side panel or on top corner of the screen
Tip: There's a "Connect" button in the solution group detail page as well
Stake-based subdivision: Each collator’s allocation is split pro-rata between collator self-stake and delegator stake.
MinTotalStake: 250,000 EWT (total stake, self-bond + delegated stake, needed to be in active set).
Since collators are ranked by total stake before the top set (defined by the topSelected parameter) is chosen for block authorship each era, increasing a collator’s stake improves their chances of being selected and therefore earning more rewards.
Collators Produce Blocks
The top set of collators, ranked by total stake, produce block during the era and receive points.
Collators and Delegators Share in Rewards
When rewards are distributed, either at the end of an era or during a growth event, the total reward pot is allocated to collators based on the points they earned for that period.
Delegators then receive a share of their nominated collator’s rewards, proportional to their stake contribution and minus the collator’s commission.
Note that staking rewards are distributed to the delegators' free balance, where they can be restaked by the user.
. In order for an individual to verify any on-chain transaction, they must sign the transaction using their private key. This makes it impossible to perform a transaction unless you have the private key.
Smart contracts that contain logic and functionality specific to applications deployed on the Energy Web Chain and the utility packages that connect them and their users to the Energy Web Chain.
A worker node account is used mainly for running worker node logic(s). Though you can earn base rewards by subscribing to a solution group, participating into worker node network allows you to earn extra rewards.
Worker node accounts do not hold any tokens and cannot access your wallet account tokens. They are only used for computation result submissions
Discover more guides for this topic:
FAQs
What to do when I forgot my worker account seed phrase?
You can recover your linked worker account's seed phrase using export feature as long as you have your password.
Unfortunately if you have unlinked or if you lost your password, then the seed phrase recovery process is not possible.
What to do when I forgot my operator account seed phrase?
In a nutshell, a Worker Node is a single processing unit in a network of nodes which has the ability to execute enterprise calculations, and submit votes to derive consensus-based, transparent results.
A general worker node typically involves below processes:
Sync operator subscriptions
Download and install solutions
Run solutions and cast votes
Figure 1 High level flow having the Marketplace app represent a worker node
Sync operator subscriptions
The worker node periodically syncs on-chain data for operator subscriptions. The syncing process informs the worker node that either a set of solutions is available to be installed (new subscriptions) or uninstalled (unsubscription or subscription expiry).
Download and install solutions
Solution flows, which are currently in the form of Node RED flow JSON files, contain the actual detailed specifications and implementation of a specific business use-case. These are stored in a decentralized file storage called IPFS. The EWX registry stores the CID of the flow along with the rest of the solution metadata. These are stored locally in the worker node during the syncing process.
When the worker node is enabled to run the flows, it downloads the actual Node RED flow JSON files from IPFS using the CID. Subsequently, the flow files are installed in the local Node RED server bundled in the worker node itself.
Run solutions and cast votes
An enterprise use-case is considered executing when the flow files get installed and are running in the Node RED server of the worker node. Each solution flow determines when and how the solution flow produces a result, and when to use the result to cast a vote.
Casting a vote simply follows below steps:
A solution is triggered to process the flow
The flow gets executed to produce a result
The result is transformed in to a Merkle Tree Root Hash
The flow requests for the worker to submit the hash as a vote
The worker enqueues the voting request
The worker submits the vote to EWX
Why does the result gets transformed into a Merkle Tree Root Hash? EWX nor the Worker Node never stores raw or calculated data unless the solution flow created by the enterprise themselves are designed and approved to do so after an extensive audit. EWX as a chain only stores the result hash for optimum performance and data security.
The Merkle Tree Root Hash can represent the actual calculated data as a single, unique vote. However, an adversary can never reverse-engineer the hash to derive the calculated or raw data. This ensures that the entire EWX ecosystem is secure and robust.
Please refer to potential enterprise use-cases for some examples of what a worker node can actually do.
Energy Web has deployed OpenEthereum's Name Registry contract. This contract is identical to OpenEthereum's original contract, with the exception that it was made Ownable by Energy Web Foundation. Only Energy Web can reserve a name or drain funds from this contract.
There are two reasons for making this contract Ownable:
We will have the official Ethereum Name Service system set up on the chain, so this contract is only needed for internal purposes and will not be used publicly.
The name registry is a placeholder for now. The contract can be found in our repo:
Interacting with the Name Registry Contract
Contract Address and ABI
Callable Functions
Ethereum
Ethereum
The Energy Web blockchain is derived from Ethereum blockchain technology. Ethereum provides a strong foundation for the Energy Web Chain because it is open-source, widely used, and many well-developed tools for development on Ethereum exist today.
Ethereum-based technology is used as EW-DOS's trust layer because anyone can use Ethereum to build and deploy decentralized applications that run on blockchain technology. This aligns with the purpose of EW-DOS, which is to build decentralized, open-sourced applications that accelerate decarbonization of the energy grid.
What Sets Ethereum Apart from Other Blockchains?
Prior to Ethereum, most blockchains were protocols created to exist as a public, decentralized ledger for financial transactions (think Bitcoin).
Ethereum developed the (EVM) to allow users to store and execute programs on the Ethereum blockchain. This lets programmers write programs that contain logic and state management, both which are critical to. These programs are called . Once it is deployed on the blockchain, a smart contract has an address on the blockchain and anyone can use to interact with the contract or call its public functions. You can read more about how to interact with smart contracts .
This means that blockchain technology can not only be used to buy and trade cryptocurrency, but also to create robust applications for decentralized finance, asset trading, gaming and, in our case, a decentralized energy market.
Read an overview of Ethereum and the Ethereum Virtual Machine on the Ethereum documentation's "What is Ethereum" section .
Ethereum Fundamentals
The Energy Web Chain is derived from Ethereum, but it is a separate blockchain using a different consensus protocol and unique governance mechanisms. However, most of the fundamentals of the Ethereum network are the same for the Energy Web Chain. These fundamentals are helpful in understanding the role that blockchain technology plays in EW-DOS. This is especially true if you want to develop and deploy smart contracts on the Energy Web Chain.
If you are unfamiliar with Blockchain technology, or the Ethereum Virtual Network, there are some additional resources below to get you started.
(this is an overview of transactions in Ethereum, but we explain more about transactions on the Energy Web Chain )
Additional Resources
Connecting to a wallet account
This section provides a step by step guide in connecting the EWX Staking Web App with a wallet account
Ensure that your wallet supports the Energy Web X chain
To ensure that your wallet supports the Energy Web X chain, please check if it is one of the supported networks in your wallet.
If not, please refer to below details to add Energy Web X as a custom network in your wallet:
RPC URL:
Name: Energy Web X
Token Symbol: EWT
Network Type: Substrate
Block Explorer:
Connect EWX wallet account
Security Notice
EWX Staking uses trustless pallets to secure your assets. Never share your private keys or seed phrase.
View account details on explorer
Click on the View on Explorer button to check the wallet account in the official EWX Explorer.
This action will open a new tab to show wallet account details on .
Switch accounts
In order to be able to switch accounts, ensure that accounts are enabled for connection to the EWX Staking Web App in your wallet. Below are examples on how to do so.
Before enabling the accounts, ensure that there are multiple accounts setup in your wallet extension.
Click on this Connect icon
Click on the Switch Account button to switch wallet accounts.
Choose the account to switch to and automatically the web app connects the selected account.
Disconnect
Simply click on the Disconnect button.
Pallets
Validator Node Architecture
The system architecture of a validator node on the Energy Web Chain is made up of two components:
Together these two components allow validators to run a local node of the chain, validate transactions, seal blocks, and monitor validator behavior and metrics.
OpenEthereum Client
A client is software that allows you to run a local node on your machine and interact directly with the blockchain. Every validator must run a full node in order to participate in validation.
Remember that the Energy Web Chain is derived from the Ethereum blockchain. Because of this we use an Ethereum client to connect with the chain called . Anyone can create a client, as long as it implements the protocols laid out in , and there are a number of Ethereum clients to choose from.
Energy Web uses the OpenEthereum client because it supports the , which is a consensus algorithm specifically for Proof-ofAuthority blockchains. OpenEthereum allows validators to connect to the chain, collect transactions and seal blocks according the AuRa consensus algorithm.
To read more about OpenEthereum, you can
To read more about Ethereum clients, see the
Telemetry Monitoring system
The monitoring system collects comprehensive, real-time data and metrics on validator performance and provides a user interface for viewing the data. It is important to gather as much data about the validator nodes as possible in order to ensure a secure and performant blockchain. To do so, we rely on well established industry solutions to transfer these metrics off the validator node to protect the sensitive nature of the data.
The use of the telemetry monitoring system is opt-in. Validators can disable it if they have their own monitoring system in place that allows for real time tracking of all relevant metrics.
Telemetry Architecture
There are four components involved in the data collection process:
client - monitors validator node behavior
: open-source server agent that collects data from the OpenEthereum client
- open source database that stores the data collected from Telegraf
All components are run in separate docker containers managed by docker compose. For additional information on docker visit: and .
Data Collection Process Overview
The OpenEthereum client collects data on the validator node. Collected data includes:
CPU usage
Memory usage
Worker Node use cases
Worker Nodes Larger landscape fit
Similarly as for blockchain or DLT (Decentralized Ledger Technology) application, Worker Node technology should mainly be considered for specific use-cases.
Active/Reactive Use cases types
You can consider utilizing Worker Nodes for either Active or Reactive use case types.
Active use cases describes a situation when system relies on Worker Nodes as a primary executors of business logic. In such a case, Worker Nodes plays a non-removable role from the system and biggest advantage is their flexibility, lightweight architecture and decentralized nature.
Example - Oracle Network
------------------------------
Reactive use cases describe a situation when system rely on Worker Nodes as a verification layer that ensures that result of the logic execution is done in tamper-proof and trustless manner. The decentralized nature additionally participates to the overall system security and ensures verification possibilities.
Example - verification of 24/7 energy matching algorithm
Worker Nodes use - Reactive use case
Main roles that Worker Nodes play in above use case type:
Application runs the business logic itself along with Worker Nodes
Worker Nodes executed functionality is part of a "bigger" system
Reactive way of using Worker Nodes offers a balance between Speed & Security
Worker Nodes use - Active use case (Coming Soon!)
Types of problems Worker Nodes help solving
There are four types of problems that Worker Nodes along with their capabilities coming from EWX Ecosystem are best equipped to solve.
Need for trustless execution (decentralized)
(Public) Verifiability of results e.g. for auditing needs
Need for system participants incentivisation
Need for blockchain use with strong security, advanced governance and data privacy care
Each use case type is presented below.
Trustless execution - Worker Nodes use ensures that multi-party consensus can be achieved.
Verifiability - Worker Nodes EWX integration allows for auditability and verifiability of execution results
Participants incentivisation - Worker Nodes EWX integration allows for incentivisation of active, well-behaving system contributors
Need for Blockchain use with maintained privacy - Use of Worker Node and EWX ecosystem integration allows for various of features that are often looked for when there is a need for Blockchain use. E.g.
Strict governance with options like Operators Whitelisting
Fully private set-up and isolation of Worker Nodes execution within private network
Not exposing private data on public blockchain
Unlinking a worker account from an operator account
An operator account is only allowed to link with a single worker account at a time. Unlinking allows you to generate a new worker account or import another worker account that can be linked with the same operator.
Unlinking will stop your worker node from casting votes
Prerequisites
Click on Unlink menu on the left panel of the Dashboard
Click Unlink to proceed or Cancel
Approve the transaction in your wallet
Wait for the transaction to finish execution
A successful message with transaction URL will be displayed when unlinking is successful
EWT Token Mobility
As part of the 2025 technology and governance upgrade approved by the Energy Web Chain (EWC) validators (for more see and ), an ERC-20–compatible representation of the Energy Web Token (EWT) has been implemented. This functional upgrade enables EWT to move between EWC, Energy Web X and Ethereum, expanding the platform’s interoperability and enhancing the EWT token utility. This documentation section serves to inform EWT holders on the impact of the 2025 upgrade but it should not be construed as an offer, recommendation, invitation, or inducement, to subscribe for or purchase the Energy Web Token. It does not constitute and is not intended to be financial or other advice and is not to be relied upon as the basis for any investment or other decision. Please be informed of all , and always verify all information presented here directly at the primary source, such as exchanges.
The functional conversion of EWT token ERC-20–compatible representation operates on a 1:1 basis,
Note: If you currently hold a native representation of EWT in a self-custodial wallet or on an exchange, no immediate action is required. Your existing tokens remain valid and can continue to be held, transferred, and used in applications that use the native representation of EWT. You may choose to convert, stake, or bridge your EWT at your own convenience. No deadline or mandatory conversion has been imposed.
In case you hold EWT in a hard or soft wallet, you can
Energy Web X
Business case
Today worker nodes are implemented as independent off-chain computing nodes that communicate with a smart contract deployed on the Energy Web Chain. This approach is effective, but it is complex and labor-intensive to configure custom business logic, synchronize nodes, and apply appropriate governance such as defining eligibility requirements and service level agreements that worker nodes must adhere to. A more efficient solution is to implement worker nodes within a common environment where they can run independently but follow a unified set of rules. That is where Energy Wb X comes in.
In contrast to the Energy Web Chain, which is Ethereum based, Energy Web X is built with . Its sole purpose is to coordinate, secure and make public the results of work performed by worker node networks.
Bootstrapping Server-based Worker Node Accounts
Before you start using your Worker Node and be able to control blockchain set-up fully using Marketplace app, there is a set-of one-time actions that needs to be done as a prerequisite.
Types of EWX Accounts
Account - an EWX account which serves as the main account of the operator to be used in EWT management (lifting/lowering), subscriptions, rewards, etc
Worker Node Pallet
The Worker Node Pallet provides essential functionalities for managing solution groups, solutions, votes and reward distribution mechanisms.
Balances Pallet
The Balances Pallet responsible for managing token balances, enabling secure transfers, and supporting the blockchain’s economic operations.
Proxy Pallet
The Proxy Pallet enables enhanced account management, operational flexibility, and secure delegation, particularly beneficial in multi-sig setups and automation scenarios.
XCM Pallet
The XCM Pallet facilitates Cross-Consensus Messaging (XCM), enabling secure and interoperable communication between different chains.
Assets Pallet
The Assets Pallet provides comprehensive tools for managing and interacting with fungible token assets.
Multisig Pallet
The Multisig Pallet is integral for collaborative decision-making and securing high-value operations in decentralized ecosystems.
Scheduler Pallet
The Scheduler Pallet is integral for automating and orchestrating on-chain operations at specified block heights or based on dynamic triggers.
Preimages Pallet
The Preimages Pallet is a specialized component in the Substrate runtime that facilitates the storage, retrieval, and management of large data blobs (preimages) on-chain.
Offences Pallet
The Offences Pallet is designed to detect, record, and manage misbehavior within the network. It ensures the integrity of the system.
Eth-Bridge Pallet
The Eth-Bridge Pallet is responsible for facilitating interactions between a Substrate-based blockchain and an Ethereum-based network.
Token-Manager Pallet
The Token-Manager Pallet is designed for managing tokens and handling token operations within a Substrate-based blockchain.
Ethereum-events pallet
The Ethereum-events pallet supports tracking event submissions, validation, and challenges while providing secure mechanisms for event processing and recording.
Avn Pallet
The Avn Pallet provides functionality that is common for other pallets such as handling offchain worker validations, managing a list of validator accounts and their signing keys.
getData(bytes32,string)
Returns a string data value from an entry, given its key.
getAddress(bytes32,string)
Returns an address data value from an entry, given its key.
getUint(bytes32,string)
Returns an unsigned integer data value from an entry, given its key.
getOwner(bytes32)
Returns the owner of an entry.
hasReverse(bytes32)
Returns true if entry has a reverse address registered.
getReverse(bytes32)
Returns reverse address of an entry.
canReverse(address)
Returns true if address can have a reverse.
reverse(address)
Returns the reverse value of an address.
reserved(bytes32)
Returns true if the name (its sha3 hash) is already reserved.
Worker nodes in the Energy Web ecosystem today function as independent off-chain computing units. They communicate with smart contracts deployed on the Energy Web Chain (EWC), which uses Ethereum-based technology. While this design has been effective in facilitating off-chain computation, it has significant challenges:
Complexity in Configuration: Setting up custom business logic for each independent worker node requires substantial effort, making the process cumbersome for enterprises.
Synchronization: Ensuring consistent operation and data synchronization between worker nodes and the smart contracts is labor-intensive.
Governance Enforcement: Defining and monitoring adherence to eligibility requirements, service-level agreements (SLAs), and reward mechanisms require careful management, adding to operational overhead.
Energy Web X as a Unified Solution
Energy Web X addresses these challenges by providing a substrate-based platform that integrates worker nodes into a unified environment. Substrate’s modular framework allows for highly customizable blockchains tailored to specific use cases, making Energy Web X a robust alternative to the Ethereum-based EWC.
Key Benefits:
Streamlined Governance: Worker nodes operating under Energy Web X follow predefined governance rules encapsulated in “pallets.” These pallets function like enhanced smart contracts, offering more flexibility and power to manage worker nodes collectively.
Enhanced Efficiency: A common environment reduces the complexity of synchronization and management, enabling easier scalability for enterprises.
Interoperability with EWC: Energy Web X is designed to complement EWC, enabling seamless interaction where worker nodes can migrate (“lift”) to Energy Web X for enhanced capabilities and revert (“lower”) to EWC as needed.
Worker Nodes in Energy Web X
Worker nodes remain essential as software packages operated by individuals or businesses. Energy Web X introduces features to make this ecosystem more appealing:
Reward Systems: To attract operators, worker nodes are incentivized through rewards in EWT (Energy Web Token). These reward mechanisms can be customized based on performance metrics, such as quality and timeliness of work.
Stake-Based Trust: To run a trusted worker node, operators are required to lock EWT, aligning their incentives with network reliability. This ensures that only committed entities contribute to critical computations.
Energy Web X structures worker nodes into solutions and solution groups, providing a hierarchical approach to management:
Solutions: Represent specific business applications or use cases powered by worker nodes.
Solution Groups: Group similar solutions together and define shared governance rules, including operational criteria and reward structures.
Configurable Lifetimes and Rewards: Solution groups provide flexibility:
Their lifetimes can be predefined but extended based on evolving business needs.
Reward mechanisms can be dynamically adjusted to incentivize participation and ensure the alignment of worker nodes with enterprise objectives.
On-Chain Consensus for Off-Chain Work
The configurations within solutions and solution groups dictate how worker node outputs are validated on-chain:
Eligibility Requirements: Define who can participate.
Service-Level Agreements: Set performance benchmarks for the worker nodes.
Consensus Mechanisms: Establish thresholds for accepting the results of off-chain computations as correct.
By formalizing these parameters, Energy Web X ensures:
Accuracy: Only valid results from worker nodes are anchored on the blockchain.
Trust: Enterprises and stakeholders can rely on a secure and tamper-resistant consensus process.
This structured and dynamic system makes Energy Web X a powerful platform for managing distributed worker nodes while reducing operational complexity and enhancing enterprise scalability.
Use the bridging function to bridge your tokens to and from various chains and exchanges
Stake your tokens on EWX and secure the network post-bridging
In case you hold EWT on an exchange,
If an exchange has already completed the conversion process and supports ERC-20 EWT, tokens can be withdrawn directly to an Ethereum token address (please see a list of actions by exchanges below, noting that this information should be verified directly with the respective exchange).
If an exchange still supports the original EWC chain and not yet the EWX and ERC-20 upgrade, tokens can be withdrawn to EWC and then bridged to EWX and from there to Ethereum, which has been facilitated by an interface at energywebx.com.
Please confirm the token representation supported by each wallet and/or exchange before making deposits and consider all risks related to token acquisition and management.
1. EWT Bridging Between Chains
Following the 2025 EWT technology and governance upgrade, bridging functionality has been made available through an interface energywebx.com, supporting token holders to move EWT across the following blockchains:
Energy Web Chain (EWC) → Energy Web X (EWX)
Use the Energy Web Bridge at www.energywebx.com
Lift locks tokens on EWC and mints them on EWX.
EWX ↔ Ethereum
Use the Energy Web Bridge at www.energywebx.com
Lift locks tokens on Ethereum and mints them on EWX while lower burns tokens on EWX and unlocks them on Ethereum
When users bridge EWT from the Energy Web Chain (EWC) or Energy Web X (EWX) to Ethereum, the tokens they receive come from the official EWT ERC-20 contract on Ethereum (smart contract that represents EWT on the Ethereum network):
Official ERC-20 contract address: 0xb66a5d30d04f076e78ffb0d045c55846fdcde928
Users are solely responsible for understanding the characteristics and risks associated with interacting with blockchain networks, including staking, bridging, or transferring EWT. Once again, please bear in mind the associated risks, and verify all information presented here directly at the primary source, such as exchanges.
Important: EWTb (the legacy bridged EWT token on Ethereum) is not the same as the new official ERC-20 EWT on Ethereum Mainnet. If you still hold EWTb, you must first bridge it back to EWC using the legacy bridge, and only then lift it from EWC to EWX. You cannot bridge EWTb directly to EWX, nor convert it directly into the new ERC-20 EWT on Ethereum via the new bridge.
2. Current Exchange Support for EWT ERC-20
Exchanges are in the process of updating their systems to support the EWT ERC-20 representation. Temporary suspensions of deposits or withdrawals may occur during these system updates. These processes are exchange-managed and follow standard operational procedures.
Grafana - data visualization tool that queries the InfluxDB for data and provides graphical interface for data visualization
Disk usage
Number of connected peers
List of visible P2P peers
Current block
Network latency to 3 different and major locations (e.g. cloudflare, google, amazon)
Network throughput
Network error rate
Number of SSH keys
Service status for SSH, docker and the parity container
SHA256 hashes of key system components/binaries
Current chain specification file (or hash)
Telegraf collects relevant metrics from the host machine and the custom-built OpenEthereum metrics collector. The metrics collector allows Telegraf to receive the metrics from the OpenEthereum client
The collected metrics are stored in an InfluxDB database and can be visualized using Grafana
Worker Node Account - an EWX account with the sole purpose of casting votes on behalf of the operator (interacting with blockchain).
Prerequisites
Public Address of the Worker Node Account - the worker node account must already be created using any of wallet which supports EWX.*
*Disclaimer -> If you use Launchpad Managed Worker Node offer, there is an option to automatically generate Worker Account along with Worker set-up.
To sign-up as an operator, you must prepare your "operator" EWX account. This account is just a normal account created on EWX network via any supported Polkadot wallet. For now, we suggest to use Sub Wallet or Nova Wallet. Make sure to always keep your seedphrase copied and secured elsewhere. In addition, please ensure that your operator account has sufficient EWT balance to proceed with any on-chain transaction.
Please follow below steps to sign-up as an operator.
Connect your operator account
Approve the connection request in your wallet
Once connected, you will be redirected to the Discover page and you will see your "operator" public address in the upper right corner of the screen as highlighted below
Browse through any solution group and click on it. You will be redirected to its details page. Then, click on the "Opt-in" button
The sign-up operator dialog gets displayed. Input your details accordingly and approve the transaction in your wallet.
Subscribe to solution group
After the signing-up as an operator, you will be prompted to stake tokens to your selected solution group from the Discover page. Stake your desired amount and approve the transaction in your wallet.
Stake EWT to subscribe to solution group
Confirm stake amount to proceed
Approve the transaction in your wallet
Set worker node account
After subscribing to the solution group, you will be prompted whether to participate in a worker node network.
Click "Continue" button to proceed.
Select "Remote server" and click "Next"
Input your worker node public address and proceed
Link worker to operator
After setting your worker node public address above, you will be prompted to link your worker node account to your operator account.
Simply click "Continue" to proceed
Then, approve the transaction in your wallet
A success message is displayed and you are done
Once done, your basic set-up is ready and you can continue with further Marketplace App Operator console exploration OR get back to your Server-based Worker Node set-up if it wasn't finished already.
Before using Ledger on the Marketplace App, the Polkadot app needs to be installed in the hardware wallet device. To do so, open the Ledger Live application in your computer and go to "My Ledger" section of the sidebar. Make sure your Ledger device is connected to the computer and unlocked when doing this.
In the "App Catalog" section, search for the Polkadot app and install it.
Confirm that the Polkadot app is correctly installed.
Now the device is ready to interact with the Polkadot chain, including the EWX chain.
⚠️ Things to Keep in Mind before using Ledger in the Marketplace App
Ledger Live app does not display EWX account and its balance as it is not yet supported. EWF is already including this in the roadmap.
The Marketplace App directly communicates with your Ledger device without the need to use Ledger Live as long as Polkadot is installed.
Connect Operator Account using Ledger Device
The first step to use Ledger with the EWX Marketplace application is to connect your hardware wallet. In this case, the process is very similar to connecting any other browser or mobile-based wallet. The user needs to click on the “Connect” button that appears both in the top-right corner of the screen.
A dialog will pop up, and the user can choose its preferred method to connect the wallet - in this case, choose Ledger.
The user will be prompted to continue the connection process in the hardware device.
By default, the Ledger device will look like this when unlocked:
After starting the connection process, the user needs to open the Polkadot application on the Ledger device.
After opening the Polkadot app (pressing both buttons at the same time), this will appear on the device:
That means there is an ongoing operation that needs to approve. To do that, press the right button until the “Approve” screen is displayed.
After approval, below shows the confirmation that the user is connected to the Ledger account successfully.
After successful connection, the EWX Account will be displayed on the upper right corner of the screen.
A new EWX address will be generated for first time users. The connected address is derived from the account which seed phrase is automatically generated and stored in the Ledger device.
One Ledger device can only represent a single EWX operator account.
Funding the EWX Account
To fund an EWX Account, the user can lift tokens from their existing EWC account or by creating a new one. EWC accounts can easily be created and funded using exchanges offering EWT such as or .
Executing a transaction
The process is very similar to the browser-based wallet, and applies to all the different transactions available on the app: lowering, sign up as operator, subscribe, link worker account, unsubscribe, top-up stake and claim rewards. After initiating a transaction, for example - lowering, the user will see a ‘Pending confirmation’ screen. The user needs to confirm the operation using the same method used to connect to the wallet.
When this screen appears, open the Polkadot account on the Ledger device, just like before.
After opening the app, review and approve the operation.
The details of the transaction are displayed on the device just like on the next sample screens.
Proceed to approve the operation.
The progress screen on the app immediately changes, displaying the “Executing transaction” title. At this point, the transaction has been sent and is being processed on the blockchain.
If the transaction finished successfully, the success screen and the corresponding tx hash are displayed. This concludes the entire transaction process.
Decentralized Identifiers (DIDs)
A DID is an identifier that is user-generated and not coupled to any centralized authority. It can be used to identify any subject, such as a non-tangible asset, a customer, or an organization.
Unlike traditional forms of identification, DIDs are not generated by a central authority, such as a government-issued driver’s license, or a bank-issued account number, and they are not stored in a centralized database. A user can create a DID for themselves or an asset using cryptographic or other means.
A DID for a given system resides in a decentralized DID registry. DID Registries, like VCs and DIDs themselves, are developed according to W3C standards. Most DID registries live on a decentralized ledger, or a blockchain. In the case of EW-DOS, the DID registry is on the Energy Web Chain.
A DID is derived from a public-private key pair that is generated programmatically through a cryptographic algorithm. The algorithm produces a private key and a corresponding public key. Crypto wallets such as will generate these keys for you on creation of an account. The public key can be exposed and shared with others, but the private key should not be shared with anyone. The algorithm used to generate the key-pair makes it virtually impossible for any outsider to guess your private key.
Your public key serves as your address on the blockchain, and your private key serves as your private identifier, similar to a password, and is used to sign on the blockchain. The signature is proof that you initiated that transaction.
DID Format
DIDs are made up of a , a and a unique method identifier. There are many DID methods that are supported by different blockchain networks. You can see a full list DID methods define operations to create, resolve, update and deactivate DIDs and their associated DID Documents, which are discussed below. DID Methods are often associated with a verifiable data registry, which are registries with store DIDs and their data. If the registry is implemented on a blockchain, smart contracts usually serve as the data registry. An example of this is the .
Energy Web Chain uses the . The string that identifies this DID method is "ethr", and the method identifier is always the user’s public key (also known as an address.)
DID generated by ID Registry using ETHR DID Method Specification
DID Documents
Every DID resolves to a corresponding , which contains metadata about the subject's authentication mechanisms and attributes, like its public key.
Below is a sample JSON document that was created by the EW-DOS DID library. For a list of required and possible DID Document properties,
Copy
Additional Resources on DIDs
Medium Series on private keys and their relevance in the Ethereum Network:
MetaMask on key terms:
Holding Contract
Overview
The Holding Contract holds tokens for initial investors. These tokens are "pre-mined", and do not enter the pool through block validation. Tokens are held for affiliates until a specific point of time that is specified in the contract, at which point they can be released to the specified address. The constructor of the holding contract and its initial balance is part of the chainspec file. This allows the investors' tokens to be locked at the first block.
The mapping between the account address and the token amount is hard coded into the contract and cannot be changed after deployment. After a block that has a later timestamp than the holding timestamp of an address is created, the tokens for that address can be transferred to the address by calling the realeaseFunds method. This method can be called by anyone, not only by the address that holds that balance.
Interaction with Holding Contract
Documentation and Source Code
Check a Balance and Withdraw Funds
If you're an investor and want to see your balance, you can use the Balance Viewer interface:
You will need MetaMask pointed to a local or a remote node
To learn how to connect via remote RPC, go
To learn how to run a local node go
Enter your address in the lookup field to see your holding balance
If the release period has ended, press the "Withdraw" button to release the funds to the address it belongs to. Make sure you trigger the withdraw function with an account that has some ethers to cover transaction costs
Mapping Between Address and Tokens
The mapping between addresses and tokens/release timestamp is kept in the storage of this contract. This mapping data structure was filled at the deploy time of the contract and cannot be changed.
Interacting with the Holding Contract
Contract Address and ABI
Callable Functions
System Contracts
System contracts are the Energy Web Chain's that implement OpenEthereum's protocols for .
Energy Web's smart contracts are open-sourced, and you can see them on github
- manage validator permissioning and behavior
- manages validator block rewards
Accounts selection
Holding Contract - manages the initial disbursement of pre-mined energy web tokens
Implementing Client Protocol
System contracts are the Energy Web Chain’s smart contracts that implement OpenEthereum’s permissioning protocols. These protocols determine what actions can be taken on the network.
In order to adhere to the expected protocol, the Energy Web Chain’s system contracts must implement the interfaces that are expected by the AuRa consensus engine, so that it can conform to the client’s protocols.
pragma solidity 0.5.8;
import "../misc/Ownable.sol";
import "../interfaces/IValidatorSetRelay.sol";
import "../interfaces/IValidatorSet.sol";
import "../interfaces/IValidatorSetRelayed.sol";
/// @title Validator Set Relay contract
/// @notice This owned contract is present in the chainspec file. The Relay contract
/// relays the function calls to a logic contract called Relayed for upgradeability
contract ValidatorSetRelay is IValidatorSet, IValidatorSetRelay, Ownable {
/// System address, used by the block sealer
/// Not constant cause it is changed for testing
address public systemAddress = 0xffffFFFfFFffffffffffffffFfFFFfffFFFfFFfE;
/// Address of the inner validator set contract
IValidatorSetRelayed public relayedSet;
/// Emitted in case a new Relayed contract is set
event NewRelayed(address indexed old, address indexed current);
modifier nonDefaultAddress(address _address) {
require(_address != address(0), "Address cannot be 0x0");
_;
}
modifier onlySystem() {
require(msg.sender == systemAddress, "Sender is not system");
_;
}
modifier onlyRelayed() {
require(msg.sender == address(relayedSet), "Sender is not the Relayed contract");
_;
}
constructor(address _owner, address _relayedSet)
public
{
_transferOwnership(_owner);
_setRelayed(_relayedSet);
}
/// @notice This function is used by the Relayed logic contract
/// to iniate a change in the active validator set
/// @dev emits `InitiateChange` which is listened by the Parity client
/// @param _parentHash Blockhash of the parent block
/// @param _newSet List of addresses of the desired active validator set
/// @return True if event was emitted
function callbackInitiateChange(bytes32 _parentHash, address[] calldata _newSet)
external
onlyRelayed
returns (bool)
{
emit InitiateChange(_parentHash, _newSet);
return true;
}
/// @notice Finalizes changes of the active validator set.
/// Called by SYSTEM
function finalizeChange()
external
onlySystem
{
relayedSet.finalizeChange();
}
/// @notice This function is used by validators to submit Benign reports
/// on other validators. Can only be called by the validator who submits
/// the report
/// @dev emits `ReportedBenign` event in the Relayed logic contract
/// @param _validator The validator to report
/// @param _blockNumber The blocknumber to report on
function reportBenign(address _validator, uint256 _blockNumber)
external
{
relayedSet.reportBenign(
msg.sender,
_validator,
_blockNumber
);
}
/// @notice This function is used by validators to submit Malicious reports
/// on other validators. Can only be called by the validator who submits
/// the report
/// @dev emits `ReportedMalicious` event in the Relayed logic contract
/// @param _validator The validator to report
/// @param _blockNumber The blocknumber to report on
/// @param _proof Proof to submit. Right now it is not used for anything
function reportMalicious(address _validator, uint256 _blockNumber, bytes calldata _proof)
external
{
relayedSet.reportMalicious(
msg.sender,
_validator,
_blockNumber,
_proof
);
}
/// @notice Sets the Relayed logic contract address. Only callable by the owner.
/// The address is assumed to belong to a contract that implements the
/// `IValidatorSetRelayed` interface
/// @param _relayedSet The contract address
function setRelayed(address _relayedSet)
external
onlyOwner
{
_setRelayed(_relayedSet);
}
/// @notice Returns the currently active validators
/// @return The list of addresses of currently active validators
function getValidators()
external
view
returns (address[] memory)
{
return relayedSet.getValidators();
}
/// @dev The actual logic of setting the Relayed contract
function _setRelayed(address _relayedSet)
private
nonDefaultAddress(_relayedSet)
{
require(
_relayedSet != address(relayedSet),
"New relayed contract address cannot be the same as the current one"
);
address oldRelayed = address(relayedSet);
relayedSet = IValidatorSetRelayed(_relayedSet);
emit NewRelayed(oldRelayed, _relayedSet);
}
}
A transaction is any action that updates the state of the blockchain. There are costs associated with each transaction that cover the computational cost of processing that transaction. These costs are variable and dependent on several factors, which are discussed .
This page covers the basic functionality of transactions, how their associated costs are calculated, and where to see transaction data from the Energy Web Chain and Volta Testnet. If you want to read more about the fundamentals of transactions, see the Ethereum documentation on , , and ,
A transaction is any ‘write’ operation that changes or updates the state of the blockchain. Transactions are always initiated by an externally owned account, and they must be signed by the account owner that initiated the transaction in order to be completed. Examples of write transactions include:
Transferring tokens between accounts
Deploying new smart contracts or accounts
Calling or Interacting with existing smart contracts
Once confirmed by the initiator, transactions can be in two states: pending and validated.
Pending Transactions
In a Proof-of-Authority consensus blockchain, validators take turn validating transactions and sealing blocks. Before a transaction is validated, it is in a "pending" state in the memory pool ("mempool"). The following image shows a transaction in a "pending" state. You can view all pending transactions on the Energy Web Block Explorer here.
Notice that the transaction fee of a pending transaction is not determined yet and the "Block Number" is pending.
Transaction in pending state - from Energy Web Block Explorer
Validated Transactions
After a transaction is validated by a validator, it is added to a block. The block is designated by a block number, shown in the image below. Each block in a blockchain is made up ofstrictly ordered, consecutive, validated transactions.
The following image is a transaction in a "validated" state. You can view all validated transactions on the Energy Web Block Explorer here.
Notice that the transaction fee of a validated transaction is no longer 0, it has a value in EWT.
Determining Transaction Cost
Every transaction that updates the chain has a transaction cost (transactions that are "read only" - meaning they do not update the state of the blockchain - do not have a cost.) It’s important to keep in mind that all transactions are not created equal: some are more computationally intensive than others, some are more urgent, some require greater degrees of privacy.
For example, an interaction with a smart contract that has complex functionality and many internal variables to store will be more computationally intensive than a simple transfer of tokens from one account to another.
As we’ll soon see, these differences from one transaction to the next can have an impact on ultimate transaction cost.
Transaction Cost Variables
There are three key variables that influence transaction cost:
1. Gas Cost
A transaction’s computational complexity is measured in gas, a unit that assigns a numeric value to each operational code, or instruction, that will be executed to complete the transaction. The gas cost of a transaction is determined by the amount and sophistication of code that needs to be executed as well as the amount and type of data that will be stored on the blockchain as a result. The more complex the transaction, the higher the gas cost.
2. Gas Price
To derive a concrete fee requires a gas price as well. Every user that initiates a transaction chooses a gas price they are willing to pay for that particular transaction, at that particular time. It is essentially a bid the user makes to have their transaction validated and added to the chain. Users that want to have their transaction expedited, for example, might bid a higher gas price to ensure that it’s included as soon as possible in the next available block.
Gas price is on the EW Chain is denominated in EWT (usually in minuscule units like gwei, which represent one billionth of an EWT). The price is expressed in tokens (gwei) per unit of gas.
You can specify a gas price in a transaction through MetaMask:
Gas price of .01 Gwei.
3. Token Value
Finally, token value—usually expressed in a fiat currency equivalent—translates virtual transaction cost into ‘real’ transaction cost. And when token value varies widely, perhaps due to token market volatility, resulting transaction costs can vary too.
Calculating Transaction Cost
Using the three variables above, you can calculate the total transaction cost:
TxCost(unit:fiat$) = GasCost(unit:gas) x gasprice(unit:token/gas) x tokenvalue($/token)
Here’s how a fee would be calculated for a hypothetical transaction on the Energy Web Chain:
50,000 gas x 1 gwei per gas = 50,000 gwei = 0.00005 EWT
If the market price of EWT was $1 at the time of the transaction, this would equate to $0.00005 fee. If the price of EWT was $10, this would equate to $0.0005.
Gas Price, Gas Limits and Block Size
To ensure that block time remains consistent and to prevent any given block from being overloaded with transactions, the EW Chain has a predefined limit to the amount of gas that can be consumed in each block. Each block on the Energy Web Chain has a size limit of 8 million units of gas.
Gas cost, as we've mentioned, represents the computational effort that validators undertake when validating transactions and sealing blocks. The gas price is denominated in EWT, which is paid to the validators for their work.
Each validator may set their own minimum gas price that they are willing to accept in order to include a transaction in their blocks. Currently on the EWC, the default is 0.1 gwei, but the overall range is between 0.01 gwei and 1 gwei. When initiating a transaction on the EW Chain, you should make sure that your gas price is at least 0.01 gwei, and if you want to ensure that your transaction is executed within the next 1-3 blocks (roughly 15 seconds), you should choose a higher gas price.
Because each transaction uses different amounts of gas, the number of transactions that fit on a block will vary.
Each block on the Energy Web Chain has a size limit of 8 million units of gas. Hypothetically, a single extremely computationally intensive transaction could consume 8M gas, but a simple transfer of EWT between two accounts (the most basic transaction type there is) consumes 21,000 gas. This is why a simple metric of “transactions per second” is misleading; not all transactions are created equal in terms of complexity (i.e. gas cost.) If many of the transactions that are waiting in the memory pool have low computational cost, you can fit more transactions in the block. If they are larger, the block will hold less transactions.
Take a look at the details of a block added to the Energy Web Chain:
Block Details of a Single Block on the Energy Web Chain
From this we can see that:
This block includes 43 transactions
The gas limit for the block is 8,000,000 (this limit remains constant for every block)
Only 1,553,623 units of gas were used to create the block (less than 20% of its limit)
If there were more transactions waiting in the memory pool to be added to the block, this block could have processed ~6,446,377 units worth of gas.
The same three variables above that define transaction cost also present opportunities to manage those costs and keep them low.
1. Lean smart contracts can help keep gas costs down: App developers and other smart contract writers are incentivized to write lean, efficient code—writing smart contracts and initiating transactions that are as computationally efficient as possible.
2. Gas price bids should remain low on networks with high transaction capacity: Of the three variables that contribute to transaction costs, gas prices are arguably the most powerful lever, since the bidded prices are solely at the discretion of the user submitting a transaction to the network. For reasons we’ll explore below, in the absence of sustained block “congestion”, gas prices can remain low and stable.
3. “Just in time” gas price calculations mitigate some risks of token value volatility: For a variety of reasons, some token markets are more volatile than others. But just because a token’s value relative to a fiat currency changes, it doesn’t mean that transaction fees similarly change without warning. Users calibrate gas price bids at the time of the transaction, and thus will bid a denomination of tokens relative to the token’s value at the time. While it is possible that a past transaction fee could end up being significantly more or less expensive relative to current (or future) token value, transaction fees at the time they are incurred should remain relatively stable as a function of fiat currency.
If users desire a low-cost network, why do transaction costs rise in the first place?
So why would anyone bid a high price for any transaction? Shouldn’t transaction fees remain very low, as rational users consistently attempt to minimize their costs? In reality, transaction fees vary precisely because of competition among users to get transactions confirmed.
At any given moment there may be hundreds or thousands of transactions waiting to be confirmed and formally added to the blockchain. These pending transactions sit in a memory pool, or "mempool", where they are ultimately selected by validators (miners in the case of proof-of-work blockchains) to be included in a block. But each block has a finite gas limit, meaning not all transactions can be confirmed at once. As a result, validators will typically give preference to the most-lucrative (or expensive, depending on perspective) transactions in the mempool. Transactions with lower fees may end up having to wait for their transaction to get confirmed.
Ultimately, fees are about transaction prioritization. The higher the gas price you pay, the faster your transaction will be confirmed. If you don’t care about the amount of time it takes to confirm your transaction, you can offer a very low (or no) gas price. However, with this strategy you run the risk that your transaction never gets confirmed, and just sits in the mempool queue indefinitely.
Lessons from what we know about the Energy Web Chain
At the most basic level, transaction fees on the EWC are determined as a function of supply (e.g., computational capacity of the network, as defined by block gas limit and block speed / time) and demand (i.e., number of pending transactions). Volatility comes into the equation because supply, namely block time and block gas limit, is essentially fixed, whereas demand fluctuates as a function of the number of users and and the volume and complexity of transactions in the memory pool at any given time. Occasionally, transaction fee trends diverge from transaction volume, but generally the two are correlated.
Looking at historical data since the launch of the EWC in June 2019, it’s fair to say that transaction fees are usually extremely low - with average block utilization (in terms of gas consumption) around 15-20% the minimum gas price of 0.1 gwei is almost always sufficient to ensure a transaction is validated within 2 blocks. Based on the historical market price of EWT, transaction fees expressed in terms of fiat currency are typically in the range of $0.0001 (or less).
Energy Web 2025 Technology and Governance Upgrade FAQ
This document lists frequently asked questions and brief answers in relation to the Energy Web 2025 Technology and Governance Upgrade. Further information is available in other sections of the GitBook documentation and the related , as well as the ,
1. What Does the Energy Web 2025 Upgrade Entail?
The 2025 upgrade marks Energy Web platform’s transition from the legacy Energy Web Chain (EWC), a public but permissioned Proof‑of‑Authority (PoA) network, to Energy Web X (EWX), a public, permissionless, nominated Proof‑of‑Stake (NPoS) parachain on Polkadot.
The upgraded Energy Web technology platform consists of:
Energy Web X (EWX) – the core blockchain layer providing NPoS, on‑chain governance, native token bridging, and EVM-compatible execution.
Verified Compute Cloud (VCC) – a decentralised off-chain business logic computation service, developed by the Energy Web Foundation as a blockchain layer 2 solution, complementing and interacting with EWX for on-chain finalization. VCC supports verification, automation and auditability for sustainable, mission-critical enterprise solutions.
With the upgrade, EWC transitions into an archive mode, while EWX becomes the strategic foundation for long-term use. EWT is deployed as an ERC‑20 representation on Ethereum for broader access and liquidity, while maintaining EWT supply cap of 100 million.
2. Why Was This Upgrade Required?
The upgrade from legacy Energy Web Chain (EWC) to Energy Web X (EWX) is a strategic evolution driven by the need for enhanced scalability, security, governance, economic stability and interoperability, critical for running enterprise grade applications on-chain.The original EWC PoA model successfully bootstrapped early enterprise deployments but presents limitations to decentralisation and linteroperability.
The 2025 upgrade addresses these constraints by:
Moving to open, permissionless NPoS on EWX
Leveraging Polkadot interoperability (XCM)
Integrating ERC‑20 EWT on Ethereum for higher accessibility and utility
Introducing VCC as layer 2 decentralised off-chain business logic for enterprise-grade service execution
Implementing transparent, token‑holder-driven governance and treasury management
3. How Was This Upgrade Authorised (Zurich Hard Fork)?
The upgrade was formally approved through EWC’s validator governance process and funded through the Community Fund. Validators voted on Energy Web Architecture Upgrade Proposal, approved by supermajority, implementing the Zurich Hard Fork, which initiated runtime upgrades (EWC supply freeze and transition to NPoS at EWX), ERC‑20 deployment, and bridge topology with additional advanced features including liquid staking and BYOT, as well as Worker Node Pallet integration facilitating layer 2 Verified Compute Cloud service. Any further upgrades will follow the new, broader on-chain governance mechanism.
Pre-upgrade the EWC Validators administered the Community Fund and determined the manner in which its EWT may be apportioned in accordance with the one-vote per Validator governance structure. For a list of previous motions please see this section.
4. How Is the Upgrade Rolled Out (Zurich Hard Fork)?
Freezes EWC token minting at ~83.26M EWT.
Moves governance and chain evolution to EWX.
Keeps EWC operational as an on‑ramp only (no new block rewards; no lowering back from EWX; existing apps may continue)
The Energy Web Bridge maintains 1:1 conservation using lock/mint and burn/unlock semantics.
Important: If you still hold EWTb, you must first bridge it back to EWC using the legacy bridge, and only then lift it from EWC to EWX. You cannot bridge EWTb directly to EWX, or convert it directly into the new ERC-20 EWT on Ethereum. For more, please see the section on EWT Token Mobility.
2. ERC‑20 EWT Deployment & Bridge Topology
ERC‑20 EWT deployed on Ethereum with initial supply equal to frozen EWC supply.
The Energy Bridge, which bridges Energy Web Tokens (EWT) between Energy Web X (EWX) with Ethereum Mainnet went live on 11 September 2025 at 08:45:59 AM UTC.
The bidirectional bridge manages token bridging through a bridge pallet deployed on EWX and the deployed on Ethereum.
Energy Bridge Contract:
Bridge behaviour:
EWC → EWX: one‑way lift.
EWX ↔ Ethereum: full bidirectional lock/mint, burn/unlock.
Liquid staking introduces stEWT for use across ecosystem applications.
5. VCC & BYOT
VCC rollout for decentralized business logic compute.
BYOT support via Polkadot Asset Hub for stablecoins and additional tokens.
6. Evolution of On-Chain Governance
Best practices for on-chain governance mechanisms to be implemented while accounting for network security, particularly learning from Polkadot and other ecosystem implementations.
5. Who Is Affected and What Actions Are Needed?
EWC Validators
Upgraded node clients for the Zurich Fork.
No PoA block rewards issued post-apgrade.
Encouraged to transition to EWX Collators.
Exchanges & RPC Providers
To integrate ERC‑20 EWT representation.
To update nodes to post‑fork configurations.
Developers
Existing EWC deployments still run, but long‑term projects should target EWX.
Both Launchpad+VCC and standard EVM routes are available.
Token Holders
Can lift EWT from EWC → EWX at 1:1.
Can lower between EWX ↔ Ethereum.
Cannot lower back to EWC after ERC‑20 activation.
For more, please see the section on EWT Token Mobility.
6. What Is Changing in Tokenomics?
The token model is now:
Fixed supply cap: 100 million.
Frozen legacy minted supply: ~83.26M.
Headroom: ~16.74M EWT that can only be minted via on‑chain governance.
No automatic inflation.
Transparent minting only under referendum, with mint events originating on Ethereum and bridged to EWX.
Enhanced token utility via new token mobility features (staking, BYOT and liquid staking) and layer 2 Verified Compute Cloud service.
7. How Are EWX Network Staking Rewards Distributed?
Rewards come from transaction fees and any governance‑approved issuance.
Collators earn points for block production.
Rewards are allocated proportionally to points.
Rewards are split between Collators and their Nominators based on stake.
Slashing applies for misbehaviour or downtime.
Parameters (reward rates, slashing percentages, active set size) can evolve through governance.
8 What is Verified Compute Cloud?
Verified Compute Cloud (VCC) Service has been developed by the Energy Web Foundation as a blockchain layer 2 solution for off-chain business logic computation, complementing and interacting with EWX for on-chain finalization. Key aspects of VCC include:
Verified Compute Cloud Solution Groups (VCG) comprise VCC Operators and Stakers providing a service pursuant to a select VCC Protocol determined by the VCC Client.
VCC Clients are users of the VCC service that determine the VCC Protocol and pay for the service.
VCC Operators: Independent, distributed node operators technically leveraging Energy Web’s Worker Node Pallets, opting in to execute tasks defined by a given business logic (e.g. computing an energy load forecast or validating a batch of renewable energy certificates), communicating the outcome for subsequent on-chain verification and finalisation pursuant to a pre-agreed set of rules (VCC Protocol).
VCC Stakers: EWT token holders providing a slashable collateral as a service to support the enforcement of VCC Protocol requirements. This service does not confer ownership, revenue rights, nor does it guarantee yield.
VCC Protocol: Each registered VCC solution comes with a deterministic business logic specification that defines both the computation tasks and the rules for participation and achieving consensus on results; for instance, the rules may include:
Required stake per VCC operator, acceptable identities or certifications for data management (if any),
Number of VCC operators that need to agree (quorum threshold like majority or supermajority),
Time windows for task execution and result submission,
Fee for successful execution and penalties for faults/disagreements, etc.
More information on VCC enterprise roll-out and how to qualify as a VCC Operator or Staker will be provided soon.
10. What is Liquid Staking on Energy Web X (EWX)?
Liquid staking on Energy Web X (EWX) lets users stake EWT without locking it, by depositing into a pooled nominator managed by the Liquid Staking Pallet and receiving liquid stEWT in return. stEWT stays fully transferable and usable across the ecosystem, including for participating in Verified Compute Cloud groups (VCGs), while continuously accruing staking rewards. Those rewards are automatically restaked, increasing the stEWT:EWT exchange rate over time without minting new tokens. This simplifies the staking process for users, removes the need to manage delegations and restake rewards while compounding utility, safeguarding network security and avoiding excessive concentration of stake. stEWT will remain bound by the overall EWT supply cap.
The liquid staking model unlocks several key benefits for stakers and the Energy Web ecosystem:
Stake EWT into a shared pool and receive liquid, transferable stEWT.
No lock-up: stEWT can be moved, held, or used in applications (e.g., Verified Compute Cloud).
Auto-compounding: staking rewards increase the exchange rate, boosting stEWT value.
No delegation management required; the pallet stakes across a curated collator set.
Improves network security, liquidity, and token efficiency across the ecosystem.
11. What Happens to the Community Fund?
The Community Fund transitions into the EWX on-chain treasury:
Funded by fees, slashing, and governance‑approved issuance.
Managed directly by EWT token holders.
Intended to continue to support ecosystem development, audits, grants, and upgrades.
12. How to Become a Collator and Apply for Nomination?
During the transition phase:
Onboarding is curated and based on meeting technical standards and minimum stake.
EWF supports eligible operators with nomination.
Future phases aim for:
Fully permissionless onboarding.
Optional KYC/KYB overlays for regulated applications.
13. What Is Proof of Stake on EWX?
EWX uses Nominated Proof-of-Stake:
Collators produce blocks, stake EWT, earn rewards, and face slashing in case of misbehave or non-performing.
Nominators back Collators and share rewards and risks.
Relay Chain Validators provide finality.
Features include:
Minimum self‑stake and total stake thresholds.
Dynamic active set based on total backing.
Slashing calibrated based on severity.
Future support for liquid staking (stEWT).
Participation in EWX is voluntary and comes with both risks and opportunities, as outlined in the 2025 EWT White Paper, and especially in the relevant risk disclosures.
The Worker Node Pallet provides the core logic for orchestrating a decentralized network of worker nodes, enabling the validation of off-chain computation through on-chain consensus. It manages the registration of solution groups and their associated solutions, coordinates result submissions, and enforces validator consensus and reward distribution on Energy Web X.
Core Functionalities
Worker Node Operator Management
Enables the registration and configuration of worker node operators and their worker nodes and organizes them into solution groups.
Enforces the locking of funds required to become a node operator and operational constraints (i.e. an operator can only have one connected worker node at a time).
Solution & Solution Group Management
Enables registrars to create, register and deregister solution groups and their constituent solutions, reserving assets in the process to be distributed as worker node rewards.
Allows registrars to configure operational parameters for each solution including consensus majority threshold (vote_threshold_percent), quorum (quorum_percent), and operator contribution requirements.
On-chain Voting & Consensus
The pallet enables the initiation of voting rounds (either via workers or registrars), the tracking, storage and collation of vote submissions (results from off-chain computation) from eligible workers, and voting round expiry.
EWX validators (collators) determine the final result of expired voting rounds through threshold-based consensus mechanism (e.g. >60% of eligible votes are identical), configured per solution.
Reward Calculation & Distribution
Voting rounds conclude and settle within discrete time intervals known as reward periods. At the end of each period, validators determine which worker nodes qualify for active rewards based on whether their performance exceeds the configured SLA (service level agreement) threshold (sla_voting_threshold).
Validators track each worker’s contributions (correct votes, total eligible voting rounds, and stake) in VoteMetadata. If a worker node surpasses the SLA threshold for correct vote. percentage during the reward period, validators calculate its reward share, weighted by stake and voting accuracy. In this way, rewards are distributed proportionally to the most accurate and economically committed participants.
Registering Solution Groups and Solutions
The worker node pallet enables the creation and management of Solutions which are mapped to solution groups. Solutions are business units which require the execution of discrete business logics or off-chain computational tasks. Each solution group acts as a collective for managing operator participation, reward distribution and operational parameters.
Registrars define key configurations for each group including:
Namespace and info
Subscription (base) rewards and SLA-based (active) rewards
Asset used for rewards
Staking requirements for operators
Solution Group Registration and Deregistration Rules
The registration of a new solution group is governed by the following rules:
The caller must be a registered solution registrar.
The registrar must provide all required parameters and configurations.
The registrar must have sufficient balance to reserve the funds required from the solution group’s operation and reward budget.
A Solution Group can be deregistered under the following conditions:
Only the registrar owning the group can initiate the deregistration.
The group must not have any active solutions associated with it.
If the group still has subscribers with unclaimed rewards, it enters a virtual removal state preventing any new operations while still allowing users to claim rewards.
Solution Group Whitelisting
Registrars can enable Solution Group Whitelisting to restrict participation in a group to a curated list of trusted worker node operators. This feature is particularly useful for governance-sensitive applications such as those run by regulated entities or consortiums (e.g. SAFC), where only pre-approved partners are eligible to perform the work.
When creating or updating a solution group, the registrar can enable the has_operator_allow_list flag within the group’s OperatorConfig and set to true. Setting to false allows any operator to subscribe and participate subject to other constraints such as group size, minimum stake or nomination criteria.
Nominations
Registrars can exert granular control over which worker nodes are eligible to participate in voting rounds for a particular solution.
Enabling Nominations: A registrar can enable nominations for a solution. When nominations are enabled, only explicitly nominated worker nodes are eligible to vote.
Nomination Criteria: Registrars may apply custom nomination criteria when selecting eligible workers. For example, they may nominate only nodes within specific geographic regions (e.g., geofencing), or favor nodes with lower environmental impact, leveraging
Enforcement: When a voting round is initiated, a snapshot of the nominated worker list is taken. Only nodes within this list can submit valid votes. Any attempt by a non-nominated worker to vote in that round will be rejected by the runtime (unauthorized error).
Worker Node (Operator) Lifecycle
Operators lock tokens, register worker nodes, subscribe to Solution Groups, perform work by executing off-chain solution logic and submit results (votes) on-chain.
Operators register by:
Locking the requisite EWT tokens
Subscribing to one or more active Solution Groups by reserving the required stEWT tokens
Connecting a worker node instance (one per operator account per group)
Participating in voting rounds for the group’s solutions
Operators receive rewards on the solution group assets based on their voting accuracy, stake, and adherence to performance requirements set by the registrar. Operators may unsubscribe at any time, subject to the configured withdrawal delay.
Voting Logic
Voting round initiation:
Voting rounds are configured to be started by either worker nodes or registrars
A voting round can only be initiated if it will conclude (determined by its max_waiting_threshold) before the expiration of its encompassing reward period.
Consensus Logic
The consensus logic is designed to incentivise high performing nodes, protect against malicious actors while optimising scalability and security. Consensus is only calculated on submitted votes for valid voting rounds, and voting rounds are only considered valid if the minimum vote contribution threshold (quorum) is reached.
Quorum: quorum_percent defines the threshold for the minimum percentage of the current Solution Group subscribers (or nominations) which must submit a vote within a given voting round, for the round to be valid and able to reach consensus.
Majority: vote_threshold_percent defines the minimum percentage of workers within the quorum which must agree on the result for consensus to be declared (i.e. the percentage of the votes submitted which are identical).
Consensus Calculation: Consensus is calculated in the reward period after a voting round has finished, and utilises a snapshot of the subscriber list taken at the start of the voting round. If nominations are enabled, the subscriber list is adjusted to include only nominated workers.
Worked Example:
A solution group has 1000 subscribed workers, of which 800 are nominated.
The quorum threshold is set to 50%, meaning a minimum of 400 workers must submit a vote within the voting round for it to be valid.
The consensus threshold is set to 60%, which means of the 400 votes, 240 must be identical submission for consensus to be declared and the result validated.
Reward System
The reward system is designed to only reward high-performing workers who submit consistent and accurate votes, as stipulated by the service level agreement (SLA).
The SLA threshold (sla_voting_threshold) is set by the solution group registrar, and stipulates the minimum percentage of correct (consensus-aligned) votes out of the total number of votes a particular worker was eligible to submit during the reward period.
Reward share is proportional to the volume of correct votes submitted by a worker during a reward period, and weighted by its stake.
worker_reward: the amount of EWT distributed to the worker node operator as their active reward for participation in eligible voting rounds within the concluded reward period.
worker_correct_votes: The number of correct (consensus aligned) votes submitted by the worker node in the eligible voting rounds within the concluded reward period.
user_stake
Worked example:
A Solution Group contains 150 operators. At the end of a reward period, 100 operators submitted sufficient votes to exceed the SLA threshold and are eligible for rewards.
From the eligible 100 operators, the average correct votes during the reward period is 100 and the average user stake is 1000.
Worker Node A had 110 correct votes with a stake of 1000. There are 7200 active blocks in a voting round, and the votings rewards per block are set to 1 token.
The withdrawal delay is the period a user must wait between submitting an unsubscription request and withdrawing their tokens. This mechanism ensures every action (vote) has a consequence, protecting against malicious actors who may otherwise submit false votes and then immediately withdraw their stake to evade penalties. withdrawal delays are measured in reward periods instead of blocks.
In practice, after an operator initializes a withdrawal, they must wait a defined (by the registrar) number of additional reward periods before withdrawing their collateral. During this delay period, the node can still participate in voting rounds and continue to earn rewards, except for the final reward period in which the stake is released and voting eligibility ends. This ensures all pending rounds are properly settled and any rewards or penalties processed before a node can exit the network.
Voting Round Lifecycle
Initiation: A voting round is initiated via extrinsic from registrar or a worker node vote submission
Voting: Eligible worker nodes submit votes (solution results) to the worker node pallet
Expiration: The voting round expires after the configured number of blocks
Consensus related Configurable Parameters
Below is a list of configurations which are set by the solution registrar, including the upper and lower bounds.
Solution Group registration Parameters
Subscription_reward_per_block: Tokens per block distributed as rewards to eligible worker node operators
withdrawal_delay: Number of reward periods to wait after withdrawal action
sla_voting_threshold: SLA voting threshold as a percent
Solution Registration Parameters
expiration_block: Block number when the solution expires
max_waiting _threshold: sets the number of blocks in which a voting round can remain active and open to receive votes, before it expires and concludes
Lower bound: 0
FAQ
1. When are voting rewards distributed to Worker Node Operators?
Rewards are distributed after a reward period has ended and all voting rounds from that period have been processed. At the current stage, the system processes one voting round per block, with a maximum of 128 votes per block. If a round contains more than 128 votes, processing can extend over multiple blocks.
Because some solutions are triggered on schedule (e.g. periodic rewards) while others are event-driven (e.g. external data triggers like gp4btc), the number of voting rounds can vary each period. Once all rounds in a period are completed, the corresponding rewards are paid out.
2. Which factors increase APY% for Worker Nodes?
Reward eligibility is determined by the SLA threshold set by Solution Group Registrars (owners). The SLA threshold is the minimum percentage of correct (consensus-aligned) votes a Worker Node must submit in each reward period.
To maximise APY returns, a Worker Node needs to exceed the SLA threshold in each reward period and therefore should aim to vote correctly in every voting round in which they are eligible to vote.
Worker Nodes are always eligible to vote for non-nominated solutions. For nominated ones, they must be first nominated by a mechanism running along with the solution.
You can read up more about the of the Worker Node Pallet.
3. Which token is required to become an operator?
Becoming a Worker Node operator requires a small amount of EWT to be locked (0.1) and the stake provided by the operators on stEWT. The Operators are getting rewarded based on their performance with the asset configured on the Solution Group they have subscribed to.
Voter eligibility determines which workers are eligible to vote on solution results within a solution group. To be eligible to vote a worker must be subscribed to the corresponding solution group. If the registrar enables nominations, the worker must also be nominated.
Validators re-submit the final consensus result on-chain and settle the voting round.
Active rewards are distributed in addition to the base rewards allocated to all actively subscribed nodes.
Majority and quorum
Operational windows
Withdrawal delays and eligibility criteria (such as nominations)
Upon successful registration, the registrar becomes the owner of the solution group.
Management: All nomination settings are managed via extrinsics and enforced through on-chain logic.
Voting eligibility:
To vote within an active voting round, a worker must be subscribed to the corresponding solution group.
If nominations are enabled by the registrar, then only workers within the nominated list are eligible to vote. Nomination means the operator’s account is included in the array of nominated workers at the start of each voting round.
Only one vote per worker per voting round is accepted.
Voting outcome:
A voting round can be in one of four states: Active, when the round is open and pending processing; OffChainVote, when validators are evaluating and agreeing on the result; Settled, when consensus has been reached; and Unresolved, when consensus could not be reached for various reasons.
: The amount of tokens locked by the operator upon registration.
total_weighted_correct_votes: Sum of correct votes weighted by stake across all worker nodes ( Σ(correct_votes_i * stake_i) ).
voting_rewards_per_block: Amount of tokens allocated to voting rewards per block (configured by the solution registrar).
active_blocks: Number of blocks spanning the reward period.
Consensus: The collators reach agreement on the consensus result and update vote metadata to track correct submission per worker
Reward distribution: At the end of the corresponding reward period, worker performance is benchmarked against the SLA threshold, and rewards are calculated and distributed to qualifying workers
Lower bound: 0
Upper bound: 100
Upper bound: <= reward period length
vote_threshold_percent: Threshold for majority consensus ruling [%]
A solution is a representation of a business case logic within the worker node networks. It is composed of the solution metadata and a Smart Flow definition file. The Smart Flow file is stored on a publicly available decentralized file system - IPFS (Interplanetary File System).
A solution group is a collection of solutions. Operators choose which solution group they opt to run and stake EWTs with. The worker node will run all active solutions under the subscribed solution group.
Smart Flows
A smart flow is a set of logical nodes that define a business use case. In EWX, smart flows are created and configured using Node RED which provides a browser-based flow editor that makes it easier for enterprises to wire together flows. However, contents of a Node RED node may be auto generated by any third party and be available as an independent, reusable node.
Smart flows are exported to JSON files and are stored on IPFS. Worker nodes of subscribed operators can automatically fetch these files and deploy into each respective instance.
Below is the sample generic sequence diagram describing the process from fetching data from each respective business case provider system, processing the data, submitting the result to EWX, calculating the consensus, and forwarding the results back to the BC system. Business Case (BC) providers are those entities who have access to and define the logic of the Smart Flows.