@oracle-agent/oracle 0.3.3 → 0.3.4

package/docs/profiles.md

@@ -34,28 +34,19 @@ Three practical reasons, learned the hard way:
 
 | Profile | Owns | Typical grant |
 |---|---|---|
-| `oracle` | routing, synthesis, multi-chain comparison, `/balance` portfolio aggregation | read + simulate only |
+| `oracle` | routing, synthesis, multi-chain comparison | read + simulate only |
 | `polymarket-agent` | prediction markets, event odds, CLOB cards/API-key order intents | read, quote, prepare |
 | `hyperliquid-agent` | perps, spot, HIP-3 builder dexs, HIP-4 outcomes | read, quote, prepare |
 | `robinhood-agent` | Robinhood Chain (4663) tokens, NFTs, tokenized Robinhood-style assets, capped NFT mints | read, quote, prepare |
 | `solana-agent` | Solana swaps, research, Jupiter routes | read, quote, prepare |
 | `bitcoin-agent` | Bitcoin L1, Ordinals/runes, inscriptions | read, prepare:inscription |
 | `stable-agent` | Stable (988), USDT-native gas quirks | read, quote, prepare |
-| `protocol-builder` | scaffold, review, prepare chain-family token/NFT collections, gacha, DEX, and protocol deploys | prepare:deploy, prepare:mint, simulate |
+| `protocol-builder` | scaffold, review, prepare protocol/NFT/gacha/DEX deploys and mint bots | prepare:deploy, prepare:mint, simulate |
 | `_template` | your new lane | you decide |
 
-`protocol-builder` classifies each launch by chain family, then designs and
-prepares unsigned token, NFT collection, protocol, or mint-bot transactions. It
-fails closed when no verified adapter exists, never house-signs, and keeps deploy,
-metadata, liquidity, mint, and authority actions as separate user approvals.
-
-The root `oracle` lane owns `/balance`, natural-language balance, and portfolio
-history requests. Its `balance` skill calls the read-only
-`portfolio_snapshot` MCP tool once, records a compact profile-local observation,
-reports partial coverage and unavailable providers, and labels `knownUsd` as
-incomplete instead of inventing a full portfolio total. `portfolio_history`
-reads those observations and `portfolio_value_graph` renders the known-value
-series while omitting unavailable values rather than plotting fake zeroes.
+`protocol-builder` can design a protocol and prepare an unsigned deploy or mint
+bot transaction. It never house-signs, and its destinations and gas-war caps are
+allowlisted like any other lane.
 
 ## Model choice is yours
 
@@ -110,21 +101,10 @@ hermes profile create polymarket-agent
 ```
 
 Then give it a `SOUL.md` (who it is, what it owns, what it must refuse) and a
-`config.yaml` (model + provider). Point it at Oracle's MCP read plane.
-
-`oracle-init --apply` writes this for you. Manual form (Hermes wants command and
-args as separate tokens):
+`config.yaml` (model + provider). Point it at Oracle's MCP read plane:
 
 ```bash
-# terminal 1 — local read plane the MCP tools call
-npx oracle-data
-
-# terminal 2 — wire MCP into a lane
-hermes -p polymarket-agent mcp add oracle-data \
-  --command node \
-  --args "$(node -p "require.resolve('@oracle-agent/oracle/package.json').replace(/package\\.json$/, 'bin/oracle-data-mcp.mjs')")"
-# or after npm link / PATH has the bin:
-# hermes -p polymarket-agent mcp add oracle-data --command oracle-data-mcp
+hermes mcp add oracle-data --command "oracle-data-mcp"
 ```
 
 Now that lane can read 30+ providers across 11 chains, quote real routes, and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oracle-agent/oracle",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Oracle: prepare-only multichain agent control plane. Policy-bounded intents for a user-signed wallet. Self-custody by default — the public package never takes your key. Built for Hermes; no model key required.",
   "license": "Apache-2.0",
   "type": "module",

package/profiles/_template/SOUL.md

@@ -38,15 +38,8 @@ Terse. Answer first, evidence second. State confidence: `high` / `moderate` /
 ## Wiring it up
 
 ```bash
-# preferred: installer writes SOUL, skills, and MCP config
-npx oracle-init --apply
-
-# or by hand
 hermes profile create my-lane
-npx oracle-data   # keep running — MCP tools call 127.0.0.1:8787
-hermes -p my-lane mcp add oracle-data --command oracle-data-mcp
-# if the bin is not on PATH:
-# hermes -p my-lane mcp add oracle-data --command node --args /abs/path/to/oracle-data-mcp.mjs
+hermes mcp add oracle-data --command "oracle-data-mcp"
 ```
 
 Then copy this `SOUL.md` into `~/.hermes/profiles/my-lane/SOUL.md` and set the

package/profiles/oracle/SOUL.md

@@ -20,11 +20,9 @@ value yourself.
 | Stable (988), USDT-native gas | `stable-agent` |
 | tokenized Robinhood-style assets / stock tokens | exact home-chain lane + `oracle-rfq-tokenized-assets` |
 | meme-token launches, sniping, liquidity/pool watches | token's home-chain lane + `oracle-meme-token-sniper` |
-| create a fungible token or NFT collection | home-chain specialist for chain facts + `protocol-builder` using the matching multichain launch skill |
-| deploy/review custom contracts, gacha, DEX, launchpad, or capped NFT mint bot | `protocol-builder` + `oracle-nft-mint-gas-war` |
+| deploy/review a contract, NFT/gacha launch, DEX, or capped NFT mint bot | `protocol-builder` + `oracle-nft-mint-gas-war` |
 | RFQ / solver-intent route comparison across chains | `oracle` + `oracle-rfq-tokenized-assets` |
 | graph/card alert rendering | token's home-chain lane + `oracle-chain-graphs-telegram-cards` |
-| `/balance`, balance, holdings, wallet portfolio | `oracle` + `balance`; one deterministic `portfolio_snapshot` read plus profile-local observation |
 | compare chains, "which is cheaper" | you, using the data plane |
 
 If the chain is ambiguous, resolve the token's home chain first (DexScreener via
@@ -55,11 +53,6 @@ the data plane). If it stays ambiguous, ask. Do not guess a chain.
    delta → the action did not succeed. Say so plainly.
 7. **Never invent chain facts.** If it did not come from a live read, label it
    `unknown`.
-8. **Balance uses one source of truth.** `/balance` and plain-language balance
-   requests call `portfolio_snapshot`; use `portfolio_history` and
-   `portfolio_value_graph` for historical requests. Report `knownUsd` as
-   incomplete whenever a provider, address, price, token/NFT indexer, or chain
-   adapter is missing. Never turn an unavailable historical value into zero.
 
 ## Confidence
 

package/profiles/oracle/profile.json

@@ -4,7 +4,7 @@
   "label": "oracle",
   "role": "router",
   "color": "#7CC4FF",
-  "description": "Router for multichain trading, building, analysis, wallet/NFT inventory and value history, scanners, RFQ, tokenized-asset buys, NFT mint gas limits, meme-token sniping, and chain-family token/NFT launches.",
+  "description": "Router for multichain trading, building, analysis, scanners, RFQ, tokenized-asset buys, NFT mint gas limits, meme-token sniping, Solana, Bitcoin, and protocol launches.",
   "model": {
     "note": "Wants the strongest reasoner available: routing and synthesis are judgment calls.",
     "suggested": "strong-reasoner"
@@ -18,10 +18,7 @@
     "oracle-meme-token-sniper",
     "oracle-chain-graphs-telegram-cards",
     "oracle-rfq-tokenized-assets",
-    "oracle-nft-mint-gas-war",
-    "oracle-multichain-token-launch",
-    "oracle-multichain-nft-launch",
-    "balance"
+    "oracle-nft-mint-gas-war"
   ],
   "mcp": [
     "oracle-data"

package/profiles/protocol-builder/SOUL.md

@@ -1,16 +1,13 @@
 # protocol builder
 
-You classify by chain family, then design, review, and prepare deploys for fungible
-tokens, NFT collections, protocols, gacha products, DEX surfaces, launchpads, mint
-pages, and scanner-backed on-chain apps. You never sign one. Unsupported chain
-adapters fail closed.
+You design, review, and prepare deploys for protocols, NFT/gacha products, DEX
+surfaces, launchpads, mint pages, and scanner-backed on-chain apps. You never sign one.
 
 ## What you own
 
-Chain-family token/NFT launch manifests, contract and program scaffolding,
-NFT/gacha mint mechanics, DEX/pool/launchpad design, security review, deploy and
-verify scripts, and **unsigned** deploy transactions. Research of existing
-protocols before cloning them.
+Contract scaffolding, NFT/gacha mint mechanics, DEX/pool/launchpad design,
+security review, deploy and verify scripts, and **unsigned** deploy transactions.
+Research of existing protocols before cloning them.
 
 ## Deployment is permanent
 
@@ -45,11 +42,7 @@ what an attacker gains from each privileged function.
 3. **Simulate before preparing.** An unsimulated deploy is a guess.
 4. **State the authority model before the code.** A user who doesn't know who owns
    the contract cannot consent to deploying it.
-5. **Receipts or it didn't happen.** Deployed address, receipt, verified source.
-6. **Chain-family support is explicit.** Use `TEMPLATE_READY`, `ADAPTER_READY`,
-   `GUIDED_BUILD`, `RESEARCH_ONLY`, or `UNSUPPORTED`. RPC reachability is not deploy support.
-7. **One approval per side effect.** Deploy, metadata upload, mint, liquidity,
-   authority transfer/revoke, reveal, and verification remain separate.
+5. **Receipts or it didn't happen** — deployed address, receipt, verified source.
 
 ## Voice
 

package/profiles/protocol-builder/profile.json

@@ -4,7 +4,7 @@
   "label": "protocol builder",
   "role": "builder",
   "color": "#ff8c5a",
-  "description": "Builder lane for protocol, chain-family token/NFT collections, gacha, DEX, scanner, and mint-bot surfaces with unsigned deploy/mint preparation.",
+  "description": "Builder lane for protocol, NFT/gacha, DEX, scanner, and mint-bot surfaces with unsigned deploy/mint preparation.",
   "model": {
     "note": "Contract review is unforgiving and mistakes are permanent; wants the strongest reasoner available.",
     "suggested": "strong-reasoner"
@@ -13,8 +13,6 @@
     "oracle-protocol-builder",
     "oracle-contract-research",
     "oracle-protocol-security",
-    "oracle-multichain-token-launch",
-    "oracle-multichain-nft-launch",
     "oracle-nft-gacha-launch",
     "oracle-dex-launch",
     "oracle-receipts",

package/src/data/catalog.mjs

@@ -98,29 +98,6 @@ registerProvider({
   description: "RH agent local HTTP (unauthenticated read routes)",
 });
 
-registerProvider({
-  id: "portfolio",
-  venue: "multichain-wallet",
-  chainIds: [1, 10, 56, 137, 988, 999, 2741, 4663, 8453, 42161, 43114],
-  auth: "none",
-  ops: ["health", "balances", "snapshot", "history", "valueGraph"],
-  execution: "read-only",
-  description:
-    "Read-only balance aggregation across configured EVM chains, Solana, Bitcoin, and Hyperliquid, plus profile-local observation snapshots, history, and value graphs with explicit partial coverage.",
-});
-
-registerProvider({
-  id: "nft-portfolio",
-  venue: "multichain-nft-wallet",
-  chainIds: [1, 10, 137, 988, 999, 2741, 4663, 8453, 42161, 43114],
-  auth: "optionalApiKey",
-  ops: ["health", "inventory", "gallery", "pnl", "prepareList"],
-  execution: "prepare",
-  baseEnv: ["OPENSEA_API_KEY", "MAGICEDEN_API_KEY", "SATFLOW_API_KEY"],
-  description:
-    "Normalized EVM, Solana, and Bitcoin NFT inventory, static contact-sheet galleries, explicit PnL coverage, and user-confirmed unsigned listing preparation.",
-});
-
 registerProvider({
   id: "evm-rpc",
   venue: "evm",
@@ -404,12 +381,11 @@ registerProvider({
 registerProvider({
   id: "opensea-nft",
   venue: "nft",
-  chainIds: [1, 10, 137, 988, 999, 2741, 4663, 8453, 42161, 43114],
+  chainIds: [1],
   auth: "apiKey",
-  ops: ["health", "collection", "floor", "accountNfts", "accountPnl", "prepareList"],
-  execution: "prepare",
+  ops: ["health", "collection", "floor"],
   baseEnv: ["OPENSEA_API_KEY", "OPENSEA_ENV_FILE"],
-  description: "OpenSea multichain NFT inventory, estimated values, indexed account PnL, collection floors, and unsigned listing actions",
+  description: "OpenSea collection + floor (OPENSEA_API_KEY)",
 });
 
 registerProvider({

package/src/data/desk-data.mjs

@@ -40,9 +40,6 @@ import * as balancer from "./providers/balancer.mjs";
 import * as pendle from "./providers/pendle.mjs";
 import * as odos from "./providers/odos.mjs";
 import * as blockscout from "./providers/blockscout.mjs";
-import * as portfolio from "./providers/portfolio.mjs";
-import * as portfolioHistory from "./providers/portfolio-history.mjs";
-import * as nftPortfolio from "./providers/nft-portfolio.mjs";
 import * as paraswap from "./providers/paraswap.mjs";
 
 const OPS = {
@@ -93,20 +90,6 @@ const OPS = {
     erc20Balance: (o, a = {}) => rpc.erc20BalanceOf(a, o),
     transactionReceipt: (o, a = {}) => rpc.transactionReceipt(a, o),
   },
-  portfolio: {
-    health: (o) => portfolio.portfolioHealth(o),
-    balances: (o, a = {}) => portfolio.portfolioBalance(a, o),
-    snapshot: (o, a = {}) => portfolioHistory.portfolioSnapshot(a, o),
-    history: (o, a = {}) => portfolioHistory.portfolioHistory(a, o),
-    valueGraph: (o, a = {}) => portfolioHistory.portfolioValueGraph(a, o),
-  },
-  "nft-portfolio": {
-    health: (o) => nftPortfolio.nftHealth(o),
-    inventory: (o, a = {}) => nftPortfolio.nftInventory(a, o),
-    gallery: (o, a = {}) => nftPortfolio.nftPortfolioGallery(a, o),
-    pnl: (o, a = {}) => nftPortfolio.nftPnl(a, o),
-    prepareList: (o, a = {}) => nftPortfolio.nftPrepareList(a, o),
-  },
   "solana-rpc": {
     health: (o) => solana.solanaHealth(o),
     latestBlockhash: (o, a = {}) => solana.solanaLatestBlockhash(a, o),
@@ -230,9 +213,6 @@ const OPS = {
     health: (o) => osnft.openseaHealth(o),
     collection: (o, a = {}) => osnft.openseaCollection(a.slug, o),
     floor: (o, a = {}) => osnft.openseaFloor(a.slug, o),
-    accountNfts: (o, a = {}) => osnft.openseaAccountNfts(a, o),
-    accountPnl: (o, a = {}) => osnft.openseaAccountPnl(a, o),
-    prepareList: (o, a = {}) => osnft.openseaPrepareList(a, o),
   },
 
   "hl-outcome": {
@@ -590,20 +570,6 @@ export const data = {
     call: (chainId, method, params, o) =>
       dataCall("evm-rpc", "call", { chainId, method, params }, o),
   },
-  portfolio: {
-    balance: (a, o) => dataCall("portfolio", "balances", a || {}, o),
-    snapshot: (a, o) => dataCall("portfolio", "snapshot", a || {}, o),
-    history: (a, o) => dataCall("portfolio", "history", a || {}, o),
-    valueGraph: (a, o) => dataCall("portfolio", "valueGraph", a || {}, o),
-  },
-  nft: {
-    inventory: (a, o) => dataCall("nft-portfolio", "inventory", a || {}, o),
-    gallery: (a, o) => dataCall("nft-portfolio", "gallery", a || {}, o),
-    pnl: (a, o) => dataCall("nft-portfolio", "pnl", a || {}, o),
-    prepareList: (a, o) => dataCall("nft-portfolio", "prepareList", a || {}, o),
-    floor: (slug, o) => dataCall("opensea-nft", "floor", { slug }, o),
-    collection: (slug, o) => dataCall("opensea-nft", "collection", { slug }, o),
-  },
   solana: {
     health: (o) => dataCall("solana-rpc", "health", {}, o),
     latestBlockhash: (a, o) => dataCall("solana-rpc", "latestBlockhash", a || {}, o),
@@ -667,6 +633,10 @@ export const data = {
   cow: {
     quote: (a, o) => dataCall("cowswap", "quote", a || {}, o),
   },
+  nft: {
+    floor: (slug, o) => dataCall("opensea-nft", "floor", { slug }, o),
+    collection: (slug, o) => dataCall("opensea-nft", "collection", { slug }, o),
+  },
   hlWs: {
     allMids: (o) => dataCall("hl-ws", "allMids", {}, o),
     l2Book: (coin, o) => dataCall("hl-ws", "l2Book", { coin }, o),

package/src/data/providers/magiceden-sol.mjs

@@ -89,18 +89,6 @@ function lamports(sol) {
   return Math.round(positiveNumber(sol, "priceSol") * LAMPORTS_PER_SOL);
 }
 
-function listingExpiry(value) {
-  if (value == null || value === "") return null;
-  const expiry = Number(value);
-  if (!Number.isSafeInteger(expiry) || expiry < 0) {
-    throw new Error("magiceden: expiry must be a whole Unix timestamp in seconds or 0");
-  }
-  if (expiry !== 0 && expiry <= Math.floor(Date.now() / 1000)) {
-    throw new Error("magiceden: expiry must be in the future or 0 for no expiry");
-  }
-  return expiry;
-}
-
 export async function magicEdenSolHealth(opts = {}) {
   try {
     const stats = await magicEdenSolStats({ symbol: "mad_lads" }, opts);
@@ -268,26 +256,20 @@ export async function magicEdenSolPrepareList(args = {}, opts = {}) {
   const tokenATA = solanaPubkey(args.tokenATA || args.tokenAddress, "tokenATA");
   const auctionHouse = solanaPubkey(args.auctionHouse, "auctionHouse");
   const priceSol = positiveNumber(args.priceSol ?? args.price, "priceSol");
-  const expiry = listingExpiry(args.expiry);
   const url = new URL(`${base(opts)}/instructions/sell`);
   url.searchParams.set("seller", seller);
   url.searchParams.set("auctionHouseAddress", auctionHouse);
   url.searchParams.set("tokenMint", tokenMint);
   url.searchParams.set("tokenAccount", tokenATA);
   url.searchParams.set("price", String(priceSol));
-  if (args.sellerReferral) url.searchParams.set("sellerReferral", solanaPubkey(args.sellerReferral, "sellerReferral"));
-  if (expiry != null) url.searchParams.set("expiry", String(expiry));
   const raw = await httpJson(url.toString(), {
     headers: headers(opts),
     fetchImpl: opts.fetchImpl,
     timeoutMs: opts.timeoutMs ?? 15_000,
   });
   const data = raw?.v0?.tx?.data ?? raw?.tx?.data ?? null;
-  if (!Array.isArray(data)) {
-    if (raw?.txSigned) throw new Error("magiceden: refused a pre-signed transaction payload from the API");
-    throw new Error("magiceden: sell returned no unsigned transaction payload");
-  }
-  const transaction = Buffer.from(data).toString("base64");
+  const transaction = Array.isArray(data) ? Buffer.from(data).toString("base64") : null;
+  if (!transaction) throw new Error("magiceden: sell returned no transaction payload");
   return stampPrepared({
     provider: "magiceden-sol",
     chain: "solana-mainnet-beta",
@@ -300,7 +282,6 @@ export async function magicEdenSolPrepareList(args = {}, opts = {}) {
     seller,
     tokenMint,
     priceSol,
-    expiry,
     transaction,
     transactionEncoding: "base64",
     raw,

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

@@ -1,49 +1,11 @@
 // OpenSea NFT floors — uses OPENSEA_API_KEY from env or ~/.config/locals-only/opensea.env
 
 import { readFileSync, existsSync } from "node:fs";
-import { getAddress } from "ethers";
 import { httpJson } from "../http.mjs";
 import { resolveProviderEndpoint, credentialedHeaders } from "../provider-endpoint.mjs";
-import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const OPENSEA_API = "https://api.opensea.io/api/v2";
 
-export const OPENSEA_ACCOUNT_CHAINS = Object.freeze([
-  "blast",
-  "base",
-  "ethereum",
-  "zora",
-  "arbitrum",
-  "sei",
-  "avalanche",
-  "polygon",
-  "optimism",
-  "ape_chain",
-  "flow",
-  "b3",
-  "soneium",
-  "ronin",
-  "bera_chain",
-  "solana",
-  "shape",
-  "unichain",
-  "gunzilla",
-  "abstract",
-  "animechain",
-  "hyperevm",
-  "somnia",
-  "monad",
-  "hyperliquid",
-  "megaeth",
-  "ink",
-  "robinhood",
-  "stablechain",
-]);
-
-const OPENSEA_CHAIN_SET = new Set(OPENSEA_ACCOUNT_CHAINS);
-const OPENSEA_NON_EVM_CHAINS = new Set(["solana", "flow"]);
-const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
-
 function loadKeyFromDisk() {
   const p = process.env.OPENSEA_ENV_FILE || `${process.env.HOME || ""}/.config/locals-only/opensea.env`;
   if (!existsSync(p)) return "";
@@ -80,81 +42,6 @@ function headers(opts = {}) {
   return credentialedHeaders({ accept: "application/json" }, { "x-api-key": apiKey(opts) }, endpoint(opts).trusted);
 }
 
-function accountChain(value) {
-  const chain = String(value || "ethereum").trim().toLowerCase();
-  if (!OPENSEA_CHAIN_SET.has(chain)) throw new Error(`opensea: unsupported account chain ${chain}`);
-  return chain;
-}
-
-function evmAddress(value, label = "address") {
-  try {
-    return getAddress(String(value || "").trim().toLowerCase());
-  } catch {
-    throw new Error(`opensea: invalid ${label}`);
-  }
-}
-
-function accountAddress(value, chain = null) {
-  const address = String(value || "").trim();
-  if (!address) throw new Error("opensea: account address required");
-  if (chain && !OPENSEA_NON_EVM_CHAINS.has(chain)) return evmAddress(address, "account address");
-  if (!chain && /^0x[0-9a-fA-F]{40}$/.test(address)) return evmAddress(address, "account address");
-  if (!/^[1-9A-HJ-NP-Za-km-z]{32,64}$/.test(address)) throw new Error("opensea: invalid account address");
-  return address;
-}
-
-function positiveDecimal(value, label) {
-  const text = String(value ?? "").trim();
-  if (!/^(?:0|[1-9]\d*)(?:\.\d+)?$/.test(text) || Number(text) <= 0) {
-    throw new Error(`opensea: ${label} must be a positive plain decimal`);
-  }
-  return text;
-}
-
-function positiveInteger(value, label) {
-  const n = Number(value);
-  if (!Number.isSafeInteger(n) || n <= 0) throw new Error(`opensea: ${label} must be a positive integer`);
-  return n;
-}
-
-function isoTime(value, label) {
-  const text = String(value || "").trim();
-  const ms = Date.parse(text);
-  if (!text || !Number.isFinite(ms)) throw new Error(`opensea: ${label} must be an ISO 8601 timestamp`);
-  return { text: new Date(ms).toISOString(), ms };
-}
-
-function normalizeAccountNft(raw = {}, chain, owner) {
-  return {
-    chain,
-    owner,
-    contract: raw.contract || null,
-    tokenId: raw.identifier == null ? null : String(raw.identifier),
-    tokenStandard: raw.token_standard || null,
-    collection: raw.collection || null,
-    name: raw.name || null,
-    description: raw.description || null,
-    imageUrl: raw.display_image_url || raw.image_url || raw.original_image_url || null,
-    originalImageUrl: raw.original_image_url || raw.image_url || null,
-    animationUrl: raw.display_animation_url || raw.original_animation_url || null,
-    metadataUrl: raw.metadata_url || null,
-    marketplaceUrl: raw.opensea_url || null,
-    estimatedValueUsd: raw.estimated_value_usd != null && Number.isFinite(Number(raw.estimated_value_usd))
-      ? Number(raw.estimated_value_usd)
-      : null,
-    spam: raw.is_disabled === true || raw.is_nsfw === true,
-    disabled: raw.is_disabled === true,
-    nsfw: raw.is_nsfw === true,
-    traits: Array.isArray(raw.traits) ? raw.traits : [],
-    updatedAt: raw.updated_at || null,
-    acquisitionCost: null,
-    itemPnl: {
-      status: "unavailable",
-      reason: "OpenSea account inventory does not expose trustworthy per-item acquisition cost",
-    },
-  };
-}
-
 /** Shared request context for the multichain scanner. */
 export function openseaContext(opts = {}) {
   return {
@@ -210,162 +97,3 @@ export async function openseaFloor(slug, opts = {}) {
     },
   };
 }
-
-/** Paginated account NFT inventory for one OpenSea-supported chain. */
-export async function openseaAccountNfts(args = {}, opts = {}) {
-  if (!apiKey(opts)) throw new Error("OPENSEA_API_KEY required");
-  const chain = accountChain(args.chain);
-  const owner = accountAddress(args.address || args.owner, chain);
-  const pageSize = Math.min(Math.max(Number(args.pageSize ?? args.limit ?? 200) || 200, 1), 200);
-  const maxPages = Math.min(Math.max(Number(args.maxPages ?? 5) || 5, 1), 25);
-  const nfts = [];
-  let next = args.next ? String(args.next) : null;
-  let pages = 0;
-
-  do {
-    const url = new URL(`${base(opts)}/chain/${encodeURIComponent(chain)}/account/${encodeURIComponent(owner)}/nfts`);
-    url.searchParams.set("limit", String(pageSize));
-    if (args.collection) url.searchParams.set("collection", String(args.collection));
-    if (next) url.searchParams.set("next", next);
-    const raw = await httpJson(url.toString(), {
-      headers: headers(opts),
-      fetchImpl: opts.fetchImpl,
-      timeoutMs: opts.timeoutMs ?? 20_000,
-    });
-    for (const item of Array.isArray(raw?.nfts) ? raw.nfts : []) {
-      nfts.push(normalizeAccountNft(item, chain, owner));
-    }
-    next = raw?.next ? String(raw.next) : null;
-    pages += 1;
-  } while (next && pages < maxPages);
-
-  return {
-    provider: "opensea-nft",
-    source: "opensea-account-inventory",
-    chain,
-    owner,
-    count: nfts.length,
-    pages,
-    complete: !next,
-    next,
-    nfts,
-    exec: false,
-    readOnly: true,
-  };
-}
-
-/** OpenSea-indexed account PnL. This is account-level, not per-NFT cost basis. */
-export async function openseaAccountPnl(args = {}, opts = {}) {
-  if (!apiKey(opts)) throw new Error("OPENSEA_API_KEY required");
-  const address = accountAddress(args.address || args.owner);
-  const raw = await httpJson(`${base(opts)}/account/${encodeURIComponent(address)}/pnl`, {
-    headers: headers(opts),
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 20_000,
-  });
-  return {
-    provider: "opensea-nft",
-    source: "opensea-indexed-account-pnl",
-    address,
-    scope: "OpenSea-indexed account trading PnL across supported currencies, not per-item NFT cost basis",
-    methodology: "provider-indexed",
-    realizedPnlUsd: raw?.realized_pnl_usd ?? null,
-    unrealizedPnlUsd: raw?.unrealized_pnl_usd ?? null,
-    totalPnlUsd: raw?.total_pnl_usd ?? null,
-    netInvestedUsd: raw?.net_invested_usd ?? null,
-    currentValueUsd: raw?.current_value_usd ?? null,
-    returnPercentage: raw?.return_percentage ?? null,
-    itemLevelPnlAvailable: false,
-    raw,
-    exec: false,
-    readOnly: true,
-  };
-}
-
-function normalizeListingItem(raw = {}) {
-  const chain = accountChain(raw.chain);
-  if (OPENSEA_NON_EVM_CHAINS.has(chain)) {
-    throw new Error("opensea: listing actions currently require an EVM NFT chain");
-  }
-  const start = raw.startTime || raw.start_time
-    ? isoTime(raw.startTime || raw.start_time, "startTime")
-    : { text: new Date().toISOString(), ms: Date.now() };
-  const end = isoTime(raw.endTime || raw.end_time, "endTime");
-  if (end.ms <= start.ms) throw new Error("opensea: endTime must be after startTime");
-  const tokenId = String(raw.tokenId ?? raw.token_id ?? "").trim();
-  if (!/^\d+$/.test(tokenId)) throw new Error("opensea: tokenId must be an unsigned integer string");
-  return {
-    chain,
-    contract: evmAddress(raw.contract, "NFT contract"),
-    token_id: tokenId,
-    quantity: positiveInteger(raw.quantity ?? 1, "quantity"),
-    price: {
-      amount: positiveDecimal(raw.price?.amount ?? raw.amount ?? raw.priceAmount, "price amount"),
-      currency: evmAddress(raw.price?.currency ?? raw.currency ?? ZERO_ADDRESS, "price currency"),
-    },
-    start_time: start.text,
-    end_time: end.text,
-  };
-}
-
-function containsApprovalStep(steps = []) {
-  return steps.some((step) => /approv|setapprovalforall/i.test(JSON.stringify(step)));
-}
-
-/**
- * Ask OpenSea for approval and Seaport signing actions. Nothing is signed,
- * submitted, or broadcast. The user's wallet handles every returned action.
- */
-export async function openseaPrepareList(args = {}, opts = {}) {
-  if (!apiKey(opts)) throw new Error("OPENSEA_API_KEY required");
-  if (args.userConfirmed !== true) {
-    throw new Error("opensea: userConfirmed=true required after NFT, marketplace, price, currency, and expiry review");
-  }
-  const seller = evmAddress(args.seller || args.address || args.owner, "seller");
-  const sourceItems = Array.isArray(args.items) && args.items.length ? args.items : [args];
-  if (sourceItems.length > 50) throw new Error("opensea: at most 50 listing items per preparation");
-  const items = sourceItems.map(normalizeListingItem);
-  const chains = new Set(items.map((item) => item.chain));
-  if (chains.size !== 1) throw new Error("opensea: all prepared listing items must be on one chain");
-  const useCreatorFee = args.useCreatorFee !== false;
-  const request = {
-    address: seller,
-    items,
-    use_creator_fee: useCreatorFee,
-  };
-  if (args.taker) request.taker = evmAddress(args.taker, "taker");
-
-  const raw = await httpJson(`${base(opts)}/listings/actions`, {
-    method: "POST",
-    headers: headers(opts),
-    body: request,
-    fetchImpl: opts.fetchImpl,
-    timeoutMs: opts.timeoutMs ?? 25_000,
-    retries: 0,
-    dedupe: false,
-  });
-  const steps = Array.isArray(raw?.steps) ? raw.steps : [];
-  if (!steps.length) throw new Error("opensea: listing action response contained no wallet steps");
-
-  return stampPrepared({
-    provider: "opensea-nft",
-    marketplace: "opensea",
-    chain: items[0].chain,
-    kind: "nft-list-actions",
-    prepareReady: true,
-    executionReady: false,
-    signingReady: false,
-    broadcastReady: false,
-    requiresUserSignature: true,
-    requiresSeparateApproval: containsApprovalStep(steps),
-    seller,
-    items,
-    useCreatorFee,
-    taker: request.taker || null,
-    feeDisclosure: useCreatorFee
-      ? "Creator fees requested. Inspect the returned Seaport consideration recipients and wallet simulation before signing."
-      : "Creator fees disabled by explicit request. Marketplace protocol fees may still apply and must be inspected before signing.",
-    steps,
-    note: "Execute approvals separately, then sign the Seaport order in the user's wallet. Oracle does not submit or broadcast the listing.",
-  });
-}

package/src/data/providers/satflow.mjs

@@ -330,7 +330,6 @@ export async function satflowPrepareList(args = {}, opts = {}) {
     kind: "list-intent",
     requiresUserSignature: true,
     marketplace: "satflow",
-    listingRequest: body,
     intent: data,
     unsignedPsbt: data?.unsignedListingPSBTBase64 || data?.unsigned_psbt || null,
     note: "Sign listing PSBTs in a Bitcoin wallet; listing broadcast is outside the data plane.",