Marketplace
Santa Paws ships as layered APNG traits and as flattened GIF tokens. OpenSea wants the GIF bake of those loops. The APNG stack stays in this repo for the studio and any later restack.
Project description
Collection name Santa Paws. Symbol PAWS. Category PFPs. The same copy lives in public/metadata/santapaws-description.txt.
Santa Paws is always in the mood of giving. A 7,777-piece collection of looping chibi-cat PFP GIFs on Base. Each Santa Paw is stacked from six layers — yard, glow, pelt, mug, hat, and gear — then flattened onto one 12-frame GIF. Snowy nights and cookie kitchens behind them. Santa hats and cocoa on top. Ears twitch. Eyes blink. Soft bob. Kawaii bust-crop cats with thick outlines, flat cel fills, and a Christmas wardrobe. One shared clock. Minting on Base (chain ID 8453). Gas is ETH.
Listing kit
OpenSea wants a square logo, a 3:2 featured image, and a wide 4:1 banner — three different pictures, no type on the marketplace images. The site hero can reuse the taller banner.

Logo
512×512, 1:1
public/brand/logo-santapaws.png

Featured
1200×800, 3:2
public/brand/featured-santapaws.jpg

OpenSea banner
2800×700, 4:1
public/brand/banner-santapaws-opensea.jpg

Collection GIF
1000×1000 loop
public/brand/collection-santapaws.gif
Wallet setup
RPC https://mainnet.base.org
Explorer https://basescan.org
OpenSea does not stack APNG layers for you. Studio is a live compositor. For a Drop you upload finished GIFs plus a CSV. Run the generator to bake each token onto the shared 12-frame clock. Default generate writes all 7,777 metadata rows and a 16-GIF preview; pass --all to flatten the full supply.
In OpenSea Studio, create a Drop on Base (chain ID 8453). Set supply to 7,777, paste the project description, and upload the listing kit from public/brand.
Upload every file in generated/santapaws/gifs (1.gif–7777.gif after --all) and generated/santapaws/SANTAPAWS-opensea-drop.csv. The CSV already uses OpenSea’s required headers (tokenID, name, description, file_name, attributes[Trait]). OpenSea plays GIF, not APNG. Preview the loops, then publish.
contracts/SantaPaws.sol mints token IDs 1–7,777. Pin generated/santapaws/json and set the base URI. Import that contract on OpenSea instead of using a Drop if you want a custom mint. Gas is ETH.
Drop upload notes: Preparing metadata for your drop. Live collection: opensea.io/collection/santa-paws-123. OpenSea-compatible chains: blockchains compatible with OpenSea.