Contracts – Knowledge Base by thirdweb

Quickstart
- Knowledge Base
  - thirdweb Support Onboarding Guide
  - Introduction
  - Get support
Connect
- FAQs
  - Auth FAQ
  - Account Abstraction FAQ
  - In-App Wallets FAQ
  - Connect FAQ
- How To
  - How to Register Your thirdweb Ecosystem Wallet with WalletConnect (now Reown)
  - How to Configure Paymaster and Bundler URLs for Account Abstraction
Contracts
- FAQs
  - Explore FAQ
  - Publish FAQ
  - Build FAQ
  - Deploy FAQ
  - Interact FAQ
- How To
  - Troubleshooting: RPC Rate Limit Exceeded on the Free Plan
  - Troubleshooting: Contract Deployment Minter Error
  - Troubleshooting: Missing EMBED Menu in Contracts
  - How to Batch Upload NFTs with GLB Files and GIF Previews
  - Claim from drop contract using contract explorer
  - Importing non-thirdweb contracts into the Dashboard
  - Airdrop Contract Troubleshooting
  - Trouble Claiming from the Embed
  - Batch Upload Troubleshooting
  - How to Prevent NFT Listings on Marketplaces
  - 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
  - Security & Privacy
- React
  - How to deploy NFT Drop template to Railway
  - How to deploy an NFT Mint site template? [NO CODE]
  - 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
  - Troubleshooting: Testnet Faucet Funds
  - Troubleshooting: Custom Token Visibility in the "Send Funds" Section
  - Troubleshooting: Charges on the Starter Plan
  - How to Use NFT Drop template as Embed to your Website
  - 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
- FAQs
  - FAQ: Free Plan vs Starter Plan
  - FAQ: How can I request the addition of my blockchain network to thirdweb's platform?
  - FAQ: Does thirdweb Support Deploying Smart Contracts on the Solana Network?
  - FAQ: Can I Fetch the Private Key or Secret Phrase of In-App Wallets via the API?
Payments
More

FAQs

Explore FAQ

Publish FAQ

Build FAQ

Deploy FAQ

Interact FAQ

How To

Troubleshooting: RPC Rate Limit Exceeded on the Free Plan

This article provides a detailed troubleshooting guide for resolving issues related to exceeding the RPC rate limit on the Free Plan.

Troubleshooting: Contract Deployment Minter Error

This article provides a detailed troubleshooting guide for resolving the "not a minter" error when deploying and minting tokens on thirdweb.

Troubleshooting: Missing EMBED Menu in Contracts

This article provides guidance for users who are unable to find the EMBED menu in their contract on thirdweb.

How to Batch Upload NFTs with GLB Files and GIF Previews

This guide explains how to format metadata for batch uploading a series of NFTs that include .glb files for 3D models and .gif preview images.

Claim from drop contract using contract explorer

This support guide will teach you how to claim using Contract Explorer by calling the claim contract function of your NFT Drop, Edition Drop & Token Drop