SDK

npm install @tenrai/sdk

import { TenraiClient } from "@tenrai/sdk";

const api = new TenraiClient();                                                  // the Tenrai API
const node = new TenraiClient({ url: "http://127.0.0.1:28701", target: "node" }); // your own node

await tenrai.chain.head();
await tenrai.address.balance(address);
await tenrai.address.balances([a, b, c]);         // up to 64 in one request
await tenrai.transactions.status(transactionId);
await tenrai.fees.estimate();
await tenrai.staking.validators();

import { pages } from "@tenrai/sdk";

for await (const page of pages((cursor) => tenrai.address.history(address, { cursor }))) {
  console.log(page.events.length);
}

import { Wallet } from "@tenrai/sdk/wallet";

const wallet = await Wallet.fromMnemonic(phrase, { network: "mainnet" });
wallet.address(0);                                              // first receiving address
const { atoms } = await wallet.balance(tenrai);
const sent = await wallet.send(tenrai, { to, amount, payload: "invoice 42" });
const payout = await wallet.send(tenrai, { payments: [{ to: alice, amount: a }, { to: bob, amount: b }] });
wallet.close();

const messenger = wallet.messenger(tenrai);
messenger.id();                                   // TRM-4CA0-35E2-…, the same on every device of this wallet
await messenger.start(address, "Hi");             // the note is public
const chats = await messenger.chats();            // rebuilt from the wallet's history
const request = chats.find((chat) => chat.state === "request");
await messenger.accept(request, "Hello");         // spends a coin of the address the request reached
await messenger.send(request, "From here on end-to-end encrypted");

const events = tenrai.events({ afterHeight: lastHeight });     // every finalized cut, resumed
events.on("cut", (event) => save(event.cut.height));

const status = tenrai.transactions.watch(transactionId);       // one transaction
status.on("final", (update) => console.log(update.lifecycle));

const live = tenrai.live();                                    // subscriptions by topic
live.subscribe({ topic: "cuts", onEvent: (event) => console.log(event.data.cut.height) });

import { signedResponses } from "@tenrai/sdk/verify";

const tenrai = new TenraiClient({ verify: signedResponses({ identity: "c97d68ce…", chainId: "…" }) });