chore: v4.9.0

chore: update utils package version (#954 )
Refactor/type-validation (#951 )
2026-01-13 16:48:00 -05:00 · 2025-02-03 13:26:48 +01:00 · 2025-02-03 12:57:30 +01:00 · 2025-02-03 12:40:32 +01:00 · 2025-02-03 12:35:25 +01:00 · 2025-01-29 00:04:39 +01:00
40 changed files with 1420 additions and 1168 deletions
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -29,10 +29,12 @@

 <!-- Please check if the PR fulfills these requirements. -->

-   [ ] My code follows the style guidelines of this project
 -   [ ] I have performed a self-review of my code
 -   [ ] I have commented my code, particularly in hard-to-understand areas
 -   [ ] My changes generate no new warnings
 -   [ ] I have run `yarn format` and `yarn lint` without getting any errors
 -   [ ] I have added tests that prove my fix is effective or that my feature works
 -   [ ] New and existing unit tests pass locally with my changes
+
+> [!IMPORTANT]
+> We do not accept minor grammatical fixes (e.g., correcting typos, rewording sentences) unless they significantly improve clarity in technical documentation. These contributions, while appreciated, are not a priority for merging. If there is a grammatical error feel free to message the team.
--- a/.github/workflows/production.yml
+++ b/.github/workflows/production.yml
@@ -34,7 +34,7 @@ jobs:
              run: yarn lint

    test-subgraph:
-        runs-on: ubuntu-latest
+        runs-on: ubuntu-22.04 # Context: https://github.com/graphprotocol/graph-tooling/issues/1546#issuecomment-2589680195

        steps:
            - uses: actions/checkout@v4
--- a/.github/workflows/pull-requests.yml
+++ b/.github/workflows/pull-requests.yml
@@ -75,7 +75,7 @@ jobs:
              run: yarn run eslint ${{ steps.changed-files.outputs.to_lint_all_changed_files }} --ext .cjs,.js,.jsx,.ts,.tsx

    test:
-        runs-on: ubuntu-latest
+        runs-on: ubuntu-22.04 # Context: https://github.com/graphprotocol/graph-tooling/issues/1546#issuecomment-2589680195

        steps:
            - uses: actions/checkout@v4
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -22,7 +22,7 @@ Pull requests are great if you want to add a feature or fix a bug. Here's a quic

 3. Add a test for your change. Only refactoring and documentation changes require no new tests.

-4. Make sure to check out the [Style Guide](/CONTRIBUTING#style-guide) and ensure that your code complies with the rules.
+4. Make sure to check out the [Style Guide](/CONTRIBUTING.md#style-guide) and ensure that your code complies with the rules.

 5. Make the test pass.

@@ -30,6 +30,9 @@ Pull requests are great if you want to add a feature or fix a bug. Here's a quic

 7. Push to your fork and submit a pull request on our `main` branch. Please provide us with some explanation of why you made the changes you made. For new features make sure to explain a standard use case to us.

+> [!IMPORTANT]
+> We do not accept minor grammatical fixes (e.g., correcting typos, rewording sentences) unless they significantly improve clarity in technical documentation. These contributions, while appreciated, are not a priority for merging. If there is a grammatical error feel free to message the team.
+
 ## CI (Github Actions) Tests

 We use GitHub Actions to test each PR before it is merged.
--- a/README.md
+++ b/README.md
@@ -281,7 +281,7 @@ Install the dependencies:
 cd semaphore && yarn
 ```

-And build the repositiory:
+And build the repository:

 ```bash
 yarn build
--- a/apps/docs/i18n/en/code.json
+++ b/apps/docs/i18n/en/code.json
@@ -390,8 +390,5 @@
    },
    "footer.right.connect.link2": {
        "message": "X (Twitter)"
-    },
-    "footer.copyright": {
-        "message": "Copyright © 2024 Ethereum Foundation"
    }
 }
--- a/apps/docs/i18n/es/code.json
+++ b/apps/docs/i18n/es/code.json
@@ -390,8 +390,5 @@
    },
    "footer.right.connect.link2": {
        "message": "X (Twitter)"
-    },
-    "footer.copyright": {
-        "message": "Copyright © 2024 Ethereum Foundation"
    }
 }
--- a/apps/docs/i18n/es/docusaurus-plugin-content-docs/version-V3/technical-reference/contracts.md
+++ b/apps/docs/i18n/es/docusaurus-plugin-content-docs/version-V3/technical-reference/contracts.md
@@ -19,7 +19,7 @@ Para utilizar los contratos e interfaces Semaphore en su proyecto, instale el pa

 Semaphore ofrece los siguientes contratos base:

-   [`SemaphoreVerifier.sol`](https://github.com/semaphore-protocol/semaphore/blob/main/packages/contracts/base/SemaphoreVerifier.sol): contiene una función para verificar pruebas Semaphore;
+-   [`SemaphoreVerifier.sol`](https://github.com/semaphore-protocol/semaphore/blob/v3.15.2/packages/contracts/contracts/base/SemaphoreVerifier.sol): contiene una función para verificar pruebas Semaphore;
 -   [`SemaphoreGroups.sol`](https://github.com/semaphore-protocol/semaphore/blob/main/packages/contracts/base/SemaphoreGroups.sol): contiene las funciones para crear grupos y añadir/remover/actualizar miembros.

 Los contratos base están relacionados de forma muy cercana al protocolo.
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -19,7 +19,7 @@
        "@docusaurus/core": "3.5.2",
        "@docusaurus/preset-classic": "3.5.2",
        "@mdx-js/react": "^3.0.0",
-        "@semaphore-protocol/utils": "4.8.1",
+        "@semaphore-protocol/utils": "4.9.0",
        "@svgr/webpack": "^5.5.0",
        "clsx": "^1.2.1",
        "docusaurus-plugin-sass": "^0.2.5",
--- a/apps/docs/src/theme/Footer/index.tsx
+++ b/apps/docs/src/theme/Footer/index.tsx
@@ -54,11 +54,7 @@ function Footer() {
                <hr />

                <div>
-                    <p>
-                        {translate({
-                            id: "footer.copyright"
-                        })}
-                    </p>
+                    <p>Copyright © {new Date().getFullYear()} Ethereum Foundation</p>

                    <Logo
                        style={{ marginRight: -8 }}
--- a/apps/docs/versioned_docs/version-V4/what-is-semaphore.md
+++ b/apps/docs/versioned_docs/version-V4/what-is-semaphore.md
@@ -33,7 +33,7 @@ Semaphore is designed to be a simple and generic _privacy layer_ for decentraliz

 ## About the code

-The core of the protocol is the [circuit logic](https://github.com/semaphore-protocol/semaphore/tree/main/packages/circuits/semaphore.circom).
+The core of the protocol is the [circuit logic](https://github.com/semaphore-protocol/semaphore/tree/main/packages/circuits/src/semaphore.circom).
 In addition to circuits,
 Semaphore provides [Solidity contracts](https://github.com/semaphore-protocol/semaphore/tree/main/packages/contracts)
 and [JavaScript libraries](https://github.com/semaphore-protocol/semaphore/tree/main#-packages) that allow developers to generate zero-knowledge proofs and verify them with minimal effort.
--- a/apps/subgraph/package.json
+++ b/apps/subgraph/package.json
@@ -18,13 +18,13 @@
        "test": "graph test Semaphore -v 0.5.0"
    },
    "dependencies": {
-        "@graphprotocol/graph-cli": "0.78.0",
-        "@graphprotocol/graph-ts": "0.35.1",
+        "@graphprotocol/graph-cli": "0.95.0",
+        "@graphprotocol/graph-ts": "0.37.0",
        "@semaphore-protocol/utils": "workspace:packages/utils"
    },
    "devDependencies": {
-        "@types/mustache": "^4.2.2",
-        "matchstick-as": "0.5.0",
+        "@types/mustache": "^4.2.5",
+        "matchstick-as": "0.6.0",
        "mustache": "^4.2.0"
    }
 }
--- a/apps/website/src/app/page.tsx
+++ b/apps/website/src/app/page.tsx
@@ -225,7 +225,7 @@ export default function Home() {
            <VStack mb="32" spacing="32">
                <VStack w="full" maxW="1110px">
                    <Heading fontSize={{ base: "30px", md: "44px" }} pb="90px">
-                        2024 Roadmap
+                        2024-2025 Roadmap
                    </Heading>

                    <HStack display={{ base: "none", md: "flex" }} w="full" mt="60px">
--- a/apps/website/src/components/Footer.tsx
+++ b/apps/website/src/components/Footer.tsx
@@ -88,7 +88,7 @@ export default function Footer() {
                    </Link>

                    <Text fontSize={{ base: "12px", md: "14px" }} color="text.500" pt="2">
-                        Copyright © 2024 Ethereum Foundation
+                        Copyright © {new Date().getFullYear()} Ethereum Foundation
                    </Text>
                </VStack>
            </VStack>
--- a/apps/website/src/data/articles.json
+++ b/apps/website/src/data/articles.json
@@ -40,5 +40,12 @@
        "date": "2024-01-01",
        "authors": ["Vivek Bhupatiraju"],
        "url": "https://vivs.wiki/Semaphore"
+    },
+    {
+        "title": "Getting Started with Semaphore: Building Privacy-Preserving dApps on Ethereum",
+        "minRead": 7,
+        "date": "2024-12-09",
+        "authors": ["glasswing"],
+        "url": "https://mirror.xyz/0xBE98D44c29D179588b7E717Db8898529e5cD770F/5Xlv1jzwJKfKgP-m257kjivBlUIM_cwTzsmpf9F0Su8"
    }
 ]
--- a/apps/website/src/data/projects.json
+++ b/apps/website/src/data/projects.json
@@ -565,5 +565,15 @@
        "links": {
            "github": "https://github.com/evgongora/VeilEscrow"
        }
+    },
+    {
+        "name": "Obscurus",
+        "categories": ["Voting", "Privacy"],
+        "tagline": "An anonymity layer for Safe Wallet owners, built using Semaphore and Zodiac.",
+        "pse": false,
+        "icon": "",
+        "links": {
+            "github": "https://github.com/quartz-technology/obscurus"
+        }
    }
 ]
--- a/apps/website/src/data/roadmap.json
+++ b/apps/website/src/data/roadmap.json
@@ -23,16 +23,16 @@
        "name": "Support more Testnets/Mainnets",
        "done": true
    },
-    {
-        "name": "Documentation improvements",
-        "done": false
-    },
    {
        "name": "New Explorer",
+        "done": true
+    },
+    {
+        "name": "Semaphore Spec",
        "done": false
    },
    {
-        "name": "RLN extension",
+        "name": "Semaphore Rust Implementation",
        "done": false
    }
 ]
--- a/package.json
+++ b/package.json
@@ -9,8 +9,7 @@
    "scripts": {
        "build": "yarn build:libraries && yarn build:subgraph && yarn build:website && yarn build:docs",
        "build:libraries": "yarn workspaces foreach -Apt --no-private run build",
-        "clean:subgraph": "rimraf apps/subgraph/node_modules",
-        "build:subgraph": "yarn clean:subgraph && yarn workspace semaphore-subgraph build:sepolia",
+        "build:subgraph": "yarn workspace semaphore-subgraph build:sepolia",
        "build:website": "yarn workspace semaphore-website build",
        "build:docs": "yarn workspace semaphore-docs build",
        "compile:contracts": "yarn workspace semaphore-contracts compile",
--- a/packages/circuits/package.json
+++ b/packages/circuits/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/circuits",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "Semaphore Circom circuits to generate zero-knowledge proofs.",
    "license": "MIT",
    "files": [
--- a/packages/cli-template-contracts-foundry/package.json
+++ b/packages/cli-template-contracts-foundry/package.json
@@ -1,10 +1,10 @@
 {
    "name": "@semaphore-protocol/cli-template-contracts-foundry",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "Semaphore Foundry template.",
    "license": "Unlicense",
    "devDependencies": {
-        "@semaphore-protocol/contracts": "4.8.1",
+        "@semaphore-protocol/contracts": "4.9.0",
        "@zk-kit/lean-imt.sol": "2.0.0",
        "forge-std": "github:foundry-rs/forge-std#v1.9.4",
        "poseidon-solidity": "0.0.5",
@@ -38,7 +38,8 @@
        ".editorconfig",
        ".env.example",
        ".prettierignore",
-        ".prettierrc.json"
+        ".prettierrc.json",
+        ".solhint.json"
    ],
    "packageManager": "yarn@4.1.0"
 }
--- a/packages/cli-template-contracts-hardhat/package.json
+++ b/packages/cli-template-contracts-hardhat/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/cli-template-contracts-hardhat",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "Semaphore Hardhat template.",
    "license": "Unlicense",
    "files": [
@@ -16,7 +16,8 @@
        ".prettierrc.json",
        "hardhat.config.ts",
        "tsconfig.json",
-        "README.md"
+        "README.md",
+        ".solhint.json"
    ],
    "publishConfig": {
        "access": "public"
@@ -41,9 +42,9 @@
        "@nomicfoundation/hardhat-network-helpers": "^1.0.0",
        "@nomicfoundation/hardhat-toolbox": "^4.0.0",
        "@nomicfoundation/hardhat-verify": "^2.0.0",
-        "@semaphore-protocol/core": "4.8.1",
-        "@semaphore-protocol/hardhat": "4.8.1",
-        "@semaphore-protocol/utils": "4.8.1",
+        "@semaphore-protocol/core": "4.9.0",
+        "@semaphore-protocol/hardhat": "4.9.0",
+        "@semaphore-protocol/utils": "4.9.0",
        "@typechain/ethers-v6": "^0.5.0",
        "@typechain/hardhat": "^9.0.0",
        "@types/chai": "^4.2.0",
@@ -71,7 +72,7 @@
        "typescript": "^5.3.3"
    },
    "dependencies": {
-        "@semaphore-protocol/contracts": "4.8.1"
+        "@semaphore-protocol/contracts": "4.9.0"
    },
    "packageManager": "yarn@4.1.0"
 }
--- a/packages/cli-template-monorepo-ethers/apps/contracts/package.json
+++ b/packages/cli-template-monorepo-ethers/apps/contracts/package.json
@@ -20,9 +20,9 @@
        "@nomicfoundation/hardhat-network-helpers": "^1.0.0",
        "@nomicfoundation/hardhat-toolbox": "^4.0.0",
        "@nomicfoundation/hardhat-verify": "^2.0.0",
-        "@semaphore-protocol/core": "4.8.1",
-        "@semaphore-protocol/hardhat": "4.8.1",
-        "@semaphore-protocol/utils": "4.8.1",
+        "@semaphore-protocol/core": "4.9.0",
+        "@semaphore-protocol/hardhat": "4.9.0",
+        "@semaphore-protocol/utils": "4.9.0",
        "@typechain/ethers-v6": "^0.5.0",
        "@typechain/hardhat": "^9.0.0",
        "@types/chai": "^4.2.0",
@@ -50,7 +50,7 @@
        "typescript": "^5.3.3"
    },
    "dependencies": {
-        "@semaphore-protocol/contracts": "4.8.1"
+        "@semaphore-protocol/contracts": "4.9.0"
    },
    "packageManager": "yarn@4.1.0"
 }
--- a/packages/cli-template-monorepo-ethers/apps/web-app/package.json
+++ b/packages/cli-template-monorepo-ethers/apps/web-app/package.json
@@ -9,9 +9,9 @@
        "lint": "next lint"
    },
    "dependencies": {
-        "@semaphore-protocol/core": "4.8.1",
-        "@semaphore-protocol/data": "4.8.1",
-        "@semaphore-protocol/utils": "4.8.1",
+        "@semaphore-protocol/core": "4.9.0",
+        "@semaphore-protocol/data": "4.9.0",
+        "@semaphore-protocol/utils": "4.9.0",
        "ethers": "^6.13.4",
        "next": "14.1.0",
        "next-pwa": "^5.6.0",
--- a/packages/cli-template-monorepo-ethers/package.json
+++ b/packages/cli-template-monorepo-ethers/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/cli-template-monorepo-ethers",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "Semaphore Hardhat + Next.js + SemaphoreEthers template.",
    "license": "Unlicense",
    "files": [
--- a/packages/cli-template-monorepo-subgraph/apps/contracts/package.json
+++ b/packages/cli-template-monorepo-subgraph/apps/contracts/package.json
@@ -20,9 +20,9 @@
        "@nomicfoundation/hardhat-network-helpers": "^1.0.0",
        "@nomicfoundation/hardhat-toolbox": "^4.0.0",
        "@nomicfoundation/hardhat-verify": "^2.0.0",
-        "@semaphore-protocol/core": "4.8.1",
-        "@semaphore-protocol/hardhat": "4.8.1",
-        "@semaphore-protocol/utils": "4.8.1",
+        "@semaphore-protocol/core": "4.9.0",
+        "@semaphore-protocol/hardhat": "4.9.0",
+        "@semaphore-protocol/utils": "4.9.0",
        "@typechain/ethers-v6": "^0.5.0",
        "@typechain/hardhat": "^9.0.0",
        "@types/chai": "^4.2.0",
@@ -50,7 +50,7 @@
        "typescript": "^5.3.3"
    },
    "dependencies": {
-        "@semaphore-protocol/contracts": "4.8.1"
+        "@semaphore-protocol/contracts": "4.9.0"
    },
    "packageManager": "yarn@4.1.0"
 }
--- a/packages/cli-template-monorepo-subgraph/apps/web-app/package.json
+++ b/packages/cli-template-monorepo-subgraph/apps/web-app/package.json
@@ -9,9 +9,9 @@
        "lint": "next lint"
    },
    "dependencies": {
-        "@semaphore-protocol/core": "4.8.1",
-        "@semaphore-protocol/data": "4.8.1",
-        "@semaphore-protocol/utils": "4.8.1",
+        "@semaphore-protocol/core": "4.9.0",
+        "@semaphore-protocol/data": "4.9.0",
+        "@semaphore-protocol/utils": "4.9.0",
        "ethers": "^6.13.4",
        "next": "14.1.0",
        "next-pwa": "^5.6.0",
--- a/packages/cli-template-monorepo-subgraph/package.json
+++ b/packages/cli-template-monorepo-subgraph/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/cli-template-monorepo-subgraph",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "Semaphore Hardhat + Next.js + SemaphoreSubgraph template.",
    "license": "Unlicense",
    "files": [
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,7 +1,7 @@
 {
    "name": "@semaphore-protocol/cli",
    "type": "module",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "A command line tool to set up your Semaphore project and get group data.",
    "license": "MIT",
    "bin": {
@@ -41,8 +41,8 @@
        "rollup-plugin-cleanup": "^3.2.1"
    },
    "dependencies": {
-        "@semaphore-protocol/data": "4.8.1",
-        "@semaphore-protocol/utils": "4.8.1",
+        "@semaphore-protocol/data": "4.9.0",
+        "@semaphore-protocol/utils": "4.9.0",
        "axios": "^1.6.7",
        "boxen": "^7.1.1",
        "chalk": "^5.3.0",
--- a/packages/contracts/contracts/package.json
+++ b/packages/contracts/contracts/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/contracts",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "Semaphore contracts to manage groups and broadcast anonymous signals.",
    "license": "MIT",
    "files": [
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/core",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "Core library for the essential Semaphore features.",
    "type": "module",
    "license": "MIT",
@@ -42,8 +42,8 @@
        "access": "public"
    },
    "dependencies": {
-        "@semaphore-protocol/group": "4.8.1",
-        "@semaphore-protocol/identity": "4.8.1",
-        "@semaphore-protocol/proof": "4.8.1"
+        "@semaphore-protocol/group": "4.9.0",
+        "@semaphore-protocol/identity": "4.9.0",
+        "@semaphore-protocol/proof": "4.9.0"
    }
 }
--- a/packages/data/package.json
+++ b/packages/data/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/data",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "A library for querying Semaphore smart contract.",
    "type": "module",
    "license": "MIT",
@@ -37,7 +37,8 @@
        "rollup-plugin-cleanup": "^3.2.1"
    },
    "dependencies": {
-        "@semaphore-protocol/utils": "4.8.1",
+        "@semaphore-protocol/utils": "4.9.0",
+        "@zk-kit/utils": "1.3.0",
        "axios": "1.6.6",
        "ethers": "6.13.4"
    }
--- a/packages/data/src/checkParameter.ts
+++ b/packages/data/src/checkParameter.ts
@@ -1,14 +0,0 @@
-/**
- * Validates the type of a given parameter against an expected type.
- * Throws a {@link TypeError} if the validation fails.
- * This function is useful for ensuring that function arguments conform to expected types at runtime.
- * @param value The value of the parameter to check.
- * @param name The name of the parameter, used in the error message for easier debugging.
- * @param type The expected JavaScript type as a string (e.g., 'string', 'number', 'object').
- * @throws {TypeError} Throws an error if the type of `value` does not match the `type`.
- */
-export default function checkParameter(value: any, name: string, type: string) {
-    if (typeof value !== type) {
-        throw new TypeError(`Parameter '${name}' is not ${type === "object" ? "an" : "a"} ${type}`)
-    }
-}
--- a/packages/data/src/ethers.ts
+++ b/packages/data/src/ethers.ts
@@ -17,8 +17,8 @@ import {
    Provider
 } from "ethers/providers"
 import { SemaphoreABI } from "@semaphore-protocol/utils/constants"
+import { requireString } from "@zk-kit/utils/error-handlers"
 import { EthersNetwork, EthersOptions, GroupResponse } from "./types"
-import checkParameter from "./checkParameter"
 import getEvents from "./getEvents"

 /**
@@ -40,16 +40,16 @@ export default class SemaphoreEthers {
     * @param options Configuration options for the ethers provider and the Semaphore contract.
     */
    constructor(networkOrEthereumURL: EthersNetwork | string = defaultNetwork, options: EthersOptions = {}) {
-        checkParameter(networkOrEthereumURL, "networkOrEthereumURL", "string")
+        requireString(networkOrEthereumURL, "networkOrEthereumURL")

        if (options.provider) {
-            checkParameter(options.provider, "provider", "string")
+            requireString(options.provider, "provider")
        } else if (!networkOrEthereumURL.startsWith("http")) {
            options.provider = "infura"
        }

        if (options.apiKey) {
-            checkParameter(options.apiKey, "apiKey", "string")
+            requireString(options.apiKey, "apiKey")
        }

        if (isSupportedNetwork(networkOrEthereumURL)) {
@@ -140,7 +140,7 @@ export default class SemaphoreEthers {
     * @returns A promise that resolves to a GroupResponse object.
     */
    async getGroup(groupId: string): Promise<GroupResponse> {
-        checkParameter(groupId, "groupId", "string")
+        requireString(groupId, "groupId")

        const groupAdmin = await this._contract.getGroupAdmin(groupId)

@@ -172,7 +172,7 @@ export default class SemaphoreEthers {
     * @returns A promise that resolves to an array of member identity commitments as strings.
     */
    async getGroupMembers(groupId: string): Promise<string[]> {
-        checkParameter(groupId, "groupId", "string")
+        requireString(groupId, "groupId")

        const groupAdmin = await this._contract.getGroupAdmin(groupId)

@@ -257,7 +257,7 @@ export default class SemaphoreEthers {
     * @returns A promise that resolves to an array of validated proofs.
     */
    async getGroupValidatedProofs(groupId: string): Promise<any> {
-        checkParameter(groupId, "groupId", "string")
+        requireString(groupId, "groupId")

        const groupAdmin = await this._contract.getGroupAdmin(groupId)

@@ -290,8 +290,8 @@ export default class SemaphoreEthers {
     * @returns A promise that resolves to true if the member is part of the group, otherwise false.
     */
    async isGroupMember(groupId: string, member: string): Promise<boolean> {
-        checkParameter(groupId, "groupId", "string")
-        checkParameter(member, "member", "string")
+        requireString(groupId, "groupId")
+        requireString(member, "member")

        return this._contract.hasMember(groupId, member)
    }
--- a/packages/data/src/subgraph.ts
+++ b/packages/data/src/subgraph.ts
@@ -1,6 +1,6 @@
 import { defaultNetwork, SupportedNetwork } from "@semaphore-protocol/utils/networks"
 import { AxiosRequestConfig } from "axios"
-import checkParameter from "./checkParameter"
+import { requireString, requireObject, requireBoolean } from "@zk-kit/utils/error-handlers"
 import getURL from "./getURL"
 import request from "./request"
 import { GroupOptions, GroupResponse } from "./types"
@@ -24,7 +24,7 @@ export default class SemaphoreSubgraph {
     * @param networkOrSubgraphURL Either a supported network identifier or a direct URL to the subgraph.
     */
    constructor(networkOrSubgraphURL: SupportedNetwork | string = defaultNetwork) {
-        checkParameter(networkOrSubgraphURL, "networkOrSubgraphURL", "string")
+        requireString(networkOrSubgraphURL, "networkOrSubgraphURL")

        if (typeof networkOrSubgraphURL === "string" && networkOrSubgraphURL.startsWith("http")) {
            this._url = networkOrSubgraphURL
@@ -73,12 +73,12 @@ export default class SemaphoreSubgraph {
     * @returns A promise that resolves to an array of group details.
     */
    async getGroups(options: GroupOptions = {}): Promise<GroupResponse[]> {
-        checkParameter(options, "options", "object")
+        requireObject(options, "options")

        const { members = false, validatedProofs = false } = options

-        checkParameter(members, "members", "boolean")
-        checkParameter(validatedProofs, "validatedProofs", "boolean")
+        requireBoolean(members, "members")
+        requireBoolean(validatedProofs, "validatedProofs")

        let filtersQuery = ""

@@ -164,13 +164,13 @@ export default class SemaphoreSubgraph {
     * @returns A promise that resolves to the details of the specified group.
     */
    async getGroup(groupId: string, options: Omit<GroupOptions, "filters"> = {}): Promise<GroupResponse> {
-        checkParameter(groupId, "groupId", "string")
-        checkParameter(options, "options", "object")
+        requireString(groupId, "groupId")
+        requireObject(options, "options")

        const { members = false, validatedProofs = false } = options

-        checkParameter(members, "members", "boolean")
-        checkParameter(validatedProofs, "validatedProofs", "boolean")
+        requireBoolean(members, "members")
+        requireBoolean(validatedProofs, "validatedProofs")

        const config: AxiosRequestConfig = {
            method: "post",
@@ -247,8 +247,8 @@ export default class SemaphoreSubgraph {
     * @returns A promise that resolves to true if the member is part of the group, otherwise false.
     */
    async isGroupMember(groupId: string, member: string): Promise<boolean> {
-        checkParameter(groupId, "groupId", "string")
-        checkParameter(member, "member", "string")
+        requireString(groupId, "groupId")
+        requireString(member, "member")

        const config: AxiosRequestConfig = {
            method: "post",
--- a/packages/group/package.json
+++ b/packages/group/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/group",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "A library to create and manage Semaphore groups.",
    "type": "module",
    "license": "MIT",
@@ -37,7 +37,7 @@
    },
    "dependencies": {
        "@zk-kit/lean-imt": "2.2.2",
-        "@zk-kit/utils": "1.2.1",
+        "@zk-kit/utils": "1.3.0",
        "poseidon-lite": "0.3.0"
    }
 }
--- a/packages/hardhat/package.json
+++ b/packages/hardhat/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/hardhat",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "A Hardhat plugin to deploy Semaphore contracts.",
    "type": "module",
    "license": "MIT",
@@ -41,7 +41,7 @@
    },
    "dependencies": {
        "@nomicfoundation/hardhat-ethers": "^3.0.0",
-        "@semaphore-protocol/contracts": "4.8.1",
+        "@semaphore-protocol/contracts": "4.9.0",
        "ethers": "^6.13.4",
        "hardhat-dependency-compiler": "^1.1.3"
    }
--- a/packages/identity/package.json
+++ b/packages/identity/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/identity",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "A library to create Semaphore identities.",
    "type": "module",
    "license": "MIT",
@@ -39,7 +39,7 @@
    "dependencies": {
        "@zk-kit/baby-jubjub": "1.0.3",
        "@zk-kit/eddsa-poseidon": "1.0.4",
-        "@zk-kit/utils": "1.2.1",
+        "@zk-kit/utils": "1.3.0",
        "poseidon-lite": "0.3.0"
    }
 }
--- a/packages/proof/package.json
+++ b/packages/proof/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/proof",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "A library to generate and verify Semaphore proofs.",
    "type": "module",
    "license": "MIT",
@@ -47,13 +47,13 @@
        "rollup-plugin-cleanup": "^3.2.1"
    },
    "peerDependencies": {
-        "@semaphore-protocol/group": "4.8.1",
-        "@semaphore-protocol/identity": "4.8.1"
+        "@semaphore-protocol/group": "4.9.0",
+        "@semaphore-protocol/identity": "4.9.0"
    },
    "dependencies": {
-        "@semaphore-protocol/utils": "4.8.1",
+        "@semaphore-protocol/utils": "4.9.0",
        "@zk-kit/artifacts": "1.8.0",
-        "@zk-kit/utils": "1.2.1",
+        "@zk-kit/utils": "1.3.0",
        "ethers": "6.13.4",
        "snarkjs": "0.7.4"
    }
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@semaphore-protocol/utils",
-    "version": "4.8.1",
+    "version": "4.9.0",
    "description": "A library to provide utility functions to the other Semaphore packages.",
    "type": "module",
    "license": "MIT",
--- a/yarn.lock
+++ b/yarn.lock
Author	SHA1	Message	Date
Vivian Plasencia	f679583498	chore: v4.9.0	2025-02-03 13:26:48 +01:00
Vivian Plasencia	05926d0ef7	chore: update utils package version (#954 )	2025-02-03 12:57:30 +01:00
Faezeh Shakouri	eef277281d	Refactor/type-validation (#951 ) * chore(data): add @zk-kit/utils dependency * refactor(data): refactor parameter validation using @zk-kit/utils	2025-02-03 12:40:32 +01:00
Chidozie DAVID	b96467f3d4	revert(subgraph): reverses changes made (#952 ) re #915	2025-02-03 12:35:25 +01:00
zanastas	e530412f27	Add new article (#918 ) * Add new article * Update apps/website/src/data/articles.json remove referral link Co-authored-by: Vivian Plasencia <v.pcalana@gmail.com> --------- Co-authored-by: Vivian Plasencia <v.pcalana@gmail.com>	2025-01-29 00:04:39 +01:00
Vivian Plasencia	4df7693367	chore(subgraph): update matchstick-as dependency (#946 ) * chore(subgraph): update matchstick-as dependency * chore(subgraph): update dependency versions * ci: update pull request workflow to install libssl1.1 before testing the subgraph * ci: update pull requests workflow * ci: update ubuntu version * ci: update ubuntu version in tests * ci: update ubuntu version	2025-01-27 14:47:11 +01:00
Sumit Vekariya	0ca80ca716	docs: fixed circuit logic url (#931 ) fix: circuit logic url	2025-01-27 13:13:39 +01:00
youyyytrok	ed8141e873	docs: fix broken link and typo correction (#923 ) * broken redirect CONTRIBUTING.md * typo README.md	2025-01-27 13:10:57 +01:00
Vivian Plasencia	0f4aca3ded	docs: make year update dynamically on website and docs (#945 ) * docs: make year update dynamically on website and docs * docs(docs): make year update dynamically	2025-01-20 21:45:32 +01:00
Vivian Plasencia	6e2ef756bc	docs(website): update roadmap (#943 ) docs(website): update roadmap on the website	2025-01-20 19:59:46 +01:00
hanghuge	c2dce437b4	chore: fix 404 status URL (#917 ) Signed-off-by: hanghuge <cmoman@outlook.com>	2025-01-20 12:43:47 +00:00
0xpanoramix	8b91d75c6f	feat(website): add obscurus to projects section (#941 ) re #939	2025-01-20 13:06:46 +01:00
Vivian Plasencia	abfcf9f006	docs: update contributing and pull_request_template files	2025-01-14 15:10:17 +01:00
Vivian Plasencia	a2e8f5a15c	chore: v4.8.2	2024-12-18 13:06:36 +01:00
Vivian Plasencia	f77df8d98f	fix: include solhint config file in contracts templates (#929 )	2024-12-18 13:01:35 +01:00