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"
API provider dashboard RPC endpoint configuration

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