Developer Documnets

Developer Resources

Build on LiquifyDAO: Contracts, APIs, and Integration Guides

1. Smart Contracts

Core Contract Addresses (BNB Chain Testnet)

Contract	Address	Description
LiquifyVault	0x7a3...1b2	Stake BNB → mint liqBNB
liqBNB	0xe5f...4c7	Liquid staking token (ERC-20)
LiquifyBridge	0x9d2...8a1	Cross-chain transfers (LayerZero)
YieldAggregator	0x3b0...6f9	Auto-compounding vault strategies

Verified on:

• BNB Chain Testnet Explorer

• Tenderly Dashboard (for debugging)

---

2. JavaScript SDK

Installation

npm install @liquifydao/sdk  # or yarn add @liquifydao/sdk

Key Functions

import { Liquify, Networks } from '@liquifydao/sdk';

// Initialize
const liquify = new Liquify({
  network: Networks.BNB_TESTNET,  // Or Networks.ETH_MAINNET
  rpcUrl: 'https://data-seed-prebsc-1-s1.binance.org:8545/', // Custom RPC
});

// Stake BNB → mint liqBNB
const stakeTx = await liquify.vault.stake({
  amount: '1.5', // BNB amount
  walletAddress: '0x...', 
});

// Bridge liqBNB to Ethereum
const bridgeTx = await liquify.bridge.send({
  token: 'liqBNB',
  amount: '1.0',
  destinationChain: Networks.ETH_MAINNET,
});

// Fetch user positions
const positions = await liquify.getUserPositions('0x...');
console.log(positions.liqBNB); // { staked: '1.5', rewards: '0.02' }

---

3. API Endpoints

Public API (REST)

Base URL: https://api.liquifydao.com/v1

Endpoint	Method	Description
/apr	GET	Current APRs for all vaults
/pools/{chainId}	GET	Active liquidity pools per chain
/bridge/limits	GET	Minimum/maximum bridge amounts

Example Request:

curl https://api.liquifydao.com/v1/apr

Response:

{
  "liqBNB": { "stakingApr": 5.2, "restakingApr": 3.8 },
  "liqETH": { "stakingApr": 4.1, "restakingApr": 2.9 }
}

---

4. Subgraph (The Graph)

Access indexed on-chain data for frontends:

• Subgraph URL: https://api.thegraph.com/subgraphs/name/liquifydao/core

• Sample Query:

{
  userPositions(where: { id: "0x..." }) {
    liqBNBBalance
    totalRewards
    lastUpdated
  }
}

---

5. Chainlink Oracles

Fetch real-time liToken prices:

• BNB Chain: 0x3c...2d (liqBNB/BNB price feed)

• Ethereum: 0x7e...1f (liqETH/ETH price feed)

Integration Example:

import "@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol";

AggregatorV3Interface priceFeed = AggregatorV3Interface(0x3c...2d);
(, int price,,,) = priceFeed.latestRoundData();

---

6. Local Development

Forking BNB Chain for Testing

1. Use Anvil (Foundry) to fork BNB Chain:

anvil --fork-url https://bsc-testnet.publicnode.com

1. Deploy test contracts:

forge script script/DeployTest.s.sol --fork-url http://localhost:8545 --broadcast

Hardhat Config Snippet

module.exports = {
  networks: {
    bnb_testnet: {
      url: "https://data-seed-prebsc-1-s1.binance.org:8545/",
      accounts: [process.env.PRIVATE_KEY],
    },
  },
};

---

7. Security & Audits

• Audit Reports: [Link to CertiK/SlowMist PDFs]

• Bug Bounty: Report vulnerabilities via Immunefi (up to $50,000 rewards).

---

8. Sample Integrations

A. Adding liqBNB to a DEX Pool

// PancakeSwap Pool Example
IPancakeRouter(0x10ED43C718714eb63d5aA57B78B54704E256024E).addLiquidity(
  address(liqBNB),
  address(USDT),
  1_000_000, // liqBNB amount
  1_000_000, // USDT amount
  0, // Slippage tolerance
  0,
  msg.sender,
  block.timestamp + 300
);

B. Using liqBNB as Collateral

// Venus Protocol
VBep20Interface vLiqBNB = VBep20Interface(0x...);
vLiqBNB.mint(1 ether); // Mint vTokens with liqBNB