bnb-chain-toolkit-guide

BNB Chain Toolkit Guide

A modular TypeScript toolkit for building, deploying, and interacting with smart contracts on BNB Chain. Created by the Sperax team for the BNB Chain Hackathon.

Modules

Module	Purpose	Key Features
Token	BEP-20 operations	Deploy, transfer, approve, metadata
DeFi	Protocol integrations	PancakeSwap, Venus, Thena
Wallet	Wallet management	Create, import, sign, batch ops
Bridge	Cross-chain	BSC ↔ Ethereum, Arbitrum, etc.
Contract	Smart contract tools	Deploy, verify, interact, ABI
MCP	AI agent interface	All above as MCP tools

Quick Start

# Install
npm install @nirholas/bnb-chain-toolkit

# Or use with MCP
npx @nirholas/bnb-chain-toolkit mcp

Token Module

Deploy a BEP-20 Token

import { TokenModule } from '@nirholas/bnb-chain-toolkit';

const token = new TokenModule(provider);
const result = await token.deploy({
  name: 'My Token',
  symbol: 'MTK',
  totalSupply: '1000000',
  decimals: 18
});
console.log(`Token deployed at: ${result.address}`);

Token Operations

// Get token info
const info = await token.getInfo('0x...');
// { name, symbol, decimals, totalSupply, owner }

// Transfer tokens
await token.transfer('0xRecipient', '1000', '0xTokenAddress');

// Approve spending
await token.approve('0xSpender', '1000', '0xTokenAddress');

// Check allowance
const allowance = await token.allowance('0xOwner', '0xSpender', '0xToken');

DeFi Module

PancakeSwap Integration

import { DeFiModule } from '@nirholas/bnb-chain-toolkit';

const defi = new DeFiModule(provider);

// Get swap quote
const quote = await defi.getSwapQuote({
  tokenIn: 'BNB',
  tokenOut: 'USDT',
  amountIn: '1'
});

// Execute swap
await defi.swap({
  tokenIn: 'BNB',
  tokenOut: 'USDT',
  amountIn: '1',
  slippage: 0.5
});

Venus Lending

// Supply collateral
await defi.supply({ protocol: 'venus', token: 'USDT', amount: '1000' });

// Borrow
await defi.borrow({ protocol: 'venus', token: 'BNB', amount: '0.5' });