LogoLogo
  • ENTER THE GR1D
    • Overview
    • GR1D Blockchain
    • GR1D Token
    • GR1D Network Utility
      • Blockchain Gaming
      • On-Chain Intellectual Property
      • Multi-Chain Consumer Applications
  • GR1D Network
    • GR1D Protocol
    • Multi-Chain Asset Orchestration
      • Multi-Chain Asset Verification SDK
        • Verify Ethereum Asset
        • Verify Solana Asset
      • GR1D MCAO Solutions
    • Intent Layer
      • GR1D Intent Architecture
      • GR1D Intent Technical Underpinnings
    • GR1D Multi-Chain Apps
      • GR1D TERM1NAL
  • Build with GR1D
    • GR1D Chain Info
      • GR1D Testnet Network Info
      • Connect to GR1D Testnet
      • Bridge to GR1D Testnet
      • Smart Contracts on GR1D Testnet
      • Explorer on GR1D Testnet
    • GR1D SDKs & APIs
    • Guide: Enter the GR1D Testnet
  • Circuit Nodes 101
    • Circuit Nodes Explained
    • Circuit Chip
    • Power your Circuit Node
      • Hardware Requirements for GR1D Circuit Node
      • How to Run GR1D Circuit Node
    • Node Operator Rewards
  • GR1D Tokenomics
    • Token Utility
    • Token Value Accrual
    • Staking and Redemptions
    • Rewards and Emissions
    • Token Overview
    • Token Distribution
  • GR1D Ecosystem
    • Amazon.com
    • Reddit.com
Powered by GitBook
On this page
  • 1. Setting Up Your Dev Environment
  • 2. Checking Out the GR1D Testnet Explorer
  • 3. Bridging Assets on the GR1D Testnet
  • 4. Deploying Smart Contracts
  • 5. Monitoring and Managing Network Activity
  • 6. Best Practices for Working with the Testnet
Export as PDF
  1. Build with GR1D

Guide: Enter the GR1D Testnet

PreviousGR1D SDKs & APIsNextCircuit Nodes 101

Last updated 3 months ago

Alright, welcome to the GR1D Testnet! If you’re looking to get hands-on with GR1D’s L2 solution, you’re in the right place. Whether you’re deploying smart contracts, testing cross-chain functionality, or simply exploring the GR1D environment, this guide will get you connected and building in no time.

1. Setting Up Your Dev Environment

First things first—you’ll want to set up your development environment to interact with the GR1D Testnet. If you’re familiar with tools like MetaMask, Hardhat, or Truffle, you’re already halfway there. Here’s the lowdown:

Step 1: Add GR1D Testnet to MetaMask

  1. Fire up MetaMask and go to the network dropdown.

  2. Click "Add Network" and fill in the following details:

    • Network Name: GR1D Testnet

    • New RPC URL:

    • Chain ID: 123420000418

    • Currency Symbol: ETH (we’re using Sepolia ETH here)

    • Block Explorer URL:

  3. Save it, and boom—you’re connected to the GR1D Testnet via MetaMask.

Step 2: Configuring Hardhat or Truffle

Now, for the real fun—getting your smart contracts ready. We’ll set up either Hardhat or Truffle to deploy on the GR1D Testnet.

Hardhat Configuration

In your hardhat.config.js, plug in the following:

module.exports = {
  networks: {
    gr1dTestnet: {
      url: "https://rpc-123420000418.raas-testnet.gelato.digital",
      accounts: [`0x${YOUR_PRIVATE_KEY}`], // Replace with your private key, keep it safe!
      chainId: 123420000418,
      gas: "auto",
      gasPrice: "auto",
    },
  },
  solidity: "0.8.26", // Make sure this matches your contracts
};

To deploy your contracts:

npx hardhat run scripts/deploy.js --network gr1dTestnet

Truffle Configuration

Update your truffle-config.js to include:

module.exports = {
  networks: {
    gr1dTestnet: {
      provider: () => new HDWalletProvider("YOUR_MNEMONIC", "https://rpc-123420000418.raas-testnet.gelato.digital"),
      network_id: 123420000418, // GR1D Testnet Chain ID
      gas: 3000000, // Adjust this based on your contract's requirements
      gasPrice: 20000000000, // 20 gwei; tweak as needed
    },
  },
  compilers: {
    solc: {
      version: "0.8.26",
    },
  },
};

Deploy with:

truffle migrate --network gr1dTestnet

2. Checking Out the GR1D Testnet Explorer

It’s your go-to for viewing transactions, inspecting smart contracts, and seeing token transfers in action. If something doesn’t look right, this is where you’ll find the details.

Real-Time Event Tracking with WebSockets

For those wanting real-time updates, you can connect via the WebSocket endpoint:

3. Bridging Assets on the GR1D Testnet

  1. Connect MetaMask to the Sepolia testnet.

  2. Set up the bridge with:

    • Source: Sepolia Testnet (L1)

    • Destination: GR1D Testnet (L2)

  3. Choose your asset (e.g., Sepolia ETH or any ERC-20 deployed there).

  4. Enter the amount and confirm the transaction.

  5. Sign in MetaMask and let the bridge do its thing. You should see the assets on GR1D Testnet in a few minutes.

4. Deploying Smart Contracts

Let’s get your smart contracts live on the GR1D Testnet. It’s straightforward if you’ve deployed on Ethereum before—same tooling, just a different network.

Step 1: Write Your Contracts

Make sure your Solidity version matches the one set in your Hardhat/Truffle config (I recommend 0.8.26).

Step 2: Compile and Deploy

With Hardhat:

npx hardhat compile
npx hardhat run scripts/deploy.js --network gr1dTestnet

With Truffle:

truffle compile
truffle migrate --network gr1dTestnet

Step 3: Verify Your Deployment

5. Monitoring and Managing Network Activity

Key L1 and L2 Smart Contracts

GR1D’s architecture links L1 (Sepolia) and L2 (GR1D Testnet), and you might want to interact with the key contracts:

6. Best Practices for Working with the Testnet

  • Use a Test Wallet: Always keep a separate wallet for testnet activity. Keeps things tidy and avoids accidental mainnet confusion.

  • Test Everything: The GR1D Testnet is built for experimentation. Push the limits—bridge assets, deploy contracts, and simulate real-world scenarios.

Got your contracts deployed? Need to debug a transaction? Head over to the .

WSS URL: Perfect for monitoring on-chain events or listening for contract events like NFT mints or DeFi protocol actions.

Ready to test out cross-chain functionality? Let’s bridge some assets between Sepolia (L1) and the GR1D Testnet (L2). It’s all done through the . Here’s how you do it:

Check the to make sure everything’s in place. You’ll be able to see transaction details, contract interactions, and token transfers—perfect for debugging and validating your deployments.

Batcher on L1: This handles batching transactions and syncing state between L1 and L2.

Proposer on L1: Submits state roots and keeps everything consistent between the GR1D Testnet and Sepolia.

Use the Explorer: Don’t skip the . It’s your best friend for transaction logs, contract validation, and debugging.

https://rpc-123420000418.raas-testnet.gelato.digital
https://explorer-testnet.gr1d.network/
GR1D Testnet Explorer
wss://ws-123420000418.raas-testnet.gelato.digital
GR1D Testnet Bridge
GR1D Testnet Explorer
Batcher Contract
Proposer Contract
GR1D Testnet Explorer
Page cover image