@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,694 +0,0 @@
1
- import { DIDDocument, OriginalsConfig, AssetResource, VerificationMethod, KeyPair, ExternalSigner, ExternalVerifier } from '../types';
2
- import { getNetworkDomain, DEFAULT_WEBVH_NETWORK, getBitcoinNetworkForWebVH } from '../types/network';
3
- import { BtcoDidResolver } from './BtcoDidResolver';
4
- import { OrdinalsClient } from '../bitcoin/OrdinalsClient';
5
- import { createBtcoDidDocument } from './createBtcoDidDocument';
6
- import { OrdinalsClientProviderAdapter } from './providers/OrdinalsClientProviderAdapter';
7
- import { multikey } from '../crypto/Multikey';
8
- import { KeyManager } from './KeyManager';
9
- import { Ed25519Signer } from '../crypto/Signer';
10
- import { validateSatoshiNumber, MAX_SATOSHI_SUPPLY } from '../utils/satoshi-validation';
11
- import * as fs from 'fs';
12
- import * as path from 'path';
13
-
14
- export class DIDManager {
15
- constructor(private config: OriginalsConfig) {}
16
-
17
- async createDIDPeer(resources: AssetResource[], returnKeyPair?: false): Promise<DIDDocument>;
18
- async createDIDPeer(resources: AssetResource[], returnKeyPair: true): Promise<{ didDocument: DIDDocument; keyPair: { privateKey: string; publicKey: string } }>;
19
- async createDIDPeer(resources: AssetResource[], returnKeyPair?: boolean): Promise<DIDDocument | { didDocument: DIDDocument; keyPair: { privateKey: string; publicKey: string } }> {
20
- // Generate a multikey keypair according to configured defaultKeyType
21
- const keyManager = new KeyManager();
22
- const desiredType = this.config.defaultKeyType || 'ES256K';
23
- const keyPair = await keyManager.generateKeyPair(desiredType);
24
-
25
- // Use @aviarytech/did-peer to create a did:peer (variant 4 long-form for full VM+context)
26
- const didPeerMod: any = await import('@aviarytech/did-peer');
27
- const did: string = await didPeerMod.createNumAlgo4(
28
- [
29
- {
30
- // type validated by the library; controller/id not required
31
- type: 'Multikey',
32
- publicKeyMultibase: keyPair.publicKey
33
- }
34
- ],
35
- undefined,
36
- undefined
37
- );
38
-
39
- // Resolve to DID Document using the same library
40
- const resolved: any = await didPeerMod.resolve(did);
41
- // Ensure controller is set on VM entries for compatibility
42
- if (resolved && Array.isArray(resolved.verificationMethod)) {
43
- resolved.verificationMethod = resolved.verificationMethod.map((vm: any) => ({
44
- controller: did,
45
- ...vm
46
- }));
47
- }
48
- // Ensure relationships exist and reference a VM
49
- const vmIds: string[] = Array.isArray(resolved?.verificationMethod)
50
- ? resolved.verificationMethod.map((vm: any) => vm.id).filter(Boolean)
51
- : [];
52
- if (!resolved.authentication || resolved.authentication.length === 0) {
53
- if (vmIds.length > 0) resolved.authentication = [vmIds[0]];
54
- }
55
- if (!resolved.assertionMethod || resolved.assertionMethod.length === 0) {
56
- resolved.assertionMethod = resolved.authentication || (vmIds.length > 0 ? [vmIds[0]] : []);
57
- }
58
-
59
- if (returnKeyPair) {
60
- return { didDocument: resolved as DIDDocument, keyPair };
61
- }
62
- return resolved as DIDDocument;
63
- }
64
-
65
- async migrateToDIDWebVH(didDoc: DIDDocument, domain?: string): Promise<DIDDocument> {
66
- // Use provided domain or get default from configured network
67
- const network = this.config.webvhNetwork || DEFAULT_WEBVH_NETWORK;
68
- const targetDomain = domain || getNetworkDomain(network);
69
-
70
- // Flexible domain validation - allow development domains with ports
71
- const normalized = String(targetDomain || '').trim().toLowerCase();
72
-
73
- // Split domain and port if present
74
- const [domainPart, portPart] = normalized.split(':');
75
-
76
- // Validate port if present
77
- if (portPart && (!/^\d+$/.test(portPart) || parseInt(portPart) < 1 || parseInt(portPart) > 65535)) {
78
- throw new Error(`Invalid domain: ${domain} - invalid port`);
79
- }
80
-
81
- // Allow localhost and IP addresses for development
82
- const isLocalhost = domainPart === 'localhost';
83
- const isIP = /^(\d{1,3}\.){3}\d{1,3}$/.test(domainPart);
84
-
85
- if (!isLocalhost && !isIP) {
86
- // For non-localhost domains, require proper domain format
87
- const label = '[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?';
88
- const domainRegex = new RegExp(`^(?=.{1,253}$)(?:${label})(?:\\.(?:${label}))+?$`, 'i');
89
- if (!domainRegex.test(domainPart)) {
90
- throw new Error('Invalid domain');
91
- }
92
- }
93
-
94
- // Stable slug derived from original peer DID suffix (or last segment)
95
- const parts = (didDoc.id || '').split(':');
96
- const method = parts.slice(0, 2).join(':');
97
- const originalSuffix = method === 'did:peer' ? parts.slice(2).join(':') : parts[parts.length - 1];
98
- const slug = (originalSuffix || '')
99
- .toString()
100
- .trim()
101
- .replace(/[^a-zA-Z0-9._-]/g, '-')
102
- .toLowerCase();
103
-
104
- const migrated: DIDDocument = {
105
- ...didDoc,
106
- id: `did:webvh:${normalized}:${slug}`
107
- };
108
- return migrated;
109
- }
110
-
111
- async migrateToDIDBTCO(didDoc: DIDDocument, satoshi: string): Promise<DIDDocument> {
112
- // Validate satoshi parameter
113
- const validation = validateSatoshiNumber(satoshi);
114
- if (!validation.valid) {
115
- throw new Error(`Invalid satoshi identifier: ${validation.error}`);
116
- }
117
-
118
- // Additional range validation for positive values within Bitcoin supply
119
- const satoshiNum = Number(satoshi);
120
- if (satoshiNum < 0) {
121
- throw new Error('Satoshi identifier must be positive (>= 0)');
122
- }
123
- if (satoshiNum > MAX_SATOSHI_SUPPLY) {
124
- throw new Error(`Satoshi identifier must be within Bitcoin's total supply (0 to ${MAX_SATOSHI_SUPPLY.toLocaleString()})`);
125
- }
126
-
127
- // Determine Bitcoin network from WebVH network configuration if available
128
- // This ensures consistent environment mapping: magby→regtest, cleffa→signet, pichu→mainnet
129
- let network: 'mainnet' | 'regtest' | 'signet';
130
- if (this.config.webvhNetwork) {
131
- network = getBitcoinNetworkForWebVH(this.config.webvhNetwork);
132
- } else {
133
- // Fall back to explicit network config
134
- network = this.config.network || 'mainnet';
135
- }
136
-
137
- // Try to carry over the first multikey VM if present
138
- const firstVm = (didDoc.verificationMethod && didDoc.verificationMethod[0]) as VerificationMethod | undefined;
139
- let publicKey: Uint8Array | undefined;
140
- let keyType: Parameters<typeof createBtcoDidDocument>[2]['keyType'] | undefined;
141
- try {
142
- if (firstVm && firstVm.publicKeyMultibase) {
143
- const decoded = multikey.decodePublicKey(firstVm.publicKeyMultibase);
144
- publicKey = decoded.key;
145
- keyType = decoded.type;
146
- }
147
- } catch (err) {
148
- // Unable to decode public key from verification method; will proceed without key material
149
- if (this.config.enableLogging) {
150
- console.warn('Failed to decode verification method public key:', err);
151
- }
152
- }
153
-
154
- // If no key material is available, generate a minimal btco DID doc without keys
155
- let btcoDoc: DIDDocument;
156
- if (publicKey && keyType) {
157
- btcoDoc = createBtcoDidDocument(satoshi, network as any, { publicKey, keyType });
158
- } else {
159
- const prefix = network === 'mainnet' ? 'did:btco:' : network === 'regtest' ? 'did:btco:reg:' : 'did:btco:sig:';
160
- btcoDoc = {
161
- '@context': ['https://www.w3.org/ns/did/v1'],
162
- id: prefix + String(satoshi)
163
- };
164
- }
165
-
166
- // Carry over service endpoints if present
167
- if (didDoc.service && didDoc.service.length > 0) {
168
- btcoDoc.service = didDoc.service;
169
- }
170
- return btcoDoc;
171
- }
172
-
173
- async resolveDID(did: string): Promise<DIDDocument | null> {
174
- try {
175
- if (did.startsWith('did:peer:')) {
176
- try {
177
- const mod: any = await import('@aviarytech/did-peer');
178
- const doc = await mod.resolve(did);
179
- return doc as DIDDocument;
180
- } catch (err) {
181
- // Failed to resolve did:peer; returning minimal document
182
- if (this.config.enableLogging) {
183
- console.warn('Failed to resolve did:peer:', err);
184
- }
185
- }
186
- return { '@context': ['https://www.w3.org/ns/did/v1'], id: did };
187
- }
188
- if (did.startsWith('did:btco:') || did.startsWith('did:btco:test:') || did.startsWith('did:btco:sig:')) {
189
- const rpcUrl = this.config.bitcoinRpcUrl || 'http://localhost:3000';
190
- const network = this.config.network || 'mainnet';
191
- const client = new OrdinalsClient(rpcUrl, network);
192
- const adapter = new OrdinalsClientProviderAdapter(client, rpcUrl);
193
- const resolver = new BtcoDidResolver({ provider: adapter });
194
- const result = await resolver.resolve(did);
195
- return result.didDocument || null;
196
- }
197
- if (did.startsWith('did:webvh:')) {
198
- try {
199
- const mod: any = await import('didwebvh-ts');
200
- if (mod && typeof mod.resolveDID === 'function') {
201
- const result = await mod.resolveDID(did);
202
- if (result && result.doc) return result.doc as DIDDocument;
203
- }
204
- } catch (err) {
205
- // Failed to resolve did:webvh; returning minimal document
206
- if (this.config.enableLogging) {
207
- console.warn('Failed to resolve did:webvh:', err);
208
- }
209
- }
210
- return { '@context': ['https://www.w3.org/ns/did/v1'], id: did };
211
- }
212
- return { '@context': ['https://www.w3.org/ns/did/v1'], id: did };
213
- } catch (err) {
214
- // DID resolution failed
215
- if (this.config.enableLogging) {
216
- console.error('Failed to resolve DID:', err);
217
- }
218
- return null;
219
- }
220
- }
221
-
222
- validateDIDDocument(didDoc: DIDDocument): boolean {
223
- return !!didDoc.id && Array.isArray(didDoc['@context']);
224
- }
225
-
226
- private getLayerFromDID(did: string): 'did:peer' | 'did:webvh' | 'did:btco' {
227
- if (did.startsWith('did:peer:')) return 'did:peer';
228
- if (did.startsWith('did:webvh:')) return 'did:webvh';
229
- if (did.startsWith('did:btco:')) return 'did:btco';
230
- throw new Error('Unsupported DID method');
231
- }
232
-
233
- createBtcoDidDocument(
234
- satNumber: number | string,
235
- network: 'mainnet' | 'regtest' | 'signet',
236
- options: Parameters<typeof createBtcoDidDocument>[2]
237
- ): DIDDocument {
238
- return createBtcoDidDocument(satNumber, network, options as any);
239
- }
240
-
241
- // ========================================================================
242
- // DID:WebVH Methods
243
- // ========================================================================
244
-
245
- /**
246
- * Creates a new did:webvh DID with proper cryptographic signing
247
- * @param options - Creation options including domain and optional key pair or external signer
248
- * @returns The created DID, document, log, and key pair (if generated)
249
- */
250
- async createDIDWebVH(options: CreateWebVHOptions): Promise<CreateWebVHResult> {
251
- const {
252
- domain: providedDomain,
253
- keyPair: providedKeyPair,
254
- paths = [],
255
- portable = false,
256
- outputDir,
257
- externalSigner,
258
- externalVerifier,
259
- verificationMethods: providedVerificationMethods,
260
- updateKeys: providedUpdateKeys
261
- } = options;
262
-
263
- // Use provided domain or get default from configured network
264
- const network = this.config.webvhNetwork || DEFAULT_WEBVH_NETWORK;
265
- const domain = providedDomain || getNetworkDomain(network);
266
-
267
- // Dynamically import didwebvh-ts to avoid module resolution issues
268
- const mod = await import('didwebvh-ts') as unknown as {
269
- createDID: (options: Record<string, unknown>) => Promise<{
270
- did: string;
271
- doc: Record<string, unknown>;
272
- log: DIDLog;
273
- }>;
274
- prepareDataForSigning: (
275
- document: Record<string, unknown>,
276
- proof: Record<string, unknown>
277
- ) => Promise<Uint8Array>;
278
- };
279
- const { createDID, prepareDataForSigning } = mod;
280
-
281
- // Runtime validation of imported module
282
- if (typeof createDID !== 'function' || typeof prepareDataForSigning !== 'function') {
283
- throw new Error('Failed to load didwebvh-ts: invalid module exports');
284
- }
285
-
286
- let signer: Signer | ExternalSigner;
287
- let verifier: Verifier | ExternalVerifier;
288
- let keyPair: KeyPair | undefined;
289
- let verificationMethods: WebVHVerificationMethod[];
290
- let updateKeys: string[];
291
-
292
- // Use external signer if provided (e.g., Privy integration)
293
- if (externalSigner) {
294
- if (!providedVerificationMethods || providedVerificationMethods.length === 0) {
295
- throw new Error('verificationMethods are required when using externalSigner');
296
- }
297
- if (!providedUpdateKeys || providedUpdateKeys.length === 0) {
298
- throw new Error('updateKeys are required when using externalSigner');
299
- }
300
-
301
- signer = externalSigner;
302
- verifier = externalVerifier || externalSigner as any; // Use signer as verifier if not provided
303
- verificationMethods = providedVerificationMethods;
304
- updateKeys = providedUpdateKeys;
305
- keyPair = undefined; // No key pair when using external signer
306
- } else {
307
- // Generate or use provided key pair (Ed25519 for did:webvh)
308
- const keyManager = new KeyManager();
309
- keyPair = providedKeyPair || await keyManager.generateKeyPair('Ed25519');
310
-
311
- // Create verification methods
312
- verificationMethods = [
313
- {
314
- type: 'Multikey',
315
- publicKeyMultibase: keyPair.publicKey,
316
- }
317
- ];
318
-
319
- // Create signer using our adapter
320
- const internalSigner = new OriginalsWebVHSigner(
321
- keyPair.privateKey,
322
- verificationMethods[0],
323
- prepareDataForSigning,
324
- { verificationMethod: verificationMethods[0] }
325
- );
326
-
327
- signer = internalSigner;
328
- verifier = internalSigner; // Use the same signer as verifier
329
- updateKeys = [`did:key:${keyPair.publicKey}`]; // Use did:key format for authorization
330
- }
331
-
332
- // Create the DID using didwebvh-ts
333
- const result = await createDID({
334
- domain,
335
- signer,
336
- verifier,
337
- updateKeys,
338
- verificationMethods,
339
- context: [
340
- 'https://www.w3.org/ns/did/v1',
341
- 'https://w3id.org/security/multikey/v1'
342
- ],
343
- paths,
344
- portable,
345
- authentication: ['#key-0'],
346
- assertionMethod: ['#key-0'],
347
- });
348
-
349
- // Validate the returned DID document
350
- if (!this.validateDIDDocument(result.doc as unknown as DIDDocument)) {
351
- throw new Error('Invalid DID document returned from createDID');
352
- }
353
-
354
- // Save the log to did.jsonl if output directory is provided
355
- let logPath: string | undefined;
356
- if (outputDir) {
357
- logPath = await this.saveDIDLog(result.did, result.log, outputDir);
358
- }
359
-
360
- return {
361
- did: result.did,
362
- didDocument: result.doc as unknown as DIDDocument,
363
- log: result.log,
364
- keyPair: keyPair || { publicKey: '', privateKey: '' }, // Return empty keypair if using external signer
365
- logPath,
366
- };
367
- }
368
-
369
- /**
370
- * Updates a DID:WebVH document
371
- * @param options - Update options
372
- * @returns Updated DID document and log
373
- */
374
- async updateDIDWebVH(options: {
375
- did: string;
376
- currentLog: DIDLog;
377
- updates: Partial<DIDDocument>;
378
- signer: ExternalSigner | { privateKey: string; publicKey: string };
379
- verifier?: ExternalVerifier;
380
- outputDir?: string;
381
- }): Promise<{ didDocument: DIDDocument; log: DIDLog; logPath?: string }> {
382
- const { did, currentLog, updates, signer: providedSigner, verifier: providedVerifier, outputDir } = options;
383
-
384
- // Dynamically import didwebvh-ts
385
- const mod = await import('didwebvh-ts') as unknown as {
386
- updateDID: (options: Record<string, unknown>) => Promise<{
387
- doc: Record<string, unknown>;
388
- log: DIDLog;
389
- }>;
390
- prepareDataForSigning: (
391
- document: Record<string, unknown>,
392
- proof: Record<string, unknown>
393
- ) => Promise<Uint8Array>;
394
- };
395
- const { updateDID, prepareDataForSigning } = mod;
396
-
397
- if (typeof updateDID !== 'function') {
398
- throw new Error('Failed to load didwebvh-ts: invalid module exports');
399
- }
400
-
401
- let signer: Signer | ExternalSigner;
402
- let verifier: Verifier | ExternalVerifier | undefined;
403
-
404
- // Check if using external signer or internal keypair
405
- if ('sign' in providedSigner && 'getVerificationMethodId' in providedSigner) {
406
- // External signer
407
- signer = providedSigner as ExternalSigner;
408
- verifier = providedVerifier;
409
- } else {
410
- // Internal signer with keypair
411
- const keyPair = providedSigner as { privateKey: string; publicKey: string };
412
- const verificationMethod: WebVHVerificationMethod = {
413
- type: 'Multikey',
414
- publicKeyMultibase: keyPair.publicKey,
415
- };
416
-
417
- const internalSigner = new OriginalsWebVHSigner(
418
- keyPair.privateKey,
419
- verificationMethod,
420
- prepareDataForSigning,
421
- { verificationMethod }
422
- );
423
-
424
- signer = internalSigner;
425
- verifier = internalSigner;
426
- }
427
-
428
- // Get the current document from the log
429
- const currentEntry = currentLog[currentLog.length - 1];
430
- const currentDoc = currentEntry.state as unknown as DIDDocument;
431
-
432
- // Merge updates with current document
433
- const updatedDoc = {
434
- ...currentDoc,
435
- ...updates,
436
- id: did, // Ensure ID doesn't change
437
- };
438
-
439
- // Update the DID using didwebvh-ts
440
- const result = await updateDID({
441
- log: currentLog,
442
- doc: updatedDoc,
443
- signer,
444
- verifier,
445
- });
446
-
447
- // Validate the returned DID document
448
- if (!this.validateDIDDocument(result.doc as unknown as DIDDocument)) {
449
- throw new Error('Invalid DID document returned from updateDID');
450
- }
451
-
452
- // Save the updated log if output directory is provided
453
- let logPath: string | undefined;
454
- if (outputDir) {
455
- logPath = await this.saveDIDLog(did, result.log, outputDir);
456
- }
457
-
458
- return {
459
- didDocument: result.doc as unknown as DIDDocument,
460
- log: result.log,
461
- logPath,
462
- };
463
- }
464
-
465
- /**
466
- * Saves the DID log to the appropriate did.jsonl path
467
- * @param did - The DID identifier
468
- * @param log - The DID log to save
469
- * @param baseDir - Base directory for saving (e.g., public/.well-known)
470
- * @returns The full path where the log was saved
471
- */
472
- async saveDIDLog(did: string, log: DIDLog, baseDir: string): Promise<string> {
473
- // Parse the DID to extract domain and path components
474
- // Format: did:webvh:domain[:port]:path1:path2...
475
- const didParts = did.split(':');
476
- if (didParts.length < 3 || didParts[0] !== 'did' || didParts[1] !== 'webvh') {
477
- throw new Error('Invalid did:webvh format');
478
- }
479
-
480
- // Extract path parts (everything after domain)
481
- const pathParts = didParts.slice(3);
482
-
483
- // Validate all path segments to prevent directory traversal
484
- for (const segment of pathParts) {
485
- if (!this.isValidPathSegment(segment)) {
486
- throw new Error(`Invalid path segment in DID: "${segment}". Path segments cannot contain '.', '..', path separators, or be absolute paths.`);
487
- }
488
- }
489
-
490
- // Extract and sanitize domain for filesystem safety
491
- const rawDomain = decodeURIComponent(didParts[2]);
492
- // Normalize: lowercase and replace any characters not in [a-z0-9._-] with '_'
493
- const safeDomain = rawDomain
494
- .toLowerCase()
495
- .replace(/[^a-z0-9._-]/g, '_');
496
-
497
- // Validate the sanitized domain (reject '..' and other dangerous patterns)
498
- if (!this.isValidPathSegment(safeDomain)) {
499
- throw new Error(`Invalid domain segment in DID: "${rawDomain}"`);
500
- }
501
-
502
- // Construct the file path with domain isolation
503
- // For did:webvh:example.com:user:alice -> baseDir/did/example.com/user/alice/did.jsonl
504
- // For did:webvh:example.com:alice -> baseDir/did/example.com/alice/did.jsonl
505
- const segments = [safeDomain, ...pathParts];
506
- const didPath = path.join(baseDir, 'did', ...segments, 'did.jsonl');
507
-
508
- // Verify the resolved path is still within baseDir (defense in depth)
509
- const resolvedBaseDir = path.resolve(baseDir);
510
- const resolvedPath = path.resolve(didPath);
511
- const relativePath = path.relative(resolvedBaseDir, resolvedPath);
512
- if (relativePath.startsWith('..') || path.isAbsolute(relativePath)) {
513
- throw new Error('Invalid DID path: resolved path is outside base directory');
514
- }
515
-
516
- // Create directories if they don't exist
517
- const dirPath = path.dirname(didPath);
518
- await fs.promises.mkdir(dirPath, { recursive: true });
519
-
520
- // Convert log to JSONL format (one JSON object per line)
521
- const jsonlContent = log.map((entry: DIDLogEntry) => JSON.stringify(entry)).join('\n');
522
-
523
- // Write the log file
524
- await fs.promises.writeFile(didPath, jsonlContent, 'utf8');
525
-
526
- return didPath;
527
- }
528
-
529
- /**
530
- * Loads a DID log from a did.jsonl file
531
- * @param logPath - Path to the did.jsonl file
532
- * @returns The loaded DID log
533
- */
534
- async loadDIDLog(logPath: string): Promise<DIDLog> {
535
- const content = await fs.promises.readFile(logPath, 'utf8');
536
- const lines = content.trim().split('\n');
537
- return lines.map(line => JSON.parse(line));
538
- }
539
-
540
- /**
541
- * Validates a path segment to prevent directory traversal attacks
542
- * @param segment - Path segment to validate
543
- * @returns true if valid, false otherwise
544
- */
545
- private isValidPathSegment(segment: string): boolean {
546
- // Reject empty segments, dots, or segments with path separators
547
- if (!segment || segment === '.' || segment === '..') {
548
- return false;
549
- }
550
-
551
- // Reject segments containing path separators or other dangerous characters
552
- if (segment.includes('/') || segment.includes('\\') || segment.includes('\0')) {
553
- return false;
554
- }
555
-
556
- // Reject absolute paths (starting with / or drive letter on Windows)
557
- if (path.isAbsolute(segment)) {
558
- return false;
559
- }
560
-
561
- return true;
562
- }
563
- }
564
-
565
- // Type definitions for didwebvh-ts (to avoid module resolution issues)
566
- interface WebVHVerificationMethod {
567
- id?: string;
568
- type: string;
569
- controller?: string;
570
- publicKeyMultibase: string;
571
- secretKeyMultibase?: string;
572
- purpose?: 'authentication' | 'assertionMethod' | 'keyAgreement' | 'capabilityInvocation' | 'capabilityDelegation';
573
- }
574
-
575
- interface SigningInput {
576
- document: Record<string, unknown>;
577
- proof: Record<string, unknown>;
578
- }
579
-
580
- interface SigningOutput {
581
- proofValue: string;
582
- }
583
-
584
- interface SignerOptions {
585
- verificationMethod?: WebVHVerificationMethod | null;
586
- useStaticId?: boolean;
587
- }
588
-
589
- interface Signer {
590
- sign(input: SigningInput): Promise<SigningOutput>;
591
- getVerificationMethodId(): string;
592
- }
593
-
594
- interface Verifier {
595
- verify(signature: Uint8Array, message: Uint8Array, publicKey: Uint8Array): Promise<boolean>;
596
- }
597
-
598
- interface DIDLogEntry {
599
- versionId: string;
600
- versionTime: string;
601
- parameters: Record<string, unknown>;
602
- state: Record<string, unknown>;
603
- proof?: Record<string, unknown>[];
604
- }
605
-
606
- type DIDLog = DIDLogEntry[];
607
-
608
- export interface CreateWebVHOptions {
609
- domain?: string; // Optional - defaults to configured webvhNetwork domain
610
- keyPair?: KeyPair;
611
- paths?: string[];
612
- portable?: boolean;
613
- outputDir?: string;
614
- externalSigner?: ExternalSigner;
615
- externalVerifier?: ExternalVerifier;
616
- verificationMethods?: WebVHVerificationMethod[];
617
- updateKeys?: string[];
618
- }
619
-
620
- export interface CreateWebVHResult {
621
- did: string;
622
- didDocument: DIDDocument;
623
- log: DIDLog;
624
- keyPair: KeyPair;
625
- logPath?: string;
626
- }
627
-
628
- /**
629
- * Adapter to use Originals SDK signers with didwebvh-ts
630
- */
631
- class OriginalsWebVHSigner implements Signer, Verifier {
632
- private privateKeyMultibase: string;
633
- private signer: Ed25519Signer;
634
- protected verificationMethod?: WebVHVerificationMethod | null;
635
- protected useStaticId: boolean;
636
- private prepareDataForSigning: (document: Record<string, unknown>, proof: Record<string, unknown>) => Promise<Uint8Array>;
637
-
638
- constructor(
639
- privateKeyMultibase: string,
640
- verificationMethod: WebVHVerificationMethod,
641
- prepareDataForSigning: (document: Record<string, unknown>, proof: Record<string, unknown>) => Promise<Uint8Array>,
642
- options: SignerOptions = {}
643
- ) {
644
- this.privateKeyMultibase = privateKeyMultibase;
645
- this.verificationMethod = options.verificationMethod || verificationMethod;
646
- this.useStaticId = options.useStaticId || false;
647
- this.signer = new Ed25519Signer();
648
- this.prepareDataForSigning = prepareDataForSigning;
649
- }
650
-
651
- async sign(input: SigningInput): Promise<SigningOutput> {
652
- // Prepare the data for signing using didwebvh-ts's canonical approach
653
- const dataToSign = await this.prepareDataForSigning(input.document, input.proof);
654
-
655
- // Sign using our Ed25519 signer
656
- const signature: Buffer = await this.signer.sign(
657
- Buffer.from(dataToSign),
658
- this.privateKeyMultibase
659
- );
660
-
661
- // Encode signature as multibase
662
- const proofValue = multikey.encodeMultibase(signature);
663
-
664
- return { proofValue };
665
- }
666
-
667
- async verify(signature: Uint8Array, message: Uint8Array, publicKey: Uint8Array): Promise<boolean> {
668
- // Decode the public key to multibase format
669
- const publicKeyMultibase = multikey.encodePublicKey(publicKey, 'Ed25519');
670
-
671
- // Verify using our Ed25519 signer
672
- const messageBuffer: Buffer = Buffer.from(message);
673
- const signatureBuffer: Buffer = Buffer.from(signature);
674
-
675
- return this.signer.verify(
676
- messageBuffer,
677
- signatureBuffer,
678
- publicKeyMultibase
679
- );
680
- }
681
-
682
- getVerificationMethodId(): string {
683
- // didwebvh-ts requires verification method to be a did:key: identifier
684
- // Extract the multibase key from the verification method
685
- const publicKeyMultibase = this.verificationMethod?.publicKeyMultibase;
686
- if (!publicKeyMultibase) {
687
- throw new Error('Verification method must have publicKeyMultibase');
688
- }
689
- // Return as did:key format which didwebvh-ts expects
690
- return `did:key:${publicKeyMultibase}`;
691
- }
692
- }
693
-
694
-