👻

# Fantom Integration

Complete guide for integrating Fantom (FTM) networks into your Bicrypto Ecosystem

## 📖 Overview

This guide shows you how to integrate Fantom (FTM) networks into your Bicrypto Ecosystem. You'll add FTM credentials in `.env`, acquire API/RPC endpoints, then set up wallets and tokens in the admin panel—much like you would for Ethereum, BSC, or Polygon.

Supported Networks

Fantom Mainnet and Testnet are supported. FTM is used for transaction fees on Fantom networks.

## 1️⃣ Configure Environment Variables

### Fantom Environment Variables

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

    # FTM Networks (mainnet, testnet)
    FTM_EXPLORER_API_KEY="YOUR_FTMSCAN_API_KEY"  # e.g., R2UMPU4MS5FMQTV5...
    FTM_NETWORK="testnet"
    FTM_MAINNET_RPC="https://YOUR_MAINNET_RPC_PLACEHOLDER"
    FTM_MAINNET_RPC_WSS=""
    FTM_TESTNET_RPC="https://YOUR_TESTNET_RPC_PLACEHOLDER"
    FTM_TESTNET_RPC_WSS=""

• FTM_EXPLORER_API_KEY: Your FtmScan (or related Fantom explorer) API key

• FTM_NETWORK: Active network (mainnet or testnet)

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

## 2️⃣ Acquire API Keys and RPC Endpoints

FS

### FtmScan API

Create an account at ftmscan.com and generate an API key for blockchain data access.

`FTM_EXPLORER_API_KEY="your_key_here"`
RPC

### RPC Providers

Sign up for RPC services like BlastAPI or others offering Fantom endpoints with reliable uptime and generous limits.

`FTM_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 FTM 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 Fantom.

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

## 🔍 Fantom-Specific Considerations

### Low Gas Fees

Fantom typically has very low gas fees and fast transaction times, making it ideal for DeFi applications. Monitor FTM prices for optimal fee settings.

### Testnet Development

Use Fantom testnet for development. Set `FTM_NETWORK="testnet"` and acquire test FTM from faucets.

## 🔒 Security Best Practices