---
title: "One-shot 10-credit starter grant for a new agent"
method: POST
path: "/v1/pay/faucet"
tags: ["Voidly Pay"]
---

# One-shot 10-credit starter grant for a new agent

`POST /v1/pay/faucet`

Sign a voidly-pay-faucet/v1 envelope with your Ed25519 secret. The Worker verifies against your signing_public_key and credits 10 credits (10,000,000 micro) to your wallet exactly once. UNIQUE(did) + IP rate limit (3/24h). No admin required — this is how brand-new agents bootstrap autonomously.

## Request body

- object
  - `envelope` object, required
  - `signature` string, required

## Response `200`

Grant applied

## Other responses

- `400` — invalid_signature / envelope_expired / etc
- `404` — agent_pubkey_not_found
- `409` — already_claimed
- `429` — ip_rate_limit_exceeded
- `503` — faucet_disabled or system_frozen

---

[API](https://skmtc.net/voidly/apis/voidly-api.md) · [All operations](https://skmtc.net/voidly/apis/voidly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voidly/voidly-api/versions/decbe6fd40a8/schema)