Skip to content

Using thirdweb on Moonbeam


thirdweb is a complete Web3 development framework that provides everything you need to develop smart contracts, build DApps, and more.

With thirdweb, you can access tools to help you through every phase of the DApp development cycle. You can create your own custom smart contracts or use any of thirdweb's prebuilt contracts to quickly get started. From there, you can use thirdweb's CLI to deploy your smart contracts. Then you can interact with your smart contracts by creating a Web3 application using the language of your choice, including but not limited to React, TypeScript, and Python.

This guide will show you some of the thirdweb features you can take advantage of to develop smart contracts and DApps on Moonbeam. To check out all of the features thirdweb has to offer, please refer to the thirdweb documentation site.

Create Contract

To create a new smart contract using the thirdweb CLI, follow these steps:

  1. In your CLI, run the following command:

    npx thirdweb create contract
  2. Input your preferences for the command line prompts:

    1. Give your project a name
    2. Choose your preferred framework: Hardhat or Foundry
    3. Name your smart contract
    4. Choose the type of base contract: Empty, ERC20, ERC721, or ERC1155
    5. Add any desired extensions
  3. Once created, navigate to your project’s directory and open in your preferred code editor
  4. If you open the contracts folder, you will find your smart contract; this is your smart contract written in Solidity

    The following is code for an ERC721Base contract without specified extensions. It implements all of the logic inside the ERC721Base.sol contract; which implements the ERC721A standard.

    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.0;
    import '@thirdweb-dev/contracts/base/ERC721Base.sol';
    contract Contract is ERC721Base {
            string memory _name,
            string memory _symbol,
            address _royaltyRecipient,
            uint128 _royaltyBps
        ) ERC721Base(_name, _symbol, _royaltyRecipient, _royaltyBps) {}

    This contract inherits the functionality of ERC721Base through the following steps:

    • Importing the ERC721Base contract
    • Inheriting the contract by declaring that your contract is an ERC721Base contract
    • Implementing any required methods, such as the constructor
  5. After modifying your contract with your desired custom logic, you can deploy it to Moonbeam using Deploy. That will be covered in the next section!

Alternatively, you can deploy a prebuilt contract for NFTs, tokens, or marketplace directly from the thirdweb Explore page:

  1. Go to the thirdweb Explore page

    thirdweb Explore

  2. Choose the type of contract you want to deploy from the available options: NFTs, tokens, marketplace, and more

  3. Follow the on-screen prompts to configure and deploy your contract

For more information on different contracts available on Explore, check out thirdweb’s documentation on prebuilt contracts.

Deploy Contract

Deploy is thirdweb's tool that allows you to easily deploy a smart contract to any EVM compatible network without configuring RPC URLs, exposing your private keys, writing scripts, and other additional setup such as verifying your contract.

  1. To deploy your smart contract using deploy, navigate to the root directory of your project and execute the following command:

    npx thirdweb deploy

    Executing this command will trigger the following actions:

    • Compiling all the contracts in the current directory
    • Providing the option to select which contract(s) you wish to deploy
    • Uploading your contract source code (ABI) to IPFS
  2. When it is completed, it will open a dashboard interface to finish filling out the parameters

    • _name - contract name
    • _symbol - symbol or "ticker"
    • _royaltyRecipient - wallet address to receive royalties from secondary sales
    • _royaltyBps - basis points (bps) that will be given to the royalty recipient for each secondary sale, e.g. 500 = 5%
  3. Select Moonbeam as the network

  4. Manage additional settings on your contract’s dashboard as needed such as uploading NFTs, configuring permissions, and more

For additional information on Deploy, please reference thirdweb’s documentation.

Create Application

thirdweb offers SDKs for a range of programming languages, such as React, React Native, TypeScript, Python, Go, and Unity. You'll start off by creating an application and then you can choose which SDK to use:

  1. In your CLI run the following command:

    npx thirdweb create --app
  2. Input your preferences for the command line prompts:

    1. Give your project a name
    2. Choose your network. You can choose EVM for Moonbeam
    3. Choose your preferred framework: Next.js, Create React App, Vite, React Native, Node.js, or Express. For this example, you can select Create React App
    4. Choose your preferred language: JavaScript or TypeScript
  3. Use the React or TypeScript SDK to interact with your application’s functions. This will be covered in the following section on interacting with a contract

Interact With a Contract

thirdweb provides several SDKs to allow you to interact with your contract including: React, React Native, TypeScript, and Unity.

This document will show you how to interact with your contract deployed to Moonbeam using React. You can view the full React SDK reference in thirdweb’s documentation.

To create a new application pre-configured with thirdweb’s SDKs run and choose your preferred configurations:

npx thirdweb create app --evm

Or install it into your existing project by running:

npx thirdweb install

Initialize SDK On Moonbeam

Wrap your application in the ThirdwebProvider component and change the activeChain to Moonbeam.

import { ThirdwebProvider } from '@thirdweb-dev/react';
import { Moonbeam } from '@thirdweb-dev/chains';

const App = () => {
  return (
    <ThirdwebProvider activeChain={Moonbeam}>
      <YourApp />

Get Contract

To connect to your contract, use the SDK’s getContract method.

import { useContract } from '@thirdweb-dev/react';

function App() {
  const { contract, isLoading, error } = useContract('INSERT_CONTRACT_ADDRESS');

Calling Contract Functions

For extension based functions, use the built-in supported hooks. There are several hooks available for you to use, the following are a few examples:

  • Use the NFTs extension to access a list of NFTs owned by an address via the useOwnedNFTs hook:

    import { useOwnedNFTs, useContract, useAddress } from '@thirdweb-dev/react';
    // Your smart contract address
    const contractAddress = 'INSERT_CONTRACT_ADDRESS';
    function App() {
      const address = useAddress();
      const { contract } = useContract(contractAddress);
      const { data, isLoading, error } = useOwnedNFTs(contract, address);
  • Use the useContractRead hook to call any read functions on your contract by passing in the name of the function you want to use:

    import { useContractRead, useContract } from '@thirdweb-dev/react';
    // Your smart contract address
    const contractAddress = 'INSERT_CONTRACT_ADDRESS';
    function App() {
      const { contract } = useContract(contractAddress);
      // Read data from your smart contract using the function or variables name
      const { data, isLoading, error } = useContractRead(contract, 'INSERT_NAME');
  • Use the useContractWrite hook to call any write functions on your contract by passing in the name of the function you want to use:

    import {
    } from '@thirdweb-dev/react';
    // Your smart contract address
    const contractAddress = 'INSERT_CONTRACT_ADDRESS';
    function App() {
      const { contract } = useContract(contractAddress);
      const { mutateAsync, isLoading, error } = useContractWrite(
      return (
          // Calls the 'INSERT_NAME' function on your smart contract
          // with 'INSERT_ARGUMENT' as the first argument
          action={() => mutateAsync({ args: ['INSERT_ARGUMENT'] })}
          Send Transaction

Connect Wallet

There are a couple of ways that you can create a custom connect wallet experience. You can use the ConnectWallet component or, for a more customizable approach, you can use the useConnect hook.

The following example will show you how to use the ConnectWallet component. To go this route, you will need to specify the supported wallets and pass them to your provider.

import {
} from '@thirdweb-dev/react';

function MyApp() {
  return (
          projectId: 'INSERT_YOUR_PROJECT_ID', // optional
          clientId: 'INSERT_YOUR_CLIENT_ID', // required
      <App />

Next, you'll need to add in a connect wallet button to prompt end-users to login with any of the above supported wallets.

import { ConnectWallet } from '@thirdweb-dev/react';

function App() {
  return <ConnectWallet />;

Deploy Application

To host your static web application on decentralized storage, run:

npx thirdweb deploy --app

By running this command, your application is built for production and stored using Storage, thirdweb's decentralized file management solution. The built application is uploaded to IPFS, a decentralized storage network, and a unique URL is generated for your application. This URL serves as a permanent hosting location for your application on the web.

If you have any further questions or encounter any issues during the process, please reach out to thirdweb support at

The information presented herein has been provided by third parties and is made available solely for general information purposes. Moonbeam does not endorse any project listed and described on the Moonbeam Doc Website ( Moonbeam Foundation does not warrant the accuracy, completeness or usefulness of this information. Any reliance you place on such information is strictly at your own risk. Moonbeam Foundation disclaims all liability and responsibility arising from any reliance placed on this information by you or by anyone who may be informed of any of its contents. All statements and/or opinions expressed in these materials are solely the responsibility of the person or entity providing those materials and do not necessarily represent the opinion of Moonbeam Foundation. The information should not be construed as professional or financial advice of any kind. Advice from a suitably qualified professional should always be sought in relation to any particular matter or circumstance. The information herein may link to or integrate with other websites operated or content provided by third parties, and such other websites may link to this website. Moonbeam Foundation has no control over any such other websites or their content and will have no liability arising out of or related to such websites or their content. The existence of any such link does not constitute an endorsement of such websites, the content of the websites, or the operators of the websites. These links are being provided to you only as a convenience and you release and hold Moonbeam Foundation harmless from any and all liability arising from your use of this information or the information provided by any third-party website or service.
Last update: June 10, 2024
| Created: June 20, 2023