Liquity updates

README.md

@@ -2154,6 +2154,16 @@ Though redemptions are permissionless, they are complicated and MEV-competitive.
 
 As [explained here](https://github.com/liquity/bold?tab=readme-ov-file#closing-the-last-trove-in-the-system), the last Trove in a branch can not be closed unless that branch has been shut down. 
 
+## `MIN_DEBT` parameter choice
+
+The minimum debt should be chosen based on gas costs of redemption (both USD and raw gas). In canonical v2, 2000 BOLD was chosen as the `MIN_DEBT` in order to ensure that, in the wost case where the lower end of the interest-sorted list is filled with minimum debt Troves, redemptions can not be significantly griefed and substantial BOLD volumes can still be redeemed. For chains with cheaper gas costs (in USD), a lower `MIN_DEBT` may be economically viable. It's also worth comparing raw gas costs - though often very similar across EVM chains, opcodes may be priced differently and so raw gas cost may vary. Lower raw gas costs imply more redemptions can be fit into a single block/tx and vice versa.
+
+## `ETH_GAS_COMPENSATION` and `COLL_GAS_COMPENSATION_CAP` parameter choices
+
+The canonical v2 value of `ETH_GAS_COMPENSATION = 0.0375` was chosen based on ETH, WSTETH and RETH collateral. For collateral tokens whereby the market price differs by orders of magnitude, the `ETH_GAS_COMPENSATION` should be adjusted accordingly - the default v2 value may be insufficient if your collateral price is much lower, and too generous if the price is much higher.
+
+Similarly, the `COLL_GAS_COMPENSATION_CAP` may be too low or high depending on order of magnitude of your collateral price.
+
 ## Security and audits
 
 It is advisable to perform one or more security audits for any changes made to the core system contracts or parameters. Even seemingly tiny or trivial changes can have outsized and unintended impacts on system security and economic resilience.

contracts/addresses/1.json

@@ -14,6 +14,8 @@
   "multiTroveGetter": "0xfa61db085510c64b83056db3a7acf3b6f631d235",
   "debtInFrontHelper": "0x4bb5e28fdb12891369b560f2fab3c032600677c6",
   "exchangeHelpers": "0x2f60bab0072abec7058017f48d7256ec288c8686",
+  "exchangeHelpersV2": "0xe453b864d3841469763bda2437e3dd0e38dca222",
+  "redemptionHelper": "0xb366256d033ae7e4f7bddec822a5adec9df07b80",
   "branches": [
     {
       "collSymbol": "WETH",

contracts/addresses/11155111.json

@@ -12,8 +12,10 @@
   "boldToken": "0x181dff47198bf3f3ed65877332e8395eb6817c4c",
   "hintHelpers": "0x10fe36cc9a830c86f8117c74e85ce6c58705ef21",
   "multiTroveGetter": "0x19303bc4d3518039d0780a55e9950b222b178467",
-  "debtInFrontHelper": "0xaeeafadd6d39e1e7c82977fe3fa274fa32a98da8",
+  "debtInFrontHelper": "0x99d799D62611849D4D1dA5FF770147164873Eb99",
   "exchangeHelpers": "0x2b50462f3026446fa9f6e618f3f08a67aae96317",
+  "exchangeHelpersV2": "0x3fff2e6b2f7fb3121d966c1d67fa8f3ab5a99f3f",
+  "redemptionHelper": "0xf299f3c504904c5f0b67f0ea0caf745d8912dc45",
   "branches": [
     {
       "collSymbol": "WETH",

contracts/broadcast/DeployOnlyExchangeHelpersV2.s.sol/1/run-1757655932243.json

@@ -0,0 +1,55 @@
+{
+  "transactions": [
+    {
+      "hash": "0x47f583a1e4f0e424426b8aa4b06f14f510c67bc11efa026abd776932b79b5c01",
+      "transactionType": "CREATE",
+      "contractName": "HybridCurveUniV3ExchangeHelpersV2",
+      "contractAddress": "0xe453b864d3841469763bda2437e3dd0e38dca222",
+      "function": null,
+      "arguments": [
+        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+        "0xEFc6516323FbD28e80B85A497B65A86243a54B3E",
+        "1",
+        "0",
+        "500",
+        "100",
+        "0x61fFE014bA17989E743c5F6cB21bF9697530B21e"
+      ],
+      "transaction": {
+        "from": "0x147676a5e327080386bcc227e103a73dd2979049",
+        "gas": "0x13ef22",
+        "value": "0x0",
+        "input": "0x61018060405234801562000011575f80fd5b506040516200145f3803806200145f8339810160408190526200003491620000b9565b6001600160a01b0397881660805295871660a05293861660c052600f92830b60e052910b6101005262ffffff908116610120521661014052166101605262000168565b6001600160a01b03811681146200008c575f80fd5b50565b8051600f81900b8114620000a1575f80fd5b919050565b805162ffffff81168114620000a1575f80fd5b5f805f805f805f80610100898b031215620000d2575f80fd5b8851620000df8162000077565b60208a0151909850620000f28162000077565b60408a0151909750620001058162000077565b95506200011560608a016200008f565b94506200012560808a016200008f565b93506200013560a08a01620000a6565b92506200014560c08a01620000a6565b915060e0890151620001578162000077565b809150509295985092959890939650565b60805160a05160c05160e0516101005161012051610140516101605161114c620003135f395f8181610144015281816103e0015281816107a801528181610a9e0152610caf01525f81816101920152818161031f0152818161074b01528181610a410152610bee01525f8181610109015281816102b4015281816103610152818161067e0152818161070901528181610974015281816109ff01528181610b830152610c3001525f818161022d0152818161049501528181610551015281816108720152610d3901525f81816101e00152818161046a0152818161057c015281816108470152610d6401525f818160a4015281816104c8015281816105ad015281816108a30152610d9701525f81816101b90152818161026401528181610293015281816103400152818161062e0152818161069f0152818161072a015281816109240152818161099501528181610a2001528181610b3301528181610b620152610c0f01525f818161016b015281816102d5015281816103820152818161065d015281816106e801528181610953015281816109de01528181610ba40152610c51015261114c5ff3fe608060405234801561000f575f80fd5b506004361061009b575f3560e01c806390a7e01f1161006357806390a7e01f1461018d578063ad5c4648146101b4578063c38cff9a146101db578063dad1ef3514610215578063e8f2751114610228575f80fd5b8063218751b21461009f57806325b1445c146100e357806347398d4b14610104578063795674ff1461013f57806389a3027114610166575b5f80fd5b6100c67f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b0390911681526020015b60405180910390f35b6100f66100f1366004610e29565b61024f565b6040519081526020016100da565b61012b7f000000000000000000000000000000000000000000000000000000000000000081565b60405162ffffff90911681526020016100da565b6100c67f000000000000000000000000000000000000000000000000000000000000000081565b6100c67f000000000000000000000000000000000000000000000000000000000000000081565b61012b7f000000000000000000000000000000000000000000000000000000000000000081565b6100c67f000000000000000000000000000000000000000000000000000000000000000081565b6102027f000000000000000000000000000000000000000000000000000000000000000081565b604051600f9190910b81526020016100da565b6100f6610223366004610e29565b610831565b6102027f000000000000000000000000000000000000000000000000000000000000000081565b5f8215610542576060826001600160a01b03167f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03160361031c577f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f000000000000000000000000000000000000000000000000000000000000000060405160200161030693929190610e6c565b60405160208183030381529060405290506103c7565b827f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000006040516020016103b5959493929190610ea7565b60405160208183030381529060405290505b60405163cdca175360e01b81525f906001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063cdca1753906104179085908a90600401610ef9565b5f604051808303815f875af1158015610432573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526104599190810190611030565b5050604051635e0d443f60e01b81527f0000000000000000000000000000000000000000000000000000000000000000600f90810b60048301527f0000000000000000000000000000000000000000000000000000000000000000900b602482015260448101839052919250507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031690635e0d443f90606401602060405180830381865afa158015610515573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061053991906110ff565b9250505061082a565b604051635e0d443f60e01b81527f0000000000000000000000000000000000000000000000000000000000000000600f90810b60048301527f0000000000000000000000000000000000000000000000000000000000000000900b6024820152604481018590525f907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031690635e0d443f90606401602060405180830381865afa1580156105fa573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061061e91906110ff565b90506060836001600160a01b03167f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316036106e6577f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000006040516020016106d093929190610e6c565b6040516020818303038152906040529050610791565b7f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000008760405160200161077f959493929190610ea7565b60405160208183030381529060405290505b60405163cdca175360e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063cdca1753906107df9084908690600401610ef9565b5f604051808303815f875af11580156107fa573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f191682016040526108219190810190611030565b50919450505050505b9392505050565b5f8215610b25576040516333ef816560e11b81527f0000000000000000000000000000000000000000000000000000000000000000600f90810b60048301527f0000000000000000000000000000000000000000000000000000000000000000900b6024820152604481018590525f907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906367df02ca90606401602060405180830381865afa1580156108f0573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061091491906110ff565b90506060836001600160a01b03167f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316036109dc577f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000006040516020016109c693929190610e6c565b6040516020818303038152906040529050610a87565b7f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f000000000000000000000000000000000000000000000000000000000000000087604051602001610a75959493929190610ea7565b60405160208183030381529060405290505b604051632f80bb1d60e01b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690632f80bb1d90610ad59084908690600401610ef9565b5f604051808303815f875af1158015610af0573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052610b179190810190611030565b5091945061082a9350505050565b6060826001600160a01b03167f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031603610beb577f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f0000000000000000000000000000000000000000000000000000000000000000604051602001610bd593929190610e6c565b6040516020818303038152906040529050610c96565b827f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f0000000000000000000000000000000000000000000000000000000000000000604051602001610c84959493929190610ea7565b60405160208183030381529060405290505b604051632f80bb1d60e01b81525f906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690632f80bb1d90610ce69085908a90600401610ef9565b5f604051808303815f875af1158015610d01573d5f803e3d5ffd5b505050506040513d5f823e601f3d908101601f19168201604052610d289190810190611030565b50506040516333ef816560e11b81527f0000000000000000000000000000000000000000000000000000000000000000600f90810b60048301527f0000000000000000000000000000000000000000000000000000000000000000900b602482015260448101839052919250507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906367df02ca90606401602060405180830381865afa158015610de4573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610e0891906110ff565b9695505050505050565b6001600160a01b0381168114610e26575f80fd5b50565b5f805f60608486031215610e3b575f80fd5b8335925060208401358015158114610e51575f80fd5b91506040840135610e6181610e12565b809150509250925092565b606093841b6bffffffffffffffffffffffff19908116825260e89390931b6001600160e81b0319166014820152921b166017820152602b0190565b6bffffffffffffffffffffffff19606096871b811682526001600160e81b031960e896871b8116601484015294871b811660178301529290941b909216602b840152921b909116602e82015260420190565b604081525f83518060408401525f5b81811015610f255760208187018101516060868401015201610f08565b505f606082850101526060601f19601f8301168401019150508260208301529392505050565b634e487b7160e01b5f52604160045260245ffd5b604051601f8201601f1916810167ffffffffffffffff81118282101715610f8857610f88610f4b565b604052919050565b5f67ffffffffffffffff821115610fa957610fa9610f4b565b5060051b60200190565b5f82601f830112610fc2575f80fd5b81516020610fd7610fd283610f90565b610f5f565b8083825260208201915060208460051b870101935086841115610ff8575f80fd5b602086015b8481101561102557805163ffffffff81168114611018575f80fd5b8352918301918301610ffd565b509695505050505050565b5f805f8060808587031215611043575f80fd5b8451935060208086015167ffffffffffffffff80821115611062575f80fd5b818801915088601f830112611075575f80fd5b8151611083610fd282610f90565b81815260059190911b8301840190848101908b8311156110a1575f80fd5b938501935b828510156110c85784516110b981610e12565b825293850193908501906110a6565b60408b015190985094505050808311156110e0575f80fd5b50506110ee87828801610fb3565b606096909601519497939650505050565b5f6020828403121561110f575f80fd5b505191905056fea26469706673582212203cdf613b5ac039ea5b2bbe6511db3b085cffa3a45fc2e457ca4f5a889ea3befa64736f6c63430008180033000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000efc6516323fbd28e80b85a497b65a86243a54b3e0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001f4000000000000000000000000000000000000000000000000000000000000006400000000000000000000000061ffe014ba17989e743c5f6cb21bf9697530b21e",
+        "nonce": "0x35",
+        "chainId": "0x1"
+      },
+      "additionalContracts": [],
+      "isFixedGasLimit": false
+    }
+  ],
+  "receipts": [
+    {
+      "status": "0x1",
+      "cumulativeGasUsed": "0x195c259",
+      "logs": [],
+      "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
+      "type": "0x2",
+      "transactionHash": "0x47f583a1e4f0e424426b8aa4b06f14f510c67bc11efa026abd776932b79b5c01",
+      "transactionIndex": "0xf4",
+      "blockHash": "0x598cc1c5f0177d031e5be4874f16e12d128d0b9cfb7e3f75e05d473cc0f53f01",
+      "blockNumber": "0x164374e",
+      "gasUsed": "0xf557d",
+      "effectiveGasPrice": "0x8408fc8",
+      "from": "0x147676a5e327080386bcc227e103a73dd2979049",
+      "to": null,
+      "contractAddress": "0xe453b864d3841469763bda2437e3dd0e38dca222"
+    }
+  ],
+  "libraries": [],
+  "pending": [],
+  "returns": {},
+  "timestamp": 1757655932243,
+  "chain": 1,
+  "commit": "5cebde67"
+}