docs: 📝 document wallet context compatibility

Author: kastale

README.md

@@ -120,6 +120,12 @@ RUN_LIVE_TESTS=1 bun run test:e2e
 - `AELFSCAN_MCP_MAX_CHARS` (default: `60000`)
 - `AELFSCAN_MCP_INCLUDE_RAW` (default: `false`)
 
+## Wallet Context Compatibility
+
+- This skill is read-only and does not consume signer/private-key context for on-chain writes.
+- It is compatible with the shared wallet-context protocol (`~/.portkey/skill-wallet/context.v1.json`) used by write-capable skills.
+- `bun run deps:check` validates wallet-context schema version when a local context file exists.
+
 ## License
 
 MIT

README.zh-CN.md

@@ -120,6 +120,12 @@ RUN_LIVE_TESTS=1 bun run test:e2e
 - `AELFSCAN_MCP_MAX_CHARS`（默认 `60000`）
 - `AELFSCAN_MCP_INCLUDE_RAW`（默认 `false`）
 
+## 钱包上下文兼容性
+
+- 本 skill 为只读，不消费 signer/private-key 上下文，也不执行链上写操作。
+- 兼容写能力 skill 使用的共享 wallet-context 协议（`~/.portkey/skill-wallet/context.v1.json`）。
+- 当本地存在 context 文件时，`bun run deps:check` 会校验 wallet-context schema 版本。
+
 ## License
 
 MIT

SKILL.md

@@ -16,8 +16,8 @@ description: "AelfScan explorer data retrieval and analytics skill for agents."
 
 ## Safe usage rules
 - Never print private keys, mnemonics, or tokens in channel outputs.
-- For write operations, require explicit user confirmation and validate parameters before sending transactions.
-- Prefer `simulate` or read-only queries first when available.
+- This skill is read-only; do not attempt to execute chain writes via this package.
+- If user intent requires writes, route to wallet + domain write skills and keep this skill for analytics.
 
 ## Command recipes
 - Start MCP server: `bun run mcp`
@@ -28,5 +28,6 @@ description: "AelfScan explorer data retrieval and analytics skill for agents."
 
 ## Limits / Non-goals
 - This skill focuses on domain operations and adapters; it is not a full wallet custody system.
+- It does not consume signer context for transaction signing.
 - Do not hardcode environment secrets in source code or docs.
 - Avoid bypassing validation for external service calls.

scripts/check-deps-baseline.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env bun
 import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
 import { resolve } from 'node:path';
 
 type Baseline = {
@@ -44,8 +45,23 @@ function main() {
     }
   }
 
+  const contextPath =
+    process.env.PORTKEY_SKILL_WALLET_CONTEXT_PATH ||
+    resolve(homedir(), '.portkey', 'skill-wallet', 'context.v1.json');
+  if (existsSync(contextPath)) {
+    try {
+      const contextRaw = readJson<Record<string, unknown>>(contextPath);
+      if (contextRaw.version !== 1) {
+        failures.push(`wallet-context version expected 1, got ${String(contextRaw.version)}`);
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      failures.push(`wallet-context parse failed: ${message}`);
+    }
+  }
+
   if (failures.length > 0) {
-    console.error('[deps:check] dependency baseline mismatch:');
+    console.error('[deps:check] check failed:');
     for (const failure of failures) {
       console.error(`- ${failure}`);
     }