Quickstart
- Knowledge Base
  - 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)
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

Auth FAQ

General FAQs

How long does the JWT last until it expires?

By default, the JWTs issued by the server are valid for 3 days (259200 seconds), after which the user will have to login again. However, this duration can be changed by modifying the authOptions.tokenDurationInSeconds configuration. For Next, see here. For Express, see here.

Is it possible to use Auth without an `authUrl` in the `authConfig` using the React SDK?

Yes, it is possible to use Auth without an authUrl in the authConfig using the React SDK. The authUrl property in the authConfig object is used to specify the backend URL of the authentication endpoints. However, if you don't need to communicate with a backend for authentication purposes, you can omit this property. In that case, Auth will use default authentication mechanisms such as cookies.

Can I token gate my website using Auth?

Yes, you can token gate your website using Auth. Token gating allows you to restrict access to certain pages or content on your website based on the ownership of a specific token, such as an NFT or a crypto token. By connecting their crypto wallet and verifying ownership of the required token, users can unlock exclusive content or features.

Are cookies required to use Auth?

Cookies are not required but are used by default. If you don't want to use cookies, you can just store the returned auth token from /login and persist that. Then pass that auth token to the other protected backend calls.

Did this answer your question?

😞

😐

🤩