Bangkok

.env.example

@@ -1,19 +1,14 @@
-export INFURA_API_KEY="zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz"
 export MNEMONIC="adapt mosquito move limb mobile illegal tree voyage juice mosquito burger raise father hope layer"
+export PRIVATE_KEY_FHEVM_DEPLOYER="0c66d8cde71d2faa29d0cb6e3a567d31279b6eace67b0a9d9ba869c119843a5e"
 export PRIVATE_KEY_GATEWAY_DEPLOYER="717fd99986df414889fd8b51069d4f90a50af72e542c58ee065f5883779099c6"
-export PRIVATE_KEY_GATEWAY_OWNER="717fd99986df414889fd8b51069d4f90a50af72e542c58ee065f5883779099c6"
 export PRIVATE_KEY_GATEWAY_RELAYER="7ec931411ad75a7c201469a385d6f18a325d4923f9f213bd882bbea87e160b67"
 export NUM_KMS_SIGNERS="1"
-export PRIVATE_KEY_KMS_SIGNER_0="26698d458a21b843aa1ddbd5c5b098821ddf4218bb52498c4aad3a84849275bb"
-export PRIVATE_KEY_KMS_SIGNER_1="e5b998ce1e664718772fa35e8d02b2b6a267a03a8ecadab15de5b125da7fa82b"
-export PRIVATE_KEY_KMS_SIGNER_2="dca817bfe824b12c92d61e56056b956617da156bcd730379cb9203c822c9ba8e"
-export PRIVATE_KEY_KMS_SIGNER_3="7ac1a2886ca07b3b7393ea5ff3613bb94d72129e2c7cbedc807eb55ff971394c"
+export PRIVATE_KEY_KMS_SIGNER_0="388b7680e4e1afa06efbfd45cdd1fe39f3c6af381df6555a19661f283b97de91"
+export PRIVATE_KEY_KMS_SIGNER_1="bbaed91514fa4b7c86aa4f73becbabcf4bce0ae130240f0d6ac3f87e06812440"
+export PRIVATE_KEY_KMS_SIGNER_2="1bfa3e2233b0103ad67954a728b246c528916791f7fab4894ff361e3937b47e1"
+export PRIVATE_KEY_KMS_SIGNER_3="7a604eed8cf4a43277d192aa0c7894d368577a4021e52bf45420f256e34c7dd7"
 export PRIVATE_KEY_COPROCESSOR_ACCOUNT="7ec8ada6642fc4ccfb7729bc29c17cf8d21b61abd5642d1db992c0b8672ab901"
+export IS_COPROCESSOR="true"
 
-# Block explorer API keys
-export ARBISCAN_API_KEY="zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz"
-export BSCSCAN_API_KEY="zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz"
-export ETHERSCAN_API_KEY="zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz"
-export OPTIMISM_API_KEY="zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz"
-export POLYGONSCAN_API_KEY="zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz"
-export SNOWTRACE_API_KEY="zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz"
+export SEPOLIA_RPC_URL="https://sepolia.infura.io/v3/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+export ETHERSCAN_API_KEY="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

.env.example.deployment

@@ -0,0 +1,12 @@
+export PRIVATE_KEY_FHEVM_DEPLOYER="0c66d8cde71d2faa29d0cb6e3a567d31279b6eace67b0a9d9ba869c119843a5e"
+export PRIVATE_KEY_GATEWAY_DEPLOYER="717fd99986df414889fd8b51069d4f90a50af72e542c58ee065f5883779099c6"
+export ADDRESS_GATEWAY_RELAYER="0x97F272ccfef4026A1F3f0e0E879d514627B84E69"
+export NUM_KMS_SIGNERS="4"
+export ADDRESS_KMS_SIGNER_0="0x0971C80fF03B428fD2094dd5354600ab103201C5"
+export ADDRESS_KMS_SIGNER_1="0xB68deCb047B5e6Cc82280502A7E2318c6b3E5eC6"
+export ADDRESS_KMS_SIGNER_2="0xfe0fB0BCceb872ee7a6ef6c455e6E127Aef55DD7"
+export ADDRESS_KMS_SIGNER_3="0x2dac5193bE0AB0eD8871399E6Ae61EAe6cc8cAE1"
+export ADDRESS_COPROCESSOR_ACCOUNT="0xc9990FEfE0c27D31D0C2aa36196b085c0c4d456c"
+export IS_COPROCESSOR="true"
+export SEPOLIA_RPC_URL="https://sepolia.infura.io/v3/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+export ETHERSCAN_API_KEY="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

.github/ISSUE_TEMPLATE/bug_report_fhevm.md

@@ -0,0 +1,56 @@
+---
+name: 🐞 Smart Contracts Bug Report
+about: Use this template to report issues encountered with confidential smart contracts on the fhEVM.
+title: ""
+labels: bug
+assignees: ""
+---
+
+### **Description**
+
+Provide a clear and detailed description of the bug.
+
+### **Expected Behavior**
+
+Describe what you expected to happen (e.g., successful decryption of the input, valid output from the encrypted function, no gas estimation errors).
+
+### **Screenshots / Logs**
+
+Include screenshots, relevant logs, or traces if available, particularly for encrypted computations or gateway interactions.
+
+### **Smart Contract Code Snippet**
+
+If applicable, provide a minimal reproducible example of the smart contract code highlighting the part where the issue occurs:
+
+<details><summary>Example</summary>
+<p>
+
+```solidity
+// Example
+contract Counter {
+  uint32 value;
+  function increment() public {
+    value += 1;
+  }
+
+  function currentValue() public view returns (uint32) {
+    return value;
+  }
+}
+```
+
+</p>
+</details>
+
+### **Environment Information**
+
+Fill in the relevant environment details where the issue was observed:
+
+- **Operating System**: [e.g., Ubuntu 20.04, Windows 10]
+- **Browser**: [e.g., Chrome v90, Safari v14]
+- **fhEVM Version**: [e.g., v1.0.0]
+- **Tooling**: [Hardhat, Remix, fhEVM CLI]
+- **Devnet / Local Node Configuration**:
+  - Chain ID: [e.g., 9000]
+  - RPC URL: [e.g., `https://devnet.zama.ai`]
+  - Faucet Usage: [Yes/No]

.github/ISSUE_TEMPLATE/bug_report_fhevmjs.md

@@ -0,0 +1,54 @@
+---
+name: 🐛 fhevmjs Bug report
+about: Use this template to report issues encountered while using the fhevmjs library for interacting with fhEVM smart contracts.
+title: ""
+labels: bug, fhevmjs
+assignees: ""
+---
+
+### **Description**
+
+Provide a clear and detailed description of the issue encountered.
+
+### **Expected Behavior**
+
+A clear and concise description of the expected behavior (e.g., successful encryption of parameters, correct reencryption result, accurate balance retrieval).
+
+### **Screenshots / Logs**
+
+If applicable, provide screenshots or logs that capture the issue. Include any console errors, warnings, or unexpected outputs.
+
+### **Environment Information**
+
+Fill in the relevant environment details where the issue was observed:
+
+- **Browser**: [e.g., Chrome v90, Firefox v88]
+- **Node.js Version**: [e.g., `v14.17.0`]
+- **`fhEVMjs` Version**: [e.g., `v0.2.1`]
+- **Package Manager**: [npm, yarn, pnpm]
+- **Network Configuration**:
+  - **Chain ID**: [e.g., `9000`]
+  - **RPC URL**: [e.g., `https://devnet.zama.ai`]
+  - **Gateway URL**: [e.g., `https://gateway.devnet.zama.ai`]
+
+### **Steps Taken to Debug**
+
+Outline any steps you’ve taken to troubleshoot the issue (e.g., using mocked mode, enabling verbose logging, testing with a different environment or network).
+
+### **Resources / References**
+
+If applicable, include links to any related documentation or reference materials that may help us understand the context:
+
+<details><summary>Logs or output</summary>
+<p>
+
+```console
+
+```
+
+</p>
+</details>
+
+---
+
+By including these details, we can ensure a faster and more accurate resolution for your issue. Thank you for helping improve `fhevmjs`!

.github/ISSUE_TEMPLATE/docs_bug_report.md

@@ -0,0 +1,70 @@
+---
+name: 📚 Documentation Bug Report / Unclear Documentation
+about: Use this template to report issues, inconsistencies, or inaccuracies in our documentation. Or to report sections of our documentation that are unclear, confusing, or require further explanation.
+title: ""
+labels: bug, documentation
+assignees: ""
+---
+
+### **Page Link**
+
+Please provide a link to the page where the issue is located:  
+**URL**: '[https://docs.zama.ai/fhevm/\_\_\_](https://docs.zama.ai/fhevm/___)'
+
+### **Description**
+
+Describe in detail what part of the documentation is unclear or provide a clear and detailed description of the bug. Include any inconsistencies, typos, broken links, or missing information.
+
+<details><summary>For example:</summary>
+<p>
+ <li>Inaccurate technical explanations or missing prerequisites.</li>
+ <li>Deprecated code snippets or outdated references.</li>
+ <li>Formatting issues or broken links.</li>
+ <li>Is there a lack of explanation for certain technical terms or concepts?</li>
+ <li>Are there missing examples for a complex function or feature?</li>
+ <li>Does the documentation assume prior knowledge that hasn't been introduced?</li>
+</p>
+</details>
+
+### **Suggested Fix / Expected Behavior / What Would You Like Clarified?**
+
+Please provide your suggestions for improvement or clarification:
+
+- Describe expected content or suggest corrections for bugs/inaccuracies.
+- Explain what needs clarification for unclear documentation.
+
+<details><summary>Examples of helpful suggestions:</summary>
+<p>
+ <li>Corrected code snippet</li>
+ <li>Improved explanation.</li>
+ <li>Link to a more accurate or up-to-date resource</li>
+</p>
+</details>
+
+<details><summary>Examples of clarification requests:</summary>
+<p>
+ <li>“Can you provide an example of this function in use?”</li>
+ <li>"What are the expected inputs and outputs for this operation?”</li>
+ <li>“Could you add a section explaining how this feature integrates with other components?”</li>
+</p>
+</details>
+
+### **Screenshots / Logs**
+
+If applicable, provide screenshots, code snippets, or logs that clearly show the issue.
+
+### **Impact Level**
+
+Choose the impact of the bug on the documentation quality and user experience:
+
+<details><summary>[Critical, Moderate, Minor]</summary>
+<p>
+<li><b>Critical</b>: Major error that could lead to incorrect implementation or misunderstanding.</li>
+<li><b>Moderate</b>: Somewhat misleading information, but unlikely to cause implementation issues.</li>
+<li><b>Minor</b>: Minor typo or aesthetic issue with no functional impact.</li>
+</p>
+</details>
+
+---
+
+By including these details, we can ensure a faster and more accurate resolution for your issue. Thank you for helping improve `fhEVM docs`!

.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,16 @@
+---
+name: 🚀 General feature request for fhEVM
+about: Suggest an idea for this project
+title: ""
+labels: enhancement
+assignees: ""
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.gitignore

@@ -7,6 +7,7 @@ yarn-error.log*
 lerna-debug.log*
 pnpm-lock.yaml
 yarn.lock
+.vscode
 
 # Diagnostic reports (https://nodejs.org/api/report.html)
 report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
@@ -73,8 +74,6 @@ typings/
 # dotenv environment variables file
 .env
 .env.test
-gateway/.env.gateway
-gateway/lib/PredeployAddress.sol
 
 # parcel-bundler cache (https://parceljs.org/)
 .cache
@@ -137,3 +136,4 @@ deployments
 typechain
 typechain-types
 .openzeppelin/unknown*
+.openzeppelin/sepolia.json

.prettierrc.json

@@ -1,15 +1,11 @@
 {
   "printWidth": 120,
-  "plugins": ["@trivago/prettier-plugin-sort-imports", "prettier-plugin-solidity"],
+  "plugins": ["prettier-plugin-organize-imports", "prettier-plugin-solidity"],
   "overrides": [
     {
       "files": ["*.ts", ".js", ".cjs"],
       "options": {
-        "singleQuote": true,
-        "importOrder": ["<THIRD_PARTY_MODULES>", "^[./]"],
-        "importOrderParserPlugins": ["typescript"],
-        "importOrderSeparation": true,
-        "importOrderSortSpecifiers": true
+        "singleQuote": true
       }
     },
     {

@types/fhevmjs/index.d.ts

@@ -0,0 +1,3 @@
+// This is a horrible hack, see: https://github.com/zama-ai/fhevm/issues/582
+
+export * from 'fhevmjs/web';

README.md

@@ -156,9 +156,7 @@ _More examples are available [here](https://github.com/zama-ai/fhevm/tree/main/e
 
 #### Others
 
-- [Governor DAO](https://github.com/zama-ai/fhevm/tree/main/examples/Governor): A DAO smart contract that facilitates governance decisions through encrypted voting.
 - [Blind auction](https://github.com/zama-ai/fhevm/blob/main/examples/BlindAuction.sol): A smart contract for conducting blind auctions where bids are encrypted and the winning bid remains private.
-- [Decentralized ID](https://github.com/zama-ai/fhevm/tree/main/examples/Identity): A blockchain-based identity management system using smart contracts to store and manage encrypted personal data.
 
 _If you have built awesome projects using fhEVM, please let us know and we will be happy to showcase them here!_
 <br></br>
@@ -253,23 +251,6 @@ npm run fhevm:start
 npm run fhevm:stop
 ```
 
-##### Faucet
-
-For development purposes, we provide a ready to use wallet. In order to use
-it, prepare the .env file that contains the mnemonic.
-
-```bash
-cp .env.example .env
-```
-
-This allows the developer to use a few accounts, each account can get coins:
-
-```bash
-npm run fhevm:faucet:alice
-npm run fhevm:faucet:bob
-npm run fhevm:faucet:carol
-```
-
 ##### Run test
 
 ```bash

ci/scripts/prepare_fhe_keys_ci.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 set -Eeuo pipefail
 

ci/scripts/prepare_fhe_keys_for_e2e_test.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 set -Eeuo pipefail
 
@@ -14,7 +14,7 @@ KEYS_FULL_PATH=$1
 mkdir -p $NETWORK_KEYS_PUBLIC_PATH
 
 MANDATORY_KEYS_LIST=('pks')
- 
+
 echo "check folder $KEYS_FULL_PATH"
 for key in "${MANDATORY_KEYS_LIST[@]}"
     do

ci/scripts/run_ERC20.sh

@@ -1,6 +1,6 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
-# This script execute a python script within a ready-to-use docker image with all the required python modules. 
+# This script execute a python script within a ready-to-use docker image with all the required python modules.
 # The script takes two arguments:
 #   1. The private key of the main account which has already funds.
 #   2. (Optional) The node address (default: http://host.docker.internal:8545)

ci/scripts/run_ERC20_ci_test.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # This script exports an Ethereum private key from an evmos node and uses it to run a Python script.
 # The script takes two arguments:
@@ -25,4 +25,4 @@ PRIVATE_KEY=$(docker compose -f $PATH_TO_EVMOS/docker-compose/docker-compose.val
 echo "Exported private key: $PRIVATE_KEY"
 
 # Run the Python script with the exported private key as an argument
-docker compose -f ci/docker-compose.yml run app python ci/tests/ERC20.py $PRIVATE_KEY
+docker compose -f ci/docker-compose.yml run app python ci/tests/ERC20.py $PRIVATE_KEY

ci/scripts/run_ERC20_e2e_test.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # This script exports an Ethereum private key from an evmos node and uses it to run a Python script.
 # The script takes two arguments: