sendTransaction

Sends a transaction using the provided account.

You can send a transaction with a prepared contract call, a prepared transaction, or using a write Extension.

Example

Using a prepared contract call


import {
  sendTransaction,
  getContract,
  prepareContractCall,
} from "thirdweb";
import { sepolia } from "thirdweb/chains";
 
const contract = getContract({
  address: "0x...",
  chain: sepolia,
  client,
});
 
const transaction = prepareContractCall({
  contract,
  method: "function transfer(address to, uint256 value)",
  params: [to, value],
});
 
const { transactionHash } = await sendTransaction({
  account,
  transaction,
});

Using a write extension


import { sendTransaction, getContract } from "thirdweb";
import { sepolia } from "thirdweb/chains";
import { mintTo } from "thirdweb/extensions/erc721";
 
const contract = getContract({
  address: "0x...",
  chain: sepolia,
  client,
});
 
const transaction = mintTo({
  contract,
  to: "0x...",
  nft: {
    name: "NFT Name",
    description: "NFT Description",
    image: "https://example.com/image.png",
  },
});
 
const { transactionHash } = await sendTransaction({
  account,
  transaction,
});

Using a prepared transaction


import {
  sendTransaction,
  getContract,
  prepareTransaction,
} from "thirdweb";
import { sepolia } from "thirdweb/chains";
 
const contract = getContract({
  address: "0x...",
  chain: sepolia,
  client,
});
 
const transaction = prepareTransaction({
  contract,
  to: "0x...",
  value: toWei("0.1"),
});
 
const { transactionHash } = await sendTransaction({
  account,
  transaction,
});

Send an EIP-7702 Transaction

Note: This feature is in beta and is subject to breaking changes


import {
  sendTransaction,
  prepareTransaction,
  signAuthorization,
} from "thirdweb";
import { sepolia } from "thirdweb/chains";
 
const authorization = await signAuthorization({
  request: {
    address: "0x...",
    chainId: 1,
    nonce: 0n,
  },
  account: myAccount,
});
 
const transaction = prepareTransaction({
  chain: sepolia,
  client: client,
  to: "0x...",
  value: 0n,
  authorizationList: [authorization],
});
 
const { transactionHash } = await sendTransaction({
  account,
  transaction,
});

Gasless usage with thirdweb Engine


const { transactionHash } = await sendTransaction({
  account,
  transaction,
  gasless: {
    provider: "engine",
    relayerUrl:
      "https://thirdweb.engine-***.thirdweb.com/relayer/***",
    relayerForwarderAddress: "0x...",
  },
});

Gasless usage with OpenZeppelin


const { transactionHash } = await sendTransaction({
  account,
  transaction,
  gasless: {
    provider: "openzeppelin",
    relayerUrl: "https://...",
    relayerForwarderAddress: "0x...",
  },
});


function sendTransaction(
  options: SendTransactionOptions,
): Promise<{
  chain: Readonly;
  client: ThirdwebClient;
  maxBlocksWaitTime?: number;
  readonly transactionHash: `0x${string}`;
}>;

Parameters

The options for sending the transaction.

Type


let options: {
  account: Account;
  gasless: GaslessOptions;
  transaction: PreparedTransaction<any>;
};

Returns


let returnType: Promise<{
  chain: Readonly;
  client: ThirdwebClient;
  maxBlocksWaitTime?: number;
  readonly transactionHash: `0x${string}`;
}>;

A promise that resolves to the transaction result.