!!!!!! IMPORTANT NOTES !!!!!!
1) Storeman registration runs from November 10th to November 19th, make sure you have registered by November 19th (Step 2.2)! Don’t miss your chance to make history as part of the first permissionless wanBridge!
2) After setting up your node, please fill in this form in order to have your node information displayed properly on the Wanchain explorer Website and other official informational sites and applications.
!!!!!! IMPORTANT NOTES !!!!!!
Step 1) Download & Install Official Wanchain Desktop Wallet
WanWallet Desktop Download link
Make certain your seed phrase is backed up
2. Storeman Selection
In order to form a wanBridge, 21 Storeman nodes must work together. In order to choose which 21 nodes may form a wanBridge, there is a selection process based on the amount of stake in each node. The 21 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.
Summary of the Storeman setup process:
Run scripts to obtain a Storeman Work Address , Public Key (your Storeman registration in WanWallet will be used), EnodeId String (your Storeman registration in WanWallet will be used), and back up the folder generated by the scripts.
2.1 Generate Public Key and EnodeID
Run scripts in Linux Ubuntu environment, and make sure the environment is safe
Rename or delete osm if it already exists at /home/user
wget https://raw.githubusercontent.com/wanchain/two-way-bridge-contracts/master/helpscript/envSetup.sh && chmod +x envSetup.sh && ./envSetup.shAfter you run the scripts above, there will be a folder osm generated at /home/user. The folder osm will be used when you start your Storeman node.
Backup BOTH the script output and also the osm folder. If you are running these scripts locally, you will later need to copy the osm folder generated by these scripts to your cloud server.
Note:
The contents marked in bold will be used once you register your Storeman in WanWallet.
!!!!!!!!!!!!!!! Important !!!!!!!!!!!!!!!==================================================
Please Backup Your Work Address
“0x733452e4b0b6e0ae2248b0b46918d64bc8771bf2”
==================================================
Please Backup Your Work Public Key
0x2d54ecef44b32fa8b7c6e8c1c4e64e2fbc96c98ee027cd7032f53d89a97be3c0a9a10377c9dc688be2b594000d0e914abbf11b8a476b63c0a6ab2be4a64c3792
==================================================
Please Backup Your Keystore JSON String
{“address”:”733452e4B0B6E0AE2248B0b46918d64BC8771BF2",”crypto”:{“cipher”:”aes-128-ctr”,”ciphertext”:”c6d8fbe6a885b8471f4c22835db0cbac7fbfe0c9f2f397d1eadd9840e9e5d4f3",”cipherparams”:{“iv”:”8d569d4c96d6ddd69de9a3f8a36a4216"},”kdf”:”scrypt”,”kdfparams”:{“dklen”:32,”n”:262144,”p”:1,”r”:8,”salt”:”2f0c2c117891a3e9f26766b591a6998c1cfeb2aff9e411f301743d9bd1da7bdb”},”mac”:”93bf267476286be3b8296d665107f412c1f7eae56afc4fce9a78ca28bdeb4693"},”crypto2":{“cipher”:”aes-128-ctr”,”ciphertext”:”129e452adbd5bbd2ba9ae6bea7b54641e6c32064cb25d813dc62debbe4335070",”cipherparams”:{“iv”:”736febbacaf06e4e61c1d0cf8010f8e6"},”kdf”:”scrypt”,”kdfparams”:{“dklen”:32,”n”:262144,”p”:1,”r”:8,”salt”:”88e483a2fce18c6efc289111f70010fd6833fe9d579069902ae827c109017766"},”mac”:”a894cd1b61a6ab7d92d53da3ed9da07c7d6ddb83d29212f4ca44ad55468c0cdb”},”id”:”7cb62af2-d704–4d09–9c80–85cfa309ca82",”version”:3,”waddress”:”022d54ecef44b32fa8b7c6e8c1c4e64e2fbc96c98ee027cd7032f53d89a97be3c00315a46e2648cbf3adc080987846b030f3dbda9a3c9af1e753333ba185c6689511"}
==================================================
Please Backup Your Nodekey String
6c99ddaaa5664bf8a0c36647b1a1a99dedb7f821415f6b6eeee9c1e60ac9d76b==================================================
Please Backup Your EnodeId String
0xa277dcfd46eaa436b795bdda227eb921ede625fd8560f33781a7ba273decfb4b09f5d41f9abdb3abedb10db15ef5b471b6405228a889e1e6d48faf0e2e9ed848
2.2 Stake WAN using WanWallet Desktop
A) Go to the Storeman staking page
Open WanWallet Desktop, go to Storeman > Storeman. This is the page for your Storeman to stake. Please transfer a small amount of WAN to your Storeman Work Address for gas fees which are required for your node to operate. The transaction will fail if the validator address has 0 WAN.
B) Register as a Storeman Candidate
After the Wanchain Foundation sends a transaction to begin a new Storeman Group, it will be visible in the Open Group List:
Input the Public Key and Enode ID you generated by the previously run script
Select the account which you want to stake from and the amount of WAN you want to stake. After you confirm this information, you can see your staking details in the Storeman List.
Add Additional Stake or Attract Delegations to Increase Selection Chances
After your Storeman becomes a Candidate, you can see the ranking of all Storeman Nodes, and top-up funds in theWanWallet.
You can also accept delegations from individuals in order to increase your chance of getting selected.
3. Check Selection Results, and Set Up Storeman Node if Selected
3.1 Check Election Result
You can check the Storeman selections results directly through the desktop wallet. If the status is Selected, it means that your Storeman node successfully entered the Storeman Group. If the Status is Not Selected, it means that your Storeman node failed to enter the group.
The Storeman nodes which fail to be selected can claim back their WAN.
3.2. Cloud Server Setup
Recommended Specifications:
A public IP without a proxy is required. Cloud and bare metal servers are both supported. The following table shows the requirements:
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 Keystore and Nodekey)
3.3 Install Storeman Service:
a) Transfer Small Amount of WAN to Work Address
Double check you have already transferred a small amount of WAN to your Storeman Work Address for gas fees. The transaction will fail if the Storeman work address has 0 WAN.
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. If you modify the ports of the scripts, please add the related port in your firewall.
Initialize the environment:
sudo chown $USER ~/osmrm init_open_storeman_EnvV3.sh
wget https://raw.githubusercontent.com/wanchain/two-way-bridge-contracts/master/helpscript/init_open_storeman_EnvV3.sh && chmod +x init_open_storeman_EnvV3.sh && ./init_open_storeman_EnvV3.sh
rm startStoremanV3.sh
wget https://raw.githubusercontent.com/wanchain/two-way-bridge-contracts/master/helpscript/startStoremanV3.sh && chmod +x startStoremanV3.sh
c) Configure KMS
Users can use shared key fragments through KMS. (It is highly recommended as it will greatly enhance the security of your funds).
If you skip this part, you can go to Section d) Start Storeman Agent.
Record the information listed below as you go throught the following steps:
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/*****
AWS KMS Setup
Create an AWS user (mpc)
Log in to AWS console and go to services. Then select “IAM”. On the left side you can see a section called “Users”
Save your User Access key ID and Secret Access Key:
Create AWS KMS secret:
The primary resources in AWS KMS are customer master keys (CMKs). CMKs are either customer managed or AWS managed. Let’s take a look at how to create a customer master key in AWS.
Log in to AWS console and go to services. Then select “Key Management Service (KMS)”. On the left side you can see a section called “Customer managed keys”. Navigate to that section. Then select “Create Key” on top left.
Follow the steps as follows:
Please record the following two pieces of information from ARN (Amazon Resource Name):
KMS Key Region: us-east-1
KMS Key ID (ARN): arn:aws:kms:us-east-1: *****:key/*****
d) Start Storeman Agent
cd ~/osm/./startStoremanV3.sh
e) Check Agent Container Status
sudo docker exec -it openstoreman_mainnet pm2 l
Status of online and restart times of 0 represent normal status.
View your log using following commands:
# agent logsudo docker exec -it openstoreman_mainnet pm2 log 2
# mpc log
sudo docker exec -it openstoreman_mainnet pm2 log 1
f) Verify the connection number of Storeman Peers
Open mpc console through ipc, and check the number of connected MPC nodes in console:
sudo docker exec -it openstoreman_mainnet ./schnorrmpc/bin/schnorrmpc attach ./schnorrmpc/data/gwan.ipcadmin.peers.length
Confirm the returned peer node information, which indicates the current number of MPC node connections. It should be more than 0.
4. Storeman Group Running Period4.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: in the testnet, a cycle is 5 days, while in the mainnet, the first cycle is 49 days , following cycles will be 30 days— 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
Find the Delegation button:
Click on New Delegation, and choose a Storeman to delegate to:
You can also top-up WAN delegations to the same Storeman during the Storeman Group running period. You can withdraw your rewards each day. After a cycle completes, you can withdraw both deposits and rewards.
Please note that the delegation amount to a Storeman can increase this Storeman’s weight. But the rewards will only be counted after the Storeman Group starts working.
6. Appendix
Here is an example of the results of runnin Public Key and EnodeID scripts
ubuntu@ip-10-1-1-105:~$ wget https://raw.githubusercontent.com/wanchain/two-way-bridge-contracts/master/helpscript/envSetup.sh && chmod +x envSetup.sh && ./envSetup.sh--2020-09-28 09:41:22-- https://raw.githubusercontent.com/wanchain/two-way-bridge-contracts/master/helpscript/envSetup.sh
Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 151.101.52.133
Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|151.101.52.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 2946 (2.9K) [text/plain]
Saving to: ‘envSetup.sh.1’envSetup.sh.1 100%[===================================================================================================================>] 2.88K --.-KB/s in 0s 2020-09-28 09:41:22 (54.6 MB/s) - ‘envSetup.sh.1’ saved [2946/2946]==========================================
| Welcome to Mainnet Validator Deploy | !!!!!! WARNING Please Remember Your Password !!!!!!!!
!!!!!!Otherwise You will lose all your assets!!!!!!!!
Enter your password of validator account:
Confirm your password of validator account:latest: Pulling from wanchain/openstoremanagent
419e7ae5bb1e: Already exists
848839e0cd3b: Already exists
de30e8b35015: Already exists
258fdea6ea48: Already exists
ca1b0e608d7b: Already exists
dd8cac1f0c02: Already exists
38a17b67fe0d: Already exists
e19d627f8e7d: Already exists
3944518be6fb: Already exists
31dfd4404907: Already exists
95d02f3cb2af: Pull complete
abe226af4359: Pull complete
62f13a73a9a6: Pull complete
2b43fcba66b2: Pull complete
Digest: sha256:d8bd070ebceaeba3be894a23d454fb138b9f16c4f1b8490b2597e9c0b9ad409c
Status: Downloaded newer image for wanchain/openstoremanagent:latest
docker.io/wanchain/openstoremanagent:latest
WARN [09-28|09:41:40] No etherbase set and no accounts found as default
INFO [09-28|09:41:40] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/pos cache=16 handles=256
INFO [09-28|09:41:40] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/rblocaldb cache=16 handles=256
INFO [09-28|09:41:40] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/eplocaldb cache=16 handles=256
INFO [09-28|09:41:40] Starting peer-to-peer node instance=gwan/v2.1.5/linux-amd64/go1.13.4
INFO [09-28|09:41:40] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/chaindata cache=128 handles=8192
INFO [09-28|09:41:40] Writing default main-net genesis block
INFO [09-28|09:41:40] Initialised chain configuration config="{ChainID: 1 Byzantium: 0 Engine: ethash}"
INFO [09-28|09:41:40] Disk storage enabled for ethash caches dir=/osm/schnorrmpc/data/gwan/wanhash count=3
INFO [09-28|09:41:40] Disk storage enabled for ethash DAGs dir=/root/.wanhash count=2
INFO [09-28|09:41:40] Initialising Wanchain protocol versions="[63 62]" network=1
INFO [09-28|09:41:40] Loaded most recent local header number=0 hash=0x0376899c001618fc7d5ab4f31cfd7f57ca3a896ccc1581a57d8f129ecf40b840 td=1048576
INFO [09-28|09:41:40] Loaded most recent local full block number=0 hash=0x0376899c001618fc7d5ab4f31cfd7f57ca3a896ccc1581a57d8f129ecf40b840 td=1048576
INFO [09-28|09:41:40] Loaded most recent local fast block number=0 hash=0x0376899c001618fc7d5ab4f31cfd7f57ca3a896ccc1581a57d8f129ecf40b840 td=1048576
INFO [09-28|09:41:40] loaded cq cache eclapsed=270ns length=0
INFO [09-28|09:41:40] Regenerated local transaction journal transactions=0 accounts=0
INFO [09-28|09:41:40] Starting P2P networking
INFO [09-28|09:41:40] RLPx listener up self="enode://a277dcfd46eaa436b795bdda227eb921ede625fd8560f33781a7ba273decfb4b09f5d41f9abdb3abedb10db15ef5b471b6405228a889e1e6d48faf0e2e9ed848@[::]:17717?discport=0"
INFO [09-28|09:41:40] IPC endpoint opened: /osm/schnorrmpc/data/gwan.ipc
INFO [09-28|09:41:45] IPC endpoint closed: /osm/schnorrmpc/data/gwan.ipc
INFO [09-28|09:41:45] Blockchain manager stopped
INFO [09-28|09:41:45] Stopping Wanchain protocol
INFO [09-28|09:41:45] Wanchain protocol stopped
INFO [09-28|09:41:45] Transaction pool stopped
INFO [09-28|09:41:45] Database closed database=/osm/schnorrmpc/data/gwan/chaindata
"0x733452e4b0b6e0ae2248b0b46918d64bc8771bf2"
INFO [09-28|09:41:46] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/pos cache=16 handles=256
INFO [09-28|09:41:46] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/rblocaldb cache=16 handles=256
INFO [09-28|09:41:46] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/eplocaldb cache=16 handles=256
INFO [09-28|09:41:46] Starting peer-to-peer node instance=gwan/v2.1.5/linux-amd64/go1.13.4
INFO [09-28|09:41:46] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/chaindata cache=128 handles=8192
INFO [09-28|09:41:47] Initialised chain configuration config="{ChainID: 1 Byzantium: 0 Engine: ethash}"
INFO [09-28|09:41:47] Disk storage enabled for ethash caches dir=/osm/schnorrmpc/data/gwan/wanhash count=3
INFO [09-28|09:41:47] Disk storage enabled for ethash DAGs dir=/root/.wanhash count=2
INFO [09-28|09:41:47] Initialising Wanchain protocol versions="[63 62]" network=1
INFO [09-28|09:41:47] Loaded most recent local header number=0 hash=0x0376899c001618fc7d5ab4f31cfd7f57ca3a896ccc1581a57d8f129ecf40b840 td=1048576
INFO [09-28|09:41:47] Loaded most recent local full block number=0 hash=0x0376899c001618fc7d5ab4f31cfd7f57ca3a896ccc1581a57d8f129ecf40b840 td=1048576
INFO [09-28|09:41:47] Loaded most recent local fast block number=0 hash=0x0376899c001618fc7d5ab4f31cfd7f57ca3a896ccc1581a57d8f129ecf40b840 td=1048576
INFO [09-28|09:41:47] loaded cq cache eclapsed=310ns length=0
INFO [09-28|09:41:47] Loaded local transaction journal transactions=0 dropped=0
INFO [09-28|09:41:47] Regenerated local transaction journal transactions=0 accounts=0
INFO [09-28|09:41:47] Starting P2P networking
INFO [09-28|09:41:47] RLPx listener up self="enode://a277dcfd46eaa436b795bdda227eb921ede625fd8560f33781a7ba273decfb4b09f5d41f9abdb3abedb10db15ef5b471b6405228a889e1e6d48faf0e2e9ed848@[::]:17717?discport=0"
INFO [09-28|09:41:47] IPC endpoint opened: /osm/schnorrmpc/data/gwan.ipc
INFO [09-28|09:41:49] IPC endpoint closed: /osm/schnorrmpc/data/gwan.ipc
INFO [09-28|09:41:49] Blockchain manager stopped
INFO [09-28|09:41:49] Stopping Wanchain protocol
INFO [09-28|09:41:49] Wanchain protocol stopped
INFO [09-28|09:41:49] Transaction pool stopped
INFO [09-28|09:41:49] Database closed database=/osm/schnorrmpc/data/gwan/chaindata
INFO [09-28|09:41:50] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/pos cache=16 handles=256
INFO [09-28|09:41:50] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/rblocaldb cache=16 handles=256
INFO [09-28|09:41:50] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/eplocaldb cache=16 handles=256
INFO [09-28|09:41:50] Starting peer-to-peer node instance=gwan/v2.1.5/linux-amd64/go1.13.4
INFO [09-28|09:41:50] Allocated cache and file handles database=/osm/schnorrmpc/data/gwan/chaindata cache=128 handles=8192
INFO [09-28|09:41:50] Initialised chain configuration config="{ChainID: 1 Byzantium: 0 Engine: ethash}"
INFO [09-28|09:41:50] Disk storage enabled for ethash caches dir=/osm/schnorrmpc/data/gwan/wanhash count=3
INFO [09-28|09:41:50] Disk storage enabled for ethash DAGs dir=/root/.wanhash count=2
INFO [09-28|09:41:50] Initialising Wanchain protocol versions="[63 62]" network=1
INFO [09-28|09:41:50] Loaded most recent local header number=0 hash=0x0376899c001618fc7d5ab4f31cfd7f57ca3a896ccc1581a57d8f129ecf40b840 td=1048576
INFO [09-28|09:41:50] Loaded most recent local full block number=0 hash=0x0376899c001618fc7d5ab4f31cfd7f57ca3a896ccc1581a57d8f129ecf40b840 td=1048576
INFO [09-28|09:41:50] Loaded most recent local fast block number=0 hash=0x0376899c001618fc7d5ab4f31cfd7f57ca3a896ccc1581a57d8f129ecf40b840 td=1048576
INFO [09-28|09:41:50] loaded cq cache eclapsed=340ns length=0
INFO [09-28|09:41:50] Loaded local transaction journal transactions=0 dropped=0
INFO [09-28|09:41:50] Regenerated local transaction journal transactions=0 accounts=0
INFO [09-28|09:41:50] Starting P2P networking
INFO [09-28|09:41:50] RLPx listener up self="enode://a277dcfd46eaa436b795bdda227eb921ede625fd8560f33781a7ba273decfb4b09f5d41f9abdb3abedb10db15ef5b471b6405228a889e1e6d48faf0e2e9ed848@[::]:17717?discport=0"
INFO [09-28|09:41:50] IPC endpoint opened: /osm/schnorrmpc/data/gwan.ipc
INFO [09-28|09:41:50] IPC endpoint closed: /osm/schnorrmpc/data/gwan.ipc
INFO [09-28|09:41:50] Blockchain manager stopped
INFO [09-28|09:41:50] Stopping Wanchain protocol
INFO [09-28|09:41:50] Wanchain protocol stopped
INFO [09-28|09:41:50] Transaction pool stopped
INFO [09-28|09:41:50] Database closed database=/osm/schnorrmpc/data/gwan/chaindata
!!!!!!!!!!!!!!! Important !!!!!!!!!!!!!!!
==================================================
Please Backup Your Validator Address
"0x733452e4b0b6e0ae2248b0b46918d64bc8771bf2"
==================================================
Please Backup Your Validator Public Key
0x2d54ecef44b32fa8b7c6e8c1c4e64e2fbc96c98ee027cd7032f53d89a97be3c0a9a10377c9dc688be2b594000d0e914abbf11b8a476b63c0a6ab2be4a64c3792
==================================================
Please Backup Your Keystore JSON String{"address":"733452e4B0B6E0AE2248B0b46918d64BC8771BF2","crypto":{"cipher":"aes-128-ctr","ciphertext":"c6d8fbe6a885b8471f4c22835db0cbac7fbfe0c9f2f397d1eadd9840e9e5d4f3","cipherparams":{"iv":"8d569d4c96d6ddd69de9a3f8a36a4216"},"kdf":"scrypt","kdfparams":{"dklen":32,"n":262144,"p":1,"r":8,"salt":"2f0c2c117891a3e9f26766b591a6998c1cfeb2aff9e411f301743d9bd1da7bdb"},"mac":"93bf267476286be3b8296d665107f412c1f7eae56afc4fce9a78ca28bdeb4693"},"crypto2":{"cipher":"aes-128-ctr","ciphertext":"129e452adbd5bbd2ba9ae6bea7b54641e6c32064cb25d813dc62debbe4335070","cipherparams":{"iv":"736febbacaf06e4e61c1d0cf8010f8e6"},"kdf":"scrypt","kdfparams":{"dklen":32,"n":262144,"p":1,"r":8,"salt":"88e483a2fce18c6efc289111f70010fd6833fe9d579069902ae827c109017766"},"mac":"a894cd1b61a6ab7d92d53da3ed9da07c7d6ddb83d29212f4ca44ad55468c0cdb"},"id":"7cb62af2-d704-4d09-9c80-85cfa309ca82","version":3,"waddress":"022d54ecef44b32fa8b7c6e8c1c4e64e2fbc96c98ee027cd7032f53d89a97be3c00315a46e2648cbf3adc080987846b030f3dbda9a3c9af1e753333ba185c6689511"}==================================================
Please Backup Your Nodekey String6c99ddaaa5664bf8a0c36647b1a1a99dedb7f821415f6b6eeee9c1e60ac9d76b==================================================
Please Backup Your EnodeId String0xa277dcfd46eaa436b795bdda227eb921ede625fd8560f33781a7ba273decfb4b09f5d41f9abdb3abedb10db15ef5b471b6405228a889e1e6d48faf0e2e9ed848
Please properly back up information above such as Public Key, Keystore, Nodekey and EnodeID after running scripts.
About Wanchain
Wanchain is the infrastructure connecting the decentralized financial world. Wanchain’s live cross-blockchain solution is EVM-based, includes optional private transactions, and provides a decentralized, permissionless, and secure approach for interoperability. Wanchain has employees globally with teams in China, the USA, and other team members around the world in Asia, Africa, and Europe.
Written By
Bryan Ye
Director of Marketing at Wanchain
