Setup Web3 Libraries

Learn how to set up popular Web3 libraries with Para. Choose your library below.

Prerequisites

Before setting up Web3 libraries, you need an authenticated Para session.

Setup Para Instance

Sepolia examples need testnet ETH before sending transactions or writing contracts. Get requestFaucetAsync from useRequestFaucet() and call requestFaucetAsync({ chain: "ETHEREUM_SEPOLIA" }) after the user has an EVM wallet. If chain is omitted, the faucet defaults to ETHEREUM_SEPOLIA. See Fund Testnet Wallet for the full example.

Ethers.js
Viem

Install

npm install @getpara/react-native-wallet @getpara/ethers-v6-integration ethers

@getpara/ethers-v6-integration is a separate package — install it alongside @getpara/react-native-wallet.

Usage

Hook (React)
Direct (Non-React)

Use the hook to create an ethers signer for your user’s Para embedded wallet or external wallet. For convenience, the and hooks wrap common signer methods in a React Query mutation.

import { useParaEthersSigner, useParaEthersSignMessage } from "@getpara/react-native-wallet/evm/ethers";
import { JsonRpcProvider } from "ethers";
import { Text, TouchableOpacity } from "react-native";

const provider = new JsonRpcProvider("https://ethereum-sepolia-rpc.publicnode.com");

function SignWithEthers() {
  const { ethersSigner, isLoading } = useParaEthersSigner({ provider });
  const { signMessageAsync, isPending } = useParaEthersSignMessage(ethersSigner);

  const handleSign = async () => {
    const signature = await signMessageAsync("Hello from Para!");
    console.log("Signature:", signature);
  };

  if (isLoading) return <Text>Loading...</Text>;
  return (
    <TouchableOpacity disabled={isPending} onPress={handleSign}>
      <Text>{isPending ? "Signing..." : "Sign Message"}</Text>
    </TouchableOpacity>
  );
}

Wallet Resolution

When no address or walletId is passed, the hook resolves the wallet in this order:

Selected wallet — if the user selected an EVM wallet in the UI. If there is only one EVM wallet in the session, it is already selected by default
First EVM wallet — the first available EVM wallet on the account

To target a specific wallet, pass address or walletId:

const { ethersSigner } = useParaEthersSigner({
  provider,
  address: "0x1234...",  // or walletId: "uuid-..."
});

Use createParaEthersSigner to create a signer directly.

import { createParaEthersSigner } from "@getpara/ethers-v6-integration";
import { ethers } from "ethers";
import Para from "@getpara/core-sdk";

const para = new Para("YOUR_API_KEY");
const provider = new ethers.JsonRpcProvider("https://ethereum-sepolia-rpc.publicnode.com");

// Authenticate first...

const signer = createParaEthersSigner({ para, provider });
const signature = await signer.signMessage("Hello from Para!");

Wallet Resolution

When no address or walletId is passed, the factory picks the first available EVM wallet.To target a specific wallet:

const signer = createParaEthersSigner({
  para,
  provider,
  address: "0x1234...",  // looks up by address
  // or walletId: "uuid-...",  // looks up by ID
});

Install

npm install @getpara/react-native-wallet @getpara/viem-v2-integration viem

@getpara/viem-v2-integration is included as a dependency of @getpara/react-native-wallet, but you should install it explicitly to ensure version alignment.

Usage

Hook (React)
Direct (Non-React)

Use the hook to create a viem WalletClient for your user’s Para embedded wallet or external wallet. For convenience, the , , , and hooks wrap common client methods in a React Query mutation.

import { useParaViemClient, useParaViemSignMessage } from "@getpara/react-native-wallet/evm/viem";
import { createPublicClient, http } from "viem";
import { sepolia } from "viem/chains";
import { Text, TouchableOpacity } from "react-native";

const publicClient = createPublicClient({
  chain: sepolia,
  transport: http("https://ethereum-sepolia-rpc.publicnode.com"),
});

function SignWithViem() {
  const { viemClient, isLoading } = useParaViemClient({
    walletClientConfig: {
      chain: sepolia,
      transport: http("https://ethereum-sepolia-rpc.publicnode.com"),
    },
  });

  const { signMessageAsync, isPending } = useParaViemSignMessage(viemClient);

  const handleSign = async () => {
    const signature = await signMessageAsync({ message: "Hello from Para!" });
    console.log("Signature:", signature);
  };

  if (isLoading) return <Text>Loading...</Text>;
  return (
    <TouchableOpacity disabled={isPending} onPress={handleSign}>
      <Text>{isPending ? "Signing..." : "Sign Message"}</Text>
    </TouchableOpacity>
  );
}

Wallet Resolution

When no address or walletId is passed, the hook resolves the wallet in this order:

Selected wallet — if the user selected an EVM wallet in the UI. If there is only one EVM wallet in the session, it is already selected by default
First EVM wallet — the first available EVM wallet on the account

To target a specific wallet:

const { viemClient } = useParaViemClient({
  address: "0x1234...",  // or walletId: "uuid-..."
  walletClientConfig: { chain: sepolia, transport: http() },
});

Use createParaViemAccount and createParaViemClient to create a wallet client directly.

import { createParaViemAccount, createParaViemClient } from "@getpara/viem-v2-integration";
import { createPublicClient, http } from "viem";
import { sepolia } from "viem/chains";
import Para from "@getpara/core-sdk";

const para = new Para("YOUR_API_KEY");

// Authenticate first...

const account = createParaViemAccount({ para });
const walletClient = createParaViemClient({ para, walletClientConfig: {
  account,
  chain: sepolia,
  transport: http("https://ethereum-sepolia-rpc.publicnode.com"),
}});

const signature = await walletClient.signMessage({ message: "Hello from Para!" });

Wallet Resolution

When no address or walletId is passed, the factory picks the first available EVM wallet.To target a specific wallet:

const account = createParaViemAccount({
  para,
  address: "0x1234...",  // looks up by address
  // or walletId: "uuid-...",  // looks up by ID
});

Setup Web3 Libraries

Prerequisites

Setup Para Instance

Install

Usage

Wallet Resolution

Wallet Resolution

Install

Usage

Wallet Resolution

Wallet Resolution

Next Steps

Configure RPC

Send Tokens

Sign Messages

​Prerequisites

Setup Para Instance

​Install

​Usage

​Wallet Resolution

​Wallet Resolution

​Install

​Usage

​Wallet Resolution

​Wallet Resolution

​Next Steps

Configure RPC

Send Tokens

Sign Messages

Prerequisites

Install

Usage

Wallet Resolution

Wallet Resolution

Install

Usage

Wallet Resolution

Wallet Resolution

Next Steps