etherlink

Etherlink Skill

Interact with Etherlink, an EVM-compatible L2 built on Tezos.

Quick Start

1. Configure MCP Server

Add to your Claude/MCP config:

{
  "mcpServers": {
    "etherlink": {
      "command": "bun",
      "args": ["run", "/path/to/etherlink-mcp-server/src/index.ts"],
      "env": {
        "EVM_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

2. Select Network

Use network name or chain ID:

• Mainnet: etherlink or 42793
• Testnet: etherlink-shadownet or 127823

Networks

Network	Chain ID	RPC	Explorer
Etherlink Mainnet	42793	https://node.mainnet.etherlink.com	https://explorer.etherlink.com
Etherlink Shadownet	127823	https://node.shadownet.etherlink.com	https://shadownet.explorer.etherlink.com

Native Currency: XTZ (18 decimals)

Common Operations

Check Balance

Get balance for 0x... on etherlink

Send Transaction

Send 0.1 XTZ to 0x... on etherlink

Read Contract

Call balanceOf on contract 0x... for address 0x... on etherlink

Get Block Info

Get latest block on etherlink

Etherlink-Specific Notes

Key Differences

1. Native Currency: XTZ (Tez), not ETH
2. No EIP-1559: Fee market not yet implemented - use legacy gas pricing
3. Block Hashes: Computed differently (can't verify from header alone)
4. Rate Limits: Public RPC limited to 1000 req/min

Supported Endpoints

• ✅ eth_blockNumber, eth_chainId, eth_getBalance
• ✅ eth_call, eth_estimateGas, eth_gasPrice
• ✅ eth_sendRawTransaction, eth_getLogs
• ✅ debug_traceTransaction
• ❌ eth_subscribe (experimental only)
• ❌ Filter endpoints (eth_newFilter, etc.)

Tezos L1 Bridge

Etherlink bridges to Tezos L1 for deposits/withdrawals. Bridge operations require Tezos tooling. See Etherlink Docs for details.

Testnet Faucet

Get testnet XTZ: https://shadownet.faucet.etherlink.com

Troubleshooting

"Unsupported network": Use correct network name (etherlink, etherlink-shadownet) or chain ID.

Rate limited: Public RPC has 1000 req/min limit. For production, run your own node.

Transaction failing: No EIP-1559 - don't set maxFeePerGas/maxPriorityFeePerGas.

Resources

• Etherlink Docs
• Block Explorer
• Shadownet Explorer
• Faucet