# echolonius/the-penniless-agent architecture

> Architecture diagram of the GitHub repository echolonius/the-penniless-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/echolonius/the-penniless-agent
- Repository: https://github.com/echolonius/the-penniless-agent

## Overview

This repository is a field report and playbook, not the implementation of an agent-commerce runtime. The graph captures the documented earn–hold–spend flow and its identity, discovery, and persistence capabilities; runtime components hosted in other repositories or services have no repository source path. Relationships are taken from the README, so implementation details beyond those statements are not shown.

Main entry points: [`README.md`](https://github.com/echolonius/the-penniless-agent/blob/main/README.md) (Receive-only EVM wallet)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_earning["Earning"]
  node_bounty["Superteam agent API"]
  node_paid_service["Token Intelligence service"]
end

subgraph group_money["Money flow"]
  node_wallet[("Receive-only EVM wallet<br/>[README.md]")]
  node_bitrefill["Bitrefill checkout"]
end

subgraph group_identity["Identity and discovery"]
  node_siwx["SIWX registration flow<br/>[README.md]"]
  node_x402scan["x402scan registry"]
  node_index402["402index registry"]
end

subgraph group_operations["Persistence"]
  node_watcher["Earning watcher"]
  node_github_actions["GitHub Actions"]
  node_status_page["Status page"]
  node_deno["Deno Deploy"]
end

node_agent(("AI agent"))

node_agent -->|"finds and submits"| node_bounty
node_agent -->|"sells API calls"| node_paid_service
node_bounty -->|"pays winnings"| node_wallet
node_paid_service -->|"receives USDC"| node_wallet
node_agent -->|"pays for goods"| node_bitrefill
node_wallet -->|"signs and pays"| node_bitrefill
node_wallet -->|"signs identity"| node_siwx
node_siwx -->|"registers identity"| node_x402scan
node_wallet -->|"registers by signature"| node_index402
node_github_actions -->|"runs on cron"| node_watcher
node_watcher -->|"polls listings"| node_bounty
node_watcher -->|"checks balance"| node_wallet
node_watcher -->|"checks health"| node_paid_service
node_watcher -->|"commits status"| node_status_page
node_deno -->|"hosts service"| node_paid_service

click node_wallet "https://github.com/echolonius/the-penniless-agent/blob/main/README.md"
click node_siwx "https://github.com/echolonius/the-penniless-agent/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_bounty,node_paid_service toneBlue
class node_wallet,node_bitrefill toneAmber
class node_siwx,node_x402scan,node_index402 toneMint
class node_watcher,node_github_actions,node_status_page,node_deno toneRose
class node_agent toneIndigo
```

## Components

### Earning

- **Superteam agent API**
- **Token Intelligence service**

### Money flow

- [Receive-only EVM wallet](https://github.com/echolonius/the-penniless-agent/blob/main/README.md): `README.md`
- **Bitrefill checkout**

### Identity and discovery

- [SIWX registration flow](https://github.com/echolonius/the-penniless-agent/blob/main/README.md): `README.md`
- **x402scan registry**
- **402index registry**

### Persistence

- **Earning watcher**
- **GitHub Actions**
- **Status page**
- **Deno Deploy**

### Other components

- **AI agent**

## Connections

- AI agent → Superteam agent API: finds and submits (evidence: `README.md`)
- AI agent → Token Intelligence service: sells API calls (evidence: `README.md`)
- Superteam agent API → Receive-only EVM wallet: pays winnings (evidence: `README.md`)
- Token Intelligence service → Receive-only EVM wallet: receives USDC (evidence: `README.md`)
- AI agent → Bitrefill checkout: pays for goods (evidence: `README.md`)
- Receive-only EVM wallet → Bitrefill checkout: signs and pays (evidence: `README.md`)
- Receive-only EVM wallet → SIWX registration flow: signs identity (evidence: `README.md`)
- SIWX registration flow → x402scan registry: registers identity (evidence: `README.md`)
- Receive-only EVM wallet → 402index registry: registers by signature (evidence: `README.md`)
- GitHub Actions → Earning watcher: runs on cron (evidence: `README.md`)
- Earning watcher → Superteam agent API: polls listings (evidence: `README.md`)
- Earning watcher → Receive-only EVM wallet: checks balance (evidence: `README.md`)
- Earning watcher → Token Intelligence service: checks health (evidence: `README.md`)
- Earning watcher → Status page: commits status (evidence: `README.md`)
- Deno Deploy → Token Intelligence service: hosts service (evidence: `README.md`)
