Technical Reference

Errors

This page is a reference to error codes returned by Minikit.

Verify

Below are the error codes you could receive with the Verify command

Code	Description	How to fix?
`verification_rejected`	User rejected the World ID request in World App.	If this was a mistake, trigger the verify command again.
`max_verifications_reached`	This person has already verified for this particular action the maximum number of times allowed.	Nothing to do. User cannot verify for this action again.
`credential_unavailable`	This user does not have the requested credential.	The user must verify at the Orb or verify their unique device in World App to receive the credential required.
`malformed_request`	The request payload couldn't be decrypted or did not conform to the standard.	Ensure Minikit is configured properly and all parameters are valid.
`invalid_network`	The application is configured for a different environment than the verifying user's client.	Ensure you use the Worldcoin Simulator for Staging applications and World App for Production applications.
`inclusion_proof_failed`	The sequencer returned an unexpected error when retrieving the inclusion proof.	Ask the user to try again. This may be due to a temporary network issue, or a bug with World App or the Signup Sequencer.
`inclusion_proof_pending`	The user might have the requested credential, but it is not available on-chain yet. It might be available for API verification.	Ask the user to verify again in approximately one hour.
`unexpected_response`	There was a problem with the response obtained from the WLD app.	Try again, though in most cases these will require contacting us to report the bug.
`generic_error`	An unhandled exception occurred.	Try again, though in most cases these will require contacting us to report the bug.

Pay

Below are the error codes you could receive with the Pay command

Code	Description	How to fix?
`input_error`	There was a problem with this request. Please try again or contact the app owner.	Ensure the request is properly formed and try again.
`payment_rejected`	You’ve cancelled the payment in World App.	If this was a mistake, initiate the payment again.
`invalid_receiver`	The receiver address is invalid. Please contact the app owner.	You don't have this address whitelisted inside the Developer Portal.
`insufficient_balance`	You do not have enough balance to complete this transaction.	Add more funds to your wallet
`transaction_failed`	The transaction failed. Please try again.	Try the transaction again. Something failed on-chain.
`generic_error`	Something unexpected went wrong. Please try again.	Try again, though in most cases these will require contacting us to report the bug.

Wallet Auth

Below are the error codes you could receive with the walletAuth command

Code	Description	How to fix?
`malformed_request`	Provided parameters in the request are invalid.	Ensure the request is properly formed and try again. If the problem persists, contact the app owner.
`user_rejected`	User rejected the request.	If this was a mistake, initiate the request again.
`generic_error`	Something unexpected went wrong.	Try the request again. If the problem persists, contact the app owner.