Exceptions - Gearbox Protocol Core V3

Gearbox Protocol uses custom errors for gas-efficient error handling. All errors are defined in IExceptions.sol.

General Errors

ZeroAddressException

error ZeroAddressException()

Thrown when attempting to set an important address to zero address.

AmountCantBeZeroException

error AmountCantBeZeroException()

Thrown when attempting to pass a zero amount to a funding-related operation.

IncorrectParameterException

error IncorrectParameterException()

Thrown on incorrect input parameter.

InsufficientBalanceException

error InsufficientBalanceException()

Thrown when balance is insufficient to perform an operation.

ValueOutOfRangeException

error ValueOutOfRangeException()

Thrown when a parameter is out of acceptable range.

ReceiveIsNotAllowedException

error ReceiveIsNotAllowedException()

Thrown when trying to send ETH to a contract that is not allowed to receive ETH directly.

AddressIsNotContractException

error AddressIsNotContractException(address)

Thrown when attempting to set an EOA as an important contract in the system.

address

The address that is not a contract

TokenNotAllowedException

error TokenNotAllowedException()

Thrown when attempting to receive a token that is not a collateral token or was forbidden.

TokenAlreadyAddedException

error TokenAlreadyAddedException()

Thrown when attempting to add a token that is already in a collateral list.

TokenIsNotQuotedException

error TokenIsNotQuotedException()

Thrown when attempting to use quota-related logic for a token that is not quoted in quota keeper.

TargetContractNotAllowedException

error TargetContractNotAllowedException()

Thrown when attempting to interact with an address that is not a valid target contract.

NotImplementedException

error NotImplementedException()

Thrown when a function is not implemented.

Contracts Register Errors

RegisteredCreditManagerOnlyException

error RegisteredCreditManagerOnlyException()

Thrown when an address is expected to be a registered credit manager, but is not.

RegisteredPoolOnlyException

error RegisteredPoolOnlyException()

Thrown when an address is expected to be a registered pool, but is not.

Address Provider Errors

AddressNotFoundException

error AddressNotFoundException()

Thrown when an address key is not found in address provider.

Pool Errors

IncompatibleCreditManagerException

error IncompatibleCreditManagerException()

Thrown when a credit manager being connected has a wrong pool address.

IncompatibleSuccessorException

error IncompatibleSuccessorException()

Thrown when attempting to set an incompatible successor staking contract.

VotingContractNotAllowedException

error VotingContractNotAllowedException()

Thrown when attempting to vote in a non-approved contract.

InsufficientVotesException

error InsufficientVotesException()

Thrown when attempting to unvote more votes than exist.

BorrowingMoreThanU2ForbiddenException

error BorrowingMoreThanU2ForbiddenException()

Thrown when attempting to borrow more than the second point on a two-point curve.

CreditManagerCantBorrowException

error CreditManagerCantBorrowException()

Thrown when a credit manager attempts to borrow more than its limit in the current block, or in general.

IncompatiblePoolQuotaKeeperException

error IncompatiblePoolQuotaKeeperException()

Thrown when attempting to connect a quota keeper to an incompatible pool.

IncompatibleGaugeException

error IncompatibleGaugeException()

Thrown when attempting to connect a gauge to an incompatible pool quota keeper.

QuotaIsOutOfBoundsException

error QuotaIsOutOfBoundsException()

Thrown when the quota is outside of min/max bounds.

Credit Manager Errors

NotEnoughCollateralException

error NotEnoughCollateralException()

Thrown when failing a full collateral check after multicall.

AllowanceFailedException

error AllowanceFailedException()

Thrown when an attempt to approve a collateral token to adapter’s target contract fails.

CreditAccountDoesNotExistException

error CreditAccountDoesNotExistException()

Thrown when attempting to perform an action for a credit account that does not exist.

TooManyTokensException

error TooManyTokensException()

Thrown when configurator attempts to add more than 255 collateral tokens.

TooManyEnabledTokensException

error TooManyEnabledTokensException()

Thrown when more than the maximum number of tokens were enabled on a credit account.

ActiveCreditAccountNotSetException

error ActiveCreditAccountNotSetException()

Thrown when attempting to execute a protocol interaction without active credit account set.

DebtUpdatedTwiceInOneBlockException

error DebtUpdatedTwiceInOneBlockException()

Thrown when trying to update credit account’s debt more than once in the same block.

DebtToZeroWithActiveQuotasException

error DebtToZeroWithActiveQuotasException()

Thrown when trying to repay all debt while having active quotas.

UpdateQuotaOnZeroDebtAccountException

error UpdateQuotaOnZeroDebtAccountException()

Thrown when a zero-debt account attempts to update quota.

CloseAccountWithNonZeroDebtException

error CloseAccountWithNonZeroDebtException()

Thrown when attempting to close an account with non-zero debt.

InsufficientRemainingFundsException

error InsufficientRemainingFundsException()

Thrown when value of funds remaining on the account after liquidation is insufficient.

ActiveCreditAccountOverridenException

error ActiveCreditAccountOverridenException()

Thrown when Credit Facade tries to write over a non-zero active credit account.

Credit Configurator Errors

IncorrectTokenContractException

error IncorrectTokenContractException()

Thrown when attempting to use a non-ERC20 contract or an EOA as a token.

IncorrectLiquidationThresholdException

error IncorrectLiquidationThresholdException()

Thrown when the newly set liquidation threshold is zero or greater than the underlying’s LT.

IncorrectLimitsException

error IncorrectLimitsException()

Thrown when borrowing limits are incorrect: minLimit > maxLimit or maxLimit > blockLimit.

IncorrectExpirationDateException

error IncorrectExpirationDateException()

Thrown when the new expiration date is less than the current expiration date or current timestamp.

IncompatibleContractException

error IncompatibleContractException()

Thrown when a contract returns a wrong credit manager or reverts when trying to retrieve it.

AdapterIsNotRegisteredException

error AdapterIsNotRegisteredException()

Thrown when attempting to forbid an adapter that is not registered in the credit manager.

IncorrectAdaptersSetException

error IncorrectAdaptersSetException()

Thrown when new credit configurator’s set of allowed adapters differs from the current one.

RampDurationTooShortException

error RampDurationTooShortException()

Thrown when attempting to schedule a token’s LT ramping that is too short in duration.

InconsistentLiquidationFeesException

error InconsistentLiquidationFeesException()

Thrown when attempting to set liquidation fees such that the sum of premium and fee changes.

InconsistentExpiredLiquidationFeesException

error InconsistentExpiredLiquidationFeesException()

Thrown when attempting to set expired liquidation fees such that the sum of premium and fee changes.

Credit Facade Errors

ForbiddenInWhitelistedModeException

error ForbiddenInWhitelistedModeException()

Thrown when attempting to perform an action that is forbidden in whitelisted mode.

NotAllowedWhenNotExpirableException

error NotAllowedWhenNotExpirableException()

Thrown when credit facade is not expirable, and attempted action requires expirability.

UnknownMethodException

error UnknownMethodException(bytes4 selector)

Thrown when a selector that doesn’t match any allowed function is passed to the credit facade in a multicall.

selector

bytes4

The unknown function selector

CreditAccountNotLiquidatableException

error CreditAccountNotLiquidatableException()

Thrown when a liquidator tries to liquidate an account with a health factor above 1.

CreditAccountNotLiquidatableWithLossException

error CreditAccountNotLiquidatableWithLossException()

Thrown when a liquidator tries to liquidate an account with loss but violates the loss policy.

BorrowedBlockLimitException

error BorrowedBlockLimitException()

Thrown when too much new debt was taken within a single block.

BorrowAmountOutOfLimitsException

error BorrowAmountOutOfLimitsException()

Thrown when the new debt principal for a credit account falls outside of borrowing limits.

NotAllowedAfterExpirationException

error NotAllowedAfterExpirationException()

Thrown when a user attempts to open an account via an expired credit facade.

ExpectedBalancesAlreadySetException

error ExpectedBalancesAlreadySetException()

Thrown when expected balances are attempted to be set twice without performing a slippage check.

ExpectedBalancesNotSetException

error ExpectedBalancesNotSetException()

Thrown when attempting to perform a slippage check when expected balances are not set.

BalanceLessThanExpectedException

error BalanceLessThanExpectedException(address token)

Thrown when balance of at least one token is less than expected during a slippage check.

token

address

The token with insufficient balance

ForbiddenTokensException

error ForbiddenTokensException(uint256 forbiddenTokensMask)

Thrown when trying to perform an action that is forbidden when credit account has enabled forbidden tokens.

forbiddenTokensMask

uint256

Bitmask of forbidden tokens

ForbiddenTokenQuotaIncreasedException

error ForbiddenTokenQuotaIncreasedException(address token)

Thrown when forbidden token quota is increased during the multicall.

token

address

The forbidden token

ForbiddenTokenBalanceIncreasedException

error ForbiddenTokenBalanceIncreasedException(address token)

Thrown when enabled forbidden token balance is increased during the multicall.

token

address

The forbidden token

RemainingTokenBalanceIncreasedException

error RemainingTokenBalanceIncreasedException(address token)

Thrown when the remaining token balance is increased during liquidation.

token

address

The token with increased balance

NotApprovedBotException

error NotApprovedBotException(address bot)

Thrown when botMulticall is called by an address that is not approved by account owner or is forbidden.

bot

address

The unapproved bot address

NoPermissionException

error NoPermissionException(uint256 permission)

Thrown when attempting to perform a multicall action with no permission for it.

permission

uint256

The missing permission

UnexpectedPermissionsException

error UnexpectedPermissionsException(uint256 permissions)

Thrown when attempting to give a bot unexpected permissions.

permissions

uint256

The unexpected permissions

CustomHealthFactorTooLowException

error CustomHealthFactorTooLowException()

Thrown when a custom health factor parameter lower than 10000 (100%) is passed into the full collateral check.

InvalidCollateralHintException

error InvalidCollateralHintException(uint256 mask)

Thrown when submitted collateral hint is not a valid token mask.

mask

uint256

The invalid mask

UnderlyingIsNotLiquidatableException

error UnderlyingIsNotLiquidatableException()

Thrown when trying to seize underlying token during partial liquidation.

SeizedLessThanRequiredException

error SeizedLessThanRequiredException(uint256 seizedAmount)

Thrown when amount of collateral seized during partial liquidation is less than required.

seizedAmount

uint256

The actual seized amount

Access Control Errors

CallerNotCreditAccountOwnerException

error CallerNotCreditAccountOwnerException()

Thrown when attempting to call an access restricted function not as credit account owner.

CallerNotConfiguratorException

error CallerNotConfiguratorException()

Thrown when attempting to call an access restricted function not as configurator.

CallerNotAccountFactoryException

error CallerNotAccountFactoryException()

Thrown when attempting to call an access restricted function not as account factory.

CallerNotCreditManagerException

error CallerNotCreditManagerException()

Thrown when attempting to call an access restricted function not as credit manager.

CallerNotCreditFacadeException

error CallerNotCreditFacadeException()

Thrown when attempting to call an access restricted function not as credit facade.

CallerNotPausableAdminException

error CallerNotPausableAdminException()

Thrown when attempting to pause a contract without pausable admin rights.

CallerNotUnpausableAdminException

error CallerNotUnpausableAdminException()

Thrown when attempting to unpause a contract without unpausable admin rights.

CallerNotGaugeException

error CallerNotGaugeException()

Thrown when attempting to call an access restricted function not as gauge.

CallerNotPoolQuotaKeeperException

error CallerNotPoolQuotaKeeperException()

Thrown when attempting to call an access restricted function not as quota keeper.

CallerNotVoterException

error CallerNotVoterException()

Thrown when attempting to call an access restricted function not as voter.

CallerNotAdapterException

error CallerNotAdapterException()

Thrown when attempting to call an access restricted function not as allowed adapter.

CallerNotMigratorException

error CallerNotMigratorException()

Thrown when attempting to call an access restricted function not as migrator.

CallerNotExecutorException

error CallerNotExecutorException()

Thrown when an address that is not the designated executor attempts to execute a transaction.

CallerNotVetoAdminException

error CallerNotVetoAdminException()

Thrown when attempting to call an access restricted function not as veto admin.

Bot List Errors

InvalidBotException

error InvalidBotException()

Thrown when attempting to set non-zero permissions for a forbidden bot.

IncorrectBotPermissionsException

error IncorrectBotPermissionsException()

Thrown when attempting to set permissions for a bot that don’t meet its requirements.

TooManyActiveBotsException

error TooManyActiveBotsException()

Thrown when attempting to set non-zero permissions for too many bots.

Account Factory Errors

MasterCreditAccountAlreadyDeployedException

error MasterCreditAccountAlreadyDeployedException()

Thrown when trying to deploy second master credit account for a credit manager.

CreditAccountIsInUseException

error CreditAccountIsInUseException()

Thrown when trying to rescue funds from a credit account that is currently in use.

Price Oracle Errors

IncorrectPriceFeedException

error IncorrectPriceFeedException()

Thrown when attempting to set a token price feed to an address that is not a correct price feed.

PriceFeedDoesNotExistException

error PriceFeedDoesNotExistException()

Thrown when attempting to interact with a price feed for a token not added to the price oracle.

PriceFeedIsNotUpdatableException

error PriceFeedIsNotUpdatableException()

Thrown when trying to apply an on-demand price update to a non-updatable price feed.

IncorrectPriceException

error IncorrectPriceException()

Thrown when price feed returns incorrect price for a token.

StalePriceException

error StalePriceException()

Thrown when token’s price feed becomes stale.

Core Interfaces

Data Structures

Events & Errors

​General Errors

​ZeroAddressException

​AmountCantBeZeroException

​IncorrectParameterException

​InsufficientBalanceException

​ValueOutOfRangeException

​ReceiveIsNotAllowedException

​AddressIsNotContractException

​TokenNotAllowedException

​TokenAlreadyAddedException

​TokenIsNotQuotedException

​TargetContractNotAllowedException

​NotImplementedException

​Contracts Register Errors

​RegisteredCreditManagerOnlyException

​RegisteredPoolOnlyException

​Address Provider Errors

​AddressNotFoundException

​Pool Errors

​IncompatibleCreditManagerException

​IncompatibleSuccessorException

​VotingContractNotAllowedException

​InsufficientVotesException

​BorrowingMoreThanU2ForbiddenException

​CreditManagerCantBorrowException

​IncompatiblePoolQuotaKeeperException

​IncompatibleGaugeException

​QuotaIsOutOfBoundsException

​Credit Manager Errors

​NotEnoughCollateralException

​AllowanceFailedException

​CreditAccountDoesNotExistException

​TooManyTokensException

​TooManyEnabledTokensException

​ActiveCreditAccountNotSetException

​DebtUpdatedTwiceInOneBlockException

​DebtToZeroWithActiveQuotasException

​UpdateQuotaOnZeroDebtAccountException

​CloseAccountWithNonZeroDebtException

​InsufficientRemainingFundsException

​ActiveCreditAccountOverridenException

​Credit Configurator Errors

​IncorrectTokenContractException

​IncorrectLiquidationThresholdException

​IncorrectLimitsException

​IncorrectExpirationDateException

​IncompatibleContractException

​AdapterIsNotRegisteredException

​IncorrectAdaptersSetException

​RampDurationTooShortException

​InconsistentLiquidationFeesException

​InconsistentExpiredLiquidationFeesException

​Credit Facade Errors

​ForbiddenInWhitelistedModeException

​NotAllowedWhenNotExpirableException

​UnknownMethodException

​CreditAccountNotLiquidatableException

​CreditAccountNotLiquidatableWithLossException

​BorrowedBlockLimitException

​BorrowAmountOutOfLimitsException

​NotAllowedAfterExpirationException

​ExpectedBalancesAlreadySetException

​ExpectedBalancesNotSetException

​BalanceLessThanExpectedException

​ForbiddenTokensException

​ForbiddenTokenQuotaIncreasedException

​ForbiddenTokenBalanceIncreasedException

​RemainingTokenBalanceIncreasedException

​NotApprovedBotException

​NoPermissionException

​UnexpectedPermissionsException

​CustomHealthFactorTooLowException

​InvalidCollateralHintException

​UnderlyingIsNotLiquidatableException

​SeizedLessThanRequiredException

​Access Control Errors

​CallerNotCreditAccountOwnerException

General Errors

ZeroAddressException

AmountCantBeZeroException

IncorrectParameterException

InsufficientBalanceException

ValueOutOfRangeException

ReceiveIsNotAllowedException

AddressIsNotContractException

TokenNotAllowedException

TokenAlreadyAddedException

TokenIsNotQuotedException

TargetContractNotAllowedException

NotImplementedException

Contracts Register Errors

RegisteredCreditManagerOnlyException

RegisteredPoolOnlyException

Address Provider Errors

AddressNotFoundException

Pool Errors

IncompatibleCreditManagerException

IncompatibleSuccessorException

VotingContractNotAllowedException

InsufficientVotesException

BorrowingMoreThanU2ForbiddenException

CreditManagerCantBorrowException

IncompatiblePoolQuotaKeeperException

IncompatibleGaugeException

QuotaIsOutOfBoundsException

Credit Manager Errors

NotEnoughCollateralException

AllowanceFailedException

CreditAccountDoesNotExistException

TooManyTokensException

TooManyEnabledTokensException

ActiveCreditAccountNotSetException

DebtUpdatedTwiceInOneBlockException

DebtToZeroWithActiveQuotasException

UpdateQuotaOnZeroDebtAccountException

CloseAccountWithNonZeroDebtException

InsufficientRemainingFundsException

ActiveCreditAccountOverridenException

Credit Configurator Errors

IncorrectTokenContractException

IncorrectLiquidationThresholdException

IncorrectLimitsException

IncorrectExpirationDateException

IncompatibleContractException

AdapterIsNotRegisteredException

IncorrectAdaptersSetException

RampDurationTooShortException

InconsistentLiquidationFeesException

InconsistentExpiredLiquidationFeesException

Credit Facade Errors

ForbiddenInWhitelistedModeException

NotAllowedWhenNotExpirableException

UnknownMethodException

CreditAccountNotLiquidatableException

CreditAccountNotLiquidatableWithLossException

BorrowedBlockLimitException

BorrowAmountOutOfLimitsException

NotAllowedAfterExpirationException

ExpectedBalancesAlreadySetException

ExpectedBalancesNotSetException

BalanceLessThanExpectedException

ForbiddenTokensException

ForbiddenTokenQuotaIncreasedException

ForbiddenTokenBalanceIncreasedException

RemainingTokenBalanceIncreasedException

NotApprovedBotException

NoPermissionException

UnexpectedPermissionsException

CustomHealthFactorTooLowException

InvalidCollateralHintException

UnderlyingIsNotLiquidatableException

SeizedLessThanRequiredException

Access Control Errors

CallerNotCreditAccountOwnerException

CallerNotConfiguratorException

CallerNotAccountFactoryException

CallerNotCreditManagerException