@continuumdao/ctm-mpc-defi 0.2.56 → 0.2.58

package/dist/protocols/evm/aave-v4/index.d.ts

@@ -52,6 +52,19 @@ type KeyGenSubset = {
 /** App-compatible alias used by multisign builders and Permit2 helpers. */
 type KeyGenSubsetForPermit = KeyGenSubset;
 
+type CoinbaseB20KnownToken = {
+    address: Address;
+    symbol: string;
+    decimals: number;
+    name?: string;
+    iconUrl?: string;
+};
+type CoinbaseB20CatalogToken = CoinbaseB20KnownToken & {
+    name: string;
+};
+/** Live Coinbase list (PYPLc, AMDc, ORCLc, …). Falls back to the seed when the API is down. */
+declare function ensureCoinbaseB20StockCatalog(): Promise<readonly CoinbaseB20CatalogToken[]>;
+
 declare const AAVE_V4_GRAPHQL_URL = "https://api.v4.aave.com/graphql";
 declare function aaveV4Gql<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
 type ChainRowV4 = {
@@ -164,8 +177,31 @@ type AaveV4ChainTokenCache = {
  * Fetches and caches (per process) the list of Aave v4 underlying addresses on a chain and the wrapped native token.
  */
 declare function ensureAaveV4ChainTokenCache(chainId: number): Promise<AaveV4ChainTokenCache>;
-/** UI market segment; maps to Aave v4 `Hub` by name (e.g. Plus ≈ “Main”, Core, Prime ≈ “Bluechip”). */
-type AaveV4UiMarketId = 'main' | 'core' | 'bluechip';
+/**
+ * UI market segment; maps to an Aave v4 hub by name.
+ * Plus ≈ Main, Core, Prime ≈ Bluechip, Coinbase Stocks (Base tokenized equities) ≈ bStocks.
+ */
+type AaveV4UiMarketId = 'main' | 'core' | 'bluechip' | 'bstocks';
+/** Base is the chain where Aave v4 lists the Coinbase Stocks hub. */
+declare const AAVE_V4_BSTOCKS_CHAIN_ID = 8453;
+declare const AAVE_V4_UI_MARKETS: readonly {
+    id: AaveV4UiMarketId;
+    label: string;
+}[];
+/** Coinbase Stocks hub and the names used in governance / the Aave app. */
+declare function isAaveV4BStocksHubName(hubName: string): boolean;
+/**
+ * Parse a UI / MCP market id. Accepts hub aliases (`plus`, `prime`, `stocks`, `equities`).
+ * Returns undefined when the string is empty or not a known segment.
+ */
+declare function parseAaveV4UiMarketId(raw: string | null | undefined): AaveV4UiMarketId | undefined;
+/** Like {@link parseAaveV4UiMarketId}, with a fallback for omitted or unknown values. */
+declare function normalizeAaveV4UiMarketId(raw: unknown, fallback?: AaveV4UiMarketId): AaveV4UiMarketId;
+/**
+ * ERC-20 address, or a Coinbase bStock ticker (`AAPLc`) from the fetched tokenized-stocks catalog.
+ * Native `0x0` is returned checksummed; it is not rewritten to a stock.
+ */
+declare function resolveAaveV4UnderlyingAddress(token: string): Address | null;
 type AaveV4Hub = {
     name: string;
     address: `0x${string}`;
@@ -238,10 +274,16 @@ type AaveV4HubReserve = {
 };
 declare function fetchAaveV4HubsForChain(chainId: number): Promise<readonly AaveV4Hub[]>;
 /**
- * Resolves which Aave v4 hub (Core / Plus / Prime, etc.) a UI “market” refers to.
- * Main → Plus, Core → Core, Bluechip → Prime.
+ * Resolves which Aave v4 hub a UI “market” refers to.
+ * Main → Plus, Core → Core, Bluechip → Prime, bStocks → Coinbase Stocks.
+ * Main does not fall back onto the Coinbase Stocks hub (Base’s only hub is bStocks).
  */
 declare function resolveAaveV4HubForUiMarket(hubs: readonly AaveV4Hub[], market: AaveV4UiMarketId, chainId: number): AaveV4Hub | null;
+/** UI markets that have a hub on this chain. */
+declare function aaveV4UiMarketsForHubs(hubs: readonly AaveV4Hub[], chainId: number): readonly {
+    id: AaveV4UiMarketId;
+    label: string;
+}[];
 /**
  * Inverse of {@link resolveAaveV4HubForUiMarket} label mapping, for switching UI market when a hub is chosen by
  * “first hub on chain that lists this underlying”.
@@ -264,8 +306,11 @@ declare function findAaveV4HubReserveForChainUnderlying(args: {
     chainId: number;
     hubs: readonly AaveV4Hub[];
     underlying: `0x${string}`;
-    /** Tried first; if the asset is not listed here, other hubs on the same chain are scanned. */
-    preferHub: AaveV4Hub;
+    /**
+     * Tried first; if the asset is not listed here, other hubs on the same chain are scanned.
+     * Omit when the selected UI market has no hub on this chain (for example Main on Base).
+     */
+    preferHub?: AaveV4Hub | null;
     /** If set, disambiguate using this debt asset’s `borrowAPY` (and optional liquidity) per hub. */
     debtUnderlying?: `0x${string}` | null;
     /**
@@ -980,6 +1025,7 @@ declare function aaveReadSupplyMetrics(reserve: unknown, symbolForDisplay: strin
     availableLiquidity: string;
 };
 
+declare const AAVE_V4_BSTOCKS_MARKET_NOTES: string;
 type AaveV4MarketSummaryRow = {
     chainId: number;
     hubName: string;
@@ -1037,6 +1083,15 @@ declare function aaveV4FetchMarketSummary(args: {
     markets: AaveV4MarketSummaryRow[];
     notes: string;
 }>;
+/** MCP: Coinbase Stocks hub (bStocks) — same rows as fetch_markets with marketId bstocks. */
+declare function aaveV4FetchStockMarketsSummary(args: {
+    chainId?: number;
+    underlying?: string;
+}): Promise<{
+    chainId: number;
+    markets: AaveV4MarketSummaryRow[];
+    notes: string;
+}>;
 
 declare const MERKL_API_BASE = "https://api.merkl.xyz";
 /**
@@ -1109,4 +1164,4 @@ declare function aaveV4FetchMerklRewardsSummary(args: {
 declare const AAVE_V4_PROTOCOL_ID = "aave-v4";
 declare const aaveV4ProtocolModule: ProtocolModule;
 
-export { AAVE_V4_GRAPHQL_URL, AAVE_V4_PROTOCOL_ID, AAVE_V4_SPOKE_BORROW_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_REPAY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_SUPPLY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_WITHDRAW_DEFAULT_GAS_UNITS, type AaveBorrowInfoLike, type AaveDecimalValueLike, type AavePercentValueLike, type AaveSupplyInfoLike, type AaveV4BorrowTableRow, type AaveV4BorrowableDisplay, type AaveV4ClaimRewardsTx, type AaveV4ExchangeAmount, type AaveV4Hub, type AaveV4HubReserve, type AaveV4HubReserveSummary, type AaveV4MarketSummaryRow, type AaveV4MerklClaimableRewardRow, type AaveV4PositionActionPayload, type AaveV4SpokeLiquidationConfig, type AaveV4SpokeOnChainReserveStatus, type AaveV4UiMarketId, type AaveV4UserPositionDetail, type AaveV4UserPositionRow, type AaveV4UserPositionsByAsset, type AaveV4UserSupplyRow, type AaveV4WithdrawHealthGateResult, MERKL_API_BASE, MERKL_DISTRIBUTOR_ADDRESS, MERKL_DISTRIBUTOR_CLAIM_GAS_FALLBACK, MERKL_REWARDS_NOTES, MIN_AAVE_V4_DEPOSIT_GAS_EXEC, type MerklDistributorClaimLeaf, type MerklRewardRow, type MerklRewardsSummary, type V4ReservesListRow, aaveAvailableLiquidityDisplay, aaveReadSupplyMetrics, aaveUnderlyingAddressForContext, aaveV4BorrowHealthGate, aaveV4FetchMarketSummary, aaveV4FetchMarketsSummary, aaveV4FetchMerklRewardsSummary, aaveV4Gql, aaveV4KeyForNodeAssetRow, aaveV4MarketRowFromHubReserve, aaveV4ProtocolModule, aaveV4RepayHealthGate, aaveV4UiMarketIdForHubName, aaveV4UserHasAvailableBorrowCollateralForContextOnSpoke, aaveV4WithdrawHealthGate, aggregateV4SupplyDisplay, borrowableAssetsFromHubReserves, buildAaveV4BorrowTableRowsFromHub, buildEvmMultisignBodyAaveV4DepositBatch, buildEvmMultisignBodyAaveV4MerklClaimRewards, buildEvmMultisignBodyAaveV4MerklDistributorClaim, buildEvmMultisignBodyAaveV4SpokeBorrow, buildEvmMultisignBodyAaveV4SpokeRepay, buildEvmMultisignBodyAaveV4SpokeWithdraw, buildEvmMultisignBodyEulerV2MerklDistributorClaim, buildEvmMultisignBodyEulerV2ReulUnlock, encodeMerklDistributorClaimData, ensureAaveV4ChainTokenCache, fetchAaveV4Chains, fetchAaveV4ClaimRewardsCalldata, fetchAaveV4HubReserves, fetchAaveV4HubsForChain, fetchAaveV4MerklClaimRewardIdsForChain, fetchAaveV4MerklClaimableRewardsForChain, fetchAaveV4NativeWrappedToken, fetchAaveV4ReservesForUnderlying, fetchAaveV4SpokeReserveIdForUnderlying, fetchAaveV4SpokeReserveStatusForUnderlying, fetchAaveV4SupportedUnderlyingAddressSet, fetchAaveV4UserBorrowsDebtByUnderlyingForHub, fetchAaveV4UserPositionById, fetchAaveV4UserPositionsByAssetOnChain, fetchAaveV4UserPositionsForChain, fetchAaveV4UserSuppliesForPosition, fetchAllMerklDistributorClaimLeaves, fetchMerklRewardsSummary, filterActiveAaveV4HubReserves, findAaveV4HubReserveForChainUnderlying, findHubReserveForUnderlying, formatAavePercentDisplay, formatAaveV4AmountHumanFromApiString, formatAaveV4ApyPercentLabel, formatAaveV4DecimalString, formatAaveV4ExchangeLabel, formatAaveV4HealthFactor, formatAaveV4PercentDisplay, formatAaveV4PositionHealthFactor, formatAaveV4PositionPercent, formatAaveV4ReserveLiquidityFromSummary, formatAaveV4RiskDisplay, formatAaveV4RiskNotionalString, formatAaveV4TokenAmount, isAaveV4DepositEvmSignRequest, isAaveV4HubReserveActive, isMerklRewardEulLeaf, isValidAaveChainId, loadAaveV4SupportedChainIds, loadAaveV4SupportedChainIdsFromV4Api, loadMerklUserRewardsJson, merklLeafToRow, merklUserRewardsUrl, parseAaveV4ApyPercent, parseBigDecimalHf, parseMerklUserRewardsToLeaves, pickAaveV4ReserveRowForSpoke, previewAaveV4BorrowResultingHf, previewAaveV4RepayResultingHf, previewAaveV4WithdrawResultingHf, resolveAaveV4DepositGasUnitsFromSignRequest, resolveAaveV4HubForUiMarket, selectFirstRootMerklLeaves, selectWalletWideMerklClaimLeaves };
+export { AAVE_V4_BSTOCKS_CHAIN_ID, AAVE_V4_BSTOCKS_MARKET_NOTES, AAVE_V4_GRAPHQL_URL, AAVE_V4_PROTOCOL_ID, AAVE_V4_SPOKE_BORROW_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_REPAY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_SUPPLY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_WITHDRAW_DEFAULT_GAS_UNITS, AAVE_V4_UI_MARKETS, type AaveBorrowInfoLike, type AaveDecimalValueLike, type AavePercentValueLike, type AaveSupplyInfoLike, type AaveV4BorrowTableRow, type AaveV4BorrowableDisplay, type AaveV4ClaimRewardsTx, type AaveV4ExchangeAmount, type AaveV4Hub, type AaveV4HubReserve, type AaveV4HubReserveSummary, type AaveV4MarketSummaryRow, type AaveV4MerklClaimableRewardRow, type AaveV4PositionActionPayload, type AaveV4SpokeLiquidationConfig, type AaveV4SpokeOnChainReserveStatus, type AaveV4UiMarketId, type AaveV4UserPositionDetail, type AaveV4UserPositionRow, type AaveV4UserPositionsByAsset, type AaveV4UserSupplyRow, type AaveV4WithdrawHealthGateResult, MERKL_API_BASE, MERKL_DISTRIBUTOR_ADDRESS, MERKL_DISTRIBUTOR_CLAIM_GAS_FALLBACK, MERKL_REWARDS_NOTES, MIN_AAVE_V4_DEPOSIT_GAS_EXEC, type MerklDistributorClaimLeaf, type MerklRewardRow, type MerklRewardsSummary, type V4ReservesListRow, aaveAvailableLiquidityDisplay, aaveReadSupplyMetrics, aaveUnderlyingAddressForContext, aaveV4BorrowHealthGate, aaveV4FetchMarketSummary, aaveV4FetchMarketsSummary, aaveV4FetchMerklRewardsSummary, aaveV4FetchStockMarketsSummary, aaveV4Gql, aaveV4KeyForNodeAssetRow, aaveV4MarketRowFromHubReserve, aaveV4ProtocolModule, aaveV4RepayHealthGate, aaveV4UiMarketIdForHubName, aaveV4UiMarketsForHubs, aaveV4UserHasAvailableBorrowCollateralForContextOnSpoke, aaveV4WithdrawHealthGate, aggregateV4SupplyDisplay, borrowableAssetsFromHubReserves, buildAaveV4BorrowTableRowsFromHub, buildEvmMultisignBodyAaveV4DepositBatch, buildEvmMultisignBodyAaveV4MerklClaimRewards, buildEvmMultisignBodyAaveV4MerklDistributorClaim, buildEvmMultisignBodyAaveV4SpokeBorrow, buildEvmMultisignBodyAaveV4SpokeRepay, buildEvmMultisignBodyAaveV4SpokeWithdraw, buildEvmMultisignBodyEulerV2MerklDistributorClaim, buildEvmMultisignBodyEulerV2ReulUnlock, encodeMerklDistributorClaimData, ensureAaveV4ChainTokenCache, ensureCoinbaseB20StockCatalog, fetchAaveV4Chains, fetchAaveV4ClaimRewardsCalldata, fetchAaveV4HubReserves, fetchAaveV4HubsForChain, fetchAaveV4MerklClaimRewardIdsForChain, fetchAaveV4MerklClaimableRewardsForChain, fetchAaveV4NativeWrappedToken, fetchAaveV4ReservesForUnderlying, fetchAaveV4SpokeReserveIdForUnderlying, fetchAaveV4SpokeReserveStatusForUnderlying, fetchAaveV4SupportedUnderlyingAddressSet, fetchAaveV4UserBorrowsDebtByUnderlyingForHub, fetchAaveV4UserPositionById, fetchAaveV4UserPositionsByAssetOnChain, fetchAaveV4UserPositionsForChain, fetchAaveV4UserSuppliesForPosition, fetchAllMerklDistributorClaimLeaves, fetchMerklRewardsSummary, filterActiveAaveV4HubReserves, findAaveV4HubReserveForChainUnderlying, findHubReserveForUnderlying, formatAavePercentDisplay, formatAaveV4AmountHumanFromApiString, formatAaveV4ApyPercentLabel, formatAaveV4DecimalString, formatAaveV4ExchangeLabel, formatAaveV4HealthFactor, formatAaveV4PercentDisplay, formatAaveV4PositionHealthFactor, formatAaveV4PositionPercent, formatAaveV4ReserveLiquidityFromSummary, formatAaveV4RiskDisplay, formatAaveV4RiskNotionalString, formatAaveV4TokenAmount, isAaveV4BStocksHubName, isAaveV4DepositEvmSignRequest, isAaveV4HubReserveActive, isMerklRewardEulLeaf, isValidAaveChainId, loadAaveV4SupportedChainIds, loadAaveV4SupportedChainIdsFromV4Api, loadMerklUserRewardsJson, merklLeafToRow, merklUserRewardsUrl, normalizeAaveV4UiMarketId, parseAaveV4ApyPercent, parseAaveV4UiMarketId, parseBigDecimalHf, parseMerklUserRewardsToLeaves, pickAaveV4ReserveRowForSpoke, previewAaveV4BorrowResultingHf, previewAaveV4RepayResultingHf, previewAaveV4WithdrawResultingHf, resolveAaveV4DepositGasUnitsFromSignRequest, resolveAaveV4HubForUiMarket, resolveAaveV4UnderlyingAddress, selectFirstRootMerklLeaves, selectWalletWideMerklClaimLeaves };

package/dist/protocols/evm/aave-v4/index.js

@@ -23,6 +23,106 @@ async function postJsonViaOptionalProxy(args) {
   }
   return await r.json();
 }
+var COINBASE_B20_STOCK_DECIMALS = 8;
+var COINBASE_B20_ASSET_PREFIX = "0xb200000000000000000000";
+function isCoinbaseB20AssetToken(address) {
+  try {
+    return getAddress(address).toLowerCase().startsWith(COINBASE_B20_ASSET_PREFIX);
+  } catch {
+    return false;
+  }
+}
+function looksLikeCoinbaseStockSymbol(symbol) {
+  return /^[A-Za-z][A-Za-z0-9]{0,8}(?:\.[A-Za-z][A-Za-z0-9]{0,4})?c$/.test((symbol ?? "").trim());
+}
+var COINBASE_TOKENIZED_STOCKS_API_URL = "https://api.coinbase.com/v1/tokenized-stocks";
+var CATALOG_TTL_MS = 15 * 60 * 1e3;
+var CATALOG_MAX = 500;
+var catalogRows = null;
+var catalogAt = 0;
+var catalogInflight = null;
+var catalogBySymbol = /* @__PURE__ */ new Map();
+var catalogByAddress = /* @__PURE__ */ new Map();
+function indexCatalog(rows) {
+  catalogRows = rows;
+  catalogAt = Date.now();
+  catalogBySymbol.clear();
+  catalogByAddress.clear();
+  for (const row of rows) {
+    catalogBySymbol.set(row.symbol.toLowerCase(), row);
+    catalogByAddress.set(row.address.toLowerCase(), row);
+  }
+}
+function parseCoinbaseTokenizedStocksPayload(payload) {
+  const tokens = Array.isArray(payload) ? payload : payload && typeof payload === "object" && Array.isArray(payload.tokens) ? payload.tokens : [];
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const row of tokens) {
+    if (!row || typeof row !== "object") continue;
+    const rec = row;
+    const symbol = typeof rec.symbol === "string" ? rec.symbol.trim() : "";
+    const addressRaw = typeof rec.contract_address === "string" ? rec.contract_address.trim() : "";
+    if (!looksLikeCoinbaseStockSymbol(symbol) || !isCoinbaseB20AssetToken(addressRaw)) continue;
+    const address = getAddress(addressRaw);
+    const key = address.toLowerCase();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    const name = typeof rec.name === "string" && rec.name.trim() ? rec.name.trim() : symbol;
+    const iconUrl = typeof rec.icon_url === "string" && rec.icon_url.trim() ? rec.icon_url.trim() : void 0;
+    const decimals = typeof rec.decimals === "number" && Number.isInteger(rec.decimals) && rec.decimals >= 0 && rec.decimals <= 18 ? rec.decimals : COINBASE_B20_STOCK_DECIMALS;
+    out.push({ address, symbol, name, decimals, iconUrl });
+    if (out.length >= CATALOG_MAX) break;
+  }
+  return out;
+}
+async function fetchCoinbaseB20StockCatalog() {
+  const merged = [];
+  const seen = /* @__PURE__ */ new Set();
+  let pageToken = "";
+  for (let page = 0; page < 4; page++) {
+    const url = new URL(COINBASE_TOKENIZED_STOCKS_API_URL);
+    url.searchParams.set("page_size", "500");
+    if (pageToken) url.searchParams.set("page_token", pageToken);
+    const res = await fetch(url, { cache: "no-store", signal: AbortSignal.timeout(8e3) });
+    if (!res.ok) break;
+    const json = await res.json();
+    for (const row of parseCoinbaseTokenizedStocksPayload(json)) {
+      const key = row.address.toLowerCase();
+      if (seen.has(key)) continue;
+      seen.add(key);
+      merged.push(row);
+      if (merged.length >= CATALOG_MAX) break;
+    }
+    pageToken = typeof json.next_page_token === "string" ? json.next_page_token.trim() : "";
+    if (!pageToken || merged.length >= CATALOG_MAX) break;
+  }
+  if (merged.length > 0) indexCatalog(merged);
+  return catalogRows ?? [];
+}
+async function ensureCoinbaseB20StockCatalog() {
+  if (catalogRows && catalogRows.length > 0 && Date.now() - catalogAt < CATALOG_TTL_MS) return catalogRows;
+  if (!catalogInflight) {
+    catalogInflight = fetchCoinbaseB20StockCatalog().finally(() => {
+      catalogInflight = null;
+    });
+  }
+  try {
+    return await catalogInflight;
+  } catch {
+    return catalogRows ?? [];
+  }
+}
+function lookupCoinbaseB20StockToken(token) {
+  const key = (token ?? "").trim();
+  if (!key) return null;
+  const fromCatalog = catalogBySymbol.get(key.toLowerCase());
+  if (fromCatalog) return fromCatalog;
+  try {
+    return catalogByAddress.get(getAddress(key).toLowerCase()) ?? null;
+  } catch {
+    return null;
+  }
+}
 
 // src/protocols/evm/aave-v4/api.ts
 var AAVE_V4_GRAPHQL_URL = "https://api.v4.aave.com/graphql";
@@ -264,6 +364,42 @@ function ensureAaveV4ChainTokenCache(chainId) {
   aaveV4ChainTokenCache.set(chainId, p);
   return p;
 }
+var AAVE_V4_BSTOCKS_CHAIN_ID = 8453;
+var AAVE_V4_UI_MARKETS = [
+  { id: "main", label: "Main" },
+  { id: "core", label: "Core" },
+  { id: "bluechip", label: "Bluechip" },
+  { id: "bstocks", label: "bStocks" }
+];
+function isAaveV4BStocksHubName(hubName) {
+  const n = (hubName ?? "").trim().toLowerCase().replace(/\s+/g, " ");
+  if (!n) return false;
+  if (n === "coinbase stocks" || n === "coinbase stocks hub" || n === "equities" || n === "equities hub" || n === "tokenised stocks" || n === "tokenized stocks" || n === "base stocks" || n === "bstocks" || n === "b stocks" || n === "mag-7" || n === "mag7") {
+    return true;
+  }
+  return n.includes("coinbase") && n.includes("stock");
+}
+function parseAaveV4UiMarketId(raw) {
+  const t = (raw ?? "").trim().toLowerCase().replace(/\s+/g, " ");
+  if (!t) return void 0;
+  if (t === "core") return "core";
+  if (t === "bluechip" || t === "prime" || t === "institutional") return "bluechip";
+  if (t === "main" || t === "plus" || t === "default") return "main";
+  if (t === "bstocks" || t === "bstock" || t === "b stocks" || t === "stocks" || t === "stock" || t === "equities" || t === "equity" || t === "coinbase stocks" || t === "tokenized stocks" || t === "tokenised stocks") {
+    return "bstocks";
+  }
+  return void 0;
+}
+function normalizeAaveV4UiMarketId(raw, fallback = "main") {
+  if (typeof raw !== "string") return fallback;
+  return parseAaveV4UiMarketId(raw) ?? fallback;
+}
+function resolveAaveV4UnderlyingAddress(token) {
+  const raw = (token ?? "").trim();
+  if (!raw) return null;
+  if (isAddress(raw)) return getAddress(raw);
+  return lookupCoinbaseB20StockToken(raw)?.address ?? null;
+}
 var aaveV4HubsByChain = /* @__PURE__ */ new Map();
 var aaveV4HubReserves = /* @__PURE__ */ new Map();
 function hubReservesKey(chainId, hub) {
@@ -294,12 +430,22 @@ function resolveAaveV4HubForUiMarket(hubs, market, chainId) {
     const set = new Set(names.map((n) => n.toLowerCase()));
     return on.find((h) => set.has((h.name ?? "").trim().toLowerCase())) ?? null;
   };
+  if (market === "bstocks") return on.find((h) => isAaveV4BStocksHubName(h.name)) ?? null;
   if (market === "core") return find(["core"]);
   if (market === "bluechip") return find(["prime", "bluechip", "institutional"]);
-  return find(["plus", "main", "default"]) ?? on[0] ?? null;
+  const named = find(["plus", "main", "default"]);
+  if (named) return named;
+  return on.find((h) => !isAaveV4BStocksHubName(h.name)) ?? null;
+}
+function aaveV4UiMarketsForHubs(hubs, chainId) {
+  const available = AAVE_V4_UI_MARKETS.filter(
+    (m) => resolveAaveV4HubForUiMarket(hubs, m.id, chainId) != null
+  );
+  return available.length ? available : AAVE_V4_UI_MARKETS;
 }
 function aaveV4UiMarketIdForHubName(hubName) {
   const n = (hubName ?? "").trim().toLowerCase();
+  if (isAaveV4BStocksHubName(hubName)) return "bstocks";
   if (n === "core") return "core";
   if (n === "plus" || n === "main" || n === "default") return "main";
   if (n === "prime" || n === "bluechip" || n === "institutional") return "bluechip";
@@ -311,6 +457,7 @@ function aaveV4HubAutoPickTiebreakOrder(a, b) {
     if (n === "core") return 0;
     if (n === "plus" || n === "main" || n === "default") return 1;
     if (n === "prime" || n === "bluechip" || n === "institutional") return 2;
+    if (isAaveV4BStocksHubName(name)) return 4;
     return 3;
   };
   const ra = rank(a.name);
@@ -337,9 +484,10 @@ function aaveV4SuppliableHumanFromHubReserve(r) {
 async function findAaveV4HubReserveForChainUnderlying(args) {
   const onChain = args.hubs.filter((h) => h.chain.chainId === args.chainId);
   if (!onChain.length) return null;
-  const prefer = getAddress(args.preferHub.address);
+  const prefer = args.preferHub ? getAddress(args.preferHub.address) : null;
   const order = (() => {
-    const rest = onChain.filter((h) => getAddress(h.address) !== prefer).sort(aaveV4HubAutoPickTiebreakOrder);
+    const rest = onChain.filter((h) => !prefer || getAddress(h.address) !== prefer).sort(aaveV4HubAutoPickTiebreakOrder);
+    if (!prefer) return rest;
     const first = onChain.find((h) => getAddress(h.address) === prefer);
     return first ? [first, ...rest] : rest;
   })();
@@ -370,8 +518,8 @@ async function findAaveV4HubReserveForChainUnderlying(args) {
   const sortKey = (a, b) => {
     const d = aaveV4HubReserveBorrowApyForSort(a.debtReserve) - aaveV4HubReserveBorrowApyForSort(b.debtReserve);
     if (d !== 0) return d;
-    const pa = getAddress(a.hub.address) === prefer ? 0 : 1;
-    const pb = getAddress(b.hub.address) === prefer ? 0 : 1;
+    const pa = prefer && getAddress(a.hub.address) === prefer ? 0 : 1;
+    const pb = prefer && getAddress(b.hub.address) === prefer ? 0 : 1;
     if (pa !== pb) return pa - pb;
     return aaveV4HubAutoPickTiebreakOrder(a.hub, b.hub);
   };
@@ -2429,6 +2577,7 @@ function matchesAssetFilter(opts) {
 }
 
 // src/protocols/evm/aave-v4/reads.ts
+var AAVE_V4_BSTOCKS_MARKET_NOTES = "Coinbase tokenized stocks (bStocks) on the Aave v4 Coinbase Stocks hub (Base, chainId 8453). AAPLc, AMZNc, GOOGLc, METAc, MSFTc, NVDAc, and TSLAc are collateral-only. USDC is the only borrow asset. marketId is bstocks. Tickers resolve (AAPLc). Chainlink equity feeds are 24/5 (last price held on weekends and US market holidays). Not for U.S. persons. Equity supply APY is typically 0; incentives may appear via Merkl.";
 function parseAaveV4ApyPercent(apy) {
   const n = parseFloat((apy?.normalized ?? "").trim());
   if (Number.isFinite(n) && n >= 0) return n;
@@ -2508,10 +2657,21 @@ function isAaveV4HubReserveActive(reserve) {
 function filterActiveAaveV4HubReserves(reserves) {
   return reserves.filter(isAaveV4HubReserveActive);
 }
-function parseUiMarketId(raw) {
-  const t = (raw ?? "").trim().toLowerCase();
-  if (t === "main" || t === "core" || t === "bluechip") return t;
-  return void 0;
+function isAaveV4StockListQuery(filter) {
+  return /^(stocks?|bstocks?|b stocks|tokenized stocks|tokenised stocks|coinbase stocks|equities)$/.test(
+    filter.trim().toLowerCase()
+  );
+}
+function rowMatchesUnderlyingFilter(row, filter) {
+  if (isAaveV4StockListQuery(filter)) return isCoinbaseB20AssetToken(row.underlying);
+  if (matchesAssetFilter({ address: row.underlying, symbol: row.symbol, filter })) return true;
+  const stock = lookupCoinbaseB20StockToken(filter);
+  if (!stock) return false;
+  try {
+    return getAddress(row.underlying) === stock.address;
+  } catch {
+    return false;
+  }
 }
 async function collectHubMarketRows(args) {
   const markets = [];
@@ -2530,6 +2690,7 @@ async function collectHubMarketRows(args) {
   return markets;
 }
 async function aaveV4FetchMarketsSummary(args) {
+  await ensureCoinbaseB20StockCatalog().catch(() => []);
   const hubs = await fetchAaveV4HubsForChain(args.chainId);
   if (!hubs.length) {
     return {
@@ -2538,7 +2699,7 @@ async function aaveV4FetchMarketsSummary(args) {
       notes: `Aave v4 lists no hubs on chain ${args.chainId}. Check get_defi_protocol_supported_chains.`
     };
   }
-  const wantMarket = parseUiMarketId(args.marketId);
+  const wantMarket = parseAaveV4UiMarketId(args.marketId);
   let selected = hubs;
   let marketNote = "";
   if (wantMarket) {
@@ -2553,18 +2714,16 @@ async function aaveV4FetchMarketsSummary(args) {
   let markets = await collectHubMarketRows({ chainId: args.chainId, hubs: selected });
   const rawUnderlying = (args.underlying ?? "").trim();
   if (rawUnderlying) {
-    markets = markets.filter(
-      (m) => matchesAssetFilter({ address: m.underlying, symbol: m.symbol, filter: rawUnderlying })
-    );
+    markets = markets.filter((m) => rowMatchesUnderlyingFilter(m, rawUnderlying));
   }
   markets.sort(sortBySupplyApyDesc);
-  const notes = "Supply/borrow APY from Aave v4 GraphQL (api.v4.aave.com). These are APY (compounded), not APR. Each live spoke is a row (unused zero-liquidity listings omitted). Copy underlying + marketId for build_*_multisign. Do not web-search Aave rates." + marketNote;
+  const notes = "Supply/borrow APY from Aave v4 GraphQL (api.v4.aave.com). These are APY (compounded), not APR. Each live spoke is a row (unused zero-liquidity listings omitted). Copy underlying + marketId for build_*_multisign. marketId bstocks is the Base Coinbase Stocks hub (tokenized equities as collateral, USDC borrow). Tickers such as AAPLc resolve. Do not web-search Aave rates." + marketNote;
   return { chainId: args.chainId, markets, notes };
 }
 async function aaveV4FetchMarketSummary(args) {
   const addr = (args.underlying ?? "").trim();
   if (!addr) {
-    throw new Error("underlying is required (ERC-20 address or ticker such as USDT).");
+    throw new Error("underlying is required (ERC-20 address or ticker such as USDT or AAPLc).");
   }
   const out = await aaveV4FetchMarketsSummary({
     chainId: args.chainId,
@@ -2579,6 +2738,20 @@ async function aaveV4FetchMarketSummary(args) {
   }
   return out;
 }
+async function aaveV4FetchStockMarketsSummary(args) {
+  const chainId = args.chainId ?? AAVE_V4_BSTOCKS_CHAIN_ID;
+  const out = await aaveV4FetchMarketsSummary({
+    chainId,
+    marketId: "bstocks",
+    underlying: args.underlying
+  });
+  const extra = out.markets.length ? "" : " No Coinbase Stocks hub reserves matched.";
+  return {
+    chainId: out.chainId,
+    markets: out.markets,
+    notes: `${AAVE_V4_BSTOCKS_MARKET_NOTES}${extra} ${out.notes}`
+  };
+}
 var MERKL_API_BASE = "https://api.merkl.xyz";
 var MERKL_DISTRIBUTOR_ADDRESS = "0x3Ef3D8bA38EBe18DB133cEc108f4D14CE00Dd9Ae";
 var MERKL_DISTRIBUTOR_CLAIM_GAS_FALLBACK = 500000n;
@@ -2754,6 +2927,6 @@ var aaveV4ProtocolModule = {
 };
 registerProtocolModule(aaveV4ProtocolModule);
 
-export { AAVE_V4_GRAPHQL_URL, AAVE_V4_PROTOCOL_ID, AAVE_V4_SPOKE_BORROW_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_REPAY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_SUPPLY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_WITHDRAW_DEFAULT_GAS_UNITS, MERKL_API_BASE, MERKL_DISTRIBUTOR_ADDRESS, MERKL_DISTRIBUTOR_CLAIM_GAS_FALLBACK, MERKL_REWARDS_NOTES, MIN_AAVE_V4_DEPOSIT_GAS_EXEC, aaveAvailableLiquidityDisplay, aaveReadSupplyMetrics, aaveUnderlyingAddressForContext, aaveV4BorrowHealthGate, aaveV4FetchMarketSummary, aaveV4FetchMarketsSummary, aaveV4FetchMerklRewardsSummary, aaveV4Gql, aaveV4KeyForNodeAssetRow, aaveV4MarketRowFromHubReserve, aaveV4ProtocolModule, aaveV4RepayHealthGate, aaveV4UiMarketIdForHubName, aaveV4UserHasAvailableBorrowCollateralForContextOnSpoke, aaveV4WithdrawHealthGate, aggregateV4SupplyDisplay, borrowableAssetsFromHubReserves, buildAaveV4BorrowTableRowsFromHub, buildEvmMultisignBodyAaveV4DepositBatch, buildEvmMultisignBodyAaveV4MerklClaimRewards, buildEvmMultisignBodyAaveV4MerklDistributorClaim, buildEvmMultisignBodyAaveV4SpokeBorrow, buildEvmMultisignBodyAaveV4SpokeRepay, buildEvmMultisignBodyAaveV4SpokeWithdraw, buildEvmMultisignBodyEulerV2MerklDistributorClaim, buildEvmMultisignBodyEulerV2ReulUnlock, encodeMerklDistributorClaimData, ensureAaveV4ChainTokenCache, fetchAaveV4Chains, fetchAaveV4ClaimRewardsCalldata, fetchAaveV4HubReserves, fetchAaveV4HubsForChain, fetchAaveV4MerklClaimRewardIdsForChain, fetchAaveV4MerklClaimableRewardsForChain, fetchAaveV4NativeWrappedToken, fetchAaveV4ReservesForUnderlying, fetchAaveV4SpokeReserveIdForUnderlying, fetchAaveV4SpokeReserveStatusForUnderlying, fetchAaveV4SupportedUnderlyingAddressSet, fetchAaveV4UserBorrowsDebtByUnderlyingForHub, fetchAaveV4UserPositionById, fetchAaveV4UserPositionsByAssetOnChain, fetchAaveV4UserPositionsForChain, fetchAaveV4UserSuppliesForPosition, fetchAllMerklDistributorClaimLeaves, fetchMerklRewardsSummary, filterActiveAaveV4HubReserves, findAaveV4HubReserveForChainUnderlying, findHubReserveForUnderlying, formatAavePercentDisplay, formatAaveV4AmountHumanFromApiString, formatAaveV4ApyPercentLabel, formatAaveV4DecimalString, formatAaveV4ExchangeLabel, formatAaveV4HealthFactor, formatAaveV4PercentDisplay, formatAaveV4PositionHealthFactor, formatAaveV4PositionPercent, formatAaveV4ReserveLiquidityFromSummary, formatAaveV4RiskDisplay, formatAaveV4RiskNotionalString, formatAaveV4TokenAmount, isAaveV4DepositEvmSignRequest, isAaveV4HubReserveActive, isMerklRewardEulLeaf, isValidAaveChainId, loadAaveV4SupportedChainIds, loadAaveV4SupportedChainIdsFromV4Api, loadMerklUserRewardsJson, merklLeafToRow, merklUserRewardsUrl, parseAaveV4ApyPercent, parseBigDecimalHf, parseMerklUserRewardsToLeaves, pickAaveV4ReserveRowForSpoke, previewAaveV4BorrowResultingHf, previewAaveV4RepayResultingHf, previewAaveV4WithdrawResultingHf, resolveAaveV4DepositGasUnitsFromSignRequest, resolveAaveV4HubForUiMarket, selectFirstRootMerklLeaves, selectWalletWideMerklClaimLeaves };
+export { AAVE_V4_BSTOCKS_CHAIN_ID, AAVE_V4_BSTOCKS_MARKET_NOTES, AAVE_V4_GRAPHQL_URL, AAVE_V4_PROTOCOL_ID, AAVE_V4_SPOKE_BORROW_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_REPAY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_SUPPLY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_WITHDRAW_DEFAULT_GAS_UNITS, AAVE_V4_UI_MARKETS, MERKL_API_BASE, MERKL_DISTRIBUTOR_ADDRESS, MERKL_DISTRIBUTOR_CLAIM_GAS_FALLBACK, MERKL_REWARDS_NOTES, MIN_AAVE_V4_DEPOSIT_GAS_EXEC, aaveAvailableLiquidityDisplay, aaveReadSupplyMetrics, aaveUnderlyingAddressForContext, aaveV4BorrowHealthGate, aaveV4FetchMarketSummary, aaveV4FetchMarketsSummary, aaveV4FetchMerklRewardsSummary, aaveV4FetchStockMarketsSummary, aaveV4Gql, aaveV4KeyForNodeAssetRow, aaveV4MarketRowFromHubReserve, aaveV4ProtocolModule, aaveV4RepayHealthGate, aaveV4UiMarketIdForHubName, aaveV4UiMarketsForHubs, aaveV4UserHasAvailableBorrowCollateralForContextOnSpoke, aaveV4WithdrawHealthGate, aggregateV4SupplyDisplay, borrowableAssetsFromHubReserves, buildAaveV4BorrowTableRowsFromHub, buildEvmMultisignBodyAaveV4DepositBatch, buildEvmMultisignBodyAaveV4MerklClaimRewards, buildEvmMultisignBodyAaveV4MerklDistributorClaim, buildEvmMultisignBodyAaveV4SpokeBorrow, buildEvmMultisignBodyAaveV4SpokeRepay, buildEvmMultisignBodyAaveV4SpokeWithdraw, buildEvmMultisignBodyEulerV2MerklDistributorClaim, buildEvmMultisignBodyEulerV2ReulUnlock, encodeMerklDistributorClaimData, ensureAaveV4ChainTokenCache, ensureCoinbaseB20StockCatalog, fetchAaveV4Chains, fetchAaveV4ClaimRewardsCalldata, fetchAaveV4HubReserves, fetchAaveV4HubsForChain, fetchAaveV4MerklClaimRewardIdsForChain, fetchAaveV4MerklClaimableRewardsForChain, fetchAaveV4NativeWrappedToken, fetchAaveV4ReservesForUnderlying, fetchAaveV4SpokeReserveIdForUnderlying, fetchAaveV4SpokeReserveStatusForUnderlying, fetchAaveV4SupportedUnderlyingAddressSet, fetchAaveV4UserBorrowsDebtByUnderlyingForHub, fetchAaveV4UserPositionById, fetchAaveV4UserPositionsByAssetOnChain, fetchAaveV4UserPositionsForChain, fetchAaveV4UserSuppliesForPosition, fetchAllMerklDistributorClaimLeaves, fetchMerklRewardsSummary, filterActiveAaveV4HubReserves, findAaveV4HubReserveForChainUnderlying, findHubReserveForUnderlying, formatAavePercentDisplay, formatAaveV4AmountHumanFromApiString, formatAaveV4ApyPercentLabel, formatAaveV4DecimalString, formatAaveV4ExchangeLabel, formatAaveV4HealthFactor, formatAaveV4PercentDisplay, formatAaveV4PositionHealthFactor, formatAaveV4PositionPercent, formatAaveV4ReserveLiquidityFromSummary, formatAaveV4RiskDisplay, formatAaveV4RiskNotionalString, formatAaveV4TokenAmount, isAaveV4BStocksHubName, isAaveV4DepositEvmSignRequest, isAaveV4HubReserveActive, isMerklRewardEulLeaf, isValidAaveChainId, loadAaveV4SupportedChainIds, loadAaveV4SupportedChainIdsFromV4Api, loadMerklUserRewardsJson, merklLeafToRow, merklUserRewardsUrl, normalizeAaveV4UiMarketId, parseAaveV4ApyPercent, parseAaveV4UiMarketId, parseBigDecimalHf, parseMerklUserRewardsToLeaves, pickAaveV4ReserveRowForSpoke, previewAaveV4BorrowResultingHf, previewAaveV4RepayResultingHf, previewAaveV4WithdrawResultingHf, resolveAaveV4DepositGasUnitsFromSignRequest, resolveAaveV4HubForUiMarket, resolveAaveV4UnderlyingAddress, selectFirstRootMerklLeaves, selectWalletWideMerklClaimLeaves };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map