Documentation Index
Fetch the complete documentation index at: https://docs.getpara.com/llms.txt
Use this file to discover all available pages before exploring further.
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.
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
});
Next Steps
