Smart Contract Addresses

This page provides verified contract addresses and practical integration examples for all Tharwa protocol deployments. Each contract is explained with its purpose, key functions, and real-world usage patterns.

Ethereum Mainnet

All core Tharwa contracts are deployed and operational on Ethereum Mainnet:

Contract

Address

Etherscan

Purpose

thUSD

0x76972F054aB43829064d31fF5f3AcC5Fabe57FE8

View

RWA-backed stablecoin

sthUSD

0xf7Af0A8079F12F19533B0DF69ce7ee6718b0C46f

View

Yield-bearing staked thUSD

thBonds

0xAc02FF90bC709A134cD4Ad0b50BaB8be9e0f504e

View

Fixed-term bond vaults

TRWA

0x7b10d50b5885bE4c7985A88408265c109bd1EeC8

View

Governance token

thUSDSwap

0x7b930eaD88e7DAD023af9eaDb5D2AC817096c2Bc

View

thUSD/USDC stableswap

thUSD/USDC LP

0xF88dE5987a4a114Fab1Fe98E681f83216F4b6E76

View

Liquidity pool token

Network Details

Chain ID: 1
RPC: https://mainnet.infura.io/v3/YOUR_KEY
Block Explorer: Etherscan

Sepolia Testnet

Development and testing environment for Tharwa protocol:

Contract

Address

Etherscan

Purpose

thUSD

0xBDa089250C2bd31db65C99a99D4862d6BAC4446A

View

Testnet stablecoin

sthUSD

0xBDa089250C2bd31db65C99a99D4862d6BAC4446A

View

Testnet staked thUSD

thBonds

0x716430d4321d05a82bdF8e59AFA96026f0c7ca06

View

Testnet bonds

thUSDSwap

0xdc2cf4bec47e2192a04d88986b3f781f6721b7fe

View

Testnet stableswap

MockDAI

0x5574a42Bed488430Fe9F2B901dfB2B98AC2Cf939

View

Test token

Network Details

Chain ID: 11155111
RPC: https://sepolia.infura.io/v3/YOUR_KEY
Block Explorer: Sepolia Etherscan
Faucet: Sepolia Faucet

Contract Verification

All contracts are verified on Etherscan with:

✅ Source code published
✅ Constructor arguments verified
✅ Proxy implementation verified (where applicable)
✅ ABI available for integration

Verification Status

Contract

Mainnet

Sepolia

Compiler

thUSD

✅ Verified

Solidity 0.8.24

sthUSD

✅ Verified

Solidity 0.8.24

thBonds

✅ Verified

Solidity 0.8.24

TRWA

✅ Verified

Solidity 0.8.24

thUSDSwap

✅ Verified

Solidity 0.8.24

Integration Examples: Real-World Usage

Basic Integration: Checking User Balances

Most integrations start with reading user balances across Tharwa's ecosystem:

const Web3 = require('web3');
const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_KEY');

// Contract instances
const thUSD = new web3.eth.Contract(thUSDABI, '0x76972F054aB43829064d31fF5f3AcC5Fabe57FE8');
const sthUSD = new web3.eth.Contract(sthUSDABI, '0xf7Af0A8079F12F19533B0DF69ce7ee6718b0C46f');

// Get user's complete Tharwa position
async function getUserPosition(userAddress) {
    const [thUSDBalance, sthUSDShares, sthUSDValue] = await Promise.all([
        thUSD.methods.balanceOf(userAddress).call(),
        sthUSD.methods.balanceOf(userAddress).call(),
        sthUSD.methods.convertToAssets(await sthUSD.methods.balanceOf(userAddress).call()).call()
    ]);
    
    return {
        thUSD: thUSDBalance,
        sthUSDShares: sthUSDShares,
        sthUSDValue: sthUSDValue,
        totalValue: BigInt(thUSDBalance) + BigInt(sthUSDValue)
    };
}

const { ethers } = require('ethers');
const provider = new ethers.providers.JsonRpcProvider('https://mainnet.infura.io/v3/YOUR_KEY');

// Contract instances
const thUSD = new ethers.Contract('0x76972F054aB43829064d31fF5f3AcC5Fabe57FE8', thUSDABI, provider);
const sthUSD = new ethers.Contract('0xf7Af0A8079F12F19533B0DF69ce7ee6718b0C46f', sthUSDABI, provider);

// Get current sthUSD exchange rate
async function getExchangeRate() {
    const totalAssets = await sthUSD.totalAssets();
    const totalSupply = await sthUSD.totalSupply();
    
    // Rate = assets per share (in 18 decimals)
    return totalAssets.mul(ethers.utils.parseEther('1')).div(totalSupply);
}

Advanced Integration: Complete Tharwa Interaction

Here's how to build a complete integration that handles the full Tharwa ecosystem:

// Complete staking flow with error handling
async function stakeThUSD(amount, userAddress, signer) {
    try {
        // 1. Check user's thUSD balance
        const balance = await thUSD.balanceOf(userAddress);
        if (balance.lt(amount)) throw new Error('Insufficient thUSD balance');
        
        // 2. Check allowance
        const allowance = await thUSD.allowance(userAddress, sthUSD.address);
        if (allowance.lt(amount)) {
            // Approve sthUSD to spend thUSD
            const approveTx = await thUSD.connect(signer).approve(sthUSD.address, amount);
            await approveTx.wait();
        }
        
        // 3. Preview the deposit to show user expected shares
        const expectedShares = await sthUSD.previewDeposit(amount);
        console.log(`You will receive ${ethers.utils.formatEther(expectedShares)} sthUSD shares`);
        
        // 4. Execute the stake
        const stakeTx = await sthUSD.connect(signer).deposit(amount, userAddress);
        const receipt = await stakeTx.wait();
        
        // 5. Confirm success
        const newBalance = await sthUSD.balanceOf(userAddress);
        console.log(`Staking successful! New sthUSD balance: ${ethers.utils.formatEther(newBalance)}`);
        
        return receipt;
    } catch (error) {
        console.error('Staking failed:', error.message);
        throw error;
    }
}

// Complete bond purchase with metadata
async function purchaseBond(duration, faceAmount, userAddress, signer) {
    try {
        // 1. Get bond configuration
        const config = await thBonds.bondConfigs(duration);
        const purchasePrice = faceAmount.mul(config.price).div(ethers.utils.parseEther('1'));
        
        // 2. Check if purchase is possible
        if (config.paused) throw new Error('Bond type is paused');
        if (config.issued.add(faceAmount).gt(config.cap)) throw new Error('Would exceed bond cap');
        
        // 3. Check user balance and approve
        const balance = await thUSD.balanceOf(userAddress);
        if (balance.lt(purchasePrice)) throw new Error('Insufficient thUSD for purchase');
        
        const allowance = await thUSD.allowance(userAddress, thBonds.address);
        if (allowance.lt(purchasePrice)) {
            const approveTx = await thUSD.connect(signer).approve(thBonds.address, purchasePrice);
            await approveTx.wait();
        }
        
        // 4. Calculate expected maturity
        const durationSeconds = duration === 0 ? 90*24*60*60 : duration === 1 ? 180*24*60*60 : 360*24*60*60;
        const maturityTime = Math.floor((Date.now() + durationSeconds * 1000) / (24*60*60*1000)) * 24*60*60;
        
        console.log(`Bond will mature on: ${new Date(maturityTime * 1000).toISOString()}`);
        console.log(`You pay: ${ethers.utils.formatEther(purchasePrice)} thUSD`);
        console.log(`You receive at maturity: ${ethers.utils.formatEther(faceAmount)} thUSD`);
        
        // 5. Purchase the bond
        const purchaseTx = await thBonds.connect(signer).purchaseBond(duration, faceAmount, userAddress);
        const receipt = await purchaseTx.wait();
        
        return { receipt, tokenId: maturityTime };
    } catch (error) {
        console.error('Bond purchase failed:', error.message);
        throw error;
    }
}

Future Deployments

Planned Networks

Arbitrum: TBA
Polygon: TBA
Base: TBA
Optimism: TBA

All future deployments will use LayerZero's OFT standard for seamless cross-chain functionality.

Important Notes

Always verify contract addresses from official sources
Test integrations on Sepolia before mainnet deployment
Use latest ABI from verified Etherscan contracts
Monitor for contract upgrades and announcements

Developer Resources

GitHub: Contract Source Code
Discord: Developer Support
dApp: app.tharwa.finance

PreviousTechnical Overview NextsthUSD Implementation

Last updated 2 months ago