@bopen-io/wallet-toolbox 1.7.18
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/.claude/settings.local.json +10 -0
- package/.env.template +22 -0
- package/.github/ISSUE_TEMPLATE/bug_report.md +40 -0
- package/.github/ISSUE_TEMPLATE/discussion.md +24 -0
- package/.github/pull_request_template.md +22 -0
- package/.github/workflows/push.yaml +145 -0
- package/.prettierrc +10 -0
- package/CHANGELOG.md +280 -0
- package/CONTRIBUTING.md +89 -0
- package/README.md +43 -0
- package/docs/README.md +85 -0
- package/docs/client.md +19627 -0
- package/docs/monitor.md +953 -0
- package/docs/open-rpc/index.html +46 -0
- package/docs/services.md +6377 -0
- package/docs/setup.md +1268 -0
- package/docs/storage.md +5367 -0
- package/docs/wallet.md +19626 -0
- package/jest.config.ts +25 -0
- package/license.md +28 -0
- package/out/tsconfig.all.tsbuildinfo +1 -0
- package/package.json +63 -0
- package/src/CWIStyleWalletManager.ts +1999 -0
- package/src/Setup.ts +579 -0
- package/src/SetupClient.ts +322 -0
- package/src/SetupWallet.ts +108 -0
- package/src/SimpleWalletManager.ts +526 -0
- package/src/Wallet.ts +1169 -0
- package/src/WalletAuthenticationManager.ts +153 -0
- package/src/WalletLogger.ts +213 -0
- package/src/WalletPermissionsManager.ts +3660 -0
- package/src/WalletSettingsManager.ts +114 -0
- package/src/__tests/CWIStyleWalletManager.test.d.ts.map +1 -0
- package/src/__tests/CWIStyleWalletManager.test.js.map +1 -0
- package/src/__tests/CWIStyleWalletManager.test.ts +675 -0
- package/src/__tests/WalletPermissionsManager.callbacks.test.ts +323 -0
- package/src/__tests/WalletPermissionsManager.checks.test.ts +844 -0
- package/src/__tests/WalletPermissionsManager.encryption.test.ts +412 -0
- package/src/__tests/WalletPermissionsManager.fixtures.ts +307 -0
- package/src/__tests/WalletPermissionsManager.flows.test.ts +462 -0
- package/src/__tests/WalletPermissionsManager.initialization.test.ts +300 -0
- package/src/__tests/WalletPermissionsManager.pmodules.test.ts +798 -0
- package/src/__tests/WalletPermissionsManager.proxying.test.ts +724 -0
- package/src/__tests/WalletPermissionsManager.tokens.test.ts +503 -0
- package/src/index.all.ts +27 -0
- package/src/index.client.ts +25 -0
- package/src/index.mobile.ts +21 -0
- package/src/index.ts +1 -0
- package/src/monitor/Monitor.ts +412 -0
- package/src/monitor/MonitorDaemon.ts +188 -0
- package/src/monitor/README.md +3 -0
- package/src/monitor/__test/MonitorDaemon.man.test.ts +45 -0
- package/src/monitor/tasks/TaskCheckForProofs.ts +243 -0
- package/src/monitor/tasks/TaskCheckNoSends.ts +73 -0
- package/src/monitor/tasks/TaskClock.ts +33 -0
- package/src/monitor/tasks/TaskFailAbandoned.ts +54 -0
- package/src/monitor/tasks/TaskMonitorCallHistory.ts +26 -0
- package/src/monitor/tasks/TaskNewHeader.ts +93 -0
- package/src/monitor/tasks/TaskPurge.ts +68 -0
- package/src/monitor/tasks/TaskReorg.ts +89 -0
- package/src/monitor/tasks/TaskReviewStatus.ts +48 -0
- package/src/monitor/tasks/TaskSendWaiting.ts +122 -0
- package/src/monitor/tasks/TaskSyncWhenIdle.ts +26 -0
- package/src/monitor/tasks/TaskUnFail.ts +151 -0
- package/src/monitor/tasks/WalletMonitorTask.ts +47 -0
- package/src/sdk/CertOpsWallet.ts +18 -0
- package/src/sdk/PrivilegedKeyManager.ts +372 -0
- package/src/sdk/README.md +13 -0
- package/src/sdk/WERR_errors.ts +234 -0
- package/src/sdk/WalletError.ts +170 -0
- package/src/sdk/WalletErrorFromJson.ts +80 -0
- package/src/sdk/WalletServices.interfaces.ts +700 -0
- package/src/sdk/WalletSigner.interfaces.ts +11 -0
- package/src/sdk/WalletStorage.interfaces.ts +606 -0
- package/src/sdk/__test/CertificateLifeCycle.test.ts +131 -0
- package/src/sdk/__test/PrivilegedKeyManager.test.ts +738 -0
- package/src/sdk/__test/WalletError.test.ts +318 -0
- package/src/sdk/__test/validationHelpers.test.ts +21 -0
- package/src/sdk/index.ts +10 -0
- package/src/sdk/types.ts +226 -0
- package/src/services/README.md +11 -0
- package/src/services/ServiceCollection.ts +248 -0
- package/src/services/Services.ts +603 -0
- package/src/services/__tests/ARC.man.test.ts +123 -0
- package/src/services/__tests/ARC.timeout.man.test.ts +79 -0
- package/src/services/__tests/ArcGorillaPool.man.test.ts +108 -0
- package/src/services/__tests/arcServices.test.ts +8 -0
- package/src/services/__tests/bitrails.test.ts +56 -0
- package/src/services/__tests/getMerklePath.test.ts +15 -0
- package/src/services/__tests/getRawTx.test.ts +13 -0
- package/src/services/__tests/postBeef.test.ts +104 -0
- package/src/services/__tests/verifyBeef.test.ts +50 -0
- package/src/services/chaintracker/BHServiceClient.ts +212 -0
- package/src/services/chaintracker/ChaintracksChainTracker.ts +71 -0
- package/src/services/chaintracker/__tests/ChaintracksChainTracker.test.ts +33 -0
- package/src/services/chaintracker/__tests/ChaintracksServiceClient.test.ts +29 -0
- package/src/services/chaintracker/chaintracks/Api/BlockHeaderApi.ts +72 -0
- package/src/services/chaintracker/chaintracks/Api/BulkIngestorApi.ts +83 -0
- package/src/services/chaintracker/chaintracks/Api/BulkStorageApi.ts +92 -0
- package/src/services/chaintracker/chaintracks/Api/ChaintracksApi.ts +64 -0
- package/src/services/chaintracker/chaintracks/Api/ChaintracksClientApi.ts +189 -0
- package/src/services/chaintracker/chaintracks/Api/ChaintracksFetchApi.ts +18 -0
- package/src/services/chaintracker/chaintracks/Api/ChaintracksFsApi.ts +58 -0
- package/src/services/chaintracker/chaintracks/Api/ChaintracksStorageApi.ts +386 -0
- package/src/services/chaintracker/chaintracks/Api/LiveIngestorApi.ts +25 -0
- package/src/services/chaintracker/chaintracks/Chaintracks.ts +609 -0
- package/src/services/chaintracker/chaintracks/ChaintracksService.ts +199 -0
- package/src/services/chaintracker/chaintracks/ChaintracksServiceClient.ts +154 -0
- package/src/services/chaintracker/chaintracks/Ingest/BulkIngestorBase.ts +176 -0
- package/src/services/chaintracker/chaintracks/Ingest/BulkIngestorCDN.ts +174 -0
- package/src/services/chaintracker/chaintracks/Ingest/BulkIngestorCDNBabbage.ts +18 -0
- package/src/services/chaintracker/chaintracks/Ingest/BulkIngestorWhatsOnChainCdn.ts +113 -0
- package/src/services/chaintracker/chaintracks/Ingest/BulkIngestorWhatsOnChainWs.ts +81 -0
- package/src/services/chaintracker/chaintracks/Ingest/LiveIngestorBase.ts +86 -0
- package/src/services/chaintracker/chaintracks/Ingest/LiveIngestorTeranodeP2P.ts +59 -0
- package/src/services/chaintracker/chaintracks/Ingest/LiveIngestorWhatsOnChainPoll.ts +104 -0
- package/src/services/chaintracker/chaintracks/Ingest/LiveIngestorWhatsOnChainWs.ts +66 -0
- package/src/services/chaintracker/chaintracks/Ingest/WhatsOnChainIngestorWs.ts +566 -0
- package/src/services/chaintracker/chaintracks/Ingest/WhatsOnChainServices.ts +219 -0
- package/src/services/chaintracker/chaintracks/Ingest/__tests/BulkIngestorCDNBabbage.test.ts +54 -0
- package/src/services/chaintracker/chaintracks/Ingest/__tests/LiveIngestorWhatsOnChainPoll.test.ts +33 -0
- package/src/services/chaintracker/chaintracks/Ingest/__tests/WhatsOnChainServices.test.ts +124 -0
- package/src/services/chaintracker/chaintracks/Storage/BulkStorageBase.ts +92 -0
- package/src/services/chaintracker/chaintracks/Storage/ChaintracksKnexMigrations.ts +104 -0
- package/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageBase.ts +382 -0
- package/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageIdb.ts +574 -0
- package/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageKnex.ts +438 -0
- package/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageMemory.ts +29 -0
- package/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageNoDb.ts +304 -0
- package/src/services/chaintracker/chaintracks/Storage/__tests/ChaintracksStorageIdb.test.ts +102 -0
- package/src/services/chaintracker/chaintracks/Storage/__tests/ChaintracksStorageKnex.test.ts +45 -0
- package/src/services/chaintracker/chaintracks/__tests/Chaintracks.test.ts +77 -0
- package/src/services/chaintracker/chaintracks/__tests/ChaintracksClientApi.test.ts +192 -0
- package/src/services/chaintracker/chaintracks/__tests/LocalCdnServer.ts +75 -0
- package/src/services/chaintracker/chaintracks/__tests/createIdbChaintracks.test.ts +62 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest349/mainNetBlockHeaders.json +1 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest349/mainNet_0.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest349/mainNet_1.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest349/mainNet_2.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest349/mainNet_3.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest379/mainNetBlockHeaders.json +1 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest379/mainNet_0.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest379/mainNet_1.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest379/mainNet_2.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest379/mainNet_3.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest399/mainNetBlockHeaders.json +1 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest399/mainNet_0.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest399/mainNet_1.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest399/mainNet_2.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest399/mainNet_3.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNetBlockHeaders.json +1 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNet_0.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNet_1.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNet_2.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNet_3.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNet_4.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNetBlockHeaders.json +1 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNet_0.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNet_1.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNet_2.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNet_3.headers +0 -0
- package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNet_4.headers +0 -0
- package/src/services/chaintracker/chaintracks/createDefaultIdbChaintracksOptions.ts +92 -0
- package/src/services/chaintracker/chaintracks/createDefaultKnexChaintracksOptions.ts +111 -0
- package/src/services/chaintracker/chaintracks/createDefaultNoDbChaintracksOptions.ts +91 -0
- package/src/services/chaintracker/chaintracks/createIdbChaintracks.ts +60 -0
- package/src/services/chaintracker/chaintracks/createKnexChaintracks.ts +65 -0
- package/src/services/chaintracker/chaintracks/createNoDbChaintracks.ts +60 -0
- package/src/services/chaintracker/chaintracks/index.all.ts +12 -0
- package/src/services/chaintracker/chaintracks/index.client.ts +4 -0
- package/src/services/chaintracker/chaintracks/index.mobile.ts +37 -0
- package/src/services/chaintracker/chaintracks/util/BulkFileDataManager.ts +975 -0
- package/src/services/chaintracker/chaintracks/util/BulkFileDataReader.ts +60 -0
- package/src/services/chaintracker/chaintracks/util/BulkFilesReader.ts +336 -0
- package/src/services/chaintracker/chaintracks/util/BulkHeaderFile.ts +247 -0
- package/src/services/chaintracker/chaintracks/util/ChaintracksFetch.ts +69 -0
- package/src/services/chaintracker/chaintracks/util/ChaintracksFs.ts +141 -0
- package/src/services/chaintracker/chaintracks/util/HeightRange.ts +153 -0
- package/src/services/chaintracker/chaintracks/util/SingleWriterMultiReaderLock.ts +76 -0
- package/src/services/chaintracker/chaintracks/util/__tests/BulkFileDataManager.test.ts +304 -0
- package/src/services/chaintracker/chaintracks/util/__tests/ChaintracksFetch.test.ts +60 -0
- package/src/services/chaintracker/chaintracks/util/__tests/HeightRange.test.ts +67 -0
- package/src/services/chaintracker/chaintracks/util/__tests/SingleWriterMultiReaderLock.test.ts +49 -0
- package/src/services/chaintracker/chaintracks/util/blockHeaderUtilities.ts +573 -0
- package/src/services/chaintracker/chaintracks/util/dirtyHashes.ts +29 -0
- package/src/services/chaintracker/chaintracks/util/validBulkHeaderFilesByFileHash.ts +432 -0
- package/src/services/chaintracker/index.all.ts +4 -0
- package/src/services/chaintracker/index.client.ts +4 -0
- package/src/services/chaintracker/index.mobile.ts +4 -0
- package/src/services/createDefaultWalletServicesOptions.ts +77 -0
- package/src/services/index.ts +1 -0
- package/src/services/processingErrors/arcSuccessError.json +76 -0
- package/src/services/providers/ARC.ts +350 -0
- package/src/services/providers/Bitails.ts +256 -0
- package/src/services/providers/SdkWhatsOnChain.ts +83 -0
- package/src/services/providers/WhatsOnChain.ts +883 -0
- package/src/services/providers/__tests/WhatsOnChain.test.ts +242 -0
- package/src/services/providers/__tests/exchangeRates.test.ts +18 -0
- package/src/services/providers/exchangeRates.ts +265 -0
- package/src/services/providers/getBeefForTxid.ts +369 -0
- package/src/signer/README.md +5 -0
- package/src/signer/WalletSigner.ts +17 -0
- package/src/signer/methods/acquireDirectCertificate.ts +52 -0
- package/src/signer/methods/buildSignableTransaction.ts +183 -0
- package/src/signer/methods/completeSignedTransaction.ts +117 -0
- package/src/signer/methods/createAction.ts +172 -0
- package/src/signer/methods/internalizeAction.ts +106 -0
- package/src/signer/methods/proveCertificate.ts +43 -0
- package/src/signer/methods/signAction.ts +54 -0
- package/src/storage/README.md +14 -0
- package/src/storage/StorageIdb.ts +2304 -0
- package/src/storage/StorageKnex.ts +1425 -0
- package/src/storage/StorageProvider.ts +810 -0
- package/src/storage/StorageReader.ts +194 -0
- package/src/storage/StorageReaderWriter.ts +432 -0
- package/src/storage/StorageSyncReader.ts +34 -0
- package/src/storage/WalletStorageManager.ts +943 -0
- package/src/storage/__test/StorageIdb.test.ts +43 -0
- package/src/storage/__test/WalletStorageManager.test.ts +275 -0
- package/src/storage/__test/adminStats.man.test.ts +89 -0
- package/src/storage/__test/getBeefForTransaction.test.ts +385 -0
- package/src/storage/index.all.ts +11 -0
- package/src/storage/index.client.ts +7 -0
- package/src/storage/index.mobile.ts +6 -0
- package/src/storage/methods/ListActionsSpecOp.ts +70 -0
- package/src/storage/methods/ListOutputsSpecOp.ts +129 -0
- package/src/storage/methods/__test/GenerateChange/generateChangeSdk.test.ts +1057 -0
- package/src/storage/methods/__test/GenerateChange/randomValsUsed1.ts +20 -0
- package/src/storage/methods/__test/offsetKey.test.ts +274 -0
- package/src/storage/methods/attemptToPostReqsToNetwork.ts +389 -0
- package/src/storage/methods/createAction.ts +947 -0
- package/src/storage/methods/generateChange.ts +556 -0
- package/src/storage/methods/getBeefForTransaction.ts +139 -0
- package/src/storage/methods/getSyncChunk.ts +293 -0
- package/src/storage/methods/internalizeAction.ts +562 -0
- package/src/storage/methods/listActionsIdb.ts +183 -0
- package/src/storage/methods/listActionsKnex.ts +226 -0
- package/src/storage/methods/listCertificates.ts +73 -0
- package/src/storage/methods/listOutputsIdb.ts +203 -0
- package/src/storage/methods/listOutputsKnex.ts +263 -0
- package/src/storage/methods/offsetKey.ts +89 -0
- package/src/storage/methods/processAction.ts +420 -0
- package/src/storage/methods/purgeData.ts +251 -0
- package/src/storage/methods/purgeDataIdb.ts +10 -0
- package/src/storage/methods/reviewStatus.ts +101 -0
- package/src/storage/methods/reviewStatusIdb.ts +43 -0
- package/src/storage/methods/utils.Buffer.ts +33 -0
- package/src/storage/methods/utils.ts +56 -0
- package/src/storage/remoting/StorageClient.ts +567 -0
- package/src/storage/remoting/StorageMobile.ts +544 -0
- package/src/storage/remoting/StorageServer.ts +291 -0
- package/src/storage/remoting/__test/StorageClient.test.ts +113 -0
- package/src/storage/schema/KnexMigrations.ts +489 -0
- package/src/storage/schema/StorageIdbSchema.ts +150 -0
- package/src/storage/schema/entities/EntityBase.ts +210 -0
- package/src/storage/schema/entities/EntityCertificate.ts +188 -0
- package/src/storage/schema/entities/EntityCertificateField.ts +136 -0
- package/src/storage/schema/entities/EntityCommission.ts +148 -0
- package/src/storage/schema/entities/EntityOutput.ts +290 -0
- package/src/storage/schema/entities/EntityOutputBasket.ts +153 -0
- package/src/storage/schema/entities/EntityOutputTag.ts +121 -0
- package/src/storage/schema/entities/EntityOutputTagMap.ts +123 -0
- package/src/storage/schema/entities/EntityProvenTx.ts +319 -0
- package/src/storage/schema/entities/EntityProvenTxReq.ts +580 -0
- package/src/storage/schema/entities/EntitySyncState.ts +389 -0
- package/src/storage/schema/entities/EntityTransaction.ts +306 -0
- package/src/storage/schema/entities/EntityTxLabel.ts +121 -0
- package/src/storage/schema/entities/EntityTxLabelMap.ts +123 -0
- package/src/storage/schema/entities/EntityUser.ts +112 -0
- package/src/storage/schema/entities/MergeEntity.ts +73 -0
- package/src/storage/schema/entities/__tests/CertificateFieldTests.test.ts +353 -0
- package/src/storage/schema/entities/__tests/CertificateTests.test.ts +354 -0
- package/src/storage/schema/entities/__tests/CommissionTests.test.ts +371 -0
- package/src/storage/schema/entities/__tests/OutputBasketTests.test.ts +278 -0
- package/src/storage/schema/entities/__tests/OutputTagMapTests.test.ts +242 -0
- package/src/storage/schema/entities/__tests/OutputTagTests.test.ts +288 -0
- package/src/storage/schema/entities/__tests/OutputTests.test.ts +464 -0
- package/src/storage/schema/entities/__tests/ProvenTxReqTests.test.ts +340 -0
- package/src/storage/schema/entities/__tests/ProvenTxTests.test.ts +504 -0
- package/src/storage/schema/entities/__tests/SyncStateTests.test.ts +288 -0
- package/src/storage/schema/entities/__tests/TransactionTests.test.ts +604 -0
- package/src/storage/schema/entities/__tests/TxLabelMapTests.test.ts +361 -0
- package/src/storage/schema/entities/__tests/TxLabelTests.test.ts +198 -0
- package/src/storage/schema/entities/__tests/stampLogTests.test.ts +90 -0
- package/src/storage/schema/entities/__tests/usersTests.test.ts +340 -0
- package/src/storage/schema/entities/index.ts +16 -0
- package/src/storage/schema/tables/TableCertificate.ts +21 -0
- package/src/storage/schema/tables/TableCertificateField.ts +12 -0
- package/src/storage/schema/tables/TableCommission.ts +13 -0
- package/src/storage/schema/tables/TableMonitorEvent.ts +9 -0
- package/src/storage/schema/tables/TableOutput.ts +64 -0
- package/src/storage/schema/tables/TableOutputBasket.ts +12 -0
- package/src/storage/schema/tables/TableOutputTag.ts +10 -0
- package/src/storage/schema/tables/TableOutputTagMap.ts +9 -0
- package/src/storage/schema/tables/TableProvenTx.ts +14 -0
- package/src/storage/schema/tables/TableProvenTxReq.ts +65 -0
- package/src/storage/schema/tables/TableSettings.ts +17 -0
- package/src/storage/schema/tables/TableSyncState.ts +18 -0
- package/src/storage/schema/tables/TableTransaction.ts +54 -0
- package/src/storage/schema/tables/TableTxLabel.ts +10 -0
- package/src/storage/schema/tables/TableTxLabelMap.ts +9 -0
- package/src/storage/schema/tables/TableUser.ts +16 -0
- package/src/storage/schema/tables/index.ts +16 -0
- package/src/storage/sync/StorageMySQLDojoReader.ts +696 -0
- package/src/storage/sync/index.ts +1 -0
- package/src/utility/Format.ts +133 -0
- package/src/utility/README.md +3 -0
- package/src/utility/ReaderUint8Array.ts +187 -0
- package/src/utility/ScriptTemplateBRC29.ts +73 -0
- package/src/utility/__tests/utilityHelpers.noBuffer.test.ts +109 -0
- package/src/utility/aggregateResults.ts +68 -0
- package/src/utility/identityUtils.ts +159 -0
- package/src/utility/index.all.ts +7 -0
- package/src/utility/index.client.ts +7 -0
- package/src/utility/parseTxScriptOffsets.ts +29 -0
- package/src/utility/stampLog.ts +69 -0
- package/src/utility/tscProofToMerklePath.ts +48 -0
- package/src/utility/utilityHelpers.buffer.ts +34 -0
- package/src/utility/utilityHelpers.noBuffer.ts +60 -0
- package/src/utility/utilityHelpers.ts +275 -0
- package/src/wab-client/WABClient.ts +94 -0
- package/src/wab-client/__tests/WABClient.man.test.ts +59 -0
- package/src/wab-client/auth-method-interactors/AuthMethodInteractor.ts +47 -0
- package/src/wab-client/auth-method-interactors/DevConsoleInteractor.ts +73 -0
- package/src/wab-client/auth-method-interactors/PersonaIDInteractor.ts +35 -0
- package/src/wab-client/auth-method-interactors/TwilioPhoneInteractor.ts +72 -0
- package/syncVersions.js +71 -0
- package/test/Wallet/StorageClient/storageClient.man.test.ts +75 -0
- package/test/Wallet/action/abortAction.test.ts +47 -0
- package/test/Wallet/action/createAction.test.ts +299 -0
- package/test/Wallet/action/createAction2.test.ts +1273 -0
- package/test/Wallet/action/createActionToGenerateBeefs.man.test.ts +293 -0
- package/test/Wallet/action/internalizeAction.a.test.ts +286 -0
- package/test/Wallet/action/internalizeAction.test.ts +682 -0
- package/test/Wallet/action/relinquishOutput.test.ts +37 -0
- package/test/Wallet/certificate/acquireCertificate.test.ts +298 -0
- package/test/Wallet/certificate/listCertificates.test.ts +346 -0
- package/test/Wallet/construct/Wallet.constructor.test.ts +57 -0
- package/test/Wallet/get/getHeaderForHeight.test.ts +82 -0
- package/test/Wallet/get/getHeight.test.ts +52 -0
- package/test/Wallet/get/getKnownTxids.test.ts +86 -0
- package/test/Wallet/get/getNetwork.test.ts +27 -0
- package/test/Wallet/get/getVersion.test.ts +27 -0
- package/test/Wallet/list/listActions.test.ts +279 -0
- package/test/Wallet/list/listActions2.test.ts +1381 -0
- package/test/Wallet/list/listCertificates.test.ts +118 -0
- package/test/Wallet/list/listOutputs.test.ts +447 -0
- package/test/Wallet/live/walletLive.man.test.ts +521 -0
- package/test/Wallet/local/localWallet.man.test.ts +93 -0
- package/test/Wallet/local/localWallet2.man.test.ts +277 -0
- package/test/Wallet/signAction/mountaintop.man.test.ts +130 -0
- package/test/Wallet/specOps/specOps.man.test.ts +220 -0
- package/test/Wallet/support/janitor.man.test.ts +40 -0
- package/test/Wallet/support/operations.man.test.ts +407 -0
- package/test/Wallet/support/reqErrorReview.2025.05.06.man.test.ts +347 -0
- package/test/Wallet/sync/Wallet.sync.test.ts +215 -0
- package/test/Wallet/sync/Wallet.updateWalletLegacyTestData.man.test.ts +203 -0
- package/test/Wallet/sync/setActive.test.ts +170 -0
- package/test/WalletClient/LocalKVStore.man.test.ts +114 -0
- package/test/WalletClient/WERR.man.test.ts +35 -0
- package/test/bsv-ts-sdk/LocalKVStore.test.ts +102 -0
- package/test/checkDB.ts +57 -0
- package/test/checkdb +0 -0
- package/test/examples/backup.man.test.ts +59 -0
- package/test/examples/pushdrop.test.ts +282 -0
- package/test/monitor/Monitor.test.ts +620 -0
- package/test/services/Services.test.ts +263 -0
- package/test/storage/KnexMigrations.test.ts +86 -0
- package/test/storage/StorageMySQLDojoReader.man.test.ts +60 -0
- package/test/storage/count.test.ts +177 -0
- package/test/storage/find.test.ts +195 -0
- package/test/storage/findLegacy.test.ts +67 -0
- package/test/storage/idb/allocateChange.test.ts +251 -0
- package/test/storage/idb/count.test.ts +158 -0
- package/test/storage/idb/find.test.ts +177 -0
- package/test/storage/idb/idbSpeed.test.ts +36 -0
- package/test/storage/idb/insert.test.ts +268 -0
- package/test/storage/idb/transactionAbort.test.ts +108 -0
- package/test/storage/idb/update.test.ts +999 -0
- package/test/storage/insert.test.ts +278 -0
- package/test/storage/update.test.ts +1021 -0
- package/test/storage/update2.test.ts +897 -0
- package/test/utils/TestUtilsWalletStorage.ts +2526 -0
- package/test/utils/localWalletMethods.ts +363 -0
- package/test/utils/removeFailedFromDatabase.sql +17 -0
- package/ts2md.json +44 -0
- package/tsconfig.all.json +31 -0
- package/tsconfig.client.json +29 -0
- package/tsconfig.json +17 -0
- package/tsconfig.mobile.json +28 -0
|
@@ -0,0 +1,263 @@
|
|
|
1
|
+
import { Beef, ListOutputsResult, OriginatorDomainNameStringUnder250Bytes, WalletOutput, Validation } from '@bsv/sdk'
|
|
2
|
+
import { StorageKnex } from '../StorageKnex'
|
|
3
|
+
import { getBasketToSpecOp, ListOutputsSpecOp } from './ListOutputsSpecOp'
|
|
4
|
+
import { AuthId, TrxToken } from '../../sdk/WalletStorage.interfaces'
|
|
5
|
+
import { verifyId, verifyOne } from '../../utility/utilityHelpers'
|
|
6
|
+
import { TableOutputBasket } from '../schema/tables/TableOutputBasket'
|
|
7
|
+
import { TableOutputTag } from '../schema/tables/TableOutputTag'
|
|
8
|
+
import { TableOutput } from '../schema/tables/TableOutput'
|
|
9
|
+
import { asString } from '../../utility/utilityHelpers.noBuffer'
|
|
10
|
+
|
|
11
|
+
export async function listOutputs(
|
|
12
|
+
dsk: StorageKnex,
|
|
13
|
+
auth: AuthId,
|
|
14
|
+
vargs: Validation.ValidListOutputsArgs,
|
|
15
|
+
originator?: OriginatorDomainNameStringUnder250Bytes
|
|
16
|
+
): Promise<ListOutputsResult> {
|
|
17
|
+
const trx: TrxToken | undefined = undefined
|
|
18
|
+
const userId = verifyId(auth.userId)
|
|
19
|
+
const limit = vargs.limit
|
|
20
|
+
let offset = vargs.offset
|
|
21
|
+
let orderBy: 'asc' | 'desc' = 'asc'
|
|
22
|
+
if (offset < 0) {
|
|
23
|
+
offset = -offset - 1
|
|
24
|
+
orderBy = 'desc'
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
const k = dsk.toDb(trx)
|
|
28
|
+
|
|
29
|
+
const r: ListOutputsResult = {
|
|
30
|
+
totalOutputs: 0,
|
|
31
|
+
outputs: []
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/*
|
|
35
|
+
ValidListOutputsArgs {
|
|
36
|
+
basket: BasketStringUnder300Bytes
|
|
37
|
+
|
|
38
|
+
tags: OutputTagStringUnder300Bytes[]
|
|
39
|
+
tagQueryMode: 'all' | 'any' // default any
|
|
40
|
+
|
|
41
|
+
limit: PositiveIntegerDefault10Max10000 // default 10
|
|
42
|
+
offset: number // default 0
|
|
43
|
+
}
|
|
44
|
+
*/
|
|
45
|
+
|
|
46
|
+
let specOp: ListOutputsSpecOp | undefined = undefined
|
|
47
|
+
let basketId: number | undefined = undefined
|
|
48
|
+
const basketsById: Record<number, TableOutputBasket> = {}
|
|
49
|
+
if (vargs.basket) {
|
|
50
|
+
let b = vargs.basket
|
|
51
|
+
specOp = getBasketToSpecOp()[b]
|
|
52
|
+
b = specOp ? (specOp.useBasket ? specOp.useBasket : '') : b
|
|
53
|
+
if (b) {
|
|
54
|
+
const baskets = await dsk.findOutputBaskets({
|
|
55
|
+
partial: { userId, name: b },
|
|
56
|
+
trx
|
|
57
|
+
})
|
|
58
|
+
if (baskets.length !== 1) {
|
|
59
|
+
// If basket does not exist, result is no outputs.
|
|
60
|
+
return r
|
|
61
|
+
}
|
|
62
|
+
const basket = baskets[0]
|
|
63
|
+
basketId = basket.basketId!
|
|
64
|
+
basketsById[basketId!] = basket
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
let tagIds: number[] = []
|
|
69
|
+
let tags = [...vargs.tags]
|
|
70
|
+
const specOpTags: string[] = []
|
|
71
|
+
if (specOp && specOp.tagsParamsCount) {
|
|
72
|
+
specOpTags.push(...tags.splice(0, Math.min(tags.length, specOp.tagsParamsCount)))
|
|
73
|
+
}
|
|
74
|
+
if (specOp && specOp.tagsToIntercept) {
|
|
75
|
+
// Pull out tags used by current specOp
|
|
76
|
+
const ts = tags
|
|
77
|
+
tags = []
|
|
78
|
+
for (const t of ts) {
|
|
79
|
+
if (specOp.tagsToIntercept.length === 0 || specOp.tagsToIntercept.indexOf(t) >= 0) {
|
|
80
|
+
specOpTags.push(t)
|
|
81
|
+
if (t === 'all') {
|
|
82
|
+
basketId = undefined
|
|
83
|
+
}
|
|
84
|
+
} else {
|
|
85
|
+
tags.push(t)
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
if (specOp && specOp.resultFromTags) {
|
|
91
|
+
const r = await specOp.resultFromTags(dsk, auth, vargs, specOpTags)
|
|
92
|
+
return r
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
if (tags && tags.length > 0) {
|
|
96
|
+
const q = k<TableOutputTag>('output_tags')
|
|
97
|
+
.where({
|
|
98
|
+
userId: userId,
|
|
99
|
+
isDeleted: false
|
|
100
|
+
})
|
|
101
|
+
.whereNotNull('outputTagId')
|
|
102
|
+
.whereIn('tag', tags)
|
|
103
|
+
.select('outputTagId')
|
|
104
|
+
const r = await q
|
|
105
|
+
tagIds = r.map(r => r.outputTagId!)
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
const isQueryModeAll = vargs.tagQueryMode === 'all'
|
|
109
|
+
if (isQueryModeAll && tagIds.length < tags.length)
|
|
110
|
+
// all the required tags don't exist, impossible to satisfy.
|
|
111
|
+
return r
|
|
112
|
+
|
|
113
|
+
if (!isQueryModeAll && tagIds.length === 0 && tags.length > 0)
|
|
114
|
+
// any and only non-existing labels, impossible to satisfy.
|
|
115
|
+
return r
|
|
116
|
+
|
|
117
|
+
const columns: string[] = [
|
|
118
|
+
'outputId',
|
|
119
|
+
'transactionId',
|
|
120
|
+
'basketId',
|
|
121
|
+
'spendable',
|
|
122
|
+
'txid',
|
|
123
|
+
'vout',
|
|
124
|
+
'satoshis',
|
|
125
|
+
'lockingScript',
|
|
126
|
+
'customInstructions',
|
|
127
|
+
'outputDescription',
|
|
128
|
+
'spendingDescription',
|
|
129
|
+
'scriptLength',
|
|
130
|
+
'scriptOffset'
|
|
131
|
+
]
|
|
132
|
+
|
|
133
|
+
const noTags = tagIds.length === 0
|
|
134
|
+
const includeSpent = specOp && specOp.includeSpent ? specOp.includeSpent : false
|
|
135
|
+
|
|
136
|
+
const txStatusOk = `(select status as tstatus from transactions where transactions.transactionId = outputs.transactionId) in ('completed', 'unproven', 'nosend', 'sending')`
|
|
137
|
+
const txStatusOkCteq = `(select status as tstatus from transactions where transactions.transactionId = o.transactionId) in ('completed', 'unproven', 'nosend', 'sending')`
|
|
138
|
+
|
|
139
|
+
const makeWithTagsQueries = () => {
|
|
140
|
+
let cteqOptions = ''
|
|
141
|
+
if (basketId) cteqOptions += ` AND o.basketId = ${basketId}`
|
|
142
|
+
if (!includeSpent) cteqOptions += ` AND o.spendable`
|
|
143
|
+
const cteq = k.raw(`
|
|
144
|
+
SELECT ${columns.map(c => 'o.' + c).join(',')},
|
|
145
|
+
(SELECT COUNT(*)
|
|
146
|
+
FROM output_tags_map AS m
|
|
147
|
+
WHERE m.OutputId = o.OutputId
|
|
148
|
+
AND m.outputTagId IN (${tagIds.join(',')})
|
|
149
|
+
) AS tc
|
|
150
|
+
FROM outputs AS o
|
|
151
|
+
WHERE o.userId = ${userId} ${cteqOptions} AND ${txStatusOkCteq}
|
|
152
|
+
`)
|
|
153
|
+
|
|
154
|
+
const q = k.with('otc', cteq)
|
|
155
|
+
q.from('otc')
|
|
156
|
+
if (isQueryModeAll) q.where('tc', tagIds.length)
|
|
157
|
+
else q.where('tc', '>', 0)
|
|
158
|
+
const qcount = q.clone()
|
|
159
|
+
q.select(columns)
|
|
160
|
+
qcount.count('outputId as total')
|
|
161
|
+
return { q, qcount }
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
const makeWithoutTagsQueries = () => {
|
|
165
|
+
const where: Partial<TableOutput> = { userId }
|
|
166
|
+
if (basketId) where.basketId = basketId
|
|
167
|
+
if (!includeSpent) where.spendable = true
|
|
168
|
+
const q = k('outputs').where(where).whereRaw(txStatusOk)
|
|
169
|
+
const qcount = q.clone().count('outputId as total')
|
|
170
|
+
return { q, qcount }
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
const { q, qcount } = noTags ? makeWithoutTagsQueries() : makeWithTagsQueries()
|
|
174
|
+
|
|
175
|
+
// Sort order when limit and offset are possible must be ascending for determinism.
|
|
176
|
+
if (!specOp || !specOp.ignoreLimit) q.limit(limit).offset(offset)
|
|
177
|
+
|
|
178
|
+
q.orderBy('outputId', orderBy)
|
|
179
|
+
|
|
180
|
+
let outputs: TableOutput[] = await q
|
|
181
|
+
|
|
182
|
+
if (specOp) {
|
|
183
|
+
if (specOp.filterOutputs) outputs = await specOp.filterOutputs(dsk, auth, vargs, specOpTags, outputs)
|
|
184
|
+
if (specOp.resultFromOutputs) {
|
|
185
|
+
const r = await specOp.resultFromOutputs(dsk, auth, vargs, specOpTags, outputs)
|
|
186
|
+
return r
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
if (!limit || outputs.length < limit) r.totalOutputs = outputs.length
|
|
191
|
+
else {
|
|
192
|
+
const total = verifyOne(await qcount)['total']
|
|
193
|
+
r.totalOutputs = Number(total)
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
/*
|
|
197
|
+
ListOutputsArgs {
|
|
198
|
+
include?: 'locking scripts' | 'entire transactions'
|
|
199
|
+
includeCustomInstructions?: BooleanDefaultFalse
|
|
200
|
+
includeTags?: BooleanDefaultFalse
|
|
201
|
+
includeLabels?: BooleanDefaultFalse
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
ListOutputsResult {
|
|
205
|
+
totalOutputs: PositiveIntegerOrZero
|
|
206
|
+
BEEF?: BEEF
|
|
207
|
+
outputs: Array<WalletOutput>
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
WalletOutput {
|
|
211
|
+
satoshis: SatoshiValue
|
|
212
|
+
spendable: boolean
|
|
213
|
+
outpoint: OutpointString
|
|
214
|
+
|
|
215
|
+
customInstructions?: string
|
|
216
|
+
lockingScript?: HexString
|
|
217
|
+
tags?: OutputTagStringUnder300Bytes[]
|
|
218
|
+
labels?: LabelStringUnder300Bytes[]
|
|
219
|
+
}
|
|
220
|
+
*/
|
|
221
|
+
|
|
222
|
+
const labelsByTxid: Record<string, string[]> = {}
|
|
223
|
+
|
|
224
|
+
const beef = new Beef()
|
|
225
|
+
|
|
226
|
+
for (const o of outputs) {
|
|
227
|
+
const wo: WalletOutput = {
|
|
228
|
+
satoshis: Number(o.satoshis),
|
|
229
|
+
spendable: !!o.spendable,
|
|
230
|
+
outpoint: `${o.txid}.${o.vout}`
|
|
231
|
+
}
|
|
232
|
+
r.outputs.push(wo)
|
|
233
|
+
//if (vargs.includeBasket && o.basketId) {
|
|
234
|
+
// if (!basketsById[o.basketId]) {
|
|
235
|
+
// basketsById[o.basketId] = verifyTruthy(await dsk.findOutputBasketId(o.basketId!, trx))
|
|
236
|
+
// }
|
|
237
|
+
// wo.basket = basketsById[o.basketId].name
|
|
238
|
+
//}
|
|
239
|
+
if (vargs.includeCustomInstructions && o.customInstructions) wo.customInstructions = o.customInstructions
|
|
240
|
+
if (vargs.includeLabels && o.txid) {
|
|
241
|
+
if (labelsByTxid[o.txid] === undefined) {
|
|
242
|
+
labelsByTxid[o.txid] = (await dsk.getLabelsForTransactionId(o.transactionId, trx)).map(l => l.label)
|
|
243
|
+
}
|
|
244
|
+
wo.labels = labelsByTxid[o.txid]
|
|
245
|
+
}
|
|
246
|
+
if (vargs.includeTags) {
|
|
247
|
+
wo.tags = (await dsk.getTagsForOutputId(o.outputId, trx)).map(t => t.tag)
|
|
248
|
+
}
|
|
249
|
+
if (vargs.includeLockingScripts) {
|
|
250
|
+
await dsk.validateOutputScript(o, trx)
|
|
251
|
+
if (o.lockingScript) wo.lockingScript = asString(o.lockingScript)
|
|
252
|
+
}
|
|
253
|
+
if (vargs.includeTransactions && !beef.findTxid(o.txid!)) {
|
|
254
|
+
await dsk.getValidBeefForKnownTxid(o.txid!, beef, undefined, vargs.knownTxids, trx)
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
if (vargs.includeTransactions) {
|
|
259
|
+
r.BEEF = beef.toBinary()
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
return r
|
|
263
|
+
}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { PublicKey, BigNumber, PrivateKey, Curve, P2PKH, PubKeyHex, CreateActionInput } from '@bsv/sdk'
|
|
2
|
+
import { TableCommission } from '../schema/tables/TableCommission'
|
|
3
|
+
import { sha256Hash } from '../../utility/utilityHelpers'
|
|
4
|
+
|
|
5
|
+
export function keyOffsetToHashedSecret(
|
|
6
|
+
pub: PublicKey,
|
|
7
|
+
keyOffset?: string
|
|
8
|
+
): { hashedSecret: BigNumber; keyOffset: string } {
|
|
9
|
+
let offset: PrivateKey
|
|
10
|
+
if (keyOffset !== undefined && typeof keyOffset === 'string') {
|
|
11
|
+
if (keyOffset.length === 64) offset = PrivateKey.fromString(keyOffset, 'hex')
|
|
12
|
+
else offset = PrivateKey.fromWif(keyOffset)
|
|
13
|
+
} else {
|
|
14
|
+
offset = PrivateKey.fromRandom()
|
|
15
|
+
keyOffset = offset.toWif()
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
const sharedSecret = pub.mul(offset).encode(true, undefined) as number[]
|
|
19
|
+
const hashedSecret = sha256Hash(sharedSecret)
|
|
20
|
+
|
|
21
|
+
return { hashedSecret: new BigNumber(hashedSecret), keyOffset }
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export function offsetPrivKey(privKey: string, keyOffset?: string): { offsetPrivKey: string; keyOffset: string } {
|
|
25
|
+
const priv = PrivateKey.fromWif(privKey)
|
|
26
|
+
|
|
27
|
+
const pub = priv.toPublicKey()
|
|
28
|
+
|
|
29
|
+
const r = keyOffsetToHashedSecret(pub, keyOffset)
|
|
30
|
+
|
|
31
|
+
const bn = priv.add(r.hashedSecret).mod(new Curve().n)
|
|
32
|
+
|
|
33
|
+
const offsetPrivKey = new PrivateKey(bn).toWif()
|
|
34
|
+
|
|
35
|
+
return { offsetPrivKey, keyOffset: r.keyOffset }
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
export function offsetPubKey(pubKey: string, keyOffset?: string): { offsetPubKey: string; keyOffset: string } {
|
|
39
|
+
const pub = PublicKey.fromString(pubKey)
|
|
40
|
+
|
|
41
|
+
const r = keyOffsetToHashedSecret(pub, keyOffset)
|
|
42
|
+
|
|
43
|
+
// The hashed secret is multiplied by the generator point.
|
|
44
|
+
const point = new Curve().g.mul(r.hashedSecret)
|
|
45
|
+
|
|
46
|
+
// The resulting point is added to the recipient public key.
|
|
47
|
+
const offsetPubKey = new PublicKey(pub.add(point))
|
|
48
|
+
|
|
49
|
+
return { offsetPubKey: offsetPubKey.toString(), keyOffset: r.keyOffset }
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export function lockScriptWithKeyOffsetFromPubKey(
|
|
53
|
+
pubKey: string,
|
|
54
|
+
keyOffset?: string
|
|
55
|
+
): { script: string; keyOffset: string } {
|
|
56
|
+
const r = offsetPubKey(pubKey, keyOffset)
|
|
57
|
+
|
|
58
|
+
const offsetPub = PublicKey.fromString(r.offsetPubKey)
|
|
59
|
+
|
|
60
|
+
const hash = offsetPub.toHash() as number[]
|
|
61
|
+
|
|
62
|
+
const script = new P2PKH().lock(hash).toHex()
|
|
63
|
+
|
|
64
|
+
return { script, keyOffset: r.keyOffset }
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
export function createStorageServiceChargeScript(pubKeyHex: PubKeyHex): {
|
|
68
|
+
script: string
|
|
69
|
+
keyOffset: string
|
|
70
|
+
} {
|
|
71
|
+
return lockScriptWithKeyOffsetFromPubKey(pubKeyHex)
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export function redeemServiceCharges(privateKeyWif: string, charges: TableCommission[]): {}[] {
|
|
75
|
+
const priv = PrivateKey.fromWif(privateKeyWif)
|
|
76
|
+
const pub = priv.toPublicKey()
|
|
77
|
+
const p2pkh = new P2PKH()
|
|
78
|
+
|
|
79
|
+
const inputs: CreateActionInput[] = []
|
|
80
|
+
|
|
81
|
+
for (const c of charges) {
|
|
82
|
+
const { hashedSecret } = keyOffsetToHashedSecret(pub, c.keyOffset)
|
|
83
|
+
const bn = priv.add(hashedSecret).mod(new Curve().n)
|
|
84
|
+
const offsetPrivKey = new PrivateKey(bn)
|
|
85
|
+
//const unlock = p2pkh.unlock(offsetPrivKey, signOutputs, anyoneCanPay)
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
return []
|
|
89
|
+
}
|