Integration Guide

How to integrate Dollar Infinite into your dApp, bot, script, or tool.

Prerequisites

• Node.js or web environment with ethers.js / web3.js

• BSC RPC: https://bsc-dataseed.binance.org/ (or Infura/Alchemy BSC)

• Contract addresses and ABIs (get from BSCScan or official site)

• Wallet with BNB for tests (use test values)

Step 1: Configure Provider and Signer

Example with ethers.js (recommended):

javascript

const ethers = require('ethers');

// Provider (read-only)
const provider = new ethers.providers.JsonRpcProvider('https://bsc-dataseed.binance.org/');

// Signer (for transactions - NEVER expose private key in frontend!)
const privateKey = process.env.PRIVATE_KEY; // use .env or hardware
const wallet = new ethers.Wallet(privateKey, provider);

Step 2: Load Vault Contract

javascript

const VAULT_ADDRESS = '0x...'; // real Vault address
const VAULT_ABI = [ /* paste complete ABI from BSCScan */ ];

const vault = new ethers.Contract(VAULT_ADDRESS, VAULT_ABI, wallet);

Step 3: Common Integration Examples

3.1 Approve USDT for Vault

javascript

const USDT_ADDRESS = '0x55d398326f99059fF775485246999027B3197955';
const usdt = new ethers.Contract(USDT_ADDRESS, [
  'function approve(address spender, uint256 amount) external returns (bool)'
], wallet);

const amount = ethers.utils.parseUnits('1000', 18); // 1000 USDT
const tx = await usdt.approve(VAULT_ADDRESS, amount);
await tx.wait();
console.log('USDT approved!');

3.2 Make Deposit

javascript

const lockDays = 10; // 1,5,10,20
const tx = await vault.deposit(amount, lockDays);
await tx.wait();
console.log('Deposit successful! Tx hash:', tx.hash);

3.3 Check User Positions

javascript

const userAddress = wallet.address;
const positions = await vault.getUserPositions(userAddress);
console.log('My positions:', positions);

3.4 Calculate Pending Rewards

javascript

const positionId = 123; // get from getUserPositions
const rewards = await vault.getPendingRewards(positionId);
console.log('Pending rewards:', ethers.utils.formatUnits(rewards, 18));

3.5 Withdraw

javascript

const positionId = 123;
const tx = await vault.withdraw(positionId);
await tx.wait();
console.log('Withdraw successful!');

Step 4: Affiliate Integration

Check pending commissions:

javascript

const affiliate = new ethers.Contract(AFFILIATE_ADDRESS, AFFILIATE_ABI, provider);
const pending = await affiliate.getPendingCommissions(userAddress);
console.log('Pending commissions:', ethers.utils.formatUnits(pending, 18));

Integration Best Practices

• Use Multicall to reduce RPC calls (e.g., multicall.bscscan.com)

• Error Handling — Capture revert reasons (e.g., "Lock not matured")

• Event Listening — Use provider.on() for Deposited/Withdrawn

• Frontend — Use wagmi or rainbowkit for wallet connection

• Security — Never expose private keys on client-side

• Testing — Start with small amounts ($10-50)

• Monitoring — Use The Graph or custom indexer for historical data

Warning: Always verify addresses and ABIs on official site or BSCScan. Never use untrusted sources.

→ Next: Code Examples