Services Industries ADI Ecosystem Cases Company Careers Blog Contacts
Services
Industries
ADI Ecosystem
Company

Step-by-Step Guide on How to Connect to ADI Testnet

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 ParameterParameter ValueReference Context
Network NameADI Network AB TestnetPrimary network identifier
RPC Endpointhttps://rpc.ab.testnet.adifoundation.ai/Foundation public JSON-RPC
Chain Identifier99999Decimal format chain ID
Token SymbolADINative execution gas ticker
Block Explorer URLhttps://explorer.ab.testnet.adifoundation.ai/Block index and transaction browser
L1 Token Contract0x2a98b46fe31ba8be05ef1ce3d36e1f80db04190dSepolia test token contract
Bridgehub Contract0xFd3cE61C65dDd1039e6e9e07FB6D6e16388d1cc7Sepolia bridge contract
Asset Router Contract0x5BA5B3a62745cD4eC5a59A22c988b2Dc2ae06573Cross-chain asset router
Protocol Specificationv0.30.1Network 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:

  1. How to Connect to ADI Testnet: 4 Steps
  2. ADI Testnet Technical Limitations and Execution Constraints
  3. 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:

  1. Open the wallet browser extension.
  2. Access the network drop-down selector located at the top of the wallet window.
  3. Choose the option to add a custom network (expanding the view simplifies copy and paste actions).
  4. Enter ADI Network AB Testnet into the network name field.
  5. Paste https://rpc.ab.testnet.adifoundation.ai/ into the primary RPC URL field.
  6. Set the chain identifier field to 99999.
  7. Input ADI into the symbol box.
  8. Enter https://explorer.ab.testnet.adifoundation.ai/ into the block explorer field.
  9. Save these settings.

The wallet active network updates immediately, displaying an initial zero balance.

Step 2: Claiming Native Faucet Funds and Test Assets

Faucet ServiceTarget Endpoint / AccessAsset SymbolExecution Role
Official ADI Faucethttps://faucet.ab.testnet.adifoundation.ai/ADINative gas execution
Pearl Digital P3 FaucetPearl P3 Onboarding InterfacePRLUSD, FlashDThird-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:

  1. Navigate to https://faucet.ab.testnet.adifoundation.ai/ to open the network distribution page.
  2. Copy the target EVM wallet address.
  3. Paste the hex address string into the field on the faucet page.
  4. Solve the CAPTCHA prompt.
  5. Click Request Funds.
  6. Select Claim Rewards on the subsequent screen.
  7. 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:

  1. Open the bridge web application.
  2. Connect the wallet containing Sepolia ETH or Sepolia ADI.
  3. Pick the transfer direction from Ethereum Sepolia to ADI Network AB Testnet.
  4. Enter the deposit amount.
  5. 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 ProviderEndpoint TypeConnection URLOperational Status
ADI FoundationPublic HTTPShttps://rpc.ab.testnet.adifoundation.ai/Active
AlchemyHTTPS RPChttps://adi-testnet.g.alchemy.com/v2/[API_KEY]Active
AlchemyWebSocket RPCwss://adi-testnet.g.alchemy.com/v2/[API_KEY]Active
NowNodesHTTPS RPCUnsupportedInactive

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 PrimitiveSupport StatusDeveloper Impact
ERC-7702UnsupportedAccount code delegation transactions fail
ERC-4844UnsupportedBlob submission transactions revert
Custom debug_traceCallUnsupportedTracing 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.

    Formats: pdf, doc, docx, rtf, ppt, pptx.
    Herman CTO
    Herman Stohniiev
    CTO and Co-founder
    As a leader in tech and innovation, Herman drives IdeaSoft as a co-founder and CTO developing the best software architecture solutions for our clients. He is hands-on in developing projects, great at picking the right tech and designing revenue-generating products.
    FAQ

    Frequently Asked Questions

    • Why is my wallet balance showing zero after requesting faucet funds?
      Faucet processing takes a few seconds to complete. You must click Request Funds and then click Claim Rewards on the confirmation screen. Wallet balance displays an update once the transaction settles on-chain. According to our experience, network traffic occasionally delays wallet UI updates. Paste your public address into the block explorer to double-check incoming receipts directly.
    • Can I deploy standard EVM smart contracts on ADI Testnet?
      Yes. You can deploy standard Solidity contracts on the testnet. We think the network runs standard EVM bytecode without extra setup. Specific protocol features, such as ERC-7702 delegation or ERC-4844 blobs, revert during execution. Custom tracers in debug_traceCall fail too. Stick to basic EVM functions for standard contract execution.
    • What should I do if a local node stops syncing with the testnet?
      Scheduled network upgrades changed the peer-to-peer communication setup. External nodes running older HTTP-replay scripts stopped syncing after that update. Node operators must update local node software to version v0.20.12. Updating restores peer discovery and sync routines.
    • How do third-party faucets differ from the main ADI faucet?
      The official faucet supplies native ADI tokens. You need these native tokens for execution gas on the network. Third-party faucets like Pearl Digital distribute app-specific tokens like PRLUSD. Honestly, third-party tokens cannot cover transaction gas fees. They use separate rules, rate limits, and access forms.
    • Do testnet ADI tokens have monetary value?
      No. Testnet tokens carry zero cash value. They exist purely for development work and test operations. Never pay money for testnet assets.
    • Can I use third-party RPC providers like Alchemy to connect to ADI Testnet?
      Yes. Alchemy works. You can connect using custom Alchemy API keys over HTTPS or WebSocket. NowNodes does not support this chain right now. We think switching to custom RPC providers helps when public endpoints hit heavy traffic or strict rate limits.
    Subscription

    Subscribe to Newsletter

    Subscribe to IdeaSoft newsletter — be the first to get blog updates and IdeaSoft news!

    Not subscribed, because of server error. Try again later...
    Successfully subscribed!