# Project Name

Short description of what the project does and its value proposition.

## Features
- ✅ Feature 1: Brief description
- ✅ Feature 2: Brief description
- 🔜 Feature 3: Coming soon

## Quick Start
\`\`\`bash
git clone https://github.com/org/project
cd project
forge install
forge test
\`\`\`

## Architecture
[Include diagram]

## Documentation
- [User Guide](./docs/user-guide.md)
- [Developer Docs](./docs/developer.md)
- [Security](./docs/security.md)

/// @title Reserve-Backed Token
/// @author Team Name
/// @notice This contract implements an ERC-20 token with reserve requirements
/// @dev All function calls check reserve backing before execution
/// @custom:security-contact security@project.com
contract ReserveToken {
    /// @notice Transfers tokens from sender to recipient
    /// @dev Checks reserve requirement before transfer
    /// @param to The recipient address
    /// @param amount The amount to transfer in wei
    /// @return success Whether the transfer succeeded
    function transfer(address to, uint256 amount) external returns (bool);
}

graph TB
    subgraph "Smart Contracts"
        Token[ERC-20 Token]
        Reserve[Reserve Manager]
        Access[Access Control]
    end
    
    subgraph "External Systems"
        Oracle[Price Oracle]
        Custodian[Reserve Custodian]
    end
    
    subgraph "User Interfaces"
        Web[Web App]
        API[REST API]
    end
    
    Web --> Token
    API --> Token
    Token --> Reserve
    Reserve --> Oracle
    Reserve --> Custodian
    Token --> Access

## API Reference

### Get Balance
Returns the token balance for an address.

**Endpoint:** `GET /api/balance/{address}`

**Response:**
\`\`\`json
{
  "address": "0x...",
  "balance": "1000000000000000000",
  "formatted": "1.0",
  "decimals": 18
}
\`\`\`

**Error Codes:**
- `400`: Invalid address format
- `404`: Address not found
- `500`: Internal server error