ADI Chain operates as a zero-knowledge Layer-2 rollup platform built on zkSync Atlas and the Airbender proving system. Transactions process off-chain before zero-knowledge validity proofs land on Ethereum Sepolia for final settlement. The network addresses financial systems, sovereign identity assets, and cross-border trade rails across emerging markets. Connecting wallet applications or development node instances requires exact protocol parameters.
| Technical Parameter | Parameter Value | Reference Context |
| Network Name | ADI Network AB Testnet | Primary network identifier |
| RPC Endpoint | https://rpc.ab.testnet.adifoundation.ai/ | Foundation public JSON-RPC |
| Chain Identifier | 99999 | Decimal format chain ID |
| Token Symbol | ADI | Native execution gas ticker |
| Block Explorer URL | https://explorer.ab.testnet.adifoundation.ai/ | Block index and transaction browser |
| L1 Token Contract | 0x2a98b46fe31ba8be05ef1ce3d36e1f80db04190d | Sepolia test token contract |
| Bridgehub Contract | 0xFd3cE61C65dDd1039e6e9e07FB6D6e16388d1cc7 | Sepolia bridge contract |
| Asset Router Contract | 0x5BA5B3a62745cD4eC5a59A22c988b2Dc2ae06573 | Cross-chain asset router |
| Protocol Specification | v0.30.1 | Network baseline version |
Ready to Build on ADI Chain?
We can help you configure the infrastructure, connect your application, and navigate the technical requirements
Table of contents:
- How to Connect to ADI Testnet: 4 Steps
- ADI Testnet Technical Limitations and Execution Constraints
- Summary
How to Connect to ADI Testnet: 4 Steps
So, here are the 4 steps you need to take to connect to ADI Testnet.
Step 1: Manual Wallet Configuration
Connecting an EVM wallet to the network requires manually adding custom network parameters. Standard wallet auto-detection skips non-mainnet chains. So:
- Open the wallet browser extension.
- Access the network drop-down selector located at the top of the wallet window.
- Choose the option to add a custom network (expanding the view simplifies copy and paste actions).
- Enter ADI Network AB Testnet into the network name field.
- Paste https://rpc.ab.testnet.adifoundation.ai/ into the primary RPC URL field.
- Set the chain identifier field to 99999.
- Input ADI into the symbol box.
- Enter https://explorer.ab.testnet.adifoundation.ai/ into the block explorer field.
- Save these settings.
The wallet active network updates immediately, displaying an initial zero balance.
Step 2: Claiming Native Faucet Funds and Test Assets
| Faucet Service | Target Endpoint / Access | Asset Symbol | Execution Role |
| Official ADI Faucet | https://faucet.ab.testnet.adifoundation.ai/ | ADI | Native gas execution |
| Pearl Digital P3 Faucet | Pearl P3 Onboarding Interface | PRLUSD, FlashD | Third-party application testing |
Every write interaction on ADI Testnet needs native ADI tokens to cover execution gas costs. These test tokens have no monetary value. So:
- Navigate to https://faucet.ab.testnet.adifoundation.ai/ to open the network distribution page.
- Copy the target EVM wallet address.
- Paste the hex address string into the field on the faucet page.
- Solve the CAPTCHA prompt.
- Click Request Funds.
- Select Claim Rewards on the subsequent screen.
- Wait a few seconds for transaction processing.
Balance updates show in the wallet or via address lookups on the block explorer. External ecosystem applications run independent asset faucets. Pearl Digital supplies test assets like PRLUSD and FlashD for its P3 environment. These external distribution sites maintain separate onboarding rules and rate limits. Native ADI from the foundation faucet remains mandatory for standard execution gas fees.
Step 3: Asset Transfer via Sepolia L1 Bridge
Cross-layer transfers rely on canonical bridge contracts on Ethereum Sepolia. According to our experience, bridging tokens connects Sepolia liquidity directly to Layer-2 execution. So:
- Open the bridge web application.
- Connect the wallet containing Sepolia ETH or Sepolia ADI.
- Pick the transfer direction from Ethereum Sepolia to ADI Network AB Testnet.
- Enter the deposit amount.
- Confirm the transaction prompt inside the wallet interface.
The bridge contracts lock funds on Sepolia L1. The sequencer mints matching balances on Layer-2 after state updates clear. Strict address aliasing applies to contracts moving across layers. Adding numeric address offsets stops L1 smart contracts from forging messages on L2. The chain balance ledger tracks locked assets continuously to stop reserve draining across separate networks.
Step 4: RPC Provider Alternatives and External Node Operations
Heavy traffic on primary endpoints can cause request timeouts. You can switch RPC providers.
| Infrastructure Provider | Endpoint Type | Connection URL | Operational Status |
| ADI Foundation | Public HTTPS | https://rpc.ab.testnet.adifoundation.ai/ | Active |
| Alchemy | HTTPS RPC | https://adi-testnet.g.alchemy.com/v2/[API_KEY] | Active |
| Alchemy | WebSocket RPC | wss://adi-testnet.g.alchemy.com/v2/[API_KEY] | Active |
| NowNodes | HTTPS RPC | Unsupported | Inactive |
Alchemy provides custom API keys and WebSocket channels for streaming chain events. NowNodes does not support ADI Testnet connections.
Teams running local read nodes query network state privately. Local nodes fetch validity proofs from foundation storage blobs, replaying transactions locally without running prover routines.
Importantly, scheduled protocol upgrades updated network P2P protocols. External nodes running legacy HTTP-replay software stopped syncing. Operators must upgrade node instances to version v0.20.12 to restore peer connections across the network.
ADI Testnet Technical Limitations and Execution Constraints
Smart contract developers must plan around specific protocol constraints. We think checking EVM opcode compatibility early saves significant debugging time.
| Network Primitive | Support Status | Developer Impact |
| ERC-7702 | Unsupported | Account code delegation transactions fail |
| ERC-4844 | Unsupported | Blob submission transactions revert |
| Custom debug_traceCall | Unsupported | Tracing requires standard RPC methods |
Contracts invoking missing EIP primitives fail during execution on the testnet. Deploying standard EVM bytecode allows smooth smart contract testing across the zkSync Atlas framework.
Summary
Connecting to the ADI Network AB Testnet requires:
- Manual wallet setup
- Native gas funding
- Protocol verification
External nodes running version v0.20.12 handle state replays across the P2P network. Applications can deploy smart contracts and run write operations once native ADI tokens are present to cover execution gas.
Build on ADI Chain With IdeaSoft
IdeaSoft helps teams integrate ADI Chain into their products and build scalable blockchain applications around its infrastructure.