@spicenet-io/spiceflow-core 0.1.0 → 0.1.2

package/dist/authorization.d.ts

@@ -0,0 +1,58 @@
+import type { Address, Hash, PublicClient } from "viem";
+import type { ChainBatch, ChainBatchInput } from "./types.js";
+/**
+ * ABI description of a single call in a chain batch.
+ */
+export declare const CallAbi: {
+    readonly type: "tuple";
+    readonly components: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+};
+/**
+ * ABI description of the per-chain signature components used by EIP‑7702
+ * to derive the chain authorization hash for a batch of calls.
+ */
+export declare const ChainBatchHashComponentsAbi: readonly [{
+    readonly name: "chainId";
+    readonly type: "uint256";
+}, {
+    readonly type: "tuple[]";
+    readonly components: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+    readonly name: "calls";
+}];
+/**
+ * Hash each chain's call batch into an EIP‑7702 chain authorization tuple.
+ */
+export declare function hashChainBatches(chainCalls: ChainBatchInput[]): ChainBatch[];
+/**
+ * Compute the intent hash from an array of per-chain authorization hashes.
+ */
+export declare function getIntentHash(nbf: bigint, exp: bigint, chainBatches: {
+    hash: Hash;
+}[]): Hash;
+/**
+ * Load the account nonce to be used when signing a chain delegation.
+ */
+export declare function getAccountNonce(address: Address, publicClient: PublicClient): Promise<number>;
+/**
+ * Fetch a recent block number used as freshness bound for chain batches.
+ */
+export declare function getRecentBlock(publicClient: PublicClient): Promise<bigint>;
+//# sourceMappingURL=authorization.d.ts.map

package/dist/authorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.d.ts","sourceRoot":"","sources":["../src/authorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAExD,OAAO,KAAK,EAAQ,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;CAOV,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;EAG9B,CAAC;AAEX;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,UAAU,EAAE,CAU5E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,EAAE,GAAG,IAAI,CAG5F;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnG;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhF"}

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+import type { PublicClient } from "viem";
+/**
+ * Configuration for the generic SpiceFlow core.
+ *
+ * Consumers provide factories/resolvers for chain-specific details
+ * (delegate contract, viem PublicClient, and API base URL).
+ */
+export interface SpiceFlowConfig {
+    txApiUrl: string;
+    delegateAddressForChain: (chainId: number) => `0x${string}`;
+    publicClientForChain: (chainId: number) => PublicClient;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,MAAM,EAAE,CAAC;IAC5D,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC;CACzD"}

package/dist/core.d.ts

@@ -0,0 +1,61 @@
+import type { PublicClient } from "viem";
+import { hashChainBatches } from "./authorization.js";
+import type { SpiceFlowConfig } from "./config.js";
+import type { Authorization, Call } from "./types.js";
+export interface Signers {
+    /** Sign an EIP‑7702 chain delegation for a given delegate contract & chain. */
+    authorizationSigner: (args: {
+        contractAddress: `0x${string}`;
+        chainId: number;
+        nonce: number;
+        address: `0x${string}`;
+    }) => Promise<Authorization>;
+    /** Sign the final cross‑chain intent hash. */
+    messageSigner: (digest: `0x${string}`) => Promise<`0x${string}`>;
+}
+export declare class SpiceFlowCore {
+    private cfg;
+    private signers;
+    constructor(cfg: SpiceFlowConfig, signers: Signers);
+    getConfig(): SpiceFlowConfig;
+    getClient(chainId: number): PublicClient;
+    /**
+     * Create EIP‑7702 authorizations for one or more chains.
+     * Will load nonces unless explicitly provided.
+     */
+    signDelegations(params: {
+        user: `0x${string}`;
+        delegations: {
+            chainId: number;
+            contractAddress: `0x${string}`;
+            nonce?: number;
+        }[];
+    }): Promise<Authorization[]>;
+    /**
+     * Build chain authorization batches and return the final intent digest.
+     */
+    buildChainBatches(nbf: bigint, exp: bigint, callsByChain: {
+        chainId: number;
+        calls: Call[];
+        recentBlock?: bigint;
+    }[]): Promise<{
+        chainBatches: import("./types.js").ChainBatch[];
+        digest: `0x${string}`;
+    }>;
+    /** Sign the final intent hash (EIP‑7702). */
+    signIntent(digest: `0x${string}`): Promise<`0x${string}`>;
+    /**
+     * Submit a signed intent to the SpiceFlow relayer.
+     */
+    submitIntent(req: {
+        user: `0x${string}`;
+        authorization: Authorization[];
+        chainBatches: ReturnType<typeof hashChainBatches>;
+        tokenAddress: `0x${string}`;
+        tokenAmount: bigint;
+        nbf: bigint;
+        exp: bigint;
+        signature?: `0x${string}`;
+    }): Promise<import("./relayer.js").RelayerSubmitResponse>;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,EAAmC,gBAAgB,EAAiB,MAAM,oBAAoB,CAAC;AACtG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGtD,MAAM,WAAW,OAAO;IACtB,+EAA+E;IAC/E,mBAAmB,EAAE,CAAC,IAAI,EAAE;QAAE,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAClJ,8CAA8C;IAC9C,aAAa,EAAE,CAAC,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;CAClE;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,GAAG;IAAmB,OAAO,CAAC,OAAO;gBAArC,GAAG,EAAE,eAAe,EAAU,OAAO,EAAE,OAAO;IAElE,SAAS,IAAI,eAAe;IAC5B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAExC;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAapK;;OAEG;IACG,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE;;;;IAW1H,6CAA6C;IACvC,UAAU,CAAC,MAAM,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;IAE/D;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE;QACtB,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;QACpB,aAAa,EAAE,aAAa,EAAE,CAAC;QAC/B,YAAY,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;QAClD,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;QAC5B,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;KAC3B;CAWF"}

package/dist/http.d.ts

@@ -0,0 +1,17 @@
+export type RetryOptions = {
+    retries?: number;
+    backoffMs?: number;
+    maxBackoffMs?: number;
+    jitter?: boolean;
+    idempotencyKey?: string;
+    retryOn?: (errOrRes: Error | Response) => boolean;
+    signal?: AbortSignal;
+};
+export declare class HttpError extends Error {
+    status: number;
+    code?: string;
+    body?: unknown;
+    constructor(message: string, status: number, code?: string, body?: unknown);
+}
+export declare function fetchWithRetry(url: string, init?: RequestInit, opts?: RetryOptions): Promise<Response>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,KAAK,OAAO,CAAC;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,qBAAa,SAAU,SAAQ,KAAK;IAGzB,MAAM,EAAE,MAAM;IACd,IAAI,CAAC,EAAE,MAAM;IACb,IAAI,CAAC,EAAE,OAAO;gBAHrB,OAAO,EAAE,MAAM,EACR,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,OAAO;CAIxB;AAMD,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,WAAgB,EACtB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,QAAQ,CAAC,CA6CnB"}

package/dist/index.cjs

@@ -0,0 +1,226 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CallAbi: () => CallAbi,
+  ChainBatchHashComponentsAbi: () => ChainBatchHashComponentsAbi,
+  SpiceFlowCore: () => SpiceFlowCore,
+  getAccountNonce: () => getAccountNonce,
+  getIntentHash: () => getIntentHash,
+  getIntentStepStatus: () => getIntentStepStatus,
+  getRecentBlock: () => getRecentBlock,
+  hashChainBatches: () => hashChainBatches,
+  prepareRFQT: () => prepareRFQT,
+  submitTransaction: () => submitTransaction
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/authorization.ts
+var import_viem = require("viem");
+var CallAbi = {
+  type: "tuple",
+  components: [
+    { name: "to", type: "address" },
+    { name: "value", type: "uint" },
+    { name: "data", type: "bytes" }
+  ]
+};
+var ChainBatchHashComponentsAbi = [
+  { name: "chainId", type: "uint256" },
+  { name: "calls", ...CallAbi, type: "tuple[]" }
+];
+function hashChainBatches(chainCalls) {
+  return chainCalls.map(({ chainId, calls }) => {
+    chainId = BigInt(chainId);
+    const hash = (0, import_viem.keccak256)(
+      (0, import_viem.encodeAbiParameters)(ChainBatchHashComponentsAbi, [chainId, calls])
+    );
+    return { hash, chainId, calls };
+  });
+}
+function getIntentHash(nbf, exp, chainBatches) {
+  const hashes = chainBatches.map(({ hash }) => hash);
+  return (0, import_viem.keccak256)((0, import_viem.encodeAbiParameters)([{ type: "uint256" }, { type: "uint256" }, { type: "bytes32[]" }], [nbf, exp, hashes]));
+}
+async function getAccountNonce(address, publicClient) {
+  return await publicClient.getTransactionCount({ address });
+}
+async function getRecentBlock(publicClient) {
+  return await publicClient.getBlockNumber();
+}
+
+// src/http.ts
+var HttpError = class extends Error {
+  constructor(message, status, code, body) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.body = body;
+  }
+};
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+async function fetchWithRetry(url, init = {}, opts = {}) {
+  const {
+    retries = 3,
+    backoffMs = 300,
+    maxBackoffMs = 5e3,
+    jitter = true,
+    idempotencyKey,
+    retryOn = (e) => e instanceof Error || e instanceof Response && (e.status >= 500 || e.status === 429),
+    signal
+  } = opts;
+  const headers = new Headers(init.headers || {});
+  if (idempotencyKey) headers.set("Idempotency-Key", idempotencyKey);
+  const reqInit = { ...init, headers, signal };
+  let attempt = 0;
+  let lastErr;
+  while (attempt <= retries) {
+    try {
+      const res = await fetch(url, reqInit);
+      if (!res.ok && retryOn(res) && attempt < retries) {
+        attempt++;
+        const base = Math.min(maxBackoffMs, backoffMs * 2 ** (attempt - 1));
+        const delay = jitter ? Math.floor(base * (0.7 + Math.random() * 0.6)) : base;
+        await sleep(delay);
+        continue;
+      }
+      if (!res.ok) {
+        let body;
+        try {
+          body = await res.json();
+        } catch {
+          body = await res.text();
+        }
+        throw new HttpError(`HTTP ${res.status}`, res.status, body && body.code || void 0, body);
+      }
+      return res;
+    } catch (e) {
+      if (attempt >= retries || !retryOn(e)) throw e;
+      attempt++;
+      const base = Math.min(maxBackoffMs, backoffMs * 2 ** (attempt - 1));
+      const delay = jitter ? Math.floor(base * (0.7 + Math.random() * 0.6)) : base;
+      await sleep(delay);
+      lastErr = e;
+    }
+  }
+  throw lastErr;
+}
+
+// src/relayer.ts
+async function submitTransaction(baseUrl, request, retry) {
+  const res = await fetchWithRetry(`${baseUrl}/transaction/submit`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(request, (k, v) => typeof v === "bigint" ? v.toString() : v)
+  }, retry);
+  const result = await res.json();
+  return { hash: result.hash, intentId: result.intentId || request.intentAuthorization.signature };
+}
+
+// src/core.ts
+var SpiceFlowCore = class {
+  constructor(cfg, signers) {
+    this.cfg = cfg;
+    this.signers = signers;
+  }
+  getConfig() {
+    return this.cfg;
+  }
+  getClient(chainId) {
+    return this.cfg.publicClientForChain(chainId);
+  }
+  /**
+   * Create EIP‑7702 authorizations for one or more chains.
+   * Will load nonces unless explicitly provided.
+   */
+  async signDelegations(params) {
+    const out = [];
+    for (const d of params.delegations) {
+      const client = this.getClient(d.chainId);
+      const nonce = typeof d.nonce === "number" ? d.nonce : await getAccountNonce(params.user, client);
+      const auth = await this.signers.authorizationSigner({ contractAddress: d.contractAddress, chainId: d.chainId, nonce, address: params.user });
+      delete auth.v;
+      out.push(auth);
+    }
+    return out;
+  }
+  /**
+   * Build chain authorization batches and return the final intent digest.
+   */
+  async buildChainBatches(nbf, exp, callsByChain) {
+    const filled = [];
+    for (const c of callsByChain) {
+      const recent = typeof c.recentBlock === "bigint" ? c.recentBlock : await getRecentBlock(this.getClient(c.chainId));
+      filled.push({ chainId: c.chainId, calls: c.calls, recentBlock: recent });
+    }
+    const chainBatches = hashChainBatches(filled);
+    const digest = getIntentHash(nbf, exp, chainBatches);
+    return { chainBatches, digest };
+  }
+  /** Sign the final intent hash (EIP‑7702). */
+  async signIntent(digest) {
+    return this.signers.messageSigner(digest);
+  }
+  /**
+   * Submit a signed intent to the SpiceFlow relayer.
+   */
+  async submitIntent(req) {
+    const signature = req.signature ?? await this.signIntent(getIntentHash(req.nbf, req.exp, req.chainBatches));
+    const resp = await submitTransaction(this.cfg.txApiUrl, {
+      tokenAddress: req.tokenAddress,
+      tokenAmount: req.tokenAmount,
+      address: req.user,
+      authorization: req.authorization,
+      intentAuthorization: { signature, chainBatches: req.chainBatches }
+    });
+    return resp;
+  }
+};
+
+// src/status.ts
+async function getIntentStepStatus(txApiUrl, intentId, stepId, retry) {
+  const res = await fetchWithRetry(`${txApiUrl}/intent/${intentId}/step/${stepId}/status`, {}, retry);
+  return res.json();
+}
+
+// src/rfqt.ts
+async function prepareRFQT(txApiUrl, request, retry) {
+  const res = await fetchWithRetry(`${txApiUrl}/rfqt`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(request)
+  }, retry);
+  return res.json();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CallAbi,
+  ChainBatchHashComponentsAbi,
+  SpiceFlowCore,
+  getAccountNonce,
+  getIntentHash,
+  getIntentStepStatus,
+  getRecentBlock,
+  hashChainBatches,
+  prepareRFQT,
+  submitTransaction
+});

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SpiceFlow SDK public API surface.
+ *
+ * This entry re-exports the minimal generic building blocks for
+ * constructing and submitting EIP‑7702 intent payloads.
+ */
+export * from "./config.js";
+export * from "./types.js";
+export * from "./authorization.js";
+export * from "./relayer.js";
+export * from "./core.js";
+export * from "./status.js";
+export * from "./rfqt.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,191 @@
+// src/authorization.ts
+import { encodeAbiParameters, keccak256 } from "viem";
+var CallAbi = {
+  type: "tuple",
+  components: [
+    { name: "to", type: "address" },
+    { name: "value", type: "uint" },
+    { name: "data", type: "bytes" }
+  ]
+};
+var ChainBatchHashComponentsAbi = [
+  { name: "chainId", type: "uint256" },
+  { name: "calls", ...CallAbi, type: "tuple[]" }
+];
+function hashChainBatches(chainCalls) {
+  return chainCalls.map(({ chainId, calls }) => {
+    chainId = BigInt(chainId);
+    const hash = keccak256(
+      encodeAbiParameters(ChainBatchHashComponentsAbi, [chainId, calls])
+    );
+    return { hash, chainId, calls };
+  });
+}
+function getIntentHash(nbf, exp, chainBatches) {
+  const hashes = chainBatches.map(({ hash }) => hash);
+  return keccak256(encodeAbiParameters([{ type: "uint256" }, { type: "uint256" }, { type: "bytes32[]" }], [nbf, exp, hashes]));
+}
+async function getAccountNonce(address, publicClient) {
+  return await publicClient.getTransactionCount({ address });
+}
+async function getRecentBlock(publicClient) {
+  return await publicClient.getBlockNumber();
+}
+
+// src/http.ts
+var HttpError = class extends Error {
+  constructor(message, status, code, body) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.body = body;
+  }
+};
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+async function fetchWithRetry(url, init = {}, opts = {}) {
+  const {
+    retries = 3,
+    backoffMs = 300,
+    maxBackoffMs = 5e3,
+    jitter = true,
+    idempotencyKey,
+    retryOn = (e) => e instanceof Error || e instanceof Response && (e.status >= 500 || e.status === 429),
+    signal
+  } = opts;
+  const headers = new Headers(init.headers || {});
+  if (idempotencyKey) headers.set("Idempotency-Key", idempotencyKey);
+  const reqInit = { ...init, headers, signal };
+  let attempt = 0;
+  let lastErr;
+  while (attempt <= retries) {
+    try {
+      const res = await fetch(url, reqInit);
+      if (!res.ok && retryOn(res) && attempt < retries) {
+        attempt++;
+        const base = Math.min(maxBackoffMs, backoffMs * 2 ** (attempt - 1));
+        const delay = jitter ? Math.floor(base * (0.7 + Math.random() * 0.6)) : base;
+        await sleep(delay);
+        continue;
+      }
+      if (!res.ok) {
+        let body;
+        try {
+          body = await res.json();
+        } catch {
+          body = await res.text();
+        }
+        throw new HttpError(`HTTP ${res.status}`, res.status, body && body.code || void 0, body);
+      }
+      return res;
+    } catch (e) {
+      if (attempt >= retries || !retryOn(e)) throw e;
+      attempt++;
+      const base = Math.min(maxBackoffMs, backoffMs * 2 ** (attempt - 1));
+      const delay = jitter ? Math.floor(base * (0.7 + Math.random() * 0.6)) : base;
+      await sleep(delay);
+      lastErr = e;
+    }
+  }
+  throw lastErr;
+}
+
+// src/relayer.ts
+async function submitTransaction(baseUrl, request, retry) {
+  const res = await fetchWithRetry(`${baseUrl}/transaction/submit`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(request, (k, v) => typeof v === "bigint" ? v.toString() : v)
+  }, retry);
+  const result = await res.json();
+  return { hash: result.hash, intentId: result.intentId || request.intentAuthorization.signature };
+}
+
+// src/core.ts
+var SpiceFlowCore = class {
+  constructor(cfg, signers) {
+    this.cfg = cfg;
+    this.signers = signers;
+  }
+  getConfig() {
+    return this.cfg;
+  }
+  getClient(chainId) {
+    return this.cfg.publicClientForChain(chainId);
+  }
+  /**
+   * Create EIP‑7702 authorizations for one or more chains.
+   * Will load nonces unless explicitly provided.
+   */
+  async signDelegations(params) {
+    const out = [];
+    for (const d of params.delegations) {
+      const client = this.getClient(d.chainId);
+      const nonce = typeof d.nonce === "number" ? d.nonce : await getAccountNonce(params.user, client);
+      const auth = await this.signers.authorizationSigner({ contractAddress: d.contractAddress, chainId: d.chainId, nonce, address: params.user });
+      delete auth.v;
+      out.push(auth);
+    }
+    return out;
+  }
+  /**
+   * Build chain authorization batches and return the final intent digest.
+   */
+  async buildChainBatches(nbf, exp, callsByChain) {
+    const filled = [];
+    for (const c of callsByChain) {
+      const recent = typeof c.recentBlock === "bigint" ? c.recentBlock : await getRecentBlock(this.getClient(c.chainId));
+      filled.push({ chainId: c.chainId, calls: c.calls, recentBlock: recent });
+    }
+    const chainBatches = hashChainBatches(filled);
+    const digest = getIntentHash(nbf, exp, chainBatches);
+    return { chainBatches, digest };
+  }
+  /** Sign the final intent hash (EIP‑7702). */
+  async signIntent(digest) {
+    return this.signers.messageSigner(digest);
+  }
+  /**
+   * Submit a signed intent to the SpiceFlow relayer.
+   */
+  async submitIntent(req) {
+    const signature = req.signature ?? await this.signIntent(getIntentHash(req.nbf, req.exp, req.chainBatches));
+    const resp = await submitTransaction(this.cfg.txApiUrl, {
+      tokenAddress: req.tokenAddress,
+      tokenAmount: req.tokenAmount,
+      address: req.user,
+      authorization: req.authorization,
+      intentAuthorization: { signature, chainBatches: req.chainBatches }
+    });
+    return resp;
+  }
+};
+
+// src/status.ts
+async function getIntentStepStatus(txApiUrl, intentId, stepId, retry) {
+  const res = await fetchWithRetry(`${txApiUrl}/intent/${intentId}/step/${stepId}/status`, {}, retry);
+  return res.json();
+}
+
+// src/rfqt.ts
+async function prepareRFQT(txApiUrl, request, retry) {
+  const res = await fetchWithRetry(`${txApiUrl}/rfqt`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(request)
+  }, retry);
+  return res.json();
+}
+export {
+  CallAbi,
+  ChainBatchHashComponentsAbi,
+  SpiceFlowCore,
+  getAccountNonce,
+  getIntentHash,
+  getIntentStepStatus,
+  getRecentBlock,
+  hashChainBatches,
+  prepareRFQT,
+  submitTransaction
+};

package/dist/relayer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Request payload to submit an EIP‑7702 intent via the SpiceFlow relayer.
+ * Values like bigint are stringified for transport.
+ */
+export interface RelayerSubmitRequest {
+    tokenAddress: string;
+    tokenAmount: bigint;
+    address: string;
+    authorization: any[];
+    intentAuthorization: {
+        signature: string;
+        chainBatches: Array<{
+            hash: string;
+            chainId: bigint;
+            calls: any[];
+            recentBlock: bigint;
+        }>;
+    };
+}
+/** Response from the relayer on successful submission. */
+export interface RelayerSubmitResponse {
+    hash: string;
+    intentId: string;
+}
+/**
+ * Submit an intent to the relayer.
+ * The relayer broadcasts the transaction(s) and returns a cross‑chain intent id.
+ */
+import { type RetryOptions } from "./http.js";
+export declare function submitTransaction(baseUrl: string, request: RelayerSubmitRequest, retry?: RetryOptions): Promise<RelayerSubmitResponse>;
+//# sourceMappingURL=relayer.d.ts.map

package/dist/relayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relayer.d.ts","sourceRoot":"","sources":["../src/relayer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,GAAG,EAAE,CAAC;IACrB,mBAAmB,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,GAAG,EAAE,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;SAAE,CAAC,CAAC;KAC5F,CAAC;CACH;AAED,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;CAAE;AAE1E;;;GAGG;AACH,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9D,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,EAC7B,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,qBAAqB,CAAC,CAOhC"}

package/dist/rfqt.d.ts

@@ -0,0 +1,27 @@
+import { type RetryOptions } from "./http.js";
+/**
+ * RFQT request shape used by SpiceFlow to prepare a user-executed trade.
+ */
+export interface RFQTRequest {
+    user: `0x${string}`;
+    /** Input asset identifier (symbol, address, or provider-defined key). */
+    tokenIn: string;
+    /** Output asset identifier (symbol, address, or provider-defined key). */
+    tokenOut: string;
+    amountIn: string;
+    amountOut: string;
+    expiry: number;
+    quoteId: `0x${string}`;
+}
+/** RFQT response payload used to build a call {to, value, data}. */
+export interface RFQTResponse {
+    to: `0x${string}`;
+    value: string;
+    data: `0x${string}`;
+}
+/**
+ * Prepare an RFQT transaction request.
+ * POST {txApiUrl}/rfqt
+ */
+export declare function prepareRFQT(txApiUrl: string, request: RFQTRequest, retry?: RetryOptions): Promise<RFQTResponse>;
+//# sourceMappingURL=rfqt.d.ts.map

package/dist/rfqt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rfqt.d.ts","sourceRoot":"","sources":["../src/rfqt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;IACpB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;CACxB;AAED,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,EACpB,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,CAAC,CAOvB"}

package/dist/status.d.ts

@@ -0,0 +1,17 @@
+import { type RetryOptions } from "./http.js";
+/**
+ * Intent step status response payload.
+ */
+export interface IntentStepStatusResponse {
+    success: boolean;
+    data: {
+        status: 'created' | 'executing' | 'success' | 'reverted';
+        transactionHash?: string;
+    };
+}
+/**
+ * Fetch the status of a specific intent step.
+ * GET {txApiUrl}/intent/{intentId}/step/{stepId}/status
+ */
+export declare function getIntentStepStatus(txApiUrl: string, intentId: string, stepId: number, retry?: RetryOptions): Promise<IntentStepStatusResponse>;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE;QACJ,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;QACzD,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAA;CACF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAGnC"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+import type { Address, Hash, Hex } from "viem";
+/** A single call packed into a chain batch. */
+export type Call = {
+    to: Address;
+    value: bigint;
+    data: Hex;
+};
+/** Signed authorization (EIP‑7702) for a specific chain & delegate contract. */
+export type Authorization = {
+    address: string;
+    chainId: number;
+    nonce: number;
+    r: string;
+    s: string;
+    yParity: number;
+};
+/** Input for hashing a per-chain authorization (preimage). */
+export type ChainBatchInput = {
+    chainId: bigint | number;
+    calls: Call[];
+};
+/** Output of hashing: the EIP‑7702 chain authorization tuple. */
+export type ChainBatch = {
+    hash: Hash;
+    chainId: bigint;
+    calls: Call[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE/C,+CAA+C;AAC/C,MAAM,MAAM,IAAI,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC;AAC7D,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAAC;AAC1E,iEAAiE;AACjE,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spicenet-io/spiceflow-core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",