Nodle Portal

Getting Started

Introduction

For Users

For Developers

More Info

Introduction to Nodle Portal

💡

This only applies to the Nodle Legacy Parachain and is not useful when using ZKsync Era.

The Nodle portal is the most comprehensive solution for interacting with the Nodle chain on a web browser. It is based on Polkadot substrate.

However, it is designed for more advanced users and more complex transitions.

💡

We recommend you use the Nodle Client for basic management of your NODL wallet (like viewing your balance and transactions, and sending NODL tokens and NFTs).

To access the Nodle portal, go to https://nodleprotocol.io. Here’s what it looks like:

This is a dashboard view of all your accounts and transactions.

In the Nodle portal, you can create your account, manage your account, send and receive tokens, and define/manage various transactions on the chain as a developer.

Creating Account

On Web Browser

⚠️

Important: Please note that in-browser account creation and storage is NOT secure, and it is done at your own risk. If you’re looking for safer and longer term wallets, then we recommend creating your accounts on the Nodle App or on browser extensions such as Polkadot JS, Ledger, or Talisman.

To create an account on the web browser, follow these steps.

Go to Nodle portal - https://nodleprotocol.io/#/accounts. Select Nodle Mainnet on the top left corner (next to the Nodle logo).

Navigate to Settings. Note that this must be done prior to creating an account.

Under the account options section, turn on in-browser account creation and storage. Select the option, “Allow in-browser account storage” as shown below.

Save your changes.

Navigate to Accounts.

Add a new account by clicking on the + button (+ Account). A pop-window appears.

The system displays a mnemonic seed, by default, as shown in the figure here. If required, you can also store the seeds in the “raw” format by selecting the Raw seed option from the Mnemonic drop-down menu. Store the seed safely and confirm the same by selecting the check box at the bottom.

💡

Note: Select Advanced creation options only if you need to use alternative cryptographic curves for managing your wallet keys. For example, if you are importing your old Nodle App wallet, then you may need to use crypto keys.

Click Next.
Provide account details. Give your account a unique name. Then, enter a strong password.

⚠️

Important: You must use a lengthy and randomly generated password. We recommend you use a password generator. Manual entry of passwords do not work.

Click Next.
Save your account. On clicking Save, a copy of your mnemonic seed is downloaded to your system automatically.

⚠️

Important: Save this file in a safe location. This is crucial when restoring or recovering your wallets.

With Polkadot JS

💡

Note: If you check your newly created account on Subscan, it won't show up until you deposit some NODL tokens.

Nodle is built upon Polkadot Substrate, making it compatible with most Polkadot wallets. For this tutorial, we will use the official wallet.

Go to the nodleprotocol.io (Nodle Portal), https://nodleprotocol.io/#/accounts

💡

Note: We recommend using a Chrome-based browser like Chrome or Brave. If you are using Brave (which you should be) please turn off ‘shields’ as it can cause errors.

Make sure you are connecting to the Nodle Chain Mainnet. Sometimes, the wallet will default to another blockchain (as we interoperate with the Polkadot ecosystem) and display “Unknown” as the network. If so, navigate to the top left of your screen and select the Nodle Network from the drop-down menu.
Set up the Polkadot.js extension:

Install the Polkadot-js extension, which is similar to Ethereum’s Metamask, except it doesn't do this.
Install the chrome extension.

Create an account. Now, go back to the wallet and reload. There may be a popup asking for your permission to connect.
If the Polkadot add-on is not showing, simply click Extensions, and pin to your browser (Then, click the extension to open).
Follow the directions to generate your account, by clicking "+".
Back up your mnemonics. You have generated 12 words. Keep them extremely safe. If you lose these words, all of your funds will be lost. If someone else gets them, they can steal all of your cryptos.
Now that you’ve saved your seed words securely, give your account a name.
Select an appropriate network from the drop-down list. For example, Polkadot Relay Chain or Nodle Parachain.
Add a strong password. You must use a long, randomly generated password (greater than 11 characters).

⚠️

Important: Ensure you use a password generator or password manager to generate a lengthy password. Manual entry of passwords may not work.

Now you have an account! Finish up.
Close the window by clicking outside it, and reload the page: You’ll be asked to give permission for the webpage to access the Polkadot-js chrome app. Please allow. If you have closed the webpage, you will be asked to enter your password.
You're all set!

Importing Account

On Web Browser

⚠️

Important: The Polkadot.JS extension may have deactivated in-browser storage by default. In this case you have to go into the settings tab in the top bar and change "in-browser account creation" to allow in the account settings section to be able to import your account.

To import your account on the web, do the following:

Once your words have been safely backed up, go to the Accounts page of the nodleprotocol.io (Nodle Portal) https://nodleprotocol.io/#/accounts
Go on the Web UI and click Add Account.
Give the account a name, then paste your 12 words under mnemonic seed. (Double-check the spelling is correct, and that there aren't any extra spaces). Finally create a password (We recommend using a long, randomly generated password stored in a password manager). Don't Click Next just yet!
If you use a legacy wallet, then Open the Advanced Options at the bottom, and select the Edwards curve.

💡

The Nodle App uses one of the two wallet systems: Legacy or non-Legacy. If you navigate to the screen with your public key by clicking the "Receive" button, the application will indicate whether you are using a Legacy wallet or not. If it does not say anything, you are not using a Legacy wallet.

Now Click Next, and Save.

With Polkadot JS

To import your account with Polkadot.js, do the following:

Install the Polkadot.js extension to your Chrome browser.
Start adding a new account by clicking the plus button at the top right, then Import account from pre-existing seed.
Enter your 12-word recovery phrase and select Nodle Parachain as a network. You can check your recovery phrase in the Nodle app > Settings > Wallet settings > Recovery phrase.
Enter the account name and create a password.
Open the Nodle Portal > Account to verify that your account has been added.

⚠️

Important: The DOT based token can only be managed with the new generic Polkadot Ledger apps. Please follow the instructions below to access and manage your NODL token.

Nodle Token Migration from Ledger

The recent parachain upgrade enables Ledger users to access and move their NODL tokens. To migrate your Polkadot-based NODL tokens from your Ledger device, you'll need to use the Polkadot Generic App and follow a specific migration process. For detailed instructions on this procedure, please refer to the official Ledger support article:

https://support.ledger.com/de/article/Migrate-Assets-to-Polkadot-Generic-App-Accounts-Using-the-Polkadot-Generic-App

This article provides comprehensive guidance on using the Polkadot Generic App and the migration process. Any questions or issues related to the use of the Polkadot Generic App or the Polkadot Migration dapp should be directed to the official Ledger support channels. They are best equipped to assist with the technical aspects of this migration process and ensure your NODL tokens remain accessible through your Ledger hardware wallet.

Importing Ledger Account

Before you start

Ensure you have the latest version of the Nodle (NODL) app installed on your ledger device. Ensure that Ledger Live is closed as it may cause conflicts with Polkadot JS.

⚠️

Important: You must use Chrome or a Chromium based browser such as Brave to use Polkadot JS with a Ledger Device.

Connect your Ledger

Use one of the links below to interact with the Nodle blockchain:

Assuming that you have the application opened and your Ledger is unlocked, navigate to Settings, then select Manage hardware connections and choose one of the options presented to you. Click Save.

Add your account

In the top header, go to Accounts.
In the drop-down menu, click Accounts.
Select Add via Ledger on the page that opens.
In the subsequent menu, enter a name in the name field, then leave account type and address index as they are. Click Save.
A pop-up window may appear. To confirm the connection with your Ledger device, select your device then click Connect.
Your account appears.

Add additional accounts

If you own multiple accounts, follow the steps below to add them manually:

Select Add via Ledger.
In the name field, choose a different name for your second account.
In the account type field, choose Account type 1. The address index field can stay on the default 0 value. Click Save.
Your second account should now show up next to your first account. If you own a third account, follow the same steps but this time choose account type 2, and so on so forth.

Exporting Account

Using Polkadot JS

To export your wallet from Polkadot.js, do the following:

Install the Polkadot.js extension to your Chrome browser.
Add a new account by clicking the + button at the top right, then select “Import account from pre-existing seed”.
Enter your 12-word recovery phrase and select “Nodle Parachain” as a network.
Enter the account name and create a password.
Once the account is added, click the three dots placed next to the account and then click “Export account”.
Enter the created password and save the account JSON file.

Exporting Ledger Wallet

⚠️

Important: The Ledger integration may sometime be out of date with the Nodle Chain depending on when upgrades are released by the Ledger team. If you have any issues, please reach out to the Ledger support or raise an issue on GitHub.

⚠️

Important: Alternatively, you could install the application manually (instructions below). However, please note that this is not recommended and you should only proceed if you know what you are doing.

Hardware Support

Ledger model	Supported	Note
Nano X	experimental	Recommended device.
Nano S Plus	experimental	Recommended device.
Nano S	experimental (with limitations)	Due to restricted hardware capabilities the application's feature may be limited.

Install the Application

Installing the Ledger application on your Ledger hardware wallet is pretty straightforward. Simply navigate to the manager tab of Ledger Live and search for "Nodle". Click "Install" and you are good to go.

💡

Note: If the application does not show up, you might have to enable experimental apps in Ledger Live. Please refer to the Ledger instructions on how to do so.

Installing from Source

⛔

THIS IS NOT RECOMMENDED, PROCEED AT YOUR OWN RISK

💡

Note: If you'd like to install the application from source, you can find the instructions here. Please note that this is not recommended and you should only proceed if you know what you are doing. Installing a version of the integration without going through Ledger Live may lead to unexpected behaviors. Nodle and Zondax will not be responsible for any issues that may arise from installing the application from source. You are on your own.

Installing from Zondax Hub

You can also use Zondax hub to install the Ledger app on your Ledger hardware device. Go to Zondax Hub and scroll down to select the Nodle Network. Ensure your hardware device or wallet is connected. If not, click Connect Device on the page.

Click Install and follow the instructions for installing the app.

Exporting Wallet

If you have coins in a Ledger wallet and need to export them to another wallet, you can do so by following the steps given below.

For example, you may want to export to another wallet if you’ve lost your Ledger or the integration isn't up to date.

This process will involve re-importing your Ledger mnemonics inside Polkadot JS, which we will then use to generate a file importable in other wallets like Talisman or the Polkadot JS extension.

⛔

BY IMPORTING YOUR LEDGER MNEMONICS INTO POLKADOT.JS, THE LEDGER DEVICE WITH THIS KEY IS NO LONGER CONSIDERED AS COLD STORAGE.

⚠️

Important: If you have other holdings on your cold wallet, move them to another wallet prior importing the seed. Once you moved your NODL token, it is advised to set up your Ledger device from scratch and move all your holdings to the new address.

Open nodleprotocol.io and ensure the Nodle mainnet is selected.
Navigate to the Settings page in the upper top navigation bar.
In the Manage hardware connections dropdown, select Attach Ledger via WebUSB (Chrome, recommended). Click Save.
Navigate to the Accounts page.
Click the + Account button.
Enter your seed in the Mnemonic seed text field.
Open the Advanced creation options dropdown.
In Keypair crypto type select Ledger (ed25519, BIP32 derivation).
In the Ledger app type (originated from) field, select Nodle Chain.
Tick I have saved my mnemonic seed safely and click Next.
Select a name and password for your account and click Next.
Verify your account details and click Save.
At this step, a backup file in with a .json extension will be downloaded. You can use it to import your Nodle Ledger account with any wallet of your choice that support a restoratiion from a JSON or Keystore file. Alternatively, you can now use your account as a normal account in Polkadot JS / Nodle Protocol.

Claiming Your Tokens

In some cases, you might have a grant of vested coins attached to your account. For instance, this would be the case if you bought some Nodle Cash or participated in the Nodle crowdloan.

💡

Use Nodle Client to Claim Tokens We know how cumbersome it is to use Polkadot.JS to claim your coins or even view your balance. Therefore, we recommend you use the easier Nodle Client interface for claiming your tokens. Simply go to client.nodle.com and click the Unlock button.

⚠️

YOU MUST ALREADY HAVE A WALLET The instructions below assume that you have either imported or created a wallet already. If not, ensure you create a wallet before proceeding.

Go to the nodleprotocol.io (Nodle Portal). Simply navigate to https://nodleprotocol.io/#/accounts. Note: We recommend using a Chrome-based browser like Chrome or Brave. If you are using Brave (which you should be), please disable ‘shields’ as theycan cause errors.
Make sure you are connecting to the Nodle Chain Mainnet. Occasionally, the wallet may default to a different blockchain, as it interoperates with the Polkadot Ecosystem. If so, go to the top left and select the Nodle Network.

Go to the extrinsics page. Select Developer > Extrinsics in the top bar.

Send the claim transaction.

Under “submit the following extrinsic” select: vesting:

Under addVestingSchedule(dest, schedule) select claim():

Click Submit Transaction at the bottom right. At this stage, you may need to have a bit more Nodle Cash in your account to pay for the transaction fee. To do this, you can send some Nodle Cash from your Nodle Cash app to your account claiming the tokens. We recommend sending at least 0.01 $NODL.
Sign the transaction (for this, you will need your password).
Now, your tokens are unlocked.

💡

Please note that only the tokens that have completed the vesting will unlock.

← Previous

Nodle on zkSync Era

NODL token

On this page

Introduction to Nodle Portal
Creating Account
On Web Browser
With Polkadot JS
Importing Account
On Web Browser
With Polkadot JS
Nodle Token Migration from Ledger
Importing Ledger Account
Exporting Account
Using Polkadot JS
Exporting Ledger Wallet
Claiming Your Tokens