Merge branch 'master' into feature/globalKVStore-withDoubleSpendRetry

Author: BraydenLangley

.github/workflows/benchmark-report.yml

@@ -0,0 +1,85 @@
+name: Benchmark Comparison
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  benchmarks:
+    name: Benchmarks (Node 22)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - name: Checkout PR branch
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build PR branch
+        run: npm run build
+
+      - name: Run PR benchmarks
+        run: node scripts/run-benchmarks.js --repo . --output pr-benchmarks.json
+
+      - name: Checkout master baseline
+        uses: actions/checkout@v4
+        with:
+          ref: master
+          path: master
+
+      - name: Install dependencies (master)
+        working-directory: master
+        run: npm ci
+
+      - name: Build master
+        working-directory: master
+        run: npm run build
+
+      - name: Run master benchmarks
+        run: node scripts/run-benchmarks.js --repo master --output master-benchmarks.json
+
+      - name: Capture baseline sha
+        id: baseline_sha
+        run: echo "value=$(cd master && git rev-parse HEAD)" >> "$GITHUB_OUTPUT"
+
+      - name: Generate benchmark report
+        run: >
+          node scripts/format-benchmark-comment.js
+          --baseline master-benchmarks.json
+          --branch pr-benchmarks.json
+          --output benchmark-report.md
+          --branch-ref $GITHUB_SHA
+          --baseline-ref ${{ steps.baseline_sha.outputs.value }}
+
+      - name: Upload benchmark artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: benchmark-results
+          path: |
+            pr-benchmarks.json
+            master-benchmarks.json
+            benchmark-report.md
+
+      - name: Comment on PR
+        if: github.event.pull_request.number != ''
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const fs = require('fs');
+            const body = fs.readFileSync('benchmark-report.md', 'utf8');
+            await github.rest.issues.createComment({
+              ...context.repo,
+              issue_number: context.payload.pull_request.number,
+              body
+            });

CHANGELOG.md

@@ -1,10 +1,14 @@
 # CHANGELOG for `@bsv/sdk`
 
-All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec2.0.0.html).
 
 ## Table of Contents
 
 - [Unreleased](#unreleased)
+- [1.9.1 - 2025-11-10](#191---2025-11-10)
+- [1.9.0 - 2025-11-09](#190---2025-11-09)
+- [1.8.13 - 2025-11-06](#1813---2025-11-06)
+- [1.8.12 - 2025-11-06](#1812---2025-11-06)
 - [1.8.11 - 2025-10-30](#1811---2025-10-30)
 - [1.8.10 - 2025-10-28](#1810---2025-10-28)
 - [1.8.9 - 2025-10-27](#189---2025-10-27)
@@ -171,6 +175,35 @@ All notable changes to this project will be documented in this file. The format
 
 ---
 
+### [1.9.1] - 2025-11-10
+
+### Fixed
+
+- Added support for originator param in LocalKVStore wallet calls.
+
+---
+
+### [1.9.0] - 2025-11-09
+
+### Added
+
+- Faster serialization and caching improvements
+- Use node- and browser-specific fast-paths opportunistically
+- Cache signatures in Spend to avoid repeated verifications
+- Cache serialized values and use Uint8Array in more places
+- These changes are not intended to be breaking, but a minor version increment is performed out of an abundance of caution
+
+---
+
+
+### [1.8.13] - 2025-11-06
+
+### Added
+
+- LookupResolver: Support for custom overlay ranking to allow for expedited lookups and reputation tracking.
+
+---
+
 ### [1.8.12] - 2025-11-06
 
 ### Fixed

benchmarks/serialization-bench.js benchmarks/bn-serialization-bench.jsbenchmarks/serialization-bench.js renamed to benchmarks/bn-serialization-bench.js

@@ -11,6 +11,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 | [LookupResolverConfig](#interface-lookupresolverconfig) |
 | [OverlayBroadcastFacilitator](#interface-overlaybroadcastfacilitator) |
 | [OverlayLookupFacilitator](#interface-overlaylookupfacilitator) |
+| [RankedHost](#interface-rankedhost) |
 | [SHIPBroadcasterConfig](#interface-shipbroadcasterconfig) |
 | [TaggedBEEF](#interface-taggedbeef) |
 
@@ -101,6 +102,10 @@ export interface LookupResolverConfig {
     hostOverrides?: Record<string, string[]>;
     additionalHosts?: Record<string, string[]>;
     cache?: CacheOptions;
+    reputationStorage?: "localStorage" | {
+        get: (key: string) => string | null | undefined;
+        set: (key: string, value: string) => void;
+    };
 }
 ```
 
@@ -150,6 +155,17 @@ The network preset to use, unless other options override it.
 networkPreset?: "mainnet" | "testnet" | "local"
 ```
 
+#### Property reputationStorage
+
+Optional storage for host reputation data.
+
+```ts
+reputationStorage?: "localStorage" | {
+    get: (key: string) => string | null | undefined;
+    set: (key: string, value: string) => void;
+}
+```
+
 #### Property slapTrackers
 
 The list of SLAP trackers queried to resolve Overlay Services hosts for a given lookup service.
@@ -199,6 +215,17 @@ See also: [LookupAnswer](./overlay-tools.md#type-lookupanswer), [LookupQuestion]
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
+---
+### Interface: RankedHost
+
+```ts
+export interface RankedHost extends HostReputationEntry {
+    score: number;
+}
+```
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
 ---
 ### Interface: SHIPBroadcasterConfig
 
@@ -294,6 +321,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 | --- |
 | [HTTPSOverlayBroadcastFacilitator](#class-httpsoverlaybroadcastfacilitator) |
 | [HTTPSOverlayLookupFacilitator](#class-httpsoverlaylookupfacilitator) |
+| [HostReputationTracker](#class-hostreputationtracker) |
 | [LookupResolver](#class-lookupresolver) |
 | [OverlayAdminTokenTemplate](#class-overlayadmintokentemplate) |
 | [TopicBroadcaster](#class-topicbroadcaster) |
@@ -333,6 +361,24 @@ See also: [LookupAnswer](./overlay-tools.md#type-lookupanswer), [LookupQuestion]
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
+---
+### Class: HostReputationTracker
+
+```ts
+export class HostReputationTracker {
+    constructor(store?: KeyValueStore) 
+    reset(): void 
+    recordSuccess(host: string, latencyMs: number): void 
+    recordFailure(host: string, reason?: unknown): void 
+    rankHosts(hosts: string[], now: number = Date.now()): RankedHost[] 
+    snapshot(host: string): HostReputationEntry | undefined 
+}
+```
+
+See also: [RankedHost](./overlay-tools.md#interface-rankedhost)
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
 ---
 ### Class: LookupResolver
 
@@ -569,6 +615,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 | --- |
 | [DEFAULT_SLAP_TRACKERS](#variable-default_slap_trackers) |
 | [DEFAULT_TESTNET_SLAP_TRACKERS](#variable-default_testnet_slap_trackers) |
+| [getOverlayHostReputationTracker](#variable-getoverlayhostreputationtracker) |
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
@@ -599,3 +646,14 @@ DEFAULT_TESTNET_SLAP_TRACKERS: string[] = [
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
 ---
+### Variable: getOverlayHostReputationTracker
+
+```ts
+getOverlayHostReputationTracker = (): HostReputationTracker => globalTracker
+```
+
+See also: [HostReputationTracker](./overlay-tools.md#class-hostreputationtracker)
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
+---