ETH Payment Skill

Zero config. Instant setup. Works on any EVM chain.

What This Does

Generate EIP-681 compliant payment links that work with MetaMask and other Ethereum wallets. Perfect for:

• Payment requests and invoices
• Donation links
• Mobile-friendly checkout
• Any on-chain payment collection

No API keys. No servers. No configuration.

Installation

Prerequisites

• Python 3.8+ - Required to run the script
• Node.js (optional) - Required only for QR code generation (npx qrcode)

Quick Install

No additional dependencies needed! The skill uses:

• Python standard library only
• npx qrcode for QR codes (auto-downloads on first use)

Run the Skill

python3 scripts/eth_payment.py create --to 0xYourAddress --amount 0.1

---

Quick Start

# Basic ETH payment on Base
eth-payment create --to 0xYourAddress --amount 0.1

# USDC payment with QR code
eth-payment create --to 0xYourAddress --amount 100 --token USDC --qr payment.png

# Specify network
eth-payment create --to 0xYourAddress --amount 10 --token USDC --network ethereum --qr qr.png

Commands

create - Generate Payment Link

eth-payment create --to <address> --amount <number> [options]

Required:
  --to <address>      Recipient address (0x...)
  --amount <number>   Amount to request

Options:
  --token <symbol>    Token symbol (default: ETH)
  --network <name>    Network: base, ethereum, arbitrum, optimism, polygon (default: base)
  --qr <path>         Generate QR code and save to path
  --json              Output as JSON for programmatic use

chains - List Supported Networks

eth-payment chains
eth-payment chains --json

tokens - List Tokens for Network

eth-payment tokens --network base
eth-payment tokens --network ethereum --json

validate - Validate Address

eth-payment validate 0x...

Supported Networks

Network	Chain ID	Native Token	ERC-20 Tokens
base	8453	ETH	USDC, USDT, WETH
ethereum	1	ETH	USDC, USDT, WETH, DAI
arbitrum	42161	ETH	USDC, USDT, ARB
optimism	10	ETH	USDC, OP
polygon	137	MATIC	USDC, USDT, WETH

Examples

Invoice with QR Code

eth-payment create \
  --to 0x1F3A9A450428BbF161C4C33f10bd7AA1b2599a3e \
  --amount 100 \
  --token USDC \
  --network base \
  --qr invoice_qr.png

JSON Output for Integration

eth-payment create --to 0x... --amount 10 --token USDC --json

Output:

{
  "success": true,
  "network": "base",
  "chain_id": 8453,
  "token": "USDC",
  "recipient": "0x...",
  "amount": "10",
  "links": {
    "eip681": "ethereum:0x833...@8453/transfer?address=0x...&uint256=10000000",
    "metamask": "https://metamask.app.link/send/..."
  },
  "transaction": {
    "to": "0x833...",
    "value": "0x0",
    "data": "0xa9059cbb..."
  }
}

How It Works

1. EIP-681 Standard: Uses the Ethereum Improvement Proposal 681 format for payment links
2. Universal: Same code works on any EVM chain - only configuration differs
3. QR Codes: Generated locally via npx qrcode, no external services

Security Notes

• This skill only generates payment links, it cannot execute transactions
• No private keys or secrets required
• All processing happens locally
• Always verify the recipient address before sharing payment links

Adding New Chains

To add a new EVM chain, edit config/chains.json:

{
  "chains": {
    "new-chain": {
      "name": "New Chain",
      "chain_id": 12345,
      "native_token": "NATIVE",
      "tokens": {
        "NATIVE": {
          "address": "0x0000000000000000000000000000000000000000",
          "decimals": 18,
          "is_native": true
        },
        "USDC": {
          "address": "0x...",
          "decimals": 6
        }
      }
    }
  }
}

---

Maintainer: Web3 Investor Team
License: MIT