Mock & Dependency Contracts

Mock dependency contracts on the BattleChain testnet and Safe infrastructure on both networks

BattleChain testnet includes mock versions of common mainnet dependencies and real infrastructure contracts so you can deploy your exact production bytecode — only swapping constructor parameters like oracle addresses.

The mock contracts on this page (tokens, price feeds, and protocol mocks) are deployed on testnet only — they are not deployed on BattleChain mainnet. The real (non-mock) contracts at the bottom are genuine deployments, not mocks: Safe on both networks, and Multicall3 on mainnet.

Mock Chainlink Price Feeds

These MockV3Aggregator contracts implement the same interface as Chainlink price feeds. Contracts that consume latestRoundData() or getRoundData() on mainnet can point at these addresses on testnet without code changes.

All feeds use 8 decimals, matching Chainlink's standard for USD pairs.

Deployed Addresses

Interface

Updating Prices

To set ETH/USD to $2,000:

cast send 0xAA72F0168eE17aA93098eC6ECf2EEe72B46aca19 \
  "updateAnswer(int256)" 200000000000 \
  --rpc-url $BATTLECHAIN_RPC_URL \
  --keystore $KEYSTORE

The value 200000000000 is 2000 * 1e8 (8 decimals).

Test Tokens

Mintable ERC-20 tokens for protocols that need token dependencies (stablecoins, WBTC, LINK, etc.). Anyone can mint — no faucet required.

Deployed Addresses

Interface

Minting Tokens

To mint 1,000,000 USDC to yourself:

cast send 0xb9bEab76Db81BdF8c863f2cA648dA8d3bB5CB1EE \
  "mint()" \
  --rpc-url $BATTLECHAIN_RPC_URL \
  --keystore $KEYSTORE

To mint a specific amount to any address:

cast send 0xb9bEab76Db81BdF8c863f2cA648dA8d3bB5CB1EE \
  "mint(address,uint256)" 0xYOUR_ADDRESS 5000000000 \
  --rpc-url $BATTLECHAIN_RPC_URL \
  --keystore $KEYSTORE

The value 5000000000 is 5000 * 1e6 (USDC has 6 decimals).

Mock Venus Protocol

A mock Venus lending protocol deployment with a Comptroller and six vToken markets. Implements the same Compound-style interface (supply, borrow, redeem, repay) so contracts that integrate with Venus on mainnet work on testnet without code changes.

All markets are listed with a 0.75 collateral factor. The mock Comptroller always reports accounts as healthy with 1M liquidity — it does not enforce real collateral checks.

Deployed Addresses

The vToken markets use the test tokens as their underlying assets. vBNB uses native ETH.

Interface

Supplying and Borrowing

To supply 1,000 USDC to vUSDC (approve first, then mint):

cast send 0xb9bEab76Db81BdF8c863f2cA648dA8d3bB5CB1EE \
  "approve(address,uint256)" \
  0x91442C344c069e9B62f068C6F7075E9B403840E0 1000000000 \
  --rpc-url $BATTLECHAIN_RPC_URL \
  --keystore $KEYSTORE

cast send 0x91442C344c069e9B62f068C6F7075E9B403840E0 \
  "mint(uint256)" 1000000000 \
  --rpc-url $BATTLECHAIN_RPC_URL \
  --keystore $KEYSTORE

To supply native ETH to vBNB:

cast send 0x11e4B3Bbe7Fc26514b8D13383a3FB30E3Ced1F62 \
  "mint()" \
  --value 1ether \
  --rpc-url $BATTLECHAIN_RPC_URL \
  --keystore $KEYSTORE

Mock Uniswap V3

A mock Uniswap V3 deployment with the core factory, swap router, and position manager. Contracts that integrate with Uniswap V3 on mainnet can point at these addresses on testnet without code changes.

Deployed Addresses

Use with the test tokens above (WETH, USDC, DAI, etc.) to create pools and test swap logic.

Mock KyberSwap Router

A mock KyberSwap aggregator router with admin-configurable exchange rates. Implements the same swap and swapSimpleMode interface so contracts that integrate with KyberSwap on mainnet work on testnet without code changes.

Simplifications:

• No actual DEX aggregation or routing
• Exchange rates are admin-set, not market-driven
• No multi-hop routing (single pair swaps only)

Deployed Addresses

Interface

Mock Euler V2

A mock Euler V2 deployment with the Ethereum Vault Connector (EVC) and two lending vaults.

Deployed Addresses

The vaults use the test tokens as their underlying assets (USDC and WETH respectively).

Mock Morpho Blue

A mock Morpho Blue lending protocol deployment. Implements the core supply, borrow, collateral, and liquidation interface so contracts that integrate with Morpho on mainnet work on testnet without code changes.

Simplifications:

• No interest accrual (rates always zero)
• No oracle price validation (liquidation is admin-gated)
• 1:1 share-to-asset ratio (no share price divergence)

Deployed Addresses

Markets

Three markets are pre-configured with an 80% liquidation LTV. Markets are identified by their Id (keccak256 of the market parameters).

Market names are formatted as loanToken/collateralToken — e.g., USDC/WETH means borrow USDC against WETH collateral. All markets use the test tokens.

Interface

Supplying and Borrowing

To supply 1,000 USDC to the USDC/WETH market (approve first, then supply):

cast send 0xb9bEab76Db81BdF8c863f2cA648dA8d3bB5CB1EE \
  "approve(address,uint256)" \
  0x102CdAF4B7097752f2Bb336c6cDf39f0aBBbb58c 1000000000 \
  --rpc-url $BATTLECHAIN_RPC_URL \
  --keystore $KEYSTORE

cast send 0x102CdAF4B7097752f2Bb336c6cDf39f0aBBbb58c \
  "supply((address,address,address,address,uint256),uint256,uint256,address,bytes)" \
  "(0xb9bEab76Db81BdF8c863f2cA648dA8d3bB5CB1EE,0x4CAc28Fc96bb8fa0e6F94ef0E579384902142f42,0x0000000000000000000000000000000000000001,0x0000000000000000000000000000000000000002,800000000000000000)" \
  1000000000 0 $YOUR_ADDRESS 0x \
  --rpc-url $BATTLECHAIN_RPC_URL \
  --keystore $KEYSTORE

The value 1000000000 is 1000 * 1e6 (USDC has 6 decimals).

Mock Chainlink CCIP

A mock Chainlink CCIP router for testing cross-chain messaging and token transfers.

Deployed Addresses

Safe (Gnosis Safe)

The full Safe smart account infrastructure is deployed on both BattleChain testnet and mainnet. Unlike the mock dependencies above, these are real Safe contracts (not mocks) — protocols that use Safe multisigs for governance, treasury, or access control can use the same deployment patterns as on other chains. The contracts were deployed by Cyfrin, so the addresses differ between the two networks and from Safe's canonical addresses on other chains.

Deployed Addresses (Testnet)

Deployed Addresses (Mainnet)

Multicall3

Multicall3 batches many contract reads into a single eth_call, and can aggregate multiple state-changing calls into one transaction. It lives at the same canonical address — 0xcA11bde05977b3631167028862bE2a173976CA11 — on 250+ chains, so libraries like viem, wagmi, ethers, and Foundry detect and use it automatically.

Unlike the mocks above, this is the real Multicall3, deployed on BattleChain mainnet only at that canonical address. It is intentionally not on testnet: deploying it there exceeds the canonical pre-signed transaction's 1,000,000 gas limit, so the standard address can't be reproduced.

Deployed Address (Mainnet)

Because it sits at the canonical address, most tooling needs no configuration — point your client at BattleChain mainnet and Multicall3 batching works out of the box.

Interface

aggregate3 is the usual entry point. The complete ABI — aggregate, tryAggregate, aggregate3Value, and the block/balance helpers — is the standard Multicall3 ABI, available from multicall3.com.