chore: update to v1.5.1 (#3874)

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

.env.example

@@ -191,7 +191,14 @@ BOLTZ_CLIENT_MACAROON="/home/bob/.boltz/macaroons/admin.macaroon"
 # HEXSTRING instead of path also possible
 BOLTZ_CLIENT_CERT="/home/bob/.boltz/tls.cert"
 
-# TODO: add Spark
+# SparkL2Wallet (external sidecar: https://github.com/lnbits/spark_sidecar)
+SPARK_L2_NETWORK=MAINNET
+SPARK_L2_EXTERNAL_ENDPOINT=http://127.0.0.1:8765
+SPARK_L2_EXTERNAL_API_KEY=
+# optional tuning
+# SPARK_L2_PAY_WAIT_MS=4000
+# SPARK_L2_PAY_POLL_MS=500
+# SPARK_L2_STREAM_KEEPALIVE_MS=15000
 
 # StrikeWallet
 STRIKE_API_ENDPOINT=https://api.strike.me/v1

docker/regtest/data/boltz/boltz.conf

@@ -26,8 +26,10 @@ password = "boltz"
   host = "0.0.0.0"
   port = 9005
 
+[swap]
+deferredClaimSymbols = ["BTC", "L-BTC"]
+
 [[pairs]]
-isLegacy = true
 base = "BTC"
 quote = "BTC"
 rate = 1
@@ -44,7 +46,6 @@ minSwapAmount = 50_000
   swapTaproot = 10080
 
 [[pairs]]
-isLegacy = true
 base = "L-BTC"
 quote = "BTC"
 fee = 0.25
@@ -83,6 +84,7 @@ maxZeroConfAmount = 0
   zmqpubrawblock = "tcp://bitcoind:29001"
   port = 18_443
   cookie = "/root/.bitcoin/regtest/.cookie"
+  feeFloor = 0.2
 
   wallet = "lnbits"
 
@@ -101,6 +103,7 @@ maxSwapAmount = 40_294_967
 minSwapAmount = 10_000
 maxZeroConfAmount = 40_294_967
 
+
   [liquid.chain]
   host = "elementsd"
   port = 18884

docker/regtest/docker-compose.yml

@@ -28,7 +28,7 @@ services:
       - lnd-2
       - boltz-postgres
     restart: always
-    image: boltz/boltz:latest
+    image: boltz/boltz:v3.12.1
     ports:
       - 9000:9000
     entrypoint: "sh -c 'sleep 30; /boltz-backend/bin/boltzd'"

docs/guide/funding-sources-table.md

@@ -50,7 +50,7 @@ Below is a side-by-side comparison of Lightning funding sources you can use with
 | **Blink**                      | Custodial                | ✅                  | Low                            | ❌                        | Low               | Provider-managed         | Easy              | Low                    | Transaction fees apply                       | Medium          | Third-party service; focuses on mobile integrations.                                       |
 | **ZBD**                        | Custodial                | ✅                  | Low                            | ❌                        | Low               | Provider-managed         | Easy              | Low                    | Transaction fees apply                       | Medium          | Gaming-focused payment platform.                                                           |
 | **Spark (CLN)**                | Self-custodial           | ❌                  | Higher                         | ✅                        | High              | Manual                   | Moderate          | High                   | Infrastructure cost and channel opening fees | High            | Web interface for CLN; requires Spark server setup.                                        |
-| **Spark (L2)**                 | Self-custodial           | ❌                  | Medium                         | ❌                        | Medium            | Automatic                | Easy              | Low                    | Minimal fees                                 | Medium          | Runs via Spark sidecar; seed-based self-custody.                                           |
+| **Spark (L2)**                 | Self-custodial           | ❌                  | Medium                         | ❌                        | High              | Automatic                | Easy              | Low                    | Minimal fees                                 | Medium          | Runs via Spark sidecar; seed-based self-custody.                                           |
 | **Cliche Wallet**              | Self-custodial           | ❌                  | Medium                         | ❌                        | Medium            | Manual                   | Moderate          | Moderate               | Minimal fees                                 | Medium          | Lightweight wallet; suitable for embedded systems.                                         |
 | **Strike**                     | Custodial                | ✅                  | Low                            | ❌                        | Low               | Provider-managed         | Easy              | Low                    | Transaction fees apply                       | Medium          | Third-party service; suitable for quick setups.                                            |
 | **LNPay**                      | Custodial                | ✅                  | Low                            | ❌                        | Low               | Provider-managed         | Easy              | Low                    | Transaction fees apply                       | Medium          | Third-party service; suitable for quick setups.                                            |
@@ -60,7 +60,7 @@ Below is a side-by-side comparison of Lightning funding sources you can use with
 
 ## Spark (L2)
 
-Spark L2 uses a local Node.js sidecar to expose an HTTP API that LNbits can use as a funding source. It is self-custodial and secured by a standard mnemonic seed. You can let LNbits run the sidecar internally or run your own instance (see `https://github.com/lnbits/spark_sidecar`).
+Spark L2 uses a local Node.js sidecar to expose an HTTP API that LNbits can use as a funding source. It is self-custodial and secured by a standard mnemonic seed. Sidecar repo `https://github.com/lnbits/spark_sidecar`.
 
 ### Notes for readers
 

docs/guide/wallets.md

@@ -41,8 +41,8 @@ A backend wallet is selected and configured entirely through LNbits environment
 | [CoreLightning](#corelightning)                 | [LND (gRPC)](#lnd-grpc)               | [Blink](#blink)                                   |
 | [CoreLightning REST](#corelightning-rest)       | [LNbits](#lnbits)                     | [Alby](#alby)                                     |
 | [Spark (Core Lightning)](#spark-core-lightning) | [LNPay](#lnpay)                       | [Boltz](#boltz)                                   |
-| [Spark (L2)](#spark-l2)                         |                                       |                                                   |
+| [Spark L2](#spark-l2)                           | [ZBD](#zbd)                           | [Phoenixd](#phoenixd)                             |
-| [Cliche Wallet](#cliche-wallet)                 | [ZBD](#zbd)                           | [Phoenixd](#phoenixd)                             |
+| [Cliche Wallet](#cliche-wallet)                 |                                       |                                                   |
 | [Breez SDK](#breez-sdk)                         | [Breez Liquid SDK](#breez-liquid-sdk) | [Nostr Wallet Connect](#nostr-wallet-connect-nwc) |
 | [Strike](#strike)                               | [Eclair (ACINQ)](#eclair-acinq)       | [LN.tips](#lntips)                                |
 | [Fake Wallet](#fake-wallet)                     |                                       |                                                   |
@@ -128,32 +128,18 @@ Old REST interface using [RTL c-lightning-REST](https://github.com/Ride-The-Ligh
 - `SPARK_URL`: `http://10.147.17.230:9737/rpc`
 - `SPARK_TOKEN`: `secret_access_key`
 
-## Spark (L2)
+## Spark L2
 
-Spark L2 is a self-custodial funding source that uses a small Node.js sidecar to talk to the Spark network and expose an HTTP API. You can let LNbits run the sidecar internally, or run it yourself and point LNbits at it.
+Self-custodial funding source using the [Spark L2](https://docs.spark.money/start/overview) network. Requires a Node.js [sidecar](https://github.com/lnbits/spark_sidecar) that bridges lnbits talking to Spark. Works in addition with any Spark-compatible seed (Wallet of Satoshi, BuhoGO, BlitzWallet).
+If the sidecar is started with a `mnemonic` then that mnemonic will be used. Otherwhise if a mnemonic is set for the `Spark L2` LNbits funding source then that mnemonic will be used.
 
-**Required env vars**
+### Optional tuning
 
-- `LNBITS_BACKEND_WALLET_CLASS`: `SparkL2Wallet`
+- `SPARK_L2_PAY_WAIT_MS`: `4000` _(payment timeout in ms)_
+- `SPARK_L2_PAY_POLL_MS`: `500` _(polling interval in ms)_
+- `SPARK_L2_STREAM_KEEPALIVE_MS`: `15000` _(SSE keepalive in ms)_
 
-**Internal sidecar (LNbits-managed)**
+### Example: run the sidecar
-
-- `SPARK_L2_INTERNAL_SIDECAR_VERSION`: `0.1.1`
-- `SPARK_L2_MNEMONIC`: `...` (optional; auto-generated if blank)
-- `SPARK_L2_NETWORK`: `MAINNET`
-
-Optional tuning:
-
-- `SPARK_L2_PAY_WAIT_MS`: `4000`
-- `SPARK_L2_PAY_POLL_MS`: `500`
-- `SPARK_L2_STREAM_KEEPALIVE_MS`: `15000`
-
-**External sidecar**
-
-- `SPARK_L2_EXTERNAL_ENDPOINT`: `http://127.0.0.1:8765`
-- `SPARK_L2_EXTERNAL_API_KEY`: `...` (if your sidecar requires auth)
-
-Example: run the sidecar manually (external mode)
 
 ```bash
 git clone https://github.com/lnbits/spark_sidecar.git
@@ -167,7 +153,7 @@ SPARK_PAY_WAIT_MS=20000 \
 node server.mjs
 ```
 
-For testing, you can generate a 12-word mnemonic at `https://iancoleman.io/bip39/`. Store it securely — it controls your funds. Then select **Spark (L2)** as the funding source in LNbits.
+For testing, you can generate a 12-word mnemonic at https://iancoleman.io/bip39/. Store it securely — it controls your funds. Then select Spark (L2) as the funding source in LNbits.
 
 ## LND (REST)
 

lnbits/settings.py

@@ -292,13 +292,13 @@ class ThemesSettings(LNbitsSettings):
     lnbits_qr_logo: str = Field(default="/static/images/favicon_qr_logo.png")
     lnbits_apple_touch_icon: str | None = Field(default=None)
     lnbits_default_reaction: str = Field(default="confettiBothSides")
-    lnbits_default_theme: str = Field(default="salvador")
+    lnbits_default_theme: str = Field(default="bitcoin")
     lnbits_default_border: str = Field(default="hard-border")
     lnbits_default_gradient: bool = Field(default=True)
     lnbits_default_bgimage: str | None = Field(default=None)
     lnbits_default_dark: bool = Field(default=True)
-    lnbits_default_card_rounded: bool = Field(default=False)
+    lnbits_default_card_rounded: bool = Field(default=True)
-    lnbits_default_card_gradient: bool = Field(default=False)
+    lnbits_default_card_gradient: bool = Field(default=True)
     lnbits_default_card_shadow: bool = Field(default=False)
 
 
@@ -610,6 +610,7 @@ class SparkL2FundingSource(LNbitsSettings):
     spark_l2_network: str = Field(default="MAINNET")
     spark_l2_external_endpoint: str | None = Field(default="http://localhost:8765")
     spark_l2_external_api_key: str | None = Field(default=None)
+    spark_l2_mnemonic: str | None = Field(default=None)
     spark_l2_pay_wait_ms: int = Field(default=4000, ge=0)
     spark_l2_pay_poll_ms: int = Field(default=500, ge=0)
     spark_l2_stream_keepalive_ms: int = Field(default=15000, ge=0)

lnbits/static/i18n/en.js

@@ -6,7 +6,7 @@ window.localisation.en = {
   funding: 'Funding',
   users: 'Users',
   audit: 'Audit',
-  api_watch: 'Api Watch',
+  api_watch: 'API Watch',
   apps: 'Apps',
   channels: 'Channels',
   transactions: 'Transactions',
@@ -271,12 +271,16 @@ window.localisation.en = {
   update: 'Update',
   update_available: 'Update {version} available!',
   funding_sources: 'Funding Sources',
+  funding_source: 'Funding Source',
+  requires_server_restart:
+    'Changing these settings requires a server restart to take effect.',
+  funding_source_info: 'Select the active funding wallet',
   latest_update: 'You are on the latest version {version}.',
   notifications: 'Notifications',
   notifications_configure: 'Configure Notifications',
   notifications_nostr_config: 'Nostr Configuration',
   notifications_enable_nostr: 'Enable Nostr',
-  notifications_enable_nostr_desc: 'Send notfications over Nostr',
+  notifications_enable_nostr_desc: 'Send notifications over Nostr',
   notifications_nostr_private_key: 'Nostr Private Key',
   notifications_nostr_private_key_desc:
     'Private key (hex or nsec) to sign the messages sent to Nostr',
@@ -289,7 +293,7 @@ window.localisation.en = {
 
   notifications_telegram_config: 'Telegram Configuration',
   notifications_enable_telegram: 'Enable Telegram',
-  notifications_enable_telegram_desc: 'Send notfications over Telegram',
+  notifications_enable_telegram_desc: 'Send notifications over Telegram',
   notifications_telegram_access_token: 'Access Token',
   notifications_telegram_access_token_desc: 'Access token for the bot',
   notifications_chat_id: 'Telegram Chat ID',
@@ -318,15 +322,15 @@ window.localisation.en = {
 
   notification_settings_update: 'Settings updated',
   notification_settings_update_desc:
-    'Notify when server settings have been updated',
+    'Send a notification when server settings have been updated',
 
   notification_server_start_stop: 'Server Start/Stop',
   notification_server_start_stop_desc:
-    'Notify when the server has been started/stopped',
+    'Send a notification when the server has been started/stopped',
 
   notification_watchdog_limit: 'Watchdog Limit Notification',
   notification_watchdog_limit_desc:
-    'Notify when the watchdog limit has been reached (does not affect the funding source)',
+    'Send a notification when the watchdog limit has been reached (does not affect the funding source)',
 
   notification_server_status: 'Server Status',
   notification_server_status_desc:
@@ -334,29 +338,31 @@ window.localisation.en = {
 
   notification_incoming_payment: 'Incoming Payments',
   notification_incoming_payment_desc:
-    'Notify when a wallet has received a payment above the specified amount (sats)',
+    'Send a notification when a wallet has received a payment above the specified amount (sats)',
 
   notification_outgoing_payment: 'Outgoing Payments',
   notification_outgoing_payment_desc:
-    'Notify when a wallet has sent a payment above the specified amount (sats)',
+    'Send a notification when a wallet has sent a payment above the specified amount (sats)',
 
   notification_credit_debit: 'Credit / Debit',
   notification_credit_debit_desc:
-    'Notify when a wallet has been credited/debited by the superuser',
+    'Send a notification when a wallet has been credited/debited by the superuser',
 
   notification_balance_delta_changed: 'Balance Delta Changed',
   notification_balance_delta_changed_desc:
-    'Notify when the difference between the node balance and the LNbits balance has changed by more than the specified amount (in sats). Set to 0 to disable. This runs every minute.',
+    'Send a notification when the difference between the node balance and the LNbits balance has changed by more than the specified amount (in sats). Set to 0 to disable. This runs every minute.',
 
-  enable_watchdog: 'Enable Watchdog Switch',
+  watchdog_introduction:
+    "Watchdog is a feature that allows you to automatically switch the LNbits funding source to VoidWallet if your node balance is lower than the LNbits balance by a certain threshold. This can help prevent overspending and keep your node's funds safe.",
+  enable_watchdog: 'Enable Watchdog',
   enable_watchdog_desc:
-    'If enabled it will change your funding source to VoidWallet automatically if your balance is lower than the LNbits balance. You will need to enable manually after an update.',
+    'You will need to re-enable this manually after an update.',
-  watchdog_interval: 'Watchdog Interval',
+  watchdog_interval: 'Watchdog Check Interval',
   watchdog_interval_desc:
-    'How often the background task should check for a killswitch signal in the watchdog delta [node_balance - lnbits_balance] (in minutes).',
+    'How often LNbits should check for a killswitch signal in the watchdog threshold delta value [node_balance - lnbits_balance] (in minutes).',
-  watchdog_delta: 'Watchdog Delta',
+  watchdog_delta: 'Watchdog Threshold Delta',
   watchdog_delta_desc:
-    'Limit before killswitch changes funding source to VoidWallet [lnbits_balance - node_balance > delta]',
+    "The LNbit's > Node balance delta threshold.  If this threshold is exceeded, the funding source is changed to VoidWallet.",
   status: 'Status',
   notification_source: 'Notification Source',
   notification_source_label:
@@ -367,12 +373,12 @@ window.localisation.en = {
   releases: 'Releases',
   watchdog: 'Watchdog',
   server_logs: 'Server Logs',
-  ip_blocker: 'IP Blocker',
+  ip_blocker: 'IP Blacklist/Whitelist',
   security: 'Security',
-  security_tools: 'Security tools',
+  security_tools: 'Security Tools',
   block_access_hint: 'Block access by IP',
   allow_access_hint: 'Allow access by IP (will override blocked IPs)',
-  enter_ip: 'Enter IP and hit enter',
+  enter_ip: 'Enter an IP address and press enter',
   rate_limiter: 'Rate Limiter',
   callback_url_rules: 'Callback URL Rules',
   enter_callback_url_rule: 'Enter URL rule as regex and hit enter',
@@ -386,14 +392,16 @@ window.localisation.en = {
   wallet_max_ballance: 'Wallet max balance in sats (0 to disable)',
   wallet_limit_secs_between_trans:
     'Min secs between transactions per wallet (0 to disable)',
-  only_incoming_payments_allowed: 'Only incoming payments allowed',
+  only_incoming_payments_allowed: 'Allow incoming payments only',
   disable_outgoing_payments: 'Disable outgoing payments',
-  number_of_requests: 'Number of requests',
+  number_of_requests: 'Number of requests to allow',
+  number_of_requests_hint:
+    'Number of requests to allow per "time unit" for the rate limiter. Set to 0 to disable.',
   time_unit: 'Time unit',
-  minute: 'minute',
+  minute: 'Minute',
   settings: 'Settings',
-  second: 'second',
+  second: 'Second',
-  hour: 'hour',
+  hour: 'Hour',
   disable_server_log: 'Disable Server Log',
   enable_server_log: 'Enable Server Log',
   coming_soon: 'Feature coming soon',
@@ -533,33 +541,30 @@ window.localisation.en = {
   create_ticker_converter: 'Create Currency Ticker Converter',
   enable_audit: 'Enable Audit',
   recommended: 'Recommended',
-  audit_desc: 'Record HTTP requests according with the specified filters',
+  audit_desc: 'Log HTTP requests according to the filters specified below.',
-  audit_record_req: 'Record Request Body',
+  audit_record_req: 'Log Request Body',
-  audit_record_warning: 'Warning: ',
+  audit_record_warning: 'Warning!',
-  audit_record_req_warning_1:
+  audit_record_req_warning_1: 'Sensitive data (like passwords) will be logged.',
-    'confidential data (like passwords) will be logged.',
+  audit_record_req_warning_2:
-  audit_record_req_warning_2: 'the request body can have large size.',
+    'The request body can be large. This can fill up your logs quickly.',
-  audit_record_use: 'Use it with caution.',
+  audit_record_use: 'Use this with caution!',
-  audit_ip: 'Record IP Address',
+  audit_ip: 'Log IP Address',
-  audit_ip_desc: 'Record the IP address of the client',
+  audit_ip_desc: 'Log the IP address of users making requests to LNbits.',
-  audit_path_params: 'Record Path Parameters',
+  audit_path_params: 'Log Path Parameters',
-  audit_query_params: 'Record Query Parameters',
+  audit_query_params: 'Log Query Parameters',
   audit_http_methods: 'Include HTTP Methods',
   audit_http_methods_hint:
-    'List of HTTP methods to be included. Empty lists means all.',
+    'List of HTTP methods to be logged. No value means all methods will be logged.',
-  audit_http_methods_label: 'HTTP Methods',
+  audit_http_methods_label: 'HTTP Methods to Log',
-  audit_resp_codes: 'Include HTTP Response Codes',
   audit_resp_codes_hint:
     'List of HTTP codes to be included (regex match). Empty lists means all. Eg: 4.*, 5.*',
-  audit_resp_codes_label: 'HTTP Response code (regex)',
+  audit_resp_codes_label: 'HTTP Response Codes to Log (regex)',
-  audit_paths: 'Include Paths',
   audit_paths_hint:
     'List of paths to be included (regex match). Empty list means all.',
-  audit_paths_label: 'HTTP Path (regex)',
+  audit_paths_label: 'HTTP Paths to Log (regex)',
-  audit_paths_exclude: 'Exclude Paths',
   audit_paths_exclude_hint:
     'List of paths to be excluded (regex match). Empty list means none.',
-  audit_paths_exclude_label: 'HTTP Path (regex)',
+  audit_paths_exclude_label: 'HTTP Paths to Exclude from Logging (regex)',
   exchange_providers: 'Exchange Providers',
   admin_extensions: 'Admin Extensions',
   admin_extensions_label: 'Admin extensions',
@@ -579,16 +584,16 @@ window.localisation.en = {
   misc_disable_extensions_builder_label:
     'Enable Extensions Builder for non admin users.',
   misc_hide_api: 'Hide API',
-  misc_hide_api_label: 'Hides wallet api, extensions can choose to honor',
+  misc_hide_api_label: 'Hides wallet API, extensions can choose to honor',
   wallets_management: 'Wallets Management',
-  funding_source_info: 'Funding Source Info',
+  funding_source_info: 'Funding Source Information',
-  funding_source: 'Funding Source: {wallet_class}',
+  funding_source: 'Funding source: {wallet_class}',
-  node_balance: 'Node Balance: {balance} sats',
+  node_balance: 'Node balance: {balance} sats',
-  lnbits_balance: 'LNbits Balance: {balance} sats',
+  lnbits_balance: 'LNbits balance: {balance} sats',
-  funding_reserve_percent: 'Reserve Percent: {percent} %',
+  funding_reserve_percent: 'Funding reserve percentage: {percent} %',
   node_management: 'Node Management',
   node_management_not_supported:
-    'Node Management not supported by active funding source',
+    'Node management is not supported by the active funding source',
   toggle_node_ui: 'Node UI',
   toggle_public_node_ui: 'Public Node UI',
   toggle_transactions_node_ui: 'Transactions Tab (Disable on large CLN nodes)',
@@ -604,16 +609,15 @@ window.localisation.en = {
   payment_wait_time_tooltip:
     'Controls how long LNbits waits for an outgoing payment attempt to confirm before marking it as pending. Higher values help when paying slow-settling invoices (e.g., HODL invoices, Boltz). The payment will be rechecked later and updated automatically or manually.',
   server_management: 'Server Management',
-  base_url: 'Base URL',
+  base_url_label: 'Base URL of the server',
-  base_url_label: 'Static/Base url for the server',
   authentication: 'Authentication',
-  auth_token_expiry_label: 'Token expire minutes',
+  auth_token_expiry_label: 'Token expiry (minutes)',
   auth_token_expiry_hint: 'Time in minutes until the token expires',
   auth_authentication_cache_label: 'Cache time (minutes)',
   auth_authentication_cache_hint:
     'Time in minutes to cache successful authentication (0 to disable)',
   auth_allowed_methods_label: 'Allowed authorization methods',
-  auth_allowed_methods_hint: 'Select authorization methods',
+  auth_allowed_methods_hint: 'Select allowed authorization methods',
   auth_nostr_label: 'Nostr Request URL',
   auth_nostr_hint: 'Absolute URL that the clients will use to login.',
   auth_google_ci_label: 'Google Client ID',
@@ -633,31 +637,27 @@ window.localisation.en = {
   auth_keycloak_custom_icon_label: 'Keycloak Custom Icon (URL)',
   currency_settings: 'Currency Settings',
   allowed_currencies: 'Allowed Currencies',
-  allowed_currencies_hint: 'Limit the number of available fiat currencies',
+  allowed_currencies_hint:
-  default_account_currency: 'Default Account Currency',
+    'Set the allowed fiat currencies for the exchange features',
-  default_account_currency_hint: 'Default currency for accounting',
+  default_account_currency: 'Default Accounting Currency',
+  default_account_currency_hint:
+    'The default currency to use for accounting features.',
   min_incoming_payment_amount: 'Min Incoming Payment Amount',
   min_incoming_payment_amount_desc:
     'Minimum amount allowed for generating an invoice',
-  max_incoming_payment_amount: 'Max Incoming Payment Amount',
+  max_incoming_payment_amount: 'Maximum Incoming Payment Amount',
   max_incoming_payment_amount_desc:
-    'Maximum amount allowed for generating an invoice',
+    'Maximum amount allowed when generating an invoice',
-  max_outgoing_payment_amount: 'Max Outgoing Payment Amount',
+  max_outgoing_payment_amount: 'Maximum Outgoing Payment Amount',
   max_outgoing_payment_amount_desc:
-    'Maximum amount allowed for making a payment',
+    'Maximum amount allowed when making a payment',
+  service_fees: 'Service Fees',
   service_fee: 'Service Fee',
-  service_fee_label: 'Service fee (%)',
+  service_fee_label: 'Service Fee Charged Per Transaction',
-  service_fee_hint: 'Fee charged per tx (%)',
+  service_fee_max_label: 'Maximum Service Fee Limit',
-  service_fee_max: 'Service Fee Max',
+  fee_wallet_label: 'Service Fee Wallet ID',
-  service_fee_max_label: 'Service fee max (sats)',
+  fee_wallet_hint: 'The ID of the wallet to which to send service funds',
-  service_fee_max_hint: 'Max service fee to charge in (sats)',
+  disable_fee: 'Disable Service Fees for Internal Payments',
-  fee_wallet: 'Fee Wallet',
-  fee_wallet_label: 'Fee wallet (wallet ID)',
-  fee_wallet_hint: 'Wallet ID to send funds to',
-  disable_fee: 'Disable Fee',
-  disable_fee_internal: 'Disable Service Fee for Internal Payments',
-  disable_fee_internal_desc:
-    'Disable Service Fee for Internal Lightning Payments',
   ui_management: 'UI Management',
   ui_site_title: 'Site Title',
   ui_changing_remove_lnbits_elements:
@@ -670,6 +670,7 @@ window.localisation.en = {
   ui_site_description_hint: 'Use plain text, Markdown, or raw HTML',
   ui_default_wallet_name: 'Default Wallet Name',
   ui_default_theme: 'Default Theme',
+  wallet_featured_button_title: 'Wallet - Featured Button',
   wallet_featured_button_label: 'Wallet Featured Button Label',
   wallet_featured_button_label_hint:
     'Show featured button on the wallet homepage',
@@ -678,33 +679,38 @@ window.localisation.en = {
     'On click the button will open this URL. Leave empty to hide the button.',
   wallet_featured_button_icon: 'Featured Button Icon',
   wallet_featured_button_icon_hint:
-    'Icon shown on the featured button (check quasar icons)',
+    'Icon shown on the featured button (Quasar icon name e.g. "bolt")',
   lnbits_wallet: 'LNbits wallet',
   denomination: 'Denomination',
   denomination_hint: 'The name for the FakeWallet token',
   denomination_error: 'Denomination must be 3 characters, or `sats`',
   ui_qr_code_logo: 'QR Code/Favicon Logo',
-  ui_qr_code_logo_hint: 'QR code and favicon logo url',
+  ui_qr_code_logo_hint: 'QR code icon and favicon logo URL',
   ui_apple_touch_icon: 'Apple Touch Icon',
-  ui_apple_touch_icon_hint: 'Apple touch icon url',
+  ui_apple_touch_icon_hint: 'Apple touch icon URL',
   ui_custom_image: 'Custom Image',
   ui_custom_image_label: 'URL to custom image',
-  ui_custom_image_hint: 'Image showed at homepage/login',
+  ui_custom_image_hint:
-  ui_custom_badge: 'Custom Badge',
+    'This image is shown on the LNbits homepage and login screen.',
+  ui_custom_badge_title: 'Custom Badge Settings',
+  ui_custom_badge_desc: 'Show a custom badge in the header of LNbits',
+  ui_custom_badge: 'Custom Badge Text',
   ui_custom_badge_label: "Custom Badge 'USE WITH CAUTION'",
   ui_custom_badge_color_label: 'Custom Badge Color',
   themes: 'Themes',
   themes_hint: 'Choose themes available for users',
   custom_logo: 'Custom Logo',
   custom_logo_hint: 'URL to logo image',
-  ad_space_title: 'Ad Space Title',
+  ad_space_section_title: 'Advertisement Space',
-  ad_space_title_label: 'Supported by',
+  ad_space_section_desc:
+    'Configure the advertisement space on the wallet sidebar.',
+  ad_space_title: 'Advertisement Space Title',
+  ad_space_title_hint: 'Title shown above the advertisement space',
   ad_slots: 'Advertisement Slots',
   ad_slots_hint:
-    'Ad url and image filepaths in CSV format, extensions can choose to honor',
+    'Advertisement image filepaths in CSV format, extensions can choose to honor. Format: url;img_light_url;img_dark_url, url..',
-  ad_slots_label: 'url;img_light_url;img_dark_url, url...',
+  ads_enabled: 'Enable Advertisement',
-  ads_enabled: 'Ads Enabled',
+  ads_disabled: 'Disabled Advertisement',
-  ads_disabled: 'Ads Disabled',
   user_management: 'User Management',
   admin_users: 'Admin Users',
   admin_users_hint: 'Users with admin privileges',

lnbits/static/js/components/admin/lnbits-admin-funding-sources.js

@@ -234,7 +234,12 @@ window.app.component('lnbits-admin-funding-sources', {
           {
             spark_l2_external_endpoint: {
               label: 'External Sidecar Endpoint',
-              hint: 'If specified then this endpoint will be used instead of the internal sidecar. Make sure to also specify the API key if your sidecar requires authentication.',
+              hint: 'Make sure to also specify the API key if your sidecar requires authentication.',
+              value: ''
+            },
+            spark_l2_mnemonic: {
+              label: 'External Sidecar Mnemonic',
+              hint: 'Mnemonic for the Spark wallet on the external sidecar. Required if the side car does not have its own mnemonic.',
               value: ''
             },
             spark_l2_external_api_key: {

lnbits/static/js/components/lnbits-manage-wallet-list.js

@@ -17,6 +17,13 @@ window.app.component('lnbits-manage-wallet-list', {
       } else {
         this.activeWalletId = null
       }
+    },
+    'g.user.wallets': {
+      handler() {
+        this.paymentEvents()
+      },
+      deep: true,
+      immediate: true
     }
   },
   created() {

lnbits/static/js/utils.js

@@ -131,6 +131,22 @@ window._lnbitsUtils = {
       currency: currency || 'sat'
     }).format(value)
   },
+  getCurrencySymbol(currency) {
+    const code = (currency || '').toUpperCase()
+    if (code === 'BTC' || code === 'XBT' || code === 'SAT' || code === 'SATS') {
+      return '₿'
+    }
+    try {
+      const parts = new Intl.NumberFormat(window.i18n.global.locale, {
+        style: 'currency',
+        currency: code
+      }).formatToParts(0)
+      const symbolPart = parts.find(part => part.type === 'currency')
+      return symbolPart?.value || code || '¤'
+    } catch (e) {
+      return code || '¤'
+    }
+  },
   formatSat(value) {
     return new Intl.NumberFormat(window.i18n.global.locale).format(value)
   },

lnbits/templates/components/admin/assets-config.vue

@@ -3,9 +3,6 @@
     <h6 class="q-my-none q-mb-sm">Assets</h6>
     <div class="row q-col-gutter-md">
       <div class="col-12 col-md-3">
-        <p>
-          <span v-text="$t('max_asset_size_mb')"></span>
-        </p>
         <q-input
           filled
           type="number"
@@ -18,9 +15,6 @@
       </div>
 
       <div class="col-12 col-md-9">
-        <p>
-          <span v-text="$t('assets_allowed_mime_types')"></span>
-        </p>
         <q-input
           filled
           v-model.number="newAllowedAssetMimeType"
@@ -56,11 +50,8 @@
     </div>
     <q-separator class="q-mb-lg q-mt-sm"></q-separator>
     <h6 class="q-my-none q-mb-sm">Thumbnails</h6>
-    <div class="row q-col-gutter-md">
+    <div class="row q-col-gutter-md q-my-lg">
-      <div class="col-12 col-md-3">
+      <div class="col-12 col-md-4">
-        <p>
-          <span v-text="$t('thumbnail_width')"></span>
-        </p>
         <q-input
           filled
           type="number"
@@ -71,10 +62,7 @@
           :hint="$t('thumbnail_width_desc')"
         ></q-input>
       </div>
-      <div class="col-12 col-md-3">
+      <div class="col-12 col-md-4">
-        <p>
-          <span v-text="$t('thumbnail_height')"></span>
-        </p>
         <q-input
           filled
           type="number"
@@ -85,10 +73,7 @@
           :hint="$t('thumbnail_height_desc')"
         ></q-input>
       </div>
-      <div class="col-12 col-md-3">
+      <div class="col-12 col-md-4">
-        <p>
-          <span v-text="$t('thumbnail_format')"></span>
-        </p>
         <q-input
           filled
           v-model.number="formData.lnbits_asset_thumbnail_format"
@@ -101,9 +86,6 @@
     <h6 class="q-my-none q-mb-sm">Users</h6>
     <div class="row q-col-gutter-md">
       <div class="col-12 col-md-3">
-        <p>
-          <span v-text="$t('max_assets_per_user')"></span>
-        </p>
         <q-input
           filled
           type="number"
@@ -115,9 +97,6 @@
         ></q-input>
       </div>
       <div class="col-12 col-md-9">
-        <p>
-          <span v-text="$t('assets_no_limit_users')"></span>
-        </p>
         <q-input
           filled
           v-model="newNoLimitUser"

lnbits/templates/components/admin/audit.vue

@@ -32,7 +32,7 @@
     </div>
     <q-separator class="q-mb-lg q-mt-sm"></q-separator>
     <div class="row">
-      <div class="col-md-3 col-sm-12 q-pr-sm">
+      <div class="col-md-6 col-sm-12 q-pr-sm">
         <q-item tag="label" v-ripple>
           <q-item-section avatar>
             <q-toggle
@@ -62,7 +62,7 @@
           </q-item-section>
         </q-item>
       </div>
-      <div class="col-md-3 col-sm-12 q-pr-sm">
+      <div class="col-md-6 col-sm-12 q-pr-sm">
         <q-item tag="label" v-ripple>
           <q-item-section avatar>
             <q-toggle
@@ -83,7 +83,7 @@
           </q-item-section>
         </q-item>
       </div>
-      <div class="col-md-3 col-sm-12 q-pr-sm">
+      <div class="col-md-6 col-sm-12 q-pr-sm">
         <q-item tag="label" v-ripple>
           <q-item-section avatar>
             <q-toggle
@@ -104,7 +104,7 @@
           </q-item-section>
         </q-item>
       </div>
-      <div class="col-md-3 col-sm-12 q-pr-sm">
+      <div class="col-md-6 col-sm-12 q-pr-sm">
         <q-item tag="label" v-ripple>
           <q-item-section avatar>
             <q-toggle
@@ -129,7 +129,6 @@
     <q-separator class="q-mb-xl q-mt-sm"></q-separator>
     <div class="row q-mb-lg">
       <div class="col-md-6 col-sm-12 q-pr-sm">
-        <p><span v-text="$t('audit_http_methods')"></span></p>
         <q-select
           filled
           v-model="formData.lnbits_audit_http_methods"
@@ -148,7 +147,6 @@
         ></q-select>
       </div>
       <div class="col-md-6 col-sm-12 q-pr-sm">
-        <p><span v-text="$t('audit_resp_codes')"></span></p>
         <q-input
           class="q-mb-md"
           filled
@@ -177,7 +175,6 @@
 
     <div class="row">
       <div class="col-md-6 col-sm-12 q-pr-sm">
-        <p><span v-text="$t('audit_paths')"></span></p>
         <q-input
           class="q-mb-md"
           filled
@@ -204,9 +201,6 @@
         <br />
       </div>
       <div class="col-md-6 col-sm-12">
-        <p>
-          <span v-text="$t('audit_paths_exclude')"></span>
-        </p>
         <q-input
           class="q-mb-md"
           filled

lnbits/templates/components/admin/exchange_providers.vue

@@ -19,6 +19,7 @@
     </div>
     <div class="col-12 col-md-4">
       <q-input
+        class="q-mb-md"
         filled
         v-model="formData.lnbits_exchange_history_refresh_interval_seconds"
         type="number"

lnbits/templates/components/admin/extensions.vue

@@ -137,7 +137,7 @@
             :hint="$t('extension_builder_manifest_url_hint')"
           ></q-input>
         </div>
-        <div class="col-12 col-md-6">
+        <div class="col-12 col-md-6 q-pb-md">
           <p>
             <span v-text="$t('reviews_url')"></span>
           </p>

lnbits/templates/components/admin/fiat_providers.vue

@@ -128,7 +128,7 @@
                 </ul>
               </q-card-section>
             </q-expansion-item>
-            <q-expansion-item :label="$t('service_fee')">
+            <q-expansion-item :label="$t('service_fees')">
               <q-card-section>
                 <div class="row">
                   <div class="col-md-4 col-sm-12">
@@ -140,7 +140,6 @@
                       v-model="formData.stripe_limits.service_fee_percent"
                       @update:model-value="formData.touch = null"
                       :label="$t('service_fee_label')"
-                      :hint="$t('service_fee_hint')"
                     ></q-input>
                   </div>
                   <div class="col-md-4 col-sm-12">
@@ -151,8 +150,7 @@
                       min="0"
                       v-model="formData.stripe_limits.service_max_fee_sats"
                       @update:model-value="formData.touch = null"
-                      :label="$t('service_fee_max')"
+                      :label="$t('service_fee_max_label')"
-                      :hint="$t('service_fee_max_hint')"
                     ></q-input>
                   </div>
                   <div class="col-md-4 col-sm-12">

lnbits/templates/components/admin/funding.vue

@@ -165,6 +165,11 @@
       <h6 class="q-mt-lg q-mb-sm">
         <p v-text="$t('watchdog')"></p>
       </h6>
+      <div class="row q-col-gutter-md">
+        <div class="col-12">
+          <p v-text="$t('watchdog_introduction')"></p>
+        </div>
+      </div>
       <div class="row q-col-gutter-md">
         <div class="col-12 col-md-6">
           <q-item tag="label" v-ripple>
@@ -239,6 +244,7 @@
               <q-input
                 filled
                 v-model="formData.lnbits_watchdog_delta"
+                :suffix="$t('sats')"
                 type="number"
               />
             </q-item-section>

lnbits/templates/components/admin/funding_sources.vue

@@ -12,11 +12,14 @@
 
     <div class="row">
       <div class="col-12">
-        <p>Active Funding<small> (Requires server restart)</small></p>
+        <p>
+          <span v-text="$t('funding_source')"></span>
+          <small><span v-text="$t('requires_server_restart')"></span></small>
+        </p>
         <q-select
           filled
           v-model="formData.lnbits_backend_wallet_class"
-          hint="Select the active funding wallet"
+          :hint="$t('funding_source_info')"
           :options="sortedAllowedFundingSources"
           :option-label="item => getFundingSourceLabel(item)"
         ></q-select>

lnbits/templates/components/admin/security.vue

@@ -1,11 +1,10 @@
 <template id="lnbits-admin-security">
   <q-card-section class="q-pa-none">
-    <h6 class="q-my-none">
+    <h6 class="q-my-none q-mb-sm">
       <span v-text="$t('server_management')"></span>
     </h6>
     <div class="row">
       <div class="col-12 col-md-6">
-        <p><span v-text="$t('base_url')"></span></p>
         <q-input
           filled
           v-model.number="formData.lnbits_baseurl"
@@ -17,7 +16,7 @@
     <h6 class="q-my-none q-mb-sm">
       <span v-text="$t('authentication')"></span>
     </h6>
-    <div class="row q-col-gutter-sm">
+    <div class="row q-col-gutter-sm q-mb-md">
       <div class="col-12 col-md-6">
         <q-input
           filled
@@ -305,6 +304,7 @@
                 type="number"
                 v-model.number="formData.lnbits_rate_limit_no"
                 :label="$t('number_of_requests')"
+                :hint="$t('number_of_requests_hint')"
               ></q-input>
             </div>
             <div class="col-12 col-md-6">

lnbits/templates/components/admin/server.vue

@@ -38,14 +38,11 @@
       </div>
 
       <q-separator class="q-mb-lg q-mt-sm"></q-separator>
-      <h6 class="q-my-none">
+      <h6 class="q-my-none q-mb-sm">
         <span v-text="$t('payments')"></span>
       </h6>
       <div class="row q-col-gutter-md">
-        <div class="col-12 col-md-3">
+        <div class="col-12 col-md-4">
-          <p>
-            <span v-text="$t('max_outgoing_payment_amount')"></span>
-          </p>
           <q-input
             filled
             type="number"
@@ -57,10 +54,7 @@
           ></q-input>
         </div>
 
-        <div class="col-12 col-md-3">
+        <div class="col-12 col-md-4">
-          <p>
-            <span v-text="$t('max_incoming_payment_amount')"></span>
-          </p>
           <q-input
             filled
             type="number"
@@ -75,7 +69,7 @@
       </div>
 
       <q-separator class="q-mb-lg q-mt-sm"></q-separator>
-      <h6 class="q-my-none">
+      <h6 class="q-my-none q-mb-sm">
         <span v-text="$t('wallet_limiter')"></span>
       </h6>
       <div class="row q-col-gutter-md">
@@ -113,35 +107,32 @@
       </div>
 
       <q-separator class="q-mb-lg q-mt-sm"></q-separator>
-      <h6 class="q-my-none">
+      <h6 class="q-my-none q-mb-sm">
-        <span v-text="$t('service_fee')"></span>
+        <span v-text="$t('service_fees')"></span>
       </h6>
       <div class="row q-col-gutter-md">
-        <div class="col-12 col-md-6">
+        <div class="col-12 col-md-4">
-          <p><span v-text="$t('service_fee')"></span></p>
           <q-input
             filled
             type="number"
             v-model.number="formData.lnbits_service_fee"
             :label="$t('service_fee_label')"
             step="0.1"
-            :hint="$t('service_fee_hint')"
+            :suffix="'%'"
           ></q-input>
           <br />
         </div>
-        <div class="col-12 col-md-6">
+        <div class="col-12 col-md-4">
-          <p><span v-text="$t('service_fee_max')"></span></p>
           <q-input
             filled
             type="number"
             v-model.number="formData.lnbits_service_fee_max"
             :label="$t('service_fee_max_label')"
-            :hint="$t('service_fee_max_hint')"
+            :suffix="$t('sats')"
           ></q-input>
           <br />
         </div>
         <div class="col-12 col-md-6">
-          <p><span v-text="$t('fee_wallet')"></span></p>
           <q-input
             filled
             v-model="formData.lnbits_service_fee_wallet"
@@ -151,16 +142,9 @@
           <br />
         </div>
         <div class="col-12 col-md-6">
-          <p>
-            <span v-text="$t('disable_fee_internal')"></span>
-          </p>
           <q-item tag="label" v-ripple>
             <q-item-section>
               <q-item-label v-text="$t('disable_fee')"></q-item-label>
-              <q-item-label
-                caption
-                v-text="$t('disable_fee_internal_desc')"
-              ></q-item-label>
             </q-item-section>
             <q-item-section avatar>
               <q-toggle

lnbits/templates/components/admin/site_customisation.vue

@@ -6,8 +6,7 @@
     <br />
     <div>
       <div class="row q-col-gutter-md">
-        <div class="col-12 col-md-5">
+        <div class="col-12 col-md-6">
-          <p><span v-text="$t('ui_site_title')"></span></p>
           <q-input
             filled
             type="text"
@@ -18,8 +17,7 @@
           ></q-input>
           <br />
         </div>
-        <div class="col-12 col-md-5">
+        <div class="col-12 col-md-6">
-          <p><span v-text="$t('ui_site_tagline')"></span></p>
           <q-input
             filled
             type="text"
@@ -28,7 +26,9 @@
           ></q-input>
           <br />
         </div>
-        <div class="col-12 col-md-2 q-mt-xl">
+      </div>
+      <div class="row q-col-gutter-md">
+        <div class="col-12 col-md-12">
           <q-toggle
             :tip="$t('ui_toggle_elements_tip')"
             v-model="formData.lnbits_show_home_page_elements"
@@ -40,78 +40,66 @@
           ></q-toggle>
         </div>
       </div>
-
-      <div>
-        <p>
-          <span v-text="$t('ui_site_description')"></span>
-        </p>
-        <q-input
-          v-model="formData.lnbits_site_description"
-          filled
-          type="textarea"
-          :hint="$t('ui_site_description_hint')"
-        />
-      </div>
-      <br />
       <div class="row q-col-gutter-md">
+        <div class="col-12">
+          <q-input
+            v-model="formData.lnbits_site_description"
+            filled
+            type="textarea"
+            :label="$t('ui_site_description')"
+            :hint="$t('ui_site_description_hint')"
+          />
+        </div>
         <div class="col-12 col-md-4">
-          <p>
-            <span v-text="$t('ui_default_wallet_name')"></span>
-          </p>
           <q-input
             filled
             type="text"
             v-model="formData.lnbits_default_wallet_name"
-            :label="$t('lnbits_wallet')"
+            :label="$t('ui_default_wallet_name')"
           ></q-input>
         </div>
         <div class="col-12 col-md-4">
-          <p><span v-text="$t('ui_qr_code_logo')"></span></p>
           <q-input
             filled
             type="text"
             v-model="formData.lnbits_qr_logo"
-            label="https://example.com/image.svg"
+            :label="$t('ui_qr_code_logo')"
             :hint="$t('ui_qr_code_logo_hint')"
           ></q-input>
         </div>
         <div class="col-12 col-md-4">
-          <p><span v-text="$t('ui_apple_touch_icon')"></span></p>
           <q-input
             filled
             type="text"
             v-model="formData.lnbits_apple_touch_icon"
-            label="https://example.com/image.png"
+            :label="$t('ui_apple_touch_icon')"
             :hint="$t('ui_apple_touch_icon_hint')"
           ></q-input>
         </div>
       </div>
-      <br />
       <div class="row q-col-gutter-md">
+        <div class="col-12 col-md-12">
+          <p><span v-text="$t('wallet_featured_button_title')"></span></p>
+        </div>
         <div class="col-12 col-md-4">
-          <p>
-            <span v-text="$t('wallet_featured_button_label')"></span>
-          </p>
           <q-input
             filled
             type="text"
             v-model="formData.lnbits_wallet_featured_button_label"
-            label="Loop to Onchain"
+            :label="$t('wallet_featured_button_label')"
             :hint="$t('wallet_featured_button_label_hint')"
           ></q-input>
         </div>
         <div class="col-12 col-md-4">
-          <p><span v-text="$t('wallet_featured_button_url')"></span></p>
           <q-input
             filled
             type="text"
             v-model="formData.lnbits_wallet_featured_button_url"
-            label="/boltz"
+            :label="$t('wallet_featured_button_url')"
             :hint="$t('wallet_featured_button_url_hint')"
           ></q-input>
         </div>
         <div class="col-12 col-md-4">
-          <p><span v-text="$t('wallet_featured_button_icon')"></span></p>
           <q-input
             filled
             type="text"
@@ -121,21 +109,27 @@
           ></q-input>
         </div>
       </div>
-
       <div class="row q-col-gutter-md q-mt-md">
-        <div class="col-12 col-md-6">
+        <div class="col-12 col-md-12">
-          <p><span v-text="$t('ui_custom_badge')"></span></p>
+          <h6 class="q-my-sm">
+            <span v-text="$t('ui_custom_badge_title')"></span>
+          </h6>
+          <p class="q-mb-none">
+            <span v-text="$t('ui_custom_badge_desc')"></span>
+          </p>
+        </div>
+        <div class="col-12">
           <div class="row q-col-gutter-md">
-            <div class="col-12 col-md-8">
+            <div class="col-12 col-md-6">
               <q-input
                 filled
                 type="text"
                 tip="Custom Badge"
                 v-model.trim="formData.lnbits_custom_badge"
-                :label="$t('ui_custom_badge_label')"
+                :label="$t('ui_custom_badge')"
               ></q-input>
             </div>
-            <div class="col-12 col-md-4">
+            <div class="col-12 col-md-6">
               <q-select
                 filled
                 v-model="formData.lnbits_custom_badge_color"
@@ -145,8 +139,8 @@
             </div>
           </div>
         </div>
-        <div class="col-12 col-md-6">
+        <div class="col-12">
-          <p><span v-text="$t('ui_custom_image')"></span></p>
+          <h6 class="q-my-sm"><span v-text="$t('ui_custom_image')"></span></h6>
           <q-input
             filled
             type="text"
@@ -157,10 +151,8 @@
           ></q-input>
         </div>
       </div>
-      <br />
       <div class="row q-col-gutter-md">
         <div class="col-12 col-md-6">
-          <p><span v-text="$t('themes')"></span></p>
           <q-select
             filled
             v-model="formData.lnbits_theme_options"
@@ -172,41 +164,26 @@
           <br />
         </div>
         <div class="col-12 col-md-6">
-          <p><span v-text="$t('custom_logo')"></span></p>
           <q-input
             filled
             type="text"
             v-model="formData.lnbits_custom_logo"
-            label="https://example.com/image.png"
+            :label="$t('custom_logo')"
             :hint="$t('custom_logo_hint')"
           ></q-input>
           <br />
         </div>
       </div>
       <div class="row q-col-gutter-md">
-        <div class="col-12 col-md-6">
+        <div class="col-12 col-md-12">
-          <p><span v-text="$t('ad_space_title')"></span></p>
+          <h6 class="q-my-sm">
-          <q-input
+            <span v-text="$t('ad_space_section_title')"></span>
-            filled
+          </h6>
-            type="text"
+          <p class="q-my-none">
-            v-model="formData.lnbits_ad_space_title"
+            <span v-text="$t('ad_space_section_desc')"></span>
-            :label="$t('ad_space_title_label')"
+          </p>
-          ></q-input>
-          <br />
         </div>
-        <div class="col-12 col-md-6">
+        <div class="col-12 col-md-12">
-          <p><span v-text="$t('ad_slots')"></span></p>
-          <q-input
-            class="q-mb-md"
-            filled
-            v-model="formData.lnbits_ad_space"
-            type="text"
-            :label="$t('ad_slots_label')"
-            :hint="$t('ad_slots_hint')"
-            ><q-tooltip>
-              format {url};{img-light};{img-dark},{url};{img-light};{img-dark}"
-            </q-tooltip>
-          </q-input>
           <q-toggle
             v-model="formData.lnbits_ad_space_enabled"
             :label="
@@ -215,8 +192,30 @@
                 : $t('ads_disabled')
             "
           />
+        </div>
+        <div class="col-12 col-md-6">
+          <q-input
+            filled
+            type="text"
+            v-model="formData.lnbits_ad_space_title"
+            :label="$t('ad_space_title')"
+            :hint="$t('ad_space_title_hint')"
+          ></q-input>
           <br />
         </div>
+        <div class="col-12 col-md-6">
+          <q-input
+            class="q-mb-md"
+            filled
+            v-model="formData.lnbits_ad_space"
+            type="text"
+            :label="$t('ad_slots')"
+            :hint="$t('ad_slots_hint')"
+            ><q-tooltip>
+              format {url};{img-light};{img-dark},{url};{img-light};{img-dark}"
+            </q-tooltip>
+          </q-input>
+        </div>
       </div>
       <div class="row q-col-gutter-md q-my-md">
         <div class="col-12" v-text="$t('ui_default_theme')"></div>

lnbits/templates/components/lnbits-header.vue

@@ -27,12 +27,9 @@
       ></q-btn>
       <q-toolbar-title>
         <q-btn flat no-caps dense class="q-mr-sm" size="lg" type="a" href="/">
-          <q-img
+          <q-avatar v-if="g.settings.customLogo" height="30px">
-            v-if="customLogo"
+            <img alt="Logo" :src="g.settings.customLogo" />
-            height="30px"
+          </q-avatar>
-            alt="Logo"
-            :src="customLogo"
-          ></q-img>
           <span v-else-if="g.settings.siteTitle == 'LNbits'"
             ><strong>LN</strong>bits</span
           >

lnbits/templates/pages/wallet.vue

@@ -204,7 +204,7 @@
       </q-card>
     </div>
     <div
-      v-if="!g.mobileSimple || !$q.screen.lt.md"
+      v-show="!g.mobileSimple || !$q.screen.lt.md"
       class="col-12 col-md-5 q-gutter-y-md"
     >
       <lnbits-wallet-extra

lnbits/wallets/sparkl2.py

@@ -8,6 +8,8 @@ from typing import Any, cast
 
 import httpx
 from bolt11 import decode as bolt11_decode
+from coincurve.keys import PrivateKey
+from embit.bip39 import mnemonic_from_bytes, mnemonic_is_valid
 from loguru import logger
 
 from lnbits.helpers import normalize_endpoint
@@ -79,6 +81,11 @@ class SparkL2Wallet(Wallet):
     async def status(self) -> StatusResponse:
         try:
             res = await self._request("POST", "/v1/balance")
+            status = res.get("status")
+            if status == "missing_mnemonic":
+                await self._check_sidecar_mnemonic()
+                return StatusResponse("Spark sidecar mnemonic not set", 0)
+
             balance_msat = res.get("balance_msat")
             if balance_msat is not None:
                 return StatusResponse(None, int(balance_msat))
@@ -237,7 +244,7 @@ class SparkL2Wallet(Wallet):
     ) -> dict[str, Any]:
         error_message = None
         try:
-            r = await self.client.request(method, path, json=json_data)
+            r = await self.client.request(method, path, json=json_data, timeout=30)
             r.raise_for_status()
             j = r.json()
         except (httpx.RequestError, httpx.HTTPStatusError, json.JSONDecodeError) as exc:
@@ -319,3 +326,30 @@ class SparkL2Wallet(Wallet):
         if mapped.failed:
             return False
         return None
+
+    async def _check_sidecar_mnemonic(self):
+        if settings.spark_l2_mnemonic:
+            valid = mnemonic_is_valid(settings.spark_l2_mnemonic)
+            if not valid:
+                logger.warning("SPARK_L2_MNEMONIC is set but invalid. Please recheck!")
+                return
+            await self._set_sidecar_mnemonic(settings.spark_l2_mnemonic)
+            return
+
+        logger.info("SPARK_L2_MNEMONIC is not set, one will be generated for you.")
+        mnemonic = mnemonic_from_bytes(PrivateKey().secret)
+        await self._set_sidecar_mnemonic(mnemonic)
+
+    async def _set_sidecar_mnemonic(self, mnemonic: str):
+        logger.info("Checking 'SPARK_L2_MNEMONIC' on the Spark sidecar.")
+        payload = {"mnemonic": mnemonic}
+        resp = await self._request("POST", "/v1/mnemonic", payload)
+        status = resp.get("status")
+        logger.info(f"Spark sidecar mnemonic status: {status}")
+        if status == "set":
+            logger.info("Updating 'SPARK_L2_MNEMONIC' mnemonic settings.")
+            from lnbits.core.crud.settings import set_settings_field
+
+            await set_settings_field("spark_l2_mnemonic", mnemonic)
+        else:
+            logger.info("Nothing to do for 'SPARK_L2_MNEMONIC' on the Spark sidecar.")

package-lock.json

@@ -1386,9 +1386,9 @@
       }
     },
     "node_modules/minimatch": {
-      "version": "3.1.2",
+      "version": "3.1.5",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
-      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
       "dev": true,
       "license": "ISC",
       "dependencies": {

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lnbits"
-version = "1.5.0"
+version = "1.5.1"
 requires-python = ">=3.10,<3.13"
 description = "LNbits, free and open-source Lightning wallet and accounts system."
 authors = [{ name = "Alan Bits", email = "alan@lnbits.com" }]

uv.lock

@@ -1247,7 +1247,7 @@ wheels = [
 
 [[package]]
 name = "lnbits"
-version = "1.5.0"
+version = "1.5.1"
 source = { editable = "." }
 dependencies = [
     { name = "aiosqlite" },
@@ -2769,14 +2769,14 @@ wheels = [
 
 [[package]]
 name = "werkzeug"
-version = "3.1.5"
+version = "3.1.6"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "markupsafe" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/5a/70/1469ef1d3542ae7c2c7b72bd5e3a4e6ee69d7978fa8a3af05a38eca5becf/werkzeug-3.1.5.tar.gz", hash = "sha256:6a548b0e88955dd07ccb25539d7d0cc97417ee9e179677d22c7041c8f078ce67", size = 864754, upload-time = "2026-01-08T17:49:23.247Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/61/f1/ee81806690a87dab5f5653c1f146c92bc066d7f4cebc603ef88eb9e13957/werkzeug-3.1.6.tar.gz", hash = "sha256:210c6bede5a420a913956b4791a7f4d6843a43b6fcee4dfa08a65e93007d0d25", size = 864736, upload-time = "2026-02-19T15:17:18.884Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ad/e4/8d97cca767bcc1be76d16fb76951608305561c6e056811587f36cb1316a8/werkzeug-3.1.5-py3-none-any.whl", hash = "sha256:5111e36e91086ece91f93268bb39b4a35c1e6f1feac762c9c822ded0a4e322dc", size = 225025, upload-time = "2026-01-08T17:49:21.859Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/ec/d58832f89ede95652fd01f4f24236af7d32b70cab2196dfcc2d2fd13c5c2/werkzeug-3.1.6-py3-none-any.whl", hash = "sha256:7ddf3357bb9564e407607f988f683d72038551200c704012bb9a4c523d42f131", size = 225166, upload-time = "2026-02-19T15:17:17.475Z" },
 ]
 
 [[package]]