eth-payment

# 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

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

---

## Quick Start

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

```bash
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

```bash
eth-payment chains
eth-payment chains --json
```

### `tokens` - List Tokens for Network

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

### `validate` - Validate Address

```bash
eth-payment validate 0x...
```

## Supported Networks

| Network | Chain ID | Native Token | ERC-20 Tokens |
|-...