Add smart contract specs

[joelamouche]

Smart Contracts

• Solidity - Smart contract programming language
• Foundry - Fast, portable and modular toolkit for Ethereum application development

The the-guild-smart-contracts/ directory contains our Solidity smart contracts built with Foundry.

TheGuildBadgeRegistry

A community-driven badge registry where anyone can create badges with unique names and descriptions.

Key Features:

• Community-driven: Anyone can create badges
• Unique names: No duplicate badge names allowed
• Immutable: No owner or upgrade mechanism
• Gas-efficient: Simple storage patterns
• Event-driven: Emits events for badge creation

Contract Interface:

// Create a new badge
function createBadge(bytes32 name, bytes32 description) external

// Get badge information
function getBadge(bytes32 name) external view returns (bytes32, bytes32, address)

// Check if badge exists
function exists(bytes32 name) external view returns (bool)

// Get total number of badges
function totalBadges() external view returns (uint256)

// Enumerate badges
function badgeNameAt(uint256 index) external view returns (bytes32)

Events:

event BadgeCreated(bytes32 indexed name, bytes32 description, address indexed creator)

[oscarwroche]

lgtm