Error codes
A failed transaction reports codespace/code (the explorer shows it under Status; the CLI in raw_log). Every Aeva module registers its codes in chain/x/<module>/types/errors.go; the codespace is the module name. Codes of the Cosmos SDK modules (sdk, bank, staking, …) are the SDK’s own.
asset
| code | error | message |
|---|---|---|
asset/2 | ErrAssetNotFound | asset not found — ErrAssetNotFound is returned when an asset id is unknown. |
asset/3 | ErrInvalidPolicy | asset policy is required — ErrInvalidPolicy is returned when the required asset policy is unset (grammar violations surface as x/policy ErrInvalidPolicy). |
asset/4 | ErrNoKinds | asset must define at least one right kind — ErrNoKinds is returned when CreateAsset carries zero right kinds. |
asset/5 | ErrInvalidKind | invalid right kind — ErrInvalidKind is returned when a right kind spec is malformed. |
asset/6 | ErrInvalidMetaHash | meta_hash must be empty or exactly 32 bytes — ErrInvalidMetaHash is returned when meta_hash is neither empty nor 32 bytes. |
asset/7 | ErrInvalidRoles | invalid role address — ErrInvalidRoles is returned when a role address is set but invalid. |
asset/8 | ErrInvalidSettlementDenom | invalid settlement denom — ErrInvalidSettlementDenom is returned when settlement_denom is not a valid denom. |
asset/9 | ErrAssetExists | asset already exists — ErrAssetExists is returned when an asset id collides with an existing one. |
asset/10 | ErrKindNotFound | right kind not found — ErrKindNotFound is returned when a kind id does not exist on an asset. |
asset/11 | ErrInvalidSupply | invalid supply — ErrInvalidSupply is returned when a supply value is negative or above 2^128-1. |
asset/12 | ErrInvalidGenesis | invalid genesis state — ErrInvalidGenesis is returned when genesis state is malformed. |
asset/13 | ErrInvalidAssetID | invalid asset id — ErrInvalidAssetID is returned when an asset id is not 64 lower-case hex chars. |
asset/14 | ErrUnauthorized | signer is not the asset issuer — ErrUnauthorized is returned when the signer is not the asset issuer. |
asset/15 | ErrInvalidStatus | invalid asset status — ErrInvalidStatus is returned when a status is not settable (only ACTIVE / FROZEN are). |
asset/16 | ErrInvalidTarget | invalid policy target — ErrInvalidTarget is returned when MsgSetPolicy has no valid target. |
asset/17 | ErrInvalidDistributionDenoms | invalid distribution denoms — ErrInvalidDistributionDenoms is returned when the payout denom allowlist is empty, too long, has duplicates or an invalid denom. |
asset/18 | ErrIssuanceLocked | issuance is locked — ErrIssuanceLocked is returned by Issue on an asset whose issuance was locked. |
asset/19 | ErrAlreadyLocked | issuance already locked — ErrAlreadyLocked is returned by a second MsgLockIssuance. |
asset/20 | ErrIssuanceLockAtCreate | issuance cannot be locked at creation; lock explicitly after the first issue — ErrIssuanceLockAtCreate is returned when MsgCreateAsset sets issuance_locked. |
asset/21 | ErrNotDivisible | effective units are not divisible by the kind’s multiplier — ErrNotDivisible is returned when an effective units input is not a multiple of the kind’s SPLIT multiplier (M2). |
bridge
| code | error | message |
|---|---|---|
bridge/2 | ErrInvalidRoute | invalid route — ErrInvalidRoute is returned for a malformed route (id, domain, contract, direction, denom, caps, display). |
bridge/3 | ErrRouteNotFound | route not found — ErrRouteNotFound is returned for an unknown route id or an unregistered warp token. |
bridge/4 | ErrRoutePaused | route is paused — ErrRoutePaused is returned in both directions while a route is PAUSED. |
bridge/5 | ErrCapExceeded | cap exceeded — ErrCapExceeded is returned when a transfer would take the rolling window over the limit (never queued). |
bridge/6 | ErrUnauthorized | unauthorized — ErrUnauthorized is returned when the signer is not the authority. |
bridge/7 | ErrNoMailbox | bridge mailbox is not configured — ErrNoMailbox is returned when params.mailbox_id is unset. |
bridge/8 | ErrDirectWarpUse | warp transfers must go through x/bridge — ErrDirectWarpUse is returned by the bank send restriction when the warp module account is used outside x/bridge. |
bridge/9 | ErrInvalidParams | invalid params — ErrInvalidParams is returned for malformed params or an invalid validator set / threshold. |
bridge/10 | ErrNativeMint | the native denom is bridged as collateral only — ErrNativeMint is returned when a route would let the bridge mint the native denom. |
bridge/11 | ErrNotBridgeable | the right kind is not bridgeable — ErrNotBridgeable is returned when a RIGHT_OUT route names a kind the issuer has not flagged bridgeable (RH-3 Q3). |
bridge/12 | ErrPolicyNotOpen | the right kind’s effective policy is not OPEN — ErrPolicyNotOpen is returned when a RIGHT_OUT route names a kind whose effective policy is not OPEN (RH-3 Q3: a policy cannot be enforced remotely). |
bridge/13 | ErrNoEscrowIncome | no income accrued to the escrow — ErrNoEscrowIncome is returned by SweepEscrowIncome when nothing is claimable. |
credential
| code | error | message |
|---|---|---|
credential/2 | ErrInvalidType | invalid attestation type — ErrInvalidType is returned when type does not match ^[a-z0-9]+(.[a-z0-9]+)*$ or exceeds 64 chars. |
credential/3 | ErrInvalidExpiry | invalid expiry — ErrInvalidExpiry is returned when expiry is unset or not after the block time. |
credential/4 | ErrInvalidEvidenceHash | evidence_hash must be empty or exactly 32 bytes — ErrInvalidEvidenceHash is returned when evidence_hash is neither empty nor 32 bytes. |
credential/5 | ErrAttestationNotFound | attestation not found — ErrAttestationNotFound is returned when (subject, type, attester) does not exist. |
credential/6 | ErrAlreadyRevoked | attestation already revoked — ErrAlreadyRevoked is returned when revoking an attestation that is already revoked. |
credential/7 | ErrInvalidAddress | invalid address — ErrInvalidAddress is returned when a bech32 address does not parse. |
credential/8 | ErrNoAttesters | at least one attester is required — ErrNoAttesters is returned when a Valid query names no attesters. |
credential/9 | ErrInvalidGenesis | invalid genesis state — ErrInvalidGenesis is returned when genesis state is malformed. |
delegation
| code | error | message |
|---|---|---|
delegation/2 | ErrInvalidDelegation | invalid delegation — ErrInvalidDelegation is returned for bad purposes, a past or too-long until, zero units or holder == delegate. |
delegation/3 | ErrNotFound | delegation not found — ErrNotFound is returned for an unknown id. |
delegation/4 | ErrNotActive | delegation is not active — ErrNotActive is returned when the delegation already ended. |
delegation/5 | ErrNotRevocable | delegation is not revocable — ErrNotRevocable is returned by MsgRevokeDelegation on a delegation created with revocable = false. |
delegation/6 | ErrUnauthorized | unauthorized — ErrUnauthorized is returned when the signer is neither the holder (revoke) nor the delegate (return). |
encumbrance
| code | error | message |
|---|---|---|
encumbrance/2 | ErrInvalidUnits | invalid units — ErrInvalidUnits is returned when units are unset, zero or above 2^128-1. |
encumbrance/3 | ErrInvalidAddress | invalid address — ErrInvalidAddress is returned when a bech32 address does not parse. |
encumbrance/4 | ErrBeneficiaryRequired | beneficiary is required — ErrBeneficiaryRequired is returned when a PLEDGE or LIEN has no beneficiary. |
encumbrance/5 | ErrInvalidEvidenceHash | evidence_hash must be empty or 32 bytes — ErrInvalidEvidenceHash is returned when evidence_hash is neither empty nor 32 bytes. |
encumbrance/6 | ErrEvidenceHashRequired | a lien requires a 32-byte evidence_hash — ErrEvidenceHashRequired is returned when a LIEN carries no evidence hash. |
encumbrance/7 | ErrInvalidExpiry | expiry must be after block time — ErrInvalidExpiry is returned when expiry is set but not after block time. |
encumbrance/8 | ErrInvalidReleaseAfter | holder_release_after must be after block time — ErrInvalidReleaseAfter is returned when holder_release_after is set but not after block time. |
encumbrance/9 | ErrEncumbranceNotFound | encumbrance not found — ErrEncumbranceNotFound is returned when no encumbrance has the id. |
encumbrance/10 | ErrNotActive | encumbrance is not active — ErrNotActive is returned when the encumbrance is in a terminal status. |
encumbrance/11 | ErrEncumbranceExpired | encumbrance has expired — ErrEncumbranceExpired is returned when touching an ACTIVE encumbrance at or after its expiry. |
encumbrance/12 | ErrNotAuthorized | signer may not release this encumbrance — ErrNotAuthorized is returned when the release signer has no release authority. |
encumbrance/13 | ErrHolderCannotRelease | the holder may not release this encumbrance — ErrHolderCannotRelease is returned when the holder tries to release without a holder_release_after. |
encumbrance/14 | ErrHolderReleaseTooEarly | holder_release_after has not passed — ErrHolderReleaseTooEarly is returned when the holder releases before holder_release_after. |
encumbrance/15 | ErrNotExercisable | encumbrance is not exercisable — ErrNotExercisable is returned when exercising a non-exercisable or LOCKUP encumbrance. |
encumbrance/16 | ErrNotBeneficiary | signer is not the beneficiary — ErrNotBeneficiary is returned when the exercise signer is not the beneficiary. |
encumbrance/17 | ErrInsufficientEncumbered | units exceed the encumbered remainder — ErrInsufficientEncumbered is returned when exercising more than the remaining units. |
encumbrance/18 | ErrLiensNotAllowed | the asset does not allow liens — ErrLiensNotAllowed is returned when the asset does not allow liens. |
encumbrance/19 | ErrNotOperator | signer is not the asset operator — ErrNotOperator is returned when the lien signer is not the asset’s operator. |
encumbrance/20 | ErrInvalidKind | invalid encumbrance kind — ErrInvalidKind is returned for an unspecified encumbrance kind. |
encumbrance/21 | ErrInvalidStatus | invalid encumbrance status — ErrInvalidStatus is returned for an unspecified status. |
encumbrance/22 | ErrInvalidAuthority | invalid authority — ErrInvalidAuthority is returned when MsgUpdateParams is not signed by the module authority. |
encumbrance/23 | ErrInvalidParams | invalid params — ErrInvalidParams is returned when params fail validation. |
encumbrance/24 | ErrInvalidGenesis | invalid genesis state — ErrInvalidGenesis is returned when genesis state is malformed. |
encumbrance/25 | ErrLockupUnavailable | lockups are not available — ErrLockupUnavailable is returned when MsgIssue.lockup_until is set but no lockup creator is wired. |
encumbrance/26 | ErrSelfBeneficiary | beneficiary must differ from the holder — ErrSelfBeneficiary is returned when the beneficiary is the holder (an exercise would be a self-transfer). |
encumbrance/27 | ErrIncomeRoutingUnavailable | income routing unavailable — ErrIncomeRoutingUnavailable is returned when income_to_beneficiary is set but no income router is wired (M3). |
erc20rights
| code | error | message |
|---|---|---|
erc20rights/2 | ErrInvalidGenesis | invalid genesis state — ErrInvalidGenesis is returned when genesis state is malformed. |
erc20rights/3 | ErrTokenNotFound | token not found — ErrTokenNotFound is returned when an address is not a registered right or bundle token. |
erc20rights/4 | ErrAlreadyRegistered | tokens already registered — ErrAlreadyRegistered is returned when an asset’s tokens are registered twice. |
erc20rights/5 | ErrInvalidAddress | invalid address — ErrInvalidAddress is returned when a 0x address does not parse. |
fee
| code | error | message |
|---|---|---|
fee/2 | ErrFeeDenomNotAccepted | fee denom not accepted: AEVA (aaeva) is the gas token (ADR-016 §2) — ErrFeeDenomNotAccepted is returned by the ante handler for a fee coin whose denom is not accepted. |
fee/3 | ErrUnauthorized | unauthorized — ErrUnauthorized is returned when the signer is not the authority. |
payout
| code | error | message |
|---|---|---|
payout/2 | ErrInvalidAmount | invalid amount — ErrInvalidAmount is returned when a distribution amount is unset, zero or above 2^128-1. |
payout/3 | ErrInvalidAddress | invalid address — ErrInvalidAddress is returned when a bech32 address does not parse. |
payout/4 | ErrInvalidDenom | invalid denom — ErrInvalidDenom is returned when a denom is not a valid bank denom. |
payout/5 | ErrDenomNotAllowed | denom is not in the asset’s distribution denoms — ErrDenomNotAllowed is returned when the denom is not in the asset’s distribution_denoms. |
payout/6 | ErrNoSupply | kind supply is zero — ErrNoSupply is returned when the kind has no units to accrue to. |
payout/7 | ErrIncrementZero | distribution too small: the index increment would be zero — ErrIncrementZero is returned when amount·SCALE + carry < supply (nothing would accrue). |
payout/8 | ErrIndexOverflow | accrual index would overflow 2^192 — ErrIndexOverflow is returned when the new index would reach 2^192. |
payout/9 | ErrAmountOverflow | distributed total would overflow 2^128 — ErrAmountOverflow is returned when a total would reach 2^128. |
payout/10 | ErrInsufficientFunds | payer has insufficient funds — ErrInsufficientFunds is returned when the payer cannot fund the distribution. |
payout/11 | ErrNothingToClaim | nothing to claim — ErrNothingToClaim is returned when a claim would pay zero. |
payout/12 | ErrAccrualNotFound | accrual not found — ErrAccrualNotFound is returned when no accrual exists for (asset, kind, denom). |
payout/13 | ErrInvalidAuthority | invalid authority — ErrInvalidAuthority is returned when MsgUpdateParams is not signed by the module authority. |
payout/14 | ErrInvalidParams | invalid params — ErrInvalidParams is returned when params fail validation. |
payout/15 | ErrInvalidGenesis | invalid genesis state — ErrInvalidGenesis is returned when genesis state is malformed. |
payout/16 | ErrInvalidKind | invalid kind — ErrInvalidKind is returned when a kind id does not exist on the asset. |
payout/17 | ErrRouteInvalid | invalid income route — ErrRouteInvalid is returned for a route that duplicates a ref, exceeds the lock, or has no units (M3). |
rights
| code | error | message |
|---|---|---|
rights/2 | ErrAssetNotFound | asset not found — ErrAssetNotFound is returned when the referenced asset does not exist. |
rights/3 | ErrKindNotFound | right kind not found — ErrKindNotFound is returned when the referenced kind_id does not exist on the asset. |
rights/4 | ErrUnauthorized | signer is not the asset issuer — ErrUnauthorized is returned when the signer of MsgIssue is not the asset issuer. |
rights/5 | ErrInvalidUnits | invalid units — ErrInvalidUnits is returned when a unit amount is not > 0 or exceeds 2^128-1. |
rights/6 | ErrInsufficientUnits | insufficient transferable units — ErrInsufficientUnits is returned when a leg or redemption exceeds transferable units. |
rights/7 | ErrKindNotTransferable | right kind is not transferable — ErrKindNotTransferable is returned when transferring a kind with transferable=false. |
rights/8 | ErrSelfTransfer | cannot transfer to self — ErrSelfTransfer is returned when from == to. |
rights/9 | ErrDuplicateLeg | duplicate kind_id in transfer legs — ErrDuplicateLeg is returned when a kind_id appears twice in the legs. |
rights/10 | ErrNoLegs | transfer must have at least one leg — ErrNoLegs is returned when MsgTransfer has no legs. |
rights/11 | ErrSupplyOverflow | supply would exceed 2^128-1 — ErrSupplyOverflow is returned when an issuance would push supply above 2^128-1. |
rights/12 | ErrInvalidAddress | invalid address — ErrInvalidAddress is returned when a bech32 address does not parse. |
rights/13 | ErrInvalidGenesis | invalid genesis state — ErrInvalidGenesis is returned when genesis state is malformed. |
rights/14 | ErrTooManyLegs | too many transfer legs — ErrTooManyLegs is returned when MsgTransfer exceeds MaxLegs. |
rights/15 | ErrInvalidAssetID | invalid asset id — ErrInvalidAssetID is returned when an asset id is not 64 lower-case hex chars. |
rights/16 | ErrAssetFrozen | asset is frozen — ErrAssetFrozen is returned when the asset status is not ACTIVE. |
rights/17 | ErrInvalidAuthority | invalid authority — ErrInvalidAuthority is returned when MsgUpdateParams is not signed by the module authority. |
rights/18 | ErrInvalidLockRef | invalid lock ref — ErrInvalidLockRef is returned when a lock ref is not ” |
rights/19 | ErrLockNotFound | lock not found — ErrLockNotFound is returned when no lock exists for (asset, kind, holder, ref). |
rights/20 | ErrInsufficientLocked | insufficient locked units — ErrInsufficientLocked is returned when an unlock or locked transfer exceeds the lock. |
rights/21 | ErrLockupUnavailable | lockups are not available — ErrLockupUnavailable is returned when MsgIssue.lockup_until is set but no lockup creator is wired. |
rights/22 | ErrAssetLiquidating | asset is liquidating — ErrAssetLiquidating is returned by operations blocked while an asset is LIQUIDATING (M2): Transfer, Issue, Redeem, Propose, Pledge, Lien, Distribute. |
rights/23 | ErrAssetLiquidated | asset is liquidated — ErrAssetLiquidated is returned by every units-moving operation on a LIQUIDATED asset (terminal), Exercise included. |
settlement
| code | error | message |
|---|---|---|
settlement/2 | ErrNoLegs | settlement must have at least one leg — ErrNoLegs is returned when a proposal has no legs. |
settlement/3 | ErrTooManyLegs | too many legs — ErrTooManyLegs is returned when a proposal exceeds params.max_legs. |
settlement/4 | ErrDuplicateLeg | duplicate leg — ErrDuplicateLeg is returned when (direction, asset, kind) or (direction, denom) repeats. |
settlement/5 | ErrSelfSettlement | counterparty must differ from proposer — ErrSelfSettlement is returned when counterparty == proposer. |
settlement/6 | ErrExpiryInPast | expiry must be after block time — ErrExpiryInPast is returned when expiry is unset or <= block time. |
settlement/7 | ErrExpiryTooFar | expiry exceeds max_ttl — ErrExpiryTooFar is returned when expiry > block time + params.max_ttl. |
settlement/8 | ErrInvalidMemoHash | memo_hash must be empty or 32 bytes — ErrInvalidMemoHash is returned when memo_hash is neither empty nor 32 bytes. |
settlement/9 | ErrSettlementNotFound | settlement not found — ErrSettlementNotFound is returned when no settlement has the id. |
settlement/10 | ErrNotCounterparty | signer is not the counterparty — ErrNotCounterparty is returned when the accept signer is not the counterparty. |
settlement/11 | ErrNotParty | signer is not a party to the settlement — ErrNotParty is returned when a cancel signer is neither party (before expiry). |
settlement/12 | ErrSettlementNotPending | settlement is not pending — ErrSettlementNotPending is returned when the settlement is in a terminal status. |
settlement/13 | ErrSettlementExpired | settlement expired — ErrSettlementExpired is returned when accepting at or after expiry. |
settlement/14 | ErrInsufficientEscrow | insufficient escrow — ErrInsufficientEscrow is returned when the escrow to release or deliver is missing. |
settlement/15 | ErrInvalidLeg | invalid leg — ErrInvalidLeg is returned when a leg has no direction or no kind, or a malformed denom. |
settlement/16 | ErrInvalidUnits | invalid units — ErrInvalidUnits is returned when a leg amount is not > 0 or exceeds 2^128-1. |
settlement/17 | ErrInvalidAssetID | invalid asset id — ErrInvalidAssetID is returned when a right leg’s asset id is not 64 lower-case hex chars. |
settlement/18 | ErrInvalidAddress | invalid address — ErrInvalidAddress is returned when a bech32 address does not parse. |
settlement/19 | ErrInvalidAuthority | invalid authority — ErrInvalidAuthority is returned when MsgUpdateParams is not signed by the module authority. |
settlement/20 | ErrInvalidParams | invalid params — ErrInvalidParams is returned when params are out of range. |
settlement/21 | ErrInvalidGenesis | invalid genesis state — ErrInvalidGenesis is returned when genesis state is malformed. |
settlement/22 | ErrInvalidStatus | invalid status — ErrInvalidStatus is returned when a status value is not a known lifecycle status. |
waterfall
| code | error | message |
|---|---|---|
waterfall/2 | ErrInvalidWaterfall | invalid waterfall — ErrInvalidWaterfall is returned for an empty tier list, more than MaxTiers, a FIXED tier with 0 amount, an unknown kind or a bad address / denom. |
waterfall/3 | ErrWaterfallImmutable | waterfall is immutable once liquidating — ErrWaterfallImmutable is returned by SetWaterfall once the asset is LIQUIDATING or LIQUIDATED. |
waterfall/4 | ErrUnauthorized | unauthorized — ErrUnauthorized is returned when the signer is not the issuer (or operator where allowed). |
waterfall/5 | ErrNotLiquidating | asset is not liquidating — ErrNotLiquidating is returned by DepositProceeds on an ACTIVE / FROZEN asset. |
waterfall/6 | ErrAlreadyLiquidating | asset is already liquidating or liquidated — ErrAlreadyLiquidating is returned by a second Liquidate. |
waterfall/7 | ErrNotLiquidated | asset is not liquidated yet — ErrNotLiquidated is returned by RunWaterfall while the exercise window is still open. |
waterfall/8 | ErrNothingToRun | nothing to run: the liquidation pool is empty — ErrNothingToRun is returned by RunWaterfall with an empty pool. |
waterfall/9 | ErrNoWaterfall | asset has no waterfall — ErrNoWaterfall is returned by RunWaterfall when the asset has no tiers. |
waterfall/10 | ErrInvalidWindow | invalid exercise window — ErrInvalidWindow is returned for a non-positive exercise window. |
waterfall/11 | ErrPoolNotFound | redemption pool not found — ErrPoolNotFound is returned when no redemption pool exists for (asset, kind, denom). |
waterfall/12 | ErrPoolInsufficient | redemption pool cannot cover the redemption — ErrPoolInsufficient is returned when units × price exceeds the pool’s remainder. |
waterfall/13 | ErrPoolClosed | redemption pool is closed — ErrPoolClosed is returned by RedeemForPool after until. |
waterfall/14 | ErrPoolOpen | redemption pool is still open — ErrPoolOpen is returned by WithdrawRedemption before until. |
waterfall/15 | ErrPriceMismatch | redemption pool price or until mismatch — ErrPriceMismatch is returned when a top-up repeats a different price or until. |
waterfall/16 | ErrInvalidPrice | invalid price or amount — ErrInvalidPrice is returned for a non-positive price or amount. |
waterfall/17 | ErrInvalidSplit | invalid split — ErrInvalidSplit is returned for a factor < 2, an unknown kind or a multiplier above MaxMultiplier. |
waterfall/19 | ErrInsufficientFunds | insufficient funds — ErrInsufficientFunds wraps a bank failure. |
Last updated