@spicenet-io/spiceflow-core 0.2.0 → 0.3.0

package/README.md

@@ -0,0 +1,82 @@
+# @spicenet-io/spiceflow-core
+
+Single source of truth for chain configs, token lists, logos, ABIs, and shared utilities across spiceflow repos.
+
+## Install
+
+```
+npm install @spicenet-io/spiceflow-core
+```
+
+## What's in here
+
+### Chains
+
+`CHAINS` is a record of all supported chains keyed by chain ID. Each entry has id, name, display name, network (mainnet/testnet), native currency, delegate contract address, block explorer, rpc url, and logo.
+
+Helper functions: `getChainMeta(chainId)`, `getChainsByNetwork(network)`, `getChainIdsByNetwork(network)`, `getMainnetChains()`, `getTestnetChains()`, `getDelegateContract(chainId)`.
+
+### Tokens
+
+`TOKENS` is the official token list. Each token has symbol, name, equivalence group, logo, and deployments across chains (address, decimals, network per chain).
+
+Helper functions: `getTokensForChain(chainId)`, `getTokenByAddress(address, chainId)`, `getEquivalentAddresses(tokenAddress)`, `areEquivalent(a, b)`, `isUsdDenominated(address)`, `isBtcDenominated(address)`.
+
+### Logos
+
+All chain and token logos are bundled as base64 data URIs in the package. They work directly in img src attributes with no network requests. To add a new logo, drop the PNG in `logos/` and reference it in the chain or token list. `npm run build` auto generates the base64 file.
+
+### Utilities
+
+`isNativeToken(address)` checks if an address is a native token (zero address, 0x0, or 0xeee...eee).
+
+`normalizeNativeTokenAddress(address)` normalizes any native token address to the zero address.
+
+`convertAmountBetweenDecimals(amount, fromDecimals, toDecimals)` converts token amounts between different decimal precisions.
+
+`formatTokenAmount(amount, decimals)` formats a bigint token amount into a human readable string.
+
+`truncateAddress(address)` shortens an address for display.
+
+`withRetry(fn, maxRetries, delayMs)` retries an async function with exponential backoff.
+
+Constants: `NATIVE_TOKEN_ADDRESS`, `ZERO_ADDRESS`, `ESCROW_ADDRESS`.
+
+### ABIs
+
+`DELEGATE_ABI`, `ERC20_ABI`, `WCBTC_ABI`.
+
+### Authorization
+
+`hashChainBatches(chainCalls)` hashes chain call batches for intent signing.
+
+`getIntentHash(signatureType, nbf, exp, chainBatches)` computes the intent hash.
+
+`getAccountNonce(address, publicClient)` gets the account nonce from chain.
+
+### Core SDK
+
+`SpiceFlowCore` class for building and submitting intents. Handles delegation signing, chain batch construction, intent signing, and transaction submission.
+
+### HTTP
+
+`fetchWithRetry(url, init, opts)` is a fetch wrapper with retry and exponential backoff.
+
+`submitTransaction(baseUrl, request)` submits a transaction to the relayer API.
+
+`getIntentStepStatus(txApiUrl, intentId, stepId)` checks intent execution status.
+
+`prepareRFQT(txApiUrl, request)` prepares an RFQT quote.
+
+## Adding a token
+
+1. Drop the logo PNG in `logos/`
+2. Add the token entry in `src/tokens/list.ts` with symbol, name, equivalence group, logo reference, and deployments
+3. `npm run build` and publish
+
+## Adding a chain
+
+1. Drop the logo PNG in `logos/` if it's a new chain logo
+2. Add the chain entry in `src/chains/list.ts`
+3. Add token deployments on that chain in `src/tokens/list.ts`
+4. `npm run build` and publish

package/dist/abis/index.d.ts

@@ -1,4 +1,5 @@
 export { DELEGATE_ABI } from "./delegate.js";
 export { ERC20_ABI } from "./erc20.js";
 export { WCBTC_ABI } from "./wcbtc.js";
+export { uniV3QuoterV2Abi, uniV3SwapRouterAbi } from "./uniV3.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/abis/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/abis/uniV3.d.ts

@@ -0,0 +1,93 @@
+export declare const uniV3QuoterV2Abi: readonly [{
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "tokenIn";
+            readonly type: "address";
+        }, {
+            readonly internalType: "address";
+            readonly name: "tokenOut";
+            readonly type: "address";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "amountIn";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "uint24";
+            readonly name: "fee";
+            readonly type: "uint24";
+        }, {
+            readonly internalType: "uint160";
+            readonly name: "sqrtPriceLimitX96";
+            readonly type: "uint160";
+        }];
+        readonly internalType: "struct IQuoterV2.QuoteExactInputSingleParams";
+        readonly name: "params";
+        readonly type: "tuple";
+    }];
+    readonly name: "quoteExactInputSingle";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "amountOut";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint160";
+        readonly name: "sqrtPriceX96After";
+        readonly type: "uint160";
+    }, {
+        readonly internalType: "uint32";
+        readonly name: "initializedTicksCrossed";
+        readonly type: "uint32";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "gasEstimate";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}];
+export declare const uniV3SwapRouterAbi: readonly [{
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "tokenIn";
+            readonly type: "address";
+        }, {
+            readonly internalType: "address";
+            readonly name: "tokenOut";
+            readonly type: "address";
+        }, {
+            readonly internalType: "uint24";
+            readonly name: "fee";
+            readonly type: "uint24";
+        }, {
+            readonly internalType: "address";
+            readonly name: "recipient";
+            readonly type: "address";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "amountIn";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "amountOutMinimum";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "uint160";
+            readonly name: "sqrtPriceLimitX96";
+            readonly type: "uint160";
+        }];
+        readonly internalType: "struct IV3SwapRouter.ExactInputSingleParams";
+        readonly name: "params";
+        readonly type: "tuple";
+    }];
+    readonly name: "exactInputSingle";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "amountOut";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "payable";
+    readonly type: "function";
+}];
+//# sourceMappingURL=uniV3.d.ts.map

package/dist/abis/uniV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniV3.d.ts","sourceRoot":"","sources":["../../src/abis/uniV3.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCnB,CAAC;AAIX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCrB,CAAC"}

package/dist/index.cjs

@@ -31,7 +31,9 @@ __export(index_exports, {
   TOKENS: () => TOKENS,
   WCBTC_ABI: () => WCBTC_ABI,
   ZERO_ADDRESS: () => ZERO_ADDRESS,
+  applySlippage: () => applySlippage,
   areEquivalent: () => areEquivalent,
+  buildUniV3SwapCalls: () => buildUniV3SwapCalls,
   convertAmountBetweenDecimals: () => convertAmountBetweenDecimals,
   fetchWithRetry: () => fetchWithRetry,
   formatTokenAmount: () => formatTokenAmount,
@@ -57,8 +59,11 @@ __export(index_exports, {
   isUsdDenominated: () => isUsdDenominated,
   normalizeNativeTokenAddress: () => normalizeNativeTokenAddress,
   prepareRFQT: () => prepareRFQT,
+  resolveTokenRef: () => resolveTokenRef,
   submitTransaction: () => submitTransaction,
   truncateAddress: () => truncateAddress,
+  uniV3QuoterV2Abi: () => uniV3QuoterV2Abi,
+  uniV3SwapRouterAbi: () => uniV3SwapRouterAbi,
   withRetry: () => withRetry
 });
 module.exports = __toCommonJS(index_exports);
@@ -444,6 +449,24 @@ function isBtcDenominated(address) {
   const group = getEquivalenceGroup(address);
   return group !== void 0 && BTC_GROUPS.has(group);
 }
+function resolveTokenRef(ref) {
+  const [symbol, chainId] = ref;
+  const tokens = getTokensForChain(chainId);
+  const match = tokens.find(
+    (t) => t.symbol.toUpperCase() === symbol.toUpperCase()
+  );
+  if (!match) {
+    throw new Error(
+      `Token "${symbol}" not found on chain ${chainId} in the token registry.`
+    );
+  }
+  return {
+    address: match.address,
+    symbol: match.symbol,
+    decimals: match.decimals,
+    chainId
+  };
+}
 
 // src/chains/list.ts
 var CHAINS = {
@@ -990,6 +1013,129 @@ var WCBTC_ABI = [
   { stateMutability: "payable", type: "receive" },
   { stateMutability: "payable", type: "fallback" }
 ];
+
+// src/abis/uniV3.ts
+var uniV3QuoterV2Abi = [
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "address", name: "tokenIn", type: "address" },
+          { internalType: "address", name: "tokenOut", type: "address" },
+          { internalType: "uint256", name: "amountIn", type: "uint256" },
+          { internalType: "uint24", name: "fee", type: "uint24" },
+          {
+            internalType: "uint160",
+            name: "sqrtPriceLimitX96",
+            type: "uint160"
+          }
+        ],
+        internalType: "struct IQuoterV2.QuoteExactInputSingleParams",
+        name: "params",
+        type: "tuple"
+      }
+    ],
+    name: "quoteExactInputSingle",
+    outputs: [
+      { internalType: "uint256", name: "amountOut", type: "uint256" },
+      {
+        internalType: "uint160",
+        name: "sqrtPriceX96After",
+        type: "uint160"
+      },
+      {
+        internalType: "uint32",
+        name: "initializedTicksCrossed",
+        type: "uint32"
+      },
+      { internalType: "uint256", name: "gasEstimate", type: "uint256" }
+    ],
+    stateMutability: "nonpayable",
+    type: "function"
+  }
+];
+var uniV3SwapRouterAbi = [
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "address", name: "tokenIn", type: "address" },
+          { internalType: "address", name: "tokenOut", type: "address" },
+          { internalType: "uint24", name: "fee", type: "uint24" },
+          { internalType: "address", name: "recipient", type: "address" },
+          { internalType: "uint256", name: "amountIn", type: "uint256" },
+          {
+            internalType: "uint256",
+            name: "amountOutMinimum",
+            type: "uint256"
+          },
+          {
+            internalType: "uint160",
+            name: "sqrtPriceLimitX96",
+            type: "uint160"
+          }
+        ],
+        internalType: "struct IV3SwapRouter.ExactInputSingleParams",
+        name: "params",
+        type: "tuple"
+      }
+    ],
+    name: "exactInputSingle",
+    outputs: [
+      { internalType: "uint256", name: "amountOut", type: "uint256" }
+    ],
+    stateMutability: "payable",
+    type: "function"
+  }
+];
+
+// src/swap.ts
+var import_viem2 = require("viem");
+function applySlippage(amount, slippage = 0.03) {
+  const slippageBps = BigInt(Math.floor((1 - slippage) * 1e4));
+  return amount * slippageBps / 10000n;
+}
+function buildUniV3SwapCalls(params) {
+  const {
+    tokenIn,
+    tokenOut,
+    amountIn,
+    amountOutMinimum,
+    fee,
+    recipient,
+    config
+  } = params;
+  return [
+    {
+      to: tokenIn,
+      value: 0n,
+      data: (0, import_viem2.encodeFunctionData)({
+        abi: import_viem2.erc20Abi,
+        functionName: "approve",
+        args: [config.swapRouter, amountIn]
+      })
+    },
+    {
+      to: config.swapRouter,
+      value: 0n,
+      data: (0, import_viem2.encodeFunctionData)({
+        abi: uniV3SwapRouterAbi,
+        functionName: "exactInputSingle",
+        args: [
+          {
+            tokenIn,
+            tokenOut,
+            fee,
+            recipient,
+            amountIn,
+            amountOutMinimum,
+            sqrtPriceLimitX96: 0n
+          }
+        ]
+      })
+    }
+  ];
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CHAINS,
@@ -1004,7 +1150,9 @@ var WCBTC_ABI = [
   TOKENS,
   WCBTC_ABI,
   ZERO_ADDRESS,
+  applySlippage,
   areEquivalent,
+  buildUniV3SwapCalls,
   convertAmountBetweenDecimals,
   fetchWithRetry,
   formatTokenAmount,
@@ -1030,7 +1178,10 @@ var WCBTC_ABI = [
   isUsdDenominated,
   normalizeNativeTokenAddress,
   prepareRFQT,
+  resolveTokenRef,
   submitTransaction,
   truncateAddress,
+  uniV3QuoterV2Abi,
+  uniV3SwapRouterAbi,
   withRetry
 });

package/dist/index.d.ts

@@ -10,4 +10,5 @@ export * from "./tokens/index.js";
 export * from "./chains/index.js";
 export * from "./utils.js";
 export * from "./abis/index.js";
+export * from "./swap.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,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;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,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;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -379,6 +379,24 @@ function isBtcDenominated(address) {
   const group = getEquivalenceGroup(address);
   return group !== void 0 && BTC_GROUPS.has(group);
 }
+function resolveTokenRef(ref) {
+  const [symbol, chainId] = ref;
+  const tokens = getTokensForChain(chainId);
+  const match = tokens.find(
+    (t) => t.symbol.toUpperCase() === symbol.toUpperCase()
+  );
+  if (!match) {
+    throw new Error(
+      `Token "${symbol}" not found on chain ${chainId} in the token registry.`
+    );
+  }
+  return {
+    address: match.address,
+    symbol: match.symbol,
+    decimals: match.decimals,
+    chainId
+  };
+}
 
 // src/chains/list.ts
 var CHAINS = {
@@ -925,6 +943,129 @@ var WCBTC_ABI = [
   { stateMutability: "payable", type: "receive" },
   { stateMutability: "payable", type: "fallback" }
 ];
+
+// src/abis/uniV3.ts
+var uniV3QuoterV2Abi = [
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "address", name: "tokenIn", type: "address" },
+          { internalType: "address", name: "tokenOut", type: "address" },
+          { internalType: "uint256", name: "amountIn", type: "uint256" },
+          { internalType: "uint24", name: "fee", type: "uint24" },
+          {
+            internalType: "uint160",
+            name: "sqrtPriceLimitX96",
+            type: "uint160"
+          }
+        ],
+        internalType: "struct IQuoterV2.QuoteExactInputSingleParams",
+        name: "params",
+        type: "tuple"
+      }
+    ],
+    name: "quoteExactInputSingle",
+    outputs: [
+      { internalType: "uint256", name: "amountOut", type: "uint256" },
+      {
+        internalType: "uint160",
+        name: "sqrtPriceX96After",
+        type: "uint160"
+      },
+      {
+        internalType: "uint32",
+        name: "initializedTicksCrossed",
+        type: "uint32"
+      },
+      { internalType: "uint256", name: "gasEstimate", type: "uint256" }
+    ],
+    stateMutability: "nonpayable",
+    type: "function"
+  }
+];
+var uniV3SwapRouterAbi = [
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "address", name: "tokenIn", type: "address" },
+          { internalType: "address", name: "tokenOut", type: "address" },
+          { internalType: "uint24", name: "fee", type: "uint24" },
+          { internalType: "address", name: "recipient", type: "address" },
+          { internalType: "uint256", name: "amountIn", type: "uint256" },
+          {
+            internalType: "uint256",
+            name: "amountOutMinimum",
+            type: "uint256"
+          },
+          {
+            internalType: "uint160",
+            name: "sqrtPriceLimitX96",
+            type: "uint160"
+          }
+        ],
+        internalType: "struct IV3SwapRouter.ExactInputSingleParams",
+        name: "params",
+        type: "tuple"
+      }
+    ],
+    name: "exactInputSingle",
+    outputs: [
+      { internalType: "uint256", name: "amountOut", type: "uint256" }
+    ],
+    stateMutability: "payable",
+    type: "function"
+  }
+];
+
+// src/swap.ts
+import { encodeFunctionData, erc20Abi } from "viem";
+function applySlippage(amount, slippage = 0.03) {
+  const slippageBps = BigInt(Math.floor((1 - slippage) * 1e4));
+  return amount * slippageBps / 10000n;
+}
+function buildUniV3SwapCalls(params) {
+  const {
+    tokenIn,
+    tokenOut,
+    amountIn,
+    amountOutMinimum,
+    fee,
+    recipient,
+    config
+  } = params;
+  return [
+    {
+      to: tokenIn,
+      value: 0n,
+      data: encodeFunctionData({
+        abi: erc20Abi,
+        functionName: "approve",
+        args: [config.swapRouter, amountIn]
+      })
+    },
+    {
+      to: config.swapRouter,
+      value: 0n,
+      data: encodeFunctionData({
+        abi: uniV3SwapRouterAbi,
+        functionName: "exactInputSingle",
+        args: [
+          {
+            tokenIn,
+            tokenOut,
+            fee,
+            recipient,
+            amountIn,
+            amountOutMinimum,
+            sqrtPriceLimitX96: 0n
+          }
+        ]
+      })
+    }
+  ];
+}
 export {
   CHAINS,
   ChainBatchHashAbi,
@@ -938,7 +1079,9 @@ export {
   TOKENS,
   WCBTC_ABI,
   ZERO_ADDRESS,
+  applySlippage,
   areEquivalent,
+  buildUniV3SwapCalls,
   convertAmountBetweenDecimals,
   fetchWithRetry,
   formatTokenAmount,
@@ -964,7 +1107,10 @@ export {
   isUsdDenominated,
   normalizeNativeTokenAddress,
   prepareRFQT,
+  resolveTokenRef,
   submitTransaction,
   truncateAddress,
+  uniV3QuoterV2Abi,
+  uniV3SwapRouterAbi,
   withRetry
 };

package/dist/swap.d.ts

@@ -0,0 +1,31 @@
+import { type Address } from "viem";
+import type { Call } from "./types.js";
+export interface UniV3SwapConfig {
+    swapRouter: Address;
+    quoterV2: Address;
+}
+export interface UniV3QuoteParams {
+    tokenIn: Address;
+    tokenOut: Address;
+    amountIn: bigint;
+    fee: number;
+    chainId: number;
+    config: UniV3SwapConfig;
+}
+export interface UniV3QuoteResult {
+    amountOut: bigint;
+    sqrtPriceX96After: bigint;
+    gasEstimate: bigint;
+}
+export interface UniV3BuildSwapParams {
+    tokenIn: Address;
+    tokenOut: Address;
+    amountIn: bigint;
+    amountOutMinimum: bigint;
+    fee: number;
+    recipient: Address;
+    config: UniV3SwapConfig;
+}
+export declare function applySlippage(amount: bigint, slippage?: number): bigint;
+export declare function buildUniV3SwapCalls(params: UniV3BuildSwapParams): Call[];
+//# sourceMappingURL=swap.d.ts.map

package/dist/swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../src/swap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAElE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,MAAM,CAGrE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,EAAE,CAyCxE"}

package/dist/tokens/index.d.ts

@@ -1,13 +1,15 @@
-export type { SwapContract, TokenDeployment, Token, ResolvedToken } from "./types.js";
+export type { SwapContract, TokenDeployment, TokenDefinition, Token } from "./types.js";
 export { TOKENS } from "./list.js";
-import type { Token, TokenDeployment, ResolvedToken } from "./types.js";
-export declare function getTokensForChain(chainId: number): ResolvedToken[];
-export declare function getTokenByAddress(address: string, chainId: number): ResolvedToken | undefined;
-export declare function getTokenDefinition(address: string): Token | undefined;
+import type { TokenDefinition, TokenDeployment, Token } from "./types.js";
+import type { ChainToken, TokenRef } from "../types.js";
+export declare function getTokensForChain(chainId: number): Token[];
+export declare function getTokenByAddress(address: string, chainId: number): Token | undefined;
+export declare function getTokenDefinition(address: string): TokenDefinition | undefined;
 export declare function getDeployment(address: string, chainId: number): TokenDeployment | undefined;
 export declare function getEquivalentAddresses(tokenAddress: string): string[];
 export declare function getEquivalenceGroup(tokenAddress: string): string | undefined;
 export declare function areEquivalent(a: string, b: string): boolean;
 export declare function isUsdDenominated(address: string): boolean;
 export declare function isBtcDenominated(address: string): boolean;
+export declare function resolveTokenRef(ref: TokenRef): ChainToken;
 //# sourceMappingURL=index.d.ts.map

package/dist/tokens/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA6CxE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAIlE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAI7F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAErE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE3F;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAIrE;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAK3D;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA6CxD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAI1D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAIrF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE/E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE3F;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAIrE;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAK3D;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,UAAU,CAmBzD"}

package/dist/tokens/list.d.ts

@@ -1,3 +1,3 @@
-import type { Token } from "./types.js";
-export declare const TOKENS: Token[];
+import type { TokenDefinition } from "./types.js";
+export declare const TOKENS: TokenDefinition[];
 //# sourceMappingURL=list.d.ts.map

package/dist/tokens/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tokens/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,eAAO,MAAM,MAAM,EAAE,KAAK,EAuHzB,CAAC"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tokens/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,eAAO,MAAM,MAAM,EAAE,eAAe,EAuHnC,CAAC"}

package/dist/tokens/types.d.ts

@@ -12,14 +12,14 @@ export interface TokenDeployment {
     network: Network;
     swapContracts: SwapContract[];
 }
-export interface Token {
+export interface TokenDefinition {
     symbol: string;
     name: string;
     equivalenceGroup: string;
     logo: string;
     deployments: TokenDeployment[];
 }
-export interface ResolvedToken {
+export interface Token {
     symbol: string;
     name: string;
     equivalenceGroup: string;

package/dist/tokens/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tokens/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tokens/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAGD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAGD,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B"}

package/dist/types.d.ts

@@ -4,6 +4,46 @@ export type Call = {
     value: bigint;
     data: Hex;
 };
+/** A declarative swap that the SDK resolves into concrete approve + swap Call[] before signing. */
+export interface SwapIntent {
+    type: "swap";
+    tokenIn: Address;
+    tokenOut: Address;
+    amountIn: bigint;
+    maxSlippage?: number;
+}
+/** A batch entry is either a concrete Call or a declarative SwapIntent. */
+export type BatchEntry = Call | SwapIntent;
+/** Token transfer config for solver-managed transfers within a batch. */
+export interface TokenTransferConfig {
+    from: Address | "solver";
+    to: Address;
+    token: Address;
+    amount: bigint;
+}
+export interface ChainToken {
+    address: Address;
+    symbol: string;
+    decimals: number;
+    chainId: number;
+}
+export type TokenRef = [symbol: string, chainId: number];
+export type RouteStrategy = "direct" | "source-swap" | "intermediary";
+export interface RoutePlan {
+    strategy: RouteStrategy;
+    sourceAsset: ChainToken;
+    outputAsset: ChainToken;
+    intermediaryAsset?: ChainToken;
+    sourceChainId: number;
+    destinationChainId: number;
+    summary: string;
+}
+export interface ResolvedSwap {
+    venue: string;
+    amountOut: bigint;
+    amountOutMinimum: bigint;
+    calls: Call[];
+}
 export type Authorization = {
     address: string;
     chainId: number;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE1D,MAAM,MAAM,IAAI,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC;AAE7D,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,MAAM,WAAW,MAAM;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC,CAAC;CACrE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE1D,MAAM,MAAM,IAAI,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC;AAE7D,mGAAmG;AACnG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2EAA2E;AAC3E,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,UAAU,CAAC;AAE3C,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,aAAa,GAAG,cAAc,CAAC;AAEtE,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE,UAAU,CAAC;IACxB,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,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,MAAM,WAAW,MAAM;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC,CAAC;CACrE"}

package/package.json

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