@torvainchain/sdk

The official TypeScript SDK for the TorvainChain Layer 1 network. It provides a robust interface for interacting with blockchain telemetry, querying blocks, managing balances, deploying/minting CW721 NFT game assets, and building high-performance decentralized gaming applications.

Features

• Core Blockchain Client: Retrieve status, blocks, transaction lists, and validator metrics.
• REST & RPC Telemetry: Native interfaces for querying TorvainChain node services.
• CosmWasm Integration: Smart contract queries and transaction executors for CW721 & CW20.
• Gaming Economy Helpers: Built-in builders for in-game payments, asset lists, and marketplace purchases.

Installation

npm install @torvainchain/sdk

Quick Start

1. Connecting to TorvainChain Testnet

import { TorvainClient } from '@torvainchain/sdk';

const client = await TorvainClient.connect('https://rpc.torvainchain.com');
const height = await client.getHeight();
console.log(`Current Block Height: ${height}`);

2. Querying Balances

const balance = await client.getBalance('torv1...', 'utvn');
console.log(`TVN Balance: ${Number(balance.amount) / 1e6} TVN`);

3. Minting Game Assets (CW721 NFT)

import { TorvainSigningClient } from '@torvainchain/sdk';

const signingClient = await TorvainSigningClient.connectWithSigner(
  'https://rpc.torvainchain.com',
  offlineSigner
);

const mintResult = await signingClient.executeContract(
  'torv1...', // Contract Address
  {
    mint: {
      token_id: 'sword-001',
      owner: 'torv1...',
      token_uri: 'https://metadata.torvainquest.com/item/1.json',
      extension: {
        name: 'Iron Sword of Torvain',
        rarity: 'Epic',
        attack: 45
      }
    }
  }
);
console.log('NFT Minted! Tx Hash:', mintResult.transactionHash);

License

Licensed under the Apache License, Version 2.0.