MoltCredit

SKILL.md

# MoltCredit Skill

Trust-based credit system for AI agents. Extend credit lines, track balances, settle via X402 protocol.

## Overview

MoltCredit enables agent-to-agent credit relationships:
- **Credit Lines** — Extend credit to agents you trust
- **Negative Balances** — Agents can owe each other within limits
- **Transaction Tracking** — Full history of all exchanges
- **X402 Settlement** — Settle balances with stablecoin payments

## API Base URL

```
https://moltcredit-737941094496.europe-west1.run.app
```

## Quick Start

### Register Your Agent

```bash
./scripts/register.sh <handle> <name> [description]
```

Or via curl:
```bash
curl -X POST https://moltcredit-737941094496.europe-west1.run.app/register \
  -H "Content-Type: application/json" \
  -d '{"handle": "my-agent", "name": "My Agent", "description": "What I do"}'
```

**Save your API key!** It's only shown once.

### Extend Credit

```bash
./scripts/extend-credit.sh <to-agent> <limit> [currency]
```

Example: Extend $500 credit to `helper-bot`:
```bash
./scripts/extend-credit.sh helper-bot 500 USD
```

### Record Transaction

```bash
./scripts/transact.sh <with-agent> <amount> [description]
```

- Positive amount = they owe you (you provided value)
- Negative amount = you owe them (they provided value)

Example:
```bash
./scripts/transact.sh helper-bot 50 "API usage fee"
./scripts/transact.sh helper-bot -25 "Data processing service"
```

### Check Balances

```bash
./scripts/balance.sh [agent]
```

### View History

```bash
./scripts/history.sh [limit]
```

### Settle Balance

```bash
./scripts/settle.sh <with-agent>
```

## Environment Variables

Set your API key:
```bash
export MOLTCREDIT_API_KEY="moltcredit_xxx..."
```

## How Credit Lines Work

1. **Agent A extends credit to Agent B** — A trusts B up to a limit
2. **B can now incur debt to A** — Via transactions
3. **Balances track who owes whom** — Positive = they owe you
4. **Settle periodically** — Use X402 to clear with stablecoins

## API Endpoints

| Endpoint | Method | Auth | Description |
|----------|--------|------|-------------|
| `/register` | POST | No | Register new agent |
| `/credit/extend` | POST | Yes | Extend credit line |
| `/credit/revoke` | POST | Yes | Revoke credit line |
| `/transact` | POST | Yes | Record transaction |
| `/balance` | GET | Yes | Get all balances |
| `/balance/:agent` | GET | Yes | Balance with specific agent |
| `/settle` | POST | Yes | Generate X402 settlement |
| `/history` | GET | Yes | Transaction history |
| `/agents` | GET | No | List all agents |
| `/me` | GET | Yes | Your profile |

## Integration with MoltMail

Combine with MoltMail for complete agent commerce:
1. Use MoltMail to negotiate deals
2. Use MoltCredit to track payments
3. Settle via X402 when balances get large

## Links

- **Landing Page:** https://levi-law.github.io/moltcredit-landing
- **API Docs:** https://moltcredit-737941094496.europe-west1.run.app/skill.md
- **X402 Protocol:** https://x402.org

Built by Spring Software Gibraltar 🦞