@inco/lightning 0.1.32 → 0.2.0

package/manifest.yaml

@@ -1,281 +1,171 @@
-incoLightning_0_1_29__183408998:
-  release:
-    name: incoLightning_0_1_29__183408998
-    executorAddress: "0x63D8135aF4D393B1dB43B649010c8D3EE19FC9fd"
+incoLightning_testnet_v0_183408998:
+  executor:
+    name: incoLightning_testnet_v0_183408998
+    majorVersion: 0
     deployer: "0x8202D2D747784Cb7D48868E44C42C4bf162a70BC"
     pepper: testnet
-    version:
-      major: 0
-      minor: 1
-      patch: 29
-      shortSalt: "183408998"
+    executorAddress: "0x63D8135aF4D393B1dB43B649010c8D3EE19FC9fd"
     salt: "0x8202d2d747784cb7d48868e44c42c4bf162a70bc00d75ffa0caf0797c3f12d66"
   deployments:
-    - decryptSigner: "0x000000000000000000000000000000000000baBe"
-      eciesPublicKey: "0x000000000000000000000000000000000000000000000000000000000000\
-        000000000000000000000000000000000000000000000000000000000000000000babe"
-      chainId: "7311099111"
-      blockNumber: "1"
-      chainName: Inco Release Chain
-      active: true
-      deployDate: 2025-04-22T16:02:38.372Z
-      commit: v3-28-g93c05a49-dirty
-      addTwoAddress: "0x04461CD161001BC484C55D253F744462A6eADc10"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
+    - name: incoLightning_0_2_0__183408998
+      chainId: "84532"
+      chainName: Base Sepolia
+      version:
+        major: 0
+        minor: 2
+        patch: 0
+        shortSalt: "183408998"
+      decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
       eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
         4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
+      blockNumber: "26296576"
+      deployDate: 2025-05-27T15:57:24.175Z
+      commit: v5-3-gec8b6aae-dirty
+      active: true
+    - name: incoLightning_0_1_29__183408998
       chainId: "10143"
-      blockNumber: "13464615"
       chainName: Monad Testnet
-      active: true
+      version:
+        major: 0
+        minor: 1
+        patch: 29
+        shortSalt: "183408998"
+      decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
+      eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
+        4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
+      blockNumber: "13464615"
       deployDate: 2025-04-22T16:01:14.380Z
       commit: v3-28-g93c05a49-dirty
-      addTwoAddress: "0x3E0Aa45e4BD7E86093460A302803298a0EE7155a"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
+      active: true
+    - name: incoLightning_0_1_29__183408998
+      chainId: "84532"
+      chainName: Base Sepolia
+      version:
+        major: 0
+        minor: 1
+        patch: 29
+        shortSalt: "183408998"
+      decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
       eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
         4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
-      chainId: "84532"
       blockNumber: "24784654"
-      chainName: Base Sepolia
-      active: true
       deployDate: 2025-04-22T16:00:02.028Z
       commit: v3-28-g93c05a49-dirty
-      addTwoAddress: "0xF10E6B2ddd168D105546f39E1Ba64004E4FbeF10"
-incoLightning_0_1_29__340846814:
-  release:
-    name: incoLightning_0_1_29__340846814
-    executorAddress: "0x3B22be60Ae699933959CA3cE147C96caa88Ccd3D"
+      active: true
+incoLightning_demonet_v0_863421733:
+  executor:
+    name: incoLightning_demonet_v0_863421733
+    majorVersion: 0
     deployer: "0x8202D2D747784Cb7D48868E44C42C4bf162a70BC"
-    pepper: devnet
-    version:
-      major: 0
-      minor: 1
-      patch: 29
-      shortSalt: "340846814"
-    salt: "0x8202d2d747784cb7d48868e44c42c4bf162a70bc00b001d6742fded0dd599ede"
+    pepper: demonet
+    executorAddress: "0xeBAFF6D578733E4603b99CBdbb221482F29a78E1"
+    salt: "0x8202d2d747784cb7d48868e44c42c4bf162a70bc00834654f6d289ccc7e5ab25"
   deployments:
-    - decryptSigner: "0x000000000000000000000000000000000000baBe"
-      eciesPublicKey: "0x000000000000000000000000000000000000000000000000000000000000\
-        000000000000000000000000000000000000000000000000000000000000000000babe"
-      chainId: "7311099111"
-      blockNumber: "1"
-      chainName: Inco Release Chain
-      active: true
-      deployDate: 2025-04-22T15:59:01.071Z
-      commit: v3-28-g93c05a49-dirty
-      addTwoAddress: "0x04461CD161001BC484C55D253F744462A6eADc10"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
+    - name: incoLightning_0_2_0__863421733
+      chainId: "84532"
+      chainName: Base Sepolia
+      version:
+        major: 0
+        minor: 2
+        patch: 0
+        shortSalt: "863421733"
+      decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
       eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
         4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
-      chainId: "10143"
-      blockNumber: "13464197"
-      chainName: Monad Testnet
+      blockNumber: "25737175"
+      deployDate: 2025-05-14T17:10:44.285Z
+      commit: v4-11-g4a1f413a-dirty
       active: true
-      deployDate: 2025-04-22T15:57:26.862Z
-      commit: v3-28-g93c05a49-dirty
-      addTwoAddress: "0x6A23b79203F1Db95947423291C8177B144DDE372"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
-      eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
-        4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
+    - name: incoLightning_0_1_29__863421733
       chainId: "84532"
-      blockNumber: "24784527"
       chainName: Base Sepolia
-      active: true
-      deployDate: 2025-04-22T15:55:47.828Z
-      commit: v3-28-g93c05a49-dirty
-      addTwoAddress: "0x1A98fB1f7E57C0648b1d2A7DEA6e126C302A7e93"
-incoLightning_0_1_29__863421733:
-  release:
-    name: incoLightning_0_1_29__863421733
-    executorAddress: "0xeBAFF6D578733E4603b99CBdbb221482F29a78E1"
-    deployer: "0x8202D2D747784Cb7D48868E44C42C4bf162a70BC"
-    pepper: demonet
-    version:
-      major: 0
-      minor: 1
-      patch: 29
-      shortSalt: "863421733"
-    salt: "0x8202d2d747784cb7d48868e44c42c4bf162a70bc00834654f6d289ccc7e5ab25"
-  deployments:
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
+      version:
+        major: 0
+        minor: 1
+        patch: 29
+        shortSalt: "863421733"
+      decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
       eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
         4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
-      chainId: "84532"
       blockNumber: "25719113"
-      chainName: Base Sepolia
-      active: true
       deployDate: 2025-05-14T07:08:39.059Z
       commit: v4
-      addTwoAddress: "0x436506A7c6462e5bab1f5CbAF9fD2a1d18F44F08"
-incoLightning_0_1_27__558243565:
-  release:
-    name: incoLightning_0_1_27__558243565
-    executorAddress: "0x595dc0fA68e7847aC1b1d52a56A1551ad0e38472"
+      active: true
+incoLightning_alphanet_v0_297966649:
+  executor:
+    name: incoLightning_alphanet_v0_297966649
+    majorVersion: 0
     deployer: "0x8202D2D747784Cb7D48868E44C42C4bf162a70BC"
-    pepper: testnet
-    version:
-      major: 0
-      minor: 1
-      patch: 27
-      shortSalt: "558243565"
-    salt: "0x8202d2d747784cb7d48868e44c42c4bf162a70bc008f0e1b154a58f3ce49d6ed"
+    pepper: alphanet
+    executorAddress: "0x4651DfD7729aE5568092E7351fAaD872266d4CBd"
+    salt: "0x8202d2d747784cb7d48868e44c42c4bf162a70bc0023f7798f470fdf5e9da639"
   deployments:
-    - decryptSigner: "0x000000000000000000000000000000000000baBe"
-      eciesPublicKey: "0x000000000000000000000000000000000000000000000000000000000000\
-        000000000000000000000000000000000000000000000000000000000000000000babe"
-      chainId: "7311099111"
-      blockNumber: "1"
-      chainName: Inco Release Chain
-      active: true
-      deployDate: 2025-04-22T14:57:24.620Z
-      commit: v3-28-g652cc4a1-dirty
-      addTwoAddress: "0x04461CD161001BC484C55D253F744462A6eADc10"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
-      eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
-        4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
-      chainId: "10143"
-      blockNumber: "13457424"
-      chainName: Monad Testnet
-      active: true
-      deployDate: 2025-04-22T14:57:15.486Z
-      commit: v3-28-g652cc4a1-dirty
-      addTwoAddress: "0xbbf1f797b5e132b72f4a45E1923cBb0BFeca80FA"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
-      eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
-        4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
+    - name: incoLightningPreview_0_2_0__297966649
       chainId: "84532"
-      blockNumber: "24782764"
       chainName: Base Sepolia
-      active: true
-      deployDate: 2025-04-22T14:57:02.375Z
-      commit: v3-28-g652cc4a1
-      addTwoAddress: "0x0c6320A91ec6BA7d42B4f079132fD71A90C12e22"
-incoLightning_0_1_27__125335042:
-  release:
-    name: incoLightning_0_1_27__125335042
-    executorAddress: "0x902B77583C7C5df71C95114707C4974A8d5Dff9D"
+      version:
+        major: 0
+        minor: 2
+        patch: 0
+        shortSalt: "297966649"
+      decryptSigner: "0x4736F8CE685760017eEc130AC3FFc6187f5A1F95"
+      eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
+        4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
+      blockNumber: "26894782"
+      deployDate: 2025-06-10T12:17:35.790Z
+      commit: v5-13-gd6b19c10-dirty
+      active: true
+incoLightning_devnet_v0_340846814:
+  executor:
+    name: incoLightning_devnet_v0_340846814
+    majorVersion: 0
     deployer: "0x8202D2D747784Cb7D48868E44C42C4bf162a70BC"
     pepper: devnet
-    version:
-      major: 0
-      minor: 1
-      patch: 27
-      shortSalt: "125335042"
-    salt: "0x8202d2d747784cb7d48868e44c42c4bf162a70bc003343825a7e951afb24c202"
+    executorAddress: "0x3B22be60Ae699933959CA3cE147C96caa88Ccd3D"
+    salt: "0x8202d2d747784cb7d48868e44c42c4bf162a70bc00b001d6742fded0dd599ede"
   deployments:
-    - decryptSigner: "0x000000000000000000000000000000000000baBe"
-      eciesPublicKey: "0x000000000000000000000000000000000000000000000000000000000000\
-        000000000000000000000000000000000000000000000000000000000000000000babe"
-      chainId: "7311099111"
-      blockNumber: "1"
-      chainName: Inco Release Chain
-      active: true
-      deployDate: 2025-04-22T14:35:10.281Z
-      commit: v3-27-ge3d04b6a-dirty
-      addTwoAddress: "0x04461CD161001BC484C55D253F744462A6eADc10"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
-      eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
-        4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
-      chainId: "10143"
-      blockNumber: "13454931"
-      chainName: Monad Testnet
-      active: true
-      deployDate: 2025-04-22T14:35:02.958Z
-      commit: v3-27-ge3d04b6a-dirty
-      addTwoAddress: "0xC1ee708D522B8b0743B5C5309AeD6b6b4C4102a6"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
-      eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
-        4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
+    - name: incoLightning_0_2_0__340846814
       chainId: "84532"
-      blockNumber: "24782097"
       chainName: Base Sepolia
-      active: true
-      deployDate: 2025-04-22T14:34:47.565Z
-      commit: v3-27-ge3d04b6a-dirty
-      addTwoAddress: "0xAac318ca07FCA665c4d27A7e9e8FB65B89AfAC83"
-incoLightning_0_1_26__18043964:
-  release:
-    name: incoLightning_0_1_26__18043964
-    executorAddress: "0x69Ef6a59f9eE2d6f3b49eA3F79bcF1553512DF0e"
-    deployer: "0x8202D2D747784Cb7D48868E44C42C4bf162a70BC"
-    pepper: testnet
-    version:
-      major: 0
-      minor: 1
-      patch: 26
-      shortSalt: "18043964"
-    salt: "0x8202d2d747784cb7d48868e44c42c4bf162a70bc00858064cb0f58c7ef7a843c"
-  deployments:
-    - decryptSigner: "0x000000000000000000000000000000000000baBe"
-      eciesPublicKey: "0x000000000000000000000000000000000000000000000000000000000000\
-        000000000000000000000000000000000000000000000000000000000000000000babe"
-      chainId: "7311099111"
-      blockNumber: "1"
-      chainName: Inco Release Chain
-      active: true
-      deployDate: 2025-04-22T12:14:50.447Z
-      commit: v3-26-g623cec72-dirty
-      addTwoAddress: "0x70fC34B18B12E945cb2204FA77E5f8e1581890C3"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
+      version:
+        major: 0
+        minor: 2
+        patch: 0
+        shortSalt: "340846814"
+      decryptSigner: "0x138AcbDC1FA02b955949d8Da09E546Ea7748710f"
       eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
         4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
+      blockNumber: "26122863"
+      deployDate: 2025-05-23T15:26:57.031Z
+      commit: v5-2-g8957c16b-dirty
+      active: true
+    - name: incoLightning_0_1_29__340846814
       chainId: "10143"
-      blockNumber: "13439069"
       chainName: Monad Testnet
-      active: true
-      deployDate: 2025-04-22T12:14:42.391Z
-      commit: v3-26-g623cec72-dirty
-      addTwoAddress: "0x4A49112FB866F6d5D05845D264b430cD3bbAb9f6"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
+      version:
+        major: 0
+        minor: 1
+        patch: 29
+        shortSalt: "340846814"
+      decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
       eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
         4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
+      blockNumber: "13464197"
+      deployDate: 2025-04-22T15:57:26.862Z
+      commit: v3-28-g93c05a49-dirty
+      active: true
+    - name: incoLightning_0_1_29__340846814
       chainId: "84532"
-      blockNumber: "24777885"
       chainName: Base Sepolia
-      active: true
-      deployDate: 2025-04-22T12:14:25.354Z
-      commit: v3-26-g623cec72-dirty
-      addTwoAddress: "0x2b5E34844997681168049783D30CD84B5962cb50"
-incoLightning_0_1_26__444235330:
-  release:
-    name: incoLightning_0_1_26__444235330
-    executorAddress: "0xdc8eD938ff2eB900bD5f86A88555a9f1956994fC"
-    deployer: "0x8202D2D747784Cb7D48868E44C42C4bf162a70BC"
-    pepper: devnet
-    version:
-      major: 0
-      minor: 1
-      patch: 26
-      shortSalt: "444235330"
-    salt: "0x8202d2d747784cb7d48868e44c42c4bf162a70bc001bab4c5927c52fbea0d042"
-  deployments:
-    - decryptSigner: "0x000000000000000000000000000000000000baBe"
-      eciesPublicKey: "0x000000000000000000000000000000000000000000000000000000000000\
-        000000000000000000000000000000000000000000000000000000000000000000babe"
-      chainId: "7311099111"
-      blockNumber: "1"
-      chainName: Inco Release Chain
-      active: true
-      deployDate: 2025-04-22T09:11:15.398Z
-      commit: v3-24-gc9716e6c-dirty
-      addTwoAddress: "0x70fC34B18B12E945cb2204FA77E5f8e1581890C3"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
-      eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
-        4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
-      chainId: "10143"
-      blockNumber: "13418528"
-      chainName: Monad Testnet
-      active: true
-      deployDate: 2025-04-22T09:11:06.223Z
-      commit: v3-24-gc9716e6c-dirty
-      addTwoAddress: "0xfeE9C1E41b2268a4ad8EaDA35f510b8d89Cd041c"
-    - decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
+      version:
+        major: 0
+        minor: 1
+        patch: 29
+        shortSalt: "340846814"
+      decryptSigner: "0xA8822DE8910f66D3d03F1eAfe2C0141dBc327Ee0"
       eciesPublicKey: "0x048a582d29083c2f3fefe024bf4dd9ab913ab8973716977da5f01106e0b8\
         4095b1e647a9e377175fcb66bda05087c93b05e1fd53a704d0914bb23a0b2a69e9f235"
-      chainId: "84532"
-      blockNumber: "24772369"
-      chainName: Base Sepolia
+      blockNumber: "24784527"
+      deployDate: 2025-04-22T15:55:47.828Z
+      commit: v3-28-g93c05a49-dirty
       active: true
-      deployDate: 2025-04-22T09:10:33.275Z
-      commit: v3-24-gc9716e6c-dirty
-      addTwoAddress: "0xeEa387f7c866A81c2AF532D9ed48c60F179C9827"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inco/lightning",
-  "version": "0.1.32",
+  "version": "0.2.0",
   "repository": "https://github.com/Inco-fhevm/inco-monorepo",
   "files": [
     "src/",
@@ -9,6 +9,7 @@
     "manifest.yaml"
   ],
   "scripts": {
+    "generate": "bun run generate:libraries",
     "generate:libraries": "bun run ../pega/lib/deployment/cmd/generate-libraries.ts",
     "publish:github": "bun publish --registry=https://npm.pkg.github.com",
     "publish:npm": "bun publish --access public"

package/src/DeployUtils.sol

@@ -9,6 +9,7 @@ import {ERC1967Proxy} from "@openzeppelin/contracts/proxy/ERC1967/ERC1967Proxy.s
 import {CONTRACT_NAME, MAJOR_VERSION, MINOR_VERSION, PATCH_VERSION} from "../src/version/IncoLightningConfig.sol";
 import {console} from "forge-std/console.sol";
 import {CreateXHelper} from "./CreateXHelper.sol";
+import {IncoLightningPreview} from "@inco/lightning-preview/src/IncoLightningPreview.sol";
 
 // can be set to 0x01 so the inco address can exist on only one chain, we want the same contract at the same address
 // on all chains
@@ -65,27 +66,40 @@ contract DeployUtils is Script {
     /// @param pepper a value used to avoid address collision on deploying the same contract twice with the same deployer
     function deployIncoLightningUsingConfig(
         address deployer,
-        string memory pepper
+        string memory pepper,
+        bool includePreviewFeatures
     ) internal returns (IncoLightning proxy) {
         return deployIncoLightningUsingConfig(
             deployer,
             pepper,
             MINOR_VERSION,
-            PATCH_VERSION
+            PATCH_VERSION,
+            includePreviewFeatures
         );
     }
 
     /// @dev Computes the address of the IncoLightning contract using CreateX based on the deployer and pepper
+    /// @param deployer MUST be the signer of the transaction
+    /// @param pepper a value used to avoid address collision on deploying the same contract twice with the same deployer
+    /// @param majorVersion major version of the contract
+    /// @param minorVersion minor version of the contract
+    /// @param patchVersion patch version of the contract
+    /// @return the address of the IncoLightning contract
+    /// @dev this function is used to compute the address of the contract before deploying it, so that we can check
+    /// @notice this must be called after vm.startBroadcast() to get the correct address
     function computeIncoLightningAddress(
         address deployer,
-        string memory pepper
+        string memory pepper,
+        uint8 majorVersion,
+        uint8 minorVersion,
+        uint8 patchVersion
     ) public returns (address) {
         CreateXHelper createX = new CreateXHelper();
         bytes32 salt = getSalt(
             CONTRACT_NAME,
-            MAJOR_VERSION,
-            MINOR_VERSION,
-            PATCH_VERSION,
+            majorVersion,
+            minorVersion,
+            patchVersion,
             deployer,
             pepper
         );
@@ -95,12 +109,16 @@ contract DeployUtils is Script {
     /// @dev wrap in prank or broadcast depending on prod or testing environment
     /// @param deployer MUST be the signer of the transaction
     /// @param pepper a value used to avoid address collision on deploying the same contract twice with the same deployer
+    /// @param minorVersionForSalt minor version of the contract to use in the salt
+    /// @param patchVersionForSalt patch version of the contract to use in the salt
+    /// @param includePreviewFeatures whether to include preview features in the contract
     function deployIncoLightningUsingConfig(
         address deployer,
         string memory pepper,
-        // FIXME: on the next major version (new contract address and state) we should remove these from the salt altogether
+    // FIXME: on the next major version (new contract address and state) we should remove these from the salt altogether
         uint8 minorVersionForSalt,
-        uint8 patchVersionForSalt
+        uint8 patchVersionForSalt,
+        bool includePreviewFeatures
     ) internal returns (IncoLightning proxy) {
         bytes32 salt = getSalt(
             CONTRACT_NAME,
@@ -115,11 +133,17 @@ contract DeployUtils is Script {
             vm.toString(deployer),
             vm.toString(salt)
         );
+        IncoLightning implementation = new IncoLightning(salt);
+        if (includePreviewFeatures) {
+            IncoLightningPreview preview = new IncoLightningPreview(address(implementation));
+            // FIXME: This is hack, we ought to define an interface IIncoLightning here and use that instead
+            implementation = IncoLightning(address(preview));
+        }
         proxy = IncoLightning(
             deployProxy({
                 deployer: deployer,
                 salt: salt,
-                implem: address(new IncoLightning(salt)),
+                implem: address(implementation),
                 initFunctionSelector: IncoLightning.initialize.selector
             })
         );
@@ -129,14 +153,18 @@ contract DeployUtils is Script {
     /// minor and patch versions can be provided to this function in order to perform an upgrade
     /// @param deployer MUST be the signer of the transaction
     /// @param pepper a value used to avoid address collision on deploying the same contract twice with the same deployer
+    /// @param minorVersionForSalt minor version of the contract to use in the salt
+    /// @param patchVersionForSalt patch version of the contract to use in the salt
+    /// @param includePreviewFeatures whether to include preview features in the contract
     function upgradeIncoLightningUsingConfig(
         address deployer,
         string memory pepper,
     // FIXME: on the next major version (new contract address and state) we should remove these from the salt altogether
         uint8 minorVersionForSalt,
-        uint8 patchVersionForSalt
+        uint8 patchVersionForSalt,
+        bool includePreviewFeatures
     ) internal returns (IncoLightning proxy) {
-        // Here we hack around the fact that we must use the same salt for an ugprade and currently the salt includes
+        // Here we hack around the fact that we must use the same salt for an upgrade and currently the salt includes
         // the minor and patch versions
         bytes32 salt = getSalt(
             CONTRACT_NAME,
@@ -157,6 +185,10 @@ contract DeployUtils is Script {
         proxy = IncoLightning(proxyAddress);
 
         IncoLightning newImplementation = new IncoLightning(salt);
+        if (includePreviewFeatures) {
+            newImplementation = IncoLightning(address(new IncoLightningPreview(address(newImplementation))));
+        }
+        new IncoLightning(salt);
         proxy.upgradeToAndCall(address(newImplementation), "");
         return proxy;
     }

package/src/IIncoLightning.sol

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: No License
+pragma solidity ^0.8;
+
+import {IIncoLightningGen} from "./IncoLightning.gen.sol";
+import {IEncryptedInputGen} from "./lightning-parts/EncryptedInput.gen.sol";
+import {IDecryptionHandlerGen} from "./lightning-parts/DecryptionHandler.gen.sol";
+import {IEncryptedOperationsGen} from "./lightning-parts/EncryptedOperations.gen.sol";
+import {ITrivialEncryptionGen} from "./lightning-parts/TrivialEncryption.gen.sol";
+import {IBaseAccessControlListGen} from "./lightning-parts/AccessControl/BaseAccessControlList.gen.sol";
+import {IHandleGenerationGen} from "./lightning-parts/primitives/HandleGeneration.gen.sol";
+
+
+interface IIncoLightning is IIncoLightningGen, IEncryptedInputGen, IDecryptionHandlerGen, IEncryptedOperationsGen, ITrivialEncryptionGen, IBaseAccessControlListGen, IHandleGenerationGen {}

package/src/IncoLightning.gen.sol

@@ -0,0 +1,15 @@
+/// SPDX-License-Identifier: No License
+pragma solidity ^0.8;
+
+import { IIncoLightning } from "./IIncoLightning.sol";
+import { CONTRACT_NAME, MAJOR_VERSION, MINOR_VERSION, PATCH_VERSION } from "./version/IncoLightningConfig.sol";
+import { DecryptionHandler } from "./lightning-parts/DecryptionHandler.sol";
+import { EncryptedInput } from "./lightning-parts/EncryptedInput.sol";
+import { EncryptedOperations } from "./lightning-parts/EncryptedOperations.sol";
+import { TrivialEncryption } from "./lightning-parts/TrivialEncryption.sol";
+import { UUPSUpgradeable } from "@openzeppelin/contracts/proxy/utils/UUPSUpgradeable.sol";
+import { Version } from "./version/Version.sol";
+
+interface IIncoLightningGen {
+    function initialize(address owner) external;
+}

package/src/IncoLightning.sol

@@ -1,18 +1,21 @@
 // SPDX-License-Identifier: No License
 pragma solidity ^0.8;
 
+import {IIncoLightning} from "./IIncoLightning.sol";
+import {CONTRACT_NAME, MAJOR_VERSION, MINOR_VERSION, PATCH_VERSION} from "./version/IncoLightningConfig.sol";
+import {DecryptionHandler} from "./lightning-parts/DecryptionHandler.sol";
 import {EncryptedInput} from "./lightning-parts/EncryptedInput.sol";
 import {EncryptedOperations} from "./lightning-parts/EncryptedOperations.sol";
-import {DecryptionHandler} from "./lightning-parts/DecryptionHandler.sol";
+import {IIncoLightningGen} from "./IncoLightning.gen.sol";
 import {TrivialEncryption} from "./lightning-parts/TrivialEncryption.sol";
 import {UUPSUpgradeable} from "@openzeppelin/contracts/proxy/utils/UUPSUpgradeable.sol";
-import {CONTRACT_NAME, MAJOR_VERSION, MINOR_VERSION, PATCH_VERSION} from "./version/IncoLightningConfig.sol";
 import {Version} from "./version/Version.sol";
 
 /// @title Inco Lightning
 /// @notice Onchain singleton for Inco Lightning, TEE-based encrypted data and operations over shared state service
 /// @dev implicitly extends BaseAccessControlList, SignatureVerifier, OwnableUpgradeable
 contract IncoLightning is
+    IIncoLightning,
     EncryptedOperations,
     DecryptionHandler,
     TrivialEncryption,

package/src/{libs/incoLightning_0_1_23__830342853.sol → Lib.alphanet.sol}

@@ -5,10 +5,10 @@
 /// SPDX-License-Identifier: No License
 pragma solidity ^0.8;
 
-import "../IncoLightning.sol";
-import { ebool, euint256, ETypes } from "../Types.sol";
+import "./IncoLightning.sol";
+import { ebool, euint256, ETypes } from "./Types.sol";
 
-IncoLightning constant inco = IncoLightning(0xF167b01eeE3eB16809D115a3476073121ACbA67C);
+IncoLightning constant inco = IncoLightning(0x4651DfD7729aE5568092E7351fAaD872266d4CBd);
 address constant deployedBy = 0x8202D2D747784Cb7D48868E44C42C4bf162a70BC;
 uint256 constant defaultDecryptionDelayLimit = 2 hours;
 

package/src/libs/{incoLightning_0_1_22__761766708.sol → incoLightning_alphanet_v0_297966649.sol}

@@ -8,7 +8,7 @@ pragma solidity ^0.8;
 import "../IncoLightning.sol";
 import { ebool, euint256, ETypes } from "../Types.sol";
 
-IncoLightning constant inco = IncoLightning(0x88ab1DF735e8de6Cf195F6142c9A7192BBF0e750);
+IncoLightning constant inco = IncoLightning(0x4651DfD7729aE5568092E7351fAaD872266d4CBd);
 address constant deployedBy = 0x8202D2D747784Cb7D48868E44C42C4bf162a70BC;
 uint256 constant defaultDecryptionDelayLimit = 2 hours;
 

package/src/libs/{incoLightning_0_1_23__547622051.sol → incoLightning_junknet3_v0_495844717.sol}

@@ -8,7 +8,7 @@ pragma solidity ^0.8;
 import "../IncoLightning.sol";
 import { ebool, euint256, ETypes } from "../Types.sol";
 
-IncoLightning constant inco = IncoLightning(0x022c0878EE7D09D385b0B97e6A6539FF2CaF31e6);
+IncoLightning constant inco = IncoLightning(0x5Db4068769783837bFFc070A703B29f44Ba16f98);
 address constant deployedBy = 0x8202D2D747784Cb7D48868E44C42C4bf162a70BC;
 uint256 constant defaultDecryptionDelayLimit = 2 hours;
 

package/src/lightning-parts/AccessControl/BaseAccessControlList.gen.sol

@@ -0,0 +1,19 @@
+/// SPDX-License-Identifier: No License
+pragma solidity ^0.8;
+
+import { SenderNotAllowedForHandle } from "../../Types.sol";
+
+interface IBaseAccessControlListGen {
+    /// @dev persistent
+    function allow(bytes32 handle, address account) external;
+
+    function allowTransient(bytes32 handle, address account) external;
+
+    function allowedTransient(bytes32 handle, address account) external view returns (bool);
+
+    function cleanTransientStorage() external;
+
+    function persistAllowed(bytes32 handle, address account) external view returns (bool);
+
+    function isAllowed(bytes32 handle, address account) external view returns (bool);
+}