@armory-sh/base 0.2.27-alpha.23.77 → 0.2.27-alpha.23.78

package/dist/client-hooks-runtime.d.ts

@@ -0,0 +1,8 @@
+import type { ClientHook, PaymentPayloadContext, PaymentRequiredContext } from "./types/hooks";
+import type { PaymentRequirementsV2 } from "./types/v2";
+export declare const runOnPaymentRequiredHooks: <TWallet>(hooks: ClientHook<TWallet>[] | undefined, context: PaymentRequiredContext) => Promise<void>;
+export declare const selectRequirementWithHooks: <TWallet>(hooks: ClientHook<TWallet>[] | undefined, context: PaymentRequiredContext) => Promise<PaymentRequirementsV2>;
+export declare const runBeforeSignPaymentHooks: <TWallet>(hooks: ClientHook<TWallet>[] | undefined, context: PaymentPayloadContext<TWallet>) => Promise<void>;
+export declare const runAfterPaymentResponseHooks: <TWallet>(hooks: ClientHook<TWallet>[] | undefined, context: PaymentPayloadContext<TWallet> & {
+    response: Response;
+}) => Promise<void>;

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export type { BalanceOfParams, BalanceOfReturnType, ERC20Abi, NameReturnType, ReceiveWithAuthorizationParams, SymbolReturnType, TransferWithAuthorizationParams, } from "./abi/erc20";
 export { ERC20_ABI } from "./abi/erc20";
+export { runAfterPaymentResponseHooks, runBeforeSignPaymentHooks, runOnPaymentRequiredHooks, selectRequirementWithHooks, } from "./client-hooks-runtime";
 export { EURC_BASE, getAllTokens, getEURCTokens, getSKLTokens, getToken, getTokensByChain, getTokensBySymbol, getUSDCTokens, getUSDTTokens, getWBTCTokens, getWETHTokens, SKL_SKALE_BASE, SKL_SKALE_BASE_SEPOLIA, TOKENS, USDC_BASE, USDC_BASE_SEPOLIA, USDC_SKALE_BASE, USDC_SKALE_BASE_SEPOLIA, USDT_SKALE_BASE, USDT_SKALE_BASE_SEPOLIA, WBTC_SKALE_BASE, WBTC_SKALE_BASE_SEPOLIA, WETH_SKALE_BASE, WETH_SKALE_BASE_SEPOLIA, } from "./data/tokens";
 export type { EIP712Domain, EIP712Types, TransferWithAuthorization, TypedDataDomain, TypedDataField, } from "./eip712";
 export { createEIP712Domain, createTransferWithAuthorization, EIP712_TYPES, USDC_DOMAIN, validateTransferWithAuthorization, } from "./eip712";
@@ -13,7 +14,7 @@ export type { PaymentConfig, ResolvedRequirementsConfig, } from "./payment-requi
 export { createPaymentRequirements, findRequirementByNetwork, } from "./payment-requirements";
 export { calculateValidBefore, detectX402Version, generateNonce, getPaymentHeaderName, parseJsonOrBase64, } from "./protocol";
 export type { AcceptPaymentOptions, ArmoryPaymentResult, FacilitatorConfig, FacilitatorSettleResult, FacilitatorVerifyResult, NetworkId, PaymentError, PaymentErrorCode, PaymentResult, PayToAddress, PricingConfig, ResolvedFacilitator, ResolvedNetwork, ResolvedPaymentConfig, ResolvedToken, SettlementMode, TokenId, ValidationError, } from "./types/api";
-export type { BeforePaymentHook, ExtensionHook, HookConfig, HookRegistry, HookResult, OnPaymentRequiredHook, PaymentPayloadContext, PaymentRequiredContext, } from "./types/hooks";
+export type { BeforePaymentHook, ClientHook, ClientHookErrorContext, ExtensionHook, HookConfig, HookRegistry, HookResult, OnPaymentRequiredHook, PaymentPayloadContext, PaymentRequiredContext, } from "./types/hooks";
 export type { CustomToken, NetworkConfig } from "./types/networks";
 export { getAllCustomTokens, getCustomToken, getMainnets, getNetworkByChainId, getNetworkConfig, getTestnets, isCustomToken, NETWORKS, registerToken, unregisterToken, } from "./types/networks";
 export type { PaymentPayload, PaymentRequired, PaymentRequirements, SettlementResponse, } from "./types/protocol";

package/dist/index.js

@@ -57,6 +57,106 @@ var ERC20_ABI = [
   }
 ];
 
+// src/client-hooks-runtime.ts
+var notifyError = async (hooks, context) => {
+  if (!hooks?.length) {
+    return;
+  }
+  for (const hook of hooks) {
+    if (!hook.onError) {
+      continue;
+    }
+    await hook.onError(context);
+  }
+};
+var runOnPaymentRequiredHooks = async (hooks, context) => {
+  if (!hooks?.length) {
+    return;
+  }
+  for (const hook of hooks) {
+    if (!hook.onPaymentRequired) {
+      continue;
+    }
+    try {
+      await hook.onPaymentRequired(context);
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "onPaymentRequired" });
+      throw error;
+    }
+  }
+};
+var selectRequirementWithHooks = async (hooks, context) => {
+  if (!context.accepts.length) {
+    throw new Error("No payment requirements found in accepts array");
+  }
+  let selected = context.accepts[0];
+  if (!hooks?.length) {
+    context.selectedRequirement = selected;
+    context.requirements = selected;
+    return selected;
+  }
+  for (const hook of hooks) {
+    if (!hook.selectRequirement) {
+      continue;
+    }
+    try {
+      const override = await hook.selectRequirement({
+        ...context,
+        selectedRequirement: selected,
+        requirements: selected
+      });
+      if (!override) {
+        continue;
+      }
+      const isValid = context.accepts.some((accept) => accept === override);
+      if (!isValid) {
+        throw new Error(
+          "Hook selectRequirement must return an item from accepts"
+        );
+      }
+      selected = override;
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "selectRequirement" });
+      throw error;
+    }
+  }
+  context.selectedRequirement = selected;
+  context.requirements = selected;
+  return selected;
+};
+var runBeforeSignPaymentHooks = async (hooks, context) => {
+  if (!hooks?.length) {
+    return;
+  }
+  for (const hook of hooks) {
+    if (!hook.beforeSignPayment) {
+      continue;
+    }
+    try {
+      await hook.beforeSignPayment(context);
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "beforeSignPayment" });
+      throw error;
+    }
+  }
+};
+var runAfterPaymentResponseHooks = async (hooks, context) => {
+  if (!hooks?.length) {
+    return;
+  }
+  for (const hook of hooks) {
+    if (!hook.afterPaymentResponse) {
+      continue;
+    }
+    try {
+      await hook.afterPaymentResponse(context);
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "afterPaymentResponse" });
+      throw error;
+    }
+  }
+};
+
 // src/data/tokens.ts
 var USDC_BASE = {
   symbol: "USDC",
@@ -1636,4 +1736,4 @@ function validateRouteConfig(config) {
   return null;
 }
 
-export { EIP712_TYPES, ERC20_ABI, EURC_BASE, NETWORKS, PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_SIGNATURE_HEADER, PaymentException, SCHEMES, SKL_SKALE_BASE, SKL_SKALE_BASE_SEPOLIA, SigningError, TOKENS, USDC_BASE, USDC_BASE_SEPOLIA, USDC_DOMAIN, USDC_SKALE_BASE, USDC_SKALE_BASE_SEPOLIA, USDT_SKALE_BASE, USDT_SKALE_BASE_SEPOLIA, V2_HEADERS, WBTC_SKALE_BASE, WBTC_SKALE_BASE_SEPOLIA, WETH_SKALE_BASE, WETH_SKALE_BASE_SEPOLIA, X402ClientError, X402_VERSION, addressToAssetId, assetIdToAddress, caip2ToNetwork, calculateValidBefore, checkFacilitatorSupport, combineSignature as combineSignatureV2, createEIP712Domain, createError, createNonce, createPaymentRequiredHeaders, createPaymentRequirements, createSettlementHeaders, createTransferWithAuthorization, decodeBase64ToUtf8, decodePayloadHeader, decodePayment, decodePaymentV2, decodeSettlementResponse, decodeSettlementV2, decodeX402Response, detectPaymentVersion, detectX402Version, encodePayment, encodePaymentV2, encodeSettlementResponse, encodeSettlementV2, encodeUtf8ToBase64, encodeX402Response, extractPayerAddress, extractPaymentFromHeaders, findMatchingRoute, findRequirementByNetwork, fromAtomicUnits, generateNonce, getAllCustomTokens, getAllTokens, getAvailableNetworks, getAvailableTokens, getCurrentTimestamp, getCustomToken, getEURCTokens, getMainnets, getNetworkByChainId, getNetworkConfig, getPaymentHeaderName, getSKLTokens, getSupported, getTestnets, getToken, getTokensByChain, getTokensBySymbol, getTxHash, getUSDCTokens, getUSDTTokens, getWBTCTokens, getWETHTokens, isAddress2 as isAddress, isCAIP2ChainId, isCAIPAssetId, isCustomToken, isExactEvmPayload, isPaymentPayload, isPaymentPayloadV2, isPaymentRequiredV2, isPaymentV2, isResolvedNetwork, isResolvedToken, isSettlementSuccessful, isSettlementV2, isValidAddress, isValidationError, isX402V2Payload, isX402V2PaymentRequired, isX402V2Requirements, isX402V2Settlement, matchRoute, networkToCaip2, normalizeAddress, normalizeBase64Url, normalizeNetworkName, parseJsonOrBase64, parseRoutePattern, parseSignature as parseSignatureV2, registerToken, resolveFacilitator, resolveNetwork, resolveToken, safeBase64Decode2 as safeBase64Decode, safeBase64Encode2 as safeBase64Encode, settlePayment, toAtomicUnits, toBase64Url, unregisterToken, validateAcceptConfig, validatePaymentConfig, validateRouteConfig, validateTransferWithAuthorization, verifyPayment };
+export { EIP712_TYPES, ERC20_ABI, EURC_BASE, NETWORKS, PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_SIGNATURE_HEADER, PaymentException, SCHEMES, SKL_SKALE_BASE, SKL_SKALE_BASE_SEPOLIA, SigningError, TOKENS, USDC_BASE, USDC_BASE_SEPOLIA, USDC_DOMAIN, USDC_SKALE_BASE, USDC_SKALE_BASE_SEPOLIA, USDT_SKALE_BASE, USDT_SKALE_BASE_SEPOLIA, V2_HEADERS, WBTC_SKALE_BASE, WBTC_SKALE_BASE_SEPOLIA, WETH_SKALE_BASE, WETH_SKALE_BASE_SEPOLIA, X402ClientError, X402_VERSION, addressToAssetId, assetIdToAddress, caip2ToNetwork, calculateValidBefore, checkFacilitatorSupport, combineSignature as combineSignatureV2, createEIP712Domain, createError, createNonce, createPaymentRequiredHeaders, createPaymentRequirements, createSettlementHeaders, createTransferWithAuthorization, decodeBase64ToUtf8, decodePayloadHeader, decodePayment, decodePaymentV2, decodeSettlementResponse, decodeSettlementV2, decodeX402Response, detectPaymentVersion, detectX402Version, encodePayment, encodePaymentV2, encodeSettlementResponse, encodeSettlementV2, encodeUtf8ToBase64, encodeX402Response, extractPayerAddress, extractPaymentFromHeaders, findMatchingRoute, findRequirementByNetwork, fromAtomicUnits, generateNonce, getAllCustomTokens, getAllTokens, getAvailableNetworks, getAvailableTokens, getCurrentTimestamp, getCustomToken, getEURCTokens, getMainnets, getNetworkByChainId, getNetworkConfig, getPaymentHeaderName, getSKLTokens, getSupported, getTestnets, getToken, getTokensByChain, getTokensBySymbol, getTxHash, getUSDCTokens, getUSDTTokens, getWBTCTokens, getWETHTokens, isAddress2 as isAddress, isCAIP2ChainId, isCAIPAssetId, isCustomToken, isExactEvmPayload, isPaymentPayload, isPaymentPayloadV2, isPaymentRequiredV2, isPaymentV2, isResolvedNetwork, isResolvedToken, isSettlementSuccessful, isSettlementV2, isValidAddress, isValidationError, isX402V2Payload, isX402V2PaymentRequired, isX402V2Requirements, isX402V2Settlement, matchRoute, networkToCaip2, normalizeAddress, normalizeBase64Url, normalizeNetworkName, parseJsonOrBase64, parseRoutePattern, parseSignature as parseSignatureV2, registerToken, resolveFacilitator, resolveNetwork, resolveToken, runAfterPaymentResponseHooks, runBeforeSignPaymentHooks, runOnPaymentRequiredHooks, safeBase64Decode2 as safeBase64Decode, safeBase64Encode2 as safeBase64Encode, selectRequirementWithHooks, settlePayment, toAtomicUnits, toBase64Url, unregisterToken, validateAcceptConfig, validatePaymentConfig, validateRouteConfig, validateTransferWithAuthorization, verifyPayment };

package/dist/types/hooks.d.ts

@@ -11,7 +11,9 @@ import type { Address, Extensions, PaymentPayloadV2, PaymentRequirementsV2 } fro
 export interface PaymentRequiredContext {
     url: RequestInfo | URL;
     requestInit: RequestInit | undefined;
+    accepts: PaymentRequirementsV2[];
     requirements: PaymentRequirementsV2;
+    selectedRequirement?: PaymentRequirementsV2;
     serverExtensions: Extensions | undefined;
     fromAddress: Address;
     nonce: `0x${string}`;
@@ -33,3 +35,17 @@ export interface HookConfig<TWallet = unknown> {
     name?: string;
 }
 export type HookRegistry<TWallet = unknown> = Record<string, HookConfig<TWallet>>;
+export interface ClientHookErrorContext {
+    error: unknown;
+    phase: "onPaymentRequired" | "selectRequirement" | "beforeSignPayment" | "afterPaymentResponse";
+}
+export interface ClientHook<TWallet = unknown> {
+    name?: string;
+    onPaymentRequired?: (context: PaymentRequiredContext) => HookResult;
+    selectRequirement?: (context: PaymentRequiredContext) => PaymentRequirementsV2 | undefined | Promise<PaymentRequirementsV2 | undefined>;
+    beforeSignPayment?: (context: PaymentPayloadContext<TWallet>) => HookResult;
+    afterPaymentResponse?: (context: PaymentPayloadContext<TWallet> & {
+        response: Response;
+    }) => HookResult;
+    onError?: (context: ClientHookErrorContext) => HookResult;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@armory-sh/base",
-  "version": "0.2.27-alpha.23.77",
+  "version": "0.2.27-alpha.23.78",
   "license": "MIT",
   "author": "Sawyer Cutler <sawyer@dirtroad.dev>",
   "keywords": [
@@ -28,10 +28,21 @@
       "bun": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./types/hooks": {
+      "types": "./src/types/hooks.ts",
+      "bun": "./src/types/hooks.ts",
+      "default": "./src/types/hooks.ts"
+    },
+    "./client-hooks-runtime": {
+      "types": "./src/client-hooks-runtime.ts",
+      "bun": "./src/client-hooks-runtime.ts",
+      "default": "./src/client-hooks-runtime.ts"
+    },
     "./dist/*": "./dist/*.js"
   },
   "files": [
     "dist",
+    "src",
     "README.md"
   ],
   "publishConfig": {

package/src/abi/erc20.ts

@@ -0,0 +1,84 @@
+export type TransferWithAuthorizationParams = readonly [
+  from: `0x${string}`,
+  to: `0x${string}`,
+  amount: bigint,
+  validAfter: bigint,
+  expiry: bigint,
+  v: number,
+  r: `0x${string}`,
+  s: `0x${string}`,
+];
+
+export type ReceiveWithAuthorizationParams = readonly [
+  from: `0x${string}`,
+  to: `0x${string}`,
+  amount: bigint,
+  validAfter: bigint,
+  expiry: bigint,
+  v: number,
+  r: `0x${string}`,
+  s: `0x${string}`,
+];
+
+export type BalanceOfParams = readonly [account: `0x${string}`];
+export type BalanceOfReturnType = bigint;
+export type NameReturnType = string;
+export type SymbolReturnType = string;
+
+export const ERC20_ABI = [
+  {
+    type: "function",
+    name: "transferWithAuthorization",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "from", type: "address" },
+      { name: "to", type: "address" },
+      { name: "amount", type: "uint256" },
+      { name: "validAfter", type: "uint256" },
+      { name: "expiry", type: "uint256" },
+      { name: "v", type: "uint8" },
+      { name: "r", type: "bytes32" },
+      { name: "s", type: "bytes32" },
+    ],
+    outputs: [],
+  },
+  {
+    type: "function",
+    name: "receiveWithAuthorization",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "from", type: "address" },
+      { name: "to", type: "address" },
+      { name: "amount", type: "uint256" },
+      { name: "validAfter", type: "uint256" },
+      { name: "expiry", type: "uint256" },
+      { name: "v", type: "uint8" },
+      { name: "r", type: "bytes32" },
+      { name: "s", type: "bytes32" },
+    ],
+    outputs: [],
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    stateMutability: "view",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "balance", type: "uint256" }],
+  },
+  {
+    type: "function",
+    name: "name",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "string" }],
+  },
+  {
+    type: "function",
+    name: "symbol",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "string" }],
+  },
+] as const;
+
+export type ERC20Abi = typeof ERC20_ABI;

package/src/client-hooks-runtime.ts

@@ -0,0 +1,133 @@
+import type {
+  ClientHook,
+  ClientHookErrorContext,
+  PaymentPayloadContext,
+  PaymentRequiredContext,
+} from "./types/hooks";
+import type { PaymentRequirementsV2 } from "./types/v2";
+
+const notifyError = async <TWallet>(
+  hooks: ClientHook<TWallet>[] | undefined,
+  context: ClientHookErrorContext,
+): Promise<void> => {
+  if (!hooks?.length) {
+    return;
+  }
+
+  for (const hook of hooks) {
+    if (!hook.onError) {
+      continue;
+    }
+    await hook.onError(context);
+  }
+};
+
+export const runOnPaymentRequiredHooks = async <TWallet>(
+  hooks: ClientHook<TWallet>[] | undefined,
+  context: PaymentRequiredContext,
+): Promise<void> => {
+  if (!hooks?.length) {
+    return;
+  }
+
+  for (const hook of hooks) {
+    if (!hook.onPaymentRequired) {
+      continue;
+    }
+    try {
+      await hook.onPaymentRequired(context);
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "onPaymentRequired" });
+      throw error;
+    }
+  }
+};
+
+export const selectRequirementWithHooks = async <TWallet>(
+  hooks: ClientHook<TWallet>[] | undefined,
+  context: PaymentRequiredContext,
+): Promise<PaymentRequirementsV2> => {
+  if (!context.accepts.length) {
+    throw new Error("No payment requirements found in accepts array");
+  }
+
+  let selected = context.accepts[0];
+
+  if (!hooks?.length) {
+    context.selectedRequirement = selected;
+    context.requirements = selected;
+    return selected;
+  }
+
+  for (const hook of hooks) {
+    if (!hook.selectRequirement) {
+      continue;
+    }
+    try {
+      const override = await hook.selectRequirement({
+        ...context,
+        selectedRequirement: selected,
+        requirements: selected,
+      });
+      if (!override) {
+        continue;
+      }
+      const isValid = context.accepts.some((accept) => accept === override);
+      if (!isValid) {
+        throw new Error(
+          "Hook selectRequirement must return an item from accepts",
+        );
+      }
+      selected = override;
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "selectRequirement" });
+      throw error;
+    }
+  }
+
+  context.selectedRequirement = selected;
+  context.requirements = selected;
+  return selected;
+};
+
+export const runBeforeSignPaymentHooks = async <TWallet>(
+  hooks: ClientHook<TWallet>[] | undefined,
+  context: PaymentPayloadContext<TWallet>,
+): Promise<void> => {
+  if (!hooks?.length) {
+    return;
+  }
+
+  for (const hook of hooks) {
+    if (!hook.beforeSignPayment) {
+      continue;
+    }
+    try {
+      await hook.beforeSignPayment(context);
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "beforeSignPayment" });
+      throw error;
+    }
+  }
+};
+
+export const runAfterPaymentResponseHooks = async <TWallet>(
+  hooks: ClientHook<TWallet>[] | undefined,
+  context: PaymentPayloadContext<TWallet> & { response: Response },
+): Promise<void> => {
+  if (!hooks?.length) {
+    return;
+  }
+
+  for (const hook of hooks) {
+    if (!hook.afterPaymentResponse) {
+      continue;
+    }
+    try {
+      await hook.afterPaymentResponse(context);
+    } catch (error) {
+      await notifyError(hooks, { error, phase: "afterPaymentResponse" });
+      throw error;
+    }
+  }
+};

package/src/data/tokens.ts

@@ -0,0 +1,199 @@
+import type { CustomToken } from "../types/networks";
+
+export const USDC_BASE: CustomToken = {
+  symbol: "USDC",
+  name: "USDC",
+  version: "2",
+  contractAddress:
+    "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" as `0x${string}`,
+  chainId: 8453,
+  decimals: 6,
+};
+
+export const EURC_BASE: CustomToken = {
+  symbol: "EURC",
+  name: "EURC",
+  version: "2",
+  contractAddress:
+    "0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42" as `0x${string}`,
+  chainId: 8453,
+  decimals: 6,
+};
+
+export const USDC_BASE_SEPOLIA: CustomToken = {
+  symbol: "USDC",
+  name: "USDC",
+  version: "2",
+  contractAddress:
+    "0x036CbD53842c5426634e7929541eC2318f3dCF7e" as `0x${string}`,
+  chainId: 84532,
+  decimals: 6,
+};
+
+export const USDC_SKALE_BASE: CustomToken = {
+  symbol: "USDC",
+  name: "Bridged USDC (SKALE Bridge)",
+  version: "2",
+  contractAddress:
+    "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20" as `0x${string}`,
+  chainId: 1187947933,
+  decimals: 6,
+};
+
+export const SKL_SKALE_BASE: CustomToken = {
+  symbol: "SKL",
+  name: "SKALE",
+  version: "1",
+  contractAddress:
+    "0xE0595a049d02b7674572b0d59cd4880Db60EDC50" as `0x${string}`,
+  chainId: 1187947933,
+  decimals: 18,
+};
+
+export const USDT_SKALE_BASE: CustomToken = {
+  symbol: "USDT",
+  name: "Tether USD",
+  version: "1",
+  contractAddress:
+    "0x2bF5bF154b515EaA82C31a65ec11554fF5aF7fCA" as `0x${string}`,
+  chainId: 1187947933,
+  decimals: 6,
+};
+
+export const WBTC_SKALE_BASE: CustomToken = {
+  symbol: "WBTC",
+  name: "Wrapped BTC",
+  version: "1",
+  contractAddress:
+    "0x1aeeCFE5454c83B42D8A316246CAc9739E7f690e" as `0x${string}`,
+  chainId: 1187947933,
+  decimals: 8,
+};
+
+export const WETH_SKALE_BASE: CustomToken = {
+  symbol: "WETH",
+  name: "Wrapped Ether",
+  version: "1",
+  contractAddress:
+    "0x7bD39ABBd0Dd13103542cAe3276C7fA332bCA486" as `0x${string}`,
+  chainId: 1187947933,
+  decimals: 18,
+};
+
+export const SKL_SKALE_BASE_SEPOLIA: CustomToken = {
+  symbol: "SKL",
+  name: "SKALE",
+  version: "1",
+  contractAddress:
+    "0xaf2e0ff5b5f51553fdb34ce7f04a6c3201cee57b" as `0x${string}`,
+  chainId: 324705682,
+  decimals: 18,
+};
+
+export const USDC_SKALE_BASE_SEPOLIA: CustomToken = {
+  symbol: "USDC",
+  name: "Bridged USDC (SKALE Bridge)",
+  version: "2",
+  contractAddress:
+    "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD" as `0x${string}`,
+  chainId: 324705682,
+  decimals: 6,
+};
+
+export const USDT_SKALE_BASE_SEPOLIA: CustomToken = {
+  symbol: "USDT",
+  name: "Tether USD",
+  version: "1",
+  contractAddress:
+    "0x3ca0a49f511c2c89c4dcbbf1731120d8919050bf" as `0x${string}`,
+  chainId: 324705682,
+  decimals: 6,
+};
+
+export const WBTC_SKALE_BASE_SEPOLIA: CustomToken = {
+  symbol: "WBTC",
+  name: "Wrapped BTC",
+  version: "1",
+  contractAddress:
+    "0x4512eacd4186b025186e1cf6cc0d89497c530e87" as `0x${string}`,
+  chainId: 324705682,
+  decimals: 8,
+};
+
+export const WETH_SKALE_BASE_SEPOLIA: CustomToken = {
+  symbol: "WETH",
+  name: "Wrapped Ether",
+  version: "1",
+  contractAddress:
+    "0xf94056bd7f6965db3757e1b145f200b7346b4fc0" as `0x${string}`,
+  chainId: 324705682,
+  decimals: 18,
+};
+
+export const TOKENS = {
+  USDC_BASE,
+  USDC_BASE_SEPOLIA,
+  EURC_BASE,
+  USDC_SKALE_BASE,
+  USDT_SKALE_BASE,
+  WBTC_SKALE_BASE,
+  WETH_SKALE_BASE,
+  SKL_SKALE_BASE,
+  SKL_SKALE_BASE_SEPOLIA,
+  USDC_SKALE_BASE_SEPOLIA,
+  USDT_SKALE_BASE_SEPOLIA,
+  WBTC_SKALE_BASE_SEPOLIA,
+  WETH_SKALE_BASE_SEPOLIA,
+} as const;
+
+function getToken(
+  chainId: number,
+  contractAddress: string,
+): CustomToken | undefined {
+  const tokens = Object.values(TOKENS);
+  return tokens.find(
+    (t) =>
+      t.chainId === chainId &&
+      t.contractAddress.toLowerCase() === contractAddress.toLowerCase(),
+  );
+}
+
+function getAllTokens(): CustomToken[] {
+  return Object.values(TOKENS);
+}
+
+function getTokensBySymbol(symbol: string): CustomToken[] {
+  return getAllTokens().filter(
+    (t) => t.symbol.toUpperCase() === symbol.toUpperCase(),
+  );
+}
+
+function getTokensByChain(chainId: number): CustomToken[] {
+  return getAllTokens().filter((t) => t.chainId === chainId);
+}
+
+export function getUSDCTokens(): CustomToken[] {
+  return getTokensBySymbol("USDC");
+}
+
+export function getEURCTokens(): CustomToken[] {
+  return getTokensBySymbol("EURC");
+}
+
+export function getSKLTokens(): CustomToken[] {
+  return getTokensBySymbol("SKL");
+}
+
+export function getUSDTTokens(): CustomToken[] {
+  return getTokensBySymbol("USDT");
+}
+
+export function getWBTCTokens(): CustomToken[] {
+  return getTokensBySymbol("WBTC");
+}
+
+export function getWETHTokens(): CustomToken[] {
+  return getTokensBySymbol("WETH");
+}
+
+export { getToken, getAllTokens, getTokensBySymbol, getTokensByChain };