@lifi/types 17.28.0 → 17.29.0-alpha.1

package/package.json

@@ -4,7 +4,7 @@
   "dependencies": {
     "viem": "^2.33.2"
   },
-  "version": "17.28.0",
+  "version": "17.29.0-alpha.1",
   "files": [
     "src",
     "!src/assets",

package/src/_cjs/balance/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./wallet.js"), exports);
+//# sourceMappingURL=index.js.map

package/src/_cjs/balance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../balance/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B"}

package/src/_cjs/balance/wallet.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=wallet.js.map

package/src/_cjs/balance/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../balance/wallet.ts"],"names":[],"mappings":""}

package/src/_cjs/index.js

@@ -21,4 +21,5 @@ __exportStar(require("./errors.js"), exports);
 __exportStar(require("./exchanges.js"), exports);
 __exportStar(require("./step.js"), exports);
 __exportStar(require("./tokens/index.js"), exports);
+__exportStar(require("./balance/index.js"), exports);
 //# sourceMappingURL=index.js.map

package/src/_cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAwB;AACxB,+CAA4B;AAC5B,oDAAiC;AACjC,8CAA2B;AAC3B,iDAA8B;AAC9B,4CAAyB;AACzB,oDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAwB;AACxB,+CAA4B;AAC5B,oDAAiC;AACjC,8CAA2B;AAC3B,iDAA8B;AAC9B,4CAAyB;AACzB,oDAAiC;AACjC,qDAAkC"}

package/src/_esm/balance/index.js

@@ -0,0 +1,2 @@
+export * from './wallet.js';
+//# sourceMappingURL=index.js.map

package/src/_esm/balance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../balance/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}

package/src/_esm/balance/wallet.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wallet.js.map

package/src/_esm/balance/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../balance/wallet.ts"],"names":[],"mappings":""}

package/src/_esm/index.js

@@ -5,4 +5,5 @@ export * from './errors.js';
 export * from './exchanges.js';
 export * from './step.js';
 export * from './tokens/index.js';
+export * from './balance/index.js';
 //# sourceMappingURL=index.js.map

package/src/_esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}

package/src/_types/balance/index.d.ts

@@ -0,0 +1,2 @@
+export * from './wallet.js';
+//# sourceMappingURL=index.d.ts.map

package/src/_types/balance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../balance/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}

package/src/_types/balance/wallet.d.ts

@@ -0,0 +1,100 @@
+import type { StaticToken, TokenExtended } from '../tokens/token.js';
+/**
+ * Parameters for getting wallet balance
+ */
+export interface GetWalletBalanceParams {
+    walletAddress: string;
+}
+/**
+ * Filter options for wallet balance requests
+ */
+export interface GetWalletBalanceFilter {
+    chainIds?: (string | number)[];
+    offset?: string;
+    limit?: number;
+    extended?: boolean;
+}
+/**
+ * Basic wallet token following EIP structure
+ */
+export interface WalletToken extends Omit<StaticToken, 'chainId'> {
+    amount: number;
+}
+/**
+ * Extended wallet token with pricing and metadata information
+ * Reuses TokenExtended but adapts for wallet context
+ */
+export interface WalletTokenExtended extends Omit<TokenExtended, 'chainId'> {
+    amount: number;
+}
+/**
+ * Wallet balance response following EIP structure
+ * Balances are grouped by chainId as numeric keys
+ *
+ * @example Basic response
+ * ```json
+ * {
+ *   "walletAddress": "0x742d35Cc6466C7b9d5b52b8e5d8bD9D9F4B12345",
+ *   "balances": {
+ *     "1": [
+ *       {
+ *         "address": "0x4200000000000000000000000000000000000006",
+ *         "symbol": "WETH",
+ *         "decimals": 18,
+ *         "amount": 100000000000000
+ *       },
+ *       {
+ *         "address": "0x0000000000000000000000000000000000000000",
+ *         "symbol": "ETH",
+ *         "decimals": 18,
+ *         "amount": 15965635006674968
+ *       }
+ *     ]
+ *   }
+ * }
+ * ```
+ *
+ * @example Extended response (with pricing data)
+ * ```json
+ * {
+ *   "walletAddress": "0x742d35Cc6466C7b9d5b52b8e5d8bD9D9F4B12345",
+ *   "balances": {
+ *     "1": [
+ *       {
+ *         "address": "0x0000000000000000000000000000000000000000",
+ *         "symbol": "ETH",
+ *         "decimals": 18,
+ *         "amount": 15965635006674968,
+ *         "name": "ETH",
+ *         "priceUSD": "3647.66",
+ *         "marketCapUSD": 22112274762505,
+ *         "volumeUSD24H": 67057337.09,
+ *         "fdvUSD": null,
+ *         "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
+ *       }
+ *     ]
+ *   }
+ * }
+ * ```
+ */
+export interface GetWalletBalanceResponse {
+    walletAddress: string;
+    balances: {
+        [chainId: number]: WalletToken[];
+    };
+    offset?: string;
+    limit?: number;
+}
+/**
+ * Extended wallet balance response with enhanced token information
+ * Includes pricing data, market cap, volume, and other metadata
+ */
+export interface GetWalletBalanceExtendedResponse {
+    walletAddress: string;
+    balances: {
+        [chainId: number]: WalletTokenExtended[];
+    };
+    offset?: string;
+    limit?: number;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/src/_types/balance/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../balance/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEpE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC;IAC/D,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC;IACzE,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE;QACR,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAA;KACjC,CAAA;IACD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE;QACR,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAAA;KACzC,CAAA;IACD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/src/_types/index.d.ts

@@ -5,4 +5,5 @@ export * from './errors.js';
 export * from './exchanges.js';
 export * from './step.js';
 export * from './tokens/index.js';
+export * from './balance/index.js';
 //# sourceMappingURL=index.d.ts.map

package/src/_types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}

package/src/balance/index.ts

@@ -0,0 +1 @@
+export * from './wallet.js'

package/src/balance/wallet.ts

@@ -0,0 +1,105 @@
+import type { StaticToken, TokenExtended } from '../tokens/token.js'
+
+/**
+ * Parameters for getting wallet balance
+ */
+export interface GetWalletBalanceParams {
+  walletAddress: string
+}
+
+/**
+ * Filter options for wallet balance requests
+ */
+export interface GetWalletBalanceFilter {
+  chainIds?: (string | number)[]
+  offset?: string
+  limit?: number
+  extended?: boolean
+}
+
+/**
+ * Basic wallet token following EIP structure
+ */
+export interface WalletToken extends Omit<StaticToken, 'chainId'> {
+  amount: number
+}
+
+/**
+ * Extended wallet token with pricing and metadata information
+ * Reuses TokenExtended but adapts for wallet context
+ */
+export interface WalletTokenExtended extends Omit<TokenExtended, 'chainId'> {
+  amount: number
+}
+
+/**
+ * Wallet balance response following EIP structure
+ * Balances are grouped by chainId as numeric keys
+ *
+ * @example Basic response
+ * ```json
+ * {
+ *   "walletAddress": "0x742d35Cc6466C7b9d5b52b8e5d8bD9D9F4B12345",
+ *   "balances": {
+ *     "1": [
+ *       {
+ *         "address": "0x4200000000000000000000000000000000000006",
+ *         "symbol": "WETH",
+ *         "decimals": 18,
+ *         "amount": 100000000000000
+ *       },
+ *       {
+ *         "address": "0x0000000000000000000000000000000000000000",
+ *         "symbol": "ETH",
+ *         "decimals": 18,
+ *         "amount": 15965635006674968
+ *       }
+ *     ]
+ *   }
+ * }
+ * ```
+ *
+ * @example Extended response (with pricing data)
+ * ```json
+ * {
+ *   "walletAddress": "0x742d35Cc6466C7b9d5b52b8e5d8bD9D9F4B12345",
+ *   "balances": {
+ *     "1": [
+ *       {
+ *         "address": "0x0000000000000000000000000000000000000000",
+ *         "symbol": "ETH",
+ *         "decimals": 18,
+ *         "amount": 15965635006674968,
+ *         "name": "ETH",
+ *         "priceUSD": "3647.66",
+ *         "marketCapUSD": 22112274762505,
+ *         "volumeUSD24H": 67057337.09,
+ *         "fdvUSD": null,
+ *         "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"
+ *       }
+ *     ]
+ *   }
+ * }
+ * ```
+ */
+export interface GetWalletBalanceResponse {
+  walletAddress: string
+  balances: {
+    [chainId: number]: WalletToken[]
+  }
+  offset?: string
+  limit?: number
+}
+
+/**
+ * Extended wallet balance response with enhanced token information
+ * Includes pricing data, market cap, volume, and other metadata
+ */
+export interface GetWalletBalanceExtendedResponse {
+  walletAddress: string
+  balances: {
+    [chainId: number]: WalletTokenExtended[]
+  }
+  offset?: string
+  limit?: number
+}

package/src/index.ts

@@ -5,3 +5,4 @@ export * from './errors.js'
 export * from './exchanges.js'
 export * from './step.js'
 export * from './tokens/index.js'
+export * from './balance/index.js'