From 01a41c27556efc1f3813647ff09a2ca76c256120 Mon Sep 17 00:00:00 2001 From: axenteoctavian Date: Tue, 30 Sep 2025 17:10:07 +0300 Subject: [PATCH 1/5] Deploy sovereign chain documentation updated --- docs/sovereign/local-setup.md | 29 +++++++++++++---------------- 1 file changed, 13 insertions(+), 16 deletions(-) diff --git a/docs/sovereign/local-setup.md b/docs/sovereign/local-setup.md index f5e8a3bdc..0be5ff5b6 100644 --- a/docs/sovereign/local-setup.md +++ b/docs/sovereign/local-setup.md @@ -80,7 +80,7 @@ cd sovereignBridge # Owner Configuration WALLET="~/wallet.pem" - # Main Chain Constants + # Network Configuration MAIN_CHAIN_ELASTIC=https://testnet-index.multiversx.com PROXY = https://testnet-gateway.multiversx.com CHAIN_ID = T @@ -91,7 +91,7 @@ cd sovereignBridge ``` :::note - - **SOVEREIGN_DIRECTORY, TXS_OUTFILE_DIRECTORY, CONTRACTS_DIRECTORY** - represent the paths to the location where the deployment scripts will generate the outputs. + - **SOVEREIGN_DIRECTORY, OUTFILE_PATH, CONTRACTS_DIRECTORY** - represent the paths to the location where the deployment scripts will generate the outputs. - **WALLET** - should represent the wallet generated at Step 2.2. - **MAIN_CHAIN_ELASTIC** - represents the elasticsearch db from the main chain - **PROXY** - in this case, for the purpose of the test, the used proxy is the testnet one. Of course that the proper proxy should be used when deploying your own set of contracts depending on the development phase of your project. @@ -109,6 +109,15 @@ cd sovereignBridge source script.sh ``` +6. Create and deploy main chain observer: + ```bash + createAndDeployMainChainObserver + ``` + + :::info + After running this command wait until the observer is fully synchronized. + ::: + 6. Deploy all cross-chain contracts on main chain and deploy Sovereign Chain with all required services: ```bash deploySovereignWithCrossChainContracts sov @@ -118,7 +127,8 @@ cd sovereignBridge `deploySovereignWithCrossChainContracts` command will: - deploy all main chain smart contracts and update sovereign configs - deploy sovereign nodes and the main chain observer - - `sov` is the prefix for ESDT tokens in the sovereign chain - it can be changed to any string consisting of 4 lowercase alphanumeric characters + - `sov` is the prefix for ESDT tokens in the sovereign chain - it can be changed to any string consisting of 1-4 lowercase alphanumeric characters + - if no prefix is provided, a random one will be generated ::: ### Step 3: Deploy services @@ -139,16 +149,3 @@ ___ ```bash stopAndCleanSovereign ``` - -## Upgrade and reset local Sovereign Chain - -1. Navigate to `mx-chain-sovereign-go/scripts/testnet/sovereignBridge`. - Source the script: - ```bash - source script.sh - ``` - -2. Upgrade and reset the chain, and all sovereign services: - ```bash - sovereignUpgradeAndReset - ``` From c8e6e762051449b8969275dd2f7d4b0807c1bb0d Mon Sep 17 00:00:00 2001 From: axenteoctavian Date: Tue, 30 Sep 2025 17:16:06 +0300 Subject: [PATCH 2/5] update 2 --- docs/sovereign/local-setup.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/sovereign/local-setup.md b/docs/sovereign/local-setup.md index 0be5ff5b6..a533a3a47 100644 --- a/docs/sovereign/local-setup.md +++ b/docs/sovereign/local-setup.md @@ -123,11 +123,12 @@ cd sovereignBridge deploySovereignWithCrossChainContracts sov ``` - :::info - `deploySovereignWithCrossChainContracts` command will: - - deploy all main chain smart contracts and update sovereign configs - - deploy sovereign nodes and the main chain observer - - `sov` is the prefix for ESDT tokens in the sovereign chain - it can be changed to any string consisting of 1-4 lowercase alphanumeric characters + :::info + `deploySovereignWithCrossChainContracts` command will: + - deploy all smart contracts on the main chain and update the sovereign chain configuration + - set up sovereign nodes and deploy the main chain observer + - use `sov` as the default prefix for ESDT tokens on the sovereign chain + (can be changed to any 1–4 character lowercase alphanumeric string; **must be unique across all deployed sovereign chains**) - if no prefix is provided, a random one will be generated ::: From 056d03f5845a930ba4786e376a532fd8ffaf420e Mon Sep 17 00:00:00 2001 From: axenteoctavian Date: Thu, 9 Oct 2025 13:45:17 +0300 Subject: [PATCH 3/5] fixes after review --- docs/sovereign/local-setup.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/sovereign/local-setup.md b/docs/sovereign/local-setup.md index a533a3a47..405acdc9a 100644 --- a/docs/sovereign/local-setup.md +++ b/docs/sovereign/local-setup.md @@ -80,7 +80,7 @@ cd sovereignBridge # Owner Configuration WALLET="~/wallet.pem" - # Network Configuration + # Main Chain Constants MAIN_CHAIN_ELASTIC=https://testnet-index.multiversx.com PROXY = https://testnet-gateway.multiversx.com CHAIN_ID = T @@ -115,7 +115,7 @@ cd sovereignBridge ``` :::info - After running this command wait until the observer is fully synchronized. + After running this command, one should wait until the observer is fully synchronized. ::: 6. Deploy all cross-chain contracts on main chain and deploy Sovereign Chain with all required services: @@ -128,7 +128,7 @@ cd sovereignBridge - deploy all smart contracts on the main chain and update the sovereign chain configuration - set up sovereign nodes and deploy the main chain observer - use `sov` as the default prefix for ESDT tokens on the sovereign chain - (can be changed to any 1–4 character lowercase alphanumeric string; **must be unique across all deployed sovereign chains**) + (can be changed to any 1–4 character lowercase alphanumeric string and **must be unique across all deployed sovereign chains**) - if no prefix is provided, a random one will be generated ::: From 36f525366868da5d368a1f6c759bbc670057a7e9 Mon Sep 17 00:00:00 2001 From: axenteoctavian Date: Wed, 22 Oct 2025 15:28:34 +0300 Subject: [PATCH 4/5] fixes after review --- docs/sovereign/local-setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sovereign/local-setup.md b/docs/sovereign/local-setup.md index 405acdc9a..0dab86775 100644 --- a/docs/sovereign/local-setup.md +++ b/docs/sovereign/local-setup.md @@ -80,7 +80,7 @@ cd sovereignBridge # Owner Configuration WALLET="~/wallet.pem" - # Main Chain Constants + # Main Chain network config MAIN_CHAIN_ELASTIC=https://testnet-index.multiversx.com PROXY = https://testnet-gateway.multiversx.com CHAIN_ID = T From 1f029fc8e2a084bb22398610b208d59fee76f5ef Mon Sep 17 00:00:00 2001 From: axenteoctavian Date: Wed, 22 Oct 2025 15:28:56 +0300 Subject: [PATCH 5/5] fixes after review --- docs/sovereign/local-setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sovereign/local-setup.md b/docs/sovereign/local-setup.md index 0dab86775..988f0ef89 100644 --- a/docs/sovereign/local-setup.md +++ b/docs/sovereign/local-setup.md @@ -80,7 +80,7 @@ cd sovereignBridge # Owner Configuration WALLET="~/wallet.pem" - # Main Chain network config + # Main chain network config MAIN_CHAIN_ELASTIC=https://testnet-index.multiversx.com PROXY = https://testnet-gateway.multiversx.com CHAIN_ID = T