thirdweb TypeScript SDK

All-in-one web3 SDK for Browser, Node and Mobile apps

Core Package

thirdweb

The main SDK package providing all-in-one web3 functionality for Browser, Node, and Mobile applications.

npm install thirdweb

Features:

• Type-safe contract and transaction APIs
• In-app wallets with social/email login
• Account abstraction (ERC4337/EIP7702) support
• 500+ external wallets supported
• Built in infra (RPC, bundler, paymaster, indexer)
• React hooks and UI components
• Automatic ABI resolution
• IPFS upload/download
• Cross-platform support (Web, React Native)

Documentation

Visit the developer portal for full documentation.

🚀 Quick Start

For React Applications

npm install thirdweb

import { createThirdwebClient } from "thirdweb";
import { ConnectButton, useActiveAccount } from "thirdweb/react";

const client = createThirdwebClient({
  clientId: "YOUR_CLIENT_ID",
});

function App() {
  const account = useActiveAccount();
  console.log("Connected as", account?.address);

  return <ConnectButton client={client} />;
}

For React Native Applications, you'll also need to install the @thirdweb-dev/react-native-adapter package and import it at app startup for polyfills.

For Backend Applications

npm install thirdweb

import { createThirdwebClient, Engine } from "thirdweb";

const client = createThirdwebClient({
  secretKey: "YOUR_SECRET_KEY",
});

const wallet = Engine.serverWallet({
  client,
  address: "0x...",
});

const transaction = transfer({
  contract: getContract({
    client,
    address: "0x...", // token contract
    chain: defineChain(1),
  }),
  to: "0x...", // recipient
  amount: "0.01", // amount in tokens
});

await wallet.enqueueTransaction({
  transaction,
});

Adapters

@thirdweb-dev/react-native-adapter

Required polyfills and configuration for running the thirdweb SDK in React Native applications.

npm install @thirdweb-dev/react-native-adapter

@thirdweb-dev/wagmi-adapter

Integration layer for using thirdweb's in-app wallets with wagmi.

npm install @thirdweb-dev/wagmi-adapter

Type safe API wrappers

@thirdweb-dev/api

TypeScript SDK for thirdweb's API, combining all of thirdweb products.

npm install @thirdweb-dev/api

@thirdweb-dev/engine

TypeScript SDK for Engine, thirdweb's backend onchain executor service.

npm install @thirdweb-dev/engine

@thirdweb-dev/insight

TypeScript SDK for Insight, thirdweb's multichain indexer service.

npm install @thirdweb-dev/insight

@thirdweb-dev/vault-sdk

SDK for interacting with Vault, thirdweb's secure key management service.

npm install @thirdweb-dev/vault-sdk

@thirdweb-dev/nebula

TypeScript SDK for Nebula, thirdweb's AI agent service.

npm install @thirdweb-dev/nebula

Contributing

We welcome contributions from all developers regardless of experience level. If you are interested in contributing, please read our Contributing Guide to learn how the repo works, how to test your changes, and how to submit a pull request.

See our open source page for more information on our open-source bounties and program.

Additional Resources

• Dashboard
• Documentation
• Templates
• YouTube

Support

For help or feedback, please visit our support site

Security

If you believe you have found a security vulnerability in any of our packages, we kindly ask you not to open a public issue; and to disclose this to us by emailing [email protected].