react-native-web3-kit

Lightweight Web3 utilities for React Native wallets and DeFi apps. Zero native dependencies — safe to use in Expo and bare React Native projects.

Built by Rajan Kumar · Senior Frontend Developer · React Native · Web3

Install

npm install react-native-web3-kit
# or
yarn add react-native-web3-kit

Features

• Address helpers — validate, shorten, and compare EVM addresses
• Amount formatting — gwei ↔ ETH conversion, wei parsing
• Chain metadata — Ethereum, Polygon, Arbitrum, Base explorers & RPC URLs
• App state hook — reconnect wallet/RPC when app returns to foreground

Usage

Address formatting

import { formatAddress, isValidAddress } from "react-native-web3-kit";

if (isValidAddress(userInput)) {
  console.log(formatAddress(userInput)); // 0x742d...f44e
}

ETH / gwei conversion

import { gweiToEth, parseEthToWei } from "react-native-web3-kit";

gweiToEth(1_500_000_000n); // "1.5"
parseEthToWei("0.25");     // 250000000000000000n

Block explorer links

import { getExplorerTxUrl } from "react-native-web3-kit";

getExplorerTxUrl(1, "0xabc..."); // https://etherscan.io/tx/0xabc...

Wallet reconnect on app resume (React Native)

import { AppState } from "react-native";
import { useAppStateReconnect } from "react-native-web3-kit";

function WalletProvider({ children }) {
  useAppStateReconnect(async () => {
    await reconnectWallet();
  }, { AppState });

  return children;
}

API

| Export | Description | |--------|-------------| | isValidAddress | Validate EVM address format | | formatAddress | Shorten address for UI | | addressesEqual | Case-insensitive address compare | | gweiToEth | Convert gwei bigint to ETH string | | parseEthToWei | Parse decimal ETH to wei | | formatTxHash | Shorten transaction hash | | CHAINS | Common chain metadata | | getChainById | Lookup chain by ID | | getExplorerAddressUrl | Block explorer address URL | | getExplorerTxUrl | Block explorer tx URL | | useAppStateReconnect | Reconnect callback on foreground |

Development

npm install
npm test
npm run build

Contributing

Issues and PRs welcome! See CONTRIBUTING.md.

License

MIT © Rajan Kumar