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.

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
});

​Prerequisites

​Install

​Usage

​Wallet Resolution

​Wallet Resolution

​Install

​Usage

​Wallet Resolution

​Wallet Resolution

​Next Steps

Prerequisites

Install

Usage

Wallet Resolution

Wallet Resolution

Install

Usage

Wallet Resolution

Wallet Resolution

Next Steps