Developer Interfaces
Testnet
The Irys testnet is an EVM-compatible network you can connect to with standard Ethereum tooling. This page lists the connection details and explains which endpoint to use for what.
Network Details
| Property | Value |
|---|---|
| Network name | Irys Testnet v1 |
| Chain ID | 1270 (0x4F6) |
| Currency symbol | IRYS |
| Decimals | 18 |
| RPC URL | https://testnet-rpc.irys.xyz/v1/execution-rpc |
| Explorer | https://testnet-explorer.irys.xyz |
Two Endpoints, Two Jobs
The same host serves two different interfaces, and picking the wrong one is the most common source of connection errors.
https://testnet-rpc.irys.xyz/v1/execution-rpc is the EVM JSON-RPC endpoint. This is what a wallet, ethers, viem or any standard Ethereum library connects to.
https://testnet-rpc.irys.xyz is the base host for the node's own REST routes, which live under /v1/. For example, /v1/info returns the node version, current height and chain ID:
curl https://testnet-rpc.irys.xyz/v1/info
/v1 on its own returns 404. It is a path prefix, not an endpoint. Requesting the base host without a path redirects to /v1/info.Adding the Network to a Wallet
The Irys faucet adds the testnet to your wallet in one click and sends test tokens to the address you give it. If you prefer to configure the network by hand, use the values in the table above.
The chain is EVM compatible, so standard EVM tooling works against it, including MetaMask.
Connecting with Ethers
import { JsonRpcProvider } from "ethers";
const provider = new JsonRpcProvider("https://testnet-rpc.irys.xyz/v1/execution-rpc");
const balance = await provider.getBalance("<address>");