feat: bridges, PMM, flash workflow, token-aggregation, and deployment docs

- CCIP/trustless bridge contracts, GRU tokens, DEX/PMM tests, reserve vault.
- Token-aggregation service routes, planner, chain config, relay env templates.
- Config snapshots and multi-chain deployment markdown updates.
- gitignore services/btc-intake/dist/ (tsc output); do not track dist.

Run forge build && forge test before deploy (large solc graph).

Made-with: Cursor

scripts/deployment/print-gnosis-bootstrap-cast-sequence.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Deprecated helper kept as a guardrail for historical references.
+#
+# Why deprecated:
+# - Chain 138 emits through a custom router that only creates MessageSent events.
+# - Native destination mappings like 138 -> Gnosis do not by themselves create
+#   a live delivery path into public-chain CCIP bridges.
+# - A real 138 -> Gnosis test already failed for this reason.
+#
+# Use instead:
+#   ./scripts/deployment/print-chain138-public-chain-unload-routes.sh
+
+set -euo pipefail
+
+cat <<'EOF'
+print-gnosis-bootstrap-cast-sequence.sh is deprecated.
+
+Reason:
+- `138 -> Gnosis` is not a practical first-hop route with the current live architecture.
+- Chain 138 uses a custom event-emitting router, so a native Gnosis bridge mapping is not enough to deliver the message.
+- The earlier live `138 -> Gnosis` attempt failed for exactly that reason.
+
+Use this instead:
+
+  cd /home/intlc/projects/proxmox/smom-dbis-138
+  ./scripts/deployment/print-chain138-public-chain-unload-routes.sh
+
+Useful examples:
+
+  TARGET_CHAIN=mainnet ./scripts/deployment/print-chain138-public-chain-unload-routes.sh
+  TARGET_CHAIN=bsc ./scripts/deployment/print-chain138-public-chain-unload-routes.sh
+  TARGET_CHAIN=gnosis ./scripts/deployment/print-chain138-public-chain-unload-routes.sh
+
+Current practical model:
+- first-hop relay-backed lanes: Mainnet, BSC, Avalanche
+- hub-distribution lanes after mainnet bootstrap: Gnosis, Cronos, Celo, Polygon, Arbitrum, Optimism, Base
+- WEMIX: deploy and wire first
+EOF