Error Codes

When interacting with the SDK or RPC, you may encounter specific error codes. This reference table helps identify the root cause of the issue.

1000 Series: Client-Side Errors

These errors occur before the request reaches the network, usually during input validation or proof generation.

Code	Name	Description	Solution
1001	InvalidDidFormat	The provided Agent ID does not match the did:veil: standard.	Check the string format and length.
1002	CircuitMismatch	The private inputs provided do not match the expected schema of the circuit.	Verify that your input JSON matches the circuit definition.
1003	ProofGenFailed	The local machine failed to generate the STARK proof.	Ensure you have sufficient RAM (16GB+) or check input validity.

2000 Series: Network & RPC Errors

These errors are returned by the VeilCore nodes.

Code	Name	Description	Solution
2001	AgentNotFound	The requested Agent ID is not registered on the Solana ledger.	Ensure the agent has been deployed and the transaction is finalized.
2002	StaleState	The proof was generated against an old state root.	Refresh the agent state using getAgentState and regenerate the proof.
2003	RateLimitExceeded	The IP address has sent too many requests.	Implement exponential backoff or use a dedicated RPC provider.

3000 Series: Verification Errors

These errors indicate that the proof is invalid cryptographically.

Code	Name	Description	Solution
3001	InvalidProof	The STARK proof failed verification constraints.	This usually indicates a bug in the circuit logic or corrupted input data.
3002	PublicInputMismatch	The public inputs in the proof do not match the on-chain requirements.	Verify that the public parameters (e.g., timestamps or prices) are current.