NFT Manager

The NFT page scans one collection across one or more wallet groups and shows what each wallet holds, with listing price, top offer and rarity attached. From there you can send, consolidate, list, or accept offers without leaving the page.

Scanning#

Scan a collection

4 steps

1. 1

   Step 1

   Paste the collection

   An EVM contract address, or for Solana a collection address or a Magic Eden / Tensor URL — pasting a Solana input switches the chain for you.

2. 2

   Step 2

   Pick the chain

   Inventory is per chain. The star beside the address field saves a collection as a favourite for next time.

3. 3

   Step 3

   Choose the wallet group(s)

   You scan a group, not an address. Several groups at once is fine; each option shows how many wallets it holds.

4. 4

   Step 4

   Hit Refresh

   Holdings are read from the chain through your own RPCs.

Units vs Token Types#

The result header reads something like 16 NFT units (13 token types) in 5 Wallets. The two counts differ because ERC-1155 is supported alongside ERC-721: an ERC-721 row is one unique token, while an ERC-1155 row can carry a quantity. The send dialog lets you choose how many units to move from each ERC-1155 row rather than forcing an all-or-nothing transfer.

ERC-1155 contracts do not provide a standard way to enumerate every token an address owns. Zyper discovers ERC-1155 inventory through a supported Alchemy or Ankr NFT indexer, then verifies the displayed quantities onchain before showing or transferring them. If no supported indexer is available for the chain, the page reports that limitation instead of pretending the wallet is empty.

Rarity#

Ranks are fetched into a shared server-side vault, so the first scan of a collection pays the cost and later scans are instant. The rank number is coloured by percentile, using OpenSea’s four bands:

Tier	Band	Colour
Legendary	top 1%	amber
Epic	top 10%	purple
Rare	top 25%	blue
Common	the rest	grey

Tier is always rank ÷ supply, which is why a rank means little without the supply beside it — rank 1507 is Epic in a 10,000 collection and only Rare in an 8,888 one. The tier chips above the list filter by band, and the Rarity column sorts by rank.

Views and Selection#

• Card view — image grid, with a density control (1 / 2 / 4 / 6 columns).
• List view — sortable table: listing price, top offer, rarity, owner.

Click to select, shift-click for a range, or use Select all. Selection spans wallets, and the action bar reports units, token types, and how many wallets they came from.

Two view helpers worth knowing: Refresh Metadata clears the cached names and images for the collection and re-fetches (use it after a reveal), and Hide Info blanks addresses and wallet names so you can screenshot the art without showing who holds what.

Sending, Consolidating, Dispersing#

Send Selected opens the transfer dialog. One checkbox decides the shape:

• Disperse off — everything selected goes to a single destination. This is how you consolidate a drop minted across many burner wallets.
• Disperse on — the selection is spread across several destinations.

Either mode can target a wallet you hold or a pasted custom address (one per line when dispersing).

Transfers leaving the same wallet are batched where the collection and chain support it. ERC-721 collections are probed for a native batchTransferFrom and can otherwise use Zyper’s batch helper. ERC-1155 transfers preserve the quantity selected for every destination. Each outcome reports its own status, so a partial failure identifies the token or quantity that did not move.

Listings and Offers#

These need an OpenSea API key in Settings; without one the buttons are disabled.

• List Selected — put the selection up for sale.
• Accept Offer — take the best live wrapped-native offer on each selected item.
• Cancel Listings — pull live listings back (costs gas).

PnL#

The chart button beside Refresh switches the panel into per-contract profit and loss — FIFO cost basis across the same wallets, rendered as a shareable card. EVM only.

ERC-721 Enumeration Strategy#

Phase	Method	Why it exists
1	balanceOf(address)	Filters empty wallets before expensive work
2	tokensOfOwner(address)	Fast path for common non-standard launchpad contracts
3	tokenOfOwnerByIndex(address,uint256)	ERC-721 Enumerable standard
4	NFT indexer, then a Transfer log scan with ownerOf verification	Universal fallback when the contract is not enumerable

For the log scan the app finds the deployment block and scans forward in chunks.

Metadata#

Once token IDs are known, tokenURI calls are batched and metadata fetched with short HTTP timeouts. Names and images are cached in nft_metadata_cache.txt, so repeat scans are fast. A token whose metadata is missing or slow still appears as #tokenId.