@deserialize/multi-vm-wallet 1.2.293 → 1.3.0

package/utils/types.ts

@@ -1,6 +1,7 @@
 import BN from "bn.js"
 import { EVMVM } from "./evm";
 import { SVMVM } from "./svm";
+import type { EntryPointVersion } from "./evm/aa-service/lib/type";
 
 export interface ChainWalletConfig {
     chainId: number;
@@ -13,10 +14,27 @@ export interface ChainWalletConfig {
         symbol: string;
         decimals: number;
     };
-    logoUrl?: string
+    logoUrl: string
     confirmationNo?: number
     testnet?: boolean;
-    vmType?: vmTypes
+    vmType: vmTypes
+
+    // Smart wallet configuration (optional) only for EVM chains and 7702
+
+    aaSupport?: {
+        enabled: boolean;
+        entryPoints: {
+            address: string;
+            version: EntryPointVersion;
+        }[]
+        bundlerUrl: string;
+        paymasterUrl: string;
+        kernelImplementations: {
+            address: string;
+            version: number;
+        }[];
+    };
+
 }
 
 export interface TokenInfo {
@@ -24,6 +42,15 @@ export interface TokenInfo {
     name: string;
     symbol: string;
     decimals: number;
+    logoUrl?: string;
+    description?: string;
+    website?: string;
+    social?: {
+        twitter?: string;
+        discord?: string;
+        telegram?: string;
+        [key: string]: string | undefined;
+    };
 }
 
 export interface UserTokenBalance<AddressType> extends TokenInfo {
@@ -39,12 +66,206 @@ export interface NFTInfo {
     image?: string;
 }
 
+// Unified NFT interface for both EVM and SVM chains
+export interface NFT {
+    // Unique identifier
+    id: string; // For Solana: mint address, For EVM: contractAddress:tokenId
+
+    // Basic metadata
+    name: string;
+    symbol?: string;
+    description: string;
+    image?: string;
+    uri: string; // Metadata URI
+
+    // Collection/Contract info
+    collection: {
+        address: string;
+        name: string;
+        verified?: boolean;
+    };
+
+    // Chain-specific data
+    chainType: 'SVM' | 'EVM';
+
+    // Ownership
+    balance?: string; // Quantity owned (useful for ERC1155)
+
+    // Optional metadata
+    attributes?: Array<{
+        trait_type: string;
+        value: string | number;
+        display_type?: string;
+    }>;
+
+    // Creators/Royalties (mainly for Solana)
+    creators?: Array<{
+        address: string;
+        verified: boolean;
+        share: number;
+    }>;
+
+    // Additional metadata
+    sellerFeeBasisPoints?: number; // Royalty percentage
+    tokenStandard?: string; // e.g., "ERC721", "ERC1155", "NonFungible", etc.
+
+    // Spam detection (mainly for EVM)
+    isSpam?: boolean;
+
+    // Raw chain-specific data for advanced use cases
+    raw?: {
+        svm?: SolanaNFT;
+        evm?: EVMNFT;
+    };
+}
+
+// NFT Collection interface for both EVM and SVM chains
+export interface NFTCollection {
+    // Collection identifier
+    address: string;
+
+    // Collection metadata
+    name: string;
+    symbol?: string;
+    description?: string;
+    image?: string;
+
+    // Verification status
+    verified?: boolean;
+
+    // Chain-specific data
+    chainType: 'SVM' | 'EVM';
+
+    // NFTs owned by the user in this collection
+    nfts: NFT[];
+
+    // Collection statistics
+    totalOwned: number; // Number of NFTs owned by user in this collection
+
+    // Collection-level metadata (for EVM)
+    contractMetadata?: {
+        tokenType?: string; // ERC721, ERC1155, etc.
+        totalSupply?: string;
+        contractDeployer?: string;
+        deployedBlockNumber?: number;
+    };
+
+    // Collection-level metadata (for SVM)
+    collectionMetadata?: {
+        updateAuthority?: string;
+        sellerFeeBasisPoints?: number;
+        creators?: Array<{
+            address: string;
+            verified: boolean;
+            share: number;
+        }>;
+    };
+
+    // OpenSea metadata (for EVM)
+    openSeaMetadata?: {
+        collectionSlug?: string;
+        floorPrice?: number;
+        safelistRequestStatus?: string;
+    };
+}
+
+export interface SolanaNFT {
+    mint: string;
+    name: string;
+    symbol: string;
+    uri: string;
+    updateAuthority: string;
+    sellerFeeBasisPoints: number;
+    creators?: Array<{
+        address: string;
+        verified: boolean;
+        share: number;
+    }>;
+}
+
+export interface EVMNFTContract {
+    address: string;
+    name: string;
+    symbol: string;
+    totalSupply: string;
+    tokenType: string;
+    contractDeployer: string;
+    deployedBlockNumber: number;
+    isSpam: boolean;
+    spamClassifications?: string[];
+}
+
+export interface EVMNFTOpenSeaMetadata {
+    collectionName: string;
+    collectionSlug: string;
+    floorPrice?: number;
+    safelistRequestStatus: string;
+    imageUrl?: string;
+    lastIngestedAt: string;
+}
+
+export interface EVMNFTImage {
+    cachedUrl?: string;
+    thumbnailUrl?: string;
+    pngUrl?: string;
+    contentType?: string;
+    size?: number;
+    originalUrl?: string;
+}
+
+export interface EVMNFTAttribute {
+    trait_type: string;
+    value: string | number;
+    display_type?: string;
+}
+
+export interface EVMNFTRawMetadata {
+    tokenUri?: string;
+    metadata?: {
+        name?: string;
+        description?: string;
+        image?: string;
+        attributes?: EVMNFTAttribute[];
+        [key: string]: any;
+    };
+}
+
+export interface EVMNFTMint {
+    mintAddress?: string;
+    blockNumber?: number;
+    timestamp?: string;
+    transactionHash?: string;
+}
+
+export interface EVMNFT {
+    contract: EVMNFTContract;
+    openSeaMetadata?: EVMNFTOpenSeaMetadata;
+    tokenId: string;
+    tokenType: string;
+    name: string;
+    description: string;
+    balance: string;
+    image?: EVMNFTImage;
+    raw?: EVMNFTRawMetadata;
+    mint?: EVMNFTMint;
+    timeLastUpdated: string;
+    acquiredAt?: string;
+}
+
+export interface EVMNFTResponse {
+    data: EVMNFT[];
+}
+
 export interface TransactionResult {
     hash: string;
     success: boolean;
     error?: string;
 }
 
+export interface FeePayerOptions {
+    privateKey: string;  // Private key of the wallet paying fees
+}
+
 export interface Balance {
     balance: BN;
     formatted: number;