@ensofinance/checkout-widget 0.0.1

package/src/enso-api/model/routerControllerRouteShortcutTransactionRoutingStrategy.ts

@@ -0,0 +1,23 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+
+export type RouterControllerRouteShortcutTransactionRoutingStrategy =
+    | (typeof RouterControllerRouteShortcutTransactionRoutingStrategy)[keyof typeof RouterControllerRouteShortcutTransactionRoutingStrategy]
+    | null;
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const RouterControllerRouteShortcutTransactionRoutingStrategy = {
+    ensowallet: "ensowallet",
+    router: "router",
+    delegate: "delegate",
+    "router-legacy": "router-legacy",
+    "delegate-legacy": "delegate-legacy",
+} as const;

package/src/enso-api/model/standard.ts

@@ -0,0 +1,18 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+import type { Protocol } from "./protocol";
+import type { StandardAction } from "./standardAction";
+
+export interface Standard {
+    protocol: Protocol;
+    forks: Protocol[];
+    actions: StandardAction[];
+}

package/src/enso-api/model/standardAction.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+import type { StandardActionAction } from "./standardActionAction";
+import type { Network } from "./network";
+
+export interface StandardAction {
+    action: StandardActionAction;
+    name: string;
+    functionNames: string[];
+    supportedChains: Network[];
+    inputs: string[];
+}

package/src/enso-api/model/standardActionAction.ts

@@ -0,0 +1,53 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+
+export type StandardActionAction =
+    (typeof StandardActionAction)[keyof typeof StandardActionAction];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const StandardActionAction = {
+    approve: "approve",
+    borrow: "borrow",
+    borrowwithpositionid: "borrowwithpositionid",
+    bridge: "bridge",
+    deposit: "deposit",
+    singledeposit: "singledeposit",
+    singledepositwithpositionid: "singledepositwithpositionid",
+    multideposit: "multideposit",
+    tokenizedsingledeposit: "tokenizedsingledeposit",
+    tokenizedmultideposit: "tokenizedmultideposit",
+    multioutsingledeposit: "multioutsingledeposit",
+    depositclmm: "depositclmm",
+    harvest: "harvest",
+    permittransferfrom: "permittransferfrom",
+    redeem: "redeem",
+    singleredeem: "singleredeem",
+    singleredeemwithpositionid: "singleredeemwithpositionid",
+    multiredeem: "multiredeem",
+    tokenizedsingleredeem: "tokenizedsingleredeem",
+    tokenizedmultiredeem: "tokenizedmultiredeem",
+    redeemclmm: "redeemclmm",
+    repay: "repay",
+    repaywithpositionid: "repaywithpositionid",
+    swap: "swap",
+    transfer: "transfer",
+    transferfrom: "transferfrom",
+    route: "route",
+    call: "call",
+    split: "split",
+    merge: "merge",
+    balance: "balance",
+    minamountout: "minamountout",
+    slippage: "slippage",
+    fee: "fee",
+    ensofee: "ensofee",
+    paymasterfee: "paymasterfee",
+} as const;

package/src/enso-api/model/tokenModel.ts

@@ -0,0 +1,36 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+
+export interface TokenModel {
+    /** Ethereum address of the token */
+    address: string;
+    /** Chain ID of the network of the token */
+    chainId: number;
+    /** Type of token */
+    type: string;
+    /** Token decimals */
+    decimals: number;
+    /**
+     * Token name
+     * @nullable
+     */
+    symbol: string | null;
+    /**
+     * Token symbol
+     * @nullable
+     */
+    name: string | null;
+    /**
+     * A list of logos for the token
+     * @nullable
+     */
+    logosUri: string[] | null;
+}

package/src/enso-api/model/tokensControllerTokens200.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+import type { PaginatedResult } from "./paginatedResult";
+import type { TokensControllerTokens200AllOf } from "./tokensControllerTokens200AllOf";
+
+export type TokensControllerTokens200 = PaginatedResult &
+    TokensControllerTokens200AllOf;

package/src/enso-api/model/tokensControllerTokens200AllOf.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+import type { PositionModel } from "./positionModel";
+
+export type TokensControllerTokens200AllOf = {
+    /** Returned data for current page */
+    data?: PositionModel[];
+};

package/src/enso-api/model/tokensControllerTokensParams.ts

@@ -0,0 +1,91 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+import type { TokensControllerTokensType } from "./tokensControllerTokensType";
+
+export type TokensControllerTokensParams = {
+    /**
+     * The overarching project or platform associated with the DeFi token
+     */
+    project?: string;
+    /**
+     * The specific standard integration or version of the DeFi project
+     */
+    protocolSlug?: string;
+    /**
+     * Underlying tokens of defi token
+     */
+    underlyingTokens?: string[];
+    /**
+     * Exact composition of underlying tokens of defi token
+     */
+    underlyingTokensExact?: string[];
+    /**
+     * Ethereum addresses for contract interaction of defi tokens
+     */
+    primaryAddress?: string[];
+    /**
+     * Ethereum addresses of the tokens
+     */
+    address?: string[];
+    /**
+     * Names of the tokens
+     */
+    name?: string[];
+    /**
+     * Symbols of the tokens
+     */
+    symbol?: string[];
+    /**
+     * Chain ID of the network of the token
+     */
+    chainId?: number;
+    /**
+ * Type of token.
+      If not provided, both types will be taken into account
+ */
+    type?: TokensControllerTokensType;
+    /**
+     * Pagination page number. Pages are of length 1000
+     */
+    page?: number;
+    /**
+     * Number of items per page (max 1000)
+     */
+    pageSize?: number;
+    /**
+     * Cursor for pagination. Pages are of length 1000
+     */
+    cursor?: number;
+    /**
+     * Whether to include token metadata (symbol, name and logos)
+     */
+    includeMetadata?: boolean;
+    /**
+     * Whether to include underlying tokes
+     */
+    includeUnderlying?: boolean;
+    /**
+     * Only include tokens with APY over this value
+     */
+    apyFrom?: number;
+    /**
+     * Only include tokens with APY below this value
+     */
+    apyTo?: number;
+    /**
+     * Only include tokens with TVL over this value
+     */
+    tvlFrom?: number;
+    /**
+     * Only include tokens with TVL below this value
+     */
+    tvlTo?: number;
+};

package/src/enso-api/model/tokensControllerTokensType.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+
+export type TokensControllerTokensType =
+    (typeof TokensControllerTokensType)[keyof typeof TokensControllerTokensType];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const TokensControllerTokensType = {
+    defi: "defi",
+    base: "base",
+} as const;

package/src/enso-api/model/transaction.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+
+export interface Transaction {
+    data: string;
+    to: string;
+    from: string;
+    value: string;
+}

package/src/enso-api/model/userOperation.ts

@@ -0,0 +1,28 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+
+export interface UserOperation {
+    callData: string;
+    callGasLimit: string;
+    factory: string;
+    factoryData: string;
+    maxFeePerGas: string;
+    maxPriorityFeePerGas: string;
+    nonce: string;
+    paymaster: string;
+    paymasterData: string;
+    paymasterPostOpGasLimit: string;
+    paymasterVerificationGasLimit: string;
+    preVerificationGas: string;
+    sender: string;
+    signature: string;
+    verificationGasLimit: string;
+}

package/src/enso-api/model/walletApproveTransaction.ts

@@ -0,0 +1,24 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+import type { WalletApproveTransactionTx } from "./walletApproveTransactionTx";
+
+export interface WalletApproveTransaction {
+    /** The tx object to use in `ethers` */
+    tx: WalletApproveTransactionTx;
+    /** The gas estimate for the transaction */
+    gas: string;
+    /** The token address to approve */
+    token: string;
+    /** The amount of tokens to approve */
+    amount: string;
+    /** The spender address to approve */
+    spender: string;
+}

package/src/enso-api/model/walletApproveTransactionTx.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+
+/**
+ * The tx object to use in `ethers`
+ */
+export type WalletApproveTransactionTx = { [key: string]: unknown };

package/src/enso-api/model/walletBalance.ts

@@ -0,0 +1,29 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+
+export interface WalletBalance {
+    /** The address of the token */
+    token: string;
+    /** The unformatted balance of the token */
+    amount: string;
+    /** Chain ID of the network */
+    chainId: number;
+    /** The unformatted balance of the token */
+    decimals: number;
+    /** Price of the token in usd */
+    price: string;
+    /** Name of the token */
+    name: string;
+    /** Symbol of the token */
+    symbol: string;
+    /** Logo of the token */
+    logoUri: string;
+}

package/src/enso-api/model/walletControllerCreateApproveTransactionParams.ts

@@ -0,0 +1,35 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+import type { WalletControllerCreateApproveTransactionRoutingStrategy } from "./walletControllerCreateApproveTransactionRoutingStrategy";
+
+export type WalletControllerCreateApproveTransactionParams = {
+    /**
+     * Chain ID of the network to execute the transaction on
+     */
+    chainId?: number;
+    /**
+     * Ethereum address of the wallet to send the transaction from
+     */
+    fromAddress?: string;
+    /**
+     * Routing strategy to use
+     * @nullable
+     */
+    routingStrategy?: WalletControllerCreateApproveTransactionRoutingStrategy;
+    /**
+     * ERC20 token address of the token to approve
+     */
+    tokenAddress?: string;
+    /**
+     * Amount of tokens to approve in wei
+     */
+    amount?: string;
+};

package/src/enso-api/model/walletControllerCreateApproveTransactionRoutingStrategy.ts

@@ -0,0 +1,23 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+
+export type WalletControllerCreateApproveTransactionRoutingStrategy =
+    | (typeof WalletControllerCreateApproveTransactionRoutingStrategy)[keyof typeof WalletControllerCreateApproveTransactionRoutingStrategy]
+    | null;
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const WalletControllerCreateApproveTransactionRoutingStrategy = {
+    ensowallet: "ensowallet",
+    router: "router",
+    delegate: "delegate",
+    "router-legacy": "router-legacy",
+    "delegate-legacy": "delegate-legacy",
+} as const;

package/src/enso-api/model/walletControllerWalletBalancesParams.ts

@@ -0,0 +1,25 @@
+/**
+ * Generated by orval v7.11.1 🍺
+ * Do not edit manually.
+ * #### Enso API
+- Find detailed documentation on [docs.enso.finance](https://docs.enso.finance).
+- To use the API, **you must include your API Key in the Authorization header** (Bearer format).
+- For testing, Swagger pre-authorizes you using the key: `1e02632d-6feb-4a75-a157-documentation` (1rps).
+- Get your own API Key at [enso.finance/developers](https://enso.finance/developers).
+ * OpenAPI spec version: 1.0
+ */
+
+export type WalletControllerWalletBalancesParams = {
+    /**
+     * Chain ID (or 'all') to fetch balances for specified network
+     */
+    chainId: number;
+    /**
+     * Address of the eoa with which to associate the ensoWallet for balances
+     */
+    eoaAddress?: string;
+    /**
+     * If true returns balances for the provided address, instead of the associated ensoWallet
+     */
+    useEoa?: boolean;
+};

package/src/index.ts

@@ -0,0 +1,17 @@
+import { CheckoutModal } from "./components/CheckoutModal";
+import { Checkout } from "./components/Checkout";
+import { type CheckoutModalProps, type CheckoutConfig } from "@/types";
+
+// Export two versions for different integration needs
+export {
+    // Modal version with isActive/setIsActive control
+    CheckoutModal,
+    CheckoutModalProps,
+
+    // Standalone widget version without modal
+    Checkout,
+    CheckoutConfig,
+};
+
+// Export theme type for TypeScript users
+export type { WidgetTheme } from "./types";

package/src/store.ts

@@ -0,0 +1,68 @@
+import { create } from "zustand";
+import { DEFAULT_SLIPPAGE } from "./util/constants";
+import { AccessTokenPayload } from "@meshconnect/web-link-sdk";
+
+type Store = {
+    isCheckout: boolean;
+    setIsCheckout: (isCheckout: boolean) => void;
+
+    ensoApiToken: string;
+    setEnsoApiToken: (ensoApiToken: string) => void;
+
+    tokenIn: string;
+    setTokenIn: (tokenIn: string) => void;
+    tokenOut: string;
+    setTokenOut: (tokenOut: string) => void;
+    chainIdIn?: number;
+    setChainIdIn: (chainIdIn: number) => void;
+    chainIdOut?: number;
+    setChainIdOut: (chainIdOut: number) => void;
+    amountIn?: string;
+    setAmountIn: (amountIn: string) => void;
+
+    slippage?: number;
+    setSlippage: (slippage: number) => void;
+
+    // Mesh integration
+    meshAccessToken: AccessTokenPayload | null;
+    setMeshAccessToken: (meshAccessToken: AccessTokenPayload) => void;
+
+    // api state
+    sessionId: string;
+    setSessionId: (sessionId: string) => void;
+    linkToken: string;
+    setLinkToken: (linkToken: string) => void;
+};
+
+export const useAppStore = create<Store>((set) => ({
+    isCheckout: false,
+    setIsCheckout: (isCheckout: boolean) => set({ isCheckout }),
+
+    ensoApiToken: "",
+    setEnsoApiToken: (ensoApiToken: string) => set({ ensoApiToken }),
+
+    tokenIn: "",
+    setTokenIn: (tokenIn: string) => set({ tokenIn }),
+    tokenOut: "",
+    setTokenOut: (tokenOut: string) => set({ tokenOut }),
+    chainIdIn: undefined,
+    setChainIdIn: (chainIdIn: number) => set({ chainIdIn }),
+    chainIdOut: undefined,
+    setChainIdOut: (chainIdOut: number) => set({ chainIdOut }),
+    amountIn: "0",
+    setAmountIn: (amountIn: string) => set({ amountIn }),
+
+    slippage: DEFAULT_SLIPPAGE,
+    setSlippage: (slippage: number) => set({ slippage }),
+
+    // Mesh integration
+    meshAccessToken: null,
+    setMeshAccessToken: (meshAccessToken: AccessTokenPayload) =>
+        set({ meshAccessToken }),
+
+    // api state
+    sessionId: "",
+    setSessionId: (sessionId: string) => set({ sessionId }),
+    linkToken: "",
+    setLinkToken: (linkToken: string) => set({ linkToken }),
+}));

package/src/types/assets.d.ts

@@ -0,0 +1,29 @@
+declare module "*.png" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.svg" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.jpg" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.jpeg" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.gif" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.webp" {
+  const value: string;
+  export default value;
+}

package/src/types/index.ts

@@ -0,0 +1,21 @@
+// Re-export Chakra's SystemConfig as the theme type
+import type { SystemConfig as WidgetTheme } from "@chakra-ui/react";
+
+export type { WidgetTheme };
+
+export type SupportedExchanges = "binance";
+
+export type CheckoutConfig = {
+    tokenOut: string;
+    chainIdOut: number;
+    apiKey: string;
+    theme?: WidgetTheme;
+    enableExchange?: SupportedExchanges[];
+};
+
+export type CheckoutModalProps = {
+    config: CheckoutConfig;
+    isActive: boolean;
+    setIsActive: (active: boolean) => void;
+    onClose?: () => void;
+};