smom-dbis-138/docs/deployment/FOUNDRY_CONFIG_FIX.md

Foundry Configuration Fix

Date: 2025-12-11 Issue: Warnings about unknown etherscan and rpc_url config in profiles

---

❌ Problem

Foundry was showing warnings:

Warning: Found unknown `etherscan` config for profile `mainnet` defined in foundry.toml.
Warning: Found unknown `rpc_url` config for profile `mainnet` defined in foundry.toml.

These warnings appeared for all network profiles (mainnet, cronos, bsc, polygon, gnosis, avalanche, base, arbitrum, optimism).

---

✅ Solution

Foundry profiles don't support rpc_url and etherscan as direct keys. These configurations should be referenced via command-line flags instead.

Removed: Profile sections with rpc_url and etherscan keys Kept: [rpc_endpoints] and [etherscan] sections (these are correct)

---

📋 Correct Usage

RPC Endpoints

Reference RPC endpoints by name from the [rpc_endpoints] section:

# Use mainnet RPC
forge script ... --rpc-url mainnet

# Use polygon RPC
forge script ... --rpc-url polygon

Etherscan API Keys

Reference etherscan configs by name and pass the API key:

# For mainnet
forge verify-contract ... --etherscan-api-key $ETHERSCAN_API_KEY

# For polygon
forge verify-contract ... --etherscan-api-key $POLYGONSCAN_API_KEY

Or use the --chain flag with the etherscan config name:

forge verify-contract ... --chain polygon --etherscan-api-key $POLYGONSCAN_API_KEY

---

🔧 Configuration Structure

Correct foundry.toml Structure

[rpc_endpoints]
mainnet = "${ETHEREUM_MAINNET_RPC}"
polygon = "${POLYGON_RPC_URL}"
# ... etc

[etherscan]
mainnet = { key = "${ETHERSCAN_API_KEY}" }
polygon = { key = "${POLYGONSCAN_API_KEY}", chain = "polygon" }
# ... etc

# Profiles should NOT contain rpc_url or etherscan keys
[profile.default]
# ... compiler settings

Removed Profile Sections

The following profile sections were removed (they caused warnings):

# ❌ REMOVED - Not supported by Foundry
[profile.mainnet]
rpc_url = "mainnet"
etherscan = "mainnet"
chain_id = 1

---

📝 Chain IDs Reference

For reference when using --chain-id flag:

• mainnet: 1
• cronos: 25
• bsc: 56
• polygon: 137
• gnosis: 100
• avalanche: 43114
• base: 8453
• arbitrum: 42161
• optimism: 10

---

✅ Verification

After the fix, Foundry commands should run without warnings:

# Should show no warnings
forge script script/DeployMainnetTether.s.sol --rpc-url mainnet --dry-run

# Should show no warnings
forge verify-contract ... --etherscan-api-key $ETHERSCAN_API_KEY

---

📚 Additional Resources

• Foundry Book - Configuration
• Foundry Book - Scripts
• Foundry Book - Verify

---

Last Updated: 2025-12-11 Status: ✅ Fixed