nexa-wallet-sdk 0.1.4 → 0.2.1

package/README.md

@@ -313,6 +313,36 @@ await watchOnlyWallet.subscribeToAddressNotifications((notification) => {
 
 ## Advanced Features
 
+### Address Notifications
+
+```typescript
+// Subscribe to a single address
+await wallet.subscribeToAddressNotifications(
+    'nexa:nqtsq5g5jsdmqqywaqd82lhnnk3a8wqunjz6gtxdtavnnekc',
+    (notification) => {
+        console.log('Address notification:', notification)
+    }
+)
+
+// Subscribe to addresses as an array
+const addresses = [
+    'nexa:nqtsq5g5jsdmqqywaqd82lhnnk3a8wqunjz6gtxdtavnnekc'
+]
+
+await wallet.subscribeToAddressNotifications(addresses, (notification) => {
+    console.log('Array Address notification:', notification)
+})
+
+// Subscribe to all wallet addresses
+const accounts = wallet.accountStore.listAccounts()
+const allAddresses = accounts.flatMap(account => 
+    account.getAddresses().map(addr => addr.address)
+)
+await wallet.subscribeToAddressNotifications(allAddresses, (notification) => {
+    console.log('Wallet notification:', notification)
+})
+```
+
 ### Parse Existing Transactions
 
 ```typescript

package/dist/index.cjs

@@ -141,7 +141,7 @@ $parcel$export(module.exports, "WatchOnlyTransactionCreator", () => $2ce5b75d109
 $parcel$export(module.exports, "rostrumProvider", () => $b5bfd17fdf06d231$export$eaa49f0478d81b9d);
 // @ts-ignore
 var $2dd241e44b9dc3c2$exports = {};
-$2dd241e44b9dc3c2$exports = JSON.parse("{\"name\":\"nexa-wallet-sdk\",\"version\":\"0.1.4\",\"type\":\"module\",\"source\":\"src/index.ts\",\"types\":\"dist/index.d.ts\",\"main\":\"dist/index.cjs\",\"module\":\"dist/index.mjs\",\"browser\":\"dist/index.web.mjs\",\"exports\":{\"types\":\"./dist/index.d.ts\",\"node\":{\"import\":\"./dist/index.mjs\",\"require\":\"./dist/index.cjs\"},\"browser\":\"./dist/index.web.mjs\",\"default\":\"./dist/index.mjs\"},\"scripts\":{\"build\":\"parcel build\",\"lint\":\"eslint .\",\"fix-lint\":\"eslint --fix .\",\"dev\":\"parcel watch\",\"test\":\"vitest run\",\"clean\":\"rm -rf dist .parcel-cache\",\"docs\":\"typedoc\"},\"repository\":{\"type\":\"git\",\"url\":\"git+ssh://git@gitlab.com/nexa/wallet-sdk-ts.git\"},\"keywords\":[\"nexa\",\"wallet\",\"web3\",\"crypto\",\"dapp\",\"walletcomms\",\"walletsdk\"],\"contributors\":[{\"name\":\"Dolaned\"},{\"name\":\"Griffith\"},{\"name\":\"Vgrunner\"},{\"name\":\"myendy\"}],\"author\":\"Dolaned\",\"license\":\"MIT\",\"bugs\":{\"url\":\"https://gitlab.com/nexa/wallet-sdk-ts/issues\"},\"homepage\":\"https://gitlab.com/nexa/wallet-sdk-ts#readme\",\"description\":\"Wallet SDK for the Nexa blockchain\",\"devDependencies\":{\"@parcel/packager-ts\":\"^2.15.4\",\"@parcel/transformer-typescript-types\":\"^2.15.4\",\"@types/lodash-es\":\"^4.17.12\",\"@types/node\":\"^22.13.1\",\"eslint\":\"^9.20.1\",\"parcel\":\"^2.15.4\",\"typedoc\":\"^0.28.7\",\"typedoc-plugin-markdown\":\"^4.7.0\",\"typedoc-plugin-rename-defaults\":\"^0.7.3\",\"typescript\":\"^5.8.3\",\"typescript-eslint\":\"^8.24.1\",\"vitest\":\"^3.0.8\"},\"targets\":{\"main\":{\"context\":\"node\",\"outputFormat\":\"commonjs\",\"distDir\":\"dist\",\"isLibrary\":true,\"includeNodeModules\":[\"lodash-es\"]},\"module\":{\"context\":\"node\",\"outputFormat\":\"esmodule\",\"distDir\":\"dist\",\"isLibrary\":true},\"browser\":{\"context\":\"browser\",\"outputFormat\":\"esmodule\",\"distDir\":\"dist\",\"isLibrary\":true}},\"dependencies\":{\"@vgrunner/electrum-cash\":\"^2.0.12\",\"bip39\":\"^3.1.0\",\"js-big-decimal\":\"^2.2.0\",\"libnexa-ts\":\"^1.0.5\",\"lodash-es\":\"^4.17.21\"},\"files\":[\"dist\"],\"directories\":{\"test\":\"tests\"},\"@parcel/resolver-default\":{\"packageExports\":true}}");
+$2dd241e44b9dc3c2$exports = JSON.parse("{\"name\":\"nexa-wallet-sdk\",\"version\":\"0.2.1\",\"type\":\"module\",\"source\":\"src/index.ts\",\"types\":\"dist/index.d.ts\",\"main\":\"dist/index.cjs\",\"module\":\"dist/index.mjs\",\"browser\":\"dist/index.web.mjs\",\"exports\":{\"types\":\"./dist/index.d.ts\",\"node\":{\"import\":\"./dist/index.mjs\",\"require\":\"./dist/index.cjs\"},\"browser\":\"./dist/index.web.mjs\",\"default\":\"./dist/index.mjs\"},\"scripts\":{\"build\":\"parcel build\",\"lint\":\"eslint .\",\"fix-lint\":\"eslint --fix .\",\"dev\":\"parcel watch\",\"test\":\"vitest run\",\"clean\":\"rm -rf dist .parcel-cache\",\"docs\":\"typedoc\"},\"repository\":{\"type\":\"git\",\"url\":\"git+ssh://git@gitlab.com/nexa/wallet-sdk-ts.git\"},\"keywords\":[\"nexa\",\"wallet\",\"web3\",\"crypto\",\"dapp\",\"walletcomms\",\"walletsdk\"],\"contributors\":[{\"name\":\"Dolaned\"},{\"name\":\"Griffith\"},{\"name\":\"Vgrunner\"},{\"name\":\"myendy\"}],\"author\":\"Dolaned\",\"license\":\"MIT\",\"bugs\":{\"url\":\"https://gitlab.com/nexa/wallet-sdk-ts/issues\"},\"homepage\":\"https://gitlab.com/nexa/wallet-sdk-ts#readme\",\"description\":\"Wallet SDK for the Nexa blockchain\",\"devDependencies\":{\"@parcel/packager-ts\":\"^2.15.4\",\"@parcel/transformer-typescript-types\":\"^2.15.4\",\"@types/lodash-es\":\"^4.17.12\",\"@types/node\":\"^22.13.1\",\"eslint\":\"^9.20.1\",\"parcel\":\"^2.15.4\",\"typedoc\":\"^0.28.7\",\"typedoc-plugin-markdown\":\"^4.7.0\",\"typedoc-plugin-rename-defaults\":\"^0.7.3\",\"typescript\":\"^5.8.3\",\"typescript-eslint\":\"^8.24.1\",\"vitest\":\"^3.0.8\"},\"targets\":{\"main\":{\"context\":\"node\",\"outputFormat\":\"commonjs\",\"distDir\":\"dist\",\"isLibrary\":true,\"includeNodeModules\":[\"lodash-es\"]},\"module\":{\"context\":\"node\",\"outputFormat\":\"esmodule\",\"distDir\":\"dist\",\"isLibrary\":true},\"browser\":{\"context\":\"browser\",\"outputFormat\":\"esmodule\",\"distDir\":\"dist\",\"isLibrary\":true}},\"dependencies\":{\"@vgrunner/electrum-cash\":\"^2.0.12\",\"bip39\":\"^3.1.0\",\"js-big-decimal\":\"^2.2.0\",\"libnexa-ts\":\"^1.0.5\",\"lodash-es\":\"^4.17.21\"},\"files\":[\"dist\"],\"directories\":{\"test\":\"tests\"},\"@parcel/resolver-default\":{\"packageExports\":true}}");
 
 
 
@@ -253,9 +253,10 @@ class $b5bfd17fdf06d231$export$ba81aefc89aef50c {
     }
     /**
      * Create initial connection with the rostrum server
-     * @param netOrParams
-     * @param params
-     */ async connect(netOrParams, params) {
+     * @param netOrParams - Network identifier or RostrumParams object
+     * @param params - RostrumParams object (for backward compatibility)
+     * @param electrumClient - Optional pre-configured ElectrumClient instance
+     */ async connect(netOrParams, params, electrumClient) {
         try {
             let connectionParams;
             // Handle backward compatibility: connect(params) or connect(network, params)
@@ -283,8 +284,13 @@ class $b5bfd17fdf06d231$export$ba81aefc89aef50c {
                     scheme: (0, $95d1e8196bc3f78b$export$1f6f962b0b96558).WS
                 };
             }
-            this.client = new (0, $l50U0$vgrunnerelectrumcash.ElectrumClient)("com.nexa.wallet-sdk", "0.1.4", connectionParams.host, connectionParams.port, connectionParams.scheme, 30000, 10000, true);
-            await this.client.connect();
+            if (electrumClient) {
+                this.client = electrumClient;
+                if (this.client.connection.status == (0, $l50U0$vgrunnerelectrumcash.ConnectionStatus).DISCONNECTED) await this.client.connect();
+            } else {
+                this.client = new (0, $l50U0$vgrunnerelectrumcash.ElectrumClient)("com.nexa.wallet-sdk", "1.4.3", connectionParams.host, connectionParams.port, connectionParams.scheme, 30000, 10000, true);
+                await this.client.connect();
+            }
         } catch (e) {
             if (e instanceof Error) console.info(e.message);
             else console.error(e);
@@ -1094,6 +1100,31 @@ function $0d59d2bcffd646c5$var$classifyTokenTransaction(vin, vout, txState, myAd
 }
 
 
+/**
+ * Checks if `value` is classified as an `Array` object.
+ *
+ * @static
+ * @memberOf _
+ * @since 0.1.0
+ * @category Lang
+ * @param {*} value The value to check.
+ * @returns {boolean} Returns `true` if `value` is an array, else `false`.
+ * @example
+ *
+ * _.isArray([1, 2, 3]);
+ * // => true
+ *
+ * _.isArray(document.body.children);
+ * // => false
+ *
+ * _.isArray('abc');
+ * // => false
+ *
+ * _.isArray(_.noop);
+ * // => false
+ */ var $36cc8c1055cfbf3b$var$isArray = Array.isArray;
+var $36cc8c1055cfbf3b$export$2e2bcd8739ae039 = $36cc8c1055cfbf3b$var$isArray;
+
 
 var $kNPhA = parcelRequire("kNPhA");
 var $cpiMl = parcelRequire("cpiMl");
@@ -1165,31 +1196,6 @@ var $8b46445dc5373cfc$export$2e2bcd8739ae039 = $8b46445dc5373cfc$var$objectToStr
 var $6911cdf7f985d482$export$2e2bcd8739ae039 = $6911cdf7f985d482$var$baseGetTag;
 
 
-/**
- * Checks if `value` is classified as an `Array` object.
- *
- * @static
- * @memberOf _
- * @since 0.1.0
- * @category Lang
- * @param {*} value The value to check.
- * @returns {boolean} Returns `true` if `value` is an array, else `false`.
- * @example
- *
- * _.isArray([1, 2, 3]);
- * // => true
- *
- * _.isArray(document.body.children);
- * // => false
- *
- * _.isArray('abc');
- * // => false
- *
- * _.isArray(_.noop);
- * // => false
- */ var $36cc8c1055cfbf3b$var$isArray = Array.isArray;
-var $36cc8c1055cfbf3b$export$2e2bcd8739ae039 = $36cc8c1055cfbf3b$var$isArray;
-
 
 /**
  * Checks if `value` is object-like. A value is object-like if it's not `null`
@@ -1899,6 +1905,24 @@ class $57b0117fe8233fef$export$bba690fb5c12ba04 {
         });
         return this;
     }
+    /**
+     * Adds nexa contract constraint to spending inputs
+     * @param templateScript
+     * @param constraintScript
+     * @param visibleArgs
+     * @param pubKey
+     * @returns This instance for chaining
+     */ addContract(templateScript, constraintScript, visibleArgs, pubKey) {
+        this.builder.push(async ()=>{
+            this.txOptions.templateData = {
+                publicKey: pubKey,
+                templateScript: templateScript,
+                constraintScript: constraintScript,
+                visibleArgs: visibleArgs
+            };
+        });
+        return this;
+    }
     /**
      * Builds the transaction by executing all queued operations
      * @returns Promise resolving to the serialized transaction hex
@@ -2380,6 +2404,56 @@ class $b76d3bd5024ccfc0$export$2e2bcd8739ae039 {
         (0, $a635077caedb9044$export$2e2bcd8739ae039).validateArgument((0, $90290c84737dbb50$export$2e2bcd8739ae039)(transaction), 'transaction must be present and valid');
         return (0, $b5bfd17fdf06d231$export$eaa49f0478d81b9d).broadcast(transaction);
     }
+    /**
+     * Subscribe to address notifications for transaction updates
+     *
+     * This method allows you to monitor one or more addresses for incoming and outgoing transactions.
+     * You can provide either a single address string or an array of addresses. The callback will be
+     * invoked whenever there are updates to any of the monitored addresses.
+     *
+     * @param addresses - A single address string or array of addresses to monitor
+     * @param callback - Function to call when address notifications are received
+     * @returns Promise that resolves when subscription is established
+     * @throws {Error} If addresses parameter is invalid or empty
+     *
+     * @example
+     * ```typescript
+     * // Subscribe to a single address
+     * await wallet.subscribeToAddressNotifications(
+     *   'nexa:address123',
+     *   (notification) => {
+     *     console.log('Address notification:', notification);
+     *   }
+     * );
+     *
+     * // Subscribe to multiple addresses
+     * await wallet.subscribeToAddressNotifications(
+     *   ['nexa:address1', 'nexa:address2', 'nexa:address3'],
+     *   (notification) => {
+     *     console.log('Address notification:', notification);
+     *   }
+     * );
+     *
+     * // Subscribe to all wallet addresses
+     * const accounts = wallet.accountStore.listAccounts();
+     * const addresses = accounts.flatMap(account => 
+     *   account.getAddresses().map(addr => addr.address)
+     * );
+     * await wallet.subscribeToAddressNotifications(addresses, callback);
+     * ```
+     */ async subscribeToAddressNotifications(addresses, callback) {
+        (0, $a635077caedb9044$export$2e2bcd8739ae039).validateArgument(!(0, $54dde1e65fb8e5b8$export$2e2bcd8739ae039)(addresses), 'addresses parameter is required');
+        (0, $a635077caedb9044$export$2e2bcd8739ae039).validateArgument(!(0, $54dde1e65fb8e5b8$export$2e2bcd8739ae039)(callback), 'callback function is required');
+        let addressArray;
+        if ((0, $90290c84737dbb50$export$2e2bcd8739ae039)(addresses)) addressArray = [
+            addresses
+        ];
+        else if ((0, $36cc8c1055cfbf3b$export$2e2bcd8739ae039)(addresses)) {
+            (0, $a635077caedb9044$export$2e2bcd8739ae039).validateArgument(addresses.length > 0, 'addresses array cannot be empty');
+            addressArray = addresses;
+        } else throw new Error('addresses must be a string or array of strings');
+        return (0, $b5bfd17fdf06d231$export$eaa49f0478d81b9d).subscribeToAddresses(addressArray, callback);
+    }
     /**
      * Sign a message using a specific address from this wallet
      *