Reference

Network	Base URL	Usage
Mainnet	`https://api.voyager.online`	Production contracts
Sepolia	`https://sepolia-api.voyager.online`	Testnet contracts
Dev	`https://dev-api.voyager.online`	Development testing
Custom	User-specified	Custom deployments

Job Status Codes

Code	Name	Description	Terminal
`0`	Submitted	Job queued	No
`1`	Compiled	Compilation success	No
`2`	CompileFailed	Compilation failed	Yes
`3`	Fail	Verification failed	Yes
`4`	Success	Verified successfully	Yes
`5`	Processing	Being processed	No

File Types

Type	Included	Flag Required	Max Size
Cairo source (.cairo)	✅ Yes	None	20MB
Scarb.toml	✅ Yes	None	20MB
Scarb.lock	❌ No	`--lock-file`	20MB
Test files	❌ No	`--test-files`	20MB
Documentation (.md)	✅ If found	None	20MB

Version Support

Component	Support Model	Current
Cairo	Server-determined	Up to 2.13.1 (Oct 2025)
Scarb	Client + Server	1.x - 2.x
Dojo	Auto-detected	Up to 1.8.0 (Oct 2025)
Client	Semantic Versioning	v2.0.1

Error Code Quick Lookup

Most Common Errors

Code	Error	Quick Fix
E005	Module not found	Add `--test-files` if importing tests
E007	Verification failed	Check Troubleshooting Guide
E015	Invalid contract name	Verify contract name matches `#[starknet::contract]` mod
E030	Class hash mismatch	Use `--lock-file` for reproducibility
E999	Unexpected error	Check logs with `--verbose`

By Category

Workspace Issues (E001-E003):

Package not found
No packages in workspace
Workspace errors

API Issues (E004-E009):

Job submission failed
Job not found
Verification failed

Dependency Issues (E010-E014):

Resolution failures
Missing dependencies
Dependency conflicts

Contract Issues (E015-E024):

Invalid contract names
Target not found
Multiple contracts found

File Issues (E025-E029):

File not found
File read errors
Invalid file types

Hash Issues (E030-E039):

Hash mismatch
Parsing errors
Format issues

Config Issues (E040-E042):

Config file errors
Parse failures
Invalid settings

File Collection Rules

Always Included

✅ All .cairo files in src/ (except tests)
✅ Package Scarb.toml
✅ Workspace Scarb.toml (if workspace)
✅ Documentation files (LICENSE, README.md, etc.)

Optional (Requires Flags)

❌ Scarb.lock → Use --lock-file
❌ Test files (src/tests/) → Use --test-files

Never Included

❌ Files outside src/ (except manifests)
❌ Test directories outside src/ (tests/, test/)
❌ Build artifacts (target/)
❌ Hidden files (.git/, .env)
❌ Unsupported file types (.yaml, .png, etc.)

File Size Limits

Maximum: 20MB per file

Validation:

File type checking (cairo, toml, lock, md, txt, json)
Size checking (max 20MB)
Path validation

Version Compatibility

Cairo Versions

Supported: Up to 2.13.1 (as of October 2025)

Compatibility:

✅ Cairo 2.13.x - Fully supported (latest)
✅ Cairo 2.12.x - Fully supported
✅ Cairo 2.11.x - Fully supported
✅ Cairo 2.10.x - Fully supported
✅ Cairo 2.9.x - Maintained
✅ Cairo 2.8.x - Maintained
⚠️ Cairo 1.x - Limited support
🔄 Newer versions - Check API or request via GitHub/Telegram

Version Agnostic: Client doesn’t impose version restrictions; server determines support.

Scarb Versions

Recommended: 2.8.x

Compatibility:

✅ Scarb 2.8.x - Fully tested
✅ Scarb 2.7.x - Stable
✅ Scarb 2.6.x - Supported
⚠️ Scarb 1.x - Limited
❌ Scarb 0.x - Not supported

Dojo Support

Detection: Automatic from Scarb.toml

Formats Supported:

# Simple string
dojo = "1.7.1"

# Git tag
dojo = { tag = "v0.7.0" }

# Version table
dojo = { version = "2.0.0" }

All Dojo versions with valid Scarb.toml format are supported.

Common Reference Scenarios

Scenario 1: Error Code Lookup

Problem: Getting error code E005

Steps:

Go to Error Codes
Find E005 in the list
Read cause, solutions, and examples
Apply suggested fix

Scenario 2: Version Check

Problem: Unsure if Cairo 2.12.0 is supported

Steps:

Go to Supported Versions
Check Cairo version compatibility matrix
See note about server-side support
Test with --dry-run on Sepolia first

Scenario 3: File Not Included

Problem: File missing from submission

Steps:

Go to File Collection
Check if file type is allowed
Verify file location (must be in src/ or manifest)
Use --dry-run to preview collection
Check if flag needed (--lock-file, --test-files)

Scenario 4: Understanding Job Status

Problem: Understanding what status codes mean

Steps:

Go to API Reference
Review job status codes documentation
Check response formats
Understand state transitions
Learn about typical timing

Scenario 5: Hash Mismatch

Problem: Class hash mismatch error

Steps:

Check Error Codes E030
Review File Collection for lock files
Use --lock-file flag
Check Supported Versions for compatibility
Verify exact versions match deployment

Reference FAQs

Q: Where can I find error code E030?

A: See Error Codes for detailed information on class hash mismatch errors.

Q: Which files are submitted for verification?

A: See File Collection for complete rules. By default: all .cairo files in src/ (except tests) + Scarb.toml + workspace manifest (if applicable).

Q: What Cairo version should I use?

A: See Supported Versions. As of 2025, Cairo up to 2.11.4 is fully supported. Newer versions are added with a slight lag.

Q: How do I check job status?

A: Use the voyager status command. See Status Command for usage details.

Q: What does status code 2 mean?

A: See API Reference. Status 2 = CompileFailed (compilation error, terminal state).

Q: Are test files included by default?

A: No. See File Collection. Use --test-files flag to include them.

Q: How long does verification take?

A: See API Reference. Simple contracts: 5-15 seconds. Complex contracts: 15-60 seconds.

Q: Can I use a custom API endpoint?

A: Yes. See API Reference for using --network custom --endpoint <URL>.

By Topic

Errors & Troubleshooting:

Error Codes - Complete error reference
Common Errors - Solutions for frequent issues
Debugging - Systematic troubleshooting

Versions & Compatibility:

Supported Versions - Version matrices
Upgrade Guide - How to upgrade

Files & Collection:

File Collection - What gets included
Test Files - Using --test-files
Lock Files - Using --lock-file

API & Integration:

API Reference - Complete API docs
Custom Endpoints - Custom deployments

By Task

I want to…

…understand an error code → Error Codes

…check version compatibility → Supported Versions

…know what files are submitted → File Collection

…understand job status codes → API Reference

…fix a verification failure → Common Errors

…upgrade Cairo/Scarb → Version Upgrade Guide

…debug compilation errors → Debugging

Keyboard shortcuts

Voyager Verifier Documentation