@didcid/keymaster 0.4.2 → 0.4.4

package/README.md

@@ -125,150 +125,105 @@ keymaster list-ids
 
 #### Commands
 
-##### Wallet Management
-
-| Command | Description |
-|---------|-------------|
-| `create-wallet` | Create a new wallet (or show existing) |
-| `new-wallet` | Create a new wallet |
-| `show-wallet` | Display wallet contents |
-| `check-wallet` | Validate DIDs in wallet |
-| `fix-wallet` | Remove invalid DIDs from wallet |
-| `import-wallet <phrase>` | Create wallet from recovery phrase |
-| `show-mnemonic` | Show recovery phrase |
-| `backup-wallet-file <file>` | Backup wallet to file |
-| `restore-wallet-file <file>` | Restore wallet from file |
-| `backup-wallet-did` | Backup wallet to encrypted DID |
-| `recover-wallet-did [did]` | Recover wallet from DID |
-
-##### Identity Management
-
-| Command | Description |
-|---------|-------------|
-| `create-id <name>` | Create a new identity |
-| `list-ids` | List all identities |
-| `use-id <name>` | Set current identity |
-| `remove-id <name>` | Delete an identity |
-| `rename-id <old> <new>` | Rename an identity |
-| `resolve-id` | Resolve current identity |
-| `rotate-keys` | Generate new keys for current ID |
-| `backup-id` | Backup current ID to registry |
-| `recover-id <did>` | Recover ID from DID |
-
-##### DID Operations
-
-| Command | Description |
-|---------|-------------|
-| `resolve-did <did>` | Resolve a DID document |
-| `resolve-did-version <did> <ver>` | Resolve specific version |
-| `revoke-did <did>` | Permanently revoke a DID |
-
-##### Encryption & Signing
-
-| Command | Description |
-|---------|-------------|
-| `encrypt-message <msg> <did>` | Encrypt message for recipient |
-| `encrypt-file <file> <did>` | Encrypt file for recipient |
-| `decrypt-did <did>` | Decrypt an encrypted message |
-| `decrypt-json <did>` | Decrypt encrypted JSON |
-| `sign-file <file>` | Sign a JSON file |
-| `verify-file <file>` | Verify signature in file |
-
-##### Credentials
-
-| Command | Description |
-|---------|-------------|
-| `bind-credential <schema> <subject>` | Create bound credential |
-| `issue-credential <file>` | Issue a credential |
-| `list-issued` | List issued credentials |
-| `revoke-credential <did>` | Revoke a credential |
-| `accept-credential <did>` | Accept a credential |
-| `list-credentials` | List held credentials |
-| `get-credential <did>` | Get credential by DID |
-| `publish-credential <did>` | Publish credential existence |
-| `reveal-credential <did>` | Reveal credential publicly |
-| `unpublish-credential <did>` | Remove from manifest |
-
-##### Challenges & Responses
-
-| Command | Description |
-|---------|-------------|
-| `create-challenge [file]` | Create a challenge |
-| `create-challenge-cc <did>` | Create challenge from credential |
-| `create-response <challenge>` | Respond to a challenge |
-| `verify-response <response>` | Verify a response |
-
-##### Aliases
-
-| Command | Description |
-|---------|-------------|
-| `add-alias <alias> <did>` | Add alias for DID |
-| `get-alias <alias>` | Get DID by alias |
-| `remove-alias <alias>` | Remove alias |
-| `list-aliases` | List all aliases |
-
-##### Groups
-
-| Command | Description |
-|---------|-------------|
-| `create-group <name>` | Create a group |
-| `list-groups` | List owned groups |
-| `get-group <did>` | Get group details |
-| `add-group-member <group> <member>` | Add member to group |
-| `remove-group-member <group> <member>` | Remove member |
-| `test-group <group> [member]` | Test group membership |
-
-##### Schemas
-
-| Command | Description |
-|---------|-------------|
-| `create-schema <file>` | Create schema from file |
-| `list-schemas` | List owned schemas |
-| `get-schema <did>` | Get schema by DID |
-| `create-schema-template <schema>` | Generate template |
-
-##### Assets
-
-| Command | Description |
-|---------|-------------|
-| `create-asset` | Create empty asset |
-| `create-asset-json <file>` | Create from JSON file |
-| `create-asset-image <file>` | Create from image |
-| `create-asset-file <file>` | Create from file |
-| `get-asset <id>` | Get asset by ID |
-| `update-asset-json <id> <file>` | Update with JSON |
-| `update-asset-image <id> <file>` | Update with image |
-| `update-asset-file <id> <file>` | Update with file |
-| `transfer-asset <id> <controller>` | Transfer ownership |
-| `clone-asset <id>` | Clone an asset |
-| `set-property <id> <key> [value]` | Set asset property |
-| `list-assets` | List owned assets |
-
-##### Polls
-
-| Command | Description |
-|---------|-------------|
-| `create-poll-template` | Create poll template |
-| `create-poll <file>` | Create poll from file |
-| `view-poll <poll>` | View poll details |
-| `vote-poll <poll> <vote>` | Vote in poll |
-| `update-poll <ballot>` | Add ballot to poll |
-| `publish-poll <poll>` | Publish results (hidden) |
-| `reveal-poll <poll>` | Publish results (revealed) |
-| `unpublish-poll <poll>` | Remove results |
-
-##### Vaults
-
-| Command | Description |
-|---------|-------------|
-| `create-vault` | Create a vault |
-| `list-vault-items <id>` | List vault items |
-| `add-vault-member <id> <member>` | Add vault member |
-| `remove-vault-member <id> <member>` | Remove member |
-| `list-vault-members <id>` | List members |
-| `add-vault-item <id> <file>` | Add file to vault |
-| `remove-vault-item <id> <item>` | Remove item |
-| `get-vault-item <id> <item> <file>` | Download item |
+| Category | Command | Description |
+|----------|---------|-------------|
+| Wallet | `create-wallet` | Create a new wallet (or show existing) |
+| Wallet | `new-wallet` | Create a new wallet |
+| Wallet | `show-wallet` | Display wallet contents |
+| Wallet | `check-wallet` | Validate DIDs in wallet |
+| Wallet | `fix-wallet` | Remove invalid DIDs from wallet |
+| Wallet | `import-wallet <phrase>` | Create wallet from recovery phrase |
+| Wallet | `show-mnemonic` | Show recovery phrase |
+| Wallet | `backup-wallet-file <file>` | Backup wallet to file |
+| Wallet | `restore-wallet-file <file>` | Restore wallet from file |
+| Wallet | `backup-wallet-did` | Backup wallet to encrypted DID |
+| Wallet | `recover-wallet-did [did]` | Recover wallet from DID |
+| Wallet | `change-passphrase <new>` | Re-encrypt wallet with a new passphrase |
+| Identity | `create-id <name>` | Create a new identity |
+| Identity | `list-ids` | List all identities |
+| Identity | `use-id <name>` | Set current identity |
+| Identity | `remove-id <name>` | Delete an identity |
+| Identity | `rename-id <old> <new>` | Rename an identity |
+| Identity | `resolve-id` | Resolve current identity |
+| Identity | `rotate-keys` | Generate new keys for current ID |
+| Identity | `backup-id` | Backup current ID to registry |
+| Identity | `recover-id <did>` | Recover ID from DID |
+| DID | `resolve-did <did>` | Resolve a DID document |
+| DID | `resolve-did-version <did> <ver>` | Resolve specific version |
+| DID | `revoke-did <did>` | Permanently revoke a DID |
+| Encryption | `encrypt-message <msg> <did>` | Encrypt message for recipient |
+| Encryption | `encrypt-file <file> <did>` | Encrypt file for recipient |
+| Encryption | `decrypt-did <did>` | Decrypt an encrypted message |
+| Encryption | `decrypt-json <did>` | Decrypt encrypted JSON |
+| Encryption | `sign-file <file>` | Sign a JSON file |
+| Encryption | `verify-file <file>` | Verify signature in file |
+| Credentials | `bind-credential <schema> <subject>` | Create bound credential |
+| Credentials | `issue-credential <file>` | Issue a credential |
+| Credentials | `list-issued` | List issued credentials |
+| Credentials | `revoke-credential <did>` | Revoke a credential |
+| Credentials | `accept-credential <did>` | Accept a credential |
+| Credentials | `list-credentials` | List held credentials |
+| Credentials | `get-credential <did>` | Get credential by DID |
+| Credentials | `publish-credential <did>` | Publish credential existence |
+| Credentials | `reveal-credential <did>` | Reveal credential publicly |
+| Credentials | `unpublish-credential <did>` | Remove from manifest |
+| Challenges | `create-challenge [file]` | Create a challenge |
+| Challenges | `create-challenge-cc <did>` | Create challenge from credential |
+| Challenges | `create-response <challenge>` | Respond to a challenge |
+| Challenges | `verify-response <response>` | Verify a response |
+| Aliases | `add-alias <alias> <did>` | Add alias for DID |
+| Aliases | `get-alias <alias>` | Get DID by alias |
+| Aliases | `remove-alias <alias>` | Remove alias |
+| Aliases | `list-aliases` | List all aliases |
+| Groups | `create-group <name>` | Create a group |
+| Groups | `list-groups` | List owned groups |
+| Groups | `get-group <did>` | Get group details |
+| Groups | `add-group-member <group> <member>` | Add member to group |
+| Groups | `remove-group-member <group> <member>` | Remove member |
+| Groups | `test-group <group> [member]` | Test group membership |
+| Schemas | `create-schema <file>` | Create schema from file |
+| Schemas | `list-schemas` | List owned schemas |
+| Schemas | `get-schema <did>` | Get schema by DID |
+| Schemas | `create-schema-template <schema>` | Generate template |
+| Assets | `create-asset` | Create empty asset |
+| Assets | `create-asset-json <file>` | Create from JSON file |
+| Assets | `create-asset-image <file>` | Create from image |
+| Assets | `create-asset-file <file>` | Create from file |
+| Assets | `get-asset <id>` | Get asset by ID |
+| Assets | `update-asset-json <id> <file>` | Update with JSON |
+| Assets | `update-asset-image <id> <file>` | Update with image |
+| Assets | `update-asset-file <id> <file>` | Update with file |
+| Assets | `transfer-asset <id> <controller>` | Transfer ownership |
+| Assets | `clone-asset <id>` | Clone an asset |
+| Assets | `set-property <id> <key> [value]` | Set asset property |
+| Assets | `list-assets` | List owned assets |
+| Polls | `create-poll-template` | Create poll template |
+| Polls | `create-poll <file>` | Create poll from file |
+| Polls | `view-poll <poll>` | View poll details |
+| Polls | `vote-poll <poll> <vote>` | Vote in poll |
+| Polls | `update-poll <ballot>` | Add ballot to poll |
+| Polls | `publish-poll <poll>` | Publish results (hidden) |
+| Polls | `reveal-poll <poll>` | Publish results (revealed) |
+| Polls | `unpublish-poll <poll>` | Remove results |
+| Vaults | `create-vault` | Create a vault |
+| Vaults | `list-vault-items <id>` | List vault items |
+| Vaults | `add-vault-member <id> <member>` | Add vault member |
+| Vaults | `remove-vault-member <id> <member>` | Remove member |
+| Vaults | `list-vault-members <id>` | List members |
+| Vaults | `add-vault-item <id> <file>` | Add file to vault |
+| Vaults | `remove-vault-item <id> <item>` | Remove item |
+| Vaults | `get-vault-item <id> <item> <file>` | Download item |
+| Lightning | `add-lightning [id]` | Create a Lightning wallet for a DID |
+| Lightning | `remove-lightning [id]` | Remove Lightning wallet from a DID |
+| Lightning | `lightning-balance [id]` | Check Lightning wallet balance |
+| Lightning | `lightning-invoice <amount> <memo> [id]` | Create invoice to receive sats |
+| Lightning | `lightning-pay <bolt11> [id]` | Pay a Lightning invoice |
+| Lightning | `lightning-check <hash> [id]` | Check status of a payment |
+| Lightning | `lightning-decode <bolt11>` | Decode a BOLT11 invoice |
+| Lightning | `lightning-zap <recipient> <amount> [memo]` | Send sats to a DID, alias, or Lightning Address |
+| Lightning | `lightning-payments [id]` | Show payment history |
+| Lightning | `publish-lightning [id]` | Publish Lightning service endpoint for a DID |
+| Lightning | `unpublish-lightning [id]` | Remove Lightning service endpoint from a DID |
 
 #### Command Options
 

package/dist/cjs/keymaster-client.cjs

@@ -78,6 +78,15 @@ class KeymasterClient {
             console.log('Keymaster service is ready!');
         }
     }
+    async getVersion() {
+        try {
+            const response = await this.axios.get(`${this.API}/version`);
+            return response.data;
+        }
+        catch (error) {
+            throwError(error);
+        }
+    }
     async isReady() {
         try {
             const response = await this.axios.get(`${this.API}/ready`);
@@ -276,6 +285,15 @@ class KeymasterClient {
             throwError(error);
         }
     }
+    async changeRegistry(id, registry) {
+        try {
+            const response = await this.axios.post(`${this.API}/ids/${id}/change-registry`, { registry });
+            return response.data.ok;
+        }
+        catch (error) {
+            throwError(error);
+        }
+    }
     async backupId(id) {
         try {
             if (!id) {
@@ -460,6 +478,15 @@ class KeymasterClient {
             throwError(error);
         }
     }
+    async getLightningPayments(name) {
+        try {
+            const response = await this.axios.post(`${this.API}/lightning/payments`, { id: name });
+            return response.data.payments;
+        }
+        catch (error) {
+            throwError(error);
+        }
+    }
     async resolveDID(id, options) {
         try {
             if (options) {
@@ -1015,7 +1042,7 @@ class KeymasterClient {
             const response = await this.axios.post(`${this.API}/files`, data, {
                 headers: {
                     'Content-Type': 'application/octet-stream',
-                    'X-Options': JSON.stringify(options), // Pass options as a custom header
+                    'X-Options': JSON.stringify(options),
                 }
             });
             return response.data.did;
@@ -1024,12 +1051,28 @@ class KeymasterClient {
             throwError(error);
         }
     }
+    async createFileStream(stream, options = {}) {
+        try {
+            const response = await this.axios.post(`${this.API}/files`, stream, {
+                headers: {
+                    'Content-Type': 'application/octet-stream',
+                    'X-Options': JSON.stringify(options),
+                },
+                maxBodyLength: Infinity,
+                maxContentLength: Infinity,
+            });
+            return response.data.did;
+        }
+        catch (error) {
+            throwError(error);
+        }
+    }
     async updateFile(id, data, options = {}) {
         try {
             const response = await this.axios.put(`${this.API}/files/${id}`, data, {
                 headers: {
                     'Content-Type': 'application/octet-stream',
-                    'X-Options': JSON.stringify(options), // Pass options as a custom header
+                    'X-Options': JSON.stringify(options),
                 }
             });
             return response.data.ok;
@@ -1038,6 +1081,22 @@ class KeymasterClient {
             throwError(error);
         }
     }
+    async updateFileStream(id, stream, options = {}) {
+        try {
+            const response = await this.axios.put(`${this.API}/files/${id}`, stream, {
+                headers: {
+                    'Content-Type': 'application/octet-stream',
+                    'X-Options': JSON.stringify(options),
+                },
+                maxBodyLength: Infinity,
+                maxContentLength: Infinity,
+            });
+            return response.data.ok;
+        }
+        catch (error) {
+            throwError(error);
+        }
+    }
     async getFile(id) {
         try {
             const response = await this.axios.get(`${this.API}/files/${id}`);

package/dist/cjs/keymaster.cjs

@@ -3361,6 +3361,24 @@ class Keymaster {
         const file = await this.generateFileAsset(filename, buffer);
         return this.mergeData(id, { file });
     }
+    async generateFileAssetFromStream(filename, stream, contentType, bytes) {
+        const cid = await this.gatekeeper.addDataStream(stream);
+        return { cid, filename, type: contentType, bytes };
+    }
+    async createFileStream(stream, options = {}) {
+        const filename = options.filename || 'file';
+        const contentType = options.contentType || 'application/octet-stream';
+        const bytes = options.bytes || 0;
+        const file = await this.generateFileAssetFromStream(filename, stream, contentType, bytes);
+        return this.createAsset({ file }, options);
+    }
+    async updateFileStream(id, stream, options = {}) {
+        const filename = options.filename || 'file';
+        const contentType = options.contentType || 'application/octet-stream';
+        const bytes = options.bytes || 0;
+        const file = await this.generateFileAssetFromStream(filename, stream, contentType, bytes);
+        return this.mergeData(id, { file });
+    }
     async getFile(id) {
         const asset = await this.resolveAsset(id);
         const file = asset.file;
@@ -3565,6 +3583,23 @@ class Keymaster {
         }
         return ok;
     }
+    async changeRegistry(id, registry) {
+        if (!registry) {
+            throw new InvalidParameterError('registry');
+        }
+        const did = await this.lookupDID(id);
+        const current = await this.resolveDID(did);
+        const currentRegistry = current.didDocumentRegistration?.registry;
+        if (registry === currentRegistry) {
+            return true;
+        }
+        return this.updateDID(did, {
+            didDocumentRegistration: {
+                ...current.didDocumentRegistration,
+                registry,
+            },
+        });
+    }
     async addToOwned(did, owner) {
         await this.mutateWallet(async (wallet) => {
             const id = await this.fetchIdInfo(owner, wallet);
@@ -4182,16 +4217,29 @@ class Keymaster {
         return true;
     }
     async zapLightning(id, amount, memo, name) {
-        const did = await this.lookupDID(id);
-        if (!did) {
-            throw new InvalidParameterError('did');
+        const isLud16 = id.includes('@') && !id.startsWith('did:');
+        let recipient;
+        if (isLud16) {
+            recipient = id;
+        }
+        else {
+            const did = await this.lookupDID(id);
+            if (!did) {
+                throw new InvalidParameterError('did');
+            }
+            recipient = did;
         }
         if (!amount || amount <= 0) {
             throw new InvalidParameterError('amount');
         }
         const drawbridge = this.requireDrawbridge();
         const config = await this.getLightningConfig(name);
-        return drawbridge.zapLightning(config.adminKey, did, amount, memo);
+        return drawbridge.zapLightning(config.adminKey, recipient, amount, memo);
+    }
+    async getLightningPayments(name) {
+        const drawbridge = this.requireDrawbridge();
+        const config = await this.getLightningConfig(name);
+        return drawbridge.getLightningPayments(config.adminKey);
     }
     async testAgent(id) {
         const doc = await this.resolveDID(id);

package/dist/esm/cli.js

@@ -335,6 +335,18 @@ program
         console.error(`cannot revoke ${did}`);
     }
 });
+program
+    .command('change-registry <id> <registry>')
+    .description('Changes the registry for an existing DID')
+    .action(async (id, registry) => {
+    try {
+        const ok = await keymaster.changeRegistry(id, registry);
+        console.log(ok ? UPDATE_OK : UPDATE_FAILED);
+    }
+    catch (error) {
+        console.error(error.error || error.message || error);
+    }
+});
 // Encryption commands
 program
     .command('encrypt-message <message> <did>')
@@ -836,17 +848,40 @@ program
     }
 });
 program
-    .command('lightning-zap <did> <amount> [memo]')
-    .description('Send sats to a DID via Lightning')
-    .action(async (did, amount, memo) => {
+    .command('lightning-zap <recipient> <amount> [memo]')
+    .description('Send sats via Lightning (DID, alias, or Lightning Address)')
+    .action(async (recipient, amount, memo) => {
     try {
-        const result = await keymaster.zapLightning(did, parseInt(amount), memo);
+        const result = await keymaster.zapLightning(recipient, parseInt(amount), memo);
         console.log(JSON.stringify(result, null, 4));
     }
     catch (error) {
         console.error(error.error || error.message || error);
     }
 });
+program
+    .command('lightning-payments [id]')
+    .description('Show Lightning payment history')
+    .action(async (id) => {
+    try {
+        const payments = await keymaster.getLightningPayments(id);
+        if (payments.length === 0) {
+            console.log('No payments found.');
+            return;
+        }
+        for (const p of payments) {
+            const d = p.time ? new Date(p.time) : null;
+            const date = d ? `${d.getFullYear()}/${String(d.getMonth() + 1).padStart(2, '0')}/${String(d.getDate()).padStart(2, '0')} ${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}:${String(d.getSeconds()).padStart(2, '0')}` : '—';
+            const fee = p.fee > 0 ? ` (fee: ${p.fee})` : '';
+            const memo = p.memo ? ` "${p.memo}"` : '';
+            const status = p.pending ? ' [pending]' : '';
+            console.log(`${date}  ${p.amount} sats${fee}${memo}${status}`);
+        }
+    }
+    catch (error) {
+        console.error(error.error || error.message || error);
+    }
+});
 // Group commands
 program
     .command('create-group <groupName>')
@@ -1033,9 +1068,10 @@ program
     .action(async (file, options) => {
     try {
         const { alias, registry } = options;
-        const data = fs.readFileSync(file);
         const filename = path.basename(file);
-        const did = await keymaster.createFile(data, { filename, alias, registry });
+        const bytes = fs.statSync(file).size;
+        const stream = fs.createReadStream(file);
+        const did = await keymaster.createFileStream(stream, { filename, alias, registry, bytes });
         console.log(did);
     }
     catch (error) {
@@ -1135,9 +1171,10 @@ program
     .description('Update an asset from a file')
     .action(async (id, file) => {
     try {
-        const data = fs.readFileSync(file);
         const filename = path.basename(file);
-        const ok = await keymaster.updateFile(id, data, { filename });
+        const bytes = fs.statSync(file).size;
+        const stream = fs.createReadStream(file);
+        const ok = await keymaster.updateFileStream(id, stream, { filename, bytes });
         console.log(ok ? UPDATE_OK : UPDATE_FAILED);
     }
     catch (error) {