Getting Started

Introduction

Vision and Mission

For Users

Nodle IoT

Nodle App

Nodle Client

Nodle on zkSync Era

Nodle Portal

NODL Token

NFT Minting Tool

Nodle Explorer

Participate

For Developers

SubQuery Indexer

Nodle APIs

Nodle Parachain

Parachain Modules

Nodle SDK

Nodle Android SDK

Nodle iOS SDK

Smart Missions

More Info

Appendix

Glossary

Introduction to Nodle App

The Nodle App is a new way to earn crypto with your smartphone. When you use the Nodle App and connect to Nodle Network through your mobile phone, you are helping build the Nodle Network around you.

All you need to join the Nodle Network is to install the Nodle App and enable Bluetooth and location sharing in the phone settings. Once you do this, your phone becomes a node of the Nodle Network, helping transmit data from Bluetooth devices around you. The information is then sent back to the owner of the Internet-of-Things (IoT) device.

For the service provided, you will get NODL tokens (cryptocurrency) as a reward.

The important characteristics of the Nodle app are:

• Privacy and Security: Nodle app prioritizes privacy by design, transmitting Bluetooth data only to device owners, encrypting it for security.
• Mobile Data-Friendly: iBeacon messages are small, minimizing data usage. Enable WiFi-offloading in phone settings for efficient data transfer.
• Power Efficiency: Nodle app optimizes CPU usage, utilizing Bluetooth Low Energy for minimal impact on smartphone battery (1-3% consumption every 24 hours).

You can download the Nodle app from:

•  Google Play Store (for Android devices)
•  Apple Store (for iOS users)

How Nodle App Works

Many IoT devices have sensors and need to send data to their owners. However, these devices only have Bluetooth radios. They don't have WiFi or Long Term Evolution (LTE) capabilities.

The Nodle app uses the Bluetooth radio in your phone to connect to these IoT devices and securely transfers the data from Bluetooth to LTE to the company that owns the device (for example, an e-Scooter, a pet with a tracking device, a cargo with a sensor).

The data collected includes address, geolocation, broadcasted beacon, and any other specific data, which can be sent to/from a device depending on its type.

Configuring Nodle App

The Nodle app is specially designed to run at all times in background without impacting the user experience. All you need is to make sure that your phone and the app are configured properly, particularly:

1. The device is connected to the Internet, which is required to transmit data from the Bluetooth devices around you.
2. Bluetooth is switched on, and the Bluetooth permission is granted to the app.
3. The location sharing permission is set to 'Always allowed'.
4. The battery optimization setting is switched off for the app (applicable only for Android phones).
5. The developer mode is switched off on the phone.

You can check granted permissions in the phone settings > Nodle app > Permissions, and all other settings in the respective phone settings. The app will also notify you if some critical permissions are missing.

Earning Rewards

Calculating Network Rewards

The amount of rewards you receive depends on your contribution to building the Nodle network and is calculated based on:

1. App time availability - the percentage of time the Nodle app has been running on a phone and connected to the Internet.
2. Bluetooth availability - a metric indicating if the Bluetooth has been switched on on a phone.
3. Geographical coverage - your contribution to the network coverage in visited H3 tiles, which is calculated based on the number of nodes in each H3 tile.

The total amount of rewards is set per day and is shared among all network nodes. It means that the amount of rewards you receive will reduce over time as the network grows. However, the bigger the network, the higher the NODL token price on the market. You can check the current token daily issuance here

Rewards are calculated every 15 minutes based on node's network contribution metrics listed above. This amount is shown in the Nodle app as "pending" and is allocated to node's wallet every 4 hours.

Maximizing Rewards

If your device and the app are configured properly you can use the following tips to maximize your rewards:

1. Make sure the app runs 24/7 either in foreground or background.
2. Move as much as possible in order to create a wider coverage.
3. If you have multiple devices with the Nodle or the Hotspot apps, then keep a maximum of 4 of them in one location. If you have more, then place them far away from each other.

For more information on rewards, refer to the Nodle Rewards section.

Analyzing Network Rewards

To analyze the amount of your network rewards you can check your network contribution metrics (time availability, Bluetooth availability, and geographical coverage) on the Rewards screen of the Nodle app. These metrics are multiplied together to determine your reward amount. If any of the metrics is 0%, your reward will be 0.

Time Availability Metric

This metric represents the percentage of time the Nodle app runs properly. To achieve the maximum reward value of 100%, ensure the app is operational and correctly configured at all times

A value of 0% may indicate one of the following possibilities:

• the app was closed
• the app wasn’t connected to the Internet
• location sharing was switched off or denied

Please note that a 0% value impacts all other metrics since the app’s inactivity prevents the transmission of information necessary for checking node location and Bluetooth availability. It means that if the value is 0%, then all other charts will be 0% as well.

Bluetooth Availability Metric 

Reflecting the Bluetooth connectivity provided by your device to the Nodle Network. Keeping Bluetooth continuously enabled allows a maximum reward value of 100%. The temporary unavailability of Bluetooth will proportionally reduce the reward value.

Geographical Coverage Metric

This metric signifies your node’s contribution to the network’s geographical coverage, measured using H3 tiles at level 10. The node’s contribution is determined based on the density of each covered H3 tile. Ideally, each tile should have four nodes for maximum rewards. The metric can assume different values based on the density of each visited H3 tile, including:

• 100% — when a tile has only one node
• more than 100% — when a node moves across multiple tiles, depending on the number of other nodes in those tiles
• less than 100% — when multiple nodes cover a tile

As these metrics directly impact the rewards amount they should help users get valuable insight about their current level of rewards and how they can earn more. Understanding these values helps you gauge your rewards and strive for higher earnings.

NFTs

Viewing Your NFTs

To view your NFTs, do the following:

1. Open the Nodle app.
2. Switch to the wallet tab by tapping on the wallet icon on the navigation bar.
3. You will find the last-created NFTs in the NFTs section, below your available wallet balance and the Send/Receive buttons.
4. Select View All to see your entire NFT collection.

Select an NFT in the NFTs section to view its details, such as the collection name, ID, NFT title, description and more.

Minting NFTs

There are several ways to start the NFT minting process.

Option #1

1. Open the Nodle app.
2. Tap on the + button in the bottom right corner.
3. Select Photo NFT if you want to take a picture with your camera or NFT from gallery if you have a pre-saved image.
4. Take a picture or select it from the phone gallery depending on your previous choice.
5. Update the NFT title if you want (it’s optional).
6. Your location will be captured if you select Photo NFT. If you don’t want to mint your NFT without exposing its location, then press Delete next to the location info.
7. Check the minting fees and whether you have enough balance to pay them.
8. Proceed to start the NFT minting process.
9. That’s it! Your NFT will appear in the NFT list in a pending state until the transaction is submitted on the Nodle chain. Note that it may take up to several minutes for the NFT to be submitted.

Option #2

1. Open the Nodle app.
2. Go to the wallet tab by tapping on the wallet icon on the bottom navigation bar.
3. In the NFTs section, select Mint your NFT.
4. Tap Start to proceed.
5. Select Take a picture if you want to take a picture with your camera or Select from gallery if you have a pre-saved image.
6. Continue with steps 4-9 from the Option #1.

Claiming NFTs

You can easily claim an NFT using a magic link or QR code shared with you.

You can use the tool to mint your own collections and distribute magic links. From time to time, we at Nodle and other community members mint NFTs and distribute magic links via our social media.

To claim an NFT, do the following:

1. Tap the magic link or scan the QR code sent to you.
2. Preview the NFT in the Nodle app.
3. Tap Get NFT to claim it.

Sharing NFTs

You can easily share your NFTs with your community, friends and followers even if they don’t have the Nodle app installed.

Sharing on Web

1. Open the Nodle app.
2. Switch to the wallet tab by clicking on the wallet icon on the navigation bar.
3. You will find the last-created NFTs in the NFTs section, below your available wallet balance and the Send/Receive buttons.
4. Tap View All to see your entire NFT collection.
5. Choose Copy link at the screen's top to share your NFT collection link manually, or select Share for the default social media sharing method.
6. To share a specific NFT, tap the desired one, and pick either Copy link or Share based on your preference.
7. The recipient will receive a link to your NFT collection or the specific NFT on the web, viewable in a browser without the Nodle app.

Sharing on Instagram

1. Open the Nodle app.
2. Switch to the wallet tab by clicking on the wallet icon on the navigation bar.
3. You will find the last-created NFTs in the NFTs section, below your available wallet balance and the Send/Receive buttons.
4. Tap View All to see your entire NFT collection.
5. Tap an NFT you want to share.
6. Tap Share on Instagram.
7. Preview your Instagram story and click on the arrow in the top right corner to proceed.
8. Tap + Instagram Stories.
9. Once the Instagram app opens, post the story as you normally would. Mention the @nodle.network to let your community know about the Nodle app.

Sending NFTs

There are several ways to send the NFT to another NODL wallet.

Option #1

1. Obtain the recipient's public key, akin to their Nodle wallet address.
2. Open the Nodle app and navigate to the wallet tab.
3. Tap Send below your balance, enter the recipient's public key, and proceed.
4. Go to the NFT tab, choose the NFT to send.
5. Be mindful of the transaction fee, displayed before confirming the transfer, similar to a postal service fee.
6. Confirm the transfer; the NFT will be sent to the recipient's wallet.
7. Track the transaction in the Transfers section for a receipt-like record.

Option #2

1. Get the recipient's public key, similar to an email address for Nodle.
2. Open the Nodle app and switch to the wallet tab.
3. Access your NFT collection in the NFTs section.
4. Choose an NFT, tap Transfer, enter the recipient's key, and confirm.
5. Verify the transaction in the Transfers list.

Wallet Management

Creating NODL Wallet on the Nodle App

For any transactions you want to do on Nodle or to earn rewards, you must have a wallet (digital wallet) in place. You can easily create one from the Nodle App on your mobile phone.

To create a Nodle wallet, do the following:

1. Open the Nodle app.
2. Tap Start and follow the instructions to create your wallet.

3. Once the wallet is successfully created, you will be directed to the primary interface of the Nodle app.

Finding Your Public Key

Consider your public key as your "postal address" in the world of cryptocurrency, similar to how your email address serves to receive emails. Feel free to share your public key with others. They'll use it to send you NODL tokens, just as they would use your email address to send you an email.

Curious where you can find your public key? It's simple! Just follow these 3 steps below.

1. Open your Nodle app.
2. From the map view, tap the wallet icon on the navigation bar.
3. Tap the "Receive" button under your account balance. Your public key is displayed along with the QR code. Use this to share with others.

Backing Up Wallet

A private key, in the context of cryptocurrency, is like a special password that allows you to access and manage your digital assets. This key is used to authorize every transaction you make on the blockchain, confirming that it's really you who is making the move.

Your wallet's private key can be translated into a more human-friendly format known as a 'recovery phrase'. This recovery phrase is a sequence of 12 secret words. It functions as a more memorable version of your private key that you can use to regain access to your wallet if you lose your device or forget your password.

Here's how you can find your recovery phrase in the Nodle app:

1. Open your Nodle app.
2. Go to Settings > Wallet Settings > Recovery Phrase.
3. Write your mnemonic phrase down on paper.
4. Make sure to write all 12 words in the correct order. The same words in a different order won't restore your account.

Sending NODL

Sending Nodle tokens from one wallet to another is just like sending a digital payment or transferring money between bank accounts.

To send NODL, do the following:

1. Get recipient's public key: Think of it as their Nodle wallet address, like an email address for sending Nodle.
2. Open Nodle app, tap Send: Find the button on the wallet tab.
3. Enter recipient's key and follow prompts
4. Check transaction fee: Like a postage fee for sending NODL via Polkadot blockchain.
5. Confirm transaction
6. Check Transfers list: Track the transaction, similar to a receipt, in the app.

Cashing Out NODL

You can sell or exchange your tokens on any crypto exchange on which the NODL is listed.

1. First, check the list of exchanges and the current token price on the CoinMarketCap or on the CoinGecko.
2. Deposit your tokens into your exchange account to trade them. To do this, you need to send your tokens to the deposit address provided by the exchange.
3. Once the exchange receives tokens, you can trade them.

Importing Wallet on Web

To import your wallet, do the following:

1. Open the Nodle Client.
2. Click Connect with Nodle App to proceed.
3. Scan the QR code with the QR code scanner available in the Nodle app.
4. Approve the Sign-in request on the Nodle app.
5. Verify that the public key is correct on the Nodle Client and click Next.
6. You are now connected to the Nodle Client.

To get more information on how to use the Nodle Client, please check here.

Using One Wallet on Multiple Devices

Although it's technically possible to use the same Nodle wallet across different devices, we advise against it. Instead, we recommend setting up a unique account for each device.

Why? Because it makes tracking your earnings much simpler. The statistics screen on the Nodle app shows you your network contribution metrics, which has a direct impact on your rewards.

If you use the same Nodle wallet on multiple devices, then the statistics data will be aggregated. Therefore, it won't be possible to analyze the performance of each individual device, which means you won't know what to change to optimize your earnings.

Transferring Your Wallet to Another Device

If you need to move your Nodle wallet to a new device, it's quite simple. Think of it as moving your physical wallet from one bag to another.

To move or transfer your Nodle wallet to other devices, do the following:

1. Create a backup of your wallet on your current device: Open the Nodle app, tap on Settings > Wallet Settings > Recovery phrase. This will reveal your unique recovery phrase. It's a secret code made up of 12 words, like a super-secure password.
2. Write down your recovery phrase: It's crucial that you write down these 12 words and keep them somewhere safe.
3. Install the Nodle app on your new device.
4. Import your wallet to the new device: When setting up the Nodle app on your new device, use your 12-word recovery phrase to import your existing wallet.

And that's it! Your Nodle wallet is now transferred to your new device.

Legacy Wallets

The Nodle app offers two types of wallet systems: legacy and non-legacy.

1. Legacy Wallet: Think of a 'legacy' wallet as an older version, which may be more complicated to move or "import" to other wallets that support NODL tokens. In some cases, it might not even be compatible with these other wallets. However, it's still a functioning wallet, and you can use it as you always have.
2. Non-legacy Wallet: If you're new to the Nodle network, you're likely using a non-legacy wallet, which is simpler to use with other wallets.

Checking Your Wallet Type

To check your wallet type, go to the screen with your public key (your wallet address) by tapping the Receive button in the app.

If the app indicates you're using a legacy wallet, it might be a good idea to switch to a new one for easier use. The app displays the message shown below if you’re using a legacy wallet. Follow the on-screen instructions to upgrade your wallet.

If the app doesn't say anything, rest assured you're using a non-legacy wallet.

Upgrading from a Legacy Wallet

If you are using a 'legacy' wallet in the Nodle app (an older version of the wallet system), it might be a good idea to upgrade to a newer wallet. If you're not sure whether your wallet is a legacy one, you can check using the steps provided in the previous section.

• Upgrading Wallet Without NODL Tokens:

If your legacy wallet lacks NODL tokens, the app can auto-upgrade you during import, giving you a new wallet address. Share this address for token transactions; your recovery phrase remains unchanged.

• Upgrading Wallet With NODL Tokens:

For legacy wallets with NODL tokens, manually switch to a new wallet:

1. Back up your existing wallet in Settings > Wallet Settings > Recovery phrase.
2. Disconnect the old wallet in Settings > Wallet Settings > Disconnect wallet.
3. Create and back up a new wallet.
4. Retrieve the new wallet address from the Receive button.
5. Return to the old wallet using the 12-word recovery phrase.
6. Transfer tokens to the new wallet via the Send button.
7. Switch back to the new wallet using its recovery phrase.
8. Now, use the Nodle app seamlessly with your upgraded wallet.

Transferring Tokens from a Legacy Wallet

If you've upgraded to a new wallet but still receive tokens in your old 'legacy' wallet, don't worry! Your tokens are safe and can be moved to your new wallet.

To do this, you'll need to import your old wallet into nodleprotocol.io.

Follow these steps:

1. Click here to het the instructions on how to re-import your wallet on the web. When asked, use your current 12-word recovery phrase, which is like the secret password for your wallet.
2. During the import process, click on Advanced creation options and then select Edwards.

Once you've done this, your old wallet will be accessible on nodleprotocol.io. You can then transfer the tokens from your old wallet to your new one.

Privacy

Location

The location of your device is used only to compute your rewards based on your contribution to network coverage, and locate Bluetooth devices on request of their owners.

Personal Information

We don’t collect your personal information. It is never shared or sold.

You can add your name to your user profile in Settings, however, it is stored locally on your phone and not shared with anybody. You can decide you share your Nodle profile, which includes your name, public key, and your NFTs with your friends.

Analytics

We collect analytics about app crashes and about how you use the app. You can opt-out from the data collection by switching of the “Share app analytics” setting in the Nodle app > Settings > Privacy and analytics.

Read the full privacy policy here.

On this page

• Introduction to Nodle App
• How Nodle App Works
• Configuring Nodle App
• Earning Rewards
• Calculating Network Rewards
• Maximizing Rewards
• Analyzing Network Rewards
• NFTs
• Viewing Your NFTs
• Minting NFTs
• Claiming NFTs
• Sharing NFTs
• Sending NFTs
• Wallet Management
• Creating NODL Wallet on the Nodle App
• Finding Your Public Key
• Backing Up Wallet
• Sending NODL
• Cashing Out NODL
• Importing Wallet on Web
• Using One Wallet on Multiple Devices
• Transferring Your Wallet to Another Device
• Legacy Wallets
• Checking Your Wallet Type
• Upgrading from a Legacy Wallet
• Transferring Tokens from a Legacy Wallet
• Privacy
• Location
• Personal Information
• Analytics