create-agent 0.0.7 → 0.0.10

package/.claude/settings.local.json

@@ -0,0 +1,23 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(tree:*)",
+      "Bash(git checkout:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(node -e:*)",
+      "Bash(npm test)",
+      "Bash(git pull:*)",
+      "Bash(gh pr list:*)",
+      "Bash(gh issue list:*)",
+      "WebFetch(domain:nostrcg.github.io)",
+      "Bash(node bin/create-agent.js:*)",
+      "WebSearch",
+      "Bash(gh issue view:*)",
+      "Bash(gh api:*)",
+      "WebFetch(domain:ai-sdk.dev)",
+      "WebFetch(domain:github.com)",
+      "Bash(git fetch:*)"
+    ]
+  }
+}

package/README.md

@@ -1,5 +1,7 @@
 # create-agent 🤖
 
+[![npm version](https://img.shields.io/npm/v/create-agent.svg)](https://www.npmjs.com/package/create-agent)
+
 A command-line tool to generate Agent keypairs with various encodings.
 
 ## Installation 📦

package/bin/create-agent.js

@@ -1,35 +1,37 @@
 #!/usr/bin/env node
 
-// Use nostr-tools to generate secure keypair
-import { generateSecretKey, getPublicKey } from 'nostr-tools/pure';
-import { nip19 } from 'nostr-tools';
-
-// Generate cryptographically secure private key (32 bytes)
-const privkey = generateSecretKey();
-
-// Convert Uint8Array to hex string
-const privkeyHex = Array.from(privkey)
-  .map(b => b.toString(16).padStart(2, '0'))
-  .join('');
-
-// Derive public key using Schnorr signatures (32 bytes, hex encoded)
-const pubkey = getPublicKey(privkey);
-
-// Encode the private key as nsec
-const nsec = nip19.nsecEncode(privkey);
-
-// Encode the public key as npub
-const npub = nip19.npubEncode(pubkey);
-
-// Cool console message
-console.error('\x1b[36m%s\x1b[0m', '🤖 Creating new agent...');
-console.error('\x1b[33m%s\x1b[0m', '⚠️  Keep your private key secret!');
-console.error('');
-
-// Output JSON with both keys, nsec and npub
-console.log(JSON.stringify({
-  privkey: privkeyHex,
-  pubkey: pubkey,
-  nsec: nsec,
-  npub: npub
-}, null, 2)); 
+import { generateAgent } from '../index.js'
+
+// Generate agent identity
+const { privkey, pubkey, nsec, npub, did } = generateAgent()
+
+// =============================================================================
+// CONSOLE OUTPUT
+// =============================================================================
+// First output the initial warning message to stderr
+process.stderr.write('\x1b[36m🤖 Creating new Nostr agent identity...\x1b[0m\n');
+process.stderr.write('\x1b[36m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m\n');
+process.stderr.write('\x1b[33m⚠️  IMPORTANT: Keep your private key (nsec/privkey) secret!\x1b[0m\n');
+process.stderr.write('\x1b[33m   Never share it with anyone or input it on websites.\x1b[0m\n');
+process.stderr.write('\n');
+
+// Then output the Nostr identity information to stderr
+process.stderr.write('\n\x1b[32m📋 Your Nostr Identity:\x1b[0m\n');
+process.stderr.write('\x1b[32m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m\n');
+process.stderr.write(`\x1b[0mPublic Key (hex) : \x1b[33m${pubkey}\x1b[0m\n`);
+process.stderr.write(`\x1b[0mNostr Public Key : \x1b[33m${npub}\x1b[0m\n`);
+process.stderr.write(`\x1b[0mPrivate Key (hex): \x1b[31m${privkey}\x1b[0m\n`);
+process.stderr.write(`\x1b[0mNostr Secret Key : \x1b[31m${nsec}\x1b[0m\n`);
+process.stderr.write('\n');
+process.stderr.write('\x1b[36m🔍 Usage:\x1b[0m\n');
+process.stderr.write('\x1b[0m- Use your npub to identify yourself to others\x1b[0m\n');
+process.stderr.write('\x1b[0m- Add relays to the services array for discovery\x1b[0m\n');
+process.stderr.write('\x1b[0m- Use nsec to sign into Nostr clients (handle with extreme care!)\x1b[0m\n');
+process.stderr.write('\n');
+
+
+// Then output the DID document to stdout with a clear header in the output
+process.stderr.write('\x1b[36m📄 DID Nostr Document:\x1b[0m\n');
+process.stderr.write('\x1b[36m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m\n');
+console.log(JSON.stringify(did, null, 2));
+process.stderr.write('\x1b[36m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m\n');

package/index.js

@@ -0,0 +1,47 @@
+import { generateSecretKey, getPublicKey } from 'nostr-tools/pure'
+import { nip19 } from 'nostr-tools'
+
+/**
+ * Generate a new Nostr agent identity
+ * @returns {{ privkey: string, pubkey: string, nsec: string, npub: string, did: object }}
+ */
+export function generateAgent() {
+  // Generate cryptographically secure private key (32 bytes)
+  const sk = generateSecretKey()
+  const privkey = Array.from(sk)
+    .map(b => b.toString(16).padStart(2, '0'))
+    .join('')
+
+  // Derive public key using Schnorr signatures
+  const pubkey = getPublicKey(sk)
+
+  // Encode keys in Nostr formats
+  const nsec = nip19.nsecEncode(sk)
+  const npub = nip19.npubEncode(pubkey)
+
+  // Create publicKeyMultibase: f (base16-lower) + e701 (secp256k1-pub varint) + 02 (even parity) + pubkey
+  const publicKeyMultibase = `fe70102${pubkey}`
+
+  // Create DID document per https://nostrcg.github.io/did-nostr/
+  const did = {
+    "@context": [
+      "https://w3id.org/did",
+      "https://w3id.org/nostr/context"
+    ],
+    "id": `did:nostr:${pubkey}`,
+    "type": "DIDNostr",
+    "verificationMethod": [
+      {
+        "id": `did:nostr:${pubkey}#key1`,
+        "type": "Multikey",
+        "controller": `did:nostr:${pubkey}`,
+        "publicKeyMultibase": publicKeyMultibase
+      }
+    ],
+    "authentication": ["#key1"],
+    "assertionMethod": ["#key1"],
+    "service": []
+  }
+
+  return { privkey, pubkey, nsec, npub, did }
+}

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "create-agent",
   "type": "module",
-  "version": "0.0.7",
+  "version": "0.0.10",
   "description": "create an agent",
-  "main": "index.js",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "node --test"
   },
   "bin": {
     "create-agent": "bin/create-agent.js"

package/test/index.test.js

@@ -0,0 +1,66 @@
+import { test, describe } from 'node:test'
+import assert from 'node:assert'
+import { generateAgent } from '../index.js'
+
+describe('generateAgent', () => {
+  test('returns all expected properties', () => {
+    const agent = generateAgent()
+    
+    assert.ok(agent.privkey, 'should have privkey')
+    assert.ok(agent.pubkey, 'should have pubkey')
+    assert.ok(agent.nsec, 'should have nsec')
+    assert.ok(agent.npub, 'should have npub')
+    assert.ok(agent.did, 'should have did')
+  })
+
+  test('privkey is 64-character hex string', () => {
+    const { privkey } = generateAgent()
+    
+    assert.strictEqual(privkey.length, 64)
+    assert.match(privkey, /^[0-9a-f]{64}$/)
+  })
+
+  test('pubkey is 64-character hex string', () => {
+    const { pubkey } = generateAgent()
+    
+    assert.strictEqual(pubkey.length, 64)
+    assert.match(pubkey, /^[0-9a-f]{64}$/)
+  })
+
+  test('nsec starts with nsec1', () => {
+    const { nsec } = generateAgent()
+    
+    assert.ok(nsec.startsWith('nsec1'))
+  })
+
+  test('npub starts with npub1', () => {
+    const { npub } = generateAgent()
+    
+    assert.ok(npub.startsWith('npub1'))
+  })
+
+  test('did document has correct structure', () => {
+    const { did, pubkey } = generateAgent()
+    
+    assert.deepStrictEqual(did['@context'], [
+      'https://www.w3.org/ns/did/v1',
+      'https://w3id.org/nostr/context'
+    ])
+    assert.strictEqual(did.id, `did:nostr:${pubkey}`)
+    assert.ok(Array.isArray(did.verificationMethod))
+    assert.strictEqual(did.verificationMethod[0].type, 'SchnorrVerification2025')
+    assert.deepStrictEqual(did.authentication, ['#key1'])
+    assert.deepStrictEqual(did.assertionMethod, ['#key1'])
+    assert.deepStrictEqual(did.service, [])
+  })
+
+  test('generates unique keys on each call', () => {
+    const agent1 = generateAgent()
+    const agent2 = generateAgent()
+    
+    assert.notStrictEqual(agent1.privkey, agent2.privkey)
+    assert.notStrictEqual(agent1.pubkey, agent2.pubkey)
+    assert.notStrictEqual(agent1.nsec, agent2.nsec)
+    assert.notStrictEqual(agent1.npub, agent2.npub)
+  })
+})