@oracle-agent/oracle 0.2.3 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oracle-agent/oracle",
-  "version": "0.2.3",
+  "version": "0.2.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/src/data/providers/aerodrome.mjs

@@ -6,6 +6,7 @@
 import { Interface, getAddress, isAddress } from "ethers";
 import { rpcCall } from "./evm-rpc.mjs";
 import { attachAutoSlippage, bindAutoSlippageGuardToCall } from "../../auto-slippage.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 /** @type {Record<number, { name: string, quoter: string, router: string, factory: string, weth: string, usdc: string }>} */
 export const AERODROME_CHAINS = {
@@ -172,7 +173,7 @@ export async function aerodromePrepareExactIn(q = {}, opts = {}) {
       sqrtPriceLimitX96: 0n,
     },
   ]);
-  return {
+  return stampPrepared({
     provider: "aerodrome",
     calldataReady: true,
     // NOT executable authority. The bytes are assembled but nothing is signed:
@@ -201,7 +202,7 @@ export async function aerodromePrepareExactIn(q = {}, opts = {}) {
       value: nativeInput ? quote.amountIn : "0",
       slippageGuard: bindAutoSlippageGuardToCall(quote.autoSlippage, { chainId, venue: meta.router, data }),
     },
-  };
+  }, { provider: "aerodrome", kind: "aerodrome-exact-in" });
 }
 
 export async function aerodromeHealth(opts = {}) {

package/src/data/providers/balancer.mjs

@@ -3,6 +3,7 @@ import { Interface, getAddress, isAddress } from "ethers";
 import { httpJson } from "../http.mjs";
 import { rpcCall as defaultRpcCall } from "./evm-rpc.mjs";
 import { attachAutoSlippage, bindAutoSlippageGuardToCall } from "../../auto-slippage.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const BALANCER_API = "https://api-v3.balancer.fi/";
 const endpoint = (o = {}) => o.baseUrl || process.env.BALANCER_API_URL || BALANCER_API;
@@ -177,7 +178,7 @@ export async function balancerPrepare(q = {}, opts = {}) {
     wethIsEth,
     userData(q.userData),
   ]);
-  return {
+  return stampPrepared({
     provider: "balancer",
     calldataReady: true,
     // NOT executable authority. The bytes are assembled but nothing is signed:
@@ -204,5 +205,5 @@ export async function balancerPrepare(q = {}, opts = {}) {
       value: nativeInput ? quote.amountIn : "0",
       slippageGuard: bindAutoSlippageGuardToCall(quote.autoSlippage, { chainId: meta.chainId, venue: meta.router, data }),
     },
-  };
+  }, { provider: "balancer", kind: "balancer-tx" });
 }

package/src/data/providers/bridges.mjs

@@ -3,6 +3,7 @@
 import { httpJson } from "../http.mjs";
 import { attachAutoSlippage, bindAutoSlippageGuardToCall, resolveAutoSlippage } from "../../auto-slippage.mjs";
 import { QUOTE_PLACEHOLDER_ADDRESS, quoteAddress } from "../quote-placeholder.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const ACROSS_API = "https://across.to/api";
 export const HOP_API = "https://api.hop.exchange/v1";
@@ -223,7 +224,7 @@ export async function relayPrepare(q = {}, opts = {}) {
     ...(tx.gasLimit != null || tx.gas != null ? { gasLimit: tx.gasLimit ?? tx.gas } : {}),
     slippageGuard: bindAutoSlippageGuardToCall(quote.autoSlippage, { chainId, venue: tx.to, data: tx.data }),
   }));
-  return {
+  return stampPrepared({
     provider: "relay",
     calldataReady: true,
     // NOT executable authority. The bytes are assembled but nothing is signed:
@@ -237,5 +238,5 @@ export async function relayPrepare(q = {}, opts = {}) {
     quote,
     autoSlippage: quote.autoSlippage,
     transactions,
-  };
+  }, { provider: "relay", kind: "relay-tx" });
 }

package/src/data/providers/cowswap.mjs

@@ -7,6 +7,7 @@ import { httpJson } from "../http.mjs";
 import { attachAutoSlippage } from "../../auto-slippage.mjs";
 import { autonomousTradingEnabled } from "../../capability-posture.mjs";
 import { QUOTE_PLACEHOLDER_ADDRESS, quoteAddress } from "../quote-placeholder.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const COW_HOSTS = {
   1: "https://api.cow.fi/mainnet/api/v1",
@@ -263,7 +264,7 @@ export async function cowPrepareOrder(q = {}, opts = {}) {
   const typedDataHash = TypedDataEncoder.hash(domain, COW_ORDER_TYPES, order);
   const relayer = COW_VAULT_RELAYER[chainId];
   if (!relayer) throw new Error(`cowswap: vault relayer not registered for chain ${chainId}`);
-  return {
+  return stampPrepared({
     provider: "cowswap",
     orderReady: true,
     executionReady: false,
@@ -298,7 +299,7 @@ export async function cowPrepareOrder(q = {}, opts = {}) {
       spender: getAddress(relayer).toLowerCase(),
       amount: order.sellAmount,
     },
-  };
+  }, { provider: "cowswap", kind: "cow-order" });
 }
 
 export async function cowOrderStatus(q = {}, opts = {}) {
@@ -346,7 +347,7 @@ export function cowPrepareCancel(q = {}) {
   if (!orderUids.length) throw new Error("cowswap: orderUids required");
   const domain = orderDomain(chainId);
   const message = { orderUids };
-  return {
+  return stampPrepared({
     provider: "cowswap",
     chainId,
     owner,
@@ -355,7 +356,7 @@ export function cowPrepareCancel(q = {}) {
     typedData: { domain, types: COW_CANCEL_TYPES, primaryType: "OrderCancellations", message },
     cancelReady: true,
     executableArtifact: true,
-  };
+  }, { provider: "cowswap", kind: "cow-cancel" });
 }
 
 export async function cowSignCancel(_a = {}, _o = {}) {

package/src/data/providers/curve.mjs

@@ -3,6 +3,7 @@ import { Interface, getAddress, isAddress } from "ethers";
 import { httpJson } from "../http.mjs";
 import { rpcCall as defaultRpcCall } from "./evm-rpc.mjs";
 import { attachAutoSlippage, bindAutoSlippageGuardToCall } from "../../auto-slippage.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const CURVE_API = "https://api.curve.finance/v1";
 const base = (o = {}) => (o.baseUrl || process.env.CURVE_API_URL || CURVE_API).replace(/\/$/, "");
@@ -170,7 +171,7 @@ export async function curvePrepare(q = {}, opts = {}) {
     pools,
     receiver,
   ]);
-  return {
+  return stampPrepared({
     provider: "curve",
     calldataReady: true,
     // NOT executable authority. The bytes are assembled but nothing is signed:
@@ -196,5 +197,5 @@ export async function curvePrepare(q = {}, opts = {}) {
       value: "0",
       slippageGuard: bindAutoSlippageGuardToCall(quote.autoSlippage, { chainId, venue: router, data }),
     },
-  };
+  }, { provider: "curve", kind: "curve-tx" });
 }

package/src/data/providers/gmx.mjs

@@ -4,6 +4,7 @@
 import { Interface, getAddress, isAddress } from "ethers";
 import { httpJson } from "../http.mjs";
 import { rpcCall as defaultRpcCall, transactionReceipt } from "./evm-rpc.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const GMX_API = Object.freeze({
   42161: "https://arbitrum-api.gmxinfra.io",
@@ -468,7 +469,7 @@ export async function gmxPrepareOrder(args = {}, opts = {}) {
     asyncExecution: true,
     issuedAtMs: Number(opts.nowMs ?? Date.now()),
   };
-  return {
+  return stampPrepared({
     provider: "gmx",
     chainId: meta.chainId,
     chain: meta.name,
@@ -491,5 +492,5 @@ export async function gmxPrepareOrder(args = {}, opts = {}) {
       value: executionFee.toString(),
       gmxGuard,
     },
-  };
+  }, { provider: "gmx", kind: "gmx-order" });
 }

package/src/data/providers/hl-staking.mjs

@@ -10,6 +10,7 @@
 //   validator -> staking balance : tokenDelegate (isUndelegate=true)   [1 day validator lockup]
 //   staking balance -> spot      : cWithdraw                            [7 day unstaking queue]
 
+import { stampPrepared } from "../../prepare-envelope.mjs";
 import { httpJson } from "../http.mjs";
 import { hlInfo } from "./hl-info.mjs";
 export const HYPE_STAKING_DECIMALS = 8;
@@ -171,7 +172,7 @@ function eip712Domain(opts = {}) {
 }
 
 function preparedAction({ kind, action, types, primaryType, message, opts, notes, caps }) {
-  return {
+  return stampPrepared({
     provider: "hl-staking",
     venue: "hypercore",
     chain: hyperliquidChain(opts),
@@ -194,7 +195,7 @@ function preparedAction({ kind, action, types, primaryType, message, opts, notes
     caps: caps || null,
     notes,
     exec: false,
-  };
+  }, { provider: "hl-staking", kind });
 }
 
 /** spot HYPE -> staking balance. Instant. */

package/src/data/providers/jupiter.mjs

@@ -3,6 +3,7 @@
 
 import { httpJson } from "../http.mjs";
 import { solanaPubkey } from "./solana-rpc.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const JUPITER_SWAP_API = "https://lite-api.jup.ag/swap/v1";
 export const SOL_MINT = "So11111111111111111111111111111111111111112";
@@ -158,7 +159,7 @@ export async function jupiterPrepareSwap(args = {}, opts = {}) {
     }
   }
 
-  return {
+  return stampPrepared({
     provider: "jupiter",
     chain: "solana-mainnet-beta",
     prepareReady: true,
@@ -178,5 +179,5 @@ export async function jupiterPrepareSwap(args = {}, opts = {}) {
     prioritizationFeeLamports: response?.prioritizationFeeLamports ?? null,
     computeUnitLimit: response?.computeUnitLimit ?? null,
     raw: response,
-  };
+  }, { provider: "jupiter", kind: "jupiter-swap" });
 }

package/src/data/providers/lifi.mjs

@@ -3,6 +3,7 @@
 import { httpJson } from "../http.mjs";
 import { attachAutoSlippage, bindAutoSlippageGuardToCall, resolveAutoSlippage } from "../../auto-slippage.mjs";
 import { QUOTE_PLACEHOLDER_ADDRESS, quoteAddress } from "../quote-placeholder.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const LIFI_API = "https://li.quest/v1";
 
@@ -116,7 +117,7 @@ export async function lifiPrepare(q = {}, opts = {}) {
       amount: String(q.fromAmount),
     };
   }
-  return {
+  return stampPrepared({
     provider: "lifi",
     calldataReady: true,
     // NOT executable authority. The bytes are assembled but nothing is signed:
@@ -139,7 +140,7 @@ export async function lifiPrepare(q = {}, opts = {}) {
       ...(tx.gasLimit != null ? { gasLimit: tx.gasLimit } : {}),
       slippageGuard: bindAutoSlippageGuardToCall(quote.autoSlippage, { chainId, venue: tx.to, data: tx.data }),
     },
-  };
+  }, { provider: "lifi", kind: "lifi-tx" });
 }
 
 export async function lifiChains(opts = {}) {

package/src/data/providers/odos.mjs

@@ -16,6 +16,7 @@
 import { isAddress } from "ethers";
 import { httpJson } from "../http.mjs";
 import { attachAutoSlippage, bindAutoSlippageGuardToCall, resolveAutoSlippage } from "../../auto-slippage.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const ODOS_API = "https://api.odos.xyz";
 const base = (o = {}) => (o.baseUrl || process.env.ODOS_API_URL || ODOS_API).replace(/\/$/, "");
@@ -121,7 +122,7 @@ export async function odosPrepare(args = {}, opts = {}) {
   const approvals = args.inputTokens
     .filter((item) => ![native, zeroNative].includes(String(item.tokenAddress).toLowerCase()))
     .map((item) => ({ token: item.tokenAddress, spender: tx.to, amount: String(item.amount) }));
-  return {
+  return stampPrepared({
     provider: "odos",
     calldataReady: true,
     // NOT executable authority. The bytes are assembled but nothing is signed:
@@ -146,7 +147,7 @@ export async function odosPrepare(args = {}, opts = {}) {
       ...(tx.nonce != null ? { nonce: tx.nonce } : {}),
       slippageGuard: bindAutoSlippageGuardToCall(quote.autoSlippage, { chainId, venue: tx.to, data: tx.data }),
     },
-  };
+  }, { provider: "odos", kind: "odos-tx" });
 }
 
 export async function odosHealth(opts = {}) {

package/src/data/providers/oneinch.mjs

@@ -3,6 +3,7 @@
 import { httpJson } from "../http.mjs";
 import { attachAutoSlippage, bindAutoSlippageGuardToCall, resolveAutoSlippage } from "../../auto-slippage.mjs";
 import { resolveProviderEndpoint, credentialedHeaders } from "../provider-endpoint.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const ONEINCH_API = "https://api.1inch.dev/swap/v6.0";
 
@@ -146,7 +147,7 @@ export async function oneinchPrepare(q = {}, opts = {}) {
     if (!spender) throw new Error("1inch: ERC-20 route missing approval spender");
     requiresApproval = { token: src, spender, amount: String(amount) };
   }
-  return {
+  return stampPrepared({
     provider: "oneinch",
     calldataReady: true,
     // NOT executable authority. The bytes are assembled but nothing is signed:
@@ -169,5 +170,5 @@ export async function oneinchPrepare(q = {}, opts = {}) {
       ...(tx.gas != null ? { gasLimit: tx.gas } : {}),
       slippageGuard: bindAutoSlippageGuardToCall(quote.autoSlippage, { chainId, venue: tx.to, data: tx.data }),
     },
-  };
+  }, { provider: "oneinch", kind: "oneinch-tx" });
 }

package/src/data/providers/paraswap.mjs

@@ -1,6 +1,7 @@
 // ParaSwap/Velora public market API — keyless price routes, quote-only here.
 import { httpJson } from "../http.mjs";
 import { attachAutoSlippage, bindAutoSlippageGuardToCall } from "../../auto-slippage.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const PARASWAP_API = "https://api.paraswap.io";
 const base = (o = {}) => (o.baseUrl || process.env.PARASWAP_API_URL || PARASWAP_API).replace(/\/$/, "");
@@ -82,7 +83,7 @@ export async function paraswapPrepare(args = {}, opts = {}) {
   if (Number(tx.chainId ?? chainId) !== chainId) throw new Error("paraswap: transaction chain mismatch");
   if (String(tx.to || "").toLowerCase() !== expectedTarget) throw new Error("paraswap: transaction target mismatch");
   if (tx.from && String(tx.from).toLowerCase() !== userAddress) throw new Error("paraswap: transaction sender mismatch");
-  return {
+  return stampPrepared({
     provider: "paraswap",
     calldataReady: true,
     // NOT executable authority. The bytes are assembled but nothing is signed:
@@ -107,7 +108,7 @@ export async function paraswapPrepare(args = {}, opts = {}) {
       ...(tx.gas != null ? { gasLimit: tx.gas } : {}),
       slippageGuard: bindAutoSlippageGuardToCall(quote.autoSlippage, { chainId, venue: tx.to, data: tx.data }),
     },
-  };
+  }, { provider: "paraswap", kind: "paraswap-tx" });
 }
 
 export async function paraswapHealth(opts = {}) {

package/src/data/providers/zerox.mjs

@@ -3,6 +3,7 @@
 import { httpJson } from "../http.mjs";
 import { attachAutoSlippage, bindAutoSlippageGuardToCall, resolveAutoSlippage } from "../../auto-slippage.mjs";
 import { resolveProviderEndpoint, credentialedHeaders } from "../provider-endpoint.mjs";
+import { stampPrepared } from "../../prepare-envelope.mjs";
 
 export const ZEROX_API = "https://api.0x.org";
 
@@ -137,7 +138,7 @@ export async function zeroxPrepare(q = {}, opts = {}) {
   if (!tx?.to || !tx?.data) throw new Error("0x: firm quote returned no transaction");
   const chainId = Number(q.chainId ?? 8453);
   const spender = quote?.issues?.allowance?.spender || quote?.allowanceTarget;
-  return {
+  return stampPrepared({
     provider: "zerox",
     calldataReady: true,
     // NOT executable authority. The bytes are assembled but nothing is signed:
@@ -162,5 +163,5 @@ export async function zeroxPrepare(q = {}, opts = {}) {
       ...(tx.gas != null ? { gasLimit: tx.gas } : {}),
       slippageGuard: bindAutoSlippageGuardToCall(quote.autoSlippage, { chainId, venue: tx.to, data: tx.data }),
     },
-  };
+  }, { provider: "zerox", kind: "zerox-tx" });
 }

package/src/router/prepare-bridge.mjs

@@ -23,6 +23,7 @@
 // Custody is unchanged: artifacts only. This module cannot sign or broadcast.
 
 import { bestBridgeRoute } from "./index.mjs";
+import { stampPrepared } from "../prepare-envelope.mjs";
 
 const ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
 
@@ -249,7 +250,7 @@ export async function prepareBestBridgeRoute(p, opts = {}) {
     );
   }
 
-  return {
+  return stampPrepared({
     ok: true,
     chosen: {
       source: chosenSource,
@@ -284,5 +285,5 @@ export async function prepareBestBridgeRoute(p, opts = {}) {
     note:
       `UNSIGNED. ${txs.length} transaction(s) on chain ${fromChainId}, crediting ` +
       `chain ${toChainId}. Verify every destination address before signing.`,
-  };
+  }, { provider: "router", kind: "best-bridge" });
 }

package/src/router/prepare-route.mjs

@@ -26,6 +26,7 @@
 // Custody is unchanged: this returns artifacts to sign. It cannot sign or broadcast.
 
 import { bestSwapRoute } from "./index.mjs";
+import { stampPrepared } from "../prepare-envelope.mjs";
 
 export const ARTIFACT = Object.freeze({
   /** Unsigned EVM transaction: wallet signs and broadcasts it. */
@@ -298,7 +299,7 @@ export async function prepareBestRoute(p, opts = {}) {
     .filter((r) => r.source !== chosenSource)
     .map((r) => ({ source: r.source, netOut: r.netOut, gasUsd: r.gasUsd }));
 
-  return {
+  return stampPrepared({
     ok: true,
     chosen: {
       source: chosenSource,
@@ -337,5 +338,5 @@ export async function prepareBestRoute(p, opts = {}) {
       "UNSIGNED. Verify the destination address and minOut against a fresh quote " +
       "immediately before signing -- a quote-time minimum is not a minimum at " +
       "broadcast time.",
-  };
+  }, { provider: "router", kind: "best-route" });
 }