A comprehensive Node.js library for interacting with the Toronet blockchain. This package simplifies wallet management, TNS setup, balance queries, fiat deposits, inter-wallet transfers, KYC verification, and smart contract deployment on Toronet's EVM-com
The Toronet SDK is a TypeScript-based toolkit for interacting with the Toronet blockchain. It empowers developers to manage wallets, query blockchain data, handle fiat transactions, verify user identity, manage virtual wallets, bridge tokens from multiple chains (Solana, Base, Polygon, BSC, Arbitrum), and more — all from a developer-friendly interface.
Wallet Management
Blockchain Queries
Token Balance Queries
Fiat Deposits (Multi-Currency)
KYC Verification
Exchange Rate Queries
Comprehensive Query Endpoints
Virtual Wallet System
Address Validation Utility
Advanced Keystore Operations
Advanced TNS Operations
Role Management
Token Operations
Advanced Currency Operations
Product Management
Advanced Payment Operations
Webhook Verification
Currency Swap
Advanced Query Operations
Multi-Chain Bridge Support
Smart Contract Deployment (ToroForge)
npm install torosdk
The SDK supports both mainnet and testnet. You can configure the network when initializing:
import { initializeSDK } from "torosdk";
// Use testnet
initializeSDK({ network: 'testnet' });
// Use mainnet (default)
initializeSDK({ network: 'mainnet' });
// Or use custom URLs
initializeSDK({
network: 'mainnet',
baseURL: 'https://custom-toronet.org',
connectWURL: 'https://custom-connectw.com'
});
Note: If you don't configure the SDK, it defaults to mainnet. All API calls will automatically use the configured network.
import { createWallet } from "torosdk";
const walletAddress = await createWallet({
username: "myuser123",
password: "securePassword123"
});
console.log("Wallet Address:", walletAddress);
import { importWalletFromPrivateKeyAndPassword } from "torosdk";
const address = await importWalletFromPrivateKeyAndPassword({
pvKey: "yourPrivateKeyHere",
password: "yourPasswordHere"
});
console.log("Imported Wallet Address:", address);
import { verifyWalletPassword } from "torosdk";
const isValid = await verifyWalletPassword({
address: "0xYourAddress",
password: "yourPassword"
});
console.log("Password is correct:", isValid);
import { getWalletKey } from "torosdk";
const key = await getWalletKey({
address: "0xYourWalletAddress"
});
console.log("Wallet Key:", key);
import { getBlockchainStatus, getLatestBlockData } from "torosdk";
const status = await getBlockchainStatus();
console.log("Blockchain Status:", status);
const block = await getLatestBlockData();
console.log("Latest Block:", block);
import { getBalance } from "torosdk";
const balances = await getBalance({
address: "0xYourWalletAddress"
});
console.log("Token Balances:", balances);
🔹 Before using this feature, ensure that you have the correct admin credentials.
KYC is required for transactions.
import { performKYCForCustomer, isAddressKYCVerified } from "torosdk";
const kycparams = {
firstName: "John",
middleName: "Doe",
lastName: "Doe",
bvn: "123456789",
currency: "NGN",
phoneNumber: "08012345678",
dob: "1990-01-01",
address: "0xYourWalletAddress",
admin: "yourWhitelistedAdminAddress",
adminpwd: "yourAdminPassword",
};
const isKYCSuccessful = await performKYCForCustomer(kycparams);
console.log("KYC Successful:", isKYCSuccessful);
const isVerified = await isAddressKYCVerified({
address: "0xYourWalletAddress"
});
console.log("KYC Verified:", isVerified);
🔹 Before using this feature, you must register as a project at https://payments.connectw.com/ to get admin credentials.
import { depositFunds } from "torosdk";
import { Currency } from "torosdk/types";
const depositDetails = await depositFunds({
userAddress: "0xYourWalletAddress",
username: "testUser",
amount: "1000",
currency: Currency.Kenyan_Shilling,
admin: "adminAddr",
adminpwd: "@adminPassword"
}, {
payeraddress: "123 Main St",
payercity: "Lagos",
payerstate: "Lagos",
payercountry: "Nigeria",
payerzipcode: "100001",
payerphone: "+2348012345678",
description: "Initial deposit",
success_url: "https://example.com/success",
cancel_url: "https://example.com/cancel",
paymenttype: "deposit",
feetype: "1",
exchange: "72",
reusewallet: "0",
});
console.log("Deposit Info:", depositDetails);
import {
getSupportedAssetsExchangeRates,
getBlocksData,
getBlockchainTransactions,
getAddressRole,
getAddressBalance,
getBlockById,
getTransactionByHash,
getTransactionReceiptById,
getEventById,
getAddressTransactions,
getTransactionsToroWrapper,
getAddressTransactionsToro,
getTransactionsDollarWrapper,
getAddressTransactionsDollar,
getTransactionsNairaWrapper,
getAddressTransactionsNaira,
getTransactionsEuroWrapper,
getAddressTransactionsEuro,
getTransactionsPoundWrapper,
getAddressTransactionsPound,
getTransactionsEGPWrapper,
getAddressTransactionsEGP,
getTransactionsKSHWrapper,
getAddressTransactionsKSH,
getTransactionsZARWrapper,
getAddressTransactionsZAR,
getTransactionsETHWrapper,
getAddressTransactionsETH,
getTransactionsRangeWrapper,
getAddressTransactionsAuth,
isAddressUtil
} from "torosdk";
const rates = await getSupportedAssetsExchangeRates();
console.log("Exchange Rates:", rates);
const blocks = await getBlocksData(5); // last 5 blocks
console.log("Blocks:", blocks);
const txs = await getBlockchainTransactions(10);
console.log("Transactions:", txs);
const addrRole = await getAddressRole("0xYourWalletAddress");
console.log("Address Role:", addrRole);
const addrBalance = await getAddressBalance("0xYourWalletAddress");
console.log("Address Balance:", addrBalance);
const blockById = await getBlockById("latest");
console.log("Block By ID:", blockById);
const txById = await getTransactionByHash("0xYourTxHash");
console.log("Transaction By ID:", txById);
const txReceiptById = await getTransactionReceiptById("0xYourTxHash");
console.log("Transaction Receipt By ID:", txReceiptById);
const eventById = await getEventById("event123");
console.log("Event By ID:", eventById);
const addrTxs = await getAddressTransactions("0xYourWalletAddress", 5);
console.log("Address Transactions:", addrTxs);
const txsToro = await getTransactionsToroWrapper(5);
console.log("Transactions Toro:", txsToro);
const addrTxsToro = await getAddressTransactionsToro("0xYourWalletAddress", 5);
console.log("Address Transactions Toro:", addrTxsToro);
const txsDollar = await getTransactionsDollarWrapper(5);
console.log("Transactions Dollar:", txsDollar);
const addrTxsDollar = await getAddressTransactionsDollar("0xYourWalletAddress", 5);
console.log("Address Transactions Dollar:", addrTxsDollar);
const txsNaira = await getTransactionsNairaWrapper(5);
console.log("Transactions Naira:", txsNaira);
const addrTxsNaira = await getAddressTransactionsNaira("0xYourWalletAddress", 5);
console.log("Address Transactions Naira:", addrTxsNaira);
const txsEuro = await getTransactionsEuroWrapper(5);
console.log("Transactions Euro:", txsEuro);
const addrTxsEuro = await getAddressTransactionsEuro("0xYourWalletAddress", 5);
console.log("Address Transactions Euro:", addrTxsEuro);
const txsPound = await getTransactionsPoundWrapper(5);
console.log("Transactions Pound:", txsPound);
const addrTxsPound = await getAddressTransactionsPound("0xYourWalletAddress", 5);
console.log("Address Transactions Pound:", addrTxsPound);
const txsEGP = await getTransactionsEGPWrapper(5);
console.log("Transactions EGP:", txsEGP);
const addrTxsEGP = await getAddressTransactionsEGP("0xYourWalletAddress", 5);
console.log("Address Transactions EGP:", addrTxsEGP);
const txsKSH = await getTransactionsKSHWrapper(5);
console.log("Transactions KSH:", txsKSH);
const addrTxsKSH = await getAddressTransactionsKSH("0xYourWalletAddress", 5);
console.log("Address Transactions KSH:", addrTxsKSH);
const txsZAR = await getTransactionsZARWrapper(5);
console.log("Transactions ZAR:", txsZAR);
const addrTxsZAR = await getAddressTransactionsZAR("0xYourWalletAddress", 5);
console.log("Address Transactions ZAR:", addrTxsZAR);
const txsETH = await getTransactionsETHWrapper(5);
console.log("Transactions ETH:", txsETH);
const addrTxsETH = await getAddressTransactionsETH("0xYourWalletAddress", 5);
console.log("Address Transactions ETH:", addrTxsETH);
const txsRange = await getTransactionsRangeWrapper(0, 10);
console.log("Transactions Range:", txsRange);
const addrTxsAuth = await getAddressTransactionsAuth("0xYourWalletAddress", 5);
console.log("Address Transactions Auth:", addrTxsAuth);
// Address validation
const isAddrValid = await isAddressUtil("0xYourWalletAddress");
console.log("Is Address Valid:", isAddrValid);
import {
createVirtualWallet,
fetchVirtualWallet,
fetchVirtualWalletByAddress,
updateVirtualWalletTxs
} from "torosdk";
const virtualWallet = await createVirtualWallet({
address: "0xYourWalletAddress",
payername: "Demo User",
currency: Currency.Naira,
admin: "0xadminaddress",
adminpwd: "adminpassword",
});
console.log("Created Virtual Wallet:", virtualWallet);
const fetchedVirtualWallet = await fetchVirtualWallet({
virtualwallet: "8900610225",
admin: "0xadminaddress",
adminpwd: "adminpassword",
});
console.log("Fetched Virtual Wallet:", fetchedVirtualWallet);
const fetchedVirtualWalletByAddress = await fetchVirtualWalletByAddress({
address: "0xYourWalletAddress",
admin: "0xadminaddress",
adminpwd: "adminpassword",
});
console.log("Fetched Virtual Wallet By Address:", fetchedVirtualWalletByAddress);
const updatedVirtualWalletTxs = await updateVirtualWalletTxs({
walletaddress: "8900610225",
admin: "0xadminaddress",
adminpwd: "adminpassword",
});
console.log("Updated Virtual Wallet Transactions:", updatedVirtualWalletTxs);
import { updatePassword } from "torosdk";
const result = await updatePassword({
address: "0xYourWalletAddress",
oldPassword: "oldPassword123",
newPassword: "newPassword456"
});
console.log("Password updated:", result);
import { deleteWallet } from "torosdk";
const result = await deleteWallet({
address: "0xYourWalletAddress",
password: "yourPassword"
});
console.log("Wallet deleted:", result);
import {
getName,
getAddr,
updateName,
deleteName,
isAddrAssigned,
adminSetName
} from "torosdk";
// Query operations
const name = await getName({ address: "0xAddress" });
const address = await getAddr({ name: "username" });
const isAssigned = await isAddrAssigned({ address: "0xAddress" });
// Client operations
await updateName({
address: "0xAddress",
password: "password",
username: "newusername"
});
await deleteName({
address: "0xAddress",
password: "password"
});
// Admin operations
await adminSetName({
address: "0xAddress",
username: "newusername",
admin: "0xAdminAddress",
adminpwd: "adminPassword"
});
import {
isAdmin,
addAdmin,
removeAdmin,
isSuperAdmin,
addSuperAdmin,
isDebugger
} from "torosdk";
// Check roles
const isAddrAdmin = await isAdmin({ address: "0xAddress" });
const isAddrSuperAdmin = await isSuperAdmin({ address: "0xAddress" });
const isAddrDebugger = await isDebugger({ address: "0xAddress" });
// Manage admins (requires super admin)
await addAdmin({
address: "0xSuperAdminAddress",
password: "superAdminPassword",
adminAddress: "0xNewAdminAddress"
});
await removeAdmin({
address: "0xSuperAdminAddress",
password: "superAdminPassword",
adminAddress: "0xAdminToRemove"
});
import {
getTokenName,
getTokenSymbol,
getTokenDecimal,
getTokenBalance,
getAllowance,
getTransactionFee,
isEnrolled,
isFrozen
} from "torosdk";
// Token metadata
const name = await getTokenName();
const symbol = await getTokenSymbol();
const decimals = await getTokenDecimal();
// Balance and allowances
const balance = await getTokenBalance({ address: "0xAddress" });
const allowance = await getAllowance({
owner: "0xOwnerAddress",
spender: "0xSpenderAddress"
});
// Fees
const fee = await getTransactionFee({ amount: "1000" });
// Status checks
const enrolled = await isEnrolled({ address: "0xAddress" });
const frozen = await isFrozen({ address: "0xAddress" });
import {
getCurrencyBalance,
transferCurrency,
allowTransfer,
freezeAddress,
enrollAddress,
mintCurrency,
burnCurrency
} from "torosdk";
// Get balance
const balance = await getCurrencyBalance({
currency: "NGN",
address: "0xAddress"
});
// Transfer (client)
await transferCurrency({
currency: "NGN",
senderAddr: "0xSender",
senderPwd: "password",
receiverAddr: "0xReceiver",
amount: "1000"
});
// Owner operations
await allowTransfer({
currency: "NGN",
address: "0xOwnerAddress",
password: "ownerPassword"
});
// Admin operations
await freezeAddress({
currency: "NGN",
address: "0xAdminAddress",
admin: "0xAdminAddress",
adminpwd: "adminPassword",
targetAddress: "0xTargetAddress"
});
await mintCurrency({
currency: "NGN",
address: "0xAdminAddress",
admin: "0xAdminAddress",
adminpwd: "adminPassword",
targetAddress: "0xRecipientAddress",
amount: "1000"
});
import {
getProject,
getProduct,
recordProduct,
updateProduct
} from "torosdk";
// Get project info
const project = await getProject({
admin: "0xAdminAddress",
getbalances: "true"
});
// Product operations
const product = await getProduct({
productId: "product123",
admin: "0xAdminAddress",
adminpwd: "adminPassword"
});
await recordProduct({
productId: "product123",
productName: "My Product",
description: "Product description",
productImage: "https://example.com/image.jpg",
admin: "0xAdminAddress",
adminpwd: "adminPassword"
});
import {
getBankListUSD,
getBankListNGN,
recordFiatWithdrawal,
verifyBankAccountNameNGN,
getFiatTransactionsAddressRange,
getFiatWithdrawalsAddressRange
} from "torosdk";
// Get bank lists
const usdBanks = await getBankListUSD({
admin: "0xAdminAddress",
adminpwd: "adminPassword"
});
const ngnBanks = await getBankListNGN({
admin: "0xAdminAddress",
adminpwd: "adminPassword"
});
// Record withdrawal
await recordFiatWithdrawal({
address: "0xAddress",
password: "password",
currency: "NGN",
token: "NGN",
payername: "John Doe",
payeremail: "john@example.com",
description: "Withdrawal",
amount: "1000",
accounttype: "savings",
bankname: "Bank Name",
routingno: "123456",
accountno: "1234567890",
accountname: "John Doe",
admin: "0xAdminAddress",
adminpwd: "adminPassword"
});
// Verify bank account
const verification = await verifyBankAccountNameNGN({
destinationInstitutionCode: "058",
accountNumber: "1234567890",
admin: "0xAdminAddress",
adminpwd: "adminPassword"
});
// Date range queries
const transactions = await getFiatTransactionsAddressRange({
address: "0xAddress",
startDate: "2024-01-01",
endDate: "2024-12-31",
currency: "NGN",
admin: "0xAdminAddress",
adminpwd: "adminPassword"
});
import { getAddrTransactionsRange } from "torosdk";
const transactions = await getAddrTransactionsRange({
address: "0xAddress",
startDate: "2024-01-01",
endDate: "2024-12-31",
token: "NGN", // Optional token filter
count: 100, // Optional pagination
start: 0 // Optional offset
});
The SDK supports bridging tokens from multiple blockchain networks to Toronet. Supported chains include Solana, Base, Polygon, BSC, and Arbitrum.
import {
createSolanaAddress,
isValidSolanaAddress,
createToronetSolanaAddress,
verifySolanaVirtualAddressEnc,
verifySolanaVirtualAddress,
getSolBalance,
getSolTokenBalance,
getSolLatestBlock,
getSolTransactions,
getSolTokenTransactions,
transferSolana,
transferSolToken,
bridgeTokenSol,
getBridgeTokenFeeSol,
BridgeNetwork
} from "torosdk";
// Create a new Solana address (prefer generatevirtualwallet for linking to Toronet)
const solAddress = await createSolanaAddress({
admin: "0xAdminAddress",
adminpwd: "adminPassword"
});
console.log("Created Solana address:", solAddress);
// Validate Solana address
const isValid = await isValidSolanaAddress("3uwR7HMDuK6dXwZAfx8jHwPcyXsYmFuHWJv3zvJxRE9w");
console.log("Is valid Solana address:", isValid);
// Create a custodial Solana address linked to Toronet address
const toronetSolAddress = await createToronetSolanaAddress({
addr: "0xYourToronetAddress",
pwd: "YourPassword"
});
console.log("Created Toronet-linked Solana address:", toronetSolAddress);
// Verify Solana virtual address encryption
const encVerified = await verifySolanaVirtualAddressEnc(
"0xYourToronetAddress",
"YourPassword"
);
console.log("Encryption verified:", encVerified);
// Verify Solana virtual address (Toronet address)
const addrVerified = await verifySolanaVirtualAddress(
"0xYourToronetAddress",
"YourPassword"
);
console.log("Address verified:", addrVerified);
// Get SOL balance
const solBalance = await getSolBalance({
address: "3uwR7HMDuK6dXwZAfx8jHwPcyXsYmFuHWJv3zvJxRE9w"
});
console.log("SOL balance:", solBalance);
// Get SPL token balance (e.g., USDC on Solana)
const usdcBalance = await getSolTokenBalance({
address: "3uwR7HMDuK6dXwZAfx8jHwPcyXsYmFuHWJv3zvJxRE9w",
contractaddress: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" // USDC contract
});
console.log("USDC balance on Solana:", usdcBalance);
// Get latest Solana block
const latestBlock = await getSolLatestBlock();
console.log("Latest Solana block:", latestBlock);
// Get SOL transactions for an address
const solTransactions = await getSolTransactions({
address: "3uwR7HMDuK6dXwZAfx8jHwPcyXsYmFuHWJv3zvJxRE9w"
});
console.log("SOL transactions:", solTransactions);
// Get SPL token transactions for an address
const tokenTransactions = await getSolTokenTransactions({
address: "3uwR7HMDuK6dXwZAfx8jHwPcyXsYmFuHWJv3zvJxRE9w",
contractaddress: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
});
console.log("USDC transactions on Solana:", tokenTransactions);
// Transfer SOL
await transferSolana({
from: "3uwR7HMDuK6dXwZAfx8jHwPcyXsYmFuHWJv3zvJxRE9w",
to: "2Ha5ETJGGahgeLpqhTiAYWhAtre1bAGaG47zTDPzJcP4",
amount: "0.1",
pwd: "YourPassword"
});
console.log("✓ SOL transferred");
// Transfer SPL token (e.g., USDC)
await transferSolToken({
from: "3uwR7HMDuK6dXwZAfx8jHwPcyXsYmFuHWJv3zvJxRE9w",
to: "2Ha5ETJGGahgeLpqhTiAYWhAtre1bAGaG47zTDPzJcP4",
amount: "10",
pwd: "YourPassword",
contractaddress: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
tokenname: "USDC",
usetokenasfees: "true" // Use token for fees if not enough SOL
});
console.log("✓ USDC transferred on Solana");
// Get bridge fee estimate
const fee = await getBridgeTokenFeeSol({
network: BridgeNetwork.Solana,
contractaddress: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
amount: "100"
});
console.log("Bridge fee:", fee);
// Bridge USDC from Solana to Toronet
await bridgeTokenSol({
from: "0xYourToronetAddress",
pwd: "YourPassword",
network: BridgeNetwork.Solana,
contractaddress: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
tokenname: "USDC",
amount: "100"
});
console.log("✓ USDC bridged from Solana to Toronet");
import {
getBalanceBase,
getTokenBalanceBase,
bridgeTokenBase,
getBalancePolygon,
getTokenBalancePolygon,
bridgeTokenPolygon,
getBalanceBSC,
getTokenBalanceBSC,
bridgeTokenBSC,
getBalanceArbitrum,
getTokenBalanceArbitrum,
bridgeTokenArbitrum,
BridgeNetwork
} from "torosdk";
// Get balance on Base
const baseBalance = await getBalanceBase({
address: "0xff9602fd3a10038ac2b6d9b03277dc5c7d154ada"
});
// Get USDC balance on Polygon
const polyUSDC = await getTokenBalancePolygon({
address: "0xff9602fd3a10038ac2b6d9b03277dc5c7d154ada",
contractaddress: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
tokenname: "USDC"
});
// Bridge USDC from Polygon to Toronet
await bridgeTokenPolygon({
from: "0xYourToronetAddress",
pwd: "YourPassword",
network: BridgeNetwork.Polygon,
contractaddress: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
tokenname: "USDC",
amount: "50"
});
// Bridge USDT from BSC to Toronet
await bridgeTokenBSC({
from: "0xYourToronetAddress",
pwd: "YourPassword",
network: BridgeNetwork.BSC,
contractaddress: "0x55d398326f99059ff775485246999027b3197955",
tokenname: "USDT",
amount: "100"
});
import {
getBridgeBalance,
getBridgeTokenBalance,
getBridgeTransactions,
getBridgeTokenTransactions,
bridgeTokenFromChain,
getBridgeTokenFeeEstimate,
BridgeNetwork
} from "torosdk";
// Get balance on any supported external chain
const balance = await getBridgeBalance(BridgeNetwork.Base, {
address: "0xff9602fd3a10038ac2b6d9b03277dc5c7d154ada"
});
// Get token balance on external chain
const tokenBalance = await getBridgeTokenBalance(BridgeNetwork.Polygon, {
address: "0xff9602fd3a10038ac2b6d9b03277dc5c7d154ada",
contractaddress: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
tokenname: "USDC"
});
// Get transactions on external chain
const transactions = await getBridgeTransactions(BridgeNetwork.BSC, {
address: "0xff9602fd3a10038ac2b6d9b03277dc5c7d154ada"
});
// Bridge token from any external chain to Toronet
await bridgeTokenFromChain(BridgeNetwork.Arbitrum, {
from: "0xYourToronetAddress",
pwd: "YourPassword",
network: BridgeNetwork.Arbitrum,
contractaddress: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
tokenname: "USDC",
amount: "75"
});
// Get bridge fee estimate
const fee = await getBridgeTokenFeeEstimate(BridgeNetwork.Base, {
network: BridgeNetwork.Base,
contractaddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
amount: "50"
});
import {
paymentInitializeCrypto,
recordCryptoPayment
} from "torosdk";
// Initialize crypto deposit from Solana
const deposit = await paymentInitializeCrypto({
address: "0xYourToronetAddress",
pwd: "YourPassword",
currency: "USDCSOL", // Currency codes: USDCSOL, USDTBSC, USDCPOLY, USDCARB, USDCBASE
token: "TORO",
amount: "100",
paymenttype: "crypto"
}, "0xAdminAddress", "adminPassword");
// Record completed crypto payment
await recordCryptoPayment({
currency: "USDCSOL",
txid: "3uwR7HMDuK6dXwZAfx8jHwPcyXsYmFuHWJv3zvJxRE9w_8e21df8325dc5e88"
}, "0xAdminAddress", "adminPassword");
For more detailed bridge examples, see CODE_SAMPLES.md.
Deploy compiled Solidity contracts to Toronet using the ToroForge deployer. See the full Deployer Guide for details.
import { initializeSDK, deploySmartContract } from "torosdk";
// Configure for testnet
initializeSDK({ network: 'testnet' });
// Deploy a contract
const result = await deploySmartContract({
owner: "", // Empty string lets the server assign the owner
constructorArgs: [
"0x0dCDCeF127786cC71EF6658f24E7268Fe349cCB8",
"0x0dCDCeF127786cC71EF6658f24E7268Fe349cCB8"
],
abi: [/* your contract ABI */],
bytecode: "0x608060...",
});
console.log("Contract deployed at:", result.address);
console.log("ABI with signatures:", result.abi);
Mainnet deployments require a token from the Toronet team:
initializeSDK({ network: 'mainnet' });
const result = await deploySmartContract({
owner: "0xYourAddress",
constructorArgs: [],
abi: [/* ... */],
bytecode: "0x608060...",
token: "your-mainnet-deploy-token",
});
Get and record ConnectW payment transactions by their transaction ID.
import { getPaymentTransactionStatus, recordPaymentTransactionStatus } from "torosdk";
// Get a payment transaction by ID
const transaction = await getPaymentTransactionStatus({
transactionId: "0100120106_222691821e91a0fee6a0d73a6a1b5c06",
admin: "0xAdminAddress",
adminpwd: "adminPassword",
});
console.log("Status:", transaction.data.status);
console.log("Amount:", transaction.data.TX_Amount);
// Manually record/trigger a payment transaction
const recorded = await recordPaymentTransactionStatus({
transactionId: "0100120106_222691821e91a0fee6a0d73a6a1b5c06",
admin: "0xAdminAddress",
adminpwd: "adminPassword",
});
Verify incoming ConnectW webhook signatures in your backend to ensure authenticity.
import { verifyWebhookSignature, WebhookEventPayload } from "torosdk";
export async function POST(request: Request) {
const payload = await request.text();
const secret = process.env.WEBHOOK_SECRET!; // "whsec_XXXXXXXX..."
try {
verifyWebhookSignature({
payload,
secret,
svixId: request.headers.get("svix-id")!,
svixTimestamp: request.headers.get("svix-timestamp")!,
svixSignature: request.headers.get("svix-signature")!,
});
const event: WebhookEventPayload = JSON.parse(payload);
console.log("Event:", event.event, "Status:", event.data.status);
return new Response(JSON.stringify({ received: true }), { status: 200 });
} catch (error) {
return new Response(JSON.stringify({ error: "Invalid signature" }), { status: 401 });
}
}
Verify incoming ConnectW webhook signatures in your backend to ensure authenticity.
import { verifyWebhookSignature, WebhookEventPayload } from "torosdk";
export async function POST(request: Request) {
const payload = await request.text();
const secret = process.env.WEBHOOK_SECRET!; // "whsec_XXXXXXXX..."
try {
verifyWebhookSignature({
payload,
secret,
svixId: request.headers.get("svix-id")!,
svixTimestamp: request.headers.get("svix-timestamp")!,
svixSignature: request.headers.get("svix-signature")!,
});
const event: WebhookEventPayload = JSON.parse(payload);
console.log("Event:", event.event, "Status:", event.data.status);
return new Response(JSON.stringify({ received: true }), { status: 200 });
} catch (error) {
return new Response(JSON.stringify({ error: "Invalid signature" }), { status: 401 });
}
}
Get live exchange rates and execute on-chain swaps between 40+ currencies and TORO.
import { getSwapQuote, swapCurrency } from "torosdk";
// 1. Preview the rate (no auth required)
const quote = await getSwapQuote({
fromCurrency: "ngn",
toCurrency: "toro",
amount: 1400,
});
console.log(`Rate: ${quote.rate}, You receive: ${quote.convertedAmount} TORO`);
// 2. Execute the swap
const result = await swapCurrency({
fromCurrency: "ngn",
toCurrency: "toro",
amount: 1400,
client: "0xYourWalletAddress",
clientPassword: "yourWalletPassword",
});
console.log("Swap result:", result);
export enum Currency {
Naira = "NGN",
Euro = "EUR",
Dollar = "USD",
Pound = "GBP",
Kenyan_Shilling = "KSH",
South_African_Rand = "ZAR",
}
src/
├── api/
│ ├── account.ts
│ ├── balance.ts
│ ├── blockchain.ts
│ ├── keystore.ts
│ ├── payments.ts
│ ├── bridge/ # Multi-chain bridge operations
│ │ ├── solana.ts # Solana bridge operations
│ │ ├── base.ts # Base chain operations
│ │ ├── polygon.ts # Polygon chain operations
│ │ ├── bsc.ts # BSC chain operations
│ │ ├── arbitrum.ts # Arbitrum chain operations
│ │ ├── payments.ts # Crypto payment operations
│ │ └── index.ts
│ └── config.ts
│
├── query/ # On-chain data queries
│ └── queries.ts
│
├── services/ # Business logic
│ ├── walletService.ts
│ ├── balanceService.ts
│ ├── paymentService.ts
│ ├── bridge_service.ts # Bridge service wrappers
│ ├── deployer_service.ts # Smart contract deployment
│ └── utils.ts
│
├── virtualwallet/ # Virtual wallet business logic
│ └── virtualwallet.ts
│
├── types/ # Global types and enums
│ └── bridge.ts # Bridge type definitions
├── utils/
├── index.ts # SDK entry
We welcome contributions from the community!
MIT License – see LICENSE file.
Join our developer community on Discord.
---
FAQs
A comprehensive Node.js library for interacting with the Toronet blockchain. This package simplifies wallet management, TNS setup, balance queries, fiat deposits, inter-wallet transfers, KYC verification, and smart contract deployment on Toronet's EVM-com
We found that torosdk demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Benign-looking npm packages split malicious functionality across a dependency chain that deploys a cross-platform RAT targeting Alibaba developers.
Research
/Security News
Two Joyfill npm beta releases contain an import-time implant that uses blockchain transactions to retrieve a remote-access trojan.
Security News
Socket releases free Certified Patches for high-severity Nuxt vulnerabilities, including server-side remote code execution through server island props.