paygents

# PayGents

Accept crypto payments through your AI agent. Generate wallet deeplinks, verify on-chain, issue receipts — no backend, no API keys.

## Quick Start

Send 10 USDC on Base:
```bash
scripts/evm-payment-link.sh --to 0xRECIPIENT --amount 10 --chain-id 8453
```

Verify the payment:
```bash
scripts/evm-verify-tx.sh --chain-id 8453 --from 0xSENDER --to 0xRECIPIENT --asset ERC20 --amount 10 --blocks 50
```

Check a wallet balance:
```bash
scripts/evm-balance.sh --address 0xADDRESS
```

That's it. No API keys, no backend, no custody.

## Flow

1. Agent collects payment details (recipient, amount, chain, token).
2. Agent runs the link generator script → gets a MetaMask deeplink.
3. Agent sends the link to the user.
4. User taps → MetaMask opens with pre-filled transfer → user approves.
5. User confirms "sent" → agent verifies the tx on-chain.

## Wallet Detection

Before generating a link, the agent should know which wallet the user has. Ask once, remember forever.

**Supported wallets with native deeplinks:**

| Wallet | `--wallet` flag | Deeplink format |
|--------|----------------|-----------------|
| MetaMask | `metamask` (default) | `https://link.metamask.io/send/...` |
| Trust Wallet | `trust` | `https://link.trustwallet.com/send?...` |

**Not supported (no send deeplinks):**
- Rabby — only has in-app browser, no direct send deeplink
- Coinbase Wallet — only has dapp browser deeplink, no direct send
- Phantom — requires encrypted handshake, not a simple URL

If the user's wallet isn't supported, default to MetaMask (most common) or let them know.

Store the user's wallet preference so you don't ask again. The agent should note the preference in its local session context (e.g. memory file). The user can change or clear this at any time by telling the agent.

## Inputs Required

| Field | Required | Description |
|-------|----------|-------------|
| `--to` | Yes | Recipient address (`0x...`) |
| `--amount` | Yes | Human-readable amount (e.g. `1.5`) |
| `--chain...

# PayGents

> Let your AI agent request payments without ever touching private keys.

PayGents is an [OpenClaw](https://openclaw.ai) skill that lets AI agents generate wallet deeplinks for EVM payments. The user taps the link, approves in their own wallet (MetaMask, Trust Wallet), and the agent verifies the transaction on-chain.

**No backend. No custody. No private keys.** The agent proposes, the human approves.

## How It Works

```
Agent receives payment request
    ↓
Agent generates wallet deeplink (MetaMask / Trust Wallet)
    ↓
Agent sends link to user via chat (Telegram, Discord, etc.)
    ↓
User taps → wallet opens with pre-filled transfer → user approves
    ↓
Agent verifies transaction on-chain
    ↓
Agent generates receipt ✅
```

## Install

```bash
clawhub install paygents
```

Or clone directly:

```bash
git clone https://github.com/AmitayBohadana/paygents.git
```

## Quick Start

### 1. Generate a Payment Link

```bash
# USDC on Base (MetaMask)
scripts/evm-payment-link.sh \
  --to 0x1234...5678 \
  --amount 10 \
  --chain-id 8453

# Native ETH on Sepolia (Trust Wallet)
scripts/evm-payment-link.sh \
  --to 0x1234...5678 \
  --amount 0.01 \
  --asset ETH \
  --chain-id 11155111 \
  --wallet trust
```

### 2. Verify Transaction

After the user confirms they've sent:

```bash
# Scan recent blocks
scripts/evm-verify-tx.sh \
  --chain-id 8453 \
  --from 0xSENDER \
  --to 0xRECIPIENT \
  --asset ERC20 \
  --amount 10

# Or verify a specific tx hash
scripts/evm-verify-tx.sh \
  --chain-id 8453 \
  --from 0xSENDER \
  --to 0xRECIPIENT \
  --asset ERC20 \
  --amount 10 \
  --tx-hash 0xabc123...
```

### 3. Generate Receipt

```bash
scripts/evm-receipt.sh \
  --tx-hash 0xabc123... \
  --chain-id 8453 \
  --memo "order-42" \
  --merchant "Cool Store" \
  --format markdown
```

### 4. Check Wallet Balance

```bash
# All chains
scripts/evm-balance.sh --address 0x1234...5678

# Single chain
scripts/evm-balance.sh --address 0x1234...5678 --chain-id 8453
```

Returns...