Build on pic2cells · Developer docs

pic2cells.

Build on pic2cells

pic2cells is 100% on-chain. There's no private API to request, no key to wait for, no permission needed. The contract is the API. Open, permissionless, go build.

The basics

Contract 0xAbEBFB0918e9f5E9C590F46edB363156f56768D8

Chain: Ethereum mainnet
Verified on Etherscan, so the full ABI is public there.
Bring your own RPC. Your own Alchemy / Infura / public node. You need nothing from us.

Use ethers, viem, web3.py, or anything that reads an Ethereum contract.

Read functions

tokenURI(tokenId) — full on-chain metadata: base64 JSON with the SVG image and all traits. Generated on-chain, no IPFS, no server.
seedOf(tokenId) — the token's seed. Form, tier, backdrop and base inventory all derive from this.
inventoryOf(tokenId) — uint32[21], live pixel count per color (after burns and painting).
canvasDataOf(tokenId) — (bytes, uint8), the painted 32×32 canvas plus encoding mode (0 raw, 1 RLE, 2 sparse).
isRevealed / isLocked / burnCountOf — token state.
ownerOf · balanceOf · totalSupply · tokensOfOwner(address) — standard ERC-721.

Events to index

Minted(to, tokenId, seed)
Burned(sacrificeId, targetId, by)
Painted(tileId, by, mode, length)
Cleared(tileId, by)

Enough to power a live activity feed or analytics.

Hosted read API no key

Don't want to run your own indexer? We host a small read-only feed of painted pieces and their rendered images. Cached, CORS-enabled (call it straight from the browser), no auth.

Base https://pic2cells-collection.pic2cells.workers.dev

GET /api/collection — manifest of every painted Cell: { updated, latestBlock, count, featured, pieces:[…] }. Each piece has id, painter, artist, tier, burns, sig, block.
GET /cell/{id}.svg — that Cell's rendered on-chain artwork as an SVG.
GET /api/status — index health: lastBlock, pieces, updated.

Read-only and painted-Cells only. For ownership, live inventory, unpainted packs, or full history, read the contract directly with your own RPC. Please don't scrape this into a full mirror, index the chain yourself from the events for heavy or complete data. And /rpc is our own proxy, not a public endpoint, so bring your own node.

Ideas to build

Rarity explorers, holder galleries, paint and trace helpers, sales and activity bots, mosaic viewers, leaderboards, anything. It's all on-chain and yours to build on.

Ship something? Share it with the community, we'd love to see it.