HedgeCoreHedgeCore
Docs
Github
Smart Contracts

HedgeCore protocol smart contract repository

Smart Contracts

The HedgeCore smart contracts are open-source and available for review, audit, and contribution.

Repository

🔗 GitHub: github.com/xia-zhang-web3/hedgecore

Contract Architecture

Core Contracts

  • SUDC: sUSD token implementation with soul-bound logic
  • StrategyRouter: Yield strategy routing and management
  • HUSDCWrapper: hUSDC wrapper for liquidity layer
  • HUSDC: ERC20 token with lock-aware transfers

Technology Stack

  • Solidity: ^0.8.28
  • Framework: Hardhat
  • Testing: Hardhat + Chai
  • Network: Binance Smart Chain (BSC)
  • Standards: ERC20, ERC-4626, EIP-2612

Repository Structure

contracts/
├── SUDC.sol                  # sUSD token
├── StrategyRouter.sol        # Yield routing
├── HUSDCWrapper.sol          # Wrapper contract
├── HUSDC.sol                 # hUSDC token
└── interfaces/
    └── IHUSDCWrapper.sol     # Wrapper interface

test/
├── SUDC.test.js
├── StrategyRouter.test.js
└── Wrapper.test.js

scripts/
├── deploy.js
└── verify.js

Development Setup

Prerequisites

  • Node.js 18+
  • npm or yarn
  • MetaMask or similar wallet

Installation

git clone https://github.com/xia-zhang-web3/hedgecore.git
cd hedgecore
npm install

Compile Contracts

npx hardhat compile

Run Tests

npx hardhat test

Deploy to BSC Testnet

npx hardhat run scripts/deploy.js --network bscTestnet

Contract Addresses

BSC Mainnet

  • SUDC (sUSD Token): TBA
  • StrategyRouter: TBA
  • HUSDCWrapper: TBA
  • HUSDC (hUSDC Token): TBA

BSC Testnet

  • SUDC (sUSD Token): TBA
  • StrategyRouter: TBA
  • HUSDCWrapper: TBA
  • HUSDC (hUSDC Token): TBA

Security

Audits

  • Status: Pending
  • Firms: TBA

Bug Bounty

We encourage responsible disclosure of security vulnerabilities:

  • Contact: security@hedgecore.io
  • Rewards: Based on severity

Best Practices

  • All contracts use OpenZeppelin libraries
  • Comprehensive test coverage
  • Reentrancy guards on external calls
  • Time-locked upgrades
  • Multisig ownership

Contributing

We welcome contributions from the community:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests
  5. Submit a pull request

Please read our contribution guidelines before submitting.

License

MIT License - see LICENSE file for details

Next