Skip to main content

Contract error reference

Find the cause and the fix for every catalogued on-chain revert DALP contracts can return, with retryability for each.

A DALP smart contract error is a revert that reaches you in an API or SDK error as id, or as dalpCode on a contract error or a failed deployment step. Open the page for the code's range from Pages by code range, then read the Why and Suggested Fix columns. The reference covers validation and permission checks, the asset lifecycle, settlement and infrastructure.

Errors the Platform API raises itself, such as authentication or validation failures, are in the Platform API error reference. The DALP error index lists the page for every code range in both references, Read and handle DALP errors explains the error envelope, and Error handling explains retries and escalation.

How to use this reference

  1. Find the id in the error, or its dalpCode on a contract error or a failed deployment step, and open the page for the code range that holds it.
  2. Read the Message and Why columns to understand what the contract rejected and why.
  3. Apply the Suggested Fix, then use Retryable for control flow. Yes means the same request can succeed later without a change to the request, for example once a date passes or a price feed updates. No means repeat calls fail until you act on the Suggested Fix.
  4. Read Severity as a default for your own alerting. Error handling says who handles each level and when to escalate.
  5. Keep the requestId or correlationId from the error, whichever is present, and include it when you open a support ticket.

Message is the headline, Why is the on-chain condition that failed, Suggested Fix is the next step, and Solidity Error is the custom error the contract reverted with. Do not parse the Message, Why or Suggested Fix columns in program logic, because their wording can change. Branch on the id (or dalpCode) together with the retryable flag.

Pages by code range

Contents

Compliance & token operations

The 137 errors in this group are on these pages:

Settlement & XvP

The 12 errors in this group are on this page:

Airdrop & distribution

The 32 errors in this group are on this page:

System & infrastructure

The 519 errors in this group are on these pages:

Internal (OpenZeppelin / low-level)

The 109 errors in this group are on these pages:

Chain & workflow

The 5 errors in this group are on this page:

Was this page helpful?