Whitepaper

The technical architecture behind Chicago's community blockchain — from vision to implementation.

v2.0 — 3-Contract Architecture

Executive Summary

CUHS replaces the failed 155-token model with a streamlined 3-contract architecture. Three smart contracts — a collateral-backed stablecoin (cUHSD), an ERC-1155 community investment vault system with 77 token IDs, and a governance reserve token — create a sustainable, data-driven community economy for Chicago's 77 neighborhoods.

Smart Contracts

Community Vaults

77M

Reserve Supply

The Problem

Previous community token projects (CityCoins, community currencies) failed because they lacked real utility, real collateral, or real data. Speculative tokens without backing collapse. Algorithmic stablecoins without collateral death-spiral. CUHS addresses all three failure modes.

No Utility

Tokens with no real use case become purely speculative. When hype fades, value goes to zero.

No Collateral

Algorithmic stablecoins with no backing assets death-spiral the moment confidence breaks.

No Data

Without real-world data anchoring, token values disconnect from community outcomes entirely.

3-Contract Architecture

The CUHS ecosystem is built on three interdependent smart contracts. The cUHSD stablecoin provides a stable medium of exchange. Community Investment Vaults create shared equity in each of Chicago's 77 neighborhoods. The CUHS Reserve Token governs the entire system and distributes fees to holders.

ERC-20

cUHSD Stablecoin

1:1 USD peg. Multi-collateral backing. Medium of exchange for all marketplace transactions.

ERC-1155

Investment Vaults

77 token IDs. Oracle-scored community health. Shared equity in neighborhood improvement.

ERC-20

CUHS Reserve

77M fixed supply. DAO governance. Fee distribution from marketplace activity.

Contract Interfaces

// Contract 1: cUHSD Stablecoin (ERC-20)
interface IcUHSD {
    function mint(address to, uint256 amount) external;
    function burn(address from, uint256 amount) external;
    function collateralRatio() external view returns (uint256);
}

// Contract 2: Community Investment Vaults (ERC-1155)
interface ICommunityVault {
    function deposit(uint256 areaId, uint256 amount) external;
    function withdraw(uint256 areaId, uint256 shares) external;
    function oracleScore(uint256 areaId) external view returns (uint256);
}

// Contract 3: CUHS Reserve Token (ERC-20)
interface ICUHSReserve {
    function vote(uint256 proposalId, bool support) external;
    function claimFees() external returns (uint256);
    function totalSupply() external view returns (uint256); // 77,000,000
}

cUHSD Stablecoin

cUHSD is Chicago's digital dollar — an ERC-20 token pegged 1:1 to USD. It serves as the primary medium of exchange for all marketplace transactions within the CUHS ecosystem.

Multi-Collateral Vault

Unlike algorithmic stablecoins that rely on market confidence alone, cUHSD is backed by a diversified vault of real assets: USDC, DAI, and eventually real-world assets (RWAs). The collateral ratio never drops below 150%.

Mint / Burn Mechanism

Users deposit collateral to mint cUHSD. When redeeming, cUHSD is burned and collateral is returned. This creates a hard floor on the token's value — every cUHSD can always be redeemed for $1 of collateral.

Stability Mechanisms

Over-Collateralization

The vault maintains a minimum 150% collateral ratio at all times. For every $1 of cUHSD in circulation, $1.50+ of collateral sits in reserve.

Circuit Breakers

If collateral ratios drop below safety thresholds, minting pauses automatically, redemptions are prioritized, and the DAO is alerted for governance action.

Algorithmic Rebalancing

When the peg drifts beyond a narrow band, the protocol automatically adjusts interest rates and mint/burn incentives to restore equilibrium.

Governance Override

Reserve token holders can vote to trigger emergency measures, adjust collateral parameters, or approve new vault asset types via DAO proposal.

Community Investment Vaults

The investment vault system is an ERC-1155 contract with 77 token IDs — one for each of Chicago's community areas. Each vault's value is determined by an oracle-aggregated community health score, not speculation.

How It Works

1Deposit cUHSD — Choose a community area and deposit cUHSD into its vault.
2Receive vault shares — You receive ERC-1155 tokens representing your proportional stake in that area's vault.
3Value grows with community health — As the oracle score improves (property values rise, crime drops, employment grows), your vault shares increase in value.

7 Data Sources

Each vault's value is scored from 7 weighted data feeds:

Property Values20%

Crime Index20%

Employment Rate15%

Spending Velocity15%

Education Scores15%

Business Growth10%

DAO Completion Rate5%

CUHS Reserve Token

The CUHS Reserve is an ERC-20 token with a fixed supply of 77,000,000 — the governance and utility backbone of the entire ecosystem.

Governance

Vote on DAO proposals, elect community councils, and shape protocol parameters across all 77 areas.

Fee Distribution

Earn a proportional share of all marketplace transaction fees flowing back to CUHS holders.

Gas Token

Used for internal operations, proposal staking, and transaction fee payment within the ecosystem.

Total Fixed Supply

77,000,000

No inflation. No additional minting. Ever.

Oracle System

The oracle system is the bridge between real-world community data and on-chain vault valuations. It aggregates 7 data sources into a single health score per community area that drives investment vault values.

Data Integration

Primary data source is the Chicago Data Portal, supplemented by county property records, Bureau of Labor Statistics employment data, local business registries, and Chicago Public Schools performance data. All sources are public, auditable, and updated on known schedules.

Weighted Scoring Formula

HealthScore(area) =
  0.20 * PropertyIndex(area) +
  0.20 * SafetyIndex(area) +
  0.15 * EmploymentRate(area) +
  0.15 * SpendingVelocity(area) +
  0.15 * EducationScore(area) +
  0.10 * BusinessGrowth(area) +
  0.05 * DAOCompletionRate(area)

Update Frequency & Dispute Resolution

Oracle scores update weekly for most data sources, with property values updating quarterly. Any community member can stake CUHS tokens to challenge an oracle score, triggering a 48-hour review period where the data committee audits the source data. Successful challenges earn the staker a bounty; frivolous challenges forfeit the stake.

Whale Protection

Five interlocking layers ensure no single actor can dominate the ecosystem. Economic power is distributed by design, not by hoping large holders will behave.

1. Identity & Sybil Prevention

Community-area residency verification and KYC checks prevent one person from operating multiple wallets to concentrate voting power or economic influence.

2. Bicameral Governance

Two-chamber voting: token-weighted for economic decisions, one-person-one-vote for community policies. Whales cannot dominate both chambers simultaneously.

3. Economic Deterrents

Progressive fee structure for large transactions, maximum wallet caps, and anti-flash-loan cooldowns make large-scale manipulation economically irrational.

4. Commitment Alignment

Time-locked staking required for governance power. The longer you lock, the more weight you earn — rewarding long-term commitment over quick accumulation.

5. Enforcement

Smart contract hard limits on single-wallet holdings, publicly visible large transactions, and community watchdog committees that can flag suspicious activity for DAO review.

Governance

Each of Chicago's 77 community areas operates its own DAO. Decisions are made by the people who live and invest there, not by a central authority.

Per-Area DAO Structure

Each community area has its own DAO with an elected council, a treasury, and autonomous decision-making power. Area DAOs control local spending, project prioritization, and can propose changes to the protocol-level governance.

Proposal Lifecycle

Draft

Author submits proposal with rationale and budget

Discussion

7-day community discussion period with feedback

Vote

5-day voting window, 10% quorum required to pass

Execute

Passed proposals are executed automatically on-chain

Quorum & Treasury

A minimum of 10% of area token holders must participate for a vote to be valid. This prevents low-turnout decisions from overriding community consensus. Each area's treasury is funded by transaction fees, staking rewards, and investment returns. Treasury allocation is decided through the same proposal and voting process.

Roadmap

A phased approach ensures each layer is built on a solid foundation before moving to the next.

Phase 1: Website + Community Engagement

Complete

Next.js website with 13 pages, community area explorer, tokenomics explainers, and user signup for all 77 community areas.

Phase 2: Mobile App Shells + Admin Tools

Current

KMP mobile apps (Android + iOS) with 5-tab navigation, admin map editor, portal CRUD, and shared data layer across platforms.

Phase 3: Backend Integration + Smart Contracts

Ktor backend, real authentication, smart contract development, oracle data pipeline, and testnet deployment of the 3-contract architecture.

Phase 4: Mainnet Deployment + Marketplace

Future

Production smart contract deployment, cUHSD minting, community investment vaults live, marketplace launch, and DAO governance activation across 77 areas.

Ready to be part of the future?

Join Chicago's community blockchain. Sign up to claim your community area and start building shared prosperity with your neighbors.

Join CUHS