VERA

At its heart, this project, VERA, is a complete, functioning ecosystem that we built to solve a problem that is hiding in plain sight.

We call it the "Golden Goose in the Iron Cage."

The "Golden Goose" is the $4 trillion municipal finance market. This is the money that builds our real-world infrastructure—our parks, our bridges, our EV charging grids. It's a massive market that offers stable, predictable, revenue-backed returns.

The "Iron Cage" is the archaic system that runs it. This market is incredibly illiquid (you can't sell your bond easily), inaccessible (you often need $5,000 or more just to buy in), and completely opaque (it's run by middlemen and complex paperwork).

VERA is our key to that cage.

Our project is a live, on-chain protocol that transforms these massive, illiquid municipal revenue bonds into transparent, liquid, and globally accessible digital assets.

It’s not just a concept. It's a fully functional Proof-of-Concept, and here is a detailed, step-by-step look at what we've built.

Our Name is Our Mission We named it VERA, which stands for Verifiable Exposure to Real Assets. In Latin, "Vera" also means "Truth." Our entire mission is to bring verifiable, on-chain truth to a market that has operated in the dark for far too long.

The Complete User Journey: A 5-Step Process This is not a collection of disconnected features. It's a complete, end-to-end user journey that we built to mirror a real-world, professional-grade financial platform.

Step 1: The "Velvet Rope" – Verification A user doesn't just show up and invest. This is a professional protocol. The first step for any new user is to visit our /verify page. Here, we've integrated World ID for a cutting-edge, privacy-preserving "Proof of Personhood." The user doesn't have to give up their personal data (like a passport); they just have to prove they are a unique human using the World ID simulator. This is our solution for a scalable, compliant, and Sybil-resistant user base.

Step 2: The "Guest List" – On-Chain Compliance This is our "checkmate" feature that 99% of projects miss. We understand that real-world finance requires compliance. After a user proves they are human, they are still not ready to invest. A protocol administrator (representing the municipality or VERA's governing body) must go to a separate, secure /admin panel. On this page, the admin sees the user's request and must execute a second, on-chain transaction to formally whitelist that user's wallet address for a specific bond. This demonstrates a complete, two-step, professional-grade compliance and access-control system.

Step 3: The "Glass Cockpit" – Transparent Investment Now, our user is fully approved. They can navigate to a project's detail page. We call this the "Glass Cockpit." Instead of asking for trust, we provide proof. Every address, from the project itself to the treasury, has a live Etherscan link. The user can verify everything. When they're ready, they use the "Invest Now" form. This on-chain transaction takes their ETH and, in return, mints them real, ERC20-compliant tokens (like VERA-PARK) that represent their unique stake in that project.

Step 4: The "Executive Dashboard" – Professional Portfolio The user's journey doesn't end at investment. They can then visit their personal "My Portfolio" page. This isn't just a list of tokens; it's an "Executive Command Center." It shows them:

A Portfolio Summary with their total amount invested.

An Asset Allocation donut chart showing how their capital is spread.

A "Blended APY" (Annual Percentage Yield) in a signature golden gradient, showing their potential returns.

A list of their individual assets, where they can manage them and Sell / Transfer their tokens.

Step 5: The "Money Machine" – Our Live Revenue Oracle This is the final, jaw-dropping piece of the puzzle. How does revenue get on-chain? We built a simulated, live revenue oracle. During our demo, we run an off-chain script (run-oracle.js). This script is a machine that sends a live, on-chain transaction to the bond contract, simulating a real-world revenue payment.

Here's the short, simple, and direct answer for your hackathon questionnaire.

How We Built VERA: The Nitty-Gritty

We built VERA as a full-stack, professional-grade protocol in two main parts:

On-Chain Engine (EVM): We used Solidity and Hardhat to build two core contracts: a ProjectFactory (verified on Etherscan) to create new bonds, and a RevenueBond ERC20 contract for each project.

Frontend dApp (Next.js): We used Next.js, TypeScript, Wagmi, and RainbowKit to create a polished "frosted glass" UI. We built a full "Executive Dashboard" with a portfolio overview and asset management.

Partner Tech (World ID): We used World ID's IDKit as a cutting-edge, privacy-preserving "Proof of Personhood" layer. This is the first step in our professional-grade compliance system.

A Notable "Hack" We're Proud Of (The Compliance Flow): Our compliance is a functional, two-step system. A user first verifies with World ID (which sets a localStorage flag), but they still can't invest. A protocol admin must then use a secure /admin panel to execute a second, on-chain transaction to whitelist the user's address. The "Invest" button is a "smart gate" that only activates if both conditions are true.

Our Checkmate Feature (The "Live Oracle" Hack): We didn't use mock data. We built an off-chain Node.js script (run-oracle.js) that acts as a live revenue oracle. When we run this script during the demo, it sends a real, on-chain transaction to the distributeRevenue function. Our frontend uses wagmi's useWatchContractEvent to listen for this and update the "Total Project Revenue" in real-time, proving our economic flywheel is fully functional.