BETA — mainnet live (chain 482120); features are still being finished. Transparency →
Bitcoin Swap BETA Chain 482120
Developers · Reference

Contract reference

Functions, events and errors of the public contracts — generated from contracts.json.

Reference › Contract reference

This page is generated automatically from /developers/contracts.json — it covers only the public interface integrators need. Full source code (including the Owner's admin functions) is verified on the explorer; admin permissions are summarized in Trust model. Revert codes: Limits & error codes.

Compiler: Solidity 0.8.28, optimizer 200 runs (482120-side contracts). Bridge routers: @hyperlane-xyz/core 12.1.0.

USDC (Bitcoin Swap)

Address 0x3b5BD179CA6Aab4DAF0f842829776843ABe6e727 · chain 482120 · 18 decimals

USDC (Bitcoin Swap): name() and symbol() return "USDC" since 6 Oct 2026 (formerly USDw; same address, decimals and balances). Redeems 1:1 for USDC.e at StableReserve.

USDC (Bitcoin Swap) — functions

function name() view returns (string)
function symbol() view returns (string)
function decimals() view returns (uint8)
function totalSupply() view returns (uint256)
function balanceOf(address) view returns (uint256)
function allowance(address,address) view returns (uint256)
function approve(address spender, uint256 amount) returns (bool)
function transfer(address to, uint256 amount) returns (bool)

USDC (Bitcoin Swap) — events

event Transfer(address indexed from, address indexed to, uint256 value)

OracleAMM

Address 0xd953d53414a81eb6AC5a4edE73d13992181aF51E · chain 482120

BTCw <-> USDC (Bitcoin Swap) at the oracle price +/- spreadBps (30 = 0.3%). maxTradeBtcw per order; stops when the oracle is older than maxAgeSec.

OracleAMM — functions

function quoteSellBtcw(uint256 btcwIn) view returns (uint256 usdOut)
function quoteBuyBtcw(uint256 usdIn) view returns (uint256 btcwOut)
function sellBtcw(uint256 minUsdOut) payable returns (uint256 usdOut)
function buyBtcw(uint256 usdIn, uint256 minBtcwOut) returns (uint256 btcwOut)
function midPrice() view returns (uint256 priceWad, uint256 updatedAt)
function spreadBps() view returns (uint256)
function maxTradeBtcw() view returns (uint256)
function btcwReserve() view returns (uint256)
function usdReserve() view returns (uint256)
function paused() view returns (bool)

OracleAMM — events

event Swap(address indexed trader, bool btcwIn, uint256 amountIn, uint256 amountOut, uint256 priceWad)

OracleTokenAMM_ETHw

Address 0xFd6d78A3b60175D37146793396A2FA7864039D54 · chain 482120

ETHw <-> USDC (Bitcoin Swap) at the PriceHub price of ETHw +/- spreadBps (30 = 0.3%). maxTradeToken 300 ETHw per order; stops when the price is older than maxAgeSec (300). buyToken/sellToken can pay another recipient. Bridge destination for ETHw (deposit USDC/USD₮0 -> USDC (Bitcoin Swap) -> ETHw).

OracleTokenAMM_ETHw — functions

function quoteBuyToken(uint256 usdIn) view returns (uint256 tokenOut)
function quoteSellToken(uint256 tokenIn) view returns (uint256 usdOut)
function buyToken(uint256 usdIn, uint256 minTokenOut, address to) returns (uint256 tokenOut)
function sellToken(uint256 tokenIn, uint256 minUsdOut, address to) returns (uint256 usdOut)
function midPrice() view returns (uint256 priceWad, uint256 updatedAt)
function token() view returns (address)
function usd() view returns (address)
function hub() view returns (address)
function tokenReserve() view returns (uint256)
function usdReserve() view returns (uint256)
function spreadBps() view returns (uint256)
function maxAgeSec() view returns (uint256)
function maxTradeToken() view returns (uint256)
function paused() view returns (bool)

OracleTokenAMM_ETHw — events

event Swap(address indexed trader, address indexed to, bool tokenIn, uint256 amountIn, uint256 amountOut, uint256 priceWad)

OracleTokenAMM_ETHw — errors

error ContractPaused()
error ZeroAmount()
error ZeroAddress()
error StalePrice(uint256 updatedAt)
error InvalidOraclePrice()
error ExceedsMaxTrade(uint256 cap, uint256 amount)
error InsufficientLiquidity(uint256 available, uint256 required)
error SlippageExceeded(uint256 amountOut, uint256 minAmountOut)

SwapRouter

Address 0x397E607eA05eF7909f84540077F3a716778031E4 · chain 482120

Ownerless router: chains up to MAX_HOPS (4) hops across venue 0 ClpPools, venue 1 OracleAMM (BTCw <-> USDC (Bitcoin Swap)), venue 2 token AMMs (ETHw kho) in one transaction. BTCw in: send msg.value = amountIn; token in: approve the router (it only pulls from msg.sender). quote() does not check caps, reserves or pause.

SwapRouter — functions

function swap(address tokenIn, uint256 amountIn, (uint8 venue, address tokenOut)[] hops, uint256 minOut, address to, uint256 deadline) payable returns (uint256 amountOut)
function quote(address tokenIn, uint256 amountIn, (uint8 venue, address tokenOut)[] hops) view returns (uint256 amountOut)
function tokenAmmCount() view returns (uint256)
function tokenAmmAt(uint256 index) view returns (address amm, address token)
function clp() view returns (address)
function oracleAmm() view returns (address)
function usdw() view returns (address)
function NATIVE() view returns (address)
function MAX_HOPS() view returns (uint256)

SwapRouter — events

event Routed(address indexed sender, address indexed tokenIn, address indexed tokenOut, uint256 amountIn, uint256 amountOut, address to, uint256 hops)

SwapRouter — errors

error Expired(uint256 deadline)
error InvalidRecipient()
error InvalidPath()
error UnknownVenue(uint8 venue)
error UnsupportedHop(uint8 venue, address tokenIn, address tokenOut)
error ValueMismatch(uint256 sent, uint256 expected)
error SlippageExceeded(uint256 amountOut, uint256 minAmountOut)
error ZeroAmount()
error ZeroAddress()
error UnexpectedSender()
error NativeTransferFailed()

ClpPools

Address 0x557aDc3d900c471F3907cdDA3a9F5377d6F9E7e0 · chain 482120

346 continuous-liquidity pools (USDC (Bitcoin Swap), 100 crypto trackers, 202 US stock, 20 US ETF, 2 pre-IPO and 21 metal / index / commodity / FX trackers), every pool paired with native BTCw (THORChain-style CLP). Fee floor minFeeBps (5).

ClpPools — functions

function swapBtcwForAsset(address token, uint256 minOut, address to) payable returns (uint256)
function swapAssetForBtcw(address token, uint256 amountIn, uint256 minOut, address to) returns (uint256)
function swapAssetForAsset(address tokenIn, address tokenOut, uint256 amountIn, uint256 minOut, address to) returns (uint256)
function quoteBtcwForAsset(address token, uint256 btcwIn) view returns (uint256 out, uint256 fee)
function quoteAssetForBtcw(address token, uint256 amountIn) view returns (uint256 out, uint256 fee)
function priceInBtcw(address token) view returns (uint256)
function poolCount() view returns (uint256)
function poolTokenAt(uint256 index) view returns (address)
function pools(address token) view returns (uint256 btcwDepth, uint256 assetDepth, uint256 totalUnits, bool exists, bool enabled)
function minFeeBps() view returns (uint256)
function paused() view returns (bool)

ClpPools — events

event Swap(address indexed trader, address indexed token, bool btcwIn, uint256 amountIn, uint256 amountOut, uint256 fee, address to)

UsdClpPools

Address 0x78aCB6Ec7aF4cc83BF9E698706de79c08D61C13f · chain 482120

R-61: a second, parallel set of 345 continuous-liquidity pools, every pool paired with USDC (Bitcoin Swap) (ERC-20, approve first; no msg.value). Same tokens as ClpPools, separate contract and liquidity; tell the two apart by contract address, not by token. Fee floor minFeeBps (5). removeLiquidity works even while paused.

UsdClpPools — functions

function usd() view returns (address)
function swapUsdForAsset(address token, uint256 amountIn, uint256 minOut, address to) returns (uint256)
function swapAssetForUsd(address token, uint256 amountIn, uint256 minOut, address to) returns (uint256)
function swapAssetForAsset(address tokenIn, address tokenOut, uint256 amountIn, uint256 minOut, address to) returns (uint256)
function quoteUsdForAsset(address token, uint256 usdIn) view returns (uint256 out, uint256 fee)
function quoteAssetForUsd(address token, uint256 amountIn) view returns (uint256 out, uint256 fee)
function quoteAssetForAsset(address tokenIn, address tokenOut, uint256 amountIn) view returns (uint256 out)
function priceInUsd(address token) view returns (uint256)
function addLiquidity(address token, uint256 usdAmount, uint256 assetAmount) returns (uint256 units)
function removeLiquidity(address token, uint256 units, uint256 minUsd, uint256 minAsset) returns (uint256 usdOut, uint256 assetOut)
function unitsOf(address token, address provider) view returns (uint256)
function poolCount() view returns (uint256)
function poolTokenAt(uint256 index) view returns (address)
function poolDepths(address[] tokens) view returns (uint256[] usdDepths, uint256[] asset)
function pools(address token) view returns (uint256 usdDepth, uint256 assetDepth, uint256 totalUnits, bool exists, bool enabled)
function minFeeBps() view returns (uint256)
function paused() view returns (bool)

UsdClpPools — events

event Swap(address indexed trader, address indexed token, bool usdIn, uint256 amountIn, uint256 amountOut, uint256 fee, address to)
event LiquidityAdded(address indexed token, address indexed provider, uint256 usdAmount, uint256 asset, uint256 units)
event LiquidityRemoved(address indexed token, address indexed provider, uint256 usdAmount, uint256 asset, uint256 units)

UsdRebalancer

Address 0xF9DAD09811755b8cf4863ed880AdD6F92358623D · chain 482120

R-61: keeps the UsdClpPools pools near the PriceHub USD price by trading from its own inventory (it mints nothing). Acts when a pool deviates by more than thresholdBps (30), closing stepPct (90%) of the gap, at most maxTradeUsd (43,000,000 USDC (Bitcoin Swap)) per trade; skips prices older than maxAgeSec (300 s). Only keepers can call it. Its volume is counted as treasury volume.

UsdRebalancer — functions

function pools() view returns (address)
function hub() view returns (address)
function usd() view returns (address)
function thresholdBps() view returns (uint256)
function stepPct() view returns (uint256)
function maxTradeUsd() view returns (uint256)
function maxAgeSec() view returns (uint256)
function paused() view returns (bool)

UsdRebalancer — events

event Rebalanced(address indexed token, bool sold, uint256 amountIn, uint256 amountOut, int256 devBps)

BtcwPriceFeed

Address 0x6E0687A5D5a5b98CC5fb05c4d8d742fBD75ba96c · chain 482120 · 8 decimals

BTC/USD, Chainlink AggregatorV3Interface. Internal oracle (median of external sources).

BtcwPriceFeed — functions

function latestRoundData() view returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)
function latestAnswer() view returns (int256)
function decimals() view returns (uint8)

PriceHub

Address 0xE87FDdCC0b668564a20B23F3bE1EE108C805ecb4 · chain 482120 · 18 decimals

USD reference price of the 345 tracker tokens: 100 crypto, 202 US stocks, 20 US ETFs, 2 pre-IPO trackers, 21 metal / index / commodity / FX trackers (internal oracle).

PriceHub — functions

function latestRoundData(address asset) view returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)
function prices(address[] assets) view returns (int256[] answers, uint256[] updatedAts)
function decimals() view returns (uint8)

WBTCw

Address 0xA7182E25e635108AD401E3be78f1c2A4593B8831 · chain 482120 · 18 decimals

Wrapped BTCw (ERC-20, WETH9-style). Minted only when the BTCw vault 0x10Ecc6EF494D0Ec1A1446a30026951b0923F3606 releases native BTCw against WBTC locked on Arbitrum One (deposit() reverts for every other sender); withdraw(wad) unwraps 1:1 to native BTCw at any time. No owner, no pause, no fees. Supply <= WBTC locked in 0x9A37C4a711b23Ae3508E0Dbd8d994ae98c92A86A (Arbitrum). Deployed by the Owner wallet 0xB17b...d952 on 3 Oct 2026 (R-54).

WBTCw — functions

function acceptBeneficiary()
function allowance(address owner, address spender) view returns (uint256)
function approve(address spender, uint256 amount) returns (bool)
function balanceOf(address account) view returns (uint256)
function beneficiary() view returns (address)
function decimals() view returns (uint8)
function decreaseAllowance(address spender, uint256 subtractedValue) returns (bool)
function deposit() payable
function increaseAllowance(address spender, uint256 addedValue) returns (bool)
function name() view returns (string)
function pendingBeneficiary() view returns (address)
function proposeBeneficiary(address proposed)
function symbol() view returns (string)
function totalSupply() view returns (uint256)
function transfer(address to, uint256 amount) returns (bool)
function transferFrom(address from, address to, uint256 amount) returns (bool)
function vault() view returns (address)
function withdraw(uint256 wad)

WBTCw — events

event Approval(address indexed owner, address indexed spender, uint256 value)
event BeneficiaryChanged(address indexed previous, address indexed current)
event BeneficiaryProposed(address indexed current, address indexed proposed)
event Deposit(address indexed dst, uint256 wad)
event Transfer(address indexed from, address indexed to, uint256 value)
event Withdrawal(address indexed src, uint256 wad)

WBTCw — errors

error NotBeneficiary(address sender)
error NotPendingBeneficiary(address sender)
error NotVault(address sender)
error TransferFailed()

USDCe

Address 0x7b56B7B06B8e586064787E7FfE466Ab6B78C31C7 · chain 482120 · 6 decimals

Bridged USDC (Bitcoin Swap), symbol USDC.e: Hyperlane synthetic token of the dedicated core (R-52). Minted 1:1 when USDC is locked in the Arbitrum router 0x1e458688336872Eb744Ccb588C7775480675b2A6, burned on withdrawal. Sealed: fixed ISM, counterpart enrolled once, no fees; allowlist on (Owner wallet only) at 3 Oct 2026. Deployed 3 Oct 2026.

USDCe — functions

function PACKAGE_VERSION() view returns (string)
function allowance(address owner, address spender) view returns (uint256)
function allowlistEnabled() view returns (bool)
function approve(address spender, uint256 amount) returns (bool)
function balanceOf(address account) view returns (uint256)
function configSealed() view returns (bool)
function decimals() view returns (uint8)
function decreaseAllowance(address spender, uint256 subtractedValue) returns (bool)
function destinationGas(uint32 destinationDomain) view returns (uint256 gasLimit)
function domains() view returns (uint32[])
function enrollRemoteRouter(uint32 _domain, bytes32 _router)
function enrollRemoteRouters(uint32[] _domains, bytes32[] _addresses)
function feeHook() view returns (address)
function feeRecipient() pure returns (address)
function feeToken() view returns (address)
function fixedIsm() view returns (address)
function handle(uint32 _origin, bytes32 _sender, bytes _message) payable
function hook() view returns (address)
function increaseAllowance(address spender, uint256 addedValue) returns (bool)
function initialize(uint256 _totalSupply, string _name, string _symbol, address _hook, address _interchainSecurityModule, address _owner)
function interchainSecurityModule() view returns (address)
function isAllowed(address) view returns (bool)
function localDomain() view returns (uint32)
function mailbox() view returns (address)
function name() view returns (string)
function owner() view returns (address)
function paused() view returns (bool)
function quoteGasPayment(uint32 _destinationDomain) view returns (uint256)
function quoteTransferRemote(uint32 _destination, bytes32 _recipient, uint256 _amount) view returns ((address token, uint256 amount)[] quotes)
function renounceOwnership()
function routers(uint32 _domain) view returns (bytes32)
function scaleDenominator() view returns (uint256)
function scaleNumerator() view returns (uint256)
function setAllowed(address[] accounts, bool allowed_)
function setAllowlistEnabled(bool enabled)
function setDestinationGas(uint32 domain, uint256 gas)
function setDestinationGas((uint32 domain, uint256 gas)[] gasConfigs)
function setFeeHook(address _feeHook)
function setFeeRecipient(address recipient)
function setHook(address hook_)
function setInterchainSecurityModule(address _module)
function setPaused(bool paused_)
function symbol() view returns (string)
function token() view returns (address)
function totalSupply() view returns (uint256)
function transfer(address to, uint256 amount) returns (bool)
function transferFrom(address from, address to, uint256 amount) returns (bool)
function transferOwnership(address newOwner)
function transferRemote(uint32 _destination, bytes32 _recipient, uint256 _amount) payable returns (bytes32 messageId)
function unenrollRemoteRouter(uint32) pure
function unenrollRemoteRouters(uint32[]) pure

USDCe — events

event AllowedSet(address indexed account, bool allowed)
event AllowlistEnabledSet(bool enabled)
event Approval(address indexed owner, address indexed spender, uint256 value)
event FeeHookSet(address feeHook)
event FeeRecipientSet(address feeRecipient)
event GasSet(uint32 domain, uint256 gas)
event HookSet(address _hook)
event Initialized(uint8 version)
event IsmSet(address _ism)
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner)
event PausedSet(bool paused)
event ReceivedTransferRemote(uint32 indexed origin, bytes32 indexed recipient, uint256 amountOrId)
event SentTransferRemote(uint32 indexed destination, bytes32 indexed recipient, uint256 amountOrId)
event Transfer(address indexed from, address indexed to, uint256 value)

USDCe — errors

error FeeHookDisabled()
error HookLocked()
error NotAllowed(address account)
error Paused()
error RoutingLocked()

UniswapV2Factory

Address 0x453F946CB371a2039137453BAafFb83FF4ccf9f7 · chain 482120

Official Uniswap V2 factory bytecode (@uniswap/v2-core 1.0.1), feeToSetter = Owner wallet, feeTo unset. Pair init code hash 0x96e8ac4277198ff8b6f785478aa9a39f403cb768dd02cbee326c3e7da348845f. Deployed 3 Oct 2026 (R-54).

UniswapV2Factory — functions

function allPairs(uint256) view returns (address)
function allPairsLength() view returns (uint256)
function createPair(address tokenA, address tokenB) returns (address pair)
function feeTo() view returns (address)
function feeToSetter() view returns (address)
function getPair(address, address) view returns (address)
function setFeeTo(address _feeTo)
function setFeeToSetter(address _feeToSetter)

UniswapV2Factory — events

event PairCreated(address indexed token0, address indexed token1, address pair, uint256)

UniswapV2Router02

Address 0x436997135b9332B2dFa1B20e6B24f0987778a246 · chain 482120

Official Uniswap V2 Router02 bytecode (@uniswap/v2-periphery 1.1.0-beta.0). WETH() = WBTCw, so the *ETH functions wrap/unwrap WBTCw <-> native BTCw (wrapping needs the vault, so swapExactETHForTokens reverts; swapExactTokensForETH unwraps and works). Deployed 3 Oct 2026 (R-54).

UniswapV2Router02 — functions

function WETH() view returns (address)
function addLiquidity(address tokenA, address tokenB, uint256 amountADesired, uint256 amountBDesired, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline) returns (uint256 amountA, uint256 amountB, uint256 liquidity)
function addLiquidityETH(address token, uint256 amountTokenDesired, uint256 amountTokenMin, uint256 amountETHMin, address to, uint256 deadline) payable returns (uint256 amountToken, uint256 amountETH, uint256 liquidity)
function factory() view returns (address)
function getAmountIn(uint256 amountOut, uint256 reserveIn, uint256 reserveOut) pure returns (uint256 amountIn)
function getAmountOut(uint256 amountIn, uint256 reserveIn, uint256 reserveOut) pure returns (uint256 amountOut)
function getAmountsIn(uint256 amountOut, address[] path) view returns (uint256[] amounts)
function getAmountsOut(uint256 amountIn, address[] path) view returns (uint256[] amounts)
function quote(uint256 amountA, uint256 reserveA, uint256 reserveB) pure returns (uint256 amountB)
function removeLiquidity(address tokenA, address tokenB, uint256 liquidity, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline) returns (uint256 amountA, uint256 amountB)
function removeLiquidityETH(address token, uint256 liquidity, uint256 amountTokenMin, uint256 amountETHMin, address to, uint256 deadline) returns (uint256 amountToken, uint256 amountETH)
function removeLiquidityETHSupportingFeeOnTransferTokens(address token, uint256 liquidity, uint256 amountTokenMin, uint256 amountETHMin, address to, uint256 deadline) returns (uint256 amountETH)
function removeLiquidityETHWithPermit(address token, uint256 liquidity, uint256 amountTokenMin, uint256 amountETHMin, address to, uint256 deadline, bool approveMax, uint8 v, bytes32 r, bytes32 s) returns (uint256 amountToken, uint256 amountETH)
function removeLiquidityETHWithPermitSupportingFeeOnTransferTokens(address token, uint256 liquidity, uint256 amountTokenMin, uint256 amountETHMin, address to, uint256 deadline, bool approveMax, uint8 v, bytes32 r, bytes32 s) returns (uint256 amountETH)
function removeLiquidityWithPermit(address tokenA, address tokenB, uint256 liquidity, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline, bool approveMax, uint8 v, bytes32 r, bytes32 s) returns (uint256 amountA, uint256 amountB)
function swapETHForExactTokens(uint256 amountOut, address[] path, address to, uint256 deadline) payable returns (uint256[] amounts)
function swapExactETHForTokens(uint256 amountOutMin, address[] path, address to, uint256 deadline) payable returns (uint256[] amounts)
function swapExactETHForTokensSupportingFeeOnTransferTokens(uint256 amountOutMin, address[] path, address to, uint256 deadline) payable
function swapExactTokensForETH(uint256 amountIn, uint256 amountOutMin, address[] path, address to, uint256 deadline) returns (uint256[] amounts)
function swapExactTokensForETHSupportingFeeOnTransferTokens(uint256 amountIn, uint256 amountOutMin, address[] path, address to, uint256 deadline)
function swapExactTokensForTokens(uint256 amountIn, uint256 amountOutMin, address[] path, address to, uint256 deadline) returns (uint256[] amounts)
function swapExactTokensForTokensSupportingFeeOnTransferTokens(uint256 amountIn, uint256 amountOutMin, address[] path, address to, uint256 deadline)
function swapTokensForExactETH(uint256 amountOut, uint256 amountInMax, address[] path, address to, uint256 deadline) returns (uint256[] amounts)
function swapTokensForExactTokens(uint256 amountOut, uint256 amountInMax, address[] path, address to, uint256 deadline) returns (uint256[] amounts)

UniswapV2Pair_WBTCw_USDCe

Address 0xED2967B738d98B3e4D3e6780A08Dc161A55EF304 · chain 482120

WBTCw / USDC.e pair (token0 = USDC.e, token1 = WBTCw), 0.30% fee. Created 3 Oct 2026 at the Chainlink BTC/USD price; a peg keeper (0xe20dA14F7A9715Ba685048292e53C05c097E766D) swaps its own inventory when the pool drifts more than 0.5% from Chainlink. Price = reserveUSDCe * 1e20 / reserveWBTCw (USD per BTC, 8 decimals). LP tokens are held by the Owner wallet, unlocked. UI: https://app.btcw.tech/pool/

UniswapV2Pair_WBTCw_USDCe — functions

function DOMAIN_SEPARATOR() view returns (bytes32)
function MINIMUM_LIQUIDITY() view returns (uint256)
function PERMIT_TYPEHASH() view returns (bytes32)
function allowance(address, address) view returns (uint256)
function approve(address spender, uint256 value) returns (bool)
function balanceOf(address) view returns (uint256)
function burn(address to) returns (uint256 amount0, uint256 amount1)
function decimals() view returns (uint8)
function factory() view returns (address)
function getReserves() view returns (uint112 _reserve0, uint112 _reserve1, uint32 _blockTimestampLast)
function initialize(address _token0, address _token1)
function kLast() view returns (uint256)
function mint(address to) returns (uint256 liquidity)
function name() view returns (string)
function nonces(address) view returns (uint256)
function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s)
function price0CumulativeLast() view returns (uint256)
function price1CumulativeLast() view returns (uint256)
function skim(address to)
function swap(uint256 amount0Out, uint256 amount1Out, address to, bytes data)
function symbol() view returns (string)
function sync()
function token0() view returns (address)
function token1() view returns (address)
function totalSupply() view returns (uint256)
function transfer(address to, uint256 value) returns (bool)
function transferFrom(address from, address to, uint256 value) returns (bool)

UniswapV2Pair_WBTCw_USDCe — events

event Approval(address indexed owner, address indexed spender, uint256 value)
event Burn(address indexed sender, uint256 amount0, uint256 amount1, address indexed to)
event Mint(address indexed sender, uint256 amount0, uint256 amount1)
event Swap(address indexed sender, uint256 amount0In, uint256 amount1In, uint256 amount0Out, uint256 amount1Out, address indexed to)
event Sync(uint112 reserve0, uint112 reserve1)
event Transfer(address indexed from, address indexed to, uint256 value)

SimpleEarn

Address 0x353ffb50779e3A4d96CFaBA62810f0292fE41b7c · chain 482120

R-62 flexible Earn: deposit native BTCw, USDC (Bitcoin Swap) or ETHw and withdraw at any time. Rewards are paid in USDC (Bitcoin Swap) from a budget funded in advance by the treasury (the contract mints nothing); a keeper calls claimFor to push rewards to depositors. Rate per market: rewardRateWad. Owner 0xB17bdA8F14EEb9fd67B34810A2e1E82A737Ad952; API: /api/v2/earn.

SimpleEarn — functions

function assetCount() view returns (uint256)
function assetAt(uint256 i) view returns (address)
function markets(address) view returns (bool exists, bool enabled, uint256 principal, uint256 rewardReserve, uint256 rewardRateWad, uint256 periodFinish, uint256 lastUpdate, uint256 rewardPerTokenStored, uint256 undistributed)
function balanceOf(address, address) view returns (uint256)
function earned(address asset, address user) view returns (uint256)
function rewardRateWad(address asset) view returns (uint256)
function totalUsdReserve() view returns (uint256)
function paused() view returns (bool)
function usd() view returns (address)
function deposit(address asset, uint256 amount) payable
function withdraw(address asset, uint256 amount)
function claim(address asset)
function exit(address asset)

SimpleEarn — events

event Deposited(address indexed asset, address indexed user, uint256 amount)
event Withdrawn(address indexed asset, address indexed user, uint256 amount)
event RewardPaid(address indexed asset, address indexed user, uint256 usdAmount, address indexed by)

SimpleEarn — errors

error ContractPaused()
error MarketDisabled(address asset)
error UnknownMarket(address asset)
error InsufficientBalance(uint256 owned, uint256 requested)
error UseDepositFunction()

FixedEarn

Address 0x0a3fD8b35593fB4f82Da4C110C356745Dd7CDce2 · chain 482120

R-62 fixed-term Earn: deposit for one of the terms listed by termsOf (between MIN_TERM 1 day and MAX_TERM 4 years); principal and USDC (Bitcoin Swap) interest are returned at maturity (redeemMatured by a keeper, or redeem by the holder). Interest comes from rewardPool, funded in advance by the treasury. Rates come from aprBpsOf; a rate setter may change them within [minSetterAprBps, maxSetterAprBps] and not below assetFloorBps. Owner 0xB17bdA8F14EEb9fd67B34810A2e1E82A737Ad952.

FixedEarn — functions

function MIN_TERM() view returns (uint256)
function MAX_TERM() view returns (uint256)
function assetCount() view returns (uint256)
function assetAt(uint256 i) view returns (address)
function markets(address) view returns (bool exists, bool enabled, uint8 decimals, uint256 principal)
function termsOf(address asset) view returns (uint256[] terms, uint256[] aprs)
function aprBpsOf(address, uint256) view returns (uint256)
function assetFloorBps(address) view returns (uint256)
function previewInterest(address asset, uint256 amount, uint256 term) view returns (uint256)
function positionCount() view returns (uint256)
function positionsOf(address user) view returns (uint256[])
function position(uint256 id) view returns ((address owner, address asset, uint128 principal, uint128 interest, uint64 start, uint64 maturity, uint32 aprBps, bool closed, uint256 priceWad))
function rewardPool() view returns (uint256)
function escrowed() view returns (uint256)
function paused() view returns (bool)
function deposit(address asset, uint256 amount, uint256 term) payable returns (uint256 id)
function redeem(uint256 id) returns (uint256 interestPaid)

FixedEarn — events

event Deposited(uint256 indexed id, address indexed asset, address indexed user, uint256 principal, uint256 interestUsd, uint256 term, uint256 aprBps, uint256 maturity, uint256 priceWad)
event Redeemed(uint256 indexed id, address indexed asset, address indexed user, uint256 principal, uint256 interestUsdPaid, bool early, address by)

FixedEarn — errors

error ContractPaused()
error MarketDisabled(address asset)
error InvalidTerm(uint256 term)
error InsufficientRewardPool(uint256 available, uint256 required)
error NotPositionOwner(uint256 id)
error AmountTooLarge()

StakedBTCw

Address 0xa4794DB9f26f489db1a6d8Cf6FC2Ab3106B1027e · chain 482120 · 18 decimals

R-62 stBTCw: stake native BTCw and receive the ERC-20 receipt stBTCw 1:1. Rewards in USDC (Bitcoin Swap) stream from rewardReserve (funded in advance; nothing is minted). unstake starts a cooldown of cooldownSec (0 s at 04/10/2026), then claimUnstaked returns BTCw. Owner 0xB17bdA8F14EEb9fd67B34810A2e1E82A737Ad952.

StakedBTCw — functions

function name() view returns (string)
function symbol() view returns (string)
function decimals() view returns (uint8)
function totalSupply() view returns (uint256)
function balanceOf(address account) view returns (uint256)
function earned(address user) view returns (uint256)
function rewardRateWad() view returns (uint256)
function currentRewardRateWad() view returns (uint256)
function periodFinish() view returns (uint256)
function rewardReserve() view returns (uint256)
function cooldownSec() view returns (uint256)
function pendingOf(address) view returns (uint256 assets, uint64 releaseAt)
function paused() view returns (bool)
function stake() payable
function unstake(uint256 amount) returns (uint64 releaseAt)
function claimUnstaked() returns (uint256 amount)
function claim()

StakedBTCw — events

event Staked(address indexed user, uint256 amount)
event Unstaked(address indexed user, uint256 amount, uint64 releaseAt)
event UnstakeClaimed(address indexed user, uint256 amount)
event RewardPaid(address indexed user, uint256 usdAmount, address indexed by)

StakedBTCw — errors

error ContractPaused()

EarnPriceSource

Address 0xfC2A0eD1702150FcAC47Ade06D22e47A34009c9c · chain 482120

USD prices used by the Earn contracts to value deposits: BTCw from OracleAMM, trackers from PriceHub, USDC (Bitcoin Swap) = 1 (18 decimals). freshPriceUsd reverts with StalePrice when the price is older than maxAgeSec (3,600 s at 04/10/2026). Owner 0xB17bdA8F14EEb9fd67B34810A2e1E82A737Ad952.

EarnPriceSource — functions

function priceUsd(address asset) view returns (uint256 priceWad, uint256 updatedAt)
function freshPriceUsd(address asset) view returns (uint256 priceWad)
function maxAgeSec() view returns (uint256)
function amm() view returns (address)
function hub() view returns (address)
function usd() view returns (address)

EarnPriceSource — errors

error NoPrice(address asset)
error StalePrice(address asset, uint256 updatedAt, uint256 maxAgeSec)

TokenFactory

Address 0xa4860BdfaE9B2881B1B593aFFC8740d926eCC1d1 · chain 482120

Creates the 345 price-tracker tokens as EIP-1167 clones of the TrackerToken implementation. List them with tokenCount / tokenAt / tokenRange, or look one up with tokenBySymbol; isFactoryToken tells whether an address is one of them. Owner 0x4aFd0A931176103d704Ff0d696614d4E10d74A4a.

TokenFactory — functions

function tokenCount() view returns (uint256)
function tokenAt(uint256 index) view returns (address)
function tokenRange(uint256 start, uint256 count) view returns (address[] out)
function tokenBySymbol(bytes32) view returns (address)
function isFactoryToken(address) view returns (bool)
function implementation() view returns (address)
function defaultMinter() view returns (address)

TokenFactory — events

event TokenCreated(address indexed token, string name, string symbol, uint256 mintCap, uint256 index)

OracleRebalancer

Address 0x6c811003D301769575e9A8661B9197FAf2A32e69 · chain 482120

Keeps the ClpPools tracker pools near the PriceHub price. Acts when a pool deviates by more than thresholdBps (30), closing stepPct (90%) of the gap, at most maxTradeBtcw (500 BTCw) per trade and dailyMintCapBtcw (160,000 BTCw-equivalent) of new tracker tokens per day; skips prices older than maxAgeSec (300 s). Only keepers can call it (openToAll = false). Its volume is counted as treasury volume. Owner 0x4aFd0A931176103d704Ff0d696614d4E10d74A4a.

OracleRebalancer — functions

function thresholdBps() view returns (uint256)
function stepPct() view returns (uint256)
function maxTradeBtcw() view returns (uint256)
function dailyMintCapBtcw() view returns (uint256)
function mintedTodayBtcw() view returns (uint256)
function maxAgeSec() view returns (uint256)
function preview(address token) view returns (uint8 side, uint256 amountIn, uint256 toMint, int256 devBps)
function isKeeper(address) view returns (bool)
function openToAll() view returns (bool)
function paused() view returns (bool)

OracleRebalancer — events

event Rebalanced(address indexed token, bool sold, uint256 amountIn, uint256 amountOut, uint256 minted, int256 devBps)
event Skipped(address indexed token, uint8 reason)

Multicall3

Address 0xA0093EA76633A983364cb2582959870eaffDdea0 · chain 482120

Multicall3 (same init code and runtime as the canonical mds1 Multicall3), deployed from the Owner wallet at a NON-standard address (R-52). Libraries that hard-code 0xcA11bde05977b3631167028862bE2a173976CA11 must be pointed at this address.

Multicall3 — functions

function aggregate3((address target, bool allowFailure, bytes callData)[] calls) payable returns ((bool success, bytes returnData)[] returnData)
function tryAggregate(bool requireSuccess, (address target, bytes callData)[] calls) payable returns ((bool success, bytes returnData)[] returnData)
function getBlockNumber() view returns (uint256 blockNumber)
function getCurrentBlockTimestamp() view returns (uint256 timestamp)
function getEthBalance(address addr) view returns (uint256 balance)

StakedTokenFactory

Address 0xA4FEe82a4d689896734fb867f5DD4F39adeAF4Ed · chain 482120

Staking for ERC-20 tokens (R-62c): one StakedToken contract (stXXX) per token, created by this factory. Stake = approve the stXXX contract, then stake(amount); you receive stXXX 1:1 (transferable ERC-20, same decimals as the token). USDC (Bitcoin Swap) rewards are streamed to every holder from a reserve the treasury funded first (nothing minted), settled on each transfer and pushable by anyone with claimFor. Unstake returns the same tokens (cooldownSec = 0). Owner 0xB17bdA8F14EEb9fd67B34810A2e1E82A737Ad952 keeps only pause, cooldown (while paused), fund / reclaim of the unstreamed USDC (Bitcoin Swap) and sweep of unbooked tokens; it cannot touch staked tokens. Deployed 5 Oct 2026. stakes = token -> stXXX contract; stakeAbi = ABI of every stXXX.

StakedTokenFactory — functions

function admin() view returns (address)
function all() view returns (address[],address[])
function assetCount() view returns (uint256)
function deploy(address[],uint256) returns (address[])
function stakeOf(address) view returns (address)
function stakeOwner() view returns (address)
function usd() view returns (address)

StakedTokenFactory — events

event StakeDeployed(address indexed,address indexed,string)

StakedTokenFactory — errors

error AlreadyDeployed(address)
error NotAdmin()
error ZeroAddress()

UniswapV3Factory

Address 0xF92304dFe93Cb4C3bfAc5B0CE59C39A4126a172F · chain 482120

Official Uniswap V3 bytecode (@uniswap/v3-core 1.0.1), runtime identical to the Ethereum deployment. owner = Owner wallet 0xB17bdA8F14EEb9fd67B34810A2e1E82A737Ad952; fee tiers 0.01 % / 0.05 % / 0.3 % / 1 % (tick spacing 1 / 10 / 60 / 200); protocol fee off. Pool init code hash 0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54 (the standard one). Deployed 6 Oct 2026 (R-65).

UniswapV3Factory — functions

function createPool(address tokenA, address tokenB, uint24 fee) returns (address pool)
function enableFeeAmount(uint24 fee, int24 tickSpacing)
function feeAmountTickSpacing(uint24) view returns (int24)
function getPool(address, address, uint24) view returns (address)
function owner() view returns (address)
function parameters() view returns (address factory, address token0, address token1, uint24 fee, int24 tickSpacing)
function setOwner(address _owner)

UniswapV3Factory — events

event FeeAmountEnabled(uint24 indexed fee, int24 indexed tickSpacing)
event OwnerChanged(address indexed oldOwner, address indexed newOwner)
event PoolCreated(address indexed token0, address indexed token1, uint24 indexed fee, int24 tickSpacing, address pool)

UniswapV3_NonfungiblePositionManager

Address 0xc0b75e9c8b736E4e905db05Aa7E60DC9e5581A30 · chain 482120

Official Uniswap V3 bytecode (@uniswap/v3-periphery 1.4.4): V3 liquidity positions as ERC-721 (UNI-V3-POS). WETH9() = WBTCw, so the *ETH paths wrap/unwrap WBTCw <-> native BTCw (wrapping needs the vault, so sending native BTCw reverts; unwrapping works). Deployed 6 Oct 2026 (R-65).

UniswapV3_NonfungiblePositionManager — functions

function DOMAIN_SEPARATOR() view returns (bytes32)
function PERMIT_TYPEHASH() view returns (bytes32)
function WETH9() view returns (address)
function approve(address to, uint256 tokenId)
function balanceOf(address owner) view returns (uint256)
function baseURI() pure returns (string)
function burn(uint256 tokenId) payable
function collect((uint256 tokenId, address recipient, uint128 amount0Max, uint128 amount1Max) params) payable returns (uint256 amount0, uint256 amount1)
function createAndInitializePoolIfNecessary(address token0, address token1, uint24 fee, uint160 sqrtPriceX96) payable returns (address pool)
function decreaseLiquidity((uint256 tokenId, uint128 liquidity, uint256 amount0Min, uint256 amount1Min, uint256 deadline) params) payable returns (uint256 amount0, uint256 amount1)
function factory() view returns (address)
function getApproved(uint256 tokenId) view returns (address)
function increaseLiquidity((uint256 tokenId, uint256 amount0Desired, uint256 amount1Desired, uint256 amount0Min, uint256 amount1Min, uint256 deadline) params) payable returns (uint128 liquidity, uint256 amount0, uint256 amount1)
function isApprovedForAll(address owner, address operator) view returns (bool)
function mint((address token0, address token1, uint24 fee, int24 tickLower, int24 tickUpper, uint256 amount0Desired, uint256 amount1Desired, uint256 amount0Min, uint256 amount1Min, address recipient, uint256 deadline) params) payable returns (uint256 tokenId, uint128 liquidity, uint256 amount0, uint256 amount1)
function multicall(bytes[] data) payable returns (bytes[] results)
function name() view returns (string)
function ownerOf(uint256 tokenId) view returns (address)
function permit(address spender, uint256 tokenId, uint256 deadline, uint8 v, bytes32 r, bytes32 s) payable
function positions(uint256 tokenId) view returns (uint96 nonce, address operator, address token0, address token1, uint24 fee, int24 tickLower, int24 tickUpper, uint128 liquidity, uint256 feeGrowthInside0LastX128, uint256 feeGrowthInside1LastX128, uint128 tokensOwed0, uint128 tokensOwed1)
function refundETH() payable
function safeTransferFrom(address from, address to, uint256 tokenId)
function safeTransferFrom(address from, address to, uint256 tokenId, bytes _data)
function selfPermit(address token, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) payable
function selfPermitAllowed(address token, uint256 nonce, uint256 expiry, uint8 v, bytes32 r, bytes32 s) payable
function selfPermitAllowedIfNecessary(address token, uint256 nonce, uint256 expiry, uint8 v, bytes32 r, bytes32 s) payable
function selfPermitIfNecessary(address token, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) payable
function setApprovalForAll(address operator, bool approved)
function supportsInterface(bytes4 interfaceId) view returns (bool)
function sweepToken(address token, uint256 amountMinimum, address recipient) payable
function symbol() view returns (string)
function tokenByIndex(uint256 index) view returns (uint256)
function tokenOfOwnerByIndex(address owner, uint256 index) view returns (uint256)
function tokenURI(uint256 tokenId) view returns (string)
function totalSupply() view returns (uint256)
function transferFrom(address from, address to, uint256 tokenId)
function uniswapV3MintCallback(uint256 amount0Owed, uint256 amount1Owed, bytes data)
function unwrapWETH9(uint256 amountMinimum, address recipient) payable

UniswapV3_NonfungiblePositionManager — events

event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId)
event ApprovalForAll(address indexed owner, address indexed operator, bool approved)
event Collect(uint256 indexed tokenId, address recipient, uint256 amount0, uint256 amount1)
event DecreaseLiquidity(uint256 indexed tokenId, uint128 liquidity, uint256 amount0, uint256 amount1)
event IncreaseLiquidity(uint256 indexed tokenId, uint128 liquidity, uint256 amount0, uint256 amount1)
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)

UniswapV3_SwapRouter02

Address 0xF0255ec02c8543DB6D549D87862B9ad1b13EF000 · chain 482120

Official Uniswap V3 bytecode (@uniswap/swap-router-contracts 1.3.1): swaps through Uniswap V3 pools and the Uniswap V2 factory 0x453F946CB371a2039137453BAafFb83FF4ccf9f7 in one router (multicall). WETH9() = WBTCw. Deployed 6 Oct 2026 (R-65).

UniswapV3_SwapRouter02 — functions

function WETH9() view returns (address)
function approveMax(address token) payable
function approveMaxMinusOne(address token) payable
function approveZeroThenMax(address token) payable
function approveZeroThenMaxMinusOne(address token) payable
function callPositionManager(bytes data) payable returns (bytes result)
function checkOracleSlippage(bytes[] paths, uint128[] amounts, uint24 maximumTickDivergence, uint32 secondsAgo) view
function checkOracleSlippage(bytes path, uint24 maximumTickDivergence, uint32 secondsAgo) view
function exactInput((bytes path, address recipient, uint256 amountIn, uint256 amountOutMinimum) params) payable returns (uint256 amountOut)
function exactInputSingle((address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96) params) payable returns (uint256 amountOut)
function exactOutput((bytes path, address recipient, uint256 amountOut, uint256 amountInMaximum) params) payable returns (uint256 amountIn)
function exactOutputSingle((address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountOut, uint256 amountInMaximum, uint160 sqrtPriceLimitX96) params) payable returns (uint256 amountIn)
function factory() view returns (address)
function factoryV2() view returns (address)
function getApprovalType(address token, uint256 amount) returns (uint8)
function increaseLiquidity((address token0, address token1, uint256 tokenId, uint256 amount0Min, uint256 amount1Min) params) payable returns (bytes result)
function mint((address token0, address token1, uint24 fee, int24 tickLower, int24 tickUpper, uint256 amount0Min, uint256 amount1Min, address recipient) params) payable returns (bytes result)
function multicall(bytes32 previousBlockhash, bytes[] data) payable returns (bytes[])
function multicall(uint256 deadline, bytes[] data) payable returns (bytes[])
function multicall(bytes[] data) payable returns (bytes[] results)
function positionManager() view returns (address)
function pull(address token, uint256 value) payable
function refundETH() payable
function selfPermit(address token, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) payable
function selfPermitAllowed(address token, uint256 nonce, uint256 expiry, uint8 v, bytes32 r, bytes32 s) payable
function selfPermitAllowedIfNecessary(address token, uint256 nonce, uint256 expiry, uint8 v, bytes32 r, bytes32 s) payable
function selfPermitIfNecessary(address token, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) payable
function swapExactTokensForTokens(uint256 amountIn, uint256 amountOutMin, address[] path, address to) payable returns (uint256 amountOut)
function swapTokensForExactTokens(uint256 amountOut, uint256 amountInMax, address[] path, address to) payable returns (uint256 amountIn)
function sweepToken(address token, uint256 amountMinimum, address recipient) payable
function sweepToken(address token, uint256 amountMinimum) payable
function sweepTokenWithFee(address token, uint256 amountMinimum, uint256 feeBips, address feeRecipient) payable
function sweepTokenWithFee(address token, uint256 amountMinimum, address recipient, uint256 feeBips, address feeRecipient) payable
function uniswapV3SwapCallback(int256 amount0Delta, int256 amount1Delta, bytes _data)
function unwrapWETH9(uint256 amountMinimum, address recipient) payable
function unwrapWETH9(uint256 amountMinimum) payable
function unwrapWETH9WithFee(uint256 amountMinimum, address recipient, uint256 feeBips, address feeRecipient) payable
function unwrapWETH9WithFee(uint256 amountMinimum, uint256 feeBips, address feeRecipient) payable
function wrapETH(uint256 value) payable

UniswapV3_QuoterV2

Address 0xB854A84d06Cc58d6C94C34aCc8Ae8Dc4988aA7cB · chain 482120

Official Uniswap V3 bytecode (@uniswap/v3-periphery 1.4.4): off-chain quotes for V3 swaps (call with eth_call / staticCall). Deployed 6 Oct 2026 (R-65).

UniswapV3_QuoterV2 — functions

function WETH9() view returns (address)
function factory() view returns (address)
function quoteExactInput(bytes path, uint256 amountIn) returns (uint256 amountOut, uint160[] sqrtPriceX96AfterList, uint32[] initializedTicksCrossedList, uint256 gasEstimate)
function quoteExactInputSingle((address tokenIn, address tokenOut, uint256 amountIn, uint24 fee, uint160 sqrtPriceLimitX96) params) returns (uint256 amountOut, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)
function quoteExactOutput(bytes path, uint256 amountOut) returns (uint256 amountIn, uint160[] sqrtPriceX96AfterList, uint32[] initializedTicksCrossedList, uint256 gasEstimate)
function quoteExactOutputSingle((address tokenIn, address tokenOut, uint256 amount, uint24 fee, uint160 sqrtPriceLimitX96) params) returns (uint256 amountIn, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)
function uniswapV3SwapCallback(int256 amount0Delta, int256 amount1Delta, bytes path) view

UniswapV3_TickLens

Address 0xb84D2A6C901eDe9518dce72A7925167343dAB3Ca · chain 482120

Official Uniswap V3 bytecode (@uniswap/v3-periphery 1.4.4): reads the initialized ticks of a V3 pool. Deployed 6 Oct 2026 (R-65).

UniswapV3_TickLens — functions

function getPopulatedTicksInWord(address pool, int16 tickBitmapIndex) view returns ((int24 tick, int128 liquidityNet, uint128 liquidityGross)[] populatedTicks)

UniswapV3_NonfungibleTokenPositionDescriptor

Address 0xE9cD5C54494021faB3481f58DD11794b96130F64 · chain 482120

Official Uniswap V3 bytecode (@uniswap/v3-periphery 1.4.4): tokenURI of V3 positions (on-chain SVG), native label "BTCw", linked to the NFTDescriptor library 0x807246C8AAC13d9693fF1B1965Ac8d712120a275. Deployed 6 Oct 2026 (R-65).

UniswapV3_NonfungibleTokenPositionDescriptor — functions

function WETH9() view returns (address)
function flipRatio(address token0, address token1, uint256 chainId) view returns (bool)
function nativeCurrencyLabel() view returns (string)
function nativeCurrencyLabelBytes() view returns (bytes32)
function tokenRatioPriority(address token, uint256 chainId) view returns (int256)
function tokenURI(address positionManager, uint256 tokenId) view returns (string)

UniswapV3Pool_WBTCw_USDCe

Address 0x0F5b0bb07fe8dB6e4fB7AAEdC40BC7F45fAB18A0 · chain 482120

Uniswap V3 WBTCw / USDC.e pool, 0.05% fee (tickSpacing 10; token0 = USDC.e, token1 = WBTCw), created 7 Oct 2026 by the Owner wallet 0xB17bdA8F14EEb9fd67B34810A2e1E82A737Ad952 at the V2 pool price with 40% of its V2 liquidity, range about +/-10%. The same peg keeper (0xe20dA14F7A9715Ba685048292e53C05c097E766D) keeps it on Chainlink BTC/USD: when it drifts more than 0.3%, one swap through SwapRouter02 with sqrtPriceLimitX96 = the reference. Price = 1e20 * 2^192 / sqrtPriceX96^2 (USD per BTC, 8 decimals). The position NFT is held by the Owner wallet, unlocked. Swap API venue v3.

UniswapV3Pool_WBTCw_USDCe — functions

function slot0() view returns (uint160 sqrtPriceX96, int24 tick, uint16 observationIndex, uint16 observationCardinality, uint16 observationCardinalityNext, uint8 feeProtocol, bool unlocked)
function liquidity() view returns (uint128)
function token0() view returns (address)
function token1() view returns (address)
function fee() view returns (uint24)
function tickSpacing() view returns (int24)

UniswapV3Pool_WBTCw_USDCe — events

event Swap(address indexed sender, address indexed recipient, int256 amount0, int256 amount1, uint160 sqrtPriceX96, uint128 liquidity, int24 tick)

ETHe

Address 0x72a1Ee092807B58682592543Eba7b49004e30579 · chain 482120 · 18 decimals

R-66: ETH.e, Bridged Ether (Bitcoin Swap): SealedSyntheticToken of the dedicated core (R-52). Minted 1:1 only when ETH is locked in the Arbitrum vault 0x0a3fD8b35593fB4f82Da4C110C356745Dd7CDce2, burned when sent back with transferRemote(42161, recipient, amount) (msg.value 0, no approval). Supply <= ETH locked, so every holder can always withdraw. Sealed: fixed ISM, counterpart enrolled once, no fees; owner (wallet B) keeps pause and the allowlist only. Allowlist off since 6 Oct 2026 (open to every wallet). Signed 06/10/2026.

ETHe — functions

function name() view returns (string)
function symbol() view returns (string)
function decimals() view returns (uint8)
function totalSupply() view returns (uint256)
function balanceOf(address) view returns (uint256)
function allowance(address,address) view returns (uint256)
function approve(address spender, uint256 amount) returns (bool)
function transfer(address to, uint256 amount) returns (bool)
function transferRemote(uint32 destination, bytes32 recipient, uint256 amount) payable returns (bytes32 messageId)
function routers(uint32 domain) view returns (bytes32)
function allowlistEnabled() view returns (bool)
function isAllowed(address) view returns (bool)
function paused() view returns (bool)

ETHe — events

event Transfer(address indexed from, address indexed to, uint256 value)
event SentTransferRemote(uint32 indexed destination, bytes32 indexed recipient, uint256 amountOrId)
event ReceivedTransferRemote(uint32 indexed origin, bytes32 indexed recipient, uint256 amountOrId)

ETHe — errors

error Paused()
error NotAllowed(address account)

OracleTokenAMM_ETHe

Address 0x041C57991b772615e720A5b35F76Cfe52632398A · chain 482120

R-66: ETH.e <-> USDC (Bitcoin Swap) at the ETH/USD price (PriceHub ETHw feed through PriceAlias 0x6E88283f25422969A73Dd8428b2120fD1Ffd0eD1) +/- spreadBps (30 = 0.3%). maxTradeToken 5 ETH.e per order; stops when the price is older than maxAgeSec (300). Buys only from its ETH.e inventory (nothing is minted); USDC (Bitcoin Swap) liquidity from the treasury. buyToken/sellToken can pay another recipient. Quote API route amm-ethe.

OracleTokenAMM_ETHe — functions

function quoteBuyToken(uint256 usdIn) view returns (uint256 tokenOut)
function quoteSellToken(uint256 tokenIn) view returns (uint256 usdOut)
function buyToken(uint256 usdIn, uint256 minTokenOut, address to) returns (uint256 tokenOut)
function sellToken(uint256 tokenIn, uint256 minUsdOut, address to) returns (uint256 usdOut)
function midPrice() view returns (uint256 priceWad, uint256 updatedAt)
function token() view returns (address)
function usd() view returns (address)
function hub() view returns (address)
function tokenReserve() view returns (uint256)
function usdReserve() view returns (uint256)
function spreadBps() view returns (uint256)
function maxAgeSec() view returns (uint256)
function maxTradeToken() view returns (uint256)
function paused() view returns (bool)

OracleTokenAMM_ETHe — events

event Swap(address indexed trader, address indexed to, bool tokenIn, uint256 amountIn, uint256 amountOut, uint256 priceWad)

OracleTokenAMM_ETHe — errors

error ContractPaused()
error ZeroAmount()
error ZeroAddress()
error StalePrice(uint256 updatedAt)
error InvalidOraclePrice()
error ExceedsMaxTrade(uint256 cap, uint256 amount)
error InsufficientLiquidity(uint256 available, uint256 required)
error SlippageExceeded(uint256 amountOut, uint256 minAmountOut)

PriceAlias_ETHe

Address 0x6E88283f25422969A73Dd8428b2120fD1Ffd0eD1 · chain 482120

R-66: ownerless, immutable. latestRoundData(ETH.e) returns PriceHub.latestRoundData(ETHw) (ETH/USD) — same answer, updatedAt and decimals; any other asset reverts UnknownAsset. Used as the hub of the ETH.e market.

PriceAlias_ETHe — functions

function hub() view returns (address)
function token() view returns (address)
function source() view returns (address)
function decimals() view returns (uint8)
function latestRoundData(address asset) view returns (uint80, int256, uint256, uint256, uint80)

PriceAlias_ETHe — errors

error UnknownAsset(address asset)

SwapRouter2

Address 0x7c2ad011E0C1D31E73F35460685f0B4fc1cC1e0E · chain 482120

R-66: a second instance of SwapRouter (same code, ownerless): venue 0 ClpPools, venue 1 OracleAMM, venue 2 ETHw market 0xFd6d78A3b60175D37146793396A2FA7864039D54, venue 3 ETH.e market 0x041C57991b772615e720A5b35F76Cfe52632398A. ETH.e <-> BTCw or any token in one transaction. The first SwapRouter is unchanged; the SDK uses this one only when one side is ETH.e.

SwapRouter2 — functions

function swap(address tokenIn, uint256 amountIn, (uint8 venue, address tokenOut)[] hops, uint256 minOut, address to, uint256 deadline) payable returns (uint256 amountOut)
function quote(address tokenIn, uint256 amountIn, (uint8 venue, address tokenOut)[] hops) view returns (uint256 amountOut)
function tokenAmmCount() view returns (uint256)
function tokenAmmAt(uint256 index) view returns (address amm, address token)
function clp() view returns (address)
function oracleAmm() view returns (address)
function usdw() view returns (address)
function NATIVE() view returns (address)
function MAX_HOPS() view returns (uint256)

SwapRouter2 — events

event Routed(address indexed sender, address indexed tokenIn, address indexed tokenOut, uint256 amountIn, uint256 amountOut, address to, uint256 hops)

SwapRouter2 — errors

error Expired(uint256 deadline)
error InvalidRecipient()
error InvalidPath()
error UnknownVenue(uint8 venue)
error UnsupportedHop(uint8 venue, address tokenIn, address tokenOut)
error ValueMismatch(uint256 sent, uint256 expected)
error SlippageExceeded(uint256 amountOut, uint256 minAmountOut)
error ZeroAmount()
error ZeroAddress()
error UnexpectedSender()
error NativeTransferFailed()

StableReserve

Address 0x509c358d8f437837174Bb5071B9fE70b06f82483 · chain 482120

R-67: exchanges USDC (Bitcoin Swap) and USDC.e 1:1. redeem(usdwAmount, to) burns USDC (Bitcoin Swap) and pays USDC.e (amount / 1e12, never paused); deposit(usdcAmount, to) takes USDC.e and pays USDC (Bitcoin Swap) from its stock. No function withdraws USDC.e. Owner (wallet B) can pause deposits only. Reserve and coverage: https://btcw.tech/api/v2/usdw/reserve

StableReserve — functions

function redeem(uint256 usdwAmount, address to) returns (uint256 usdcOut)
function deposit(uint256 usdcAmount, address to) returns (uint256 usdwOut)
function quoteRedeem(uint256 usdwAmount) pure returns (uint256 usdcOut, uint256 usdwTaken)
function reserve() view returns (uint256)
function stock() view returns (uint256)
function depositPaused() view returns (bool)

StableReserve — events

event Redeemed(address indexed from, address indexed to, uint256 usdwIn, uint256 usdcOut)
event Deposited(address indexed from, address indexed to, uint256 usdcIn, uint256 usdwOut)

VerifyingPaymaster

Address 0x876Be0170F5fb4Cd86b1990Bb2A34fe52F089aEd · chain 482120

ERC-4337 VerifyingPaymaster (@account-abstraction/contracts 0.7.0 sample, unmodified) for EntryPoint v0.7: pays the gas of new smart-account wallets when the ERC-7677 service https://btcw.tech/api/v2/4337/paymaster signs a voucher (rules: docs Gasless transactions). Owner 0xB17bdA8F14EEb9fd67B34810A2e1E82A737Ad952 (deposit and withdrawal); verifyingSigner 0x618a5Aa975c406E5207e6dC22904De72A3aaB39c signs vouchers only. Deployed 6 Oct 2026 (R-66).

VerifyingPaymaster — functions

function owner() view returns (address)
function verifyingSigner() view returns (address)
function entryPoint() view returns (address)
function getDeposit() view returns (uint256)
function getHash((address sender,uint256 nonce,bytes initCode,bytes callData,bytes32 accountGasLimits,uint256 preVerificationGas,bytes32 gasFees,bytes paymasterAndData,bytes signature) userOp, uint48 validUntil, uint48 validAfter) view returns (bytes32)

Bridge router (GuardedCollateralRouter)

USDC: Arbitrum 0x10B5757aC9a40E3467846e35749ae30b00ef0182 ⇄ 482120 0x10EDFF80C17A39940a4dc724b9c24fE9D2E8Fd9b
USD₮0: Arbitrum 0x984fDC24D1A2Be538C7290487d0fc212635D98A5 ⇄ 482120 0xD6d8452FdCC26B155BEc4fc878635c05CaC95FB1

Arbitrum USDC / USD₮0 (6 decimals) are locked in the Arbitrum router; the 482120 router releases USDC (Bitcoin Swap) (18 decimals) from its reserve, and back. Amount leaving an end is bounded by what is locked there. On 482120 amounts must be a multiple of granularity (1e12). No interchain gas payment: call transferRemote with msg.value = 0. Recipient is bytes32, address LEFT-padded with zeros. Delivery usually 10-30 s. Read allowlistEnabled(): when true only allowlisted wallets can send.

Bridge router (GuardedCollateralRouter) — functions

function transferRemote(uint32 destination, bytes32 recipient, uint256 amount) payable returns (bytes32 messageId)
function wrappedToken() view returns (address)
function granularity() view returns (uint256)
function allowlistEnabled() view returns (bool)
function isAllowed(address) view returns (bool)
function paused() view returns (bool)
function routers(uint32 domain) view returns (bytes32)
function mailbox() view returns (address)

Bridge router (GuardedCollateralRouter) — events

event SentTransferRemote(uint32 indexed destination, bytes32 indexed recipient, uint256 amountOrId)
event ReceivedTransferRemote(uint32 indexed origin, bytes32 indexed recipient, uint256 amountOrId)

Bridge router (GuardedCollateralRouter) — errors

error NotAllowed(address account)
error Paused()
error BadGranularity(uint256 amount, uint256 granularity)