Building transactions

For a full explanation, see the core docs overview of a transaction.

Add dependencies

The @solana/web3.js library provides convenient classes and Solana primitive types to build transactions.

yarn install @solana/web3.js

npm install @solana/web3.js

Add polyfills

After installing, ensure you have also added these polyfills to your React native app. These are needed by some parts of @solana/web3.js because it is originally written as a web/node library and, as a result, certain expected APIs are missing in a React Native environment.

Example: SOL Transfer Transaction

In the following example, we create a transaction that invokes the System Program’s transfer instruction to send SOL to an address. A transaction instruction is comprised of a program id, a list of accounts, and instruction data specific to the program.

Versioned Transactions
Legacy Transactions

A versioned transaction is a new format for transactions recommended for use by clients.As an example, we’ll be invoking the transfer instruction from the System Program. Use the SystemProgram factory class to conveniently generate the transfer instruction.

import {
  Connection,
  PublicKey,
  VersionedTransaction,
  SystemProgram,
} from "@solana/web3.js";

// Create a list of Program instructions to execute.
const instructions = [
  SystemProgram.transfer({
    fromPubkey: fromPublicKey,
    toPubkey: toPublicKey,
    lamports: 1_000_000,
  }),
];

// Connect to an RPC endpoint and get the latest blockhash, to include in
// the transaction.
const connection = new Connection(clusterApiUrl("devnet"), "confirmed");
const latestBlockhash = await connection.getLatestBlockhash();

// Create the "message" of a transaction and compile to `V0Message` format.
const txMessage = new TransactionMessage({
  payerKey: fromPublicKey,
  recentBlockhash: latestBlockhash.blockhash,
  instructions,
}).compileToV0Message();

// Construct the Versioned Transaction passing in the message.
const versionedTransaction = new VersionedTransaction(txMessage);

For backwards compatiblity, you can still construct legacy transactions with @solana/web3.js.

import {
  Connection,
  PublicKey,
  Transaction,
  SystemProgram,
} from "@solana/web3.js";

const latestBlockhash = await connection.getLatestBlockhash();
const randomTransferTransaction = new Transaction({
  ...latestBlockhash,
  feePayer: fromPublicKey,
}).add(
  SystemProgram.transfer({
    fromPubkey: fromPublicKey,
    toPubkey: toPublicKey,
    lamports: 1_000,
  }),
);

Send a Transaction

After a transaction is signed by the appropriate accounts, it can be submitted to the Solana network via RPC. See the next guide, Using Mobile Walelt Adapter to learn how to sign transactions.

Versioned Transactions
Legacy Transactions

import { transact } from "@solana-mobile/mobile-wallet-adapter-protocol-web3js";
import {
  sendTransaction,
  clusterApiUrl,
  Connection,
  VersionedTransaction,
  confirmTransaction,
} from "@solana/web3.js";

const connection = new Connection(clusterApiUrl("devnet"), "confirmed");
const unsignedTx = new VersionedTransaction(/* ... */);
const signedTx: VersionedTransaction = await transact((wallet) => {
  /* ...sign `unsignedTx` with Mobile Wallet Adapter... */
});

// After sending, a transaction signature is returned.
const txSignature = await connection.sendTransaction(signedTx);

// Confirm the transaction was successful.
const confirmationResult = await connection.confirmTransaction(
  txSignature,
  "confirmed",
);

if (confirmationResult.value.err) {
  throw new Error(JSON.stringify(confirmationResult.value.err));
} else {
  console.log("Transaction successfully submitted!");
}

import { transact } from "@solana-mobile/mobile-wallet-adapter-protocol-web3js";
import {
  sendTransaction,
  clusterApiUrl,
  Connection,
  Transaction,
  confirmTransaction,
} from "@solana/web3.js";

const connection = new Connection(clusterApiUrl("devnet"), "confirmed");
const signedTx: Transaction = await transact((wallet) => {
  /* ...signing code from above... */
});

// After sending, a transaction signature is returned.
const txSignature = await sendTransaction(signedTx, connection);

// Confirm the transaction was successful.
const confirmationResult = await connection.confirmTransaction(
  txSignature,
  "confirmed",
);

if (confirmationResult.value.err) {
  throw new Error(JSON.stringify(confirmationResult.value.err));
} else {
  console.log("Transaction successfully submitted!");
}

Next steps

Read the following Using Mobile Wallet Adapter guide to learn how to sign these transactions and submit them to the Solana network.
See the Anchor Integration guide to learn how to create and create transactions and invoke instructions from Anchor programs.

Recipes

General

Mobile Wallet Adapter

Solana Development

Add dependencies

Add polyfills

Example: SOL Transfer Transaction

Send a Transaction

Next steps

​Add dependencies

​Add polyfills

​Example: SOL Transfer Transaction

​Send a Transaction

​Next steps

Add dependencies

Add polyfills

Example: SOL Transfer Transaction

Send a Transaction

Next steps