@arkade-os/sdk 0.5.0-rc.7 → 0.5.0-rc.8

package/README.md

@@ -1371,6 +1371,35 @@ const swWallet = await ServiceWorkerWallet.setup({
 
 Raise it when the external issuer is expected to burn more than `N` consecutive addresses without any of them being paid — every index in such a run is a miss, and the funded one sits past the band. When that happens the funds are invisible until a `restore()` whose `gapLimit` is large enough to cross the run (`wallet.restore({ gapLimit: 200 })`); a default restore closes its gap window before reaching the funded index. Keep the value modest: the band adds up to `2N + 1` indices × the candidate matrix (typically 1-4 scripts each) to the wallet's subscription.
 
+#### Restoring plugin state
+
+`wallet.restore()` is the explicit imported-wallet recovery boundary. It first restores the
+wallet's own addresses, contracts, history, and balances, then runs every restore hook registered
+for that wallet instance. `Wallet` and `ServiceWorkerWallet` both follow this ordering, and
+concurrent calls coalesce until the hooks finish.
+
+```typescript
+import { registerWalletRestoreHook } from '@arkade-os/sdk'
+
+const unregister = registerWalletRestoreHook(wallet, {
+  id: 'my-plugin',
+  restore: async (restoredWallet) => {
+    await rebuildPluginState(await restoredWallet.getTransactionHistory())
+  },
+})
+
+await wallet.restore()
+```
+
+Registering the same `id` again replaces that hook without changing its position. A run uses a
+stable snapshot, attempts every hook in registration order, and throws an `AggregateError` after
+all failures have been collected. If core recovery fails, hooks do not run. The returned function
+removes only that exact registration and is safe to call more than once.
+
+Hooks do not run during `Wallet.create()`, `ServiceWorkerWallet.setup()`, or ordinary startup. A
+plugin should register before an application calls `restore()` and keep its normal incremental
+reconciliation for state that arrives later.
+
 For advanced use cases, you can access the ContractManager directly to register external contracts:
 
 ```typescript

package/dist/adapters/expo.cjs

@@ -1,18 +1,18 @@
 'use strict';
 
-var chunkXIPWLWPU_cjs = require('../chunk-XIPWLWPU.cjs');
-require('../chunk-XOT73T36.cjs');
-require('../chunk-GLLBSULU.cjs');
+var chunk56RCBKNF_cjs = require('../chunk-56RCBKNF.cjs');
+require('../chunk-2AWDPVZI.cjs');
+require('../chunk-NY5FN4VV.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkXIPWLWPU_cjs.ExpoArkProvider; }
+  get: function () { return chunk56RCBKNF_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkXIPWLWPU_cjs.ExpoIndexerProvider; }
+  get: function () { return chunk56RCBKNF_cjs.ExpoIndexerProvider; }
 });
 //# sourceMappingURL=expo.cjs.map
 //# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.d.cts

@@ -1,5 +1,5 @@
-import { q as RestArkProvider, n as SettlementEvent, T as TxNotificationEvent, r as RestIndexerProvider, s as SubscriptionResponse } from '../index-F-X4BWxi.cjs';
-export { t as ArkProvider, u as IndexerProvider } from '../index-F-X4BWxi.cjs';
+import { q as RestArkProvider, n as SettlementEvent, T as TxNotificationEvent, r as RestIndexerProvider, s as SubscriptionResponse } from '../index-BIL9boGL.cjs';
+export { t as ArkProvider, u as IndexerProvider } from '../index-BIL9boGL.cjs';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';

package/dist/adapters/expo.d.ts

@@ -1,5 +1,5 @@
-import { q as RestArkProvider, n as SettlementEvent, T as TxNotificationEvent, r as RestIndexerProvider, s as SubscriptionResponse } from '../index-F-X4BWxi.js';
-export { t as ArkProvider, u as IndexerProvider } from '../index-F-X4BWxi.js';
+import { q as RestArkProvider, n as SettlementEvent, T as TxNotificationEvent, r as RestIndexerProvider, s as SubscriptionResponse } from '../index-BIL9boGL.js';
+export { t as ArkProvider, u as IndexerProvider } from '../index-BIL9boGL.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';

package/dist/adapters/expo.js

@@ -1,5 +1,5 @@
-export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-4MB3Z33G.js';
-import '../chunk-2JU54RGB.js';
-import '../chunk-H7KLBU6G.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-INTEA7D3.js';
+import '../chunk-G6S4XSFI.js';
+import '../chunk-MTYQXZ2T.js';
 //# sourceMappingURL=expo.js.map
 //# sourceMappingURL=expo.js.map

package/dist/{asyncStorageTaskQueue-BHOhjFiF.d.cts → asyncStorageTaskQueue-Bn3FoNkc.d.cts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, b as TaskItem, c as TaskResult } from './taskRunner-CDCz7MTW.cjs';
+import { c as TaskQueue, b as TaskItem, d as TaskResult } from './taskRunner-z_BGID85.cjs';
 
 /**
  * Minimal async key-value storage interface.
@@ -46,4 +46,4 @@ declare class AsyncStorageTaskQueue implements TaskQueue {
     private writeList;
 }
 
-export { AsyncStorageTaskQueue as A, type AsyncStorageLike as a };
+export { type AsyncStorageLike as A, AsyncStorageTaskQueue as a };

package/dist/{asyncStorageTaskQueue-BedBOEpT.d.ts → asyncStorageTaskQueue-CeYTmuGU.d.ts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, b as TaskItem, c as TaskResult } from './taskRunner-BdU_d__J.js';
+import { c as TaskQueue, b as TaskItem, d as TaskResult } from './taskRunner-CRbuzUXR.js';
 
 /**
  * Minimal async key-value storage interface.
@@ -46,4 +46,4 @@ declare class AsyncStorageTaskQueue implements TaskQueue {
     private writeList;
 }
 
-export { AsyncStorageTaskQueue as A, type AsyncStorageLike as a };
+export { type AsyncStorageLike as A, AsyncStorageTaskQueue as a };

package/dist/{chunk-XOT73T36.cjs → chunk-2AWDPVZI.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkGLLBSULU_cjs = require('./chunk-GLLBSULU.cjs');
+var chunkNY5FN4VV_cjs = require('./chunk-NY5FN4VV.cjs');
 var base = require('@scure/base');
 var secp256k1_js = require('@noble/curves/secp256k1.js');
 var utils_js = require('@scure/btc-signer/utils.js');
 
 // src/extension/asset/index.ts
 var asset_exports = {};
-chunkGLLBSULU_cjs.__export(asset_exports, {
+chunkNY5FN4VV_cjs.__export(asset_exports, {
   ASSET_ID_VECTORS: () => ASSET_ID_VECTORS,
   AssetGroup: () => AssetGroup,
   AssetId: () => AssetId,
@@ -1419,10 +1419,10 @@ async function indexerFetch(input, init) {
     const lastAttempt = attempt >= maxAttempts;
     let res;
     try {
-      res = await chunkGLLBSULU_cjs.rateGate.runHttp(input, () => chunkGLLBSULU_cjs.baseFetch(input, init));
+      res = await chunkNY5FN4VV_cjs.rateGate.runHttp(input, () => chunkNY5FN4VV_cjs.baseFetch(input, init));
     } catch (err) {
-      const mapped = chunkGLLBSULU_cjs.toProviderUnavailable(err, "indexer");
-      if (lastAttempt || !(mapped instanceof chunkGLLBSULU_cjs.ProviderUnavailableError)) throw mapped;
+      const mapped = chunkNY5FN4VV_cjs.toProviderUnavailable(err, "indexer");
+      if (lastAttempt || !(mapped instanceof chunkNY5FN4VV_cjs.ProviderUnavailableError)) throw mapped;
       await sleep(retryDelayMs(attempt));
       continue;
     }
@@ -1434,7 +1434,7 @@ async function indexerFetch(input, init) {
       body = void 0;
     }
     try {
-      chunkGLLBSULU_cjs.throwIfHttpUnavailable(res, "indexer", body);
+      chunkNY5FN4VV_cjs.throwIfHttpUnavailable(res, "indexer", body);
     } catch (err) {
       if (lastAttempt) throw err;
       await sleep(retryDelayMs(attempt));
@@ -1463,7 +1463,7 @@ var ChainTxType = /* @__PURE__ */ ((ChainTxType2) => {
   return ChainTxType2;
 })(ChainTxType || {});
 var RestIndexerProvider = class {
-  constructor(serverUrl = chunkGLLBSULU_cjs.DEFAULT_ARKADE_SERVER_URL, options = {}) {
+  constructor(serverUrl = chunkNY5FN4VV_cjs.DEFAULT_ARKADE_SERVER_URL, options = {}) {
     this.serverUrl = serverUrl;
     this.eventSource = options.eventSource;
   }
@@ -1601,8 +1601,8 @@ var RestIndexerProvider = class {
       try {
         while (!abortSignal?.aborted) {
           try {
-            const currentIterator = chunkGLLBSULU_cjs.eventSourceIterator(
-              chunkGLLBSULU_cjs.resolveEventSource(override)(url)
+            const currentIterator = chunkNY5FN4VV_cjs.eventSourceIterator(
+              chunkNY5FN4VV_cjs.resolveEventSource(override)(url)
             );
             iterator = currentIterator;
             for await (const event of currentIterator) {
@@ -1613,9 +1613,9 @@ var RestIndexerProvider = class {
                   yield {
                     txid: data.event.txid,
                     scripts: data.event.scripts || [],
-                    newVtxos: (data.event.newVtxos || []).map(chunkGLLBSULU_cjs.convertVtxo),
-                    spentVtxos: (data.event.spentVtxos || []).map(chunkGLLBSULU_cjs.convertVtxo),
-                    sweptVtxos: (data.event.sweptVtxos || []).map(chunkGLLBSULU_cjs.convertVtxo),
+                    newVtxos: (data.event.newVtxos || []).map(chunkNY5FN4VV_cjs.convertVtxo),
+                    spentVtxos: (data.event.spentVtxos || []).map(chunkNY5FN4VV_cjs.convertVtxo),
+                    sweptVtxos: (data.event.sweptVtxos || []).map(chunkNY5FN4VV_cjs.convertVtxo),
                     tx: data.event.tx,
                     checkpointTxs: data.event.checkpointTxs
                   };
@@ -1629,14 +1629,14 @@ var RestIndexerProvider = class {
             if (abortSignal?.aborted || error instanceof Error && error.name === "AbortError") {
               break;
             }
-            if (chunkGLLBSULU_cjs.isFetchTimeoutError(error)) {
+            if (chunkNY5FN4VV_cjs.isFetchTimeoutError(error)) {
               console.debug("Timeout error ignored");
               continue;
             }
-            if (chunkGLLBSULU_cjs.isEventSourceError(error)) {
+            if (chunkNY5FN4VV_cjs.isEventSourceError(error)) {
               throw error;
             }
-            if (chunkGLLBSULU_cjs.isEventSourceUnavailableError(error)) throw error;
+            if (chunkNY5FN4VV_cjs.isEventSourceUnavailableError(error)) throw error;
             console.error("Subscription error:", error);
             throw error;
           } finally {
@@ -1780,7 +1780,7 @@ var RestIndexerProvider = class {
     }
     const data = await this.fetchVtxosJson(url);
     return {
-      vtxos: data.vtxos.map(chunkGLLBSULU_cjs.convertVtxo),
+      vtxos: data.vtxos.map(chunkNY5FN4VV_cjs.convertVtxo),
       page: data.page
     };
   }
@@ -1994,5 +1994,5 @@ exports.Metadata = Metadata;
 exports.Packet = Packet;
 exports.RestIndexerProvider = RestIndexerProvider;
 exports.asset_exports = asset_exports;
-//# sourceMappingURL=chunk-XOT73T36.cjs.map
-//# sourceMappingURL=chunk-XOT73T36.cjs.map
+//# sourceMappingURL=chunk-2AWDPVZI.cjs.map
+//# sourceMappingURL=chunk-2AWDPVZI.cjs.map