Skip to main content
Deno 2 is finally here 🎉️
Learn more

Nanojs

NanoJs is a simple, modern and secure library for nanocurrency.

Features

  • Secure by default. No sharing of private_key, all the blocks are created and signed locally. then get published to node.
  • Get account information, balance, pending blocks, etc.
  • Send, and Receive nano.
  • Create wallet, account (with and without seed).
  • Work Generate, block info, publish block to node, etc.
  • xno to raw and vice-versa.

Install

Node

yarn add @tanishq-singh/nanojs
# or
npm install @tanishq-singh/nanojs
import nanojs from '@tanishq-singh/nanojs';
// or
const nanojs = require('@tanishq-singh/nanojs');

Deno

import nanojs from 'https://deno.land/x/nanojs/mod.ts';

Getting Started

Account

  1. Account Information

    const nano_address = "nano_1cp73fb93gkunh1yujbz3ecap46cmfsm5ozx3iqho7mu9jsx7p36hp5g39bn";
const info = await nanojs.get_account_info(nano_address);

if ('error' in info) console.log(info.error); // error reason
else console.log(info); // account info
    {
    "frontier": "3611793EF73D629181ECE0F99BADDF1A02E85523D2CC8EE2C6637481080857D2",
    "open_block": "160816E90ECAB9726FC7A0208165EC5BAC5C00093DEC8C8F1D537FE7B1C11052",
    "representative_block": "3611793EF73D629181ECE0F99BADDF1A02E85523D2CC8EE2C6637481080857D2",
    "balance": "3850130000000000000000000000",
    "modified_timestamp": "1675659938",
    "block_count": "55",
    "account_version": "2",
    "confirmation_height": "55",
    "confirmation_height_frontier": "3611793EF73D629181ECE0F99BADDF1A02E85523D2CC8EE2C6637481080857D2",
}

  1. Account Balance

    const nano_address = "nano_1cp73fb93gkunh1yujbz3ecap46cmfsm5ozx3iqho7mu9jsx7p36hp5g39bn";
const account_balance = await nanojs.get_account_balance(nano_address);

console.log(account_balance); 
    {
    "balance": "325586539664609129644855132177",
    "pending": "2309372510769300000000000000000000",
    "receivable": "2309372510769300000000000000000000"
}

  1. Account Pending Blocks

    const nano_address = "nano_1111111111111111111111111111111111111111111111111117353trpda";
const pending_blocks = await nanojs.get_pending_blocks(nano_address);

console.log(pending_blocks); 
    {
    "blocks": [
        "0EF695810BEC8B4AE3DC217DA495885A42956456A4B168C0B788ADB17A5ED7F4",
        "142A538F36833D1CC78B94E11C766F75818F8B940771335C6C1B8AB880C5BB1D",
        "1AAE335A94C5DA1E4E1D0B45C3B100CCA241CC5BC557E24BB367C779D55E3A0C",
        "1F04048431842B8875CD0040B9F2B2AAC2E8B88A0256D11E7AE6769F4DF2B61A",
        "20D5D6EA5CA355B11A0E3C11A74FBB4E91D126F4B3FD97232945D451A621E6F7"
    ],
}

Block

  1. Block Information

    const hash = "87434F8041869A01C8F6F263B87972D7BA443A72E0A97D7A3FD0CCC2358FD6F9";
const info = await nanojs.get_block_info(hash);

console.log(info);
    {
    "block_account": "nano_1ipx847tk8o46pwxt5qjdbncjqcbwcc1rrmqnkztrfjy5k7z4imsrata9est",
    "amount": "30000000000000000000000000000000000",
    "balance": "5606157000000000000000000000000000000",
    "height": "58",
    "local_timestamp": "0",
    "successor": "8D3AB98B301224253750D448B4BD997132400CEDD0A8432F775724F2D9821C72",
    "confirmed": "true",
    "contents": {
        "type": "state",
        "account": "nano_1ipx847tk8o46pwxt5qjdbncjqcbwcc1rrmqnkztrfjy5k7z4imsrata9est",
        "previous": "CE898C131AAEE25E05362F247760F8A3ACF34A9796A5AE0D9204E86B0637965E",
        "representative": "nano_1stofnrxuz3cai7ze75o174bpm7scwj9jn3nxsn8ntzg784jf1gzn1jjdkou",
        "balance": "5606157000000000000000000000000000000",
        "link": "5D1AA8A45F8736519D707FCB375976A7F9AF795091021D7E9C7548D6F45DD8D5",
        "link_as_account": "nano_1qato4k7z3spc8gq1zyd8xeqfbzsoxwo36a45ozbrxcatut7up8ohyardu1z",
        "signature": "82D41BC16F313E4B2243D14DFFA2FB04679C540C2095FEE7EAE0F2F26880AD56DD48D87A7CC5DD760C5B2D76EE2C205506AA557BF00B60D8DEE312EC7343A501",
        "work": "8a142e07a10996d5"
    },
    "subtype": "send",
}

  1. Publish Block

    import nanocurrency from 'nanocurrency';

const block_data = { }; // block data
const account_private_key = "my-account-private-key";

const { block } = nanocurrency.createBlock(account_private_key, block_data)
const publish_block = await nanojs.publish_block(block);

console.log(publish_block); 
    {
    "hash": "87434F8041869A01C8F6F263B87972D7BA443A72E0A97D7A3FD0CCC2358FD6F9"
}

Work

  1. Work Generate

    const hash = "87434F8041869A01C8F6F263B87972D7BA443A72E0A97D7A3FD0CCC2358FD6F9"
const work = await nanojs.work_generate(hash);

console.log(work); 
    {
    "difficulty": string,
    "multiplier": string,
    "work": string,
    "hash": string,
    "error": undefined
}

Conversions

  1. XNO to RAW

    const xno = "1.21";
const raw = nanojs.xno_to_raw(xno);

console.log(raw); 
    "1210000000000000000000000000000"

  2. RAW to XNO

    const raw = "1.21";
const xno = nanojs.raw_to_xno(raw);

console.log(xno); 
    "1.5023"

license

MIT