Quickstart
- Knowledge Base
  - Introduction
  - Get support
Connect
- FAQs
  - Auth FAQ
  - Account Abstraction FAQ
  - In-App Wallets FAQ
  - Connect FAQ
Contracts
- FAQs
  - Explore FAQ
  - Publish FAQ
  - Build FAQ
  - Deploy FAQ
  - Interact FAQ
- How To
  - Claim from drop contract using contract explorer
  - Importing non-thirdweb contracts into the Dashboard
  - Airdrop Contract Troubleshooting
  - Trouble Claiming from the Embed
  - Customizing the Embed
  - Batch Upload Troubleshooting
  - Transferring ownership of a contract
  - How to close Auction Listings in a Marketplace
  - Take a Snapshot of Existing Holders
  - openPack Function out of gas
  - NFT Drop claim function parameters
  - NFT metadata structure
  - WalletConnect Prefab Required for Connect Wallet (Native) Prefab
  - How to use the multicall() function
  - Start Token ID at 1 instead of 0
  - Why can’t I claim an NFT from the embed on mobile?
  - Where can I see the audited contract reports?
  - How can I get my NFTs to show up on OpenSea or other marketplaces?
  - What are Platform Fees?
  - Why am I unable to use the same token for staking and rewards?
  - Understanding gas, Gwei, and cost saving strategies
  - How to make your NFTs non-transferrable aka Soulbound
  - SetApprovalForAll: what it means to grant access to all your NFTs
  - Staking Contract Troubleshooting - Not Owned or Approved
  - Token showing “Mintable” on dex scanner after renouncing
  - When will my collection show up on OpenSea?
  - My Collection is Not Showing Up
  - My Collection is Not Showing Up
  - NFTs Aren’t Revealing
Engine
- FAQs
  - Change my Engine admin (Cloud-hosted)
  - Using Engine as a relayer
  - Run Engine locally
  - Deploy Engine on Railway
  - Deploy contracts using OP Credits with thirdweb Engine
  - Unable to connect to Engine: Ensure that your Engine is publicly accessible
  - Cloud-hosted vs self-hosted Engine
  - Error: DEPTH_ZERO_SELF_SIGNED_CERT (Self-hosted)
Infra
- FAQs
  - RPC
  - Storage
- How To
  - Blockscout API contract verification
  - Token verification on Etherscan
  - Blockscout API contract verification
  - Token verification on Etherscan
General thirdweb Issues
- FAQs
  - Billing
  - Security & Privacy
- React
  - How to display a custom token on ConnectButton
  - How to migrate read-only hooks from thirdweb v4 to v5
  - How to get the signer for connected wallet
- Javascript
  - How to generate a private key account using the thirdweb SDK
  - How to generate merkle root for airdrop contract using SDK
  - How to take a snapshot of an ERC721 collection
  - How to check if a provided address is a contract address or wallet address
  - How to verify a contract using thirdweb SDK
  - How to check if a contract is an ERC721/ERC1155/ERC20 contract
  - How to fetch contract metadata
  - How to retrieve tokenIds from the lazyMint method
  - How to shuffle items when lazy minting
  - How to get all tokenIDs in an NFT contract
- Others
  - How to resolve ENS address
  - How to resolve ENS avatar
  - How to resolve ENS name?
  - How to signature mint using the thirdweb v5 SDK
  - How to update NFT metadata for drop contract via thirdweb SDK
  - How to update NFT metadata for via NFT Collection/Edition Contract
  - How to distribute funds on spilt contract with explorer
  - How to Find NFTs by Owner for an NFT Drop Contract
  - How to add a contract to the thirdweb dashboard via code
  - How to update the metadata for multiple NFTs
  - How to find the contract address from your transaction hash after deploying a contract
  - How to upload a single NFT via thirdweb explorer?
  - How to secure your API Keys
  - How to transfer native tokens
  - How to add a custom RPC URL into your front-end, backend, or dashboard
  - How to add your EVM chain to thirdweb’s Chainlist?
Commonly Seen Onchain Errors
- Application errors
  - This action requires a connected wallet to sign the transaction. Please pass a valid signer to the SDK.
  - [ethjs-query] while formatting outputs from RPC
  - Unity Error: "Multiple precompiled assemblies with the same name Newtonsoft.Json.dll included on the current platform”
  - Unity SDK Error: this functionality is not yet supported on the current platform
  - How to share your console log errors
  - 401 Unauthorized
  - Unauthorized - You don't have permission to use this service
  - We are not able to process your request at this time. Please contact thirdweb support.
  - ERR_FAILED_413
- RPC Errors
  - Transaction underpriced
  - Replacement transaction underpriced / Replacement fee too low
  - Cannot estimate gas; transaction may fail or may require manual gas limit
  - Nonce too low: next nonce #, tx nonce #
  - Nonce too high
  - ErrorData: 0x
  - Execution reverted (-32000)
  - Invalid request (-32600)
  - Invalid params / Invalid arguments (-32602)
- Onchain Errors
  - AA21 didn’t pay prefund
  - Paymaster deposit too low
  - Invalid UserOperation signature or paymaster signature
  - Execution Reverted: !Tokens
  - Execution reverted: !QTY
  - Execution reverted: ST
  - Insufficient funds for gas * price + value / Insufficient funds for intrinsic transaction cost
  - Execution reverted: !BAL20
  - Execution reverted: !BALNFT
  - Execution reverted: proof claimed
  - Execution reverted: !ADMIN
  - Execution reverted: !CONDITION
  - Execution Reverted: Not within the sale window
  - Execution Reverted: !Amt Error
  - ERC20 - Transfer Amount Exceeds Allowance
  - Account 0x… is missing role 0x…
  - Execution reverted !V
- CLI Errors
  - npm ERR! syscall spawn git
  - Issue linking device on the authorization page via thirdweb cli
General
Payments
More

Cannot estimate gas; transaction may fail or may require manual gas limit

This error may include "code":"UNPREDICTABLE_GAS_LIMIT”.

What it means

There was an error simulating the transaction in order to estimate the gas. This indicates the transaction is expected to fail (”revert”) onchain and was rejected by the RPC. No gas is consumed.

How to fix it

Simulate your transaction with the thirdweb Transaction Simulator or the simulateTransaction SDK method to get the error returned by the contract logic, if any.

See the Execution reverted article for more troubleshooting steps.

Did this answer your question?

😞

😐

🤩

Replacement transaction underpriced / Replacement fee too low Nonce too low: next nonce #, tx nonce #