🌀

# 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"`

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