chore: 🔧 add wallet-context schema checks to deps gate

Author: kastale

bun.lock

@@ -70,6 +70,7 @@
   },
   "devDependencies": {
     "@types/bun": "latest",
+    "ajv": "^8.17.1",
     "typescript": "^5.7.0"
   }
 }

package.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/AElfProject/aelf-skills/docs/schemas/wallet-context.v1.schema.json",
+  "title": "WalletContextFileV1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "activeProfileId",
+    "profiles",
+    "lastWriter"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "activeProfileId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "profiles": {
+      "type": "object",
+      "minProperties": 0,
+      "additionalProperties": {
+        "$ref": "#/$defs/activeProfile"
+      }
+    },
+    "lastWriter": {
+      "$ref": "#/$defs/lastWriter"
+    }
+  },
+  "$defs": {
+    "activeProfile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "walletType",
+        "source",
+        "updatedAt"
+      ],
+      "properties": {
+        "walletType": {
+          "type": "string",
+          "enum": [
+            "EOA",
+            "CA"
+          ]
+        },
+        "source": {
+          "type": "string",
+          "enum": [
+            "eoa-local",
+            "ca-keystore",
+            "env"
+          ]
+        },
+        "network": {
+          "type": "string"
+        },
+        "address": {
+          "type": "string"
+        },
+        "caAddress": {
+          "type": "string"
+        },
+        "caHash": {
+          "type": "string"
+        },
+        "walletFile": {
+          "type": "string"
+        },
+        "keystoreFile": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "lastWriter": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "skill",
+        "version"
+      ],
+      "properties": {
+        "skill": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  }
+}

schemas/wallet-context.v1.schema.json

@@ -2,6 +2,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { resolve } from 'node:path';
+import Ajv from 'ajv';
 
 type Baseline = {
   dependencies: Record<string, string>;
@@ -15,6 +16,7 @@ function main() {
   const cwd = process.cwd();
   const baselinePath = resolve(cwd, 'deps-baseline.json');
   const packagePath = resolve(cwd, 'package.json');
+  const contextSchemaPath = resolve(cwd, 'schemas', 'wallet-context.v1.schema.json');
 
   if (!existsSync(baselinePath)) {
     console.error(`[deps:check] missing deps-baseline.json at ${baselinePath}`);
@@ -48,15 +50,23 @@ function main() {
   const contextPath =
     process.env.PORTKEY_SKILL_WALLET_CONTEXT_PATH ||
     resolve(homedir(), '.portkey', 'skill-wallet', 'context.v1.json');
-  if (existsSync(contextPath)) {
+  if (!existsSync(contextSchemaPath)) {
+    failures.push(`missing wallet-context schema: ${contextSchemaPath}`);
+  } else if (existsSync(contextPath)) {
     try {
+      const schema = readJson<Record<string, unknown>>(contextSchemaPath);
       const contextRaw = readJson<Record<string, unknown>>(contextPath);
-      if (contextRaw.version !== 1) {
-        failures.push(`wallet-context version expected 1, got ${String(contextRaw.version)}`);
+      const ajv = new Ajv({ allErrors: true, strict: false });
+      const validate = ajv.compile(schema);
+      if (!validate(contextRaw)) {
+        const details = (validate.errors || [])
+          .map((err) => `${err.instancePath || '/'} ${err.message || 'invalid'}`)
+          .join('; ');
+        failures.push(`wallet-context schema validation failed (${contextPath}): ${details}`);
       }
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      failures.push(`wallet-context parse failed: ${message}`);
+      failures.push(`wallet-context parse/validation failed: ${message}`);
     }
   }