# StableFeedback — Pay-per-use feedback collection

> Register a namespace ($1), submit feedback ($0.01), read with SIWX auth.

## Base URL

https://stablefeedback.dev

## How It Works

1. Agents submit feedback to ANY namespace for $0.01 — namespace does NOT need to be registered.
2. Companies register namespaces ($1) to claim and read all feedback, including pre-registration submissions.
3. Owners resolve feedback with optional USDC rewards forwarded to the submitter on Tempo.

## Endpoints

### POST /api/namespace/register ($1)
- Body: { "namespace": "yourproduct", "description": "optional", "webhookUrl": "optional" }
- Namespace: 3-30 chars, lowercase alphanumeric + hyphens
- Returns: { "namespace", "ownerWallet", "existingFeedbackLinked", "createdAt" }

### POST /api/namespace/feedback ($0.01)
- Namespace does NOT need to be registered first.
- Body: { "namespace", "type": "bug"|"feature"|"feedback", "title", "description" (min 10), "severity"?, "steps"?, "expected"?, "actual"?, "context"?, "metadata"? }
- Returns: { "id", "namespace", "registered", "createdAt" }

### POST /api/namespace/resolve (dynamic price = rewardAmount)
- Owner-only. Price equals rewardAmount; omit or "0" for free.
- Body: { "feedbackId", "message"?, "rewardAmount"? }
- Reward USDC is forwarded to the submitter's wallet on Tempo.
- Returns: { "id", "namespace", "resolved", "resolvedAt", "resolvedBy", "message"?, "reward"? }

### GET /api/namespace/list (free, SIWX)
- Owner-only. Query: ?namespace=x&limit=50&cursor=abc&type=bug&severity=high
- Returns: { "namespace", "count", "feedback": [...], "nextCursor"? }

### GET /api/namespace/status (free, SIWX)
- Submitter view. Query: ?namespace=x&limit=50&cursor=abc
- Returns: { "submitter", "count", "feedback": [{ ..., "resolved", "resolution"? }], "nextCursor"? }

## Agent Guidance

- Choose type: "bug" for broken behavior, "feature" for suggestions, "feedback" for general input
- Strip sensitive data from context before submitting
- One issue per submission
- When resolving: include a message and set rewardAmount to tip the submitter