Deploy a Bridge Node via XStake (Recommended)
0. Node Overview & Requirements
To become a Wanchain Bridge Validator (also known as a Storeman Node), please ensure your environment meets the following hardware and staking requirements.
Hardware Specifications
CPU
2 cores
RAM
8 GB
Disk Space
80 GB
Operating System
Ubuntu 22.04 and above
Key Policy Details
Minimum Stake: 10,000 WAN
Staking Period: ~30 days (from the 9th of each month to the 9th of the following month)
Node Selection: Only the top 25 nodes by total stake will be selected as active validators. Unselected nodes may withdraw their funds after the 10th of each month.
Node Exit: If you initiate an exit during the month, you can withdraw the staked WAN after the 10th of the following month.
Registration Window: Monthly from 1st 04:00 a.m. UTC – 5th 04:00 a.m. UTC
1. Access the XStake Website
Visit the official XStake portal: https://xstake.wanchain.org/
Navigate to Validator Node > Setup Bridge Node.
Review the requirements thoroughly before proceeding with the setup.
2. Registration and Selection Process
In order to form a WanBridge, 25 Storeman nodes must work together. In order to choose which 25 nodes may form a WanBridge, there is a selection process based on the amount of stake in each node. The 25 nodes with the most WAN staked will be selected. In order to be considered for selection, node operators must register their node with a on-chain transaction.
Process Summary: You will run a script to generate a Work Address, Public Key, and EnodeID. These credentials are required for the registration step.
2.1 Generate Public Key and NodeID
Run the following commands in a secure Linux Ubuntu environment.
Note: Rename or delete osm if it already exists at /home/user
Post-Script Actions:
A folder named
osmwill be generated at/home/user. This folder is critical for running your node.Backup both the script output and the osm folder. If you are running these scripts locally, you will later need to copy the
osmfolder generated by these scripts to your cloud server.
The output will look similar to the example below; keep these values ready for the XStake registration.
2.2 Staking WAN
A) Register as a Storeman Candidate
Once the Wanchain Foundation opens a new Storeman Group, the "Setup Bridge Node" section will activate.
Input Credentials: Enter the Public Key and EnodeID generated in step 2.1.
Stake WAN: Ensure your connected wallet has the required WAN. Enter your staking amount (minimum 10,000 WAN).
Confirm: Review the details and click Confirm to send the registration transaction.
B) Increase Selection Chances
After becoming a "Candidate," you can view your ranking on "My Bridge Staking". To improve your chances of reaching the top 25:
Top-up: Add more self-staked WAN via My Bridge Staking.
Attract Delegations: Open your node to community delegations to increase your total stake weight.
3. Selection Results and Cloud Server Configuration
3.1 Check Selection Result
Verify your status on the My Bridge Staking page:
Selected: Your node has successfully entered the Storeman Group. Proceed to server setup.
Not Selected: Your node failed to make the top 25. You may claim your WAN back.
3.2. Cloud Server Configuration
Recommended Specifications
A public IP without a proxy is required. Cloud and bare metal servers are both supported. The following table shows the requirements:
CPU
2 cores
RAM
8 GB
Disk Space
80 GB
Operating System
Ubuntu 22.04 and above
Prepare Keystore and Nodekey
If you ran the setup scripts locally, please copy the Keystore and Nodekey files which were generated at /home/user to the same path on your cloud server. (See Section 2 for how to generate Public Key and NodeID)
3.3 Install Storeman Service
a) Fund Work Address for Gas Fee
Your Work Address (generated in 2.1) needs a small amount of WAN (e.g., 20 WAN) to pay for gas fees during operation. If the balance is 0, the node will fail.
b) Environment Setup
Open Ports:
Log in to your cloud server platform (such as AWS). Enable the following ports in the firewall inbound settings: TCP 37718/UDP 37718, and enable the following ports in the firewall outbound settings: TCP 26891/ TCP 26892/ TCP 30000 (By default, the outbound rule in most cloud platforms is set to open, so you just keep the default settings of outbound ports). If you modify the ports of the scripts, please add the related port in your firewall.
Initialize the environment:
c) Start Storeman Agent
Start Agent
Follow the steps of scripts
Choose the network of Storeman: mainnet
Input Work Address (generated in section 2.1) of YOUR Storeman node (DO NOT input the following work address!!)
Input the password of your Work Address. If it shows “Password match!”, it means that your password is correct
Choose whether to use KMS to encrypt the private key fragments
AWS Key Management Service (AWS KMS) is a key management serevice provided by Amazon. It can be used to create and manage your master key. Users can choose whether to encrypt private key fragments by using KMS. (Encryption is recommended. It strengthens the security of funds).
If you want to create KMS, you could refer to https://aws.amazon.com/cn/kms/
If you need to use KMS, please enter Y when running the scripts, and you need to provide the relevant information corresponding to the KMS. When it shows “KMS match!” , it means that the KMS-related information you entered is verified correctly.
User Access key ID: AKIAJPUJ**********
User Secret Access Key: KiHjz0g12a***********
KMS Key Region: us-east-1
KMS Key ID (ARN): arn:aws:kms:us-east-1: *****:key/*****
If you don’t need KMS, please enter N when running the scripts and choose not to use KMS for encryption
When you choose not to use the KMS encryption service, please choose whether to save the password locally to support automatic update, which facilitates the automatic upgrade of the agent in the future. Please select Y for agree, and N for refuse.
The script will automatically start Docker to create the Storeman service. If it displays Storeman Start Success, it means the service starts normally.
d) Check Agent Container Status
Status of online and restart times of 0 represent normal status.
e) Verify the connection number of Storeman Peers
Open mpc console through ipc, and check the number of connected MPC nodes in console:
Confirm the returned peer node information, which indicates the current number of MPC node connections. It should be 1 or 25. If the number is abnormal, please contact Wanchain techsupport team.
In the Seleting Time for the Storeman Group, the peer number should be 1,
In the Ready status for the Storeman Group, the peer number should be 25.
Restart Service
If there is something wrong with your node, try to restart your service
4. Storeman Group Running Period
On the My Bridge Staking page, you can monitor your node's real-time status, increase your stake, claim earned rewards, or initiate the exit process.
4.1 Top-up Stake
During the Storeman Group working period, you can top-up WAN to your Storeman.
4.2 Claim Rewards
You can claim your rewards every day. But the deposits can only be claimed when the entire Storeman Group period has concluded.
4.3 Exit
You can choose to enter the next round or exit the selection process before the next Storeman Group is formed.
You can top-up your staking amount at any time.
(Note: a cycle is one month — cycle time subject to change in future)
After a cycle completes, you can claim your both deposits and rewards, and enter the next round.
5 How to Delegate WAN to a Storeman Node
If you want to support a specific Storeman node through delegation, follow these steps:
Locate Delegation Section: Click the "Delegate to Bridge" button on XStake.
Select a Node: Browse the list to find the Storeman node you wish to support.
Manage Delegations:
You can add more WAN to an existing delegation at any time during the operational period.
Rewards: Delegators can withdraw their portion of the rewards daily.
Withdrawal: Both the principal delegation and any unclaimed rewards become available for withdrawal after the cycle ends.
Note on Selection Weight: Increasing the delegation amount improves the Storeman node’s "weight" (ranking), which enhances its chances of being selected for the next group. However, rewards only begin to accrue once the Storeman Group has successfully transitioned to the "Working" status.
6 Appendix
Here is an example of the results of runnin Public Key and EnodeID scripts
Please properly back up information above such as Public Key, Keystore, Nodekey and EnodeID after running scripts.
Last updated