Files
SatsFaucet/backend/openapi/index.yaml
2026-02-28 21:14:27 -03:00

61 lines
1.7 KiB
YAML

openapi: 3.0.3
info:
title: LNFaucet API
description: |
Lightning Network faucet: request small amounts of sats for testing.
Auth via NIP-98 (Nostr) or npub-only (limited).
version: 1.0.0
servers:
- url: http://localhost:3001
description: Local development
tags:
- name: Public
description: No authentication required
- name: Auth
description: NIP-98 or npub login
- name: Claim
description: Request sats (rate limited)
- name: User
description: Profile and refresh
paths:
/health:
$ref: './path-items/health.yaml'
/config:
$ref: './path-items/config.yaml'
/stats:
$ref: './path-items/stats.yaml'
/deposit:
$ref: './path-items/deposit.yaml'
/deposit/redeem-cashu:
$ref: './path-items/deposit-redeem-cashu.yaml'
/auth/login:
$ref: './path-items/auth-login.yaml'
/auth/login-npub:
$ref: './path-items/auth-login-npub.yaml'
/auth/me:
$ref: './path-items/auth-me.yaml'
/claim/quote:
$ref: './path-items/claim-quote.yaml'
/claim/confirm:
$ref: './path-items/claim-confirm.yaml'
/user/refresh-profile:
$ref: './path-items/user-refresh-profile.yaml'
components:
securitySchemes:
$ref: './components/security.yaml'
schemas:
FaucetConfig:
$ref: './components/schemas/faucet.yaml#/FaucetConfig'
Stats:
$ref: './components/schemas/faucet.yaml#/Stats'
DepositInfo:
$ref: './components/schemas/faucet.yaml#/DepositInfo'
QuoteResult:
$ref: './components/schemas/claim.yaml#/QuoteResult'
ConfirmResult:
$ref: './components/schemas/claim.yaml#/ConfirmResult'
UserProfile:
$ref: './components/schemas/user.yaml#/UserProfile'
ApiError:
$ref: './components/schemas/common.yaml#/ApiError'