0xtrails 0.16.2 → 0.17.1

package/dist/onramp/meshconnect.js

@@ -1,124 +0,0 @@
-import { getActiveMeshMode as o } from "./TrailsOnRampProvider.js";
-import { TrailsOnrampRpcClient as A } from "@0xtrails/api/onramp";
-var w = 3e4, x = 5e3, p = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), M = /* @__PURE__ */ new Map(), I = /* @__PURE__ */ new Map(), T = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new Map();
-function g(e) {
-  const n = (t, a) => {
-    const r = {};
-    return e?.jwt && e.jwt.length > 0 && (r.Authorization = `BEARER ${e.jwt}`), e?.apiKey && e.apiKey.length > 0 && (r["X-Access-Key"] = e.apiKey), a = a || {}, a.headers = {
-      ...a.headers,
-      ...r
-    }, fetch(t, a);
-  };
-  return new A(e?.hostname && e.hostname.length > 0 ? e.hostname : "https://trails-api.sequence.app", n);
-}
-function m(e) {
-  return JSON.stringify({
-    hostname: e?.hostname ?? "",
-    apiKey: e?.apiKey ?? "",
-    jwt: e?.jwt ?? "",
-    environment: o(e)
-  });
-}
-async function k(e) {
-  const n = m(e), t = p.get(n);
-  if (t && t.expiresAt > Date.now()) return t.integrations;
-  const a = l.get(n);
-  if (a) return a;
-  const r = g(e), c = { environment: o(e) }, h = r.getMeshIntegrations(c).then((s) => {
-    const i = s.integrations || [];
-    return p.set(n, {
-      integrations: i,
-      expiresAt: Date.now() + w
-    }), i;
-  }).finally(() => {
-    l.delete(n);
-  });
-  return l.set(n, h), h;
-}
-async function d(e, n) {
-  return (await k(n)).find((t) => t.key === e)?.id;
-}
-async function f(e) {
-  return await d("coinbaseRamp", e) ?? d("coinbase", e);
-}
-async function v(e) {
-  return await d("binanceInternationalDirect", e) ?? d("binanceInternational", e);
-}
-async function b(e) {
-  return await d("bitfinexDirect", e) ?? d("bitfinex", e);
-}
-async function K(e, n) {
-  const t = e.authOnly === !0 || !(e.address && e.symbol && e.destinationChainId !== void 0 && e.destinationChainId !== null && e.amount), a = JSON.stringify({
-    config: m(n),
-    request: {
-      authOnly: t,
-      userId: e.userId ?? "",
-      address: t ? "" : e.address ?? "",
-      symbol: t ? "" : e.symbol ?? "",
-      amount: t ? "" : e.amount ?? "",
-      destinationChainId: t ? "" : e.destinationChainId?.toString() ?? "",
-      integrationId: e.integrationId ?? "",
-      exchangeType: e.exchangeType ?? "",
-      restrictMultipleAccounts: e.restrictMultipleAccounts ?? !1,
-      transactionId: e.transactionId ?? ""
-    }
-  }), r = M.get(a);
-  if (r && r.expiresAt > Date.now()) return r.response;
-  const c = I.get(a);
-  if (c) return c;
-  const h = g(n), s = {
-    environment: o(n),
-    clientId: n?.mesh?.clientId ?? n?.clientId,
-    authOnly: t,
-    userId: e.userId,
-    integrationId: e.integrationId,
-    exchangeType: e.exchangeType,
-    transactionId: e.transactionId,
-    restrictMultipleAccounts: e.restrictMultipleAccounts
-  };
-  t || (s.recipientAddress = e.address, s.tokenSymbol = e.symbol, s.destinationChainId = e.destinationChainId?.toString(), s.amount = e.amount);
-  const i = h.createMeshLinkToken(s).then((u) => (M.set(a, {
-    response: u,
-    expiresAt: Date.now() + x
-  }), u)).finally(() => {
-    I.delete(a);
-  });
-  return I.set(a, i), i;
-}
-async function O(e, n) {
-  const t = JSON.stringify({
-    config: m(n),
-    request: {
-      integrationId: e.integrationId ?? "",
-      exchangeType: e.exchangeType ?? "",
-      chainIds: e.chainIds ?? []
-    }
-  }), a = T.get(t);
-  if (a && a.expiresAt > Date.now()) return a.tokens;
-  const r = y.get(t);
-  if (r) return r;
-  const c = g(n), h = {
-    environment: o(n),
-    integrationId: e.integrationId,
-    exchangeType: e.exchangeType,
-    chainIds: e.chainIds
-  }, s = c.getMeshSupportedTokens(h).then((i) => {
-    const u = i.tokens || [];
-    return T.set(t, {
-      tokens: u,
-      expiresAt: Date.now() + w
-    }), u;
-  }).finally(() => {
-    y.delete(t);
-  });
-  return y.set(t, s), s;
-}
-export {
-  K as createMeshLinkToken,
-  v as getBinanceIntegrationId,
-  b as getBitfinexIntegrationId,
-  f as getCoinbaseIntegrationId,
-  d as getMeshIntegrationId,
-  k as getMeshIntegrations,
-  O as getMeshSupportedTokens
-};

package/dist/onramp/trailsOnramp.d.ts

@@ -1,32 +0,0 @@
-import { default as React } from 'react';
-import { SelectedMeshExchange } from './MeshConnectFlow.js';
-import { TrailsOnRampConfig } from './TrailsOnRampProvider.js';
-export interface OnrampWidgetHandlers {
-    setCurrentScreen: (screen: string) => void;
-    onComplete?: (transferData: unknown) => void;
-    onError?: (error: unknown) => void;
-    onBack?: () => void;
-    authOnly?: boolean;
-    accessTokens?: Array<{
-        accountId: string;
-        accountName: string;
-        accessToken: string;
-        brokerType: string;
-        brokerName: string;
-    }>;
-    toTokenSymbol?: string;
-    toTokenAmount?: string;
-    toChainId?: number;
-    toRecipientAddress?: string;
-    toAmountUsd?: number;
-    selectedExchange?: SelectedMeshExchange;
-    apiKey?: string;
-    hostname?: string;
-}
-export type OnrampFactory = (handlers: OnrampWidgetHandlers) => React.ReactElement;
-export declare function normalizeTrailsOnrampConfig(config?: TrailsOnRampConfig): TrailsOnRampConfig | undefined;
-export declare function getTrailsOnrampConfig(factory?: OnrampFactory): TrailsOnRampConfig | undefined;
-export declare function trailsOnramp(options: {
-    config?: TrailsOnRampConfig;
-}): OnrampFactory;
-//# sourceMappingURL=trailsOnramp.d.ts.map

package/dist/onramp/trailsOnramp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trailsOnramp.d.ts","sourceRoot":"","sources":["../../src/onramp/trailsOnramp.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAEhE,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAA;AAElC,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,IAAI,CAAA;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAC,CAAA;IACF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,QAAQ,EAAE,oBAAoB,KAC3B,KAAK,CAAC,YAAY,CAAA;AAMvB,wBAAgB,2BAA2B,CACzC,MAAM,CAAC,EAAE,kBAAkB,GAC1B,kBAAkB,GAAG,SAAS,CAsBhC;AAED,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,aAAa,GACtB,kBAAkB,GAAG,SAAS,CAIhC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAC5B,GAAG,aAAa,CA4EhB"}

package/dist/onramp/trailsOnramp.js

@@ -1,64 +0,0 @@
-import { logger as e } from "../logger/index.js";
-import { TrailsOnRampProvider as x } from "./TrailsOnRampProvider.js";
-import { MeshConnectFlow as A } from "./MeshConnectFlow.js";
-import { jsx as a } from "react/jsx-runtime";
-function s(o) {
-  if (o)
-    return o.mesh ? {
-      ...o,
-      mesh: {
-        environment: "production",
-        ...o.mesh
-      },
-      bluvo: o.bluvo ? {
-        environment: "production",
-        ...o.bluvo
-      } : o.bluvo
-    } : o;
-}
-function R(o) {
-  return s(o?.trailsOnrampConfig);
-}
-function S(o) {
-  const n = s(o.config), t = (i) => {
-    const { setCurrentScreen: p, onComplete: r, onError: c, onBack: l, authOnly: d, accessTokens: u, toTokenSymbol: h, toTokenAmount: C, toChainId: f, toRecipientAddress: g, toAmountUsd: y, selectedExchange: v, apiKey: O, hostname: b } = i, k = () => {
-      l ? l() : p("home");
-    }, T = (m) => {
-      if (e.console.log("[onramp] handleComplete called:", {
-        hasOnComplete: !!r,
-        transferData: m
-      }), r) try {
-        e.console.log("[onramp] Calling onComplete from widget handlers"), r(m), e.console.log("[onramp] onComplete called successfully");
-      } catch (w) {
-        e.console.error("[onramp] Error in onComplete:", w);
-      }
-      else e.console.warn("[onramp] onComplete handler not provided by widget");
-    };
-    return /* @__PURE__ */ a(x, {
-      config: {
-        ...n,
-        apiKey: O || n?.apiKey,
-        hostname: b || n?.hostname
-      },
-      children: /* @__PURE__ */ a(A, {
-        onBack: k,
-        onComplete: T,
-        onError: c,
-        authOnly: d,
-        accessTokens: u,
-        toTokenSymbol: h,
-        toTokenAmount: C,
-        toChainId: f,
-        toRecipientAddress: g,
-        toAmountUsd: y,
-        selectedExchange: v
-      })
-    });
-  };
-  return t.trailsOnrampConfig = n, t;
-}
-export {
-  R as getTrailsOnrampConfig,
-  s as normalizeTrailsOnrampConfig,
-  S as trailsOnramp
-};

package/dist/onramp-client/index.d.ts

@@ -1,13 +0,0 @@
-import { TrailsApi } from '@0xtrails/api';
-import { TrailsOnrampRpcClient } from '@0xtrails/api/onramp';
-export type * from '@0xtrails/api/onramp';
-export interface TrailsOnrampOptions {
-    apiKey?: string;
-    jwt?: string;
-    hostname?: string;
-}
-export declare class TrailsOnramp extends TrailsOnrampRpcClient {
-    static fromTrailsApiClient(client: TrailsApi): TrailsOnramp;
-    constructor(apiKey: string, options?: TrailsOnrampOptions);
-}
-//# sourceMappingURL=index.d.ts.map

package/dist/onramp-client/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/onramp-client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,mBAAmB,sBAAsB,CAAA;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,YAAa,SAAQ,qBAAqB;IACrD,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,YAAY;gBAM/C,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAkC1D"}

package/dist/onramp-client/index.js

@@ -1,19 +0,0 @@
-import { TrailsOnrampRpcClient as h } from "@0xtrails/api/onramp";
-var l = class extends h {
-  static fromTrailsApiClient(e) {
-    return new h(e.getHostname(), e.getFetch());
-  }
-  constructor(e, t) {
-    const c = (n, s) => {
-      const a = {};
-      return t?.jwt && t?.jwt.length > 0 && (a.Authorization = `BEARER ${t?.jwt}`), e && e.length > 0 && (a["X-Access-Key"] = e), s = s || {}, s.headers = {
-        ...s.headers,
-        ...a
-      }, fetch(n, s);
-    }, r = t?.hostname && t?.hostname.length > 0 ? t?.hostname : "https://trails-api.sequence.app";
-    super(r.endsWith("/") ? r.slice(0, -1) : r, c);
-  }
-};
-export {
-  l as TrailsOnramp
-};

package/dist/onrampClient.d.ts

@@ -1,10 +0,0 @@
-import { TrailsOnramp } from './onramp-client/index.js';
-export type OnrampClientConfig = {
-    apiKey: string;
-    jwt?: string;
-    hostname?: string;
-};
-export declare function getOnrampClient({ apiKey, jwt, hostname, }: OnrampClientConfig): TrailsOnramp;
-export { TrailsOnramp } from './onramp-client/index.js';
-export declare const useOnrampClient: (configOverride?: Partial<OnrampClientConfig>) => TrailsOnramp;
-//# sourceMappingURL=onrampClient.d.ts.map

package/dist/onrampClient.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"onrampClient.d.ts","sourceRoot":"","sources":["../src/onrampClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAKvD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,GAAG,EACH,QAAQ,GACT,EAAE,kBAAkB,GAAG,YAAY,CAKnC;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,eAAO,MAAM,eAAe,GAC1B,iBAAiB,OAAO,CAAC,kBAAkB,CAAC,iBA8B7C,CAAA"}

package/dist/onrampClient.js

@@ -1,31 +0,0 @@
-import { TrailsOnramp as o } from "./onramp-client/index.js";
-import { useTrailsOnRamp as i } from "./onramp/TrailsOnRampProvider.js";
-import { useTrails as m } from "./widget/providers/TrailsProvider.js";
-import { useMemo as p } from "react";
-function r({ apiKey: t, jwt: n, hostname: a }) {
-  return new o(t, {
-    jwt: n,
-    hostname: a
-  });
-}
-var f = (t) => {
-  const n = m(), a = i();
-  return p(() => r({
-    apiKey: t?.apiKey || a?.config.apiKey || n.trailsApiKey || "",
-    hostname: t?.hostname || a?.config.hostname || n.trailsApiUrl,
-    jwt: t?.jwt ?? a?.config.jwt
-  }), [
-    t?.hostname,
-    t?.apiKey,
-    t?.jwt,
-    a?.config.apiKey,
-    a?.config.hostname,
-    a?.config.jwt,
-    n.trailsApiKey,
-    n.trailsApiUrl
-  ]);
-};
-export {
-  r as getOnrampClient,
-  f as useOnrampClient
-};

package/dist/package.js

@@ -1,123 +0,0 @@
-var t = "0xtrails", e = "0.16.2", i = "SDK for Trails", s = "module", a = "./dist/index.js", r = "./dist/index.js", d = "./dist/index.d.ts";
-var c = { access: "public" }, o = ["dist"], n = {
-  build: "rimraf dist && pnpm run build:css && pnpm run build:vite && pnpm run build:patch && pnpm run build:umd",
-  "build:patch": "node scripts/apply-react-patch.cjs",
-  "build:vite": "vite build --config vite.config.ts --mode production",
-  "build:umd": "BUILD_MODE=umd vite build --config vite.umd.config.ts --mode production && pnpm run build:copy-umd-js",
-  "build:copy-umd-js": "mkdir -p ../../apps/trails-demo/public/js && cp ./dist/umd/trails.min.js ../../apps/trails-demo/public/js/trails.min.js",
-  "build:css": "node ./scripts/css/compile-tailwind.mjs",
-  dev: "pnpm run build:vite --watch",
-  test: "RUN_TEST_SCENARIOS=false vitest",
-  "test:run": "RUN_TEST_SCENARIOS=false vitest --run",
-  "test:scenarios": "RUN_TEST_SCENARIOS=true vitest --run test/scenarios/useQuote.test.tsx",
-  "test:tui": "tsx test/tui/index.ts",
-  clean: "rimraf dist node_modules",
-  typecheck: "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
-  lint: "biome lint ./src",
-  "lint:fix": "biome lint --write ./src",
-  format: "biome format --write ./src",
-  "icons:generate": "node scripts/generate-widget-svg-components.mjs",
-  createRecoveryScenario: "vite-node --config ./vite.config.ts ./scripts/createRecoveryScenario.tsx",
-  recoverFunds: "vite-node --config ./vite.config.ts ./scripts/recoverFunds.tsx"
-}, p = [
-  "trails",
-  "sdk",
-  "wallet"
-];
-var l = "Apache-2.0", u = {
-  "@0xsequence/indexer": "^3.0.4",
-  "@0xsequence/metadata": "^3.0.4",
-  "@0xsequence/wallet-primitives": "3.0.0-beta.19",
-  "@0xtrails/api": "workspace:*",
-  "@0xtrails/wallet": "workspace:*",
-  "@databeat/tracker": "0.9.3",
-  "@emotion/is-prop-valid": "1.4.0",
-  "@meshconnect/web-link-sdk": "3.7.1",
-  "@radix-ui/react-tooltip": "1.2.8",
-  "@tanstack/query-persist-client-core": "^5.91.19",
-  "@tanstack/react-virtual": "^3.13.14",
-  "@walletconnect/ethereum-provider": "^2.22.4",
-  "lucide-react": "catalog:",
-  motion: "catalog:",
-  ox: "catalog:",
-  qrcode: "1.5.4"
-}, v = {
-  "@tailwindcss/postcss": "^4.2.1",
-  "@testing-library/jest-dom": "6.9.1",
-  "@testing-library/react": "16.3.2",
-  "@types/node": "catalog:",
-  "@types/qrcode": "1.5.6",
-  "@types/react": "catalog:",
-  "@types/react-dom": "catalog:",
-  "@vitejs/plugin-react": "catalog:",
-  "@vitest/coverage-v8": "4.0.18",
-  cssnano: "^7.1.2",
-  dotenv: "17.2.4",
-  "happy-dom": "20.6.1",
-  postcss: "^8.5.6",
-  react: "catalog:",
-  "react-dom": "catalog:",
-  table: "6.9.0",
-  tailwindcss: "catalog:",
-  tsx: "4.21.0",
-  typescript: "catalog:",
-  viem: "catalog:",
-  vite: "catalog:",
-  "vite-node": "6.0.0",
-  "vite-plugin-dts": "catalog:",
-  vitest: "4.0.18"
-}, m = {
-  "@tanstack/react-query": "^5.90.20",
-  react: "^18.0.0 || ^19.0.0",
-  "react-dom": "^18.0.0 || ^19.0.0",
-  viem: "^2.41.0"
-}, g = {
-  ".": {
-    types: "./dist/index.d.ts",
-    import: "./dist/index.js",
-    require: "./dist/index.js"
-  },
-  "./actions": {
-    types: "./dist/actions/index.d.ts",
-    import: "./dist/actions/index.js",
-    require: "./dist/actions/index.js"
-  },
-  "./hydrate": {
-    types: "./dist/hydrate/index.d.ts",
-    import: "./dist/hydrate/index.js",
-    require: "./dist/hydrate/index.js"
-  },
-  "./hooks": {
-    types: "./dist/hooks/index.d.ts",
-    import: "./dist/hooks/index.js",
-    require: "./dist/hooks/index.js"
-  },
-  "./widget": {
-    types: "./dist/widget/index.d.ts",
-    import: "./dist/widget/index.js",
-    require: "./dist/widget/index.js"
-  }
-}, x = {
-  name: t,
-  version: e,
-  description: i,
-  type: s,
-  main: a,
-  module: r,
-  types: d,
-  sideEffects: !1,
-  publishConfig: c,
-  private: !1,
-  files: o,
-  scripts: n,
-  keywords: p,
-  author: "",
-  license: l,
-  dependencies: u,
-  devDependencies: v,
-  peerDependencies: m,
-  exports: g
-};
-export {
-  x as default
-};

package/dist/placeholder.d.ts

@@ -1,142 +0,0 @@
-export type PlaceholderErrorCode = "MULTIPLE_AMOUNT_SLOTS" | "INVALID_AMOUNT_OFFSET";
-export declare class PlaceholderError extends Error {
-    readonly code: PlaceholderErrorCode;
-    constructor(code: PlaceholderErrorCode, message: string, cause?: unknown);
-}
-/**
- * Sentinel uint256 used internally by the SDK to mark a calldata slot that
- * should be hydrated with the wallet's token balance at runtime.
- *
- * **Internal SDK use only.** Do not pass this value directly in contract
- * calldata - it is not a valid amount and will cause transactions to revert.
- * Instead, pass it as the `amount` / `amountIn` field when building calls via
- * SDK helpers (e.g. `buildUniswapV3ExactInputCall`). `encodeMulticallHydrateExecute`
- * will detect this sentinel and replace it with the correct `erc20Balance / self`
- * hydration entry before the calldata is submitted on-chain.
- *
- * Hash-derived from
- * `keccak256(utf8("sequence.trails.hydrate.amount.sentinel.v1"))`.
- */
-export declare const TRAILS_HYDRATE_PLACEHOLDER_AMOUNT = 114316045351081986197366228715807272115562181347258027827511447451103061843027n;
-/**
- * @deprecated Use `TRAILS_HYDRATE_PLACEHOLDER_AMOUNT` instead.
- */
-export declare const TRAILS_ROUTER_PLACEHOLDER_AMOUNT = 114316045351081986197366228715807272115562181347258027827511447451103061843027n;
-/**
- * should be hydrated with `address(this)` (the intent wallet) at runtime.
- *
- * **Internal SDK use only.** Do not submit this address directly in contract
- * calldata - it is not a real address and will cause transactions to revert.
- * Pass it as the `recipient` (or any address field) when building calls via
- * SDK helpers. `encodeMulticallHydrateExecute` will detect it and replace the
- * slot with an `address / self` hydration entry before on-chain submission.
- *
- * @example
- * ```ts
- * import { TRAILS_HYDRATE_SELF_ADDRESS } from "0xtrails"
- *
- * swapExactOutputSingle({
- *   ...
- *   recipient: TRAILS_HYDRATE_SELF_ADDRESS,
- * })
- * ```
- *
- * Hash-derived from:
- * `uint160(uint256(keccak256(utf8("sequence.trails.hydrate.address.sentinel.v1"))))`
- * = `0xd80d3a37a85094663c36c062e5ef689f2bf54fca`.
- */
-export declare const TRAILS_HYDRATE_SELF_ADDRESS: "0xd80d3a37a85094663c36c062e5ef689f2bf54fca";
-/**
- * Returns all byte offsets where the ABI-padded `TRAILS_HYDRATE_SELF_ADDRESS`
- * sentinel appears in calldata.
- *
- * ABI encoding pads a 20-byte address to 32 bytes (12 zero bytes prefix).
- * The returned offsets point to the start of the 20-byte address within the
- * slot (i.e. `slotStart + 12`), which is the correct `calldataOffset` for
- * `HydrateProxy.replaceAddress`.
- *
- * Scanning is restricted to word-aligned slot starts (bytes 4, 36, 68, ...).
- * This prevents spurious matches when sentinels with periodic byte patterns
- * (for example, `deadbeef...`) sit adjacent to other sentinels in calldata.
- * An ABI-padded self-address slot followed by the 32-byte amount sentinel can
- * create one long contiguous `deadbeef` run; a naive byte-pattern search could
- * misreport padding bytes inside the amount slot as an address match. Word-
- * aligned scanning avoids that corruption.
- */
-export declare function getSelfAddressOffsets(calldata: `0x${string}`): number[];
-/**
- * Find the byte offset of the single safe ABI-aligned slot whose contents match
- * `placeholder` as a 32-byte big-endian uint256. Returns `-1` when not found.
- *
- * This is a validated single-slot finder, not a "first match wins" search:
- * - exactly one safe aligned match → return that slot offset
- * - no match at all → return `-1`
- * - multiple aligned matches or only non-word-aligned matches → throw
- *
- * Throws when the placeholder appears multiple times or only at a non-word
- * boundary, because silently choosing one match would make exact-input
- * destination encoding ambiguous or unsafe.
- *
- * The scan is restricted to word-aligned offsets (4, 36, 68, ...) so that
- * sentinels with periodic byte patterns cannot produce spurious mid-slot
- * matches when adjacent to other sentinels. See {@link getSelfAddressOffsets}
- * for the collision scenario this guards against.
- */
-export declare function getAmountOffset(calldata: `0x${string}`, placeholder: bigint): number;
-/**
- * Returns every word-aligned byte offset whose contents match `placeholder` as
- * a 32-byte big-endian uint256.
- *
- * Useful when a single calldata blob may contain multiple amount sentinels
- * (for example, a raw user-crafted "custom" call that passes `dynamic()` into
- * more than one argument) — callers can detect the condition and either
- * hydrate every slot or refuse to encode.
- */
-export declare function getAmountOffsets(calldata: `0x${string}`, placeholder: bigint): number[];
-/**
- * Replace every word-aligned ABI slot whose contents match `placeholderWei`
- * (encoded as a 32-byte big-endian uint256) with the hex of
- * {@link TRAILS_HYDRATE_PLACEHOLDER_AMOUNT}.
- *
- * Mirror of {@link replacePlaceholderInCalldata}: that function swaps the
- * sentinel OUT for a concrete amount, this one swaps a concrete placeholder
- * IN for the sentinel. It is used when an external encoder (e.g. the Trails
- * Yield API) only accepts human-readable numeric amounts and we need the
- * returned calldata to carry the hydration sentinel so that `HydrateProxy`
- * injects the intent wallet's runtime balance at execution time.
- *
- * Scanning is restricted to word-aligned slot starts (bytes 4, 36, 68, …)
- * via {@link getAmountOffsets}. A naive byte-pattern replace would risk
- * matching the placeholder hex at non-aligned offsets — for example, where
- * a slot's zero-padded prefix abuts the nonzero suffix of another field
- * inside an inline `bytes` payload — and corrupt unrelated calldata. See
- * {@link getSelfAddressOffsets} for the broader collision rationale.
- *
- * Returns `null` (not an error) when the placeholder is not present at any
- * aligned slot — callers decide how to react (usually: try another candidate
- * decimals, or throw with a descriptive message).
- */
-export declare function injectHydrationPlaceholderIntoCalldata(calldata: `0x${string}`, placeholderWei: bigint): `0x${string}` | null;
-/**
- * @deprecated TrailsRouter is not used in v1.5.
- *
- * Check if calldata contains the placeholder amount. If no placeholder is
- * found, the calldata has a real amount baked in.
- *
- * @param calldata - The calldata to check
- * @returns true if calldata contains the placeholder, false otherwise
- */
-export declare function calldataHasPlaceholder(calldata?: string): boolean;
-/**
- * Replace the placeholder amount in calldata with the actual amount.
- *
- * Used for same-chain same-token vault deposits where the calldata was
- * generated with one or more placeholder slots.
- *
- * @param calldata - The calldata containing the placeholder
- * @param amount - The actual amount to inject (as string in wei)
- * @returns The calldata with every aligned placeholder replaced, or the
- * original calldata if no aligned placeholder is found
- */
-export declare function replacePlaceholderInCalldata(calldata: string, amount: string): string;
-//# sourceMappingURL=placeholder.d.ts.map

package/dist/placeholder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"placeholder.d.ts","sourceRoot":"","sources":["../src/placeholder.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAC5B,uBAAuB,GACvB,uBAAuB,CAAA;AAE3B,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;gBAEvB,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAKzE;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iCAAiC,kFACuB,CAAA;AAErE;;GAEG;AACH,eAAO,MAAM,gCAAgC,kFACV,CAAA;AAEnC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,2BAA2B,EACtC,4CAAqD,CAAA;AAyDvD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM,EAAE,CAuBvE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,KAAK,MAAM,EAAE,EACvB,WAAW,EAAE,MAAM,GAClB,MAAM,CAaR;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,KAAK,MAAM,EAAE,EACvB,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CA+BV;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,KAAK,MAAM,EAAE,EACvB,cAAc,EAAE,MAAM,GACrB,KAAK,MAAM,EAAE,GAAG,IAAI,CAuBtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CASjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAuDR"}

package/dist/placeholder.js

@@ -1,95 +0,0 @@
-import { _defineProperty as x } from "./_virtual/_@oxc-project_runtime@0.126.0/helpers/defineProperty.js";
-import { Bytes as c, Hex as S } from "ox";
-var A = class extends Error {
-  constructor(e, f, t) {
-    super(f, t !== void 0 ? { cause: t } : void 0), x(this, "code", void 0), this.name = "PlaceholderError", this.code = e;
-  }
-}, h = 114316045351081986197366228715807272115562181347258027827511447451103061843027n, p = h, I = "0xd80d3a37a85094663c36c062e5ef689f2bf54fca", u = 4, i = 32;
-function m(e, f) {
-  const t = f.toString(16).padStart(64, "0"), l = c.fromHex(`0x${t}`), o = c.fromHex(e), n = [];
-  for (let r = 0; r + i <= o.length; r++) {
-    let s = !0;
-    for (let a = 0; a < i; a++) if (o[r + a] !== l[a]) {
-      s = !1;
-      break;
-    }
-    s && n.push(r);
-  }
-  return n;
-}
-function g(e) {
-  return e >= u && (e - u) % i === 0;
-}
-function y(e) {
-  const f = `000000000000000000000000${I.slice(2)}`.toLowerCase(), t = e.toLowerCase(), l = (t.length - 2) / 2, o = [];
-  for (let n = u; n + i <= l; n += i) {
-    const r = 2 + n * 2;
-    t.slice(r, r + 64) === f && o.push(n + 12);
-  }
-  return o;
-}
-function w(e, f) {
-  const t = d(e, f);
-  if (t.length > 1) throw new A("MULTIPLE_AMOUNT_SLOTS", `Ambiguous placeholder match; expected exactly one amount slot, found ${t.length}`);
-  return t.length === 1 ? t[0] : -1;
-}
-function d(e, f) {
-  const t = f.toString(16).padStart(64, "0").toLowerCase(), l = e.toLowerCase(), o = (l.length - 2) / 2, n = [];
-  for (let r = u; r + i <= o; r += i) {
-    const s = 2 + r * 2;
-    l.slice(s, s + 64) === t && n.push(r);
-  }
-  if (n.length === 0) {
-    const r = m(e, f);
-    if (r.some((s) => !g(s))) throw new A("INVALID_AMOUNT_OFFSET", `Invalid placeholder offset ${r.find((s) => !g(s))}; expected a 32-byte ABI word offset`);
-  }
-  return n;
-}
-function B(e, f) {
-  if (f <= 0n) return null;
-  if (f === 114316045351081986197366228715807272115562181347258027827511447451103061843027n) return e;
-  const t = d(e, f);
-  if (t.length === 0) return null;
-  const l = h.toString(16).padStart(64, "0");
-  let o = e;
-  for (const n of t) {
-    const r = 2 + n * 2;
-    o = o.slice(0, r) + l + o.slice(r + 64);
-  }
-  return o;
-}
-function L(e) {
-  return !e || e === "0x" || !S.validate(e, { strict: !0 }) ? !1 : d(e, h).length > 0;
-}
-function E(e, f) {
-  if (!e || e === "0x") return e;
-  if (!f || f === "")
-    return console.warn("replacePlaceholderInCalldata: Amount is empty, returning original calldata"), e;
-  let t;
-  try {
-    t = BigInt(f);
-  } catch (s) {
-    return console.warn(`replacePlaceholderInCalldata: Invalid amount "${f}", returning original calldata`, s), e;
-  }
-  if (t < 0n)
-    return console.warn(`replacePlaceholderInCalldata: Amount cannot be negative (${f}), returning original calldata`), e;
-  if (t > BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"))
-    return console.warn(`replacePlaceholderInCalldata: Amount exceeds uint256 max (${f}), returning original calldata`), e;
-  const l = t.toString(16).padStart(64, "0"), o = d(e, p);
-  if (o.length === 0) return e;
-  const n = c.fromHex(e), r = c.fromHex(`0x${l}`);
-  for (const s of o) n.set(r, s);
-  return c.toHex(n);
-}
-export {
-  A as PlaceholderError,
-  h as TRAILS_HYDRATE_PLACEHOLDER_AMOUNT,
-  I as TRAILS_HYDRATE_SELF_ADDRESS,
-  p as TRAILS_ROUTER_PLACEHOLDER_AMOUNT,
-  L as calldataHasPlaceholder,
-  w as getAmountOffset,
-  d as getAmountOffsets,
-  y as getSelfAddressOffsets,
-  B as injectHydrationPlaceholderIntoCalldata,
-  E as replacePlaceholderInCalldata
-};