Skip to main content

Samurai

Samurai is an open source browser plug-in wallet tool that supports the Alaya and PlatON networks, supporting wallet creation, sending and receiving ATP and LAT, and allowing web DApps to interact with the Alaya and PlatON networks.

Samurai only generates wallet keys on your device, so only you can access your wallet account and data. You therefore need to keep your wallet key (private key, mnemonic) and wallet password safe. Samurai currently only supports Chrome.

Note#

Samurai is a browser plug-in wallet modified based on MetaMask's open source code version 8.0.10, which is mainly adapted to the Alaya network and PlatON network. Due to some bugs in the official MetaMask itself. Please pay attention when using Samurai:

  • Do not click the edit button to edit transaction related information on the transaction confirmation page.
  • On the transaction confirmation page, please make sure that the receiving address is correct before clicking the confirm button.

Installation#

  • Download Samurai plug-in package from Release address.
  • Unzip Samurai plug-in package.
  • Open chrome browser,input chrome://extensions/ in the address bar and Enter,enter the management page of chrome extension program.
chrome://extensions/
  • Open the switch of developer mode, select to load the unzipped extension program, import the unzipped catalogue of the 2nd step.

Initial Use#

  1. Click the Samurai icon on the right side of browser address bar, when you use it for the first time, there will be a prompt as shown below:

  1. Click “Get Started”,there is two options - Create wallet and iImport wallet.

  • Import wallet:

Click “import wallet”，enter the guide page, click “I agree” and enter the next step. Then input the Seed phrase and password of this wallet, and click “import”->Once all steps is completed, you can enter the mainpage.

Note: The current Samurai mnemonic phrase generation path has problems, and the import of mnemonic phrases generated by external wallet applications is not supported. It is recommended to import it through the private key after the initial creation.

  • Create wallet:

Click “create wallet”, enter the boot page, click “I agree” and enter the next step. Then input the password of new wallet, and click “create”.

Go to the mnemonic backup page, click "CLICK HERE TO REVEAL SECRET WORDS" to show the mnemonic words of the new account (mnemonic words need to be prevented from being seen by others, Samurai uses the password you provided to encrypt this information locally and will never send it to the server), click “Reminder me later” to go directly to the Samurai mainpage of the new account(Skip not recommended).

Click “ext step”, re-input the mnemonic words with the right sequence, click “confirm”->Once all steps is completed, you can enter the mainpage.

Transaction Operation#

Send ATP#

  • In the Alaya main network, click "send" on the mainpage, and you can see the Add Recipient page.

  • Enter or select the address for transfer between my accounts, and go to the transaction form page.

  • The transaction form must fill in the number of transaction ATP, and the system will give you the default transaction fee. You can also make appropriate adjustments to this value. After completing the form, click “next” to enter the page to be confirmed, which will show the total number of ATP spent (including the handling fee).

  • Click “Confirm” to complete the sending of ATP, and you can view the transaction status in the Activity on the mainpage.

Add and send Token#

Add Token#

  • Enter the mainpage, click Assets -> Add Token.

  • Pop-up the “Add Tokens” page, add the existed Token Contract Address of connected network, Samurai will automatically to get token’s symbol and exact decimal point, click “Next” when you completed all the steps.

  • Enter the confirm page of Add Tokens, there will show the balance of this token under this account, click “Add Tokens”to add successfully.

  • After the account is successfully added, go to the token display screen, which displays the balance of tokens, or you can click “send” to enter the token transfer page. At the same time, the asset list of the mainpage will display the token assets.

Token Transfer#

  • You can click "send" in the account token display page to initiate the token transfer, or you can click "send" of the corresponding token in the asset list inof the mainpage.

  • Enter the add recipient page, enter or select the address for transfer between my accounts as you would for sending ATP, and enter the transaction form page.

  • The transaction form must enter the number of tokens for the transaction. Click “Next” to enter the transaction confirmation page.

  • Click “Confirm” to complete the sending of tokens, you can view the transaction status in the transaction list on the mainpage.

Create and manage an account#

Create Account#

  • Click on the wallet avatar at the top right of the Samurai homepage and click on Create Account in the drop down menu that appears.

  • Go to create account form page, enter account name (example below is wallet 2), click create button.

  • Successful creation will bring you to the mainpage of the newly created wallet, click on the wallet avatar at the top right to see a list of all wallet accounts.

Import Account#

  • Click on the wallet avatar at the top right of the Samurai page and in the drop down menu that appears click on import account.

  • enter import account form page, you can choose two import modes (private key/keystore json file), choose private key mode, paste private key into the form, then click import button.

  • Choose import keystore file mode, select JSON file type, click select file, select keystore file from local directory, then enter keystore file passphrase, finally click import button.

  • If the import is successful you will enter the main page of the newly imported wallet, click on the wallet avatar at the top right to see a list of all wallet accounts.

Network Management#

By default, Samurai connects to the PlatON network, or it can connect to other networks.

Choose networks#

Samurai have added PlatON Main Network, PlatON dev network, Alaya Network, Alaya dev Network as default, you can choose a network to connect. Click “Networks” and choose a network from the four networks to connect.

Add Custom Network#

  • Click “Networks”-> Custom RPC.

  • Enter the new network configuration page, and click “Save” after configuring the form.

  • Samurai will try to connect to the node, and if the node fails to connect, it will pop up a corresponding dialog prompt.

  • If the connection is successful, a network list option will be added to the network list.

Switch language#

  • Click on the wallet avatar at the top right of the Samurai homepage and click on Settings in the drop down menu that appears.

  • Go to main settings page, then click General -> Go to Current Language drop down box to select (multiple languages supported).