Builders
App Developers
Smart Contracts
GOAT Network EVM Client

GOAT Network EVM Client Overview Documentation

This documentation provides comprehensive instructions for creating a client that can read, write, and communicate with the GOAT Network EVM (Ethereum Virtual Machine) chain using the Ethers.js library. The client will handle wallet management, smart contract interactions, and connectivity to GOAT Network nodes. Additionally, it covers essential security practices, deployment guidelines, and useful tools to enhance your development experience.

Prerequisites

Before proceeding, ensure you have the following:

Visit GOAT Network RPC Documentation (opens in a new tab) for help.

Setup and Installation

Create a new directory for your project and initialize it with npm:

mkdir goat-network-client
cd goat-network-client
npm init -y

Install the necessary libraries:

npm install ethers dotenv @ethersproject/hdnode

Your project structure should look like this:

goat-network-client/
├── contracts/
│   └── FoundersClub.sol
├── src/
│   ├── index.js
│   └── wallet.js
├── .env
├── package.json
└── README.md

Network Configuration

For GOAT Testnet configuration details, refer to:

async function addGoatTestnet() {
  try {
    await window.ethereum.request({
      method: 'wallet_addEthereumChain',
      params: [{
        chainId: '0xBEAF',
        chainName: 'GOAT Testnet',
        nativeCurrency: {
          name: 'Bitcoin',
          symbol: 'BTC',
          decimals: 18
        },
        rpcUrls: ['https://rpc.testnet.goat.network'],
        blockExplorerUrls: ['https://explorer.testnet.goat.network']
      }]
    });
  } catch (error) {
    console.error('Failed to add network:', error);
  }
}

Wallet Management

Generating a New Wallet

const { ethers } = require('ethers');
const fs = require('fs');
require('dotenv').config();
 
function generateWallet() {
    const wallet = ethers.Wallet.createRandom();
    console.log('New Wallet Address:', wallet.address);
    console.log('Mnemonic Phrase:', wallet.mnemonic.phrase);
    
    const walletJson = wallet.encryptSync(process.env.WALLET_PASSWORD || 'default_password');
    fs.writeFileSync('wallet.json', walletJson);
    console.log('Wallet saved to wallet.json');
    return wallet;
}
 
module.exports = { generateWallet };

Connecting to GOAT Network

const { ethers } = require('ethers');
 
function connectToGoatTestnet() {
    const rpcURL = 'https://rpc.testnet.goat.network';
    const provider = new ethers.providers.JsonRpcProvider(rpcURL, {
        name: 'GOAT Testnet',
        chainId: 48815,
    });
    console.log('Connected to GOAT Testnet');
    return provider;
}

Local Development

For setting up a local development environment, refer to:

const localNetwork = {
  name: 'GOAT Local',
  chainId: 1337,
  network: 'development',
  rpc: 'http://localhost:8545'
}

Fee Management

For transaction fee details and best practices, refer to:

startLine: 17
endLine: 25

Development Tools

For a complete list of development tools and frameworks, refer to:

startLine: 16
endLine: 51

Testing Smart Contracts

For local testing configuration:

import { ethers } from 'ethers';
 
const provider = new ethers.JsonRpcProvider('http://localhost:8545');
const signer = await provider.getSigner();
 
// Deploy a contract
const Contract = await ethers.getContractFactory("YourContract");
const contract = await Contract.deploy();
await contract.deployed();
 
console.log("Contract deployed to:", contract.address);

Additional Resources

OverviewTransaction Fees