Frequently Asked Questions

The not so mysterious magic of nanote...

Table of Contents

What is nanote?

First off, welcome to nanote! Thanks for visiting the site and thanks for viewing the FAQ section to learn more about nanote.

nanote is a side-project of mine to allow you to send messages in a Nano transactions. If you are asking what is Nano? There is a separate faq section for that question.

The Nano protocol attempts to be as lightweight as possible. So there is no space alloted for a "memo" line of free text in the transaction. What Nano does have, however, is a very tiny "smallest denomination" (1x10^-30 of 1 Nano). A seemingly useless denomination. So why not use all that seemingly useless space to base 10encoded messages? Ok, so here is how nanote works...

  1. A string of characters (message) is given by the user
  2. A character set is determined. In the nanote protocol, there is 1000 unique character sets. The reason these exist is so the smallest number of characters to represent your message is used. The more unique characters in a message, the more space it takes to uniquely represent your message.
  3. Once a character set is determined, each character is assigned a value
  4. The values are then used to encode the entire string into base 10, so that it can be represented in a Nano amount
  5. The standardized character set 3-digit representation (000 to 999) is appended to the amount (for reference by the decoder)
  6. A checksum is calculated (sumation of the digits of the character set) and appended after the character set (first level of filtering to determine if a Nano transaction is a nanote message)
  7. A minimum value (0.0001 Nano) is added to the message. This is to help alleviate spam to some extent. Many wallets will not accept Nano transactions if they are below a certain amount (normally 0.000001 Nano). So this minimum amount is added just for sanity.
  8. The amount is then sent to a Nano account. The nanote node monitors the network and parses all transactions looking for nanote messages. You can see how many transactions per second the nanote node is parsing by looking at the lower-left cornder of this site.

One item I skipped over is the second layer of filtering that nanote completes. Filtering must occur so that actual nanote messages can be viewed with minimal non-nanote messages cluttering the space. The checksum mentioned above is the initial filtering step. Every block on the Nano network gets parsed by the nanote parser. If the checksum does not check out, it is dropped.

The second layer of filtering is a space character that is prepended to every nanote message. So if a block is seen by the nanote parser, and the checksum is good, the amount will be decoded into a message. And if the first character of that message is a space (the cheapest character in nanote) it will be kept, otherwise dropped.

What is Nano?

Nano is an open-source cryptocurrency that is fast and fee-less. That means, when you send it (like sending a nanote on this site), it will be received VERY quickly and the full amount you sent will be received, no fees!

There is a fantastic community surrounding Nano. If you want to learn more, I recommend the /r/nanocurrency subreddit. Also check out the official Nano website.

How do I send a message?

Sending a nanote message is no different than sending any amount of Nano. There are basically two bits of information that you need to know...

  1. To what account am I sending Nano?
  2. What amount of Nano am I sending?

First, you can send a nanote message to any account, regardless whether you control the account. Second, the amount of Nano you send is calculated by the message you want to send. The longer the message, the more Nano it will take. The more diverse character set used, the more Nano it will take. For the details on how this is all determined, check out how nanote works. Feel free to type out as many messages as you want to see the amount required to send.

Once you type a message on this site, a QR Code will pop up on the screen. You can scan this QR Code with many different Nano mobile wallets. Also, links to a few Nano web wallets are there to click. The QR Code will tell the wallet to what account and the amount of Nano to send. Another option is to just copy paste the amount of Nano into the wallet of your choice.

How do I receive a message?

Receiving a message is simple, you don't need to do anything! Visit your Nano account's page and you will be able to view all received messages. Your Nano account does not even need to receive the transaction to view the message. nanote monitors only send blocks. This enables a nanote message to be viewed right after the sender sends the block.

To find your account page, enter your account into the search bar at the top of this site.

What wallets have been tested with nanote?

Not all tested Nano wallets have worked with nanote. This is because some wallets will truncate the small amounts of Nano in a transaction. Why they do this... I have no idea. The smallest denomination of Nano is a "raw" which is 0.000000000000000000000000000001 Nano. Small, right?

If a wallet truncates your transaction amount and you send 0.000102182701366461085457178942, that wallet might only send 0.000102. And all those missing digits hold the data within which your message is contained.

WalletPlatformWorks with nanoteQR Code Scanning / Link ClickSame account send
Nano WalletAndroid
Apple iOS

* * v2.0.1 BETA works * *


How do I change my Avatar?

You can change your account's Avatar by sending a shortcode command to the nanote account. This will randomly generate a new Avatar to represent your account. There is no limit to the number of times this command can be run. Here are examples of the different Avatars. Refresh this page to generate new examples.





How do I add/change my Alias?

An Alias is an easy way to identify your account. Important to note, is that a single Alias can be used by multiple accounts. So if you have multiple accounts and want to use the same Alias, that is fine. When an Alias is searched, it is possible for multiple accounts to be returned in the search results. You can change your account's Alias by sending a shortcode command to the nanote account. There is no limit to the number of times this command can be run.

.al your alias here

Example: If you want your alias to be "john smith" you would send the following command to the nanote account:

.al john smith

How do I add/change/verify my website?

A website can be associated with your Nano account and listed on your account page. Additionally, this website will be verified by nanote when it is added to your account. To ensure your website is listed as verified, read the faq on verified websites. Important to note, is that a single website can be associated with multiple accounts. So if you have multiple accounts and want to use the same website, that is fine. When a website is searched, it is possible for multiple accounts to be returned in the search results.

You can change your account's website by sending a shortcode command to the nanote account. There is no limit to the number of times this command can be run. Each time it is run, nanote will attempt to verify the website's association with the account. So if you have an unverified website for your account, you can take the proper steps and then resubmit the website to have it become verified.


Example: If you want to submit, you would send the following command to the nanote account:


Example: If you want to submit (not https), you would send the following command to the nanote account:


What is a verified website?

A verified website is a website that has been proven to be associated with the given Nano account. This website/Nano account association is verified by utilizing the nano.txt protocol. Seeing a verified website for an account should give a user confidence that they are sending a nanote to the person or organization they think they are.

You can view this site's nano.txt for an example of a working/verified website.

How do I send a GIF?

Sending a GIF is a fun way to communicate between accounts in the nanote protocol. The GIF itself is not sent in the Nano transaction, but instead a shortcode is sent, and this site can translate a shortcode into a GIF.

For example, sending the message:


is shown in chat as...

What is a shortcode?

A shortcode is a short, pre-defined text that triggers some type of event on this site. GIFs and various commands (changing an alias, website, avatar) are all triggered by a shortcode. You can view all shortcodes by clicking the shortcodes button next to the message input box on the chat window for any account.

How do I request a new GIF/shortcode?

Want some type of nanote functionality that does not yet exist? A new GIF to send? Let me know! Send me a note on Twitter (or send me a nanote !).

Can I donate to nanote?

Yes! Please do make donations. Even if all my development time is free, the domain, website hosting, and Nano Node hosting all cost real money.

On the left sidebar, you can see the progress we've made in this year's donations. The amount listed is the amount to cover nanote operational costs.

How do I donate?

A donation is made by sending a nanote message to the nanote account. This could be any command (changing Avatar, Alias, Website, etc), any GIF, or any plain text message.

Donation recognition

In order to recognize those that support nanote, if you make enough of a donation (through one or multiple nanote messages), your Avatar will be modified to showcase your level of support.

No DonationsBronzeSilverGold
Donate  0 NanoDonate  0 NanoDonate  1 NanoDonate  10 Nano

How do I report innapropriate content?

If you find innapropriate content on nanote, please contact me via Twitter and I will investigate the content.

How do I report a bug?

If you believe you found a bug, you can report it on GitHub or by sending me a note on Twitter .

Is nanote Open Source?

Yes! Well... mostly. The nanote protocol is open source and available on GitHub and npmjs. The code to this site is currently closed source, but my intent is to open source the codebase eventually.

How can I integrate nanote with my site/app?

First, feel free to contact me (via Twitter). If you have any questions about integrating nanote with your site or app. I'd love to help advise as you see fit.

If you want to use the npmjs/Node.js package, you can find it with documentation here.

If you want to use the Public RESTful API hosted on this site, you can find documentation here.