NFT Management

// From src/state/nfts/types.ts
interface NftsState {
  collections: Map<CollectionId, Collection>;
  nftsByCollection: Map<CollectionId, Map<UniqueId, UniqueAsset>>;
  pagination: PaginationInfo | null;
  
  getNftCollections: () => Map<CollectionId, Collection> | null;
  getNftsByCollection: (collectionId: CollectionId) => Map<UniqueId, UniqueAsset> | null;
  getNftByUniqueId: (collectionId: CollectionId, uniqueId: UniqueId) => UniqueAsset | null;
}

type Collection = {
  id: CollectionId;           // Unique collection identifier
  name: string;               // Collection name
  imageUrl: string | null;    // Collection banner/icon
  totalCount: string;         // Total NFTs in collection
};

type UniqueAsset = {
  id: string;                    // Token ID
  uniqueId: string;              // Global unique ID
  collection: {
    id: string;
    name: string;
    imageUrl?: string;
  };
  
  // NFT Metadata
  name: string;                  // NFT name
  description?: string;          // Description
  imageUrl?: string;             // NFT image
  animationUrl?: string;         // Video/animation
  
  // On-chain data
  contractAddress: string;       // NFT contract
  tokenId: string;               // Token ID
  chainId: ChainId;             // Network
  
  // Traits/attributes
  traits?: Array<{
    trait_type: string;
    value: string | number;
  }>;
  
  // Marketplace data
  lastSalePrice?: {
    amount: string;
    currency: string;
  };
  floorPrice?: {
    amount: string;
    currency: string;
  };
};

// From src/state/nfts/types.ts
interface OpenCollectionsState {
  openCollections: Record<CollectionId, boolean>;
  insertionOrder: CollectionId[];
  
  toggleCollection: (collectionId: CollectionId) => void;
  isCollectionOpen: (collectionId: CollectionId) => boolean;
  setCollectionOpen: (collectionId: CollectionId, isOpen: boolean) => void;
}

type NftParams = {
  walletAddress: Address | string;
  limit: number;              // NFTs per page
  pageKey: string | null;     // Pagination cursor
  collectionId?: CollectionId; // Specific collection
};

type PaginationInfo = {
  pageKey: string | null;     // Current page cursor
  hasNext: boolean;           // More NFTs available
  total_elements?: number;    // Total NFT count
};

type CollectionName = string | 'Showcase';

// Special "Showcase" collection
const showcaseCollection: Collection = {
  id: 'showcase',
  name: 'Showcase',
  imageUrl: null,
  totalCount: '0', // Dynamic
};

// Hide individual NFT or entire collection
hideNft: (collectionId: CollectionId, uniqueId?: UniqueId) => {
  if (uniqueId) {
    // Hide specific NFT
    const hidden = get().hiddenNfts || new Set();
    hidden.add(uniqueId);
    set({ hiddenNfts: hidden });
  } else {
    // Hide entire collection
    const hidden = get().hiddenCollections || new Set();
    hidden.add(collectionId);
    set({ hiddenCollections: hidden });
  }
}

// Efficient Map-based storage
nftsByCollection: Map<CollectionId, Map<UniqueId, UniqueAsset>>

// O(1) lookups
getNftByUniqueId: (collectionId: CollectionId, uniqueId: UniqueId) => {
  return get().nftsByCollection.get(collectionId)?.get(uniqueId) || null;
}

{
  "name": "NFT Name",
  "description": "Description",
  "image": "ipfs://...",
  "attributes": [
    {
      "trait_type": "Background",
      "value": "Blue"
    }
  ]
}

{
  "name": "Edition Name",
  "decimals": 0,
  "image": "https://...",
  "properties": {
    "edition": "1 of 100"
  }
}

const resolveIpfsUrl = (ipfsUrl: string): string => {
  if (ipfsUrl.startsWith('ipfs://')) {
    return ipfsUrl.replace('ipfs://', 'https://ipfs.io/ipfs/');
  }
  return ipfsUrl;
};