mirror of
https://github.com/Routstr/routstr-core.git
synced 2026-08-12 12:13:21 +00:00
Jeroen UbbinkandClaude Fable 5
7870db9af1
A foreign mint's melt fee_reserve is a non-binding estimate (NUT-05): the mint may demand more on the real quote or reject the melt outright (e.g. mint.cubabitcoin.org charging input fees beyond its quote). Instead of padding the estimate with a safety buffer that strands funds at the foreign mint on every swap, retry the mint-quote/melt-quote/melt cycle (max 3 attempts) with the amount recomputed from the fees the mint actually demands. Melt failures are classified by the NUT-00 error code (11005 registered TransactionUnbalanced as sent by cdk, 11000 nutshell's generic TransactionError): fee-related rejections retry, others (e.g. 20004 Lightning payment failed) surface immediately. Nutshell's Provided/needed amounts refine the retry step when present; otherwise shrink by 1. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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 configurationtest_main.py- Tests for main app endpointstest_account.py- Tests for wallet/account management endpointstest_proxy.py- Tests for the proxy functionality with mocked upstreamtest_models.py- Tests for model pricing and data structures
Key Fixtures
async_client- Async HTTP client for testing FastAPI endpointstest_session- In-memory SQLite database session for teststest_api_key- Pre-configured API key with balanceapi_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
- Use
@pytest.mark.asynciofor async tests - Use the provided fixtures for database and client access
- Mock external dependencies (like upstream API calls)
- Test both success and error cases
- Verify database state changes when applicable