Aztec Artifact Registry

Upload your Aztec contract artifact to make it available for others.
Store, verify, and share your artifacts in one place.

📁

Upload your deployed Aztec contract JSON file

Drag & drop or click to browse (multiple files supported)

API Reference

All endpoints return JSON. No authentication required.

POST/api/upload

Upload Contract

Upload and validate an Aztec contract artifact. Validates structure, extracts class ID, and verifies deployment on the Aztec network.

Request Example

curl -X POST /api/upload \ -F "file=@/path/to/contract.json"

Success Response 200 OK

{ "success": true, "filename": "0x2c01847b...json", "classId": "0x2c01847b231e4c7cb4441aa6e46a21439cc8fd517a13c8598665f88ac3d92029", "contractName": "Token", "functionCount": 42 }

Error Codes

400 Invalid file or validation failed 409 Duplicate contract 413 File too large (>10MB) 503 Aztec node unavailable

GET/api/contracts

List Contracts

Retrieve metadata for all uploaded contracts, sorted by upload date (newest first).

Request Example

curl /api/contracts

Success Response 200 OK

[ { "classId": "0x2c01847b...", "name": "Token", "functionCount": 42, "fileSize": 10067321, "uploadedAt": "2025-10-22T12:34:56.789Z" } ]

GET/api/contracts/:classId

Download Contract

Retrieve the full contract artifact JSON file by class ID. The JSON will be displayed inline in the browser.

Request Example

curl -o contract.json \ /api/contracts/0x2c01847b231e4c7cb4441aa6e46a21439cc8fd517a13c8598665f88ac3d92029

Error Codes

400 Invalid class ID format 404 Contract not found