ton-node-kit

ton-node-kit

Useful utilities for working with TON in NodeJS

Install

npm install ton-node-kit

Usage

import { Address, TonClient } from '@ton/ton';
import type { Transaction } from '@ton/ton';

import {
  getTxComment,
  getTxSender,
  getTxValueAmount,
  withRetry,
} from 'ton-node-kit';

const myAddress = Address.parse('<your-wallet-address>');

const client = new TonClient({
  endpoint: 'https://testnet.toncenter.com/api/v2/jsonRPC',
  apiKey: process.env.TON_API_KEY,
});

const TRANSACTION_LIMIT = 1;
const RETRY_LIMIT = 30;
const RETRY_DELAY_MS = 100;

const getTransactions = async () => {
  return (await withRetry(
    () =>
      client.getTransactions(myAddress, {
        limit: TRANSACTION_LIMIT,
      }),
    RETRY_LIMIT,
    RETRY_DELAY_MS,
  )) as Transaction[];
};

const transactions = await getTransactions();

for (const tx of transactions) {
  const commentText = getTxComment(tx);
  const tonValue = getTxValueAmount(tx);
  const nanoValue = getTxValueAmount(tx, {
    currency: 'nano',
    returnBigint: true,
  });
  const sender = getTxSender(tx);

  console.log('Transaction', {
    commentText,
    tonValue,
    nanoValue,
    sender,
  });
  // Transaction {
  //   commentText: 'Hello, TON!',
  //   nanoValue: 50000000n,
  //   tonValue: '0.05'
  //   sender: <sender-wallet-address>
  // }
}