Skip to main content

Execution errors

Generated from the Sui source (MystenLabs/sui at commit e25770145) on 2026-11-16 by error_pages.py in MystenLabs/docs-data-dashboard. Do not edit this page by hand: the weekly run regenerates it from the source. To change a message, edit the #[error(...)] attribute on the variant in crates/sui-types/src/error.rs or crates/sui-types/src/execution_status.rs.

Every error the Sui execution layer and the transaction input checks can return, as the ExecutionErrorKind, CommandArgumentError, PackageUpgradeError, TypeArgumentError, and UserInputError enums in crates/sui-types define them, with the message each one renders. A placeholder in a message, shown as {...}, is filled in with the value at the time. The last column links the page that explains the error, when one does. For the most common failures and their fixes, see Troubleshooting common errors.

ExecutionErrorKind​

42 variants, defined in crates/sui-types/src/execution_status.rs.

ErrorMessageExplained on
InsufficientGasInsufficient Gas.Troubleshooting Common Errors
InvalidGasObjectInvalid Gas Object. Possibly not address-owned or possibly not a SUI coin.
InvariantViolationINVARIANT VIOLATION.Sui Validator Alert Reference
FeatureNotYetSupportedAttempted to used feature that is not supported yet
MoveObjectTooBigMove object with size {...} is larger than the maximum object size {...}
MovePackageTooBigMove package with size {...} is larger than the maximum object size {...}
CircularObjectOwnershipCircular Object Ownership, including object {...}.
InsufficientCoinBalanceInsufficient coin balance for operation.
CoinBalanceOverflowThe coin balance overflows u64
PublishErrorNonZeroAddressPublish Error, Non-zero Address. The modules in the package must have their self-addresses set to zero.
SuiMoveVerificationErrorSui Move Bytecode Verification Error. Please run the Sui Move Verifier for more information.
MovePrimitiveRuntimeErrorMove Primitive Runtime Error. Location: {...}. Arithmetic error, stack overflow, max value depth, etc.
MoveAbortMove Runtime Abort. Location: {...}, Abort Code: {...}Troubleshooting Common Errors
VMVerificationOrDeserializationErrorMove Bytecode Verification Error. Please run the Bytecode Verifier for more information.Troubleshooting Common Errors
VMInvariantViolationMOVE VM INVARIANT VIOLATION.
FunctionNotFoundFunction Not Found.
ArityMismatchArity mismatch for Move function. The number of arguments does not match the number of parameters
TypeArityMismatchType arity mismatch for Move function. Mismatch between the number of actual versus expected type arguments.
NonEntryFunctionInvokedNon Entry Function Invoked. Move Call must start with an entry function
CommandArgumentErrorInvalid command argument at {...}. {...}
TypeArgumentErrorError for type argument at index {...}: {...}
UnusedValueWithoutDropUnused result without the drop ability. Command result {...}, return value {...}Troubleshooting Common Errors, Staking Rewards
InvalidPublicFunctionReturnTypeInvalid public Move function signature. Unsupported return type for return value {...}
InvalidTransferObjectInvalid Transfer Object, object does not have public transfer.
EffectsTooLargeEffects of size {...} bytes too large. Limit is {...} bytes
PublishUpgradeMissingDependencyPublish/Upgrade Error, Missing dependency. A dependency of a published or upgraded package has not been assigned an on-chain address.
PublishUpgradeDependencyDowngradePublish/Upgrade Error, Dependency downgrade. Indirect (transitive) dependency of published or upgraded package has been assigned an on-chain version that is less than the version required by one of the package's transitive dependencies.
PackageUpgradeErrorInvalid package upgrade. {...}
WrittenObjectsTooLargeWritten objects of {...} bytes too large. Limit is {...} bytes
CertificateDeniedCertificate is on the deny list
SuiMoveVerificationTimedoutSui Move Bytecode Verification Timeout. Please run the Sui Move Verifier for more information.
SharedObjectOperationNotAllowedThe shared object operation is not allowed.
InputObjectDeletedCertificate cannot be executed due to a dependency on a deleted shared object or an object that was transferred out of consensus
ExecutionCancelledDueToSharedObjectCongestionCertificate is cancelled due to congestion on shared objects: {...}
AddressDeniedForCoinAddress {...} is denied for coin {...}
CoinTypeGlobalPauseCoin type is globally paused for use: {...}
ExecutionCancelledDueToRandomnessUnavailableCertificate is cancelled because randomness could not be generated this epoch
MoveVectorElemTooBigMove vector element (passed to MakeMoveVec) with size {...} is larger than the maximum size {...}. Note that this maximum is scaled based on the type of the vector element.
MoveRawValueTooBigMove value (possibly an upgrade ticket or a dev-inspect value) with size {...} is larger than the maximum size {...}. Note that this maximum is scaled based on the type of the value.
InvalidLinkageA valid linkage was unable to be determined for the transaction
InsufficientFundsForWithdrawInsufficient funds for funds accumulator withdrawal
NonExclusiveWriteInputObjectModifiedNon-exclusive write input object {...} has been modified

CommandArgumentError​

20 variants, defined in crates/sui-types/src/execution_status.rs.

ErrorMessageExplained on
TypeMismatchThe type of the value does not match the expected type
InvalidBCSBytesThe argument cannot be deserialized into a value of the specified type
InvalidUsageOfPureArgThe argument cannot be instantiated from raw bytes
InvalidArgumentToPrivateEntryFunctionInvalid argument to private entry function. These functions cannot take arguments from other Move functions
IndexOutOfBoundsOut of bounds access to input or result vector {...}
SecondaryIndexOutOfBoundsOut of bounds secondary access to result vector {...} at secondary index {...}
InvalidResultArityInvalid usage of result {...}, expected a single result but found either no return values or multiple.
InvalidGasCoinUsageInvalid taking of the Gas coin. It can only be used by-value with TransferObjects
InvalidValueUsageInvalid usage of value. Mutably borrowed values require unique usage. Immutably borrowed values cannot be taken or borrowed mutably. Taken values cannot be used again.
InvalidObjectByValueImmutable objects cannot be passed by-value.
InvalidObjectByMutRefImmutable objects cannot be passed by mutable reference, &mut.
SharedObjectOperationNotAllowedShared object operations such a wrapping, freezing, or converting to owned are not allowed.
InvalidArgumentArityInvalid argument arity. Expected a single argument but found a result that expanded to multiple arguments.
InvalidTransferObjectObject passed to TransferObject does not have public transfer, i.e. the `store` ability
InvalidMakeMoveVecNonObjectArgumentFirst argument to MakeMoveVec is not an object. If no type is specified for MakeMoveVec, all arguments must be the same object type.
ArgumentWithoutValueSpecified argument location does not have a value and cannot be used
CannotMoveBorrowedValueCannot move a borrowed value. The value's type does resulted in this argument usage being inferred as a move. This is likely due to the type not having the `copy` ability; although in rare cases, it could also be this is the last usage of a value without the `drop` ability.
CannotWriteToExtendedReferenceCannot write to an argument location that is still borrowed, and where that borrow is an extension of that reference. This is likely due to this argument being used in a Move call that returns a reference, and that reference is used in a later command.
InvalidReferenceArgumentThe argument specified cannot be used as a reference argument in the Move call. Either the argument is a mutable reference and it conflicts with another argument to the call, or the argument is mutable and another reference extends it and will be used in a later command.
InvalidTxContextInvalid usage of TxContext in the function signature. TxContext can only be used by reference, `&TxContext` or `&mut TxContext`. If used mutably, it must be the only TxContext parameter, and TxContext can never be returned from a Move call.

PackageUpgradeError​

6 variants, defined in crates/sui-types/src/execution_status.rs.

ErrorMessageExplained on
UnableToFetchPackageUnable to fetch package at {...}
NotAPackageObject {...} is not a package
IncompatibleUpgradeNew package is incompatible with previous version
DigestDoesNotMatchDigest in upgrade ticket and computed digest disagree
UnknownUpgradePolicyUpgrade policy {...} is not a valid upgrade policy
PackageIDDoesNotMatchPackage ID {...} does not match package ID in upgrade ticket {...}

TypeArgumentError​

2 variants, defined in crates/sui-types/src/execution_status.rs.

ErrorMessageExplained on
TypeNotFoundA type was not found in the module specified.
ConstraintNotSatisfiedA type provided did not match the specified constraints.

UserInputError​

66 variants, defined in crates/sui-types/src/error.rs.

ErrorMessageExplained on
MutableObjectUsedMoreThanOnceMutable object {...} cannot appear more than one in one transaction
ObjectInputArityViolationWrong number of parameters for the transaction
ObjectNotFoundCould not find the referenced object {...} at version {...}
ObjectVersionUnavailableForConsumptionTransaction needs to be rebuilt because object {...} version {...} ({...}) is unavailable for consumption, current version: {...}
PackageVerificationTimeoutPackage verification failed: {...}
DependentPackageNotFoundDependent package not found on-chain: {...}
ImmutableParameterExpectedErrorMutable parameter provided, immutable parameter expected
SizeLimitExceededSize limit exceeded: {...} is {...}
InvalidChildObjectArgumentObject {...} is owned by object {...}. Objects owned by other objects cannot be used as input arguments
InvalidObjectDigestInvalid Object digest for object {...}. Expected digest : {...}
InvalidSequenceNumberSequence numbers above the maximal value are not usable for transfers
MovePackageAsObjectA move object is expected, instead a move package is passed: {...}
MoveObjectAsPackageA move package is expected, instead a move object is passed: {...}
IncorrectUserSignatureTransaction was not signed by the correct sender: {...}
NotSharedObjectErrorObject used as shared is not shared
DuplicateObjectRefInputThe transaction inputs contain duplicated ObjectRef's
MissingGasPaymentTransaction gas payment missing
GasObjectNotOwnedObjectGas object is not an owned object with owner: {...}
GasBudgetTooHighGas budget: {...} is higher than max: {...}
GasBudgetTooLowGas budget: {...} is lower than min: {...}
GasBalanceTooLowBalance of gas object {...} is lower than the needed amount: {...}
UnsupportedSponsoredTransactionKindTransaction kind does not support Sponsored Transaction
GasPriceUnderRGPGas price {...} under reference gas price (RGP) {...}
GasPriceTooHighGas price cannot exceed {...} mist
InvalidGasObjectObject {...} is not a gas object
InsufficientBalanceToCoverMinimalGasGas object does not have enough balance to cover minimal gas spend
ObjectSequenceNumberTooHighCould not find the referenced object {...} as the asked version {...} is higher than the latest {...}
ObjectDeletedObject deleted at reference ({...}, {...}, {...})
InvalidBatchTransactionInvalid Batch Transaction: {...}
BlockedMoveFunctionThis Move function is currently disabled and not available for call
EmptyInputCoinsEmpty input coins for Pay related transaction
UnexpectedGasPaymentObjectSUI payment transactions use first input coin for gas payment, but found a different gas object
SharedObjectStartingVersionMismatchWrong initial version given for shared object
TransferObjectWithoutPublicTransferErrorAttempt to transfer object {...} that does not have public transfer. Object transfer must be done instead using a distinct Move function call
EmptyCommandInputTransferObjects, MergeCoin, and Publish cannot have empty arguments. If MakeMoveVec has empty arguments, it must have a type specified
TransactionDeniedTransaction is denied: {...}
UnsupportedFeature is not supported: {...}
MoveFunctionInputErrorQuery transactions with move function input error: {...}
VerifiedCheckpointNotFoundVerified checkpoint not found for sequence number: {...}
VerifiedCheckpointDigestNotFoundVerified checkpoint not found for digest: {...}
LatestCheckpointSequenceNumberNotFoundLatest checkpoint sequence number not found
CheckpointContentsNotFoundCheckpoint contents not found for digest: {...}
GenesisTransactionNotFoundGenesis transaction not found
TransactionCursorNotFoundTransaction {...} not found
InaccessibleSystemObjectObject {...} is a system object and cannot be accessed by user transactions
MaxPublishCountExceeded{...} max publish/upgrade commands allowed, {...} provided
MutableParameterExpectedImmutable parameter provided, mutable parameter expected
AddressDeniedForCoinAddress {...} is denied for coin {...}
PostRandomCommandRestrictionsCommands following a command with Random can only be TransferObjects or MergeCoins
InvalidArgumentIndexInvalid argument at command {...}, argument {...}: index {...} is out of bounds
TooManyTransactionsInBatchNumber of transactions ({...}) exceeds the maximum allowed ({...}) in a batch
TotalTransactionSizeTooLargeInBatchTotal transactions size ({...}) bytes exceeds the maximum allowed ({...}) bytes in a Soft Bundle
NoSharedObjectErrorTransaction {...} in Soft Bundle contains no shared objects
AlreadyExecutedInSoftBundleErrorTransaction {...} in Soft Bundle has already been executed
CertificateAlreadyProcessedAt least one certificate in Soft Bundle has already been processed
TransactionAlreadyExecutedTransaction {...} was already executed
GasPriceMismatchErrorGas price for transaction {...} in Soft Bundle mismatch: want {...}, have {...}
CoinTypeGlobalPauseCoin type is globally paused for use: {...}
InvalidIdentifierInvalid identifier found in the transaction: {...}
NotOwnedObjectErrorObject used as owned is not owned
InvalidWithdrawReservationInvalid withdraw reservation: {...}
MissingTransactionExpirationTransaction with empty gas payment must specify an expiration.
InvalidExpirationInvalid transaction expiration: {...}
InvalidChainIdTransaction chain ID {...} does not match network chain ID {...}.
RepeatedTransactionsTransaction {...} appears more than once in the request
ProposerNotAllowedValidator {...} is not an allowed proposer of this transaction