⟡

# Ethereum Integration

Complete guide for integrating Ethereum into your Bicrypto Ecosystem

## 📖 Overview

This guide shows you how to integrate Ethereum networks (mainnet, Sepolia, Goerli) into your Bicrypto Ecosystem. You'll configure environment variables, acquire API and RPC endpoints, then set up wallets and tokens in the admin panel.

Supported Networks

Ethereum Mainnet, Sepolia Testnet, and Goerli Testnet are supported. ETH is used for transaction fees.

## 1️⃣ Configure Environment Variables

### Ethereum Environment Variables

Add the following Ethereum-specific variables to your `.env` file:

    # Ethereum Networks (mainnet, sepolia, goerli)
    ETH_EXPLORER_API_KEY="YOUR_ETHERSCAN_API_KEY"  # e.g., 59J3XYZ123
    ETH_NETWORK="mainnet"
    ETH_MAINNET_RPC="https://eth.public-rpc.com"
    ETH_MAINNET_RPC_WSS="wss://YOUR_MAINNET_WSS_PLACEHOLDER"
    ETH_GOERLI_RPC="https://YOUR_GOERLI_RPC_PLACEHOLDER"
    ETH_GOERLI_RPC_WSS="wss://YOUR_GOERLI_RPC_WSS_PLACEHOLDER"
    ETH_SEPOLIA_RPC="https://YOUR_SEPOLIA_RPC_PLACEHOLDER"
    ETH_SEPOLIA_RPC_WSS="wss://YOUR_SEPOLIA_RPC_WSS_PLACEHOLDER"

• ETH_EXPLORER_API_KEY: Your Etherscan API key for blockchain data

• ETH_NETWORK: Active network (mainnet, sepolia, or goerli)

• RPC/WSS URLs: HTTP and WebSocket endpoints for each network

## 2️⃣ Acquire API Keys and RPC Endpoints

ES

### Etherscan API

Create an account at etherscan.io and generate an API key for blockchain data access.

`ETH_EXPLORER_API_KEY="your_key_here"`
BA

### BlastAPI RPC

Sign up at blastapi.io for reliable Ethereum RPC endpoints with generous monthly limits.

`ETH_MAINNET_RPC="https://your-endpoint"`

## 3️⃣ Apply Environment Updates

## 4️⃣ Configure Master Wallet

## 5️⃣ Enable Tokens and Configure Fees

## 6️⃣ Custodial Wallets (For Non-Permit Tokens)

When Custodial Wallets Are Needed

Some tokens don't support the PERMIT feature for fee delegation. For these tokens, you'll need to deploy custodial wallets.

1

### Fund Master Wallet

Ensure your master wallet has sufficient ETH to cover gas fees for custodial wallet deployments and transactions.

2

### Deploy Custodial Wallet

Go to Admin → Extensions → Ecosystem → Custodial Wallets and deploy a new custodial wallet for Ethereum.

The platform will handle user deposits/withdrawals through this wallet, with the master wallet paying ETH gas fees.

## 🔍 Ethereum-Specific Considerations

### Gas Fee Management

Ethereum gas fees can be volatile. Monitor network congestion and adjust minimum withdrawal fees accordingly to maintain profitability.

### Testnet Development

Use Sepolia or Goerli testnets for development. Set `ETH_NETWORK="sepolia"` and acquire test ETH from faucets.

## 🔒 Security & Best Practices