@lifi/types 10.0.0-beta.1 → 10.1.0

package/README.md

@@ -1,31 +1,9 @@
-<div align="center">
+### Installation
 
-[![license](https://img.shields.io/badge/license-Apache%202-blue)](/LICENSE.md)
-[![npm latest package](https://img.shields.io/npm/v/@lifi/types/latest.svg)](https://www.npmjs.com/package/@lifi/types)
-[![npm downloads](https://img.shields.io/npm/dm/@lifi/types.svg)](https://www.npmjs.com/package/@lifi/types)
-[![Follow on Twitter](https://img.shields.io/twitter/follow/lifiprotocol.svg?label=follow+LI.FI)](https://twitter.com/lifiprotocol)
-
-</div>
-
-# LI.FI - Types
-
-Types for the LI.FI stack.
-
-## Summary
-
-This package contains all common types for the [LI.FI SDK](https://github.com/lifinance/sdk).
-Learn more about LI.FI on (https://li.fi).
-
-Check out the [Changelog](./CHANGELOG.md) to see what changed in the last releases.
-
-## Installation
-
-```bash
-yarn add @lifi/types
 ```
-
-or
-
-```bash
 npm install --save @lifi/types
 ```
+
+### Summary
+
+This package contains type definitions for LI.FI projects (https://github.com/lifinance).

package/{src/_types → dist}/api.d.ts

@@ -1,31 +1,6 @@
-import type { BridgeDefinition } from './bridges.js';
-import type { Chain, ChainId, ChainKey, ChainType } from './chains/index.js';
-import type { ExchangeDefinition } from './exchanges.js';
-import type { Action, LiFiStep } from './step.js';
-import type { Token } from './tokens/index.js';
-/**
- * Used as a bigint replacement for TransactionRequest because bigint is not serializable
- */
-export type BigIntish = string;
-export type TransactionRequest = {
-    to?: string;
-    from?: string;
-    nonce?: number;
-    gasLimit?: BigIntish;
-    gasPrice?: BigIntish;
-    data?: string;
-    value?: BigIntish;
-    chainId?: number;
-    type?: number;
-    accessList?: {
-        address: string;
-        storageKeys: string[];
-    }[];
-    maxPriorityFeePerGas?: BigIntish;
-    maxFeePerGas?: BigIntish;
-    customData?: Record<string, any>;
-    ccipReadEnabled?: boolean;
-};
+import { TransactionRequest } from '@ethersproject/providers';
+import { BridgeDefinition, Chain, ChainId, ChainKey, ChainType, ExchangeDefinition, LifiStep, Token } from '.';
+import { ToolError } from './apiErrors';
 export declare const Orders: readonly ["RECOMMENDED", "FASTEST", "CHEAPEST", "SAFEST"];
 export type Order = (typeof Orders)[number];
 export interface RoutesRequest {
@@ -40,17 +15,18 @@ export interface RoutesRequest {
     fromAmountForGas?: string;
 }
 export interface RouteOptions {
-    integrator?: string;
-    fee?: number;
-    insurance?: boolean;
-    maxPriceImpact?: number;
     order?: Order;
     slippage?: number;
-    referrer?: string;
+    infiniteApproval?: boolean;
     allowSwitchChain?: boolean;
+    integrator?: string;
     allowDestinationCall?: boolean;
+    referrer?: string;
     bridges?: AllowDenyPrefer;
     exchanges?: AllowDenyPrefer;
+    fee?: number;
+    insurance?: boolean;
+    maxPriceImpact?: number;
 }
 export type ToolsResponse = {
     exchanges: {
@@ -96,17 +72,10 @@ export interface Route {
     toAddress?: string;
     gasCostUSD?: string;
     containsSwitchChain?: boolean;
-    steps: LiFiStep[];
+    infiniteApproval?: boolean;
+    steps: LifiStep[];
     tags?: Order[];
 }
-export type ToolErrorType = 'NO_QUOTE';
-export interface ToolError {
-    errorType: ToolErrorType;
-    code: string;
-    action: Action;
-    tool: string;
-    message: string;
-}
 export type ErroredPaths = {
     [subpath: string]: ToolError[];
 };
@@ -258,6 +227,7 @@ export interface ExtendedTransactionInfo extends BaseTransactionInfo {
     gasAmount: string;
     gasAmountUSD: string;
     timestamp?: number;
+    value?: string;
 }
 export interface PendingReceivingInfo {
     chainId: ChainId;
@@ -269,7 +239,7 @@ export type SubstatusPending = (typeof _SubstatusPending)[number];
 declare const _SubstatusDone: readonly ["COMPLETED", "PARTIAL", "REFUNDED"];
 export type SubstatusDone = (typeof _SubstatusDone)[number];
 export type Substatus = SubstatusPending | SubstatusDone;
-export declare const isSubstatusPending: (substatus: Substatus) => substatus is "WAIT_SOURCE_CONFIRMATIONS" | "WAIT_DESTINATION_TRANSACTION" | "BRIDGE_NOT_AVAILABLE" | "CHAIN_NOT_AVAILABLE" | "NOT_PROCESSABLE_REFUND_NEEDED" | "REFUND_IN_PROGRESS" | "UNKNOWN_ERROR";
+export declare const isSubstatusPending: (substatus: Substatus) => substatus is "UNKNOWN_ERROR" | "WAIT_SOURCE_CONFIRMATIONS" | "WAIT_DESTINATION_TRANSACTION" | "BRIDGE_NOT_AVAILABLE" | "CHAIN_NOT_AVAILABLE" | "NOT_PROCESSABLE_REFUND_NEEDED" | "REFUND_IN_PROGRESS";
 export declare const isSubstatusDone: (substatus: Substatus) => substatus is "COMPLETED" | "PARTIAL" | "REFUNDED";
 export interface BaseStatusData {
     status: StatusMessage;
@@ -282,6 +252,9 @@ export interface StatusData extends BaseStatusData {
     receiving: PendingReceivingInfo;
 }
 export type StatusResponse = FullStatusData | StatusData;
+interface TransferMetadata {
+    integrator: string;
+}
 export interface FullStatusData extends StatusData {
     transactionId: string;
     sending: ExtendedTransactionInfo;
@@ -289,6 +262,7 @@ export interface FullStatusData extends StatusData {
     lifiExplorerLink: string;
     fromAddress: string;
     toAddress: string;
+    metadata: TransferMetadata;
     bridgeExplorerLink?: string;
 }
 export interface ExtendedChain extends Chain {
@@ -370,15 +344,13 @@ export type GasRecommendationResponse = {
     fromToken?: Token;
     fromAmount?: string;
 };
-export interface TransactionAnalyticsResponse {
-    transfers: StatusResponse[];
+export interface WalletAnalytics {
+    walletAddress: string;
+    transactions: StatusResponse[];
 }
-export type TransactionAnalyticsStatus = Exclude<StatusMessage, 'NOT_FOUND' | 'INVALID'> | 'ALL';
-export interface TransactionAnalyticsRequest {
-    wallet: string;
-    fromTimestamp?: number;
-    toTimestamp?: number;
-    status?: TransactionAnalyticsStatus;
+export interface WalletAnalyticsRequest {
+    walletAddress: string;
+    fromTimestamp: number;
+    toTimestamp: number;
 }
 export {};
-//# sourceMappingURL=api.d.ts.map

package/{src/_esm → dist}/api.js

@@ -45,4 +45,3 @@ const _SubstatusDone = [
 export const isSubstatusPending = (substatus) => _SubstatusPending.includes(substatus);
 export const isSubstatusDone = (substatus) => _SubstatusDone.includes(substatus);
 const _LIFuelState = ['PENDING', 'DONE', 'NOT_FOUND'];
-//# sourceMappingURL=api.js.map

package/{src/_types/errors.d.ts → dist/apiErrors.d.ts}

@@ -1,3 +1,12 @@
+import { Action } from './step';
+export type ToolErrorType = 'NO_QUOTE';
+export interface ToolError {
+    errorType: ToolErrorType;
+    code: string;
+    action: Action;
+    tool: string;
+    message: string;
+}
 export declare enum ErrorCode {
     DefaultError = 1000,
     FailedToBuildTransactionError = 1001,
@@ -12,4 +21,3 @@ export declare enum ErrorCode {
     UnauthorizedError = 1010,
     ValidationError = 1011
 }
-//# sourceMappingURL=errors.d.ts.map

package/{src/_esm/errors.js → dist/apiErrors.js}

@@ -14,4 +14,3 @@ export var ErrorCode;
     ErrorCode[ErrorCode["UnauthorizedError"] = 1010] = "UnauthorizedError";
     ErrorCode[ErrorCode["ValidationError"] = 1011] = "ValidationError";
 })(ErrorCode || (ErrorCode = {}));
-//# sourceMappingURL=errors.js.map

package/dist/base.d.ts

@@ -0,0 +1,231 @@
+import { BridgeTool } from './bridges';
+import { ExchangeTools } from './exchanges';
+export declare enum CoinKey {
+    ETH = "ETH",
+    MATIC = "MATIC",
+    BNB = "BNB",
+    DAI = "DAI",
+    FTM = "FTM",
+    OKT = "OKT",
+    AVAX = "AVAX",
+    HT = "HT",
+    ONE = "ONE",
+    FSN = "FSN",
+    MOVR = "MOVR",
+    EXP = "EXP",
+    TCH = "TCH",
+    UBQ = "UBQ",
+    META = "META",
+    DIODE = "DIODE",
+    CELO = "CELO",
+    FUSE = "FUSE",
+    TLOS = "TLOS",
+    CRO = "CRO",
+    SHIB = "SHIB",
+    L1 = "L1",
+    RBTC = "RBTC",
+    TBG = "TBG",
+    VLX = "VLX",
+    GLMR = "GLMR",
+    METIS = "METIS",
+    SOL = "SOL",
+    EVM = "EVM",
+    USDT = "USDT",
+    USDC = "USDC",
+    cbtUSDC = "cbtUSDC",
+    cbtUSDT = "cbtUSDT",
+    cbtWUSDT = "cbtWUSDT",
+    cbtWUSDC = "cbtWUSDC",
+    cbtCELR = "cbtCELR",
+    BUSD = "BUSD",
+    USDCe = "USDCe",
+    TEST = "TEST",
+    KAL = "KAL",
+    SDIODE = "SDIODE",
+    SPARK = "SPARK",
+    TRBTC = "TRBTC",
+    CXTT = "CXTT",
+    sgMETIS = "sgMETIS",
+    sgWOO = "sgWOO",
+    sgUSDT = "sgUSDT",
+    sgBUSD = "sgBUSD",
+    sgUSDC = "sgUSDC",
+    WBTC = "WBTC",
+    WETH = "WETH",
+    SUSHI = "SUSHI",
+    DODO = "DODO",
+    MCB = "MCB",
+    CELR = "CELR",
+    IF = "IF"
+}
+export declare enum ChainKey {
+    ETH = "eth",
+    POL = "pol",
+    BSC = "bsc",
+    DAI = "dai",
+    OKT = "okt",
+    FTM = "ftm",
+    AVA = "ava",
+    ARB = "arb",
+    HEC = "hec",
+    OPT = "opt",
+    ONE = "one",
+    FSN = "fsn",
+    MOR = "mor",
+    EXP = "exp",
+    TCH = "tch",
+    UBQ = "ubq",
+    MET = "met",
+    DIO = "dio",
+    CEL = "cel",
+    FUS = "fus",
+    TLO = "tlo",
+    CRO = "cro",
+    BOB = "bob",
+    SHI = "shi",
+    GL1 = "gl1",
+    RSK = "rsk",
+    TBW = "tbw",
+    VEL = "vel",
+    MOO = "moo",
+    MAM = "mam",
+    AUR = "aur",
+    TER = "ter",
+    OAS = "oas",
+    SOL = "sol",
+    EVM = "evm",
+    ARN = "arn",
+    ERA = "era",
+    PZE = "pze",
+    LNA = "lna",
+    BAS = "bas",
+    GOR = "gor",
+    METT = "mett",
+    DIOT = "diot",
+    MUM = "mum",
+    ARBG = "arbg",
+    OPTG = "optg",
+    BSCT = "bsct",
+    HECT = "hect",
+    ONET = "onet",
+    FUST = "fust",
+    TLOT = "tlot",
+    RSKT = "rskt",
+    SOLT = "solt",
+    OAST = "oast",
+    TERT = "tert",
+    AVAT = "avat",
+    EVMT = "evmt",
+    MORT = "mort",
+    FTMT = "ftmt",
+    LNAT = "lnat"
+}
+export declare enum ChainId {
+    ETH = 1,
+    POL = 137,
+    BSC = 56,
+    DAI = 100,
+    OKT = 66,
+    FTM = 250,
+    AVA = 43114,
+    ARB = 42161,
+    HEC = 128,
+    OPT = 10,
+    ONE = 1666600000,
+    FSN = 32659,
+    MOR = 1285,
+    EXP = 2,
+    TCH = 7,
+    UBQ = 8,
+    MET = 11,
+    DIO = 15,
+    CEL = 42220,
+    FUS = 122,
+    TLO = 40,
+    CRO = 25,
+    BOB = 288,
+    SHI = 27,
+    GL1 = 29,
+    RSK = 30,
+    TBW = 35,
+    VEL = 106,
+    MOO = 1284,
+    MAM = 1088,
+    AUR = 1313161554,
+    SOL = 1151111081099710,
+    TER = 1161011141099710,
+    OAS = 111971151099710,
+    EVM = 9001,
+    ARN = 42170,
+    ERA = 324,
+    PZE = 1101,
+    LNA = 59144,
+    BAS = 8453,
+    GOR = 5,
+    METT = 12,
+    DIOT = 13,
+    MUM = 80001,
+    ARBG = 421613,
+    OPTG = 420,
+    BSCT = 97,
+    HECT = 256,
+    ONET = 1666700000,
+    FUST = 123,
+    TLOT = 41,
+    RSKT = 31,
+    SOLT = 1151111081161011,
+    TERT = 1161011141161011,
+    OAST = 1119711511610111,
+    AVAT = 43113,
+    EVMT = 9000,
+    MORT = 1287,
+    FTMT = 4002,
+    LNAT = 59140
+}
+export interface BaseToken {
+    chainId: ChainId;
+    address: string;
+}
+export interface StaticToken extends BaseToken {
+    symbol: string;
+    decimals: number;
+    name: string;
+    coinKey?: CoinKey;
+    logoURI?: string;
+}
+export interface Token extends StaticToken {
+    priceUSD: string;
+}
+export interface TokenAmount extends Token {
+    amount: string;
+    blockNumber?: number;
+}
+export interface Coin {
+    key: CoinKey;
+    name: string;
+    logoURI: string;
+    verified: boolean;
+    chains: {
+        [ChainId: string]: StaticToken;
+    };
+}
+export interface ExchangeDefinition {
+    tool: ExchangeTools;
+    chains: number[];
+}
+/**
+ * Should not be accessed via the types package anymore
+ * @deprecated
+ */
+export interface BridgeDefinition {
+    tool: BridgeTool;
+    fromChainId: number;
+    fromToken: BaseToken;
+    toChainId: number;
+    toToken: BaseToken;
+    maximumTransfer: string;
+    minimumTransfer: string;
+    swapFeeRate: string;
+    swapFeeMinimum: string;
+    swapFeeMaximum: string;
+}

package/{src/_esm/chains → dist}/base.js

@@ -1,3 +1,66 @@
+export var CoinKey;
+(function (CoinKey) {
+    CoinKey["ETH"] = "ETH";
+    CoinKey["MATIC"] = "MATIC";
+    CoinKey["BNB"] = "BNB";
+    CoinKey["DAI"] = "DAI";
+    CoinKey["FTM"] = "FTM";
+    CoinKey["OKT"] = "OKT";
+    CoinKey["AVAX"] = "AVAX";
+    CoinKey["HT"] = "HT";
+    CoinKey["ONE"] = "ONE";
+    CoinKey["FSN"] = "FSN";
+    CoinKey["MOVR"] = "MOVR";
+    CoinKey["EXP"] = "EXP";
+    CoinKey["TCH"] = "TCH";
+    CoinKey["UBQ"] = "UBQ";
+    CoinKey["META"] = "META";
+    CoinKey["DIODE"] = "DIODE";
+    CoinKey["CELO"] = "CELO";
+    CoinKey["FUSE"] = "FUSE";
+    CoinKey["TLOS"] = "TLOS";
+    CoinKey["CRO"] = "CRO";
+    CoinKey["SHIB"] = "SHIB";
+    CoinKey["L1"] = "L1";
+    CoinKey["RBTC"] = "RBTC";
+    CoinKey["TBG"] = "TBG";
+    CoinKey["VLX"] = "VLX";
+    CoinKey["GLMR"] = "GLMR";
+    CoinKey["METIS"] = "METIS";
+    CoinKey["SOL"] = "SOL";
+    CoinKey["EVM"] = "EVM";
+    // Stable coins
+    CoinKey["USDT"] = "USDT";
+    CoinKey["USDC"] = "USDC";
+    CoinKey["cbtUSDC"] = "cbtUSDC";
+    CoinKey["cbtUSDT"] = "cbtUSDT";
+    CoinKey["cbtWUSDT"] = "cbtWUSDT";
+    CoinKey["cbtWUSDC"] = "cbtWUSDC";
+    CoinKey["cbtCELR"] = "cbtCELR";
+    CoinKey["BUSD"] = "BUSD";
+    CoinKey["USDCe"] = "USDCe";
+    // Testnet
+    CoinKey["TEST"] = "TEST";
+    CoinKey["KAL"] = "KAL";
+    CoinKey["SDIODE"] = "SDIODE";
+    CoinKey["SPARK"] = "SPARK";
+    CoinKey["TRBTC"] = "TRBTC";
+    CoinKey["CXTT"] = "CXTT";
+    // stargate testnet tokens
+    CoinKey["sgMETIS"] = "sgMETIS";
+    CoinKey["sgWOO"] = "sgWOO";
+    CoinKey["sgUSDT"] = "sgUSDT";
+    CoinKey["sgBUSD"] = "sgBUSD";
+    CoinKey["sgUSDC"] = "sgUSDC";
+    // Other tokens
+    CoinKey["WBTC"] = "WBTC";
+    CoinKey["WETH"] = "WETH";
+    CoinKey["SUSHI"] = "SUSHI";
+    CoinKey["DODO"] = "DODO";
+    CoinKey["MCB"] = "MCB";
+    CoinKey["CELR"] = "CELR";
+    CoinKey["IF"] = "IF";
+})(CoinKey || (CoinKey = {}));
 export var ChainKey;
 (function (ChainKey) {
     ChainKey["ETH"] = "eth";
@@ -126,4 +189,3 @@ export var ChainId;
     ChainId[ChainId["FTMT"] = 4002] = "FTMT";
     ChainId[ChainId["LNAT"] = 59140] = "LNAT";
 })(ChainId || (ChainId = {}));
-//# sourceMappingURL=base.js.map

package/dist/bridges.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @deprecated
+ * These values are now obtainable from the LI.FI API
+ */
+export declare enum BridgeTool {
+    connext = "connext",
+    hop = "hop",
+    multichain = "multichain",
+    cbridge = "cbridge",
+    hyphen = "hyphen",
+    polygon = "polygon",
+    arbitrum = "arbitrum",
+    avalanche = "avalanche",
+    optimism = "optimism",
+    across = "across",
+    portal = "portal",
+    stargate = "stargate"
+}
+export interface Bridge {
+    key: BridgeTool;
+    name: string;
+    logoURI: string;
+    bridgeUrl?: string;
+    discordUrl?: string;
+    supportUrl?: string;
+    docsUrl?: string;
+    explorerUrl?: string;
+    analyticsUrl?: string;
+}
+/**
+ * @deprecated
+ * These values are now obtainable from the LI.FI API
+ */
+export declare const supportedBridges: Array<Bridge>;