> For the complete documentation index, see [llms.txt](https://tharwa.gitbook.io/tharwa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tharwa.gitbook.io/tharwa/technical-architecture/smart-contract-addresses.md). # 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](https://etherscan.io/address/0x76972F054aB43829064d31fF5f3AcC5Fabe57FE8) | RWA-backed stablecoin | | **sthUSD** | `0xf7Af0A8079F12F19533B0DF69ce7ee6718b0C46f` | [View](https://etherscan.io/address/0xf7Af0A8079F12F19533B0DF69ce7ee6718b0C46f) | Yield-bearing staked thUSD | | **thBonds** | `0xAc02FF90bC709A134cD4Ad0b50BaB8be9e0f504e` | [View](https://etherscan.io/address/0xAc02FF90bC709A134cD4Ad0b50BaB8be9e0f504e) | Fixed-term bond vaults | | **TRWA** | `0x7b10d50b5885bE4c7985A88408265c109bd1EeC8` | [View](https://etherscan.io/address/0x7b10d50b5885bE4c7985A88408265c109bd1EeC8) | Governance token | | **thUSDSwap** | `0x7b930eaD88e7DAD023af9eaDb5D2AC817096c2Bc` | [View](https://etherscan.io/address/0x7b930eaD88e7DAD023af9eaDb5D2AC817096c2Bc) | thUSD/USDC stableswap | | **thUSD/USDC LP** | `0xF88dE5987a4a114Fab1Fe98E681f83216F4b6E76` | [View](https://etherscan.io/address/0xF88dE5987a4a114Fab1Fe98E681f83216F4b6E76) | Liquidity pool token | ### **Network Details** * **Chain ID**: 1 * **RPC**: `https://mainnet.infura.io/v3/YOUR_KEY` * **Block Explorer**: [Etherscan](https://etherscan.io) *** ## **Sepolia Testnet** Development and testing environment for Tharwa protocol: | Contract | Address | Etherscan | Purpose | | ------------- | -------------------------------------------- | --------------------------------------------------------------------------------------- | -------------------- | | **thUSD** | `0xBDa089250C2bd31db65C99a99D4862d6BAC4446A` | [View](https://sepolia.etherscan.io/address/0xBDa089250C2bd31db65C99a99D4862d6BAC4446A) | Testnet stablecoin | | **sthUSD** | `0xBDa089250C2bd31db65C99a99D4862d6BAC4446A` | [View](https://sepolia.etherscan.io/address/0xBDa089250C2bd31db65C99a99D4862d6BAC4446A) | Testnet staked thUSD | | **thBonds** | `0x716430d4321d05a82bdF8e59AFA96026f0c7ca06` | [View](https://sepolia.etherscan.io/address/0x716430d4321d05a82bdF8e59AFA96026f0c7ca06) | Testnet bonds | | **thUSDSwap** | `0xdc2cf4bec47e2192a04d88986b3f781f6721b7fe` | [View](https://sepolia.etherscan.io/address/0xdc2cf4bec47e2192a04d88986b3f781f6721b7fe) | Testnet stableswap | | **MockDAI** | `0x5574a42Bed488430Fe9F2B901dfB2B98AC2Cf939` | [View](https://sepolia.etherscan.io/address/0x5574a42Bed488430Fe9F2B901dfB2B98AC2Cf939) | Test token | ### **Network Details** * **Chain ID**: 11155111 * **RPC**: `https://sepolia.infura.io/v3/YOUR_KEY` * **Block Explorer**: [Sepolia Etherscan](https://sepolia.etherscan.io) * **Faucet**: [Sepolia Faucet](https://sepoliafaucet.com) *** ## **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 | ✅ Verified | Solidity 0.8.24 | | sthUSD | ✅ Verified | ✅ Verified | Solidity 0.8.24 | | thBonds | ✅ Verified | ✅ Verified | Solidity 0.8.24 | | TRWA | ✅ Verified | ✅ Verified | Solidity 0.8.24 | | thUSDSwap | ✅ Verified | ✅ 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: {% tabs %} {% tab title="Web3.js" %} ```javascript 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) }; } ``` {% endtab %} {% tab title="Ethers.js" %} ```javascript 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); } ``` {% endtab %} {% endtabs %} ### **Advanced Integration: Complete Tharwa Interaction** Here's how to build a complete integration that handles the full Tharwa ecosystem: {% tabs %} {% tab title="Stake thUSD → sthUSD" %} ```javascript // 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; } } ``` {% endtab %} {% tab title="Purchase Tharwa Bonds" %} ```javascript // 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; } } ``` {% endtab %} {% endtabs %} *** ## **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. *** {% hint style="warning" %} **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 {% endhint %} {% hint style="info" %} **Developer Resources** * **GitHub**: [Contract Source Code](https://github.com/tharwa-finance/contracts-v0) * **Discord**: [Developer Support](https://discord.gg/gn9htPaF9v) * **dApp**: [app.tharwa.finance](https://app.tharwa.finance) {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://tharwa.gitbook.io/tharwa/technical-architecture/smart-contract-addresses.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.