@funkit/fun-relay 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# @funkit/fun-relay
+
+## 0.1.0
+
+In development

package/README.md

@@ -0,0 +1 @@
+# @funkit/fun-relay

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { getRelayClient, initializeRelayClient, type InitializeRelayClientParams, } from './src/client';
+export { type ExecuteRelayQuoteParams, executeRelayQuote, getRelayExecutionInfo, } from './src/execution';
+export { type GetRelayQuoteParams, getRelayQuote } from './src/quote';
+export { getRelayExecutionRefundState, getRelayExecutionState, isRelayExecutionTerminalStatus, } from './src/utils';
+export { LogLevel, type RelayExecutionInfo, type RelayExecutionStatus, } from './src/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,327 @@
+"use strict";
+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);
+
+// index.ts
+var index_exports = {};
+__export(index_exports, {
+  LogLevel: () => import_relay_sdk3.LogLevel,
+  executeRelayQuote: () => executeRelayQuote,
+  getRelayClient: () => getRelayClient,
+  getRelayExecutionInfo: () => getRelayExecutionInfo,
+  getRelayExecutionRefundState: () => getRelayExecutionRefundState,
+  getRelayExecutionState: () => getRelayExecutionState,
+  getRelayQuote: () => getRelayQuote,
+  initializeRelayClient: () => initializeRelayClient,
+  isRelayExecutionTerminalStatus: () => isRelayExecutionTerminalStatus
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_relay_sdk = require("@reservoir0x/relay-sdk");
+function initializeRelayClient({
+  chains,
+  logger,
+  ...options
+}) {
+  return (0, import_relay_sdk.createClient)({
+    ...options,
+    baseApiUrl: import_relay_sdk.MAINNET_RELAY_API,
+    chains: chains.map(import_relay_sdk.convertViemChainToRelayChain),
+    logger: (message) => {
+      logger.log("[RelayClient]:", message);
+    }
+  });
+}
+function getRelayClient() {
+  const client = (0, import_relay_sdk.getClient)();
+  if (!client) {
+    throw new Error("Relay client is not defined");
+  }
+  return client;
+}
+
+// src/execution.ts
+var import_relay_sdk2 = require("@reservoir0x/relay-sdk");
+async function executeRelayQuote({
+  logger,
+  onConfirmed,
+  onError,
+  relayQuote,
+  stepMessageSetter,
+  walletClient
+}) {
+  await getRelayClient().actions.execute({
+    quote: relayQuote,
+    wallet: walletClient,
+    onProgress: async ({
+      steps,
+      fees,
+      breakdown,
+      currentStep,
+      currentStepItem,
+      txHashes,
+      details,
+      error
+    }) => {
+      const logPrefix = "onRelayProgress";
+      logger.log(`${logPrefix}:params`, {
+        steps,
+        currentStep,
+        fees,
+        breakdown,
+        currentStepItem,
+        txHashes,
+        details,
+        error
+      });
+      stepMessageSetter(currentStep?.action ?? "");
+      if (error) {
+        logger.log(`${logPrefix}:errorDetected`, error);
+        await onError(error).catch((e) => {
+          logger.error(`${logPrefix}:onErrorFailed`, e);
+        });
+      } else if (
+        // We can redirect as soon as all the required user steps are done
+        // https://fun-xyz.slack.com/archives/C08MQ85QB2N/p1748381169792379
+        txHashes && txHashes.length > 0 && txHashes.length === steps.length
+      ) {
+        logger.log(`${logPrefix}:completed`, txHashes);
+        await onConfirmed(txHashes[0].txHash).catch((e) => {
+          logger.error(`${logPrefix}:onConfirmedFailed`, e);
+        });
+      }
+    }
+  });
+}
+async function getRelayExecutionInfo(requestId) {
+  const url = `${import_relay_sdk2.MAINNET_RELAY_API}/intents/status/v2?requestId=${requestId}`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw Error(response.statusText);
+  }
+  const data = await response.json();
+  return data;
+}
+
+// src/quote.ts
+var import_viem = require("viem");
+
+// src/constants.ts
+var FUNKIT_NATIVE_TOKEN = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee";
+var RELAY_NATIVE_TOKEN = "0x0000000000000000000000000000000000000000";
+var FUN_RELAY_REVENUE_WALLET = "0xb61562d83aEC43a050A06BED12Ac2bD8f9BFfd5E";
+var FUN_RELAY_REFERRER = "funxyz";
+var RELAY_QUOTE_CHECKOUT_TIME_BUFFER_MS = 3e3;
+var RELAY_TERMINAL_STATUSES = [
+  "refund",
+  "failure",
+  "success"
+];
+
+// src/fees.ts
+function computeFunRelayFeeBps({
+  isSameToken
+}) {
+  return isSameToken ? 0 : 2;
+}
+function parseRelayFees({
+  fees,
+  logger
+}) {
+  const relayGasFeesUsd = Number.parseFloat(fees?.gas?.amountUsd || "0");
+  const funLpFeesUsd = Number.parseFloat(fees?.app?.amountUsd || "0");
+  const funLpFeesFromAmount = Number.parseFloat(
+    fees?.app?.amountFormatted || "0"
+  );
+  const funLpFeesFromAmountBaseUnit = BigInt(fees?.app?.amount || "0");
+  const relayLpFeesUsd = Number.parseFloat(fees?.relayer?.amountUsd || "0") + Number.parseFloat(fees?.relayerGas?.amountUsd || "0") + Number.parseFloat(fees?.relayerService?.amountUsd || "0");
+  const relayLpFeesFromAmount = Number.parseFloat(fees?.relayer?.amountFormatted || "0") + Number.parseFloat(fees?.relayerGas?.amountFormatted || "0") + Number.parseFloat(fees?.relayerService?.amountFormatted || "0");
+  const relayLpFeesFromAmountBaseUnit = BigInt(fees?.relayer?.amount || "0") + BigInt(fees?.relayerGas?.amount || "0") + BigInt(fees?.relayerService?.amount || "0");
+  const totalLpFeesUsd = funLpFeesUsd + relayLpFeesUsd;
+  const totalLpFeesFromAmount = funLpFeesFromAmount + relayLpFeesFromAmount;
+  const totalLpFeesFromAmountBaseUnit = funLpFeesFromAmountBaseUnit + relayLpFeesFromAmountBaseUnit;
+  logger.log("parseRelayFees", {
+    relayGasFeesUsd,
+    funLpFeesUsd,
+    funLpFeesFromAmount,
+    funLpFeesFromAmountBaseUnit,
+    relayLpFeesUsd,
+    relayLpFeesFromAmount,
+    relayLpFeesFromAmountBaseUnit,
+    totalLpFeesUsd,
+    totalLpFeesFromAmount,
+    totalLpFeesFromAmountBaseUnit
+  });
+  return {
+    relayGasFeesUsd,
+    totalLpFeesUsd,
+    totalFeesUsd: relayGasFeesUsd + totalLpFeesUsd,
+    totalFeesFromAmount: totalLpFeesFromAmount,
+    totalFeesFromAmountBaseUnit: totalLpFeesFromAmountBaseUnit
+  };
+}
+
+// src/types.ts
+var import_relay_sdk3 = require("@reservoir0x/relay-sdk");
+
+// src/utils.ts
+function convertFunToRelayTokenAddress(address) {
+  if (address.toLowerCase() === FUNKIT_NATIVE_TOKEN.toLowerCase()) {
+    return RELAY_NATIVE_TOKEN;
+  }
+  return address;
+}
+function getRelayExecutionRefundState(info) {
+  switch (info.status) {
+    case "refund":
+      return "REFUNDED" /* REFUNDED */;
+    default:
+      return void 0;
+  }
+}
+function getRelayExecutionState(info) {
+  switch (info.status) {
+    case "success":
+      return "COMPLETED" /* COMPLETED */;
+    case "failure":
+    case "refund":
+      return "CHECKOUT_ERROR" /* CHECKOUT_ERROR */;
+    default:
+      return "PENDING_RECEIVAL" /* PENDING_RECEIVAL */;
+  }
+}
+function isRelayExecutionTerminalStatus(info) {
+  return RELAY_TERMINAL_STATUSES.includes(info.status);
+}
+
+// src/quote.ts
+async function getRelayQuote({
+  actionParams,
+  logger,
+  toChainId,
+  toTokenAddress,
+  toTokenAmount,
+  toTokenDecimals,
+  fromChainId,
+  fromTokenAddress,
+  recipientAddress,
+  userAddress
+}) {
+  try {
+    const relayClient = getRelayClient();
+    const toMultipler = 10 ** toTokenDecimals;
+    const toAmountBaseUnitBI = BigInt(Math.floor(toTokenAmount * toMultipler));
+    const toAmountBaseUnitBIString = toAmountBaseUnitBI.toString();
+    const txs = actionParams?.map((action) => {
+      const data = (0, import_viem.encodeFunctionData)({
+        abi: action.contractAbi,
+        args: action.functionArgs,
+        functionName: action.functionName
+      });
+      return {
+        data,
+        to: action.contractAddress,
+        value: String(action.value ?? 0n)
+      };
+    });
+    logger.log("getRelayQuoteParams", {
+      actionParams,
+      toChainId,
+      toTokenAddress,
+      toTokenAmount,
+      toTokenDecimals,
+      fromChainId,
+      fromTokenAddress,
+      recipientAddress,
+      userAddress,
+      relayClient,
+      toAmountBaseUnitBI: toAmountBaseUnitBIString,
+      txs
+    });
+    const relayQuote = await relayClient.actions.getQuote({
+      chainId: Number(fromChainId),
+      toChainId: Number(toChainId),
+      currency: convertFunToRelayTokenAddress(fromTokenAddress),
+      toCurrency: convertFunToRelayTokenAddress(toTokenAddress),
+      amount: toAmountBaseUnitBIString,
+      recipient: recipientAddress,
+      tradeType: "EXACT_OUTPUT",
+      user: userAddress,
+      ...txs && { txs },
+      options: {
+        referrer: FUN_RELAY_REFERRER,
+        appFees: [
+          {
+            fee: computeFunRelayFeeBps({
+              isSameToken: fromChainId === toChainId && fromTokenAddress.toLowerCase() === toTokenAddress.toLowerCase()
+            }).toString(),
+            recipient: FUN_RELAY_REVENUE_WALLET
+          }
+        ]
+      }
+    });
+    logger.log("relayQuote", relayQuote);
+    const estSubtotalUsd = Number(
+      relayQuote.details?.currencyOut?.amountUsd || 0
+    );
+    const estTotalUsd = Number(relayQuote.details?.currencyIn?.amountUsd || 0);
+    const fromAmountString = relayQuote.details?.currencyIn?.amountFormatted || "0";
+    const fromAmountBaseUnitString = relayQuote.details?.currencyIn?.amount || "0";
+    const relayRequestId = relayQuote.steps[0]?.requestId;
+    if (!relayRequestId) {
+      throw new Error("Relay quote does not contain a requestId");
+    }
+    const {
+      relayGasFeesUsd,
+      totalLpFeesUsd,
+      totalFeesUsd,
+      totalFeesFromAmount,
+      totalFeesFromAmountBaseUnit
+    } = parseRelayFees({ fees: relayQuote.fees, logger });
+    const estSubtotalFromAmount = (Number.parseFloat(fromAmountString) - totalFeesFromAmount).toString();
+    const estSubtotalFromAmountBaseUnit = (BigInt(fromAmountBaseUnitString) - totalFeesFromAmountBaseUnit).toString();
+    return {
+      quoteId: relayRequestId,
+      estTotalFromAmount: fromAmountString,
+      estSubtotalFromAmount,
+      estTotalFromAmountBaseUnit: fromAmountBaseUnitString,
+      estSubtotalFromAmountBaseUnit,
+      estFeesFromAmount: totalFeesFromAmount.toString(),
+      estFeesFromAmountBaseUnit: totalFeesFromAmountBaseUnit.toString(),
+      fromTokenAddress,
+      estFeesUsd: totalFeesUsd,
+      estSubtotalUsd,
+      estTotalUsd,
+      estCheckoutTimeMs: (relayQuote.details?.timeEstimate || 0) * 1e3 + RELAY_QUOTE_CHECKOUT_TIME_BUFFER_MS,
+      estMarketMakerGasUsd: relayGasFeesUsd,
+      lpFeePercentage: 0,
+      // TODO: ?
+      lpFeeUsd: totalLpFeesUsd,
+      metadata: {
+        relayQuote,
+        toAmountBaseUnit: toAmountBaseUnitBIString
+      }
+    };
+  } catch (err) {
+    throw new Error(
+      `An error occured trying to generate a relay quote: ${err instanceof Error ? err.message : JSON.stringify(err)}`
+    );
+  }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../index.ts", "../src/client.ts", "../src/execution.ts", "../src/quote.ts", "../src/constants.ts", "../src/fees.ts", "../src/types.ts", "../src/utils.ts"],
+  "sourcesContent": ["export {\n  getRelayClient,\n  initializeRelayClient,\n  type InitializeRelayClientParams,\n} from './src/client'\nexport {\n  type ExecuteRelayQuoteParams,\n  executeRelayQuote,\n  getRelayExecutionInfo,\n} from './src/execution'\nexport { type GetRelayQuoteParams, getRelayQuote } from './src/quote'\nexport {\n  getRelayExecutionRefundState,\n  getRelayExecutionState,\n  isRelayExecutionTerminalStatus,\n} from './src/utils'\nexport {\n  LogLevel,\n  type RelayExecutionInfo,\n  type RelayExecutionStatus,\n} from './src/types'\n", "import {\n  MAINNET_RELAY_API,\n  type RelayClient,\n  type RelayClientOptions,\n  convertViemChainToRelayChain,\n  createClient,\n  getClient,\n} from '@reservoir0x/relay-sdk'\nimport type { Chain } from 'viem'\nimport type { Logger } from './types'\n\nexport type InitializeRelayClientParams = Omit<\n  RelayClientOptions,\n  'baseApiUrl' | 'chains' | 'logger'\n> & {\n  chains: Chain[]\n  logger: Logger\n}\n\n/**\n * Initializes a global instance of the RelayClient\n * https://docs.relay.link/references/sdk/createClient\n */\nexport function initializeRelayClient({\n  chains,\n  logger,\n  ...options\n}: InitializeRelayClientParams): RelayClient {\n  return createClient({\n    ...options,\n    baseApiUrl: MAINNET_RELAY_API,\n    chains: chains.map(convertViemChainToRelayChain),\n    logger: (message) => {\n      logger.log('[RelayClient]:', message)\n    },\n  })\n}\n\n/**\n * Gets the global instance of the RelayClient\n */\nexport function getRelayClient(): RelayClient {\n  const client = getClient()\n\n  if (!client) {\n    throw new Error('Relay client is not defined')\n  }\n\n  return client\n}\n", "import { type Execute, MAINNET_RELAY_API } from '@reservoir0x/relay-sdk'\nimport type { Hex, WalletClient } from 'viem'\nimport { getRelayClient } from './client'\nimport type { Logger, RelayExecutionInfo } from './types'\n\nexport interface ExecuteRelayQuoteParams {\n  logger: Logger\n  onConfirmed: (txHash: Hex) => Promise<void>\n  onError: (error: Error) => Promise<void>\n  relayQuote: Execute\n  stepMessageSetter: (message: string) => void\n  walletClient: WalletClient\n}\n\n// TODO: Add unit tests for this once impl is settled\nexport async function executeRelayQuote({\n  logger,\n  onConfirmed,\n  onError,\n  relayQuote,\n  stepMessageSetter,\n  walletClient,\n}: ExecuteRelayQuoteParams) {\n  await getRelayClient().actions.execute({\n    quote: relayQuote,\n    wallet: walletClient,\n    onProgress: async ({\n      steps,\n      fees,\n      breakdown,\n      currentStep,\n      currentStepItem,\n      txHashes,\n      details,\n      error,\n    }) => {\n      const logPrefix = 'onRelayProgress'\n      logger.log(`${logPrefix}:params`, {\n        steps,\n        currentStep,\n        fees,\n        breakdown,\n        currentStepItem,\n        txHashes,\n        details,\n        error,\n      })\n\n      stepMessageSetter(currentStep?.action ?? '')\n\n      if (error) {\n        logger.log(`${logPrefix}:errorDetected`, error)\n        await onError(error).catch((e) => {\n          logger.error(`${logPrefix}:onErrorFailed`, e)\n        })\n      } else if (\n        // We can redirect as soon as all the required user steps are done\n        // https://fun-xyz.slack.com/archives/C08MQ85QB2N/p1748381169792379\n        txHashes &&\n        txHashes.length > 0 &&\n        txHashes.length === steps.length\n      ) {\n        logger.log(`${logPrefix}:completed`, txHashes)\n        // Can we assume its completed here?\n        // Use first txHash as the main txHash in fun DE table\n        await onConfirmed(txHashes[0].txHash as Hex).catch((e) => {\n          logger.error(`${logPrefix}:onConfirmedFailed`, e)\n        })\n      }\n    },\n  })\n}\n\nexport async function getRelayExecutionInfo(\n  requestId: string,\n): Promise<RelayExecutionInfo> {\n  const url = `${MAINNET_RELAY_API}/intents/status/v2?requestId=${requestId}`\n  const response = await fetch(url)\n  if (!response.ok) {\n    throw Error(response.statusText)\n  }\n\n  const data = await response.json()\n  return data as RelayExecutionInfo\n}\n", "import { type Address, encodeFunctionData } from 'viem'\nimport { getRelayClient } from './client'\nimport {\n  FUN_RELAY_REFERRER,\n  FUN_RELAY_REVENUE_WALLET,\n  RELAY_QUOTE_CHECKOUT_TIME_BUFFER_MS,\n} from './constants'\nimport { computeFunRelayFeeBps, parseRelayFees } from './fees'\nimport type {\n  ApiFunkitCheckoutActionParams,\n  CheckoutQuoteResponse,\n  Logger,\n} from './types'\nimport { convertFunToRelayTokenAddress } from './utils'\n\nexport interface GetRelayQuoteParams {\n  actionParams?: ApiFunkitCheckoutActionParams[]\n  fromChainId: string\n  fromTokenAddress: Address\n  logger: Logger\n  recipientAddress: Address | undefined\n  toChainId: string\n  toTokenAddress: Address\n  toTokenAmount: number\n  toTokenDecimals: number\n  userAddress: Address | undefined\n}\n\nexport async function getRelayQuote({\n  actionParams,\n  logger,\n  toChainId,\n  toTokenAddress,\n  toTokenAmount,\n  toTokenDecimals,\n  fromChainId,\n  fromTokenAddress,\n  recipientAddress,\n  userAddress,\n}: GetRelayQuoteParams): Promise<CheckoutQuoteResponse> {\n  try {\n    const relayClient = getRelayClient()\n\n    // Mirror logic in api-base (this is wrong)\n    const toMultipler = 10 ** toTokenDecimals\n    const toAmountBaseUnitBI = BigInt(Math.floor(toTokenAmount * toMultipler))\n    const toAmountBaseUnitBIString = toAmountBaseUnitBI.toString()\n\n    const txs = actionParams?.map((action) => {\n      const data = encodeFunctionData({\n        abi: action.contractAbi,\n        args: action.functionArgs,\n        functionName: action.functionName,\n      })\n\n      return {\n        data,\n        to: action.contractAddress,\n        value: String(action.value ?? 0n),\n      }\n    })\n\n    logger.log('getRelayQuoteParams', {\n      actionParams,\n      toChainId,\n      toTokenAddress,\n      toTokenAmount,\n      toTokenDecimals,\n      fromChainId,\n      fromTokenAddress,\n      recipientAddress,\n      userAddress,\n      relayClient,\n      toAmountBaseUnitBI: toAmountBaseUnitBIString,\n      txs,\n    })\n\n    // Get the relay quote\n    const relayQuote = await relayClient.actions.getQuote({\n      chainId: Number(fromChainId),\n      toChainId: Number(toChainId),\n      currency: convertFunToRelayTokenAddress(fromTokenAddress),\n      toCurrency: convertFunToRelayTokenAddress(toTokenAddress),\n      amount: toAmountBaseUnitBIString,\n      recipient: recipientAddress,\n      tradeType: 'EXACT_OUTPUT',\n      user: userAddress,\n      ...(txs && { txs }),\n      options: {\n        referrer: FUN_RELAY_REFERRER,\n        appFees: [\n          {\n            fee: computeFunRelayFeeBps({\n              isSameToken:\n                fromChainId === toChainId &&\n                fromTokenAddress.toLowerCase() === toTokenAddress.toLowerCase(),\n            }).toString(),\n            recipient: FUN_RELAY_REVENUE_WALLET,\n          },\n        ],\n      },\n    })\n\n    // TODO: Handling for no route response\n\n    logger.log('relayQuote', relayQuote)\n\n    const estSubtotalUsd = Number(\n      relayQuote.details?.currencyOut?.amountUsd || 0,\n    )\n    const estTotalUsd = Number(relayQuote.details?.currencyIn?.amountUsd || 0)\n    // Get how much fromAmount is needed for the quote\n    const fromAmountString =\n      relayQuote.details?.currencyIn?.amountFormatted || '0'\n    const fromAmountBaseUnitString =\n      relayQuote.details?.currencyIn?.amount || '0'\n\n    // RequestID will be consistent across steps in the quote\n    // https://fun-xyz.slack.com/archives/C08MQ85QB2N/p1747774944603209\n    const relayRequestId = relayQuote.steps[0]?.requestId\n\n    // TODO: Verify with relay team if this is possible?\n    if (!relayRequestId) {\n      throw new Error('Relay quote does not contain a requestId')\n    }\n\n    const {\n      relayGasFeesUsd,\n      totalLpFeesUsd,\n      totalFeesUsd,\n      totalFeesFromAmount,\n      totalFeesFromAmountBaseUnit,\n    } = parseRelayFees({ fees: relayQuote.fees, logger })\n\n    const estSubtotalFromAmount = (\n      Number.parseFloat(fromAmountString) - totalFeesFromAmount\n    ).toString()\n\n    const estSubtotalFromAmountBaseUnit = (\n      BigInt(fromAmountBaseUnitString) - totalFeesFromAmountBaseUnit\n    ).toString()\n\n    return {\n      quoteId: relayRequestId,\n      estTotalFromAmount: fromAmountString,\n      estSubtotalFromAmount,\n      estTotalFromAmountBaseUnit: fromAmountBaseUnitString,\n      estSubtotalFromAmountBaseUnit: estSubtotalFromAmountBaseUnit,\n      estFeesFromAmount: totalFeesFromAmount.toString(),\n      estFeesFromAmountBaseUnit: totalFeesFromAmountBaseUnit.toString(),\n      fromTokenAddress,\n      estFeesUsd: totalFeesUsd,\n      estSubtotalUsd,\n      estTotalUsd,\n      estCheckoutTimeMs:\n        (relayQuote.details?.timeEstimate || 0) * 1000 +\n        RELAY_QUOTE_CHECKOUT_TIME_BUFFER_MS,\n      estMarketMakerGasUsd: relayGasFeesUsd,\n      lpFeePercentage: 0, // TODO: ?\n      lpFeeUsd: totalLpFeesUsd,\n      metadata: {\n        relayQuote,\n        toAmountBaseUnit: toAmountBaseUnitBIString,\n      },\n    }\n  } catch (err) {\n    throw new Error(\n      `An error occured trying to generate a relay quote: ${\n        err instanceof Error ? err.message : JSON.stringify(err)\n      }`,\n    )\n  }\n}\n", "import type { Address } from 'viem'\nimport type { RelayExecutionStatus } from './types'\n\n/**\n * Fake address for a chain's native currency used by Funkit\n */\nexport const FUNKIT_NATIVE_TOKEN =\n  '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee' satisfies Address\n\n/**\n * Fake address for a chain's native currency used by Relay\n */\nexport const RELAY_NATIVE_TOKEN =\n  '0x0000000000000000000000000000000000000000' satisfies Address\n\n/**\n * Wallet that receives the app fees collected by Relay\n */\nexport const FUN_RELAY_REVENUE_WALLET =\n  '0xb61562d83aEC43a050A06BED12Ac2bD8f9BFfd5E' satisfies Address\n\n/**\n * Referred field in Relay quote\n */\nexport const FUN_RELAY_REFERRER = 'funxyz'\n\n/**\n * Buffer added to Relay's time estimate (which sometimes is 0)\n */\nexport const RELAY_QUOTE_CHECKOUT_TIME_BUFFER_MS = 3_000 // 3 seconds\n\nexport const RELAY_TERMINAL_STATUSES: RelayExecutionStatus[] = [\n  'refund',\n  'failure',\n  'success',\n]\n", "import type { CallFees } from '@reservoir0x/relay-sdk'\nimport type { Logger } from './types'\n\nexport function computeFunRelayFeeBps({\n  isSameToken,\n}: {\n  isSameToken: boolean\n}): number {\n  // For now, we have a flat 2bps app fee for all relay transactions\n  // TODO: Dynamic fee based on the transaction size, from token, to token, etc\n  return isSameToken ? 0 : 2\n}\n\nexport function parseRelayFees({\n  fees,\n  logger,\n}: {\n  fees: CallFees | undefined\n  logger: Logger\n}) {\n  // Gas fees, denominated in source chain native token\n  const relayGasFeesUsd = Number.parseFloat(fees?.gas?.amountUsd || '0')\n\n  // App fees, denominated in source chain token\n  const funLpFeesUsd = Number.parseFloat(fees?.app?.amountUsd || '0')\n  const funLpFeesFromAmount = Number.parseFloat(\n    fees?.app?.amountFormatted || '0',\n  )\n  const funLpFeesFromAmountBaseUnit = BigInt(fees?.app?.amount || '0')\n\n  // Relay fees, denominated in source chain token\n  const relayLpFeesUsd =\n    Number.parseFloat(fees?.relayer?.amountUsd || '0') +\n    Number.parseFloat(fees?.relayerGas?.amountUsd || '0') +\n    Number.parseFloat(fees?.relayerService?.amountUsd || '0')\n  const relayLpFeesFromAmount =\n    Number.parseFloat(fees?.relayer?.amountFormatted || '0') +\n    Number.parseFloat(fees?.relayerGas?.amountFormatted || '0') +\n    Number.parseFloat(fees?.relayerService?.amountFormatted || '0')\n  const relayLpFeesFromAmountBaseUnit =\n    BigInt(fees?.relayer?.amount || '0') +\n    BigInt(fees?.relayerGas?.amount || '0') +\n    BigInt(fees?.relayerService?.amount || '0')\n\n  const totalLpFeesUsd = funLpFeesUsd + relayLpFeesUsd\n  const totalLpFeesFromAmount = funLpFeesFromAmount + relayLpFeesFromAmount\n  const totalLpFeesFromAmountBaseUnit =\n    funLpFeesFromAmountBaseUnit + relayLpFeesFromAmountBaseUnit\n\n  logger.log('parseRelayFees', {\n    relayGasFeesUsd,\n    funLpFeesUsd,\n    funLpFeesFromAmount,\n    funLpFeesFromAmountBaseUnit,\n    relayLpFeesUsd,\n    relayLpFeesFromAmount,\n    relayLpFeesFromAmountBaseUnit,\n    totalLpFeesUsd,\n    totalLpFeesFromAmount,\n    totalLpFeesFromAmountBaseUnit,\n  })\n\n  return {\n    relayGasFeesUsd,\n    totalLpFeesUsd,\n    totalFeesUsd: relayGasFeesUsd + totalLpFeesUsd,\n    totalFeesFromAmount: totalLpFeesFromAmount,\n    totalFeesFromAmountBaseUnit: totalLpFeesFromAmountBaseUnit,\n  }\n}\n", "import { LogLevel } from '@reservoir0x/relay-sdk'\nimport type { Abi, Address } from 'viem'\n\nexport { LogLevel }\n\nexport type RelayExecutionStatus =\n  | 'refund'\n  | 'delayed'\n  | 'waiting'\n  | 'failure'\n  | 'pending'\n  | 'success'\n\n// https://docs.relay.link/references/api/get-intents-status-v2\nexport interface RelayExecutionInfo {\n  status: RelayExecutionStatus\n  details: string\n  /** Incoming transaction hashes */\n  inTxHashes: string[]\n  /** Outgoing transaction hashes */\n  txHashes: string[]\n  /** The last timestamp the data was updated in milliseconds */\n  time: number\n  originChainId: number\n  destinationChainId: number\n}\n\n//// The types below are duplicated from @funkit/api-base atm, but this package should be used in BE as well\n//// TODO: Are we fine with BE importing @funkit/api-base and (by extension) @funkit/utils?\n//// See https://linear.app/funxyz/issue/PE-1342/sdk-extract-domainsrelayts-to-a-new-package#comment-d487d533\n\nexport interface Logger {\n  error(message: string, data?: object): void\n  log(message: string, data?: object): void\n}\n\nexport interface ApiFunkitCheckoutActionParams {\n  contractAbi: Abi\n  contractAddress: Address\n  functionName: string\n  functionArgs: unknown[]\n  value?: bigint\n}\n\nexport enum CheckoutRefundState {\n  INITIATED = 'INITIATED',\n  ERROR = 'ERROR',\n  REFUNDED = 'REFUNDED',\n  PROCEEDED = 'PROCEEDED',\n  WAITING_FOR_FULFILLMENT = 'WAITING_FOR_FULFILLMENT',\n  FULFILLED = 'FULFILLED',\n}\n\n// Reference from api server: https://github.com/fun-xyz/fun-api-server/blob/main/src/tables/FunWalletCheckout.ts#L11C1-L21C2\nexport enum CheckoutState {\n  // In-progress States\n  FROM_UNFUNDED = 'FROM_UNFUNDED',\n  FROM_FUNDED = 'FROM_FUNDED',\n  FROM_POOLED = 'FROM_POOLED',\n  TO_UNFUNDED = 'TO_UNFUNDED',\n  TO_FUNDED = 'TO_FUNDED',\n  TO_POOLED = 'TO_POOLED',\n  TO_READY = 'TO_READY',\n  PENDING_RECEIVAL = 'PENDING_RECEIVAL',\n  // Terminal States\n  COMPLETED = 'COMPLETED',\n  CHECKOUT_ERROR = 'CHECKOUT_ERROR',\n  EXPIRED = 'EXPIRED',\n  CANCELLED = 'CANCELLED',\n}\n\n// The response of the actual /checkout/quote api\nexport type CheckoutApiQuoteResponse = {\n  quoteId: string\n  estTotalFromAmountBaseUnit: string\n  estSubtotalFromAmountBaseUnit: string\n  estFeesFromAmountBaseUnit: string\n  fromTokenAddress: Address\n  estFeesUsd: number\n  estSubtotalUsd: number\n  estTotalUsd: number\n  estCheckoutTimeMs: number\n  estMarketMakerGasUsd: number\n  lpFeePercentage: number\n  lpFeeUsd: number\n}\n\n// The formatted response quote interface from the core sdk\nexport type CheckoutQuoteResponse = CheckoutApiQuoteResponse & {\n  estTotalFromAmount: string\n  estSubtotalFromAmount: string\n  estFeesFromAmount: string\n\n  // Any additional fields purely for frontend use\n  metadata?: { [key: string]: unknown }\n}\n", "import type { Address } from 'viem'\nimport {\n  FUNKIT_NATIVE_TOKEN,\n  RELAY_NATIVE_TOKEN,\n  RELAY_TERMINAL_STATUSES,\n} from './constants'\nimport {\n  CheckoutRefundState,\n  CheckoutState,\n  type RelayExecutionInfo,\n} from './types'\n\n/**\n * Converts a token address within Funkit the corresponding Relay token address.\n */\nexport function convertFunToRelayTokenAddress(address: Address): Address {\n  if (address.toLowerCase() === FUNKIT_NATIVE_TOKEN.toLowerCase()) {\n    return RELAY_NATIVE_TOKEN\n  }\n\n  return address\n}\n\nexport function getRelayExecutionRefundState(\n  info: RelayExecutionInfo,\n): CheckoutRefundState | undefined {\n  switch (info.status) {\n    case 'refund':\n      return CheckoutRefundState.REFUNDED\n    default:\n      return undefined\n  }\n}\n\nexport function getRelayExecutionState(\n  info: RelayExecutionInfo,\n): CheckoutState {\n  switch (info.status) {\n    case 'success':\n      return CheckoutState.COMPLETED\n    case 'failure':\n    case 'refund':\n      return CheckoutState.CHECKOUT_ERROR\n    default:\n      return CheckoutState.PENDING_RECEIVAL\n  }\n}\n\n/**\n * Checks whether the Relay execution has reached a terminal status.\n */\nexport function isRelayExecutionTerminalStatus(\n  info: RelayExecutionInfo,\n): boolean {\n  return RELAY_TERMINAL_STATUSES.includes(info.status)\n}\n"],
+  "mappings": "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",
+  "names": ["import_relay_sdk", "import_relay_sdk"]
+}

package/dist/src/client.d.ts

@@ -0,0 +1,17 @@
+import { type RelayClient, type RelayClientOptions } from '@reservoir0x/relay-sdk';
+import type { Chain } from 'viem';
+import type { Logger } from './types';
+export type InitializeRelayClientParams = Omit<RelayClientOptions, 'baseApiUrl' | 'chains' | 'logger'> & {
+    chains: Chain[];
+    logger: Logger;
+};
+/**
+ * Initializes a global instance of the RelayClient
+ * https://docs.relay.link/references/sdk/createClient
+ */
+export declare function initializeRelayClient({ chains, logger, ...options }: InitializeRelayClientParams): RelayClient;
+/**
+ * Gets the global instance of the RelayClient
+ */
+export declare function getRelayClient(): RelayClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EAIxB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,kBAAkB,EAClB,YAAY,GAAG,QAAQ,GAAG,QAAQ,CACnC,GAAG;IACF,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,MAAM,EACN,MAAM,EACN,GAAG,OAAO,EACX,EAAE,2BAA2B,GAAG,WAAW,CAS3C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAQ5C"}

package/dist/src/constants.d.ts

@@ -0,0 +1,23 @@
+import type { RelayExecutionStatus } from './types';
+/**
+ * Fake address for a chain's native currency used by Funkit
+ */
+export declare const FUNKIT_NATIVE_TOKEN = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee";
+/**
+ * Fake address for a chain's native currency used by Relay
+ */
+export declare const RELAY_NATIVE_TOKEN = "0x0000000000000000000000000000000000000000";
+/**
+ * Wallet that receives the app fees collected by Relay
+ */
+export declare const FUN_RELAY_REVENUE_WALLET = "0xb61562d83aEC43a050A06BED12Ac2bD8f9BFfd5E";
+/**
+ * Referred field in Relay quote
+ */
+export declare const FUN_RELAY_REFERRER = "funxyz";
+/**
+ * Buffer added to Relay's time estimate (which sometimes is 0)
+ */
+export declare const RELAY_QUOTE_CHECKOUT_TIME_BUFFER_MS = 3000;
+export declare const RELAY_TERMINAL_STATUSES: RelayExecutionStatus[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,mBAAmB,+CACgC,CAAA;AAEhE;;GAEG;AACH,eAAO,MAAM,kBAAkB,+CACiC,CAAA;AAEhE;;GAEG;AACH,eAAO,MAAM,wBAAwB,+CAC2B,CAAA;AAEhE;;GAEG;AACH,eAAO,MAAM,kBAAkB,WAAW,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,mCAAmC,OAAQ,CAAA;AAExD,eAAO,MAAM,uBAAuB,EAAE,oBAAoB,EAIzD,CAAA"}

package/dist/src/execution.d.ts

@@ -0,0 +1,14 @@
+import { type Execute } from '@reservoir0x/relay-sdk';
+import type { Hex, WalletClient } from 'viem';
+import type { Logger, RelayExecutionInfo } from './types';
+export interface ExecuteRelayQuoteParams {
+    logger: Logger;
+    onConfirmed: (txHash: Hex) => Promise<void>;
+    onError: (error: Error) => Promise<void>;
+    relayQuote: Execute;
+    stepMessageSetter: (message: string) => void;
+    walletClient: WalletClient;
+}
+export declare function executeRelayQuote({ logger, onConfirmed, onError, relayQuote, stepMessageSetter, walletClient, }: ExecuteRelayQuoteParams): Promise<void>;
+export declare function getRelayExecutionInfo(requestId: string): Promise<RelayExecutionInfo>;
+//# sourceMappingURL=execution.d.ts.map

package/dist/src/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAqB,MAAM,wBAAwB,CAAA;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAEzD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,UAAU,EAAE,OAAO,CAAA;IACnB,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,YAAY,EAAE,YAAY,CAAA;CAC3B;AAGD,wBAAsB,iBAAiB,CAAC,EACtC,MAAM,EACN,WAAW,EACX,OAAO,EACP,UAAU,EACV,iBAAiB,EACjB,YAAY,GACb,EAAE,uBAAuB,iBAiDzB;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAS7B"}

package/dist/src/fees.d.ts

@@ -0,0 +1,16 @@
+import type { CallFees } from '@reservoir0x/relay-sdk';
+import type { Logger } from './types';
+export declare function computeFunRelayFeeBps({ isSameToken, }: {
+    isSameToken: boolean;
+}): number;
+export declare function parseRelayFees({ fees, logger, }: {
+    fees: CallFees | undefined;
+    logger: Logger;
+}): {
+    relayGasFeesUsd: number;
+    totalLpFeesUsd: number;
+    totalFeesUsd: number;
+    totalFeesFromAmount: number;
+    totalFeesFromAmountBaseUnit: bigint;
+};
+//# sourceMappingURL=fees.d.ts.map

package/dist/src/fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fees.d.ts","sourceRoot":"","sources":["../../src/fees.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC,wBAAgB,qBAAqB,CAAC,EACpC,WAAW,GACZ,EAAE;IACD,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,MAAM,CAIT;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,MAAM,GACP,EAAE;IACD,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;CACf;;;;;;EAkDA"}

package/dist/src/quote.d.ts

@@ -0,0 +1,16 @@
+import { type Address } from 'viem';
+import type { ApiFunkitCheckoutActionParams, CheckoutQuoteResponse, Logger } from './types';
+export interface GetRelayQuoteParams {
+    actionParams?: ApiFunkitCheckoutActionParams[];
+    fromChainId: string;
+    fromTokenAddress: Address;
+    logger: Logger;
+    recipientAddress: Address | undefined;
+    toChainId: string;
+    toTokenAddress: Address;
+    toTokenAmount: number;
+    toTokenDecimals: number;
+    userAddress: Address | undefined;
+}
+export declare function getRelayQuote({ actionParams, logger, toChainId, toTokenAddress, toTokenAmount, toTokenDecimals, fromChainId, fromTokenAddress, recipientAddress, userAddress, }: GetRelayQuoteParams): Promise<CheckoutQuoteResponse>;
+//# sourceMappingURL=quote.d.ts.map

package/dist/src/quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.d.ts","sourceRoot":"","sources":["../../src/quote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAsB,MAAM,MAAM,CAAA;AAQvD,OAAO,KAAK,EACV,6BAA6B,EAC7B,qBAAqB,EACrB,MAAM,EACP,MAAM,SAAS,CAAA;AAGhB,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,6BAA6B,EAAE,CAAA;IAC9C,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,OAAO,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,OAAO,GAAG,SAAS,CAAA;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,OAAO,GAAG,SAAS,CAAA;CACjC;AAED,wBAAsB,aAAa,CAAC,EAClC,YAAY,EACZ,MAAM,EACN,SAAS,EACT,cAAc,EACd,aAAa,EACb,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,GACZ,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAqItD"}

package/dist/src/types.d.ts

@@ -0,0 +1,72 @@
+import { LogLevel } from '@reservoir0x/relay-sdk';
+import type { Abi, Address } from 'viem';
+export { LogLevel };
+export type RelayExecutionStatus = 'refund' | 'delayed' | 'waiting' | 'failure' | 'pending' | 'success';
+export interface RelayExecutionInfo {
+    status: RelayExecutionStatus;
+    details: string;
+    /** Incoming transaction hashes */
+    inTxHashes: string[];
+    /** Outgoing transaction hashes */
+    txHashes: string[];
+    /** The last timestamp the data was updated in milliseconds */
+    time: number;
+    originChainId: number;
+    destinationChainId: number;
+}
+export interface Logger {
+    error(message: string, data?: object): void;
+    log(message: string, data?: object): void;
+}
+export interface ApiFunkitCheckoutActionParams {
+    contractAbi: Abi;
+    contractAddress: Address;
+    functionName: string;
+    functionArgs: unknown[];
+    value?: bigint;
+}
+export declare enum CheckoutRefundState {
+    INITIATED = "INITIATED",
+    ERROR = "ERROR",
+    REFUNDED = "REFUNDED",
+    PROCEEDED = "PROCEEDED",
+    WAITING_FOR_FULFILLMENT = "WAITING_FOR_FULFILLMENT",
+    FULFILLED = "FULFILLED"
+}
+export declare enum CheckoutState {
+    FROM_UNFUNDED = "FROM_UNFUNDED",
+    FROM_FUNDED = "FROM_FUNDED",
+    FROM_POOLED = "FROM_POOLED",
+    TO_UNFUNDED = "TO_UNFUNDED",
+    TO_FUNDED = "TO_FUNDED",
+    TO_POOLED = "TO_POOLED",
+    TO_READY = "TO_READY",
+    PENDING_RECEIVAL = "PENDING_RECEIVAL",
+    COMPLETED = "COMPLETED",
+    CHECKOUT_ERROR = "CHECKOUT_ERROR",
+    EXPIRED = "EXPIRED",
+    CANCELLED = "CANCELLED"
+}
+export type CheckoutApiQuoteResponse = {
+    quoteId: string;
+    estTotalFromAmountBaseUnit: string;
+    estSubtotalFromAmountBaseUnit: string;
+    estFeesFromAmountBaseUnit: string;
+    fromTokenAddress: Address;
+    estFeesUsd: number;
+    estSubtotalUsd: number;
+    estTotalUsd: number;
+    estCheckoutTimeMs: number;
+    estMarketMakerGasUsd: number;
+    lpFeePercentage: number;
+    lpFeeUsd: number;
+};
+export type CheckoutQuoteResponse = CheckoutApiQuoteResponse & {
+    estTotalFromAmount: string;
+    estSubtotalFromAmount: string;
+    estFeesFromAmount: string;
+    metadata?: {
+        [key: string]: unknown;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,CAAA;AAGb,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,oBAAoB,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAMD,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1C;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,GAAG,CAAA;IAChB,eAAe,EAAE,OAAO,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,OAAO,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,oBAAY,mBAAmB;IAC7B,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,uBAAuB,4BAA4B;IACnD,SAAS,cAAc;CACxB;AAGD,oBAAY,aAAa;IAEvB,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,gBAAgB,qBAAqB;IAErC,SAAS,cAAc;IACvB,cAAc,mBAAmB;IACjC,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB;AAGD,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,0BAA0B,EAAE,MAAM,CAAA;IAClC,6BAA6B,EAAE,MAAM,CAAA;IACrC,yBAAyB,EAAE,MAAM,CAAA;IACjC,gBAAgB,EAAE,OAAO,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAGD,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,GAAG;IAC7D,kBAAkB,EAAE,MAAM,CAAA;IAC1B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,iBAAiB,EAAE,MAAM,CAAA;IAGzB,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CACtC,CAAA"}

package/dist/src/utils.d.ts

@@ -0,0 +1,13 @@
+import type { Address } from 'viem';
+import { CheckoutRefundState, CheckoutState, type RelayExecutionInfo } from './types';
+/**
+ * Converts a token address within Funkit the corresponding Relay token address.
+ */
+export declare function convertFunToRelayTokenAddress(address: Address): Address;
+export declare function getRelayExecutionRefundState(info: RelayExecutionInfo): CheckoutRefundState | undefined;
+export declare function getRelayExecutionState(info: RelayExecutionInfo): CheckoutState;
+/**
+ * Checks whether the Relay execution has reached a terminal status.
+ */
+export declare function isRelayExecutionTerminalStatus(info: RelayExecutionInfo): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAMnC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,KAAK,kBAAkB,EACxB,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAMvE;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,kBAAkB,GACvB,mBAAmB,GAAG,SAAS,CAOjC;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,kBAAkB,GACvB,aAAa,CAUf;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAET"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@funkit/fun-relay",
+  "version": "0.1.0",
+  "files": [
+    "dist/src",
+    "dist/index.d.ts",
+    "dist/index.js",
+    "dist/index.js.map",
+    "CHANGELOG.md"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@reservoir0x/relay-sdk": "^2.0.3"
+  },
+  "devDependencies": {
+    "viem": "^2.29.4"
+  },
+  "peerDependencies": {
+    "viem": ">=2.23.1"
+  },
+  "keywords": [
+    "blockchain",
+    "funkit"
+  ],
+  "author": "https://fun.xyz/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fun-xyz/funkit.git",
+    "directory": "packages/fun-relay"
+  },
+  "homepage": "https://github.com/fun-xyz/funkit/tree/main/packages/fun-relay",
+  "scripts": {
+    "build": "rm -rf dist && pnpm typegen && node build.mjs",
+    "build:watch": "rm -rf dist && node build.js --watch",
+    "lint": "biome check",
+    "lint:fix": "biome check --fix",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "typegen": "tsc --emitDeclarationOnly"
+  }
+}