A Remote Procedure Call (RPC) is a fundamental protocol that enables your Web3 wallet to communicate directly with a blockchain network. By adding a custom RPC endpoint, you can manually connect your OKX Wallet to various networks—such as testnets, emerging EVM-compatible chains, or private blockchains—that aren't natively supported by default. This guide will walk you through the steps to add a custom RPC in both the OKX mobile app and the web extension.
Why Add a Custom RPC Endpoint?
Custom RPCs provide flexibility for developers, researchers, or crypto enthusiasts who need to interact with specialized or experimental blockchain environments. Whether you're testing a smart contract on a testnet or using a new Layer-2 solution, manually adding an RPC allows your wallet to read and write data to that specific chain.
Using a custom RPC can help you:
- Access test networks like Goerli or Sepolia
- Connect to new or niche EVM-compatible blockchains
- Interact with private or consortium blockchains
- Troubleshoot or explore networks not yet integrated into OKX Wallet
Steps to Add a Custom RPC in the OKX Mobile App
- Open the OKX app and navigate to your Web3 Wallet.
- Tap the network selection menu at the top of the wallet interface.
- Select Custom or Add Network from the options.
- Fill in the required network details (see parameters below).
- Tap Confirm or Save to add the network.
Steps to Add a Custom RPC in the OKX Web Extension
- Log in to your OKX Wallet browser extension.
- Click the network switcher (e.g., Ethereum or BNB Chain) at the top of the wallet.
- Choose Add Network.
Enter the following information:
- Network Name: A recognizable name (e.g., "My Test Network")
- RPC URL: A valid HTTPS endpoint URL for the RPC node
- Chain ID: The unique identifier of the network (e.g., 137 for Polygon)
- Currency Symbol (optional): The native token symbol (e.g., ETH, MATIC)
- Block Explorer URL (optional): For viewing transactions on the network
- Click Save or Add. The custom network will now appear in your network list.
Essential Parameters for Custom RPC Setup
When adding a new network, accuracy is critical. Below are the details you’ll need to provide:
- RPC URL: A working node endpoint. This is often provided by blockchain projects, node service providers, or community sources.
- Chain ID: A numeric value that identifies the blockchain (e.g., 1 for Ethereum Mainnet, 56 for BSC).
- Currency Symbol: The ticker of the network’s native gas token.
- Block Explorer URL: Useful for reviewing transaction history.
Incorrect entries—especially in the Chain ID or RPC URL—can lead to failed transactions or an inability to interact with the network.
Best Practices for Using Custom RPCs
- Always use RPC endpoints from trusted and reliable sources.
- Verify Chain IDs with official network documentation.
- Test with a small transaction first when using a new custom network.
- Remember that you can edit or remove custom networks later in your wallet settings.
For those looking to explore a wider range of blockchain networks or tools, you can 👉 discover more advanced Web3 utilities designed for developers and advanced users.
Frequently Asked Questions
What is an RPC endpoint in blockchain?
An RPC endpoint is a server URL that allows your wallet to query blockchain data, submit transactions, and interact with smart contracts. It acts as a communication bridge between your wallet and the blockchain network.
Is it safe to use a custom RPC?
It is safe as long as you use endpoints from reputable sources. Avoid unknown or unverified URLs to minimize risks like privacy leaks or failed transactions.
Can I use the same RPC on multiple wallets?
Yes, you can add the same custom RPC settings to different wallets if they support manual network configuration. This is useful for maintaining consistency across development or testing environments.
What should I do if my custom RPC isn’t working?
Double-check the RPC URL and Chain ID for accuracy. Ensure the endpoint is active and supports the methods required by your wallet. Consulting official network documentation or support channels can also help.
Why can’t I see my funds after adding a custom network?
This may occur if the RPC endpoint is unresponsive, the Chain ID is incorrect, or the network doesn’t support the tokens you’re trying to view. Verify all parameters and try switching to a different RPC URL if available.
Can I delete a custom RPC later?
Yes, you can manage or remove custom networks anytime through the network settings in your OKX Wallet.
Final Tips
Adding a custom RPC increases the versatility of your OKX Wallet, letting you engage with a broader spectrum of blockchain ecosystems. Always prioritize security by validating RPC URLs and network details before saving them. For further assistance, refer to OKX Help Center materials or the official documentation of the network you are trying to access.