Swaptoshi Migrator is a command line tool to migrate the blockchain data to the latest protocol when hard fork.
The following dependencies need to be installed in order to run applications created with the Klayr SDK:
| Dependencies | Version |
|---|---|
| NodeJS | ^18.20.2 |
| NPM | 9.8.1 or later |
| Swaptoshi Core | 1.0.0-alpha.0 or later |
NOTE: It is important that NodeJS is installed using NVM. Please refer our documentation here.
The following system requirements are recommended to run Swaptoshi Migrator:
- Machines with a minimum of 4 GB RAM.
- Machines with a minimum of 40 GB HDD.
Follow Klayr Documentation guide for setting up the migrator.
Clone the Swaptoshi Migrator repository using Git and initialize the modules.
$ git clone https://github.com/swaptoshi/swaptoshi-migrator
$ cd swaptoshi-migrator
$ git checkout $tag
$ nvm install $(cat .nvmrc)
$ npm install --global yarn
$ yarn; yarn build;
$ PLATFORM=$(uname | tr '[:upper:]' '[:lower:]')
$ ARCH=$(uname -m | sed 's/x86_64/x64/')
$ npx oclif-dev pack --targets=$PLATFORM-$ARCHAfter building the binaries, please extract the appropriate tarball and add it the the PATH environment variable as shown below to continue with the usage.
Requires
jq. If not already installed, please check https://jqlang.github.io/jq/download on how to install.
$ MIGRATOR_VERSION=$(jq -r .version < package.json)
$ PLATFORM=$(uname | tr '[:upper:]' '[:lower:]')
$ ARCH=$(uname -m | sed 's/x86_64/x64/')
$ mkdir ~/swaptoshi-migrator-extract
$ find ./dist -name swaptoshi-migrator-v$MIGRATOR_VERSION-$PLATFORM-$ARCH.tar.gz -exec cp {} ~/swaptoshi-migrator-extract \;
$ tar -C ~/swaptoshi-migrator-extract -xf ~/swaptoshi-migrator-extract/swaptoshi-migrator-v$MIGRATOR_VERSION-$PLATFORM-$ARCH.tar.gz
$ export PATH="$PATH:$HOME/swaptoshi-migrator-extract/swaptoshi-migrator/bin"$ npm install -g swaptoshi-migrator
$ swaptoshi-migrator COMMAND
running command...
$ swaptoshi-migrator (-v|--version|version)
swaptoshi-migrator/2.0.9 darwin-arm64 node-v18.20.1
$ swaptoshi-migrator --help [COMMAND]
USAGE
$ swaptoshi-migrator COMMAND
...NOTE: To verify the final results, please run the following command:
cat genesis_block.blob.SHA256under the output directory and compare the results with other participants on Discord.
swaptoshi-migrator help- display help for swaptoshi-migrator
Swaptoshi Migrator has an extensive set of unit tests. To run the tests, please install Swaptoshi Migrator from source, and then run the command:
$ npm testThe migration guide explains the transition process of Swaptoshi Core using this Swaptoshi Migrator.
| Reason | How |
|---|---|
| Want to chat with our community | Reach them on Discord |
| Found a bug | Open a new issue |
| Want to develop with us | Create a fork |
Copyright 2024 Klayr Holding BV.
Copyright 2016-2024 Lisk Foundation
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.