Compare commits
20
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
e5af15087c | ||
|
|
a384b08044 | ||
|
|
ee4e845c89 | ||
|
|
977bb762c7 | ||
|
|
fe909bedcf | ||
|
|
9207bbcb8f | ||
|
|
5cfe2d6f95 | ||
|
|
0d2fef6502 | ||
|
|
e7f844b11f | ||
|
|
4c80c1c5bf | ||
|
|
6a90136b50 | ||
|
|
31bc9a327f | ||
|
|
6045c89ed0 | ||
|
|
a574db0d93 | ||
|
|
d60da11603 | ||
|
|
22e3cfb2be | ||
|
|
4124dc08e6 | ||
|
|
08c566d547 | ||
|
|
97545ad91f | ||
|
|
702b37b319 |
No files matched your search
@@ -30,3 +30,8 @@ ADMIN_TOKEN=
|
|||||||
# Every business/round parameter (bet amount, round duration/cooldown, min
|
# Every business/round parameter (bet amount, round duration/cooldown, min
|
||||||
# amount, fee rate, RBF timeout, fee address) is configured live from the
|
# amount, fee rate, RBF timeout, fee address) is configured live from the
|
||||||
# admin panel (/admin) instead of here — see docs/guida-admin.md.
|
# admin panel (/admin) instead of here — see docs/guida-admin.md.
|
||||||
|
|
||||||
|
# Swagger/ReDoc/the raw OpenAPI JSON expose the entire API surface — admin
|
||||||
|
# endpoints included — to anyone who requests them. Off by default; set to
|
||||||
|
# true only for local development, never in production.
|
||||||
|
ENABLE_API_DOCS=false
|
||||||
@@ -1,170 +0,0 @@
|
|||||||
# Known bugs
|
|
||||||
|
|
||||||
A second full-codebase audit on 2026-07-27 found **25 further issues** (4 critical, 6 high,
|
|
||||||
7 medium, 8 low), listed below as B-33 … B-49. B-25 through B-37 are fixed (see "Previously
|
|
||||||
fixed" below) — no Critical-severity finding remains open; the other 12 are High/Medium/Low.
|
|
||||||
The 139-test suite was green at the time of the audit, so none of these were caught by existing
|
|
||||||
coverage — every fix lands with a regression test (the thirteen fixes so far brought the suite
|
|
||||||
from 139 to 201).
|
|
||||||
|
|
||||||
The recurring pattern across the open findings is worth stating once: the code is rigorous
|
|
||||||
about the failure modes that have actually been hit, and silent about the ones that have not.
|
|
||||||
The payout phase is now fully recoverable; the "drawing" phase (waiting on a block) is now
|
|
||||||
observable (B-36) but still has no equivalent resume-after-restart — see "Known gaps / TODO"
|
|
||||||
in [CLAUDE.md](CLAUDE.md), which is also where other by-design limitations (single-shared-token
|
|
||||||
admin auth, single-process assumptions, no user-facing history, etc.) are documented.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Medium
|
|
||||||
|
|
||||||
### B-38 — The 500-subscriber SSE cap is a zero-cost DoS of the realtime feature
|
|
||||||
|
|
||||||
`GET /rounds/stream` requires no authentication and each connection takes a slot on a
|
|
||||||
**global** counter (`rounds/events.py:33-38`). Anyone opening 500 connections degrades every
|
|
||||||
real user to polling. The comment describes it as a defensive cap; it is in fact the vector,
|
|
||||||
not the defence.
|
|
||||||
|
|
||||||
**Proposed fix.** Cap per client IP (and, once available, per authenticated user) rather than
|
|
||||||
globally, and evict the oldest idle subscriber instead of refusing new ones. The reverse proxy
|
|
||||||
is the right place for the connection-count limit — Caddy can enforce it before the request
|
|
||||||
reaches the app.
|
|
||||||
|
|
||||||
### B-39 — SQLite with no WAL, no `busy_timeout`, and five concurrent writer tasks
|
|
||||||
|
|
||||||
`db/base.py:6` calls `create_async_engine(settings.database_url)` with no `connect_args`, and
|
|
||||||
there is no `PRAGMA` anywhere in the repo (verified by grep). Without `journal_mode=WAL`
|
|
||||||
readers block writers, and the concurrent writers are five background tasks plus every HTTP
|
|
||||||
handler. `database is locked` under load is realistic, and nothing handles it.
|
|
||||||
|
|
||||||
**Proposed fix.** Set `journal_mode=WAL`, `synchronous=NORMAL` and a `busy_timeout` of a few
|
|
||||||
seconds on connect (a `connect` event listener on the engine, applied only for the SQLite
|
|
||||||
dialect), and retry `OperationalError: database is locked` in the background loops. Longer
|
|
||||||
term this is an argument for PostgreSQL, which the single-process constraints in CLAUDE.md
|
|
||||||
also point at.
|
|
||||||
|
|
||||||
### B-40 — `bump_fee` holds a DB session open across N network calls
|
|
||||||
|
|
||||||
`tx/broadcast.py:80` issues one `get_transaction` **per input** (up to 15s each) and then a
|
|
||||||
`broadcast`, all with the session open. This is precisely the pattern B-18 removed from
|
|
||||||
`_trigger_payout` via its three-phase structure; it survives here.
|
|
||||||
|
|
||||||
Side note in the same function: `_prevout_amount` does `round(value_coins * 100_000_000)` on a
|
|
||||||
float from the server — acceptable at these magnitudes, but it is floating-point money
|
|
||||||
arithmetic in a codebase that is otherwise strictly integer-satoshi.
|
|
||||||
|
|
||||||
**Proposed fix.** Restructure into the same three phases: read what is needed and close the
|
|
||||||
session, do the chain work, then reopen to persist. For the float: prefer the raw (non-verbose)
|
|
||||||
transaction and parse the output value as an integer with `embit`, which is what
|
|
||||||
`reconcile.py:_release_inputs` already does for inputs.
|
|
||||||
|
|
||||||
### B-41 — All confirmation logic depends on `verbose=True`, which is not universally supported
|
|
||||||
|
|
||||||
`poll_once`, `reconcile._tx_exists_on_chain` and `bump_fee` all call
|
|
||||||
`blockchain.transaction.get(txid, True)`. Several Electrum server implementations and versions
|
|
||||||
reject the verbose flag ("verbose transactions are currently unsupported"). Falling back onto
|
|
||||||
such a server means **no confirmations, no reconciliation, no bumps** — and the code would read
|
|
||||||
that as a transport error and stay silent.
|
|
||||||
|
|
||||||
Related: `reconcile.py:83` decides whether to **abandon a transaction** by substring-matching
|
|
||||||
the error text (`"missing"`, `"not found"`, `"no such"`, `"unknown"`). It works against
|
|
||||||
ElectrumX; it is fragile as the basis for a decision that releases funds.
|
|
||||||
|
|
||||||
**Proposed fix.** Use `blockchain.transaction.get_merkle` (or the scripthash history) for
|
|
||||||
confirmation and existence checks — both are portable and give the confirming height directly.
|
|
||||||
Probe verbose support once at connect time and record it on the client, so an unsupported
|
|
||||||
server is detected loudly at session start rather than silently mid-operation.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Low / hygiene
|
|
||||||
|
|
||||||
### B-42 — `/docs` exposed in production
|
|
||||||
|
|
||||||
FastAPI mounts Swagger by default, so the entire API surface — `/admin` included — is publicly
|
|
||||||
enumerable. The README advertises it.
|
|
||||||
**Fix:** `docs_url=None, redoc_url=None, openapi_url=None` in production (env-gated), or place
|
|
||||||
them behind `require_admin`.
|
|
||||||
|
|
||||||
### B-43 — No HTTP security headers
|
|
||||||
|
|
||||||
The [Caddyfile](Caddyfile) sets no CSP, no `X-Frame-Options`/`frame-ancestors`, and no HSTS
|
|
||||||
(Caddy does not add it on its own). The JWT lives in `localStorage`, so any XSS exfiltrates
|
|
||||||
it, and the page is iframeable.
|
|
||||||
**Fix:** a `header` block in the Caddyfile with `Strict-Transport-Security`,
|
|
||||||
`X-Content-Type-Options: nosniff`, `Referrer-Policy` and a CSP tight enough for two static
|
|
||||||
pages with no external assets (`default-src 'self'`).
|
|
||||||
|
|
||||||
### B-44 — README and CLAUDE.md contradict each other
|
|
||||||
|
|
||||||
The README says to run `uvicorn --reload` directly and
|
|
||||||
`docker compose run --rm app python scripts/generate_master_key.py`; CLAUDE.md says explicitly
|
|
||||||
that neither is supported. Whoever opens the repo reads the README first.
|
|
||||||
**Fix:** align the README's Quick start with the Docker-only workflow documented in
|
|
||||||
CLAUDE.md and `docs/setup.md`.
|
|
||||||
|
|
||||||
### B-45 — Unvalidated and unpaginated admin list endpoints
|
|
||||||
|
|
||||||
`limit: int = 50` on `/admin/rounds` and `/admin/audit-log` has no bounds (`-1` means
|
|
||||||
"everything" on SQLite), and `/admin/pending-transactions` has no limit at all — it grows
|
|
||||||
without end.
|
|
||||||
**Fix:** `Query(default=50, ge=1, le=500)` on both, and the same treatment plus a status filter
|
|
||||||
on the pending-transaction list.
|
|
||||||
|
|
||||||
### B-46 — `secrets.compare_digest` on a `str` raises on non-ASCII input
|
|
||||||
|
|
||||||
`api/routes/admin.py:27` raises `TypeError` — a 500 instead of a 403 — when the header contains
|
|
||||||
non-ASCII characters.
|
|
||||||
**Fix:** compare the UTF-8 encoded bytes of both sides.
|
|
||||||
|
|
||||||
### B-47 — Unbounded `String` columns for large text
|
|
||||||
|
|
||||||
`raw_tx_hex` (`db/models.py:146`) and `payload_json` (`:178`) should be `Text`. It works on
|
|
||||||
SQLite and PostgreSQL and breaks elsewhere.
|
|
||||||
**Fix:** switch both to `Text` in a migration.
|
|
||||||
|
|
||||||
### B-48 — No cap on input count in `select_utxos`
|
|
||||||
|
|
||||||
A user with hundreds of small UTXOs builds a huge transaction whose fee — deducted from the bet
|
|
||||||
amount — materially erodes their contribution to the pool, and it can exceed standardness
|
|
||||||
limits.
|
|
||||||
**Fix:** cap the selected inputs (e.g. 50) and fail with a translatable error suggesting a
|
|
||||||
consolidation, or consolidate the address automatically when the count crosses a threshold.
|
|
||||||
|
|
||||||
### B-49 — Rollback paths do not publish an SSE update
|
|
||||||
|
|
||||||
`bets/service.py:_release_failed_bet` and `withdrawals/service.py:_release_failed_withdrawal`
|
|
||||||
restore the balance without calling `broadcaster.publish()`, so dashboards only find out on
|
|
||||||
their next poll.
|
|
||||||
**Fix:** one `broadcaster.publish()` at the end of each, as every other state-changing path
|
|
||||||
already does.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Previously fixed
|
|
||||||
|
|
||||||
- **B-25** — the payout had no two-phase write, unlike bets and withdrawals
|
|
||||||
- **B-26** — a payout failure or a process restart could wedge a round in `paying_out` forever
|
|
||||||
- **B-27** — an RBF bump reset the reconciler's own abandon clock, so a repeatedly-bumped tx was never abandoned
|
|
||||||
- **B-28** — a hostile Electrum server (or a MITM) could single-handedly pick the round's winner
|
|
||||||
- **B-29** — a UTXO absent from one server's `listunspent` was marked spent immediately, irreversibly, on a single unauthenticated reply
|
|
||||||
- **B-30** — a lost scripthash subscription meant a user's deposits were never credited, with no periodic safety net
|
|
||||||
- **B-31** — resubscribing on reconnect ran serially before anything else started, freezing the chain tip (and so an in-flight draw) for the whole sweep
|
|
||||||
- **B-32** — an RBF bump could retry forever below BIP125's relay-mandated minimum fee delta, with no ceiling on the fee rate either
|
|
||||||
- **B-33** — `POST /auth/login` had no rate limiting, so a password could be brute-forced against an enumerable username list
|
|
||||||
- **B-34** — password change/reset didn't invalidate already-issued JWTs, so a stolen token survived a change meant to lock it out
|
|
||||||
- **B-35** — API timestamps round-tripped as naive datetimes, so the frontend parsed them as local time instead of UTC
|
|
||||||
- **B-36** — a stalled draw wait had no timeout, no log, and no audit trail, so a frozen round showed nothing in `/admin`
|
|
||||||
- **B-37** — a withdrawal covered by unconfirmed change answered "insufficient balance" instead of distinguishing it from actually having no funds
|
|
||||||
|
|
||||||
See git history for the fix-by-fix breakdown (commits `f13f685`, `50a43ae`, `933760e`, and the
|
|
||||||
B-28/B-29/B-30/B-31/B-32/B-33/B-34/B-35/B-36/B-37 fixes). Suite grew from 139 to 201 tests over the thirteen.
|
|
||||||
|
|
||||||
A full-codebase audit on 2026-07-26 (commit `d4e0974`) found 24 bugs across every Python
|
|
||||||
module under `app/`, both static frontends, and the Docker/Caddy deployment — 5 critical,
|
|
||||||
7 high, 7 medium, 5 low. All 24 were fixed and verified against the current code on
|
|
||||||
2026-07-27; the fixes are covered by the regression suite (grew from 79 to 139 tests) and
|
|
||||||
five of them were additionally confirmed against a real mainnet deployment (see git history
|
|
||||||
between `fb734bb` (documenting the findings) and `845ba98` (recording the audit outcome) for
|
|
||||||
the fix-by-fix breakdown — each commit message names the bugs it closes and where their
|
|
||||||
tests live).
|
|
||||||
@@ -8,15 +8,15 @@ The user communicates in Italian in chat — reply to them in Italian. Everythin
|
|||||||
|
|
||||||
## Project status
|
## Project status
|
||||||
|
|
||||||
All 10 stages of the original build order are code-complete and unit-tested — 185 tests, all under `tests/unit/` (`tests/integration/` is an empty package). Beyond them: Docker + Caddy deployment, admin dashboard (`/admin`), static test UI (`/`), pending-inclusive balance display, an SSE push channel layered over the original polling, self-service password change + admin password reset, and the reconciliation/corroboration machinery below.
|
All 10 stages of the original build order are code-complete and unit-tested — 253 tests, all under `tests/unit/` (`tests/integration/` is an empty package). Beyond them: Docker + Caddy deployment, admin dashboard (`/admin`), static test UI (`/`), pending-inclusive balance display, an SSE push channel layered over the original polling, self-service password change + admin password reset, and the reconciliation/corroboration machinery below.
|
||||||
|
|
||||||
Verified on mainnet with real money: registration + address derivation, deposit crediting (1-conf), a real 10 PLM bet (broadcast → confirmed → change credited back), and one full round cycle (close → draw on a real block hash → 70/30 payout with sat math checked against the broadcast tx → confirmation → close → next round auto-opened). **Withdrawal and the RBF bump path have never been exercised against a live broadcast** — unit-tested only.
|
Verified on mainnet with real money: registration + address derivation, deposit crediting (1-conf), a real 10 PLM bet (broadcast → confirmed → change credited back), and one full round cycle (close → draw on a real block hash → 70/30 payout with sat math checked against the broadcast tx → confirmation → close → next round auto-opened). **Withdrawal and the RBF bump path have never been exercised against a live broadcast** — unit-tested only.
|
||||||
|
|
||||||
**Read [BUGS.md](BUGS.md) before trusting any behaviour here.** Two audits: 2026-07-26 found 24 bugs (5 critical), all fixed; 2026-07-27 found 25 more (B-25 … B-49), of which **12 are still open** — no Critical or High remains, only Medium/Low: no WAL/`busy_timeout` under five concurrent SQLite writer tasks (B-39), a 500-subscriber SSE cap that doubles as a cheap DoS of the realtime feature (B-38), among others. BUGS.md is the live open list with a proposed fix per finding; "Known gaps" at the end of this file is for limitations accepted **by design** instead. Don't fix a BUGS.md item silently as a side effect of other work — each fix lands with its own regression test.
|
Two full-codebase audits — 2026-07-26 (24 findings, 5 critical) and 2026-07-27 (25 more, B-25 … B-49) — are **all fixed** as of 2026-07-27, each with its own regression test. They were tracked in a `BUGS.md` that was deleted once the list emptied, so the ~276 `B-nn` markers left in comments across the code are pointers into git history (`git log --all --grep 'B-nn'` finds the commit that fixed one, and `git show f1a1145:BUGS.md`-style the file as it stood). A closed list is not the same as no bugs: the suite is unit-only (`tests/integration/` is empty), and withdrawal and the RBF bump have never been live-broadcast. "Known gaps" at the end of this file is for limitations accepted **by design** instead. A new finding gets the next B-nn, in its own commit with its own regression test.
|
||||||
|
|
||||||
Before writing code, read the "Architecture" section below in full plus the diagrams in [flowchart/](flowchart/): [platform-overview.mmd](flowchart/platform-overview.mmd) (the 5-phase flow) and [round-lifecycle.mmd](flowchart/round-lifecycle.mmd) (the round/draw lifecycle). Every node **and edge label** (conditions, retries, loops) is a behaviour that must be implemented as described. Regenerate the companion PDFs with `flowchart/render-pdf.sh <file>.mmd` after editing either.
|
Before writing code, read the "Architecture" section below in full plus the diagrams in [flowchart/](flowchart/): [platform-overview.mmd](flowchart/platform-overview.mmd) (the 5-phase flow) and [round-lifecycle.mmd](flowchart/round-lifecycle.mmd) (the round/draw lifecycle). Every node **and edge label** (conditions, retries, loops) is a behaviour that must be implemented as described. Regenerate the companion PDFs with `flowchart/render-pdf.sh <file>.mmd` after editing either.
|
||||||
|
|
||||||
Human-facing guides are in [docs/](docs/), in Italian by explicit request (an exception to the English-only rule): [setup.md](docs/setup.md), [running-the-server.md](docs/running-the-server.md), [guida-utente.md](docs/guida-utente.md), [guida-admin.md](docs/guida-admin.md). **[README.md](README.md)'s Quick start is stale** (bare `uvicorn --reload`, `docker compose run … generate_master_key.py` — neither is supported; B-44); this file and `docs/setup.md` are authoritative.
|
Human-facing guides are in [docs/](docs/), in Italian by explicit request (an exception to the English-only rule): [setup.md](docs/setup.md), [running-the-server.md](docs/running-the-server.md), [guida-utente.md](docs/guida-utente.md), [guida-admin.md](docs/guida-admin.md). README's Quick start and `docs/running-the-server.md` are Docker-only, matching this file — a bare `uvicorn --reload` workflow was removed from both (B-44).
|
||||||
|
|
||||||
## Commands
|
## Commands
|
||||||
|
|
||||||
@@ -33,7 +33,7 @@ PYTHONPATH=. python scripts/decrypt_master_key.py # ops recovery: decrypt+pr
|
|||||||
PYTHONPATH=. python scripts/encrypt_master_key.py # ops bootstrap: import an externally-generated xprv (--overwrite to replace)
|
PYTHONPATH=. python scripts/encrypt_master_key.py # ops bootstrap: import an externally-generated xprv (--overwrite to replace)
|
||||||
PYTHONPATH=. python scripts/electrum_smoke_test.py # manual check: connect, handshake, subscribe to headers, print the tip
|
PYTHONPATH=. python scripts/electrum_smoke_test.py # manual check: connect, handshake, subscribe to headers, print the tip
|
||||||
|
|
||||||
python -m pytest # all 185 tests
|
python -m pytest # all 253 tests
|
||||||
python -m pytest tests/unit/test_hd.py # one file
|
python -m pytest tests/unit/test_hd.py # one file
|
||||||
python -m pytest tests/unit/test_hd.py::test_derivation_is_deterministic # one test
|
python -m pytest tests/unit/test_hd.py::test_derivation_is_deterministic # one test
|
||||||
```
|
```
|
||||||
@@ -55,7 +55,7 @@ docker compose down
|
|||||||
|
|
||||||
`SITE_ADDRESS` unset → `localhost`, Caddy issues a self-signed cert from its internal CA (browser warning on first visit is expected; `curl -k`). `SITE_ADDRESS=lottery.example.com docker compose up -d` → real Let's Encrypt cert, automatically renewed (needs DNS pointing here and ports 80+443 reachable).
|
`SITE_ADDRESS` unset → `localhost`, Caddy issues a self-signed cert from its internal CA (browser warning on first visit is expected; `curl -k`). `SITE_ADDRESS=lottery.example.com docker compose up -d` → real Let's Encrypt cert, automatically renewed (needs DNS pointing here and ports 80+443 reachable).
|
||||||
|
|
||||||
The `Caddyfile` sets **no** security headers — no CSP, HSTS or `X-Frame-Options` (B-43). `restart: unless-stopped` on `app` means a mid-round crash auto-restarts: `closing` and `paying_out` resume on their own, `drawing` does not (see Known gaps).
|
The `Caddyfile` sends baseline security headers — HSTS, `X-Content-Type-Options: nosniff`, `X-Frame-Options: DENY`, `Referrer-Policy`, and a CSP scoped to `default-src 'self'` plus the Google Fonts `@import` in `style.css`/`admin.css`. `script-src`/`style-src` need `'unsafe-inline'` because both SPAs use inline `onclick` handlers and `style=""` attributes throughout — removing those is a separate, larger refactor, not a header change. `restart: unless-stopped` on `app` means a mid-round crash auto-restarts: `closing` and `paying_out` resume on their own, `drawing` does not (see Known gaps).
|
||||||
|
|
||||||
## Tech stack
|
## Tech stack
|
||||||
|
|
||||||
@@ -91,6 +91,7 @@ Source of truth: the `PalladiumWallet` repo — [ChainProfiles.cs](../PalladiumW
|
|||||||
| Min deposit | none | — |
|
| Min deposit | none | — |
|
||||||
| Min password length | 8 | `auth/security.py:MIN_PASSWORD_LENGTH` |
|
| Min password length | 8 | `auth/security.py:MIN_PASSWORD_LENGTH` |
|
||||||
| Confirmations, every tx kind | **1** | hardcoded in `tx/confirmation.py` |
|
| Confirmations, every tx kind | **1** | hardcoded in `tx/confirmation.py` |
|
||||||
|
| Max inputs per tx | 50 (`MAX_TX_INPUTS`, B-48) — over it the build fails with `too_many_inputs`, it never spends more | hardcoded in `wallet/psbt_builder.py` |
|
||||||
|
|
||||||
`GET /rounds/current`'s `jackpot_sats` is the winner's 70% share, not the whole pool, and the pool is summed from the participants' actual `bet_amount_sats` (each already net of its own bet fee) rather than `count × current bet amount` — editing the bet amount mid-round must not move an in-progress round's advertised jackpot (B-11).
|
`GET /rounds/current`'s `jackpot_sats` is the winner's 70% share, not the whole pool, and the pool is summed from the participants' actual `bet_amount_sats` (each already net of its own bet fee) rather than `count × current bet amount` — editing the bet amount mid-round must not move an in-progress round's advertised jackpot (B-11).
|
||||||
|
|
||||||
@@ -180,7 +181,7 @@ At 120s blocks that's ~4–6 min worst case (last bet confirms right at the dead
|
|||||||
|
|
||||||
`GET /rounds/stream` is **additive to** the polling loops in the two SPAs, not a replacement — a blocked or dropped stream just degrades to the old behaviour. No payload, no auth: it's a "something changed, go refetch" ping, with all personalization (e.g. `user_played`) staying in the authenticated REST endpoints. The generator re-checks `request.is_disconnected()` every 5s and sends a keep-alive comment every 20s, so neither a client that vanished without a clean close nor a proxy idle timeout breaks it silently.
|
`GET /rounds/stream` is **additive to** the polling loops in the two SPAs, not a replacement — a blocked or dropped stream just degrades to the old behaviour. No payload, no auth: it's a "something changed, go refetch" ping, with all personalization (e.g. `user_played`) staying in the authenticated REST endpoints. The generator re-checks `request.is_disconnected()` every 5s and sends a keep-alive comment every 20s, so neither a client that vanished without a clean close nor a proxy idle timeout breaks it silently.
|
||||||
|
|
||||||
`rounds/events.py`'s `RoundEventBroadcaster` (singleton `broadcaster`) is in-process pub/sub, one `asyncio.Queue(maxsize=1)` per client so redundant notifications coalesce. `publish()` is called on: a round opening (`rounds/service.py`), every status transition (`scheduler.py`), a bet or withdrawal broadcast, any pending tx confirming (`tx/confirmation.py`), a deposit credited (`deposits/service.py`), and a new tip arriving (`electrum/listener.py` — exactly what the drawing phase waits on). Rollback paths are the known exception (B-49).
|
`rounds/events.py`'s `RoundEventBroadcaster` (singleton `broadcaster`) is in-process pub/sub, one `asyncio.Queue(maxsize=1)` per client so redundant notifications coalesce. `publish()` is called on: a round opening (`rounds/service.py`), every status transition (`scheduler.py`), a bet or withdrawal broadcast, any pending tx confirming (`tx/confirmation.py`), a deposit credited (`deposits/service.py`), and a new tip arriving (`electrum/listener.py` — exactly what the drawing phase waits on). The rollback paths (`_release_failed_bet`, `_release_failed_withdrawal`, the reconciler's abandon) publish too — a rollback moves as much state as the success path, so it must ping the dashboards the same way (B-49).
|
||||||
|
|
||||||
Deliberate scope limits, not oversights: **single-process only** (fine for one uvicorn process; a multi-worker deployment needs e.g. Redis pub/sub — don't add it speculatively); **generic broadcast, not per-user** (everyone refetches on every event; acceptable at ~100 concurrent users, and a targeted channel would need auth on the stream plus server-side knowledge of who each event affects); `MAX_SUBSCRIBERS` (500) is defensive only — past it the endpoint returns 503 and `EventSource` falls back to polling, which being global and unauthenticated makes the cap itself a cheap DoS of the realtime feature (B-38).
|
Deliberate scope limits, not oversights: **single-process only** (fine for one uvicorn process; a multi-worker deployment needs e.g. Redis pub/sub — don't add it speculatively); **generic broadcast, not per-user** (everyone refetches on every event; acceptable at ~100 concurrent users, and a targeted channel would need auth on the stream plus server-side knowledge of who each event affects); `MAX_SUBSCRIBERS` (500) is defensive only — past it the endpoint returns 503 and `EventSource` falls back to polling, which being global and unauthenticated makes the cap itself a cheap DoS of the realtime feature (B-38).
|
||||||
|
|
||||||
@@ -209,12 +210,13 @@ Two static SPAs served directly by FastAPI (`main.py` mounts `app/static/` and a
|
|||||||
|
|
||||||
Both talk to the same JSON API; there's no admin/user API split beyond `require_admin`.
|
Both talk to the same JSON API; there's no admin/user API split beyond `require_admin`.
|
||||||
|
|
||||||
## Internationalization (`/` only)
|
## Internationalization (`/` and `/report-bug`)
|
||||||
|
|
||||||
`app/static/i18n.js` holds every user-facing string of `/` in 7 languages (en, it, es, fr, de, ru, zh) as one flat `TRANSLATIONS` table — no build step, no fetch, loaded before `app.js` so `t()` is always available. Language: `localStorage.plm_lang` → `navigator.language` → `en`. The switcher sits in the **chain-bar, not the navbar**, deliberately: the navbar is hidden until login, which would leave the landing page and login form untranslatable for exactly the users who need it.
|
`app/static/i18n.js` holds every user-facing string of `/` and `/report-bug` in 7 languages (en, it, es, fr, de, ru, zh) as one flat `TRANSLATIONS` table — no build step, no fetch. `/` loads it before `app.js`; `/report-bug` loads it before its own inline script — either way `t()` is always available by the time it's called. Language: `localStorage.plm_lang` → `navigator.language` → `en`, shared across both pages since they read/write the same `localStorage` key. On `/` the switcher sits in the **chain-bar, not the navbar**, deliberately: the navbar is hidden until login, which would leave the landing page and login form untranslatable for exactly the users who need it. `/report-bug` has no navbar at all, so its switcher is just a top-right bar of its own.
|
||||||
|
|
||||||
- Static markup is translated by attribute (`data-i18n`, plus `-html`, `-placeholder`, `-title`, `-aria-label`, `-alt`) via `applyStaticTranslations(root?)`; anything rendered from server data uses `t()` in `app.js` and is re-rendered by `onLanguageChange()`. An element belongs to one camp or the other, **never both**, or the two mechanisms overwrite each other — that's why `#bet-btn` has no `data-i18n`: its label carries the configurable bet amount, so `renderBetButton()` owns it.
|
- Static markup is translated by attribute (`data-i18n`, plus `-html`, `-placeholder`, `-title`, `-aria-label`, `-alt`) via `applyStaticTranslations(root?)`; anything rendered from server data uses `t()` directly (`app.js`'s `onLanguageChange()`, `report-bug.html`'s own inline equivalent) and is re-rendered on a language switch. An element belongs to one camp or the other, **never both**, or the two mechanisms overwrite each other — that's why `#bet-btn` has no `data-i18n`: its label carries the configurable bet amount, so `renderBetButton()` owns it.
|
||||||
- **Every language must have exactly the same key set.** There is no fallback beyond `en`; a missing key renders as the raw key string.
|
- **Every language must have exactly the same key set.** There is no fallback beyond `en`; a missing key renders as the raw key string.
|
||||||
|
- `/report-bug`'s `bugReport.englishNotice` string is itself translated into all 7 languages — it just always *says*, in whichever language the visitor reads, to write the actual bug description in English (so the admin panel, which is Italian-operator-facing and untranslated, doesn't end up with reports in 7 different languages).
|
||||||
- `/admin` is intentionally untranslated (operator-facing, Italian), as is `/guida`.
|
- `/admin` is intentionally untranslated (operator-facing, Italian), as is `/guida`.
|
||||||
|
|
||||||
**API error contract** (`app/api/errors.py`) — the API is single-language by design. Failures answer with a structured `detail`: `{"code", "message", "params"}`, where `message` is English for non-dashboard consumers and `code` is what the frontend maps to `error.<code>` in `i18n.js` (falling back to `message` for an unknown code). `BetError`/`WithdrawalError` subclass `ApiError` and carry the code from where the failure happens. Even the catch-all 500 handler answers in that shape (`internal_error`), so clients never special-case unexpected errors, and the exception text stays in `logs/app.log`. Adding a user-facing error: give it a code, add `error.<code>` to all 7 languages, and pass values through `params` (amounts as `*_sats` — the frontend derives a `*_plm` sibling) instead of baking them into English text.
|
**API error contract** (`app/api/errors.py`) — the API is single-language by design. Failures answer with a structured `detail`: `{"code", "message", "params"}`, where `message` is English for non-dashboard consumers and `code` is what the frontend maps to `error.<code>` in `i18n.js` (falling back to `message` for an unknown code). `BetError`/`WithdrawalError` subclass `ApiError` and carry the code from where the failure happens. Even the catch-all 500 handler answers in that shape (`internal_error`), so clients never special-case unexpected errors, and the exception text stays in `logs/app.log`. Adding a user-facing error: give it a code, add `error.<code>` to all 7 languages, and pass values through `params` (amounts as `*_sats` — the frontend derives a `*_plm` sibling) instead of baking them into English text.
|
||||||
@@ -233,7 +235,7 @@ Explicit design choices, not derivable from any single file — respect them:
|
|||||||
|
|
||||||
## Known gaps / TODO
|
## Known gaps / TODO
|
||||||
|
|
||||||
Accepted **by design**. For actual bugs see [BUGS.md](BUGS.md) (18 open) — not duplicated here.
|
Accepted **by design** — distinct from the audit findings above (all fixed), which are not duplicated here.
|
||||||
|
|
||||||
- **`drawing` doesn't resume after a restart.** `_tick()` handles `open`, `closing` and `paying_out` (the last via `_retry_payout_if_due`); nothing re-enters `_wait_for_next_block` after a crash. That wait is unbounded by design (the draw's entropy genuinely depends on a future block) but no longer silent — past `_DRAW_STALL_THRESHOLD_SECONDS` it logs progress and writes a `draw_stalled` audit entry, and `GET /rounds/current`'s `draw_waiting_since` surfaces it live (B-36). Restart-resumption itself remains the last prerequisite for running unattended.
|
- **`drawing` doesn't resume after a restart.** `_tick()` handles `open`, `closing` and `paying_out` (the last via `_retry_payout_if_due`); nothing re-enters `_wait_for_next_block` after a crash. That wait is unbounded by design (the draw's entropy genuinely depends on a future block) but no longer silent — past `_DRAW_STALL_THRESHOLD_SECONDS` it logs progress and writes a `draw_stalled` audit entry, and `GET /rounds/current`'s `draw_waiting_since` surfaces it live (B-36). Restart-resumption itself remains the last prerequisite for running unattended.
|
||||||
- **RBF handles one shape only**: a single change output, back to the tx's own sender, big enough to absorb the increase. No extra-input fallback — an exact-amount tx or too-small change raises `RbfError`. Not permanent, though: an unbumpable tx that never confirms is eventually abandoned and its UTXOs released.
|
- **RBF handles one shape only**: a single change output, back to the tx's own sender, big enough to absorb the increase. No extra-input fallback — an exact-amount tx or too-small change raises `RbfError`. Not permanent, though: an unbumpable tx that never confirms is eventually abandoned and its UTXOs released.
|
||||||
|
|||||||
@@ -13,5 +13,21 @@
|
|||||||
not path /rounds/stream
|
not path /rounds/stream
|
||||||
}
|
}
|
||||||
encode @not_sse gzip
|
encode @not_sse gzip
|
||||||
|
|
||||||
|
# B-43: Caddy adds none of these on its own. The JWT lives in
|
||||||
|
# localStorage, so any XSS exfiltrates it — CSP is the main mitigation.
|
||||||
|
# script-src/style-src need 'unsafe-inline' because both SPAs
|
||||||
|
# (app/static/index.html, admin.html) use inline onclick handlers and
|
||||||
|
# style="" attributes throughout; removing those is a separate,
|
||||||
|
# larger refactor, not a header change. fonts.googleapis.com/gstatic.com
|
||||||
|
# are the one external asset (the Google Fonts @import in style.css/admin.css).
|
||||||
|
header {
|
||||||
|
Strict-Transport-Security "max-age=31536000; includeSubDomains"
|
||||||
|
X-Content-Type-Options "nosniff"
|
||||||
|
X-Frame-Options "DENY"
|
||||||
|
Referrer-Policy "strict-origin-when-cross-origin"
|
||||||
|
Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; font-src 'self' https://fonts.gstatic.com; img-src 'self'; connect-src 'self'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'; object-src 'none'"
|
||||||
|
}
|
||||||
|
|
||||||
reverse_proxy app:8123
|
reverse_proxy app:8123
|
||||||
}
|
}
|
||||||
@@ -13,31 +13,30 @@ production-ready.
|
|||||||
|
|
||||||
## Quick start
|
## Quick start
|
||||||
|
|
||||||
|
The server always runs via Docker (app + Caddy reverse proxy with automatic
|
||||||
|
TLS) — in dev and production alike, with only `SITE_ADDRESS` differing
|
||||||
|
between the two. There's no supported way to run `uvicorn` directly; the
|
||||||
|
venv is only for local tooling (tests, Alembic migrations, the one-time key
|
||||||
|
scripts) — see [CLAUDE.md](CLAUDE.md#commands).
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cp .env.example .env # then fill in the generated secrets, see docs/setup.md
|
cp .env.example .env # then fill in the generated secrets, see docs/setup.md
|
||||||
python3 -m venv .venv && source .venv/bin/activate
|
|
||||||
pip install -e ".[dev]"
|
|
||||||
PYTHONPATH=. python scripts/generate_master_key.py
|
|
||||||
alembic upgrade head
|
|
||||||
uvicorn app.main:app --reload --port 8123
|
|
||||||
```
|
|
||||||
|
|
||||||
Open `http://127.0.0.1:8123/` for the test UI, `http://127.0.0.1:8123/admin`
|
|
||||||
for the admin dashboard, `http://127.0.0.1:8123/docs` for the interactive API
|
|
||||||
docs.
|
|
||||||
|
|
||||||
Or run the whole stack (app + Caddy reverse proxy with automatic TLS) via
|
|
||||||
Docker:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
mkdir -p data/db data/keys data/logs
|
mkdir -p data/db data/keys data/logs
|
||||||
docker compose run --rm app python scripts/generate_master_key.py
|
docker compose run --rm app python scripts/generate_master_key.py
|
||||||
docker compose up -d --build
|
docker compose up -d --build
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Open `https://localhost/` for the test UI, `https://localhost/admin` for the
|
||||||
|
admin dashboard (a self-signed-certificate warning on first visit is
|
||||||
|
expected in dev — accept it, or use `curl -k`). The interactive API docs at
|
||||||
|
`/docs` are disabled by default (they'd otherwise expose the whole API
|
||||||
|
surface, admin endpoints included) — set `ENABLE_API_DOCS=true` in `.env` to
|
||||||
|
enable them.
|
||||||
|
|
||||||
See [docs/setup.md](docs/setup.md) and
|
See [docs/setup.md](docs/setup.md) and
|
||||||
[docs/running-the-server.md](docs/running-the-server.md) for the full
|
[docs/running-the-server.md](docs/running-the-server.md) for the full
|
||||||
walkthrough (both workflows, dev vs. production TLS).
|
walkthrough (secrets, master key generation, production TLS with a real
|
||||||
|
domain).
|
||||||
|
|
||||||
## Documentation
|
## Documentation
|
||||||
|
|
||||||
@@ -62,7 +61,7 @@ python -m pytest # all tests
|
|||||||
python -m pytest tests/unit/test_hd.py # one file
|
python -m pytest tests/unit/test_hd.py # one file
|
||||||
```
|
```
|
||||||
|
|
||||||
76 unit tests cover HD derivation, PSBT building, the Electrum client, bets,
|
232 unit tests cover HD derivation, PSBT building, the Electrum client, bets,
|
||||||
deposits, withdrawals, the round/draw engine, RBF fee-bumping, admin config,
|
deposits, withdrawals, the round/draw engine, RBF fee-bumping, admin config,
|
||||||
the pending-inclusive balance calculation, and the SSE push channel. No
|
the pending-inclusive balance calculation, and the SSE push channel. No
|
||||||
automated integration tests against a live Electrum connection — mainnet
|
automated integration tests against a live Electrum connection — mainnet
|
||||||
|
|||||||
@@ -0,0 +1,17 @@
|
|||||||
|
from fastapi import Request
|
||||||
|
|
||||||
|
|
||||||
|
def client_ip(request: Request) -> str:
|
||||||
|
"""The caller's real IP, from Caddy's X-Forwarded-For (see Caddyfile) —
|
||||||
|
request.client.host would otherwise be the reverse proxy's own address, not
|
||||||
|
the caller's. Falls back to request.client.host only if the header is
|
||||||
|
somehow missing (e.g. the app container hit directly, bypassing Caddy).
|
||||||
|
|
||||||
|
Shared by the login/registration throttles (B-33) and the SSE per-IP
|
||||||
|
subscriber cap (B-38) so the two can't drift into different notions of
|
||||||
|
"the client's IP".
|
||||||
|
"""
|
||||||
|
forwarded = request.headers.get("x-forwarded-for")
|
||||||
|
if forwarded:
|
||||||
|
return forwarded.split(",")[0].strip()
|
||||||
|
return request.client.host if request.client else "unknown"
|
||||||
+86
-8
@@ -1,7 +1,7 @@
|
|||||||
import json
|
import json
|
||||||
import secrets
|
import secrets
|
||||||
|
|
||||||
from fastapi import APIRouter, Depends, Header, HTTPException, status
|
from fastapi import APIRouter, Depends, Header, HTTPException, Query, status
|
||||||
from pydantic import BaseModel, Field, field_validator
|
from pydantic import BaseModel, Field, field_validator
|
||||||
from sqlalchemy import select
|
from sqlalchemy import select
|
||||||
from sqlalchemy.ext.asyncio import AsyncSession
|
from sqlalchemy.ext.asyncio import AsyncSession
|
||||||
@@ -10,7 +10,7 @@ from app.api.timeutil import isoformat_utc
|
|||||||
from app.audit.log import write_audit_log
|
from app.audit.log import write_audit_log
|
||||||
from app.auth.security import hash_password
|
from app.auth.security import hash_password
|
||||||
from app.config import settings
|
from app.config import settings
|
||||||
from app.db.models import AuditLog, PendingTransaction, Round, User
|
from app.db.models import AuditLog, BugReport, PendingTransaction, Round, User
|
||||||
from app.db.session import get_session
|
from app.db.session import get_session
|
||||||
from app.rounds.config import get_round_config
|
from app.rounds.config import get_round_config
|
||||||
from app.wallet.address import is_valid_plm_address
|
from app.wallet.address import is_valid_plm_address
|
||||||
@@ -26,7 +26,9 @@ async def require_admin(x_admin_token: str = Header(default="")) -> None:
|
|||||||
# anyone on an instance that never configured a token.
|
# anyone on an instance that never configured a token.
|
||||||
if not settings.admin_token:
|
if not settings.admin_token:
|
||||||
raise HTTPException(status.HTTP_403_FORBIDDEN, "invalid admin token")
|
raise HTTPException(status.HTTP_403_FORBIDDEN, "invalid admin token")
|
||||||
if not secrets.compare_digest(x_admin_token, settings.admin_token):
|
# compare_digest raises TypeError on a str containing non-ASCII characters
|
||||||
|
# (B-46) -- comparing the UTF-8 bytes instead accepts any input safely.
|
||||||
|
if not secrets.compare_digest(x_admin_token.encode(), settings.admin_token.encode()):
|
||||||
raise HTTPException(status.HTTP_403_FORBIDDEN, "invalid admin token")
|
raise HTTPException(status.HTTP_403_FORBIDDEN, "invalid admin token")
|
||||||
|
|
||||||
|
|
||||||
@@ -242,7 +244,9 @@ class AdminRoundResponse(BaseModel):
|
|||||||
|
|
||||||
|
|
||||||
@router.get("/rounds", response_model=list[AdminRoundResponse], dependencies=[Depends(require_admin)])
|
@router.get("/rounds", response_model=list[AdminRoundResponse], dependencies=[Depends(require_admin)])
|
||||||
async def list_rounds(session: AsyncSession = Depends(get_session), limit: int = 50) -> list[AdminRoundResponse]:
|
async def list_rounds(
|
||||||
|
session: AsyncSession = Depends(get_session), limit: int = Query(default=50, ge=1, le=500)
|
||||||
|
) -> list[AdminRoundResponse]:
|
||||||
rounds = (await session.scalars(select(Round).order_by(Round.id.desc()).limit(limit))).all()
|
rounds = (await session.scalars(select(Round).order_by(Round.id.desc()).limit(limit))).all()
|
||||||
winner_ids = {r.winner_user_id for r in rounds if r.winner_user_id is not None}
|
winner_ids = {r.winner_user_id for r in rounds if r.winner_user_id is not None}
|
||||||
winners = {}
|
winners = {}
|
||||||
@@ -282,7 +286,7 @@ class AdminAuditLogResponse(BaseModel):
|
|||||||
"/audit-log", response_model=list[AdminAuditLogResponse], dependencies=[Depends(require_admin)]
|
"/audit-log", response_model=list[AdminAuditLogResponse], dependencies=[Depends(require_admin)]
|
||||||
)
|
)
|
||||||
async def list_audit_log(
|
async def list_audit_log(
|
||||||
session: AsyncSession = Depends(get_session), limit: int = 200
|
session: AsyncSession = Depends(get_session), limit: int = Query(default=200, ge=1, le=500)
|
||||||
) -> list[AdminAuditLogResponse]:
|
) -> list[AdminAuditLogResponse]:
|
||||||
entries = (await session.scalars(select(AuditLog).order_by(AuditLog.id.desc()).limit(limit))).all()
|
entries = (await session.scalars(select(AuditLog).order_by(AuditLog.id.desc()).limit(limit))).all()
|
||||||
return [
|
return [
|
||||||
@@ -319,10 +323,13 @@ class AdminPendingTransactionResponse(BaseModel):
|
|||||||
)
|
)
|
||||||
async def list_pending_transactions(
|
async def list_pending_transactions(
|
||||||
session: AsyncSession = Depends(get_session),
|
session: AsyncSession = Depends(get_session),
|
||||||
|
limit: int = Query(default=50, ge=1, le=500),
|
||||||
|
status_filter: str | None = Query(default=None, alias="status"),
|
||||||
) -> list[AdminPendingTransactionResponse]:
|
) -> list[AdminPendingTransactionResponse]:
|
||||||
entries = (
|
query = select(PendingTransaction).order_by(PendingTransaction.id.desc())
|
||||||
await session.scalars(select(PendingTransaction).order_by(PendingTransaction.id.desc()))
|
if status_filter is not None:
|
||||||
).all()
|
query = query.where(PendingTransaction.status == status_filter)
|
||||||
|
entries = (await session.scalars(query.limit(limit))).all()
|
||||||
return [
|
return [
|
||||||
AdminPendingTransactionResponse(
|
AdminPendingTransactionResponse(
|
||||||
id=p.id,
|
id=p.id,
|
||||||
@@ -339,3 +346,74 @@ async def list_pending_transactions(
|
|||||||
)
|
)
|
||||||
for p in entries
|
for p in entries
|
||||||
]
|
]
|
||||||
|
|
||||||
|
|
||||||
|
_BUG_REPORT_STATUSES = ("open", "read", "resolved")
|
||||||
|
|
||||||
|
|
||||||
|
class AdminBugReportResponse(BaseModel):
|
||||||
|
id: int
|
||||||
|
description: str
|
||||||
|
contact: str | None
|
||||||
|
user_id: int | None
|
||||||
|
username: str | None
|
||||||
|
status: str
|
||||||
|
created_at: str
|
||||||
|
|
||||||
|
|
||||||
|
def _bug_report_response(report: BugReport, username: str | None) -> AdminBugReportResponse:
|
||||||
|
return AdminBugReportResponse(
|
||||||
|
id=report.id,
|
||||||
|
description=report.description,
|
||||||
|
contact=report.contact,
|
||||||
|
user_id=report.user_id,
|
||||||
|
username=username,
|
||||||
|
status=report.status,
|
||||||
|
created_at=isoformat_utc(report.created_at),
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
@router.get(
|
||||||
|
"/bug-reports", response_model=list[AdminBugReportResponse], dependencies=[Depends(require_admin)]
|
||||||
|
)
|
||||||
|
async def list_bug_reports(
|
||||||
|
session: AsyncSession = Depends(get_session), limit: int = Query(default=200, ge=1, le=500)
|
||||||
|
) -> list[AdminBugReportResponse]:
|
||||||
|
reports = (await session.scalars(select(BugReport).order_by(BugReport.id.desc()).limit(limit))).all()
|
||||||
|
user_ids = {r.user_id for r in reports if r.user_id is not None}
|
||||||
|
usernames = {}
|
||||||
|
if user_ids:
|
||||||
|
users = (await session.scalars(select(User).where(User.id.in_(user_ids)))).all()
|
||||||
|
usernames = {u.id: u.username for u in users}
|
||||||
|
|
||||||
|
return [
|
||||||
|
_bug_report_response(r, usernames.get(r.user_id) if r.user_id is not None else None)
|
||||||
|
for r in reports
|
||||||
|
]
|
||||||
|
|
||||||
|
|
||||||
|
class BugReportStatusUpdate(BaseModel):
|
||||||
|
status: str = Field(pattern="^(open|read|resolved)$")
|
||||||
|
|
||||||
|
|
||||||
|
@router.post(
|
||||||
|
"/bug-reports/{report_id}/status",
|
||||||
|
response_model=AdminBugReportResponse,
|
||||||
|
dependencies=[Depends(require_admin)],
|
||||||
|
)
|
||||||
|
async def update_bug_report_status(
|
||||||
|
report_id: int, body: BugReportStatusUpdate, session: AsyncSession = Depends(get_session)
|
||||||
|
) -> AdminBugReportResponse:
|
||||||
|
report = await session.get(BugReport, report_id)
|
||||||
|
if report is None:
|
||||||
|
raise HTTPException(status.HTTP_404_NOT_FOUND, "bug report not found")
|
||||||
|
|
||||||
|
report.status = body.status
|
||||||
|
await session.commit()
|
||||||
|
|
||||||
|
username = None
|
||||||
|
if report.user_id is not None:
|
||||||
|
user = await session.get(User, report.user_id)
|
||||||
|
username = user.username if user is not None else None
|
||||||
|
|
||||||
|
return _bug_report_response(report, username)
|
||||||
@@ -0,0 +1,79 @@
|
|||||||
|
from fastapi import APIRouter, Depends, status
|
||||||
|
from pydantic import BaseModel, Field, field_validator
|
||||||
|
from sqlalchemy import select
|
||||||
|
from sqlalchemy.ext.asyncio import AsyncSession
|
||||||
|
|
||||||
|
from app.api.timeutil import isoformat_utc
|
||||||
|
from app.auth.dependencies import get_current_user, get_optional_user
|
||||||
|
from app.db.models import BugReport, User
|
||||||
|
from app.db.session import get_session
|
||||||
|
|
||||||
|
router = APIRouter(prefix="/bug-reports", tags=["bug-reports"])
|
||||||
|
|
||||||
|
|
||||||
|
class BugReportCreate(BaseModel):
|
||||||
|
description: str = Field(min_length=1, max_length=2000)
|
||||||
|
contact: str | None = Field(default=None, max_length=256)
|
||||||
|
|
||||||
|
@field_validator("description")
|
||||||
|
@classmethod
|
||||||
|
def _description_not_blank(cls, value: str) -> str:
|
||||||
|
value = value.strip()
|
||||||
|
if not value:
|
||||||
|
raise ValueError("description must not be blank")
|
||||||
|
return value
|
||||||
|
|
||||||
|
@field_validator("contact")
|
||||||
|
@classmethod
|
||||||
|
def _contact_stripped(cls, value: str | None) -> str | None:
|
||||||
|
if value is None:
|
||||||
|
return None
|
||||||
|
value = value.strip()
|
||||||
|
return value or None
|
||||||
|
|
||||||
|
|
||||||
|
class BugReportResponse(BaseModel):
|
||||||
|
id: int
|
||||||
|
|
||||||
|
|
||||||
|
@router.post("", response_model=BugReportResponse, status_code=status.HTTP_201_CREATED)
|
||||||
|
async def create_bug_report(
|
||||||
|
body: BugReportCreate,
|
||||||
|
user: User | None = Depends(get_optional_user),
|
||||||
|
session: AsyncSession = Depends(get_session),
|
||||||
|
) -> BugReportResponse:
|
||||||
|
report = BugReport(
|
||||||
|
description=body.description,
|
||||||
|
contact=body.contact,
|
||||||
|
user_id=user.id if user is not None else None,
|
||||||
|
)
|
||||||
|
session.add(report)
|
||||||
|
await session.commit()
|
||||||
|
return BugReportResponse(id=report.id)
|
||||||
|
|
||||||
|
|
||||||
|
class MyBugReportResponse(BaseModel):
|
||||||
|
id: int
|
||||||
|
description: str
|
||||||
|
status: str
|
||||||
|
created_at: str
|
||||||
|
|
||||||
|
|
||||||
|
@router.get("/mine", response_model=list[MyBugReportResponse])
|
||||||
|
async def list_my_bug_reports(
|
||||||
|
user: User = Depends(get_current_user),
|
||||||
|
session: AsyncSession = Depends(get_session),
|
||||||
|
) -> list[MyBugReportResponse]:
|
||||||
|
"""The one user-facing history view for bug reports (anonymous submissions have
|
||||||
|
no user to attribute this to, so this only ever covers ones filed while logged in)."""
|
||||||
|
reports = (
|
||||||
|
await session.scalars(
|
||||||
|
select(BugReport).where(BugReport.user_id == user.id).order_by(BugReport.id.desc())
|
||||||
|
)
|
||||||
|
).all()
|
||||||
|
return [
|
||||||
|
MyBugReportResponse(
|
||||||
|
id=r.id, description=r.description, status=r.status, created_at=isoformat_utc(r.created_at)
|
||||||
|
)
|
||||||
|
for r in reports
|
||||||
|
]
|
||||||
@@ -8,13 +8,14 @@ from pydantic import BaseModel
|
|||||||
from sqlalchemy import func, select
|
from sqlalchemy import func, select
|
||||||
from sqlalchemy.ext.asyncio import AsyncSession
|
from sqlalchemy.ext.asyncio import AsyncSession
|
||||||
|
|
||||||
|
from app.api.client_ip import client_ip
|
||||||
from app.api.timeutil import isoformat_utc
|
from app.api.timeutil import isoformat_utc
|
||||||
from app.auth.dependencies import get_optional_user
|
from app.auth.dependencies import get_optional_user
|
||||||
from app.db.models import RoundParticipant, User
|
from app.db.models import RoundParticipant, User
|
||||||
from app.db.session import get_session
|
from app.db.session import get_session
|
||||||
from app.rounds.config import get_round_config
|
from app.rounds.config import get_round_config
|
||||||
from app.rounds.events import RoundEventCapacityError, broadcaster
|
from app.rounds.events import EVICTED, RoundEventCapacityError, broadcaster
|
||||||
from app.rounds.service import get_active_round
|
from app.rounds.service import get_active_round, winner_share
|
||||||
|
|
||||||
router = APIRouter(prefix="/rounds", tags=["rounds"])
|
router = APIRouter(prefix="/rounds", tags=["rounds"])
|
||||||
|
|
||||||
@@ -46,9 +47,14 @@ async def round_stream(request: Request) -> Response:
|
|||||||
That's also what happens past MAX_SUBSCRIBERS (app/rounds/events.py): this
|
That's also what happens past MAX_SUBSCRIBERS (app/rounds/events.py): this
|
||||||
returns 503 rather than opening a stream, and the browser's EventSource
|
returns 503 rather than opening a stream, and the browser's EventSource
|
||||||
just retries later while the frontend keeps working off polling meanwhile.
|
just retries later while the frontend keeps working off polling meanwhile.
|
||||||
|
|
||||||
|
Concurrent streams are additionally capped per client IP (B-38): past
|
||||||
|
MAX_SUBSCRIBERS_PER_IP, opening one more evicts that IP's own oldest
|
||||||
|
connection rather than refusing the new one or letting a single source
|
||||||
|
exhaust the global cap and degrade every other user.
|
||||||
"""
|
"""
|
||||||
try:
|
try:
|
||||||
queue = broadcaster.subscribe()
|
queue = broadcaster.subscribe(client_ip(request))
|
||||||
except RoundEventCapacityError:
|
except RoundEventCapacityError:
|
||||||
return JSONResponse(status_code=503, content={"detail": "too many concurrent update streams"})
|
return JSONResponse(status_code=503, content={"detail": "too many concurrent update streams"})
|
||||||
|
|
||||||
@@ -59,7 +65,9 @@ async def round_stream(request: Request) -> Response:
|
|||||||
if await request.is_disconnected():
|
if await request.is_disconnected():
|
||||||
break
|
break
|
||||||
try:
|
try:
|
||||||
await asyncio.wait_for(queue.get(), timeout=_SSE_DISCONNECT_CHECK_SECONDS)
|
item = await asyncio.wait_for(queue.get(), timeout=_SSE_DISCONNECT_CHECK_SECONDS)
|
||||||
|
if item is EVICTED:
|
||||||
|
break # this IP opened another stream past its per-IP cap
|
||||||
yield "event: update\ndata: {}\n\n".format(json.dumps({}))
|
yield "event: update\ndata: {}\n\n".format(json.dumps({}))
|
||||||
ticks_since_keepalive = 0
|
ticks_since_keepalive = 0
|
||||||
except asyncio.TimeoutError:
|
except asyncio.TimeoutError:
|
||||||
@@ -157,7 +165,7 @@ async def current_round(
|
|||||||
# upper bound by the payout tx's own fee, which is deducted from the winner's
|
# upper bound by the payout tx's own fee, which is deducted from the winner's
|
||||||
# share and isn't knowable until the payout is built — a few hundred sat on a
|
# share and isn't knowable until the payout is built — a few hundred sat on a
|
||||||
# 1 sat/vB payout, i.e. invisible at PLM amounts, but it is not exact.
|
# 1 sat/vB payout, i.e. invisible at PLM amounts, but it is not exact.
|
||||||
jackpot_sats = pool_amount_sats * 70 // 100
|
jackpot_sats = winner_share(pool_amount_sats)
|
||||||
|
|
||||||
return CurrentRoundResponse(
|
return CurrentRoundResponse(
|
||||||
server_time=datetime.now(timezone.utc).isoformat(),
|
server_time=datetime.now(timezone.utc).isoformat(),
|
||||||
|
|||||||
+1
-10
@@ -4,6 +4,7 @@ from sqlalchemy import func, select
|
|||||||
from sqlalchemy.exc import IntegrityError
|
from sqlalchemy.exc import IntegrityError
|
||||||
from sqlalchemy.ext.asyncio import AsyncSession
|
from sqlalchemy.ext.asyncio import AsyncSession
|
||||||
|
|
||||||
|
from app.api.client_ip import client_ip as _client_ip
|
||||||
from app.api.errors import http_error
|
from app.api.errors import http_error
|
||||||
from app.auth.rate_limit import AuthRateLimiters
|
from app.auth.rate_limit import AuthRateLimiters
|
||||||
from app.auth.security import MIN_PASSWORD_LENGTH, create_access_token, hash_password, verify_password
|
from app.auth.security import MIN_PASSWORD_LENGTH, create_access_token, hash_password, verify_password
|
||||||
@@ -34,16 +35,6 @@ def _rate_limiters(request: Request) -> AuthRateLimiters:
|
|||||||
return request.app.state.auth_rate_limiters
|
return request.app.state.auth_rate_limiters
|
||||||
|
|
||||||
|
|
||||||
def _client_ip(request: Request) -> str:
|
|
||||||
# Caddy (see Caddyfile) reverse-proxies every request, so request.client.host
|
|
||||||
# is the proxy's address, not the caller's — fall back to it only if the
|
|
||||||
# header is somehow missing (e.g. hitting the app container directly).
|
|
||||||
forwarded = request.headers.get("x-forwarded-for")
|
|
||||||
if forwarded:
|
|
||||||
return forwarded.split(",")[0].strip()
|
|
||||||
return request.client.host if request.client else "unknown"
|
|
||||||
|
|
||||||
|
|
||||||
def _rate_limited_error(retry_after: float):
|
def _rate_limited_error(retry_after: float):
|
||||||
return http_error(
|
return http_error(
|
||||||
status.HTTP_429_TOO_MANY_REQUESTS,
|
status.HTTP_429_TOO_MANY_REQUESTS,
|
||||||
|
|||||||
+6
-1
@@ -62,7 +62,7 @@ async def place_bet(session: AsyncSession, client: ElectrumClient, user: User) -
|
|||||||
fee_rate_sat_vb=config.fee_rate_sat_vb,
|
fee_rate_sat_vb=config.fee_rate_sat_vb,
|
||||||
)
|
)
|
||||||
except InsufficientFundsError as exc:
|
except InsufficientFundsError as exc:
|
||||||
raise BetError(exc.code, str(exc)) from exc
|
raise BetError(exc.code, str(exc), **exc.params) from exc
|
||||||
|
|
||||||
# --- Phase 1: record the intent, *then* broadcast (B-08) --------------------
|
# --- Phase 1: record the intent, *then* broadcast (B-08) --------------------
|
||||||
# Broadcasting first meant a failure (or a crash) between the broadcast and the
|
# Broadcasting first meant a failure (or a crash) between the broadcast and the
|
||||||
@@ -144,6 +144,11 @@ async def _release_failed_bet(
|
|||||||
user_id=user_id,
|
user_id=user_id,
|
||||||
)
|
)
|
||||||
await session.commit()
|
await session.commit()
|
||||||
|
# The rollback moved as much state as the successful path did — the balance is
|
||||||
|
# back, the participant is gone, so participant_count and jackpot shrank again.
|
||||||
|
# Without this the dashboards kept showing the phantom bet until their next poll
|
||||||
|
# (B-49); the reconciler's own abandon path has always published here.
|
||||||
|
broadcaster.publish()
|
||||||
|
|
||||||
|
|
||||||
def _pending_transaction(
|
def _pending_transaction(
|
||||||
|
|||||||
@@ -29,6 +29,11 @@ class Settings(BaseSettings):
|
|||||||
jwt_expire_minutes: int = 60 * 24
|
jwt_expire_minutes: int = 60 * 24
|
||||||
admin_token: str = ""
|
admin_token: str = ""
|
||||||
|
|
||||||
|
# Swagger/ReDoc/OpenAPI JSON expose the entire API surface (admin endpoints
|
||||||
|
# included) to anyone who requests them. Off by default (B-42) — set to true
|
||||||
|
# only for local development, never in production.
|
||||||
|
enable_api_docs: bool = False
|
||||||
|
|
||||||
# Every business/round parameter (bet amount, round duration/cooldown,
|
# Every business/round parameter (bet amount, round duration/cooldown,
|
||||||
# min amount, fee rate, RBF timeout, fee address) lives in the round_config
|
# min amount, fee rate, RBF timeout, fee address) lives in the round_config
|
||||||
# DB table instead (app/db/models.py RoundConfig, app/rounds/config.py) —
|
# DB table instead (app/db/models.py RoundConfig, app/rounds/config.py) —
|
||||||
|
|||||||
+36
-1
@@ -1,9 +1,44 @@
|
|||||||
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
|
from sqlalchemy import event
|
||||||
|
from sqlalchemy.ext.asyncio import AsyncEngine, async_sessionmaker, create_async_engine
|
||||||
from sqlalchemy.orm import DeclarativeBase
|
from sqlalchemy.orm import DeclarativeBase
|
||||||
|
|
||||||
from app.config import settings
|
from app.config import settings
|
||||||
|
|
||||||
|
# How long a writer waits for a lock held by another writer before SQLite raises
|
||||||
|
# "database is locked" (B-39). A few seconds is enough to ride out this app's own
|
||||||
|
# five concurrent background tasks (scheduler, confirmation poller, RBF bumper,
|
||||||
|
# two reconcilers) plus HTTP handlers briefly overlapping a write.
|
||||||
|
_SQLITE_BUSY_TIMEOUT_MS = 5000
|
||||||
|
|
||||||
|
|
||||||
|
def _register_sqlite_pragmas(target_engine: AsyncEngine) -> None:
|
||||||
|
"""Without WAL, SQLite's default (rollback-journal) mode lets a writer block
|
||||||
|
every reader for the duration of its transaction, and a second writer arriving
|
||||||
|
while one is already active fails immediately rather than waiting at all —
|
||||||
|
realistic under this app's concurrency, and nothing previously handled it.
|
||||||
|
WAL lets readers and writers proceed without blocking each other, and
|
||||||
|
busy_timeout gives a second writer a real window to wait for the first
|
||||||
|
instead of an instant `OperationalError`.
|
||||||
|
|
||||||
|
No-op for any dialect other than sqlite (e.g. a future PostgreSQL
|
||||||
|
DATABASE_URL), which neither needs nor understands these pragmas.
|
||||||
|
"""
|
||||||
|
if target_engine.dialect.name != "sqlite":
|
||||||
|
return
|
||||||
|
|
||||||
|
@event.listens_for(target_engine.sync_engine, "connect")
|
||||||
|
def _set_sqlite_pragmas(dbapi_connection, connection_record) -> None:
|
||||||
|
cursor = dbapi_connection.cursor()
|
||||||
|
try:
|
||||||
|
cursor.execute("PRAGMA journal_mode=WAL")
|
||||||
|
cursor.execute("PRAGMA synchronous=NORMAL")
|
||||||
|
cursor.execute(f"PRAGMA busy_timeout={_SQLITE_BUSY_TIMEOUT_MS}")
|
||||||
|
finally:
|
||||||
|
cursor.close()
|
||||||
|
|
||||||
|
|
||||||
engine = create_async_engine(settings.database_url)
|
engine = create_async_engine(settings.database_url)
|
||||||
|
_register_sqlite_pragmas(engine)
|
||||||
AsyncSessionLocal = async_sessionmaker(engine, expire_on_commit=False)
|
AsyncSessionLocal = async_sessionmaker(engine, expire_on_commit=False)
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
+21
-3
@@ -1,6 +1,6 @@
|
|||||||
from datetime import datetime, timezone
|
from datetime import datetime, timezone
|
||||||
|
|
||||||
from sqlalchemy import BigInteger, ForeignKey, Index, String, UniqueConstraint, text
|
from sqlalchemy import BigInteger, ForeignKey, Index, String, Text, UniqueConstraint, text
|
||||||
from sqlalchemy.orm import Mapped, mapped_column
|
from sqlalchemy.orm import Mapped, mapped_column
|
||||||
|
|
||||||
from app.db.base import Base
|
from app.db.base import Base
|
||||||
@@ -154,7 +154,7 @@ class PendingTransaction(Base):
|
|||||||
user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), default=None)
|
user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), default=None)
|
||||||
current_txid: Mapped[str] = mapped_column(String(64))
|
current_txid: Mapped[str] = mapped_column(String(64))
|
||||||
fee_rate_sat_vb: Mapped[int]
|
fee_rate_sat_vb: Mapped[int]
|
||||||
raw_tx_hex: Mapped[str] = mapped_column(String)
|
raw_tx_hex: Mapped[str] = mapped_column(Text)
|
||||||
# The *first* broadcast — never rewritten by a bump — since this is what the
|
# The *first* broadcast — never rewritten by a bump — since this is what the
|
||||||
# reconciler's abandon-after-N-hours grace period (app/tx/reconcile.py) measures
|
# reconciler's abandon-after-N-hours grace period (app/tx/reconcile.py) measures
|
||||||
# from. Bumping used to overwrite this field, which reset that clock on every
|
# from. Bumping used to overwrite this field, which reset that clock on every
|
||||||
@@ -188,12 +188,30 @@ class Withdrawal(Base):
|
|||||||
confirmed_at: Mapped[datetime | None] = mapped_column(default=None)
|
confirmed_at: Mapped[datetime | None] = mapped_column(default=None)
|
||||||
|
|
||||||
|
|
||||||
|
class BugReport(Base):
|
||||||
|
__tablename__ = "bug_reports"
|
||||||
|
|
||||||
|
id: Mapped[int] = mapped_column(primary_key=True)
|
||||||
|
description: Mapped[str] = mapped_column(Text)
|
||||||
|
contact: Mapped[str | None] = mapped_column(String(256), default=None)
|
||||||
|
# Set when the reporter was logged in at submission time; the report page is
|
||||||
|
# reachable both logged-in and logged-out (like GET /rounds/current), so this
|
||||||
|
# stays nullable rather than requiring auth just to file a report.
|
||||||
|
user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), default=None)
|
||||||
|
# open -> read -> resolved, admin-driven (app/api/routes/admin.py). "read" is a
|
||||||
|
# distinct step from "resolved" so a reporter checking their own status (only
|
||||||
|
# possible when logged in — see GET /bug-reports/mine) can tell "an admin has
|
||||||
|
# seen this" apart from "this has actually been fixed".
|
||||||
|
status: Mapped[str] = mapped_column(String(16), default="open")
|
||||||
|
created_at: Mapped[datetime] = mapped_column(default=utcnow)
|
||||||
|
|
||||||
|
|
||||||
class AuditLog(Base):
|
class AuditLog(Base):
|
||||||
__tablename__ = "audit_log"
|
__tablename__ = "audit_log"
|
||||||
|
|
||||||
id: Mapped[int] = mapped_column(primary_key=True)
|
id: Mapped[int] = mapped_column(primary_key=True)
|
||||||
event_type: Mapped[str] = mapped_column(String(32))
|
event_type: Mapped[str] = mapped_column(String(32))
|
||||||
payload_json: Mapped[str] = mapped_column(String)
|
payload_json: Mapped[str] = mapped_column(Text)
|
||||||
user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), default=None)
|
user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), default=None)
|
||||||
round_id: Mapped[int | None] = mapped_column(ForeignKey("rounds.id"), default=None)
|
round_id: Mapped[int | None] = mapped_column(ForeignKey("rounds.id"), default=None)
|
||||||
created_at: Mapped[datetime] = mapped_column(default=utcnow)
|
created_at: Mapped[datetime] = mapped_column(default=utcnow)
|
||||||
@@ -169,6 +169,17 @@ class ElectrumClient:
|
|||||||
async def listunspent(self, scripthash: str) -> list[dict]:
|
async def listunspent(self, scripthash: str) -> list[dict]:
|
||||||
return await self.request("blockchain.scripthash.listunspent", [scripthash])
|
return await self.request("blockchain.scripthash.listunspent", [scripthash])
|
||||||
|
|
||||||
|
async def get_history(self, scripthash: str) -> list[dict]:
|
||||||
|
"""Every transaction touching `scripthash`, each as {"tx_hash", "height"} —
|
||||||
|
height > 0 means confirmed at that height, height <= 0 means still in the
|
||||||
|
mempool. Used instead of blockchain.transaction.get's verbose=True mode
|
||||||
|
for confirmation/existence checks (B-41): several Electrum server
|
||||||
|
implementations and versions reject the verbose flag outright ("verbose
|
||||||
|
transactions are currently unsupported"), while get_history is a plain,
|
||||||
|
universally-supported method every server must implement.
|
||||||
|
"""
|
||||||
|
return await self.request("blockchain.scripthash.get_history", [scripthash])
|
||||||
|
|
||||||
async def broadcast(self, raw_tx_hex: str) -> str:
|
async def broadcast(self, raw_tx_hex: str) -> str:
|
||||||
return await self.request("blockchain.transaction.broadcast", [raw_tx_hex])
|
return await self.request("blockchain.transaction.broadcast", [raw_tx_hex])
|
||||||
|
|
||||||
|
|||||||
+13
-2
@@ -15,6 +15,7 @@ import app.rounds.confirmation # noqa: F401 (registers the "payout" confirmati
|
|||||||
import app.withdrawals.confirmation # noqa: F401 (registers the "withdrawal" confirmation handler)
|
import app.withdrawals.confirmation # noqa: F401 (registers the "withdrawal" confirmation handler)
|
||||||
from app.api.routes.admin import router as admin_router
|
from app.api.routes.admin import router as admin_router
|
||||||
from app.api.routes.bets import router as bets_router
|
from app.api.routes.bets import router as bets_router
|
||||||
|
from app.api.routes.bug_reports import router as bug_reports_router
|
||||||
from app.api.routes.qr import router as qr_router
|
from app.api.routes.qr import router as qr_router
|
||||||
from app.api.routes.rounds import router as rounds_router
|
from app.api.routes.rounds import router as rounds_router
|
||||||
from app.api.routes.users import router as users_router
|
from app.api.routes.users import router as users_router
|
||||||
@@ -41,7 +42,7 @@ def _make_electrum_client(endpoint: ElectrumEndpoint) -> ElectrumClient:
|
|||||||
|
|
||||||
@asynccontextmanager
|
@asynccontextmanager
|
||||||
async def lifespan(app: FastAPI):
|
async def lifespan(app: FastAPI):
|
||||||
# Refuses to serve rather than starting up half-configured — see B-15 in BUGS.md.
|
# Refuses to serve rather than starting up half-configured (B-15).
|
||||||
validate_runtime_secrets()
|
validate_runtime_secrets()
|
||||||
|
|
||||||
endpoints = parse_endpoints(
|
endpoints = parse_endpoints(
|
||||||
@@ -84,12 +85,22 @@ async def lifespan(app: FastAPI):
|
|||||||
await listener.client.close()
|
await listener.client.close()
|
||||||
|
|
||||||
|
|
||||||
app = FastAPI(title="PLM Lottery", lifespan=lifespan)
|
# Swagger/ReDoc/the raw OpenAPI JSON enumerate the entire API surface, admin
|
||||||
|
# endpoints included, to anyone who requests them (B-42) — disabled unless
|
||||||
|
# ENABLE_API_DOCS is explicitly set, which should only happen in development.
|
||||||
|
app = FastAPI(
|
||||||
|
title="PLM Lottery",
|
||||||
|
lifespan=lifespan,
|
||||||
|
docs_url="/docs" if settings.enable_api_docs else None,
|
||||||
|
redoc_url="/redoc" if settings.enable_api_docs else None,
|
||||||
|
openapi_url="/openapi.json" if settings.enable_api_docs else None,
|
||||||
|
)
|
||||||
app.include_router(auth_router)
|
app.include_router(auth_router)
|
||||||
app.include_router(users_router)
|
app.include_router(users_router)
|
||||||
app.include_router(bets_router)
|
app.include_router(bets_router)
|
||||||
app.include_router(withdrawals_router)
|
app.include_router(withdrawals_router)
|
||||||
app.include_router(admin_router)
|
app.include_router(admin_router)
|
||||||
|
app.include_router(bug_reports_router)
|
||||||
app.include_router(qr_router)
|
app.include_router(qr_router)
|
||||||
app.include_router(rounds_router)
|
app.include_router(rounds_router)
|
||||||
|
|
||||||
|
|||||||
+54
-14
@@ -1,16 +1,31 @@
|
|||||||
import asyncio
|
import asyncio
|
||||||
|
from collections import defaultdict
|
||||||
|
|
||||||
# Defensive cap on concurrent SSE subscribers. Expected load is on the order of
|
# Defensive backstop on concurrent SSE subscribers overall, regardless of source
|
||||||
# ~100 concurrent users; this is set well above that so it never engages under
|
# — expected load is on the order of ~100 concurrent users, so this is set well
|
||||||
# normal use — it exists purely so a runaway/DoS-y number of open connections
|
# above that. The real defense against a single abusive source is the per-IP cap
|
||||||
# degrades (new connections fall back to polling, see round_stream()) instead
|
# below (B-38): a global-only cap was trivially exhausted by one client opening
|
||||||
# of growing the in-memory subscriber set without bound. Revisit this number if
|
# MAX_SUBSCRIBERS connections, degrading every other user to polling — the
|
||||||
# expected concurrency grows well past it.
|
# comment used to call it "defensive"; it was actually the vector.
|
||||||
MAX_SUBSCRIBERS = 500
|
MAX_SUBSCRIBERS = 500
|
||||||
|
|
||||||
|
# How many concurrent streams a single client IP may hold. Deliberately small —
|
||||||
|
# a real browser tab needs at most one, occasionally two briefly across a
|
||||||
|
# reload — since this bounds one source's share of the global capacity, not a
|
||||||
|
# legitimate per-user concurrency limit.
|
||||||
|
MAX_SUBSCRIBERS_PER_IP = 5
|
||||||
|
|
||||||
|
# Put on a to-be-evicted subscriber's queue (B-38) to wake its generator
|
||||||
|
# (app/api/routes/rounds.py:round_stream) promptly so it closes the connection
|
||||||
|
# instead of lingering, silently uncounted, until the client's own network
|
||||||
|
# timeout or the next keep-alive tick.
|
||||||
|
EVICTED = object()
|
||||||
|
|
||||||
|
|
||||||
class RoundEventCapacityError(Exception):
|
class RoundEventCapacityError(Exception):
|
||||||
"""Raised by subscribe() when MAX_SUBSCRIBERS is already reached."""
|
"""Raised by subscribe() when MAX_SUBSCRIBERS — the global backstop — is
|
||||||
|
already reached. The per-IP cap never raises this; it evicts instead (see
|
||||||
|
subscribe())."""
|
||||||
|
|
||||||
|
|
||||||
class RoundEventBroadcaster:
|
class RoundEventBroadcaster:
|
||||||
@@ -26,22 +41,47 @@ class RoundEventBroadcaster:
|
|||||||
would need a shared channel (e.g. Redis pub/sub) instead.
|
would need a shared channel (e.g. Redis pub/sub) instead.
|
||||||
"""
|
"""
|
||||||
|
|
||||||
def __init__(self, max_subscribers: int = MAX_SUBSCRIBERS):
|
def __init__(self, max_subscribers: int = MAX_SUBSCRIBERS, max_per_ip: int = MAX_SUBSCRIBERS_PER_IP):
|
||||||
self._subscribers: set[asyncio.Queue] = set()
|
self._ip_by_queue: dict[asyncio.Queue, str] = {}
|
||||||
|
self._queues_by_ip: dict[str, list[asyncio.Queue]] = defaultdict(list)
|
||||||
self.max_subscribers = max_subscribers
|
self.max_subscribers = max_subscribers
|
||||||
|
self.max_per_ip = max_per_ip
|
||||||
|
|
||||||
def subscribe(self) -> asyncio.Queue:
|
def subscribe(self, client_ip: str = "unknown") -> asyncio.Queue:
|
||||||
if len(self._subscribers) >= self.max_subscribers:
|
if len(self._ip_by_queue) >= self.max_subscribers:
|
||||||
raise RoundEventCapacityError(f"already at the {self.max_subscribers}-subscriber cap")
|
raise RoundEventCapacityError(f"already at the {self.max_subscribers}-subscriber cap")
|
||||||
|
|
||||||
|
ip_queues = self._queues_by_ip[client_ip]
|
||||||
|
if len(ip_queues) >= self.max_per_ip:
|
||||||
|
# B-38: evict this IP's own oldest connection rather than refusing
|
||||||
|
# the new one — bounds one source's footprint without turning a
|
||||||
|
# legitimate reconnect storm (a flaky network retrying EventSource)
|
||||||
|
# into an outright block, and without letting one abusive IP crowd
|
||||||
|
# out unrelated clients the way the old global-only cap did.
|
||||||
|
oldest = ip_queues.pop(0)
|
||||||
|
self._ip_by_queue.pop(oldest, None)
|
||||||
|
if not oldest.full():
|
||||||
|
oldest.put_nowait(EVICTED)
|
||||||
|
|
||||||
queue: asyncio.Queue = asyncio.Queue(maxsize=1)
|
queue: asyncio.Queue = asyncio.Queue(maxsize=1)
|
||||||
self._subscribers.add(queue)
|
self._ip_by_queue[queue] = client_ip
|
||||||
|
ip_queues.append(queue)
|
||||||
return queue
|
return queue
|
||||||
|
|
||||||
def unsubscribe(self, queue: asyncio.Queue) -> None:
|
def unsubscribe(self, queue: asyncio.Queue) -> None:
|
||||||
self._subscribers.discard(queue)
|
client_ip = self._ip_by_queue.pop(queue, None)
|
||||||
|
if client_ip is None:
|
||||||
|
return
|
||||||
|
ip_queues = self._queues_by_ip.get(client_ip)
|
||||||
|
if ip_queues is None:
|
||||||
|
return
|
||||||
|
if queue in ip_queues:
|
||||||
|
ip_queues.remove(queue)
|
||||||
|
if not ip_queues:
|
||||||
|
self._queues_by_ip.pop(client_ip, None)
|
||||||
|
|
||||||
def publish(self) -> None:
|
def publish(self) -> None:
|
||||||
for queue in self._subscribers:
|
for queue in self._ip_by_queue:
|
||||||
if queue.full():
|
if queue.full():
|
||||||
continue # a not-yet-delivered notification already covers this one
|
continue # a not-yet-delivered notification already covers this one
|
||||||
queue.put_nowait(None)
|
queue.put_nowait(None)
|
||||||
|
|||||||
+10
-7
@@ -14,7 +14,7 @@ from app.electrum.scripthash import address_to_scripthash
|
|||||||
from app.rounds.config import get_round_config
|
from app.rounds.config import get_round_config
|
||||||
from app.rounds.draw import draw_winner, header_hex_to_block_hash
|
from app.rounds.draw import draw_winner, header_hex_to_block_hash
|
||||||
from app.rounds.events import broadcaster
|
from app.rounds.events import broadcaster
|
||||||
from app.rounds.service import open_new_round_if_needed
|
from app.rounds.service import open_new_round_if_needed, winner_share
|
||||||
from app.wallet.hd import derive_pool_key
|
from app.wallet.hd import derive_pool_key
|
||||||
from app.wallet.plm_network import PLM_MAINNET
|
from app.wallet.plm_network import PLM_MAINNET
|
||||||
from app.wallet.psbt_builder import InsufficientFundsError, Utxo, build_payout_transaction
|
from app.wallet.psbt_builder import InsufficientFundsError, Utxo, build_payout_transaction
|
||||||
@@ -338,8 +338,8 @@ class RoundScheduler:
|
|||||||
await self._log_payout_failure(round_id, winner_user_id, "winner user not found")
|
await self._log_payout_failure(round_id, winner_user_id, "winner user not found")
|
||||||
return
|
return
|
||||||
|
|
||||||
winner_share = pool_amount_sats * 70 // 100
|
winner_sats = winner_share(pool_amount_sats)
|
||||||
commission_share = pool_amount_sats - winner_share # remainder from rounding goes to fees
|
commission_share = pool_amount_sats - winner_sats # remainder from rounding goes to fees
|
||||||
|
|
||||||
# --- Phase 2: build (network read only, no DB write yet) -----------------
|
# --- Phase 2: build (network read only, no DB write yet) -----------------
|
||||||
try:
|
try:
|
||||||
@@ -358,15 +358,18 @@ class RoundScheduler:
|
|||||||
from_script=pool_script_obj,
|
from_script=pool_script_obj,
|
||||||
utxos=utxos,
|
utxos=utxos,
|
||||||
winner_address=winner_address,
|
winner_address=winner_address,
|
||||||
winner_share_sats=winner_share,
|
winner_share_sats=winner_sats,
|
||||||
fee_address=fee_address,
|
fee_address=fee_address,
|
||||||
commission_sats=commission_share,
|
commission_sats=commission_share,
|
||||||
change_address=pool_address,
|
change_address=pool_address,
|
||||||
fee_rate_sat_vb=fee_rate,
|
fee_rate_sat_vb=fee_rate,
|
||||||
)
|
)
|
||||||
except InsufficientFundsError:
|
except InsufficientFundsError as exc:
|
||||||
logger.exception("round %s payout failed: insufficient pool UTXOs", round_id)
|
# Includes the B-48 "too_many_inputs" case: the pool holds enough, but spread
|
||||||
await self._log_payout_failure(round_id, winner_user_id, "insufficient pool UTXOs")
|
# over more UTXOs than one transaction may spend, so /admin has to say which.
|
||||||
|
reason = "insufficient pool UTXOs" if exc.code == "insufficient_balance" else exc.code
|
||||||
|
logger.exception("round %s payout failed: %s", round_id, reason)
|
||||||
|
await self._log_payout_failure(round_id, winner_user_id, reason)
|
||||||
return
|
return
|
||||||
except Exception:
|
except Exception:
|
||||||
# Anything else — a malformed fee_address (EmbitError) or similar. This
|
# Anything else — a malformed fee_address (EmbitError) or similar. This
|
||||||
|
|||||||
@@ -18,6 +18,14 @@ _ACTIVE_STATUSES = ("open", "closing", "drawing", "paying_out")
|
|||||||
# broken in a way we don't anticipate.
|
# broken in a way we don't anticipate.
|
||||||
_OPEN_ROUND_ATTEMPTS = 3
|
_OPEN_ROUND_ATTEMPTS = 3
|
||||||
|
|
||||||
|
# 70% winner / 30% fees. Hardcoded by design (see CLAUDE.md) — changing the split
|
||||||
|
# is a code change, not an admin-editable setting. Single source of truth so the
|
||||||
|
# advertised jackpot (rounds.py) and the actual payout (scheduler.py) can't diverge.
|
||||||
|
|
||||||
|
|
||||||
|
def winner_share(pool_amount_sats: int) -> int:
|
||||||
|
return pool_amount_sats * 70 // 100
|
||||||
|
|
||||||
|
|
||||||
async def get_active_round(session: AsyncSession) -> Round | None:
|
async def get_active_round(session: AsyncSession) -> Round | None:
|
||||||
"""The round currently in progress (in any non-closed state), if any. Rounds
|
"""The round currently in progress (in any non-closed state), if any. Rounds
|
||||||
|
|||||||
@@ -133,6 +133,7 @@ table { width: 100%; border-collapse: collapse; font-size: 0.85rem; }
|
|||||||
th, td { text-align: left; padding: 8px 6px; border-bottom: 1px solid var(--color-border); vertical-align: top; }
|
th, td { text-align: left; padding: 8px 6px; border-bottom: 1px solid var(--color-border); vertical-align: top; }
|
||||||
th { color: var(--color-muted-foreground); font-weight: 500; }
|
th { color: var(--color-muted-foreground); font-weight: 500; }
|
||||||
td.addr, td.txid { font-family: 'Fira Code', monospace; word-break: break-all; max-width: 200px; }
|
td.addr, td.txid { font-family: 'Fira Code', monospace; word-break: break-all; max-width: 200px; }
|
||||||
|
td.payload-cell { max-width: 360px; white-space: pre-wrap; word-break: break-word; }
|
||||||
.table-wrap { overflow-x: auto; }
|
.table-wrap { overflow-x: auto; }
|
||||||
|
|
||||||
.badge {
|
.badge {
|
||||||
@@ -144,6 +145,13 @@ td.addr, td.txid { font-family: 'Fira Code', monospace; word-break: break-all; m
|
|||||||
background: #FEF3C7; color: #92400E; border-color: #F59E0B;
|
background: #FEF3C7; color: #92400E; border-color: #F59E0B;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
.badge.bug-status-open { background: #FEF3C7; color: #92400E; border-color: #F59E0B; }
|
||||||
|
.badge.bug-status-read { background: var(--color-background); color: var(--color-muted-foreground); }
|
||||||
|
.badge.bug-status-resolved { background: var(--color-success-bg); color: var(--color-success); border-color: var(--color-success); }
|
||||||
|
|
||||||
|
.bug-actions { display: flex; flex-wrap: wrap; gap: 6px; margin-top: 6px; }
|
||||||
|
.bug-actions button { width: auto; margin-top: 0; min-height: 30px; padding: 4px 10px; font-size: 0.78rem; }
|
||||||
|
|
||||||
button.reveal {
|
button.reveal {
|
||||||
width: auto; margin-top: 0; padding: 4px 10px; min-height: 30px; font-size: 0.78rem;
|
width: auto; margin-top: 0; padding: 4px 10px; min-height: 30px; font-size: 0.78rem;
|
||||||
background: var(--color-destructive-bg); color: var(--color-destructive); border: 1px solid var(--color-destructive);
|
background: var(--color-destructive-bg); color: var(--color-destructive); border: 1px solid var(--color-destructive);
|
||||||
|
|||||||
@@ -30,6 +30,7 @@
|
|||||||
<span class="nav-tab" id="nav-round" onclick="switchView('round')">Round</span>
|
<span class="nav-tab" id="nav-round" onclick="switchView('round')">Round</span>
|
||||||
<span class="nav-tab" id="nav-pending" onclick="switchView('pending')">Transazioni pendenti</span>
|
<span class="nav-tab" id="nav-pending" onclick="switchView('pending')">Transazioni pendenti</span>
|
||||||
<span class="nav-tab" id="nav-audit" onclick="switchView('audit')">Audit log</span>
|
<span class="nav-tab" id="nav-audit" onclick="switchView('audit')">Audit log</span>
|
||||||
|
<span class="nav-tab" id="nav-bugreports" onclick="switchView('bugreports')">Segnalazioni bug</span>
|
||||||
<span class="spacer"></span>
|
<span class="spacer"></span>
|
||||||
<span class="chain-status-pill">
|
<span class="chain-status-pill">
|
||||||
<span class="status-dot" id="chain-status-dot"></span>
|
<span class="status-dot" id="chain-status-dot"></span>
|
||||||
@@ -153,6 +154,22 @@
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<div class="view" id="view-bugreports">
|
||||||
|
<h2 class="section-title">Segnalazioni bug</h2>
|
||||||
|
<p class="hint">Segnalazioni inviate dagli utenti tramite la pagina "Segnala un bug".</p>
|
||||||
|
|
||||||
|
<div class="card">
|
||||||
|
<div class="table-wrap">
|
||||||
|
<table>
|
||||||
|
<thead>
|
||||||
|
<tr><th>ID</th><th>Descrizione</th><th>Contatto</th><th>Utente</th><th>Quando</th><th>Stato</th></tr>
|
||||||
|
</thead>
|
||||||
|
<tbody id="bugreports-tbody"></tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
</main>
|
</main>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|||||||
+46
-3
@@ -89,8 +89,8 @@ function stopChainStatusPolling() {
|
|||||||
chainStatusInterval = null;
|
chainStatusInterval = null;
|
||||||
}
|
}
|
||||||
|
|
||||||
const VIEWS = ['parametri', 'utenti', 'round', 'pending', 'audit'];
|
const VIEWS = ['parametri', 'utenti', 'round', 'pending', 'audit', 'bugreports'];
|
||||||
const VIEW_LOADERS = { utenti: loadUsers, round: loadRounds, pending: loadPending, audit: loadAuditLog };
|
const VIEW_LOADERS = { utenti: loadUsers, round: loadRounds, pending: loadPending, audit: loadAuditLog, bugreports: loadBugReports };
|
||||||
let currentAdminView = 'parametri';
|
let currentAdminView = 'parametri';
|
||||||
|
|
||||||
function switchView(name) {
|
function switchView(name) {
|
||||||
@@ -109,7 +109,7 @@ function showDashboard() {
|
|||||||
}
|
}
|
||||||
|
|
||||||
async function loadDashboard() {
|
async function loadDashboard() {
|
||||||
await Promise.all([adminLoadConfig(), loadUsers(), loadRounds(), loadPending(), loadAuditLog()]);
|
await Promise.all([adminLoadConfig(), loadUsers(), loadRounds(), loadPending(), loadAuditLog(), loadBugReports()]);
|
||||||
}
|
}
|
||||||
|
|
||||||
async function adminLogin() {
|
async function adminLogin() {
|
||||||
@@ -346,6 +346,49 @@ async function loadAuditLog() {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
const BUG_REPORT_STATUS_LABELS = { open: 'Da leggere', read: 'Presa in carico', resolved: 'Risolta' };
|
||||||
|
|
||||||
|
function bugReportBadge(status) {
|
||||||
|
return `<span class="badge bug-status-${escapeHtml(status)}">${escapeHtml(BUG_REPORT_STATUS_LABELS[status] || status)}</span>`;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function loadBugReports() {
|
||||||
|
try {
|
||||||
|
const reports = await callAdmin('GET', '/admin/bug-reports');
|
||||||
|
const tbody = document.getElementById('bugreports-tbody');
|
||||||
|
tbody.innerHTML = reports.map((r) => `
|
||||||
|
<tr>
|
||||||
|
<td>${r.id}</td>
|
||||||
|
<td class="payload-cell">${escapeHtml(r.description)}</td>
|
||||||
|
<td>${r.contact ? escapeHtml(r.contact) : '—'}</td>
|
||||||
|
<td>${r.username ? escapeHtml(r.username) : '—'}</td>
|
||||||
|
<td>${fmtDate(r.created_at)}</td>
|
||||||
|
<td>
|
||||||
|
${bugReportBadge(r.status)}
|
||||||
|
<div class="bug-actions">
|
||||||
|
${r.status === 'open' ? `<button class="secondary" onclick="setBugReportStatus(${r.id}, 'read', this)">Segna come presa in carico</button>` : ''}
|
||||||
|
${r.status !== 'resolved' ? `<button class="secondary" onclick="setBugReportStatus(${r.id}, 'resolved', this)">Segna come risolta</button>` : ''}
|
||||||
|
${r.status !== 'open' ? `<button class="secondary" onclick="setBugReportStatus(${r.id}, 'open', this)">Riapri</button>` : ''}
|
||||||
|
</div>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
`).join('') || '<tr><td colspan="6" class="hint">Nessuna segnalazione ricevuta.</td></tr>';
|
||||||
|
} catch (e) {
|
||||||
|
toast('Errore nel caricamento segnalazioni: ' + e.message, 'error');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function setBugReportStatus(reportId, newStatus, button) {
|
||||||
|
await withLoading(button, '…', async () => {
|
||||||
|
try {
|
||||||
|
await callAdmin('POST', '/admin/bug-reports/' + reportId + '/status', { status: newStatus });
|
||||||
|
await loadBugReports();
|
||||||
|
} catch (e) {
|
||||||
|
toast('Errore: ' + e.message, 'error');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
document.getElementById('admin-token').addEventListener('keydown', (e) => {
|
document.getElementById('admin-token').addEventListener('keydown', (e) => {
|
||||||
if (e.key === 'Enter') adminLogin();
|
if (e.key === 'Enter') adminLogin();
|
||||||
});
|
});
|
||||||
|
|||||||
+12
-2
@@ -488,11 +488,21 @@ async function refreshRound() {
|
|||||||
// myUserId may not be loaded yet on the very first tick after a reload
|
// myUserId may not be loaded yet on the very first tick after a reload
|
||||||
// (refreshMe() and refreshRound() run concurrently) — fall back to the
|
// (refreshMe() and refreshRound() run concurrently) — fall back to the
|
||||||
// persisted result rather than risk showing nothing or the wrong side.
|
// persisted result rather than risk showing nothing or the wrong side.
|
||||||
|
// winner_user_id is committed as soon as the draw picks a winner, but
|
||||||
|
// winner_amount_sats isn't set until the payout tx is built afterwards
|
||||||
|
// (a real Electrum round-trip later) — revealing a win before then would
|
||||||
|
// show "+— PLM". Only the winner's own reveal needs to wait for it.
|
||||||
|
const iWon = myUserId != null && data.winner_user_id === myUserId;
|
||||||
|
const amountReady = !iWon || data.winner_amount_sats != null;
|
||||||
const canReveal =
|
const canReveal =
|
||||||
data.user_played && data.winner_user_id != null && (alreadyKnown || elapsedMs >= minMs) && myUserId != null;
|
data.user_played &&
|
||||||
|
data.winner_user_id != null &&
|
||||||
|
(alreadyKnown || elapsedMs >= minMs) &&
|
||||||
|
myUserId != null &&
|
||||||
|
amountReady;
|
||||||
|
|
||||||
if (canReveal) {
|
if (canReveal) {
|
||||||
const won = data.winner_user_id === myUserId;
|
const won = iWon;
|
||||||
if (!alreadyKnown) {
|
if (!alreadyKnown) {
|
||||||
persistResult(data.round_id, won, data.winner_amount_sats);
|
persistResult(data.round_id, won, data.winner_amount_sats);
|
||||||
if (won) {
|
if (won) {
|
||||||
|
|||||||
@@ -10,6 +10,26 @@ const TRANSLATIONS = {
|
|||||||
'nav.guideTitle': 'Guide',
|
'nav.guideTitle': 'Guide',
|
||||||
'nav.guideAria': 'Open the user guide',
|
'nav.guideAria': 'Open the user guide',
|
||||||
'nav.bugReport': 'Report a bug',
|
'nav.bugReport': 'Report a bug',
|
||||||
|
'bugReport.pageTitle': 'Report a bug',
|
||||||
|
'bugReport.heading': 'Report a bug',
|
||||||
|
'bugReport.intro': 'Found a problem? Describe it below — your report goes straight to the admin panel.',
|
||||||
|
'bugReport.englishNotice': "Please write your bug report in English, regardless of the language you're browsing in — this helps us handle it faster.",
|
||||||
|
'bugReport.descriptionLabel': 'What happened?',
|
||||||
|
'bugReport.descriptionPlaceholder': 'Describe the bug: what you were doing, what you expected, and what happened instead.',
|
||||||
|
'bugReport.contactLabel': 'Contact (optional)',
|
||||||
|
'bugReport.contactPlaceholder': "Email or other contact, if you'd like a reply",
|
||||||
|
'bugReport.submitBtn': 'Send report',
|
||||||
|
'bugReport.submitting': 'Sending…',
|
||||||
|
'bugReport.blankError': 'Describe the bug before sending.',
|
||||||
|
'bugReport.successToast': 'Thanks! Report sent.',
|
||||||
|
'bugReport.errorPrefix': 'Error sending: ',
|
||||||
|
'bugReport.myReportsTitle': 'Your reports',
|
||||||
|
'bugReport.myReportsHint': 'Only reports sent from this account, with the status set by the admin team.',
|
||||||
|
'bugReport.myReportsEmpty': "You haven't sent any reports yet.",
|
||||||
|
'bugReport.statusOpen': 'Not read yet',
|
||||||
|
'bugReport.statusRead': 'Acknowledged',
|
||||||
|
'bugReport.statusResolved': 'Resolved',
|
||||||
|
'bugReport.backLink': 'Back to home',
|
||||||
'nav.logoutTitle': 'Log out',
|
'nav.logoutTitle': 'Log out',
|
||||||
'nav.logoutAria': 'Log out of your account',
|
'nav.logoutAria': 'Log out of your account',
|
||||||
'nav.deposit': 'Deposit',
|
'nav.deposit': 'Deposit',
|
||||||
@@ -135,6 +155,7 @@ const TRANSLATIONS = {
|
|||||||
'error.invalid_amount': 'Enter an amount greater than zero.',
|
'error.invalid_amount': 'Enter an amount greater than zero.',
|
||||||
'error.broadcast_failed': 'The network refused the transaction. Please try again shortly.',
|
'error.broadcast_failed': 'The network refused the transaction. Please try again shortly.',
|
||||||
'error.amount_below_dust_limit': 'The amount is too small to be sent.',
|
'error.amount_below_dust_limit': 'The amount is too small to be sent.',
|
||||||
|
'error.too_many_inputs': 'Your balance is split across too many small deposits to be spent in a single transaction (max {max_inputs}). Please contact support to consolidate it.',
|
||||||
'error.withdrawal_to_own_address': 'That is your own deposit address — withdraw to an external wallet.',
|
'error.withdrawal_to_own_address': 'That is your own deposit address — withdraw to an external wallet.',
|
||||||
'error.internal_error': 'Unexpected server error. Please try again shortly.',
|
'error.internal_error': 'Unexpected server error. Please try again shortly.',
|
||||||
'error.guide_unavailable': 'The guide is not available right now.',
|
'error.guide_unavailable': 'The guide is not available right now.',
|
||||||
@@ -152,6 +173,26 @@ const TRANSLATIONS = {
|
|||||||
'nav.guideTitle': 'Guida',
|
'nav.guideTitle': 'Guida',
|
||||||
'nav.guideAria': 'Apri la guida utente',
|
'nav.guideAria': 'Apri la guida utente',
|
||||||
'nav.bugReport': 'Segnala un bug',
|
'nav.bugReport': 'Segnala un bug',
|
||||||
|
'bugReport.pageTitle': 'Segnala un bug',
|
||||||
|
'bugReport.heading': 'Segnala un bug',
|
||||||
|
'bugReport.intro': 'Hai trovato un problema? Descrivilo qui sotto: la segnalazione arriva direttamente al pannello di amministrazione.',
|
||||||
|
'bugReport.englishNotice': "Scrivi la segnalazione in inglese, indipendentemente dalla lingua che stai usando per navigare: questo ci aiuta a gestirla più velocemente.",
|
||||||
|
'bugReport.descriptionLabel': 'Cosa è successo?',
|
||||||
|
'bugReport.descriptionPlaceholder': 'Descrivi il bug: cosa stavi facendo, cosa ti aspettavi e cosa è successo invece.',
|
||||||
|
'bugReport.contactLabel': 'Contatto (opzionale)',
|
||||||
|
'bugReport.contactPlaceholder': 'Email o altro recapito, se vuoi essere ricontattato',
|
||||||
|
'bugReport.submitBtn': 'Invia segnalazione',
|
||||||
|
'bugReport.submitting': 'Invio…',
|
||||||
|
'bugReport.blankError': 'Descrivi il bug prima di inviare.',
|
||||||
|
'bugReport.successToast': 'Grazie! Segnalazione inviata.',
|
||||||
|
'bugReport.errorPrefix': "Errore nell'invio: ",
|
||||||
|
'bugReport.myReportsTitle': 'Le tue segnalazioni',
|
||||||
|
'bugReport.myReportsHint': "Solo le segnalazioni inviate da questo account, con lo stato aggiornato dall'amministrazione.",
|
||||||
|
'bugReport.myReportsEmpty': 'Non hai ancora inviato segnalazioni.',
|
||||||
|
'bugReport.statusOpen': 'Da leggere',
|
||||||
|
'bugReport.statusRead': 'Presa in carico',
|
||||||
|
'bugReport.statusResolved': 'Risolta',
|
||||||
|
'bugReport.backLink': 'Torna alla home',
|
||||||
'nav.logoutTitle': 'Esci',
|
'nav.logoutTitle': 'Esci',
|
||||||
'nav.logoutAria': "Esci dall'account",
|
'nav.logoutAria': "Esci dall'account",
|
||||||
'nav.deposit': 'Deposito',
|
'nav.deposit': 'Deposito',
|
||||||
@@ -274,6 +315,7 @@ const TRANSLATIONS = {
|
|||||||
'error.invalid_amount': 'Inserisci un importo maggiore di zero.',
|
'error.invalid_amount': 'Inserisci un importo maggiore di zero.',
|
||||||
'error.broadcast_failed': 'La rete ha rifiutato la transazione. Riprova tra poco.',
|
'error.broadcast_failed': 'La rete ha rifiutato la transazione. Riprova tra poco.',
|
||||||
'error.amount_below_dust_limit': "L'importo è troppo basso per essere inviato.",
|
'error.amount_below_dust_limit': "L'importo è troppo basso per essere inviato.",
|
||||||
|
'error.too_many_inputs': 'Il tuo saldo è suddiviso in troppi piccoli depositi per essere speso in una sola transazione (max {max_inputs}). Contatta l\'assistenza per consolidarlo.',
|
||||||
'error.withdrawal_to_own_address': 'Questo è il tuo indirizzo di deposito — preleva verso un wallet esterno.',
|
'error.withdrawal_to_own_address': 'Questo è il tuo indirizzo di deposito — preleva verso un wallet esterno.',
|
||||||
'error.internal_error': 'Errore inatteso del server. Riprova tra poco.',
|
'error.internal_error': 'Errore inatteso del server. Riprova tra poco.',
|
||||||
'error.guide_unavailable': 'La guida non è disponibile in questo momento.',
|
'error.guide_unavailable': 'La guida non è disponibile in questo momento.',
|
||||||
@@ -291,6 +333,26 @@ const TRANSLATIONS = {
|
|||||||
'nav.guideTitle': 'Guía',
|
'nav.guideTitle': 'Guía',
|
||||||
'nav.guideAria': 'Abrir la guía del usuario',
|
'nav.guideAria': 'Abrir la guía del usuario',
|
||||||
'nav.bugReport': 'Reportar un error',
|
'nav.bugReport': 'Reportar un error',
|
||||||
|
'bugReport.pageTitle': 'Reportar un error',
|
||||||
|
'bugReport.heading': 'Reportar un error',
|
||||||
|
'bugReport.intro': '¿Encontraste un problema? Descríbelo a continuación: el informe llega directamente al panel de administración.',
|
||||||
|
'bugReport.englishNotice': 'Escribe el informe en inglés, independientemente del idioma que estés usando para navegar: esto nos ayuda a gestionarlo más rápido.',
|
||||||
|
'bugReport.descriptionLabel': '¿Qué pasó?',
|
||||||
|
'bugReport.descriptionPlaceholder': 'Describe el error: qué estabas haciendo, qué esperabas y qué sucedió en su lugar.',
|
||||||
|
'bugReport.contactLabel': 'Contacto (opcional)',
|
||||||
|
'bugReport.contactPlaceholder': 'Correo u otro contacto, si quieres que te respondamos',
|
||||||
|
'bugReport.submitBtn': 'Enviar informe',
|
||||||
|
'bugReport.submitting': 'Enviando…',
|
||||||
|
'bugReport.blankError': 'Describe el error antes de enviarlo.',
|
||||||
|
'bugReport.successToast': '¡Gracias! Informe enviado.',
|
||||||
|
'bugReport.errorPrefix': 'Error al enviar: ',
|
||||||
|
'bugReport.myReportsTitle': 'Tus informes',
|
||||||
|
'bugReport.myReportsHint': 'Solo los informes enviados desde esta cuenta, con el estado actualizado por el equipo de administración.',
|
||||||
|
'bugReport.myReportsEmpty': 'Todavía no has enviado ningún informe.',
|
||||||
|
'bugReport.statusOpen': 'Sin leer',
|
||||||
|
'bugReport.statusRead': 'En curso',
|
||||||
|
'bugReport.statusResolved': 'Resuelto',
|
||||||
|
'bugReport.backLink': 'Volver al inicio',
|
||||||
'nav.logoutTitle': 'Salir',
|
'nav.logoutTitle': 'Salir',
|
||||||
'nav.logoutAria': 'Cerrar sesión',
|
'nav.logoutAria': 'Cerrar sesión',
|
||||||
'nav.deposit': 'Depósito',
|
'nav.deposit': 'Depósito',
|
||||||
@@ -413,6 +475,7 @@ const TRANSLATIONS = {
|
|||||||
'error.invalid_amount': 'Introduce un importe mayor que cero.',
|
'error.invalid_amount': 'Introduce un importe mayor que cero.',
|
||||||
'error.broadcast_failed': 'La red rechazó la transacción. Inténtalo de nuevo en un momento.',
|
'error.broadcast_failed': 'La red rechazó la transacción. Inténtalo de nuevo en un momento.',
|
||||||
'error.amount_below_dust_limit': 'El importe es demasiado pequeño para enviarse.',
|
'error.amount_below_dust_limit': 'El importe es demasiado pequeño para enviarse.',
|
||||||
|
'error.too_many_inputs': 'Tu saldo está repartido en demasiados depósitos pequeños para gastarse en una sola transacción (máx. {max_inputs}). Contacta con soporte para consolidarlo.',
|
||||||
'error.withdrawal_to_own_address': 'Esa es tu propia dirección de depósito — retira a una cartera externa.',
|
'error.withdrawal_to_own_address': 'Esa es tu propia dirección de depósito — retira a una cartera externa.',
|
||||||
'error.internal_error': 'Error inesperado del servidor. Inténtalo de nuevo en un momento.',
|
'error.internal_error': 'Error inesperado del servidor. Inténtalo de nuevo en un momento.',
|
||||||
'error.guide_unavailable': 'La guía no está disponible en este momento.',
|
'error.guide_unavailable': 'La guía no está disponible en este momento.',
|
||||||
@@ -430,6 +493,26 @@ const TRANSLATIONS = {
|
|||||||
'nav.guideTitle': 'Guide',
|
'nav.guideTitle': 'Guide',
|
||||||
'nav.guideAria': "Ouvrir le guide de l'utilisateur",
|
'nav.guideAria': "Ouvrir le guide de l'utilisateur",
|
||||||
'nav.bugReport': 'Signaler un bug',
|
'nav.bugReport': 'Signaler un bug',
|
||||||
|
'bugReport.pageTitle': 'Signaler un bug',
|
||||||
|
'bugReport.heading': 'Signaler un bug',
|
||||||
|
'bugReport.intro': "Vous avez trouvé un problème ? Décrivez-le ci-dessous : le signalement arrive directement dans le panneau d'administration.",
|
||||||
|
'bugReport.englishNotice': "Rédigez votre signalement en anglais, quelle que soit la langue que vous utilisez pour naviguer : cela nous aide à le traiter plus rapidement.",
|
||||||
|
'bugReport.descriptionLabel': "Que s'est-il passé ?",
|
||||||
|
'bugReport.descriptionPlaceholder': "Décrivez le bug : ce que vous faisiez, ce que vous attendiez et ce qui s'est passé à la place.",
|
||||||
|
'bugReport.contactLabel': 'Contact (facultatif)',
|
||||||
|
'bugReport.contactPlaceholder': 'Email ou autre contact, si vous souhaitez une réponse',
|
||||||
|
'bugReport.submitBtn': 'Envoyer le signalement',
|
||||||
|
'bugReport.submitting': 'Envoi…',
|
||||||
|
'bugReport.blankError': "Décrivez le bug avant d'envoyer.",
|
||||||
|
'bugReport.successToast': 'Merci ! Signalement envoyé.',
|
||||||
|
'bugReport.errorPrefix': "Erreur lors de l'envoi : ",
|
||||||
|
'bugReport.myReportsTitle': 'Vos signalements',
|
||||||
|
'bugReport.myReportsHint': "Seulement les signalements envoyés depuis ce compte, avec le statut mis à jour par l'équipe d'administration.",
|
||||||
|
'bugReport.myReportsEmpty': "Vous n'avez encore envoyé aucun signalement.",
|
||||||
|
'bugReport.statusOpen': 'Non lu',
|
||||||
|
'bugReport.statusRead': 'Prise en charge',
|
||||||
|
'bugReport.statusResolved': 'Résolu',
|
||||||
|
'bugReport.backLink': "Retour à l'accueil",
|
||||||
'nav.logoutTitle': 'Se déconnecter',
|
'nav.logoutTitle': 'Se déconnecter',
|
||||||
'nav.logoutAria': 'Se déconnecter du compte',
|
'nav.logoutAria': 'Se déconnecter du compte',
|
||||||
'nav.deposit': 'Dépôt',
|
'nav.deposit': 'Dépôt',
|
||||||
@@ -552,6 +635,7 @@ const TRANSLATIONS = {
|
|||||||
'error.invalid_amount': 'Saisissez un montant supérieur à zéro.',
|
'error.invalid_amount': 'Saisissez un montant supérieur à zéro.',
|
||||||
'error.broadcast_failed': 'Le réseau a refusé la transaction. Veuillez réessayer dans un instant.',
|
'error.broadcast_failed': 'Le réseau a refusé la transaction. Veuillez réessayer dans un instant.',
|
||||||
'error.amount_below_dust_limit': "Le montant est trop faible pour être envoyé.",
|
'error.amount_below_dust_limit': "Le montant est trop faible pour être envoyé.",
|
||||||
|
'error.too_many_inputs': 'Votre solde est réparti sur trop de petits dépôts pour être dépensé en une seule transaction (max {max_inputs}). Contactez le support pour le consolider.',
|
||||||
'error.withdrawal_to_own_address': "C'est votre propre adresse de dépôt — retirez vers un portefeuille externe.",
|
'error.withdrawal_to_own_address': "C'est votre propre adresse de dépôt — retirez vers un portefeuille externe.",
|
||||||
'error.internal_error': 'Erreur inattendue du serveur. Veuillez réessayer dans un instant.',
|
'error.internal_error': 'Erreur inattendue du serveur. Veuillez réessayer dans un instant.',
|
||||||
'error.guide_unavailable': "Le guide n'est pas disponible pour le moment.",
|
'error.guide_unavailable': "Le guide n'est pas disponible pour le moment.",
|
||||||
@@ -569,6 +653,26 @@ const TRANSLATIONS = {
|
|||||||
'nav.guideTitle': 'Anleitung',
|
'nav.guideTitle': 'Anleitung',
|
||||||
'nav.guideAria': 'Benutzerhandbuch öffnen',
|
'nav.guideAria': 'Benutzerhandbuch öffnen',
|
||||||
'nav.bugReport': 'Fehler melden',
|
'nav.bugReport': 'Fehler melden',
|
||||||
|
'bugReport.pageTitle': 'Fehler melden',
|
||||||
|
'bugReport.heading': 'Fehler melden',
|
||||||
|
'bugReport.intro': 'Ein Problem gefunden? Beschreibe es unten — die Meldung geht direkt an das Admin-Panel.',
|
||||||
|
'bugReport.englishNotice': 'Bitte schreibe die Fehlermeldung auf Englisch, unabhängig von der Sprache, die du gerade verwendest — das hilft uns, sie schneller zu bearbeiten.',
|
||||||
|
'bugReport.descriptionLabel': 'Was ist passiert?',
|
||||||
|
'bugReport.descriptionPlaceholder': 'Beschreibe den Fehler: was du getan hast, was du erwartet hast und was stattdessen passiert ist.',
|
||||||
|
'bugReport.contactLabel': 'Kontakt (optional)',
|
||||||
|
'bugReport.contactPlaceholder': 'E-Mail oder anderer Kontakt, falls du eine Antwort möchtest',
|
||||||
|
'bugReport.submitBtn': 'Meldung senden',
|
||||||
|
'bugReport.submitting': 'Senden…',
|
||||||
|
'bugReport.blankError': 'Beschreibe den Fehler, bevor du sendest.',
|
||||||
|
'bugReport.successToast': 'Danke! Meldung gesendet.',
|
||||||
|
'bugReport.errorPrefix': 'Fehler beim Senden: ',
|
||||||
|
'bugReport.myReportsTitle': 'Deine Meldungen',
|
||||||
|
'bugReport.myReportsHint': 'Nur Meldungen, die von diesem Konto gesendet wurden, mit dem vom Admin-Team aktualisierten Status.',
|
||||||
|
'bugReport.myReportsEmpty': 'Du hast noch keine Meldungen gesendet.',
|
||||||
|
'bugReport.statusOpen': 'Ungelesen',
|
||||||
|
'bugReport.statusRead': 'In Bearbeitung',
|
||||||
|
'bugReport.statusResolved': 'Gelöst',
|
||||||
|
'bugReport.backLink': 'Zurück zur Startseite',
|
||||||
'nav.logoutTitle': 'Abmelden',
|
'nav.logoutTitle': 'Abmelden',
|
||||||
'nav.logoutAria': 'Vom Konto abmelden',
|
'nav.logoutAria': 'Vom Konto abmelden',
|
||||||
'nav.deposit': 'Einzahlung',
|
'nav.deposit': 'Einzahlung',
|
||||||
@@ -691,6 +795,7 @@ const TRANSLATIONS = {
|
|||||||
'error.invalid_amount': 'Gib einen Betrag größer als null ein.',
|
'error.invalid_amount': 'Gib einen Betrag größer als null ein.',
|
||||||
'error.broadcast_failed': 'Das Netzwerk hat die Transaktion abgelehnt. Bitte versuche es in Kürze erneut.',
|
'error.broadcast_failed': 'Das Netzwerk hat die Transaktion abgelehnt. Bitte versuche es in Kürze erneut.',
|
||||||
'error.amount_below_dust_limit': 'Der Betrag ist zu klein, um gesendet zu werden.',
|
'error.amount_below_dust_limit': 'Der Betrag ist zu klein, um gesendet zu werden.',
|
||||||
|
'error.too_many_inputs': 'Ihr Guthaben ist auf zu viele kleine Einzahlungen verteilt, um in einer einzigen Transaktion ausgegeben zu werden (max. {max_inputs}). Bitte wenden Sie sich an den Support, um es zusammenzufassen.',
|
||||||
'error.withdrawal_to_own_address': 'Das ist deine eigene Einzahlungsadresse — zahle auf eine externe Wallet aus.',
|
'error.withdrawal_to_own_address': 'Das ist deine eigene Einzahlungsadresse — zahle auf eine externe Wallet aus.',
|
||||||
'error.internal_error': 'Unerwarteter Serverfehler. Bitte versuche es in Kürze erneut.',
|
'error.internal_error': 'Unerwarteter Serverfehler. Bitte versuche es in Kürze erneut.',
|
||||||
'error.guide_unavailable': 'Die Anleitung ist derzeit nicht verfügbar.',
|
'error.guide_unavailable': 'Die Anleitung ist derzeit nicht verfügbar.',
|
||||||
@@ -708,6 +813,26 @@ const TRANSLATIONS = {
|
|||||||
'nav.guideTitle': 'Инструкция',
|
'nav.guideTitle': 'Инструкция',
|
||||||
'nav.guideAria': 'Открыть руководство пользователя',
|
'nav.guideAria': 'Открыть руководство пользователя',
|
||||||
'nav.bugReport': 'Сообщить об ошибке',
|
'nav.bugReport': 'Сообщить об ошибке',
|
||||||
|
'bugReport.pageTitle': 'Сообщить об ошибке',
|
||||||
|
'bugReport.heading': 'Сообщить об ошибке',
|
||||||
|
'bugReport.intro': 'Нашли проблему? Опишите её ниже — сообщение сразу попадёт в панель администратора.',
|
||||||
|
'bugReport.englishNotice': 'Пожалуйста, опишите ошибку на английском языке, независимо от языка интерфейса — это поможет нам обработать её быстрее.',
|
||||||
|
'bugReport.descriptionLabel': 'Что произошло?',
|
||||||
|
'bugReport.descriptionPlaceholder': 'Опишите ошибку: что вы делали, что ожидали и что произошло вместо этого.',
|
||||||
|
'bugReport.contactLabel': 'Контакт (необязательно)',
|
||||||
|
'bugReport.contactPlaceholder': 'Email или другой контакт, если хотите получить ответ',
|
||||||
|
'bugReport.submitBtn': 'Отправить сообщение',
|
||||||
|
'bugReport.submitting': 'Отправка…',
|
||||||
|
'bugReport.blankError': 'Опишите ошибку перед отправкой.',
|
||||||
|
'bugReport.successToast': 'Спасибо! Сообщение отправлено.',
|
||||||
|
'bugReport.errorPrefix': 'Ошибка отправки: ',
|
||||||
|
'bugReport.myReportsTitle': 'Ваши сообщения',
|
||||||
|
'bugReport.myReportsHint': 'Только сообщения, отправленные с этого аккаунта, со статусом, обновлённым администрацией.',
|
||||||
|
'bugReport.myReportsEmpty': 'Вы ещё не отправляли сообщений.',
|
||||||
|
'bugReport.statusOpen': 'Не прочитано',
|
||||||
|
'bugReport.statusRead': 'В обработке',
|
||||||
|
'bugReport.statusResolved': 'Решено',
|
||||||
|
'bugReport.backLink': 'Назад на главную',
|
||||||
'nav.logoutTitle': 'Выйти',
|
'nav.logoutTitle': 'Выйти',
|
||||||
'nav.logoutAria': 'Выйти из аккаунта',
|
'nav.logoutAria': 'Выйти из аккаунта',
|
||||||
'nav.deposit': 'Депозит',
|
'nav.deposit': 'Депозит',
|
||||||
@@ -830,6 +955,7 @@ const TRANSLATIONS = {
|
|||||||
'error.invalid_amount': 'Введите сумму больше нуля.',
|
'error.invalid_amount': 'Введите сумму больше нуля.',
|
||||||
'error.broadcast_failed': 'Сеть отклонила транзакцию. Попробуйте ещё раз через минуту.',
|
'error.broadcast_failed': 'Сеть отклонила транзакцию. Попробуйте ещё раз через минуту.',
|
||||||
'error.amount_below_dust_limit': 'Сумма слишком мала для отправки.',
|
'error.amount_below_dust_limit': 'Сумма слишком мала для отправки.',
|
||||||
|
'error.too_many_inputs': 'Ваш баланс разбит на слишком много мелких депозитов, чтобы потратить его одной транзакцией (максимум {max_inputs}). Обратитесь в поддержку для консолидации.',
|
||||||
'error.withdrawal_to_own_address': 'Это ваш собственный адрес для депозита — выводите на внешний кошелёк.',
|
'error.withdrawal_to_own_address': 'Это ваш собственный адрес для депозита — выводите на внешний кошелёк.',
|
||||||
'error.internal_error': 'Непредвиденная ошибка сервера. Попробуйте ещё раз через минуту.',
|
'error.internal_error': 'Непредвиденная ошибка сервера. Попробуйте ещё раз через минуту.',
|
||||||
'error.guide_unavailable': 'Руководство сейчас недоступно.',
|
'error.guide_unavailable': 'Руководство сейчас недоступно.',
|
||||||
@@ -847,6 +973,26 @@ const TRANSLATIONS = {
|
|||||||
'nav.guideTitle': '指南',
|
'nav.guideTitle': '指南',
|
||||||
'nav.guideAria': '打开用户指南',
|
'nav.guideAria': '打开用户指南',
|
||||||
'nav.bugReport': '报告问题',
|
'nav.bugReport': '报告问题',
|
||||||
|
'bugReport.pageTitle': '报告问题',
|
||||||
|
'bugReport.heading': '报告问题',
|
||||||
|
'bugReport.intro': '发现问题了吗?请在下面描述——您的反馈会直接发送到管理员面板。',
|
||||||
|
'bugReport.englishNotice': '请用英文描述问题,无论您当前使用的是哪种语言界面——这有助于我们更快处理。',
|
||||||
|
'bugReport.descriptionLabel': '发生了什么?',
|
||||||
|
'bugReport.descriptionPlaceholder': '描述问题:您当时在做什么、期望的结果是什么,以及实际发生了什么。',
|
||||||
|
'bugReport.contactLabel': '联系方式(可选)',
|
||||||
|
'bugReport.contactPlaceholder': '如果希望得到回复,请留下邮箱或其他联系方式',
|
||||||
|
'bugReport.submitBtn': '发送反馈',
|
||||||
|
'bugReport.submitting': '发送中…',
|
||||||
|
'bugReport.blankError': '请先描述问题再发送。',
|
||||||
|
'bugReport.successToast': '谢谢!反馈已发送。',
|
||||||
|
'bugReport.errorPrefix': '发送出错:',
|
||||||
|
'bugReport.myReportsTitle': '您的反馈',
|
||||||
|
'bugReport.myReportsHint': '仅显示此账户发送的反馈,状态由管理团队更新。',
|
||||||
|
'bugReport.myReportsEmpty': '您还没有发送过反馈。',
|
||||||
|
'bugReport.statusOpen': '待处理',
|
||||||
|
'bugReport.statusRead': '处理中',
|
||||||
|
'bugReport.statusResolved': '已解决',
|
||||||
|
'bugReport.backLink': '返回首页',
|
||||||
'nav.logoutTitle': '退出登录',
|
'nav.logoutTitle': '退出登录',
|
||||||
'nav.logoutAria': '退出账户',
|
'nav.logoutAria': '退出账户',
|
||||||
'nav.deposit': '存款',
|
'nav.deposit': '存款',
|
||||||
@@ -969,6 +1115,7 @@ const TRANSLATIONS = {
|
|||||||
'error.invalid_amount': '请输入大于零的金额。',
|
'error.invalid_amount': '请输入大于零的金额。',
|
||||||
'error.broadcast_failed': '网络拒绝了该交易,请稍后重试。',
|
'error.broadcast_failed': '网络拒绝了该交易,请稍后重试。',
|
||||||
'error.amount_below_dust_limit': '金额过小,无法发送。',
|
'error.amount_below_dust_limit': '金额过小,无法发送。',
|
||||||
|
'error.too_many_inputs': '您的余额分散在过多的小额存款中,无法在一笔交易中花费(最多 {max_inputs} 笔)。请联系客服进行归集。',
|
||||||
'error.withdrawal_to_own_address': '这是你自己的充值地址 — 请提现到外部钱包。',
|
'error.withdrawal_to_own_address': '这是你自己的充值地址 — 请提现到外部钱包。',
|
||||||
'error.internal_error': '服务器发生意外错误,请稍后重试。',
|
'error.internal_error': '服务器发生意外错误,请稍后重试。',
|
||||||
'error.guide_unavailable': '指南当前不可用。',
|
'error.guide_unavailable': '指南当前不可用。',
|
||||||
|
|||||||
+159
-6
@@ -1,16 +1,169 @@
|
|||||||
<!DOCTYPE html>
|
<!DOCTYPE html>
|
||||||
<html lang="it">
|
<html lang="en">
|
||||||
<head>
|
<head>
|
||||||
<meta charset="UTF-8">
|
<meta charset="UTF-8">
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
<title>Segnala un bug — PLM Lottery</title>
|
<title data-i18n="bugReport.pageTitle">Report a bug</title>
|
||||||
|
<link rel="icon" type="image/svg+xml" href="/logo.svg">
|
||||||
<link rel="stylesheet" href="/style.css">
|
<link rel="stylesheet" href="/style.css">
|
||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
<div class="app-shell">
|
<div class="app-shell app-shell-bugreport">
|
||||||
<h1>Segnala un bug</h1>
|
|
||||||
<p>Questa pagina è un placeholder. Il modulo per la segnalazione dei bug sarà disponibile qui a breve.</p>
|
<div class="bugreport-topbar">
|
||||||
<p><a class="link" href="/">← Torna alla home</a></p>
|
<a class="brand" href="/">
|
||||||
|
<img class="brand-mark" src="/logo.svg" alt="">
|
||||||
|
PLM Lottery
|
||||||
|
</a>
|
||||||
|
<div class="bugreport-topbar-right">
|
||||||
|
<a class="back-home-btn" href="/">
|
||||||
|
<svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="19" y1="12" x2="5" y2="12"/><polyline points="12 19 5 12 12 5"/></svg>
|
||||||
|
<span data-i18n="bugReport.backLink">Back to home</span>
|
||||||
|
</a>
|
||||||
|
<select id="lang-switcher" class="lang-switcher" onchange="setLanguage(this.value)" aria-label="Language">
|
||||||
|
<option value="en">English</option>
|
||||||
|
<option value="it">Italiano</option>
|
||||||
|
<option value="es">Español</option>
|
||||||
|
<option value="fr">Français</option>
|
||||||
|
<option value="de">Deutsch</option>
|
||||||
|
<option value="ru">Русский</option>
|
||||||
|
<option value="zh">中文</option>
|
||||||
|
</select>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="bugreport-hero">
|
||||||
|
<div class="bugreport-hero-icon">
|
||||||
|
<svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M12 8v5"/><path d="M12 16h.01"/></svg>
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<h1 data-i18n="bugReport.heading">Report a bug</h1>
|
||||||
|
<p data-i18n="bugReport.intro">Found a problem? Describe it below — your report goes straight to the admin panel.</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="card" id="report-form">
|
||||||
|
<div class="field-note" id="english-notice">
|
||||||
|
<svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="2" y1="12" x2="22" y2="12"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg>
|
||||||
|
<span data-i18n="bugReport.englishNotice">Please write your bug report in English, regardless of the language you're browsing in — this helps us handle it faster.</span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<label for="bug-description" data-i18n="bugReport.descriptionLabel">What happened?</label>
|
||||||
|
<textarea id="bug-description" rows="6" maxlength="2000" data-i18n-placeholder="bugReport.descriptionPlaceholder" oninput="updateCharCount()"></textarea>
|
||||||
|
<div class="char-count" id="char-count">0 / 2000</div>
|
||||||
|
|
||||||
|
<label for="bug-contact" data-i18n="bugReport.contactLabel">Contact (optional)</label>
|
||||||
|
<input id="bug-contact" type="text" maxlength="256" data-i18n-placeholder="bugReport.contactPlaceholder">
|
||||||
|
|
||||||
|
<button onclick="submitBugReport()" id="bug-submit-btn" data-i18n="bugReport.submitBtn">Send report</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="hidden" id="my-reports-section">
|
||||||
|
<p class="section-label" data-i18n="bugReport.myReportsTitle">Your reports</p>
|
||||||
|
<div class="card">
|
||||||
|
<p class="hint" data-i18n="bugReport.myReportsHint">Only reports sent from this account, with the status set by the admin team.</p>
|
||||||
|
<div id="my-reports-list"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<div id="toast-container" aria-live="polite"></div>
|
||||||
|
|
||||||
|
<script src="/i18n.js"></script>
|
||||||
|
<script>
|
||||||
|
function toast(message, type) {
|
||||||
|
const container = document.getElementById('toast-container');
|
||||||
|
const el = document.createElement('div');
|
||||||
|
el.className = 'toast ' + type;
|
||||||
|
el.textContent = message;
|
||||||
|
container.appendChild(el);
|
||||||
|
setTimeout(() => el.remove(), 4000);
|
||||||
|
}
|
||||||
|
|
||||||
|
function escapeHtml(s) {
|
||||||
|
return String(s).replace(/[&<>"']/g, (c) => ({ '&': '&', '<': '<', '>': '>', '"': '"', "'": ''' }[c]));
|
||||||
|
}
|
||||||
|
|
||||||
|
function updateCharCount() {
|
||||||
|
const field = document.getElementById('bug-description');
|
||||||
|
document.getElementById('char-count').textContent = field.value.length + ' / ' + field.maxLength;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function submitBugReport() {
|
||||||
|
const btn = document.getElementById('bug-submit-btn');
|
||||||
|
const description = document.getElementById('bug-description').value.trim();
|
||||||
|
const contact = document.getElementById('bug-contact').value.trim();
|
||||||
|
if (!description) {
|
||||||
|
toast(t('bugReport.blankError'), 'error');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const headers = { 'Content-Type': 'application/json' };
|
||||||
|
const token = localStorage.getItem('plm_token');
|
||||||
|
if (token) headers['Authorization'] = 'Bearer ' + token;
|
||||||
|
|
||||||
|
btn.disabled = true;
|
||||||
|
const original = btn.textContent;
|
||||||
|
btn.textContent = t('bugReport.submitting');
|
||||||
|
try {
|
||||||
|
const res = await fetch('/bug-reports', {
|
||||||
|
method: 'POST',
|
||||||
|
headers,
|
||||||
|
body: JSON.stringify({ description, contact: contact || null }),
|
||||||
|
});
|
||||||
|
const data = await res.json().catch(() => ({}));
|
||||||
|
if (!res.ok) throw new Error(data.detail?.message || data.detail || res.statusText);
|
||||||
|
document.getElementById('bug-description').value = '';
|
||||||
|
document.getElementById('bug-contact').value = '';
|
||||||
|
updateCharCount();
|
||||||
|
toast(t('bugReport.successToast'), 'success');
|
||||||
|
loadMyBugReports();
|
||||||
|
} catch (e) {
|
||||||
|
toast(t('bugReport.errorPrefix') + e.message, 'error');
|
||||||
|
} finally {
|
||||||
|
btn.disabled = false;
|
||||||
|
btn.textContent = original;
|
||||||
|
applyStaticTranslations(btn);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function loadMyBugReports() {
|
||||||
|
const token = localStorage.getItem('plm_token');
|
||||||
|
const section = document.getElementById('my-reports-section');
|
||||||
|
if (!token) {
|
||||||
|
section.classList.add('hidden');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
const res = await fetch('/bug-reports/mine', { headers: { Authorization: 'Bearer ' + token } });
|
||||||
|
if (!res.ok) {
|
||||||
|
section.classList.add('hidden');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
const reports = await res.json();
|
||||||
|
section.classList.remove('hidden');
|
||||||
|
const list = document.getElementById('my-reports-list');
|
||||||
|
list.innerHTML = reports.map((r) => `
|
||||||
|
<div class="report-row">
|
||||||
|
<span class="badge bug-status-${escapeHtml(r.status)}">${escapeHtml(t('bugReport.status' + r.status.charAt(0).toUpperCase() + r.status.slice(1)))}</span>
|
||||||
|
<span class="report-row-desc" title="${escapeHtml(r.description)}">${escapeHtml(r.description)}</span>
|
||||||
|
<span class="report-row-date">${new Date(r.created_at).toLocaleDateString(currentDateLocale(), { day: 'numeric', month: 'short', year: 'numeric' })}</span>
|
||||||
|
</div>
|
||||||
|
`).join('') || `<p class="hint report-empty">${escapeHtml(t('bugReport.myReportsEmpty'))}</p>`;
|
||||||
|
} catch (e) {
|
||||||
|
section.classList.add('hidden');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Re-renders server-rendered content (my reports list) on a language switch,
|
||||||
|
// the same split app.js uses between data-i18n (static markup) and t() (data).
|
||||||
|
function onLanguageChange() {
|
||||||
|
loadMyBugReports();
|
||||||
|
}
|
||||||
|
|
||||||
|
updateCharCount();
|
||||||
|
loadMyBugReports();
|
||||||
|
</script>
|
||||||
</body>
|
</body>
|
||||||
</html>
|
</html>
|
||||||
+91
-3
@@ -74,16 +74,17 @@ h1, h2, h3 { font-family: inherit; letter-spacing: -0.01em; }
|
|||||||
label { display: block; font-size: 0.85rem; font-weight: 500; color: var(--color-muted-foreground); margin-top: 14px; margin-bottom: 6px; }
|
label { display: block; font-size: 0.85rem; font-weight: 500; color: var(--color-muted-foreground); margin-top: 14px; margin-bottom: 6px; }
|
||||||
label:first-child { margin-top: 0; }
|
label:first-child { margin-top: 0; }
|
||||||
|
|
||||||
input {
|
input, textarea {
|
||||||
width: 100%; min-height: 44px; padding: 10px 12px; font-size: 0.95rem; font-family: inherit;
|
width: 100%; min-height: 44px; padding: 10px 12px; font-size: 0.95rem; font-family: inherit;
|
||||||
border: 1px solid var(--color-border); border-radius: var(--radius-sm); background: var(--color-surface);
|
border: 1px solid var(--color-border); border-radius: var(--radius-sm); background: var(--color-surface);
|
||||||
color: var(--color-foreground); transition: border-color 150ms, box-shadow 150ms;
|
color: var(--color-foreground); transition: border-color 150ms, box-shadow 150ms;
|
||||||
}
|
}
|
||||||
input:focus {
|
textarea { resize: vertical; }
|
||||||
|
input:focus, textarea:focus {
|
||||||
outline: none; border-color: var(--color-ring);
|
outline: none; border-color: var(--color-ring);
|
||||||
box-shadow: 0 0 0 3px color-mix(in srgb, var(--color-ring) 25%, transparent);
|
box-shadow: 0 0 0 3px color-mix(in srgb, var(--color-ring) 25%, transparent);
|
||||||
}
|
}
|
||||||
input:disabled { background: var(--color-surface-inset); color: var(--color-muted-foreground); }
|
input:disabled, textarea:disabled { background: var(--color-surface-inset); color: var(--color-muted-foreground); }
|
||||||
|
|
||||||
button {
|
button {
|
||||||
display: inline-flex; align-items: center; justify-content: center; gap: 6px;
|
display: inline-flex; align-items: center; justify-content: center; gap: 6px;
|
||||||
@@ -253,6 +254,93 @@ button.link:hover, a.link:hover { filter: none; color: var(--color-foreground);
|
|||||||
.toast.error { background: var(--color-destructive-bg); color: var(--color-destructive); }
|
.toast.error { background: var(--color-destructive-bg); color: var(--color-destructive); }
|
||||||
@keyframes toast-in { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }
|
@keyframes toast-in { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }
|
||||||
|
|
||||||
|
/* --- /report-bug: a standalone page (no logged-in navbar), so it gets its
|
||||||
|
own slim top bar rather than the app's bottom tab bar / sticky header. --- */
|
||||||
|
.app-shell-bugreport { padding-bottom: 32px; }
|
||||||
|
|
||||||
|
.bugreport-topbar {
|
||||||
|
display: flex; align-items: center; justify-content: space-between; gap: 12px;
|
||||||
|
padding: 4px 0 20px; margin-bottom: 20px; border-bottom: 1px solid var(--color-border);
|
||||||
|
}
|
||||||
|
.bugreport-topbar .brand {
|
||||||
|
display: flex; align-items: center; gap: 8px; font-weight: 700; font-size: 1rem;
|
||||||
|
letter-spacing: -0.01em; color: var(--color-foreground); text-decoration: none;
|
||||||
|
}
|
||||||
|
.bugreport-topbar .brand-mark { width: 26px; height: 26px; border-radius: 50%; flex-shrink: 0; display: block; }
|
||||||
|
.bugreport-topbar-right { display: flex; align-items: center; gap: 12px; }
|
||||||
|
|
||||||
|
/* Pill button, same idiom as .trust-pill / .chain-status-pill elsewhere on the
|
||||||
|
site: a bordered chip rather than a bare text link, so "go back" reads as an
|
||||||
|
actual control instead of fading into the surrounding copy. */
|
||||||
|
.back-home-btn {
|
||||||
|
display: inline-flex; align-items: center; gap: 6px;
|
||||||
|
font-size: 0.8rem; font-weight: 500; color: var(--color-muted-foreground);
|
||||||
|
background: var(--color-surface); border: 1px solid var(--color-border);
|
||||||
|
padding: 6px 12px 6px 10px; border-radius: 999px; text-decoration: none;
|
||||||
|
transition: color 150ms, border-color 150ms, background 150ms;
|
||||||
|
}
|
||||||
|
.back-home-btn .icon { width: 15px; height: 15px; }
|
||||||
|
.back-home-btn:hover {
|
||||||
|
color: var(--color-foreground); background: var(--color-surface-inset);
|
||||||
|
border-color: color-mix(in srgb, var(--color-ring) 40%, var(--color-border));
|
||||||
|
}
|
||||||
|
.back-home-btn:focus-visible { outline: 2px solid var(--color-ring); outline-offset: 2px; }
|
||||||
|
|
||||||
|
.bugreport-hero { display: flex; align-items: flex-start; gap: 14px; margin-bottom: 20px; }
|
||||||
|
.bugreport-hero-icon {
|
||||||
|
width: 44px; height: 44px; flex-shrink: 0; border-radius: 999px;
|
||||||
|
background: color-mix(in srgb, var(--color-primary) 14%, transparent);
|
||||||
|
color: var(--color-primary);
|
||||||
|
display: flex; align-items: center; justify-content: center;
|
||||||
|
}
|
||||||
|
.bugreport-hero-icon .icon { width: 22px; height: 22px; }
|
||||||
|
.bugreport-hero h1 { font-size: 1.3rem; font-weight: 700; margin: 2px 0 4px; text-wrap: balance; }
|
||||||
|
.bugreport-hero p { color: var(--color-muted-foreground); font-size: 0.9rem; margin: 0; max-width: 46ch; }
|
||||||
|
|
||||||
|
/* Info callout, anchored inside the form card right above the field it
|
||||||
|
applies to — not a warning (that's what the amber status badges below are
|
||||||
|
for), so it gets the accent hue instead, keeping the two meanings visually
|
||||||
|
distinct. */
|
||||||
|
.field-note {
|
||||||
|
display: flex; align-items: flex-start; gap: 10px;
|
||||||
|
background: color-mix(in srgb, var(--color-accent) 10%, transparent);
|
||||||
|
border: 1px solid color-mix(in srgb, var(--color-accent) 28%, transparent);
|
||||||
|
color: color-mix(in srgb, var(--color-accent) 75%, var(--color-foreground));
|
||||||
|
border-radius: var(--radius-sm); padding: 10px 12px; font-size: 0.82rem; line-height: 1.4;
|
||||||
|
margin-bottom: 16px;
|
||||||
|
}
|
||||||
|
.field-note .icon { width: 16px; height: 16px; margin-top: 1px; flex-shrink: 0; }
|
||||||
|
|
||||||
|
.char-count {
|
||||||
|
font-variant-numeric: tabular-nums; text-align: right;
|
||||||
|
font-size: 0.75rem; color: var(--color-muted-foreground); margin-top: 4px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.badge {
|
||||||
|
display: inline-block; font-size: 0.72rem; font-weight: 600; padding: 2px 8px;
|
||||||
|
border-radius: 999px; background: var(--color-background); border: 1px solid var(--color-border);
|
||||||
|
flex-shrink: 0;
|
||||||
|
}
|
||||||
|
.badge.bug-status-open { background: color-mix(in srgb, var(--color-primary) 16%, transparent); color: #92400E; border-color: color-mix(in srgb, var(--color-primary) 55%, transparent); }
|
||||||
|
.badge.bug-status-read { background: var(--color-background); color: var(--color-muted-foreground); }
|
||||||
|
.badge.bug-status-resolved { background: var(--color-success-bg); color: var(--color-success); border-color: var(--color-success); }
|
||||||
|
|
||||||
|
.report-row {
|
||||||
|
display: flex; flex-wrap: wrap; align-items: center; gap: 10px;
|
||||||
|
padding: 12px 0; border-bottom: 1px solid var(--color-border);
|
||||||
|
}
|
||||||
|
.report-row:first-child { padding-top: 0; }
|
||||||
|
.report-row:last-child { padding-bottom: 0; border-bottom: none; }
|
||||||
|
.report-row-desc {
|
||||||
|
flex: 1 1 200px; font-size: 0.88rem;
|
||||||
|
overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
|
||||||
|
}
|
||||||
|
.report-row-date {
|
||||||
|
font-size: 0.78rem; color: var(--color-muted-foreground); white-space: nowrap;
|
||||||
|
font-variant-numeric: tabular-nums;
|
||||||
|
}
|
||||||
|
.report-empty { margin: 0; }
|
||||||
|
|
||||||
/* --- landing hero (shown only when logged out) --- */
|
/* --- landing hero (shown only when logged out) --- */
|
||||||
body {
|
body {
|
||||||
position: relative;
|
position: relative;
|
||||||
|
|||||||
+78
-50
@@ -48,14 +48,14 @@ def should_bump(pending: PendingTransaction, now: datetime, timeout_seconds: int
|
|||||||
return now >= pending.last_broadcast_at.replace(tzinfo=timezone.utc) + timedelta(seconds=timeout_seconds)
|
return now >= pending.last_broadcast_at.replace(tzinfo=timezone.utc) + timedelta(seconds=timeout_seconds)
|
||||||
|
|
||||||
|
|
||||||
async def _signing_context(session: AsyncSession, pending: PendingTransaction) -> tuple:
|
async def _signing_context(session: AsyncSession, kind: str, user_id: int | None) -> tuple:
|
||||||
"""Returns (signing_key, own_script, own_address) for the single sender that
|
"""Returns (signing_key, own_script, own_address) for the single sender that
|
||||||
controls every input of this tx — a user for bet/withdrawal, the pool for
|
controls every input of this tx — a user for bet/withdrawal, the pool for
|
||||||
payout. All our builders only ever spend one address's UTXOs per tx."""
|
payout. All our builders only ever spend one address's UTXOs per tx."""
|
||||||
if pending.kind == "payout":
|
if kind == "payout":
|
||||||
key = derive_pool_key()
|
key = derive_pool_key()
|
||||||
else:
|
else:
|
||||||
user = await session.get(User, pending.user_id)
|
user = await session.get(User, user_id)
|
||||||
key = derive_user_key(user.derivation_index)
|
key = derive_user_key(user.derivation_index)
|
||||||
own_script = script.p2wpkh(key.to_public())
|
own_script = script.p2wpkh(key.to_public())
|
||||||
own_address = own_script.address(network=PLM_MAINNET)
|
own_address = own_script.address(network=PLM_MAINNET)
|
||||||
@@ -63,10 +63,19 @@ async def _signing_context(session: AsyncSession, pending: PendingTransaction) -
|
|||||||
|
|
||||||
|
|
||||||
async def _prevout_amount(client: ElectrumClient, vin: TransactionInput) -> int:
|
async def _prevout_amount(client: ElectrumClient, vin: TransactionInput) -> int:
|
||||||
|
"""The exact integer satoshi value of the output this input spends.
|
||||||
|
|
||||||
|
Parsed directly from the raw transaction via embit rather than asking the
|
||||||
|
server for its own float, whole-coin-denominated "value" field (verbose=True)
|
||||||
|
and converting with `* 100_000_000` — embit's TransactionOutput.value is
|
||||||
|
already an integer number of satoshis straight from the tx's binary
|
||||||
|
encoding, so this never touches floating point in a codebase that is
|
||||||
|
otherwise strictly integer-satoshi (B-40).
|
||||||
|
"""
|
||||||
txid_hex = vin.txid.hex()
|
txid_hex = vin.txid.hex()
|
||||||
tx = await client.get_transaction(txid_hex, verbose=True)
|
raw_hex = await client.get_transaction(txid_hex, verbose=False)
|
||||||
value_coins = tx["vout"][vin.vout]["value"]
|
prevout_tx = Transaction.parse(bytes.fromhex(raw_hex))
|
||||||
return round(value_coins * 100_000_000)
|
return prevout_tx.vout[vin.vout].value
|
||||||
|
|
||||||
|
|
||||||
def _find_change_output(tx: Transaction, change_address: str) -> int | None:
|
def _find_change_output(tx: Transaction, change_address: str) -> int | None:
|
||||||
@@ -76,35 +85,55 @@ def _find_change_output(tx: Transaction, change_address: str) -> int | None:
|
|||||||
return None
|
return None
|
||||||
|
|
||||||
|
|
||||||
async def bump_fee(session: AsyncSession, client: ElectrumClient, pending: PendingTransaction) -> str:
|
async def bump_fee(
|
||||||
"""Rebuild `pending`'s transaction with a higher fee (same inputs, same
|
session_factory: async_sessionmaker, client: ElectrumClient, pending_id: int
|
||||||
recipient outputs, the extra fee taken from the change output) and
|
) -> str | None:
|
||||||
rebroadcast. Returns the new txid.
|
"""Rebuild pending_transaction `pending_id`'s transaction with a higher fee
|
||||||
|
(same inputs, same recipient outputs, the extra fee taken from the change
|
||||||
|
output) and rebroadcast. Returns the new txid, or None if there was nothing
|
||||||
|
to do (the row is gone or already left "pending" — a normal race with
|
||||||
|
confirmation, not an error).
|
||||||
|
|
||||||
|
Three phases, so no DB session is held across the network calls this needs
|
||||||
|
(one get_transaction per input, then a broadcast) — the same shape used
|
||||||
|
elsewhere for exactly this reason (B-18, rounds/scheduler.py:_trigger_payout;
|
||||||
|
B-31, electrum/listener.py:refresh_user) and now here too (B-40): read what's
|
||||||
|
needed and close the session, do the chain work, then reopen to persist.
|
||||||
|
|
||||||
Only handles the common case: exactly one change output paying back to the
|
Only handles the common case: exactly one change output paying back to the
|
||||||
tx's own sender address, large enough to absorb the increase. If there's no
|
tx's own sender address, large enough to absorb the increase. If there's no
|
||||||
such output (e.g. an exact-amount bet with no change), this raises RbfError —
|
such output (e.g. an exact-amount bet with no change), this raises RbfError —
|
||||||
bumping such a tx would require selecting additional inputs, which isn't
|
bumping such a tx would require selecting additional inputs, which isn't
|
||||||
implemented for the MVP; it needs manual operator intervention. Also raises
|
implemented for the MVP; it needs manual operator intervention. Also raises
|
||||||
RbfError, rather than bumping, once `pending` is already at MAX_FEE_RATE_SAT_VB
|
RbfError, rather than bumping, once the row is already at MAX_FEE_RATE_SAT_VB
|
||||||
(B-32) — the reconciler abandons it if it never confirms (B-27), instead of
|
(B-32) — the reconciler abandons it if it never confirms (B-27), instead of
|
||||||
this retrying an ever-higher fee forever.
|
this retrying an ever-higher fee forever.
|
||||||
"""
|
"""
|
||||||
if pending.fee_rate_sat_vb >= MAX_FEE_RATE_SAT_VB:
|
# --- Phase 1: read what's needed, close the session before any network call ---
|
||||||
raise RbfError(
|
async with session_factory() as session:
|
||||||
f"pending_transaction {pending.id}: already at the maximum fee rate "
|
pending = await session.get(PendingTransaction, pending_id)
|
||||||
f"({MAX_FEE_RATE_SAT_VB} sat/vB) — refusing to bump further"
|
if pending is None or pending.status != "pending":
|
||||||
)
|
logger.info("pending_transaction %s no longer pending; skipping bump", pending_id)
|
||||||
|
return None
|
||||||
|
if pending.fee_rate_sat_vb >= MAX_FEE_RATE_SAT_VB:
|
||||||
|
raise RbfError(
|
||||||
|
f"pending_transaction {pending_id}: already at the maximum fee rate "
|
||||||
|
f"({MAX_FEE_RATE_SAT_VB} sat/vB) — refusing to bump further"
|
||||||
|
)
|
||||||
|
|
||||||
old_tx = Transaction.parse(bytes.fromhex(pending.raw_tx_hex))
|
kind = pending.kind
|
||||||
signing_key, own_script, own_address = await _signing_context(session, pending)
|
current_fee_rate = pending.fee_rate_sat_vb
|
||||||
|
raw_tx_hex = pending.raw_tx_hex
|
||||||
|
signing_key, own_script, own_address = await _signing_context(session, kind, pending.user_id)
|
||||||
|
|
||||||
|
# --- Phase 2: chain reads, signing, and the broadcast — no DB session open ----
|
||||||
|
old_tx = Transaction.parse(bytes.fromhex(raw_tx_hex))
|
||||||
input_amounts = [await _prevout_amount(client, vin) for vin in old_tx.vin]
|
input_amounts = [await _prevout_amount(client, vin) for vin in old_tx.vin]
|
||||||
total_in = sum(input_amounts)
|
total_in = sum(input_amounts)
|
||||||
old_fee = total_in - sum(o.value for o in old_tx.vout)
|
old_fee = total_in - sum(o.value for o in old_tx.vout)
|
||||||
vsize = estimate_vsize(len(old_tx.vin), len(old_tx.vout))
|
vsize = estimate_vsize(len(old_tx.vin), len(old_tx.vout))
|
||||||
|
|
||||||
target_fee_rate = min(pending.fee_rate_sat_vb + _FEE_RATE_INCREMENT, MAX_FEE_RATE_SAT_VB)
|
target_fee_rate = min(current_fee_rate + _FEE_RATE_INCREMENT, MAX_FEE_RATE_SAT_VB)
|
||||||
target_fee = vsize * target_fee_rate
|
target_fee = vsize * target_fee_rate
|
||||||
# BIP125 rule 4's minimum, in absolute sats for this tx's size — the floor
|
# BIP125 rule 4's minimum, in absolute sats for this tx's size — the floor
|
||||||
# `fee_delta` must never go below, no matter what `target_fee - old_fee` comes
|
# `fee_delta` must never go below, no matter what `target_fee - old_fee` comes
|
||||||
@@ -120,7 +149,7 @@ async def bump_fee(session: AsyncSession, client: ElectrumClient, pending: Pendi
|
|||||||
|
|
||||||
change_index = _find_change_output(old_tx, own_address)
|
change_index = _find_change_output(old_tx, own_address)
|
||||||
if change_index is None or old_tx.vout[change_index].value <= fee_delta:
|
if change_index is None or old_tx.vout[change_index].value <= fee_delta:
|
||||||
raise RbfError(f"pending_transaction {pending.id}: no change output large enough to absorb a fee bump")
|
raise RbfError(f"pending_transaction {pending_id}: no change output large enough to absorb a fee bump")
|
||||||
|
|
||||||
new_vout = list(old_tx.vout)
|
new_vout = list(old_tx.vout)
|
||||||
bumped_change = new_vout[change_index].value - fee_delta
|
bumped_change = new_vout[change_index].value - fee_delta
|
||||||
@@ -144,25 +173,28 @@ async def bump_fee(session: AsyncSession, client: ElectrumClient, pending: Pendi
|
|||||||
new_txid = final_tx.txid().hex()
|
new_txid = final_tx.txid().hex()
|
||||||
await client.broadcast(raw_hex)
|
await client.broadcast(raw_hex)
|
||||||
|
|
||||||
old_txid = pending.current_txid
|
# --- Phase 3: persist the outcome ----------------------------------------------
|
||||||
pending.replaced_by_txid = old_txid # points backwards: what current_txid replaced
|
async with session_factory() as session:
|
||||||
pending.current_txid = new_txid
|
pending = await session.get(PendingTransaction, pending_id)
|
||||||
pending.raw_tx_hex = raw_hex
|
old_txid = pending.current_txid
|
||||||
# The *actual* resulting rate, not target_fee_rate: when the BIP125-minimum
|
pending.replaced_by_txid = old_txid # points backwards: what current_txid replaced
|
||||||
# floor above raised fee_delta past the naive target, the tx now pays more
|
pending.current_txid = new_txid
|
||||||
# than target_fee_rate implied. Recording the true rate keeps the next bump's
|
pending.raw_tx_hex = raw_hex
|
||||||
# arithmetic honest instead of drifting from what's really being paid.
|
# The *actual* resulting rate, not target_fee_rate: when the BIP125-minimum
|
||||||
pending.fee_rate_sat_vb = (old_fee + fee_delta) // vsize
|
# floor above raised fee_delta past the naive target, the tx now pays more
|
||||||
pending.attempt_count += 1
|
# than target_fee_rate implied. Recording the true rate keeps the next bump's
|
||||||
# last_broadcast_at, not broadcast_at (B-27): broadcast_at must stay the *first*
|
# arithmetic honest instead of drifting from what's really being paid.
|
||||||
# broadcast, since reconcile.py's abandon-after-N-hours grace period is measured
|
pending.fee_rate_sat_vb = (old_fee + fee_delta) // vsize
|
||||||
# from it — overwriting it here used to reset that clock on every bump, so a
|
pending.attempt_count += 1
|
||||||
# repeatedly-bumped-but-never-mined tx was never abandoned.
|
# last_broadcast_at, not broadcast_at (B-27): broadcast_at must stay the *first*
|
||||||
pending.last_broadcast_at = datetime.now(timezone.utc)
|
# broadcast, since reconcile.py's abandon-after-N-hours grace period is measured
|
||||||
await _retarget_txid_references(session, pending, old_txid, new_txid)
|
# from it — overwriting it here used to reset that clock on every bump, so a
|
||||||
await session.commit()
|
# repeatedly-bumped-but-never-mined tx was never abandoned.
|
||||||
|
pending.last_broadcast_at = datetime.now(timezone.utc)
|
||||||
|
await _retarget_txid_references(session, pending, old_txid, new_txid)
|
||||||
|
await session.commit()
|
||||||
|
|
||||||
logger.info("bumped %s pending_transaction %s: %s -> %s", pending.kind, pending.id, old_txid, new_txid)
|
logger.info("bumped %s pending_transaction %s: %s -> %s", kind, pending_id, old_txid, new_txid)
|
||||||
return new_txid
|
return new_txid
|
||||||
|
|
||||||
|
|
||||||
@@ -230,16 +262,12 @@ class RbfBumper:
|
|||||||
candidates = (
|
candidates = (
|
||||||
await session.scalars(select(PendingTransaction).where(PendingTransaction.status == "pending"))
|
await session.scalars(select(PendingTransaction).where(PendingTransaction.status == "pending"))
|
||||||
).all()
|
).all()
|
||||||
due = [p for p in candidates if should_bump(p, now, timeout_seconds=timeout_seconds)]
|
due_ids = [p.id for p in candidates if should_bump(p, now, timeout_seconds=timeout_seconds)]
|
||||||
|
|
||||||
for pending in due:
|
for pending_id in due_ids:
|
||||||
async with self._session_factory() as session:
|
try:
|
||||||
row = await session.get(PendingTransaction, pending.id)
|
await bump_fee(self._session_factory, client, pending_id)
|
||||||
if row is None or row.status != "pending":
|
except RbfError:
|
||||||
continue
|
logger.exception("could not bump pending_transaction %s", pending_id)
|
||||||
try:
|
except Exception:
|
||||||
await bump_fee(session, client, row)
|
logger.exception("unexpected error bumping pending_transaction %s", pending_id)
|
||||||
except RbfError:
|
|
||||||
logger.exception("could not bump pending_transaction %s", row.id)
|
|
||||||
except Exception:
|
|
||||||
logger.exception("unexpected error bumping pending_transaction %s", row.id)
|
|
||||||
+39
-9
@@ -7,7 +7,9 @@ from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
|
|||||||
|
|
||||||
from app.db.models import PendingTransaction
|
from app.db.models import PendingTransaction
|
||||||
from app.electrum.client import ElectrumClient
|
from app.electrum.client import ElectrumClient
|
||||||
|
from app.electrum.scripthash import address_to_scripthash
|
||||||
from app.rounds.events import broadcaster
|
from app.rounds.events import broadcaster
|
||||||
|
from app.tx.pending_address import own_address_for
|
||||||
|
|
||||||
logger = logging.getLogger(__name__)
|
logger = logging.getLogger(__name__)
|
||||||
|
|
||||||
@@ -31,24 +33,52 @@ async def poll_once(session_factory: async_sessionmaker, client: ElectrumClient)
|
|||||||
candidates = (
|
candidates = (
|
||||||
await session.execute(
|
await session.execute(
|
||||||
select(
|
select(
|
||||||
PendingTransaction.id, PendingTransaction.current_txid, PendingTransaction.kind
|
PendingTransaction.id,
|
||||||
|
PendingTransaction.current_txid,
|
||||||
|
PendingTransaction.kind,
|
||||||
|
PendingTransaction.user_id,
|
||||||
).where(PendingTransaction.status == "pending")
|
).where(PendingTransaction.status == "pending")
|
||||||
)
|
)
|
||||||
).all()
|
).all()
|
||||||
|
|
||||||
|
# Resolved once per candidate while the session is still open, and cached
|
||||||
|
# by scripthash below — every "payout" row shares the same pool address,
|
||||||
|
# so this also avoids asking the server the same history twice per tick.
|
||||||
|
scripthash_by_id: dict[int, str] = {}
|
||||||
|
for pending_id, _txid, kind, user_id in candidates:
|
||||||
|
try:
|
||||||
|
address = await own_address_for(session, kind, user_id)
|
||||||
|
scripthash_by_id[pending_id] = address_to_scripthash(address)
|
||||||
|
except Exception:
|
||||||
|
logger.exception("could not derive the address for pending_transaction %s", pending_id)
|
||||||
|
|
||||||
confirmed = 0
|
confirmed = 0
|
||||||
for pending_id, txid, kind in candidates:
|
history_cache: dict[str, list[dict]] = {}
|
||||||
|
for pending_id, txid, kind, _user_id in candidates:
|
||||||
|
scripthash = scripthash_by_id.get(pending_id)
|
||||||
|
if scripthash is None:
|
||||||
|
continue # address derivation failed above; already logged
|
||||||
|
|
||||||
try:
|
try:
|
||||||
tx = await client.get_transaction(txid, verbose=True)
|
if scripthash not in history_cache:
|
||||||
|
history_cache[scripthash] = await client.get_history(scripthash)
|
||||||
except Exception:
|
except Exception:
|
||||||
# One unresolvable txid must not stop the others: a tx the server no
|
# One unresolvable scripthash must not stop the others: a tx the server
|
||||||
# longer knows (dropped from the mempool, replaced) used to abort the
|
# no longer knows about (dropped from the mempool, replaced) used to
|
||||||
# whole pass, so nothing confirmed again until an operator intervened
|
# abort the whole pass via a verbose blockchain.transaction.get call
|
||||||
# (B-03). Abandoning such a row is app/tx/reconcile.py's job, not ours.
|
# that some servers reject outright (B-41), so nothing confirmed again
|
||||||
logger.warning("could not check pending_transaction %s (txid %s)", pending_id, txid, exc_info=True)
|
# until an operator intervened (B-03). Abandoning such a row is
|
||||||
|
# app/tx/reconcile.py's job, not ours.
|
||||||
|
logger.warning("could not fetch history for pending_transaction %s (txid %s)", pending_id, txid, exc_info=True)
|
||||||
continue
|
continue
|
||||||
if not tx or tx.get("confirmations", 0) < 1:
|
|
||||||
|
entry = next((e for e in history_cache[scripthash] if e.get("tx_hash") == txid), None)
|
||||||
|
# height > 0 means confirmed at that height; 0 or absent means still in
|
||||||
|
# the mempool (or the server doesn't know this txid at all yet) — either
|
||||||
|
# way, not confirmed, so keep waiting.
|
||||||
|
if entry is None or entry.get("height", 0) <= 0:
|
||||||
continue
|
continue
|
||||||
|
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
row = await session.get(PendingTransaction, pending_id)
|
row = await session.get(PendingTransaction, pending_id)
|
||||||
if row is None or row.status != "pending":
|
if row is None or row.status != "pending":
|
||||||
|
|||||||
@@ -0,0 +1,22 @@
|
|||||||
|
from sqlalchemy.ext.asyncio import AsyncSession
|
||||||
|
|
||||||
|
from app.db.models import User
|
||||||
|
from app.wallet.hd import derive_pool_address, derive_user_address
|
||||||
|
|
||||||
|
|
||||||
|
async def own_address_for(session: AsyncSession, kind: str, user_id: int | None) -> str:
|
||||||
|
"""The address that owns every input of a PendingTransaction of this kind —
|
||||||
|
a user's own address for a bet/withdrawal, the pool address for a payout.
|
||||||
|
All our builders only ever spend one address's UTXOs per tx (see
|
||||||
|
tx/broadcast.py:_signing_context, which derives the same address alongside
|
||||||
|
the signing key it also needs).
|
||||||
|
|
||||||
|
Shared by tx/confirmation.py and tx/reconcile.py (B-41): both now check
|
||||||
|
blockchain.scripthash.get_history for this address instead of asking
|
||||||
|
blockchain.transaction.get for a verbose reply, so the two can't derive
|
||||||
|
different addresses for the same row.
|
||||||
|
"""
|
||||||
|
if kind == "payout":
|
||||||
|
return derive_pool_address()
|
||||||
|
user = await session.get(User, user_id)
|
||||||
|
return derive_user_address(user.derivation_index)
|
||||||
+32
-22
@@ -36,7 +36,9 @@ from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
|
|||||||
from app.audit.log import write_audit_log
|
from app.audit.log import write_audit_log
|
||||||
from app.db.models import PendingTransaction, Round, RoundParticipant, UtxoEvent, Withdrawal
|
from app.db.models import PendingTransaction, Round, RoundParticipant, UtxoEvent, Withdrawal
|
||||||
from app.electrum.client import ElectrumClient
|
from app.electrum.client import ElectrumClient
|
||||||
|
from app.electrum.scripthash import address_to_scripthash
|
||||||
from app.rounds.events import broadcaster
|
from app.rounds.events import broadcaster
|
||||||
|
from app.tx.pending_address import own_address_for
|
||||||
from app.wallet.balance import recompute_balance
|
from app.wallet.balance import recompute_balance
|
||||||
|
|
||||||
logger = logging.getLogger(__name__)
|
logger = logging.getLogger(__name__)
|
||||||
@@ -72,22 +74,21 @@ class PendingTransactionReconciler:
|
|||||||
await asyncio.sleep(_POLL_INTERVAL_SECONDS)
|
await asyncio.sleep(_POLL_INTERVAL_SECONDS)
|
||||||
|
|
||||||
|
|
||||||
async def _tx_exists_on_chain(client: ElectrumClient, txid: str) -> bool:
|
|
||||||
"""True if the server knows this txid at all (mempool or mined). An error reply
|
|
||||||
means "unknown", which is the answer we're looking for; a transport failure is
|
|
||||||
*not* — that raises, and the caller leaves the row alone until next time."""
|
|
||||||
try:
|
|
||||||
tx = await client.get_transaction(txid, verbose=True)
|
|
||||||
except Exception as exc:
|
|
||||||
message = str(exc).lower()
|
|
||||||
if "missing" in message or "not found" in message or "no such" in message or "unknown" in message:
|
|
||||||
return False
|
|
||||||
raise
|
|
||||||
return bool(tx)
|
|
||||||
|
|
||||||
|
|
||||||
async def reconcile_once(session_factory: async_sessionmaker, client: ElectrumClient) -> int:
|
async def reconcile_once(session_factory: async_sessionmaker, client: ElectrumClient) -> int:
|
||||||
"""Returns how many rows were resolved (promoted or abandoned)."""
|
"""Returns how many rows were resolved (promoted or abandoned).
|
||||||
|
|
||||||
|
Existence is decided by checking whether a row's own address's history
|
||||||
|
(blockchain.scripthash.get_history) includes its txid at all — mempool or
|
||||||
|
mined — rather than asking blockchain.transaction.get for a verbose reply
|
||||||
|
(B-41): several Electrum server implementations and versions reject the
|
||||||
|
verbose flag outright, and the previous substring-matching on the error
|
||||||
|
text (looking for "missing", "not found", ...) was fragile as the basis for
|
||||||
|
a decision that releases funds. A transport failure fetching history still
|
||||||
|
raises and leaves the row alone until next time — get_history not
|
||||||
|
returning our txid is the only thing that means "gone". History is cached
|
||||||
|
per scripthash within one pass, since every "payout" row shares the same
|
||||||
|
pool address.
|
||||||
|
"""
|
||||||
now = datetime.now(timezone.utc)
|
now = datetime.now(timezone.utc)
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
rows = (
|
rows = (
|
||||||
@@ -95,16 +96,25 @@ async def reconcile_once(session_factory: async_sessionmaker, client: ElectrumCl
|
|||||||
select(PendingTransaction).where(PendingTransaction.status.in_(("building", "pending")))
|
select(PendingTransaction).where(PendingTransaction.status.in_(("building", "pending")))
|
||||||
)
|
)
|
||||||
).all()
|
).all()
|
||||||
candidates = [
|
candidates = []
|
||||||
(row.id, row.status, row.current_txid)
|
for row in rows:
|
||||||
for row in rows
|
if not _is_due(row, now):
|
||||||
if _is_due(row, now)
|
continue
|
||||||
]
|
try:
|
||||||
|
address = await own_address_for(session, row.kind, row.user_id)
|
||||||
|
scripthash = address_to_scripthash(address)
|
||||||
|
except Exception:
|
||||||
|
logger.exception("could not derive the address for pending_transaction %s", row.id)
|
||||||
|
continue
|
||||||
|
candidates.append((row.id, row.status, row.current_txid, scripthash))
|
||||||
|
|
||||||
resolved = 0
|
resolved = 0
|
||||||
for row_id, status, txid in candidates:
|
history_cache: dict[str, list[dict]] = {}
|
||||||
|
for row_id, status, txid, scripthash in candidates:
|
||||||
try:
|
try:
|
||||||
exists = await _tx_exists_on_chain(client, txid)
|
if scripthash not in history_cache:
|
||||||
|
history_cache[scripthash] = await client.get_history(scripthash)
|
||||||
|
exists = any(entry.get("tx_hash") == txid for entry in history_cache[scripthash])
|
||||||
except Exception:
|
except Exception:
|
||||||
# Transport/server problem — say nothing about this tx and try again on
|
# Transport/server problem — say nothing about this tx and try again on
|
||||||
# the next pass rather than abandoning a tx that may be perfectly alive.
|
# the next pass rather than abandoning a tx that may be perfectly alive.
|
||||||
|
|||||||
+19
-1
@@ -38,6 +38,15 @@ async def compute_pending_balance(session: AsyncSession, user: User) -> tuple[in
|
|||||||
user's own address. Adding that to cached_balance_sats gives the balance the
|
user's own address. Adding that to cached_balance_sats gives the balance the
|
||||||
user will end up with once everything currently in flight confirms.
|
user will end up with once everything currently in flight confirms.
|
||||||
|
|
||||||
|
The change output's own confirmation is credited by two independent, unordered
|
||||||
|
paths: the Electrum listener (event-driven, near-instant — app/deposits/service.py
|
||||||
|
turns it into a UtxoEvent and folds it into cached_balance_sats via
|
||||||
|
recompute_balance) and this module's PendingTransaction.status flip
|
||||||
|
(app/tx/confirmation.py, polled every 10s). The listener usually wins that race,
|
||||||
|
so for the gap until the poller catches up the row is still "pending" here while
|
||||||
|
the same sats are already inside cached_balance_sats — double-counting the
|
||||||
|
change unless excluded below.
|
||||||
|
|
||||||
Returns (pending_inclusive_balance_sats, has_pending) — has_pending tells the
|
Returns (pending_inclusive_balance_sats, has_pending) — has_pending tells the
|
||||||
caller whether this differs from the confirmed-only balance at all.
|
caller whether this differs from the confirmed-only balance at all.
|
||||||
"""
|
"""
|
||||||
@@ -54,10 +63,19 @@ async def compute_pending_balance(session: AsyncSession, user: User) -> tuple[in
|
|||||||
)
|
)
|
||||||
).all()
|
).all()
|
||||||
|
|
||||||
|
already_credited = {
|
||||||
|
(txid, vout)
|
||||||
|
for txid, vout in (
|
||||||
|
await session.execute(select(UtxoEvent.txid, UtxoEvent.vout).where(UtxoEvent.user_id == user.id))
|
||||||
|
).all()
|
||||||
|
}
|
||||||
|
|
||||||
pending_change_sats = 0
|
pending_change_sats = 0
|
||||||
for row in pending:
|
for row in pending:
|
||||||
tx = Transaction.parse(bytes.fromhex(row.raw_tx_hex))
|
tx = Transaction.parse(bytes.fromhex(row.raw_tx_hex))
|
||||||
for out in tx.vout:
|
for vout, out in enumerate(tx.vout):
|
||||||
|
if (row.current_txid, vout) in already_credited:
|
||||||
|
continue
|
||||||
if out.script_pubkey.address(network=PLM_MAINNET) == user.address:
|
if out.script_pubkey.address(network=PLM_MAINNET) == user.address:
|
||||||
pending_change_sats += out.value
|
pending_change_sats += out.value
|
||||||
|
|
||||||
|
|||||||
@@ -33,15 +33,30 @@ DUST_LIMIT_SATS = 294
|
|||||||
# eating further and further into the sender's change with no limit.
|
# eating further and further into the sender's change with no limit.
|
||||||
MAX_FEE_RATE_SAT_VB = 10_000
|
MAX_FEE_RATE_SAT_VB = 10_000
|
||||||
|
|
||||||
|
# Ceiling on how many UTXOs one transaction may spend (B-48). Every extra input costs
|
||||||
|
# ~68 vbytes of fee, and that fee comes out of the amount being moved — so an address
|
||||||
|
# fragmented into hundreds of small deposits would silently erode its own bet (shrinking
|
||||||
|
# the user's share of the pool) or withdrawal, and past a few hundred inputs the tx also
|
||||||
|
# stops being standard and gets refused at broadcast. Failing the build with a
|
||||||
|
# translatable error is the honest outcome; consolidating the address is the way out.
|
||||||
|
MAX_TX_INPUTS = 50
|
||||||
|
|
||||||
|
|
||||||
class InsufficientFundsError(Exception):
|
class InsufficientFundsError(Exception):
|
||||||
"""`code` is the machine-readable identifier the API layer forwards to the
|
"""`code` is the machine-readable identifier the API layer forwards to the
|
||||||
client so it can translate the failure (see app/api/errors.py); the message
|
client so it can translate the failure (see app/api/errors.py); the message
|
||||||
itself stays English."""
|
itself stays English, and `params` carries the values it interpolates so the
|
||||||
|
translation can place them wherever its own grammar needs them."""
|
||||||
|
|
||||||
def __init__(self, message: str, code: str = "insufficient_balance") -> None:
|
def __init__(
|
||||||
|
self,
|
||||||
|
message: str,
|
||||||
|
code: str = "insufficient_balance",
|
||||||
|
**params: int | str,
|
||||||
|
) -> None:
|
||||||
super().__init__(message)
|
super().__init__(message)
|
||||||
self.code = code
|
self.code = code
|
||||||
|
self.params = params
|
||||||
|
|
||||||
|
|
||||||
@dataclass
|
@dataclass
|
||||||
@@ -68,11 +83,22 @@ def estimate_vsize(n_inputs: int, n_outputs: int) -> int:
|
|||||||
def select_utxos(utxos: list[Utxo], target_sats: int) -> tuple[list[Utxo], int]:
|
def select_utxos(utxos: list[Utxo], target_sats: int) -> tuple[list[Utxo], int]:
|
||||||
"""Greedily select UTXOs (largest first, to minimize input count) covering
|
"""Greedily select UTXOs (largest first, to minimize input count) covering
|
||||||
target_sats — the amount deducted from the sender's balance. The fee is paid
|
target_sats — the amount deducted from the sender's balance. The fee is paid
|
||||||
out of target_sats (see build_signed_transaction), not added on top of it."""
|
out of target_sats (see build_signed_transaction), not added on top of it.
|
||||||
|
|
||||||
|
At most MAX_TX_INPUTS are ever selected (B-48): if the largest MAX_TX_INPUTS
|
||||||
|
UTXOs don't cover the target, the balance is there but too fragmented to spend
|
||||||
|
in one transaction, which is a different failure from having no funds at all
|
||||||
|
and gets its own code."""
|
||||||
ordered = sorted(utxos, key=lambda u: u.amount_sats, reverse=True)
|
ordered = sorted(utxos, key=lambda u: u.amount_sats, reverse=True)
|
||||||
selected: list[Utxo] = []
|
selected: list[Utxo] = []
|
||||||
total = 0
|
total = 0
|
||||||
for utxo in ordered:
|
for utxo in ordered:
|
||||||
|
if len(selected) == MAX_TX_INPUTS:
|
||||||
|
raise InsufficientFundsError(
|
||||||
|
f"balance too fragmented: more than {MAX_TX_INPUTS} inputs would be needed",
|
||||||
|
code="too_many_inputs",
|
||||||
|
max_inputs=MAX_TX_INPUTS,
|
||||||
|
)
|
||||||
selected.append(utxo)
|
selected.append(utxo)
|
||||||
total += utxo.amount_sats
|
total += utxo.amount_sats
|
||||||
if total >= target_sats:
|
if total >= target_sats:
|
||||||
|
|||||||
@@ -89,7 +89,7 @@ async def request_withdrawal(
|
|||||||
fee_rate_sat_vb=config.fee_rate_sat_vb,
|
fee_rate_sat_vb=config.fee_rate_sat_vb,
|
||||||
)
|
)
|
||||||
except InsufficientFundsError as exc:
|
except InsufficientFundsError as exc:
|
||||||
raise WithdrawalError(exc.code, str(exc)) from exc
|
raise WithdrawalError(exc.code, str(exc), **exc.params) from exc
|
||||||
|
|
||||||
# Persist the intent before broadcasting, and only promote the rows once the
|
# Persist the intent before broadcasting, and only promote the rows once the
|
||||||
# network has accepted the tx — same two-phase shape as place_bet (B-08).
|
# network has accepted the tx — same two-phase shape as place_bet (B-08).
|
||||||
@@ -173,3 +173,4 @@ async def _release_failed_withdrawal(
|
|||||||
user_id=user_id,
|
user_id=user_id,
|
||||||
)
|
)
|
||||||
await session.commit()
|
await session.commit()
|
||||||
|
broadcaster.publish() # the reserved UTXOs are spendable again — refetch the balance (B-49)
|
||||||
+3
-2
@@ -121,8 +121,9 @@ Eventi a cui vale la pena prestare attenzione:
|
|||||||
## Alternative all'interfaccia grafica
|
## Alternative all'interfaccia grafica
|
||||||
|
|
||||||
Le stesse operazioni si possono fare da terminale o da Swagger UI
|
Le stesse operazioni si possono fare da terminale o da Swagger UI
|
||||||
(`https://<host>/docs`, sezione `admin`), sempre passando `ADMIN_TOKEN`
|
(`https://<host>/docs`, sezione `admin` — disponibile solo se `ENABLE_API_DOCS=true`
|
||||||
nell'header `X-Admin-Token`:
|
è impostato in `.env`, disattivata di default perché espone l'intera API),
|
||||||
|
sempre passando `ADMIN_TOKEN` nell'header `X-Admin-Token`:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# leggere la configurazione
|
# leggere la configurazione
|
||||||
|
|||||||
@@ -3,24 +3,14 @@
|
|||||||
Presuppone che [setup.md](setup.md) sia già stato completato (`.env` pronto,
|
Presuppone che [setup.md](setup.md) sia già stato completato (`.env` pronto,
|
||||||
master key generata, migrazioni applicate).
|
master key generata, migrazioni applicate).
|
||||||
|
|
||||||
## Locale / venv (sviluppo rapido)
|
Il server gira sempre via Docker, in sviluppo e in produzione allo stesso
|
||||||
|
modo — non esiste un modo supportato per lanciare `uvicorn` direttamente.
|
||||||
|
Il venv locale (`.venv/`) serve solo per i test, per scrivere le migrazioni
|
||||||
|
Alembic e per gli script una tantum di generazione chiavi (vedi
|
||||||
|
[setup.md](setup.md) e la sezione "Commands" di
|
||||||
|
[CLAUDE.md](../CLAUDE.md#commands)).
|
||||||
|
|
||||||
```bash
|
## Docker + Caddy (unico workflow supportato)
|
||||||
source .venv/bin/activate
|
|
||||||
uvicorn app.main:app --reload --port 8123
|
|
||||||
```
|
|
||||||
|
|
||||||
- App su `http://127.0.0.1:8123/`
|
|
||||||
- Pannello admin su `http://127.0.0.1:8123/admin`
|
|
||||||
- Log applicativi in `logs/app.log` (rotante, 10MB × 5 backup)
|
|
||||||
- Nessun TLS, nessun reverse proxy — solo per test locali sulla tua macchina.
|
|
||||||
|
|
||||||
Per fermarlo: `Ctrl+C`, oppure se lanciato in background con `nohup`:
|
|
||||||
```bash
|
|
||||||
pkill -f "uvicorn app.main:app"
|
|
||||||
```
|
|
||||||
|
|
||||||
## Docker + Caddy (consigliato, anche per i test con dominio/TLS)
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
mkdir -p data/db data/keys data/logs # una tantum, se non già presenti
|
mkdir -p data/db data/keys data/logs # una tantum, se non già presenti
|
||||||
|
|||||||
@@ -38,6 +38,11 @@ cp .env.example .env
|
|||||||
Le altre chiavi di `.env` (`DATABASE_URL`, `ELECTRUM_HOST`/`PORT`/`USE_SSL`,
|
Le altre chiavi di `.env` (`DATABASE_URL`, `ELECTRUM_HOST`/`PORT`/`USE_SSL`,
|
||||||
`MASTER_KEY_PATH`) hanno default sensati in `.env.example`.
|
`MASTER_KEY_PATH`) hanno default sensati in `.env.example`.
|
||||||
|
|
||||||
|
`ENABLE_API_DOCS` (default `false`) controlla Swagger/ReDoc/l'OpenAPI JSON grezzo
|
||||||
|
su `/docs`, `/redoc` e `/openapi.json`: espongono l'intera superficie dell'API,
|
||||||
|
endpoint admin inclusi, quindi restano disattivati a meno di non impostarlo
|
||||||
|
esplicitamente a `true` — utile in locale, da evitare in produzione.
|
||||||
|
|
||||||
`ELECTRUM_FALLBACK_SERVERS` elenca i server di riserva, separati da virgola, nel
|
`ELECTRUM_FALLBACK_SERVERS` elenca i server di riserva, separati da virgola, nel
|
||||||
formato `host:porta` (TLS, il caso normale) oppure `host:porta:notls`. Esempio:
|
formato `host:porta` (TLS, il caso normale) oppure `host:porta:notls`. Esempio:
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,38 @@
|
|||||||
|
"""widen raw_tx_hex and payload_json to Text
|
||||||
|
|
||||||
|
Fixes B-47: both columns held arbitrary-length data (a raw signed transaction
|
||||||
|
hex, and a JSON audit payload) in an unbounded `String`, which SQLAlchemy
|
||||||
|
compiles to `VARCHAR` with no length. That's accepted by SQLite and
|
||||||
|
PostgreSQL but rejected by other backends (e.g. MySQL requires a length on
|
||||||
|
VARCHAR) — `Text` is the portable type for both.
|
||||||
|
|
||||||
|
Revision ID: 87a0c640355c
|
||||||
|
Revises: 9ef6a51509f7
|
||||||
|
Create Date: 2026-07-27
|
||||||
|
|
||||||
|
"""
|
||||||
|
from typing import Sequence, Union
|
||||||
|
|
||||||
|
from alembic import op
|
||||||
|
import sqlalchemy as sa
|
||||||
|
|
||||||
|
|
||||||
|
# revision identifiers, used by Alembic.
|
||||||
|
revision: str = '87a0c640355c'
|
||||||
|
down_revision: Union[str, Sequence[str], None] = '9ef6a51509f7'
|
||||||
|
branch_labels: Union[str, Sequence[str], None] = None
|
||||||
|
depends_on: Union[str, Sequence[str], None] = None
|
||||||
|
|
||||||
|
|
||||||
|
def upgrade() -> None:
|
||||||
|
with op.batch_alter_table('audit_log') as batch_op:
|
||||||
|
batch_op.alter_column('payload_json', existing_type=sa.VARCHAR(), type_=sa.Text(), existing_nullable=False)
|
||||||
|
with op.batch_alter_table('pending_transactions') as batch_op:
|
||||||
|
batch_op.alter_column('raw_tx_hex', existing_type=sa.VARCHAR(), type_=sa.Text(), existing_nullable=False)
|
||||||
|
|
||||||
|
|
||||||
|
def downgrade() -> None:
|
||||||
|
with op.batch_alter_table('pending_transactions') as batch_op:
|
||||||
|
batch_op.alter_column('raw_tx_hex', existing_type=sa.Text(), type_=sa.VARCHAR(), existing_nullable=False)
|
||||||
|
with op.batch_alter_table('audit_log') as batch_op:
|
||||||
|
batch_op.alter_column('payload_json', existing_type=sa.Text(), type_=sa.VARCHAR(), existing_nullable=False)
|
||||||
@@ -0,0 +1,41 @@
|
|||||||
|
"""replace bug_reports.resolved with a three-state status
|
||||||
|
|
||||||
|
Revision ID: be71fdac734e
|
||||||
|
Revises: ee8508d98d34
|
||||||
|
Create Date: 2026-07-31 15:33:51.780062
|
||||||
|
|
||||||
|
"""
|
||||||
|
from typing import Sequence, Union
|
||||||
|
|
||||||
|
from alembic import op
|
||||||
|
import sqlalchemy as sa
|
||||||
|
|
||||||
|
|
||||||
|
# revision identifiers, used by Alembic.
|
||||||
|
revision: str = 'be71fdac734e'
|
||||||
|
down_revision: Union[str, Sequence[str], None] = 'ee8508d98d34'
|
||||||
|
branch_labels: Union[str, Sequence[str], None] = None
|
||||||
|
depends_on: Union[str, Sequence[str], None] = None
|
||||||
|
|
||||||
|
|
||||||
|
def upgrade() -> None:
|
||||||
|
"""Upgrade schema, preserving existing rows: resolved=True -> 'resolved', else 'open'.
|
||||||
|
|
||||||
|
'read' has no equivalent in the old boolean, so nothing backfills into it —
|
||||||
|
every previously-open report starts the new lifecycle at 'open', which is
|
||||||
|
correct (nobody had acknowledged it yet)."""
|
||||||
|
op.add_column('bug_reports', sa.Column('status', sa.String(length=16), nullable=True))
|
||||||
|
op.execute("UPDATE bug_reports SET status = CASE WHEN resolved THEN 'resolved' ELSE 'open' END")
|
||||||
|
with op.batch_alter_table('bug_reports') as batch_op:
|
||||||
|
batch_op.alter_column('status', nullable=False)
|
||||||
|
batch_op.drop_column('resolved')
|
||||||
|
|
||||||
|
|
||||||
|
def downgrade() -> None:
|
||||||
|
"""Downgrade schema. 'read' collapses back into resolved=False — the same loss
|
||||||
|
of information any boolean-from-enum downgrade has."""
|
||||||
|
op.add_column('bug_reports', sa.Column('resolved', sa.BOOLEAN(), nullable=True))
|
||||||
|
op.execute("UPDATE bug_reports SET resolved = (status = 'resolved')")
|
||||||
|
with op.batch_alter_table('bug_reports') as batch_op:
|
||||||
|
batch_op.alter_column('resolved', nullable=False)
|
||||||
|
batch_op.drop_column('status')
|
||||||
@@ -0,0 +1,41 @@
|
|||||||
|
"""add bug_reports table
|
||||||
|
|
||||||
|
Revision ID: ee8508d98d34
|
||||||
|
Revises: 87a0c640355c
|
||||||
|
Create Date: 2026-07-31 15:14:14.288552
|
||||||
|
|
||||||
|
"""
|
||||||
|
from typing import Sequence, Union
|
||||||
|
|
||||||
|
from alembic import op
|
||||||
|
import sqlalchemy as sa
|
||||||
|
|
||||||
|
|
||||||
|
# revision identifiers, used by Alembic.
|
||||||
|
revision: str = 'ee8508d98d34'
|
||||||
|
down_revision: Union[str, Sequence[str], None] = '87a0c640355c'
|
||||||
|
branch_labels: Union[str, Sequence[str], None] = None
|
||||||
|
depends_on: Union[str, Sequence[str], None] = None
|
||||||
|
|
||||||
|
|
||||||
|
def upgrade() -> None:
|
||||||
|
"""Upgrade schema."""
|
||||||
|
# ### commands auto generated by Alembic - please adjust! ###
|
||||||
|
op.create_table('bug_reports',
|
||||||
|
sa.Column('id', sa.Integer(), nullable=False),
|
||||||
|
sa.Column('description', sa.Text(), nullable=False),
|
||||||
|
sa.Column('contact', sa.String(length=256), nullable=True),
|
||||||
|
sa.Column('user_id', sa.Integer(), nullable=True),
|
||||||
|
sa.Column('resolved', sa.Boolean(), nullable=False),
|
||||||
|
sa.Column('created_at', sa.DateTime(), nullable=False),
|
||||||
|
sa.ForeignKeyConstraint(['user_id'], ['users.id'], ),
|
||||||
|
sa.PrimaryKeyConstraint('id')
|
||||||
|
)
|
||||||
|
# ### end Alembic commands ###
|
||||||
|
|
||||||
|
|
||||||
|
def downgrade() -> None:
|
||||||
|
"""Downgrade schema."""
|
||||||
|
# ### commands auto generated by Alembic - please adjust! ###
|
||||||
|
op.drop_table('bug_reports')
|
||||||
|
# ### end Alembic commands ###
|
||||||
@@ -67,6 +67,15 @@ async def test_admin_rejects_wrong_token(client):
|
|||||||
assert resp.status_code == 403
|
assert resp.status_code == 403
|
||||||
|
|
||||||
|
|
||||||
|
async def test_admin_rejects_non_ascii_token_with_403_not_500(client):
|
||||||
|
"""B-46: secrets.compare_digest raises TypeError on a non-ASCII str, which
|
||||||
|
used to bubble up as a 500 instead of the expected 403. httpx encodes str
|
||||||
|
header values as ASCII client-side, so the raw UTF-8 bytes are passed
|
||||||
|
directly to reproduce what a real non-ASCII header on the wire looks like."""
|
||||||
|
resp = await client.get("/admin/config", headers={"X-Admin-Token": "café".encode("utf-8")})
|
||||||
|
assert resp.status_code == 403
|
||||||
|
|
||||||
|
|
||||||
async def test_admin_reads_and_updates_config(client):
|
async def test_admin_reads_and_updates_config(client):
|
||||||
headers = {"X-Admin-Token": "test-admin-token"}
|
headers = {"X-Admin-Token": "test-admin-token"}
|
||||||
|
|
||||||
@@ -277,3 +286,90 @@ async def test_pause_cannot_be_toggled_through_the_config_endpoint(client):
|
|||||||
resp = await client.put("/admin/config", headers=headers, json={"paused": True})
|
resp = await client.put("/admin/config", headers=headers, json={"paused": True})
|
||||||
assert resp.status_code in (200, 422) # ignored or refused, but never applied
|
assert resp.status_code in (200, 422) # ignored or refused, but never applied
|
||||||
assert (await client.get("/admin/config", headers=headers)).json()["paused"] is False
|
assert (await client.get("/admin/config", headers=headers)).json()["paused"] is False
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.parametrize("endpoint", ["/admin/rounds", "/admin/audit-log", "/admin/pending-transactions"])
|
||||||
|
@pytest.mark.parametrize("bad_limit", [0, -1, 501])
|
||||||
|
async def test_admin_list_endpoints_reject_out_of_range_limit(client, endpoint, bad_limit):
|
||||||
|
"""B-45: `limit` had no bounds — `-1` means "everything" on SQLite, so an
|
||||||
|
unvalidated limit could dump the entire table in one response."""
|
||||||
|
headers = {"X-Admin-Token": "test-admin-token"}
|
||||||
|
resp = await client.get(endpoint, headers=headers, params={"limit": bad_limit})
|
||||||
|
assert resp.status_code == 422
|
||||||
|
|
||||||
|
|
||||||
|
async def test_admin_list_rounds_respects_limit(client):
|
||||||
|
from app.db import base as db_base
|
||||||
|
from app.db.models import Round
|
||||||
|
|
||||||
|
async with db_base.AsyncSessionLocal() as session:
|
||||||
|
session.add_all([Round(status="closed") for _ in range(3)])
|
||||||
|
await session.commit()
|
||||||
|
|
||||||
|
headers = {"X-Admin-Token": "test-admin-token"}
|
||||||
|
resp = await client.get("/admin/rounds", headers=headers, params={"limit": 2})
|
||||||
|
assert resp.status_code == 200
|
||||||
|
assert len(resp.json()) == 2
|
||||||
|
|
||||||
|
|
||||||
|
async def test_admin_audit_log_respects_limit(client):
|
||||||
|
from app.db import base as db_base
|
||||||
|
from app.audit.log import write_audit_log
|
||||||
|
|
||||||
|
async with db_base.AsyncSessionLocal() as session:
|
||||||
|
for _ in range(3):
|
||||||
|
await write_audit_log(session, "test_event", {})
|
||||||
|
await session.commit()
|
||||||
|
|
||||||
|
headers = {"X-Admin-Token": "test-admin-token"}
|
||||||
|
resp = await client.get("/admin/audit-log", headers=headers, params={"limit": 2})
|
||||||
|
assert resp.status_code == 200
|
||||||
|
assert len(resp.json()) == 2
|
||||||
|
|
||||||
|
|
||||||
|
async def _make_pending_transaction(session, *, kind="bet", status="pending"):
|
||||||
|
from app.db.models import PendingTransaction
|
||||||
|
import secrets as _secrets
|
||||||
|
|
||||||
|
tx = PendingTransaction(
|
||||||
|
kind=kind,
|
||||||
|
current_txid=_secrets.token_hex(32),
|
||||||
|
fee_rate_sat_vb=1,
|
||||||
|
raw_tx_hex="00",
|
||||||
|
status=status,
|
||||||
|
)
|
||||||
|
session.add(tx)
|
||||||
|
return tx
|
||||||
|
|
||||||
|
|
||||||
|
async def test_admin_pending_transactions_respects_limit(client):
|
||||||
|
from app.db import base as db_base
|
||||||
|
|
||||||
|
async with db_base.AsyncSessionLocal() as session:
|
||||||
|
for _ in range(3):
|
||||||
|
await _make_pending_transaction(session)
|
||||||
|
await session.commit()
|
||||||
|
|
||||||
|
headers = {"X-Admin-Token": "test-admin-token"}
|
||||||
|
resp = await client.get("/admin/pending-transactions", headers=headers, params={"limit": 2})
|
||||||
|
assert resp.status_code == 200
|
||||||
|
assert len(resp.json()) == 2
|
||||||
|
|
||||||
|
|
||||||
|
async def test_admin_pending_transactions_status_filter(client):
|
||||||
|
from app.db import base as db_base
|
||||||
|
|
||||||
|
async with db_base.AsyncSessionLocal() as session:
|
||||||
|
await _make_pending_transaction(session, status="pending")
|
||||||
|
await _make_pending_transaction(session, status="confirmed")
|
||||||
|
await _make_pending_transaction(session, status="failed")
|
||||||
|
await session.commit()
|
||||||
|
|
||||||
|
headers = {"X-Admin-Token": "test-admin-token"}
|
||||||
|
resp = await client.get(
|
||||||
|
"/admin/pending-transactions", headers=headers, params={"status": "confirmed"}
|
||||||
|
)
|
||||||
|
assert resp.status_code == 200
|
||||||
|
entries = resp.json()
|
||||||
|
assert len(entries) == 1
|
||||||
|
assert entries[0]["status"] == "confirmed"
|
||||||
@@ -91,6 +91,54 @@ async def test_pending_balance_matches_confirmed_when_nothing_in_flight(session_
|
|||||||
assert pending_balance == 2_000_000_000
|
assert pending_balance == 2_000_000_000
|
||||||
|
|
||||||
|
|
||||||
|
async def test_pending_balance_does_not_double_count_change_already_credited(session_factory):
|
||||||
|
"""The Electrum listener (event-driven) and the confirmation poller (10s
|
||||||
|
cadence) independently react to the same change output confirming. When the
|
||||||
|
listener wins that race — the common case — the change is already a
|
||||||
|
UtxoEvent inside cached_balance_sats while the PendingTransaction row is
|
||||||
|
still "pending". compute_pending_balance must not add the change a second
|
||||||
|
time in that window."""
|
||||||
|
user_id = await _make_funded_user(session_factory, 4, 1_500_000_000)
|
||||||
|
client = FakeElectrumClient()
|
||||||
|
|
||||||
|
async with session_factory() as session:
|
||||||
|
user = await session.get(User, user_id)
|
||||||
|
await place_bet(session, client, user)
|
||||||
|
|
||||||
|
async with session_factory() as session:
|
||||||
|
pending = (await session.scalars(select(PendingTransaction))).one()
|
||||||
|
from embit.transaction import Transaction
|
||||||
|
|
||||||
|
from app.wallet.plm_network import PLM_MAINNET
|
||||||
|
|
||||||
|
tx = Transaction.parse(bytes.fromhex(pending.raw_tx_hex))
|
||||||
|
change_vout, change_out = next(
|
||||||
|
(i, out) for i, out in enumerate(tx.vout) if out.script_pubkey.address(network=PLM_MAINNET) == user.address
|
||||||
|
)
|
||||||
|
|
||||||
|
user = await session.get(User, user_id)
|
||||||
|
# Simulate the listener having already credited the change output as
|
||||||
|
# confirmed, before the poller has flipped `pending.status`.
|
||||||
|
session.add(
|
||||||
|
UtxoEvent(
|
||||||
|
user_id=user_id,
|
||||||
|
txid=pending.current_txid,
|
||||||
|
vout=change_vout,
|
||||||
|
amount_sats=change_out.value,
|
||||||
|
confirmed_height=101,
|
||||||
|
)
|
||||||
|
)
|
||||||
|
await recompute_balance(session, user_id)
|
||||||
|
await session.commit()
|
||||||
|
|
||||||
|
async with session_factory() as session:
|
||||||
|
user = await session.get(User, user_id)
|
||||||
|
pending_balance, has_pending = await compute_pending_balance(session, user)
|
||||||
|
|
||||||
|
assert has_pending is True # the PendingTransaction row is still "pending"
|
||||||
|
assert pending_balance == user.cached_balance_sats # already-credited change isn't added again
|
||||||
|
|
||||||
|
|
||||||
async def test_pending_balance_ignores_other_users_pending_transactions(session_factory):
|
async def test_pending_balance_ignores_other_users_pending_transactions(session_factory):
|
||||||
user_id = await _make_funded_user(session_factory, 2, 2_000_000_000)
|
user_id = await _make_funded_user(session_factory, 2, 2_000_000_000)
|
||||||
other_user_id = await _make_funded_user(session_factory, 3, 1_500_000_000)
|
other_user_id = await _make_funded_user(session_factory, 3, 1_500_000_000)
|
||||||
|
|||||||
@@ -8,8 +8,10 @@ from app.bets.service import BetError, place_bet
|
|||||||
from app.config import settings
|
from app.config import settings
|
||||||
from app.db.base import Base
|
from app.db.base import Base
|
||||||
from app.db.models import AuditLog, PendingTransaction, Round, RoundConfig, RoundParticipant, User, UtxoEvent
|
from app.db.models import AuditLog, PendingTransaction, Round, RoundConfig, RoundParticipant, User, UtxoEvent
|
||||||
|
from app.rounds.events import broadcaster
|
||||||
from app.rounds.service import open_new_round_if_needed
|
from app.rounds.service import open_new_round_if_needed
|
||||||
from app.wallet.hd import derive_user_address
|
from app.wallet.hd import derive_user_address
|
||||||
|
from app.wallet.psbt_builder import MAX_TX_INPUTS
|
||||||
|
|
||||||
|
|
||||||
class FakeElectrumClient:
|
class FakeElectrumClient:
|
||||||
@@ -91,6 +93,35 @@ async def test_place_bet_rejects_insufficient_balance(session_factory):
|
|||||||
await place_bet(session, client, user)
|
await place_bet(session, client, user)
|
||||||
|
|
||||||
|
|
||||||
|
async def test_place_bet_reports_a_too_fragmented_balance_distinctly(session_factory): # B-48
|
||||||
|
# 100 x 0.15 PLM = 15 PLM, plenty for a 10 PLM bet, but the 50 largest inputs
|
||||||
|
# only add up to 7.5 PLM — so the build must fail with its own code, not with
|
||||||
|
# the "you have no funds" one, and must carry the cap for the translation.
|
||||||
|
user_id = await _make_funded_user(session_factory, 20, 15_000_000)
|
||||||
|
async with session_factory() as session:
|
||||||
|
for i in range(99):
|
||||||
|
session.add(
|
||||||
|
UtxoEvent(
|
||||||
|
user_id=user_id,
|
||||||
|
txid=f"{i:064x}",
|
||||||
|
vout=0,
|
||||||
|
amount_sats=15_000_000,
|
||||||
|
confirmed_height=100,
|
||||||
|
)
|
||||||
|
)
|
||||||
|
await session.commit()
|
||||||
|
client = FakeElectrumClient()
|
||||||
|
|
||||||
|
async with session_factory() as session:
|
||||||
|
user = await session.get(User, user_id)
|
||||||
|
with pytest.raises(BetError) as excinfo:
|
||||||
|
await place_bet(session, client, user)
|
||||||
|
|
||||||
|
assert excinfo.value.code == "too_many_inputs"
|
||||||
|
assert excinfo.value.params == {"max_inputs": MAX_TX_INPUTS}
|
||||||
|
assert not client.broadcasted
|
||||||
|
|
||||||
|
|
||||||
async def test_place_bet_rejects_second_bet_same_round(session_factory):
|
async def test_place_bet_rejects_second_bet_same_round(session_factory):
|
||||||
user_id = await _make_funded_user(session_factory, 2, 3_000_000_000)
|
user_id = await _make_funded_user(session_factory, 2, 3_000_000_000)
|
||||||
client = FakeElectrumClient()
|
client = FakeElectrumClient()
|
||||||
@@ -166,6 +197,33 @@ async def test_failed_broadcast_leaves_nothing_behind(session_factory):
|
|||||||
assert "bet_placed" not in events
|
assert "bet_placed" not in events
|
||||||
|
|
||||||
|
|
||||||
|
async def test_failed_broadcast_publishes_an_sse_update(session_factory): # B-49
|
||||||
|
"""The rollback moves as much state as the successful path does, so it must ping
|
||||||
|
the dashboards the same way — otherwise the phantom bet stays on screen until the
|
||||||
|
next poll."""
|
||||||
|
user_id = await _make_funded_user(session_factory, 21, 3_000_000_000)
|
||||||
|
async with session_factory() as session:
|
||||||
|
# Open the round up front: place_bet would otherwise open it itself, and that
|
||||||
|
# publish() would satisfy the assertion below whether or not the rollback ever
|
||||||
|
# published one of its own.
|
||||||
|
await open_new_round_if_needed(session)
|
||||||
|
await session.commit()
|
||||||
|
|
||||||
|
queue = broadcaster.subscribe()
|
||||||
|
try:
|
||||||
|
while not queue.empty():
|
||||||
|
queue.get_nowait()
|
||||||
|
|
||||||
|
async with session_factory() as session:
|
||||||
|
user = await session.get(User, user_id)
|
||||||
|
with pytest.raises(BetError, match="refused"):
|
||||||
|
await place_bet(session, RejectingElectrumClient(), user)
|
||||||
|
|
||||||
|
assert not queue.empty()
|
||||||
|
finally:
|
||||||
|
broadcaster.unsubscribe(queue)
|
||||||
|
|
||||||
|
|
||||||
async def test_failed_broadcast_reports_the_broadcast_failed_code(session_factory):
|
async def test_failed_broadcast_reports_the_broadcast_failed_code(session_factory):
|
||||||
user_id = await _make_funded_user(session_factory, 5, 3_000_000_000)
|
user_id = await _make_funded_user(session_factory, 5, 3_000_000_000)
|
||||||
|
|
||||||
|
|||||||
+139
-23
@@ -3,7 +3,7 @@ from datetime import datetime, timedelta, timezone
|
|||||||
import pytest
|
import pytest
|
||||||
from embit import script
|
from embit import script
|
||||||
from embit.bip32 import HDKey
|
from embit.bip32 import HDKey
|
||||||
from embit.transaction import Transaction
|
from embit.transaction import Transaction, TransactionInput, TransactionOutput
|
||||||
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
|
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
|
||||||
|
|
||||||
from app.config import settings
|
from app.config import settings
|
||||||
@@ -58,12 +58,23 @@ def test_should_bump_measures_from_last_broadcast_not_first(monkeypatch):
|
|||||||
|
|
||||||
|
|
||||||
class FakeClient:
|
class FakeClient:
|
||||||
|
"""B-40: _prevout_amount now asks for the raw (non-verbose) transaction and
|
||||||
|
reads its output value as an integer via embit, rather than a verbose reply's
|
||||||
|
float "value" field — so this fake must hand back a real, parseable raw tx
|
||||||
|
whose vout[0] carries the requested amount (every test here spends vout 0 of
|
||||||
|
its fixture UTXO)."""
|
||||||
|
|
||||||
def __init__(self, prevout_values: dict[str, int]):
|
def __init__(self, prevout_values: dict[str, int]):
|
||||||
self._prevout_values = prevout_values
|
self._prevout_values = prevout_values
|
||||||
self.broadcasted: list[str] = []
|
self.broadcasted: list[str] = []
|
||||||
|
|
||||||
async def get_transaction(self, txid: str, verbose: bool = False) -> dict:
|
async def get_transaction(self, txid: str, verbose: bool = False) -> str:
|
||||||
return {"vout": {0: {"value": self._prevout_values[txid] / 100_000_000}}}
|
assert verbose is False
|
||||||
|
fake_prevout_tx = Transaction(
|
||||||
|
vin=[TransactionInput(b"\x00" * 32, 0)],
|
||||||
|
vout=[TransactionOutput(self._prevout_values[txid], script.Script(b"\x00\x14" + b"\x00" * 20))],
|
||||||
|
)
|
||||||
|
return fake_prevout_tx.serialize().hex()
|
||||||
|
|
||||||
async def broadcast(self, raw_tx_hex: str) -> str:
|
async def broadcast(self, raw_tx_hex: str) -> str:
|
||||||
self.broadcasted.append(raw_tx_hex)
|
self.broadcasted.append(raw_tx_hex)
|
||||||
@@ -130,9 +141,7 @@ async def test_bump_fee_shrinks_change_and_rebroadcasts(session_factory):
|
|||||||
|
|
||||||
client = FakeClient({utxo_txid: utxo_amount})
|
client = FakeClient({utxo_txid: utxo_amount})
|
||||||
|
|
||||||
async with session_factory() as session:
|
new_txid = await bump_fee(session_factory, client, pending_id)
|
||||||
row = await session.get(PendingTransaction, pending_id)
|
|
||||||
new_txid = await bump_fee(session, client, row)
|
|
||||||
|
|
||||||
assert client.broadcasted
|
assert client.broadcasted
|
||||||
assert new_txid != built.txid
|
assert new_txid != built.txid
|
||||||
@@ -197,9 +206,7 @@ async def test_bump_fee_leaves_broadcast_at_untouched(session_factory):
|
|||||||
client = FakeClient({utxo_txid: utxo_amount})
|
client = FakeClient({utxo_txid: utxo_amount})
|
||||||
before_bump = datetime.now(timezone.utc)
|
before_bump = datetime.now(timezone.utc)
|
||||||
|
|
||||||
async with session_factory() as session:
|
await bump_fee(session_factory, client, pending_id)
|
||||||
row = await session.get(PendingTransaction, pending_id)
|
|
||||||
await bump_fee(session, client, row)
|
|
||||||
|
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
row = await session.get(PendingTransaction, pending_id)
|
row = await session.get(PendingTransaction, pending_id)
|
||||||
@@ -246,10 +253,8 @@ async def test_bump_fee_raises_when_no_change_output(session_factory):
|
|||||||
|
|
||||||
client = FakeClient({utxo_txid: utxo_amount})
|
client = FakeClient({utxo_txid: utxo_amount})
|
||||||
|
|
||||||
async with session_factory() as session:
|
with pytest.raises(RbfError):
|
||||||
row = await session.get(PendingTransaction, pending_id)
|
await bump_fee(session_factory, client, pending_id)
|
||||||
with pytest.raises(RbfError):
|
|
||||||
await bump_fee(session, client, row)
|
|
||||||
|
|
||||||
|
|
||||||
async def test_bump_fee_retargets_every_stored_txid(session_factory):
|
async def test_bump_fee_retargets_every_stored_txid(session_factory):
|
||||||
@@ -303,9 +308,7 @@ async def test_bump_fee_retargets_every_stored_txid(session_factory):
|
|||||||
await session.commit()
|
await session.commit()
|
||||||
pending_id = pending.id
|
pending_id = pending.id
|
||||||
|
|
||||||
async with session_factory() as session:
|
new_txid = await bump_fee(session_factory, FakeClient({utxo_txid: utxo_amount}), pending_id)
|
||||||
row = await session.get(PendingTransaction, pending_id)
|
|
||||||
new_txid = await bump_fee(session, FakeClient({utxo_txid: utxo_amount}), row)
|
|
||||||
|
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
from sqlalchemy import select
|
from sqlalchemy import select
|
||||||
@@ -378,9 +381,7 @@ async def test_bump_fee_meets_bip125_minimum_when_old_fee_already_exceeds_target
|
|||||||
inflated_excess = 50_000
|
inflated_excess = 50_000
|
||||||
client = FakeClient({utxo_txid: utxo_amount + inflated_excess})
|
client = FakeClient({utxo_txid: utxo_amount + inflated_excess})
|
||||||
|
|
||||||
async with session_factory() as session:
|
new_txid = await bump_fee(session_factory, client, pending_id)
|
||||||
row = await session.get(PendingTransaction, pending_id)
|
|
||||||
new_txid = await bump_fee(session, client, row)
|
|
||||||
|
|
||||||
assert client.broadcasted
|
assert client.broadcasted
|
||||||
new_tx = Transaction.parse(bytes.fromhex(client.broadcasted[0]))
|
new_tx = Transaction.parse(bytes.fromhex(client.broadcasted[0]))
|
||||||
@@ -442,9 +443,124 @@ async def test_bump_fee_refuses_once_at_the_max_fee_rate(session_factory):
|
|||||||
|
|
||||||
client = FakeClient({utxo_txid: utxo_amount})
|
client = FakeClient({utxo_txid: utxo_amount})
|
||||||
|
|
||||||
async with session_factory() as session:
|
with pytest.raises(RbfError):
|
||||||
row = await session.get(PendingTransaction, pending_id)
|
await bump_fee(session_factory, client, pending_id)
|
||||||
with pytest.raises(RbfError):
|
|
||||||
await bump_fee(session, client, row)
|
|
||||||
|
|
||||||
assert not client.broadcasted
|
assert not client.broadcasted
|
||||||
|
|
||||||
|
|
||||||
|
# --- B-40: bump_fee must not hold a DB session open across its network calls,
|
||||||
|
# and a row that's no longer pending by the time it runs is a quiet no-op. -------
|
||||||
|
|
||||||
|
|
||||||
|
async def test_bump_fee_holds_no_session_open_during_network_calls(session_factory):
|
||||||
|
"""The get_transaction-per-input reads and the broadcast must happen with no
|
||||||
|
DB session held open — the same shape used elsewhere for this reason (B-18,
|
||||||
|
electrum/listener.py's refresh_user for B-31) — otherwise a session sits
|
||||||
|
idle in the pool for the whole duration of what can be several slow network
|
||||||
|
round-trips."""
|
||||||
|
from app.wallet.hd import derive_user_address, derive_user_key
|
||||||
|
|
||||||
|
signer = derive_user_key(0)
|
||||||
|
my_address = derive_user_address(0)
|
||||||
|
from_script = script.p2wpkh(signer.to_public())
|
||||||
|
to_address = script.p2wpkh(_key(94).to_public()).address(network=PLM_MAINNET)
|
||||||
|
|
||||||
|
utxo_amount = 150_000_000
|
||||||
|
utxo_txid = "77" * 32
|
||||||
|
built = build_signed_transaction(
|
||||||
|
signing_key=signer,
|
||||||
|
from_script=from_script,
|
||||||
|
utxos=[Utxo(utxo_txid, 0, utxo_amount)],
|
||||||
|
to_address=to_address,
|
||||||
|
amount_sats=10_000_000,
|
||||||
|
change_address=my_address,
|
||||||
|
fee_rate_sat_vb=1,
|
||||||
|
)
|
||||||
|
|
||||||
|
async with session_factory() as session:
|
||||||
|
user = User(username="frank", password_hash="x", derivation_index=0, address=my_address)
|
||||||
|
session.add(user)
|
||||||
|
await session.commit()
|
||||||
|
pending = PendingTransaction(
|
||||||
|
kind="bet",
|
||||||
|
user_id=user.id,
|
||||||
|
current_txid=built.txid,
|
||||||
|
fee_rate_sat_vb=1,
|
||||||
|
raw_tx_hex=built.raw_hex,
|
||||||
|
status="pending",
|
||||||
|
broadcast_at=datetime.now(timezone.utc) - timedelta(seconds=1000),
|
||||||
|
)
|
||||||
|
session.add(pending)
|
||||||
|
await session.commit()
|
||||||
|
pending_id = pending.id
|
||||||
|
|
||||||
|
open_count = {"n": 0}
|
||||||
|
|
||||||
|
class _TrackedSession:
|
||||||
|
def __init__(self, inner):
|
||||||
|
self._inner = inner
|
||||||
|
|
||||||
|
async def __aenter__(self):
|
||||||
|
result = await self._inner.__aenter__()
|
||||||
|
open_count["n"] += 1
|
||||||
|
return result
|
||||||
|
|
||||||
|
async def __aexit__(self, *exc):
|
||||||
|
open_count["n"] -= 1
|
||||||
|
return await self._inner.__aexit__(*exc)
|
||||||
|
|
||||||
|
def tracking_session_factory():
|
||||||
|
return _TrackedSession(session_factory())
|
||||||
|
|
||||||
|
class TrackingClient(FakeClient):
|
||||||
|
async def get_transaction(self, txid, verbose=False):
|
||||||
|
assert open_count["n"] == 0, "a session was held open during a network call"
|
||||||
|
return await super().get_transaction(txid, verbose)
|
||||||
|
|
||||||
|
async def broadcast(self, raw_tx_hex):
|
||||||
|
assert open_count["n"] == 0, "a session was held open during the broadcast"
|
||||||
|
return await super().broadcast(raw_tx_hex)
|
||||||
|
|
||||||
|
client = TrackingClient({utxo_txid: utxo_amount})
|
||||||
|
await bump_fee(tracking_session_factory, client, pending_id)
|
||||||
|
|
||||||
|
assert client.broadcasted
|
||||||
|
assert open_count["n"] == 0 # nothing left open afterwards either
|
||||||
|
|
||||||
|
|
||||||
|
async def test_bump_fee_is_a_noop_when_no_longer_pending(session_factory):
|
||||||
|
"""A row can legitimately confirm (or otherwise leave "pending") between
|
||||||
|
being read as due and RbfBumper actually attempting the bump — a normal
|
||||||
|
race, not an error. Must return quietly rather than raising or touching
|
||||||
|
the network."""
|
||||||
|
async with session_factory() as session:
|
||||||
|
user = User(username="grace", password_hash="x", derivation_index=0, address="plm1qxxx")
|
||||||
|
session.add(user)
|
||||||
|
await session.commit()
|
||||||
|
pending = PendingTransaction(
|
||||||
|
kind="bet",
|
||||||
|
user_id=user.id,
|
||||||
|
current_txid="already-confirmed-txid",
|
||||||
|
fee_rate_sat_vb=1,
|
||||||
|
raw_tx_hex="00",
|
||||||
|
status="confirmed",
|
||||||
|
broadcast_at=datetime.now(timezone.utc) - timedelta(seconds=1000),
|
||||||
|
)
|
||||||
|
session.add(pending)
|
||||||
|
await session.commit()
|
||||||
|
pending_id = pending.id
|
||||||
|
|
||||||
|
client = FakeClient({})
|
||||||
|
|
||||||
|
result = await bump_fee(session_factory, client, pending_id)
|
||||||
|
|
||||||
|
assert result is None
|
||||||
|
assert not client.broadcasted
|
||||||
|
|
||||||
|
|
||||||
|
async def test_bump_fee_is_a_noop_when_the_row_is_gone(session_factory):
|
||||||
|
client = FakeClient({})
|
||||||
|
result = await bump_fee(session_factory, client, 999_999)
|
||||||
|
assert result is None
|
||||||
|
assert not client.broadcasted
|
||||||
@@ -0,0 +1,181 @@
|
|||||||
|
import pytest
|
||||||
|
from cryptography.fernet import Fernet
|
||||||
|
from httpx import ASGITransport, AsyncClient
|
||||||
|
|
||||||
|
from app.config import settings
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture
|
||||||
|
async def client(monkeypatch, tmp_path):
|
||||||
|
monkeypatch.setattr(settings, "database_url", f"sqlite+aiosqlite:///{tmp_path}/test.db")
|
||||||
|
monkeypatch.setattr(settings, "admin_token", "test-admin-token")
|
||||||
|
monkeypatch.setattr(settings, "jwt_secret", "test-jwt-secret")
|
||||||
|
monkeypatch.setattr(settings, "xprv_encryption_key", Fernet.generate_key().decode())
|
||||||
|
monkeypatch.setattr(settings, "master_key_path", str(tmp_path / "master.xprv.enc"))
|
||||||
|
|
||||||
|
import app.wallet.hd as hd
|
||||||
|
|
||||||
|
hd._account_key = None
|
||||||
|
hd.generate_master_key()
|
||||||
|
|
||||||
|
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
|
||||||
|
|
||||||
|
from app.db import base as db_base
|
||||||
|
|
||||||
|
import app.db.models # noqa: F401
|
||||||
|
|
||||||
|
db_base.engine = create_async_engine(settings.database_url)
|
||||||
|
db_base.AsyncSessionLocal = async_sessionmaker(db_base.engine, expire_on_commit=False)
|
||||||
|
|
||||||
|
from app.db import session as db_session
|
||||||
|
|
||||||
|
db_session.AsyncSessionLocal = db_base.AsyncSessionLocal
|
||||||
|
|
||||||
|
async with db_base.engine.begin() as conn:
|
||||||
|
await conn.run_sync(db_base.Base.metadata.create_all)
|
||||||
|
|
||||||
|
from fastapi import FastAPI
|
||||||
|
|
||||||
|
from app.api.routes.admin import router as admin_router
|
||||||
|
from app.api.routes.bug_reports import router as bug_reports_router
|
||||||
|
from app.auth.routes import router as auth_router
|
||||||
|
from app.electrum.listener import ElectrumListener
|
||||||
|
|
||||||
|
app = FastAPI()
|
||||||
|
app.include_router(auth_router)
|
||||||
|
app.include_router(bug_reports_router)
|
||||||
|
app.include_router(admin_router)
|
||||||
|
app.state.electrum_listener = ElectrumListener(lambda endpoint: None, db_base.AsyncSessionLocal)
|
||||||
|
|
||||||
|
transport = ASGITransport(app=app)
|
||||||
|
async with AsyncClient(transport=transport, base_url="http://test") as ac:
|
||||||
|
yield ac
|
||||||
|
|
||||||
|
await db_base.engine.dispose()
|
||||||
|
|
||||||
|
|
||||||
|
_ADMIN_HEADERS = {"X-Admin-Token": "test-admin-token"}
|
||||||
|
|
||||||
|
|
||||||
|
async def _register(client, username="alice", password="original-password"):
|
||||||
|
resp = await client.post("/auth/register", json={"username": username, "password": password})
|
||||||
|
assert resp.status_code == 201
|
||||||
|
return resp.json()["access_token"]
|
||||||
|
|
||||||
|
|
||||||
|
async def test_anonymous_bug_report_has_no_user(client):
|
||||||
|
resp = await client.post("/bug-reports", json={"description": "the bet button does nothing"})
|
||||||
|
assert resp.status_code == 201
|
||||||
|
|
||||||
|
resp = await client.get("/admin/bug-reports", headers=_ADMIN_HEADERS)
|
||||||
|
assert resp.status_code == 200
|
||||||
|
reports = resp.json()
|
||||||
|
assert len(reports) == 1
|
||||||
|
assert reports[0]["description"] == "the bet button does nothing"
|
||||||
|
assert reports[0]["user_id"] is None
|
||||||
|
assert reports[0]["username"] is None
|
||||||
|
assert reports[0]["status"] == "open"
|
||||||
|
|
||||||
|
|
||||||
|
async def test_logged_in_bug_report_is_attributed_to_the_user(client):
|
||||||
|
token = await _register(client)
|
||||||
|
|
||||||
|
resp = await client.post(
|
||||||
|
"/bug-reports",
|
||||||
|
headers={"Authorization": f"Bearer {token}"},
|
||||||
|
json={"description": "withdrawal amount looks wrong", "contact": "alice@example.com"},
|
||||||
|
)
|
||||||
|
assert resp.status_code == 201
|
||||||
|
|
||||||
|
resp = await client.get("/admin/bug-reports", headers=_ADMIN_HEADERS)
|
||||||
|
reports = resp.json()
|
||||||
|
assert reports[0]["username"] == "alice"
|
||||||
|
assert reports[0]["contact"] == "alice@example.com"
|
||||||
|
|
||||||
|
|
||||||
|
async def test_user_can_see_own_report_status(client):
|
||||||
|
token = await _register(client)
|
||||||
|
headers = {"Authorization": f"Bearer {token}"}
|
||||||
|
|
||||||
|
resp = await client.post("/bug-reports", headers=headers, json={"description": "some bug"})
|
||||||
|
report_id = resp.json()["id"]
|
||||||
|
|
||||||
|
resp = await client.get("/bug-reports/mine", headers=headers)
|
||||||
|
assert resp.status_code == 200
|
||||||
|
reports = resp.json()
|
||||||
|
assert len(reports) == 1
|
||||||
|
assert reports[0]["id"] == report_id
|
||||||
|
assert reports[0]["status"] == "open"
|
||||||
|
|
||||||
|
await client.post(
|
||||||
|
f"/admin/bug-reports/{report_id}/status", headers=_ADMIN_HEADERS, json={"status": "read"}
|
||||||
|
)
|
||||||
|
resp = await client.get("/bug-reports/mine", headers=headers)
|
||||||
|
assert resp.json()[0]["status"] == "read"
|
||||||
|
|
||||||
|
|
||||||
|
async def test_bug_reports_mine_requires_auth(client):
|
||||||
|
resp = await client.get("/bug-reports/mine")
|
||||||
|
assert resp.status_code == 401
|
||||||
|
|
||||||
|
|
||||||
|
async def test_bug_reports_mine_only_returns_own_reports(client):
|
||||||
|
alice_token = await _register(client, username="alice")
|
||||||
|
bob_token = await _register(client, username="bob", password="bob-password")
|
||||||
|
|
||||||
|
await client.post(
|
||||||
|
"/bug-reports", headers={"Authorization": f"Bearer {alice_token}"}, json={"description": "alice's bug"}
|
||||||
|
)
|
||||||
|
|
||||||
|
resp = await client.get("/bug-reports/mine", headers={"Authorization": f"Bearer {bob_token}"})
|
||||||
|
assert resp.json() == []
|
||||||
|
|
||||||
|
|
||||||
|
async def test_blank_description_is_rejected(client):
|
||||||
|
resp = await client.post("/bug-reports", json={"description": " "})
|
||||||
|
assert resp.status_code == 422
|
||||||
|
|
||||||
|
|
||||||
|
async def test_admin_bug_reports_requires_token(client):
|
||||||
|
resp = await client.get("/admin/bug-reports")
|
||||||
|
assert resp.status_code == 403
|
||||||
|
|
||||||
|
|
||||||
|
async def test_admin_can_move_through_open_read_resolved(client):
|
||||||
|
resp = await client.post("/bug-reports", json={"description": "some bug"})
|
||||||
|
report_id = resp.json()["id"]
|
||||||
|
|
||||||
|
resp = await client.post(
|
||||||
|
f"/admin/bug-reports/{report_id}/status", headers=_ADMIN_HEADERS, json={"status": "read"}
|
||||||
|
)
|
||||||
|
assert resp.status_code == 200
|
||||||
|
assert resp.json()["status"] == "read"
|
||||||
|
|
||||||
|
resp = await client.post(
|
||||||
|
f"/admin/bug-reports/{report_id}/status", headers=_ADMIN_HEADERS, json={"status": "resolved"}
|
||||||
|
)
|
||||||
|
assert resp.status_code == 200
|
||||||
|
assert resp.json()["status"] == "resolved"
|
||||||
|
|
||||||
|
resp = await client.post(
|
||||||
|
f"/admin/bug-reports/{report_id}/status", headers=_ADMIN_HEADERS, json={"status": "open"}
|
||||||
|
)
|
||||||
|
assert resp.status_code == 200
|
||||||
|
assert resp.json()["status"] == "open"
|
||||||
|
|
||||||
|
|
||||||
|
async def test_update_status_rejects_unknown_value(client):
|
||||||
|
resp = await client.post("/bug-reports", json={"description": "some bug"})
|
||||||
|
report_id = resp.json()["id"]
|
||||||
|
|
||||||
|
resp = await client.post(
|
||||||
|
f"/admin/bug-reports/{report_id}/status", headers=_ADMIN_HEADERS, json={"status": "bogus"}
|
||||||
|
)
|
||||||
|
assert resp.status_code == 422
|
||||||
|
|
||||||
|
|
||||||
|
async def test_update_status_unknown_report_is_404(client):
|
||||||
|
resp = await client.post(
|
||||||
|
"/admin/bug-reports/999/status", headers=_ADMIN_HEADERS, json={"status": "read"}
|
||||||
|
)
|
||||||
|
assert resp.status_code == 404
|
||||||
@@ -0,0 +1,35 @@
|
|||||||
|
"""B-43: the Caddyfile must keep sending baseline security headers. Caddy adds
|
||||||
|
none of these on its own, and the JWT lives in localStorage, so a regression
|
||||||
|
here silently reopens an XSS/clickjacking exposure with no test ever failing
|
||||||
|
in the Python suite (the Caddyfile isn't imported/exercised by anything else)."""
|
||||||
|
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
CADDYFILE = (Path(__file__).parent.parent.parent / "Caddyfile").read_text()
|
||||||
|
|
||||||
|
|
||||||
|
def test_header_block_present():
|
||||||
|
assert "header {" in CADDYFILE
|
||||||
|
|
||||||
|
|
||||||
|
def test_hsts_is_set():
|
||||||
|
assert "Strict-Transport-Security" in CADDYFILE
|
||||||
|
assert "max-age=" in CADDYFILE
|
||||||
|
|
||||||
|
|
||||||
|
def test_nosniff_is_set():
|
||||||
|
assert 'X-Content-Type-Options "nosniff"' in CADDYFILE
|
||||||
|
|
||||||
|
|
||||||
|
def test_frame_ancestors_are_blocked():
|
||||||
|
assert 'X-Frame-Options "DENY"' in CADDYFILE
|
||||||
|
assert "frame-ancestors 'none'" in CADDYFILE
|
||||||
|
|
||||||
|
|
||||||
|
def test_referrer_policy_is_set():
|
||||||
|
assert "Referrer-Policy" in CADDYFILE
|
||||||
|
|
||||||
|
|
||||||
|
def test_csp_default_src_is_self():
|
||||||
|
assert "Content-Security-Policy" in CADDYFILE
|
||||||
|
assert "default-src 'self'" in CADDYFILE
|
||||||
@@ -0,0 +1,43 @@
|
|||||||
|
"""app.api.client_ip is shared by the login/registration throttles (B-33) and
|
||||||
|
the SSE per-IP subscriber cap (B-38) — both depend on it correctly preferring
|
||||||
|
X-Forwarded-For (Caddy reverse-proxies every request, see Caddyfile) over
|
||||||
|
request.client.host, which would otherwise be the proxy's own address."""
|
||||||
|
|
||||||
|
from starlette.requests import Request
|
||||||
|
|
||||||
|
from app.api.client_ip import client_ip
|
||||||
|
|
||||||
|
|
||||||
|
def _request(*, forwarded: str | None = None, client_host: str | None = "127.0.0.1") -> Request:
|
||||||
|
headers = [(b"x-forwarded-for", forwarded.encode())] if forwarded else []
|
||||||
|
scope = {
|
||||||
|
"type": "http",
|
||||||
|
"headers": headers,
|
||||||
|
"client": (client_host, 12345) if client_host else None,
|
||||||
|
}
|
||||||
|
return Request(scope)
|
||||||
|
|
||||||
|
|
||||||
|
def test_client_ip_prefers_x_forwarded_for():
|
||||||
|
request = _request(forwarded="5.6.7.8", client_host="10.0.0.1")
|
||||||
|
assert client_ip(request) == "5.6.7.8"
|
||||||
|
|
||||||
|
|
||||||
|
def test_client_ip_takes_the_first_hop_of_a_forwarded_chain():
|
||||||
|
request = _request(forwarded="5.6.7.8, 10.0.0.1, 172.17.0.1")
|
||||||
|
assert client_ip(request) == "5.6.7.8"
|
||||||
|
|
||||||
|
|
||||||
|
def test_client_ip_strips_whitespace():
|
||||||
|
request = _request(forwarded=" 5.6.7.8 , 10.0.0.1")
|
||||||
|
assert client_ip(request) == "5.6.7.8"
|
||||||
|
|
||||||
|
|
||||||
|
def test_client_ip_falls_back_to_request_client_without_the_header():
|
||||||
|
request = _request(forwarded=None, client_host="10.0.0.1")
|
||||||
|
assert client_ip(request) == "10.0.0.1"
|
||||||
|
|
||||||
|
|
||||||
|
def test_client_ip_falls_back_to_unknown_with_neither():
|
||||||
|
request = _request(forwarded=None, client_host=None)
|
||||||
|
assert client_ip(request) == "unknown"
|
||||||
+132
-36
@@ -1,41 +1,83 @@
|
|||||||
import pytest
|
import pytest
|
||||||
from sqlalchemy import select
|
|
||||||
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
|
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
|
||||||
|
|
||||||
import app.bets.confirmation # noqa: F401 (registers the "bet" handler)
|
import app.bets.confirmation # noqa: F401 (registers the "bet" handler)
|
||||||
import app.rounds.confirmation # noqa: F401 (registers the "payout" handler)
|
import app.rounds.confirmation # noqa: F401 (registers the "payout" handler)
|
||||||
|
from sqlalchemy import select
|
||||||
|
|
||||||
|
from app.config import settings
|
||||||
from app.db.base import Base
|
from app.db.base import Base
|
||||||
from app.db.models import PendingTransaction, Round, RoundParticipant
|
from app.db.models import PendingTransaction, Round, RoundParticipant, User
|
||||||
|
from app.electrum.scripthash import address_to_scripthash
|
||||||
from app.tx.confirmation import poll_once
|
from app.tx.confirmation import poll_once
|
||||||
|
from app.wallet.hd import derive_user_address
|
||||||
|
|
||||||
|
|
||||||
class FakeClient:
|
class FakeClient:
|
||||||
def __init__(self, confirmations_by_txid: dict[str, int]):
|
"""B-41: poll_once now asks blockchain.scripthash.get_history rather than a
|
||||||
self._confirmations = confirmations_by_txid
|
verbose blockchain.transaction.get, so this hands back a flat history —
|
||||||
|
height > 0 means confirmed at that height, 0 (or absent) means still in the
|
||||||
|
mempool. The scripthash argument is ignored: every candidate's derived
|
||||||
|
address is looked up against the same known universe of txids, which is
|
||||||
|
fine since matching happens on tx_hash, not on which address asked."""
|
||||||
|
|
||||||
async def get_transaction(self, txid: str, verbose: bool = False) -> dict:
|
def __init__(self, heights_by_txid: dict[str, int]):
|
||||||
return {"confirmations": self._confirmations.get(txid, 0)}
|
self._heights = heights_by_txid
|
||||||
|
|
||||||
|
async def get_history(self, scripthash: str) -> list[dict]:
|
||||||
|
return [{"tx_hash": txid, "height": height} for txid, height in self._heights.items()]
|
||||||
|
|
||||||
|
|
||||||
@pytest.fixture
|
@pytest.fixture
|
||||||
async def session_factory():
|
async def session_factory(tmp_path, monkeypatch):
|
||||||
|
# own_address_for (B-41) derives each row's address via the HD wallet, so
|
||||||
|
# poll_once now needs a real master key — same bootstrap test_broadcast.py
|
||||||
|
# and test_reconcile.py use.
|
||||||
|
monkeypatch.setattr(settings, "master_key_path", str(tmp_path / "master.xprv.enc"))
|
||||||
|
monkeypatch.setattr(
|
||||||
|
settings,
|
||||||
|
"xprv_encryption_key",
|
||||||
|
__import__("cryptography.fernet", fromlist=["Fernet"]).Fernet.generate_key().decode(),
|
||||||
|
)
|
||||||
|
from app.wallet import hd
|
||||||
|
|
||||||
|
hd._account_key = None
|
||||||
|
hd.generate_master_key()
|
||||||
|
|
||||||
engine = create_async_engine("sqlite+aiosqlite:///:memory:")
|
engine = create_async_engine("sqlite+aiosqlite:///:memory:")
|
||||||
async with engine.begin() as conn:
|
async with engine.begin() as conn:
|
||||||
await conn.run_sync(Base.metadata.create_all)
|
await conn.run_sync(Base.metadata.create_all)
|
||||||
yield async_sessionmaker(engine, expire_on_commit=False)
|
yield async_sessionmaker(engine, expire_on_commit=False)
|
||||||
await engine.dispose()
|
await engine.dispose()
|
||||||
|
hd._account_key = None
|
||||||
|
|
||||||
|
|
||||||
|
async def _make_user(session, derivation_index: int) -> User:
|
||||||
|
user = User(
|
||||||
|
username=f"user{derivation_index}",
|
||||||
|
password_hash="x",
|
||||||
|
derivation_index=derivation_index,
|
||||||
|
address=derive_user_address(derivation_index),
|
||||||
|
)
|
||||||
|
session.add(user)
|
||||||
|
await session.flush()
|
||||||
|
return user
|
||||||
|
|
||||||
|
|
||||||
async def test_bet_confirmation_marks_participant_confirmed(session_factory):
|
async def test_bet_confirmation_marks_participant_confirmed(session_factory):
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
|
user = await _make_user(session, 0)
|
||||||
session.add(Round(id=1, status="open"))
|
session.add(Round(id=1, status="open"))
|
||||||
session.add(
|
session.add(
|
||||||
RoundParticipant(
|
RoundParticipant(
|
||||||
round_id=1, user_id=1, bet_amount_sats=1_000, bet_txid="tx1", status="broadcast"
|
round_id=1, user_id=user.id, bet_amount_sats=1_000, bet_txid="tx1", status="broadcast"
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
session.add(
|
session.add(
|
||||||
PendingTransaction(kind="bet", round_id=1, user_id=1, current_txid="tx1", fee_rate_sat_vb=1, raw_tx_hex="00", status="pending")
|
PendingTransaction(
|
||||||
|
kind="bet", round_id=1, user_id=user.id, current_txid="tx1", fee_rate_sat_vb=1,
|
||||||
|
raw_tx_hex="00", status="pending",
|
||||||
|
)
|
||||||
)
|
)
|
||||||
await session.commit()
|
await session.commit()
|
||||||
|
|
||||||
@@ -53,9 +95,17 @@ async def test_bet_confirmation_marks_participant_confirmed(session_factory):
|
|||||||
|
|
||||||
async def test_unconfirmed_tx_is_left_pending(session_factory):
|
async def test_unconfirmed_tx_is_left_pending(session_factory):
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
|
user = await _make_user(session, 0)
|
||||||
session.add(Round(id=2, status="open"))
|
session.add(Round(id=2, status="open"))
|
||||||
session.add(RoundParticipant(round_id=2, user_id=1, bet_amount_sats=1_000, bet_txid="tx2", status="broadcast"))
|
session.add(
|
||||||
session.add(PendingTransaction(kind="bet", round_id=2, user_id=1, current_txid="tx2", fee_rate_sat_vb=1, raw_tx_hex="00", status="pending"))
|
RoundParticipant(round_id=2, user_id=user.id, bet_amount_sats=1_000, bet_txid="tx2", status="broadcast")
|
||||||
|
)
|
||||||
|
session.add(
|
||||||
|
PendingTransaction(
|
||||||
|
kind="bet", round_id=2, user_id=user.id, current_txid="tx2", fee_rate_sat_vb=1,
|
||||||
|
raw_tx_hex="00", status="pending",
|
||||||
|
)
|
||||||
|
)
|
||||||
await session.commit()
|
await session.commit()
|
||||||
|
|
||||||
client = FakeClient({"tx2": 0})
|
client = FakeClient({"tx2": 0})
|
||||||
@@ -70,7 +120,11 @@ async def test_unconfirmed_tx_is_left_pending(session_factory):
|
|||||||
async def test_payout_confirmation_closes_round(session_factory):
|
async def test_payout_confirmation_closes_round(session_factory):
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
session.add(Round(id=3, status="paying_out", payout_txid="tx3"))
|
session.add(Round(id=3, status="paying_out", payout_txid="tx3"))
|
||||||
session.add(PendingTransaction(kind="payout", round_id=3, current_txid="tx3", fee_rate_sat_vb=1, raw_tx_hex="00", status="pending"))
|
session.add(
|
||||||
|
PendingTransaction(
|
||||||
|
kind="payout", round_id=3, current_txid="tx3", fee_rate_sat_vb=1, raw_tx_hex="00", status="pending"
|
||||||
|
)
|
||||||
|
)
|
||||||
await session.commit()
|
await session.commit()
|
||||||
|
|
||||||
client = FakeClient({"tx3": 2})
|
client = FakeClient({"tx3": 2})
|
||||||
@@ -83,43 +137,52 @@ async def test_payout_confirmation_closes_round(session_factory):
|
|||||||
|
|
||||||
|
|
||||||
class ExplodingClient:
|
class ExplodingClient:
|
||||||
"""Answers for one txid and raises for the other — a tx the server no longer
|
"""Answers for one address's history and raises for the other's — the
|
||||||
knows (dropped from the mempool, replaced by a bump)."""
|
get_history equivalent of a server that no longer knows a particular tx
|
||||||
|
(dropped from the mempool, replaced by a bump)."""
|
||||||
|
|
||||||
def __init__(self, known: dict[str, int], exploding_txid: str):
|
def __init__(self, heights_by_txid: dict[str, int], exploding_scripthash: str):
|
||||||
self._known = known
|
self._heights = heights_by_txid
|
||||||
self._exploding = exploding_txid
|
self._exploding = exploding_scripthash
|
||||||
|
|
||||||
async def get_transaction(self, txid: str, verbose: bool = False) -> dict:
|
async def get_history(self, scripthash: str) -> list[dict]:
|
||||||
if txid == self._exploding:
|
if scripthash == self._exploding:
|
||||||
raise RuntimeError("missing transaction")
|
raise RuntimeError("server error")
|
||||||
return {"confirmations": self._known.get(txid, 0)}
|
return [{"tx_hash": txid, "height": height} for txid, height in self._heights.items()]
|
||||||
|
|
||||||
|
|
||||||
async def test_one_unresolvable_txid_does_not_block_the_others(session_factory):
|
async def test_one_unresolvable_candidate_does_not_block_the_others(session_factory):
|
||||||
"""B-03: the lookup used to be unguarded, so a single unknown txid aborted the
|
"""B-03: the lookup used to be unguarded, so a single failing candidate aborted
|
||||||
whole pass — nothing confirmed again until an operator intervened, which in turn
|
the whole pass — nothing confirmed again until an operator intervened, which in
|
||||||
meant no round could ever close."""
|
turn meant no round could ever close. B-41 changed the failure unit from "one
|
||||||
|
txid" to "one address's history", but the isolation guarantee is the same."""
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
|
good_user = await _make_user(session, 0)
|
||||||
|
gone_user = await _make_user(session, 1)
|
||||||
session.add(Round(id=10, status="open"))
|
session.add(Round(id=10, status="open"))
|
||||||
session.add(
|
session.add(
|
||||||
RoundParticipant(round_id=10, user_id=1, bet_amount_sats=1_000, bet_txid="good", status="broadcast")
|
RoundParticipant(
|
||||||
)
|
round_id=10, user_id=good_user.id, bet_amount_sats=1_000, bet_txid="good", status="broadcast"
|
||||||
session.add(
|
|
||||||
PendingTransaction(
|
|
||||||
kind="bet", round_id=10, user_id=2, current_txid="gone", fee_rate_sat_vb=1, raw_tx_hex="00",
|
|
||||||
status="pending",
|
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
session.add(
|
session.add(
|
||||||
PendingTransaction(
|
PendingTransaction(
|
||||||
kind="bet", round_id=10, user_id=1, current_txid="good", fee_rate_sat_vb=1, raw_tx_hex="00",
|
kind="bet", round_id=10, user_id=gone_user.id, current_txid="gone", fee_rate_sat_vb=1,
|
||||||
status="pending",
|
raw_tx_hex="00", status="pending",
|
||||||
|
)
|
||||||
|
)
|
||||||
|
session.add(
|
||||||
|
PendingTransaction(
|
||||||
|
kind="bet", round_id=10, user_id=good_user.id, current_txid="good", fee_rate_sat_vb=1,
|
||||||
|
raw_tx_hex="00", status="pending",
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
await session.commit()
|
await session.commit()
|
||||||
|
|
||||||
confirmed = await poll_once(session_factory, ExplodingClient({"good": 1}, exploding_txid="gone"))
|
exploding_scripthash = address_to_scripthash(derive_user_address(1))
|
||||||
|
confirmed = await poll_once(
|
||||||
|
session_factory, ExplodingClient({"good": 1}, exploding_scripthash=exploding_scripthash)
|
||||||
|
)
|
||||||
assert confirmed == 1 # the healthy one still got processed
|
assert confirmed == 1 # the healthy one still got processed
|
||||||
|
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
@@ -135,15 +198,16 @@ async def test_bet_confirms_after_an_rbf_bump_changed_the_txid(session_factory):
|
|||||||
a txid no participant carried — the participant stayed "broadcast" forever and
|
a txid no participant carried — the participant stayed "broadcast" forever and
|
||||||
the round could never close. It now resolves by (round_id, user_id)."""
|
the round could never close. It now resolves by (round_id, user_id)."""
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
|
user = await _make_user(session, 0)
|
||||||
session.add(Round(id=11, status="open"))
|
session.add(Round(id=11, status="open"))
|
||||||
session.add(
|
session.add(
|
||||||
RoundParticipant(
|
RoundParticipant(
|
||||||
round_id=11, user_id=7, bet_amount_sats=1_000, bet_txid="old-txid", status="broadcast"
|
round_id=11, user_id=user.id, bet_amount_sats=1_000, bet_txid="old-txid", status="broadcast"
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
session.add(
|
session.add(
|
||||||
PendingTransaction(
|
PendingTransaction(
|
||||||
kind="bet", round_id=11, user_id=7, current_txid="bumped-txid", fee_rate_sat_vb=2,
|
kind="bet", round_id=11, user_id=user.id, current_txid="bumped-txid", fee_rate_sat_vb=2,
|
||||||
raw_tx_hex="00", status="pending", replaced_by_txid="old-txid",
|
raw_tx_hex="00", status="pending", replaced_by_txid="old-txid",
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
@@ -171,3 +235,35 @@ async def test_payout_confirms_after_an_rbf_bump_changed_the_txid(session_factor
|
|||||||
|
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
assert (await session.get(Round, 12)).status == "closed"
|
assert (await session.get(Round, 12)).status == "closed"
|
||||||
|
|
||||||
|
|
||||||
|
async def test_poll_once_caches_history_per_scripthash(session_factory):
|
||||||
|
"""Two pending bets from the same user share one address — fetching its
|
||||||
|
history twice in one pass would be wasteful."""
|
||||||
|
async with session_factory() as session:
|
||||||
|
user = await _make_user(session, 0)
|
||||||
|
session.add(Round(id=20, status="open"))
|
||||||
|
session.add(
|
||||||
|
PendingTransaction(
|
||||||
|
kind="bet", round_id=20, user_id=user.id, current_txid="tx-a", fee_rate_sat_vb=1,
|
||||||
|
raw_tx_hex="00", status="pending",
|
||||||
|
)
|
||||||
|
)
|
||||||
|
session.add(
|
||||||
|
PendingTransaction(
|
||||||
|
kind="withdrawal", user_id=user.id, current_txid="tx-b", fee_rate_sat_vb=1,
|
||||||
|
raw_tx_hex="00", status="pending",
|
||||||
|
)
|
||||||
|
)
|
||||||
|
await session.commit()
|
||||||
|
|
||||||
|
call_count = {"n": 0}
|
||||||
|
|
||||||
|
class CountingClient:
|
||||||
|
async def get_history(self, scripthash: str) -> list[dict]:
|
||||||
|
call_count["n"] += 1
|
||||||
|
return [{"tx_hash": "tx-a", "height": 0}, {"tx_hash": "tx-b", "height": 0}]
|
||||||
|
|
||||||
|
await poll_once(session_factory, CountingClient())
|
||||||
|
|
||||||
|
assert call_count["n"] == 1
|
||||||
@@ -0,0 +1,61 @@
|
|||||||
|
"""Regression tests for B-39: SQLite must run in WAL mode with a busy_timeout,
|
||||||
|
since this app has five concurrent background tasks plus every HTTP handler
|
||||||
|
sharing one database file, and the default rollback-journal mode lets a writer
|
||||||
|
block every reader and fails a second writer immediately instead of waiting."""
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
from sqlalchemy.ext.asyncio import create_async_engine
|
||||||
|
|
||||||
|
from app.db.base import _SQLITE_BUSY_TIMEOUT_MS, _register_sqlite_pragmas
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture
|
||||||
|
async def sqlite_engine(tmp_path):
|
||||||
|
# WAL needs a real file (it writes a companion -wal/-shm file alongside it) —
|
||||||
|
# ":memory:" wouldn't exercise the same path.
|
||||||
|
engine = create_async_engine(f"sqlite+aiosqlite:///{tmp_path}/test.db")
|
||||||
|
yield engine
|
||||||
|
await engine.dispose()
|
||||||
|
|
||||||
|
|
||||||
|
async def _pragma(engine, name: str):
|
||||||
|
async with engine.connect() as conn:
|
||||||
|
result = await conn.exec_driver_sql(f"PRAGMA {name}")
|
||||||
|
return result.fetchone()[0]
|
||||||
|
|
||||||
|
|
||||||
|
async def test_register_sqlite_pragmas_enables_wal_and_busy_timeout(sqlite_engine):
|
||||||
|
_register_sqlite_pragmas(sqlite_engine)
|
||||||
|
|
||||||
|
assert (await _pragma(sqlite_engine, "journal_mode")).lower() == "wal"
|
||||||
|
assert await _pragma(sqlite_engine, "busy_timeout") == _SQLITE_BUSY_TIMEOUT_MS
|
||||||
|
assert await _pragma(sqlite_engine, "synchronous") == 1 # NORMAL
|
||||||
|
|
||||||
|
|
||||||
|
async def test_register_sqlite_pragmas_applies_to_every_new_connection(sqlite_engine):
|
||||||
|
"""The pool can open more than one underlying DBAPI connection over the
|
||||||
|
engine's lifetime — the pragmas must be re-applied to each one, not just
|
||||||
|
the first, or a later connection would silently fall back to SQLite's
|
||||||
|
defaults."""
|
||||||
|
_register_sqlite_pragmas(sqlite_engine)
|
||||||
|
|
||||||
|
async with sqlite_engine.connect() as first:
|
||||||
|
await first.exec_driver_sql("PRAGMA journal_mode")
|
||||||
|
|
||||||
|
async with sqlite_engine.connect() as second:
|
||||||
|
result = await second.exec_driver_sql("PRAGMA busy_timeout")
|
||||||
|
assert result.fetchone()[0] == _SQLITE_BUSY_TIMEOUT_MS
|
||||||
|
|
||||||
|
|
||||||
|
def test_register_sqlite_pragmas_is_a_noop_for_other_dialects():
|
||||||
|
"""Must not touch (or crash on) a non-sqlite engine — e.g. a future
|
||||||
|
PostgreSQL DATABASE_URL, which neither needs nor understands these
|
||||||
|
pragmas."""
|
||||||
|
|
||||||
|
class _FakeDialect:
|
||||||
|
name = "postgresql"
|
||||||
|
|
||||||
|
class _FakeEngine:
|
||||||
|
dialect = _FakeDialect()
|
||||||
|
|
||||||
|
_register_sqlite_pragmas(_FakeEngine()) # must not raise
|
||||||
@@ -0,0 +1,28 @@
|
|||||||
|
"""B-42: Swagger/ReDoc/OpenAPI JSON must not be reachable unless explicitly enabled —
|
||||||
|
they enumerate the whole API surface, admin endpoints included."""
|
||||||
|
|
||||||
|
import importlib
|
||||||
|
|
||||||
|
from app.config import settings
|
||||||
|
|
||||||
|
|
||||||
|
def _reload_main():
|
||||||
|
import app.main
|
||||||
|
|
||||||
|
return importlib.reload(app.main)
|
||||||
|
|
||||||
|
|
||||||
|
def test_docs_disabled_by_default(monkeypatch):
|
||||||
|
monkeypatch.setattr(settings, "enable_api_docs", False)
|
||||||
|
main = _reload_main()
|
||||||
|
assert main.app.docs_url is None
|
||||||
|
assert main.app.redoc_url is None
|
||||||
|
assert main.app.openapi_url is None
|
||||||
|
|
||||||
|
|
||||||
|
def test_docs_enabled_when_configured(monkeypatch):
|
||||||
|
monkeypatch.setattr(settings, "enable_api_docs", True)
|
||||||
|
main = _reload_main()
|
||||||
|
assert main.app.docs_url == "/docs"
|
||||||
|
assert main.app.redoc_url == "/redoc"
|
||||||
|
assert main.app.openapi_url == "/openapi.json"
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
"""B-44: README and docs/running-the-server.md must not document a bare
|
||||||
|
`uvicorn --reload` workflow — the server always runs via Docker, in dev and
|
||||||
|
production alike (CLAUDE.md's "Commands" section), and the two files had
|
||||||
|
drifted back to contradicting that policy."""
|
||||||
|
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
REPO_ROOT = Path(__file__).parent.parent.parent
|
||||||
|
|
||||||
|
|
||||||
|
def test_readme_has_no_bare_uvicorn_command():
|
||||||
|
readme = (REPO_ROOT / "README.md").read_text()
|
||||||
|
assert "uvicorn app.main:app --reload" not in readme
|
||||||
|
|
||||||
|
|
||||||
|
def test_running_the_server_doc_has_no_bare_uvicorn_command():
|
||||||
|
doc = (REPO_ROOT / "docs" / "running-the-server.md").read_text()
|
||||||
|
assert "uvicorn app.main:app --reload" not in doc
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
"""B-47: raw_tx_hex (a full raw signed transaction hex) and payload_json (an
|
||||||
|
arbitrary audit payload) must stay `Text`, not a bare `String`/`VARCHAR` with
|
||||||
|
no length -- SQLite and PostgreSQL accept that, but other backends (e.g.
|
||||||
|
MySQL) require a length on VARCHAR and would reject it."""
|
||||||
|
|
||||||
|
from sqlalchemy import Text
|
||||||
|
|
||||||
|
from app.db.models import AuditLog, PendingTransaction
|
||||||
|
|
||||||
|
|
||||||
|
def test_pending_transaction_raw_tx_hex_is_text():
|
||||||
|
assert isinstance(PendingTransaction.__table__.c.raw_tx_hex.type, Text)
|
||||||
|
|
||||||
|
|
||||||
|
def test_audit_log_payload_json_is_text():
|
||||||
|
assert isinstance(AuditLog.__table__.c.payload_json.type, Text)
|
||||||
@@ -0,0 +1,55 @@
|
|||||||
|
"""B-41: own_address_for is the single place tx/confirmation.py and
|
||||||
|
tx/reconcile.py derive a PendingTransaction's own address from — a payout's
|
||||||
|
address must always be the pool's, everything else the actual user's."""
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
|
||||||
|
|
||||||
|
from app.config import settings
|
||||||
|
from app.db.base import Base
|
||||||
|
from app.db.models import User
|
||||||
|
from app.tx.pending_address import own_address_for
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture
|
||||||
|
async def session_factory(tmp_path, monkeypatch):
|
||||||
|
monkeypatch.setattr(settings, "master_key_path", str(tmp_path / "master.xprv.enc"))
|
||||||
|
monkeypatch.setattr(
|
||||||
|
settings,
|
||||||
|
"xprv_encryption_key",
|
||||||
|
__import__("cryptography.fernet", fromlist=["Fernet"]).Fernet.generate_key().decode(),
|
||||||
|
)
|
||||||
|
from app.wallet import hd
|
||||||
|
|
||||||
|
hd._account_key = None
|
||||||
|
hd.generate_master_key()
|
||||||
|
|
||||||
|
engine = create_async_engine("sqlite+aiosqlite:///:memory:")
|
||||||
|
async with engine.begin() as conn:
|
||||||
|
await conn.run_sync(Base.metadata.create_all)
|
||||||
|
yield async_sessionmaker(engine, expire_on_commit=False)
|
||||||
|
await engine.dispose()
|
||||||
|
hd._account_key = None
|
||||||
|
|
||||||
|
|
||||||
|
async def test_payout_uses_the_pool_address_regardless_of_user_id(session_factory):
|
||||||
|
from app.wallet.hd import derive_pool_address
|
||||||
|
|
||||||
|
async with session_factory() as session:
|
||||||
|
address = await own_address_for(session, "payout", None)
|
||||||
|
|
||||||
|
assert address == derive_pool_address()
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.parametrize("kind", ["bet", "withdrawal"])
|
||||||
|
async def test_bet_and_withdrawal_use_the_users_own_address(session_factory, kind):
|
||||||
|
from app.wallet.hd import derive_user_address
|
||||||
|
|
||||||
|
async with session_factory() as session:
|
||||||
|
user = User(username="alice", password_hash="x", derivation_index=3, address=derive_user_address(3))
|
||||||
|
session.add(user)
|
||||||
|
await session.flush()
|
||||||
|
|
||||||
|
address = await own_address_for(session, kind, user.id)
|
||||||
|
|
||||||
|
assert address == derive_user_address(3)
|
||||||
@@ -5,6 +5,7 @@ from embit.transaction import Transaction
|
|||||||
|
|
||||||
from app.wallet.plm_network import PLM_MAINNET
|
from app.wallet.plm_network import PLM_MAINNET
|
||||||
from app.wallet.psbt_builder import (
|
from app.wallet.psbt_builder import (
|
||||||
|
MAX_TX_INPUTS,
|
||||||
InsufficientFundsError,
|
InsufficientFundsError,
|
||||||
Utxo,
|
Utxo,
|
||||||
build_signed_transaction,
|
build_signed_transaction,
|
||||||
@@ -36,6 +37,22 @@ def test_select_utxos_raises_when_insufficient():
|
|||||||
select_utxos(utxos, target_sats=10_000_000)
|
select_utxos(utxos, target_sats=10_000_000)
|
||||||
|
|
||||||
|
|
||||||
|
def test_select_utxos_never_exceeds_the_input_cap(): # B-48
|
||||||
|
# 200 dust-ish UTXOs that together cover the target, but only past the cap.
|
||||||
|
utxos = [Utxo(f"{i:064x}", 0, 100_000) for i in range(200)]
|
||||||
|
with pytest.raises(InsufficientFundsError) as excinfo:
|
||||||
|
select_utxos(utxos, target_sats=100_000 * MAX_TX_INPUTS + 1)
|
||||||
|
assert excinfo.value.code == "too_many_inputs"
|
||||||
|
assert excinfo.value.params == {"max_inputs": MAX_TX_INPUTS}
|
||||||
|
|
||||||
|
|
||||||
|
def test_select_utxos_allows_exactly_the_input_cap():
|
||||||
|
utxos = [Utxo(f"{i:064x}", 0, 100_000) for i in range(200)]
|
||||||
|
selected, total = select_utxos(utxos, target_sats=100_000 * MAX_TX_INPUTS)
|
||||||
|
assert len(selected) == MAX_TX_INPUTS
|
||||||
|
assert total == 100_000 * MAX_TX_INPUTS
|
||||||
|
|
||||||
|
|
||||||
def test_build_signed_transaction_deducts_fee_from_amount_not_change():
|
def test_build_signed_transaction_deducts_fee_from_amount_not_change():
|
||||||
signer = _key(1)
|
signer = _key(1)
|
||||||
from_script = script.p2wpkh(signer.to_public())
|
from_script = script.p2wpkh(signer.to_public())
|
||||||
|
|||||||
@@ -1,5 +1,10 @@
|
|||||||
"""Regression tests for B-04 (and the "building" half of B-08): a transaction that
|
"""Regression tests for B-04 (and the "building" half of B-08): a transaction that
|
||||||
never made it onto the chain must give the coins back instead of freezing them."""
|
never made it onto the chain must give the coins back instead of freezing them.
|
||||||
|
|
||||||
|
Also covers B-41: existence/reconciliation checks go through
|
||||||
|
blockchain.scripthash.get_history rather than a verbose blockchain.transaction.get
|
||||||
|
reply, so the fake clients below implement get_history.
|
||||||
|
"""
|
||||||
|
|
||||||
import pytest
|
import pytest
|
||||||
from embit import script
|
from embit import script
|
||||||
@@ -7,37 +12,60 @@ from embit.transaction import Transaction, TransactionInput, TransactionOutput
|
|||||||
from sqlalchemy import select
|
from sqlalchemy import select
|
||||||
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
|
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
|
||||||
|
|
||||||
|
from app.config import settings
|
||||||
from app.db.base import Base
|
from app.db.base import Base
|
||||||
from app.db.models import AuditLog, PendingTransaction, RoundParticipant, User, UtxoEvent, Withdrawal
|
from app.db.models import AuditLog, PendingTransaction, RoundParticipant, User, UtxoEvent, Withdrawal
|
||||||
from app.tx.reconcile import reconcile_once
|
from app.tx.reconcile import reconcile_once
|
||||||
|
|
||||||
|
|
||||||
class UnknownTxClient:
|
class UnknownTxClient:
|
||||||
"""A server that doesn't know any of the txids it's asked about."""
|
"""A server whose history for any address never includes our txid."""
|
||||||
|
|
||||||
async def get_transaction(self, txid: str, verbose: bool = False):
|
async def get_history(self, scripthash: str) -> list[dict]:
|
||||||
raise RuntimeError(f"missing transaction {txid}")
|
return []
|
||||||
|
|
||||||
|
|
||||||
class KnownTxClient:
|
class KnownTxClient:
|
||||||
async def get_transaction(self, txid: str, verbose: bool = False):
|
"""A server whose history for the address includes our txid — mined or
|
||||||
return {"txid": txid, "confirmations": 0}
|
still in the mempool doesn't matter for existence, only for confirmation
|
||||||
|
(which is tx/confirmation.py's concern, not reconcile.py's)."""
|
||||||
|
|
||||||
|
def __init__(self, txid: str = "betxid"):
|
||||||
|
self._txid = txid
|
||||||
|
|
||||||
|
async def get_history(self, scripthash: str) -> list[dict]:
|
||||||
|
return [{"tx_hash": self._txid, "height": 100}]
|
||||||
|
|
||||||
|
|
||||||
class BrokenClient:
|
class BrokenClient:
|
||||||
"""A transport failure — says nothing about whether the tx exists."""
|
"""A transport failure — says nothing about whether the tx exists."""
|
||||||
|
|
||||||
async def get_transaction(self, txid: str, verbose: bool = False):
|
async def get_history(self, scripthash: str) -> list[dict]:
|
||||||
raise ConnectionResetError("connection reset")
|
raise ConnectionResetError("connection reset")
|
||||||
|
|
||||||
|
|
||||||
@pytest.fixture
|
@pytest.fixture
|
||||||
async def session_factory():
|
async def session_factory(tmp_path, monkeypatch):
|
||||||
|
# own_address_for (B-41) derives each row's address via the HD wallet rather
|
||||||
|
# than trusting the DB's address column, so reconcile_once now needs a real
|
||||||
|
# master key set up — same bootstrap test_broadcast.py uses.
|
||||||
|
monkeypatch.setattr(settings, "master_key_path", str(tmp_path / "master.xprv.enc"))
|
||||||
|
monkeypatch.setattr(
|
||||||
|
settings,
|
||||||
|
"xprv_encryption_key",
|
||||||
|
__import__("cryptography.fernet", fromlist=["Fernet"]).Fernet.generate_key().decode(),
|
||||||
|
)
|
||||||
|
from app.wallet import hd
|
||||||
|
|
||||||
|
hd._account_key = None
|
||||||
|
hd.generate_master_key()
|
||||||
|
|
||||||
engine = create_async_engine("sqlite+aiosqlite:///:memory:")
|
engine = create_async_engine("sqlite+aiosqlite:///:memory:")
|
||||||
async with engine.begin() as conn:
|
async with engine.begin() as conn:
|
||||||
await conn.run_sync(Base.metadata.create_all)
|
await conn.run_sync(Base.metadata.create_all)
|
||||||
yield async_sessionmaker(engine, expire_on_commit=False)
|
yield async_sessionmaker(engine, expire_on_commit=False)
|
||||||
await engine.dispose()
|
await engine.dispose()
|
||||||
|
hd._account_key = None
|
||||||
|
|
||||||
|
|
||||||
# A real (unsigned) transaction spending one input, built rather than hand-written
|
# A real (unsigned) transaction spending one input, built rather than hand-written
|
||||||
@@ -66,11 +94,19 @@ async def _seed_bet(
|
|||||||
participant_status: str,
|
participant_status: str,
|
||||||
age_seconds: int,
|
age_seconds: int,
|
||||||
last_broadcast_age_seconds: int | None = None,
|
last_broadcast_age_seconds: int | None = None,
|
||||||
|
derivation_index: int = 0,
|
||||||
):
|
):
|
||||||
from datetime import datetime, timedelta, timezone
|
from datetime import datetime, timedelta, timezone
|
||||||
|
|
||||||
|
from app.wallet.hd import derive_user_address
|
||||||
|
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
user = User(username="u", password_hash="x", derivation_index=0, address="plm1qtest")
|
user = User(
|
||||||
|
username="u",
|
||||||
|
password_hash="x",
|
||||||
|
derivation_index=derivation_index,
|
||||||
|
address=derive_user_address(derivation_index),
|
||||||
|
)
|
||||||
session.add(user)
|
session.add(user)
|
||||||
await session.flush()
|
await session.flush()
|
||||||
session.add(
|
session.add(
|
||||||
@@ -145,7 +181,7 @@ async def test_promotes_a_building_row_whose_tx_did_reach_the_chain(session_fact
|
|||||||
session_factory, pending_status="building", participant_status="building", age_seconds=300
|
session_factory, pending_status="building", participant_status="building", age_seconds=300
|
||||||
)
|
)
|
||||||
|
|
||||||
resolved = await reconcile_once(session_factory, KnownTxClient())
|
resolved = await reconcile_once(session_factory, KnownTxClient("betxid"))
|
||||||
assert resolved == 1
|
assert resolved == 1
|
||||||
|
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
@@ -219,8 +255,10 @@ async def test_abandoned_withdrawal_is_marked_failed_and_kept(session_factory):
|
|||||||
they can see it didn't go through."""
|
they can see it didn't go through."""
|
||||||
from datetime import datetime, timedelta, timezone
|
from datetime import datetime, timedelta, timezone
|
||||||
|
|
||||||
|
from app.wallet.hd import derive_user_address
|
||||||
|
|
||||||
async with session_factory() as session:
|
async with session_factory() as session:
|
||||||
user = User(username="w", password_hash="x", derivation_index=1, address="plm1qtest2")
|
user = User(username="w", password_hash="x", derivation_index=1, address=derive_user_address(1))
|
||||||
session.add(user)
|
session.add(user)
|
||||||
await session.flush()
|
await session.flush()
|
||||||
session.add(
|
session.add(
|
||||||
@@ -264,3 +302,42 @@ async def test_abandoned_withdrawal_is_marked_failed_and_kept(session_factory):
|
|||||||
assert withdrawal.status == "failed"
|
assert withdrawal.status == "failed"
|
||||||
assert withdrawal.txid is None
|
assert withdrawal.txid is None
|
||||||
assert (await session.scalars(select(UtxoEvent))).one().spent_txid is None
|
assert (await session.scalars(select(UtxoEvent))).one().spent_txid is None
|
||||||
|
|
||||||
|
|
||||||
|
# --- B-41: existence checks now use get_history and share it across candidates
|
||||||
|
# sharing the same address, instead of a per-tx verbose blockchain.transaction.get. --
|
||||||
|
|
||||||
|
|
||||||
|
async def test_reconcile_once_caches_history_per_scripthash(session_factory):
|
||||||
|
"""Two payout PendingTransaction rows always share the same pool address —
|
||||||
|
fetching its history twice in one pass would be wasteful and, at scale
|
||||||
|
across many candidates on one address, needlessly slow the whole tick."""
|
||||||
|
from datetime import datetime, timedelta, timezone
|
||||||
|
|
||||||
|
async with session_factory() as session:
|
||||||
|
old = datetime.now(timezone.utc) - timedelta(hours=7)
|
||||||
|
session.add(
|
||||||
|
PendingTransaction(
|
||||||
|
kind="payout", round_id=1, current_txid="payout-a", fee_rate_sat_vb=1,
|
||||||
|
raw_tx_hex=_RAW_TX, status="pending", broadcast_at=old, last_broadcast_at=old,
|
||||||
|
)
|
||||||
|
)
|
||||||
|
session.add(
|
||||||
|
PendingTransaction(
|
||||||
|
kind="payout", round_id=2, current_txid="payout-b", fee_rate_sat_vb=1,
|
||||||
|
raw_tx_hex=_RAW_TX, status="pending", broadcast_at=old, last_broadcast_at=old,
|
||||||
|
)
|
||||||
|
)
|
||||||
|
await session.commit()
|
||||||
|
|
||||||
|
call_count = {"n": 0}
|
||||||
|
|
||||||
|
class CountingClient:
|
||||||
|
async def get_history(self, scripthash: str) -> list[dict]:
|
||||||
|
call_count["n"] += 1
|
||||||
|
return [{"tx_hash": "payout-a", "height": 100}, {"tx_hash": "payout-b", "height": 100}]
|
||||||
|
|
||||||
|
resolved = await reconcile_once(session_factory, CountingClient())
|
||||||
|
|
||||||
|
assert resolved == 0 # both exist — nothing to abandon or promote (already "pending")
|
||||||
|
assert call_count["n"] == 1 # one call covered both rows sharing the pool address
|
||||||
@@ -2,7 +2,7 @@ import asyncio
|
|||||||
|
|
||||||
import pytest
|
import pytest
|
||||||
|
|
||||||
from app.rounds.events import RoundEventBroadcaster, RoundEventCapacityError
|
from app.rounds.events import EVICTED, RoundEventBroadcaster, RoundEventCapacityError
|
||||||
|
|
||||||
|
|
||||||
async def test_publish_wakes_up_subscriber():
|
async def test_publish_wakes_up_subscriber():
|
||||||
@@ -60,3 +60,71 @@ async def test_unsubscribe_frees_a_capacity_slot():
|
|||||||
|
|
||||||
broadcaster.unsubscribe(queue)
|
broadcaster.unsubscribe(queue)
|
||||||
broadcaster.subscribe() # no longer at capacity
|
broadcaster.subscribe() # no longer at capacity
|
||||||
|
|
||||||
|
|
||||||
|
# --- B-38: a single IP must not be able to exhaust the global cap and degrade
|
||||||
|
# every other user to polling. ----------------------------------------------------
|
||||||
|
|
||||||
|
|
||||||
|
async def test_subscribe_evicts_the_same_ips_oldest_connection_past_its_cap():
|
||||||
|
"""Past MAX_SUBSCRIBERS_PER_IP, one more stream from the *same* IP evicts
|
||||||
|
that IP's own oldest connection rather than being refused — bounds one
|
||||||
|
source's footprint without an outright block."""
|
||||||
|
broadcaster = RoundEventBroadcaster(max_subscribers=100, max_per_ip=2)
|
||||||
|
first = broadcaster.subscribe("1.2.3.4")
|
||||||
|
second = broadcaster.subscribe("1.2.3.4")
|
||||||
|
|
||||||
|
third = broadcaster.subscribe("1.2.3.4") # past the per-IP cap of 2
|
||||||
|
|
||||||
|
assert await asyncio.wait_for(first.get(), timeout=1) is EVICTED
|
||||||
|
assert second.empty() # untouched — only the oldest was evicted
|
||||||
|
assert third is not None
|
||||||
|
|
||||||
|
|
||||||
|
async def test_subscribe_does_not_evict_across_different_ips():
|
||||||
|
"""A different IP hitting its own cap must never evict an unrelated IP's
|
||||||
|
connection — that would let one abusive source crowd out real users, which
|
||||||
|
is exactly what the global-only cap used to allow."""
|
||||||
|
broadcaster = RoundEventBroadcaster(max_subscribers=100, max_per_ip=1)
|
||||||
|
other_ip_queue = broadcaster.subscribe("9.9.9.9")
|
||||||
|
|
||||||
|
broadcaster.subscribe("1.2.3.4")
|
||||||
|
broadcaster.subscribe("1.2.3.4") # evicts 1.2.3.4's own oldest, not 9.9.9.9's
|
||||||
|
|
||||||
|
assert other_ip_queue.empty()
|
||||||
|
|
||||||
|
|
||||||
|
async def test_subscribe_still_enforces_the_global_cap_across_many_ips():
|
||||||
|
"""The per-IP cap doesn't replace the global backstop — spreading across
|
||||||
|
enough distinct IPs must still eventually hit MAX_SUBSCRIBERS."""
|
||||||
|
broadcaster = RoundEventBroadcaster(max_subscribers=3, max_per_ip=1)
|
||||||
|
broadcaster.subscribe("1.1.1.1")
|
||||||
|
broadcaster.subscribe("2.2.2.2")
|
||||||
|
broadcaster.subscribe("3.3.3.3")
|
||||||
|
|
||||||
|
with pytest.raises(RoundEventCapacityError):
|
||||||
|
broadcaster.subscribe("4.4.4.4")
|
||||||
|
|
||||||
|
|
||||||
|
async def test_unsubscribe_clears_the_per_ip_tracking_too():
|
||||||
|
"""Regression guard: unsubscribe must forget the queue's IP association, or
|
||||||
|
a churned-through connection would keep counting against that IP's cap
|
||||||
|
forever."""
|
||||||
|
broadcaster = RoundEventBroadcaster(max_subscribers=100, max_per_ip=1)
|
||||||
|
queue = broadcaster.subscribe("1.2.3.4")
|
||||||
|
broadcaster.unsubscribe(queue)
|
||||||
|
|
||||||
|
broadcaster.subscribe("1.2.3.4") # must not evict anything — nothing left to evict
|
||||||
|
assert queue.empty()
|
||||||
|
|
||||||
|
|
||||||
|
async def test_subscribe_defaults_to_a_shared_ip_when_none_given():
|
||||||
|
"""Existing callers (and most tests) that don't care about IP isolation
|
||||||
|
still share one implicit bucket rather than needing every call updated."""
|
||||||
|
broadcaster = RoundEventBroadcaster(max_subscribers=100, max_per_ip=2)
|
||||||
|
first = broadcaster.subscribe()
|
||||||
|
broadcaster.subscribe()
|
||||||
|
|
||||||
|
broadcaster.subscribe() # past the default bucket's cap of 2 — evicts, doesn't raise
|
||||||
|
|
||||||
|
assert await asyncio.wait_for(first.get(), timeout=1) is EVICTED
|
||||||
@@ -6,6 +6,7 @@ from app.bets.service import place_bet
|
|||||||
from app.config import settings
|
from app.config import settings
|
||||||
from app.db.base import Base
|
from app.db.base import Base
|
||||||
from app.db.models import PendingTransaction, User, UtxoEvent, Withdrawal
|
from app.db.models import PendingTransaction, User, UtxoEvent, Withdrawal
|
||||||
|
from app.rounds.events import broadcaster
|
||||||
from app.wallet.hd import derive_user_address
|
from app.wallet.hd import derive_user_address
|
||||||
from app.withdrawals.service import WithdrawalError, request_withdrawal
|
from app.withdrawals.service import WithdrawalError, request_withdrawal
|
||||||
|
|
||||||
@@ -171,6 +172,31 @@ async def test_withdrawal_to_own_address_is_rejected(session_factory):
|
|||||||
assert (await session.scalars(select(UtxoEvent).where(UtxoEvent.user_id == user_id))).one().spent_txid is None
|
assert (await session.scalars(select(UtxoEvent).where(UtxoEvent.user_id == user_id))).one().spent_txid is None
|
||||||
|
|
||||||
|
|
||||||
|
async def test_failed_broadcast_publishes_an_sse_update(session_factory): # B-49
|
||||||
|
"""The released UTXOs are spendable again and the balance changed back, so the
|
||||||
|
rollback must nudge the dashboard to refetch instead of leaving it stale until
|
||||||
|
its next poll."""
|
||||||
|
user_id = await _make_funded_user(session_factory, 10, 3_000_000_000)
|
||||||
|
|
||||||
|
class RejectingClient:
|
||||||
|
async def broadcast(self, raw_tx_hex: str) -> str:
|
||||||
|
raise RuntimeError("min relay fee not met")
|
||||||
|
|
||||||
|
queue = broadcaster.subscribe()
|
||||||
|
try:
|
||||||
|
while not queue.empty():
|
||||||
|
queue.get_nowait()
|
||||||
|
|
||||||
|
async with session_factory() as session:
|
||||||
|
user = await session.get(User, user_id)
|
||||||
|
with pytest.raises(WithdrawalError, match="refused"):
|
||||||
|
await request_withdrawal(session, RejectingClient(), user, derive_user_address(98), 1_000_000_000)
|
||||||
|
|
||||||
|
assert not queue.empty()
|
||||||
|
finally:
|
||||||
|
broadcaster.unsubscribe(queue)
|
||||||
|
|
||||||
|
|
||||||
async def test_failed_broadcast_marks_the_withdrawal_failed_and_frees_the_coins(session_factory):
|
async def test_failed_broadcast_marks_the_withdrawal_failed_and_frees_the_coins(session_factory):
|
||||||
"""B-07/B-08: the Withdrawal row is kept (unlike a bet) so the user can see the
|
"""B-07/B-08: the Withdrawal row is kept (unlike a bet) so the user can see the
|
||||||
instruction didn't go through, but the coins must come back."""
|
instruction didn't go through, but the coins must come back."""
|
||||||
|
|||||||
Reference in new issue
Block a user