@equalfi/ski 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# @equalfi/ski
+
+Interactive Session Key Installer for EqualFi.
+
+## Install & Run
+
+```bash
+pnpm dlx @equalfi/ski
+```
+
+## What it does
+- Prompts for Position NFT id and Validation Entity ID
+- Generates a fresh session EOA
+- Stores encrypted keystore at `~/.openclaw/keys/equalfi/<label>.json`
+- Stores the password in your OS keychain (one prompt)
+- Prints the session key address to paste into the UI
+
+## Notes
+- Default label is `position-<tokenId>`
+- If the key already exists, it asks before overwriting
+
+## Output example
+```
+✅ Session key created
+Address: 0xabc...
+Label:   position-1
+Entity:  7
+Stored:  ~/.openclaw/keys/equalfi/position-1.json
+```
+
+Then paste the address into the EqualFi UI Session Key Address field and click **Install Session Key Module**.

package/bin/cli.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+
+const fs = require('fs/promises');
+const path = require('path');
+const os = require('os');
+const crypto = require('crypto');
+const prompts = require('prompts');
+const keytar = require('keytar');
+const { Wallet } = require('ethers');
+
+const SERVICE = 'equalfi-ski';
+const SKILL_ID = 'equalfi';
+const DEFAULT_ENTITY_ID = 7;
+
+const resolvePaths = (label) => {
+  const baseDir = path.join(os.homedir(), '.openclaw', 'keys', SKILL_ID);
+  return {
+    baseDir,
+    keystorePath: path.join(baseDir, `${label}.json`),
+    metaPath: path.join(baseDir, `${label}.meta.json`),
+  };
+};
+
+const keychainAccount = (label) => `session-key:${SKILL_ID}:${label}`;
+
+async function ensureDir(dir) {
+  await fs.mkdir(dir, { recursive: true });
+}
+
+async function fileExists(p) {
+  try {
+    await fs.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function main() {
+  const response = await prompts([
+    {
+      type: 'number',
+      name: 'tokenId',
+      message: 'Position NFT id (for label)',
+      validate: (v) => (Number.isFinite(v) && v > 0 ? true : 'Enter a positive integer'),
+    },
+    {
+      type: 'number',
+      name: 'entityId',
+      message: 'Validation Entity ID',
+      initial: DEFAULT_ENTITY_ID,
+      validate: (v) => (Number.isFinite(v) && v >= 0 ? true : 'Enter a non-negative integer'),
+    },
+  ]);
+
+  if (response.tokenId === undefined) {
+    console.log('Cancelled.');
+    return;
+  }
+
+  const label = `position-${response.tokenId}`;
+  const entityId = Number(response.entityId ?? DEFAULT_ENTITY_ID);
+
+  const { baseDir, keystorePath, metaPath } = resolvePaths(label);
+  await ensureDir(baseDir);
+
+  if (await fileExists(keystorePath)) {
+    const confirm = await prompts({
+      type: 'confirm',
+      name: 'overwrite',
+      message: `Key for ${label} already exists. Overwrite?`,
+      initial: false,
+    });
+    if (!confirm.overwrite) {
+      console.log('Aborted.');
+      return;
+    }
+  }
+
+  const wallet = Wallet.createRandom();
+  const password = crypto.randomBytes(32).toString('hex');
+  const keystore = await wallet.encrypt(password);
+
+  await fs.writeFile(keystorePath, keystore);
+  await fs.writeFile(
+    metaPath,
+    JSON.stringify(
+      {
+        address: wallet.address,
+        chainId: null,
+        skillId: SKILL_ID,
+        agentLabel: label,
+        positionTokenId: response.tokenId,
+        entityId,
+        createdAt: new Date().toISOString(),
+        keychainService: SERVICE,
+        keychainAccount: keychainAccount(label),
+      },
+      null,
+      2
+    )
+  );
+
+  try {
+    await keytar.setPassword(SERVICE, keychainAccount(label), password);
+  } catch (err) {
+    console.error('Failed to store key in OS keychain:', err?.message || err);
+    console.error('Keystore saved, but you must secure the password manually.');
+    return;
+  }
+
+  console.log('\n✅ Session key created');
+  console.log(`Address: ${wallet.address}`);
+  console.log(`Label:   ${label}`);
+  console.log(`Entity:  ${entityId}`);
+  console.log(`Stored:  ${keystorePath}`);
+  console.log('\nPaste the address into the UI session key field and install the module/policy.');
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@equalfi/ski",
+  "version": "0.1.0",
+  "description": "EqualFi Session Key Installer (interactive CLI)",
+  "license": "MIT",
+  "bin": {
+    "ski": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "ethers": "^6.13.5",
+    "keytar": "^7.9.0",
+    "prompts": "^2.4.2"
+  }
+}