@originals/sdk 1.4.2 → 1.4.3

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 (212) hide show
  1. package/package.json +4 -1
  2. package/.eslintrc.json +0 -33
  3. package/src/adapters/FeeOracleMock.ts +0 -9
  4. package/src/adapters/index.ts +0 -5
  5. package/src/adapters/providers/OrdHttpProvider.ts +0 -126
  6. package/src/adapters/providers/OrdMockProvider.ts +0 -101
  7. package/src/adapters/types.ts +0 -66
  8. package/src/bitcoin/BitcoinManager.ts +0 -330
  9. package/src/bitcoin/BroadcastClient.ts +0 -54
  10. package/src/bitcoin/OrdinalsClient.ts +0 -119
  11. package/src/bitcoin/PSBTBuilder.ts +0 -106
  12. package/src/bitcoin/fee-calculation.ts +0 -38
  13. package/src/bitcoin/providers/OrdNodeProvider.ts +0 -92
  14. package/src/bitcoin/providers/OrdinalsProvider.ts +0 -56
  15. package/src/bitcoin/providers/types.ts +0 -59
  16. package/src/bitcoin/transactions/commit.ts +0 -465
  17. package/src/bitcoin/transactions/index.ts +0 -13
  18. package/src/bitcoin/transfer.ts +0 -43
  19. package/src/bitcoin/utxo-selection.ts +0 -322
  20. package/src/bitcoin/utxo.ts +0 -113
  21. package/src/contexts/credentials-v1.json +0 -237
  22. package/src/contexts/credentials-v2-examples.json +0 -5
  23. package/src/contexts/credentials-v2.json +0 -340
  24. package/src/contexts/credentials.json +0 -237
  25. package/src/contexts/data-integrity-v2.json +0 -81
  26. package/src/contexts/dids.json +0 -58
  27. package/src/contexts/ed255192020.json +0 -93
  28. package/src/contexts/ordinals-plus.json +0 -23
  29. package/src/contexts/originals.json +0 -22
  30. package/src/core/OriginalsSDK.ts +0 -416
  31. package/src/crypto/Multikey.ts +0 -194
  32. package/src/crypto/Signer.ts +0 -254
  33. package/src/crypto/noble-init.ts +0 -121
  34. package/src/did/BtcoDidResolver.ts +0 -227
  35. package/src/did/DIDManager.ts +0 -694
  36. package/src/did/Ed25519Verifier.ts +0 -68
  37. package/src/did/KeyManager.ts +0 -236
  38. package/src/did/WebVHManager.ts +0 -498
  39. package/src/did/createBtcoDidDocument.ts +0 -59
  40. package/src/did/providers/OrdinalsClientProviderAdapter.ts +0 -68
  41. package/src/events/EventEmitter.ts +0 -222
  42. package/src/events/index.ts +0 -19
  43. package/src/events/types.ts +0 -331
  44. package/src/examples/basic-usage.ts +0 -78
  45. package/src/examples/create-module-original.ts +0 -435
  46. package/src/examples/full-lifecycle-flow.ts +0 -514
  47. package/src/examples/run.ts +0 -60
  48. package/src/index.ts +0 -150
  49. package/src/kinds/KindRegistry.ts +0 -290
  50. package/src/kinds/index.ts +0 -74
  51. package/src/kinds/types.ts +0 -470
  52. package/src/kinds/validators/AgentValidator.ts +0 -257
  53. package/src/kinds/validators/AppValidator.ts +0 -211
  54. package/src/kinds/validators/DatasetValidator.ts +0 -242
  55. package/src/kinds/validators/DocumentValidator.ts +0 -311
  56. package/src/kinds/validators/MediaValidator.ts +0 -269
  57. package/src/kinds/validators/ModuleValidator.ts +0 -225
  58. package/src/kinds/validators/base.ts +0 -276
  59. package/src/kinds/validators/index.ts +0 -12
  60. package/src/lifecycle/BatchOperations.ts +0 -373
  61. package/src/lifecycle/LifecycleManager.ts +0 -2126
  62. package/src/lifecycle/OriginalsAsset.ts +0 -524
  63. package/src/lifecycle/ProvenanceQuery.ts +0 -280
  64. package/src/lifecycle/ResourceVersioning.ts +0 -163
  65. package/src/migration/MigrationManager.ts +0 -527
  66. package/src/migration/audit/AuditLogger.ts +0 -176
  67. package/src/migration/checkpoint/CheckpointManager.ts +0 -112
  68. package/src/migration/checkpoint/CheckpointStorage.ts +0 -101
  69. package/src/migration/index.ts +0 -33
  70. package/src/migration/operations/BaseMigration.ts +0 -126
  71. package/src/migration/operations/PeerToBtcoMigration.ts +0 -105
  72. package/src/migration/operations/PeerToWebvhMigration.ts +0 -62
  73. package/src/migration/operations/WebvhToBtcoMigration.ts +0 -105
  74. package/src/migration/rollback/RollbackManager.ts +0 -170
  75. package/src/migration/state/StateMachine.ts +0 -92
  76. package/src/migration/state/StateTracker.ts +0 -156
  77. package/src/migration/types.ts +0 -344
  78. package/src/migration/validation/BitcoinValidator.ts +0 -107
  79. package/src/migration/validation/CredentialValidator.ts +0 -62
  80. package/src/migration/validation/DIDCompatibilityValidator.ts +0 -151
  81. package/src/migration/validation/LifecycleValidator.ts +0 -64
  82. package/src/migration/validation/StorageValidator.ts +0 -79
  83. package/src/migration/validation/ValidationPipeline.ts +0 -213
  84. package/src/resources/ResourceManager.ts +0 -655
  85. package/src/resources/index.ts +0 -21
  86. package/src/resources/types.ts +0 -202
  87. package/src/storage/LocalStorageAdapter.ts +0 -61
  88. package/src/storage/MemoryStorageAdapter.ts +0 -29
  89. package/src/storage/StorageAdapter.ts +0 -25
  90. package/src/storage/index.ts +0 -3
  91. package/src/types/bitcoin.ts +0 -98
  92. package/src/types/common.ts +0 -92
  93. package/src/types/credentials.ts +0 -88
  94. package/src/types/did.ts +0 -31
  95. package/src/types/external-shims.d.ts +0 -53
  96. package/src/types/index.ts +0 -7
  97. package/src/types/network.ts +0 -175
  98. package/src/utils/EventLogger.ts +0 -298
  99. package/src/utils/Logger.ts +0 -322
  100. package/src/utils/MetricsCollector.ts +0 -358
  101. package/src/utils/bitcoin-address.ts +0 -130
  102. package/src/utils/cbor.ts +0 -12
  103. package/src/utils/encoding.ts +0 -127
  104. package/src/utils/hash.ts +0 -6
  105. package/src/utils/retry.ts +0 -46
  106. package/src/utils/satoshi-validation.ts +0 -196
  107. package/src/utils/serialization.ts +0 -96
  108. package/src/utils/telemetry.ts +0 -40
  109. package/src/utils/validation.ts +0 -119
  110. package/src/vc/CredentialManager.ts +0 -918
  111. package/src/vc/Issuer.ts +0 -100
  112. package/src/vc/Verifier.ts +0 -47
  113. package/src/vc/cryptosuites/bbs.ts +0 -253
  114. package/src/vc/cryptosuites/bbsSimple.ts +0 -21
  115. package/src/vc/cryptosuites/eddsa.ts +0 -99
  116. package/src/vc/documentLoader.ts +0 -67
  117. package/src/vc/proofs/data-integrity.ts +0 -33
  118. package/src/vc/utils/jsonld.ts +0 -18
  119. package/tests/__mocks__/bbs-signatures.js +0 -17
  120. package/tests/__mocks__/mf-base58.js +0 -24
  121. package/tests/fixtures/did-documents.ts +0 -247
  122. package/tests/index.test.ts +0 -21
  123. package/tests/integration/BatchOperations.test.ts +0 -531
  124. package/tests/integration/CompleteLifecycle.e2e.test.ts +0 -735
  125. package/tests/integration/CredentialManager.test.ts +0 -42
  126. package/tests/integration/DIDManager.test.ts +0 -41
  127. package/tests/integration/DidPeerToWebVhFlow.test.ts +0 -351
  128. package/tests/integration/Events.test.ts +0 -435
  129. package/tests/integration/Lifecycle.transfer.btco.integration.test.ts +0 -25
  130. package/tests/integration/LifecycleManager.test.ts +0 -21
  131. package/tests/integration/MultikeyFlow.test.ts +0 -52
  132. package/tests/integration/TelemetryIntegration.test.ts +0 -395
  133. package/tests/integration/WebVhPublish.test.ts +0 -48
  134. package/tests/integration/createTypedOriginal.test.ts +0 -379
  135. package/tests/integration/migration/peer-to-webvh.test.ts +0 -172
  136. package/tests/manual/test-commit-creation.ts +0 -323
  137. package/tests/mocks/MockKeyStore.ts +0 -38
  138. package/tests/mocks/adapters/MemoryStorageAdapter.ts +0 -24
  139. package/tests/mocks/adapters/MockFeeOracle.ts +0 -11
  140. package/tests/mocks/adapters/MockOrdinalsProvider.ts +0 -76
  141. package/tests/mocks/adapters/OrdMockProvider.test.ts +0 -176
  142. package/tests/mocks/adapters/index.ts +0 -6
  143. package/tests/performance/BatchOperations.perf.test.ts +0 -403
  144. package/tests/performance/logging.perf.test.ts +0 -336
  145. package/tests/sdk.test.ts +0 -43
  146. package/tests/security/bitcoin-penetration-tests.test.ts +0 -622
  147. package/tests/setup.bun.ts +0 -69
  148. package/tests/setup.jest.ts +0 -23
  149. package/tests/stress/batch-operations-stress.test.ts +0 -571
  150. package/tests/unit/adapters/FeeOracleMock.test.ts +0 -40
  151. package/tests/unit/bitcoin/BitcoinManager.test.ts +0 -293
  152. package/tests/unit/bitcoin/BroadcastClient.test.ts +0 -52
  153. package/tests/unit/bitcoin/OrdNodeProvider.test.ts +0 -53
  154. package/tests/unit/bitcoin/OrdinalsClient.test.ts +0 -381
  155. package/tests/unit/bitcoin/OrdinalsClientProvider.test.ts +0 -102
  156. package/tests/unit/bitcoin/PSBTBuilder.test.ts +0 -84
  157. package/tests/unit/bitcoin/fee-calculation.test.ts +0 -261
  158. package/tests/unit/bitcoin/transactions/commit.test.ts +0 -649
  159. package/tests/unit/bitcoin/transfer.test.ts +0 -31
  160. package/tests/unit/bitcoin/utxo-selection-new.test.ts +0 -502
  161. package/tests/unit/bitcoin/utxo.more.test.ts +0 -39
  162. package/tests/unit/bitcoin/utxo.selection.test.ts +0 -38
  163. package/tests/unit/core/OriginalsSDK.test.ts +0 -152
  164. package/tests/unit/crypto/Multikey.test.ts +0 -206
  165. package/tests/unit/crypto/Signer.test.ts +0 -408
  166. package/tests/unit/did/BtcoDidResolver.test.ts +0 -611
  167. package/tests/unit/did/DIDManager.more.test.ts +0 -43
  168. package/tests/unit/did/DIDManager.test.ts +0 -185
  169. package/tests/unit/did/Ed25519Verifier.test.ts +0 -160
  170. package/tests/unit/did/KeyManager.test.ts +0 -452
  171. package/tests/unit/did/OrdinalsClientProviderAdapter.test.ts +0 -45
  172. package/tests/unit/did/WebVHManager.test.ts +0 -435
  173. package/tests/unit/did/createBtcoDidDocument.test.ts +0 -67
  174. package/tests/unit/did/providers/OrdinalsClientProviderAdapter.test.ts +0 -159
  175. package/tests/unit/events/EventEmitter.test.ts +0 -407
  176. package/tests/unit/kinds/KindRegistry.test.ts +0 -329
  177. package/tests/unit/kinds/types.test.ts +0 -409
  178. package/tests/unit/kinds/validators.test.ts +0 -651
  179. package/tests/unit/lifecycle/BatchOperations.test.ts +0 -527
  180. package/tests/unit/lifecycle/LifecycleManager.cleanapi.test.ts +0 -441
  181. package/tests/unit/lifecycle/LifecycleManager.keymanagement.test.ts +0 -312
  182. package/tests/unit/lifecycle/LifecycleManager.prov.test.ts +0 -18
  183. package/tests/unit/lifecycle/LifecycleManager.test.ts +0 -213
  184. package/tests/unit/lifecycle/LifecycleManager.transfer.unit.test.ts +0 -30
  185. package/tests/unit/lifecycle/OriginalsAsset.test.ts +0 -176
  186. package/tests/unit/lifecycle/ProvenanceQuery.test.ts +0 -577
  187. package/tests/unit/lifecycle/ResourceVersioning.test.ts +0 -651
  188. package/tests/unit/resources/ResourceManager.test.ts +0 -740
  189. package/tests/unit/storage/MemoryStorageAdapter.test.ts +0 -93
  190. package/tests/unit/types/network.test.ts +0 -255
  191. package/tests/unit/utils/EventIntegration.test.ts +0 -384
  192. package/tests/unit/utils/Logger.test.ts +0 -473
  193. package/tests/unit/utils/MetricsCollector.test.ts +0 -358
  194. package/tests/unit/utils/bitcoin-address.test.ts +0 -250
  195. package/tests/unit/utils/cbor.test.ts +0 -35
  196. package/tests/unit/utils/encoding.test.ts +0 -318
  197. package/tests/unit/utils/hash.test.ts +0 -12
  198. package/tests/unit/utils/retry.test.ts +0 -100
  199. package/tests/unit/utils/satoshi-validation.test.ts +0 -354
  200. package/tests/unit/utils/serialization.test.ts +0 -124
  201. package/tests/unit/utils/telemetry.test.ts +0 -52
  202. package/tests/unit/utils/validation.test.ts +0 -141
  203. package/tests/unit/vc/CredentialManager.helpers.test.ts +0 -527
  204. package/tests/unit/vc/CredentialManager.test.ts +0 -487
  205. package/tests/unit/vc/Issuer.test.ts +0 -107
  206. package/tests/unit/vc/Verifier.test.ts +0 -525
  207. package/tests/unit/vc/bbs.test.ts +0 -282
  208. package/tests/unit/vc/cryptosuites/eddsa.test.ts +0 -398
  209. package/tests/unit/vc/documentLoader.test.ts +0 -121
  210. package/tests/unit/vc/proofs/data-integrity.test.ts +0 -24
  211. package/tsconfig.json +0 -31
  212. package/tsconfig.test.json +0 -15
@@ -1,322 +0,0 @@
1
- /**
2
- * UTXO Selection for Ordinals Transactions
3
- *
4
- * This module implements functions for selecting UTXOs for ordinals transactions.
5
- * It provides a simple coin selection algorithm optimized for ordinals inscriptions.
6
- *
7
- * Ported from legacy ordinalsplus transaction infrastructure.
8
- */
9
-
10
- import {
11
- Utxo,
12
- DUST_LIMIT_SATS,
13
- ResourceUtxo,
14
- ResourceUtxoSelectionOptions,
15
- ResourceUtxoSelectionResult
16
- } from '../types/bitcoin.js';
17
- import { calculateFee } from './fee-calculation.js';
18
-
19
- // Minimum dust limit for Bitcoin outputs (546 satoshis)
20
- const MIN_DUST_LIMIT = DUST_LIMIT_SATS;
21
-
22
- /**
23
- * Estimates transaction size in vbytes based on input and output counts
24
- * This is a simplified calculation, and actual size may vary based on script types
25
- *
26
- * @param inputCount Number of inputs in the transaction
27
- * @param outputCount Number of outputs in the transaction
28
- * @returns Estimated transaction size in vbytes
29
- */
30
- export function estimateTransactionSize(inputCount: number, outputCount: number): number {
31
- // Rough estimation based on segwit transaction format
32
- // Transaction overhead: ~10 vbytes
33
- // Each input: ~68 vbytes (P2WPKH)
34
- // Each output: ~31 vbytes
35
- return 10 + (inputCount * 68) + (outputCount * 31);
36
- }
37
-
38
- /**
39
- * Tags UTXOs as resource-containing or regular based on provided data
40
- *
41
- * @param utxos List of UTXOs to tag
42
- * @param resourceData Optional data about which UTXOs contain resources
43
- * @returns Tagged ResourceUtxo[] list with hasResource flags set appropriately
44
- */
45
- export function tagResourceUtxos(
46
- utxos: ResourceUtxo[],
47
- resourceData?: {[utxoId: string]: boolean}
48
- ): ResourceUtxo[] {
49
- return utxos.map(utxo => {
50
- const utxoId = `${utxo.txid}:${utxo.vout}`;
51
- const hasResource = resourceData ? !!resourceData[utxoId] : utxo.hasResource || false;
52
-
53
- return {
54
- ...utxo,
55
- hasResource
56
- };
57
- });
58
- }
59
-
60
- /**
61
- * Options for simple UTXO selection
62
- */
63
- export interface SimpleUtxoSelectionOptions {
64
- /** Target amount to reach (in satoshis) */
65
- targetAmount: number;
66
- /** Optional maximum amount of UTXOs to use */
67
- maxNumUtxos?: number;
68
- /** Optional preference for UTXO selection strategy */
69
- strategy?: 'minimize_change' | 'minimize_inputs' | 'optimize_size';
70
- }
71
-
72
- /**
73
- * Result of simple UTXO selection
74
- */
75
- export interface SimpleUtxoSelectionResult {
76
- /** Selected UTXOs for the transaction */
77
- selectedUtxos: Utxo[];
78
- /** Total value of selected UTXOs */
79
- totalInputValue: number;
80
- /** Estimated change amount (if any) */
81
- changeAmount: number;
82
- }
83
-
84
- /**
85
- * Selects UTXOs to cover a target amount using a simplified approach.
86
- * This version is used specifically for commit transactions where we
87
- * don't need the more complex resource-aware selection.
88
- *
89
- * @param utxos - Available UTXOs
90
- * @param options - Target amount or detailed options
91
- * @returns Selected UTXOs and related information
92
- */
93
- export function selectUtxos(
94
- utxos: Utxo[],
95
- options: number | SimpleUtxoSelectionOptions
96
- ): SimpleUtxoSelectionResult {
97
- // Handle simple number input
98
- const targetAmount = typeof options === 'number'
99
- ? options
100
- : options.targetAmount;
101
-
102
- const maxNumUtxos = typeof options === 'number'
103
- ? undefined
104
- : options.maxNumUtxos;
105
-
106
- const strategy = typeof options === 'number'
107
- ? 'minimize_inputs'
108
- : options.strategy || 'minimize_inputs';
109
-
110
- // Validate inputs
111
- if (!utxos || utxos.length === 0) {
112
- throw new Error('No UTXOs provided for selection.');
113
- }
114
-
115
- if (targetAmount <= 0) {
116
- throw new Error(`Invalid target amount: ${targetAmount}`);
117
- }
118
-
119
- // Sort UTXOs based on selected strategy
120
- let sortedUtxos = [...utxos];
121
-
122
- if (strategy === 'minimize_inputs') {
123
- // Sort by value descending to use fewest inputs
124
- sortedUtxos.sort((a, b) => b.value - a.value);
125
- } else if (strategy === 'minimize_change') {
126
- // Sort by value ascending to minimize change
127
- sortedUtxos.sort((a, b) => a.value - b.value);
128
- } else if (strategy === 'optimize_size') {
129
- // Sort by value/size ratio (value density) for optimal fee efficiency
130
- // For now, just sort by value as a reasonable approximation
131
- sortedUtxos.sort((a, b) => b.value - a.value);
132
- }
133
-
134
- const selected: Utxo[] = [];
135
- let totalValue = 0;
136
-
137
- // Add UTXOs until we reach the target amount
138
- for (const utxo of sortedUtxos) {
139
- // Skip invalid UTXOs
140
- if (!utxo.txid || utxo.vout === undefined || !utxo.value) {
141
- console.warn(`Skipping invalid UTXO: ${utxo.txid}:${utxo.vout}`);
142
- continue;
143
- }
144
-
145
- selected.push(utxo);
146
- totalValue += utxo.value;
147
-
148
- // Check if we've reached the target
149
- if (totalValue >= targetAmount) {
150
- break;
151
- }
152
-
153
- // Check if we've reached the maximum allowed number of UTXOs
154
- if (maxNumUtxos && selected.length >= maxNumUtxos) {
155
- break;
156
- }
157
- }
158
-
159
- // Check if we have enough funds
160
- if (totalValue < targetAmount) {
161
- throw new Error(`Insufficient funds. Required: ${targetAmount}, Available: ${totalValue} from ${utxos.length} UTXOs.`);
162
- }
163
-
164
- // Calculate change amount
165
- const changeAmount = totalValue - targetAmount;
166
-
167
- return {
168
- selectedUtxos: selected,
169
- totalInputValue: totalValue,
170
- changeAmount
171
- };
172
- }
173
-
174
- /**
175
- * Selects UTXOs for a transaction, excluding UTXOs with resources unless explicitly allowed
176
- *
177
- * @param availableUtxos List of available UTXOs to select from
178
- * @param options Configuration options for the selection process
179
- * @returns Selection result with chosen UTXOs and fee information
180
- * @throws Error if insufficient funds or if all available UTXOs contain resources
181
- */
182
- export function selectResourceUtxos(
183
- availableUtxos: ResourceUtxo[],
184
- options: ResourceUtxoSelectionOptions
185
- ): ResourceUtxoSelectionResult {
186
- const {
187
- requiredAmount,
188
- feeRate,
189
- allowResourceUtxos = false,
190
- preferOlder = false,
191
- preferCloserAmount = false,
192
- avoidUtxoIds = []
193
- } = options;
194
-
195
- // Convert requiredAmount to bigint for compatibility with fee calculations
196
- const requiredAmountBigInt = BigInt(requiredAmount);
197
-
198
- // Filter out UTXOs to avoid and those with resources if not allowed
199
- let eligibleUtxos = availableUtxos.filter(utxo => {
200
- const utxoId = `${utxo.txid}:${utxo.vout}`;
201
- const shouldAvoid = avoidUtxoIds.includes(utxoId);
202
- const containsResource = utxo.hasResource === true;
203
-
204
- // Skip this UTXO if it's in the avoid list
205
- if (shouldAvoid) return false;
206
-
207
- // Skip this UTXO if it contains a resource and we're not allowed to use resource UTXOs
208
- if (containsResource && !allowResourceUtxos) return false;
209
-
210
- return true;
211
- });
212
-
213
- if (eligibleUtxos.length === 0) {
214
- // Special error message if we have UTXOs but they all contain resources
215
- if (availableUtxos.length > 0 && availableUtxos.every(u => u.hasResource)) {
216
- throw new Error('All available UTXOs contain resources and cannot be used for fees/payments. Please add non-resource UTXOs to your wallet.');
217
- }
218
- throw new Error('No eligible UTXOs available for selection');
219
- }
220
-
221
- // Apply sorting strategy
222
- if (preferCloserAmount) {
223
- // Sort by closest to required amount (but still above it)
224
- eligibleUtxos.sort((a, b) => {
225
- const aDiff = a.value - requiredAmount;
226
- const bDiff = b.value - requiredAmount;
227
-
228
- // Prioritize UTXOs that cover the amount
229
- if (aDiff >= 0 && bDiff < 0) return -1;
230
- if (aDiff < 0 && bDiff >= 0) return 1;
231
-
232
- // If both cover or both don't cover, prefer the one closer to required amount
233
- return Math.abs(aDiff) - Math.abs(bDiff);
234
- });
235
- } else if (preferOlder) {
236
- // Prefer older UTXOs (by txid as a proxy for age - not perfect but simple)
237
- eligibleUtxos.sort((a, b) => a.txid.localeCompare(b.txid));
238
- } else {
239
- // Default: sort by value descending (largest first)
240
- eligibleUtxos.sort((a, b) => b.value - a.value);
241
- }
242
-
243
- // Initial fee estimation (1 input, 2 outputs - payment and change)
244
- let estimatedVbytes = estimateTransactionSize(1, 2);
245
- let estimatedFee = calculateFee(estimatedVbytes, feeRate);
246
-
247
- // Target amount including estimated fee
248
- let targetAmount = requiredAmountBigInt + estimatedFee;
249
-
250
- // Select UTXOs
251
- const selectedUtxos: ResourceUtxo[] = [];
252
- let totalSelectedValue = 0n;
253
-
254
- // First pass: try to find a single UTXO that covers the amount
255
- const singleUtxo = eligibleUtxos.find(utxo => BigInt(utxo.value) >= targetAmount);
256
-
257
- if (singleUtxo) {
258
- selectedUtxos.push(singleUtxo);
259
- totalSelectedValue = BigInt(singleUtxo.value);
260
- } else {
261
- // Second pass: accumulate UTXOs until we reach the target amount
262
- for (const utxo of eligibleUtxos) {
263
- selectedUtxos.push(utxo);
264
- totalSelectedValue += BigInt(utxo.value);
265
-
266
- // Recalculate fee as we add more inputs
267
- estimatedVbytes = estimateTransactionSize(selectedUtxos.length, 2);
268
- estimatedFee = calculateFee(estimatedVbytes, feeRate);
269
- targetAmount = requiredAmountBigInt + estimatedFee;
270
-
271
- if (totalSelectedValue >= targetAmount) {
272
- break;
273
- }
274
- }
275
- }
276
-
277
- // Final fee calculation based on actual number of inputs
278
- estimatedVbytes = estimateTransactionSize(selectedUtxos.length, 2);
279
- estimatedFee = calculateFee(estimatedVbytes, feeRate);
280
-
281
- // Check if we have enough funds
282
- if (totalSelectedValue < requiredAmountBigInt + estimatedFee) {
283
- throw new Error(`Insufficient funds. Required: ${requiredAmountBigInt + estimatedFee}, Available: ${totalSelectedValue}`);
284
- }
285
-
286
- // Calculate change
287
- let changeAmount = totalSelectedValue - requiredAmountBigInt - estimatedFee;
288
-
289
- // If change is less than dust limit, add it to the fee
290
- if (changeAmount > 0n && changeAmount < BigInt(MIN_DUST_LIMIT)) {
291
- estimatedFee += changeAmount;
292
- changeAmount = 0n;
293
- }
294
-
295
- return {
296
- selectedUtxos,
297
- totalSelectedValue: Number(totalSelectedValue),
298
- estimatedFee: Number(estimatedFee),
299
- changeAmount: Number(changeAmount)
300
- };
301
- }
302
-
303
- /**
304
- * Convenience function to select UTXOs for a payment, explicitly avoiding resource UTXOs
305
- *
306
- * @param availableUtxos List of available UTXOs
307
- * @param requiredAmount Amount needed for the payment in satoshis
308
- * @param feeRate Fee rate in satoshis per vbyte
309
- * @returns Selection result with UTXOs, fee and change information
310
- */
311
- export function selectUtxosForPayment(
312
- availableUtxos: ResourceUtxo[],
313
- requiredAmount: number,
314
- feeRate: number
315
- ): ResourceUtxoSelectionResult {
316
- return selectResourceUtxos(availableUtxos, {
317
- requiredAmount,
318
- feeRate,
319
- allowResourceUtxos: false // Never use resource UTXOs for payments
320
- });
321
- }
322
-
@@ -1,113 +0,0 @@
1
- import { DUST_LIMIT_SATS, Utxo } from '../types';
2
-
3
- export interface FeeEstimateOptions {
4
- bytesPerInput?: number;
5
- bytesPerOutput?: number;
6
- baseTxBytes?: number;
7
- }
8
-
9
- export interface SelectionOptions {
10
- feeRateSatsPerVb: number; // sats/vbyte
11
- targetAmountSats: number; // includes recipient output value
12
- allowLocked?: boolean;
13
- forbidInscriptionBearingInputs?: boolean;
14
- changeAddress?: string;
15
- feeEstimate?: FeeEstimateOptions;
16
- }
17
-
18
- export interface SelectionResult {
19
- selected: Utxo[];
20
- feeSats: number;
21
- changeSats: number;
22
- }
23
-
24
- export const DEFAULT_FEE_ESTIMATE: Required<FeeEstimateOptions> = {
25
- bytesPerInput: 148,
26
- bytesPerOutput: 34,
27
- baseTxBytes: 10
28
- };
29
-
30
- export function estimateFeeSats(numInputs: number, numOutputs: number, feeRateSatsPerVb: number, feeEstimate: FeeEstimateOptions = {}): number {
31
- const est = { ...DEFAULT_FEE_ESTIMATE, ...feeEstimate };
32
- const bytes = est.baseTxBytes + numInputs * est.bytesPerInput + numOutputs * est.bytesPerOutput;
33
- return Math.ceil(bytes * feeRateSatsPerVb);
34
- }
35
-
36
- export class UtxoSelectionError extends Error {
37
- code: 'INSUFFICIENT_FUNDS' | 'TOO_LOW_FEE' | 'DUST_OUTPUT' | 'CONFLICTING_LOCKS' | 'SAT_SAFETY';
38
- constructor(code: UtxoSelectionError['code'], message?: string) {
39
- super(message || code);
40
- this.code = code;
41
- }
42
- }
43
-
44
- export function selectUtxos(utxos: Utxo[], options: SelectionOptions): SelectionResult {
45
- const { feeRateSatsPerVb, targetAmountSats, allowLocked, forbidInscriptionBearingInputs, feeEstimate } = options;
46
- if (feeRateSatsPerVb <= 0) {
47
- const err = new UtxoSelectionError('TOO_LOW_FEE', 'TOO_LOW_FEE');
48
- throw err;
49
- }
50
- if (targetAmountSats < DUST_LIMIT_SATS) {
51
- const err = new UtxoSelectionError('DUST_OUTPUT', 'DUST_OUTPUT');
52
- throw err;
53
- }
54
-
55
- // Filter UTXOs based on policy
56
- let candidateUtxos = utxos.slice().filter(u => typeof u.value === 'number' && u.value > 0);
57
- const hasLocked = candidateUtxos.some(u => u.locked);
58
- if (hasLocked && !allowLocked) {
59
- // If excluding locked leaves insufficient funds, surface a specific error later; but first mark conflict
60
- // We'll check after filtering
61
- }
62
-
63
- if (!allowLocked) {
64
- candidateUtxos = candidateUtxos.filter(u => !u.locked);
65
- }
66
- if (forbidInscriptionBearingInputs) {
67
- candidateUtxos = candidateUtxos.filter(u => !u.inscriptions || u.inscriptions.length === 0);
68
- }
69
-
70
- // Greedy accumulate until amount + fee is satisfied. Start with 2 outputs (recipient + change), adjust if change is dust.
71
- const selected: Utxo[] = [];
72
- let accumulated = 0;
73
-
74
- // Sort largest first to reduce change outputs and input count
75
- candidateUtxos.sort((a, b) => b.value - a.value);
76
-
77
- // We'll iteratively include inputs and recompute fee until covered
78
- for (const utxo of candidateUtxos) {
79
- selected.push(utxo);
80
- accumulated += utxo.value;
81
-
82
- // Assume two outputs initially
83
- let fee = estimateFeeSats(selected.length, 2, feeRateSatsPerVb, feeEstimate);
84
- let required = targetAmountSats + fee;
85
-
86
- if (accumulated >= required) {
87
- // Compute change and dust policy
88
- let change = accumulated - required;
89
- if (change > 0 && change < DUST_LIMIT_SATS) {
90
- // If change would be dust, try recomputing fee for single output (recipient only)
91
- fee = estimateFeeSats(selected.length, 1, feeRateSatsPerVb, feeEstimate);
92
- required = targetAmountSats + fee;
93
- change = accumulated - required;
94
- if (change > 0 && change < DUST_LIMIT_SATS) {
95
- // Force add to fee (better than creating dust)
96
- change = 0;
97
- }
98
- }
99
- if (accumulated >= targetAmountSats + fee) {
100
- return { selected, feeSats: fee, changeSats: Math.max(0, change) };
101
- }
102
- }
103
- }
104
-
105
- // If we got here, insufficient funds with the given policy
106
- if (hasLocked && !allowLocked) {
107
- const err = new UtxoSelectionError('CONFLICTING_LOCKS', 'CONFLICTING_LOCKS');
108
- throw err;
109
- }
110
- const err = new UtxoSelectionError('INSUFFICIENT_FUNDS', 'INSUFFICIENT_FUNDS');
111
- throw err;
112
- }
113
-
@@ -1,237 +0,0 @@
1
- {
2
- "@context": {
3
- "@version": 1.1,
4
- "@protected": true,
5
-
6
- "id": "@id",
7
- "type": "@type",
8
-
9
- "VerifiableCredential": {
10
- "@id": "https://www.w3.org/2018/credentials#VerifiableCredential",
11
- "@context": {
12
- "@version": 1.1,
13
- "@protected": true,
14
-
15
- "id": "@id",
16
- "type": "@type",
17
-
18
- "cred": "https://www.w3.org/2018/credentials#",
19
- "sec": "https://w3id.org/security#",
20
- "xsd": "http://www.w3.org/2001/XMLSchema#",
21
-
22
- "credentialSchema": {
23
- "@id": "cred:credentialSchema",
24
- "@type": "@id",
25
- "@context": {
26
- "@version": 1.1,
27
- "@protected": true,
28
-
29
- "id": "@id",
30
- "type": "@type",
31
-
32
- "cred": "https://www.w3.org/2018/credentials#",
33
-
34
- "JsonSchemaValidator2018": "cred:JsonSchemaValidator2018"
35
- }
36
- },
37
- "credentialStatus": {"@id": "cred:credentialStatus", "@type": "@id"},
38
- "credentialSubject": {"@id": "cred:credentialSubject", "@type": "@id"},
39
- "evidence": {"@id": "cred:evidence", "@type": "@id"},
40
- "expirationDate": {"@id": "cred:expirationDate", "@type": "xsd:dateTime"},
41
- "holder": {"@id": "cred:holder", "@type": "@id"},
42
- "issued": {"@id": "cred:issued", "@type": "xsd:dateTime"},
43
- "issuer": {"@id": "cred:issuer", "@type": "@id"},
44
- "issuanceDate": {"@id": "cred:issuanceDate", "@type": "xsd:dateTime"},
45
- "proof": {"@id": "sec:proof", "@type": "@id", "@container": "@graph"},
46
- "refreshService": {
47
- "@id": "cred:refreshService",
48
- "@type": "@id",
49
- "@context": {
50
- "@version": 1.1,
51
- "@protected": true,
52
-
53
- "id": "@id",
54
- "type": "@type",
55
-
56
- "cred": "https://www.w3.org/2018/credentials#",
57
-
58
- "ManualRefreshService2018": "cred:ManualRefreshService2018"
59
- }
60
- },
61
- "termsOfUse": {"@id": "cred:termsOfUse", "@type": "@id"},
62
- "validFrom": {"@id": "cred:validFrom", "@type": "xsd:dateTime"},
63
- "validUntil": {"@id": "cred:validUntil", "@type": "xsd:dateTime"}
64
- }
65
- },
66
-
67
- "VerifiablePresentation": {
68
- "@id": "https://www.w3.org/2018/credentials#VerifiablePresentation",
69
- "@context": {
70
- "@version": 1.1,
71
- "@protected": true,
72
-
73
- "id": "@id",
74
- "type": "@type",
75
-
76
- "cred": "https://www.w3.org/2018/credentials#",
77
- "sec": "https://w3id.org/security#",
78
-
79
- "holder": {"@id": "cred:holder", "@type": "@id"},
80
- "proof": {"@id": "sec:proof", "@type": "@id", "@container": "@graph"},
81
- "verifiableCredential": {"@id": "cred:verifiableCredential", "@type": "@id", "@container": "@graph"}
82
- }
83
- },
84
-
85
- "EcdsaSecp256k1Signature2019": {
86
- "@id": "https://w3id.org/security#EcdsaSecp256k1Signature2019",
87
- "@context": {
88
- "@version": 1.1,
89
- "@protected": true,
90
-
91
- "id": "@id",
92
- "type": "@type",
93
-
94
- "sec": "https://w3id.org/security#",
95
- "xsd": "http://www.w3.org/2001/XMLSchema#",
96
-
97
- "challenge": "sec:challenge",
98
- "created": {"@id": "http://purl.org/dc/terms/created", "@type": "xsd:dateTime"},
99
- "domain": "sec:domain",
100
- "expires": {"@id": "sec:expiration", "@type": "xsd:dateTime"},
101
- "jws": "sec:jws",
102
- "nonce": "sec:nonce",
103
- "proofPurpose": {
104
- "@id": "sec:proofPurpose",
105
- "@type": "@vocab",
106
- "@context": {
107
- "@version": 1.1,
108
- "@protected": true,
109
-
110
- "id": "@id",
111
- "type": "@type",
112
-
113
- "sec": "https://w3id.org/security#",
114
-
115
- "assertionMethod": {"@id": "sec:assertionMethod", "@type": "@id", "@container": "@set"},
116
- "authentication": {"@id": "sec:authenticationMethod", "@type": "@id", "@container": "@set"}
117
- }
118
- },
119
- "proofValue": "sec:proofValue",
120
- "verificationMethod": {"@id": "sec:verificationMethod", "@type": "@id"}
121
- }
122
- },
123
-
124
- "EcdsaSecp256r1Signature2019": {
125
- "@id": "https://w3id.org/security#EcdsaSecp256r1Signature2019",
126
- "@context": {
127
- "@version": 1.1,
128
- "@protected": true,
129
-
130
- "id": "@id",
131
- "type": "@type",
132
-
133
- "sec": "https://w3id.org/security#",
134
- "xsd": "http://www.w3.org/2001/XMLSchema#",
135
-
136
- "challenge": "sec:challenge",
137
- "created": {"@id": "http://purl.org/dc/terms/created", "@type": "xsd:dateTime"},
138
- "domain": "sec:domain",
139
- "expires": {"@id": "sec:expiration", "@type": "xsd:dateTime"},
140
- "jws": "sec:jws",
141
- "nonce": "sec:nonce",
142
- "proofPurpose": {
143
- "@id": "sec:proofPurpose",
144
- "@type": "@vocab",
145
- "@context": {
146
- "@version": 1.1,
147
- "@protected": true,
148
-
149
- "id": "@id",
150
- "type": "@type",
151
-
152
- "sec": "https://w3id.org/security#",
153
-
154
- "assertionMethod": {"@id": "sec:assertionMethod", "@type": "@id", "@container": "@set"},
155
- "authentication": {"@id": "sec:authenticationMethod", "@type": "@id", "@container": "@set"}
156
- }
157
- },
158
- "proofValue": "sec:proofValue",
159
- "verificationMethod": {"@id": "sec:verificationMethod", "@type": "@id"}
160
- }
161
- },
162
-
163
- "Ed25519Signature2018": {
164
- "@id": "https://w3id.org/security#Ed25519Signature2018",
165
- "@context": {
166
- "@version": 1.1,
167
- "@protected": true,
168
-
169
- "id": "@id",
170
- "type": "@type",
171
-
172
- "sec": "https://w3id.org/security#",
173
- "xsd": "http://www.w3.org/2001/XMLSchema#",
174
-
175
- "challenge": "sec:challenge",
176
- "created": {"@id": "http://purl.org/dc/terms/created", "@type": "xsd:dateTime"},
177
- "domain": "sec:domain",
178
- "expires": {"@id": "sec:expiration", "@type": "xsd:dateTime"},
179
- "jws": "sec:jws",
180
- "nonce": "sec:nonce",
181
- "proofPurpose": {
182
- "@id": "sec:proofPurpose",
183
- "@type": "@vocab",
184
- "@context": {
185
- "@version": 1.1,
186
- "@protected": true,
187
-
188
- "id": "@id",
189
- "type": "@type",
190
-
191
- "sec": "https://w3id.org/security#",
192
-
193
- "assertionMethod": {"@id": "sec:assertionMethod", "@type": "@id", "@container": "@set"},
194
- "authentication": {"@id": "sec:authenticationMethod", "@type": "@id", "@container": "@set"}
195
- }
196
- },
197
- "proofValue": "sec:proofValue",
198
- "verificationMethod": {"@id": "sec:verificationMethod", "@type": "@id"}
199
- }
200
- },
201
-
202
- "RsaSignature2018": {
203
- "@id": "https://w3id.org/security#RsaSignature2018",
204
- "@context": {
205
- "@version": 1.1,
206
- "@protected": true,
207
-
208
- "challenge": "sec:challenge",
209
- "created": {"@id": "http://purl.org/dc/terms/created", "@type": "xsd:dateTime"},
210
- "domain": "sec:domain",
211
- "expires": {"@id": "sec:expiration", "@type": "xsd:dateTime"},
212
- "jws": "sec:jws",
213
- "nonce": "sec:nonce",
214
- "proofPurpose": {
215
- "@id": "sec:proofPurpose",
216
- "@type": "@vocab",
217
- "@context": {
218
- "@version": 1.1,
219
- "@protected": true,
220
-
221
- "id": "@id",
222
- "type": "@type",
223
-
224
- "sec": "https://w3id.org/security#",
225
-
226
- "assertionMethod": {"@id": "sec:assertionMethod", "@type": "@id", "@container": "@set"},
227
- "authentication": {"@id": "sec:authenticationMethod", "@type": "@id", "@container": "@set"}
228
- }
229
- },
230
- "proofValue": "sec:proofValue",
231
- "verificationMethod": {"@id": "sec:verificationMethod", "@type": "@id"}
232
- }
233
- },
234
-
235
- "proof": {"@id": "https://w3id.org/security#proof", "@type": "@id", "@container": "@graph"}
236
- }
237
- }
@@ -1,5 +0,0 @@
1
- {
2
- "@context": {
3
- "@vocab": "https://www.w3.org/ns/credentials/examples#"
4
- }
5
- }