Files
routstr-core/tests/unit
9qeklajc 9beead5ece feat: negative cache for terminal Cashu redemption failures
A dead token (already spent, malformed, zero value) presented as a bearer
key triggers a full mint redemption attempt on every request, because the
failed attempt rolls back and leaves no api_keys row behind. Polling
clients that never back off turn one dead token into thousands of
pointless mint calls per day (~800/day observed against minibits alone),
hammering mints that are already degraded.

Add an in-memory bounded TTL+LRU cache keyed by token hash that remembers
terminal redemption failures (already spent, invalid token, zero value,
fees exceed amount). Repeat presentations are rejected locally with the
exact same sanitized error envelope the mint-backed failure produced.

Transient classifications (mint unreachable, rate limited) are never
cached so a brief mint outage cannot poison valid tokens. The cache is
deliberately memory-only: persisting a row per failed token would let an
attacker fill the database with garbage tokens for free.
2026-08-17 23:14:40 +02:00
..
2025-08-03 20:35:59 -03:00
2025-08-09 14:55:26 -03:00
2026-08-03 23:32:06 +02:00
2026-08-04 01:44:01 +02:00
2026-06-13 23:40:39 +02:00
2026-08-16 14:59:38 +02:00
2026-08-03 23:32:06 +02:00
2026-08-06 22:58:44 +02:00
2026-07-22 23:10:27 +02:00
2026-08-04 22:59:50 +02:00
2026-08-04 00:06:53 +02:00
2026-08-03 00:05:36 +02:00
2026-08-03 23:32:06 +02:00
2026-08-02 23:16:01 +02:00
2026-08-03 23:32:06 +02:00
2026-08-04 00:06:53 +02:00
2026-07-01 17:08:28 +02:00
2026-07-01 16:53:52 +02:00
2026-05-14 15:40:49 +02:00
2026-07-29 22:50:33 +02:00
2026-08-14 21:48:29 +02:00
2026-07-22 23:10:27 +02:00
2026-07-22 23:10:27 +02:00
2026-08-15 15:09:00 +02:00

FastAPI Async Unit Tests

This directory contains async unit tests for the Routstr proxy FastAPI application.

Installation

First, ensure you have the development dependencies installed:

uv pip install -e ".[dev]"

Running Tests

To run all tests:

pytest

To run tests with coverage:

pytest --cov=routstr --cov-report=html

To run specific test files:

pytest tests/test_main.py
pytest tests/test_models.py
pytest tests/test_proxy.py

To run only async tests:

pytest -m asyncio

Test Structure

  • conftest.py - Pytest fixtures and configuration
  • test_main.py - Tests for main app endpoints
  • test_account.py - Tests for wallet/account management endpoints
  • test_proxy.py - Tests for the proxy functionality with mocked upstream
  • test_models.py - Tests for model pricing and data structures

Key Fixtures

  • async_client - Async HTTP client for testing FastAPI endpoints
  • test_session - In-memory SQLite database session for tests
  • test_api_key - Pre-configured API key with balance
  • api_key_with_balance - API key with sufficient balance for proxy tests

Environment Variables

The tests automatically set up required environment variables in conftest.py. No manual configuration needed.

Writing New Tests

  1. Use @pytest.mark.asyncio for async tests
  2. Use the provided fixtures for database and client access
  3. Mock external dependencies (like upstream API calls)
  4. Test both success and error cases
  5. Verify database state changes when applicable