Error Codes

All INK endpoints MUST return structured error responses:

{
  "protocol": "ink/0.1",
  "error": true,
  "code": "invalid_signature",
  "message": "Ed25519 signature verification failed"
}

Error Codes

Code	HTTP Status	Description
invalid_signature	401	Signature verification failed
invalid_delegation	401	agentLink repo commit signature verification failed
expired_message	400	Timestamp outside acceptable window
duplicate_nonce	400	Nonce already seen
unknown_did	404	Could not resolve sender DID
no_agent_link	404	No agentLink record found for sender
encryption_required	400	Intent type requires encrypted payload
decryption_failed	400	Could not decrypt payload
unsupported_version	400	Protocol version not supported
rate_limited	429	Too many requests
access_denied	403	Requester is not a party to the referenced message
internal_error	500	Agent internal error