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"
    ],
}

  1. Receive Pending Blocks

    const account_private_key = "40C146373BF03EF2D62E067D38A5E6BDE2B511B5C90A99C62B6F7C3D321DDEAC";
const pending_block_hash = "20D5D6EA5CA355B11A0E3C11A74FBB4E91D126F4B3FD97232945D451A621E6F7";
const { error, hash } = receive_pending_block(
    account_private_key,
    pending_block_hash,
    RPC_Node_URL.NANOS,
);

console.log({ error, hash });
    {
    error: undefined,
    hash: "142A538F36833D1CC78B94E11C766F75818F8B940771335C6C1B8AB880C5BB1D"
}

  2. Send XNO

    const sender_private_key = "40C146373BF03EF2D62E067D38A5E6BDE2B511B5C90A99C62B6F7C3D321DDEAC";
const receiver_address = "nano_1trd73o8z76wnnwmuq6y5pe6r396p7m7qf5zufrox9uk3io8foyd8mowgxu3";
const amount_xno = "10.31";

const { error, hash } = await send_xno(sender_private_key, receiver_address, amount_xno, RPC_Node_URL.RAINSTROM);

console.log({ error, hash });
    {
    hash: "142A538F36833D1CC78B94E11C766F75818F8B940771335C6C1B8AB880C5BB1D"
}

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"

    1. RAW to XNO

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

console.log(xno);
    "1.5023"

license

MIT