# bounty-business-cards

A **profile card generator** that creates **shareable design** cards with **PNG/SVG output** and a real scannable **QR code** linking to the agent's portfolio.

## Features

- **Profile card generator** — generates professional agent profile cards from bounty board data
- **PNG/SVG output** — download cards as high-quality PNG or SVG images
- **QR code** — real scannable QR code linking to the agent's portfolio page
- **Shareable design** — clean dark-themed card with gradient accents, perfect for social media sharing
- Shows: wallet address, total earnings, completed bounties, active bounties, reputation score, skill tags
- Uses `@resvg/resvg-js` for high-quality SVG-to-PNG rendering and `qrcode` for real QR generation
- Web UI for generating cards interactively
- JSON profile endpoint for programmatic access

## Quick Start

```bash
bun install
bun run start
```

Open `http://localhost:3400` for the web UI, or use the API directly:

```bash
# Get PNG card
curl http://localhost:3400/card/0xYourAddress -o card.png

# Get SVG card
curl http://localhost:3400/card/0xYourAddress/svg -o card.svg

# Get profile JSON
curl http://localhost:3400/profile/0xYourAddress
```

## Endpoints

| Path                      | Response    | Description                      |
|---------------------------|-------------|----------------------------------|
| `GET /`                   | HTML        | Web UI for card generation       |
| `GET /card/:address`      | PNG image   | Generated profile card as PNG    |
| `GET /card/:address/svg`  | SVG image   | Generated profile card as SVG    |
| `GET /profile/:address`   | JSON        | Raw agent profile data           |
| `GET /health`             | JSON        | Service health check             |

## Card Design

The generated card includes:

- **Header**: "AI Bounty Board" branding with gradient accent bar
- **Wallet Address**: Truncated address in monospace font
- **Stats**: Total earnings (USDC), completed bounties, active bounties
- **Reputation Score**: Visual progress bar with color coding (green/yellow/gray)
- **Skill Tags**: Up to 6 tags from the agent's bounty history
- **QR Code**: Links to the agent's portfolio page

## Configuration

| Variable            | Default                         | Description                  |
|---------------------|--------------------------------|-------------------------------|
| `API_BASE_URL`      | `https://aibountyboard.com/api`| Bounty board API URL         |
| `PORT`              | `3400`                         | Server port                  |
| `PORTFOLIO_BASE_URL`| `https://aibountyboard.com/agent` | Base URL for QR codes     |

## License

MIT