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

script/deploy/DeployQuotePushFlashWorkflowBorrower.s.sol

@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.20;
+
+import {Script, console} from "forge-std/Script.sol";
+import {QuotePushFlashWorkflowBorrower} from "../../contracts/flash/QuotePushFlashWorkflowBorrower.sol";
+
+/**
+ * @title DeployQuotePushFlashWorkflowBorrower
+ * @notice Deploy the ERC-3156 quote-push borrower against a trusted flash lender.
+ *
+ * Env:
+ *   PRIVATE_KEY                    required
+ *   QUOTE_PUSH_FLASH_LENDER        required
+ *
+ * Usage:
+ *   forge script script/deploy/DeployQuotePushFlashWorkflowBorrower.s.sol:DeployQuotePushFlashWorkflowBorrower \
+ *     --rpc-url <RPC> --broadcast -vvvv
+ */
+contract DeployQuotePushFlashWorkflowBorrower is Script {
+    function run() external {
+        uint256 pk = vm.envUint("PRIVATE_KEY");
+        address lender = vm.envAddress("QUOTE_PUSH_FLASH_LENDER");
+        address deployer = vm.addr(pk);
+
+        console.log("Deployer:", deployer);
+        console.log("Trusted lender:", lender);
+
+        vm.startBroadcast(pk);
+        QuotePushFlashWorkflowBorrower borrower = new QuotePushFlashWorkflowBorrower(lender);
+        vm.stopBroadcast();
+
+        console.log("QuotePushFlashWorkflowBorrower:", address(borrower));
+    }
+}