From 6fa4057965a5fc028b024774f779fd9a7043509b Mon Sep 17 00:00:00 2001 From: PRavaga Date: Wed, 3 Apr 2024 15:13:36 +0200 Subject: [PATCH] updated migration article Signed-off-by: PRavaga --- docs/stake/proof-of-stake-mining.md | 2 +- docs/use/zarcanum-migration.md | 39 ++++++++++++++++++- static/img/use/zarcanum-migration/button.png | Bin 0 -> 21949 bytes static/img/use/zarcanum-migration/popup.png | Bin 0 -> 16891 bytes 4 files changed, 39 insertions(+), 2 deletions(-) create mode 100644 static/img/use/zarcanum-migration/button.png create mode 100644 static/img/use/zarcanum-migration/popup.png diff --git a/docs/stake/proof-of-stake-mining.md b/docs/stake/proof-of-stake-mining.md index be0d8dc..539aa02 100644 --- a/docs/stake/proof-of-stake-mining.md +++ b/docs/stake/proof-of-stake-mining.md @@ -8,6 +8,6 @@ Proof of stake mining or staking is typically implemented in such way that a ran Open Zano app, make sure the blockchain is synchronised and turn on `Staking` switch. -![alt proof-of-stake-mining](../../static/img/mine/proof-of-stake-mining/proof-of-stake-mining.png "proof-of-stake-mining")_
Proof-of-stake mining
_ +![alt proof-of-stake-mining](../../static/img/mine/proof-of-stake-mining/proof-of-stake-mining.png "proof-of-stake-mining")
Proof-of-stake mining
You can observe your progress in the `Staking` tab of your staking wallet. The amount of earnings depends on the wallet balance. Note that funds, that participate in proof-of-stake will be locked. When you turn `Staking` off, balance will get unlocked right away. You can switch `Staking` on and off without any limitations. diff --git a/docs/use/zarcanum-migration.md b/docs/use/zarcanum-migration.md index 2304652..7313300 100644 --- a/docs/use/zarcanum-migration.md +++ b/docs/use/zarcanum-migration.md @@ -2,4 +2,41 @@ sidebar_position: 10 --- -TBD +# Zarcanum Migration + +With the Zarcanum hardfork, Zano introduces an essential feature for all users: the Auto Migration process. This feature is designed to seamlessly transition your wallet to the post-Zarcanum era, ensuring that you can continue to stake and participate in the network without interruption. + +## What is Auto Migration? + +Auto Migration is an automated process within the Zano wallet that takes pre-Zarcanum outputs and consolidates them. Here's what it entails: + +**Collection**: The wallet automatically gathers all old outputs in your Zano wallet that were created before the Zarcanum hardfork. + +**Consolidation**: These outputs are then consolidated into a few transactions. This step is crucial because it reduces the complexity and size of your wallet, making it more +efficient. + +**Recreation**: The consolidated funds are sent to your own wallet address. This step recreates the outputs in the post-Zarcanum format, making your funds compatible with the new network rules. + +**Staking Eligibility**: By converting your outputs to the new format, your wallet becomes eligible for staking in the post-Zarcanum era. This means you can immediately participate in securing the network and earning staking rewards. + +## How to Use Auto Migration + +Using the Auto Migration feature is simple, thanks to the new wallet interface. Follow these steps to ensure your wallet is ready for staking in the post-Zarcanum era: + +**Look for the Migration Button**: When you open your updated Zano wallet, look for the 'Migrate wallet to Zarcanum' button, typically located at the top of the screen. + +![alt migration-button](../../static/img/use/zarcanum-migration/button.png "migration button")
Migration button
+ +**Initiate Migration**: If your wallet detects pre-Zarcanum outputs, a popup will appear informing you of the number of outputs and the total ZANO amount they represent. For example, "There are 112 outputs with a total amount of 24 ZANO". + +**Understand the Details**: If you're unsure about what 'outputs' means, click on the "What does it mean?" link for a detailed explanation — this will be the article currently in progress. + +**Review the Transaction Fee**: The popup will also display the transaction fee required to migrate your outputs. Ensure you have enough balance to cover this fee. + +**Confirm Migration**: By clicking the 'Migrate' button, the wallet will consolidate your outputs and recreate them in the post-Zarcanum format. + +![alt migration-popup](../../static/img/use/zarcanum-migration/popup.png "migration popup")
Migration popup
+ +**Complete the Process**: The migration transaction will be sent. It require 10 blocks time to get confirmed, just like any other transaction. + +**Post-Migration**: Once the migration is completed, your wallet will be up-to-date with the Zarcanum protocol, and you'll be all set to continue staking and using your wallet as usual. diff --git a/static/img/use/zarcanum-migration/button.png b/static/img/use/zarcanum-migration/button.png new file mode 100644 index 0000000000000000000000000000000000000000..10c3966e117f50b5d60f15927336adcbb8fd5b1b GIT binary patch literal 21949 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

4j$L0J6cr`~9Ic2+L=p)< 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 eZTr?MAV7oyw