buildonspark · ecurrencyhodler · Aug 22, 2025 · Aug 20, 2025 · Aug 22, 2025 · Aug 22, 2025
diff --git a/sdks/js/README.md b/sdks/js/README.md
@@ -1,5 +1,31 @@
 # Spark JS SDK workspaces
 
-# Install
+## Install
 
-Running `yarn` will install dependencies for all workspaces. Please note there is a postinstall script that runs after install to build some dependencies. This will run automatically when the dependency tree changes or when manually running `yarn rebuild`.
+You should use [nvm](https://github.com/nvm-sh/nvm#installing-and-updating) to manage your node versions. That way you're using the same version as CI, it's easier to upgrade, and easier to repro any issues that are tied to a specific version.
+
+With nvm installed:
+
+```
+cd spark/sdks/js
+nvm use || nvm install
+```
+
+Similarly to manage yarn versions [it's recommended](https://yarnpkg.com/getting-started/install) using corepack which is built in with node:
+
+```
+corepack enable
+cd spark/sdks/js
+# use yarn version from packageManager key in package.json:
+corepack prepare --activate
+```
+
+Then install dependencies for all workspaces:
+
+```
+# cd to js or to any subdirectory of js
+cd spark/sdks/js
+yarn
+```
+
+Please note there is a postinstall script that runs after install to build some dependencies. This will run automatically when the dependency tree changes or when manually running `yarn rebuild`.
diff --git a/sdks/js/examples/nestjs-app/CHANGELOG.md b/sdks/js/examples/nestjs-app/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @buildonspark/nestjs-app
 
+## 0.0.69
+
+### Patch Changes
+
+- Updated dependencies
+  - @buildonspark/spark-sdk@0.2.11
+
 ## 0.0.68
 
 ### Patch Changes

diff --git a/sdks/js/examples/nestjs-app/package.json b/sdks/js/examples/nestjs-app/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@buildonspark/nestjs-app",
-  "version": "0.0.68",
+  "version": "0.0.69",
   "description": "",
   "author": "",
   "private": true,
@@ -19,7 +19,7 @@
     "test:e2e": "NODE_OPTIONS=\"--experimental-vm-modules\" yarn jest --config ./test/jest-e2e.json --detectOpenHandles --forceExit"
   },
   "dependencies": {
-    "@buildonspark/spark-sdk": "0.2.10",
+    "@buildonspark/spark-sdk": "0.2.11",
     "@nestjs/common": "^10.0.0",
     "@nestjs/core": "^10.0.0",
     "@nestjs/platform-express": "^10.0.0",

diff --git a/sdks/js/examples/nodejs-scripts/CHANGELOG.md b/sdks/js/examples/nodejs-scripts/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @buildonspark/nodejs-scripts
 
+## 0.0.85
+
+### Patch Changes
+
+- Updated dependencies
+  - @buildonspark/spark-sdk@0.2.11
+  - @buildonspark/issuer-sdk@0.0.90
+
 ## 0.0.84
 
 ### Patch Changes

diff --git a/sdks/js/examples/nodejs-scripts/package.json b/sdks/js/examples/nodejs-scripts/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@buildonspark/nodejs-scripts",
-  "version": "0.0.84",
+  "version": "0.0.85",
   "private": true,
   "description": "Example NodeJS scripts for Spark SDK",
   "main": "index.js",
@@ -24,8 +24,8 @@
     "typescript": "^5.7.3"
   },
   "dependencies": {
-    "@buildonspark/issuer-sdk": "0.0.89",
-    "@buildonspark/spark-sdk": "0.2.10",
+    "@buildonspark/issuer-sdk": "0.0.90",
+    "@buildonspark/spark-sdk": "0.2.11",
     "tsx": "^4.19.3"
   },
   "engines": {

diff --git a/sdks/js/examples/spark-bare-app/CHANGELOG.md b/sdks/js/examples/spark-bare-app/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @buildonspark/spark-bare-app
 
+## 0.0.7
+
+### Patch Changes
+
+- Updated dependencies
+  - @buildonspark/spark-sdk@0.2.11
+  - @buildonspark/bare@0.0.7
+
 ## 0.0.6
 
 ### Patch Changes

diff --git a/sdks/js/examples/spark-bare-app/package.json b/sdks/js/examples/spark-bare-app/package.json
@@ -1,15 +1,15 @@
 {
   "name": "@buildonspark/spark-bare-app",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "private": true,
   "type": "module",
   "scripts": {
     "get-wallet-details": "bare get-wallet-details.js",
     "create-lightning-invoice": "bare create-lightning-invoice.js 1000"
   },
   "dependencies": {
-    "@buildonspark/bare": "0.0.6",
-    "@buildonspark/spark-sdk": "0.2.10",
+    "@buildonspark/bare": "0.0.7",
+    "@buildonspark/spark-sdk": "0.2.11",
     "bare": "^1.21.3",
     "bare-assert": "^1.0.2",
     "bare-async-hooks": "^0.0.0",

diff --git a/sdks/js/examples/spark-browser-extension/CHANGELOG.md b/sdks/js/examples/spark-browser-extension/CHANGELOG.md
@@ -1,5 +1,12 @@
 # spark-browser-extension
 
+## 0.0.6
+
+### Patch Changes
+
+- Updated dependencies
+  - @buildonspark/spark-sdk@0.2.11
+
 ## 0.0.5
 
 ### Patch Changes

diff --git a/sdks/js/examples/spark-browser-extension/package.json b/sdks/js/examples/spark-browser-extension/package.json
@@ -1,6 +1,6 @@
 {
   "name": "spark-browser-extension",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "private": true,
   "type": "module",
   "scripts": {
@@ -11,7 +11,7 @@
     "format": "prettier src --check"
   },
   "dependencies": {
-    "@buildonspark/spark-sdk": "0.2.10"
+    "@buildonspark/spark-sdk": "0.2.11"
   },
   "devDependencies": {
     "@types/chrome": "^0.0.276",

diff --git a/sdks/js/examples/spark-cli/CHANGELOG.md b/sdks/js/examples/spark-cli/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @buildonspark/spark-cli
 
+## 0.0.68
+
+### Patch Changes
+
+- Updated dependencies
+  - @buildonspark/spark-sdk@0.2.11
+  - @buildonspark/issuer-sdk@0.0.90
+
 ## 0.0.67
 
 ### Patch Changes

diff --git a/sdks/js/examples/spark-cli/package.json b/sdks/js/examples/spark-cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@buildonspark/spark-cli",
-  "version": "0.0.67",
+  "version": "0.0.68",
   "private": true,
   "description": "Spark CLI",
   "main": "index.js",
@@ -28,8 +28,8 @@
     "typescript": "^5.7.3"
   },
   "dependencies": {
-    "@buildonspark/issuer-sdk": "0.0.89",
-    "@buildonspark/spark-sdk": "0.2.10",
+    "@buildonspark/issuer-sdk": "0.0.90",
+    "@buildonspark/spark-sdk": "0.2.11",
     "tsx": "^4.19.3",
     "yargs": "^18.0.0"
   },

diff --git a/sdks/js/examples/spark-cli/src/cli.ts b/sdks/js/examples/spark-cli/src/cli.ts
@@ -19,7 +19,9 @@ import {
   WalletConfig,
   SparkAddressFormat,
   validateSparkInvoiceSignature,
+  SparkSdkLogger,
 } from "@buildonspark/spark-sdk";
+import { LoggingLevel } from "@lightsparkdev/core";
 import {
   TokenTransactionStatus,
   TreeNode,
@@ -355,6 +357,8 @@ const commands = [
   "fulfillsparkinvoice",
   "validateinvoicesig",
 
+  "enablelogging",
+  "setloggerlevel",
   "help",
   "exit",
   "quit",
@@ -684,6 +688,8 @@ async function runCLI() {
   createtoken <tokenName> <tokenTicker> <decimals> <maxSupply> <isFreezable> - Create a new token
   decodetokenidentifier <tokenIdentifier>                             - Returns the raw token identifier as a hex string
 
+  enablelogging <true|false>                                          - Enable or disable logging
+  setloggerlevel <trace|info>                                         - Set the logging level
   help                                                                - Show this help message
   exit/quit                                                           - Exit the program
 `;
@@ -710,6 +716,14 @@ async function runCLI() {
         case "help":
           console.log(helpMessage);
           break;
+        case "enablelogging":
+          SparkSdkLogger.setAllEnabled(args[0] === "true");
+          break;
+        case "setloggerlevel":
+          SparkSdkLogger.setAllLevels(
+            args[0] === "trace" ? LoggingLevel.Trace : LoggingLevel.Info,
+          );
+          break;
         case "nontrustydeposit":
           if (process.env.NODE_ENV !== "development" || network !== "REGTEST") {
             console.log(
@@ -722,7 +736,7 @@ async function runCLI() {
            *
            * 1. Get an address to deposit funds from L1 to Spark
            * 2. Construct a tx spending from the L1 address to the Spark address
-           * 3. Call initalizeDeposit with the tx hex
+           * 3. Call initializeDeposit with the tx hex
            * 4. Sign the tx
            * 5. Broadcast the tx
            */

diff --git a/sdks/js/examples/spark-expo-react-native-app/CHANGELOG.md b/sdks/js/examples/spark-expo-react-native-app/CHANGELOG.md
@@ -1,5 +1,12 @@
 # my-app
 
+## 1.0.6
+
+### Patch Changes
+
+- Updated dependencies
+  - @buildonspark/spark-sdk@0.2.11
+
 ## 1.0.5
 
 ### Patch Changes

diff --git a/sdks/js/examples/spark-expo-react-native-app/package.json b/sdks/js/examples/spark-expo-react-native-app/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@buildonspark/spark-expo-react-native-app",
   "main": "expo-router/entry",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "type": "module",
   "scripts": {
     "start": "expo start",
@@ -13,7 +13,7 @@
     "lint": "expo lint"
   },
   "dependencies": {
-    "@buildonspark/spark-sdk": "0.2.10",
+    "@buildonspark/spark-sdk": "0.2.11",
     "@expo/vector-icons": "^14.1.0",
     "@react-native-community/cli": "19.0.0",
     "@react-navigation/bottom-tabs": "^7.3.10",

diff --git a/sdks/js/examples/spark-nextjs-app/CHANGELOG.md b/sdks/js/examples/spark-nextjs-app/CHANGELOG.md
@@ -1,5 +1,12 @@
 # spark-nextjs-app
 
+## 0.1.31
+
+### Patch Changes
+
+- Updated dependencies
+  - @buildonspark/spark-sdk@0.2.11
+
 ## 0.1.30
 
 ### Patch Changes

diff --git a/sdks/js/examples/spark-nextjs-app/package.json b/sdks/js/examples/spark-nextjs-app/package.json
@@ -1,6 +1,6 @@
 {
   "name": "spark-nextjs-app",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "private": true,
   "scripts": {
     "dev": "next dev --turbopack",
@@ -9,7 +9,7 @@
     "lint": "next lint"
   },
   "dependencies": {
-    "@buildonspark/spark-sdk": "0.2.10",
+    "@buildonspark/spark-sdk": "0.2.11",
     "next": "15.3.2",
     "react": "19.0.0",
     "react-dom": "19.0.0"

diff --git a/sdks/js/examples/spark-node-express/CHANGELOG.md b/sdks/js/examples/spark-node-express/CHANGELOG.md
@@ -1,5 +1,13 @@
 # spark-node-express
 
+## 0.0.77
+
+### Patch Changes
+
+- Updated dependencies
+  - @buildonspark/spark-sdk@0.2.11
+  - @buildonspark/issuer-sdk@0.0.90
+
 ## 0.0.76
 
 ### Patch Changes

diff --git a/sdks/js/examples/spark-node-express/package.json b/sdks/js/examples/spark-node-express/package.json
@@ -1,6 +1,6 @@
 {
   "name": "spark-node-express",
-  "version": "0.0.76",
+  "version": "0.0.77",
   "main": "dist/index.js",
   "type": "module",
   "private": true,
@@ -14,8 +14,8 @@
   "author": "",
   "description": "basic express server consuming the @buildonspark/spark-sdk and @buildonspark/issuer-sdk",
   "dependencies": {
-    "@buildonspark/issuer-sdk": "0.0.89",
-    "@buildonspark/spark-sdk": "0.2.10",
+    "@buildonspark/issuer-sdk": "0.0.90",
+    "@buildonspark/spark-sdk": "0.2.11",
     "@lightsparkdev/core": "^1.4.3",
     "@noble/curves": "^1.8.0",
     "express": "^4.21.2"

diff --git a/sdks/js/examples/spark-react-native-app/CHANGELOG.md b/sdks/js/examples/spark-react-native-app/CHANGELOG.md
@@ -1,5 +1,12 @@
 # spark-react-native-app
 
+## 0.0.17
+
+### Patch Changes
+
+- Updated dependencies
+  - @buildonspark/spark-sdk@0.2.11
+
 ## 0.0.16
 
 ### Patch Changes

diff --git a/sdks/js/examples/spark-react-native-app/ios/Podfile.lock b/sdks/js/examples/spark-react-native-app/ios/Podfile.lock
@@ -1657,7 +1657,7 @@ PODS:
     - React-perflogger (= 0.79.4)
     - React-utils (= 0.79.4)
   - SocketRocket (0.7.1)
-  - spark-sdk (0.2.5):
+  - spark-sdk (0.2.10):
     - React
     - React-Core
   - Yoga (0.0.0)
@@ -1961,7 +1961,7 @@ SPEC CHECKSUMS:
   ReactCodegen: e713bcd88244fff6026629aebe9aa61b693beb9c
   ReactCommon: c7d636ec1b9801ff4ee83cce8e0bf74a1610fc3f
   SocketRocket: d4aabe649be1e368d1318fdf28a022d714d65748
-  spark-sdk: 476b47d7cdc485b64fbc1865d935c8aff99524c9
+  spark-sdk: a126ef95d385f3dd89438855e291c86e7b884ebc
   Yoga: a6cb833e04fb8c59a012b49fb1d040fcb0cbb633
 
 PODFILE CHECKSUM: ea1210c0e7d02ebb3d518cc5766a9f3dde871573

diff --git a/sdks/js/examples/spark-react-native-app/package.json b/sdks/js/examples/spark-react-native-app/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@buildonspark/spark-react-native-app",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "private": true,
   "scripts": {
     "android": "react-native run-android",
@@ -12,7 +12,7 @@
   },
   "dependencies": {
     "@azure/core-asynciterator-polyfill": "^1.0.2",
-    "@buildonspark/spark-sdk": "0.2.10",
+    "@buildonspark/spark-sdk": "0.2.11",
     "@react-native/new-app-screen": "0.80.1",
     "react": "19.0.0",
     "react-native": "0.79.4",

diff --git a/sdks/js/examples/spark-token-cli/CHANGELOG.md b/sdks/js/examples/spark-token-cli/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @buildonspark/spark-token-cli
 
+## 0.0.49
+
+### Patch Changes
+
+- @buildonspark/issuer-sdk@0.0.90
+
 ## 0.0.48
 
 ### Patch Changes