@oracle-agent/oracle 0.25.2 → 0.25.4

package/README.md

@@ -163,6 +163,38 @@ promise.
 
 ## Coverage
 
+### Universal NFT lifecycle readiness
+
+The public package exposes one canonical NFT lifecycle vocabulary—`mint`,
+`buy`, `list`, `cancel_listing`, and `send`—for deterministic route discovery.
+The lifecycle module is `ROUTE_ONLY`: an advertised operation is not itself an
+unsigned transaction or an execution-readiness claim. Concrete provider
+adapters separately return reviewed unsigned artifacts where implemented. The
+same capabilities and safety checks apply to public and admin callers. Admin
+configuration may set other product fees, but these NFT routes and preparations
+charge zero Oracle fee by default.
+
+Current readiness is deliberately adapter-specific:
+
+- EVM has OpenSea SeaDrop mint, listing, and cancellation preparation plus exact
+  ERC-721/ERC-1155 safe-transfer preparation. OpenSea buy and sweep preparation
+  are disabled until canonical Seaport target and calldata decoding is shipped;
+  read-only best-listing discovery remains available. Other EVM launchpad routes
+  retain their own declared tiers.
+- Solana has the separate Magic Eden buy/list/mint provider plus exact, verified
+  Metaplex NFT/Core transfer preparation. The generic universal Solana mint
+  adapter is `RESEARCH_ONLY` and fails closed until canonical serialized-message
+  decoding exists. Marketplace listing cancellation is not currently exposed.
+- Ordinals has Satflow buy/list, reviewed inscription mint planning, and exact
+  PSBT transfer-plan preparation. Marketplace listing cancellation is not
+  currently exposed.
+
+Concrete public data-plane preparation routes stop at unsigned reviewed
+artifacts; lifecycle route discovery stops earlier at `ROUTE_ONLY`. Solana and
+Ordinals transfers are prepare-stage plans, and adapter capability tiers must
+be checked per route. This is not a claim of universal signing, broadcasting,
+or end-to-end execution readiness.
+
 **11 EVM chains** built in: Ethereum, Optimism, BNB, Polygon, Stable, HyperEVM,
 Abstract, Robinhood Chain, Base, Arbitrum, Avalanche. Plus Solana and Bitcoin L1
 lanes. Solana covers Jupiter quote/prepare, SPL account research, live
@@ -210,7 +242,7 @@ known answer. This matters: the canonical QuoterV2 address also has bytecode on
 Base, but does not price that chain's pairs. A codesize check would have
 allowlisted the wrong contract.
 
-**80 provider modules** in the read/quote catalog, covering **220 unique
+**86 provider modules** in the read/quote catalog, covering **220 unique
 protocols/venues** across EVM, Solana, and Bitcoin (115 EVM + cross-chain, 98
 Solana venues backed by 101 verified Jupiter program IDs, 6 Bitcoin surfaces).
 One module can cover many protocols: the Jupiter module alone routes 98 Solana

package/dist/assets/skills/oracle-desk-product/SKILL.md

@@ -97,7 +97,7 @@ does not prove npm users receive it. A locally hosted model/data/policy loop doe
 a bundled signer. A merged feature is not public until the npm artifact containing it is
 published and inspected.
 
-**Candidate release in this source tree:** public package `@oracle-agent/oracle@0.25.2`
+**Candidate release in this source tree:** public package `@oracle-agent/oracle@0.25.4`
 ships the encrypted local vault + short-lived loopback signer. Hosted/keyless
 Oracle cannot hold keys or move funds. Self-host after `oracle sign init|import` is **auto-armed**
 for user-initiated actions. Public still charges the disclosed fee card; Administrator