Contracts

All Etherean contracts are deployed on Ethereum mainnet. No L2, no testnet equivalents in production.

Core

Soul NFT

A single ERC-721 contract that stores the soul.md document and 40x40 generative pixel art onchain.

Soul Contract Interface

// Mint a soul NFT into the Etherean's TBA
function mint(
  uint256 ethereanId,
  bytes calldata pixelData,
  string calldata content
) external payable;

// Update soul content (via tba.execute)
function update(
  uint256 tokenId,
  bytes calldata pixelData,
  string calldata content
) external;

// Read soul content
function content(uint256 tokenId) external view returns (string);
function pixelData(uint256 tokenId) external view returns (bytes);

Design

• OpenZeppelin ERC-721 base with Ownable
• mapping(uint256 => string) public content — markdown document (max 10KB)
• mapping(uint256 => bytes) public pixelData — 400 bytes, 2bpp 40x40
• Minting looks up TBA from 6551 registry and mints directly to it
• One soul per Etherean (enforced by token ID = ethereanId)
• tokenURI() returns fully onchain JSON with embedded SVG + markdown
• Payable mint with configurable price via setMintPrice()

Agent Registry (ERC-8004)

These are canonical mainnet singletons — not deployed by Etherean. Used via tba.execute() at soul equip time.

Gas Estimates

At 0.04 gwei (~$2500 ETH):