SubmitContractChallengeErrorResponseException
extends Exception
in package
Exception thrown when submitting signed authorization entries returns an error.
This exception is thrown when the POST request to the WEB_AUTH_FOR_CONTRACTS_ENDPOINT with signed authorization entries succeeds (returns 200 or 400) but the response contains an error field instead of a JWT token. This indicates the server validated the request but rejected the authorization entries for authentication.
Common reasons for submission errors:
- Invalid signatures on the client authorization entry
- Missing required signatures
- Signature threshold not met
- Nonce already used (replay attempt detected)
- Signature expiration ledger too old or in the past
- Authorization entries modified after being issued
- Contract account not authorized for authentication
- Client domain verification failed
The error message from the server is included in the exception message and should provide details about why the submission was rejected.