@meshconnect/uwc-types 0.24.0 → 0.26.0

package/dist/UWC-state.d.ts

@@ -39,6 +39,12 @@ export interface DetectedTonWalletInfo {
     icon: string;
     jsBridgeKey: string;
 }
+export interface DetectedBitcoinWalletInfo {
+    uuid: string;
+    name: string;
+    /** Wallet Standard `bitcoin:*` feature names the wallet advertises. */
+    features: string[];
+}
 export interface Eip155Metadata {
     eip155Name: string;
     injectedId: string;
@@ -65,12 +71,20 @@ export interface TonMetadata {
     installed?: boolean;
     detectedWallet?: DetectedTonWalletInfo;
 }
+export interface BitcoinMetadata {
+    /** Wallet Standard wallet name used to match the `bitcoin:*` registry entry. */
+    walletStandardName?: string;
+    injectedId?: string;
+    installed?: boolean;
+    detectedWallet?: DetectedBitcoinWalletInfo;
+}
 /** Keys are CAIP-2 namespace identifiers. Types use brand names (e.g. tvm → TonMetadata). */
 interface NamespaceMetaDataRegistry {
     eip155: Eip155Metadata;
     solana: SolanaMetadata;
     tron: TronMetadata;
     tvm: TonMetadata;
+    bip122: BitcoinMetadata;
 }
 type NamespaceMetaDataMap = {
     [K in Namespace]?: K extends keyof NamespaceMetaDataRegistry ? NamespaceMetaDataRegistry[K] : undefined;

package/dist/UWC-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UWC-state.d.ts","sourceRoot":"","sources":["../src/UWC-state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"UWC-state.d.ts","sourceRoot":"","sources":["../src/UWC-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,uEAAuE;IACvE,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,sBAAsB,EAAE,OAAO,CAAA;IAC/B,mCAAmC,EAAE,OAAO,CAAA;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,yBAAyB,CAAA;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,wBAAwB,CAAA;CAC1C;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,sBAAsB,CAAA;CACxC;AAED,MAAM,WAAW,WAAW;IAC1B,oGAAoG;IACpG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,qBAAqB,CAAA;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,yBAAyB,CAAA;CAC3C;AAED,6FAA6F;AAC7F,UAAU,yBAAyB;IACjC,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,EAAE,cAAc,CAAA;IACtB,IAAI,EAAE,YAAY,CAAA;IAClB,GAAG,EAAE,WAAW,CAAA;IAChB,MAAM,EAAE,eAAe,CAAA;CACxB;AAED,KAAK,oBAAoB,GAAG;KACzB,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,yBAAyB,GACxD,yBAAyB,CAAC,CAAC,CAAC,GAC5B,SAAS;CACd,CAAA;AAED,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,SAAS,EAAE,CAAA;IAChC,iBAAiB,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAChD,qCAAqC,CAAC,EAAE,OAAO,CAAA;CAChD;AAED,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAClF,yBAAyB,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEjD,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,EAAE,SAAS,EAAE,CAAA;IAChC,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,iBAAiB,CAAC,EAAE,YAAY,CAAA;QAChC,gDAAgD;QAChD,wBAAwB,CAAC,EAAE,YAAY,CAAA;QACvC,gDAAgD;QAChD,oBAAoB,CAAC,EAAE,YAAY,CAAA;KACpC,CAAA;CACF;AAED,yEAAyE;AACzE,MAAM,WAAW,wBAAwB;IACvC,mBAAmB,EAAE,SAAS,EAAE,CAAA;IAChC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;CAC/B;AAGD,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACrD,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,CAAC,CAAA;IACX,yBAAyB,CAAC,EAAE,yBAAyB,CAAA;IACrD,iCAAiC,CAAC,EAAE,iCAAiC,CAAA;IACrE,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,kBAAkB,CAAC,EAAE,wBAAwB,CAAA;CAC9C"}

package/dist/bitcoin.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Per-wallet feature-flag key for `enabledWallets`. Open `string` because the
+ * Bitcoin namespace is metadata-driven — the wallet set comes from the passed-in
+ * metadata, not a compiled union — so any backend-configured wallet can be gated
+ * without a UWC release. Mirrors `TronWalletId`.
+ */
+export type BitcoinWalletId = string;
+/**
+ * A bip122 account as surfaced by the wallet (Wallet Standard `bitcoin:*`).
+ *
+ * Shapes match the Wallet Standard bitcoin account: an `address`, its
+ * `publicKey` (needed per-input for PSBT signing), and an optional `purpose`
+ * distinguishing payment vs. ordinals addresses on wallets that separate them.
+ * `publicKey` is hex here (JSON/transport-safe) — adapters convert to/from the
+ * wallet's native `Uint8Array` at the boundary.
+ */
+export interface BitcoinAccount {
+    address: string;
+    /** Compressed public key, hex-encoded (no `0x`). */
+    publicKey: string;
+    /** Address purpose, when the wallet distinguishes them (e.g. Phantom-style). */
+    purpose?: 'payment' | 'ordinals';
+}
+/**
+ * Params to sign a message (Wallet Standard `bitcoin:signMessage`).
+ * `message` is the UTF-8 string; the adapter encodes it to bytes.
+ */
+export interface BitcoinSignMessageParams {
+    account: BitcoinAccount;
+    message: string;
+    /** Signing protocol; wallets default to `ecdsa` when omitted. */
+    protocol?: 'ecdsa' | 'bip322';
+}
+/**
+ * Public configuration for the Bitcoin namespace module. Lives in `uwc-types`
+ * (like `TronConnectorConfig` / `TonConnectConfig`) so it can thread through
+ * `UniversalWalletConnector` once the core wiring lands.
+ *
+ * The `enabledWallets` set is an OPTIONAL per-wallet feature-flag surface. When
+ * omitted, every wallet whose metadata declares a `namespaceMetaData.bip122`
+ * entry is enabled (catalog-driven). An empty set/array enables nothing.
+ *
+ * Broadcast configuration (mempool.space endpoints) is intentionally NOT here
+ * yet — it arrives in Phase 3 alongside the broadcast implementation, together
+ * with the bip122 testnet network id it needs to be keyed by.
+ */
+export interface BitcoinConfig {
+    /**
+     * Optional allow-list of wallets to enable, matched against each wallet's
+     * `WalletMetadata.id` or its `namespaceMetaData.bip122.injectedId`
+     * (case-insensitive). Omit to enable every bip122-capable wallet the metadata
+     * declares; an empty set/array enables nothing.
+     */
+    enabledWallets?: ReadonlySet<BitcoinWalletId> | readonly BitcoinWalletId[];
+    /** Timeout (ms) for the per-wallet injection probe during connect. Default: 3000. */
+    readyStateTimeoutMs?: number;
+    /**
+     * Timeout (ms) for the injection probe during discovery. Deliberately short
+     * (default: 300) because absent wallets always wait out the full timeout.
+     */
+    discoveryTimeoutMs?: number;
+    /** Poll cadence (ms) for the injection probe. Default: 50. */
+    readyStatePollIntervalMs?: number;
+}
+//# sourceMappingURL=bitcoin.d.ts.map

package/dist/bitcoin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin.d.ts","sourceRoot":"","sources":["../src/bitcoin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAA;AAEpC;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,gFAAgF;IAChF,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,cAAc,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,GAAG,SAAS,eAAe,EAAE,CAAA;IAE1E,qFAAqF;IACrF,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B,8DAA8D;IAC9D,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC"}

package/dist/bitcoin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bitcoin.js.map

package/dist/bitcoin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin.js","sourceRoot":"","sources":["../src/bitcoin.ts"],"names":[],"mappings":""}

package/dist/connector.d.ts

@@ -3,7 +3,7 @@ import type { ConnectionMode } from './connection-mode';
 import type { AvailableAddress } from './session';
 import type { DetectedEIP6963WalletInfo, DetectedSolanaWalletInfo, DetectedTronWalletInfo, DetectedTonWalletInfo, ExtensionInjectedProvider, IntegratedBrowserInjectedProvider, WalletConnectProvider, TonConnectWalletProvider, WalletMetadata } from './UWC-state';
 import type { EVMCapabilities, TransactionRequest, TransactionResult } from './transactions';
-import type { SignatureType, EIP712TypedData } from './signature';
+import type { SignatureResult, EIP712TypedData } from './signature';
 /**
  * A post-connect wallet lifecycle change observed from the live provider.
  *
@@ -110,9 +110,12 @@ export interface Connector {
      * Sign a message with the connected wallet
      * @param message The message to sign
      * @param provider The wallet provider (required for injected connector)
-     * @returns A promise that resolves to the signature
+     * @returns A promise that resolves to a {@link SignatureResult} carrying both
+     *   the signature and the EXACT address it was signed with. Consumers verifying
+     *   ownership MUST claim `result.address` (the live signer) rather than a
+     *   possibly-stale session address, which can diverge after an account switch.
      */
-    signMessage?(message: string, provider?: ExtensionInjectedProvider | IntegratedBrowserInjectedProvider | WalletConnectProvider | TonConnectWalletProvider): Promise<SignatureType>;
+    signMessage?(message: string, provider?: ExtensionInjectedProvider | IntegratedBrowserInjectedProvider | WalletConnectProvider | TonConnectWalletProvider): Promise<SignatureResult>;
     /**
      * Sign EIP-712 typed structured data (eth_signTypedData_v4).
      * Required for ERC-3009 (Transfer With Authorization) and EIP-2612 (Permit) relay flows.
@@ -149,5 +152,27 @@ export interface Connector {
      * observes lifecycle leaves it undefined entirely.
      */
     onLifecycleEvent?(listener: (event: WalletLifecycleEvent) => void, context: WalletLifecycleContext): (() => void) | undefined;
+    /**
+     * Subscribe to the live provider's REAL account list for the active
+     * session — used only to keep UWC's own session state (activeAddress /
+     * availableAddresses) in sync with the wallet. This is a distinct concern
+     * from `onLifecycleEvent`: that stream is PII-safe telemetry and must
+     * never carry an address; this one exists specifically to carry it.
+     *
+     * An empty array signals the wallet-side logout/lock condition — the
+     * caller (core) treats it as a full disconnect. Returns an unsubscribe
+     * function, or `undefined` when this connector/session can't be observed
+     * (no live `.on`, unsupported namespace). Optional: a connector that
+     * never observes real account changes leaves it undefined entirely.
+     */
+    onAccountsChanged?(listener: (accounts: string[]) => void, context: WalletLifecycleContext): (() => void) | undefined;
+    /**
+     * Read the wallet's LIVE current address for a given namespace, re-read at
+     * call time (not the connect-time cache), so it reflects an in-wallet account
+     * switch. Optional: only connectors backed by a live provider/adapter per
+     * namespace implement it (injected, tron). Returns null when the namespace
+     * isn't connected or no address is available. Must never throw.
+     */
+    getLiveAccount?(namespace: Namespace): Promise<string | null>;
 }
 //# sourceMappingURL=connector.d.ts.map

package/dist/connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from './connector';
 export * from './providers';
 export * from './wallet-connect-connector';
 export * from './tron-connector';
+export * from './bitcoin';
 export * from './react-hooks';
 export * from './signature';
 export * from './transactions';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA"}

package/dist/index.js

@@ -7,6 +7,7 @@ export * from './connector';
 export * from './providers';
 export * from './wallet-connect-connector';
 export * from './tron-connector';
+export * from './bitcoin';
 export * from './react-hooks';
 export * from './signature';
 export * from './transactions';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA"}

package/dist/observability.d.ts

@@ -10,6 +10,7 @@
  * UWC ships NO third-party telemetry SDK. The consumer implements the sinks and
  * wires them to whatever backend they run (Datadog, Amplitude, Segment, …).
  */
+import type { Namespace } from './networks';
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 /**
  * Pluggable logger. The default implementation (`createLogger`) is console-backed
@@ -85,4 +86,60 @@ export type LifecycleUnavailableReason =
  * tripped (a storming provider). Emitted once at the moment of the trip.
  */
  | 'emission_cap';
+/**
+ * A named phase INSIDE a wallet operation, below the `awaitingWallet` →
+ * terminal pair. The handoff funnel answers "did the wallet answer?"; these
+ * answer "which part took the time / gave up?" — the gap that made a hung
+ * MetaMask connect indistinguishable from a slow one (ONC-183).
+ *
+ * Deliberately coarse and stable (dashboard-facing, low-cardinality). Only
+ * steps with a distinct failure mode get a name; internal bookkeeping does not.
+ */
+export type WalletStepName = 
+/** Discovering the injected provider for the target namespace (EIP-6963 / bridge poll). */
+'providerDetection'
+/** Passive `eth_accounts`-style read for an already-authorized provider (no prompt). */
+ | 'existingConnectionCheck'
+/** The authorizing wallet call for the TARGET namespace (e.g. `eth_requestAccounts`). */
+ | 'primaryConnect'
+/** Post-authorization chain read (`eth_chainId`) confirming the provider is live. */
+ | 'chainIdRead'
+/**
+ * Best-effort address gather for a NON-target namespace (MetaMask's Solana
+ * Snap, a multi-namespace wallet's Tron leg). Unbounded before ONC-183 and
+ * the dominant source of connects that hang AFTER the user already approved.
+ */
+ | 'secondaryGather';
+/** How a {@link WalletStepName} phase ended. */
+export type WalletStepOutcome = 'ok'
+/** Threw. For a best-effort step this is still a degraded-but-continuing connect. */
+ | 'failed'
+/** Hit its deadline and was abandoned; the underlying promise may still be pending. */
+ | 'timedOut'
+/**
+ * RESERVED — not yet emitted. Deliberately not run because a gate suppressed
+ * it, which is distinct from `ok` with no result. Declared now so consumer
+ * switch statements are exhaustive ahead of it (same convention as
+ * {@link LifecycleUnavailableReason}'s `old_bridge_parent`). The natural first
+ * emit site is the injected connector's legacy-`injectedId` / framed gates on
+ * the secondary Solana gather, which today report only through their own
+ * dedicated `secondarySolanaConnectSkipped` sink — so a suppressed leg is
+ * currently ABSENT from the step timeline rather than present-and-skipped.
+ */
+ | 'skipped';
+/**
+ * Payload for the injected connector's step sink. Routing facets only — the
+ * same non-PII contract as the handoff events (no address, no payload). Core
+ * stamps `handoffId` on the way out so a step joins its own attempt's terminal.
+ */
+export interface WalletStepInfo {
+    step: WalletStepName;
+    outcome: WalletStepOutcome;
+    /** Wall-clock ms for this step alone. */
+    durationMs: number;
+    /** The namespace the step acted on — the gather leg for `secondaryGather`. */
+    namespace?: Namespace | undefined;
+    /** The deadline that elapsed; set only when `outcome` is `timedOut`. */
+    timeoutMs?: number | undefined;
+}
 //# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CACjD;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GACtB,wBAAwB,GACxB,+BAA+B,GAC/B,wBAAwB,GACxB,qBAAqB,GACrB,cAAc,GACd,qBAAqB,GACrB,4BAA4B,GAC5B,wBAAwB,GACxB,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,eAAe;AACjB,iFAAiF;GAC/E,mBAAmB,GACnB,oBAAoB,GACpB,gBAAgB,GAChB,SAAS;AACX,gFAAgF;GAC9E,oBAAoB,GACpB,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,WAAW,GACX,QAAQ,GACR,KAAK,GACL,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,0BAA0B;AACpC,gGAAgG;AAC9F,mCAAmC;AACrC,uFAAuF;GACrF,iCAAiC;AACnC,oEAAoE;GAClE,uBAAuB;AACzB;;;;GAIG;GACD,mBAAmB;AACrB;;;GAGG;GACD,cAAc,CAAA"}
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CACjD;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GACtB,wBAAwB,GACxB,+BAA+B,GAC/B,wBAAwB,GACxB,qBAAqB,GACrB,cAAc,GACd,qBAAqB,GACrB,4BAA4B,GAC5B,wBAAwB,GACxB,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,eAAe;AACjB,iFAAiF;GAC/E,mBAAmB,GACnB,oBAAoB,GACpB,gBAAgB,GAChB,SAAS;AACX,gFAAgF;GAC9E,oBAAoB,GACpB,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,WAAW,GACX,QAAQ,GACR,KAAK,GACL,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,MAAM,0BAA0B;AACpC,gGAAgG;AAC9F,mCAAmC;AACrC,uFAAuF;GACrF,iCAAiC;AACnC,oEAAoE;GAClE,uBAAuB;AACzB;;;;GAIG;GACD,mBAAmB;AACrB;;;GAGG;GACD,cAAc,CAAA;AAElB;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc;AACxB,2FAA2F;AACzF,mBAAmB;AACrB,wFAAwF;GACtF,yBAAyB;AAC3B,yFAAyF;GACvF,gBAAgB;AAClB,qFAAqF;GACnF,aAAa;AACf;;;;GAIG;GACD,iBAAiB,CAAA;AAErB,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GACzB,IAAI;AACN,qFAAqF;GACnF,QAAQ;AACV,uFAAuF;GACrF,UAAU;AACZ;;;;;;;;;GASG;GACD,SAAS,CAAA;AAEb;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAA;IACpB,OAAO,EAAE,iBAAiB,CAAA;IAC1B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IACjC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B"}

package/dist/react-hooks.d.ts

@@ -1,4 +1,4 @@
-import type { NetworkId, Network, ConnectionMode, Session, AvailableAddress, TransactionRequest, TransactionResult, WalletError, EVMCapabilities, SignatureType, EIP712TypedData, WalletMetadata } from './index';
+import type { NetworkId, Network, ConnectionMode, Session, AvailableAddress, TransactionRequest, TransactionResult, WalletError, EVMCapabilities, SignatureType, SignatureResult, EIP712TypedData, WalletMetadata } from './index';
 /**
  * WalletConnect connection interface for the useConnection hook
  */
@@ -203,20 +203,22 @@ export interface UseSwitchNetworkReturn {
  * const { signMessage, isLoading, signature } = useSignMessage()
  *
  * const handleSign = async () => {
- *   const sig = await signMessage('Hello World')
- *   console.log('Signature:', sig)
- *   // The signature state will also contain the result
+ *   const { signature, address } = await signMessage('Hello World')
+ *   console.log('Signature:', signature, 'signed by', address)
+ *   // The `signature` state also holds the last result.signature.
  * }
  * ```
  */
 export interface UseSignMessageReturn {
     /**
-     * Signs a message with the connected wallet
+     * Signs a message with the connected wallet.
      * @param message - The message to sign
-     * @returns Promise that resolves to the signature string
+     * @returns Promise resolving to a {@link SignatureResult} with both the
+     *   signature and the EXACT address it was signed with. Claim
+     *   `result.address` when verifying ownership — never a stale session address.
      * @throws Error if no wallet is connected or signing fails
      */
-    signMessage: (message: string) => Promise<SignatureType>;
+    signMessage: (message: string) => Promise<SignatureResult>;
     /**
      * Indicates if a message signing operation is currently in progress
      */

package/dist/react-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react-hooks.d.ts","sourceRoot":"","sources":["../src/react-hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"react-hooks.d.ts","sourceRoot":"","sources":["../src/react-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EACP,cAAc,EACd,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,EACf,MAAM,SAAS,CAAA;AAIhB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;IAC9B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;IAC9B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;IAC9B,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,aAAa,EAAE,uBAAuB,CAAA;IACtC;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAAA;IAC5B;;OAEG;IACH,UAAU,EAAE,oBAAoB,CAAA;IAChC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;CACjB;AAID;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B;;OAEG;IACH,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7B;;OAEG;IACH,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI,CAAA;IAChE;;OAEG;IACH,+BAA+B,EAAE,eAAe,GAAG,IAAI,CAAA;IACvD;;OAEG;IACH,iBAAiB,EAAE,OAAO,EAAE,CAAA;IAC5B;;OAEG;IACH,eAAe,EAAE,cAAc,GAAG,IAAI,CAAA;IACtC;;OAEG;IACH,kBAAkB,EAAE,gBAAgB,EAAE,CAAA;IACtC;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAID;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,wBAAwB,EAAE,OAAO,CAAA;IACjC;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;CAC/B;AAID;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;IAC1D;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,SAAS,EAAE,aAAa,GAAG,SAAS,CAAA;IACpC;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;CAC/B;AAID;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9D;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;CAC/B;AAID;;;;;GAKG;AACH,MAAM,WAAW,8BAA8B;IAC7C,0FAA0F;IAC1F,qBAAqB,EAAE,CAAC,YAAY,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACxE,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;CAC/B;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC5E;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,GAAG,SAAS,CAAA;IAChD;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;CAC/B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAID;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;CAC/B;AAID;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,eAAe,EAAE,cAAc,EAAE,CAAA;IACjC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;CACjB"}

package/dist/transactions.d.ts

@@ -39,7 +39,12 @@ export interface EVMContractCallRequest {
     functionName: string;
     args: unknown[];
     from: string;
-    value?: bigint;
+    /**
+     * Native currency to attach to a payable call, in wei (unsigned). A bigint, or a
+     * decimal or `0x`-hex string — `1000000000000000000n`, `'1000000000000000000'`,
+     * and `'0xde0b6b3a7640000'` are all 1 ETH. Omitted → 0.
+     */
+    value?: bigint | string;
     gasConfig?: EVMGasConfig;
 }
 /**
@@ -49,7 +54,12 @@ export interface EVMDataTransferRequest {
     from: string;
     to: string;
     data: string;
-    value?: bigint;
+    /**
+     * Native currency to attach to the call, in wei (unsigned). A bigint, or a
+     * decimal or `0x`-hex string — `1000000000000000000n`, `'1000000000000000000'`,
+     * and `'0xde0b6b3a7640000'` are all 1 ETH. Omitted → 0.
+     */
+    value?: bigint | string;
     chainId: string;
     gasConfig?: EVMGasConfig;
 }
@@ -181,6 +191,39 @@ export interface TronContractCallRequest {
     data: string;
 }
 export type TronTransactionRequest = TronNativeTransferRequest | TronTRC20TransferRequest | TronContractCallRequest;
+/**
+ * Bitcoin (bip122) Transaction Types
+ */
+/** SIGHASH flag for a PSBT input (Wallet Standard bitcoin values). */
+export type BitcoinSigHash = 'ALL' | 'NONE' | 'SINGLE' | 'ALL|ANYONECANPAY' | 'NONE|ANYONECANPAY' | 'SINGLE|ANYONECANPAY';
+/** Which inputs of a PSBT a given address should sign. */
+export interface BitcoinPsbtInputToSign {
+    address: string;
+    signingIndexes: number[];
+    sigHash?: BitcoinSigHash;
+}
+/**
+ * Path B — sign a backend-constructed PSBT (Wallet Standard `signTransaction`).
+ * The wallet signs the requested inputs and returns the signed PSBT; the
+ * connector finalizes and broadcasts (to mempool.space). Not a wallet broadcast.
+ */
+export interface BitcoinPsbtSignRequest {
+    from: string;
+    /** Base64-encoded PSBT (BIP-174). */
+    psbt: string;
+    /** Inputs to sign; when omitted the wallet signs all it can. */
+    inputsToSign?: BitcoinPsbtInputToSign[];
+}
+/**
+ * Path A — high-level transfer (Trust Wallet WalletConnect `sendTransfer`). The
+ * wallet does coin selection, fee estimation, signing, and broadcast.
+ */
+export interface BitcoinSendTransferRequest {
+    from: string;
+    to: string;
+    amount: number | bigint;
+}
+export type BitcoinTransactionRequest = BitcoinPsbtSignRequest | BitcoinSendTransferRequest;
 /**
  * Common Transaction Types
  */
@@ -248,7 +291,16 @@ export interface BatchTransactionResult {
 /**
  * Generic transaction request that can be either EVM or Solana
  */
-export type TransactionRequest = EthereumTransactionRequest | SolanaTransactionRequest | TronTransactionRequest | TonNativeTransferRequest;
+export type TransactionRequest = EthereumTransactionRequest | SolanaTransactionRequest | TronTransactionRequest | TonNativeTransferRequest | BitcoinTransactionRequest;
 export type EthereumTransactionRequest = EVMNativeTransferRequest | EVMContractCallRequest | EVMBatchTransactionRequest | EVMDataTransferRequest;
 export type SolanaTransactionRequest = SolanaNativeTransferRequest | SolanaTokenTransferRequest | SolanaGenericTransferRequest;
+/**
+ * Normalize an EVM `value` (in wei) to a bigint for viem.
+ *
+ * Accepts a bigint or a decimal / `0x`-hex string. Missing/nullish → 0n. Anything
+ * else throws with context rather than silently coercing to 0 on a money path:
+ * empty/whitespace, non-numeric, binary/octal (`0b`/`0o`), negative, or a
+ * non-string/non-bigint value (e.g. a number arriving from untyped JSON).
+ */
+export declare function toEvmValueBigInt(value?: bigint | string | null): bigint;
 //# sourceMappingURL=transactions.d.ts.map

package/dist/transactions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../src/transactions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../src/transactions.ts"],"names":[],"mappings":"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"}

package/dist/transactions.js

@@ -1,5 +1,42 @@
 /**
  * EVM Transaction Types
  */
-export {};
+/**
+ * Normalize an EVM `value` (in wei) to a bigint for viem.
+ *
+ * Accepts a bigint or a decimal / `0x`-hex string. Missing/nullish → 0n. Anything
+ * else throws with context rather than silently coercing to 0 on a money path:
+ * empty/whitespace, non-numeric, binary/octal (`0b`/`0o`), negative, or a
+ * non-string/non-bigint value (e.g. a number arriving from untyped JSON).
+ */
+export function toEvmValueBigInt(value) {
+    if (value == null)
+        return 0n;
+    if (typeof value === 'bigint') {
+        if (value < 0n)
+            throw new Error(`Invalid EVM value: "${value}"`);
+        return value;
+    }
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid EVM value: expected bigint or string, got ${typeof value}`);
+    }
+    const trimmed = value.trim();
+    if (trimmed === '') {
+        throw new Error('Invalid EVM value: empty string');
+    }
+    // BigInt() accepts 0b/0o prefixes; reject so only decimal and 0x-hex wei parse.
+    if (/^[+-]?0[bo]/i.test(trimmed)) {
+        throw new Error(`Invalid EVM value: "${value}"`);
+    }
+    let result;
+    try {
+        result = BigInt(trimmed);
+    }
+    catch {
+        throw new Error(`Invalid EVM value: "${value}"`);
+    }
+    if (result < 0n)
+        throw new Error(`Invalid EVM value: "${value}"`);
+    return result;
+}
 //# sourceMappingURL=transactions.js.map

package/dist/transactions.js.map

@@ -1 +1 @@
-{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../src/transactions.ts"],"names":[],"mappings":"AAAA;;GAEG"}
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../src/transactions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoXH;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA8B;IAC7D,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,CAAA;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,GAAG,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,GAAG,CAAC,CAAA;QAChE,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,qDAAqD,OAAO,KAAK,EAAE,CACpE,CAAA;IACH,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACpD,CAAC;IACD,gFAAgF;IAChF,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,GAAG,CAAC,CAAA;IAClD,CAAC;IACD,IAAI,MAAc,CAAA;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,GAAG,CAAC,CAAA;IAClD,CAAC;IACD,IAAI,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,GAAG,CAAC,CAAA;IACjE,OAAO,MAAM,CAAA;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshconnect/uwc-types",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "description": "TypeScript types for Universal Wallet Connector",
   "type": "module",
   "main": "dist/index.js",

package/src/UWC-state.ts

@@ -45,6 +45,13 @@ export interface DetectedTonWalletInfo {
   jsBridgeKey: string
 }
 
+export interface DetectedBitcoinWalletInfo {
+  uuid: string
+  name: string
+  /** Wallet Standard `bitcoin:*` feature names the wallet advertises. */
+  features: string[]
+}
+
 export interface Eip155Metadata {
   eip155Name: string
   injectedId: string
@@ -75,12 +82,21 @@ export interface TonMetadata {
   detectedWallet?: DetectedTonWalletInfo
 }
 
+export interface BitcoinMetadata {
+  /** Wallet Standard wallet name used to match the `bitcoin:*` registry entry. */
+  walletStandardName?: string
+  injectedId?: string
+  installed?: boolean
+  detectedWallet?: DetectedBitcoinWalletInfo
+}
+
 /** Keys are CAIP-2 namespace identifiers. Types use brand names (e.g. tvm → TonMetadata). */
 interface NamespaceMetaDataRegistry {
   eip155: Eip155Metadata
   solana: SolanaMetadata
   tron: TronMetadata
   tvm: TonMetadata
+  bip122: BitcoinMetadata
 }
 
 type NamespaceMetaDataMap = {

package/src/bitcoin.ts

@@ -0,0 +1,70 @@
+/**
+ * Per-wallet feature-flag key for `enabledWallets`. Open `string` because the
+ * Bitcoin namespace is metadata-driven — the wallet set comes from the passed-in
+ * metadata, not a compiled union — so any backend-configured wallet can be gated
+ * without a UWC release. Mirrors `TronWalletId`.
+ */
+export type BitcoinWalletId = string
+
+/**
+ * A bip122 account as surfaced by the wallet (Wallet Standard `bitcoin:*`).
+ *
+ * Shapes match the Wallet Standard bitcoin account: an `address`, its
+ * `publicKey` (needed per-input for PSBT signing), and an optional `purpose`
+ * distinguishing payment vs. ordinals addresses on wallets that separate them.
+ * `publicKey` is hex here (JSON/transport-safe) — adapters convert to/from the
+ * wallet's native `Uint8Array` at the boundary.
+ */
+export interface BitcoinAccount {
+  address: string
+  /** Compressed public key, hex-encoded (no `0x`). */
+  publicKey: string
+  /** Address purpose, when the wallet distinguishes them (e.g. Phantom-style). */
+  purpose?: 'payment' | 'ordinals'
+}
+
+/**
+ * Params to sign a message (Wallet Standard `bitcoin:signMessage`).
+ * `message` is the UTF-8 string; the adapter encodes it to bytes.
+ */
+export interface BitcoinSignMessageParams {
+  account: BitcoinAccount
+  message: string
+  /** Signing protocol; wallets default to `ecdsa` when omitted. */
+  protocol?: 'ecdsa' | 'bip322'
+}
+
+/**
+ * Public configuration for the Bitcoin namespace module. Lives in `uwc-types`
+ * (like `TronConnectorConfig` / `TonConnectConfig`) so it can thread through
+ * `UniversalWalletConnector` once the core wiring lands.
+ *
+ * The `enabledWallets` set is an OPTIONAL per-wallet feature-flag surface. When
+ * omitted, every wallet whose metadata declares a `namespaceMetaData.bip122`
+ * entry is enabled (catalog-driven). An empty set/array enables nothing.
+ *
+ * Broadcast configuration (mempool.space endpoints) is intentionally NOT here
+ * yet — it arrives in Phase 3 alongside the broadcast implementation, together
+ * with the bip122 testnet network id it needs to be keyed by.
+ */
+export interface BitcoinConfig {
+  /**
+   * Optional allow-list of wallets to enable, matched against each wallet's
+   * `WalletMetadata.id` or its `namespaceMetaData.bip122.injectedId`
+   * (case-insensitive). Omit to enable every bip122-capable wallet the metadata
+   * declares; an empty set/array enables nothing.
+   */
+  enabledWallets?: ReadonlySet<BitcoinWalletId> | readonly BitcoinWalletId[]
+
+  /** Timeout (ms) for the per-wallet injection probe during connect. Default: 3000. */
+  readyStateTimeoutMs?: number
+
+  /**
+   * Timeout (ms) for the injection probe during discovery. Deliberately short
+   * (default: 300) because absent wallets always wait out the full timeout.
+   */
+  discoveryTimeoutMs?: number
+
+  /** Poll cadence (ms) for the injection probe. Default: 50. */
+  readyStatePollIntervalMs?: number
+}

package/src/connector.ts

@@ -17,7 +17,7 @@ import type {
   TransactionRequest,
   TransactionResult
 } from './transactions'
-import type { SignatureType, EIP712TypedData } from './signature'
+import type { SignatureResult, EIP712TypedData } from './signature'
 
 /**
  * A post-connect wallet lifecycle change observed from the live provider.
@@ -156,7 +156,10 @@ export interface Connector {
    * Sign a message with the connected wallet
    * @param message The message to sign
    * @param provider The wallet provider (required for injected connector)
-   * @returns A promise that resolves to the signature
+   * @returns A promise that resolves to a {@link SignatureResult} carrying both
+   *   the signature and the EXACT address it was signed with. Consumers verifying
+   *   ownership MUST claim `result.address` (the live signer) rather than a
+   *   possibly-stale session address, which can diverge after an account switch.
    */
   signMessage?(
     message: string,
@@ -165,7 +168,7 @@ export interface Connector {
       | IntegratedBrowserInjectedProvider
       | WalletConnectProvider
       | TonConnectWalletProvider
-  ): Promise<SignatureType>
+  ): Promise<SignatureResult>
 
   /**
    * Sign EIP-712 typed structured data (eth_signTypedData_v4).
@@ -226,4 +229,31 @@ export interface Connector {
     listener: (event: WalletLifecycleEvent) => void,
     context: WalletLifecycleContext
   ): (() => void) | undefined
+
+  /**
+   * Subscribe to the live provider's REAL account list for the active
+   * session — used only to keep UWC's own session state (activeAddress /
+   * availableAddresses) in sync with the wallet. This is a distinct concern
+   * from `onLifecycleEvent`: that stream is PII-safe telemetry and must
+   * never carry an address; this one exists specifically to carry it.
+   *
+   * An empty array signals the wallet-side logout/lock condition — the
+   * caller (core) treats it as a full disconnect. Returns an unsubscribe
+   * function, or `undefined` when this connector/session can't be observed
+   * (no live `.on`, unsupported namespace). Optional: a connector that
+   * never observes real account changes leaves it undefined entirely.
+   */
+  onAccountsChanged?(
+    listener: (accounts: string[]) => void,
+    context: WalletLifecycleContext
+  ): (() => void) | undefined
+
+  /**
+   * Read the wallet's LIVE current address for a given namespace, re-read at
+   * call time (not the connect-time cache), so it reflects an in-wallet account
+   * switch. Optional: only connectors backed by a live provider/adapter per
+   * namespace implement it (injected, tron). Returns null when the namespace
+   * isn't connected or no address is available. Must never throw.
+   */
+  getLiveAccount?(namespace: Namespace): Promise<string | null>
 }

package/src/index.ts

@@ -7,6 +7,7 @@ export * from './connector'
 export * from './providers'
 export * from './wallet-connect-connector'
 export * from './tron-connector'
+export * from './bitcoin'
 export * from './react-hooks'
 export * from './signature'
 export * from './transactions'

package/src/observability.ts

@@ -11,6 +11,8 @@
  * wires them to whatever backend they run (Datadog, Amplitude, Segment, …).
  */
 
+import type { Namespace } from './networks'
+
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error'
 
 /**
@@ -114,3 +116,63 @@ export type LifecycleUnavailableReason =
    * tripped (a storming provider). Emitted once at the moment of the trip.
    */
   | 'emission_cap'
+
+/**
+ * A named phase INSIDE a wallet operation, below the `awaitingWallet` →
+ * terminal pair. The handoff funnel answers "did the wallet answer?"; these
+ * answer "which part took the time / gave up?" — the gap that made a hung
+ * MetaMask connect indistinguishable from a slow one (ONC-183).
+ *
+ * Deliberately coarse and stable (dashboard-facing, low-cardinality). Only
+ * steps with a distinct failure mode get a name; internal bookkeeping does not.
+ */
+export type WalletStepName =
+  /** Discovering the injected provider for the target namespace (EIP-6963 / bridge poll). */
+  | 'providerDetection'
+  /** Passive `eth_accounts`-style read for an already-authorized provider (no prompt). */
+  | 'existingConnectionCheck'
+  /** The authorizing wallet call for the TARGET namespace (e.g. `eth_requestAccounts`). */
+  | 'primaryConnect'
+  /** Post-authorization chain read (`eth_chainId`) confirming the provider is live. */
+  | 'chainIdRead'
+  /**
+   * Best-effort address gather for a NON-target namespace (MetaMask's Solana
+   * Snap, a multi-namespace wallet's Tron leg). Unbounded before ONC-183 and
+   * the dominant source of connects that hang AFTER the user already approved.
+   */
+  | 'secondaryGather'
+
+/** How a {@link WalletStepName} phase ended. */
+export type WalletStepOutcome =
+  | 'ok'
+  /** Threw. For a best-effort step this is still a degraded-but-continuing connect. */
+  | 'failed'
+  /** Hit its deadline and was abandoned; the underlying promise may still be pending. */
+  | 'timedOut'
+  /**
+   * RESERVED — not yet emitted. Deliberately not run because a gate suppressed
+   * it, which is distinct from `ok` with no result. Declared now so consumer
+   * switch statements are exhaustive ahead of it (same convention as
+   * {@link LifecycleUnavailableReason}'s `old_bridge_parent`). The natural first
+   * emit site is the injected connector's legacy-`injectedId` / framed gates on
+   * the secondary Solana gather, which today report only through their own
+   * dedicated `secondarySolanaConnectSkipped` sink — so a suppressed leg is
+   * currently ABSENT from the step timeline rather than present-and-skipped.
+   */
+  | 'skipped'
+
+/**
+ * Payload for the injected connector's step sink. Routing facets only — the
+ * same non-PII contract as the handoff events (no address, no payload). Core
+ * stamps `handoffId` on the way out so a step joins its own attempt's terminal.
+ */
+export interface WalletStepInfo {
+  step: WalletStepName
+  outcome: WalletStepOutcome
+  /** Wall-clock ms for this step alone. */
+  durationMs: number
+  /** The namespace the step acted on — the gather leg for `secondaryGather`. */
+  namespace?: Namespace | undefined
+  /** The deadline that elapsed; set only when `outcome` is `timedOut`. */
+  timeoutMs?: number | undefined
+}

package/src/react-hooks.ts

@@ -9,6 +9,7 @@ import type {
   WalletError,
   EVMCapabilities,
   SignatureType,
+  SignatureResult,
   EIP712TypedData,
   WalletMetadata
 } from './index'
@@ -231,20 +232,22 @@ export interface UseSwitchNetworkReturn {
  * const { signMessage, isLoading, signature } = useSignMessage()
  *
  * const handleSign = async () => {
- *   const sig = await signMessage('Hello World')
- *   console.log('Signature:', sig)
- *   // The signature state will also contain the result
+ *   const { signature, address } = await signMessage('Hello World')
+ *   console.log('Signature:', signature, 'signed by', address)
+ *   // The `signature` state also holds the last result.signature.
  * }
  * ```
  */
 export interface UseSignMessageReturn {
   /**
-   * Signs a message with the connected wallet
+   * Signs a message with the connected wallet.
    * @param message - The message to sign
-   * @returns Promise that resolves to the signature string
+   * @returns Promise resolving to a {@link SignatureResult} with both the
+   *   signature and the EXACT address it was signed with. Claim
+   *   `result.address` when verifying ownership — never a stale session address.
    * @throws Error if no wallet is connected or signing fails
    */
-  signMessage: (message: string) => Promise<SignatureType>
+  signMessage: (message: string) => Promise<SignatureResult>
   /**
    * Indicates if a message signing operation is currently in progress
    */

package/src/transactions.test.ts

@@ -0,0 +1,53 @@
+import { describe, it, expect } from 'vitest'
+import { toEvmValueBigInt } from './transactions'
+
+describe('toEvmValueBigInt', () => {
+  const oneEth = 1000000000000000000n
+
+  it('returns 0n for undefined or null', () => {
+    expect(toEvmValueBigInt(undefined)).toBe(0n)
+    expect(toEvmValueBigInt(null as unknown as undefined)).toBe(0n)
+  })
+
+  it('passes a bigint through unchanged', () => {
+    expect(toEvmValueBigInt(oneEth)).toBe(oneEth)
+  })
+
+  it.each([
+    ['decimal string', '1000000000000000000'],
+    ['hex string', '0xde0b6b3a7640000'],
+    ['whitespace-padded', '  1000000000000000000  ']
+  ])('parses %s to the same bigint', (_l, value) => {
+    expect(toEvmValueBigInt(value)).toBe(oneEth)
+  })
+
+  it.each(['', '   '])('throws on empty/whitespace value %j', value => {
+    expect(() => toEvmValueBigInt(value)).toThrow(
+      'Invalid EVM value: empty string'
+    )
+  })
+
+  it.each(['abc', '1.5', '1e18', '0x'])(
+    'throws with context on malformed value %j',
+    value => {
+      expect(() => toEvmValueBigInt(value)).toThrow(/Invalid EVM value/)
+    }
+  )
+
+  it.each(['-1', '0b1010', '0o17'])(
+    'rejects negative and binary/octal value %j',
+    value => {
+      expect(() => toEvmValueBigInt(value)).toThrow(/Invalid EVM value/)
+    }
+  )
+
+  it('rejects a negative bigint', () => {
+    expect(() => toEvmValueBigInt(-1n)).toThrow(/Invalid EVM value/)
+  })
+
+  it('rejects a non-string/non-bigint value with a clear error', () => {
+    expect(() => toEvmValueBigInt(100 as unknown as string)).toThrow(
+      /expected bigint or string, got number/
+    )
+  })
+})

package/src/transactions.ts

@@ -44,7 +44,12 @@ export interface EVMContractCallRequest {
   functionName: string
   args: unknown[]
   from: string
-  value?: bigint // For payable functions (in wei)
+  /**
+   * Native currency to attach to a payable call, in wei (unsigned). A bigint, or a
+   * decimal or `0x`-hex string — `1000000000000000000n`, `'1000000000000000000'`,
+   * and `'0xde0b6b3a7640000'` are all 1 ETH. Omitted → 0.
+   */
+  value?: bigint | string
   gasConfig?: EVMGasConfig
 }
 
@@ -55,7 +60,12 @@ export interface EVMDataTransferRequest {
   from: string
   to: string
   data: string
-  value?: bigint // For payable functions (in wei)
+  /**
+   * Native currency to attach to the call, in wei (unsigned). A bigint, or a
+   * decimal or `0x`-hex string — `1000000000000000000n`, `'1000000000000000000'`,
+   * and `'0xde0b6b3a7640000'` are all 1 ETH. Omitted → 0.
+   */
+  value?: bigint | string
   chainId: string
   gasConfig?: EVMGasConfig
 }
@@ -222,6 +232,56 @@ export type TronTransactionRequest =
   | TronTRC20TransferRequest
   | TronContractCallRequest
 
+/**
+ * Bitcoin (bip122) Transaction Types
+ */
+
+/** SIGHASH flag for a PSBT input (Wallet Standard bitcoin values). */
+export type BitcoinSigHash =
+  | 'ALL'
+  | 'NONE'
+  | 'SINGLE'
+  | 'ALL|ANYONECANPAY'
+  | 'NONE|ANYONECANPAY'
+  | 'SINGLE|ANYONECANPAY'
+
+/** Which inputs of a PSBT a given address should sign. */
+export interface BitcoinPsbtInputToSign {
+  address: string
+  signingIndexes: number[]
+  sigHash?: BitcoinSigHash
+}
+
+/**
+ * Path B — sign a backend-constructed PSBT (Wallet Standard `signTransaction`).
+ * The wallet signs the requested inputs and returns the signed PSBT; the
+ * connector finalizes and broadcasts (to mempool.space). Not a wallet broadcast.
+ */
+export interface BitcoinPsbtSignRequest {
+  from: string
+  /** Base64-encoded PSBT (BIP-174). */
+  psbt: string
+  /** Inputs to sign; when omitted the wallet signs all it can. */
+  inputsToSign?: BitcoinPsbtInputToSign[]
+}
+
+/**
+ * Path A — high-level transfer (Trust Wallet WalletConnect `sendTransfer`). The
+ * wallet does coin selection, fee estimation, signing, and broadcast.
+ */
+export interface BitcoinSendTransferRequest {
+  from: string
+  to: string
+  // amount in satoshis. `bigint` avoids float-precision loss; sats are
+  // serialized to a JSON number over WalletConnect, so values must stay within
+  // the safe-integer range (BTC's 2.1e15-sat cap does).
+  amount: number | bigint
+}
+
+export type BitcoinTransactionRequest =
+  | BitcoinPsbtSignRequest
+  | BitcoinSendTransferRequest
+
 /**
  * Common Transaction Types
  */
@@ -299,6 +359,7 @@ export type TransactionRequest =
   | SolanaTransactionRequest
   | TronTransactionRequest
   | TonNativeTransferRequest
+  | BitcoinTransactionRequest
 
 export type EthereumTransactionRequest =
   | EVMNativeTransferRequest
@@ -310,3 +371,40 @@ export type SolanaTransactionRequest =
   | SolanaNativeTransferRequest
   | SolanaTokenTransferRequest
   | SolanaGenericTransferRequest
+
+/**
+ * Normalize an EVM `value` (in wei) to a bigint for viem.
+ *
+ * Accepts a bigint or a decimal / `0x`-hex string. Missing/nullish → 0n. Anything
+ * else throws with context rather than silently coercing to 0 on a money path:
+ * empty/whitespace, non-numeric, binary/octal (`0b`/`0o`), negative, or a
+ * non-string/non-bigint value (e.g. a number arriving from untyped JSON).
+ */
+export function toEvmValueBigInt(value?: bigint | string | null): bigint {
+  if (value == null) return 0n
+  if (typeof value === 'bigint') {
+    if (value < 0n) throw new Error(`Invalid EVM value: "${value}"`)
+    return value
+  }
+  if (typeof value !== 'string') {
+    throw new Error(
+      `Invalid EVM value: expected bigint or string, got ${typeof value}`
+    )
+  }
+  const trimmed = value.trim()
+  if (trimmed === '') {
+    throw new Error('Invalid EVM value: empty string')
+  }
+  // BigInt() accepts 0b/0o prefixes; reject so only decimal and 0x-hex wei parse.
+  if (/^[+-]?0[bo]/i.test(trimmed)) {
+    throw new Error(`Invalid EVM value: "${value}"`)
+  }
+  let result: bigint
+  try {
+    result = BigInt(trimmed)
+  } catch {
+    throw new Error(`Invalid EVM value: "${value}"`)
+  }
+  if (result < 0n) throw new Error(`Invalid EVM value: "${value}"`)
+  return result
+}