🌀

Arbitrum Integration

Complete guide for integrating Arbitrum networks into your Bicrypto Ecosystem

📖 Overview

This guide shows you how to integrate Arbitrum networks (Arbitrum Mainnet and Goerli) into your Bicrypto Ecosystem. You'll add Arbitrum credentials in .env, acquire API/RPC endpoints, then set up wallets and tokens in the admin panel—similar to how it's done for other EVM-compatible chains like Ethereum or Optimism.

Supported Networks

Arbitrum Mainnet and Goerli Testnet are supported. ETH (Layer 2) is used for transaction fees on Arbitrum.

1️⃣ Configure Environment Variables

Arbitrum Environment Variables

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

# Arbitrum Networks (mainnet, goerli)
ARBITRUM_EXPLORER_API_KEY="YOUR_ARBITRUM_EXPLORER_API_KEY"  # e.g., 4EEJEPRYQG7D...
ARBITRUM_NETWORK="goerli"
ARBITRUM_MAINNET_RPC="https://YOUR_MAINNET_RPC_PLACEHOLDER"
ARBITRUM_MAINNET_RPC_WSS=""
ARBITRUM_GOERLI_RPC="https://YOUR_GOERLI_RPC_PLACEHOLDER"
ARBITRUM_GOERLI_RPC_WSS=""

ARBITRUM_EXPLORER_API_KEY: Your Arbiscan API key for blockchain data

ARBITRUM_NETWORK: Active network (mainnet or goerli)

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

2️⃣ Acquire API Keys and RPC Endpoints

AS

Arbiscan API

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

ARBITRUM_EXPLORER_API_KEY="your_key_here"
RPC

RPC Providers

Sign up for RPC services like Alchemy, GetBlock, or others offering Arbitrum endpoints with reliable uptime and performance.

ARBITRUM_MAINNET_RPC="https://your-endpoint"
Arbiscan API key creation

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 (Layer 2) 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 Arbitrum.

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

🔍 Arbitrum-Specific Considerations

Lower Gas Fees

Arbitrum gas fees are generally lower than Ethereum L1, but can still fluctuate. Monitor fees and adjust your minimum withdrawal fees accordingly.

Goerli Testnet

Use Goerli testnet for development. Set ARBITRUM_NETWORK="goerli" and acquire test ETH from Goerli faucets.

🔒 Security Best Practices