@bsv/wallet-toolbox 1.7.13 → 1.7.15

package/.github/workflows/push.yaml

@@ -1,71 +1,68 @@
-on: [push, pull_request]
-name: Build and Test
+name: Test and Publish Package
+
+on:
+  push:
+    branches:
+      - master
+      - main
+  pull_request:
+
+permissions:
+  id-token: write  # Required for OIDC
+  contents: read
+
 jobs:
   test:
-    name: Build & Test
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [18.x, 20.x, 22.x]
     steps:
-    - uses: actions/checkout@v2
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v1
-      with:
-        node-version: ${{ matrix.node-version }}
-    - name: Cache node_modules
-      id: cache-modules
-      uses: actions/cache@v4
-      with:
-        path: node_modules
-        key: ${{ matrix.node-version }}-${{ runner.OS }}-build-${{ hashFiles('package.json') }}
-    - name: Build
-      if: steps.cache-modules.outputs.cache-hit != 'true'
-      run: npm install
-    - name: Test
-      run: npm run test
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+
+      - run: npm ci
+      - run: npm run build --if-present
+      - run: npm test
+
   publish:
-    name: Publish
-    needs: test
     runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+    needs: test
+    # Only run on push to master/main, not on PRs
+    if: github.event_name == 'push' && (github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main')
     steps:
-    - name: Authenticate with registry
-      run: echo "//registry.npmjs.org/:_authToken=$NODE_AUTH_TOKEN" > ~/.npmrc
-      env:
-        NODE_AUTH_TOKEN: ${{ secrets.BSV_NPM_TOKEN }}
-    - uses: actions/checkout@v3
-    - name: Use Node.js 20.x
-      uses: actions/setup-node@v1
-      with:
-        node-version: 20.x
-      env:
-        NODE_AUTH_TOKEN: ${{ secrets.BSV_NPM_TOKEN }}
-    - name: Cache node_modules
-      id: cache-modules
-      uses: actions/cache@v4
-      with:
-        path: node_modules
-        key: 20.x-${{ runner.OS }}-build-${{ hashFiles('package.json') }}
-    - name: Install deps
-      if: steps.cache-modules.outputs.cache-hit != 'true'
-      run: npm install
-    - name: Build
-      run: npm run build
-    - name: Publish to NPM (expected to fail if version was not bumped manually)
-      run: npm publish --provenance --access public
-      env:
-        NODE_AUTH_TOKEN: ${{ secrets.BSV_NPM_TOKEN }}
-    - name: Publish client to NPM (expected to fail if version was not bumped manually)
-      run: npm publish --provenance --access public
-      working-directory: client
-      env:
-        NODE_AUTH_TOKEN: ${{ secrets.BSV_NPM_TOKEN }}
-    - name: Publish mobile to NPM (expected to fail if version was not bumped manually)
-      run: npm publish --provenance --access public
-      working-directory: mobile
-      env:
-        NODE_AUTH_TOKEN: ${{ secrets.BSV_NPM_TOKEN }}
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+
+      - run: npm ci
+      - run: npm run build --if-present
+
+      - name: Check if version already published
+        id: check-version
+        run: |
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          PACKAGE_VERSION=$(node -p "require('./package.json').version")
+
+          echo "Package: $PACKAGE_NAME@$PACKAGE_VERSION"
+
+          # Check if this version exists on npm
+          if npm view "$PACKAGE_NAME@$PACKAGE_VERSION" version 2>/dev/null; then
+            echo "Version $PACKAGE_VERSION already published"
+            echo "should_publish=false" >> $GITHUB_OUTPUT
+          else
+            echo "Version $PACKAGE_VERSION not yet published"
+            echo "should_publish=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Publish to npm
+        if: steps.check-version.outputs.should_publish == 'true'
+        run: npm publish
+
+      - name: Skip publishing
+        if: steps.check-version.outputs.should_publish == 'false'
+        run: echo "Skipping publish - version already exists on npm"

package/CHANGELOG.md

@@ -4,6 +4,11 @@ This document captures the history of significant changes to the wallet-toolbox
 The git commit history contains the details but is unable to draw
 attention to changes that materially alter behavior or extend functionality.
 
+## wallet-toolbox 1.7.15
+
+- Fix specOpInvalidChange to always ignore unbasketted outputs.
+- Update dependency to bsv/sdk 1.9.24
+
 ## wallet-toolbox 1.7.13
 
 - Fix moreSatoshisNeeded amount in WERR_INSUFFICIENT_FUNDS (was releasing allocated change before saving value).

package/docs/client.md

@@ -4004,17 +4004,16 @@ encryptWalletMetadata?: boolean
 
 ###### Property permissionModules
 
-A map of P-basket permission scheme modules.
+A map of P-basket/protocol permission scheme modules.
 
 Keys are scheme IDs (e.g., "btms"), values are PermissionsModule instances.
 
-Each module handles basket IDs of the form: `p <schemeID> <rest...>`
+Each module handles basket/protocol names of the form: `p <schemeID> <rest...>`
 
-The WalletPermissionManager detects P-prefix baskets and delegates
+The WalletPermissionManager detects P-prefix baskets/protocols and delegates
 request/response transformation to the corresponding module.
 
-If no module exists for a given schemeID, the wallet MUST reject access
-according to the P-Baskets specification.
+If no module exists for a given schemeID, the wallet will reject access.
 
 ```ts
 permissionModules?: Record<string, PermissionsModule>
@@ -4179,19 +4178,17 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ---
 ##### Interface: PermissionsModule
 
-A permissions module handles request/response transformation for a specific P-basket scheme.
+A permissions module handles request/response transformation for a specific P-protocol or P-basket scheme under BRC-98/99.
 Modules are registered in the config mapped by their scheme ID.
 
 ```ts
 export interface PermissionsModule {
     onRequest(req: {
         method: string;
-        args: any[];
+        args: object;
         originator: string;
     }): Promise<{
-        method: string;
-        args: any[];
-        originator: string;
+        args: object;
     }>;
     onResponse(res: any, context: {
         method: string;
@@ -4203,23 +4200,21 @@ export interface PermissionsModule {
 ###### Method onRequest
 
 Transforms the request before it's passed to the underlying wallet.
-Can modify method name, args, or originator as needed.
+Can check and enforce permissions, throw errors, or modify any arguments as needed prior to invocation.
 
 ```ts
 onRequest(req: {
     method: string;
-    args: any[];
+    args: object;
     originator: string;
 }): Promise<{
-    method: string;
-    args: any[];
-    originator: string;
+    args: object;
 }>
 ```
 
 Returns
 
-Transformed request that will be passed to the underlying wallet
+Transformed arguments that will be passed to the underlying wallet
 
 Argument Details
 
@@ -9000,6 +8995,7 @@ export class CWIStyleWalletManager implements WalletInterface {
     async provideRecoveryKey(recoveryKey: number[]): Promise<void> 
     saveSnapshot(): number[] 
     async loadSnapshot(snapshot: number[]): Promise<void> 
+    async syncUMPToken(): Promise<boolean> 
     destroy(): void 
     listProfiles(): Array<{
         id: number[];
@@ -16740,10 +16736,10 @@ Simplifications:
 Confirms for each availbleChange output that it remains available as they are allocated and selects alternate if not.
 
 ```ts
-export async function generateChangeSdk(params: GenerateChangeSdkParams, allocateChangeInput: (targetSatoshis: number, exactSatoshis?: number) => Promise<GenerateChangeSdkChangeInput | undefined>, releaseChangeInput: (outputId: number) => Promise<void>): Promise<GenerateChangeSdkResult> 
+export async function generateChangeSdk(params: GenerateChangeSdkParams, allocateChangeInput: (targetSatoshis: number, exactSatoshis?: number) => Promise<GenerateChangeSdkChangeInput | undefined>, releaseChangeInput: (outputId: number) => Promise<void>, logger?: WalletLoggerInterface): Promise<GenerateChangeSdkResult> 
 ```
 
-See also: [GenerateChangeSdkChangeInput](./storage.md#interface-generatechangesdkchangeinput), [GenerateChangeSdkParams](./storage.md#interface-generatechangesdkparams), [GenerateChangeSdkResult](./storage.md#interface-generatechangesdkresult)
+See also: [GenerateChangeSdkChangeInput](./storage.md#interface-generatechangesdkchangeinput), [GenerateChangeSdkParams](./storage.md#interface-generatechangesdkparams), [GenerateChangeSdkResult](./storage.md#interface-generatechangesdkresult), [logger](./client.md#variable-logger)
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
 
@@ -18923,6 +18919,8 @@ getBasketToSpecOp: () => Record<string, ListOutputsSpecOp> = () => {
                 const filteredOutputs: TableOutput[] = [];
                 const services = s.getServices();
                 for (const o of outputs) {
+                    if (!o.basketId)
+                        continue;
                     await s.validateOutputScript(o);
                     let ok: boolean | undefined = false;
                     if (o.lockingScript && o.lockingScript.length > 0) {

package/docs/storage.md

@@ -4672,10 +4672,10 @@ Simplifications:
 Confirms for each availbleChange output that it remains available as they are allocated and selects alternate if not.
 
 ```ts
-export async function generateChangeSdk(params: GenerateChangeSdkParams, allocateChangeInput: (targetSatoshis: number, exactSatoshis?: number) => Promise<GenerateChangeSdkChangeInput | undefined>, releaseChangeInput: (outputId: number) => Promise<void>): Promise<GenerateChangeSdkResult> 
+export async function generateChangeSdk(params: GenerateChangeSdkParams, allocateChangeInput: (targetSatoshis: number, exactSatoshis?: number) => Promise<GenerateChangeSdkChangeInput | undefined>, releaseChangeInput: (outputId: number) => Promise<void>, logger?: WalletLoggerInterface): Promise<GenerateChangeSdkResult> 
 ```
 
-See also: [GenerateChangeSdkChangeInput](./storage.md#interface-generatechangesdkchangeinput), [GenerateChangeSdkParams](./storage.md#interface-generatechangesdkparams), [GenerateChangeSdkResult](./storage.md#interface-generatechangesdkresult)
+See also: [GenerateChangeSdkChangeInput](./storage.md#interface-generatechangesdkchangeinput), [GenerateChangeSdkParams](./storage.md#interface-generatechangesdkparams), [GenerateChangeSdkResult](./storage.md#interface-generatechangesdkresult), [logger](./client.md#variable-logger)
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
 
@@ -5204,6 +5204,8 @@ getBasketToSpecOp: () => Record<string, ListOutputsSpecOp> = () => {
                 const filteredOutputs: TableOutput[] = [];
                 const services = s.getServices();
                 for (const o of outputs) {
+                    if (!o.basketId)
+                        continue;
                     await s.validateOutputScript(o);
                     let ok: boolean | undefined = false;
                     if (o.lockingScript && o.lockingScript.length > 0) {

package/docs/wallet.md

@@ -4003,17 +4003,16 @@ encryptWalletMetadata?: boolean
 
 ###### Property permissionModules
 
-A map of P-basket permission scheme modules.
+A map of P-basket/protocol permission scheme modules.
 
 Keys are scheme IDs (e.g., "btms"), values are PermissionsModule instances.
 
-Each module handles basket IDs of the form: `p <schemeID> <rest...>`
+Each module handles basket/protocol names of the form: `p <schemeID> <rest...>`
 
-The WalletPermissionManager detects P-prefix baskets and delegates
+The WalletPermissionManager detects P-prefix baskets/protocols and delegates
 request/response transformation to the corresponding module.
 
-If no module exists for a given schemeID, the wallet MUST reject access
-according to the P-Baskets specification.
+If no module exists for a given schemeID, the wallet will reject access.
 
 ```ts
 permissionModules?: Record<string, PermissionsModule>
@@ -4178,19 +4177,17 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 ---
 ##### Interface: PermissionsModule
 
-A permissions module handles request/response transformation for a specific P-basket scheme.
+A permissions module handles request/response transformation for a specific P-protocol or P-basket scheme under BRC-98/99.
 Modules are registered in the config mapped by their scheme ID.
 
 ```ts
 export interface PermissionsModule {
     onRequest(req: {
         method: string;
-        args: any[];
+        args: object;
         originator: string;
     }): Promise<{
-        method: string;
-        args: any[];
-        originator: string;
+        args: object;
     }>;
     onResponse(res: any, context: {
         method: string;
@@ -4202,23 +4199,21 @@ export interface PermissionsModule {
 ###### Method onRequest
 
 Transforms the request before it's passed to the underlying wallet.
-Can modify method name, args, or originator as needed.
+Can check and enforce permissions, throw errors, or modify any arguments as needed prior to invocation.
 
 ```ts
 onRequest(req: {
     method: string;
-    args: any[];
+    args: object;
     originator: string;
 }): Promise<{
-    method: string;
-    args: any[];
-    originator: string;
+    args: object;
 }>
 ```
 
 Returns
 
-Transformed request that will be passed to the underlying wallet
+Transformed arguments that will be passed to the underlying wallet
 
 Argument Details
 
@@ -8999,6 +8994,7 @@ export class CWIStyleWalletManager implements WalletInterface {
     async provideRecoveryKey(recoveryKey: number[]): Promise<void> 
     saveSnapshot(): number[] 
     async loadSnapshot(snapshot: number[]): Promise<void> 
+    async syncUMPToken(): Promise<boolean> 
     destroy(): void 
     listProfiles(): Array<{
         id: number[];
@@ -16739,10 +16735,10 @@ Simplifications:
 Confirms for each availbleChange output that it remains available as they are allocated and selects alternate if not.
 
 ```ts
-export async function generateChangeSdk(params: GenerateChangeSdkParams, allocateChangeInput: (targetSatoshis: number, exactSatoshis?: number) => Promise<GenerateChangeSdkChangeInput | undefined>, releaseChangeInput: (outputId: number) => Promise<void>): Promise<GenerateChangeSdkResult> 
+export async function generateChangeSdk(params: GenerateChangeSdkParams, allocateChangeInput: (targetSatoshis: number, exactSatoshis?: number) => Promise<GenerateChangeSdkChangeInput | undefined>, releaseChangeInput: (outputId: number) => Promise<void>, logger?: WalletLoggerInterface): Promise<GenerateChangeSdkResult> 
 ```
 
-See also: [GenerateChangeSdkChangeInput](./storage.md#interface-generatechangesdkchangeinput), [GenerateChangeSdkParams](./storage.md#interface-generatechangesdkparams), [GenerateChangeSdkResult](./storage.md#interface-generatechangesdkresult)
+See also: [GenerateChangeSdkChangeInput](./storage.md#interface-generatechangesdkchangeinput), [GenerateChangeSdkParams](./storage.md#interface-generatechangesdkparams), [GenerateChangeSdkResult](./storage.md#interface-generatechangesdkresult), [logger](./client.md#variable-logger)
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
 
@@ -18922,6 +18918,8 @@ getBasketToSpecOp: () => Record<string, ListOutputsSpecOp> = () => {
                 const filteredOutputs: TableOutput[] = [];
                 const services = s.getServices();
                 for (const o of outputs) {
+                    if (!o.basketId)
+                        continue;
                     await s.validateOutputScript(o);
                     let ok: boolean | undefined = false;
                     if (o.lockingScript && o.lockingScript.length > 0) {

package/mobile/node_modules/.package-lock.json

@@ -0,0 +1,14 @@
+{
+  "name": "@bsv/wallet-toolbox-mobile",
+  "version": "1.7.15",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "node_modules/@bsv/sdk": {
+      "version": "1.9.24",
+      "resolved": "https://registry.npmjs.org/@bsv/sdk/-/sdk-1.9.24.tgz",
+      "integrity": "sha512-ldDJPs+niAm79GMvSmOXWXLthOYb+x1S9Aroo5T0Kpvc3o86FZLO4YFJi3Hn0AtqmGWHvBLf4aviBmUpWbg8FA==",
+      "license": "SEE LICENSE IN LICENSE.txt"
+    }
+  }
+}

package/mobile/node_modules/@bsv/sdk/LICENSE.txt

@@ -0,0 +1,28 @@
+Open BSV License version 4
+
+Copyright (c) 2023 BSV Blockchain Association ("Bitcoin Association")
+ 
+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:
+ 
+1 - The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+2 - The Software, and any software that is derived from the Software or parts thereof,
+can only be used on the Bitcoin SV blockchains. The Bitcoin SV blockchains are defined,
+for purposes of this license, as the Bitcoin blockchain containing block height #556767
+with the hash "000000000000000001d956714215d96ffc00e0afda4cd0a96c96f8d802b1662b" and
+that contains the longest persistent chain of blocks accepted by this Software and which are valid under the rules set forth in the Bitcoin white paper (S. Nakamoto, Bitcoin: A Peer-to-Peer Electronic Cash System, posted online October 2008) and the latest version of this Software available in this repository or another repository designated by Bitcoin Association,
+as well as the test blockchains that contain the longest persistent chains of blocks accepted by this Software and which are valid under the rules set forth in the Bitcoin whitepaper (S. Nakamoto, Bitcoin: A Peer-to-Peer Electronic Cash System, posted online October 2008) and the latest version of this Software available in this repository, or another repository designated by Bitcoin Association
+ 
+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/mobile/node_modules/@bsv/sdk/README.md

@@ -0,0 +1,133 @@
+# BSV SDK
+
+[![codecov](https://codecov.io/gh/bsv-blockchain/ts-sdk/branch/master/graph/badge.svg)](https://codecov.io/gh/bsv-blockchain/ts-sdk)
+[![npm version](https://badge.fury.io/js/@bsv%2Fsdk.svg)](https://badge.fury.io/js/@bsv%2Fsdk)
+[![Build Status](https://github.com/bsv-blockchain/ts-sdk/actions/workflows/push.yaml/badge.svg)](https://github.com/bsv-blockchain/ts-sdk/actions/workflows/push.yaml)
+
+BSV BLOCKCHAIN | Software Development Kit for JavaScript and TypeScript
+
+Welcome to the BSV Blockchain Libraries Project, the comprehensive TypeScript SDK designed to provide an updated and unified layer for developing scalable applications on the BSV Blockchain. This SDK addresses the limitations of previous tools by offering a fresh, peer-to-peer approach, adhering to SPV, and ensuring privacy and scalability.
+
+## Table of Contents
+
+1. [Objective](#objective)
+2. [Getting Started](#getting-started)
+3. [Features & Deliverables](#features--deliverables)
+4. [Documentation](#documentation)
+5. [Contribution Guidelines](#contribution-guidelines)
+6. [Support & Contacts](#support--contacts)
+
+## Objective
+
+The BSV Blockchain Libraries Project aims to structure and maintain a middleware layer of the BSV Blockchain technology stack. By facilitating the development and maintenance of core libraries, it serves as an essential toolkit for developers looking to build on the BSV Blockchain.
+
+## Getting Started
+
+### Installation
+
+To install the SDK, run:
+
+```bash
+npm install @bsv/sdk
+```
+
+### Basic Usage
+
+Here's a simple example of using the SDK to create and sign a transaction:
+
+```javascript
+import { PrivateKey, P2PKH, Transaction, ARC } from '@bsv/sdk'
+
+const privKey = PrivateKey.fromWif('L5EY1SbTvvPNSdCYQe1EJHfXCBBT4PmnF6CDbzCm9iifZptUvDGB')
+
+const sourceTransaction = Transaction.fromHex('0200000001849c6419aec8b65d747cb72282cc02f3fc26dd018b46962f5de48957fac50528020000006a473044022008a60c611f3b48eaf0d07b5425d75f6ce65c3730bd43e6208560648081f9661b0220278fa51877100054d0d08e38e069b0afdb4f0f9d38844c68ee2233ace8e0de2141210360cd30f72e805be1f00d53f9ccd47dfd249cbb65b0d4aee5cfaf005a5258be37ffffffff03d0070000000000001976a914acc4d7c37bc9d0be0a4987483058a2d842f2265d88ac75330100000000001976a914db5b7964eecb19fcab929bf6bd29297ec005d52988ac809f7c09000000001976a914c0b0a42e92f062bdbc6a881b1777eed1213c19eb88ac00000000')
+
+const version = 1
+const input = {
+  sourceTransaction,
+  sourceOutputIndex: 0,
+  unlockingScriptTemplate: new P2PKH().unlock(privKey),
+}
+const output = {
+  lockingScript: new P2PKH().lock(privKey.toAddress()),
+  change: true
+}
+
+const tx = new Transaction(version, [input], [output])
+await tx.fee()
+await tx.sign()
+
+await tx.broadcast()
+```
+
+For a more detailed tutorial and advanced examples, check our [Documentation](#documentation).
+
+## Features & Deliverables
+
+- **Sound Cryptographic Primitives**: Secure key management, signature computations, and encryption protocols.
+
+- **Script Level Constructs**: Network-compliant script interpreter with support for custom scripts and serialization formats.
+
+- **Transaction Construction and Signing**: Comprehensive transaction builder API, ensuring versatile and secure transaction creation.
+
+- **Transaction Broadcast Management**: Mechanisms to send transactions to both miners and overlays, ensuring extensibility and future-proofing.
+
+- **Merkle Proof Verification**: Tools for representing and verifying merkle proofs, adhering to various serialization standards.
+
+- **Serializable SPV Structures**: Structures and interfaces for full SPV verification.
+
+- **Secure Encryption and Signed Messages**: Enhanced mechanisms for encryption and digital signatures, replacing outdated methods.
+
+- **P2P Authentication**: Robust peer-to-peer authentication mechanisms to ensure secure connections between parties.
+
+- **Identity**: Comprehensive identity management system supporting identity verification and certificate management.
+
+- **Key Value Store**: Distributed key-value store for decentralized data storage and retrieval.
+
+- **Distributed Storage**: Scalable and secure distributed data storage solutions to support blockchain applications.
+
+- **Wallet Interface**: Standardized interface for wallet operations, supporting multiple cryptocurrencies and protocols.
+
+- **Overlay Tools**: Advanced tools for overlay network management and optimization.
+
+- **Distributed Protocol and Certificate Registration**: Efficient systems for registering and managing distributed protocols and certificates.
+
+## Documentation
+
+Comprehensive documentation is available in several formats:
+
+- **[📚 Online Documentation](https://bsv-blockchain.github.io/ts-sdk)**: Our complete documentation:
+    - **[🚀 Tutorials](https://bsv-blockchain.github.io/ts-sdk/tutorials/)**: Step-by-step lessons to learn by doing
+    - **[🔧 How-To Guides](https://bsv-blockchain.github.io/ts-sdk/guides/)**: Practical solutions to specific problems
+    - **[📚 Reference](https://bsv-blockchain.github.io/ts-sdk/reference/)**: Complete technical specifications and API documentation
+    - **[🏗️ Concepts](https://bsv-blockchain.github.io/ts-sdk/concepts/)**: Architecture and design explanations
+- **[⚡ Examples](https://docs.bsvblockchain.org/guides/sdks/ts/examples)**: Practical code examples
+- **Code Annotations**: The SDK is richly documented with code-level annotations that show up in editors like VSCode
+
+## Contribution Guidelines
+
+We're always looking for contributors to help us improve the SDK. Whether it's bug reports, feature requests, or pull requests - all contributions are welcome.
+
+1. **Fork & Clone**: Fork this repository and clone it to your local machine.
+2. **Set Up**: Run `npm install` to install all dependencies.
+3. **Make Changes**: Create a new branch and make your changes.
+4. **Test**: Ensure all tests pass by running `npm test`.
+5. **Commit**: Commit your changes and push to your fork.
+6. **Pull Request**: Open a pull request from your fork to this repository.
+For more details, check the [contribution guidelines](./CONTRIBUTING.md).
+
+For information on past releases, check out the [changelog](./CHANGELOG.md). For future plans, check the [roadmap](./ROADMAP.md)!
+
+## Support & Contacts
+
+Project Owners: Thomas Giacomo and Darren Kellenschwiler
+
+Development Team Lead: Ty Everett
+
+For questions, bug reports, or feature requests, please open an issue on GitHub or contact us directly.
+
+## License
+
+The license for the code in this repository is the Open BSV License. Refer to [LICENSE.txt](./LICENSE.txt) for the license text.
+
+Thank you for being a part of the BSV Blockchain Libraries Project. Let's build the future of BSV Blockchain together!

package/mobile/node_modules/@bsv/sdk/dist/cjs/mod.js

@@ -0,0 +1,36 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./src/primitives/index.js"), exports);
+__exportStar(require("./src/script/index.js"), exports);
+__exportStar(require("./src/script/templates/index.js"), exports);
+__exportStar(require("./src/transaction/index.js"), exports);
+__exportStar(require("./src/transaction/fee-models/index.js"), exports);
+__exportStar(require("./src/transaction/broadcasters/index.js"), exports);
+__exportStar(require("./src/transaction/chaintrackers/index.js"), exports);
+__exportStar(require("./src/transaction/http/index.js"), exports);
+__exportStar(require("./src/messages/index.js"), exports);
+__exportStar(require("./src/compat/index.js"), exports);
+__exportStar(require("./src/totp/index.js"), exports);
+__exportStar(require("./src/wallet/index.js"), exports);
+__exportStar(require("./src/wallet/substrates/index.js"), exports);
+__exportStar(require("./src/auth/index.js"), exports);
+__exportStar(require("./src/overlay-tools/index.js"), exports);
+__exportStar(require("./src/storage/index.js"), exports);
+__exportStar(require("./src/identity/index.js"), exports);
+__exportStar(require("./src/registry/index.js"), exports);
+__exportStar(require("./src/kvstore/index.js"), exports);
+//# sourceMappingURL=mod.js.map

package/mobile/node_modules/@bsv/sdk/dist/cjs/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../mod.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAAyC;AACzC,wDAAqC;AACrC,kEAA+C;AAC/C,6DAA0C;AAC1C,wEAAqD;AACrD,0EAAuD;AACvD,2EAAwD;AACxD,kEAA+C;AAC/C,0DAAuC;AACvC,wDAAqC;AACrC,sDAAmC;AACnC,wDAAqC;AACrC,mEAAgD;AAChD,sDAAmC;AACnC,+DAA4C;AAC5C,yDAAsC;AACtC,0DAAuC;AACvC,0DAAuC;AACvC,yDAAsC"}