Programmable

Application, contracts and public data for tokens built with Uniswap v4 hooks.

Website · Explore · Create · Documentation

Programmable is an Ethereum application for launching, exploring and trading tokens whose market behavior is defined by Uniswap v4 hooks. This repository contains the website, the contract workspace, the public read model and the evidence that binds what the application shows to deployed code.

Inside this repository

The product interface and API routes live in app/ and components/. The Solidity workspace, deployment scripts and release evidence live in contracts/. Chain reads, indexing and shared product logic live in indexer/ and lib/. Verification, documentation and operations are maintained in scripts/, tests/, docs/ and ops/.

The complete directory guide is in docs/PROJECT-STRUCTURE.md.

Public repositories

Programmable uses four public repositories with separate responsibilities.

| Repository | Purpose | | :--- | :--- | | programmable | The application, contract releases, public read model and release evidence | | hookbuilder | The agent skill and local tools used to build reproducible Uniswap v4 projects | | apply | Public review rules, checker behavior, applications tied to exact revisions and discovery records | | developers | Discovery manifests, API contracts and verification examples for external platforms |

Use this repository for product, contract and website work. Use hookbuilder to build a project, apply to follow the public review process and developers to integrate Programmable data into another product.

How data reaches the application

Programmable reads recognized contract events and finalized public records, then reconstructs project and market state at a defined chain snapshot. The application uses that data for Explore, token pages, profiles and transaction preparation.

The connected wallet confirms user transactions. A listing, source match or public record does not by itself authorize a launch or prove that a project is safe.

External consumers can use the public token feed at /api/indexers/v1/tokens. The integration contract and discovery manifest are maintained in 0xprogrammable/developers.

Local development

npm install
cp .env.example .env.local
npm run dev

Open http://localhost:3000.

Provide your own Privy, RPC and storage configuration in .env.local. Do not commit RPC credentials, storage tokens, signing material or other secrets.

Verification

Run the complete product gate:

npm run verify

For contract changes, also use the dedicated contract gate:

npm run contracts:verify

These are local repository checks. They do not prove that a change has been deployed or activated in production.

Reference

• Project structure
• Developer documentation
• Public indexer feed
• Transaction preflight
• Uniswap source provenance
• Mainnet readiness

Release and security boundaries

production contains the complete website product and is the only source for website releases. main preserves the public contract and release evidence history. Feature branches merge through reviewed pull requests.

Source verification, local tests, a Registry record or a Programmable listing are not an external audit, a safety guarantee or proof of liquidity. Deployment, activation and public availability require their own evidence.

The smart contracts in this repository have not undergone an external audit or public security contest.