@zebec-network/admin-sdk 1.0.0

package/dist/constants.d.ts

@@ -0,0 +1,32 @@
+import type { RpcNetwork, SuiNetwork } from "./types";
+export declare const STREAM_PROGRAM_LOOKUP_TABLE_ADDRESS: Record<RpcNetwork, string>;
+/**
+ * Supported Chain Ids by SDK
+ */
+export declare enum SupportedChain {
+    Mainnet = 1,
+    Sepolia = 11155111,
+    Base = 8453,
+    Bsc = 56,
+    BscTestnet = 97,
+    OdysseyTestnet = 131313,
+    Odyssey = 153153,
+    Polygon = 137,
+    PolygonAmoy = 80002
+}
+export declare function parseSupportedChain(chainId: number): SupportedChain;
+/**
+ * Odyssey chain ids
+ */
+export declare const ODYSSEY_CHAIN_IDS: SupportedChain[];
+export declare const ZEBEC_EVM_CARD_ADDRESS: Record<SupportedChain, string>;
+export declare const USDC_ADDRESS: Record<SupportedChain, string>;
+export declare const WETH_ADDRESS: Record<SupportedChain, string>;
+export declare const DEFAULT_GAS_LIMIT = 3000000;
+export declare const SUI_SILVERCARD_PACKAGE_ADDRESS: Record<SuiNetwork, string>;
+export declare const SUI_SILVERCARD_MODULE_NAME = "sui_silver_card_contract";
+export declare const SUI_SILVERCARD_CARD_CONFIG_OBJECT_ID: Record<SuiNetwork, string>;
+export declare const SUI_SILVERCARD_FEE_TIER_LIST_OBJECT_ID: Record<SuiNetwork, string>;
+export declare const SUI_SILVERCARD_SWAP_FEE_LIST_OBJECT_ID: Record<SuiNetwork, string>;
+export declare const SUI_SILVERCARD_ADMIN_CAP_STRUCT_TYPE: Record<SuiNetwork, string>;
+export declare const SUI_USDC_COIN_TYPE: Record<SuiNetwork, string>;

package/dist/constants.js

@@ -0,0 +1,115 @@
+export const STREAM_PROGRAM_LOOKUP_TABLE_ADDRESS = {
+    devnet: "HJmEzSXzJrtSdgBZSaedQ51WaD4LkT1r5zR2yT1QERqv",
+    "mainnet-beta": "43N5otEu7k7TzkKsdhkwiYGrdKjBejetWQbF9cJPtY6i",
+};
+/**
+ * Supported Chain Ids by SDK
+ */
+export var SupportedChain;
+(function (SupportedChain) {
+    SupportedChain[SupportedChain["Mainnet"] = 1] = "Mainnet";
+    SupportedChain[SupportedChain["Sepolia"] = 11155111] = "Sepolia";
+    SupportedChain[SupportedChain["Base"] = 8453] = "Base";
+    SupportedChain[SupportedChain["Bsc"] = 56] = "Bsc";
+    SupportedChain[SupportedChain["BscTestnet"] = 97] = "BscTestnet";
+    SupportedChain[SupportedChain["OdysseyTestnet"] = 131313] = "OdysseyTestnet";
+    SupportedChain[SupportedChain["Odyssey"] = 153153] = "Odyssey";
+    SupportedChain[SupportedChain["Polygon"] = 137] = "Polygon";
+    SupportedChain[SupportedChain["PolygonAmoy"] = 80002] = "PolygonAmoy";
+})(SupportedChain || (SupportedChain = {}));
+export function parseSupportedChain(chainId) {
+    switch (chainId) {
+        case 1:
+            return SupportedChain.Mainnet;
+        case 11155111:
+            return SupportedChain.Sepolia;
+        case 8453:
+            return SupportedChain.Base;
+        case 56:
+            return SupportedChain.Bsc;
+        case 97:
+            return SupportedChain.BscTestnet;
+        case 131313:
+            return SupportedChain.OdysseyTestnet;
+        case 153153:
+            return SupportedChain.Odyssey;
+        case 137:
+            return SupportedChain.Polygon;
+        case 80002:
+            return SupportedChain.PolygonAmoy;
+        default:
+            throw new Error(`Chain Id: ${chainId} not supported.`);
+    }
+}
+/**
+ * Odyssey chain ids
+ */
+export const ODYSSEY_CHAIN_IDS = [
+    SupportedChain.Odyssey,
+    SupportedChain.OdysseyTestnet,
+];
+export const ZEBEC_EVM_CARD_ADDRESS = {
+    [SupportedChain.Sepolia]: "0xD0e8f23ACcC1a7147Fb17E078A5cbe7ff1F47407",
+    [SupportedChain.Base]: "0x1bF6419D8555EafaE79142D309534e8aBd54aBa3",
+    [SupportedChain.Mainnet]: "0xB4f6E946E12200F4E0ba3B352B8DbF0a66635b53",
+    [SupportedChain.Bsc]: "0x1bF6419D8555EafaE79142D309534e8aBd54aBa3",
+    [SupportedChain.BscTestnet]: "0x53E1Ffb703298744670a7Fd341F90AC7949D7516",
+    [SupportedChain.OdysseyTestnet]: "0x597fA3656FF24034939edce2d74480c0619F51A7",
+    [SupportedChain.Odyssey]: "0x935D149eCB4E3F3824327e7d4357180a08aE8a15",
+    [SupportedChain.Polygon]: "0xB4f6E946E12200F4E0ba3B352B8DbF0a66635b53",
+    [SupportedChain.PolygonAmoy]: "0xB4f6E946E12200F4E0ba3B352B8DbF0a66635b53",
+};
+export const USDC_ADDRESS = {
+    [SupportedChain.Sepolia]: "0x94a9D9AC8a22534E3FaCa9F4e7F2E2cf85d5E4C8",
+    [SupportedChain.Base]: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    [SupportedChain.Mainnet]: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    [SupportedChain.Bsc]: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
+    [SupportedChain.BscTestnet]: "0xF8Dc6f35a10244213096D86c376491042594a84e",
+    [SupportedChain.OdysseyTestnet]: "0x1bF6419D8555EafaE79142D309534e8aBd54aBa3",
+    [SupportedChain.Odyssey]: "0x8aBEE32587864cce7000e6f2820680874eD6100A",
+    [SupportedChain.Polygon]: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+    [SupportedChain.PolygonAmoy]: "0x935d149ecb4e3f3824327e7d4357180a08ae8a15",
+};
+export const WETH_ADDRESS = {
+    [SupportedChain.Sepolia]: "0x7b79995e5f793A07Bc00c21412e50Ecae098E7f9",
+    [SupportedChain.Base]: "0x4200000000000000000000000000000000000006",
+    [SupportedChain.Bsc]: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c",
+    [SupportedChain.BscTestnet]: "0x094616F0BdFB0b526bD735Bf66Eca0Ad254ca81F",
+    [SupportedChain.Mainnet]: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+    [SupportedChain.OdysseyTestnet]: "0xF21Cbaf7bD040D686Bd390957770D2ea652E4013",
+    [SupportedChain.Odyssey]: "0xF21Cbaf7bD040D686Bd390957770D2ea652E4013",
+    [SupportedChain.Polygon]: "0x0000000000000000000000000000000000001010",
+    [SupportedChain.PolygonAmoy]: "0x0000000000000000000000000000000000000000",
+};
+export const DEFAULT_GAS_LIMIT = 3000000; // Default gas limit for transactions
+export const SUI_SILVERCARD_PACKAGE_ADDRESS = {
+    devnet: "0x6f2c14f388f357c3820464b7c22a0ff7ad36f6b9a5ebdbfffe3a14d1f0efc95c",
+    mainnet: "0xec2d5a4ca1fba9385301d858253a2a07c5bba566c041cc7433e3c77b42f679ea",
+    testnet: "0xfe1c8009a32922998c9f8ac3481bf5f7c5aa0b6e4556a18c5727ae5c4dcab92c",
+};
+export const SUI_SILVERCARD_MODULE_NAME = "sui_silver_card_contract";
+export const SUI_SILVERCARD_CARD_CONFIG_OBJECT_ID = {
+    devnet: "0xc3c5e0e713713d5b3e0f259c68e1087ecb69162d61e9482753f0df8312adcb3b",
+    mainnet: "0x86951e397bd073eafc1f3cc4dda0f44efb6fd32ad00ea097a336ae7cf530e4ff",
+    testnet: "0xc5dc55b550b9d1ec7edca3d66428a56fe3c743f0cf08ead476d86ac0ef9fb44c",
+};
+export const SUI_SILVERCARD_FEE_TIER_LIST_OBJECT_ID = {
+    devnet: "0x2a6daec8090c5194dca6f44c7dec9806c53a27235c34110989b0538e30868f60",
+    mainnet: "0x07a5844cae13e02762ee72605a574404642f3538f2c520677c0032b996193a33",
+    testnet: "0x2ccc98c504a62804cb9db6c2f95ad5e09855f33f5282c430de069356ba88abab",
+};
+export const SUI_SILVERCARD_SWAP_FEE_LIST_OBJECT_ID = {
+    devnet: "0x49bffe8c49cebcc25ca7b5c6c2c88fb94926f1cb45d7e126780932e63d8043b4",
+    mainnet: "0x492d3bc81be1b2fc1f800f757ae159552284036eacf45103b2d925e9a00d3456",
+    testnet: "0xee0a756e0d508a47dc8057d91a1fb1eb32c25ce98b8ef7b4fe86d3784218f9ec",
+};
+export const SUI_SILVERCARD_ADMIN_CAP_STRUCT_TYPE = {
+    devnet: "0x6f2c14f388f357c3820464b7c22a0ff7ad36f6b9a5ebdbfffe3a14d1f0efc95c::sui_silver_card_contract::AdminCap",
+    mainnet: "0xec2d5a4ca1fba9385301d858253a2a07c5bba566c041cc7433e3c77b42f679ea::sui_silver_card_contract::AdminCap",
+    testnet: "0xfe1c8009a32922998c9f8ac3481bf5f7c5aa0b6e4556a18c5727ae5c4dcab92c::sui_silver_card_contract::AdminCap",
+};
+export const SUI_USDC_COIN_TYPE = {
+    devnet: "0x46f30b27bdbdd02b003f7c8db8dfc83488f7b8f7f8eef06d9434eeff7c4655c3::sui_generic_coins::SUI_GENERIC_COINS",
+    mainnet: "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
+    testnet: "0x03cea04319a0015e35e7a9dae0f046643e8fbbf29922aad31a5ffd9a9c3e76f4::sui_generic_coins::SUI_GENERIC_COINS",
+};

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./artifacts/index.js";
+export * from "./constants.js";
+export * from "./pda.js";
+export * from "./services/index.js";
+export * from "./types.js";
+export * from "./utils.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./artifacts/index.js";
+export * from "./constants.js";
+export * from "./pda.js";
+export * from "./services/index.js";
+export * from "./types.js";
+export * from "./utils.js";

package/dist/pda.d.ts

@@ -0,0 +1,23 @@
+import { type Address } from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+import { Buffer } from "buffer";
+export declare function deriveStreamConfigPda(configName: string, programId: Address): [PublicKey, number];
+export declare function deriveStreamVaultPda(metatadata: Address, programId: Address): [PublicKey, number];
+export declare function deriveProxyConfigPda(chainId: string, programId: Address): [PublicKey, number];
+export declare function deriveMintAuthorityPda(programId: Address): [PublicKey, number];
+export declare function deriveCheckAccountPda(hash: Buffer | Uint8Array, programId: Address): [PublicKey, number];
+export declare function deriveUserPda(chainId: string, walletHash: Buffer | Uint8Array, programId: Address): [PublicKey, number];
+export declare function deriveUserVaultPda(userPda: PublicKey, programId: Address): [PublicKey, number];
+export declare function deriveStakeAddress(staker: Address, lockup: Address, nonce: bigint, programId: Address): PublicKey;
+export declare function deriveLockupAddress(name: string, programId: Address): PublicKey;
+export declare function deriveUserNonceAddress(user: Address, lockup: Address, programId: Address): PublicKey;
+export declare function deriveStakeVaultAddress(lockup: Address, programId: Address): PublicKey;
+export declare function deriveRewardVaultAddress(lockup: Address, programId: Address): PublicKey;
+export declare function deriveCardConfigPda(programId: Address): [PublicKey, number];
+export declare function derivePartnerCardConfigPda(programId: Address, partnershipName: string): [PublicKey, number];
+export declare function deriveTokenFeeMapPda(programId: Address): [PublicKey, number];
+export declare function derivePartnerTokenFeeMapPda(cardPda: Address, programId: Address): [PublicKey, number];
+export declare function deriveCardPurchasePda(buyer: Address, buyerCounter: bigint, programId: Address): [PublicKey, number];
+export declare function derivePartnerCardPurchasePda(buyer: Address, cardPda: Address, buyerCounter: bigint, programId: Address): [PublicKey, number];
+export declare function deriveUserPurchaseRecordPda(user: Address, programId: Address): [PublicKey, number];
+export declare function derivePartnerUserPurchaseRecordPda(user: Address, cardPda: Address, programId: Address): [PublicKey, number];

package/dist/pda.js

@@ -0,0 +1,125 @@
+import { translateAddress, utils } from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+import BN from "bn.js";
+import { Buffer } from "buffer";
+const STREAM_PROGRAM_SEEDS = {
+    STREAM_CONFIG: utils.bytes.utf8.encode("config"),
+};
+export function deriveStreamConfigPda(configName, programId) {
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(STREAM_PROGRAM_SEEDS.STREAM_CONFIG),
+        utils.bytes.utf8.encode(configName),
+    ], translateAddress(programId));
+}
+export function deriveStreamVaultPda(metatadata, programId) {
+    return PublicKey.findProgramAddressSync([translateAddress(metatadata).toBuffer()], translateAddress(programId));
+}
+const PROXY_STREAM_PROGRAM_SEEDS = {
+    PROXY_CONFIG: utils.bytes.utf8.encode("proxy"),
+    MINT_AUTHORITY: utils.bytes.utf8.encode("ztoken_minter"),
+};
+export function deriveProxyConfigPda(chainId, programId) {
+    return PublicKey.findProgramAddressSync([PROXY_STREAM_PROGRAM_SEEDS.PROXY_CONFIG, Buffer.from(chainId)], translateAddress(programId));
+}
+export function deriveMintAuthorityPda(programId) {
+    return PublicKey.findProgramAddressSync([PROXY_STREAM_PROGRAM_SEEDS.MINT_AUTHORITY], translateAddress(programId));
+}
+export function deriveCheckAccountPda(hash, programId) {
+    return PublicKey.findProgramAddressSync([Buffer.from(hash)], translateAddress(programId));
+}
+export function deriveUserPda(chainId, walletHash, programId) {
+    return PublicKey.findProgramAddressSync([Buffer.from(chainId), Buffer.from(walletHash)], translateAddress(programId));
+}
+export function deriveUserVaultPda(userPda, programId) {
+    return PublicKey.findProgramAddressSync([userPda.toBuffer()], translateAddress(programId));
+}
+const STAKE_PROGRAM_SEEDS = {
+    LOCKUP: "zebec_lockup",
+    STAKE_VAULT: "stake_vault",
+    REWARD_VAULT: "reward_vault",
+};
+export function deriveStakeAddress(staker, lockup, nonce, programId) {
+    const [stakeAddress] = PublicKey.findProgramAddressSync([
+        translateAddress(staker).toBuffer(),
+        translateAddress(lockup).toBuffer(),
+        new BN(nonce.toString()).toArrayLike(Buffer, "le", 8),
+    ], translateAddress(programId));
+    return stakeAddress;
+}
+export function deriveLockupAddress(name, programId) {
+    const [lockupAddress] = PublicKey.findProgramAddressSync([
+        utils.bytes.utf8.encode(STAKE_PROGRAM_SEEDS.LOCKUP),
+        utils.bytes.utf8.encode(name),
+    ], translateAddress(programId));
+    return lockupAddress;
+}
+export function deriveUserNonceAddress(user, lockup, programId) {
+    const [userNonceAddress] = PublicKey.findProgramAddressSync([translateAddress(user).toBuffer(), translateAddress(lockup).toBuffer()], translateAddress(programId));
+    return userNonceAddress;
+}
+export function deriveStakeVaultAddress(lockup, programId) {
+    const [stakeVault] = PublicKey.findProgramAddressSync([
+        utils.bytes.utf8.encode(STAKE_PROGRAM_SEEDS.STAKE_VAULT),
+        translateAddress(lockup).toBuffer(),
+    ], translateAddress(programId));
+    return stakeVault;
+}
+export function deriveRewardVaultAddress(lockup, programId) {
+    const [rewardVault] = PublicKey.findProgramAddressSync([
+        utils.bytes.utf8.encode(STAKE_PROGRAM_SEEDS.REWARD_VAULT),
+        translateAddress(lockup).toBuffer(),
+    ], translateAddress(programId));
+    return rewardVault;
+}
+const CARD_PROGRAM_V2_SEEDS = {
+    CARD_CONFIG: "card_config",
+    TOKEN_FEE_MAP: "token_fee_map",
+    USER_CARD_PURCHASE: "user_card_purchase",
+    USER_PURCHASE_RECORD: "user_purchase_record",
+};
+export function deriveCardConfigPda(programId) {
+    return PublicKey.findProgramAddressSync([Buffer.from(utils.bytes.utf8.encode(CARD_PROGRAM_V2_SEEDS.CARD_CONFIG))], translateAddress(programId));
+}
+export function derivePartnerCardConfigPda(programId, partnershipName) {
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(utils.bytes.utf8.encode(CARD_PROGRAM_V2_SEEDS.CARD_CONFIG)),
+        Buffer.from(utils.bytes.utf8.encode(partnershipName)),
+    ], translateAddress(programId));
+}
+export function deriveTokenFeeMapPda(programId) {
+    return PublicKey.findProgramAddressSync([Buffer.from(utils.bytes.utf8.encode(CARD_PROGRAM_V2_SEEDS.TOKEN_FEE_MAP))], translateAddress(programId));
+}
+export function derivePartnerTokenFeeMapPda(cardPda, programId) {
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(utils.bytes.utf8.encode(CARD_PROGRAM_V2_SEEDS.TOKEN_FEE_MAP)),
+        translateAddress(cardPda).toBuffer(),
+    ], translateAddress(programId));
+}
+export function deriveCardPurchasePda(buyer, buyerCounter, programId) {
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(utils.bytes.utf8.encode(CARD_PROGRAM_V2_SEEDS.USER_CARD_PURCHASE)),
+        translateAddress(buyer).toBuffer(),
+        new BN(buyerCounter.toString()).toArrayLike(Buffer, "le", 8),
+    ], translateAddress(programId));
+}
+export function derivePartnerCardPurchasePda(buyer, cardPda, buyerCounter, programId) {
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(utils.bytes.utf8.encode(CARD_PROGRAM_V2_SEEDS.USER_CARD_PURCHASE)),
+        translateAddress(buyer).toBuffer(),
+        translateAddress(cardPda).toBuffer(),
+        new BN(buyerCounter.toString()).toArrayLike(Buffer, "le", 8),
+    ], translateAddress(programId));
+}
+export function deriveUserPurchaseRecordPda(user, programId) {
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(utils.bytes.utf8.encode(CARD_PROGRAM_V2_SEEDS.USER_PURCHASE_RECORD)),
+        translateAddress(user).toBuffer(),
+    ], translateAddress(programId));
+}
+export function derivePartnerUserPurchaseRecordPda(user, cardPda, programId) {
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(utils.bytes.utf8.encode(CARD_PROGRAM_V2_SEEDS.USER_PURCHASE_RECORD)),
+        translateAddress(user).toBuffer(),
+        translateAddress(cardPda).toBuffer(),
+    ], translateAddress(programId));
+}

package/dist/services/evmCardService.d.ts

@@ -0,0 +1,189 @@
+import { ethers } from "ethers";
+import { type OdysseyZebecCard, type Token, type Weth, type ZebecCard } from "../artifacts/index.js";
+import type { CardFeeTier, CardPurchaseOfDay, EvmCardConfig } from "../types";
+export declare class ZebecCardService {
+    readonly signer: ethers.Signer;
+    readonly chainId: number;
+    readonly zebecCard: ZebecCard | OdysseyZebecCard;
+    readonly usdcToken: Token;
+    readonly weth: Weth;
+    /**
+     * Create instance of ZebecCardService.
+     * @param signer ethers signer
+     * @param chainId chain ID supported by sdk
+     */
+    constructor(signer: ethers.Signer, chainId: number);
+    /**
+     *	Sets Native Fee in card config.
+     *
+     *  Can only be invoked admin.
+     *
+     * @param params
+     * @returns
+     */
+    setNativeFee(params: {
+        feeInPercent: string;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    /**
+     * Sets NonNative Fee in card config
+     *
+     * Can only be invoked admin.
+     *
+     * @param params
+     * @returns
+     */
+    setNonNativeFee(params: {
+        feeInPercent: string;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    /**
+     * Sets Revenue Fee in card config
+     *
+     * Can only be invoked admin.
+     *
+     * @param params
+     * @returns
+     */
+    setRevenueFee(params: {
+        feeInPercent: string;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    /**
+     * Sets Revenue vault address in card config
+     *
+     * Can only be invoked admin.
+     *
+     * @param params
+     * @returns
+     */
+    setRevenueVault(params: {
+        vaultAddress: ethers.AddressLike;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    /**
+     * Sets commission vault address in card config
+     *
+     * Can only be invoked admin.
+     *
+     * @param params
+     * @returns
+     */
+    setCommissionVault(params: {
+        vaultAddress: ethers.AddressLike;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    /**
+     * Sets card vault address in card config
+     *
+     * Can only be invoked admin.
+     *
+     */
+    setCardVault(params: {
+        vaultAddress: ethers.AddressLike;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    /**
+     * Sets usdc address in card config
+     * Can only be invoked by admin
+     */
+    setUsdcAddress(params: {
+        tokenAddress: ethers.AddressLike;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    /**
+     * Sets minimum card amount for purchasing card in card config
+     */
+    setMinCardAmount(params: {
+        minCardAmount: string;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    /**
+     * Sets maximum card amount for purchasing card  in card config
+     */
+    setMaxCardAmount(params: {
+        maxCardAmount: string;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    /**
+     * Sets daily card purchase limit in card config
+     */
+    setDailyCardPurchaseLimit(params: {
+        dailyCardPurchaseLimit: string;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    /**
+     * Updates fee for given min - max (range) amount and inserts if range in not found.
+     */
+    setFee(params: {
+        minAmount: string;
+        maxAmount: string;
+        feePercent: string;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    /**
+     * Sets fee tiers only be invoked by admin
+     */
+    setFeeTiers(params: {
+        feeTiers: CardFeeTier[];
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    private _parseFeeTiers;
+    setCustomFee(params: {
+        tokenAddress: string;
+        fee: number | string;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    getCustomFee(params: {
+        tokenAddress: string;
+        overrides?: ethers.Overrides;
+    }): Promise<string>;
+    setReloadableFee(params: {
+        fee: string | number;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+    getReloadableFee(): Promise<string>;
+    /**
+     * Gets user's card purchase
+     * @param params
+     * @returns
+     */
+    getCardPurhcaseOfDay(params: {
+        userAddress: ethers.AddressLike;
+    }): Promise<CardPurchaseOfDay>;
+    /**
+     * Gets Zebec Instant Card contract configs
+     * @returns
+     */
+    getCardConfig(): Promise<EvmCardConfig>;
+    /**
+     * Gets fee tiers
+     * @returns Array of fee tier
+     */
+    getFeeTiers(): Promise<Array<CardFeeTier>>;
+    /**
+     * Gets admin adddress
+     * @returns
+     */
+    getAdmin(): Promise<string>;
+    /**
+     * add allowance of given amount of given token to given spender
+     * @param params
+     * @returns
+     */
+    approve(params: {
+        token: string;
+        spender: ethers.AddressLike;
+        amount: string;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse | null>;
+    /**
+     * Wrap ETH to Wrapped ETH
+     * @param param
+     * @returns
+     */
+    wrapEth(params: {
+        amount: string;
+        overrides?: ethers.Overrides;
+    }): Promise<ethers.ContractTransactionResponse>;
+}