Error Handling

The AkashicPay SDK may throw or return errors (extending the default error object of the language) with specific error codes. For the /payout endpoint, errors are typically returned rather than thrown. Below is a list of Akashic-specific errors, their explanations, and recommended actions.

Error Code
Explanation
What to Do

OTK_ONBOARDING_FAILED

Failed to set up an OTK on AkashicChain for testing.

Try again. If it persists, contact [email protected].

INVALID_PRIVATE_KEY_FORMAT

The private key or recovery phrase used to instantiate the SDK is invalid.

Double-check your variables and try again.

WALLET_CREATION_FAILURE

Failed to create an L1 wallet on AkashicChain.

Try again. If it persists, contact [email protected].

UNHEALTHY_WALLET

A wallet was created on AkashicChain but could not be verified as safe.

Try again. If it persists, contact [email protected].

ACCESS_DENIED

Attempted to access the OTK in a production environment (not allowed).

Do not attempt this in production.

L2ADDRESS_NOT_FOUND

Formatting error or the L2 address does not exist for a Layer 2 transaction.

Double-check your input and try again.

NOT_SIGNED_UP

SDK instantiated without completing setup on AkashicPay.com.

Complete the setup on AkashicPay.com and try again.

FUNDS_EXCEEDED

Attempted to withdraw more funds than available.

Check your balances and inputs and try again.

ASSIGNMENT_FAILED

Failed to create an L1 wallet on AkashicChain.

Try again. If it persists, contact [email protected].

INVALID_PARAMETER

Invalid argument provided to a function (Java and C# only).

Double-check your inputs for syntax errors.

UNKNOWN_ERROR

An unspecified error occurred.

Check the error message details. Retry after a short delay. If it persists, contact [email protected].

Last updated

Was this helpful?