Skip to content

Latest commit

 

History

History

contract-verification

README.md

Tempo Contract Verification Service

contracts.tempo.xyz/docs

Sourcify-compatible smart contract verification service. Currently supports Tempo Testnets and Devnets.

Architecture

graph LR
    Client["Client"]
    Worker["Worker<br/>Hono Routes"]
    Container["Container<br/>Solc"]
    D1["D1<br/>SQLite"]
    
    Client -->|HTTP| Worker
    Worker -->|compile| Container
    Worker -->|query/write| D1
    Worker -->|response| Client
    
    style Worker fill:#2563eb,color:#fff
    style Container fill:#8b5cf6,color:#fff
    style D1 fill:#f59e0b,color:#fff
Loading

API Endpoints

Verification

  • POST /v2/verify/:chainId/:address - Verify contract with source code
  • GET /v2/verify/:verificationId - Check verification status

Lookup

  • GET /v2/contract/:chainId/:address - Get verified contract details
  • GET /v2/contract/all-chains/:address - Find contract across all chains
  • GET /v2/contracts/:chainId - List all verified contracts on a chain

Usage

With Foundry

Pass the API URL to the --verifier-url flag and set --verifier to sourcify:

forge script script/Mail.s.sol --verifier-url https://contracts.tempo.xyz --verifier sourcify

See /apps/contract-verification/scripts/quick-verify.sh and /apps/contract-verification/scripts/medium-verify.sh for small examples you can run.

Direct API Usage

Development

Prerequisites

cp .env.example .env  # Copy example environment variables
pnpm install          # Install dependencies
pnpm dev              # Start development server

Once dev server is running, you can run scripts in the /apps/contract-verification/scripts directory to populate your local database with verified contracts.

Database

We use D1, a serverless SQLite-compatible database by Cloudflare. Sometimes you need to debug the local database in development, especially when it's SQLite. Sadly, wrangler doesn't have a nice way to do this.

Improvised solution: we locate the local SQLite file wrangler uses and run drizzle-kit studio to view it.

environment database dialect GUI
production Cloudflare D1 SQLite DrizzleKit Studio
development Local SQLite SQLite Cloudflare Dashboard