refactor: regenerate declarations with @icp-sdk/bindgen

Regenerate canister declaration files using @icp-sdk/bindgen@0.3.0,
replacing the old dfx-generated index.js/index.d.ts boilerplate.

- Replace createActor wrappers with direct Actor.createActor calls
- Add new typed .ts declaration files generated by bindgen
- Remove old .did, index.js, and index.d.ts files
- Update import paths to use .did.js extensions and import type
- Refine ByteBuf.inner type from Uint8Array | number[] to Uint8Array
- Add null guards for canister IDs in tests
- Update test host ports to 8000
- Reformat tsconfig.json, vite.config.ts, eslint.config.mjs

Author: andreacerulli

frontend/ic_vetkeys/CHANGELOG.md

@@ -12,6 +12,21 @@
 
 ### Changed
 
+- **BREAKING** `DefaultEncryptedMapsClient` and `DefaultKeyManagerClient`
+  constructors now accept an `HttpAgent` (from `@icp-sdk/core/agent`) instead of
+  `HttpAgentOptions`. Since `HttpAgent.create()` is async, the agent must be
+  created by the caller before being passed in — this avoids the deprecated
+  `new HttpAgent(options)` constructor and allows full configuration upfront,
+  including providing the network's root key for local development:
+
+    ```ts
+    const agent = await HttpAgent.create({
+        host,
+        identity,
+        ...(rootKey ? { rootKey } : {}), // rootKey from ic_env cookie in local dev
+    });
+    new DefaultEncryptedMapsClient(agent, canisterId);
+    ```
 
 - Make `DerivedKeyMaterial.deriveAesGcmCryptoKey` `@internal`.
 
@@ -27,7 +42,7 @@
 
 ### Changed
 
- - Bump `@dfinity` agent-related packages to major version `3`.
+- Bump `@dfinity` agent-related packages to major version `3`.
 
 ## [0.3.0] - 2025-06-30
 
@@ -44,9 +59,11 @@
 ## [0.2.0] - 2025-06-08
 
 ### Fixed
+
 - Links in code docs.
 
 ### Changed
+
 - The code docs now live on github.io.
 - Replaces some instances of `window` with `globalThis` in a few places for better node compatibility.
 

frontend/ic_vetkeys/eslint.config.mjs

@@ -3,8 +3,8 @@
 import eslint from "@eslint/js";
 import tseslint from "typescript-eslint";
 import eslintPluginPrettierRecommended from "eslint-plugin-prettier/recommended";
-import { fileURLToPath } from 'url';
-import path from 'path';
+import { fileURLToPath } from "url";
+import path from "path";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -13,30 +13,30 @@ export default tseslint.config(
     tseslint.configs.recommendedTypeChecked,
     eslintPluginPrettierRecommended,
     {
-      languageOptions: {
-        parserOptions: {
-          project: path.resolve(__dirname, "tsconfig.tests.json"),
-          tsconfigRootDir: __dirname,
+        languageOptions: {
+            parserOptions: {
+                project: path.resolve(__dirname, "tsconfig.tests.json"),
+                tsconfigRootDir: __dirname,
+            },
+        },
+        rules: {
+            "@typescript-eslint/naming-convention": [
+                "error",
+                {
+                    selector: "variableLike",
+                    format: ["camelCase"],
+                },
+                {
+                    selector: "variable",
+                    modifiers: ["const"],
+                    format: ["camelCase", "UPPER_CASE"],
+                },
+                {
+                    selector: "typeLike",
+                    format: ["PascalCase"],
+                },
+            ],
         },
-      },
-      rules: {
-        '@typescript-eslint/naming-convention': [
-          'error',
-          {
-            selector: 'variableLike',
-            format: ['camelCase'],
-          },
-          {
-            selector: 'variable',
-            modifiers: ['const'],
-            format: ['camelCase', 'UPPER_CASE'],
-          },
-          {
-            selector: 'typeLike',
-            format: ['PascalCase'],
-          },
-        ],
-      },
     },
     {
         ignores: [

frontend/ic_vetkeys/package.json

@@ -57,7 +57,7 @@
     "module": "dist/lib/index.es.js",
     "typings": "dist/types/index.d.ts",
     "dependencies": {
-        "@icp-sdk/core": "^5.0.0",
+        "@icp-sdk/core": "^5.2.1",
         "idb-keyval": "^6.2.1"
     },
     "devDependencies": {
@@ -81,15 +81,15 @@
     "scripts": {
         "build": "tsc && vite build",
         "prepare": "test -d dist || (npx vite --version >/dev/null 2>&1 && npm run build) || echo 'dist/ not found and vite not available — run npm install && npm run build in frontend/ic_vetkeys'",
-        "coverage": "npm run test:deploy_all && export $(cat .test1.env .test2.env | xargs) && vitest run --coverage",
+        "coverage": "npm run test:deploy_all && CANISTER_ID_IC_VETKEYS_MANAGER_CANISTER=$(cd $(git rev-parse --show-toplevel)/backend/rs/canisters && icp canister status ic_vetkeys_manager_canister -e local --id-only) CANISTER_ID_IC_VETKEYS_ENCRYPTED_MAPS_CANISTER=$(cd $(git rev-parse --show-toplevel)/backend/rs/canisters && icp canister status ic_vetkeys_encrypted_maps_canister -e local --id-only) vitest run --coverage",
         "lint": "eslint",
         "make:docs": "mkdir -p $(git rev-parse --show-toplevel)/docs/key_manager && mkdir -p $(git rev-parse --show-toplevel)/docs/encrypted_maps && typedoc --out $(git rev-parse --show-toplevel)/docs",
         "prettier": "prettier --write .",
         "prettier-check": "prettier --check .",
         "test_utils": "vitest utils",
-        "test": "npm run test:deploy_all && export $(cat .test1.env .test2.env | xargs) && vitest --sequence.concurrent",
-        "test:deploy_all": "npm run test:deploy_key_manager_canister && npm run test:deploy_encrypted_maps_canister",
-        "test:deploy_key_manager_canister": "cd $(git rev-parse --show-toplevel)/backend/rs/canisters/ic_vetkeys_manager_canister && dfx start --clean --background; dfx deploy --argument '(\"dfx_test_key\")' ic_vetkeys_manager_canister && grep CANISTER_ID .env > $(git rev-parse --show-toplevel)/frontend/ic_vetkeys/.test1.env",
-        "test:deploy_encrypted_maps_canister": "cd $(git rev-parse --show-toplevel)/backend/rs/canisters/ic_vetkeys_encrypted_maps_canister && dfx start --clean --background; dfx deploy --argument '(\"dfx_test_key\")' ic_vetkeys_encrypted_maps_canister && grep CANISTER_ID .env > $(git rev-parse --show-toplevel)/frontend/ic_vetkeys/.test2.env"
+        "test": "npm run test:deploy_all && CANISTER_ID_IC_VETKEYS_MANAGER_CANISTER=$(cd $(git rev-parse --show-toplevel)/backend/rs/canisters && icp canister status ic_vetkeys_manager_canister -e local --id-only) CANISTER_ID_IC_VETKEYS_ENCRYPTED_MAPS_CANISTER=$(cd $(git rev-parse --show-toplevel)/backend/rs/canisters && icp canister status ic_vetkeys_encrypted_maps_canister -e local --id-only) vitest run --sequence.concurrent",
+        "test:deploy_all": "cd $(git rev-parse --show-toplevel)/backend/rs/canisters && (icp network stop || true) && icp network start -d && icp deploy ic_vetkeys_manager_canister -e local && icp deploy ic_vetkeys_encrypted_maps_canister -e local",
+        "test:deploy_key_manager_canister": "cd $(git rev-parse --show-toplevel)/backend/rs/canisters && (icp network stop || true) && icp network start -d && icp deploy ic_vetkeys_manager_canister -e local",
+        "test:deploy_encrypted_maps_canister": "cd $(git rev-parse --show-toplevel)/backend/rs/canisters && (icp network stop || true) && icp network start -d && icp deploy ic_vetkeys_encrypted_maps_canister -e local"
     }
 }

frontend/ic_vetkeys/src/declarations/ic_vetkeys_encrypted_maps_canister/ic_vetkeys_encrypted_maps_canister.did

@@ -1,11 +1,19 @@
-import type { Principal } from '@icp-sdk/core/principal';
+/* eslint-disable */
+
+// @ts-nocheck
+
+// This file was automatically generated by @icp-sdk/bindgen@0.3.0.
+// You should NOT make any changes in this file as it will be overwritten.
+// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
+
 import type { ActorMethod } from '@icp-sdk/core/agent';
 import type { IDL } from '@icp-sdk/core/candid';
+import type { Principal } from '@icp-sdk/core/principal';
 
 export type AccessRights = { 'Read' : null } |
   { 'ReadWrite' : null } |
   { 'ReadWriteManage' : null };
-export interface ByteBuf { 'inner' : Uint8Array | number[] }
+export interface ByteBuf { 'inner' : Uint8Array }
 export interface EncryptedMapData {
   'access_control' : Array<[Principal, AccessRights]>,
   'keyvals' : Array<[ByteBuf, ByteBuf]>,
@@ -60,4 +68,4 @@ export interface _SERVICE {
   >,
 }
 export declare const idlFactory: IDL.InterfaceFactory;
-export declare const init: (args: { IDL: typeof IDL }) => IDL.Type[];
+export declare const init: (args: { IDL: typeof IDL }) => IDL.Type[];

frontend/ic_vetkeys/src/declarations/ic_vetkeys_encrypted_maps_canister/ic_vetkeys_encrypted_maps_canister.did.d.ts

@@ -1,3 +1,13 @@
+/* eslint-disable */
+
+// @ts-nocheck
+
+// This file was automatically generated by @icp-sdk/bindgen@0.3.0.
+// You should NOT make any changes in this file as it will be overwritten.
+// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
+
+import { IDL } from '@icp-sdk/core/candid';
+
 export const idlFactory = ({ IDL }) => {
   const ByteBuf = IDL.Record({ 'inner' : IDL.Vec(IDL.Nat8) });
   const AccessRights = IDL.Variant({
@@ -26,6 +36,7 @@ export const idlFactory = ({ IDL }) => {
     'Err' : IDL.Text,
   });
   const Result_5 = IDL.Variant({ 'Ok' : IDL.Vec(ByteBuf), 'Err' : IDL.Text });
+  
   return IDL.Service({
     'get_accessible_shared_map_names' : IDL.Func(
         [],
@@ -103,4 +114,5 @@ export const idlFactory = ({ IDL }) => {
       ),
   });
 };
-export const init = ({ IDL }) => { return []; };
+
+export const init = ({ IDL }) => { return [IDL.Text]; };