Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
52 commits
Select commit Hold shift + click to select a range
9e294b8
fix: findings in auth-sessions (cycle 1)
erubboli Oct 20, 2026
17a9cc3
fix: findings in tokens-trading (cycle 1)
erubboli Oct 20, 2026
ed30df8
fix: findings in wallet-rpc (cycle 1)
erubboli Oct 20, 2026
2a14ae6
fix: findings in bitcoin (cycle 1)
erubboli Oct 20, 2026
6291ccc
fix: findings in bridge (cycle 1)
erubboli Oct 20, 2026
0b23a76
fix: findings in settings-management (cycle 1)
erubboli Oct 20, 2026
674b53e
fix: findings in foundation-lib (cycle 1)
erubboli Oct 20, 2026
2870b26
fix: findings in infra (cycle 1)
erubboli Oct 20, 2026
66df886
fix: findings in bridge and trading components (cycle 2)
erubboli Oct 20, 2026
1c6890f
fix: findings in infra (cycle 2)
erubboli Oct 20, 2026
668d5ef
fix: findings in the wallet rpc surface (cycle 2)
erubboli Oct 20, 2026
7f97262
fix: findings in installers and the service sidecar (cycle 2)
erubboli Oct 20, 2026
8f00feb
fix: keep first-run setup private to the staging browser (cycle 2)
erubboli Oct 20, 2026
839b72c
fix: findings on the settings and wallet pages (cycle 2)
erubboli Oct 20, 2026
73710b7
fix: reject nonzero padding in p2wsh bech32 programs (cycle 2)
erubboli Oct 20, 2026
2abf231
fix: keep the bitcoin wallet responsive while it scans (cycle 2)
erubboli Oct 21, 2026
efa2195
fix: findings in foundation libraries (cycle 3)
erubboli Oct 21, 2026
9e6c9f6
fix: findings in the wallet rpc surface (cycle 3)
erubboli Oct 21, 2026
72e8a6c
fix: findings on the settings and wallet pages (cycle 3)
erubboli Oct 21, 2026
c5cf536
fix: findings in the bridge components (cycle 3)
erubboli Oct 21, 2026
9500aff
fix: findings in the bitcoin wallet (cycle 3)
erubboli Oct 21, 2026
0091ebb
fix: findings in the trading components (cycle 3)
erubboli Oct 21, 2026
ea09917
fix: findings in the auth and session flow (cycle 3)
erubboli Oct 21, 2026
133af9a
fix: findings in the deployment and upgrade tooling (cycle 3)
erubboli Oct 21, 2026
0f6845a
fix: findings in the management pages (cycle 4)
erubboli Oct 21, 2026
8d6f9d5
fix: findings in the auth and bootstrap flow (cycle 4)
erubboli Oct 21, 2026
5d1ca9f
fix: findings in the shared libraries (cycle 4)
erubboli Oct 21, 2026
ca38789
fix: findings in the bitcoin wallet (cycle 4)
erubboli Oct 21, 2026
0b13d7c
fix: findings in the bridge flow (cycle 4)
erubboli Oct 21, 2026
de8bd52
fix: findings in the trading flow (cycle 4)
erubboli Oct 21, 2026
5479e1d
fix: findings in the install and deploy paths (cycle 4)
erubboli Oct 21, 2026
cd8361f
fix: findings in the wallet surface (cycle 4)
erubboli Oct 21, 2026
d0e0af3
fix: findings in the shared libraries (cycle 5)
erubboli Oct 21, 2026
8a85bf2
fix: findings in the wallet surface (cycle 5)
erubboli Oct 21, 2026
3704e4f
fix: findings in the bitcoin wallet (cycle 5)
erubboli Oct 21, 2026
739a27b
fix: clamp bridge quick chips to the token decimals
erubboli Oct 21, 2026
fe6c8e7
fix: findings in the trading surface (cycle 5)
erubboli Oct 21, 2026
9b70ef8
fix: findings in the management pages (cycle 5)
erubboli Oct 21, 2026
e55864f
fix: findings in the auth flow (cycle 5)
erubboli Oct 21, 2026
74d586b
fix: findings in the install and compose layer (cycle 5)
erubboli Oct 21, 2026
98be934
fix: findings in the bitcoin wallet and update card (cycle 6)
erubboli Oct 21, 2026
b13397a
fix: findings in the bridge amounts and deploy scripts (cycle 6)
erubboli Oct 21, 2026
f1dd4ec
fix: findings in the wallet surface and trading (cycle 6)
erubboli Oct 21, 2026
e9a14a3
fix: findings in the bitcoin wallet (cycle 7)
erubboli Oct 21, 2026
3ab940e
fix: keep bridge quick chips on whole tokens for 0-decimal assets
erubboli Oct 21, 2026
a17fd53
fix: findings in the management pages (cycle 7)
erubboli Oct 21, 2026
f062e36
fix: findings in the deploy scripts (cycle 7)
erubboli Oct 21, 2026
a988e7e
fix: findings in the wallet surface (cycle 7)
erubboli Oct 21, 2026
308e167
fix: reset the order pair decimals when the pair is deselected
erubboli Oct 21, 2026
43f7654
fix: findings in the bitcoin wallet (cycle 8)
erubboli Oct 21, 2026
643c3ef
fix: reject whitespace install paths in non-interactive mode
erubboli Oct 21, 2026
e6438c9
fix: findings in the wallet surface (cycle 8)
erubboli Oct 21, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 18 additions & 5 deletions .env.example
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ ML_GROUP_ID=1000
# WEB_GUI_IMAGE=ghcr.io/mintlayer/web-gui/web-gui:latest
# BDK_WALLET_IMAGE=ghcr.io/mintlayer/web-gui/bdk-wallet:latest
# BTC_EXPLORER_IMAGE=ghcr.io/mintlayer/web-gui/btc-explorer:latest
# Mintlayer daemons are also rebuilt from v1.4.0 source for arm64:
# Mintlayer daemons are also rebuilt from v1.4.1 source for arm64:
# ML_NODE_DAEMON_IMAGE=ghcr.io/mintlayer/web-gui/node-daemon:latest
# ML_WALLET_RPC_DAEMON_IMAGE=ghcr.io/mintlayer/web-gui/wallet-rpc-daemon:latest
# ML_API_SCANNER_IMAGE=ghcr.io/mintlayer/web-gui/api-blockchain-scanner-daemon:latest
Expand Down Expand Up @@ -90,6 +90,13 @@ PASSKEY_ORIGIN=http://localhost:4321
# and managed via the web UI Settings page.
SESSION_SECRET=<64-hex-chars-random>

# ── Optional-services sidecar ─────────────────────
# The feature-enabler container (settings-page toggles/upgrades) applies
# compose against the REAL host path of this checkout - a container path
# breaks bind mounts and the compose project name. init.sh writes this;
# manual installs must set it to the absolute checkout directory.
PROJECT_DIR_HOST=/absolute/path/to/web-gui

# ── Indexer (optional, profile: indexer) ─────────────
# Only needed when running: docker compose --profile indexer up
POSTGRES_USER=mintlayer
Expand Down Expand Up @@ -127,7 +134,8 @@ PINATA_GATEWAY_URL=
BITCOIN_ENABLED=false

# Bitcoin network. Empty = follow NETWORK above (mainnet/testnet).
# Valid values: mainnet, testnet, regtest, signet.
# Supported end to end: mainnet, testnet, regtest. (signet is not wired
# through the enabler allowlist or Core's -chain fallback - do not use.)
BITCOIN_NETWORK=

# Credentials for the bitcoind RPC (used by the bdk-wallet sidecar).
Expand All @@ -139,12 +147,17 @@ BITCOIN_WALLET_HTTP_USERNAME=btcwallet_user
BITCOIN_WALLET_HTTP_PASSWORD=btcwallet_password_change_me

# Advanced: transaction index and pruning for bitcoind.
# txindex=1 (default) is required for full wallet history.
# prune>0 saves disk but is incompatible with the wallet history sync
# (mainnet chain data is ~700 GB with txindex=1).
# txindex=1 (default) keeps full wallet history available to rescans.
# prune>0 saves disk (pruned keeps only recent blocks) but the wallet
# sidecar refuses restoring an OLD seed against a pruned node.
BITCOIN_TXINDEX=1
BITCOIN_PRUNE=0

# Bitcoin Core's -chain value. init.sh derives this (mainnet -> "main",
# others pass through). Manual installs: leave as "main" for mainnet,
# or set test / regtest / signet to match BITCOIN_NETWORK.
#BITCOIN_CORE_CHAIN=main

# Block explorer used for tx/address links in the Bitcoin page.
# Empty default: public networks link to mempool.space; regtest links to
# the self-hosted btc-rpc-explorer sidecar (http://localhost:3002).
Expand Down
36 changes: 21 additions & 15 deletions Makefile
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
.PHONY: up down restart nuke restart-gui build logs dev dev-build dev-local dev-env wallet-cli bitcoin bitcoin-cli nft-images-public pending-transactions list-utxos

ACCOUNT ?= 0
# Compose derives the network name from the project directory
# (checkout folder), not from a fixed string - derive it the same way.
COMPOSE_NETWORK ?= $(notdir $(CURDIR))_default
# Helper tools read RPC credentials from the env file; dev stacks
# only have .env.dev.
ENV_FILE := $(if $(wildcard .env),.env,.env.dev)

## Start all services
up:
Expand All @@ -9,28 +15,28 @@ up:

## Stop and remove all containers (including optional profiles and orphaned run containers)
down:
docker compose --profile indexer --profile wallet_cli --profile bitcoin down --remove-orphans
docker compose --profile indexer --profile wallet_cli --profile bitcoin --profile web --profile watchtower down --remove-orphans

## Full clean restart: tear down everything, fix stuck networks, then bring up fresh
## Fixes "Network still in use" / "network not found" errors from dangling containers.
restart: down
@# Disconnect any containers still clinging to the project network
@NETWORK=mintlayer-web-gui_default; \
@NETWORK=$(COMPOSE_NETWORK); \
CONTAINERS=$$(docker network inspect $$NETWORK --format '{{range .Containers}}{{.Name}} {{end}}' 2>/dev/null || true); \
if [ -n "$$CONTAINERS" ]; then \
echo "Disconnecting dangling containers from $$NETWORK: $$CONTAINERS"; \
for c in $$CONTAINERS; do docker network disconnect -f $$NETWORK $$c 2>/dev/null || true; done; \
fi
@# Remove the network if it still exists so Docker recreates it cleanly
@docker network rm mintlayer-web-gui_default 2>/dev/null || true
@docker network rm $(COMPOSE_NETWORK) 2>/dev/null || true
docker compose up -d

## Nuclear option: remove ALL stopped containers and unused networks project-wide,
## then restart. Use when restart still fails.
## Nuclear option: remove this project's containers/volumes/networks, then
## restart. Use when restart still fails. Deliberately project-scoped -
## host-wide `docker prune` would eat stopped containers from unrelated
## projects on shared machines.
nuke:
docker compose --profile indexer --profile wallet_cli --profile bitcoin down --remove-orphans --volumes 2>/dev/null || true
docker container prune -f
docker network prune -f
docker compose --profile indexer --profile wallet_cli --profile bitcoin --profile web --profile watchtower down --remove-orphans --volumes 2>/dev/null || true
docker compose up -d

## Rebuild and restart only the web-gui container
Expand Down Expand Up @@ -88,35 +94,35 @@ bitcoin:
## bitcoin-cli shell inside the Bitcoin node container
## Usage: make bitcoin-cli CMD='getblockchaininfo'
bitcoin-cli:
docker compose --profile bitcoin exec bitcoind bitcoin-cli -rpcport=8332 -rpcuser=$$(grep '^BITCOIN_RPC_USERNAME=' .env | cut -d= -f2) -rpcpassword=$$(grep '^BITCOIN_RPC_PASSWORD=' .env | cut -d= -f2) $(CMD)
docker compose --profile bitcoin exec bitcoind bitcoin-cli -rpcport=8332 -rpcuser=$$(grep '^BITCOIN_RPC_USERNAME=' .env | cut -d= -f2-) -rpcpassword=$$(grep '^BITCOIN_RPC_PASSWORD=' .env | cut -d= -f2-) $(CMD)

## List pending transactions for account ACCOUNT (default 0) via wallet RPC.
## Usage: make pending-transactions or make pending-transactions ACCOUNT=1
pending-transactions:
docker run --rm \
--network web-gui_default \
--network $(COMPOSE_NETWORK) \
-v "$(CURDIR)/tools:/tools:ro" \
-v "$(CURDIR)/.env:/.env:ro" \
-v "$(CURDIR)/$(ENV_FILE):/.env:ro" \
-e WALLET_RPC_HOST=wallet-rpc-daemon \
alpine sh -c 'apk add -q bash curl jq >/dev/null && bash /tools/list-pending-transactions.sh $(ACCOUNT)'

## List UTXOs for account ACCOUNT (default 0) via wallet RPC.
## Usage: make list-utxos or make list-utxos ACCOUNT=1
list-utxos:
docker run --rm \
--network web-gui_default \
--network $(COMPOSE_NETWORK) \
-v "$(CURDIR)/tools:/tools:ro" \
-v "$(CURDIR)/.env:/.env:ro" \
-v "$(CURDIR)/$(ENV_FILE):/.env:ro" \
-e WALLET_RPC_HOST=wallet-rpc-daemon \
alpine sh -c 'apk add -q bash curl jq >/dev/null && bash /tools/list-utxos.sh $(ACCOUNT)'

## Ensure all NFT images stored on Pinata are publicly accessible.
## Runs inside Docker so it can reach wallet-rpc-daemon on the internal network.
nft-images-public:
docker run --rm \
--network mintlayer-web-gui_default \
--network $(COMPOSE_NETWORK) \
-v "$(CURDIR)/tools:/tools:ro" \
-v "$(CURDIR)/.env:/.env:ro" \
-v "$(CURDIR)/$(ENV_FILE):/.env:ro" \
-e WALLET_RPC_URL=http://wallet-rpc-daemon:3034 \
node:lts-alpine \
node /tools/make-nft-images-public.mjs
Loading
Loading