redshift
e2f6e37ebe
cashu_mints previously defaulted to an empty list, leaving a new node in a half-working state: it silently trusted the hardcoded minibits primary mint but advertised no mints in /v1/info or its NIP-91 listing, so clients discovering the node had no way to know where to pay. - default cashu_mints to minibits + cubabitcoin via shared DEFAULT_CASHU_MINTS - reuse the constant for the primary_mint fallback (removes duplicate literal) - CASHU_MINTS env or dashboard edits still replace the list entirely; an explicitly empty value keeps only the primary mint trusted - document the defaults in configuration.md, dashboard.md, .env.example Existing nodes are unaffected: the settings-blob merge skips persisted empty lists, so unconfigured nodes pick up the defaults on restart while nodes with explicit mints keep theirs.
5.6 KiB
Admin Dashboard
The Admin Dashboard is your command center for managing your Routstr provider node. Configure providers, monitor earnings, manage models, and withdraw profits—all from a web interface.
URL: http://your-node:8000/admin/
Overview Tab
The main dashboard view shows your node's financial status at a glance.
Wallet Summary
| Metric | Description |
|---|---|
| Total Wallet | All Bitcoin currently held by your node |
| User Balances | Funds belonging to active client sessions |
| Your Balance | Your profit: Total - User Balances |
Mint Status
Shows connected Cashu mints and their balances. Each mint displays:
- Connection status
- Balance in sats/msats
- Unit type
Sessions Tab
View and manage active client sessions (API keys).
Session List
| Column | Description |
|---|---|
| Hashed Key | Privacy-preserving identifier (not the actual key) |
| Balance | Remaining funds in the session |
| Spent | Total amount spent by this session |
| Requests | Number of API calls made |
| Created | When the session was created |
| Expires | Auto-expiry time (if set) |
Actions
- View Details — See full session history
- Revoke — Terminate a session (remaining balance returns to your wallet)
Models Tab
Manage which AI models you offer to clients.
Model List
Shows all models available from your upstream provider(s):
| Column | Description |
|---|---|
| Model ID | The model identifier (e.g., gpt-4o) |
| Enabled | Whether clients can use this model |
| Input Price | Cost per 1M input tokens (USD) |
| Output Price | Cost per 1M output tokens (USD) |
| Custom | Whether pricing is overridden |
Actions
- Import Models — Fetch latest model list from upstream
- Enable/Disable — Toggle model availability
- Edit Pricing — Override default pricing for a model
- Create Alias — Map a friendly name to a model
Editing a Model
Click on any model to configure:
| Field | Description |
|---|---|
| Enabled | Show this model to clients |
| Prompt Price | Custom price per 1M input tokens (USD) |
| Completion Price | Custom price per 1M output tokens (USD) |
| Alias | Alternative name for this model |
Settings Tab
Configure all node settings. Changes take effect immediately.
Upstream
Connect to your AI provider:
| Field | Description |
|---|---|
| Base URL | API endpoint (e.g., https://api.openai.com/v1) |
| API Key | Your provider's secret key |
Node Identity
| Field | Description |
|---|---|
| Name | Public display name |
| Description | Brief description of your service |
| Npub | Nostr public key for discovery |
Pricing
| Field | Description |
|---|---|
| Fixed Pricing | Toggle flat-rate vs. per-token pricing |
| Fixed Cost | Sats per request (when fixed pricing enabled) |
| Exchange Fee | Multiplier for BTC volatility buffer |
| Upstream Fee | Your profit margin multiplier |
Example: With Exchange Fee 1.005 and Upstream Fee 1.10:
- Upstream cost: $30/1M tokens
- Your price: $30 × 1.005 × 1.10 = $33.17/1M tokens
Cashu Mints
Manage which mints you accept payments from. A fresh node comes with two
default mints preconfigured (https://mint.minibits.cash/Bitcoin and
https://mint.cubabitcoin.org):
- Add Mint — Enter a mint URL
- Remove Mint — Stop accepting from a mint
- Test Connection — Verify mint is reachable
Lightning
| Field | Description |
|---|---|
| Lightning Address | Your LN address for automatic withdrawals |
Nostr Discovery
| Field | Description |
|---|---|
| Nsec | Private key for signing announcements |
| Relays | Where to publish your node advertisement |
| Share Analytics | Toggle publishing aggregate usage stats to Nostr |
Security
| Field | Description |
|---|---|
| Admin Password | Password for dashboard access |
!!! warning "Set a Password" The dashboard has no password by default. Always set one for production nodes.
Withdraw Tab
Withdraw your profits to a Lightning wallet.
Steps
- Select Mint — Choose which mint to withdraw from
- Enter Amount — How many sats to withdraw
- Generate Token — Creates a Cashu token
- Redeem — Paste the token into your Cashu wallet and melt to Lightning
Alternative: Lightning Address
If you've configured a Lightning Address in Settings, profits can be automatically swept to your wallet (coming soon).
Logs Tab
View node logs for debugging without SSH access.
Features
- Filter by Level — Error, Warning, Info, Debug
- Search — Find specific entries
- Time Range — View logs from specific periods
- Auto-refresh — Watch logs in real-time
Common Log Entries
| Entry | Meaning |
|---|---|
Upstream request failed |
Problem connecting to your AI provider |
Invalid token |
Client sent an invalid Cashu token |
Session expired |
API key reached its time limit |
Insufficient balance |
Client ran out of funds mid-request |