Getting Started: Developing with Nano Currency — Part 2: Interacting with Public and Private Nano Nodes

SomeNano
SomeNano
Jan 15 · 18 min read
Image for post
Image for post

This post is part of a series of posts that help developers/coders/tinkerers of all levels get started coding with Nano (cryptocurrency).

  1. Build your foundation
  2. Interacting with Public and Private Nodes [this article]
  3. Interacting with Programmable Software Wallets

If you find any errors, contact me here on Medium (SomeNano), send me an email (jason@somenano.com), or find me on Twitter (@SomeNanoTweets).

Disclaimer: I link to many apps/frameworks/projects with which I have no association. While I have personally used every app/framework/project that I reference, I can not guarantee its security or availability. When in doubt, never use a “seed” or private key given from software you don’t know to be secure. Also, I have no association with the Nano Foundation and nothing in these articles should be taken as “Official” guidance. I am simply an advocate for Nano and want to support the Nano Community, and specifically those looking to code with Nano, as best I can.

Image for post
Image for post

Introduction

Teaser: With no software to install, no fees to pay, and no registrations of any sort, you will receive some free Nano and write code to transact it countless times on the Nano Network. Sound good?

Welcome back! I’m glad you made it to the second of three articles in this “Getting Started” series on developing with Nano Currency. If you are new to Nano and just getting started, I recommend you first build your Nano foundation to understand the terminology and design of Nano before attempting to interact with the network.

Of the three articles in this series, this is the article that I am most excited about. Why? Because this is where you, as a developer, first experience the true and awesome capabilities of the Nano Network. No middlemen. No coordinators. Not even a Software Wallet. In this article we are going to be interacting directly with the Nano Nodes that, together, comprise the totality of the Nano Network.

In this article, I am going to walk you through some no-nonsense JavaScript code that you can run straight from JSFiddle or in any modern (sorry Internet Explorer) browser. I am going to introduce you to some Public Nano Nodes with free-to-use Public APIs. I’m going to guide you through building Nano Blocks that will transact real Nano on the live/production Nano Network. And I am going to get you started with some free Nano to use throughout this article.

So other than your time and attention, there is really zero cost to you. At the end of this article, I intend to have you programmatically receiving and sending Nano while maintaining a Nano Account. And, of course, you will be left with some Nano to continue your fast, feeless, and eco-friendly cryptocurrency escapades.

But lastly, before we get really started, I want to set your expectations appropriately.

This article is:

  • A lesson on the basics of how to programmatically interact with Nano Nodes

This article is NOT:

  • A lesson in JavaScript coding (to include error handling)
  • A lesson in secure coding practices
  • A lesson in key management
  • A lesson in browser security

Public vs Private Nano Nodes

We previously learned that Nano Nodes are the infrastructure that supports the Nano Network. We learned that the Nano Foundation’s Nano Node is the standard across the Nano Network for Nano Node software. And we learned that anyone can operate a Nano Node.

While running a Nano Node is far beyond the scope of this article, I want you, as a developer to understand the differences between a Public and Private Nano Node. For our purposes here, when I mention a Public Nano Node, I am referencing a Nano Node that you do not operate and is open and available to be accessed over the Internet. When I mention a Private Nano Node, I am referencing a Nano Node that you downloaded, installed, and operate on a private server of some sort.

Image for post
Image for post
Public vs Private Nano Nodes

When should I use a Public Nano Node?

Right now, honestly. If you are just getting started, there is zero reason to go through the process that results in a Nano Node for you to operate and maintain. If you want to code … simply code! There are multiple Public Nano Nodes available to you right now with no registration required of any sort.

Security concerns when relying on a Public Nano Node should also be noted. When we build Nano Blocks to send and receive Nano later in this article, you will notice that we are retrieving our current Nano Account balance from a Public Nano Node. If we are creating a Nano Block of subtype send, we are then subtracting the amount of Nano we want to send, signing that Nano Block, and sending it back to the Public Nano Node to process. What happens if a Public Nano Node lies to you and tells you a less-than-actual amount for your balance? Well, you could end up “sending” a lot more Nano than you expected.

It is safe to send a Nano Block to a Public Nano Node because it is cryptographically secure via a Private Key signature. But we need to be mindful about the information we are querying and trusting, coming from a source that we do not inherently trust. One simple way to combat this, is to query more than one Public Nano Node and compare the information returned. If it does not match, bring in the human to do some investigation.

When should I use a Private Nano Node?

After you get your feet beneath you and make it through this article, if you want to write an application that users will depend upon, then you will want to consider running a Private Nano Node. While the individuals that operate the Public Nano Nodes are doing a fine service to new and hobby developers, there are (to my knowledge) no service agreements available from any of them.

That said, it really isn’t difficult to get a Nano Node up and running and the recommended machine specs will hopefully not break the bank.

Passively observing the Nano Network

“On with it!” you say. Ok, let’s get coding.

There are three unique ways in which you may interact with the Nano Network.

  1. Observing the Nano Network
  2. Querying the Nano Network
  3. Participating in the Nano Network

In this section, we are going to focus on the first, observing the Nano Network. We will not be building Nano Blocks here. Here, we will be passively listening.

Image for post
Image for post
Passively listening to the Nano Network

For some of you, this section might be as far as you need to go for your first Nano project idea. You want to observe the Nano Network and take an action of some sort if Nano is sent to a particular Nano Address. This is all the crypto bird feeder needed to do (not mine) and the Nano Christmas Tree needed to do (also not mine). This is all I do for my Nano Network visualizers (snow and plinko).

The Nano Node has made available a WebSocket for you to subscribe to, to consume various data from the Nano Network.

Here is our boilerplate code that will get us started. We simply create a new WebSocket object and create the three functions to handle events (learn more about WebSockets). As we progress through the article, each JSFiddle in each section builds on the previous (kind of like a block chain…) but each JSFiddle stands on its own as a complete and executable script (kind of like a state block!). I will not describe line by line each example but will cover the highlights following each JSFiddle.

Did you run the script? At this point we are actually communicating with a Public Nano Node. But what should we say? The Nano Foundation’s Nano Node provides a laundry list of topics, but we are going to focus on just a few. First, let’s test our connection with a WebSocket version of “Hello, World!”. Ping.

If all has gone to plan, we should see a “pong” message back that looks something like this:

{
ack: "pong",
time: "1610600439160"
}

Great! Now we know the Nano Node and us are speaking the same language. What else can we do? How about we take the crypto bird feeder approach and listen for transactions on a single Nano Account? How about we listen to the fairly active FreeNanoFaucet.com’s Nano Address?

Eventually, you should see some output like below.

{
ack: "subscribe"
time: "1610601231728"
}
{
message:
{
account: "nano_1z9ezcfz6xsih7tbe9hanedy4qb49wnjuaba18asfh7ycj6adkxhw91kxmma"
amount: "123000000000000000000000000"
block:
account: "nano_1z9ezcfz6xsih7tbe9hanedy4qb49wnjuaba18asfh7ycj6adkxhw91kxmma"
balance: "0"
link: "CB96B762A73BF920DB1794A053C8B4EE0A0F74FCD07CCB89018C258A15C2CC47"
link_as_account: "nano_3kwppxjcggzs65fjh771ch6dbuic3xthsn5wsg6i5537jacw7m493ra8574x"
previous: "C6114BC22D6D2EA8270792D0CF6059842BDCE93C6FA06896766326F9F63AEEF7"
representative: "nano_1iuz18n4g4wfp9gf7p1s8qkygxw7wx9qfjq6a9aq68uyrdnningdcjontgar"
signature: "3FF5027F2C897579003B1957E1F422D3662C2C4208D88DAF53D78F4166BC790E27D43B19081F6D24022E8346E5CDF85A062EF17FFB2355F92BF7CAA5BC594305"
subtype: "send"
type: "state"
work: "487a20aae4690dc4"
}
confirmation_type: "active_quorum"
hash: "79A772291C68A6A587837DEDBF1EF03B18227BF2F64CE76F6753DADFC31173ED"
}
time: "1610601260097"
topic: "confirmation"
}

If you are working in JSFiddle, you may not see the fully expanded objects in the results window as I’ve pasted above. You can open up your Brower’s console and view the fully expanded objects there.

So what’s going on here? We can send a message with action: “Subscribe”, topic: “Confirmation” and an array of Nano Accounts to subscribe to confirmations from those Nano Accounts. In short, when a Nano Block gets confirmed by the Nano Network as valid, you will get a WebSocket message telling you so.

I won’t dive too much into the Nano Block output as we briefly reviewed the fields in the first article on building your foundation and we will work more with these fields below when we actually build some Nano Blocks.

Now, I said before, I won’t spend much time talking about security or best practices, but I will offer a word of caution here. If you are taking action on the notification of certain confirmed Nano Blocks, you need to check that you haven’t observed that Nano Block previously. You need to maintain a log of hashes from the hash field. If you’ve already seen that hash and taken action, skip, simple.

And that’s really about it! Like I said before, there are quite a few other messages you can send through WebSockets (update your subscription, observe votes, subscribe to all Nano Blocks, election information, and more…), but I think our point has been made. You are now able to observe the Nano Network!

And before we leave this section, I want to highlight two working WebSocket examples provided by the Nano Foundation. While I have guided you through the simplest implementation that I could think of, if you want to see a Node.js or a Python example, check out the docs.

Actively querying the Nano Network

Observing the Nano Network is immensely useful. But what if you are looking for specific, on-demand information about the Nano Network? What if you want to know the balance of a Nano Account? What if you want to know information about a specific Nano Block? For this information we will need to query the Nano Network.

While technically the section above on observing is not completely passive (you need to actively subscribe to certain information), I consider it passive as it is a stream or feed of data flowing to you as a listener. I consider the act of querying the Nano Network to be active because we are asking a specific question and expecting a certain type of answer in response.

Image for post
Image for post
Querying the Nano Network

I think the concept is fairly simple to understand, this is your standard RPC or REST API request. Let’s get right to the code. Here is the boilerplate code that will get us started.

This code is fairly generic and won’t actually do anything for us, yet. The post function returns a Promise object that is resolved/rejected on the return or the error of the POST request.

There are a HUGE number of Node RPCs supported by the Nano Foudation’s Nano Node. We will only tackle a few. But as long as you know what the input values are, the POST request format is the same. Now let’s actually query the Public Nano Node we’ve selected and request the account balance of FreeNanoFaucet.com’s Nano Address.

Here we simply follow the documentation for the account_balance RPC. Pass in an action value and an account value. By now, especially if you read through my first article, you might have noticed that I discern between a Nano Account and a Nano Address. I try to be very intentional about this. To me, the Nano Address is the xrb_* or nano_* value. Every Nano Account has a Nano Address, but it also has a Private Key and a Public Key. So when I reference a Nano Address, I mean the string of characters that is the address. But when I reference a Nano Account, I reference the logical thing that is the combination of Public Key, Private Key, and Nano Address. It might seem pedantic… but hey, that’s me. All that said, in the Node RPC reference, whenever an “account” field exists, it is looking for the string of characters that I call the Nano Address.

Image for post
Image for post

Ok, off my soap box…

After running the above code, you should see a result similar to this:

{
balance: "9538071006620219687677251092905",
pending: "0",
requestLimitReset: "Fri Jan 15 2021 00:07:06 GMT-0500 (Eastern Standard Time)",
requestsLimit: "5000",
requestsRemaining: "4936"
}

Our query to a Public Nano Node resulted in us determining the current balance (in raw) and pending balance (Nano (in raw) that has been sent but not yet received by this Nano Account). Both of these values can be confirmed on a Block Explorer like NanoCrawler. We are also given some other information about “requests” that I want to highlight.

Some of the Public Nano Nodes run a Nano RPC proxy. This Nano Community developed proxy was created to enable people that operate their own Nano Node, to have its RPC and WebSocket capabilities accessible publicly, without opening direct connections to the actual Nano Node software. One of the features this proxy offers is tokens. Tokens allow the Node Operator to limit requests to their Nano Node. But it also allows them to potentially monetize access to their Nano Node’s API by allowing people to purchase tokens.

Image for post
Image for post
https://github.com/Joohansson/NanoRPCProxy

In the output above, we see that this particular Nano Node has set a limit of 5000 requests, of which I have 4936 requests remaining. And my limit will be reset on Friday January 15th 2021 at 00:07:06 EST. Referencing back to my earlier section on Private vs Public Nano Nodes. This is potentially a limiting factor if you choose to rely on a Public Nano Node. Not all the Public Nano Nodes utilize tokens, however. And some Public Nano Nodes do utilize tokens but don’t use this particular proxy software. I try to highlight which Public Nano Nodes use the token system on my Public Nano Node webpage. I personally like the Nano RPC Proxy and its token system. It is easy to view and programmatically parse my limits. It demonstrates an attempt at resiliency of the API against spam. And honestly, for playing around, I won’t ever come close to breaching my allotted tokens.

That ended up being quite a bit of foundation building between terminology and introducing the Nano RPC Proxy. Let’s get back to code! Now that we’ve determined a Nano Account’s balance, let’s query information about a specific Nano Block.

Here we add a new function to query the block_info RPC. And the response is below:

{
amount: "123000000000000000000000000",
balance: "9704399006620219687677251092905",
block_account: "nano_3kwppxjcggzs65fjh771ch6dbuic3xthsn5wsg6i5537jacw7m493ra8574x",
confirmed: "true",
contents: {
account: "nano_3kwppxjcggzs65fjh771ch6dbuic3xthsn5wsg6i5537jacw7m493ra8574x",
balance: "9704399006620219687677251092905",
link: "432FE1A625EC1924E92BF7122D03E0E9B1FEAB5A58F4A5042D77227A87E65796",
link_as_account: "nano_1ishw8m4du1s6mnkqxrk7n3y3tfjztoonp9nnn44txs4hc5yeowpwnfazaap",
previous: "8D8B391831B4E6E2E226C875195864CDD75285201BF027A6C34301D097D05F81",
representative: "nano_3kwppxjcggzs65fjh771ch6dbuic3xthsn5wsg6i5537jacw7m493ra8574x",
signature: "3FC6DD1E6E2ADF0D07C821347EDC759870EFC6A59788E8AF720A4BA1A917CE738FE5F30B460DF562E7CC62EC41F5833C8B28023821152B4BF3E8AB059BE9760B",
type: "state",
work: "4d1e6d5bb9180c42"
},
height: "234806",
local_timestamp: "1610601139",
requestLimitReset: "Fri Jan 15 2021 00:07:06 GMT-0500 (Eastern Standard Time)",
requestsLimit: "5000",
requestsRemaining: "4933",
subtype: "send"
}

The Nano Block object should be looking rather familiar to you by now!

Participating in the Nano Network

Now that we can observe and listen real-time to the Nano Network for new Nano Blocks as well as query for specific information on any Nano Address or any Nano Block, I think it is time for the real fun. It is time to begin programmatically receiving and sending Nano!

For this section I am going to enlist the assistance of a Nano Community developed JavaScript library called nanocurrency-js (npm) (jsdelivr). This package is phenomenal and helps us stay at the “Getting Started” level. We will leverage nanocurrency-js to do more Nano boilerplate tasks like deriving Nano Account information from a seed and signing Nano Blocks with our Private Keys. We can even use it to generate the work required to send a Nano Block, but more on that later.

Our plan for this section is:

Image for post
Image for post
Participating in the Nano Network

Step 0: Request Free Nano from FreeNanoFaucet.com

I said you’d be getting some free Nano, didn’t I? But first, you need to figure out the Nano Address where you want the Nano to be sent.

Your results should look something like this (but unique). The first value is your seed and the second value is the first Nano Address derived from the seed. I recommend NEVER generating a seed or ever really using a seed and Private Keys in JSFiddle. However, we are going to be working with very small amounts of Nano and the risk is (in my assessment) minimal.

"dfc973628c10a..."
"nano_1syhufn6..."

Copy your seed and Nano Address to a text document for safe keeping as we work through the rest of this article.

Next, head over to FreeNanoFaucet.com, enter your Nano Address and click “Get Nano!”. Then, to confirm the Nano was sent, head over to NanoCrawler, enter your Nano Address into the search box and hit enter. You should see some “pending” Nano.

Image for post
Image for post

Now you could enter your seed into a Software Wallet, but we are here to code, so let’s receive the Nano into your Nano Account programmatically.

Note: There are a few free Nano faucets available. You could also try nano-faucet.org or check out the various options on nanolinks.info.

Step 1: Receive Nano

From here on out, for each JSFiddle, you will need to enter your seed for the seed variable I have defined at the bottom of this script.

Here we add a new function pending which will query the Nano Node with action pending and return the hash of any Nano Blocks of subtype send that are ready to be received by your Nano Account. You should see that you have one Nano Block pending and see an array with a hash that matches the hash you saw above on NanoCrawler.

"Found 1 blocks pending..."
["A8AEB2313F12E6D36B3149FFC3D4E534F1B3603D35FAE7FA4EDDAB3985D02157"]
Image for post
Image for post
Pending Nano Block hash values match

Now let’s take it the next (big) step and actually build the Nano Block of subtype receive.

Results should look similar to this:

"Found 1 blocks pending...""Receiving in address nano_1syhufn6sde8oh4ntox6166jzh4rdtk9uoo9donj9epa597wizonn8kt6nhb from block A8AEB2313F12E6D36B3149FFC3D4E534F1B3603D35FAE7FA4EDDAB3985D02157""Computing work for subtype receive, difficulty: fffffe0000000000 (work being done locally: false)""Processing block with block:"
{
block: {
account: "xrb_1syhufn6sde8oh4ntox6166jzh4rdtk9uoo9donj9epa597wizonn8kt6nhb",
balance: "123000000000000000000000000",
link: "A8AEB2313F12E6D36B3149FFC3D4E534F1B3603D35FAE7FA4EDDAB3985D02157",
link_as_account: "xrb_3c7gparmy6q8tfom4khzrhcgcf9jpfi5tfhtwzx6xqfd984x1acqgkg9w7or",
previous: "0000000000000000000000000000000000000000000000000000000000000000",
representative: "nano_1center16ci77qw5w69ww8sy4i4bfmgfhr81ydzpurm91cauj11jn6y3uc5y",
signature: "963740438369EC7EA941FC1B0A7F8480BCF00CF2BD10BAFC8E751CF1CDD16F08D6DB5AFDF81F579C00781ABB4429377AE23179AAA9542AB02CDC9836ADFE090F",
type: "state",
work: "9e8d4de54d0c00a2"
},
hash: "9C447E554E4ACE2809DF87AE95E54B0F05FF6F53CB8F012E33DB7964AFBB31A5"
}
"Published receive block: 9C447E554E4ACE2809DF87AE95E54B0F05FF6F53CB8F012E33DB7964AFBB31A5"

And you can see in NanoCrawler that your Nano has been received by your Nano Account!

Image for post
Image for post

Congrats! You have created and published your first Nano Block! You have requested Nano from a free Nano faucet and programmatically detected a pending block and programmatically received it. But let’s rewind, quite a bit of new code was added to the last example and I want to walk through most of it. Fortunately, this deep dive on the receive will pay dividends soon when we build other Nano Blocks, as there are quite a few similarities.

Let’s walk through it in order of code execution:

Image for post
Image for post
After detecting pending blocks, we iterate over each of the pending blocks and call a newly defined function receive_block.
Image for post
Image for post
We start with two queries to the Nano Node, one for block_info and another for account_info. We’ve seen block_info previously. With account_info, we won’t get any information back on this particular call because our Nano Account does not yet exist in the Nano Network. Even though we know the Nano Address, we need to publish a Nano Block before any Nano Nodes will be aware of its existence. This first Nano Block has some unique qualities. I check if account_info returned a balance (or is undefined) to determine if the Nano Account is new. If it is new, I follow the Nano Foundation’s guidance on building a Nano Account’s first Nano Block (an Open block).
Image for post
Image for post
Next we calculate the work (more below) and calculate the new balance of the Nano Account in raw units. I created a helper add and subtract function to assist in the arithmetic as raw units are very large integers conveyed as Strings. We then create and sign the Nano Block with our Nano Account’s Private Key. And finally, after the Nano Block is ready, we send it to the Nano Node to be processed.
Image for post
Image for post
A small proof-of-work calculation is required by the Nano Network to deter spam. The nanocurrency-js library provides a method of computing the work value, but it is slow. It relies on your CPU and takes (in my experience) 2 to 20 minutes to complete (more benchmarks here). Fortunately, some of the Public Nano Nodes support your outsourcing of work computation to them, and they are fast (GPUs)! The ones that utilize tokens will likely charge more (~50x) for a work computation, though. But the allotted balance is plenty to go through our article (multiple times). There are other factors to watch for as well. The Nano Network can dynamically increase the work requirement if the load on the network increases over a threshold. So we query active_difficulty to determine the current work requirements. And there are different requirements for receive vs all other Nano Block subtypes. But fortunately for us, this information is handed to us nicely via the active_difficulty RPC.
Image for post
Image for post
Two new globals to highlight are WORK_LOCAL and DEFAULT_REPRESENTATIVE. WORK_LOCAL, when true, computes the work value through the nanocurrency-js library. When false, it outsources work to the Nano Node. The DEFAULT_REPRESENTATIVE is used when creating the first Nano Block with subtype receive for a Nano Account. Here I set it to the awesome Principal Representative from NanoCenter.

Step 2: Change Representative

As discussed in the first article of this series, each Nano Block contains the full state of a Nano Account, which can really be broken down into two pieces of information, balance and representative. Once you understand this concept, you will realize that it is quite possible for a Nano Account to never publish a change block to change its Representative, even if the Representative changes over time.

In any Nano Block (receive, send, or change) the set Representative for that Nano Account can be changed. A change block is not required to carry out this action. However, the change subtype does exist so that the Representative can be changed without a change in the Nano Account’s balance (via sending or receiving). Most Software Wallets do not provide a way to change a Nano Account’s Representative during a send or receive, but only as a standalone “change” action. I think this is to simplify the user experience.

Again, Nano’s consensus mechanism to include voting and Principal Representatives is mostly out of scope of these “Getting Started” articles. But really that’s ok. You can certainly interact with the Nano Network successfully without fully understanding Open Representative Voting (ORV). You just need to understand that every Nano Account should assign a reliable Representative in order to support the security of the Nano Network.

Ok, now back to the code. Let’s build and process a Nano Block with a subtype of “change”.

Expected output:

"Changing representative of nano_1syhufn6sde8oh4ntox6166jzh4rdtk9uoo9donj9epa597wizonn8kt6nhb to nano_1syhufn6sde8oh4ntox6166jzh4rdtk9uoo9donj9epa597wizonn8kt6nhb""Computing work for subtype change, difficulty: fffffff800000000 (work being done locally: false)""Processing block with block:"
{
block: {
account: "xrb_1syhufn6sde8oh4ntox6166jzh4rdtk9uoo9donj9epa597wizonn8kt6nhb",
balance: "123000000000000000000000000",
link: "0000000000000000000000000000000000000000000000000000000000000000",
link_as_account: "xrb_1111111111111111111111111111111111111111111111111111hifc8npp",
previous: "9C447E554E4ACE2809DF87AE95E54B0F05FF6F53CB8F012E33DB7964AFBB31A5",
representative: "nano_1syhufn6sde8oh4ntox6166jzh4rdtk9uoo9donj9epa597wizonn8kt6nhb",
signature: "1B67ECEABB7DDD978C4CEDA7EC5A2C449DDAF7258ECE2104C36C3E3E97A60C04B45817AE1701A7F5090F05D9799A9AC588AF2EE42AF45A1111B8F8A69764DD0C",
type: "state",
work: "5f57e1962e09f2fe"
},
hash: "97948241224C41C07DD6C8A629B70171F50F00351B49690F947D738593FFD684"
}
Image for post
Image for post
NanoCrawler view after NanoBlock of subtype change has been processed.

In this example we are doing something that shouldn’t really be done. We are setting ourselves as the Representative for our Nano Account. While this is a perfectly legitimate action, our Nano Account is not associated with a voting Representative Nano Node. The Representative should be set to an established and reliable Representative.

To create and process the Nano Block of subtype change, we add a new function that takes inputs of the Nano Address, the new Representative Address, and the Nano Account’s private key. The only unique quality of a change block is that the value of the link field is all zeros.

Step 3: Send Nano

We have received Nano and we have changed the Nano Account’s Representative. All that’s left is to send Nano! So that we can keep playing around with our free Nano, let’s demonstrate a send by doing something useless and send some Nano right back to our Nano Address.

Expected output:

"Sending 0.0001 Nano from address nano_1syhufn6sde8oh4ntox6166jzh4rdtk9uoo9donj9epa597wizonn8kt6nhb to nano_1syhufn6sde8oh4ntox6166jzh4rdtk9uoo9donj9epa597wizonn8kt6nhb""Computing work for subtype send, difficulty: fffffff800000000 (work being done locally: false)""Processing block with block:"
{
block: {
account: "xrb_1syhufn6sde8oh4ntox6166jzh4rdtk9uoo9donj9epa597wizonn8kt6nhb",
balance: "23000000000000000000000000",
link: "67CFDB684CAD86ABC54D57A401091FBC585EA47DD6A75D6913B2C819CBC87EB4",
link_as_account: "nano_1syhufn6sde8oh4ntox6166jzh4rdtk9uoo9donj9epa597wizonn8kt6nhb",
previous: "97948241224C41C07DD6C8A629B70171F50F00351B49690F947D738593FFD684",
representative: "nano_1syhufn6sde8oh4ntox6166jzh4rdtk9uoo9donj9epa597wizonn8kt6nhb",
signature: "C41F462F7836AFC7E4B68B95F20F051F5F6A6D8D12DC102939E137086A3DB1FE0F333C7C9F4E7033E82A1ADB5051D5F75F30C48D05BFE4C570336CE7DFA7A801",
type: "state",
work: "03865bf98f8efb14"
},
hash: "0DBA566C35E509D5D03B9F642437671C32851130EAAF4003371EC1B2CEA8DA89"
}
Image for post
Image for post
NanoCrawler view after NanoBlock of subtype send has been processed.

In the above screenshot, you can see that our third Nano Block has been processed for our Nano Account. And we also have a pending Nano Block! That’s because the source and destination of our send was the same! It is kind of like your left hand giving your right hand a dollar bill.

In this example I do take an input of Nano in its more user-friendly Nano (10³⁰) unit. I then lean on the nanocurrency-js package to convert from Nano to raw.

In a Nano Block of subtype send we set the link value to be the destination Nano Address. Under the hood in nanocurrency-js, the link value is converted to the destination Nano Account’s Public Key and a field link_as_account is added. The link field is kind of the wildcard field when it comes to the various Nano Blocks:

  • Subtype receive: link is the hash of the pending Nano Block
  • Subtype change: link is set to all zeros
  • Subtype send: link is the destination Nano Account’s Public Key
Image for post
Image for post
Nano Block Fields per Subtype

Conclusion

And that’s it! In this article we…

  1. Observed the Nano Network and listened for confirmed Nano Blocks
  2. Queried the Nano Network for information on specific Nano Accounts and Nano Blocks
  3. Interacted with the Nano Network and built our own Nano Blocks to receive, change representative, and send Nano

As a final capstone and comprehension test of what we’ve covered I’ll give you a challenge.

Write a script that will send Nano using one Public Nano Node and listen (via a WebSocket) for the confirmation of that Nano Block from a different Public Nano Node.

I want to thank you very much for reading this article. I hope you found it useful as you begin developing with Nano. It really is a phenomenal technology and a lot of fun to dig into and build with.

I have linked many references throughout this article and I hope you do decide to dig deeper. I also hope you continue with this series of articles.

  1. Build your foundation
  2. Interacting with Public and Private Nodes [this article]
  3. Interacting with Programmable Software Wallets

While you are here on Medium, I recommend you also read articles from Nano Education, Nano, and the Nano Publication. If you are on Twitter, feel free to follow me @SomeNanoTweets. If you are on reddit, Nano has a phenomenal subreddit with a huge amount of helpful and highly intelligent people. And if you are more of a real-time chat sort of person, check on the Nano discord where there is a specific dev channel to help aspiring Nano “BUIDLers” like you and me.

~ SomeNano

Ps, these articles are a lot of fun to write but they take A LOT of time. I wrote it to support Nano Community developers. And I would be highly appreciative if you also consider supporting me in return. If you found this article useful, please consider sending a donation.

Image for post
Image for post
nano_1somenanerzdzdbyr4y6x996qbo764ifxk8beuhphydmwn1agpzkwquqqick (NanoCrawler link)

Nano

The best place for all of the latest Nano updates…

SomeNano

Written by

SomeNano

BUIDLing with Nano since 2017

Nano

Nano

The best place for all of the latest Nano updates, developments and interviews. Brought to you by the Nano Foundation.

SomeNano

Written by

SomeNano

BUIDLing with Nano since 2017

Nano

Nano

The best place for all of the latest Nano updates, developments and interviews. Brought to you by the Nano Foundation.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store