singularity-chain-sdk

TypeScript SDK for Singularity Chain — the 5-VM blockchain with 4M+ TPS.

Install

npm install singularity-chain-sdk

Quick Start

import { SingularityProvider, requestFaucet } from "singularity-chain-sdk";

const provider = new SingularityProvider();

// Get chain stats (real-time TPS, block height, etc.)
const stats = await provider.getStats();
console.log(stats.tps_recent); // ~1,260,000

// Get block info (2M txs per block)
const block = await provider.getBlockInfo(0);
console.log(block.tx_count); // 2,000,000

// Fund your address (testnet faucet)
await provider.faucet("0xYOUR_ADDRESS");

// Get balance
const balance = await provider.getSingBalance("0xYOUR_ADDRESS");
console.log(balance, "SING");

// WebSocket subscriptions
const ws = SingularityProvider.ws();

Network Details

| Field | Value | |-------|-------| | Chain ID | 17743 (0x454F) | | RPC (Zone A) | http://52.206.7.183:8899 | | WebSocket | ws://52.206.7.183:8900 | | Explorer | http://100.27.228.66:8080 | | Docs | http://100.27.228.66:8080/docs | | Gas Price | 0 (free on testnet) | | Native Token | $SING (9 decimals) |

API

SingularityProvider

Extends ethers.JsonRpcProvider with Singularity-specific methods:

• getSingBalance(address) — works with both 0x and base58 addresses
• faucet(address, amount?) — request testnet SING
• getUnifiedReceipt(hash) — cross-VM transaction receipt
• getBlockInfo(height?) — block with VM breakdown
• search(query) — universal search
• getStats() — chain statistics

Standalone Functions

• requestFaucet(address, amount?, rpcUrl?) — standalone faucet
• crossVmTransfer(signer, params) — EVM→SVM/WASM/Move transfers
• getUnifiedBalance(provider, address) — balance across any VM

5 VMs, 1 Token, No Bridges

Singularity Chain runs SVM, EVM, WASM, Move, and ZK on unified state. The $SING token is native to every VM — transfer via SVM and the balance is instantly visible from EVM.