@originals/sdk 1.2.0 → 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 (401) hide show
  1. package/package.json +4 -1
  2. package/.eslintrc.json +0 -33
  3. package/.turbo/turbo-build.log +0 -1
  4. package/dist/adapters/FeeOracleMock.d.ts +0 -6
  5. package/dist/adapters/FeeOracleMock.js +0 -8
  6. package/dist/adapters/index.d.ts +0 -4
  7. package/dist/adapters/index.js +0 -4
  8. package/dist/adapters/providers/OrdHttpProvider.d.ts +0 -56
  9. package/dist/adapters/providers/OrdHttpProvider.js +0 -110
  10. package/dist/adapters/providers/OrdMockProvider.d.ts +0 -70
  11. package/dist/adapters/providers/OrdMockProvider.js +0 -75
  12. package/dist/adapters/types.d.ts +0 -71
  13. package/dist/adapters/types.js +0 -1
  14. package/dist/bitcoin/BitcoinManager.d.ts +0 -15
  15. package/dist/bitcoin/BitcoinManager.js +0 -262
  16. package/dist/bitcoin/BroadcastClient.d.ts +0 -30
  17. package/dist/bitcoin/BroadcastClient.js +0 -35
  18. package/dist/bitcoin/OrdinalsClient.d.ts +0 -21
  19. package/dist/bitcoin/OrdinalsClient.js +0 -105
  20. package/dist/bitcoin/PSBTBuilder.d.ts +0 -24
  21. package/dist/bitcoin/PSBTBuilder.js +0 -80
  22. package/dist/bitcoin/fee-calculation.d.ts +0 -14
  23. package/dist/bitcoin/fee-calculation.js +0 -31
  24. package/dist/bitcoin/providers/OrdNodeProvider.d.ts +0 -38
  25. package/dist/bitcoin/providers/OrdNodeProvider.js +0 -67
  26. package/dist/bitcoin/providers/OrdinalsProvider.d.ts +0 -33
  27. package/dist/bitcoin/providers/OrdinalsProvider.js +0 -50
  28. package/dist/bitcoin/providers/types.d.ts +0 -63
  29. package/dist/bitcoin/providers/types.js +0 -1
  30. package/dist/bitcoin/transactions/commit.d.ts +0 -89
  31. package/dist/bitcoin/transactions/commit.js +0 -311
  32. package/dist/bitcoin/transactions/index.d.ts +0 -7
  33. package/dist/bitcoin/transactions/index.js +0 -8
  34. package/dist/bitcoin/transfer.d.ts +0 -9
  35. package/dist/bitcoin/transfer.js +0 -26
  36. package/dist/bitcoin/utxo-selection.d.ts +0 -78
  37. package/dist/bitcoin/utxo-selection.js +0 -237
  38. package/dist/bitcoin/utxo.d.ts +0 -26
  39. package/dist/bitcoin/utxo.js +0 -78
  40. package/dist/contexts/credentials-v1.json +0 -195
  41. package/dist/contexts/credentials-v2-examples.json +0 -5
  42. package/dist/contexts/credentials-v2.json +0 -301
  43. package/dist/contexts/credentials.json +0 -195
  44. package/dist/contexts/data-integrity-v2.json +0 -81
  45. package/dist/contexts/dids.json +0 -57
  46. package/dist/contexts/ed255192020.json +0 -93
  47. package/dist/contexts/ordinals-plus.json +0 -23
  48. package/dist/contexts/originals.json +0 -22
  49. package/dist/core/OriginalsSDK.d.ts +0 -158
  50. package/dist/core/OriginalsSDK.js +0 -274
  51. package/dist/crypto/Multikey.d.ts +0 -30
  52. package/dist/crypto/Multikey.js +0 -149
  53. package/dist/crypto/Signer.d.ts +0 -21
  54. package/dist/crypto/Signer.js +0 -196
  55. package/dist/crypto/noble-init.d.ts +0 -18
  56. package/dist/crypto/noble-init.js +0 -106
  57. package/dist/did/BtcoDidResolver.d.ts +0 -57
  58. package/dist/did/BtcoDidResolver.js +0 -166
  59. package/dist/did/DIDManager.d.ts +0 -101
  60. package/dist/did/DIDManager.js +0 -493
  61. package/dist/did/Ed25519Verifier.d.ts +0 -30
  62. package/dist/did/Ed25519Verifier.js +0 -59
  63. package/dist/did/KeyManager.d.ts +0 -17
  64. package/dist/did/KeyManager.js +0 -207
  65. package/dist/did/WebVHManager.d.ts +0 -100
  66. package/dist/did/WebVHManager.js +0 -304
  67. package/dist/did/createBtcoDidDocument.d.ts +0 -10
  68. package/dist/did/createBtcoDidDocument.js +0 -42
  69. package/dist/did/providers/OrdinalsClientProviderAdapter.d.ts +0 -23
  70. package/dist/did/providers/OrdinalsClientProviderAdapter.js +0 -51
  71. package/dist/events/EventEmitter.d.ts +0 -115
  72. package/dist/events/EventEmitter.js +0 -198
  73. package/dist/events/index.d.ts +0 -7
  74. package/dist/events/index.js +0 -6
  75. package/dist/events/types.d.ts +0 -286
  76. package/dist/events/types.js +0 -9
  77. package/dist/examples/basic-usage.d.ts +0 -3
  78. package/dist/examples/basic-usage.js +0 -62
  79. package/dist/examples/run.d.ts +0 -1
  80. package/dist/examples/run.js +0 -4
  81. package/dist/index.d.ts +0 -39
  82. package/dist/index.js +0 -47
  83. package/dist/lifecycle/BatchOperations.d.ts +0 -147
  84. package/dist/lifecycle/BatchOperations.js +0 -251
  85. package/dist/lifecycle/LifecycleManager.d.ts +0 -116
  86. package/dist/lifecycle/LifecycleManager.js +0 -971
  87. package/dist/lifecycle/OriginalsAsset.d.ts +0 -164
  88. package/dist/lifecycle/OriginalsAsset.js +0 -380
  89. package/dist/lifecycle/ProvenanceQuery.d.ts +0 -126
  90. package/dist/lifecycle/ProvenanceQuery.js +0 -220
  91. package/dist/lifecycle/ResourceVersioning.d.ts +0 -73
  92. package/dist/lifecycle/ResourceVersioning.js +0 -127
  93. package/dist/migration/MigrationManager.d.ts +0 -86
  94. package/dist/migration/MigrationManager.js +0 -412
  95. package/dist/migration/audit/AuditLogger.d.ts +0 -51
  96. package/dist/migration/audit/AuditLogger.js +0 -156
  97. package/dist/migration/checkpoint/CheckpointManager.d.ts +0 -31
  98. package/dist/migration/checkpoint/CheckpointManager.js +0 -96
  99. package/dist/migration/checkpoint/CheckpointStorage.d.ts +0 -26
  100. package/dist/migration/checkpoint/CheckpointStorage.js +0 -89
  101. package/dist/migration/index.d.ts +0 -22
  102. package/dist/migration/index.js +0 -27
  103. package/dist/migration/operations/BaseMigration.d.ts +0 -48
  104. package/dist/migration/operations/BaseMigration.js +0 -83
  105. package/dist/migration/operations/PeerToBtcoMigration.d.ts +0 -25
  106. package/dist/migration/operations/PeerToBtcoMigration.js +0 -67
  107. package/dist/migration/operations/PeerToWebvhMigration.d.ts +0 -19
  108. package/dist/migration/operations/PeerToWebvhMigration.js +0 -46
  109. package/dist/migration/operations/WebvhToBtcoMigration.d.ts +0 -25
  110. package/dist/migration/operations/WebvhToBtcoMigration.js +0 -67
  111. package/dist/migration/rollback/RollbackManager.d.ts +0 -29
  112. package/dist/migration/rollback/RollbackManager.js +0 -146
  113. package/dist/migration/state/StateMachine.d.ts +0 -25
  114. package/dist/migration/state/StateMachine.js +0 -76
  115. package/dist/migration/state/StateTracker.d.ts +0 -36
  116. package/dist/migration/state/StateTracker.js +0 -123
  117. package/dist/migration/types.d.ts +0 -306
  118. package/dist/migration/types.js +0 -33
  119. package/dist/migration/validation/BitcoinValidator.d.ts +0 -13
  120. package/dist/migration/validation/BitcoinValidator.js +0 -83
  121. package/dist/migration/validation/CredentialValidator.d.ts +0 -13
  122. package/dist/migration/validation/CredentialValidator.js +0 -46
  123. package/dist/migration/validation/DIDCompatibilityValidator.d.ts +0 -16
  124. package/dist/migration/validation/DIDCompatibilityValidator.js +0 -127
  125. package/dist/migration/validation/LifecycleValidator.d.ts +0 -10
  126. package/dist/migration/validation/LifecycleValidator.js +0 -52
  127. package/dist/migration/validation/StorageValidator.d.ts +0 -10
  128. package/dist/migration/validation/StorageValidator.js +0 -65
  129. package/dist/migration/validation/ValidationPipeline.d.ts +0 -29
  130. package/dist/migration/validation/ValidationPipeline.js +0 -180
  131. package/dist/storage/LocalStorageAdapter.d.ts +0 -11
  132. package/dist/storage/LocalStorageAdapter.js +0 -53
  133. package/dist/storage/MemoryStorageAdapter.d.ts +0 -6
  134. package/dist/storage/MemoryStorageAdapter.js +0 -21
  135. package/dist/storage/StorageAdapter.d.ts +0 -16
  136. package/dist/storage/StorageAdapter.js +0 -1
  137. package/dist/storage/index.d.ts +0 -2
  138. package/dist/storage/index.js +0 -2
  139. package/dist/types/bitcoin.d.ts +0 -84
  140. package/dist/types/bitcoin.js +0 -1
  141. package/dist/types/common.d.ts +0 -82
  142. package/dist/types/common.js +0 -1
  143. package/dist/types/credentials.d.ts +0 -75
  144. package/dist/types/credentials.js +0 -1
  145. package/dist/types/did.d.ts +0 -26
  146. package/dist/types/did.js +0 -1
  147. package/dist/types/index.d.ts +0 -5
  148. package/dist/types/index.js +0 -5
  149. package/dist/types/network.d.ts +0 -78
  150. package/dist/types/network.js +0 -145
  151. package/dist/utils/EventLogger.d.ts +0 -71
  152. package/dist/utils/EventLogger.js +0 -232
  153. package/dist/utils/Logger.d.ts +0 -106
  154. package/dist/utils/Logger.js +0 -257
  155. package/dist/utils/MetricsCollector.d.ts +0 -110
  156. package/dist/utils/MetricsCollector.js +0 -264
  157. package/dist/utils/bitcoin-address.d.ts +0 -38
  158. package/dist/utils/bitcoin-address.js +0 -113
  159. package/dist/utils/cbor.d.ts +0 -2
  160. package/dist/utils/cbor.js +0 -9
  161. package/dist/utils/encoding.d.ts +0 -37
  162. package/dist/utils/encoding.js +0 -120
  163. package/dist/utils/hash.d.ts +0 -1
  164. package/dist/utils/hash.js +0 -5
  165. package/dist/utils/retry.d.ts +0 -10
  166. package/dist/utils/retry.js +0 -35
  167. package/dist/utils/satoshi-validation.d.ts +0 -60
  168. package/dist/utils/satoshi-validation.js +0 -156
  169. package/dist/utils/serialization.d.ts +0 -14
  170. package/dist/utils/serialization.js +0 -76
  171. package/dist/utils/telemetry.d.ts +0 -17
  172. package/dist/utils/telemetry.js +0 -24
  173. package/dist/utils/validation.d.ts +0 -5
  174. package/dist/utils/validation.js +0 -98
  175. package/dist/vc/CredentialManager.d.ts +0 -22
  176. package/dist/vc/CredentialManager.js +0 -227
  177. package/dist/vc/Issuer.d.ts +0 -27
  178. package/dist/vc/Issuer.js +0 -70
  179. package/dist/vc/Verifier.d.ts +0 -16
  180. package/dist/vc/Verifier.js +0 -50
  181. package/dist/vc/cryptosuites/bbs.d.ts +0 -44
  182. package/dist/vc/cryptosuites/bbs.js +0 -213
  183. package/dist/vc/cryptosuites/bbsSimple.d.ts +0 -9
  184. package/dist/vc/cryptosuites/bbsSimple.js +0 -12
  185. package/dist/vc/cryptosuites/eddsa.d.ts +0 -30
  186. package/dist/vc/cryptosuites/eddsa.js +0 -81
  187. package/dist/vc/documentLoader.d.ts +0 -16
  188. package/dist/vc/documentLoader.js +0 -59
  189. package/dist/vc/proofs/data-integrity.d.ts +0 -21
  190. package/dist/vc/proofs/data-integrity.js +0 -15
  191. package/dist/vc/utils/jsonld.d.ts +0 -2
  192. package/dist/vc/utils/jsonld.js +0 -15
  193. package/src/adapters/FeeOracleMock.ts +0 -9
  194. package/src/adapters/index.ts +0 -5
  195. package/src/adapters/providers/OrdHttpProvider.ts +0 -126
  196. package/src/adapters/providers/OrdMockProvider.ts +0 -101
  197. package/src/adapters/types.ts +0 -66
  198. package/src/bitcoin/BitcoinManager.ts +0 -330
  199. package/src/bitcoin/BroadcastClient.ts +0 -54
  200. package/src/bitcoin/OrdinalsClient.ts +0 -119
  201. package/src/bitcoin/PSBTBuilder.ts +0 -106
  202. package/src/bitcoin/fee-calculation.ts +0 -38
  203. package/src/bitcoin/providers/OrdNodeProvider.ts +0 -92
  204. package/src/bitcoin/providers/OrdinalsProvider.ts +0 -56
  205. package/src/bitcoin/providers/types.ts +0 -59
  206. package/src/bitcoin/transactions/commit.ts +0 -465
  207. package/src/bitcoin/transactions/index.ts +0 -13
  208. package/src/bitcoin/transfer.ts +0 -43
  209. package/src/bitcoin/utxo-selection.ts +0 -322
  210. package/src/bitcoin/utxo.ts +0 -113
  211. package/src/contexts/credentials-v1.json +0 -237
  212. package/src/contexts/credentials-v2-examples.json +0 -5
  213. package/src/contexts/credentials-v2.json +0 -340
  214. package/src/contexts/credentials.json +0 -237
  215. package/src/contexts/data-integrity-v2.json +0 -81
  216. package/src/contexts/dids.json +0 -58
  217. package/src/contexts/ed255192020.json +0 -93
  218. package/src/contexts/ordinals-plus.json +0 -23
  219. package/src/contexts/originals.json +0 -22
  220. package/src/core/OriginalsSDK.ts +0 -416
  221. package/src/crypto/Multikey.ts +0 -194
  222. package/src/crypto/Signer.ts +0 -254
  223. package/src/crypto/noble-init.ts +0 -121
  224. package/src/did/BtcoDidResolver.ts +0 -227
  225. package/src/did/DIDManager.ts +0 -694
  226. package/src/did/Ed25519Verifier.ts +0 -68
  227. package/src/did/KeyManager.ts +0 -236
  228. package/src/did/WebVHManager.ts +0 -489
  229. package/src/did/createBtcoDidDocument.ts +0 -59
  230. package/src/did/providers/OrdinalsClientProviderAdapter.ts +0 -68
  231. package/src/events/EventEmitter.ts +0 -222
  232. package/src/events/index.ts +0 -19
  233. package/src/events/types.ts +0 -331
  234. package/src/examples/basic-usage.ts +0 -78
  235. package/src/examples/run.ts +0 -5
  236. package/src/index.ts +0 -84
  237. package/src/lifecycle/BatchOperations.ts +0 -373
  238. package/src/lifecycle/LifecycleManager.ts +0 -1218
  239. package/src/lifecycle/OriginalsAsset.ts +0 -524
  240. package/src/lifecycle/ProvenanceQuery.ts +0 -280
  241. package/src/lifecycle/ResourceVersioning.ts +0 -163
  242. package/src/migration/MigrationManager.ts +0 -527
  243. package/src/migration/audit/AuditLogger.ts +0 -176
  244. package/src/migration/checkpoint/CheckpointManager.ts +0 -112
  245. package/src/migration/checkpoint/CheckpointStorage.ts +0 -101
  246. package/src/migration/index.ts +0 -33
  247. package/src/migration/operations/BaseMigration.ts +0 -126
  248. package/src/migration/operations/PeerToBtcoMigration.ts +0 -105
  249. package/src/migration/operations/PeerToWebvhMigration.ts +0 -62
  250. package/src/migration/operations/WebvhToBtcoMigration.ts +0 -105
  251. package/src/migration/rollback/RollbackManager.ts +0 -170
  252. package/src/migration/state/StateMachine.ts +0 -92
  253. package/src/migration/state/StateTracker.ts +0 -156
  254. package/src/migration/types.ts +0 -344
  255. package/src/migration/validation/BitcoinValidator.ts +0 -107
  256. package/src/migration/validation/CredentialValidator.ts +0 -62
  257. package/src/migration/validation/DIDCompatibilityValidator.ts +0 -151
  258. package/src/migration/validation/LifecycleValidator.ts +0 -64
  259. package/src/migration/validation/StorageValidator.ts +0 -79
  260. package/src/migration/validation/ValidationPipeline.ts +0 -213
  261. package/src/storage/LocalStorageAdapter.ts +0 -61
  262. package/src/storage/MemoryStorageAdapter.ts +0 -29
  263. package/src/storage/StorageAdapter.ts +0 -25
  264. package/src/storage/index.ts +0 -3
  265. package/src/types/bitcoin.ts +0 -98
  266. package/src/types/common.ts +0 -92
  267. package/src/types/credentials.ts +0 -88
  268. package/src/types/did.ts +0 -31
  269. package/src/types/external-shims.d.ts +0 -53
  270. package/src/types/index.ts +0 -7
  271. package/src/types/network.ts +0 -175
  272. package/src/utils/EventLogger.ts +0 -298
  273. package/src/utils/Logger.ts +0 -322
  274. package/src/utils/MetricsCollector.ts +0 -358
  275. package/src/utils/bitcoin-address.ts +0 -130
  276. package/src/utils/cbor.ts +0 -12
  277. package/src/utils/encoding.ts +0 -127
  278. package/src/utils/hash.ts +0 -6
  279. package/src/utils/retry.ts +0 -46
  280. package/src/utils/satoshi-validation.ts +0 -196
  281. package/src/utils/serialization.ts +0 -96
  282. package/src/utils/telemetry.ts +0 -40
  283. package/src/utils/validation.ts +0 -119
  284. package/src/vc/CredentialManager.ts +0 -273
  285. package/src/vc/Issuer.ts +0 -100
  286. package/src/vc/Verifier.ts +0 -47
  287. package/src/vc/cryptosuites/bbs.ts +0 -253
  288. package/src/vc/cryptosuites/bbsSimple.ts +0 -21
  289. package/src/vc/cryptosuites/eddsa.ts +0 -99
  290. package/src/vc/documentLoader.ts +0 -67
  291. package/src/vc/proofs/data-integrity.ts +0 -33
  292. package/src/vc/utils/jsonld.ts +0 -18
  293. package/test/logs/did_webvh_QmNTn9Kkp8dQ75WrF9xqJ2kuDp9QhKc3aPiERRMj8XoTBN_example_com.jsonl +0 -1
  294. package/test/logs/did_webvh_QmNu4MNr8Lr5txx5gYNhuhZDchXsZEu3hJXKYuphpWTPDp_example_com_users_etc_passwd.jsonl +0 -1
  295. package/test/logs/did_webvh_QmR9MrGZACzjKETA8SBRNCKG11HxU85c4bVR2qN5eDCfsD_example_com.jsonl +0 -1
  296. package/test/logs/did_webvh_QmUc5suaqRM2P4nrXxZwqYMfqzhdMqjuL7oJaJbEpCQVCd_example_com_users_etc_passwd.jsonl +0 -1
  297. package/test/logs/did_webvh_QmUkiB2RCV2VZ1RTXsCebWN25Eiy9TLvpzDWAJNjhgvB4X_example_com_etc_passwd.jsonl +0 -1
  298. package/test/logs/did_webvh_QmUoRTe8UMwpAQXZSAW7pjAgZK1tq2X3C6Kfxq3UXGcaGy_example_com_secret.jsonl +0 -1
  299. package/test/logs/did_webvh_QmWWot3chx1t6KwTmcE5i2FeDZ5JMkQw3qXycsKDVmJ9Be_example_com_users_alice.jsonl +0 -1
  300. package/test/logs/did_webvh_QmWvVgALL5kjZdpgR7KZay7J8UiiUr834kkRmWeFAxjAuC_example_com_users_etc_passwd.jsonl +0 -1
  301. package/test/logs/did_webvh_QmWwaRQHUZAFcKihFC6xR6tRTTrQhHPTku6azf1egWbpy1_example_com_users_alice.jsonl +0 -1
  302. package/test/logs/did_webvh_QmXJLtkz23r7AozbtXsZMKWnVU6rd38CkVtjdWuATU3Yp6_example_com_users_alice123_profile.jsonl +0 -1
  303. package/test/logs/did_webvh_QmYsce448po14oDE1wXbyaP6wY9HQgHSKLwdezn1k577SF_example_com_my_org_user_name_test_123.jsonl +0 -1
  304. package/test/logs/did_webvh_QmZBeNzzqajxdfwcDUPZ4P8C5YSXyRztrAwmPiKuKUxmAK_example_com.jsonl +0 -1
  305. package/test/logs/did_webvh_QmZhJsqxizwVbRtqCUkmE6XQunSxtxMt3gbTYadVBNAaEq_example_com.jsonl +0 -1
  306. package/test/logs/did_webvh_QmZk7NHU2D57RzzbMq4tWW9gBa9AqtVTWfiRM6RFdwGVj2_example_com.jsonl +0 -1
  307. package/test/logs/did_webvh_QmZshSXp9w8ovH62zGGBS1b5pGGPsuYiu1VQ935sga2hWF_example_com_level1_level2.jsonl +0 -1
  308. package/test/logs/did_webvh_QmbWAmw7HQL7vKJyCsctZihXf1rmT4sGvggKCPKWcUWjw1_example_com.jsonl +0 -1
  309. package/test/logs/did_webvh_QmbdLUMbYs3juR39TLB6hhrFWLcNg45ybUzeBJCS1MhCh1_example_com_C_Windows_System32.jsonl +0 -1
  310. package/test/logs/did_webvh_QmcaQ1Ma4gkSbae85aCm8Mv4rvdT2Sb2RR3JzYwrm5XBq8_example_com_etc_passwd.jsonl +0 -1
  311. package/test/logs/did_webvh_QmcbA7WQhsBqZSoDpKJHjV8Q5o53h8vmgJhQfo6rqTY5ho_example_com.jsonl +0 -1
  312. package/test/logs/did_webvh_Qmdy8uWr2gkUJrXsThynAug3DASTWwb3onEj89LKmMGZYB_example_com.jsonl +0 -1
  313. package/tests/__mocks__/bbs-signatures.js +0 -17
  314. package/tests/__mocks__/mf-base58.js +0 -24
  315. package/tests/e2e/README.md +0 -97
  316. package/tests/e2e/example.spec.ts +0 -78
  317. package/tests/fixtures/did-documents.ts +0 -247
  318. package/tests/index.test.ts +0 -21
  319. package/tests/integration/BatchOperations.test.ts +0 -531
  320. package/tests/integration/CompleteLifecycle.e2e.test.ts +0 -735
  321. package/tests/integration/CredentialManager.test.ts +0 -42
  322. package/tests/integration/DIDManager.test.ts +0 -41
  323. package/tests/integration/DidPeerToWebVhFlow.test.ts +0 -351
  324. package/tests/integration/Events.test.ts +0 -435
  325. package/tests/integration/Lifecycle.transfer.btco.integration.test.ts +0 -25
  326. package/tests/integration/LifecycleManager.test.ts +0 -21
  327. package/tests/integration/MultikeyFlow.test.ts +0 -52
  328. package/tests/integration/TelemetryIntegration.test.ts +0 -395
  329. package/tests/integration/WebVhPublish.test.ts +0 -48
  330. package/tests/integration/migration/peer-to-webvh.test.ts +0 -172
  331. package/tests/manual/test-commit-creation.ts +0 -323
  332. package/tests/mocks/MockKeyStore.ts +0 -38
  333. package/tests/mocks/adapters/MemoryStorageAdapter.ts +0 -24
  334. package/tests/mocks/adapters/MockFeeOracle.ts +0 -11
  335. package/tests/mocks/adapters/MockOrdinalsProvider.ts +0 -76
  336. package/tests/mocks/adapters/OrdMockProvider.test.ts +0 -176
  337. package/tests/mocks/adapters/index.ts +0 -6
  338. package/tests/performance/BatchOperations.perf.test.ts +0 -403
  339. package/tests/performance/logging.perf.test.ts +0 -336
  340. package/tests/sdk.test.ts +0 -43
  341. package/tests/security/bitcoin-penetration-tests.test.ts +0 -622
  342. package/tests/setup.bun.ts +0 -69
  343. package/tests/setup.jest.ts +0 -23
  344. package/tests/stress/batch-operations-stress.test.ts +0 -571
  345. package/tests/unit/adapters/FeeOracleMock.test.ts +0 -40
  346. package/tests/unit/bitcoin/BitcoinManager.test.ts +0 -293
  347. package/tests/unit/bitcoin/BroadcastClient.test.ts +0 -52
  348. package/tests/unit/bitcoin/OrdNodeProvider.test.ts +0 -53
  349. package/tests/unit/bitcoin/OrdinalsClient.test.ts +0 -381
  350. package/tests/unit/bitcoin/OrdinalsClientProvider.test.ts +0 -102
  351. package/tests/unit/bitcoin/PSBTBuilder.test.ts +0 -84
  352. package/tests/unit/bitcoin/fee-calculation.test.ts +0 -261
  353. package/tests/unit/bitcoin/transactions/commit.test.ts +0 -649
  354. package/tests/unit/bitcoin/transfer.test.ts +0 -31
  355. package/tests/unit/bitcoin/utxo-selection-new.test.ts +0 -502
  356. package/tests/unit/bitcoin/utxo.more.test.ts +0 -39
  357. package/tests/unit/bitcoin/utxo.selection.test.ts +0 -38
  358. package/tests/unit/core/OriginalsSDK.test.ts +0 -152
  359. package/tests/unit/crypto/Multikey.test.ts +0 -206
  360. package/tests/unit/crypto/Signer.test.ts +0 -408
  361. package/tests/unit/did/BtcoDidResolver.test.ts +0 -611
  362. package/tests/unit/did/DIDManager.more.test.ts +0 -43
  363. package/tests/unit/did/DIDManager.test.ts +0 -185
  364. package/tests/unit/did/Ed25519Verifier.test.ts +0 -160
  365. package/tests/unit/did/KeyManager.test.ts +0 -452
  366. package/tests/unit/did/OrdinalsClientProviderAdapter.test.ts +0 -45
  367. package/tests/unit/did/WebVHManager.test.ts +0 -435
  368. package/tests/unit/did/createBtcoDidDocument.test.ts +0 -67
  369. package/tests/unit/did/providers/OrdinalsClientProviderAdapter.test.ts +0 -159
  370. package/tests/unit/events/EventEmitter.test.ts +0 -407
  371. package/tests/unit/lifecycle/BatchOperations.test.ts +0 -527
  372. package/tests/unit/lifecycle/LifecycleManager.keymanagement.test.ts +0 -312
  373. package/tests/unit/lifecycle/LifecycleManager.prov.test.ts +0 -18
  374. package/tests/unit/lifecycle/LifecycleManager.test.ts +0 -213
  375. package/tests/unit/lifecycle/LifecycleManager.transfer.unit.test.ts +0 -30
  376. package/tests/unit/lifecycle/OriginalsAsset.test.ts +0 -176
  377. package/tests/unit/lifecycle/ProvenanceQuery.test.ts +0 -577
  378. package/tests/unit/lifecycle/ResourceVersioning.test.ts +0 -651
  379. package/tests/unit/storage/MemoryStorageAdapter.test.ts +0 -93
  380. package/tests/unit/types/network.test.ts +0 -255
  381. package/tests/unit/utils/EventIntegration.test.ts +0 -384
  382. package/tests/unit/utils/Logger.test.ts +0 -473
  383. package/tests/unit/utils/MetricsCollector.test.ts +0 -358
  384. package/tests/unit/utils/bitcoin-address.test.ts +0 -250
  385. package/tests/unit/utils/cbor.test.ts +0 -35
  386. package/tests/unit/utils/encoding.test.ts +0 -318
  387. package/tests/unit/utils/hash.test.ts +0 -12
  388. package/tests/unit/utils/retry.test.ts +0 -100
  389. package/tests/unit/utils/satoshi-validation.test.ts +0 -354
  390. package/tests/unit/utils/serialization.test.ts +0 -124
  391. package/tests/unit/utils/telemetry.test.ts +0 -52
  392. package/tests/unit/utils/validation.test.ts +0 -141
  393. package/tests/unit/vc/CredentialManager.test.ts +0 -487
  394. package/tests/unit/vc/Issuer.test.ts +0 -107
  395. package/tests/unit/vc/Verifier.test.ts +0 -525
  396. package/tests/unit/vc/bbs.test.ts +0 -282
  397. package/tests/unit/vc/cryptosuites/eddsa.test.ts +0 -398
  398. package/tests/unit/vc/documentLoader.test.ts +0 -121
  399. package/tests/unit/vc/proofs/data-integrity.test.ts +0 -24
  400. package/tsconfig.json +0 -31
  401. package/tsconfig.test.json +0 -15
@@ -1,262 +0,0 @@
1
- import { DUST_LIMIT_SATS } from '../types';
2
- import { emitTelemetry, StructuredError } from '../utils/telemetry';
3
- import { validateBitcoinAddress } from '../utils/bitcoin-address';
4
- import { validateSatoshiNumber } from '../utils/satoshi-validation';
5
- export class BitcoinManager {
6
- constructor(config) {
7
- this.config = config;
8
- this.feeOracle = config.feeOracle;
9
- this.ord = config.ordinalsProvider;
10
- }
11
- async resolveFeeRate(targetBlocks = 1, provided) {
12
- // 1) Prefer external fee oracle
13
- if (this.feeOracle) {
14
- try {
15
- const estimated = await this.feeOracle.estimateFeeRate(targetBlocks);
16
- if (typeof estimated === 'number' && Number.isFinite(estimated) && estimated > 0) {
17
- emitTelemetry(this.config.telemetry, {
18
- name: 'bitcoin.fee.estimated',
19
- attributes: { feeRate: estimated, source: 'feeOracle' }
20
- });
21
- return estimated;
22
- }
23
- }
24
- catch (error) {
25
- emitTelemetry(this.config.telemetry, {
26
- name: 'bitcoin.fee.error',
27
- level: 'warn',
28
- attributes: { error: String(error), source: 'feeOracle' }
29
- });
30
- }
31
- }
32
- // 2) Fallback to ordinals provider if present
33
- if (this.ord) {
34
- try {
35
- const estimated = await this.ord.estimateFee(targetBlocks);
36
- if (typeof estimated === 'number' && Number.isFinite(estimated) && estimated > 0) {
37
- emitTelemetry(this.config.telemetry, {
38
- name: 'bitcoin.fee.estimated',
39
- attributes: { feeRate: estimated, source: 'ordinalsProvider' }
40
- });
41
- return estimated;
42
- }
43
- }
44
- catch (error) {
45
- emitTelemetry(this.config.telemetry, {
46
- name: 'bitcoin.fee.error',
47
- level: 'warn',
48
- attributes: { error: String(error), source: 'ordinalsProvider' }
49
- });
50
- }
51
- }
52
- // 3) If caller provided a valid non-zero fee rate, use it as last resort
53
- if (typeof provided === 'number' && Number.isFinite(provided) && provided > 0) {
54
- return provided;
55
- }
56
- return undefined;
57
- }
58
- async inscribeData(data, contentType, feeRate) {
59
- // Input validation
60
- if (!data) {
61
- throw new StructuredError('INVALID_INPUT', 'Data to inscribe cannot be null or undefined');
62
- }
63
- if (!contentType || typeof contentType !== 'string') {
64
- throw new StructuredError('INVALID_INPUT', 'Content type must be a non-empty string');
65
- }
66
- // Validate contentType is a valid MIME type
67
- if (!/^[a-zA-Z0-9][a-zA-Z0-9!#$&^_.+-]{0,126}\/[a-zA-Z0-9][a-zA-Z0-9!#$&^_.+-]{0,126}$/.test(contentType)) {
68
- throw new StructuredError('INVALID_INPUT', `Invalid MIME type format: ${contentType}`);
69
- }
70
- if (feeRate !== undefined && (typeof feeRate !== 'number' || feeRate <= 0 || !Number.isFinite(feeRate))) {
71
- throw new StructuredError('INVALID_INPUT', 'Fee rate must be a positive number');
72
- }
73
- // Security: Reject extremely high fee rates to prevent accidental fund drainage
74
- const MAX_REASONABLE_FEE_RATE = 10000; // sat/vB
75
- if (feeRate !== undefined && feeRate > MAX_REASONABLE_FEE_RATE) {
76
- throw new StructuredError('INVALID_INPUT', `Fee rate ${feeRate} exceeds maximum reasonable fee rate of ${MAX_REASONABLE_FEE_RATE} sat/vB`);
77
- }
78
- const effectiveFeeRate = await this.resolveFeeRate(1, feeRate);
79
- if (!this.ord) {
80
- throw new StructuredError('ORD_PROVIDER_REQUIRED', 'Ordinals provider must be configured to inscribe data on Bitcoin. ' +
81
- 'Please provide an ordinalsProvider in your SDK configuration. ' +
82
- 'For testing, use: import { OrdMockProvider } from \'@originals/sdk\';');
83
- }
84
- if (typeof this.ord.createInscription !== 'function') {
85
- throw new StructuredError('ORD_PROVIDER_UNSUPPORTED', 'Configured ordinals provider does not support inscription creation');
86
- }
87
- const creation = await this.ord.createInscription({ data, contentType, feeRate: effectiveFeeRate });
88
- const txid = creation.txid ?? creation.revealTxId;
89
- if (!creation.inscriptionId || !txid) {
90
- throw new StructuredError('ORD_PROVIDER_INVALID_RESPONSE', 'Ordinals provider did not return a valid inscription identifier or transaction id');
91
- }
92
- let satoshi = creation.satoshi ?? '';
93
- if (!satoshi) {
94
- satoshi = (await this.getSatoshiFromInscription(creation.inscriptionId)) ?? '';
95
- }
96
- // Validate satoshi before using it
97
- if (satoshi) {
98
- const validation = validateSatoshiNumber(satoshi);
99
- if (!validation.valid) {
100
- throw new StructuredError('INVALID_SATOSHI', `Ordinals provider returned invalid satoshi identifier: ${validation.error}`);
101
- }
102
- }
103
- let recordedFeeRate;
104
- if (this.feeOracle) {
105
- recordedFeeRate = effectiveFeeRate;
106
- }
107
- else if (typeof feeRate === 'number' && Number.isFinite(feeRate) && feeRate > 0) {
108
- recordedFeeRate = feeRate;
109
- }
110
- else {
111
- recordedFeeRate = creation.feeRate ?? effectiveFeeRate;
112
- }
113
- const inscription = {
114
- satoshi,
115
- inscriptionId: creation.inscriptionId,
116
- content: creation.content ?? data,
117
- contentType: creation.contentType ?? contentType,
118
- txid,
119
- vout: typeof creation.vout === 'number' ? creation.vout : 0,
120
- blockHeight: creation.blockHeight,
121
- revealTxId: creation.revealTxId,
122
- commitTxId: creation.commitTxId,
123
- feeRate: recordedFeeRate
124
- };
125
- return inscription;
126
- }
127
- async trackInscription(inscriptionId) {
128
- if (this.ord) {
129
- const info = await this.ord.getInscriptionById(inscriptionId);
130
- if (!info)
131
- return null;
132
- return {
133
- satoshi: info.satoshi ?? '',
134
- inscriptionId: info.inscriptionId,
135
- content: info.content,
136
- contentType: info.contentType,
137
- txid: info.txid,
138
- vout: info.vout,
139
- blockHeight: info.blockHeight
140
- };
141
- }
142
- return null;
143
- }
144
- async transferInscription(inscription, toAddress) {
145
- // Input validation
146
- if (!inscription || typeof inscription !== 'object') {
147
- throw new StructuredError('INVALID_INPUT', 'Inscription must be a valid OrdinalsInscription object');
148
- }
149
- if (!inscription.inscriptionId || typeof inscription.inscriptionId !== 'string') {
150
- throw new StructuredError('INVALID_INPUT', 'Inscription must have a valid inscriptionId');
151
- }
152
- if (!toAddress || typeof toAddress !== 'string') {
153
- throw new StructuredError('INVALID_INPUT', 'Destination address must be a non-empty string');
154
- }
155
- // Validate Bitcoin address format and checksum
156
- try {
157
- validateBitcoinAddress(toAddress, this.config.network);
158
- }
159
- catch (error) {
160
- const message = error instanceof Error ? error.message : 'Invalid Bitcoin address';
161
- throw new StructuredError('INVALID_ADDRESS', message);
162
- }
163
- const effectiveFeeRate = await this.resolveFeeRate(1);
164
- if (!this.ord) {
165
- throw new StructuredError('ORD_PROVIDER_REQUIRED', 'Ordinals provider must be configured to transfer inscriptions on Bitcoin. ' +
166
- 'Please provide an ordinalsProvider in your SDK configuration. ' +
167
- 'For testing, use: import { OrdMockProvider } from \'@originals/sdk\';');
168
- }
169
- if (typeof this.ord.transferInscription !== 'function') {
170
- throw new StructuredError('ORD_PROVIDER_UNSUPPORTED', 'Configured ordinals provider does not support inscription transfers');
171
- }
172
- const response = await this.ord.transferInscription(inscription.inscriptionId, toAddress, {
173
- feeRate: effectiveFeeRate
174
- });
175
- if (!response || !response.txid) {
176
- throw new StructuredError('ORD_PROVIDER_INVALID_RESPONSE', 'Ordinals provider did not return a valid transfer transaction');
177
- }
178
- if (response.satoshi) {
179
- inscription.satoshi = response.satoshi;
180
- }
181
- return {
182
- txid: response.txid,
183
- vin: response.vin ?? [{ txid: inscription.txid, vout: inscription.vout }],
184
- vout: response.vout?.length
185
- ? response.vout
186
- : [{ value: DUST_LIMIT_SATS, scriptPubKey: 'script', address: toAddress }],
187
- fee: response.fee,
188
- blockHeight: response.blockHeight,
189
- confirmations: response.confirmations
190
- };
191
- }
192
- async preventFrontRunning(satoshi) {
193
- if (!satoshi)
194
- throw new StructuredError('SATOSHI_REQUIRED', 'Satoshi identifier is required');
195
- // Naive implementation: check for multiple inscriptions on same satoshi via provider
196
- if (this.ord) {
197
- const list = await this.ord.getInscriptionsBySatoshi(satoshi);
198
- return list.length <= 1;
199
- }
200
- return true;
201
- }
202
- async getSatoshiFromInscription(inscriptionId) {
203
- if (this.ord) {
204
- const info = await this.ord.getInscriptionById(inscriptionId);
205
- const satoshi = info?.satoshi;
206
- // Validate satoshi before returning
207
- if (satoshi) {
208
- const validation = validateSatoshiNumber(satoshi);
209
- if (!validation.valid) {
210
- // Return null if validation fails (don't return empty or invalid string)
211
- return null;
212
- }
213
- return satoshi;
214
- }
215
- return null;
216
- }
217
- return null;
218
- }
219
- async validateBTCODID(didId) {
220
- // Validate that a did:btco DID exists on Bitcoin
221
- const satoshi = this.extractSatoshiFromBTCODID(didId);
222
- if (!satoshi)
223
- return false;
224
- // Validate the extracted satoshi number
225
- const validation = validateSatoshiNumber(satoshi);
226
- if (!validation.valid)
227
- return false;
228
- if (!this.ord)
229
- return false;
230
- const inscriptions = await this.ord.getInscriptionsBySatoshi(satoshi);
231
- return inscriptions.length > 0;
232
- }
233
- extractSatoshiFromBTCODID(didId) {
234
- // Extract satoshi identifier from did:btco DID
235
- if (!didId.startsWith('did:btco:'))
236
- return null;
237
- const parts = didId.split(':');
238
- let satoshi = null;
239
- // Handle different network prefixes:
240
- // did:btco:123456 (mainnet) - 3 parts
241
- // did:btco:test:123456 or did:btco:sig:123456 - 4 parts
242
- if (parts.length === 3) {
243
- satoshi = parts[2];
244
- }
245
- else if (parts.length === 4) {
246
- // Validate network prefix - only 'test' and 'sig' are allowed
247
- const network = parts[2];
248
- if (network !== 'test' && network !== 'sig') {
249
- return null;
250
- }
251
- satoshi = parts[3];
252
- }
253
- // Validate the extracted satoshi format
254
- if (satoshi) {
255
- const validation = validateSatoshiNumber(satoshi);
256
- if (!validation.valid) {
257
- return null;
258
- }
259
- }
260
- return satoshi;
261
- }
262
- }
@@ -1,30 +0,0 @@
1
- export interface TransactionStatus {
2
- confirmed: boolean;
3
- confirmations?: number;
4
- }
5
- export interface Broadcaster {
6
- (txHex: string): Promise<string>;
7
- }
8
- export interface StatusProvider {
9
- (txid: string): Promise<TransactionStatus>;
10
- }
11
- export interface BroadcastOptions {
12
- pollIntervalMs?: number;
13
- maxAttempts?: number;
14
- }
15
- /**
16
- * Broadcast client with idempotency and confirmation polling.
17
- * Designed to be predictable and simple, honoring behavior expected by the
18
- * ordinalsplus legacy components which are finicky about retries.
19
- */
20
- export declare class BroadcastClient {
21
- private readonly broadcaster;
22
- private readonly statusProvider;
23
- private inflight;
24
- constructor(broadcaster: Broadcaster, statusProvider: StatusProvider);
25
- broadcastIdempotent(txidKey: string, create: () => Promise<string>): Promise<string>;
26
- broadcastAndConfirm(txHex: string, options?: BroadcastOptions): Promise<{
27
- txid: string;
28
- confirmations: number;
29
- }>;
30
- }
@@ -1,35 +0,0 @@
1
- /**
2
- * Broadcast client with idempotency and confirmation polling.
3
- * Designed to be predictable and simple, honoring behavior expected by the
4
- * ordinalsplus legacy components which are finicky about retries.
5
- */
6
- export class BroadcastClient {
7
- constructor(broadcaster, statusProvider) {
8
- this.broadcaster = broadcaster;
9
- this.statusProvider = statusProvider;
10
- this.inflight = new Map();
11
- }
12
- broadcastIdempotent(txidKey, create) {
13
- if (this.inflight.has(txidKey))
14
- return this.inflight.get(txidKey);
15
- const p = (async () => create())();
16
- this.inflight.set(txidKey, p);
17
- return p.finally(() => this.inflight.delete(txidKey));
18
- }
19
- async broadcastAndConfirm(txHex, options = {}) {
20
- const txid = await this.broadcastIdempotent(txHex, () => this.broadcaster(txHex));
21
- const interval = Math.max(100, options.pollIntervalMs ?? 500);
22
- const maxAttempts = Math.max(1, options.maxAttempts ?? 20);
23
- let attempts = 0;
24
- let last = { confirmed: false };
25
- while (attempts < maxAttempts) {
26
- last = await this.statusProvider(txid);
27
- if (last.confirmed) {
28
- return { txid, confirmations: last.confirmations ?? 1 };
29
- }
30
- await new Promise(r => setTimeout(r, interval));
31
- attempts++;
32
- }
33
- return { txid, confirmations: last.confirmations ?? 0 };
34
- }
35
- }
@@ -1,21 +0,0 @@
1
- import { OrdinalsInscription, BitcoinTransaction } from '../types';
2
- export declare class OrdinalsClient {
3
- private rpcUrl;
4
- private network;
5
- constructor(rpcUrl: string, network: 'mainnet' | 'regtest' | 'signet');
6
- getInscriptionById(id: string): Promise<OrdinalsInscription | null>;
7
- getInscriptionsBySatoshi(satoshi: string): Promise<OrdinalsInscription[]>;
8
- broadcastTransaction(tx: BitcoinTransaction): Promise<string>;
9
- getTransactionStatus(txid: string): Promise<{
10
- confirmed: boolean;
11
- blockHeight?: number;
12
- confirmations?: number;
13
- }>;
14
- estimateFee(blocks?: number): Promise<number>;
15
- getSatInfo(satoshi: string): Promise<{
16
- inscription_ids: string[];
17
- }>;
18
- resolveInscription(identifier: string): Promise<OrdinalsInscription | null>;
19
- getMetadata(inscriptionId: string): Promise<Record<string, unknown> | null>;
20
- private fetchJson;
21
- }
@@ -1,105 +0,0 @@
1
- import { decode as decodeCbor } from '../utils/cbor';
2
- import { hexToBytes } from '../utils/encoding';
3
- export class OrdinalsClient {
4
- constructor(rpcUrl, network) {
5
- this.rpcUrl = rpcUrl;
6
- this.network = network;
7
- }
8
- async getInscriptionById(id) {
9
- if (!id)
10
- return null;
11
- return this.resolveInscription(id);
12
- }
13
- async getInscriptionsBySatoshi(satoshi) {
14
- const info = await this.getSatInfo(satoshi);
15
- if (!info.inscription_ids.length)
16
- return [];
17
- const inscriptions = await Promise.all(info.inscription_ids.map(id => this.resolveInscription(id)));
18
- return inscriptions.filter((x) => x !== null);
19
- }
20
- async broadcastTransaction(tx) {
21
- return tx.txid || 'txid';
22
- }
23
- async getTransactionStatus(txid) {
24
- return { confirmed: false };
25
- }
26
- async estimateFee(blocks = 1) {
27
- return Math.max(1, blocks) * 10;
28
- }
29
- // Added provider-like helper methods commonly expected by higher-level resolvers
30
- // Minimal placeholder implementations suitable for unit testing
31
- async getSatInfo(satoshi) {
32
- const data = await this.fetchJson(`/sat/${satoshi}`);
33
- if (!data)
34
- return { inscription_ids: [] };
35
- // Support both {inscription_ids: []} and {data: {inscription_ids: []}} shapes via fetchJson
36
- const inscriptionIds = Array.isArray(data.inscription_ids) ? data.inscription_ids : [];
37
- return { inscription_ids: inscriptionIds };
38
- }
39
- async resolveInscription(identifier) {
40
- if (!identifier)
41
- return null;
42
- const info = await this.fetchJson(`/inscription/${identifier}`);
43
- if (!info)
44
- return null;
45
- // Fetch content bytes
46
- const contentUrl = info.content_url || `${this.rpcUrl}/content/${identifier}`;
47
- const contentRes = await fetch(contentUrl);
48
- if (!contentRes.ok)
49
- throw new Error(`Failed to fetch inscription content: ${contentRes.status}`);
50
- const contentArrayBuf = await contentRes.arrayBuffer();
51
- const content = Buffer.from(new Uint8Array(contentArrayBuf));
52
- // owner_output may be 'txid:vout'
53
- let txid = 'unknown';
54
- let vout = 0;
55
- if (typeof info.owner_output === 'string' && info.owner_output.includes(':')) {
56
- const [tid, v] = info.owner_output.split(':');
57
- txid = tid;
58
- vout = Number(v) || 0;
59
- }
60
- // sat number provided as number or string
61
- const satoshi = String(info.sat ?? '');
62
- const inscription = {
63
- satoshi,
64
- inscriptionId: info.inscription_id || identifier,
65
- content,
66
- contentType: info.content_type || 'application/octet-stream',
67
- txid,
68
- vout,
69
- blockHeight: info.block_height
70
- };
71
- return inscription;
72
- }
73
- async getMetadata(inscriptionId) {
74
- if (!inscriptionId)
75
- return null;
76
- const base = this.rpcUrl.replace(/\/$/, '');
77
- const res = await fetch(`${base}/r/metadata/${inscriptionId}`, { headers: { 'Accept': 'application/json' } });
78
- if (!res.ok) {
79
- return null;
80
- }
81
- let text = (await res.text()).trim();
82
- if (text.startsWith('"') && text.endsWith('"')) {
83
- try {
84
- text = JSON.parse(text);
85
- }
86
- catch (_) { }
87
- }
88
- try {
89
- const bytes = hexToBytes(text);
90
- return decodeCbor(bytes);
91
- }
92
- catch (_) {
93
- return null;
94
- }
95
- }
96
- async fetchJson(path) {
97
- const url = `${this.rpcUrl.replace(/\/$/, '')}${path}`;
98
- const res = await fetch(url, { headers: { 'Accept': 'application/json' } });
99
- if (!res.ok)
100
- return null;
101
- const body = await res.json();
102
- // Accept { data: T } or T
103
- return (body && typeof body === 'object' && 'data' in body) ? body.data : body;
104
- }
105
- }
@@ -1,24 +0,0 @@
1
- import type { Utxo } from '../types/bitcoin';
2
- export interface PsbtOutput {
3
- address: string;
4
- value: number;
5
- }
6
- export interface BuildPsbtParams {
7
- utxos: Utxo[];
8
- outputs: PsbtOutput[];
9
- changeAddress: string;
10
- feeRate: number;
11
- network: 'mainnet' | 'testnet' | 'regtest' | 'signet';
12
- dustLimit?: number;
13
- }
14
- export interface BuildPsbtResult {
15
- psbtBase64: string;
16
- selectedUtxos: Utxo[];
17
- fee: number;
18
- changeOutput?: PsbtOutput;
19
- }
20
- export declare class PSBTBuilder {
21
- private readonly dustLimit;
22
- constructor(dustLimit?: number);
23
- build(params: BuildPsbtParams): BuildPsbtResult;
24
- }
@@ -1,80 +0,0 @@
1
- function estimateVBytes(inputs, outputs) {
2
- const overhead = 10; // base tx overhead
3
- const inSize = 68; // rough P2WPKH/any-segwit input size
4
- const outSize = 31; // P2WPKH output size
5
- return Math.ceil(overhead + inputs * inSize + outputs * outSize);
6
- }
7
- export class PSBTBuilder {
8
- constructor(dustLimit = 546) {
9
- this.dustLimit = dustLimit;
10
- }
11
- build(params) {
12
- const { utxos, outputs, changeAddress, feeRate } = params;
13
- if (!utxos || utxos.length === 0)
14
- throw new Error('No UTXOs');
15
- if (!outputs || outputs.length === 0)
16
- throw new Error('No outputs');
17
- // Sort UTXOs ascending by value for simple greedy selection
18
- const sorted = [...utxos].sort((a, b) => a.value - b.value);
19
- // Start with smallest set to cover target + estimated fee; refine iteratively
20
- const targetValue = outputs.reduce((s, o) => s + o.value, 0);
21
- let selected = [];
22
- let total = 0;
23
- const pick = () => {
24
- selected = [];
25
- total = 0;
26
- for (const u of sorted) {
27
- selected.push(u);
28
- total += u.value;
29
- const vbytes = estimateVBytes(selected.length, outputs.length + 1); // +1 potential change
30
- const fee = Math.ceil(vbytes * feeRate);
31
- if (total >= targetValue + fee)
32
- break;
33
- }
34
- if (total < targetValue)
35
- throw new Error('Insufficient funds');
36
- };
37
- pick();
38
- const initialVBytes = estimateVBytes(selected.length, outputs.length + 1);
39
- let fee = Math.ceil(initialVBytes * feeRate);
40
- let change = total - targetValue - fee;
41
- let includeChange = change >= this.dustLimit;
42
- // Re-estimate once we know whether change is included
43
- const finalVBytes = estimateVBytes(selected.length, outputs.length + (includeChange ? 1 : 0));
44
- fee = Math.ceil(finalVBytes * feeRate);
45
- change = total - targetValue - fee;
46
- includeChange = change >= this.dustLimit;
47
- let changeOutput;
48
- if (!includeChange) {
49
- // Add dust to fee
50
- fee = total - targetValue;
51
- }
52
- else {
53
- changeOutput = { address: changeAddress, value: change };
54
- }
55
- // Construct a minimal PSBT-like payload for dry-run/testing. We intentionally avoid
56
- // bringing heavy bitcoin libraries here; this builder focuses on deterministic
57
- // selection, fee estimation, and change handling.
58
- const payload = {
59
- version: 0,
60
- inputs: selected.map(u => ({ txid: u.txid, vout: u.vout })),
61
- outputs: [
62
- ...outputs.map(o => ({ address: o.address, value: o.value })),
63
- ...(changeOutput ? [changeOutput] : [])
64
- ],
65
- fee
66
- };
67
- // Base64 encode via Node when available; fallback to btoa if present
68
- const json = JSON.stringify(payload);
69
- let psbtBase64;
70
- try {
71
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
72
- const B = global.Buffer;
73
- psbtBase64 = B ? B.from(json, 'utf8').toString('base64') : global.btoa(json);
74
- }
75
- catch {
76
- psbtBase64 = `psbt:${json}`;
77
- }
78
- return { psbtBase64, selectedUtxos: selected, fee, changeOutput };
79
- }
80
- }
@@ -1,14 +0,0 @@
1
- /**
2
- * Bitcoin Transaction Fee Calculation
3
- *
4
- * Utilities for calculating transaction fees based on size and fee rate.
5
- * Ported from legacy ordinalsplus transaction infrastructure.
6
- */
7
- /**
8
- * Calculate transaction fee based on vbytes and fee rate, ensuring minimum relay fee.
9
- *
10
- * @param vbytes - The virtual size of the transaction.
11
- * @param feeRate - The desired fee rate in sats/vbyte.
12
- * @returns The calculated fee in satoshis (bigint).
13
- */
14
- export declare const calculateFee: (vbytes: number, feeRate: number) => bigint;
@@ -1,31 +0,0 @@
1
- /**
2
- * Bitcoin Transaction Fee Calculation
3
- *
4
- * Utilities for calculating transaction fees based on size and fee rate.
5
- * Ported from legacy ordinalsplus transaction infrastructure.
6
- */
7
- // Define minimum relay fee rate (sats/vB)
8
- // Increased slightly from Bitcoin Core default of 1.0 for safety
9
- const MIN_RELAY_FEE_RATE = 1.1;
10
- /**
11
- * Calculate transaction fee based on vbytes and fee rate, ensuring minimum relay fee.
12
- *
13
- * @param vbytes - The virtual size of the transaction.
14
- * @param feeRate - The desired fee rate in sats/vbyte.
15
- * @returns The calculated fee in satoshis (bigint).
16
- */
17
- export const calculateFee = (vbytes, feeRate) => {
18
- // Ensure inputs are valid numbers
19
- if (isNaN(vbytes) || vbytes <= 0 || isNaN(feeRate) || feeRate <= 0) {
20
- console.warn(`[calculateFee] Invalid input: vbytes=${vbytes}, feeRate=${feeRate}. Returning 0.`);
21
- return 0n;
22
- }
23
- // Calculate fee based on the desired fee rate
24
- const calculatedFee = Math.ceil(vbytes * feeRate);
25
- // Calculate the minimum fee required for relay
26
- const minimumFee = Math.ceil(vbytes * MIN_RELAY_FEE_RATE);
27
- // Return the higher of the calculated fee or minimum relay fee
28
- // Ensure the result is a positive integer (minimum 1 sat)
29
- const finalFee = BigInt(Math.max(1, calculatedFee, minimumFee));
30
- return finalFee;
31
- };
@@ -1,38 +0,0 @@
1
- import type { ResourceProvider, LinkedResource, ResourceInfo, Inscription, ResourceCrawlOptions } from './types';
2
- export interface OrdNodeProviderOptions {
3
- nodeUrl: string;
4
- timeout?: number;
5
- network?: 'mainnet' | 'testnet' | 'signet';
6
- }
7
- export declare class OrdNodeProvider implements ResourceProvider {
8
- private readonly nodeUrl;
9
- private readonly timeout;
10
- private readonly network;
11
- constructor(options: OrdNodeProviderOptions);
12
- resolve(resourceId: string): Promise<LinkedResource>;
13
- resolveInscription(inscriptionId: string): Promise<Inscription>;
14
- resolveInfo(resourceId: string): Promise<ResourceInfo>;
15
- resolveCollection(did: string, _options?: {
16
- type?: string;
17
- limit?: number;
18
- offset?: number;
19
- }): Promise<LinkedResource[]>;
20
- getSatInfo(_satNumber: string): Promise<{
21
- inscription_ids: string[];
22
- }>;
23
- getMetadata(_inscriptionId: string): Promise<any>;
24
- getAllResources(_options?: ResourceCrawlOptions): AsyncGenerator<LinkedResource[]>;
25
- getAllResourcesChronological(_options?: ResourceCrawlOptions): AsyncGenerator<LinkedResource[]>;
26
- getInscriptionLocationsByAddress(_address: string): Promise<{
27
- id: string;
28
- location: string;
29
- }[]>;
30
- getInscriptionByNumber(_inscriptionNumber: number): Promise<Inscription>;
31
- getAddressOutputs(_address: string): Promise<string[]>;
32
- getOutputDetails(_outpoint: string): Promise<{
33
- value: number;
34
- script_pubkey: string;
35
- spent: boolean;
36
- inscriptions: string[];
37
- }>;
38
- }