ripley-xmr-gateway

# Ripley Monero Agent Gateway

> Part of the [KYC.rip](https://kyc.rip) product lines.

A portable, secure HTTP gateway for AI agents to interact with the Monero (XMR) blockchain. Built to follow the `agentskills.io` specification.

## Why "Ripley"?
Named after the central character who values survival, independence, and raw competence in the face of overwhelming systems. **Ripley** represents the "anti-KYC" ethos: an entity that doesn't ask for permission, doesn't leak identity, and manages its own resources autonomously. 

This gateway is the bridge that allows your AI agents to become sovereign financial entities, free from the constraints of centralized payment rails.

## 🚀 Quick Start (One-Liner)

Deploy your own secure Ripley Gateway in seconds. This script prepares the environment, handles filesystem permissions, generates a secure `AGENT_API_KEY`, and starts the Docker stack.

```bash
curl -sL https://raw.githubusercontent.com/KYC-rip/ripley-xmr-gateway/main/scripts/install.sh | bash
```

> [!IMPORTANT]
> **API Key Visibility**: The script will output your generated `AGENT_API_KEY` at the end. Copy it immediately to configure your AI Agent skills.

### 1. Installation for AI Agents

**Gemini Skills CLI**:
```bash
gemini skills install https://github.com/KYC-rip/ripley-xmr-gateway.git --path skills/monero-wallet
```

**OpenClaw / ClawHub**:
The Monero Wallet skill is published on [ClawHub](https://clawhub.ai/xbtoshi/monero-wallet).
Install it directly into your workspace:
```bash
# Recommended: Install via ClawHub CLI
clawhub install monero-wallet
```

Alternatively, link it locally:
```bash
# Manual Link
ln -s /path/to/ripley-xmr-gateway/skills/monero-wallet ~/.openclaw/skills/monero-wallet
```


## Features
- **Stateless AI Integration**: Connect any AI model (Gemini, GPT-4, etc.) to Monero via standard HTTP.
- **XMR402 Paywall Support**: Native support for the [XMR402 Protocol](https://xmr402.org) to handle autonomous payments.
- **Payment Recovery**: Bui