@arkade-os/sdk 0.4.7 → 0.4.9

package/dist/cjs/worker/messageBus.js

@@ -8,6 +8,7 @@ const delegator_1 = require("../providers/delegator");
 const identity_1 = require("../identity");
 const wallet_1 = require("../wallet/wallet");
 const base_1 = require("@scure/base");
+const errors_1 = require("./errors");
 class MessageBus {
     constructor(walletRepository, contractRepository, { messageHandlers, tickIntervalMs = 10000, messageTimeoutMs = 30000, debug = false, buildServices, }) {
         this.walletRepository = walletRepository;
@@ -151,8 +152,12 @@ class MessageBus {
                 identity,
                 arkServerUrl: config.arkServer.url,
                 arkServerPublicKey: config.arkServer.publicKey,
+                indexerUrl: config.indexerUrl,
+                esploraUrl: config.esploraUrl,
                 storage,
                 delegatorProvider,
+                settlementConfig: config.settlementConfig,
+                watcherConfig: config.watcherConfig,
             });
             return { wallet, arkProvider, readonlyWallet: wallet };
         }
@@ -162,8 +167,11 @@ class MessageBus {
                 identity,
                 arkServerUrl: config.arkServer.url,
                 arkServerPublicKey: config.arkServer.publicKey,
+                indexerUrl: config.indexerUrl,
+                esploraUrl: config.esploraUrl,
                 storage,
                 delegatorProvider,
+                watcherConfig: config.watcherConfig,
             });
             return { readonlyWallet, arkProvider };
         }
@@ -183,6 +191,10 @@ class MessageBus {
     }
     async processMessage(event) {
         const { id, tag, broadcast } = event.data;
+        if (tag === "PING") {
+            event.source?.postMessage({ id, tag: "PONG" });
+            return;
+        }
         if (tag === "INITIALIZE_MESSAGE_BUS") {
             if (this.debug) {
                 console.log("Init Command received");
@@ -207,7 +219,7 @@ class MessageBus {
             event.source?.postMessage({
                 id,
                 tag: tag ?? "unknown",
-                error: new Error("MessageBus not initialized"),
+                error: new errors_1.MessageBusNotInitializedError(),
             });
             return;
         }
@@ -278,7 +290,7 @@ class MessageBus {
             return promise;
         return new Promise((resolve, reject) => {
             const timer = self.setTimeout(() => {
-                reject(new Error(`Message handler timed out after ${this.messageTimeoutMs}ms (${label})`));
+                reject(new errors_1.ServiceWorkerTimeoutError(`Message handler timed out after ${this.messageTimeoutMs}ms (${label})`));
             }, this.messageTimeoutMs);
             promise.then((val) => {
                 self.clearTimeout(timer);

package/dist/esm/contracts/contractManager.js

@@ -71,9 +71,10 @@ export class ContractManager {
         }
         // Load persisted contracts
         const contracts = await this.config.contractRepository.getContracts();
-        // fetch latest VTXOs for all contracts, ensure cache is up to date
+        // fetch all VTXOs (including spent/swept) for all contracts,
+        // so the repository has full history for transaction history and balance
         // TODO: what if the user has 1k contracts?
-        await this.getVtxosForContracts(contracts);
+        await this.fetchContractVxosFromIndexer(contracts, true);
         // add all contracts to the watcher
         const now = Date.now();
         for (const contract of contracts) {
@@ -136,8 +137,8 @@ export class ContractManager {
         };
         // Persist
         await this.config.contractRepository.saveContract(contract);
-        // ensure we have the latest VTXOs for this contract
-        await this.getVtxosForContracts([contract]);
+        // fetch all VTXOs (including spent/swept) for this contract
+        await this.fetchContractVxosFromIndexer([contract], true);
         // Add to watcher
         await this.watcher.addContract(contract);
         return contract;
@@ -302,6 +303,14 @@ export class ContractManager {
             this.eventCallbacks.delete(callback);
         };
     }
+    /**
+     * Force a full VTXO refresh from the indexer for all contracts.
+     * Populates the wallet repository with complete VTXO history.
+     */
+    async refreshVtxos() {
+        const contracts = await this.config.contractRepository.getContracts();
+        await this.fetchContractVxosFromIndexer(contracts, true);
+    }
     /**
      * Check if currently watching.
      */
@@ -331,11 +340,13 @@ export class ContractManager {
             case "vtxo_spent":
                 await this.fetchContractVxosFromIndexer([event.contract], true);
                 break;
-            case "connection_reset":
-                // Refetch all VTXOs for all active contracts
+            case "connection_reset": {
+                // Refetch all VTXOs (including spent/swept) for all active
+                // contracts so the repo stays consistent with bootstrap state
                 const activeWatchedContracts = this.watcher.getActiveContracts();
-                await this.fetchContractVxosFromIndexer(activeWatchedContracts, false);
+                await this.fetchContractVxosFromIndexer(activeWatchedContracts, true);
                 break;
+            }
             case "contract_expired":
                 // just update DB
                 await this.config.contractRepository.saveContract(event.contract);
@@ -362,11 +373,48 @@ export class ContractManager {
         return result;
     }
     async fetchContractVtxosBulk(contracts, includeSpent) {
-        const result = new Map();
-        await Promise.all(contracts.map(async (contract) => {
+        if (contracts.length === 0) {
+            return new Map();
+        }
+        // For a single contract, use the paginated path directly.
+        if (contracts.length === 1) {
+            const contract = contracts[0];
             const vtxos = await this.fetchContractVtxosPaginated(contract, includeSpent);
-            result.set(contract.script, vtxos);
-        }));
+            return new Map([[contract.script, vtxos]]);
+        }
+        // For multiple contracts, batch all scripts into a single indexer call
+        // per page to minimise round-trips.  Results are keyed by script so we
+        // can distribute them back to the correct contract afterwards.
+        const scriptToContract = new Map(contracts.map((c) => [c.script, c]));
+        const result = new Map(contracts.map((c) => [c.script, []]));
+        const scripts = contracts.map((c) => c.script);
+        const pageSize = 100;
+        const opts = includeSpent ? {} : { spendableOnly: true };
+        let pageIndex = 0;
+        let hasMore = true;
+        while (hasMore) {
+            const { vtxos, page } = await this.config.indexerProvider.getVtxos({
+                scripts,
+                ...opts,
+                pageIndex,
+                pageSize,
+            });
+            for (const vtxo of vtxos) {
+                // Match the VTXO back to its contract via the script field
+                // populated by the indexer.
+                if (!vtxo.script)
+                    continue;
+                const contract = scriptToContract.get(vtxo.script);
+                if (!contract)
+                    continue;
+                result.get(contract.script).push({
+                    ...extendVtxoFromContract(vtxo, contract),
+                    contractScript: contract.script,
+                });
+            }
+            hasMore = page ? vtxos.length === pageSize : false;
+            pageIndex++;
+        }
         return result;
     }
     async fetchContractVtxosPaginated(contract, includeSpent) {

package/dist/esm/contracts/contractWatcher.js

@@ -410,8 +410,27 @@ export class ContractWatcher {
             }
             return;
         }
-        this.subscriptionId =
-            await this.config.indexerProvider.subscribeForScripts(scriptsToWatch, this.subscriptionId);
+        try {
+            this.subscriptionId =
+                await this.config.indexerProvider.subscribeForScripts(scriptsToWatch, this.subscriptionId);
+        }
+        catch (error) {
+            // If we sent a stale subscription ID that the server no longer
+            // recognises, clear it and retry to create a fresh subscription.
+            // The server currently returns HTTP 500 with a JSON body whose
+            // message field looks like "subscription <uuid> not found".
+            // All other errors (network failures, parse errors, etc.) are rethrown.
+            const isStale = error instanceof Error &&
+                /subscription\s+\S+\s+not\s+found/i.test(error.message);
+            if (this.subscriptionId && isStale) {
+                this.subscriptionId = undefined;
+                this.subscriptionId =
+                    await this.config.indexerProvider.subscribeForScripts(scriptsToWatch);
+            }
+            else {
+                throw error;
+            }
+        }
     }
     /**
      * Main listening loop for subscription events.

package/dist/esm/identity/seedIdentity.js

@@ -102,7 +102,7 @@ export class SeedIdentity {
     static fromSeed(seed, opts) {
         const descriptor = hasDescriptor(opts)
             ? opts.descriptor
-            : buildDescriptor(seed, opts.isMainnet);
+            : buildDescriptor(seed, opts.isMainnet ?? true);
         return new SeedIdentity(seed, descriptor);
     }
     async xOnlyPublicKey() {
@@ -190,7 +190,7 @@ export class MnemonicIdentity extends SeedIdentity {
         const seed = mnemonicToSeedSync(phrase, passphrase);
         const descriptor = hasDescriptor(opts)
             ? opts.descriptor
-            : buildDescriptor(seed, opts.isMainnet);
+            : buildDescriptor(seed, opts.isMainnet ?? true);
         return new MnemonicIdentity(seed, descriptor);
     }
 }

package/dist/esm/index.js

@@ -39,7 +39,8 @@ export * as asset from './extension/asset/index.js';
 // Contracts
 import { ContractManager, ContractWatcher, contractHandlers, DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, encodeArkContract, decodeArkContract, contractFromArkContract, contractFromArkContractWithAddress, isArkContract, } from './contracts/index.js';
 import { closeDatabase, openDatabase } from './repositories/indexedDB/manager.js';
-import { WalletMessageHandler } from './wallet/serviceWorker/wallet-message-handler.js';
+import { WalletMessageHandler, WalletNotInitializedError, ReadonlyWalletError, DelegatorNotConfiguredError, } from './wallet/serviceWorker/wallet-message-handler.js';
+import { MessageBusNotInitializedError, ServiceWorkerTimeoutError, } from './worker/errors.js';
 export { 
 // Wallets
 Wallet, ReadonlyWallet, SingleKey, ReadonlySingleKey, SeedIdentity, MnemonicIdentity, ReadonlyDescriptorIdentity, OnchainWallet, Ramps, VtxoManager, DelegatorManagerImpl, RestDelegatorProvider, 
@@ -50,7 +51,7 @@ ArkAddress, DefaultVtxo, DelegateVtxo, VtxoScript, VHTLC,
 // Enums
 TxType, IndexerTxType, ChainTxType, SettlementEventType, 
 // Service Worker
-setupServiceWorker, MessageBus, WalletMessageHandler, ServiceWorkerWallet, ServiceWorkerReadonlyWallet, 
+setupServiceWorker, MessageBus, WalletMessageHandler, WalletNotInitializedError, ReadonlyWalletError, DelegatorNotConfiguredError, MessageBusNotInitializedError, ServiceWorkerTimeoutError, ServiceWorkerWallet, ServiceWorkerReadonlyWallet, 
 // Tapscript
 decodeTapscript, MultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CLTVMultisigTapscript, TapTreeCoder, 
 // Ark PSBT fields

package/dist/esm/providers/expoIndexer.js

@@ -28,6 +28,7 @@ function convertVtxo(vtxo) {
         createdAt: new Date(Number(vtxo.createdAt) * 1000),
         isUnrolled: vtxo.isUnrolled,
         isSpent: vtxo.isSpent,
+        script: vtxo.script,
         assets: vtxo.assets?.map((a) => ({
             assetId: a.assetId,
             amount: Number(a.amount),

package/dist/esm/providers/indexer.js

@@ -402,6 +402,7 @@ function convertVtxo(vtxo) {
         createdAt: new Date(Number(vtxo.createdAt) * 1000),
         isUnrolled: vtxo.isUnrolled,
         isSpent: vtxo.isSpent,
+        script: vtxo.script,
         assets: vtxo.assets?.map((a) => ({
             assetId: a.assetId,
             amount: Number(a.amount),

package/dist/esm/utils/transactionHistory.js

@@ -115,7 +115,8 @@ export async function buildTransactionHistory(vtxos, allBoardingTxs, commitments
                     txAmount = spentAmount;
                     // TODO: fetch the vtxo with /v1/indexer/vtxos?outpoints=<vtxo.arkTxid:0> to know when the tx was made
                     txTime = getTxCreatedAt
-                        ? await getTxCreatedAt(vtxo.arkTxId)
+                        ? ((await getTxCreatedAt(vtxo.arkTxId)) ??
+                            vtxo.createdAt.getTime() + 1)
                         : vtxo.createdAt.getTime() + 1;
                 }
                 const assets = subtractAssets(allSpent, changes);