@bsv/sdk 2.0.15 → 2.1.0

package/docs/reference/primitives.md

@@ -4948,7 +4948,6 @@ export default class TransactionSignature extends Signature {
     static formatBip143(params: TransactionSignatureFormatParams): Uint8Array 
     static format(params: TransactionSignatureFormatParams): number[] 
     static formatBytes(params: TransactionSignatureFormatParams): Uint8Array 
-    static usesOtdaSingleBug(params: TransactionSignatureFormatParams): boolean
     static fromChecksigFormat(buf: number[]): TransactionSignature 
     constructor(r: BigNumber, s: BigNumber, scope: number) 
     public hasLowS(): boolean 

package/docs/reference/script.md

@@ -45,7 +45,6 @@ A representation of a chunk of a script, which includes an opcode. For push oper
 export default interface ScriptChunk {
     op: number;
     data?: number[];
-    invalidLength?: boolean;
 }
 ```
 
@@ -805,14 +804,10 @@ export default class Spend {
     stack: number[][];
     altStack: number[][];
     ifStack: boolean[];
-    elseStack: boolean[];
     memoryLimit: number;
     stackMem: number;
     altStackMem: number;
     isRelaxedOverride: boolean;
-    verifyFlags?: Set<string>;
-    executedOpCount: number;
-    returningFromConditional: boolean;
     constructor(params: {
         sourceTXID: string;
         sourceOutputIndex: number;
@@ -827,7 +822,6 @@ export default class Spend {
         lockTime: number;
         memoryLimit?: number;
         isRelaxed?: boolean;
-        verifyFlags?: string | string[];
     }) 
     reset(): void 
     step(): boolean 
@@ -854,7 +848,6 @@ constructor(params: {
     lockTime: number;
     memoryLimit?: number;
     isRelaxed?: boolean;
-    verifyFlags?: string | string[];
 }) 
 ```
 See also: [LockingScript](./script.md#class-lockingscript), [TransactionInput](./transaction.md#interface-transactioninput), [TransactionOutput](./transaction.md#interface-transactionoutput), [UnlockingScript](./script.md#class-unlockingscript)

package/docs/reference/transaction.md

@@ -2455,8 +2455,8 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ### Function: defaultHttpClient
 
 Returns a default HttpClient implementation based on the environment that it is run on.
-This method will attempt to use `window.fetch` if available (in browser environments),
-then `globalThis.fetch` (service workers, Deno, Node 18+), then the Node `https` module.
+This method will attempt to use `window.fetch` if available (in browser environments).
+If running in a Node environment, it falls back to using the Node `https` module
 
 ```ts
 export function defaultHttpClient(): HttpClient 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/sdk",
-  "version": "2.0.15",
+  "version": "2.1.0",
   "type": "module",
   "description": "BSV Blockchain Software Development Kit",
   "main": "dist/cjs/mod.js",
@@ -218,24 +218,10 @@
       "import": "./dist/umd/bundle.js"
     }
   },
-  "scripts": {
-    "test": "npm run build && jest",
-    "test:watch": "npm run build && jest --watch",
-    "test:coverage": "npm run build && jest --coverage",
-    "lint:ci": "ts-standard src/**/*.ts",
-    "lint": "ts-standard --fix src/**/*.ts",
-    "build": "npm run build:ts && npm run build:umd",
-    "build:ts": "tsc -b && tsconfig-to-dual-package tsconfig.cjs.json",
-    "build:umd": "rspack --config rspack.config.js",
-    "dev": "tsc -b -w",
-    "prepublish": "npm run build",
-    "doc": "ts2md",
-    "docs:serve": "mkdocs serve",
-    "docs:build": "mkdocs build"
-  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/bsv-blockchain/ts-sdk.git"
+    "url": "git+https://github.com/bsv-blockchain/ts-stack.git",
+    "directory": "packages/sdk"
   },
   "keywords": [
     "BSV",
@@ -247,32 +233,47 @@
   "author": "BSV Blockchain Association",
   "license": "SEE LICENSE IN LICENSE.txt",
   "bugs": {
-    "url": "https://github.com/bsv-blockchain/ts-sdk/issues"
+    "url": "https://github.com/bsv-blockchain/ts-stack/issues"
   },
-  "homepage": "https://github.com/bsv-blockchain/ts-sdk#readme",
+  "homepage": "https://github.com/bsv-blockchain/ts-stack/tree/main/packages/sdk#readme",
   "devDependencies": {
-    "@eslint/js": "^10.0.1",
+    "@eslint/js": "^9.39.1",
     "@jest/globals": "^30.3.0",
     "@rspack/cli": "^2.0.0",
-    "@rspack/core": "^2.0.0",
+    "@rspack/core": "^1.6.1",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.6.0",
-    "eslint": "^10.2.1",
-    "globals": "^17.5.0",
+    "@types/node": "^24.10.1",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
     "jest": "^30.3.0",
     "jest-environment-jsdom": "^30.3.0",
     "ts-jest": "^29.4.9",
-    "ts-loader": "^9.5.7",
+    "ts-loader": "^9.5.4",
     "ts-standard": "^12.0.2",
     "ts2md": "^0.2.8",
     "tsconfig-to-dual-package": "^1.2.0",
-    "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.0"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.4"
   },
   "ts-standard": {
     "project": "tsconfig.eslint.json",
     "ignore": [
       "dist"
     ]
+  },
+  "scripts": {
+    "test": "npm run build && jest",
+    "test:watch": "npm run build && jest --watch",
+    "test:coverage": "npm run build && jest --coverage --watchman=false",
+    "lint:ci": "ts-standard src/**/*.ts",
+    "lint": "ts-standard --fix src/**/*.ts",
+    "build": "npm run build:ts && npm run build:umd",
+    "build:ts": "tsc -b && tsconfig-to-dual-package tsconfig.cjs.json",
+    "build:umd": "rspack --config rspack.config.js",
+    "dev": "tsc -b -w",
+    "prepublish": "npm run build",
+    "doc": "ts2md",
+    "docs:serve": "mkdocs serve",
+    "docs:build": "mkdocs build"
   }
-}
+}

package/src/kvstore/GlobalKVStore.ts

@@ -106,9 +106,7 @@ export class GlobalKVStore {
    * @returns {Promise<KVStoreEntry | KVStoreEntry[] | undefined>} Single entry for key+controller queries, array for all other queries
    */
   async get (query: KVStoreQuery, options: KVStoreGetOptions = {}): Promise<KVStoreEntry | KVStoreEntry[] | undefined> {
-    if (Object.keys(query).length === 0) {
-      throw new Error('Must specify either key, controller, or protocolID')
-    }
+    this.validateQuerySelectors(query)
     if (query.key != null && query.controller != null) {
       // Specific key+controller query - return single entry
       const entries = await this.queryOverlay(query, options)
@@ -117,6 +115,24 @@ export class GlobalKVStore {
     return await this.queryOverlay(query, options)
   }
 
+  /**
+   * Ensures lookup pagination and ordering options are only used with a real KV selector.
+   *
+   * @param {KVStoreQuery} query - Query parameters sent to overlay.
+   * @throws {Error} If the query does not include a valid selector.
+   */
+  private validateQuerySelectors (query: KVStoreQuery): void {
+    const hasSelector =
+      (typeof query.key === 'string' && query.key.length > 0) ||
+      (typeof query.controller === 'string' && query.controller.length > 0) ||
+      (Array.isArray(query.protocolID) && query.protocolID.length === 2) ||
+      (Array.isArray(query.tags) && query.tags.length > 0)
+
+    if (!hasSelector) {
+      throw new Error('Must specify at least one selector: key, controller, protocolID, or tags')
+    }
+  }
+
   /**
    * Sets a key-value pair. The current user (wallet identity) becomes the controller.
    *

package/src/kvstore/__tests/GlobalKVStore.test.ts

@@ -577,7 +577,30 @@ describe('GlobalKVStore', () => {
 
     describe('sad paths', () => {
       it('rejects when no query parameters provided', async () => {
-        await expect(kvStore.get({})).rejects.toThrow('Must specify either key, controller, or protocolID')
+        await expect(kvStore.get({})).rejects.toThrow(
+          'Must specify at least one selector: key, controller, protocolID, or tags'
+        )
+      })
+
+      it('rejects pagination-only queries before resolving overlay hosts', async () => {
+        await expect(kvStore.get({ limit: 10 })).rejects.toThrow(
+          'Must specify at least one selector: key, controller, protocolID, or tags'
+        )
+        expect(mockResolver.query).not.toHaveBeenCalled()
+      })
+
+      it('rejects ordering-only queries before resolving overlay hosts', async () => {
+        await expect(kvStore.get({ sortOrder: 'desc' })).rejects.toThrow(
+          'Must specify at least one selector: key, controller, protocolID, or tags'
+        )
+        expect(mockResolver.query).not.toHaveBeenCalled()
+      })
+
+      it('rejects empty tag selector queries before resolving overlay hosts', async () => {
+        await expect(kvStore.get({ tags: [] })).rejects.toThrow(
+          'Must specify at least one selector: key, controller, protocolID, or tags'
+        )
+        expect(mockResolver.query).not.toHaveBeenCalled()
       })
 
       it('propagates overlay errors', async () => {

package/src/kvstore/types.ts

@@ -37,7 +37,8 @@ export interface KVStoreConfig {
 
 /**
  * Query parameters for KVStore lookups from overlay services.
- * Used when searching for existing key-value pairs in the network.
+ * Must include at least one selector: key, controller, protocolID, or non-empty tags.
+ * Pagination and ordering fields only refine selector-based lookups.
  */
 export interface KVStoreQuery {
   key?: string

package/docs/swagger/dist/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024 Peter Evans
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/docs/swagger/dist/index.css

@@ -1,16 +0,0 @@
-html {
-    box-sizing: border-box;
-    overflow: -moz-scrollbars-vertical;
-    overflow-y: scroll;
-}
-
-*,
-*:before,
-*:after {
-    box-sizing: inherit;
-}
-
-body {
-    margin: 0;
-    background: #fafafa;
-}

package/docs/swagger/dist/oauth2-redirect.html

@@ -1,79 +0,0 @@
-<!doctype html>
-<html lang="en-US">
-<head>
-    <title>Swagger UI: OAuth2 Redirect</title>
-</head>
-<body>
-<script>
-    'use strict';
-    function run () {
-        var oauth2 = window.opener.swaggerUIRedirectOauth2;
-        var sentState = oauth2.state;
-        var redirectUrl = oauth2.redirectUrl;
-        var isValid, qp, arr;
-
-        if (/code|token|error/.test(window.location.hash)) {
-            qp = window.location.hash.substring(1).replace('?', '&');
-        } else {
-            qp = location.search.substring(1);
-        }
-
-        arr = qp.split("&");
-        arr.forEach(function (v,i,_arr) { _arr[i] = '"' + v.replace('=', '":"') + '"';});
-        qp = qp ? JSON.parse('{' + arr.join() + '}',
-                function (key, value) {
-                    return key === "" ? value : decodeURIComponent(value);
-                }
-        ) : {};
-
-        isValid = qp.state === sentState;
-
-        if ((
-          oauth2.auth.schema.get("flow") === "accessCode" ||
-          oauth2.auth.schema.get("flow") === "authorizationCode" ||
-          oauth2.auth.schema.get("flow") === "authorization_code"
-        ) && !oauth2.auth.code) {
-            if (!isValid) {
-                oauth2.errCb({
-                    authId: oauth2.auth.name,
-                    source: "auth",
-                    level: "warning",
-                    message: "Authorization may be unsafe, passed state was changed in server. The passed state wasn't returned from auth server."
-                });
-            }
-
-            if (qp.code) {
-                delete oauth2.state;
-                oauth2.auth.code = qp.code;
-                oauth2.callback({auth: oauth2.auth, redirectUrl: redirectUrl});
-            } else {
-                let oauthErrorMsg;
-                if (qp.error) {
-                    oauthErrorMsg = "["+qp.error+"]: " +
-                        (qp.error_description ? qp.error_description+ ". " : "no accessCode received from the server. ") +
-                        (qp.error_uri ? "More info: "+qp.error_uri : "");
-                }
-
-                oauth2.errCb({
-                    authId: oauth2.auth.name,
-                    source: "auth",
-                    level: "error",
-                    message: oauthErrorMsg || "[Authorization failed]: no accessCode received from the server."
-                });
-            }
-        } else {
-            oauth2.callback({auth: oauth2.auth, token: qp, isValid: isValid, redirectUrl: redirectUrl});
-        }
-        window.close();
-    }
-
-    if (document.readyState !== 'loading') {
-        run();
-    } else {
-        document.addEventListener('DOMContentLoaded', function () {
-            run();
-        });
-    }
-</script>
-</body>
-</html>

package/docs/swagger/dist/swagger-initializer.js

@@ -1,20 +0,0 @@
-window.onload = function() {
-  //<editor-fold desc="Changeable Configuration Block">
-
-  // the following lines will be replaced by docker/configurator, when it runs in a docker-container
-  window.ui = SwaggerUIBundle({
-    url: "swagger.yaml",
-    dom_id: '#swagger-ui',
-    deepLinking: true,
-    presets: [
-      SwaggerUIBundle.presets.apis,
-      SwaggerUIStandalonePreset
-    ],
-    plugins: [
-      SwaggerUIBundle.plugins.DownloadUrl
-    ],
-    layout: "StandaloneLayout"
-  });
-
-  //</editor-fold>
-};