HavenScience

A decentralized token launchpad with bonding curve mechanisms built on BNB Smart Chain (BSC) and compatible with other EVM networks.

Technology Stack

• Blockchain: BNB Smart Chain + EVM-compatible chains
• Smart Contracts: Solidity ^0.8.20
• Frontend: React + Vite + ethers.js + wagmi + RainbowKit
• Backend: Supabase + Node.js API endpoints
• Development: Hardhat, OpenZeppelin libraries
• Real-time: WebSocket-based blockchain indexer

Supported Networks

• BNB Smart Chain Mainnet (Chain ID: 56)
• BNB Smart Chain Testnet (Chain ID: 97)

Contract Addresses

Core Contracts (BNB Mainnet)

Contract	Address
Router	0x26e442d47529091dd5e41c8e08c729cf4ee9f95d
HAVEN Factory	0xA82E806F3aee4C0e306fB4d989354F9e43Ff7dE4
BNB Factory	0xaD6D411363b4271E30D84db226482Cd4B88eF428
HAVEN Token	0x0Cce89Fb7f51aDB16Cd1e18be58457a70F5D93e7
Test Token (BNB)	0x619E5F39A2aaCB5b978384deF6e03D75543878E9

Helper Contracts

Contract	Address
Graduation Helper (HAVEN)	0x7DaeDEBDeDCEDc1ce661F5d7bC7e4d801Ff08Bc2
Graduation Helper (BNB)	0x1AD23aEf94bBeD915a0F536E23B47ff773Daf218
Address Predictor (HAVEN)	0x8a9cA2aC69c1E9bc6D5b74C98E3e03bECE12e27A
Address Predictor (BNB)	0x2DAbdb4235588608a64c97a3017Bf6E62C526017
Deployer Library	0x00e2401a6C3d220e258B4998ebCF1D199b379a55

Standard Contracts

Contract	Address
PancakeSwap Router V2	0x10ED43C718714eb63d5aA57B78B54704E256024E
WBNB	0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c

Features

• Bonding Curve Token Launch: Fair launch mechanism with automated market making
• Multi-Pair Support: Create tokens paired with BNB or HAVEN
• Low-Cost Transactions: Gas-efficient design optimized for BNB Smart Chain
• Real-time Indexing: WebSocket-based blockchain event monitoring
• AI-Powered Agents: Create intelligent trading agents with customizable strategies
• Advanced Trading Interface: TradingView charts, price feeds, and trade history
• Creator Fees: Built-in fee collection for token creators
• Graduation Mechanism: Automatic liquidity migration to PancakeSwap at threshold

Project Structure

├── api/                    # Backend API endpoints
│   ├── blockchain/         # Blockchain data endpoints
│   ├── robot/             # AI agent endpoints
│   └── ipfs/              # IPFS upload handlers
├── contracts/             # Solidity smart contracts
├── scripts/               # Blockchain indexing scripts
├── src/
│   ├── haven-reskin/      # Main application UI
│   ├── contracts/         # Contract ABIs
│   └── lib/               # Utility libraries
└── public/                # Static assets

Getting Started

Prerequisites

• Node.js 18+ and npm
• A BSC RPC endpoint (Alchemy, Binance, etc.)
• Supabase account for database
• WalletConnect Project ID

Installation

1. Clone the repository:

git clone https://github.com/nightcode112/HavenScience.git
cd HavenScience

2. Install dependencies:

npm install

3. Copy .env.example to .env and fill in your configuration:

cp .env.example .env

4. Configure environment variables in .env:

VITE_BSC_RPC_URL=your_bsc_rpc_url
VITE_FACTORY_ADDRESS=0x3DeF438082Abd8dbCf03bf58a8Ad1510eaFa4629
VITE_XTOKEN_ADDRESS=0x3c06AF089F1188c8357b29bDf9f98B36E51f7690
VITE_ROUTER_V2_ADDRESS=0x10ED43C718714eb63d5aA57B78B54704E256024E
VITE_WALLETCONNECT_PROJECT_ID=your_project_id
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_KEY=your_supabase_anon_key

5. Run the development server:

npm run dev

6. (Optional) Run the blockchain indexer:

cd scripts
npm install
node realtime-indexer.js

Smart Contract Development

Compile Contracts

npx hardhat compile

Deploy Router Contract

node contracts/deploy-router.js

Verify on BSCScan

npx hardhat verify --network bsc <CONTRACT_ADDRESS> <CONSTRUCTOR_ARGS>

Architecture

Bonding Curve Mechanism

• Initial Phase: Tokens are bought/sold through a bonding curve
• Graduation: When reaching 17,000 BNB/HAVEN, liquidity migrates to PancakeSwap
• Fee Structure: Creator fees + protocol fees on each trade

Real-time Indexing

The indexer monitors:

• Token creation events
• Buy/sell transactions
• Graduation events
• Creator fee collections

Data is stored in Supabase for fast queries and real-time updates.

Security

• Contracts use OpenZeppelin libraries for standard implementations
• Reentrancy guards on all state-changing functions
• Timelocks on critical contract upgrades
• Audited bonding curve mathematics

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

License

This project is private and proprietary.

Links

• Website: haven.science
• Documentation: docs.haven.science
• Twitter: @HavenLabs_
• Telegram: t.me/haven_labs
• Discord: discord.gg/3bMDdEqf
• Linktree: linktr.ee/HavenLabs

Support

For questions and support, please join our Telegram community or Discord server.