@avalabs/fusion-sdk 0.0.0-additive-fee-allowance-buffer-20260325170134

package/dist/types/transfer.d.cts

@@ -0,0 +1,126 @@
+import { Caip2ChainId } from "./caip.cjs";
+import { Chain } from "./chain.cjs";
+import { Environment, ServiceType, TransferSignatureReason } from "../constants.cjs";
+import { Asset } from "./asset.cjs";
+import { Quote, QuoteFees } from "./quote.cjs";
+import { ErrorCode } from "../errors.cjs";
+
+//#region src/types/transfer.d.ts
+/** Step status emitted during execution. */
+interface TransferStepDetails {
+  /** 1-based index for current signature request. */
+  readonly currentSignature: number;
+  /** Why the current signature is needed. */
+  readonly currentSignatureReason: TransferSignatureReason;
+  /** Total number of signatures expected. */
+  readonly requiredSignatures: number;
+  /** The original quote */
+  readonly quote: Quote;
+}
+/**
+* Unified transfer lifecycle states (bridge and swap).
+*/
+type TransferStatus = "created" | "source-pending" | "source-completed" | "target-pending" | "refunded" | "completed" | "failed";
+/** Common fields for any transfer (bridge or swap). */
+interface TransferBase {
+  /** The original source asset amount (smallest unit). */
+  readonly amountIn: bigint;
+  /** The original quoted target asset amount (smallest unit). */
+  readonly amountOut: bigint;
+  readonly environment: Environment;
+  readonly fees: QuoteFees;
+  readonly fromAddress: string;
+  /** Client-stable UUID for persistence. */
+  readonly id: string;
+  /** Optional implementer metadata bag. */
+  readonly metadata?: Record<string, unknown>;
+  readonly partnerFeeBps: number | null;
+  readonly sourceAsset: Asset;
+  readonly sourceChain: Chain;
+  readonly status: TransferStatus;
+  readonly targetAsset: Asset;
+  readonly targetChain: Chain;
+  readonly toAddress: string;
+  /** ServiceType used. */
+  readonly type: ServiceType;
+}
+/** Source leg progress. */
+interface TransferSourceProgress<TxHash extends string = string> {
+  readonly confirmationCount: number;
+  readonly requiredConfirmationCount: number;
+  readonly startedAtMs: number;
+  /**
+  * Target chains block number to start a tx hash lookup from.
+  * Not applicable for same-chain transfers.
+  * */
+  readonly targetStartBlockNumber?: bigint;
+  /** Source tx hash. */
+  readonly txHash: TxHash;
+}
+/** Target leg progress. */
+interface TransferTargetProgress<TxHash extends string = string> {
+  readonly confirmationCount: number;
+  readonly requiredConfirmationCount: number;
+  readonly startedAtMs: number;
+  /** Target tx hash, if/when known. */
+  readonly txHash?: TxHash;
+}
+interface SourcePendingTransfer<SourceTxHash extends string = string> extends TransferBase {
+  readonly status: "source-pending";
+  readonly source: TransferSourceProgress<SourceTxHash>;
+}
+/**
+* This status is used for bridge transfers.
+*
+* This status indicates that a source transfer has completed,
+* but the target transfer has not yet been initiated.
+*
+* For same-chain swaps, this status is not applicable.
+*/
+interface SourceCompletedTransfer<SourceTxHash extends string = string> extends TransferBase {
+  readonly status: "source-completed";
+  readonly source: TransferSourceProgress<SourceTxHash>;
+}
+interface TargetPendingTransfer<SourceTxHash extends string = string, TargetTxHash extends string = string> extends TransferBase {
+  readonly status: "target-pending";
+  readonly source: TransferSourceProgress<SourceTxHash>;
+  readonly target: TransferTargetProgress<TargetTxHash> | null;
+}
+/**
+* Indicates that the cross-chain swap failed to fully complete (execute) on
+* the destination chain, and that a refund transaction has been issued.
+*
+* This is a "terminal" status (like "completed" or "failed") that indicates no further state changes will occur.
+*/
+interface RefundedTransfer<SourceTxHash extends string = string, TargetTxHash extends string = string> extends TransferBase {
+  readonly status: "refunded";
+  readonly refund: Readonly<{
+    /** The amount refunded (smallest unit) of refund asset. */amount: bigint; /** The asset the refund is issued in */
+    asset: Asset | null; /** Chain ID where the refund is issued */
+    chainId: Caip2ChainId; /** Transaction hash of the refund */
+    txHash: SourceTxHash | TargetTxHash | null; /** Timestamp when the refund was issued */
+    timestampMs: number;
+  }>;
+  readonly source: TransferSourceProgress<SourceTxHash>;
+  readonly target: TransferTargetProgress<TargetTxHash> | null;
+}
+interface CompletedTransfer<SourceTxHash extends string = string, TargetTxHash extends string = string> extends TransferBase {
+  readonly status: "completed";
+  readonly completedAtMs: number;
+  readonly source: TransferSourceProgress<SourceTxHash>;
+  readonly target: TransferTargetProgress<TargetTxHash> | null;
+}
+interface FailedTransfer<SourceTxHash extends string = string, TargetTxHash extends string = string> extends TransferBase {
+  readonly status: "failed";
+  readonly failedAtMs: number;
+  /** Optional provider-specific error code. */
+  readonly errorCode?: ErrorCode;
+  readonly errorReason?: string;
+  readonly source?: TransferSourceProgress<SourceTxHash>;
+  readonly target?: TransferTargetProgress<TargetTxHash> | null;
+}
+/** Discriminated union for runtime tracking. */
+type Transfer<SourceTxHash extends string = string, TargetTxHash extends string = string> = SourcePendingTransfer<SourceTxHash> | SourceCompletedTransfer<SourceTxHash> | TargetPendingTransfer<SourceTxHash, TargetTxHash> | RefundedTransfer<SourceTxHash, TargetTxHash> | CompletedTransfer<SourceTxHash, TargetTxHash> | FailedTransfer<SourceTxHash, TargetTxHash>;
+//#endregion
+export { CompletedTransfer, FailedTransfer, RefundedTransfer, SourceCompletedTransfer, SourcePendingTransfer, TargetPendingTransfer, Transfer, TransferBase, TransferSourceProgress, TransferStatus, TransferStepDetails, TransferTargetProgress };
+//# sourceMappingURL=transfer.d.cts.map

package/dist/types/transfer.d.ts

@@ -0,0 +1,126 @@
+import { Caip2ChainId } from "./caip.js";
+import { Chain } from "./chain.js";
+import { Environment, ServiceType, TransferSignatureReason } from "../constants.js";
+import { Asset } from "./asset.js";
+import { Quote, QuoteFees } from "./quote.js";
+import { ErrorCode } from "../errors.js";
+
+//#region src/types/transfer.d.ts
+/** Step status emitted during execution. */
+interface TransferStepDetails {
+  /** 1-based index for current signature request. */
+  readonly currentSignature: number;
+  /** Why the current signature is needed. */
+  readonly currentSignatureReason: TransferSignatureReason;
+  /** Total number of signatures expected. */
+  readonly requiredSignatures: number;
+  /** The original quote */
+  readonly quote: Quote;
+}
+/**
+* Unified transfer lifecycle states (bridge and swap).
+*/
+type TransferStatus = "created" | "source-pending" | "source-completed" | "target-pending" | "refunded" | "completed" | "failed";
+/** Common fields for any transfer (bridge or swap). */
+interface TransferBase {
+  /** The original source asset amount (smallest unit). */
+  readonly amountIn: bigint;
+  /** The original quoted target asset amount (smallest unit). */
+  readonly amountOut: bigint;
+  readonly environment: Environment;
+  readonly fees: QuoteFees;
+  readonly fromAddress: string;
+  /** Client-stable UUID for persistence. */
+  readonly id: string;
+  /** Optional implementer metadata bag. */
+  readonly metadata?: Record<string, unknown>;
+  readonly partnerFeeBps: number | null;
+  readonly sourceAsset: Asset;
+  readonly sourceChain: Chain;
+  readonly status: TransferStatus;
+  readonly targetAsset: Asset;
+  readonly targetChain: Chain;
+  readonly toAddress: string;
+  /** ServiceType used. */
+  readonly type: ServiceType;
+}
+/** Source leg progress. */
+interface TransferSourceProgress<TxHash extends string = string> {
+  readonly confirmationCount: number;
+  readonly requiredConfirmationCount: number;
+  readonly startedAtMs: number;
+  /**
+  * Target chains block number to start a tx hash lookup from.
+  * Not applicable for same-chain transfers.
+  * */
+  readonly targetStartBlockNumber?: bigint;
+  /** Source tx hash. */
+  readonly txHash: TxHash;
+}
+/** Target leg progress. */
+interface TransferTargetProgress<TxHash extends string = string> {
+  readonly confirmationCount: number;
+  readonly requiredConfirmationCount: number;
+  readonly startedAtMs: number;
+  /** Target tx hash, if/when known. */
+  readonly txHash?: TxHash;
+}
+interface SourcePendingTransfer<SourceTxHash extends string = string> extends TransferBase {
+  readonly status: "source-pending";
+  readonly source: TransferSourceProgress<SourceTxHash>;
+}
+/**
+* This status is used for bridge transfers.
+*
+* This status indicates that a source transfer has completed,
+* but the target transfer has not yet been initiated.
+*
+* For same-chain swaps, this status is not applicable.
+*/
+interface SourceCompletedTransfer<SourceTxHash extends string = string> extends TransferBase {
+  readonly status: "source-completed";
+  readonly source: TransferSourceProgress<SourceTxHash>;
+}
+interface TargetPendingTransfer<SourceTxHash extends string = string, TargetTxHash extends string = string> extends TransferBase {
+  readonly status: "target-pending";
+  readonly source: TransferSourceProgress<SourceTxHash>;
+  readonly target: TransferTargetProgress<TargetTxHash> | null;
+}
+/**
+* Indicates that the cross-chain swap failed to fully complete (execute) on
+* the destination chain, and that a refund transaction has been issued.
+*
+* This is a "terminal" status (like "completed" or "failed") that indicates no further state changes will occur.
+*/
+interface RefundedTransfer<SourceTxHash extends string = string, TargetTxHash extends string = string> extends TransferBase {
+  readonly status: "refunded";
+  readonly refund: Readonly<{
+    /** The amount refunded (smallest unit) of refund asset. */amount: bigint; /** The asset the refund is issued in */
+    asset: Asset | null; /** Chain ID where the refund is issued */
+    chainId: Caip2ChainId; /** Transaction hash of the refund */
+    txHash: SourceTxHash | TargetTxHash | null; /** Timestamp when the refund was issued */
+    timestampMs: number;
+  }>;
+  readonly source: TransferSourceProgress<SourceTxHash>;
+  readonly target: TransferTargetProgress<TargetTxHash> | null;
+}
+interface CompletedTransfer<SourceTxHash extends string = string, TargetTxHash extends string = string> extends TransferBase {
+  readonly status: "completed";
+  readonly completedAtMs: number;
+  readonly source: TransferSourceProgress<SourceTxHash>;
+  readonly target: TransferTargetProgress<TargetTxHash> | null;
+}
+interface FailedTransfer<SourceTxHash extends string = string, TargetTxHash extends string = string> extends TransferBase {
+  readonly status: "failed";
+  readonly failedAtMs: number;
+  /** Optional provider-specific error code. */
+  readonly errorCode?: ErrorCode;
+  readonly errorReason?: string;
+  readonly source?: TransferSourceProgress<SourceTxHash>;
+  readonly target?: TransferTargetProgress<TargetTxHash> | null;
+}
+/** Discriminated union for runtime tracking. */
+type Transfer<SourceTxHash extends string = string, TargetTxHash extends string = string> = SourcePendingTransfer<SourceTxHash> | SourceCompletedTransfer<SourceTxHash> | TargetPendingTransfer<SourceTxHash, TargetTxHash> | RefundedTransfer<SourceTxHash, TargetTxHash> | CompletedTransfer<SourceTxHash, TargetTxHash> | FailedTransfer<SourceTxHash, TargetTxHash>;
+//#endregion
+export { CompletedTransfer, FailedTransfer, RefundedTransfer, SourceCompletedTransfer, SourcePendingTransfer, TargetPendingTransfer, Transfer, TransferBase, TransferSourceProgress, TransferStatus, TransferStepDetails, TransferTargetProgress };
+//# sourceMappingURL=transfer.d.ts.map

package/dist/types/utility-types.d.cts

@@ -0,0 +1,21 @@
+//#region src/types/utility-types.d.ts
+/**
+* This file should only contain types and interfaces.
+* No runtime code.
+*/
+/**
+* Utility type to extract the element type from an array type.
+*/
+type ArrayElement<A> = A extends readonly (infer T)[] ? T : never;
+/**
+* Utility type to make all properties of a type mutable (non-readonly).
+*/
+type Mutable<T> = { -readonly [P in keyof T]: T[P] };
+/**
+* Like Mutable, but applies recursively to nested objects.
+*/
+type DeepMutable<T> = { -readonly [P in keyof T]: T[P] extends object ? DeepMutable<T[P]> : T[P] };
+type Fetch = typeof globalThis.fetch;
+//#endregion
+export { ArrayElement, DeepMutable, Fetch, Mutable };
+//# sourceMappingURL=utility-types.d.cts.map

package/dist/types/utility-types.d.ts

@@ -0,0 +1,21 @@
+//#region src/types/utility-types.d.ts
+/**
+* This file should only contain types and interfaces.
+* No runtime code.
+*/
+/**
+* Utility type to extract the element type from an array type.
+*/
+type ArrayElement<A> = A extends readonly (infer T)[] ? T : never;
+/**
+* Utility type to make all properties of a type mutable (non-readonly).
+*/
+type Mutable<T> = { -readonly [P in keyof T]: T[P] };
+/**
+* Like Mutable, but applies recursively to nested objects.
+*/
+type DeepMutable<T> = { -readonly [P in keyof T]: T[P] extends object ? DeepMutable<T[P]> : T[P] };
+type Fetch = typeof globalThis.fetch;
+//#endregion
+export { ArrayElement, DeepMutable, Fetch, Mutable };
+//# sourceMappingURL=utility-types.d.ts.map

package/dist/utils/asset-id.cjs

@@ -0,0 +1,2 @@
+const e=require(`../constants.cjs`);function t(t,n){return n.type===e.TokenType.NATIVE?`${t}:${n.type}`:`${t}:${n.type}:${n.address.toLowerCase()}`}exports.getAssetId=t;
+//# sourceMappingURL=asset-id.cjs.map

package/dist/utils/asset-id.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-id.cjs","names":["TokenType"],"sources":["../../src/utils/asset-id.ts"],"sourcesContent":["import { TokenType } from '../constants';\nimport type { Asset } from '../types/asset';\nimport type { Caip2ChainId } from '../types/caip';\n\n/**\n * Returns a unique string identifier for an asset on a given chain.\n *\n * Format:\n *  - Native assets: `{chainId}:native`\n *  - Token assets:  `{chainId}:{tokenType}:{lowercaseAddress}`\n */\nexport function getAssetId(chainId: Caip2ChainId, asset: Asset): string {\n  if (asset.type === TokenType.NATIVE) {\n    return `${chainId}:${asset.type}`;\n  }\n\n  return `${chainId}:${asset.type}:${asset.address.toLowerCase()}`;\n}\n"],"mappings":"oCAWA,SAAgB,EAAW,EAAuB,EAAsB,CAKtE,OAJI,EAAM,OAASA,EAAAA,UAAU,OACpB,GAAG,EAAQ,GAAG,EAAM,OAGtB,GAAG,EAAQ,GAAG,EAAM,KAAK,GAAG,EAAM,QAAQ,aAAa"}

package/dist/utils/asset-id.js

@@ -0,0 +1,2 @@
+import{TokenType as e}from"../constants.js";function t(t,n){return n.type===e.NATIVE?`${t}:${n.type}`:`${t}:${n.type}:${n.address.toLowerCase()}`}export{t as getAssetId};
+//# sourceMappingURL=asset-id.js.map

package/dist/utils/asset-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-id.js","names":[],"sources":["../../src/utils/asset-id.ts"],"sourcesContent":["import { TokenType } from '../constants';\nimport type { Asset } from '../types/asset';\nimport type { Caip2ChainId } from '../types/caip';\n\n/**\n * Returns a unique string identifier for an asset on a given chain.\n *\n * Format:\n *  - Native assets: `{chainId}:native`\n *  - Token assets:  `{chainId}:{tokenType}:{lowercaseAddress}`\n */\nexport function getAssetId(chainId: Caip2ChainId, asset: Asset): string {\n  if (asset.type === TokenType.NATIVE) {\n    return `${chainId}:${asset.type}`;\n  }\n\n  return `${chainId}:${asset.type}:${asset.address.toLowerCase()}`;\n}\n"],"mappings":"4CAWA,SAAgB,EAAW,EAAuB,EAAsB,CAKtE,OAJI,EAAM,OAAS,EAAU,OACpB,GAAG,EAAQ,GAAG,EAAM,OAGtB,GAAG,EAAQ,GAAG,EAAM,KAAK,GAAG,EAAM,QAAQ,aAAa"}

package/dist/utils/bitcoin-address.cjs

@@ -0,0 +1,2 @@
+require(`../_virtual/_rolldown/runtime.cjs`);let e=require(`@scure/base`);function t(e){return e.toLowerCase().startsWith(`tb1`)||e.toLowerCase().startsWith(`bc1`)}function n(n){if(!t(n))return!1;try{return e.bech32.decode(n),!0}catch{return!1}}function r(e,t){return n(e)?e.toLowerCase().startsWith(t?`bc`:`tb`):!1}exports.isBech32Address=n,exports.isBech32AddressInNetwork=r;
+//# sourceMappingURL=bitcoin-address.cjs.map

package/dist/utils/bitcoin-address.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin-address.cjs","names":[],"sources":["../../src/utils/bitcoin-address.ts"],"sourcesContent":["import { bech32 } from '@scure/base';\n\nfunction isBech32Format(address: string): address is `tb1${string}` | `bc1${string}` {\n  return address.toLowerCase().startsWith('tb1') || address.toLowerCase().startsWith('bc1');\n}\n\nexport function isBech32Address(address: string): boolean {\n  if (!isBech32Format(address)) {\n    return false;\n  }\n\n  try {\n    bech32.decode(address);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport function isBech32AddressInNetwork(address: string, isMainnet: boolean): boolean {\n  if (isBech32Address(address)) {\n    return address.toLowerCase().startsWith(isMainnet ? 'bc' : 'tb');\n  }\n  return false;\n}\n"],"mappings":"0EAEA,SAAS,EAAe,EAA6D,CACnF,OAAO,EAAQ,aAAa,CAAC,WAAW,MAAM,EAAI,EAAQ,aAAa,CAAC,WAAW,MAAM,CAG3F,SAAgB,EAAgB,EAA0B,CACxD,GAAI,CAAC,EAAe,EAAQ,CAC1B,MAAO,GAGT,GAAI,CAEF,OADA,EAAA,OAAO,OAAO,EAAQ,CACf,QACD,CACN,MAAO,IAIX,SAAgB,EAAyB,EAAiB,EAA6B,CAIrF,OAHI,EAAgB,EAAQ,CACnB,EAAQ,aAAa,CAAC,WAAW,EAAY,KAAO,KAAK,CAE3D"}

package/dist/utils/bitcoin-address.js

@@ -0,0 +1,2 @@
+import{bech32 as e}from"@scure/base";function t(e){return e.toLowerCase().startsWith(`tb1`)||e.toLowerCase().startsWith(`bc1`)}function n(n){if(!t(n))return!1;try{return e.decode(n),!0}catch{return!1}}function r(e,t){return n(e)?e.toLowerCase().startsWith(t?`bc`:`tb`):!1}export{n as isBech32Address,r as isBech32AddressInNetwork};
+//# sourceMappingURL=bitcoin-address.js.map

package/dist/utils/bitcoin-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin-address.js","names":[],"sources":["../../src/utils/bitcoin-address.ts"],"sourcesContent":["import { bech32 } from '@scure/base';\n\nfunction isBech32Format(address: string): address is `tb1${string}` | `bc1${string}` {\n  return address.toLowerCase().startsWith('tb1') || address.toLowerCase().startsWith('bc1');\n}\n\nexport function isBech32Address(address: string): boolean {\n  if (!isBech32Format(address)) {\n    return false;\n  }\n\n  try {\n    bech32.decode(address);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport function isBech32AddressInNetwork(address: string, isMainnet: boolean): boolean {\n  if (isBech32Address(address)) {\n    return address.toLowerCase().startsWith(isMainnet ? 'bc' : 'tb');\n  }\n  return false;\n}\n"],"mappings":"qCAEA,SAAS,EAAe,EAA6D,CACnF,OAAO,EAAQ,aAAa,CAAC,WAAW,MAAM,EAAI,EAAQ,aAAa,CAAC,WAAW,MAAM,CAG3F,SAAgB,EAAgB,EAA0B,CACxD,GAAI,CAAC,EAAe,EAAQ,CAC1B,MAAO,GAGT,GAAI,CAEF,OADA,EAAO,OAAO,EAAQ,CACf,QACD,CACN,MAAO,IAIX,SAAgB,EAAyB,EAAiB,EAA6B,CAIrF,OAHI,EAAgB,EAAQ,CACnB,EAAQ,aAAa,CAAC,WAAW,EAAY,KAAO,KAAK,CAE3D"}

package/dist/utils/caip.cjs

@@ -0,0 +1,2 @@
+const e=require(`../errors.cjs`),t=/^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$/,n=/^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,50}$/,r=(e,r=!0)=>r?t.test(e):n.test(e),i=t=>{let[n,r]=t.split(`:`);if(!n||!r)throw new e.SdkError(e.ErrorReason.INVALID_PARAMS,e.ErrorCode.INVALID_PARAMS,{details:`Invalid CAIP-2 chain ID: ${t}`});return{namespace:n,reference:r}},a=t=>{let{namespace:n,reference:r}=i(t);if(n!==`eip155`)throw new e.SdkError(e.ErrorReason.INVALID_PARAMS,e.ErrorCode.INVALID_PARAMS,{details:`CAIP-2 chain ID is not in the eip155 namespace: ${t}`});let a=Number(r);if(isNaN(a))throw new e.SdkError(e.ErrorReason.INVALID_PARAMS,e.ErrorCode.INVALID_PARAMS,{details:`CAIP-2 chain ID reference is not a valid number: ${t}`});return a},o=e=>`0x${a(e).toString(16)}`,s=t=>{if(!Number.isInteger(t)||t<0)throw new e.SdkError(e.ErrorReason.INVALID_PARAMS,e.ErrorCode.INVALID_PARAMS,{details:`Invalid EIP-155 chain ID: ${t}`});return`eip155:${t}`};exports.caip2ToEip155ChainId=a,exports.caip2ToEip155HexChainId=o,exports.eip155ChainIdToCaip2=s,exports.isCaip2ChainId=r,exports.splitCaip2ChainId=i;
+//# sourceMappingURL=caip.cjs.map

package/dist/utils/caip.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.cjs","names":["SdkError","ErrorReason","ErrorCode"],"sources":["../../src/utils/caip.ts"],"sourcesContent":["import { ErrorCode, ErrorReason, SdkError } from '../errors';\nimport type { Caip2ChainId } from '../types/caip';\n\n/**\n * Strictly follows the CAIP-2 specification.\n * @see https://chainagnostic.org/CAIPs/caip-2\n */\nconst CAIP2_STRICT_REGEX = /^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$/;\n/**\n * Loosely follows the CAIP-2 specification, allowing up to 50 characters in the reference part.\n * This is to accommodate chain IDs that use longer references (ie cb58 encoded chain IDs).\n */\nconst CAIP2_LOOSE_REGEX = /^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,50}$/;\n\n/**\n * Checks whether a given chainId is a valid CAIP-2 chain ID.\n *\n * @param chainId The chainId to verify is CAIP-2\n * @param strict Whether to use strict validation (default: true)\n * @returns Boolean indicating whether the chainId is a valid CAIP-2 chain ID\n */\nexport const isCaip2ChainId = (chainId: string, strict = true): chainId is Caip2ChainId => {\n  if (!strict) {\n    return CAIP2_LOOSE_REGEX.test(chainId);\n  }\n\n  return CAIP2_STRICT_REGEX.test(chainId);\n};\n\n/**\n * Splits a CAIP-2 chain ID into its namespace and reference components.\n *\n * @param chainId The CAIP-2 chain ID to split\n * @returns An object containing the namespace and reference\n * @throws SdkError if the chainId is not a valid CAIP-2 chain ID\n */\nexport const splitCaip2ChainId = (chainId: Caip2ChainId): { namespace: string; reference: string } => {\n  const [namespace, reference] = chainId.split(':');\n\n  if (!namespace || !reference) {\n    throw new SdkError(ErrorReason.INVALID_PARAMS, ErrorCode.INVALID_PARAMS, {\n      details: `Invalid CAIP-2 chain ID: ${chainId}`,\n    });\n  }\n\n  return { namespace, reference };\n};\n\n/**\n * Converts a CAIP-2 chain ID in the eip155 namespace to its corresponding EIP-155 numeric chain ID.\n *\n * @param chainId The CAIP-2 chain ID to convert\n * @returns The EIP-155 numeric chain ID\n * @throws SdkError if the chainId is not in the eip155 namespace or if the reference is not a valid number\n */\nexport const caip2ToEip155ChainId = (chainId: Caip2ChainId): number => {\n  const { namespace, reference } = splitCaip2ChainId(chainId);\n\n  if (namespace !== 'eip155') {\n    throw new SdkError(ErrorReason.INVALID_PARAMS, ErrorCode.INVALID_PARAMS, {\n      details: `CAIP-2 chain ID is not in the eip155 namespace: ${chainId}`,\n    });\n  }\n\n  const numericChainId = Number(reference);\n\n  if (isNaN(numericChainId)) {\n    throw new SdkError(ErrorReason.INVALID_PARAMS, ErrorCode.INVALID_PARAMS, {\n      details: `CAIP-2 chain ID reference is not a valid number: ${chainId}`,\n    });\n  }\n\n  return numericChainId;\n};\n\n/**\n * Converts a CAIP-2 chain ID in the eip155 namespace to its corresponding EIP-155 hexadecimal chain ID.\n *\n * @param chainId The CAIP-2 chain ID to convert\n * @returns The EIP-155 hexadecimal chain ID\n * @throws SdkError if the chainId is not in the eip155 namespace or if the reference is not a valid number\n */\nexport const caip2ToEip155HexChainId = (chainId: Caip2ChainId): `0x${string}` => {\n  const numericChainId = caip2ToEip155ChainId(chainId);\n\n  return `0x${numericChainId.toString(16)}` as `0x${string}`;\n};\n\n/**\n * Converts an EIP-155 numeric chain ID to its corresponding CAIP-2 chain ID in the eip155 namespace.\n *\n * @param chainId The EIP-155 numeric chain ID to convert\n * @returns The corresponding CAIP-2 chain ID in the eip155 namespace\n * @throws SdkError if the chainId is not a valid non-negative integer\n */\nexport const eip155ChainIdToCaip2 = (chainId: number): Caip2ChainId => {\n  if (!Number.isInteger(chainId) || chainId < 0) {\n    throw new SdkError(ErrorReason.INVALID_PARAMS, ErrorCode.INVALID_PARAMS, {\n      details: `Invalid EIP-155 chain ID: ${chainId}`,\n    });\n  }\n\n  return `eip155:${chainId}`;\n};\n"],"mappings":"iCAOM,EAAqB,sCAKrB,EAAoB,sCASb,GAAkB,EAAiB,EAAS,KAClD,EAIE,EAAmB,KAAK,EAAQ,CAH9B,EAAkB,KAAK,EAAQ,CAa7B,EAAqB,GAAoE,CACpG,GAAM,CAAC,EAAW,GAAa,EAAQ,MAAM,IAAI,CAEjD,GAAI,CAAC,GAAa,CAAC,EACjB,MAAM,IAAIA,EAAAA,SAASC,EAAAA,YAAY,eAAgBC,EAAAA,UAAU,eAAgB,CACvE,QAAS,4BAA4B,IACtC,CAAC,CAGJ,MAAO,CAAE,YAAW,YAAW,EAUpB,EAAwB,GAAkC,CACrE,GAAM,CAAE,YAAW,aAAc,EAAkB,EAAQ,CAE3D,GAAI,IAAc,SAChB,MAAM,IAAIF,EAAAA,SAASC,EAAAA,YAAY,eAAgBC,EAAAA,UAAU,eAAgB,CACvE,QAAS,mDAAmD,IAC7D,CAAC,CAGJ,IAAM,EAAiB,OAAO,EAAU,CAExC,GAAI,MAAM,EAAe,CACvB,MAAM,IAAIF,EAAAA,SAASC,EAAAA,YAAY,eAAgBC,EAAAA,UAAU,eAAgB,CACvE,QAAS,oDAAoD,IAC9D,CAAC,CAGJ,OAAO,GAUI,EAA2B,GAG/B,KAFgB,EAAqB,EAAQ,CAEzB,SAAS,GAAG,GAU5B,EAAwB,GAAkC,CACrE,GAAI,CAAC,OAAO,UAAU,EAAQ,EAAI,EAAU,EAC1C,MAAM,IAAIF,EAAAA,SAASC,EAAAA,YAAY,eAAgBC,EAAAA,UAAU,eAAgB,CACvE,QAAS,6BAA6B,IACvC,CAAC,CAGJ,MAAO,UAAU"}

package/dist/utils/caip.d.cts

@@ -0,0 +1,49 @@
+import { Caip2ChainId } from "../types/caip.cjs";
+
+//#region src/utils/caip.d.ts
+/**
+* Checks whether a given chainId is a valid CAIP-2 chain ID.
+*
+* @param chainId The chainId to verify is CAIP-2
+* @param strict Whether to use strict validation (default: true)
+* @returns Boolean indicating whether the chainId is a valid CAIP-2 chain ID
+*/
+declare const isCaip2ChainId: (chainId: string, strict?: boolean) => chainId is Caip2ChainId;
+/**
+* Splits a CAIP-2 chain ID into its namespace and reference components.
+*
+* @param chainId The CAIP-2 chain ID to split
+* @returns An object containing the namespace and reference
+* @throws SdkError if the chainId is not a valid CAIP-2 chain ID
+*/
+declare const splitCaip2ChainId: (chainId: Caip2ChainId) => {
+  namespace: string;
+  reference: string;
+};
+/**
+* Converts a CAIP-2 chain ID in the eip155 namespace to its corresponding EIP-155 numeric chain ID.
+*
+* @param chainId The CAIP-2 chain ID to convert
+* @returns The EIP-155 numeric chain ID
+* @throws SdkError if the chainId is not in the eip155 namespace or if the reference is not a valid number
+*/
+declare const caip2ToEip155ChainId: (chainId: Caip2ChainId) => number;
+/**
+* Converts a CAIP-2 chain ID in the eip155 namespace to its corresponding EIP-155 hexadecimal chain ID.
+*
+* @param chainId The CAIP-2 chain ID to convert
+* @returns The EIP-155 hexadecimal chain ID
+* @throws SdkError if the chainId is not in the eip155 namespace or if the reference is not a valid number
+*/
+declare const caip2ToEip155HexChainId: (chainId: Caip2ChainId) => `0x${string}`;
+/**
+* Converts an EIP-155 numeric chain ID to its corresponding CAIP-2 chain ID in the eip155 namespace.
+*
+* @param chainId The EIP-155 numeric chain ID to convert
+* @returns The corresponding CAIP-2 chain ID in the eip155 namespace
+* @throws SdkError if the chainId is not a valid non-negative integer
+*/
+declare const eip155ChainIdToCaip2: (chainId: number) => Caip2ChainId;
+//#endregion
+export { caip2ToEip155ChainId, caip2ToEip155HexChainId, eip155ChainIdToCaip2, isCaip2ChainId, splitCaip2ChainId };
+//# sourceMappingURL=caip.d.cts.map

package/dist/utils/caip.d.ts

@@ -0,0 +1,49 @@
+import { Caip2ChainId } from "../types/caip.js";
+
+//#region src/utils/caip.d.ts
+/**
+* Checks whether a given chainId is a valid CAIP-2 chain ID.
+*
+* @param chainId The chainId to verify is CAIP-2
+* @param strict Whether to use strict validation (default: true)
+* @returns Boolean indicating whether the chainId is a valid CAIP-2 chain ID
+*/
+declare const isCaip2ChainId: (chainId: string, strict?: boolean) => chainId is Caip2ChainId;
+/**
+* Splits a CAIP-2 chain ID into its namespace and reference components.
+*
+* @param chainId The CAIP-2 chain ID to split
+* @returns An object containing the namespace and reference
+* @throws SdkError if the chainId is not a valid CAIP-2 chain ID
+*/
+declare const splitCaip2ChainId: (chainId: Caip2ChainId) => {
+  namespace: string;
+  reference: string;
+};
+/**
+* Converts a CAIP-2 chain ID in the eip155 namespace to its corresponding EIP-155 numeric chain ID.
+*
+* @param chainId The CAIP-2 chain ID to convert
+* @returns The EIP-155 numeric chain ID
+* @throws SdkError if the chainId is not in the eip155 namespace or if the reference is not a valid number
+*/
+declare const caip2ToEip155ChainId: (chainId: Caip2ChainId) => number;
+/**
+* Converts a CAIP-2 chain ID in the eip155 namespace to its corresponding EIP-155 hexadecimal chain ID.
+*
+* @param chainId The CAIP-2 chain ID to convert
+* @returns The EIP-155 hexadecimal chain ID
+* @throws SdkError if the chainId is not in the eip155 namespace or if the reference is not a valid number
+*/
+declare const caip2ToEip155HexChainId: (chainId: Caip2ChainId) => `0x${string}`;
+/**
+* Converts an EIP-155 numeric chain ID to its corresponding CAIP-2 chain ID in the eip155 namespace.
+*
+* @param chainId The EIP-155 numeric chain ID to convert
+* @returns The corresponding CAIP-2 chain ID in the eip155 namespace
+* @throws SdkError if the chainId is not a valid non-negative integer
+*/
+declare const eip155ChainIdToCaip2: (chainId: number) => Caip2ChainId;
+//#endregion
+export { caip2ToEip155ChainId, caip2ToEip155HexChainId, eip155ChainIdToCaip2, isCaip2ChainId, splitCaip2ChainId };
+//# sourceMappingURL=caip.d.ts.map

package/dist/utils/caip.js

@@ -0,0 +1,2 @@
+import{ErrorCode as e,ErrorReason as t,SdkError as n}from"../errors.js";const r=/^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$/,i=/^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,50}$/,a=(e,t=!0)=>t?r.test(e):i.test(e),o=r=>{let[i,a]=r.split(`:`);if(!i||!a)throw new n(t.INVALID_PARAMS,e.INVALID_PARAMS,{details:`Invalid CAIP-2 chain ID: ${r}`});return{namespace:i,reference:a}},s=r=>{let{namespace:i,reference:a}=o(r);if(i!==`eip155`)throw new n(t.INVALID_PARAMS,e.INVALID_PARAMS,{details:`CAIP-2 chain ID is not in the eip155 namespace: ${r}`});let s=Number(a);if(isNaN(s))throw new n(t.INVALID_PARAMS,e.INVALID_PARAMS,{details:`CAIP-2 chain ID reference is not a valid number: ${r}`});return s},c=e=>`0x${s(e).toString(16)}`,l=r=>{if(!Number.isInteger(r)||r<0)throw new n(t.INVALID_PARAMS,e.INVALID_PARAMS,{details:`Invalid EIP-155 chain ID: ${r}`});return`eip155:${r}`};export{s as caip2ToEip155ChainId,c as caip2ToEip155HexChainId,l as eip155ChainIdToCaip2,a as isCaip2ChainId,o as splitCaip2ChainId};
+//# sourceMappingURL=caip.js.map

package/dist/utils/caip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.js","names":[],"sources":["../../src/utils/caip.ts"],"sourcesContent":["import { ErrorCode, ErrorReason, SdkError } from '../errors';\nimport type { Caip2ChainId } from '../types/caip';\n\n/**\n * Strictly follows the CAIP-2 specification.\n * @see https://chainagnostic.org/CAIPs/caip-2\n */\nconst CAIP2_STRICT_REGEX = /^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$/;\n/**\n * Loosely follows the CAIP-2 specification, allowing up to 50 characters in the reference part.\n * This is to accommodate chain IDs that use longer references (ie cb58 encoded chain IDs).\n */\nconst CAIP2_LOOSE_REGEX = /^[a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,50}$/;\n\n/**\n * Checks whether a given chainId is a valid CAIP-2 chain ID.\n *\n * @param chainId The chainId to verify is CAIP-2\n * @param strict Whether to use strict validation (default: true)\n * @returns Boolean indicating whether the chainId is a valid CAIP-2 chain ID\n */\nexport const isCaip2ChainId = (chainId: string, strict = true): chainId is Caip2ChainId => {\n  if (!strict) {\n    return CAIP2_LOOSE_REGEX.test(chainId);\n  }\n\n  return CAIP2_STRICT_REGEX.test(chainId);\n};\n\n/**\n * Splits a CAIP-2 chain ID into its namespace and reference components.\n *\n * @param chainId The CAIP-2 chain ID to split\n * @returns An object containing the namespace and reference\n * @throws SdkError if the chainId is not a valid CAIP-2 chain ID\n */\nexport const splitCaip2ChainId = (chainId: Caip2ChainId): { namespace: string; reference: string } => {\n  const [namespace, reference] = chainId.split(':');\n\n  if (!namespace || !reference) {\n    throw new SdkError(ErrorReason.INVALID_PARAMS, ErrorCode.INVALID_PARAMS, {\n      details: `Invalid CAIP-2 chain ID: ${chainId}`,\n    });\n  }\n\n  return { namespace, reference };\n};\n\n/**\n * Converts a CAIP-2 chain ID in the eip155 namespace to its corresponding EIP-155 numeric chain ID.\n *\n * @param chainId The CAIP-2 chain ID to convert\n * @returns The EIP-155 numeric chain ID\n * @throws SdkError if the chainId is not in the eip155 namespace or if the reference is not a valid number\n */\nexport const caip2ToEip155ChainId = (chainId: Caip2ChainId): number => {\n  const { namespace, reference } = splitCaip2ChainId(chainId);\n\n  if (namespace !== 'eip155') {\n    throw new SdkError(ErrorReason.INVALID_PARAMS, ErrorCode.INVALID_PARAMS, {\n      details: `CAIP-2 chain ID is not in the eip155 namespace: ${chainId}`,\n    });\n  }\n\n  const numericChainId = Number(reference);\n\n  if (isNaN(numericChainId)) {\n    throw new SdkError(ErrorReason.INVALID_PARAMS, ErrorCode.INVALID_PARAMS, {\n      details: `CAIP-2 chain ID reference is not a valid number: ${chainId}`,\n    });\n  }\n\n  return numericChainId;\n};\n\n/**\n * Converts a CAIP-2 chain ID in the eip155 namespace to its corresponding EIP-155 hexadecimal chain ID.\n *\n * @param chainId The CAIP-2 chain ID to convert\n * @returns The EIP-155 hexadecimal chain ID\n * @throws SdkError if the chainId is not in the eip155 namespace or if the reference is not a valid number\n */\nexport const caip2ToEip155HexChainId = (chainId: Caip2ChainId): `0x${string}` => {\n  const numericChainId = caip2ToEip155ChainId(chainId);\n\n  return `0x${numericChainId.toString(16)}` as `0x${string}`;\n};\n\n/**\n * Converts an EIP-155 numeric chain ID to its corresponding CAIP-2 chain ID in the eip155 namespace.\n *\n * @param chainId The EIP-155 numeric chain ID to convert\n * @returns The corresponding CAIP-2 chain ID in the eip155 namespace\n * @throws SdkError if the chainId is not a valid non-negative integer\n */\nexport const eip155ChainIdToCaip2 = (chainId: number): Caip2ChainId => {\n  if (!Number.isInteger(chainId) || chainId < 0) {\n    throw new SdkError(ErrorReason.INVALID_PARAMS, ErrorCode.INVALID_PARAMS, {\n      details: `Invalid EIP-155 chain ID: ${chainId}`,\n    });\n  }\n\n  return `eip155:${chainId}`;\n};\n"],"mappings":"wEAOA,MAAM,EAAqB,sCAKrB,EAAoB,sCASb,GAAkB,EAAiB,EAAS,KAClD,EAIE,EAAmB,KAAK,EAAQ,CAH9B,EAAkB,KAAK,EAAQ,CAa7B,EAAqB,GAAoE,CACpG,GAAM,CAAC,EAAW,GAAa,EAAQ,MAAM,IAAI,CAEjD,GAAI,CAAC,GAAa,CAAC,EACjB,MAAM,IAAI,EAAS,EAAY,eAAgB,EAAU,eAAgB,CACvE,QAAS,4BAA4B,IACtC,CAAC,CAGJ,MAAO,CAAE,YAAW,YAAW,EAUpB,EAAwB,GAAkC,CACrE,GAAM,CAAE,YAAW,aAAc,EAAkB,EAAQ,CAE3D,GAAI,IAAc,SAChB,MAAM,IAAI,EAAS,EAAY,eAAgB,EAAU,eAAgB,CACvE,QAAS,mDAAmD,IAC7D,CAAC,CAGJ,IAAM,EAAiB,OAAO,EAAU,CAExC,GAAI,MAAM,EAAe,CACvB,MAAM,IAAI,EAAS,EAAY,eAAgB,EAAU,eAAgB,CACvE,QAAS,oDAAoD,IAC9D,CAAC,CAGJ,OAAO,GAUI,EAA2B,GAG/B,KAFgB,EAAqB,EAAQ,CAEzB,SAAS,GAAG,GAU5B,EAAwB,GAAkC,CACrE,GAAI,CAAC,OAAO,UAAU,EAAQ,EAAI,EAAU,EAC1C,MAAM,IAAI,EAAS,EAAY,eAAgB,EAAU,eAAgB,CACvE,QAAS,6BAA6B,IACvC,CAAC,CAGJ,MAAO,UAAU"}

package/dist/utils/evm-address.cjs

@@ -0,0 +1,2 @@
+require(`../_virtual/_rolldown/runtime.cjs`);let e=require(`viem`);function t(e){return e.toLowerCase()}function n(t,n){return(0,e.isAddress)(t,n)}exports.formatEvmAddress=t,exports.isEvmAddress=n;
+//# sourceMappingURL=evm-address.cjs.map

package/dist/utils/evm-address.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm-address.cjs","names":[],"sources":["../../src/utils/evm-address.ts"],"sourcesContent":["import { isAddress, type Address as EvmAddress, type IsAddressOptions } from 'viem';\n\nexport function formatEvmAddress(address: EvmAddress): EvmAddress {\n  return address.toLowerCase() as EvmAddress;\n}\n\nexport function isEvmAddress(address: string, options?: IsAddressOptions): address is EvmAddress {\n  return isAddress(address, options);\n}\n"],"mappings":"mEAEA,SAAgB,EAAiB,EAAiC,CAChE,OAAO,EAAQ,aAAa,CAG9B,SAAgB,EAAa,EAAiB,EAAmD,CAC/F,OAAA,EAAA,EAAA,WAAiB,EAAS,EAAQ"}

package/dist/utils/evm-address.js

@@ -0,0 +1,2 @@
+import{isAddress as e}from"viem";function t(e){return e.toLowerCase()}function n(t,n){return e(t,n)}export{t as formatEvmAddress,n as isEvmAddress};
+//# sourceMappingURL=evm-address.js.map

package/dist/utils/evm-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm-address.js","names":[],"sources":["../../src/utils/evm-address.ts"],"sourcesContent":["import { isAddress, type Address as EvmAddress, type IsAddressOptions } from 'viem';\n\nexport function formatEvmAddress(address: EvmAddress): EvmAddress {\n  return address.toLowerCase() as EvmAddress;\n}\n\nexport function isEvmAddress(address: string, options?: IsAddressOptions): address is EvmAddress {\n  return isAddress(address, options);\n}\n"],"mappings":"iCAEA,SAAgB,EAAiB,EAAiC,CAChE,OAAO,EAAQ,aAAa,CAG9B,SAAgB,EAAa,EAAiB,EAAmD,CAC/F,OAAO,EAAU,EAAS,EAAQ"}

package/dist/utils/price-impact.cjs

@@ -0,0 +1,2 @@
+require(`../_virtual/_rolldown/runtime.cjs`);let e=require(`viem`);const t=[`partner`];async function n({amountIn:n,amountOut:r,assetIn:i,assetOut:a,fees:o,targetChain:s},c){let l=o.filter(n=>!t.includes(n.type)||n.fundingModel!==`included`||n.chainId!==s.chainId||n.token.type!==a.type?!1:`address`in n.token&&`address`in a?n.token.type===`erc20`&&a.type===`erc20`?(0,e.isAddressEqual)(n.token.address,a.address):n.token.address===a.address:!0).reduce((e,t)=>e+t.amount,r),[u,d]=await c({asset:i,amount:n},{asset:a,amount:l});return u===null||d===null?null:(u-d)/u*1e4}exports.calculatePriceImpactFromQuote=n;
+//# sourceMappingURL=price-impact.cjs.map

package/dist/utils/price-impact.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-impact.cjs","names":[],"sources":["../../src/utils/price-impact.ts"],"sourcesContent":["import { isAddressEqual } from 'viem';\nimport type { Quote, QuoteFeeType } from '../types/quote';\nimport type { Asset } from '../types/asset';\n\nconst FEE_TYPE_FILTER: readonly QuoteFeeType[] = ['partner'];\n\n/**\n * Calculates quote price impact in basis points using USD valuations for the input and output assets.\n *\n * Included fees that are deducted from the output asset are added back to `amountOut` so the comparison\n * reflects the pre-deduction output value.\n *\n * @param quote - Quote to evaluate.\n * @param getTokenUsdValues - Resolver that returns USD values for the input and adjusted output amounts.\n * @returns Price impact in basis points, or `null` when either USD value is unavailable.\n */\nexport async function calculatePriceImpactFromQuote(\n  { amountIn, amountOut, assetIn, assetOut, fees, targetChain }: Quote,\n  getTokenUsdValues: (\n    input: { asset: Asset; amount: bigint },\n    output: { asset: Asset; amount: bigint },\n  ) => Promise<[inputUsd: number | null, outputUsd: number | null]>,\n): Promise<number | null> {\n  const adjustedAmountOut: bigint = fees\n    .filter((fee) => {\n      if (\n        !FEE_TYPE_FILTER.includes(fee.type) ||\n        fee.fundingModel !== 'included' ||\n        fee.chainId !== targetChain.chainId ||\n        fee.token.type !== assetOut.type\n      ) {\n        return false;\n      }\n\n      if ('address' in fee.token && 'address' in assetOut) {\n        if (fee.token.type === 'erc20' && assetOut.type === 'erc20') {\n          return isAddressEqual(fee.token.address, assetOut.address);\n        }\n\n        return fee.token.address === assetOut.address;\n      }\n\n      return true;\n    })\n    .reduce((acc, fee) => acc + fee.amount, amountOut);\n\n  const [inputUsd, outputUsd] = await getTokenUsdValues(\n    { asset: assetIn, amount: amountIn },\n    { asset: assetOut, amount: adjustedAmountOut },\n  );\n\n  if (inputUsd === null || outputUsd === null) {\n    return null;\n  }\n\n  const priceImpactBps = ((inputUsd - outputUsd) / inputUsd) * 10_000;\n\n  return priceImpactBps;\n}\n"],"mappings":"mEAIA,MAAM,EAA2C,CAAC,UAAU,CAY5D,eAAsB,EACpB,CAAE,WAAU,YAAW,UAAS,WAAU,OAAM,eAChD,EAIwB,CACxB,IAAM,EAA4B,EAC/B,OAAQ,GAEL,CAAC,EAAgB,SAAS,EAAI,KAAK,EACnC,EAAI,eAAiB,YACrB,EAAI,UAAY,EAAY,SAC5B,EAAI,MAAM,OAAS,EAAS,KAErB,GAGL,YAAa,EAAI,OAAS,YAAa,EACrC,EAAI,MAAM,OAAS,SAAW,EAAS,OAAS,SAClD,EAAA,EAAA,gBAAsB,EAAI,MAAM,QAAS,EAAS,QAAQ,CAGrD,EAAI,MAAM,UAAY,EAAS,QAGjC,GACP,CACD,QAAQ,EAAK,IAAQ,EAAM,EAAI,OAAQ,EAAU,CAE9C,CAAC,EAAU,GAAa,MAAM,EAClC,CAAE,MAAO,EAAS,OAAQ,EAAU,CACpC,CAAE,MAAO,EAAU,OAAQ,EAAmB,CAC/C,CAQD,OANI,IAAa,MAAQ,IAAc,KAC9B,MAGgB,EAAW,GAAa,EAAY"}

package/dist/utils/price-impact.d.cts

@@ -0,0 +1,31 @@
+import { Asset } from "../types/asset.cjs";
+import { Quote } from "../types/quote.cjs";
+
+//#region src/utils/price-impact.d.ts
+/**
+* Calculates quote price impact in basis points using USD valuations for the input and output assets.
+*
+* Included fees that are deducted from the output asset are added back to `amountOut` so the comparison
+* reflects the pre-deduction output value.
+*
+* @param quote - Quote to evaluate.
+* @param getTokenUsdValues - Resolver that returns USD values for the input and adjusted output amounts.
+* @returns Price impact in basis points, or `null` when either USD value is unavailable.
+*/
+declare function calculatePriceImpactFromQuote({
+  amountIn,
+  amountOut,
+  assetIn,
+  assetOut,
+  fees,
+  targetChain
+}: Quote, getTokenUsdValues: (input: {
+  asset: Asset;
+  amount: bigint;
+}, output: {
+  asset: Asset;
+  amount: bigint;
+}) => Promise<[inputUsd: number | null, outputUsd: number | null]>): Promise<number | null>;
+//#endregion
+export { calculatePriceImpactFromQuote };
+//# sourceMappingURL=price-impact.d.cts.map

package/dist/utils/price-impact.d.ts

@@ -0,0 +1,31 @@
+import { Asset } from "../types/asset.js";
+import { Quote } from "../types/quote.js";
+
+//#region src/utils/price-impact.d.ts
+/**
+* Calculates quote price impact in basis points using USD valuations for the input and output assets.
+*
+* Included fees that are deducted from the output asset are added back to `amountOut` so the comparison
+* reflects the pre-deduction output value.
+*
+* @param quote - Quote to evaluate.
+* @param getTokenUsdValues - Resolver that returns USD values for the input and adjusted output amounts.
+* @returns Price impact in basis points, or `null` when either USD value is unavailable.
+*/
+declare function calculatePriceImpactFromQuote({
+  amountIn,
+  amountOut,
+  assetIn,
+  assetOut,
+  fees,
+  targetChain
+}: Quote, getTokenUsdValues: (input: {
+  asset: Asset;
+  amount: bigint;
+}, output: {
+  asset: Asset;
+  amount: bigint;
+}) => Promise<[inputUsd: number | null, outputUsd: number | null]>): Promise<number | null>;
+//#endregion
+export { calculatePriceImpactFromQuote };
+//# sourceMappingURL=price-impact.d.ts.map

package/dist/utils/price-impact.js

@@ -0,0 +1,2 @@
+import{isAddressEqual as e}from"viem";const t=[`partner`];async function n({amountIn:n,amountOut:r,assetIn:i,assetOut:a,fees:o,targetChain:s},c){let l=o.filter(n=>!t.includes(n.type)||n.fundingModel!==`included`||n.chainId!==s.chainId||n.token.type!==a.type?!1:`address`in n.token&&`address`in a?n.token.type===`erc20`&&a.type===`erc20`?e(n.token.address,a.address):n.token.address===a.address:!0).reduce((e,t)=>e+t.amount,r),[u,d]=await c({asset:i,amount:n},{asset:a,amount:l});return u===null||d===null?null:(u-d)/u*1e4}export{n as calculatePriceImpactFromQuote};
+//# sourceMappingURL=price-impact.js.map

package/dist/utils/price-impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-impact.js","names":[],"sources":["../../src/utils/price-impact.ts"],"sourcesContent":["import { isAddressEqual } from 'viem';\nimport type { Quote, QuoteFeeType } from '../types/quote';\nimport type { Asset } from '../types/asset';\n\nconst FEE_TYPE_FILTER: readonly QuoteFeeType[] = ['partner'];\n\n/**\n * Calculates quote price impact in basis points using USD valuations for the input and output assets.\n *\n * Included fees that are deducted from the output asset are added back to `amountOut` so the comparison\n * reflects the pre-deduction output value.\n *\n * @param quote - Quote to evaluate.\n * @param getTokenUsdValues - Resolver that returns USD values for the input and adjusted output amounts.\n * @returns Price impact in basis points, or `null` when either USD value is unavailable.\n */\nexport async function calculatePriceImpactFromQuote(\n  { amountIn, amountOut, assetIn, assetOut, fees, targetChain }: Quote,\n  getTokenUsdValues: (\n    input: { asset: Asset; amount: bigint },\n    output: { asset: Asset; amount: bigint },\n  ) => Promise<[inputUsd: number | null, outputUsd: number | null]>,\n): Promise<number | null> {\n  const adjustedAmountOut: bigint = fees\n    .filter((fee) => {\n      if (\n        !FEE_TYPE_FILTER.includes(fee.type) ||\n        fee.fundingModel !== 'included' ||\n        fee.chainId !== targetChain.chainId ||\n        fee.token.type !== assetOut.type\n      ) {\n        return false;\n      }\n\n      if ('address' in fee.token && 'address' in assetOut) {\n        if (fee.token.type === 'erc20' && assetOut.type === 'erc20') {\n          return isAddressEqual(fee.token.address, assetOut.address);\n        }\n\n        return fee.token.address === assetOut.address;\n      }\n\n      return true;\n    })\n    .reduce((acc, fee) => acc + fee.amount, amountOut);\n\n  const [inputUsd, outputUsd] = await getTokenUsdValues(\n    { asset: assetIn, amount: amountIn },\n    { asset: assetOut, amount: adjustedAmountOut },\n  );\n\n  if (inputUsd === null || outputUsd === null) {\n    return null;\n  }\n\n  const priceImpactBps = ((inputUsd - outputUsd) / inputUsd) * 10_000;\n\n  return priceImpactBps;\n}\n"],"mappings":"sCAIA,MAAM,EAA2C,CAAC,UAAU,CAY5D,eAAsB,EACpB,CAAE,WAAU,YAAW,UAAS,WAAU,OAAM,eAChD,EAIwB,CACxB,IAAM,EAA4B,EAC/B,OAAQ,GAEL,CAAC,EAAgB,SAAS,EAAI,KAAK,EACnC,EAAI,eAAiB,YACrB,EAAI,UAAY,EAAY,SAC5B,EAAI,MAAM,OAAS,EAAS,KAErB,GAGL,YAAa,EAAI,OAAS,YAAa,EACrC,EAAI,MAAM,OAAS,SAAW,EAAS,OAAS,QAC3C,EAAe,EAAI,MAAM,QAAS,EAAS,QAAQ,CAGrD,EAAI,MAAM,UAAY,EAAS,QAGjC,GACP,CACD,QAAQ,EAAK,IAAQ,EAAM,EAAI,OAAQ,EAAU,CAE9C,CAAC,EAAU,GAAa,MAAM,EAClC,CAAE,MAAO,EAAS,OAAQ,EAAU,CACpC,CAAE,MAAO,EAAU,OAAQ,EAAmB,CAC/C,CAQD,OANI,IAAa,MAAQ,IAAc,KAC9B,MAGgB,EAAW,GAAa,EAAY"}

package/dist/utils/quote-fees.cjs

@@ -0,0 +1,2 @@
+const e=require(`../constants.cjs`);function t(t){return t.type===e.TokenType.NATIVE?{type:e.TokenType.NATIVE}:t.type===e.TokenType.SPL?{type:e.TokenType.SPL,address:t.address}:{type:e.TokenType.ERC20,address:t.address}}exports.assetToQuoteFeeToken=t;
+//# sourceMappingURL=quote-fees.cjs.map

package/dist/utils/quote-fees.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-fees.cjs","names":["TokenType"],"sources":["../../src/utils/quote-fees.ts"],"sourcesContent":["import { TokenType } from '../constants';\nimport type { Asset } from '../types/asset';\nimport type { QuoteFeeToken } from '../types/quote';\n\nexport function assetToQuoteFeeToken(asset: Asset): QuoteFeeToken {\n  if (asset.type === TokenType.NATIVE) {\n    return { type: TokenType.NATIVE };\n  }\n\n  if (asset.type === TokenType.SPL) {\n    return { type: TokenType.SPL, address: asset.address };\n  }\n\n  return { type: TokenType.ERC20, address: asset.address };\n}\n"],"mappings":"oCAIA,SAAgB,EAAqB,EAA6B,CAShE,OARI,EAAM,OAASA,EAAAA,UAAU,OACpB,CAAE,KAAMA,EAAAA,UAAU,OAAQ,CAG/B,EAAM,OAASA,EAAAA,UAAU,IACpB,CAAE,KAAMA,EAAAA,UAAU,IAAK,QAAS,EAAM,QAAS,CAGjD,CAAE,KAAMA,EAAAA,UAAU,MAAO,QAAS,EAAM,QAAS"}

package/dist/utils/quote-fees.js

@@ -0,0 +1,2 @@
+import{TokenType as e}from"../constants.js";function t(t){return t.type===e.NATIVE?{type:e.NATIVE}:t.type===e.SPL?{type:e.SPL,address:t.address}:{type:e.ERC20,address:t.address}}export{t as assetToQuoteFeeToken};
+//# sourceMappingURL=quote-fees.js.map

package/dist/utils/quote-fees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-fees.js","names":[],"sources":["../../src/utils/quote-fees.ts"],"sourcesContent":["import { TokenType } from '../constants';\nimport type { Asset } from '../types/asset';\nimport type { QuoteFeeToken } from '../types/quote';\n\nexport function assetToQuoteFeeToken(asset: Asset): QuoteFeeToken {\n  if (asset.type === TokenType.NATIVE) {\n    return { type: TokenType.NATIVE };\n  }\n\n  if (asset.type === TokenType.SPL) {\n    return { type: TokenType.SPL, address: asset.address };\n  }\n\n  return { type: TokenType.ERC20, address: asset.address };\n}\n"],"mappings":"4CAIA,SAAgB,EAAqB,EAA6B,CAShE,OARI,EAAM,OAAS,EAAU,OACpB,CAAE,KAAM,EAAU,OAAQ,CAG/B,EAAM,OAAS,EAAU,IACpB,CAAE,KAAM,EAAU,IAAK,QAAS,EAAM,QAAS,CAGjD,CAAE,KAAM,EAAU,MAAO,QAAS,EAAM,QAAS"}

package/dist/utils/sol-address.cjs

@@ -0,0 +1,2 @@
+require(`../_virtual/_rolldown/runtime.cjs`);let e=require(`@solana/kit`);function t(t){return(0,e.isAddress)(t)}exports.isSolAddress=t;
+//# sourceMappingURL=sol-address.cjs.map

package/dist/utils/sol-address.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sol-address.cjs","names":[],"sources":["../../src/utils/sol-address.ts"],"sourcesContent":["import { type Address as SolAddress, isAddress } from '@solana/kit';\n\nexport function isSolAddress(address: string): address is SolAddress {\n  return isAddress(address);\n}\n"],"mappings":"0EAEA,SAAgB,EAAa,EAAwC,CACnE,OAAA,EAAA,EAAA,WAAiB,EAAQ"}

package/dist/utils/sol-address.js

@@ -0,0 +1,2 @@
+import{isAddress as e}from"@solana/kit";function t(t){return e(t)}export{t as isSolAddress};
+//# sourceMappingURL=sol-address.js.map

package/dist/utils/sol-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sol-address.js","names":[],"sources":["../../src/utils/sol-address.ts"],"sourcesContent":["import { type Address as SolAddress, isAddress } from '@solana/kit';\n\nexport function isSolAddress(address: string): address is SolAddress {\n  return isAddress(address);\n}\n"],"mappings":"wCAEA,SAAgB,EAAa,EAAwC,CACnE,OAAO,EAAU,EAAQ"}