# Numbers Verify Engine

> Digital content verification platform by Numbers Protocol.
> Verify authenticity and provenance of images and media
> registered on the Numbers blockchain network.

## What this site does

Numbers Verify Engine lets users verify whether a digital image
or media file has been registered on the Numbers Protocol blockchain.
It provides two main functions:

1. **Reverse image search**: Upload an image to find exact and
   visually similar matches among blockchain-registered assets,
   using AI-powered CLIP embeddings and BigQuery Vector Search.

2. **Asset profile viewer**: View the full provenance record of
   a registered asset, including creator, registration time,
   blockchain commits, NFT details, license, and C2PA metadata.

## Key URLs

- Homepage: https://verify.numbersprotocol.io/
- Asset Profile: https://verify.numbersprotocol.io/asset-profile/{nid}
  (where {nid} is a CIDv1 content identifier, e.g. bafybeih5gd5...)

## How verification works

1. User uploads an image or enters a content ID (NID).
2. The system generates a CLIP ViT-B/32 embedding of the image.
3. It computes the IPFS CID for exact-match lookup.
4. It queries BigQuery Vector Search for visually similar matches.
5. Results show matched assets with similarity scores, creator info,
   blockchain chain, and links to the full asset profile.

## API endpoints (for developers)

- POST /api/search — Upload a base64-encoded image to start a
  similarity search. Returns a requestId for polling.
- GET /api/search/{requestId} — Poll for search results.
  Returns exact match and similar matches when completed.
- POST /api/verify — Verify an asset exists by its NID.
  Returns verified status and asset metadata.

## Technology

- CLIP ViT-B/32 for image embeddings (512-dimensional vectors)
- BigQuery Vector Search with cosine similarity (IVF index)
- IPFS content addressing (CIDv1, base32)
- Numbers Protocol blockchain for asset registration
- Firebase Cloud Functions + Hosting
- React 19 SPA with Vite

## Supported blockchains

- Numbers Mainnet
- Ethereum
- Polygon
- Avalanche
- ThunderCore
- BNB Chain

## About Numbers Protocol

Numbers Protocol (https://www.numbersprotocol.io) builds
infrastructure for digital media provenance. It enables
creators to register digital content on-chain with metadata
including creator identity, capture time, geolocation,
license terms, and AI training preferences. The protocol
supports C2PA (Coalition for Content Provenance and
Authenticity) standards for content credentials.

## Contact

- Website: https://www.numbersprotocol.io
- GitHub: https://github.com/numbersprotocol