otx-btc-wallet-connectors 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/README.md +554 -0
  2. package/dist/base-IAFq7sd8.d.mts +53 -0
  3. package/dist/base-IAFq7sd8.d.ts +53 -0
  4. package/dist/binance/index.d.mts +81 -0
  5. package/dist/binance/index.d.ts +81 -0
  6. package/dist/binance/index.js +13 -0
  7. package/dist/binance/index.js.map +1 -0
  8. package/dist/binance/index.mjs +4 -0
  9. package/dist/binance/index.mjs.map +1 -0
  10. package/dist/bitget/index.d.mts +84 -0
  11. package/dist/bitget/index.d.ts +84 -0
  12. package/dist/bitget/index.js +13 -0
  13. package/dist/bitget/index.js.map +1 -0
  14. package/dist/bitget/index.mjs +4 -0
  15. package/dist/bitget/index.mjs.map +1 -0
  16. package/dist/chunk-5Z5Q2Y75.mjs +91 -0
  17. package/dist/chunk-5Z5Q2Y75.mjs.map +1 -0
  18. package/dist/chunk-7KK2LZLZ.mjs +208 -0
  19. package/dist/chunk-7KK2LZLZ.mjs.map +1 -0
  20. package/dist/chunk-AW2JZIHR.mjs +753 -0
  21. package/dist/chunk-AW2JZIHR.mjs.map +1 -0
  22. package/dist/chunk-EIJOSZXZ.js +331 -0
  23. package/dist/chunk-EIJOSZXZ.js.map +1 -0
  24. package/dist/chunk-EQHR7P7G.js +541 -0
  25. package/dist/chunk-EQHR7P7G.js.map +1 -0
  26. package/dist/chunk-EWRXLZO4.mjs +539 -0
  27. package/dist/chunk-EWRXLZO4.mjs.map +1 -0
  28. package/dist/chunk-FISNQZZ7.js +802 -0
  29. package/dist/chunk-FISNQZZ7.js.map +1 -0
  30. package/dist/chunk-HL4WDMGS.js +200 -0
  31. package/dist/chunk-HL4WDMGS.js.map +1 -0
  32. package/dist/chunk-IPYWR76I.js +314 -0
  33. package/dist/chunk-IPYWR76I.js.map +1 -0
  34. package/dist/chunk-JYYNWR5G.js +142 -0
  35. package/dist/chunk-JYYNWR5G.js.map +1 -0
  36. package/dist/chunk-LNKTYZJM.js +701 -0
  37. package/dist/chunk-LNKTYZJM.js.map +1 -0
  38. package/dist/chunk-LVZMONQL.mjs +699 -0
  39. package/dist/chunk-LVZMONQL.mjs.map +1 -0
  40. package/dist/chunk-MFXLQWOE.js +93 -0
  41. package/dist/chunk-MFXLQWOE.js.map +1 -0
  42. package/dist/chunk-NBIA4TTE.mjs +204 -0
  43. package/dist/chunk-NBIA4TTE.mjs.map +1 -0
  44. package/dist/chunk-O4DD2XJ2.js +206 -0
  45. package/dist/chunk-O4DD2XJ2.js.map +1 -0
  46. package/dist/chunk-P7HVBU2B.mjs +140 -0
  47. package/dist/chunk-P7HVBU2B.mjs.map +1 -0
  48. package/dist/chunk-Q7QVQYEB.js +210 -0
  49. package/dist/chunk-Q7QVQYEB.js.map +1 -0
  50. package/dist/chunk-RLZEG6KL.mjs +329 -0
  51. package/dist/chunk-RLZEG6KL.mjs.map +1 -0
  52. package/dist/chunk-SYLDBJ75.mjs +246 -0
  53. package/dist/chunk-SYLDBJ75.mjs.map +1 -0
  54. package/dist/chunk-TTEUU3CI.mjs +198 -0
  55. package/dist/chunk-TTEUU3CI.mjs.map +1 -0
  56. package/dist/chunk-V66BXDTR.mjs +292 -0
  57. package/dist/chunk-V66BXDTR.mjs.map +1 -0
  58. package/dist/chunk-X77ZT4OI.js +268 -0
  59. package/dist/chunk-X77ZT4OI.js.map +1 -0
  60. package/dist/imtoken/index.d.mts +116 -0
  61. package/dist/imtoken/index.d.ts +116 -0
  62. package/dist/imtoken/index.js +14 -0
  63. package/dist/imtoken/index.js.map +1 -0
  64. package/dist/imtoken/index.mjs +5 -0
  65. package/dist/imtoken/index.mjs.map +1 -0
  66. package/dist/index.d.mts +14 -0
  67. package/dist/index.d.ts +14 -0
  68. package/dist/index.js +170 -0
  69. package/dist/index.js.map +1 -0
  70. package/dist/index.mjs +13 -0
  71. package/dist/index.mjs.map +1 -0
  72. package/dist/ledger/index.d.mts +290 -0
  73. package/dist/ledger/index.d.ts +290 -0
  74. package/dist/ledger/index.js +14 -0
  75. package/dist/ledger/index.js.map +1 -0
  76. package/dist/ledger/index.mjs +5 -0
  77. package/dist/ledger/index.mjs.map +1 -0
  78. package/dist/okx/index.d.mts +88 -0
  79. package/dist/okx/index.d.ts +88 -0
  80. package/dist/okx/index.js +13 -0
  81. package/dist/okx/index.js.map +1 -0
  82. package/dist/okx/index.mjs +4 -0
  83. package/dist/okx/index.mjs.map +1 -0
  84. package/dist/phantom/index.d.mts +96 -0
  85. package/dist/phantom/index.d.ts +96 -0
  86. package/dist/phantom/index.js +14 -0
  87. package/dist/phantom/index.js.map +1 -0
  88. package/dist/phantom/index.mjs +5 -0
  89. package/dist/phantom/index.mjs.map +1 -0
  90. package/dist/psbt-builder-CFOs69Z5.d.mts +131 -0
  91. package/dist/psbt-builder-CFOs69Z5.d.ts +131 -0
  92. package/dist/trezor/index.d.mts +155 -0
  93. package/dist/trezor/index.d.ts +155 -0
  94. package/dist/trezor/index.js +14 -0
  95. package/dist/trezor/index.js.map +1 -0
  96. package/dist/trezor/index.mjs +5 -0
  97. package/dist/trezor/index.mjs.map +1 -0
  98. package/dist/unisat/index.d.mts +75 -0
  99. package/dist/unisat/index.d.ts +75 -0
  100. package/dist/unisat/index.js +13 -0
  101. package/dist/unisat/index.js.map +1 -0
  102. package/dist/unisat/index.mjs +4 -0
  103. package/dist/unisat/index.mjs.map +1 -0
  104. package/dist/utils/index.d.mts +398 -0
  105. package/dist/utils/index.d.ts +398 -0
  106. package/dist/utils/index.js +120 -0
  107. package/dist/utils/index.js.map +1 -0
  108. package/dist/utils/index.mjs +3 -0
  109. package/dist/utils/index.mjs.map +1 -0
  110. package/dist/xverse/index.d.mts +79 -0
  111. package/dist/xverse/index.d.ts +79 -0
  112. package/dist/xverse/index.js +13 -0
  113. package/dist/xverse/index.js.map +1 -0
  114. package/dist/xverse/index.mjs +4 -0
  115. package/dist/xverse/index.mjs.map +1 -0
  116. package/package.json +108 -0
  117. package/src/base.ts +132 -0
  118. package/src/binance/BinanceConnector.ts +307 -0
  119. package/src/binance/index.ts +1 -0
  120. package/src/bitget/BitgetConnector.ts +301 -0
  121. package/src/bitget/index.ts +1 -0
  122. package/src/imtoken/ImTokenConnector.ts +420 -0
  123. package/src/imtoken/index.ts +2 -0
  124. package/src/index.ts +78 -0
  125. package/src/ledger/LedgerConnector.ts +1019 -0
  126. package/src/ledger/index.ts +8 -0
  127. package/src/okx/OKXConnector.ts +230 -0
  128. package/src/okx/index.ts +1 -0
  129. package/src/phantom/PhantomConnector.ts +381 -0
  130. package/src/phantom/index.ts +2 -0
  131. package/src/trezor/TrezorConnector.ts +824 -0
  132. package/src/trezor/index.ts +6 -0
  133. package/src/unisat/UnisatConnector.ts +312 -0
  134. package/src/unisat/index.ts +1 -0
  135. package/src/utils/blockstream.ts +230 -0
  136. package/src/utils/btc-service.ts +364 -0
  137. package/src/utils/index.ts +56 -0
  138. package/src/utils/mempool.ts +232 -0
  139. package/src/utils/psbt-builder.ts +492 -0
  140. package/src/utils/types.ts +183 -0
  141. package/src/xverse/XverseConnector.ts +479 -0
  142. package/src/xverse/index.ts +1 -0
@@ -0,0 +1,13 @@
1
+ 'use strict';
2
+
3
+ var chunkEIJOSZXZ_js = require('../chunk-EIJOSZXZ.js');
4
+ require('../chunk-MFXLQWOE.js');
5
+
6
+
7
+
8
+ Object.defineProperty(exports, "XverseConnector", {
9
+ enumerable: true,
10
+ get: function () { return chunkEIJOSZXZ_js.XverseConnector; }
11
+ });
12
+ //# sourceMappingURL=out.js.map
13
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ export { XverseConnector } from '../chunk-RLZEG6KL.mjs';
2
+ import '../chunk-5Z5Q2Y75.mjs';
3
+ //# sourceMappingURL=out.js.map
4
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"names":[],"mappings":""}
package/package.json ADDED
@@ -0,0 +1,108 @@
1
+ {
2
+ "name": "otx-btc-wallet-connectors",
3
+ "version": "0.1.0",
4
+ "description": "Bitcoin wallet connectors for otx-btc-wallet",
5
+ "license": "MIT",
6
+ "main": "./dist/index.js",
7
+ "module": "./dist/index.mjs",
8
+ "types": "./dist/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "import": "./dist/index.mjs",
12
+ "require": "./dist/index.js",
13
+ "types": "./dist/index.d.ts"
14
+ },
15
+ "./unisat": {
16
+ "import": "./dist/unisat/index.mjs",
17
+ "require": "./dist/unisat/index.js",
18
+ "types": "./dist/unisat/index.d.ts"
19
+ },
20
+ "./xverse": {
21
+ "import": "./dist/xverse/index.mjs",
22
+ "require": "./dist/xverse/index.js",
23
+ "types": "./dist/xverse/index.d.ts"
24
+ },
25
+ "./okx": {
26
+ "import": "./dist/okx/index.mjs",
27
+ "require": "./dist/okx/index.js",
28
+ "types": "./dist/okx/index.d.ts"
29
+ },
30
+ "./leather": {
31
+ "import": "./dist/leather/index.mjs",
32
+ "require": "./dist/leather/index.js",
33
+ "types": "./dist/leather/index.d.ts"
34
+ },
35
+ "./phantom": {
36
+ "import": "./dist/phantom/index.mjs",
37
+ "require": "./dist/phantom/index.js",
38
+ "types": "./dist/phantom/index.d.ts"
39
+ },
40
+ "./bitget": {
41
+ "import": "./dist/bitget/index.mjs",
42
+ "require": "./dist/bitget/index.js",
43
+ "types": "./dist/bitget/index.d.ts"
44
+ },
45
+ "./binance": {
46
+ "import": "./dist/binance/index.mjs",
47
+ "require": "./dist/binance/index.js",
48
+ "types": "./dist/binance/index.d.ts"
49
+ },
50
+ "./ledger": {
51
+ "import": "./dist/ledger/index.mjs",
52
+ "require": "./dist/ledger/index.js",
53
+ "types": "./dist/ledger/index.d.ts"
54
+ },
55
+ "./trezor": {
56
+ "import": "./dist/trezor/index.mjs",
57
+ "require": "./dist/trezor/index.js",
58
+ "types": "./dist/trezor/index.d.ts"
59
+ },
60
+ "./imtoken": {
61
+ "import": "./dist/imtoken/index.mjs",
62
+ "require": "./dist/imtoken/index.js",
63
+ "types": "./dist/imtoken/index.d.ts"
64
+ },
65
+ "./utils": {
66
+ "import": "./dist/utils/index.mjs",
67
+ "require": "./dist/utils/index.js",
68
+ "types": "./dist/utils/index.d.ts"
69
+ }
70
+ },
71
+ "files": [
72
+ "dist",
73
+ "src"
74
+ ],
75
+ "sideEffects": false,
76
+ "dependencies": {
77
+ "@ledgerhq/hw-app-btc": "^10.4.1",
78
+ "@ledgerhq/hw-transport-webusb": "^6.30.0",
79
+ "@trezor/connect-web": "^9.4.3",
80
+ "bitcoinjs-lib": "^7.0.1",
81
+ "sats-connect": "^2.2.0",
82
+ "otx-btc-wallet-core": "0.1.0"
83
+ },
84
+ "devDependencies": {
85
+ "typescript": "^5.3.2",
86
+ "tsup": "^8.0.1"
87
+ },
88
+ "keywords": [
89
+ "bitcoin",
90
+ "wallet",
91
+ "unisat",
92
+ "xverse",
93
+ "okx",
94
+ "leather",
95
+ "phantom",
96
+ "bitget",
97
+ "binance",
98
+ "ledger",
99
+ "trezor",
100
+ "imtoken"
101
+ ],
102
+ "scripts": {
103
+ "build": "tsup",
104
+ "dev": "tsup --watch",
105
+ "clean": "rm -rf dist",
106
+ "typecheck": "tsc --noEmit"
107
+ }
108
+ }
package/src/base.ts ADDED
@@ -0,0 +1,132 @@
1
+ import type {
2
+ BitcoinConnector,
3
+ WalletAccount,
4
+ BitcoinNetwork,
5
+ SignPsbtOptions,
6
+ AddressType,
7
+ } from 'otx-btc-wallet-core';
8
+
9
+ /**
10
+ * Abstract base class for all wallet connectors
11
+ * Provides common functionality and enforces the BitcoinConnector interface
12
+ */
13
+ export abstract class BaseConnector implements BitcoinConnector {
14
+ abstract readonly id: string;
15
+ abstract readonly name: string;
16
+ abstract readonly icon: string;
17
+
18
+ private _ready = false;
19
+ private _accountsChangedCallbacks: Set<(accounts: WalletAccount[]) => void> =
20
+ new Set();
21
+ private _networkChangedCallbacks: Set<(network: BitcoinNetwork) => void> =
22
+ new Set();
23
+
24
+ constructor() {
25
+ this.checkReady();
26
+ // Some wallets inject after DOMContentLoaded
27
+ if (typeof window !== 'undefined') {
28
+ if (document.readyState === 'complete') {
29
+ this.checkReady();
30
+ } else {
31
+ window.addEventListener('load', () => this.checkReady());
32
+ }
33
+ }
34
+ }
35
+
36
+ get ready(): boolean {
37
+ return this._ready;
38
+ }
39
+
40
+ protected set ready(value: boolean) {
41
+ this._ready = value;
42
+ }
43
+ protected abstract getProvider(): unknown;
44
+ protected checkReady(): void {
45
+ this._ready = !!this.getProvider();
46
+ }
47
+ protected ensureInstalled(): void {
48
+ if (!this.ready) {
49
+ throw new Error(`${this.name} wallet is not installed`);
50
+ }
51
+ }
52
+ protected inferAddressType(address: string): AddressType {
53
+ if (address.startsWith('bc1q') || address.startsWith('tb1q')) {
54
+ return 'segwit';
55
+ }
56
+ if (address.startsWith('bc1p') || address.startsWith('tb1p')) {
57
+ return 'taproot';
58
+ }
59
+ if (address.startsWith('3') || address.startsWith('2')) {
60
+ return 'nested-segwit';
61
+ }
62
+ return 'legacy';
63
+ }
64
+
65
+ protected handleError(error: unknown): never {
66
+ console.error('Exception in connector', this.id, error);
67
+ // Throw raw error for other cases
68
+ throw error;
69
+ }
70
+ // Abstract methods that must be implemented
71
+ abstract connect(network?: BitcoinNetwork): Promise<WalletAccount>;
72
+ abstract disconnect(): Promise<void>;
73
+ abstract getAccounts(): Promise<WalletAccount[]>;
74
+ abstract signMessage(message: string): Promise<string>;
75
+ abstract signPsbt(psbtHex: string, options?: SignPsbtOptions): Promise<string>;
76
+ abstract sendTransaction(to: string, satoshis: number): Promise<string>;
77
+ abstract getNetwork(): Promise<BitcoinNetwork>;
78
+
79
+ // Optional methods - can be overridden
80
+ signPsbts?(
81
+ psbtHexs: string[],
82
+ options?: SignPsbtOptions
83
+ ): Promise<string[]>;
84
+
85
+ switchNetwork?(network: BitcoinNetwork): Promise<void>;
86
+
87
+ /**
88
+ * Subscribe to account changes
89
+ */
90
+ onAccountsChanged(callback: (accounts: WalletAccount[]) => void): () => void {
91
+ this._accountsChangedCallbacks.add(callback);
92
+ return () => {
93
+ this._accountsChangedCallbacks.delete(callback);
94
+ };
95
+ }
96
+
97
+ /**
98
+ * Subscribe to network changes
99
+ */
100
+ onNetworkChanged(callback: (network: BitcoinNetwork) => void): () => void {
101
+ this._networkChangedCallbacks.add(callback);
102
+ return () => {
103
+ this._networkChangedCallbacks.delete(callback);
104
+ };
105
+ }
106
+
107
+ /**
108
+ * Emit account change event
109
+ */
110
+ protected emitAccountsChanged(accounts: WalletAccount[]): void {
111
+ for (const callback of this._accountsChangedCallbacks) {
112
+ callback(accounts);
113
+ }
114
+ }
115
+
116
+ /**
117
+ * Emit network change event
118
+ */
119
+ protected emitNetworkChanged(network: BitcoinNetwork): void {
120
+ for (const callback of this._networkChangedCallbacks) {
121
+ callback(network);
122
+ }
123
+ }
124
+
125
+ /**
126
+ * Clean up all listeners
127
+ */
128
+ protected cleanup(): void {
129
+ this._accountsChangedCallbacks.clear();
130
+ this._networkChangedCallbacks.clear();
131
+ }
132
+ }
@@ -0,0 +1,307 @@
1
+ import type {
2
+ WalletAccount,
3
+ BitcoinNetwork,
4
+ SignPsbtOptions,
5
+ } from 'otx-btc-wallet-core';
6
+ import { BaseConnector } from '../base';
7
+
8
+ /**
9
+ * Binance sign PSBT options
10
+ * @see https://developers.binance.com/docs/binance-w3w/bitcoin-provider
11
+ */
12
+ interface BinanceSignPsbtOptions {
13
+ autoFinalized?: boolean;
14
+ toSignInputs?: Array<{
15
+ index: number;
16
+ address?: string;
17
+ publicKey?: string;
18
+ sighashTypes?: number[];
19
+ disableTweakSigner?: boolean;
20
+ }>;
21
+ }
22
+
23
+ /**
24
+ * Binance Bitcoin provider interface
25
+ * Provider is accessible via window.binancew3w.bitcoin
26
+ * @see https://developers.binance.com/docs/binance-w3w/bitcoin-provider
27
+ */
28
+ interface BinanceBitcoinProvider {
29
+ requestAccounts(): Promise<string[]>;
30
+ getAccounts(): Promise<string[]>;
31
+ getPublicKey(): Promise<string>;
32
+ getBalance(): Promise<{ confirmed: number; unconfirmed: number; total: number }>;
33
+ getNetwork(): Promise<string>;
34
+ switchNetwork(network: 'livenet' | 'testnet' | 'signet'): Promise<boolean>;
35
+ signMessage(msg: string, type?: 'ecdsa' | 'bip322-simple'): Promise<string>;
36
+ signPsbt(psbtHex: string, options?: BinanceSignPsbtOptions): Promise<string>;
37
+ signPsbts(psbtHexs: string[], options?: BinanceSignPsbtOptions[]): Promise<string[]>;
38
+ pushPsbt(psbtHex: string): Promise<string>;
39
+ sendBitcoin(toAddress: string, satoshis: number, options?: { feeRate?: number }): Promise<string>;
40
+ on(event: 'accountsChanged', callback: (accounts: string[]) => void): void;
41
+ on(event: 'networkChanged', callback: (network: string) => void): void;
42
+ removeListener(event: 'accountsChanged', callback: (accounts: string[]) => void): void;
43
+ removeListener(event: 'networkChanged', callback: (network: string) => void): void;
44
+ }
45
+
46
+ // Extend window type
47
+ declare global {
48
+ interface Window {
49
+ binancew3w?: {
50
+ bitcoin?: BinanceBitcoinProvider;
51
+ };
52
+ }
53
+ }
54
+
55
+ // Binance wallet icon
56
+ const BINANCE_ICON =
57
+ 'data:image/jpeg;base64,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';
58
+
59
+ /**
60
+ * Binance network type
61
+ */
62
+ type BinanceNetwork = 'livenet' | 'testnet' | 'signet';
63
+
64
+ /**
65
+ * Binance Wallet Connector
66
+ *
67
+ * @see https://developers.binance.com/docs/binance-w3w/bitcoin-provider
68
+ */
69
+ export class BinanceConnector extends BaseConnector {
70
+ readonly id = 'binance';
71
+ readonly name = 'Binance Wallet';
72
+ readonly icon = BINANCE_ICON;
73
+
74
+ private _removeAccountChangeListener: (() => void) | null = null;
75
+ private _removeNetworkChangeListener: (() => void) | null = null;
76
+
77
+ protected getProvider(): BinanceBitcoinProvider | undefined {
78
+ if (typeof window === 'undefined') return undefined;
79
+ return window.binancew3w?.bitcoin;
80
+ }
81
+
82
+ async connect(network: BitcoinNetwork = 'mainnet'): Promise<WalletAccount> {
83
+ this.ensureInstalled();
84
+ const provider = this.getProvider()!;
85
+
86
+ try {
87
+ const accounts = await provider.requestAccounts();
88
+ if (!accounts || accounts.length === 0) {
89
+ throw new Error('No accounts found');
90
+ }
91
+
92
+ // Switch network if needed
93
+ await this.ensureNetwork(provider, network);
94
+
95
+ const publicKey = await provider.getPublicKey();
96
+
97
+ // Setup event listeners
98
+ this.setupEventListeners();
99
+
100
+ return {
101
+ address: accounts[0] ?? '',
102
+ publicKey,
103
+ type: this.inferAddressType(accounts[0] ?? ''),
104
+ };
105
+ } catch (error) {
106
+ this.handleError(error);
107
+ }
108
+ }
109
+
110
+ private async ensureNetwork(provider: BinanceBitcoinProvider, network: BitcoinNetwork): Promise<void> {
111
+ const currentNetwork = await provider.getNetwork();
112
+ const targetNetwork = this.mapToBinanceNetwork(network);
113
+
114
+ if (currentNetwork !== targetNetwork) {
115
+ await provider.switchNetwork(targetNetwork);
116
+ }
117
+ }
118
+
119
+ private setupEventListeners(): void {
120
+ const provider = this.getProvider();
121
+ if (!provider) return;
122
+
123
+ // Remove existing listeners
124
+ this.removeEventListeners();
125
+
126
+ // Account change listener
127
+ const handleAccountsChanged = (accounts: string[]) => {
128
+ if (!accounts || accounts.length === 0) {
129
+ this.emitAccountsChanged([]);
130
+ return;
131
+ }
132
+
133
+ provider.getPublicKey().then((publicKey) => {
134
+ const walletAccounts: WalletAccount[] = accounts.map((address) => ({
135
+ address,
136
+ publicKey,
137
+ type: this.inferAddressType(address),
138
+ }));
139
+ this.emitAccountsChanged(walletAccounts);
140
+ }).catch(() => {
141
+ this.emitAccountsChanged([]);
142
+ });
143
+ };
144
+
145
+ // Network change listener
146
+ const handleNetworkChanged = (network: string) => {
147
+ const btcNetwork = this.mapNetwork(network);
148
+ this.emitNetworkChanged(btcNetwork);
149
+ };
150
+
151
+ provider.on('accountsChanged', handleAccountsChanged);
152
+ provider.on('networkChanged', handleNetworkChanged);
153
+
154
+ this._removeAccountChangeListener = () => {
155
+ provider.removeListener('accountsChanged', handleAccountsChanged);
156
+ };
157
+ this._removeNetworkChangeListener = () => {
158
+ provider.removeListener('networkChanged', handleNetworkChanged);
159
+ };
160
+ }
161
+
162
+ private removeEventListeners(): void {
163
+ this._removeAccountChangeListener?.();
164
+ this._removeAccountChangeListener = null;
165
+
166
+ this._removeNetworkChangeListener?.();
167
+ this._removeNetworkChangeListener = null;
168
+ }
169
+
170
+ async disconnect(): Promise<void> {
171
+ this.removeEventListeners();
172
+ this.cleanup();
173
+ }
174
+
175
+ async getAccounts(): Promise<WalletAccount[]> {
176
+ this.ensureInstalled();
177
+ const provider = this.getProvider()!;
178
+
179
+ try {
180
+ const addresses = await provider.getAccounts();
181
+ const publicKey = await provider.getPublicKey();
182
+
183
+ return addresses.map((address) => ({
184
+ address,
185
+ publicKey,
186
+ type: this.inferAddressType(address),
187
+ }));
188
+ } catch (error) {
189
+ this.handleError(error);
190
+ }
191
+ }
192
+
193
+ async signMessage(message: string): Promise<string> {
194
+ this.ensureInstalled();
195
+ const provider = this.getProvider()!;
196
+
197
+ try {
198
+ return await provider.signMessage(message);
199
+ } catch (error) {
200
+ this.handleError(error);
201
+ }
202
+ }
203
+
204
+ async signPsbt(psbtHex: string, options?: SignPsbtOptions): Promise<string> {
205
+ this.ensureInstalled();
206
+ const provider = this.getProvider()!;
207
+
208
+ try {
209
+ const binanceOptions: BinanceSignPsbtOptions = {
210
+ autoFinalized: options?.autoFinalize ?? true,
211
+ };
212
+
213
+ if (options?.toSignInputs) {
214
+ binanceOptions.toSignInputs = options.toSignInputs;
215
+ }
216
+
217
+ return await provider.signPsbt(psbtHex, binanceOptions);
218
+ } catch (error) {
219
+ this.handleError(error);
220
+ }
221
+ }
222
+
223
+ async signPsbts(psbtHexs: string[], options?: SignPsbtOptions): Promise<string[]> {
224
+ this.ensureInstalled();
225
+ const provider = this.getProvider()!;
226
+
227
+ try {
228
+ const binanceOptions: BinanceSignPsbtOptions = {
229
+ autoFinalized: options?.autoFinalize ?? true,
230
+ };
231
+
232
+ if (options?.toSignInputs) {
233
+ binanceOptions.toSignInputs = options.toSignInputs;
234
+ }
235
+
236
+ // Create options array for each PSBT
237
+ const optionsArray = psbtHexs.map(() => binanceOptions);
238
+
239
+ return await provider.signPsbts(psbtHexs, optionsArray);
240
+ } catch (error) {
241
+ this.handleError(error);
242
+ }
243
+ }
244
+
245
+ async sendTransaction(to: string, satoshis: number): Promise<string> {
246
+ this.ensureInstalled();
247
+ const provider = this.getProvider()!;
248
+
249
+ try {
250
+ return await provider.sendBitcoin(to, satoshis);
251
+ } catch (error) {
252
+ this.handleError(error);
253
+ }
254
+ }
255
+
256
+ async getNetwork(): Promise<BitcoinNetwork> {
257
+ this.ensureInstalled();
258
+ const provider = this.getProvider()!;
259
+
260
+ try {
261
+ const network = await provider.getNetwork();
262
+ return this.mapNetwork(network);
263
+ } catch (error) {
264
+ this.handleError(error);
265
+ }
266
+ }
267
+
268
+ async switchNetwork(network: BitcoinNetwork): Promise<void> {
269
+ this.ensureInstalled();
270
+ const provider = this.getProvider()!;
271
+
272
+ try {
273
+ const binanceNetwork = this.mapToBinanceNetwork(network);
274
+ await provider.switchNetwork(binanceNetwork);
275
+ } catch (error) {
276
+ this.handleError(error);
277
+ }
278
+ }
279
+
280
+ private mapNetwork(network: string): BitcoinNetwork {
281
+ switch (network.toLowerCase()) {
282
+ case 'livenet':
283
+ case 'mainnet':
284
+ return 'mainnet';
285
+ case 'testnet':
286
+ return 'testnet';
287
+ case 'signet':
288
+ return 'signet';
289
+ default:
290
+ return 'mainnet';
291
+ }
292
+ }
293
+
294
+ private mapToBinanceNetwork(network: BitcoinNetwork): BinanceNetwork {
295
+ switch (network) {
296
+ case 'mainnet':
297
+ return 'livenet';
298
+ case 'testnet':
299
+ case 'testnet4':
300
+ return 'testnet';
301
+ case 'signet':
302
+ return 'signet';
303
+ default:
304
+ return 'livenet';
305
+ }
306
+ }
307
+ }
@@ -0,0 +1 @@
1
+ export { BinanceConnector } from './BinanceConnector';