lifinance · gvladika · Jul 1, 2026 · May 20, 2026 · May 20, 2026 · May 25, 2026
diff --git a/audit/auditLog.json b/audit/auditLog.json
@@ -629,6 +629,13 @@
       "auditorGitHandle": "sujithsomraaj",
       "auditReportPath": "./audit/reports/2026.06.30_LiFiIntentEscrowFacetV2(v1.0.0).pdf",
       "auditCommitHash": "11aad2677a9434cd394eb9ab98e3fb23d078e50f"
+    },
+    "audit20260701": {
+      "auditCompletedOn": "01.07.2026",
+      "auditedBy": "Sujith Somraaj (individual security researcher)",
+      "auditorGitHandle": "sujithsomraaj",
+      "auditReportPath": "./audit/reports/2026.07.01_SupersetFacet(v1.0.0).pdf",
+      "auditCommitHash": "6baa3f128eae77d4aa1db1985651607b4a1ac72e"
     }
   },
   "auditedContracts": {
@@ -748,7 +755,8 @@
     },
     "GenericErrors": {
       "1.0.1": ["audit20250506", "audit20250508"],
-      "1.0.2": ["audit20250718"]
+      "1.0.2": ["audit20250718"],
+      "1.0.4": ["audit20260701"]
     },
     "GenericSwapFacet": {
       "1.0.0": ["audit20250508"]
@@ -981,6 +989,9 @@
     "StargateFacetV2": {
       "1.0.1": ["audit20240814", "audit20250508"]
     },
+    "SupersetFacet": {
+      "1.0.0": ["audit20260701"]
+    },
     "SwapperV2": {
       "1.0.0": ["audit20250508"],
       "1.0.1": ["audit20250718"],

diff --git a/audit/reports/2026.07.01_SupersetFacet(v1.0.0).pdf b/audit/reports/2026.07.01_SupersetFacet(v1.0.0).pdf
diff --git a/bun.lock b/bun.lock
diff --git a/config/clearSigningProposal.json b/config/clearSigningProposal.json
@@ -1,6 +1,6 @@
 {
   "$note": "ERC-7730 display.formats entries for the LIFI Diamond, generated by tasks/buildClearSigningProposal.ts from Foundry artifacts. Source of truth for clear-signing UX strings. Consumed by tasks/generateLedgerClearSigning.ts during the sync workflow: entries here are merged into the registry payload pushed to ethereum/clear-signing-erc7730-registry.",
-  "$count": 103,
+  "$count": 105,
   "formats": {
     "startBridgeTokensViaAcross((bytes32 transactionId, string bridge, string integrator, address referrer, address sendingAssetId, address receiver, uint256 minAmount, uint256 destinationChainId, bool hasSourceSwaps, bool hasDestinationCall) _bridgeData, (int64 relayerFeePct, uint32 quoteTimestamp, bytes message, uint256 maxCount) _acrossData)": {
       "intent": "Bridge via Across",
@@ -2309,6 +2309,73 @@
         }
       ]
     },
+    "startBridgeTokensViaSuperset((bytes32 transactionId, string bridge, string integrator, address referrer, address sendingAssetId, address receiver, uint256 minAmount, uint256 destinationChainId, bool hasSourceSwaps, bool hasDestinationCall) _bridgeData, (bytes path, uint256 amountOutMin, address refundAddress, address fallbackEoA, uint256 deadline, uint32 toEid, bytes options, uint256 lzFee) _supersetData)": {
+      "intent": "Bridge via Superset",
+      "interpolatedIntent": "Bridge {_bridgeData.minAmount} via Superset to chain {_bridgeData.destinationChainId} for {_bridgeData.receiver}",
+      "fields": [
+        {
+          "path": "_bridgeData.minAmount",
+          "label": "Amount to Bridge",
+          "format": "tokenAmount",
+          "params": {
+            "tokenPath": "_bridgeData.sendingAssetId"
+          },
+          "visible": "always"
+        },
+        {
+          "path": "_bridgeData.destinationChainId",
+          "label": "Destination Chain",
+          "format": "raw",
+          "visible": "always"
+        },
+        {
+          "path": "_bridgeData.receiver",
+          "label": "Recipient",
+          "format": "addressName",
+          "params": {
+            "types": [
+              "eoa",
+              "contract"
+            ],
+            "sources": [
+              "local",
+              "ens"
+            ]
+          },
+          "visible": "always"
+        },
+        {
+          "path": "_bridgeData.transactionId",
+          "label": "Transaction Id",
+          "visible": "never"
+        },
+        {
+          "path": "_bridgeData.bridge",
+          "label": "Bridge",
+          "visible": "never"
+        },
+        {
+          "path": "_bridgeData.integrator",
+          "label": "Integrator",
+          "visible": "never"
+        },
+        {
+          "path": "_bridgeData.referrer",
+          "label": "Referrer",
+          "visible": "never"
+        },
+        {
+          "path": "_bridgeData.hasSourceSwaps",
+          "label": "Has Source Swaps",
+          "visible": "never"
+        },
+        {
+          "path": "_bridgeData.hasDestinationCall",
+          "label": "Has Destination Call",
+          "visible": "never"
+        }
+      ]
+    },
     "startBridgeTokensViaSymbiosis((bytes32 transactionId, string bridge, string integrator, address referrer, address sendingAssetId, address receiver, uint256 minAmount, uint256 destinationChainId, bool hasSourceSwaps, bool hasDestinationCall) _bridgeData, (bytes firstSwapCalldata, bytes secondSwapCalldata, address intermediateToken, address firstDexRouter, address secondDexRouter, address[] approvedTokens, address callTo, bytes callData) _symbiosisData)": {
       "intent": "Bridge via Symbiosis",
       "interpolatedIntent": "Bridge {_bridgeData.minAmount} via Symbiosis to chain {_bridgeData.destinationChainId} for {_bridgeData.receiver}",
@@ -5678,6 +5745,102 @@
         }
       ]
     },
+    "swapAndStartBridgeTokensViaSuperset((bytes32 transactionId, string bridge, string integrator, address referrer, address sendingAssetId, address receiver, uint256 minAmount, uint256 destinationChainId, bool hasSourceSwaps, bool hasDestinationCall) _bridgeData, (address callTo, address approveTo, address sendingAssetId, address receivingAssetId, uint256 fromAmount, bytes callData, bool requiresDeposit)[] _swapData, (bytes path, uint256 amountOutMin, address refundAddress, address fallbackEoA, uint256 deadline, uint32 toEid, bytes options, uint256 lzFee) _supersetData)": {
+      "intent": "Swap & Bridge via Superset",
+      "interpolatedIntent": "Swap then bridge {_bridgeData.minAmount} via Superset to chain {_bridgeData.destinationChainId} for {_bridgeData.receiver}",
+      "fields": [
+        {
+          "path": "_swapData.[0].fromAmount",
+          "label": "Amount to Swap",
+          "format": "tokenAmount",
+          "params": {
+            "tokenPath": "_swapData.[0].sendingAssetId"
+          },
+          "visible": "always"
+        },
+        {
+          "path": "_bridgeData.minAmount",
+          "label": "Minimum to Bridge",
+          "format": "tokenAmount",
+          "params": {
+            "tokenPath": "_bridgeData.sendingAssetId"
+          },
+          "visible": "always"
+        },
+        {
+          "path": "_bridgeData.destinationChainId",
+          "label": "Destination Chain",
+          "format": "raw",
+          "visible": "always"
+        },
+        {
+          "path": "_bridgeData.receiver",
+          "label": "Recipient",
+          "format": "addressName",
+          "params": {
+            "types": [
+              "eoa",
+              "contract"
+            ],
+            "sources": [
+              "local",
+              "ens"
+            ]
+          },
+          "visible": "always"
+        },
+        {
+          "path": "_bridgeData.transactionId",
+          "label": "Transaction Id",
+          "visible": "never"
+        },
+        {
+          "path": "_bridgeData.bridge",
+          "label": "Bridge",
+          "visible": "never"
+        },
+        {
+          "path": "_bridgeData.integrator",
+          "label": "Integrator",
+          "visible": "never"
+        },
+        {
+          "path": "_bridgeData.referrer",
+          "label": "Referrer",
+          "visible": "never"
+        },
+        {
+          "path": "_bridgeData.hasSourceSwaps",
+          "label": "Has Source Swaps",
+          "visible": "never"
+        },
+        {
+          "path": "_bridgeData.hasDestinationCall",
+          "label": "Has Destination Call",
+          "visible": "never"
+        },
+        {
+          "path": "_swapData.[].callData",
+          "label": "Swap Data Call Data",
+          "visible": "never"
+        },
+        {
+          "path": "_swapData.[].callTo",
+          "label": "Swap Data Call To",
+          "visible": "never"
+        },
+        {
+          "path": "_swapData.[].approveTo",
+          "label": "Swap Data Approve To",
+          "visible": "never"
+        },
+        {
+          "path": "_swapData.[].requiresDeposit",
+          "label": "Swap Data Requires Deposit",
+          "visible": "never"
+        }
+      ]
+    },
     "swapAndStartBridgeTokensViaSymbiosis((bytes32 transactionId, string bridge, string integrator, address referrer, address sendingAssetId, address receiver, uint256 minAmount, uint256 destinationChainId, bool hasSourceSwaps, bool hasDestinationCall) _bridgeData, (address callTo, address approveTo, address sendingAssetId, address receivingAssetId, uint256 fromAmount, bytes callData, bool requiresDeposit)[] _swapData, (bytes firstSwapCalldata, bytes secondSwapCalldata, address intermediateToken, address firstDexRouter, address secondDexRouter, address[] approvedTokens, address callTo, bytes callData) _symbiosisData)": {
       "intent": "Swap & Bridge via Symbiosis",
       "interpolatedIntent": "Swap then bridge {_bridgeData.minAmount} via Symbiosis to chain {_bridgeData.destinationChainId} for {_bridgeData.receiver}",

diff --git a/config/superset.json b/config/superset.json
@@ -0,0 +1,15 @@
+{
+  "IMPORTANT DEV NOTICE": "after adding a new mapping, call initSuperset (first deploy) or setChainIdToEid (incremental update) on every diamond where SupersetFacet is deployed",
+  "Source for LayerZero EIDs: https://docs.layerzero.network/v2/deployments/deployed-contracts": {},
+  "Source for Superset PoolManager addresses: https://github.com/superset-finance/deployments/blob/main/manifests/mainnet.json": {},
+  "poolManager": {
+    "arbitrum": "0xcC687ed9155F5e49719D5f3147F79FD5F177961c",
+    "base": "0x57C155a15a9CA0A6C1F759ac6988b4fCa3663Ea4",
+    "unichain": "0x326D0B0357b394EC5bbeFE87554243E5dc76e56E"
+  },
+  "mappings": [
+    { "chainId": 42161, "lzEid": 30110 },
+    { "chainId": 8453, "lzEid": 30184 },
+    { "chainId": 130, "lzEid": 30320 }
+  ]
+}
diff --git a/deployments/arbitrum.staging.json b/deployments/arbitrum.staging.json
@@ -71,5 +71,6 @@
   "ReceiverOIF": "0x55C74AdB64A9C11EFA5637dF58AC17Bc77D5c911",
   "WhitelistRecoveryFacet": "0xd35fC069dcBD50780c706750A41AfC418f25f5D6",
   "EcoFacet": "0x532CEdcf24B769EA6dB2D6970220C38b15C9fAF2",
-  "FeeForwarder": "0x7C1923FbD89154156DE2220870C834B141bA8c49"
+  "FeeForwarder": "0x7C1923FbD89154156DE2220870C834B141bA8c49",
+  "SupersetFacet": "0x54AEC552Acc3218b0B3991FD61cA12b3A4fD222D"
 }
diff --git a/deployments/base.staging.json b/deployments/base.staging.json
@@ -25,5 +25,6 @@
   "FeeCollector": "0x8354CdFA9FD680e53a4AAAecbf7dfB22665c36Ec",
   "ERC20Proxy": "0xC87e9C07db776bd167bEFc3a6d46797BCf343313",
   "Executor": "0xaD2cc66a7dC1e5adFE4419355D8b128845E77f04",
-  "ReceiverOIF": "0xa89c674d04E44AD24D38298097e94281BF93f9AD"
+  "ReceiverOIF": "0xa89c674d04E44AD24D38298097e94281BF93f9AD",
+  "SupersetFacet": "0x54AEC552Acc3218b0B3991FD61cA12b3A4fD222D"
 }