@oracle-agent/oracle 0.11.0 → 0.13.0

package/src/data/providers/nft-gallery.mjs

@@ -1,163 +0,0 @@
-// Raster-only NFT contact sheets returned as SVG image content.
-
-import { timed } from "../http.mjs";
-
-const ALLOWED_IMAGE_HOSTS = Object.freeze([
-  "i.seadn.io",
-  "openseauserdata.com",
-  "arweave.net",
-  "ipfs.io",
-  "nftstorage.link",
-  "dweb.link",
-  "cloudflare-ipfs.com",
-  "ordinals.com",
-  "ordinals.g.com",
-  "cdn.helius-rpc.com",
-  "shdw-drive.genesysgo.net",
-]);
-
-const RASTER_MIME = new Set(["image/jpeg", "image/png", "image/webp"]);
-
-function allowedHost(hostname) {
-  const host = String(hostname || "").toLowerCase();
-  return ALLOWED_IMAGE_HOSTS.some((allowed) => host === allowed || host.endsWith(`.${allowed}`));
-}
-
-function gatewayUrl(value) {
-  const text = String(value || "").trim();
-  if (text.startsWith("ipfs://")) return `https://ipfs.io/ipfs/${text.slice(7).replace(/^ipfs\//, "")}`;
-  if (text.startsWith("ar://")) return `https://arweave.net/${text.slice(5)}`;
-  return text;
-}
-
-function safeImageUrl(value) {
-  const text = gatewayUrl(value);
-  let url;
-  try {
-    url = new URL(text);
-  } catch {
-    return null;
-  }
-  if (url.protocol !== "https:" || url.username || url.password || !allowedHost(url.hostname)) return null;
-  return url;
-}
-
-async function fetchRaster(value, opts = {}) {
-  const fetchImpl = opts.fetchImpl || globalThis.fetch;
-  if (typeof fetchImpl !== "function") throw new Error("gallery fetch unavailable");
-  let url = safeImageUrl(value);
-  if (!url) throw new Error("image host is not on the raster gallery allowlist");
-  const maxBytes = Math.min(Math.max(Number(opts.maxImageBytes ?? 1_500_000), 50_000), 4_000_000);
-
-  for (let redirect = 0; redirect <= 3; redirect += 1) {
-    const attempt = await timed(() => fetchImpl(url.toString(), {
-      method: "GET",
-      redirect: "manual",
-      headers: { accept: "image/jpeg,image/png,image/webp" },
-      signal: AbortSignal.timeout(opts.timeoutMs ?? 12_000),
-    }));
-    if (!attempt.ok) throw new Error(attempt.error);
-    const response = attempt.data;
-    if (response.status >= 300 && response.status < 400) {
-      const location = response.headers?.get?.("location");
-      if (!location) throw new Error("image redirect missing location");
-      const next = safeImageUrl(new URL(location, url).toString());
-      if (!next) throw new Error("image redirect left the host allowlist");
-      url = next;
-      continue;
-    }
-    if (!response.ok) throw new Error(`image HTTP ${response.status}`);
-    const mimeType = String(response.headers?.get?.("content-type") || "").split(";", 1)[0].toLowerCase();
-    if (!RASTER_MIME.has(mimeType)) throw new Error(`unsafe or unsupported image type ${mimeType || "unknown"}`);
-    const length = Number(response.headers?.get?.("content-length") || 0);
-    if (length > maxBytes) throw new Error("image exceeds gallery byte cap");
-    const bytes = Buffer.from(await response.arrayBuffer());
-    if (!bytes.length || bytes.length > maxBytes) throw new Error("image exceeds gallery byte cap");
-    return { mimeType, data: bytes.toString("base64"), sourceUrl: url.toString(), bytes: bytes.length };
-  }
-  throw new Error("too many image redirects");
-}
-
-function xml(value) {
-  return String(value ?? "")
-    .replaceAll("&", "&amp;")
-    .replaceAll("<", "&lt;")
-    .replaceAll(">", "&gt;")
-    .replaceAll('"', "&quot;")
-    .replaceAll("'", "&apos;");
-}
-
-function label(item, index) {
-  return item.name || item.collection || item.tokenId || `NFT ${index + 1}`;
-}
-
-export async function nftGallery(args = {}, opts = {}) {
-  const allItems = Array.isArray(args.items) ? args.items : [];
-  if (!allItems.length) throw new Error("nft gallery requires inventory items");
-  const pageSize = Math.min(Math.max(Number(args.pageSize ?? 12) || 12, 1), 12);
-  const page = Math.max(Number(args.page ?? 1) || 1, 1);
-  const totalPages = Math.max(Math.ceil(allItems.length / pageSize), 1);
-  if (page > totalPages) throw new Error(`nft gallery page ${page} exceeds ${totalPages}`);
-  const items = allItems.slice((page - 1) * pageSize, page * pageSize);
-  const loaded = [];
-  let totalBytes = 0;
-  const maxTotalBytes = Math.min(Math.max(Number(args.maxTotalBytes ?? 8_000_000), 250_000), 12_000_000);
-
-  for (const item of items) {
-    if (totalBytes >= maxTotalBytes) {
-      loaded.push({ item, image: null, error: "gallery page byte cap reached" });
-      continue;
-    }
-    try {
-      const image = await fetchRaster(item.imageUrl || item.originalImageUrl, {
-        ...opts,
-        maxImageBytes: Math.min(Number(args.maxImageBytes ?? 1_500_000), maxTotalBytes - totalBytes),
-      });
-      totalBytes += image.bytes;
-      loaded.push({ item, image, error: null });
-    } catch (error) {
-      loaded.push({ item, image: null, error: String(error?.message || error).slice(0, 180) });
-    }
-  }
-
-  const columns = 3;
-  const tileWidth = 340;
-  const tileHeight = 400;
-  const headerHeight = 76;
-  const rows = Math.ceil(items.length / columns);
-  const width = columns * tileWidth;
-  const height = headerHeight + rows * tileHeight;
-  const body = loaded.map(({ item, image, error }, index) => {
-    const column = index % columns;
-    const row = Math.floor(index / columns);
-    const x = column * tileWidth;
-    const y = headerHeight + row * tileHeight;
-    const art = image
-      ? `<image x="${x + 14}" y="${y + 14}" width="312" height="312" preserveAspectRatio="xMidYMid slice" href="data:${image.mimeType};base64,${image.data}"/>`
-      : `<rect x="${x + 14}" y="${y + 14}" width="312" height="312" rx="14" fill="#151820"/><text x="${x + 170}" y="${y + 165}" text-anchor="middle" fill="#76808f" font-size="16">image unavailable</text>`;
-    const title = xml(label(item, index).slice(0, 34));
-    const chain = xml(item.chain || "unknown chain");
-    return `${art}<text x="${x + 16}" y="${y + 350}" fill="#f3f5f7" font-size="17" font-weight="600">${title}</text><text x="${x + 16}" y="${y + 376}" fill="#8d98a8" font-size="13">${chain}${error ? " · placeholder" : ""}</text>`;
-  }).join("");
-  const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}"><rect width="100%" height="100%" fill="#090b10"/><text x="24" y="34" fill="#ffffff" font-size="24" font-weight="700">NFT INVENTORY</text><text x="24" y="58" fill="#8d98a8" font-size="14">page ${page} of ${totalPages} · ${allItems.length} assets · generated ${xml(new Date().toISOString())}</text>${body}</svg>`;
-
-  return {
-    provider: "nft-portfolio",
-    operation: "gallery",
-    mimeType: "image/svg+xml",
-    dataBase64: Buffer.from(svg).toString("base64"),
-    page,
-    pageSize,
-    totalPages,
-    totalItems: allItems.length,
-    renderedItems: loaded.filter((row) => row.image).length,
-    placeholders: loaded.filter((row) => !row.image).map((row) => ({
-      assetKey: row.item.assetKey || null,
-      name: row.item.name || null,
-      sourceUrl: row.item.imageUrl || null,
-      error: row.error,
-    })),
-    rasterOnly: true,
-    externalScripts: false,
-  };
-}

package/src/data/providers/nft-portfolio.mjs

@@ -1,494 +0,0 @@
-// Read-only NFT inventory and valuation coverage across configured wallet families.
-
-import { mapLimit, timed } from "../http.mjs";
-import { resolvePortfolioAddresses } from "./portfolio.mjs";
-import { openseaAccountNfts, openseaAccountPnl, openseaPrepareList } from "./opensea-nft.mjs";
-import { satflowWalletContents, satflowPrepareList } from "./satflow.mjs";
-import { btcInscriptions } from "./bitcoin-meta.mjs";
-import { magicEdenSolPrepareList } from "./magiceden-sol.mjs";
-import { nftGallery } from "./nft-gallery.mjs";
-
-export const OPENSEA_WALLET_CHAINS = Object.freeze([
-  { chain: "ethereum", chainId: 1, family: "evm" },
-  { chain: "optimism", chainId: 10, family: "evm" },
-  { chain: "polygon", chainId: 137, family: "evm" },
-  { chain: "stablechain", chainId: 988, family: "evm" },
-  { chain: "hyperevm", chainId: 999, family: "evm" },
-  { chain: "abstract", chainId: 2741, family: "evm" },
-  { chain: "robinhood", chainId: 4663, family: "evm" },
-  { chain: "base", chainId: 8453, family: "evm" },
-  { chain: "arbitrum", chainId: 42161, family: "evm" },
-  { chain: "avalanche", chainId: 43114, family: "evm" },
-  { chain: "hyperliquid", chainId: null, family: "hyperliquid" },
-]);
-
-const KNOWN_UNSUPPORTED = Object.freeze([
-  { family: "evm", chain: "bsc", chainId: 56, reason: "OpenSea account inventory does not support BSC" },
-  { family: "cosmos", reason: "requires a chain-specific bech32 address and NFT indexer" },
-  { family: "sui", reason: "owner inventory adapter not installed" },
-  { family: "aptos", reason: "owner inventory adapter not installed" },
-]);
-
-function childOpts(opts = {}, key) {
-  return {
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs,
-    ...(opts[key] || {}),
-  };
-}
-
-async function safe(label, fn) {
-  const result = await timed(fn);
-  return result.ok
-    ? { ok: true, data: result.data }
-    : { ok: false, error: `${label}: ${result.error}`.slice(0, 300) };
-}
-
-function rowsFromSatflow(contents) {
-  if (Array.isArray(contents)) return contents;
-  for (const key of ["items", "results", "ordinals", "inscriptions", "data"]) {
-    if (Array.isArray(contents?.[key])) return contents[key];
-  }
-  return [];
-}
-
-function normalizeSatflowItem(raw = {}, owner) {
-  const inscriptionId = raw.inscription_id || raw.inscriptionId || raw.id || raw.inscription || null;
-  return {
-    chain: "bitcoin",
-    family: "bitcoin",
-    owner,
-    contract: null,
-    tokenId: inscriptionId == null ? null : String(inscriptionId),
-    tokenStandard: "ordinal",
-    collection: raw.collection_slug || raw.collectionSlug || raw.collection?.slug || raw.collection || null,
-    name: raw.name || raw.meta?.name || (inscriptionId ? `Inscription ${inscriptionId}` : "Bitcoin inscription"),
-    description: raw.description || raw.meta?.description || null,
-    imageUrl: raw.image_url || raw.imageUrl || raw.content_url || raw.contentUrl || raw.thumbnail || null,
-    originalImageUrl: raw.content_url || raw.contentUrl || raw.image_url || raw.imageUrl || null,
-    animationUrl: null,
-    metadataUrl: raw.metadata_url || raw.metadataUrl || null,
-    marketplaceUrl: raw.marketplace_url || raw.marketplaceUrl || null,
-    estimatedValueUsd: raw.estimated_value_usd != null && Number.isFinite(Number(raw.estimated_value_usd))
-      ? Number(raw.estimated_value_usd)
-      : null,
-    estimatedValueSats: (raw.floor_price_sats ?? raw.price_sats) != null && Number.isFinite(Number(raw.floor_price_sats ?? raw.price_sats))
-      ? Number(raw.floor_price_sats ?? raw.price_sats)
-      : null,
-    spam: false,
-    disabled: false,
-    nsfw: false,
-    listed: raw.listed === true || raw.is_listed === true,
-    listingId: raw.listing_id || raw.listingId || null,
-    traits: Array.isArray(raw.traits) ? raw.traits : [],
-    updatedAt: raw.updated_at || raw.updatedAt || null,
-    acquisitionCost: null,
-    itemPnl: {
-      status: "unavailable",
-      reason: "Satflow wallet inventory does not expose trustworthy acquisition cost",
-    },
-    listingAdapter: "satflow",
-    source: "satflow-wallet-contents",
-  };
-}
-
-function normalizeFallbackInscription(id, owner) {
-  return {
-    chain: "bitcoin",
-    family: "bitcoin",
-    owner,
-    contract: null,
-    tokenId: String(id),
-    tokenStandard: "ordinal",
-    collection: null,
-    name: `Inscription ${id}`,
-    description: null,
-    imageUrl: null,
-    originalImageUrl: null,
-    animationUrl: null,
-    metadataUrl: null,
-    marketplaceUrl: null,
-    estimatedValueUsd: null,
-    spam: false,
-    disabled: false,
-    nsfw: false,
-    traits: [],
-    updatedAt: null,
-    acquisitionCost: null,
-    itemPnl: { status: "unavailable", reason: "address indexer returned no acquisition or valuation data" },
-    listingAdapter: "satflow",
-    source: "bitcoin-meta-address-indexer",
-  };
-}
-
-export function nftAssetKey(item = {}) {
-  return [item.chain || "unknown", item.contract || "native", item.tokenId || "unknown"].join(":").toLowerCase();
-}
-
-function costBasisMap(input) {
-  const out = new Map();
-  if (Array.isArray(input)) {
-    for (const row of input) {
-      if (row?.assetKey) out.set(String(row.assetKey).toLowerCase(), row);
-    }
-    return out;
-  }
-  if (input && typeof input === "object") {
-    for (const [key, value] of Object.entries(input)) out.set(key.toLowerCase(), value);
-  }
-  return out;
-}
-
-function applyCostBasis(item, basis) {
-  const key = nftAssetKey(item);
-  const row = basis.get(key);
-  const current = item.estimatedValueUsd == null ? null : Number(item.estimatedValueUsd);
-  if (!row) return { ...item, assetKey: key };
-  const cost = Number(row.costUsd);
-  const fees = Number(row.feesUsd ?? 0);
-  if (!Number.isFinite(cost) || cost < 0 || !Number.isFinite(fees) || fees < 0) {
-    return {
-      ...item,
-      assetKey: key,
-      acquisitionCost: null,
-      itemPnl: { status: "unavailable", reason: "invalid user-supplied cost basis" },
-    };
-  }
-  const totalCostUsd = Math.round((cost + fees) * 100) / 100;
-  if (!Number.isFinite(current)) {
-    return {
-      ...item,
-      assetKey: key,
-      acquisitionCost: {
-        costUsd: cost,
-        feesUsd: fees,
-        totalCostUsd,
-        acquiredAt: row.acquiredAt || null,
-        source: row.source || "user-supplied",
-      },
-      itemPnl: { status: "unavailable", reason: "current NFT valuation is unavailable" },
-    };
-  }
-  return {
-    ...item,
-    assetKey: key,
-    acquisitionCost: {
-      costUsd: cost,
-      feesUsd: fees,
-      totalCostUsd,
-      acquiredAt: row.acquiredAt || null,
-      source: row.source || "user-supplied",
-    },
-    itemPnl: {
-      status: "estimated",
-      methodology: "provider estimated current value minus supplied USD acquisition cost and fees",
-      unrealizedUsd: Math.round((current - totalCostUsd) * 100) / 100,
-      currentValueUsd: current,
-      totalCostUsd,
-      realizedUsd: null,
-    },
-  };
-}
-
-function dedupe(items) {
-  const map = new Map();
-  for (const item of items) {
-    const key = nftAssetKey(item);
-    if (!map.has(key)) map.set(key, item);
-  }
-  return [...map.values()];
-}
-
-function pnlSummary(items, accountPnl) {
-  const known = items.filter((item) => item.itemPnl?.status === "estimated");
-  const unknown = items.length - known.length;
-  const knownUnrealizedUsd = Math.round(
-    known.reduce((sum, item) => sum + Number(item.itemPnl.unrealizedUsd || 0), 0) * 100,
-  ) / 100;
-  return {
-    nftItemPnl: {
-      status: unknown === 0 && items.length ? "estimated-complete-for-held-items" : known.length ? "partial" : "unavailable",
-      methodology: "Only items with explicit acquisition cost and provider estimated current value are included",
-      knownUnrealizedUsd,
-      knownItems: known.length,
-      unknownItems: unknown,
-      realizedUsd: null,
-      warning: "Transfers, gifts, airdrops, mints, bridges, gas, royalties, and off-market sales can make cost basis unavailable or incomplete.",
-    },
-    providerAccountPnl: accountPnl,
-  };
-}
-
-/** One normalized owner NFT inventory with per-chain partial failure reporting. */
-export async function nftHealth() {
-  return {
-    ok: true,
-    provider: "nft-portfolio",
-    readOnly: true,
-    marketplaces: ["opensea", "magiceden-sol", "satflow"],
-    listingExecution: "prepare-only",
-  };
-}
-
-export async function nftInventory(args = {}, opts = {}) {
-  const generatedAt = new Date().toISOString();
-  const addresses = resolvePortfolioAddresses(args, opts.env || process.env);
-  const selected = Array.isArray(args.chains) && args.chains.length
-    ? new Set(args.chains.map((value) => String(value).toLowerCase()))
-    : null;
-  const openSeaChains = OPENSEA_WALLET_CHAINS.filter((row) => !selected || selected.has(row.chain));
-  const coverage = [];
-  const items = [];
-  const openseaOpts = childOpts(opts, "opensea");
-
-  const evmRows = addresses.evm
-    ? openSeaChains.filter((row) => row.family !== "solana")
-    : [];
-  const evmResults = await mapLimit(evmRows, 4, async (row) => ({
-    row,
-    result: await safe(
-      `opensea-${row.chain}`,
-      () => openseaAccountNfts({
-        chain: row.chain,
-        address: addresses.evm,
-        pageSize: args.pageSize,
-        maxPages: args.maxPages,
-      }, openseaOpts),
-      opts.timeoutMs ?? 35_000,
-    ),
-  }));
-
-  for (const { row, result } of evmResults) {
-    if (result.ok) {
-      const rows = result.data.nfts.map((item) => ({
-        ...item,
-        family: row.family,
-        chainId: row.chainId,
-        listingAdapter: "opensea",
-        source: "opensea-account-inventory",
-      }));
-      items.push(...rows);
-      coverage.push({
-        family: row.family,
-        chain: row.chain,
-        chainId: row.chainId,
-        status: result.data.complete ? "ok" : "partial",
-        count: rows.length,
-        complete: result.data.complete,
-        next: result.data.next,
-        source: "opensea",
-      });
-    } else {
-      coverage.push({ family: row.family, chain: row.chain, chainId: row.chainId, status: "unavailable", error: result.error, source: "opensea" });
-    }
-  }
-
-  if (!addresses.evm) {
-    for (const row of openSeaChains.filter((item) => item.family !== "solana")) {
-      coverage.push({ family: row.family, chain: row.chain, chainId: row.chainId, status: "not-configured", reason: "EVM address missing" });
-    }
-  }
-
-  if (addresses.solana && (!selected || selected.has("solana"))) {
-    const result = await safe(
-      "opensea-solana",
-      () => openseaAccountNfts({
-        chain: "solana",
-        address: addresses.solana,
-        pageSize: args.pageSize,
-        maxPages: args.maxPages,
-      }, openseaOpts),
-      opts.timeoutMs ?? 35_000,
-    );
-    if (result.ok) {
-      const rows = result.data.nfts.map((item) => ({
-        ...item,
-        family: "solana",
-        chainId: null,
-        listingAdapter: null,
-        source: "opensea-account-inventory",
-      }));
-      items.push(...rows);
-      coverage.push({ family: "solana", chain: "solana", status: result.data.complete ? "ok" : "partial", count: rows.length, complete: result.data.complete, next: result.data.next, source: "opensea" });
-    } else {
-      coverage.push({ family: "solana", chain: "solana", status: "unavailable", error: result.error, source: "opensea" });
-    }
-  } else if (!selected || selected.has("solana")) {
-    coverage.push({ family: "solana", chain: "solana", status: "not-configured", reason: "Solana address missing" });
-  }
-
-  if (addresses.bitcoin && (!selected || selected.has("bitcoin"))) {
-    const satflow = await safe(
-      "satflow-wallet-contents",
-      () => satflowWalletContents({ address: addresses.bitcoin, type: "ordinals", limit: args.bitcoinLimit ?? 100, offset: 0 }, childOpts(opts, "satflow")),
-      opts.timeoutMs ?? 35_000,
-    );
-    if (satflow.ok) {
-      const rows = rowsFromSatflow(satflow.data.contents).map((item) => normalizeSatflowItem(item, addresses.bitcoin));
-      items.push(...rows);
-      const complete = rows.length < Number(args.bitcoinLimit ?? 100);
-      coverage.push({ family: "bitcoin", chain: "bitcoin", status: complete ? "ok" : "partial", count: rows.length, complete, source: "satflow" });
-    } else {
-      const fallback = await safe(
-        "bitcoin-meta-inscriptions",
-        () => btcInscriptions({ address: addresses.bitcoin }, childOpts(opts, "bitcoinMeta")),
-        opts.timeoutMs ?? 35_000,
-      );
-      const ids = fallback.ok && fallback.data?.ok && Array.isArray(fallback.data.inscriptions)
-        ? fallback.data.inscriptions
-        : [];
-      items.push(...ids.map((id) => normalizeFallbackInscription(id, addresses.bitcoin)));
-      coverage.push({
-        family: "bitcoin",
-        chain: "bitcoin",
-        status: ids.length ? "partial" : "unavailable",
-        count: ids.length,
-        complete: false,
-        source: ids.length ? "bitcoin-meta" : "satflow",
-        error: ids.length ? "Satflow unavailable; fallback has IDs only" : satflow.error,
-      });
-    }
-  } else if (!selected || selected.has("bitcoin")) {
-    coverage.push({ family: "bitcoin", chain: "bitcoin", status: "not-configured", reason: "Bitcoin address missing" });
-  }
-
-  const accountPnl = [];
-  if (args.includePnl !== false) {
-    for (const address of [...new Set([addresses.evm, addresses.solana].filter(Boolean))]) {
-      const result = await safe(
-        `opensea-pnl-${address}`,
-        () => openseaAccountPnl({ address }, openseaOpts),
-        opts.timeoutMs ?? 35_000,
-      );
-      accountPnl.push(result.ok
-        ? { status: "ok", ...result.data }
-        : { status: "unavailable", address, source: "opensea-indexed-account-pnl", error: result.error });
-    }
-  }
-
-  const basis = costBasisMap(args.costBasis);
-  const normalized = dedupe(items).map((item) => applyCostBasis(item, basis));
-  const visible = normalized.filter((item) => !item.spam);
-  const flagged = normalized.filter((item) => item.spam);
-  const estimated = visible.filter((item) =>
-    item.estimatedValueUsd != null && Number.isFinite(Number(item.estimatedValueUsd)),
-  );
-  const estimatedCurrentValueUsd = Math.round(
-    estimated.reduce((sum, item) => sum + Number(item.estimatedValueUsd), 0) * 100,
-  ) / 100;
-  const missingValueItems = visible.length - estimated.length;
-  const failedCoverage = coverage.filter((row) => row.status !== "ok" || row.complete === false);
-
-  return {
-    provider: "nft-portfolio",
-    operation: "inventory",
-    readOnly: true,
-    generatedAt,
-    addresses,
-    coverage,
-    unsupported: KNOWN_UNSUPPORTED,
-    inventory: {
-      count: normalized.length,
-      visibleCount: visible.length,
-      flaggedCount: flagged.length,
-      items: normalized,
-      visibleItems: visible,
-      flaggedItems: flagged,
-    },
-    valuation: {
-      estimatedCurrentValueUsd,
-      valuedItems: estimated.length,
-      unvaluedItems: missingValueItems,
-      complete: missingValueItems === 0 && failedCoverage.length === 0,
-      methodology: "Sum of provider estimated_value_usd for non-flagged items. It is not an executable bid.",
-    },
-    pnl: pnlSummary(visible, accountPnl),
-    listingCoverage: {
-      opensea: "EVM listing actions available with OPENSEA_API_KEY, explicit price/currency/expiry, and user confirmation",
-      satflow: "Bitcoin unsigned listing PSBT available with SATFLOW_API_KEY, explicit price/expiry, and user confirmation",
-      solana: "Magic Eden unsigned list transaction available with MAGICEDEN_API_KEY, explicit SOL price/expiry, and user confirmation",
-      unsupported: "Sui, Aptos, Cosmos, BSC, and unknown marketplaces fail closed",
-    },
-    metadataSafety: {
-      imagesAreUntrusted: true,
-      animationAndHtmlNotRendered: true,
-      galleryRasterOnly: true,
-      missingImagesUsePlaceholders: true,
-    },
-  };
-}
-
-function futureUnixSeconds(value, label) {
-  const raw = typeof value === "number" ? value * 1000 : Date.parse(String(value || ""));
-  if (!Number.isFinite(raw)) throw new Error(`${label} must be an ISO 8601 timestamp or Unix seconds`);
-  const seconds = Math.floor(raw / 1000);
-  if (seconds <= Math.floor(Date.now() / 1000)) throw new Error(`${label} must be in the future`);
-  return seconds;
-}
-
-function positiveSats(value) {
-  const text = String(value ?? "").trim();
-  if (!/^[1-9]\d*$/.test(text)) throw new Error("Bitcoin NFT list priceSats must be a positive integer");
-  return text;
-}
-
-export async function nftPrepareList(args = {}, opts = {}) {
-  if (args.userConfirmed !== true) {
-    throw new Error("NFT listing preparation requires userConfirmed=true after reviewing asset, marketplace, price, currency, fees, royalties, and expiry");
-  }
-  const marketplace = String(args.marketplace || "").trim().toLowerCase();
-  if (marketplace === "opensea") {
-    return openseaPrepareList(args, childOpts(opts, "opensea"));
-  }
-  if (marketplace === "magiceden" || marketplace === "magiceden-sol") {
-    const expiry = futureUnixSeconds(args.expiry ?? args.endTime, "Solana NFT listing expiry");
-    return magicEdenSolPrepareList({ ...args, expiry }, childOpts(opts, "magiceden"));
-  }
-  if (marketplace === "satflow") {
-    const expiry = futureUnixSeconds(args.expiry ?? args.endTime ?? args.expiresAt, "Bitcoin NFT listing expiry");
-    return satflowPrepareList({
-      inscription_id: args.inscriptionId || args.tokenId,
-      runes_output: args.runesOutput,
-      ord_address: args.ordAddress || args.seller,
-      receive_address: args.receiveAddress,
-      price: positiveSats(args.priceSats ?? args.price),
-      tap_key: args.tapKey,
-      collection_slug: args.collectionSlug || args.collection,
-      expires_at: expiry,
-    }, childOpts(opts, "satflow"));
-  }
-  throw new Error(`unsupported NFT marketplace: ${marketplace || "<missing>"}`);
-}
-
-export async function nftPnl(args = {}, opts = {}) {
-  const inventory = await nftInventory({ ...args, includePnl: true }, opts);
-  return {
-    provider: "nft-portfolio",
-    operation: "pnl",
-    readOnly: true,
-    generatedAt: inventory.generatedAt,
-    addresses: inventory.addresses,
-    coverage: inventory.coverage,
-    unsupported: inventory.unsupported,
-    valuation: inventory.valuation,
-    pnl: inventory.pnl,
-  };
-}
-
-export async function nftPortfolioGallery(args = {}, opts = {}) {
-  let items = Array.isArray(args.items) ? args.items : null;
-  let inventory = null;
-  if (!items) {
-    inventory = await nftInventory({ ...args, includePnl: false }, opts);
-    items = inventory.inventory.visibleItems;
-  }
-  const gallery = await nftGallery({ ...args, items }, childOpts(opts, "gallery"));
-  return {
-    ...gallery,
-    inventorySummary: inventory ? {
-      visibleCount: inventory.inventory.visibleCount,
-      flaggedCount: inventory.inventory.flaggedCount,
-      coverage: inventory.coverage,
-    } : null,
-  };
-}