@bitgo-beta/sdk-coin-kaspa 0.0.1-beta.21 → 0.0.1-beta.210

package/dist/src/lib/keyPair.d.ts

@@ -1,4 +1,5 @@
 import { DefaultKeys, KeyPairOptions, Secp256k1ExtendedKeyPair } from '@bitgo-beta/sdk-core';
+import { KaspaAddressType } from './constants';
 export declare class KeyPair extends Secp256k1ExtendedKeyPair {
     /**
      * Public constructor. By default, creates a key pair with a random master seed.
@@ -15,8 +16,11 @@ export declare class KeyPair extends Secp256k1ExtendedKeyPair {
     /**
      * Get a Kaspa address from this key pair.
      *
-     * @returns {string} The bech32-encoded Kaspa address
+     * @param network - 'mainnet' or 'testnet' (default: 'mainnet')
+     * @param type    - address type (default: SCHNORR / v0 for hot-wallet;
+     *                  use KaspaAddressType.ECDSA / v1 for MPC/DKLS wallets)
+     * @returns bech32-encoded Kaspa address
      */
-    getAddress(network?: string): string;
+    getAddress(network?: string, type?: KaspaAddressType): string;
 }
 //# sourceMappingURL=keyPair.d.ts.map

package/dist/src/lib/keyPair.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyPair.d.ts","sourceRoot":"","sources":["../../../src/lib/keyPair.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAIX,cAAc,EACd,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAQ9B,qBAAa,OAAQ,SAAQ,wBAAwB;IACnD;;;;OAIG;gBACS,MAAM,CAAC,EAAE,cAAc;IAoBnC;;;;OAIG;IACH,OAAO,IAAI,WAAW;IAOtB;;;;OAIG;IACH,UAAU,CAAC,OAAO,SAAY,GAAG,MAAM;CAKxC"}
+{"version":3,"file":"keyPair.d.ts","sourceRoot":"","sources":["../../../src/lib/keyPair.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAIX,cAAc,EACd,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAkC,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAI/E,qBAAa,OAAQ,SAAQ,wBAAwB;IACnD;;;;OAIG;gBACS,MAAM,CAAC,EAAE,cAAc;IAoBnC;;;;OAIG;IACH,OAAO,IAAI,WAAW;IAOtB;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,SAAY,EAAE,IAAI,GAAE,gBAA2C,GAAG,MAAM;CAK3F"}

package/dist/src/lib/keyPair.js

@@ -49,13 +49,16 @@ class KeyPair extends sdk_core_1.Secp256k1ExtendedKeyPair {
     /**
      * Get a Kaspa address from this key pair.
      *
-     * @returns {string} The bech32-encoded Kaspa address
+     * @param network - 'mainnet' or 'testnet' (default: 'mainnet')
+     * @param type    - address type (default: SCHNORR / v0 for hot-wallet;
+     *                  use KaspaAddressType.ECDSA / v1 for MPC/DKLS wallets)
+     * @returns bech32-encoded Kaspa address
      */
-    getAddress(network = 'mainnet') {
+    getAddress(network = 'mainnet', type = constants_1.KaspaAddressType.SCHNORR) {
         const hrp = network === 'testnet' ? constants_1.TESTNET_PREFIX : constants_1.MAINNET_PREFIX;
         const compressedPub = this.getPublicKey({ compressed: true });
-        return (0, utils_1.pubKeyToKaspaAddress)(compressedPub, hrp);
+        return (0, utils_1.pubKeyToKaspaAddress)(compressedPub, hrp, type);
     }
 }
 exports.KeyPair = KeyPair;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoia2V5UGFpci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIva2V5UGFpci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxtREFPOEI7QUFDOUIscURBQThDO0FBQzlDLG1DQUFxQztBQUNyQyxtQ0FBK0M7QUFDL0MsMkNBQTZEO0FBRTdELE1BQU0sdUJBQXVCLEdBQUcsRUFBRSxDQUFDO0FBRW5DLE1BQWEsT0FBUSxTQUFRLG1DQUF3QjtJQUNuRDs7OztPQUlHO0lBQ0gsWUFBWSxNQUF1QjtRQUNqQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDZCxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDWixNQUFNLElBQUksR0FBRyxJQUFBLG9CQUFXLEVBQUMsdUJBQXVCLENBQUMsQ0FBQztZQUNsRCxJQUFJLENBQUMsTUFBTSxHQUFHLGlCQUFLLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ3JDLENBQUM7YUFBTSxJQUFJLElBQUEsaUJBQU0sRUFBQyxNQUFNLENBQUMsRUFBRSxDQUFDO1lBQzFCLElBQUksQ0FBQyxNQUFNLEdBQUcsaUJBQUssQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQzVDLENBQUM7YUFBTSxJQUFJLElBQUEsdUJBQVksRUFBQyxNQUFNLENBQUMsRUFBRSxDQUFDO1lBQ2hDLElBQUksQ0FBQyx3QkFBd0IsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDNUMsQ0FBQzthQUFNLElBQUksSUFBQSxzQkFBVyxFQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7WUFDL0IsSUFBSSxDQUFDLHVCQUF1QixDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUMzQyxDQUFDO2FBQU0sQ0FBQztZQUNOLE1BQU0sSUFBSSxLQUFLLENBQUMsMEJBQTBCLENBQUMsQ0FBQztRQUM5QyxDQUFDO1FBRUQsSUFBSSxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDaEIsSUFBSSxDQUFDLE9BQU8sR0FBRyxtQ0FBd0IsQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO1FBQ2pFLENBQUM7SUFDSCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILE9BQU87UUFDTCxPQUFPO1lBQ0wsR0FBRyxFQUFFLElBQUksQ0FBQyxZQUFZLENBQUMsRUFBRSxVQUFVLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDO1lBQzVELEdBQUcsRUFBRSxJQUFJLENBQUMsYUFBYSxFQUFFLEVBQUUsUUFBUSxDQUFDLEtBQUssQ0FBQztTQUMzQyxDQUFDO0lBQ0osQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxVQUFVLENBQUMsT0FBTyxHQUFHLFNBQVM7UUFDNUIsTUFBTSxHQUFHLEdBQUcsT0FBTyxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUMsMEJBQWMsQ0FBQyxDQUFDLENBQUMsMEJBQWMsQ0FBQztRQUNwRSxNQUFNLGFBQWEsR0FBRyxJQUFJLENBQUMsWUFBWSxDQUFDLEVBQUUsVUFBVSxFQUFFLElBQUksRUFBRSxDQUFDLENBQUM7UUFDOUQsT0FBTyxJQUFBLDRCQUFvQixFQUFDLGFBQWEsRUFBRSxHQUFHLENBQUMsQ0FBQztJQUNsRCxDQUFDO0NBQ0Y7QUFoREQsMEJBZ0RDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHtcbiAgRGVmYXVsdEtleXMsXG4gIGlzUHJpdmF0ZUtleSxcbiAgaXNQdWJsaWNLZXksXG4gIGlzU2VlZCxcbiAgS2V5UGFpck9wdGlvbnMsXG4gIFNlY3AyNTZrMUV4dGVuZGVkS2V5UGFpcixcbn0gZnJvbSAnQGJpdGdvLWJldGEvc2RrLWNvcmUnO1xuaW1wb3J0IHsgYmlwMzIgfSBmcm9tICdAYml0Z28tYmV0YS9zZWNwMjU2azEnO1xuaW1wb3J0IHsgcmFuZG9tQnl0ZXMgfSBmcm9tICdjcnlwdG8nO1xuaW1wb3J0IHsgcHViS2V5VG9LYXNwYUFkZHJlc3MgfSBmcm9tICcuL3V0aWxzJztcbmltcG9ydCB7IE1BSU5ORVRfUFJFRklYLCBURVNUTkVUX1BSRUZJWCB9IGZyb20gJy4vY29uc3RhbnRzJztcblxuY29uc3QgREVGQVVMVF9TRUVEX1NJWkVfQllURVMgPSAxNjtcblxuZXhwb3J0IGNsYXNzIEtleVBhaXIgZXh0ZW5kcyBTZWNwMjU2azFFeHRlbmRlZEtleVBhaXIge1xuICAvKipcbiAgICogUHVibGljIGNvbnN0cnVjdG9yLiBCeSBkZWZhdWx0LCBjcmVhdGVzIGEga2V5IHBhaXIgd2l0aCBhIHJhbmRvbSBtYXN0ZXIgc2VlZC5cbiAgICpcbiAgICogQHBhcmFtIHsgS2V5UGFpck9wdGlvbnMgfSBzb3VyY2UgRWl0aGVyIGEgbWFzdGVyIHNlZWQsIGEgcHJpdmF0ZSBrZXksIG9yIGEgcHVibGljIGtleVxuICAgKi9cbiAgY29uc3RydWN0b3Ioc291cmNlPzogS2V5UGFpck9wdGlvbnMpIHtcbiAgICBzdXBlcihzb3VyY2UpO1xuICAgIGlmICghc291cmNlKSB7XG4gICAgICBjb25zdCBzZWVkID0gcmFuZG9tQnl0ZXMoREVGQVVMVF9TRUVEX1NJWkVfQllURVMpO1xuICAgICAgdGhpcy5oZE5vZGUgPSBiaXAzMi5mcm9tU2VlZChzZWVkKTtcbiAgICB9IGVsc2UgaWYgKGlzU2VlZChzb3VyY2UpKSB7XG4gICAgICB0aGlzLmhkTm9kZSA9IGJpcDMyLmZyb21TZWVkKHNvdXJjZS5zZWVkKTtcbiAgICB9IGVsc2UgaWYgKGlzUHJpdmF0ZUtleShzb3VyY2UpKSB7XG4gICAgICB0aGlzLnJlY29yZEtleXNGcm9tUHJpdmF0ZUtleShzb3VyY2UucHJ2KTtcbiAgICB9IGVsc2UgaWYgKGlzUHVibGljS2V5KHNvdXJjZSkpIHtcbiAgICAgIHRoaXMucmVjb3JkS2V5c0Zyb21QdWJsaWNLZXkoc291cmNlLnB1Yik7XG4gICAgfSBlbHNlIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcignSW52YWxpZCBrZXkgcGFpciBvcHRpb25zJyk7XG4gICAgfVxuXG4gICAgaWYgKHRoaXMuaGROb2RlKSB7XG4gICAgICB0aGlzLmtleVBhaXIgPSBTZWNwMjU2azFFeHRlbmRlZEtleVBhaXIudG9LZXlQYWlyKHRoaXMuaGROb2RlKTtcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogRGVmYXVsdCBrZXlzIGZvcm1hdCBpcyBhIHBhaXIgb2YgaGV4IGtleXMuXG4gICAqXG4gICAqIEByZXR1cm5zIHsgRGVmYXVsdEtleXMgfSBUaGUga2V5cyBpbiB0aGUgZGVmaW5lZCBmb3JtYXRcbiAgICovXG4gIGdldEtleXMoKTogRGVmYXVsdEtleXMge1xuICAgIHJldHVybiB7XG4gICAgICBwdWI6IHRoaXMuZ2V0UHVibGljS2V5KHsgY29tcHJlc3NlZDogdHJ1ZSB9KS50b1N0cmluZygnaGV4JyksXG4gICAgICBwcnY6IHRoaXMuZ2V0UHJpdmF0ZUtleSgpPy50b1N0cmluZygnaGV4JyksXG4gICAgfTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXQgYSBLYXNwYSBhZGRyZXNzIGZyb20gdGhpcyBrZXkgcGFpci5cbiAgICpcbiAgICogQHJldHVybnMge3N0cmluZ30gVGhlIGJlY2gzMi1lbmNvZGVkIEthc3BhIGFkZHJlc3NcbiAgICovXG4gIGdldEFkZHJlc3MobmV0d29yayA9ICdtYWlubmV0Jyk6IHN0cmluZyB7XG4gICAgY29uc3QgaHJwID0gbmV0d29yayA9PT0gJ3Rlc3RuZXQnID8gVEVTVE5FVF9QUkVGSVggOiBNQUlOTkVUX1BSRUZJWDtcbiAgICBjb25zdCBjb21wcmVzc2VkUHViID0gdGhpcy5nZXRQdWJsaWNLZXkoeyBjb21wcmVzc2VkOiB0cnVlIH0pO1xuICAgIHJldHVybiBwdWJLZXlUb0thc3BhQWRkcmVzcyhjb21wcmVzc2VkUHViLCBocnApO1xuICB9XG59XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoia2V5UGFpci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIva2V5UGFpci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxtREFPOEI7QUFDOUIscURBQThDO0FBQzlDLG1DQUFxQztBQUNyQyxtQ0FBK0M7QUFDL0MsMkNBQStFO0FBRS9FLE1BQU0sdUJBQXVCLEdBQUcsRUFBRSxDQUFDO0FBRW5DLE1BQWEsT0FBUSxTQUFRLG1DQUF3QjtJQUNuRDs7OztPQUlHO0lBQ0gsWUFBWSxNQUF1QjtRQUNqQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDZCxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDWixNQUFNLElBQUksR0FBRyxJQUFBLG9CQUFXLEVBQUMsdUJBQXVCLENBQUMsQ0FBQztZQUNsRCxJQUFJLENBQUMsTUFBTSxHQUFHLGlCQUFLLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ3JDLENBQUM7YUFBTSxJQUFJLElBQUEsaUJBQU0sRUFBQyxNQUFNLENBQUMsRUFBRSxDQUFDO1lBQzFCLElBQUksQ0FBQyxNQUFNLEdBQUcsaUJBQUssQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQzVDLENBQUM7YUFBTSxJQUFJLElBQUEsdUJBQVksRUFBQyxNQUFNLENBQUMsRUFBRSxDQUFDO1lBQ2hDLElBQUksQ0FBQyx3QkFBd0IsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDNUMsQ0FBQzthQUFNLElBQUksSUFBQSxzQkFBVyxFQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7WUFDL0IsSUFBSSxDQUFDLHVCQUF1QixDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUMzQyxDQUFDO2FBQU0sQ0FBQztZQUNOLE1BQU0sSUFBSSxLQUFLLENBQUMsMEJBQTBCLENBQUMsQ0FBQztRQUM5QyxDQUFDO1FBRUQsSUFBSSxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDaEIsSUFBSSxDQUFDLE9BQU8sR0FBRyxtQ0FBd0IsQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO1FBQ2pFLENBQUM7SUFDSCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILE9BQU87UUFDTCxPQUFPO1lBQ0wsR0FBRyxFQUFFLElBQUksQ0FBQyxZQUFZLENBQUMsRUFBRSxVQUFVLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDO1lBQzVELEdBQUcsRUFBRSxJQUFJLENBQUMsYUFBYSxFQUFFLEVBQUUsUUFBUSxDQUFDLEtBQUssQ0FBQztTQUMzQyxDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7O09BT0c7SUFDSCxVQUFVLENBQUMsT0FBTyxHQUFHLFNBQVMsRUFBRSxPQUF5Qiw0QkFBZ0IsQ0FBQyxPQUFPO1FBQy9FLE1BQU0sR0FBRyxHQUFHLE9BQU8sS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLDBCQUFjLENBQUMsQ0FBQyxDQUFDLDBCQUFjLENBQUM7UUFDcEUsTUFBTSxhQUFhLEdBQUcsSUFBSSxDQUFDLFlBQVksQ0FBQyxFQUFFLFVBQVUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO1FBQzlELE9BQU8sSUFBQSw0QkFBb0IsRUFBQyxhQUFhLEVBQUUsR0FBRyxFQUFFLElBQUksQ0FBQyxDQUFDO0lBQ3hELENBQUM7Q0FDRjtBQW5ERCwwQkFtREMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQge1xuICBEZWZhdWx0S2V5cyxcbiAgaXNQcml2YXRlS2V5LFxuICBpc1B1YmxpY0tleSxcbiAgaXNTZWVkLFxuICBLZXlQYWlyT3B0aW9ucyxcbiAgU2VjcDI1NmsxRXh0ZW5kZWRLZXlQYWlyLFxufSBmcm9tICdAYml0Z28tYmV0YS9zZGstY29yZSc7XG5pbXBvcnQgeyBiaXAzMiB9IGZyb20gJ0BiaXRnby1iZXRhL3NlY3AyNTZrMSc7XG5pbXBvcnQgeyByYW5kb21CeXRlcyB9IGZyb20gJ2NyeXB0byc7XG5pbXBvcnQgeyBwdWJLZXlUb0thc3BhQWRkcmVzcyB9IGZyb20gJy4vdXRpbHMnO1xuaW1wb3J0IHsgTUFJTk5FVF9QUkVGSVgsIFRFU1RORVRfUFJFRklYLCBLYXNwYUFkZHJlc3NUeXBlIH0gZnJvbSAnLi9jb25zdGFudHMnO1xuXG5jb25zdCBERUZBVUxUX1NFRURfU0laRV9CWVRFUyA9IDE2O1xuXG5leHBvcnQgY2xhc3MgS2V5UGFpciBleHRlbmRzIFNlY3AyNTZrMUV4dGVuZGVkS2V5UGFpciB7XG4gIC8qKlxuICAgKiBQdWJsaWMgY29uc3RydWN0b3IuIEJ5IGRlZmF1bHQsIGNyZWF0ZXMgYSBrZXkgcGFpciB3aXRoIGEgcmFuZG9tIG1hc3RlciBzZWVkLlxuICAgKlxuICAgKiBAcGFyYW0geyBLZXlQYWlyT3B0aW9ucyB9IHNvdXJjZSBFaXRoZXIgYSBtYXN0ZXIgc2VlZCwgYSBwcml2YXRlIGtleSwgb3IgYSBwdWJsaWMga2V5XG4gICAqL1xuICBjb25zdHJ1Y3Rvcihzb3VyY2U/OiBLZXlQYWlyT3B0aW9ucykge1xuICAgIHN1cGVyKHNvdXJjZSk7XG4gICAgaWYgKCFzb3VyY2UpIHtcbiAgICAgIGNvbnN0IHNlZWQgPSByYW5kb21CeXRlcyhERUZBVUxUX1NFRURfU0laRV9CWVRFUyk7XG4gICAgICB0aGlzLmhkTm9kZSA9IGJpcDMyLmZyb21TZWVkKHNlZWQpO1xuICAgIH0gZWxzZSBpZiAoaXNTZWVkKHNvdXJjZSkpIHtcbiAgICAgIHRoaXMuaGROb2RlID0gYmlwMzIuZnJvbVNlZWQoc291cmNlLnNlZWQpO1xuICAgIH0gZWxzZSBpZiAoaXNQcml2YXRlS2V5KHNvdXJjZSkpIHtcbiAgICAgIHRoaXMucmVjb3JkS2V5c0Zyb21Qcml2YXRlS2V5KHNvdXJjZS5wcnYpO1xuICAgIH0gZWxzZSBpZiAoaXNQdWJsaWNLZXkoc291cmNlKSkge1xuICAgICAgdGhpcy5yZWNvcmRLZXlzRnJvbVB1YmxpY0tleShzb3VyY2UucHViKTtcbiAgICB9IGVsc2Uge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKCdJbnZhbGlkIGtleSBwYWlyIG9wdGlvbnMnKTtcbiAgICB9XG5cbiAgICBpZiAodGhpcy5oZE5vZGUpIHtcbiAgICAgIHRoaXMua2V5UGFpciA9IFNlY3AyNTZrMUV4dGVuZGVkS2V5UGFpci50b0tleVBhaXIodGhpcy5oZE5vZGUpO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBEZWZhdWx0IGtleXMgZm9ybWF0IGlzIGEgcGFpciBvZiBoZXgga2V5cy5cbiAgICpcbiAgICogQHJldHVybnMgeyBEZWZhdWx0S2V5cyB9IFRoZSBrZXlzIGluIHRoZSBkZWZpbmVkIGZvcm1hdFxuICAgKi9cbiAgZ2V0S2V5cygpOiBEZWZhdWx0S2V5cyB7XG4gICAgcmV0dXJuIHtcbiAgICAgIHB1YjogdGhpcy5nZXRQdWJsaWNLZXkoeyBjb21wcmVzc2VkOiB0cnVlIH0pLnRvU3RyaW5nKCdoZXgnKSxcbiAgICAgIHBydjogdGhpcy5nZXRQcml2YXRlS2V5KCk/LnRvU3RyaW5nKCdoZXgnKSxcbiAgICB9O1xuICB9XG5cbiAgLyoqXG4gICAqIEdldCBhIEthc3BhIGFkZHJlc3MgZnJvbSB0aGlzIGtleSBwYWlyLlxuICAgKlxuICAgKiBAcGFyYW0gbmV0d29yayAtICdtYWlubmV0JyBvciAndGVzdG5ldCcgKGRlZmF1bHQ6ICdtYWlubmV0JylcbiAgICogQHBhcmFtIHR5cGUgICAgLSBhZGRyZXNzIHR5cGUgKGRlZmF1bHQ6IFNDSE5PUlIgLyB2MCBmb3IgaG90LXdhbGxldDtcbiAgICogICAgICAgICAgICAgICAgICB1c2UgS2FzcGFBZGRyZXNzVHlwZS5FQ0RTQSAvIHYxIGZvciBNUEMvREtMUyB3YWxsZXRzKVxuICAgKiBAcmV0dXJucyBiZWNoMzItZW5jb2RlZCBLYXNwYSBhZGRyZXNzXG4gICAqL1xuICBnZXRBZGRyZXNzKG5ldHdvcmsgPSAnbWFpbm5ldCcsIHR5cGU6IEthc3BhQWRkcmVzc1R5cGUgPSBLYXNwYUFkZHJlc3NUeXBlLlNDSE5PUlIpOiBzdHJpbmcge1xuICAgIGNvbnN0IGhycCA9IG5ldHdvcmsgPT09ICd0ZXN0bmV0JyA/IFRFU1RORVRfUFJFRklYIDogTUFJTk5FVF9QUkVGSVg7XG4gICAgY29uc3QgY29tcHJlc3NlZFB1YiA9IHRoaXMuZ2V0UHVibGljS2V5KHsgY29tcHJlc3NlZDogdHJ1ZSB9KTtcbiAgICByZXR1cm4gcHViS2V5VG9LYXNwYUFkZHJlc3MoY29tcHJlc3NlZFB1YiwgaHJwLCB0eXBlKTtcbiAgfVxufVxuIl19

package/dist/src/lib/pskt.d.ts

@@ -0,0 +1,257 @@
+/**
+ * PSKT — Partially Signed Kaspa Transaction
+ *
+ * Kaspa's native analogue of Bitcoin's PSBT (BIP-174), implemented in
+ * TypeScript with zero external dependencies. Wire format is plain camelCase
+ * JSON, matching the serde serialisation of rusty-kaspa's wallet/pskt crate.
+ *
+ * Reference: https://github.com/kaspanet/rusty-kaspa/tree/master/wallet/pskt
+ *
+ * Role state machine:
+ *   CREATOR → UPDATER → SIGNER ─┬→ COMBINER → FINALIZER → EXTRACTOR
+ *                                └──────────→ FINALIZER → EXTRACTOR
+ *
+ * Key difference from the current JSON-hex flow:
+ *   Signatures are stored in `partialSigs` per input until the FINALIZER
+ *   role promotes them into the push-only `finalScriptSig`. This lets an
+ *   external HSM or a second party receive the serialised PSKT, call
+ *   `addSignature()`, and return it — identical to how PSBT works for BTC.
+ */
+import { KaspaTransactionData } from './iface';
+export type PsktRole = 'CREATOR' | 'UPDATER' | 'SIGNER' | 'COMBINER' | 'FINALIZER' | 'EXTRACTOR';
+export interface PsktKeySource {
+    /** 4-byte master fingerprint, hex-encoded */
+    keyFingerprint: string;
+    /** BIP-32 derivation path string, e.g. "m/44'/111111'/0'/0/0" */
+    derivationPath: string;
+}
+export interface PsktGlobal {
+    /** PSKT version (0 = no payload, 1 = payload allowed) */
+    version: 0 | 1;
+    /** Kaspa transaction version (currently 0) */
+    txVersion: number;
+    /** Fallback lock time (block or timestamp), as decimal string for JSON safety */
+    fallbackLockTime?: string;
+    /** Whether inputs can still be added */
+    inputsModifiable: boolean;
+    /** Whether outputs can still be added */
+    outputsModifiable: boolean;
+    /** Number of inputs in this PSKT */
+    inputCount: number;
+    /** Number of outputs in this PSKT */
+    outputCount: number;
+    /** Extended public keys and their derivation info */
+    xpubs: Record<string, PsktKeySource>;
+    /** Transaction ID once known */
+    id?: string;
+    /** Proprietary key-value pairs */
+    proprietaries: Record<string, unknown>;
+    /** Hex-encoded transaction payload (requires version >= 1) */
+    payload?: string;
+}
+export interface PsktUtxoEntry {
+    /** Amount in sompi (decimal string for JSON bigint safety) */
+    amount: string;
+    /** Hex-encoded scriptPublicKey bytes */
+    scriptPublicKey: string;
+    blockDaaScore?: string;
+    isCoinbase?: boolean;
+}
+export interface PsktInput {
+    /** The outpoint being spent */
+    previousOutpoint: {
+        transactionId: string;
+        index: number;
+    };
+    /**
+     * UTXO data required for sighash computation.
+     * Must be present before signing.
+     */
+    utxoEntry?: PsktUtxoEntry;
+    /** Sequence number (u64 as decimal string; absent = u64::MAX / finality) */
+    sequence?: string;
+    /**
+     * Partial Schnorr signatures collected so far.
+     * Key: 33-byte compressed secp256k1 pubKey hex.
+     * Value: 64-byte raw Schnorr signature hex.
+     */
+    partialSigs: Record<string, string>;
+    /** SigHash type for this input (default: SIGHASH_ALL = 0x01) */
+    sighashType: number;
+    /** Signature operation count */
+    sigOpCount?: number;
+    /**
+     * Finalized scriptSig (set by the FINALIZER role).
+     * Layout: 0x41 (OP_DATA_65) + 64-byte sig + 1-byte sighash type = 66 bytes hex.
+     */
+    finalScriptSig?: string;
+    /** BIP-32 derivation info for keys used in this input */
+    bip32Derivations: Record<string, PsktKeySource>;
+    /** Proprietary key-value pairs */
+    proprietaries: Record<string, unknown>;
+}
+export interface PsktOutput {
+    /** Amount in sompi (decimal string for JSON bigint safety) */
+    amount: string;
+    /** Script public key */
+    scriptPublicKey: {
+        version: number;
+        scriptPublicKey: string;
+    };
+    /** BIP-32 derivation info for keys used in this output */
+    bip32Derivations: Record<string, PsktKeySource>;
+    /** Proprietary key-value pairs */
+    proprietaries: Record<string, unknown>;
+}
+/** Wire format — what `serialize()` produces and `deserialize()` consumes. */
+export interface SerializedPskt {
+    role: PsktRole;
+    global: PsktGlobal;
+    inputs: PsktInput[];
+    outputs: PsktOutput[];
+}
+/**
+ * PSKT (Partially Signed Kaspa Transaction).
+ *
+ * Mirrors the role-based workflow of Bitcoin's PSBT but uses Kaspa's wire
+ * format (camelCase JSON), Blake2b sighash, and Schnorr signatures.
+ *
+ * Typical single-signer flow:
+ * ```ts
+ * const pskt = Pskt.creator()
+ *   .toUpdater()
+ *   .input({ ... })
+ *   .output({ ... })
+ *   .toSigner()
+ *   .sign(privateKeyBuffer)
+ *   .toFinalizer()
+ *   .finalize()
+ *   .toExtractor();
+ *
+ * const broadcastJson = pskt.extract();
+ * ```
+ *
+ * HSM / external signing flow:
+ * ```ts
+ * const unsigned = pskt.serialize();          // send to HSM
+ * const signed   = Pskt.deserialize(signed);  // receive back
+ * const tx       = signed.toFinalizer().finalize().toExtractor().extract();
+ * ```
+ */
+export declare class Pskt {
+    private _global;
+    private _inputs;
+    private _outputs;
+    private _role;
+    private constructor();
+    get role(): PsktRole;
+    get global(): Readonly<PsktGlobal>;
+    get inputs(): ReadonlyArray<Readonly<PsktInput>>;
+    get outputs(): ReadonlyArray<Readonly<PsktOutput>>;
+    /**
+     * Create a new PSKT in CREATOR role.
+     *
+     * @param txVersion       Kaspa transaction version (currently 0)
+     * @param fallbackLockTime Optional lock time as decimal string
+     */
+    static creator(txVersion?: number, fallbackLockTime?: string): Pskt;
+    /**
+     * Reconstruct a PSKT from a `KaspaTransactionData` object.
+     *
+     * The returned PSKT is placed in SIGNER role (inputs are locked, UTXO data
+     * is populated, any existing `signatureScript` is carried as `finalScriptSig`).
+     * Used by `Transaction.toPskt()`.
+     */
+    static fromTxData(txData: KaspaTransactionData): Pskt;
+    /**
+     * Deserialise a PSKT from the JSON string produced by `serialize()`.
+     */
+    static deserialize(json: string): Pskt;
+    toUpdater(): Pskt;
+    toSigner(): Pskt;
+    toCombiner(): Pskt;
+    /**
+     * Transition to FINALIZER role.
+     * Allowed from both SIGNER (single-party shortcut) and COMBINER.
+     */
+    toFinalizer(): Pskt;
+    /**
+     * Transition to EXTRACTOR role.
+     * All inputs must have a `finalScriptSig` (call `finalize()` first).
+     */
+    toExtractor(): Pskt;
+    /**
+     * Add an input. Only allowed in CREATOR or UPDATER role.
+     */
+    input(inp: PsktInput): this;
+    /**
+     * Add an output. Only allowed in CREATOR or UPDATER role.
+     */
+    output(out: PsktOutput): this;
+    /**
+     * Sign all inputs with a private key (single-key / non-HSM path).
+     *
+     * Computes a distinct keyed Blake2b-256 sighash per input (Kaspa's
+     * BIP-143-like scheme) and writes the 64-byte Schnorr signature into
+     * `partialSigs[compressedPubKeyHex]` for each input.
+     *
+     * @param privateKey  32-byte private key buffer
+     * @param sigHashType SigHash type (default: SIGHASH_ALL = 0x01)
+     */
+    sign(privateKey: Buffer, sigHashType?: number): this;
+    /**
+     * Record an externally-produced Schnorr signature for one specific input.
+     *
+     * HSM / MPCv2 flow:
+     * ```ts
+     * const json  = pskt.serialize();                  // → HSM
+     * // HSM signs each input's sighash and returns signatures
+     * pskt.addSignature(0, pubKeyHex, sig0Hex)
+     *     .addSignature(1, pubKeyHex, sig1Hex);
+     * ```
+     *
+     * @param inputIndex  0-based index of the input being signed
+     * @param pubKeyHex   33-byte compressed secp256k1 pubKey, hex-encoded
+     * @param sigHex      64-byte Schnorr signature, hex-encoded
+     * @param sigHashType SigHash type used when producing the signature
+     */
+    addSignature(inputIndex: number, pubKeyHex: string, sigHex: string, sigHashType?: number): this;
+    /**
+     * Merge `partialSigs` from another PSKT into this one.
+     *
+     * Both PSKTs must represent the same transaction (same number of inputs and
+     * outputs). Conflicting signatures for the same pubKey raise an error.
+     */
+    combine(other: Pskt): this;
+    /**
+     * Finalise all inputs: promote the first `partialSig` on each input into
+     * `finalScriptSig` using Kaspa's push-only script layout:
+     *   `0x41` (OP_DATA_65) + 64-byte sig + 1-byte sighash type = 66 bytes
+     *
+     * Works for both Schnorr (v0) and ECDSA (v1) inputs since both produce a
+     * 64-byte compact signature stored in `partialSigs`.
+     * Inputs that already have a `finalScriptSig` are left unchanged.
+     */
+    finalize(): this;
+    /**
+     * Extract the broadcast-ready transaction as a JSON string.
+     *
+     * Produces the same wire format as `Transaction.toBroadcastFormat()`.
+     * Must be in EXTRACTOR role (call `.toFinalizer().finalize().toExtractor()` first).
+     */
+    extract(): string;
+    /**
+     * Serialise the PSKT to a JSON string for transmission (e.g. to an HSM).
+     * The `role` is included so `Pskt.deserialize()` can reconstruct the state.
+     */
+    serialize(): string;
+    /**
+     * Convert the PSKT's internal data back to a `KaspaTransactionData` object.
+     *
+     * `finalScriptSig` (if present) is mapped to `signatureScript` so that the
+     * resulting `Transaction` is fully signed and ready to broadcast.
+     * Used by `Transaction.fromPskt()`.
+     */
+    toTxData(): KaspaTransactionData;
+}
+//# sourceMappingURL=pskt.d.ts.map

package/dist/src/lib/pskt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pskt.d.ts","sourceRoot":"","sources":["../../../src/lib/pskt.ts"],"names":[],"mappings":"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"}