# Guide: Enter the GR1D Testnet

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**: <https://rpc-123420000418.raas-testnet.gelato.digital>
   * **Chain ID**: `123420000418`
   * **Currency Symbol**: ETH (we’re using Sepolia ETH here)
   * **Block Explorer URL**: <https://explorer-testnet.gr1d.network/>
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:

```javascript
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:

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

**Truffle Configuration**

Update your `truffle-config.js` to include:

```javascript
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:

```bash
truffle migrate --network gr1dTestnet
```

### 2. Checking Out the GR1D Testnet Explorer

Got your contracts deployed? Need to debug a transaction? Head over to the [**GR1D Testnet Explorer**](https://blockscout-123420000418.raas-testnet.gelato.digital/).&#x20;

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:

* **WSS URL**: <wss://ws-123420000418.raas-testnet.gelato.digital>\
  Perfect for monitoring on-chain events or listening for contract events like NFT mints or DeFi protocol actions.

### 3. Bridging Assets on the GR1D Testnet

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 [GR1D Testnet Bridge](https://testnet-bridge.gelato.network/bridge/gr1d-testnet-1). Here’s how you do it:

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:

```bash
npx hardhat compile
```

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

With Truffle:

```bash
truffle compile
```

```bash
truffle migrate --network gr1dTestnet
```

#### Step 3: Verify Your Deployment

Check the [GR1D Testnet Explorer](https://blockscout-123420000418.raas-testnet.gelato.digital/) 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.

### 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:

* **Batcher on L1**: [Batcher Contract](https://sepolia.etherscan.io/address/0xfbFbe73846784101809930E1a2f28cAc235E9F97)\
  This handles batching transactions and syncing state between L1 and L2.
* **Proposer on L1**: [Proposer Contract](https://sepolia.etherscan.io/address/0x0A4ABdE5C08063616c647424c606Bf6B58212153)\
  Submits state roots and keeps everything consistent between the GR1D Testnet and Sepolia.

### 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.
* **Use the Explorer**: Don’t skip the [GR1D Testnet Explorer](https://blockscout-123420000418.raas-testnet.gelato.digital/). It’s your best friend for transaction logs, contract validation, and debugging.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gr1d.network/build-with-gr1d/guide-enter-the-gr1d-testnet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.