@meshconnect/uwc-bitcoin 0.1.0-snapshot.e930396

package/dist/bitcoin-namespace.d.ts

@@ -0,0 +1,36 @@
+import type { Namespace, Network } from '@meshconnect/uwc-types';
+/** CAIP-2 namespace this module serves. */
+export declare const BITCOIN_NAMESPACE: Namespace;
+/**
+ * Assert `network` is a bip122 network, else throw. Shared by the namespace
+ * module and its transport adapters so the boundary check lives in one place.
+ */
+export declare function assertBitcoinNetwork(network: Network, method: string): void;
+/**
+ * Bitcoin (bip122) namespace module.
+ *
+ * A NAMESPACE module, not a connector — and it has no `connect` of its own.
+ * Connecting belongs to the transport layer: the transport connectors
+ * (`injected-connector`, `wallet-connect-connector`) own wallet discovery,
+ * pairing, and the provider/session lifecycle. This module owns only
+ * Bitcoin-specific operations performed against a transport-supplied
+ * provider/session — enumerating bip122 accounts, signing messages,
+ * building/signing/finalizing PSBTs, and broadcasting. Both transports
+ * dispatch their `bip122` branch into the matching adapter here.
+ *
+ * Those operations, and the provider/session types they take, land on the
+ * `BitcoinTransportAdapter` port in Phase 2 — deferred here so the scaffold
+ * doesn't pre-commit signatures before those types exist.
+ *
+ * Phase 1 (scaffold): namespace identity + the shared network guard only.
+ *
+ * Phased build plan:
+ * https://app.notion.com/p/3a5f862e950a8187b3d3f0e255d13f45
+ */
+export declare class BitcoinNamespace {
+    /** CAIP-2 namespace this module serves. */
+    readonly namespace: Namespace;
+    /** Throws unless `network` is a bip122 network. */
+    assertSupportedNetwork(network: Network): void;
+}
+//# sourceMappingURL=bitcoin-namespace.d.ts.map

package/dist/bitcoin-namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin-namespace.d.ts","sourceRoot":"","sources":["../src/bitcoin-namespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAGhE,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,EAAE,SAAoB,CAAA;AAEpD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO3E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,gBAAgB;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,YAAoB;IAEtC,mDAAmD;IACnD,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAG/C"}

package/dist/bitcoin-namespace.js

@@ -0,0 +1,45 @@
+import { WalletConnectorError } from '@meshconnect/uwc-types';
+/** CAIP-2 namespace this module serves. */
+export const BITCOIN_NAMESPACE = 'bip122';
+/**
+ * Assert `network` is a bip122 network, else throw. Shared by the namespace
+ * module and its transport adapters so the boundary check lives in one place.
+ */
+export function assertBitcoinNetwork(network, method) {
+    if (network.namespace !== BITCOIN_NAMESPACE) {
+        throw new WalletConnectorError({
+            type: 'unknown',
+            message: `${method}: expected a bip122 network but got "${network.id}"`
+        });
+    }
+}
+/**
+ * Bitcoin (bip122) namespace module.
+ *
+ * A NAMESPACE module, not a connector — and it has no `connect` of its own.
+ * Connecting belongs to the transport layer: the transport connectors
+ * (`injected-connector`, `wallet-connect-connector`) own wallet discovery,
+ * pairing, and the provider/session lifecycle. This module owns only
+ * Bitcoin-specific operations performed against a transport-supplied
+ * provider/session — enumerating bip122 accounts, signing messages,
+ * building/signing/finalizing PSBTs, and broadcasting. Both transports
+ * dispatch their `bip122` branch into the matching adapter here.
+ *
+ * Those operations, and the provider/session types they take, land on the
+ * `BitcoinTransportAdapter` port in Phase 2 — deferred here so the scaffold
+ * doesn't pre-commit signatures before those types exist.
+ *
+ * Phase 1 (scaffold): namespace identity + the shared network guard only.
+ *
+ * Phased build plan:
+ * https://app.notion.com/p/3a5f862e950a8187b3d3f0e255d13f45
+ */
+export class BitcoinNamespace {
+    /** CAIP-2 namespace this module serves. */
+    namespace = BITCOIN_NAMESPACE;
+    /** Throws unless `network` is a bip122 network. */
+    assertSupportedNetwork(network) {
+        assertBitcoinNetwork(network, 'BitcoinNamespace.assertSupportedNetwork');
+    }
+}
+//# sourceMappingURL=bitcoin-namespace.js.map

package/dist/bitcoin-namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin-namespace.js","sourceRoot":"","sources":["../src/bitcoin-namespace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D,2CAA2C;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAc,QAAQ,CAAA;AAEpD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,MAAc;IACnE,IAAI,OAAO,CAAC,SAAS,KAAK,iBAAiB,EAAE,CAAC;QAC5C,MAAM,IAAI,oBAAoB,CAAC;YAC7B,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG,MAAM,wCAAwC,OAAO,CAAC,EAAE,GAAG;SACxE,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,2CAA2C;IAClC,SAAS,GAAG,iBAAiB,CAAA;IAEtC,mDAAmD;IACnD,sBAAsB,CAAC,OAAgB;QACrC,oBAAoB,CAAC,OAAO,EAAE,yCAAyC,CAAC,CAAA;IAC1E,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { BitcoinNamespace, assertBitcoinNetwork, BITCOIN_NAMESPACE } from './bitcoin-namespace';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { BitcoinNamespace, assertBitcoinNetwork, BITCOIN_NAMESPACE } from './bitcoin-namespace';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,qBAAqB,CAAA"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@meshconnect/uwc-bitcoin",
+  "version": "0.1.0-snapshot.e930396",
+  "description": "Mesh-owned Bitcoin (bip122) namespace module for Universal Wallet Connector — network-specific logic (PSBT, address/network handling, mempool broadcast) with pluggable transport adapters (Wallet Standard bitcoin:* and WalletConnect bip122), consumed by the injected and walletConnect transport connectors",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@meshconnect/uwc-types": "0.23.0-snapshot.e930396"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "type-check": "tsc --noEmit"
+  }
+}

package/src/bitcoin-namespace.test.ts

@@ -0,0 +1,65 @@
+import { describe, it, expect } from 'vitest'
+import type { Network } from '@meshconnect/uwc-types'
+import { WalletConnectorError } from '@meshconnect/uwc-types'
+import {
+  BitcoinNamespace,
+  assertBitcoinNetwork,
+  BITCOIN_NAMESPACE
+} from './bitcoin-namespace'
+
+const bitcoinNetwork: Network = {
+  internalId: 0,
+  id: 'bip122:000000000019d6689c085ae165831e93',
+  namespace: 'bip122',
+  name: 'Bitcoin',
+  logoUrl: '',
+  nativeCurrency: { name: 'Satoshi', symbol: 'BTC', decimals: 8 },
+  networkType: 'bitcoin'
+}
+
+const ethereumNetwork: Network = {
+  internalId: 1,
+  id: 'eip155:1',
+  namespace: 'eip155',
+  name: 'Ethereum',
+  logoUrl: '',
+  nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+  networkType: 'evm'
+}
+
+describe('assertBitcoinNetwork', () => {
+  it('passes for a bip122 network', () => {
+    expect(() => assertBitcoinNetwork(bitcoinNetwork, 'test')).not.toThrow()
+  })
+
+  it('throws a WalletConnectorError for a non-bip122 network', () => {
+    expect(() => assertBitcoinNetwork(ethereumNetwork, 'test')).toThrow(
+      WalletConnectorError
+    )
+  })
+
+  it('names the offending network id in the message', () => {
+    expect(() => assertBitcoinNetwork(ethereumNetwork, 'test')).toThrow(
+      ethereumNetwork.id
+    )
+  })
+})
+
+describe('BitcoinNamespace', () => {
+  it('serves the bip122 namespace', () => {
+    expect(BITCOIN_NAMESPACE).toBe('bip122')
+    expect(new BitcoinNamespace().namespace).toBe(BITCOIN_NAMESPACE)
+  })
+
+  it('assertSupportedNetwork accepts a bip122 network', () => {
+    expect(() =>
+      new BitcoinNamespace().assertSupportedNetwork(bitcoinNetwork)
+    ).not.toThrow()
+  })
+
+  it('assertSupportedNetwork rejects a non-bip122 network', () => {
+    expect(() =>
+      new BitcoinNamespace().assertSupportedNetwork(ethereumNetwork)
+    ).toThrow(WalletConnectorError)
+  })
+})

package/src/bitcoin-namespace.ts

@@ -0,0 +1,49 @@
+import type { Namespace, Network } from '@meshconnect/uwc-types'
+import { WalletConnectorError } from '@meshconnect/uwc-types'
+
+/** CAIP-2 namespace this module serves. */
+export const BITCOIN_NAMESPACE: Namespace = 'bip122'
+
+/**
+ * Assert `network` is a bip122 network, else throw. Shared by the namespace
+ * module and its transport adapters so the boundary check lives in one place.
+ */
+export function assertBitcoinNetwork(network: Network, method: string): void {
+  if (network.namespace !== BITCOIN_NAMESPACE) {
+    throw new WalletConnectorError({
+      type: 'unknown',
+      message: `${method}: expected a bip122 network but got "${network.id}"`
+    })
+  }
+}
+
+/**
+ * Bitcoin (bip122) namespace module.
+ *
+ * A NAMESPACE module, not a connector — and it has no `connect` of its own.
+ * Connecting belongs to the transport layer: the transport connectors
+ * (`injected-connector`, `wallet-connect-connector`) own wallet discovery,
+ * pairing, and the provider/session lifecycle. This module owns only
+ * Bitcoin-specific operations performed against a transport-supplied
+ * provider/session — enumerating bip122 accounts, signing messages,
+ * building/signing/finalizing PSBTs, and broadcasting. Both transports
+ * dispatch their `bip122` branch into the matching adapter here.
+ *
+ * Those operations, and the provider/session types they take, land on the
+ * `BitcoinTransportAdapter` port in Phase 2 — deferred here so the scaffold
+ * doesn't pre-commit signatures before those types exist.
+ *
+ * Phase 1 (scaffold): namespace identity + the shared network guard only.
+ *
+ * Phased build plan:
+ * https://app.notion.com/p/3a5f862e950a8187b3d3f0e255d13f45
+ */
+export class BitcoinNamespace {
+  /** CAIP-2 namespace this module serves. */
+  readonly namespace = BITCOIN_NAMESPACE
+
+  /** Throws unless `network` is a bip122 network. */
+  assertSupportedNetwork(network: Network): void {
+    assertBitcoinNetwork(network, 'BitcoinNamespace.assertSupportedNetwork')
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+export {
+  BitcoinNamespace,
+  assertBitcoinNetwork,
+  BITCOIN_NAMESPACE
+} from './bitcoin-namespace'