ECP Funding Operations Guide
Introduction
ECP (Edge Computing Provider) is a crucial component in the Swan Chain ecosystem and is responsible for executing Zero-Knowledge (ZK) computation tasks. The Sequencer is an optimization component aggregating proofs submitted by multiple ECPs, processing them in batches to reduce gas fees and improve overall efficiency.
Account Overview
CP Account (Computing Provider Account): An independent on-chain contract account for CP operations and fund management. FCP and ECP have the same account structure.
Owner Address: Hold the highest authority to manage the CP account.
Beneficiary Address: Receives rewards for ZK tasks.
Worker Address: Used for submitting proofs.
Collateral Account: ECP's collateral account in the collateral contract (SwanC).
Escrow Account: A account for storing ECP's collateral in collateral contarct, ensuring that ECP can receive ZK tasks.
Sequencer Account: ECP's account in the sequencer contract, used to pay for gas fees required when submitting ZK proofs.
Table of Content:
1. Initial Setup
1.1 Obtaining ETH for Gas Fees
ETH is required for transaction gas fees. Follow these steps:
Visit Swan Chain's official bridge website: https://bridge.swanchain.io
Cross-chain your ETH to Swan Chain to obtain ETH
Prepare sufficient ETH to account for potential fluctuations in network gas fees
1.2 Obtaining SWANU for Collateral
ECP requires SWANU
(Swan Compute Unit) as collateral.
Token: SWANU Contract: 0x39cBBeaF88a91404618d45a16e0977Adab4d1Af1
Existing Providers:
Automatic SWANU collateral deposit based on GPU specifications
Required upgrade to Computing Provider v0.7.1
Status verification via
computing-provider info
command
New Providers: Submit application through official form for SWANU allocation here:https://docs.google.com/forms/d/e/1FAIpQLSdnd8H4ab1eBr0D4e2QBLvBRj6H_xo7C8gW8ItewvHJRzYVVg/viewform?usp=sf_link
1.3 Collateral Requirements
Collateral amounts dynamically adjust based on network computing power.
Review our comprehensive collateral documentation for detailed information
Monitor the Swan dashboard for computing units and base collateral trends(upcoming feature)
Maintain sufficient collateral to ensure continuous task eligibility
During CP UBI-0 stage:
Collateral will be directly deposited to corresponding escrow account. No manual deposit required.
Funds locked for UBI qualification and order acceptance. No withdrawal option available
2. Account Setup
Depositing SWANU to the Collateral Account: Use the following command:
3. Configuring Sequencer (Recommended)
3.1 Enabling Sequencer Functionality
In the ECP configuration file, set EnableSequencer = true
and autoChainProof = true
When autoChainProof
is true, ECP will prioritize submitting proofs via the sequencer. If the sequencer lacks sufficient gas, it will automatically submit proofs on-chain. If set to false, ECP won't submit tasks when the sequencer lacks gas.
Note: ECPs can submit proofs in two ways:
Directly to Swan Chain as a contract (higher gas consumption per transaction)
To the zk-sequencer for batch aggregation (lower gas consumption, recommended)
3.2 Funding the Sequencer Account
When using the sequencer, pre-fund the CP's sequencer account with ETH on Swan Chain. Currently, the gas is decided by the Dynamic Pricing Strategy. For more detailed information, see here.
Note: The sequencer periodically processes tasks and deducts from the sequencer account. If the balance is insufficient during settlement, it may become negative. ECPs need to refund to receive new tasks.
4. Task Execution and Rewards
4.1 Reward Distribution
Rewards are distributed during the next settlement cycle after 24 hours following the CP UBI-0 event rules, typically within 48 hours of task proof submission, to the beneficiary account.
Read Computing Provider Income to learn more.
4.2 Viewing UBI tasks
Check the transaction list of the beneficiary account on the blockchain explorer: https://swanscan.io.
Alternatively, you can use the CP command to view UBI tasks:
The result will look like this:
4.3 Slash Mechanism
If a task proof fails validation (late submission, invalid proof, etc.), 5 SWANU will be deducted during the periodic settlement.
5. Exit Procedure
5.1 Stop Receiving New Tasks
5.2 Data Backup
Backup the CP_PATH directory (default: ~/.swan/computing)
5.3 Withdrawal Process
a) Withdraw from collateral account:
b) Withdraw from sequencer account:
c) Withdraw from escrow account:
Initiate withdrawal request:
Confirm withdrawal after 48 hours:
Note: Escrow account balance may fluctuate due to periodic settlements. It's advisable to wait 24 hours after changing taskTypes
before requesting the withdrawal. Confirmation can only be made 48 hours after the initial request. Funds will be withdrawn to the CP's ownerAddress
upon confirmation.
Last updated