@black-market/sdk 0.1.0

package/src/addresses.ts

@@ -0,0 +1,342 @@
+import type { Address, Chain } from "viem";
+import { defineChain } from "viem";
+import { foundry } from "viem/chains";
+
+export type SupportedChainId = 31337 | 4663 | 46631;
+
+export type AbyssInfrastructureAddresses = {
+  abyssFactory: Address;
+  abyssFeeVault: Address;
+  abyssPoolDeployer: Address;
+  abyssRouter: Address;
+  abyssQuoter: Address;
+  abyssPositionManager: Address;
+  abyssPositionLocker: Address;
+  abyssToken: Address;
+  abyssBuybackBurnerImplementation: Address;
+  abyssBuybackBurner: Address;
+  abyssFeeRouterImplementation: Address;
+  abyssFeeRouter: Address;
+};
+
+export type LaunchApplicationAddresses = {
+  launchTokenFactory: Address;
+  launchCoordinator: Address;
+  launchFactory: Address;
+  launchTemplateRegistry: Address;
+  launchModuleFactory: Address;
+  launchFeeOwnerRegistry: Address;
+};
+
+export type ProtocolAddresses = AbyssInfrastructureAddresses &
+  LaunchApplicationAddresses & {
+    lendingPool: Address;
+    addressesProvider: Address;
+    dataProvider: Address;
+    uiPoolDataProvider: Address;
+    walletBalanceProvider: Address;
+    aaveOracle: Address;
+    liquidationExecutor: Address;
+    protocolVault: Address;
+    ethUsdFeed: Address;
+    weth: Address;
+    wethGateway: Address;
+    lens: Address;
+    tokenVesting: Address;
+    faucet: Address;
+  };
+
+const zero = "0x0000000000000000000000000000000000000000" as Address;
+
+function readEnv(...keys: string[]): string | undefined {
+  if (typeof process === "undefined" || !process.env) return undefined;
+  for (const key of keys) {
+    const value = process.env[key];
+    if (value) return value;
+  }
+  return undefined;
+}
+
+const rpcUrl = readEnv("VITE_RPC_URL", "NEXT_PUBLIC_RPC_URL", "RPC_URL") ?? "http://127.0.0.1:8545";
+
+/** Local Anvil (DeployLocal / plain forge). */
+export const anvilLocal = foundry;
+
+/** Robinhood-mainnet fork workbench (contracts/script/workbench.sh). */
+export const workbenchChain = defineChain({
+  id: 46631,
+  name: "Black Market Workbench",
+  nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+  rpcUrls: {
+    default: { http: [rpcUrl] },
+  },
+  testnet: true,
+});
+
+/** Canonical Robinhood Chain mainnet. */
+export const robinhoodMainnet = defineChain({
+  id: 4663,
+  name: "Robinhood Chain",
+  nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+  rpcUrls: {
+    default: { http: ["https://rpc.mainnet.chain.robinhood.com/"] },
+  },
+  blockExplorers: {
+    default: {
+      name: "Robinhood Chain Explorer",
+      url: "https://robinhoodchain.blockscout.com",
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+    },
+  },
+});
+
+function envAddr(keys: string[], fallback: Address = zero): Address {
+  return (readEnv(...keys) as Address | undefined) ?? fallback;
+}
+
+function abyssInfrastructureFromEnv(
+  fallback: AbyssInfrastructureAddresses,
+): AbyssInfrastructureAddresses {
+  const address = (name: string, defaultAddress: Address) =>
+    envAddr([name, `VITE_${name}`, `NEXT_PUBLIC_${name}`], defaultAddress);
+
+  return {
+    abyssFactory: address("ABYSS_FACTORY", fallback.abyssFactory),
+    abyssFeeVault: address("ABYSS_FEE_VAULT", fallback.abyssFeeVault),
+    abyssPoolDeployer: address("ABYSS_POOL_DEPLOYER", fallback.abyssPoolDeployer),
+    abyssRouter: address("ABYSS_ROUTER", fallback.abyssRouter),
+    abyssQuoter: address("ABYSS_QUOTER", fallback.abyssQuoter),
+    abyssPositionManager: address("ABYSS_POSITION_MANAGER", fallback.abyssPositionManager),
+    abyssPositionLocker: address("ABYSS_POSITION_LOCKER", fallback.abyssPositionLocker),
+    abyssToken: address("ABYSS_TOKEN", fallback.abyssToken),
+    abyssBuybackBurnerImplementation: address(
+      "ABYSS_BUYBACK_BURNER_IMPLEMENTATION",
+      fallback.abyssBuybackBurnerImplementation,
+    ),
+    abyssBuybackBurner: address("ABYSS_BUYBACK_BURNER", fallback.abyssBuybackBurner),
+    abyssFeeRouterImplementation: address(
+      "ABYSS_FEE_ROUTER_IMPLEMENTATION",
+      fallback.abyssFeeRouterImplementation,
+    ),
+    abyssFeeRouter: address("ABYSS_FEE_ROUTER", fallback.abyssFeeRouter),
+  };
+}
+
+function launchApplicationFromEnv(
+  fallback: LaunchApplicationAddresses,
+): LaunchApplicationAddresses {
+  const address = (name: string, defaultAddress: Address) =>
+    envAddr([name, `VITE_${name}`, `NEXT_PUBLIC_${name}`], defaultAddress);
+
+  return {
+    launchTokenFactory: address("LAUNCH_TOKEN_FACTORY", fallback.launchTokenFactory),
+    launchCoordinator: address("LAUNCH_COORDINATOR", fallback.launchCoordinator),
+    launchFactory: address("LAUNCH_FACTORY", fallback.launchFactory),
+    launchTemplateRegistry: address("LAUNCH_TEMPLATE_REGISTRY", fallback.launchTemplateRegistry),
+    launchModuleFactory: address("LAUNCH_MODULE_FACTORY", fallback.launchModuleFactory),
+    launchFeeOwnerRegistry: address("LAUNCH_FEE_OWNER_REGISTRY", fallback.launchFeeOwnerRegistry),
+  };
+}
+
+const ROBINHOOD_WETH = "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73" as Address;
+const ROBINHOOD_ETH_USD = "0x78F3556b67E17Df817D51Ef5a990cDaF09E8d3A9" as Address;
+
+const zeroAbyssInfrastructure: AbyssInfrastructureAddresses = {
+  abyssFactory: zero,
+  abyssFeeVault: zero,
+  abyssPoolDeployer: zero,
+  abyssRouter: zero,
+  abyssQuoter: zero,
+  abyssPositionManager: zero,
+  abyssPositionLocker: zero,
+  abyssToken: zero,
+  abyssBuybackBurnerImplementation: zero,
+  abyssBuybackBurner: zero,
+  abyssFeeRouterImplementation: zero,
+  abyssFeeRouter: zero,
+};
+
+const zeroLaunchApplication: LaunchApplicationAddresses = {
+  launchTokenFactory: zero,
+  launchCoordinator: zero,
+  launchFactory: zero,
+  launchTemplateRegistry: zero,
+  launchModuleFactory: zero,
+  launchFeeOwnerRegistry: zero,
+};
+
+/** Canonical replacement: abyss/deployments/4663/abyss-canonical-replacement-20260830/deployment.json. */
+export const robinhoodAbyssInfrastructure: AbyssInfrastructureAddresses = {
+  abyssFactory: "0xe7feF2BC860B25bbdEB6F6AB96d88bAAa77ddad7",
+  abyssFeeVault: "0x19b04F2E86fFDf26510ACf25344c406240214d5F",
+  abyssPoolDeployer: "0xe49Ff46f2Ca543D5504cDCF533fe84e0c95eF693",
+  abyssRouter: "0xF7818c69e31bf98eFF96C721B557Bb519659CD27",
+  abyssQuoter: "0xF1ff7c78605939df2d705F3E12Ac9CEB69Bcfe76",
+  abyssPositionManager: "0x1b2176d4D2C7bd36227D92Ed84F1A3aE30B635bF",
+  abyssPositionLocker: "0xa0d4fA31740FA0d8fc6b5b4173Da17864Eb6e888",
+  abyssToken: "0x15f3385625D7e364C5a6216FBbceadf10fa90e7d",
+  abyssBuybackBurnerImplementation: "0xd17F05C41FfdebB6b57b3e232c20a340906A0aAd",
+  abyssBuybackBurner: "0xF6C7159e967f28C65d9Fb5b919567E04540cD2FF",
+  abyssFeeRouterImplementation: "0xB35b85db23fEF3A146Fbd755D76be12F9e1eBfFC",
+  abyssFeeRouter: "0x2c3B1b6fe0EDa8e10C0445567b47e66E825B34cd",
+};
+
+/** Captured replacement: contracts/deployments/launch/robinhood-mainnet-replacement-deployment-record.json. */
+export const robinhoodLaunchApplication: LaunchApplicationAddresses = {
+  launchTokenFactory: "0x7B6F6efb4536F579223423e31d9036D996bc90F0",
+  launchCoordinator: "0xE98A82202D794A7836316971e7ACf61F260f8399",
+  launchFactory: "0xAf3FdC499b3717EBE8aD51B66bA78Cb083552351",
+  launchTemplateRegistry: "0x5C22c6e02bAC8225eed64629447868bAA5774186",
+  launchModuleFactory: "0xb2D9988592eE245a36290A0992505ca0474434f2",
+  launchFeeOwnerRegistry: "0xdD3756269Db20F2a60055b0FE8c101FAd12525f9",
+};
+
+/** Workbench deployment snapshot — override via env when redeploying. */
+const workbenchDefaults: ProtocolAddresses = {
+  ...robinhoodAbyssInfrastructure,
+  ...launchApplicationFromEnv(zeroLaunchApplication),
+  lendingPool: "0xe1576c5CF12F670911BEd5Cc0AEDBcD4E5E9550c",
+  addressesProvider: "0x9Fcca440F19c62CDF7f973eB6DDF218B15d4C71D",
+  dataProvider: "0x79E8AB29Ff79805025c9462a2f2F12e9A496f81d",
+  uiPoolDataProvider: zero,
+  walletBalanceProvider: zero,
+  aaveOracle: "0x9c65f85425c619A6cB6D29fF8d57ef696323d188",
+  liquidationExecutor: zero,
+  protocolVault: "0xAe120F0df055428E45b264E7794A18c54a2a3fAF",
+  ethUsdFeed: ROBINHOOD_ETH_USD,
+  weth: ROBINHOOD_WETH,
+  wethGateway: zero,
+  lens: zero,
+  tokenVesting: zero,
+  faucet: zero,
+};
+
+export const addresses: Record<SupportedChainId, ProtocolAddresses> = {
+  31337: {
+    ...abyssInfrastructureFromEnv(zeroAbyssInfrastructure),
+    ...launchApplicationFromEnv(zeroLaunchApplication),
+    lendingPool: envAddr(["LENDING_POOL", "VITE_LENDING_POOL", "NEXT_PUBLIC_LENDING_POOL"]),
+    addressesProvider: envAddr([
+      "ADDRESSES_PROVIDER",
+      "VITE_ADDRESSES_PROVIDER",
+      "NEXT_PUBLIC_ADDRESSES_PROVIDER",
+    ]),
+    dataProvider: envAddr(["DATA_PROVIDER", "VITE_DATA_PROVIDER", "NEXT_PUBLIC_DATA_PROVIDER"]),
+    uiPoolDataProvider: envAddr([
+      "UI_POOL_DATA_PROVIDER",
+      "VITE_UI_POOL_DATA_PROVIDER",
+      "NEXT_PUBLIC_UI_POOL_DATA_PROVIDER",
+    ]),
+    walletBalanceProvider: envAddr([
+      "WALLET_BALANCE_PROVIDER",
+      "VITE_WALLET_BALANCE_PROVIDER",
+      "NEXT_PUBLIC_WALLET_BALANCE_PROVIDER",
+    ]),
+    aaveOracle: envAddr(["AAVE_ORACLE", "VITE_AAVE_ORACLE", "NEXT_PUBLIC_AAVE_ORACLE"]),
+    liquidationExecutor: envAddr([
+      "LIQUIDATION_EXECUTOR",
+      "VITE_LIQUIDATION_EXECUTOR",
+      "NEXT_PUBLIC_LIQUIDATION_EXECUTOR",
+    ]),
+    protocolVault: envAddr(["PROTOCOL_VAULT", "VITE_PROTOCOL_VAULT", "NEXT_PUBLIC_PROTOCOL_VAULT"]),
+    ethUsdFeed: envAddr(["ETH_USD_FEED", "VITE_ETH_USD_FEED", "NEXT_PUBLIC_ETH_USD_FEED"]),
+    weth: envAddr(["WETH", "VITE_WETH", "NEXT_PUBLIC_WETH"]),
+    wethGateway: envAddr(["WETH_GATEWAY", "VITE_WETH_GATEWAY", "NEXT_PUBLIC_WETH_GATEWAY"]),
+    lens: envAddr(["LENS", "VITE_LENS", "NEXT_PUBLIC_LENS"]),
+    tokenVesting: envAddr(["TOKEN_VESTING", "VITE_TOKEN_VESTING", "NEXT_PUBLIC_TOKEN_VESTING"]),
+    faucet: envAddr(["FAUCET", "VITE_FAUCET", "NEXT_PUBLIC_FAUCET"]),
+  },
+  /** Captured replacement launch defaults; environment variables may override them. */
+  4663: {
+    ...robinhoodAbyssInfrastructure,
+    ...launchApplicationFromEnv(robinhoodLaunchApplication),
+    lendingPool: "0x5b8F732A4F7a62D642070bb49255d6C434A76766",
+    addressesProvider: "0xaaD329d0Da03C8c00E8460b5b208D0A21A48C9df",
+    dataProvider: "0x3B097A7899DF433552B8428E774964661b53C193",
+    uiPoolDataProvider: "0x2F35A64c7E7cBc0c05A1A1C3e2F3952E103fD5b8",
+    walletBalanceProvider: "0x833BB152212DD5d2d6C7b0501aB38efb9602AD8B",
+    aaveOracle: "0xb9441f8D3Eda65Ac7cbb6b542b5345c98067e5Fb",
+    liquidationExecutor: envAddr([
+      "LIQUIDATION_EXECUTOR",
+      "VITE_LIQUIDATION_EXECUTOR",
+      "NEXT_PUBLIC_LIQUIDATION_EXECUTOR",
+    ]),
+    protocolVault: "0x961981916AB6575C3af3eeCecbf6A3b7Fad7C9e1",
+    ethUsdFeed: ROBINHOOD_ETH_USD,
+    weth: ROBINHOOD_WETH,
+    wethGateway: "0xAbc9E3B20e8773536BDCa5ba28C619762C8e0570",
+    lens: "0x82FA6e601F48d64b4f163Eb47D6001f2d5040f9B",
+    tokenVesting: zero,
+    faucet: zero,
+  },
+  46631: {
+    ...workbenchDefaults,
+    ...abyssInfrastructureFromEnv(robinhoodAbyssInfrastructure),
+    ...launchApplicationFromEnv(zeroLaunchApplication),
+    lendingPool: envAddr(
+      ["VITE_LENDING_POOL", "NEXT_PUBLIC_LENDING_POOL"],
+      workbenchDefaults.lendingPool,
+    ),
+    addressesProvider: envAddr(
+      ["VITE_ADDRESSES_PROVIDER", "NEXT_PUBLIC_ADDRESSES_PROVIDER"],
+      workbenchDefaults.addressesProvider,
+    ),
+    dataProvider: envAddr(
+      ["VITE_DATA_PROVIDER", "NEXT_PUBLIC_DATA_PROVIDER"],
+      workbenchDefaults.dataProvider,
+    ),
+    uiPoolDataProvider: envAddr(
+      ["VITE_UI_POOL_DATA_PROVIDER", "NEXT_PUBLIC_UI_POOL_DATA_PROVIDER"],
+      workbenchDefaults.uiPoolDataProvider,
+    ),
+    walletBalanceProvider: envAddr(
+      ["VITE_WALLET_BALANCE_PROVIDER", "NEXT_PUBLIC_WALLET_BALANCE_PROVIDER"],
+      workbenchDefaults.walletBalanceProvider,
+    ),
+    aaveOracle: envAddr(
+      ["VITE_AAVE_ORACLE", "NEXT_PUBLIC_AAVE_ORACLE"],
+      workbenchDefaults.aaveOracle,
+    ),
+    liquidationExecutor: envAddr(
+      ["LIQUIDATION_EXECUTOR", "VITE_LIQUIDATION_EXECUTOR", "NEXT_PUBLIC_LIQUIDATION_EXECUTOR"],
+      workbenchDefaults.liquidationExecutor,
+    ),
+    protocolVault: envAddr(
+      ["VITE_PROTOCOL_VAULT", "NEXT_PUBLIC_PROTOCOL_VAULT"],
+      workbenchDefaults.protocolVault,
+    ),
+    ethUsdFeed: envAddr(
+      ["VITE_ETH_USD_FEED", "NEXT_PUBLIC_ETH_USD_FEED"],
+      workbenchDefaults.ethUsdFeed,
+    ),
+    weth: envAddr(["VITE_WETH", "NEXT_PUBLIC_WETH"], workbenchDefaults.weth),
+    wethGateway: envAddr(
+      ["VITE_WETH_GATEWAY", "NEXT_PUBLIC_WETH_GATEWAY"],
+      workbenchDefaults.wethGateway,
+    ),
+    lens: envAddr(["VITE_LENS", "NEXT_PUBLIC_LENS"], workbenchDefaults.lens),
+    tokenVesting: envAddr(
+      ["VITE_TOKEN_VESTING", "NEXT_PUBLIC_TOKEN_VESTING"],
+      workbenchDefaults.tokenVesting,
+    ),
+    faucet: envAddr(["VITE_FAUCET", "NEXT_PUBLIC_FAUCET"], workbenchDefaults.faucet),
+  },
+};
+
+export const chains: Record<SupportedChainId, Chain> = {
+  31337: anvilLocal,
+  4663: robinhoodMainnet,
+  46631: workbenchChain,
+};
+
+export function getAddresses(chainId: SupportedChainId = 46631): ProtocolAddresses {
+  return addresses[chainId];
+}
+
+export function isSupportedChainId(id: number): id is SupportedChainId {
+  return id === 31337 || id === 4663 || id === 46631;
+}

package/src/auction.ts

@@ -0,0 +1,107 @@
+import { type Address, zeroAddress } from "viem";
+
+/** Fixed supply used by Atomic launches. */
+export const AUCTION_SUPPLY = 1_000_000_000n * 10n ** 18n;
+export const AUCTION_SUPPLY_WHOLE = 1_000_000_000;
+
+
+export const ROBINHOOD_USDG = "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168" as Address;
+export const ROBINHOOD_WETH = "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73" as Address;
+export const ROBINHOOD_ABYSS = "0x15f3385625D7e364C5a6216FBbceadf10fa90e7d" as Address;
+export const ROBINHOOD_AAPL = "0xaF3D76f1834A1d425780943C99Ea8A608f8a93f9" as Address;
+export const ROBINHOOD_AMD = "0x86923f96303D656E4aa86D9d42D1e57ad2023fdC" as Address;
+export const ROBINHOOD_AMZN = "0x12f190a9F9d7D37a250758b26824B97CE941bF54" as Address;
+export const ROBINHOOD_ASML = "0x47F93d52cBeC7C6D2CfC080e154002370a60dAEA" as Address;
+export const ROBINHOOD_BABA = "0xad25Ac6C84D497db898fa1E8387bf6Af3532a1c4" as Address;
+export const ROBINHOOD_CLSK = "0xcBB95BBF36099d34dA091dc6Fa6F49EfA257Cee3" as Address;
+export const ROBINHOOD_COIN = "0x6330D8C3178a418788dF01a47479c0ce7CCF450b" as Address;
+export const ROBINHOOD_CRCL = "0xdF0992E440dD0be65BD8439b609d6D4366bf1CB5" as Address;
+export const ROBINHOOD_CRWV = "0x5f10A1C971B69e47e059e1dC91901B59b3fB49C3" as Address;
+export const ROBINHOOD_DELL = "0x941AE714EC6D8130c7B75d67160Ca08f1e7d11Dd" as Address;
+export const ROBINHOOD_EWY = "0x7f0aBeF0C07280F82c6a08ead09dEd6BAE2C13Fc" as Address;
+export const ROBINHOOD_GME = "0x1b0E319c6A659F002271B69dB8A7df2F911c153E" as Address;
+export const ROBINHOOD_GOOGL = "0x2e0847E8910a9732eB3fb1bb4b70a580ADAD4FE3" as Address;
+export const ROBINHOOD_INTC = "0xc72b96e0E48ecd4DC75E1e45396e26300BC39681" as Address;
+export const ROBINHOOD_IONQ = "0x558378E000D634A36593E338eBacdd6207640EfE" as Address;
+export const ROBINHOOD_META = "0xc0D6457C16Cc70d6790Dd43521C899C87ce02f35" as Address;
+export const ROBINHOOD_MSFT = "0xe93237C50D904957Cf27E7B1133b510C669c2e74" as Address;
+export const ROBINHOOD_MSTR = "0xec262a75e413fAfD0dF80480274532C79D42da09" as Address;
+export const ROBINHOOD_MU = "0xfF080c8ce2E5feadaCa0Da81314Ae59D232d4afD" as Address;
+export const ROBINHOOD_NBIS = "0x9D9c6684F596F66a64C030B93A886D51Fd4D7931" as Address;
+export const ROBINHOOD_NVDA = "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC" as Address;
+export const ROBINHOOD_ORCL = "0xb0992820E760d836549ba69BC7598b4af75dEE03" as Address;
+export const ROBINHOOD_PLTR = "0x894E1EC2D74FFE5AEF8Dc8A9e84686acCB964F2A" as Address;
+export const ROBINHOOD_QQQ = "0xD5f3879160bc7c32ebb4dC785F8a4F505888de68" as Address;
+export const ROBINHOOD_RGTI = "0x284358abc07F9359f19f4b5b4aC91901Be2597Ba" as Address;
+export const ROBINHOOD_RKLB = "0x3b14C39E89D60D627b42a1A4CA45b5bb45Fc12e2" as Address;
+export const ROBINHOOD_SGOV = "0x92FD66527192E3e61d4DDd13322Aa222DE86F9B5" as Address;
+export const ROBINHOOD_SLV = "0x411eFb0E7f985935DAec3D4C3ebaEa0d0AD7D89f" as Address;
+export const ROBINHOOD_SNDK = "0xB90A19fF0Af67f7779afF50A882A9CfF42446400" as Address;
+export const ROBINHOOD_SPCX = "0x4a0E65A3EcceC6dBe60AE065F2e7bb85Fae35eEa" as Address;
+export const ROBINHOOD_SPY = "0x117cc2133c37B721F49dE2A7a74833232B3B4C0C" as Address;
+export const ROBINHOOD_TSLA = "0x322F0929c4625eD5bAd873c95208D54E1c003b2d" as Address;
+export const ROBINHOOD_TSM = "0x58FfE4a942d3885bAa22D7520691F611EF09e7AA" as Address;
+export const ROBINHOOD_USAR = "0xd917B029C761D264c6A312BBbcDA868658eF86a6" as Address;
+export const ROBINHOOD_USO = "0xa30FA36Db767ad9eD3f7a60fC79526fB4d56D344" as Address;
+
+export type AuctionQuoteId = string;
+
+export type AuctionQuoteOption = {
+  id: AuctionQuoteId;
+  symbol: string;
+  /** Contract address; native ETH is represented by the zero address. */
+  address: Address;
+  decimals: number;
+  /** UI-only: treat quote as $1 when labeling opening FDV. Not an on-chain flag. */
+  /** Human-readable asset name used for search and display. */
+  name: string;
+  usdPeg: boolean;
+};
+
+function rwa(id: AuctionQuoteId, name: string, address: Address): AuctionQuoteOption {
+  return { id, symbol: id, name, address, decimals: 18, usdPeg: false };
+}
+
+/** Supported paired assets for Atomic launches: native ETH, wrapped WETH, USDG, then catalog stocks. */
+export const AUCTION_QUOTE_OPTIONS: AuctionQuoteOption[] = [
+  { id: "ETH", symbol: "ETH", name: "Ether", address: zeroAddress, decimals: 18, usdPeg: false },
+  { id: "WETH", symbol: "WETH", name: "Wrapped Ether", address: ROBINHOOD_WETH, decimals: 18, usdPeg: false },
+  { id: "USDG", symbol: "USDG", name: "Global Dollar", address: ROBINHOOD_USDG, decimals: 6, usdPeg: true },
+  { id: "ABYSS", symbol: "ABYSS", name: "Abyss", address: ROBINHOOD_ABYSS, decimals: 18, usdPeg: false },
+  rwa("AAPL", "Apple", ROBINHOOD_AAPL),
+  rwa("AMD", "Advanced Micro Devices", ROBINHOOD_AMD),
+  rwa("AMZN", "Amazon", ROBINHOOD_AMZN),
+  rwa("ASML", "ASML Holding", ROBINHOOD_ASML),
+  rwa("BABA", "Alibaba", ROBINHOOD_BABA),
+  rwa("CLSK", "CleanSpark", ROBINHOOD_CLSK),
+  rwa("COIN", "Coinbase", ROBINHOOD_COIN),
+  rwa("CRCL", "Circle", ROBINHOOD_CRCL),
+  rwa("CRWV", "CoreWeave", ROBINHOOD_CRWV),
+  rwa("DELL", "Dell", ROBINHOOD_DELL),
+  rwa("EWY", "MSCI South Korea", ROBINHOOD_EWY),
+  rwa("GME", "GameStop", ROBINHOOD_GME),
+  rwa("GOOGL", "Alphabet", ROBINHOOD_GOOGL),
+  rwa("INTC", "Intel", ROBINHOOD_INTC),
+  rwa("IONQ", "IonQ", ROBINHOOD_IONQ),
+  rwa("META", "Meta", ROBINHOOD_META),
+  rwa("MSFT", "Microsoft", ROBINHOOD_MSFT),
+  rwa("MSTR", "Strategy", ROBINHOOD_MSTR),
+  rwa("MU", "Micron", ROBINHOOD_MU),
+  rwa("NBIS", "Nebius", ROBINHOOD_NBIS),
+  rwa("NVDA", "NVIDIA", ROBINHOOD_NVDA),
+  rwa("ORCL", "Oracle", ROBINHOOD_ORCL),
+  rwa("PLTR", "Palantir", ROBINHOOD_PLTR),
+  rwa("QQQ", "Nasdaq-100", ROBINHOOD_QQQ),
+  rwa("RGTI", "Rigetti", ROBINHOOD_RGTI),
+  rwa("RKLB", "Rocket Lab", ROBINHOOD_RKLB),
+  rwa("SGOV", "T-Bills", ROBINHOOD_SGOV),
+  rwa("SLV", "Silver", ROBINHOOD_SLV),
+  rwa("SNDK", "Sandisk", ROBINHOOD_SNDK),
+  rwa("SPCX", "SPACs", ROBINHOOD_SPCX),
+  rwa("SPY", "S&P 500", ROBINHOOD_SPY),
+  rwa("TSLA", "Tesla", ROBINHOOD_TSLA),
+  rwa("TSM", "TSMC", ROBINHOOD_TSM),
+  rwa("USAR", "USA Rare Earth", ROBINHOOD_USAR),
+  rwa("USO", "Oil", ROBINHOOD_USO),
+];
+

package/src/client.ts

@@ -0,0 +1,37 @@
+import {
+  type Account,
+  type Chain,
+  createPublicClient,
+  createWalletClient,
+  type Hex,
+  http,
+  type PublicClient,
+  type Transport,
+  type WalletClient,
+} from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { foundry } from "viem/chains";
+import type { SupportedChainId } from "./addresses.js";
+import { chains } from "./addresses.js";
+
+export function createProtocolPublicClient(opts?: {
+  chainId?: SupportedChainId;
+  rpcUrl?: string;
+}): PublicClient {
+  const chainId = opts?.chainId ?? 31337;
+  const chain = chains[chainId] ?? foundry;
+  const transport = http(opts?.rpcUrl ?? process.env.RPC_URL ?? "http://127.0.0.1:8545");
+  return createPublicClient({ chain, transport });
+}
+
+export function createProtocolWalletClient(opts: {
+  privateKey: Hex;
+  chainId?: SupportedChainId;
+  rpcUrl?: string;
+}): WalletClient {
+  const chainId = opts.chainId ?? 31337;
+  const chain: Chain = chains[chainId] ?? foundry;
+  const transport: Transport = http(opts.rpcUrl ?? process.env.RPC_URL ?? "http://127.0.0.1:8545");
+  const account: Account = privateKeyToAccount(opts.privateKey);
+  return createWalletClient({ account, chain, transport });
+}

package/src/format.ts

@@ -0,0 +1,73 @@
+/** Ray = 1e27 (Aave interest rates). */
+export const RAY = 10n ** 27n;
+export const WAD = 10n ** 18n;
+export const BPS = 10_000n;
+
+export function rayToPercent(ray: bigint, digits = 2): number {
+  if (ray === 0n) return 0;
+  // (ray / 1e27) * 100
+  const scaled = (ray * 10_000n) / RAY; // bps-ish * 100
+  return Number(scaled) / 100 / 100;
+}
+
+/** Convert Aave liquidity/variable borrow rate (ray) to APY % display number. */
+export function rayAprToApyPercent(ray: bigint): number {
+  // Simple APR display (not compounded) — matches most Aave UI rate tooltips at a glance.
+  return Number((ray * 10_000n) / RAY) / 100;
+}
+
+export function formatHealthFactor(hfRayOrWad: bigint): string {
+  if (hfRayOrWad === 0n) return "—";
+  // getUserAccountData returns HF in wad (1e18)
+  const value = Number(hfRayOrWad) / 1e18;
+  if (!Number.isFinite(value) || value > 1e6) return "∞";
+  return value.toFixed(2);
+}
+
+export function healthFactorStatus(hfWad: bigint): "safe" | "watch" | "danger" | "none" {
+  if (hfWad === 0n) return "none";
+  const value = Number(hfWad) / 1e18;
+  if (!Number.isFinite(value) || value > 1e6) return "safe";
+  if (value < 1.05) return "danger";
+  if (value < 1.5) return "watch";
+  return "safe";
+}
+
+/** Parse a decimal health factor ("1.25") to wad. */
+export function parseHealthFactorToWad(raw: string): bigint | undefined {
+  const cleaned = raw.trim();
+  if (!cleaned) return undefined;
+  const n = Number(cleaned);
+  if (!Number.isFinite(n) || n <= 0) return undefined;
+  const [whole, frac = ""] = cleaned.split(".");
+  const fracPadded = (frac + "0".repeat(18)).slice(0, 18);
+  return BigInt(whole || "0") * WAD + BigInt(fracPadded || "0");
+}
+
+export function parseAmountToUnits(amount: string, decimals: number): bigint {
+  const cleaned = amount.trim();
+  if (!cleaned || cleaned === ".") return 0n;
+  const [whole, frac = ""] = cleaned.split(".");
+  const fracPadded = (frac + "0".repeat(decimals)).slice(0, decimals);
+  const wholePart = BigInt(whole || "0") * 10n ** BigInt(decimals);
+  const fracPart = BigInt(fracPadded || "0");
+  return wholePart + fracPart;
+}
+
+export function formatUnitsDisplay(value: bigint, decimals: number, digits = 4): string {
+  if (value === 0n) return "0";
+  const neg = value < 0n;
+  const v = neg ? -value : value;
+  const base = 10n ** BigInt(decimals);
+  const whole = v / base;
+  const frac = v % base;
+  const fracStr = frac.toString().padStart(decimals, "0").slice(0, digits).replace(/0+$/, "");
+  const body = fracStr ? `${whole}.${fracStr}` : whole.toString();
+  return neg ? `-${body}` : body;
+}
+
+export function utilizationFromReserve(availableLiquidity: bigint, totalDebt: bigint): number {
+  const total = availableLiquidity + totalDebt;
+  if (total === 0n) return 0;
+  return Number((totalDebt * 10_000n) / total) / 100;
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+export * from "./abis.js";
+export * from "./abyss.js";
+export * from "./addresses.js";
+export * from "./auction.js";
+export * from "./client.js";
+export * from "./format.js";
+export * from "./launch.js";
+export * from "./live.js";