@nostr-paywall/relay-guard
v0.1.3
Published
이벤트 단위 유료 nostr 릴레이 — 결제 원장(node:sqlite)과 가드. 훅 비의존이라 어느 릴레이 구현에도 얹힌다.
Maintainers
Readme
@nostr-paywall/relay-guard
유료 nostr 릴레이의 결제 원장과 가드. node:sqlite 라 네이티브 의존성 0.
⚠️ Node 22.5+ 필요 (
node:sqlite내장 시점). 24 이상 권장 — 그보다 낮으면--experimental-sqlite플래그가 필요하다. 버전이 낮으면 부팅 시ERR_UNKNOWN_BUILTIN_MODULE: No such built-in module: node:sqlite로 죽는다. pm2/systemd 로 돌린다면 그 데몬이 쓰는 Node 버전을 확인할 것 — 셸에서 바꿔도 데몬이 옛 버전으로 떠 있으면 자식 프로세스도 옛 버전을 물려받는다.
import { PaymentGuard, SqlitePaymentRepository } from '@nostr-paywall/relay-guard';
const guard = new PaymentGuard({ terms, collectors: [collector], repository: new SqlitePaymentRepository(path) });
await guard.init();
const outcome = await guard.check(event, envelope);
// 'free' | 'already-paid' | 'collected' | 'reject'(okMessage 를 그대로 OK 에 실으면 된다)훅 비의존이다 — 특정 릴레이 구현을 import 하지 않으므로 어디에도 얹을 수 있다.
원장이 지키는 것 셋
- 이중사용 — proof secret 하나는 한 이벤트만 산다
- 멱등(유저 보호) — 같은 이벤트를 두 번 보내도 두 번 과금되지 않는다. 클라가 봉투를 잃고 새 proofs 로 재시도해도 잡힌다
- 자산 보관 — 수납한 proofs 는 베어러다. 이 원장이 유일한 사본이라 감사 로그가 아니라 자산 원장이다. 파일을 잃으면 걷은 돈이 증발한다
설계 문서: https://github.com/tajava2006/nostr-paywall
PoC. mainnet 미검증.
