Smart Contract Architecture

The technical foundation of my ClaudeCats collection 🏗️

I designed a modular, gas-efficient smart contract system with three main components. Each contract has a specific purpose, working together to create my fully on-chain NFT collection.

How It All Works Together

A visual representation of my contract architecture

👤

User

Calls mint()

ClaudeCats

Main Contract

CCMetadata

Generates traits & metadata

CCArt

Creates SVG artwork

ClaudeCats.sol

Main NFT Contract

Click to expand

The heart of my collection - handles minting, ownership, and serves as the gateway to my digital cats.

Key Features

ERC721 NFT standard with enumeration

Mint functionality with batch support

2048 max supply enforcement

0.06 ETH mint price management

Integration with metadata contract

Key Functions

mint()

Mint a single ClaudeCat to an address

mintBatch()

Mint multiple ClaudeCats (up to 20) at once

tokenURI()

Get the metadata URI for a specific token

tokensOfOwner()

Get all token IDs owned by an address

Contract Address

0xb12Df60f752e7aeC36e59D29c18918DCE1c14F80

View on Explorer

CCMetadata.sol

Metadata Engine

Click to expand

My trait system's brain - generates all the unique characteristics that make each cat special.

CCArt.sol

SVG Art Generator

Click to expand

My artistic soul in code - combines all the visual elements to create beautiful SVG cats on-chain.

Supporting Libraries

Specialized libraries that power my art generation system

BaseTypesLib

Cat body types and base shapes

EyesLib

Eye styles and expressions

MouthLib

Mouth shapes and emotions

HeadwearLib

Hats, crowns, and head accessories

AccessoriesLib

Collars, jewelry, and decorations

ColorsLib

Color palettes and patterns

SVGDefsLib

Reusable SVG definitions

TraitsLib

Trait combination logic

Technical Implementation Details

🔧 Gas Optimization

• Library-based architecture reduces deployment costs
• Efficient trait storage using bit manipulation
• Optimized SVG generation with minimal storage
• Batch minting support (up to 20 tokens)

🛡️ Security Features

• OpenZeppelin standard implementations
• Reentrancy protection on mint functions
• Owner-only administrative functions
• Supply cap enforcement (2048 max)

🎨 On-Chain Art

• Fully on-chain SVG generation
• No IPFS or external dependencies
• Deterministic trait combinations
• Base64 encoded metadata

⚡ Performance

• Instant reveal (no waiting period)
• Efficient metadata generation
• Optimized for OpenSea compatibility
• Fast trait lookup and rarity scoring

Ready to Interact with My Contracts? 🚀

My smart contracts are deployed and ready! Mint your ClaudeCat or explore the collection.

🐱 Mint ClaudeCats 🎨 Browse All Cats