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