@deserialize/multi-vm-wallet 1.2.21 → 1.2.23

package/dist/constant.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TRANSACTION_TYPE = exports.DefaultChains = void 0;
+const chains_1 = require("viem/chains");
 exports.DefaultChains = [{
         chainId: 123456789,
         name: "Solana Mainnet",
@@ -12,7 +13,7 @@ exports.DefaultChains = [{
             decimals: 9,
         },
         testnet: false,
-        logoUrl: "https://cryptologos.cc/logos/solana-sol-logo.png?v=040",
+        logoUrl: "https://solana.com/src/img/branding/solanaLogoMark.svg",
         vmType: "SVM"
     },
     {
@@ -26,7 +27,7 @@ exports.DefaultChains = [{
             decimals: 18,
         },
         testnet: false,
-        logoUrl: "https://cryptologos.cc/logos/ethereum-eth-logo.png?v=040",
+        logoUrl: "https://cryptologos.cc/logos/ethereum-eth-logo.svg?v=040",
         vmType: "EVM"
     }, {
         chainId: 56,
@@ -39,7 +40,7 @@ exports.DefaultChains = [{
             decimals: 18,
         },
         testnet: false,
-        logoUrl: "https://cryptologos.cc/logos/bnb-bnb-logo.png?v=040",
+        logoUrl: "https://cryptologos.cc/logos/bnb-bnb-logo.svg?v=040",
         vmType: "EVM"
     }, {
         chainId: 123456791,
@@ -68,6 +69,20 @@ exports.DefaultChains = [{
         testnet: false,
         logoUrl: "https://chainscan.0g.ai/static/media/zg-logo-new.b22d59dabf457524325ca81c29a4e055.svg",
         vmType: "EVM"
+    },
+    {
+        chainId: chains_1.base.id,
+        name: chains_1.base.name,
+        rpcUrl: chains_1.base.rpcUrls.default.http[0],
+        explorerUrl: chains_1.base.blockExplorers?.default.url || "",
+        nativeToken: {
+            name: chains_1.base.nativeCurrency.name,
+            symbol: chains_1.base.nativeCurrency.symbol,
+            decimals: chains_1.base.nativeCurrency.decimals,
+        },
+        testnet: chains_1.base.testnet,
+        logoUrl: "https://avatars.githubusercontent.com/u/108554348?s=200&v=4",
+        vmType: "EVM"
     }
 ];
 exports.TRANSACTION_TYPE = {

package/dist/constant.js.map

@@ -1 +1 @@
-{"version":3,"file":"constant.js","sourceRoot":"","sources":["../utils/constant.ts"],"names":[],"mappings":";;;AAEa,QAAA,aAAa,GAAwB,CAAC;QAC/C,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,+DAA+D;QACvE,WAAW,EAAE,6BAA6B,EAAE,uBAAuB;QACnE,WAAW,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,CAAC;SACd;QACD,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,wDAAwD;QACjE,MAAM,EAAE,KAAK;KAChB;IACK;QACF,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,uEAAuE;QAC/E,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE;YACT,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,EAAE;SACf;QACD,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,0DAA0D;QACnE,MAAM,EAAE,KAAK;KAChB,EAAE;QACC,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,yBAAyB;QAC/B,MAAM,EAAE,mCAAmC;QAC3C,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE;YACT,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,EAAE;SACf;QACD,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,qDAAqD;QAC9D,MAAM,EAAE,KAAK;KAChB,EAAE;QACC,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,qCAAqC;QAC7C,WAAW,EAAE,+BAA+B,EAAE,uBAAuB;QACrE,WAAW,EAAE;YACT,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,CAAC;SACd;QACD,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,iJAAiJ;QAC1J,MAAM,EAAE,KAAK;KAChB;IACD;QACI,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,sBAAsB;QAC9B,WAAW,EAAE,0BAA0B,EAAE,uBAAuB;QAChE,WAAW,EAAE;YACT,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,EAAE;SACf;QACD,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,uFAAuF;QAChG,MAAM,EAAE,KAAK;KAChB;CAGA,CAAA;AAEY,QAAA,gBAAgB,GAAG;IAC5B,wBAAwB;IACxB,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,oBAAoB,EAAE,sBAAsB;IAC5C,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,kBAAkB,EAAE,oBAAoB;IACxC,iBAAiB,EAAE,mBAAmB;IACtC,mBAAmB,EAAE,qBAAqB;IAC1C,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CAEZ,CAAA"}
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../utils/constant.ts"],"names":[],"mappings":"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"}

package/dist/evm/transaction.utils.d.ts

@@ -0,0 +1,362 @@
+import { type PublicClient, type Address, type Hex } from 'viem';
+/**
+ * Enum representing different transaction types
+ */
+export declare enum TransactionType {
+    tokenMethodApprove = "approve",
+    tokenMethodSetApprovalForAll = "setApprovalForAll",
+    tokenMethodTransfer = "transfer",
+    tokenMethodTransferFrom = "transferFrom",
+    tokenMethodIncreaseAllowance = "increaseAllowance",
+    tokenMethodSafeTransferFrom = "safeTransferFrom",
+    contractInteraction = "contractInteraction",
+    deployContract = "deployContract",
+    simpleSend = "simpleSend",
+    cancel = "cancel",
+    retry = "retry",
+    swap = "swap"
+}
+/**
+ * Enum representing asset types
+ */
+export declare enum AssetType {
+    native = "NATIVE",
+    token = "TOKEN",
+    NFT = "NFT",
+    unknown = "UNKNOWN"
+}
+/**
+ * Enum representing token standards
+ */
+export declare enum TokenStandard {
+    ERC20 = "ERC20",
+    ERC721 = "ERC721",
+    ERC1155 = "ERC1155",
+    none = "none"
+}
+/**
+ * Transaction parameters interface
+ */
+export interface TransactionParams {
+    from: Address;
+    to?: Address;
+    value?: bigint | string;
+    data?: Hex;
+    gas?: bigint | string;
+    gasPrice?: bigint | string;
+    maxFeePerGas?: bigint | string;
+    maxPriorityFeePerGas?: bigint | string;
+    nonce?: number;
+}
+/**
+ * Transaction metadata interface
+ */
+export interface TransactionMeta {
+    type?: TransactionType;
+    txParams: TransactionParams;
+    dappSuggestedGasFees?: {
+        gasPrice?: bigint | string;
+        maxFeePerGas?: bigint | string;
+        maxPriorityFeePerGas?: bigint | string;
+    };
+}
+/**
+ * Result of transaction type inference
+ */
+export interface InferTransactionTypeResult {
+    type: TransactionType;
+    contractCode: Hex | null;
+}
+/**
+ * Parsed approval transaction data
+ */
+export interface ParsedApprovalData {
+    amountOrTokenId?: bigint;
+    isApproveAll?: boolean;
+    isRevokeAll?: boolean;
+    name: string;
+    tokenAddress?: Address;
+    spender?: Address;
+}
+/**
+ * Token details interface
+ */
+export interface TokenDetails {
+    decimals?: number;
+    balance?: bigint;
+    symbol?: string;
+    standard?: TokenStandard;
+}
+/**
+ * Determines if a transaction uses EIP-1559 gas fields
+ *
+ * EIP-1559 transactions use maxFeePerGas and maxPriorityFeePerGas instead of gasPrice
+ *
+ * @param transactionMeta - Transaction metadata to check
+ * @returns True if transaction uses valid EIP-1559 fields
+ *
+ * @example
+ * ```typescript
+ * const isEIP1559 = isEIP1559Transaction({
+ *   txParams: {
+ *     maxFeePerGas: '0x59682f00',
+ *     maxPriorityFeePerGas: '0x3b9aca00'
+ *   }
+ * });
+ * ```
+ */
+export declare function isEIP1559Transaction(transactionMeta: TransactionMeta): boolean;
+/**
+ * Determines if a transaction uses legacy gas fields (gasPrice)
+ *
+ * Legacy transactions use gasPrice instead of EIP-1559 fields
+ *
+ * @param transactionMeta - Transaction metadata to check
+ * @returns True if transaction uses valid legacy gas fields
+ *
+ * @example
+ * ```typescript
+ * const isLegacy = isLegacyTransaction({
+ *   txParams: {
+ *     gasPrice: '0x3b9aca00'
+ *   }
+ * });
+ * ```
+ */
+export declare function isLegacyTransaction(transactionMeta: TransactionMeta): boolean;
+/**
+ * Checks if transaction gas fees match dApp suggested fees
+ *
+ * Useful for determining if the user has modified the dApp's suggested gas fees
+ *
+ * @param transactionMeta - Transaction metadata to check
+ * @returns True if txParams match dappSuggestedGasFees
+ *
+ * @example
+ * ```typescript
+ * const isUnmodified = txParamsAreDappSuggested({
+ *   txParams: { gasPrice: '0x3b9aca00' },
+ *   dappSuggestedGasFees: { gasPrice: '0x3b9aca00' }
+ * });
+ * ```
+ */
+export declare function txParamsAreDappSuggested(transactionMeta: TransactionMeta): boolean;
+/**
+ * Attempts to decode transaction data using standard token ABIs
+ *
+ * Tries to decode the data against ERC20, ERC721, ERC1155, USDC, and Permit2 ABIs
+ *
+ * @param data - Encoded transaction data
+ * @returns Decoded function data or undefined if decoding fails
+ *
+ * @example
+ * ```typescript
+ * const parsed = parseStandardTokenTransactionData('0xa9059cbb...');
+ * if (parsed) {
+ *   console.log('Function:', parsed.functionName);
+ *   console.log('Args:', parsed.args);
+ * }
+ * ```
+ */
+export declare function parseStandardTokenTransactionData(data: Hex): {
+    args: readonly [];
+    functionName: "symbol";
+} | {
+    args: readonly [];
+    functionName: "decimals";
+} | {
+    args: readonly [`0x${string}`];
+    functionName: "balanceOf";
+} | {
+    args: readonly [`0x${string}`, bigint];
+    functionName: "transfer";
+} | {
+    args: readonly [`0x${string}`, bigint] | readonly [`0x${string}`, `0x${string}`, bigint, number];
+    functionName: "approve";
+} | {
+    args: readonly [`0x${string}`, boolean];
+    functionName: "setApprovalForAll";
+} | {
+    args: readonly [`0x${string}`, `0x${string}`, bigint];
+    functionName: "transferFrom";
+} | {
+    args: readonly [`0x${string}`, bigint];
+    functionName: "increaseAllowance";
+} | {
+    args: readonly [`0x${string}`, `0x${string}`, bigint] | readonly [`0x${string}`, `0x${string}`, bigint, `0x${string}`] | readonly [`0x${string}`, `0x${string}`, bigint, bigint, `0x${string}`];
+    functionName: "safeTransferFrom";
+} | {
+    args: readonly [`0x${string}`, bigint];
+    functionName: "decreaseAllowance";
+} | {
+    args: readonly [`0x${string}`];
+    functionName: "supportsInterface";
+} | {
+    args: readonly [`0x${string}`, `0x${string}`, readonly bigint[], readonly bigint[], `0x${string}`];
+    functionName: "safeBatchTransferFrom";
+} | undefined;
+/**
+ * Checks if transaction has meaningful data
+ *
+ * @param transactionData - Transaction data field
+ * @returns True if data exists and is not empty
+ *
+ * @example
+ * ```typescript
+ * hasTransactionData('0x') // false
+ * hasTransactionData('0xa9059cbb...') // true
+ * ```
+ */
+export declare function hasTransactionData(transactionData?: Hex): boolean;
+/**
+ * Parses approval transaction data to extract relevant information
+ *
+ * Supports:
+ * - ERC20: approve, increaseAllowance
+ * - ERC721/ERC1155: setApprovalForAll
+ * - Permit2: approve
+ * - USDC: increaseAllowance
+ *
+ * @param data - Transaction data to parse
+ * @returns Parsed approval data or undefined if not an approval transaction
+ *
+ * @example
+ * ```typescript
+ * const approval = parseApprovalTransactionData('0x095ea7b3...');
+ * if (approval) {
+ *   console.log('Spender:', approval.spender);
+ *   console.log('Amount:', approval.amountOrTokenId);
+ *   console.log('Is approval for all?', approval.isApproveAll);
+ * }
+ * ```
+ */
+export declare function parseApprovalTransactionData(data: Hex): ParsedApprovalData | undefined;
+/**
+ * Reads an address to determine if it's a contract
+ *
+ * @param client - Viem public client
+ * @param address - Address to check
+ * @returns Contract code and whether it's a contract address
+ *
+ * @example
+ * ```typescript
+ * const { isContractAddress, contractCode } = await readAddressAsContract(
+ *   client,
+ *   '0x...'
+ * );
+ * ```
+ */
+export declare function readAddressAsContract(client: PublicClient, address: Address): Promise<{
+    isContractAddress: boolean;
+    contractCode: Hex | null;
+}>;
+/**
+ * Determines the token standard by checking EIP-165 interface support
+ *
+ * @param client - Viem public client
+ * @param address - Token contract address
+ * @returns Token standard (ERC721, ERC1155, ERC20, or none)
+ *
+ * @example
+ * ```typescript
+ * const standard = await getTokenStandard(client, '0x...');
+ * console.log('Token standard:', standard); // 'ERC721'
+ * ```
+ */
+export declare function getTokenStandard(client: PublicClient, address: Address): Promise<TokenStandard>;
+/**
+ * Gets token details including standard, decimals, symbol, and balance
+ *
+ * @param client - Viem public client
+ * @param address - Token contract address
+ * @param holderAddress - Optional address to check balance for
+ * @returns Token details
+ *
+ * @example
+ * ```typescript
+ * const details = await getTokenStandardAndDetails(
+ *   client,
+ *   '0x...', // token address
+ *   '0x...'  // holder address
+ * );
+ * console.log(details.symbol, details.decimals, details.balance);
+ * ```
+ */
+export declare function getTokenStandardAndDetails(client: PublicClient, address: Address, holderAddress?: Address): Promise<TokenDetails>;
+/**
+ * Determines the type of transaction by analyzing its parameters
+ *
+ * This function analyzes the transaction to determine if it's:
+ * - A contract deployment
+ * - A token transfer/approval
+ * - A contract interaction
+ * - A simple ETH transfer
+ *
+ * @param txParams - Transaction parameters
+ * @param client - Viem public client
+ * @returns Transaction type and contract code
+ *
+ * @example
+ * ```typescript
+ * const result = await determineTransactionType(
+ *   {
+ *     from: '0x...',
+ *     to: '0x...',
+ *     data: '0xa9059cbb...'
+ *   },
+ *   client
+ * );
+ * console.log('Transaction type:', result.type);
+ * ```
+ */
+export declare function determineTransactionType(txParams: TransactionParams, client: PublicClient): Promise<InferTransactionTypeResult>;
+/**
+ * Determines the asset type and token standard for a transaction
+ *
+ * This function analyzes the transaction to determine what type of asset
+ * is being transferred and what standard it follows (if applicable)
+ *
+ * @param txMeta - Transaction metadata
+ * @param client - Viem public client
+ * @returns Asset type and token standard
+ *
+ * @example
+ * ```typescript
+ * const { assetType, tokenStandard } = await determineTransactionAssetType(
+ *   txMeta,
+ *   client
+ * );
+ *
+ * if (assetType === AssetType.token) {
+ *   console.log('ERC20 token transfer');
+ * }
+ * ```
+ */
+export declare function determineTransactionAssetType(txMeta: TransactionMeta, client: PublicClient): Promise<{
+    assetType: AssetType;
+    tokenStandard: TokenStandard;
+}>;
+/**
+ * Parses typed data message while preserving large number precision
+ *
+ * JSON.parse can lose precision for numbers > Number.MAX_SAFE_INTEGER
+ * This function extracts large values and preserves them as strings
+ *
+ * @param dataToParse - Data to parse (object or string)
+ * @returns Parsed data with preserved precision
+ *
+ * @example
+ * ```typescript
+ * const parsed = parseTypedDataMessage(signatureRequest.data);
+ * console.log(parsed.message.value); // Preserved as string
+ * ```
+ */
+export declare function parseTypedDataMessage(dataToParse: object | string | number | boolean): any;
+/**
+ * Case-insensitive string comparison
+ *
+ * @param str1 - First string
+ * @param str2 - Second string
+ * @returns True if strings are equal (case-insensitive)
+ */
+export declare function isEqualCaseInsensitive(str1: string, str2: string): boolean;