@arkade-os/sdk 0.4.69 → 0.5.0-rc.1

package/README.md

@@ -787,7 +787,7 @@ const wallet = await Wallet.create({
 })
 
 // Get fee information from the server
-const { fees: feeInfo } = await wallet.arkProvider.getInfo();
+const { fees: feeInfo } = await wallet.getArkadeInfo();
 
 const exitTxid = await new Ramps(wallet).offboard(
   'bc1p...',
@@ -795,6 +795,37 @@ const exitTxid = await new Ramps(wallet).offboard(
 );
 ```
 
+`getArkadeInfo()` is part of the `IReadonlyWallet` interface, so the same call works on the
+service-worker and Expo wallets too. It answers with the server's live `ArkadeInfo`, falling back
+to the snapshot persisted at wallet construction when the server is unreachable.
+
+### Talking to the server through the wallet
+
+`getArkadeInfo()` is one of three seams that let a plugin work from a wallet alone, never a
+server URL of its own:
+
+| Seam | Interface | For |
+| --- | --- | --- |
+| `getArkadeInfo()` | `IReadonlyWallet` | Network, signer key, delays, dust, fees, limits |
+| `getArkadeReader()` | `IReadonlyWallet` | Chain reads for scripts the wallet does not own |
+| `getArkadeBroadcaster()` | `IWallet` | `submitTx` / `finalizeTx` |
+
+```typescript
+const reader = await wallet.getArkadeReader();
+const { vtxos } = await reader.getVtxos({ scripts: [covenantScriptHex], spendableOnly: true });
+const { txs } = await reader.getVirtualTxs([spendTxid]);
+```
+
+`getVtxos()` here queries the server for an arbitrary script — distinct from
+`wallet.getVtxos()`, which answers the wallet's own outputs from local repositories. Everything
+it returns is normalized, so each VTXO carries its canonical facts.
+
+Broadcasting sits on `IWallet` rather than `IReadonlyWallet` on purpose: a readonly wallet must
+not submit, and a service-worker wallet in readonly mode refuses the message outright.
+
+All three are proxied to the worker on a service-worker wallet, so a plugin shares the wallet's
+connection instead of opening a second one outside its rate gate and caches.
+
 ### Unilateral Exit
 
 Unilateral exit allows you to withdraw your funds from the Arkade protocol back to the Bitcoin blockchain without requiring cooperation from the Arkade server. This process involves two main steps:
@@ -1135,13 +1166,12 @@ The `StorageAdapter` API is deprecated. Use repositories instead. If you omit `s
 > Anything related to contract repository migration must be handled by the
 > package that created the contracts. The SDK doesn't manage external contracts
 > in V1; data persisted by other packages remains untouched in its original
-> location. For example, see `@arkade-os/boltz-swap`'s `migrateToSwapRepository`
-> for migrating legacy `reverseSwaps` / `submarineSwaps` collections.
+> location.
 
 #### Repository Versioning
 
 `WalletRepository`, `ContractRepository`, and `SwapRepository` (in
-`@arkade-os/boltz-swap`) each declare a `readonly version` field with a literal
+`@arkade-os/swap`) each declare a `readonly version` field with a literal
 type. All built-in implementations set this to the current version. If you
 maintain a custom repository implementation, TypeScript will produce a compile
 error when the version is bumped, signaling that a semantic update is required:
@@ -1526,7 +1556,7 @@ For integration tests, use the root commands (`pnpm run test:integration:ts-sdk`
 
 ### Releasing
 
-Package-local releases are disabled. Releases run from the monorepo root and are package-scoped: `pnpm run release -- sdk patch` bumps `@arkade-os/sdk`, creates a `@arkade-os/sdk/<version>` tag, and also bumps `@arkade-os/boltz-swap` (which depends on SDK via `workspace:*`). See the [root README](../../README.md#releasing) for full flags and `pnpm run release -- --help`.
+Package-local releases are disabled. Releases run from the monorepo root and are package-scoped: `pnpm run release -- sdk patch` bumps `@arkade-os/sdk`, creates a `@arkade-os/sdk/<version>` tag, and also bumps `@arkade-os/swap` (which depends on SDK via `workspace:*`). See the [root README](../../README.md#releasing) for full flags and `pnpm run release -- --help`.
 
 ## License
 

package/dist/adapters/expo.cjs

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunkXQPN5YP2_cjs = require('../chunk-XQPN5YP2.cjs');
-require('../chunk-GVHUHTRH.cjs');
-require('../chunk-5MLC2HU3.cjs');
+var chunkKB7OP3FG_cjs = require('../chunk-KB7OP3FG.cjs');
+require('../chunk-WQIWUTYS.cjs');
+require('../chunk-RZ2NGS6A.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkXQPN5YP2_cjs.ExpoArkProvider; }
+  get: function () { return chunkKB7OP3FG_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkXQPN5YP2_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkKB7OP3FG_cjs.ExpoIndexerProvider; }
 });
 //# sourceMappingURL=expo.cjs.map
 //# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.d.cts

@@ -1,5 +1,5 @@
-import { n as RestArkProvider, k as SettlementEvent, T as TxNotificationEvent, o as RestIndexerProvider, p as SubscriptionResponse } from '../index-dWRqYSdS.cjs';
-export { q as ArkProvider, r as IndexerProvider } from '../index-dWRqYSdS.cjs';
+import { r as RestArkProvider, o as SettlementEvent, T as TxNotificationEvent, s as RestIndexerProvider, t as SubscriptionResponse } from '../index-DnNIOqHS.cjs';
+export { u as ArkProvider, v as IndexerProvider } from '../index-DnNIOqHS.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 { n as RestArkProvider, k as SettlementEvent, T as TxNotificationEvent, o as RestIndexerProvider, p as SubscriptionResponse } from '../index-dWRqYSdS.js';
-export { q as ArkProvider, r as IndexerProvider } from '../index-dWRqYSdS.js';
+import { r as RestArkProvider, o as SettlementEvent, T as TxNotificationEvent, s as RestIndexerProvider, t as SubscriptionResponse } from '../index-DnNIOqHS.js';
+export { u as ArkProvider, v as IndexerProvider } from '../index-DnNIOqHS.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';

package/dist/adapters/expo.js

@@ -1,6 +1,6 @@
-export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-MNMPGEK2.js';
-import '../chunk-YG7T6LI3.js';
-import '../chunk-L5SCQYHF.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-MEJSBJVH.js';
+import '../chunk-SG4XYCS7.js';
+import '../chunk-6COJWPBO.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=expo.js.map
 //# sourceMappingURL=expo.js.map

package/dist/adapters/indexedDB.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkEBYCTLET_cjs = require('../chunk-EBYCTLET.cjs');
-require('../chunk-GVHUHTRH.cjs');
-require('../chunk-WIFL5QYZ.cjs');
-require('../chunk-5MLC2HU3.cjs');
+var chunkYEUXBECG_cjs = require('../chunk-YEUXBECG.cjs');
+require('../chunk-WQIWUTYS.cjs');
+require('../chunk-Q5WQ4Y2I.cjs');
+require('../chunk-RZ2NGS6A.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 // src/storage/indexedDB.ts
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunkEBYCTLET_cjs.DB_VERSION) {
+  constructor(dbName, version = chunkYEUXBECG_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,7 +1,7 @@
-import { DB_VERSION } from '../chunk-TA7XLEP2.js';
-import '../chunk-YG7T6LI3.js';
-import '../chunk-2PPL3O7Z.js';
-import '../chunk-L5SCQYHF.js';
+import { DB_VERSION } from '../chunk-VTE3NYVD.js';
+import '../chunk-SG4XYCS7.js';
+import '../chunk-ZPSUBAWQ.js';
+import '../chunk-6COJWPBO.js';
 import '../chunk-NSBPE2FW.js';
 
 // src/storage/indexedDB.ts

package/dist/{asyncStorageTaskQueue-BgUJN-3X.d.ts → asyncStorageTaskQueue-DAs_n1xr.d.ts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-D2fnbqYw.js';
+import { c as TaskQueue, a as TaskItem, b as TaskResult } from './taskRunner-F7wNJcF3.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/{asyncStorageTaskQueue-Cstx6hS7.d.cts → asyncStorageTaskQueue-DqGRG66E.d.cts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-CzYKyJ9c.cjs';
+import { c as TaskQueue, a as TaskItem, b as TaskResult } from './taskRunner-BDb5Ee2J.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/{chunk-L5SCQYHF.js → chunk-6COJWPBO.js}

@@ -1,4 +1,4 @@
-import { ScriptNum, OP, p2tr_ms, Script, SigHash, p2tr, TAPROOT_UNSPENDABLE_KEY, Address, RawWitness, Transaction as Transaction$1 } from '@scure/btc-signer';
+import { ScriptNum, OP, p2tr_ms, Script, RawWitness, SigHash, p2tr, TAPROOT_UNSPENDABLE_KEY, Address, Transaction as Transaction$1 } from '@scure/btc-signer';
 import * as bip68 from 'bip68';
 import { TEST_NETWORK, NETWORK } from '@scure/btc-signer/utils.js';
 import { hex, bech32m } from '@scure/base';
@@ -192,6 +192,7 @@ var getNetwork = (network) => {
   if (!found) throw new Error(`Unsupported network: ${network}`);
   return found;
 };
+var networkFromArkadeInfo = (info) => getNetwork(info.network);
 var networks = {
   bitcoin: withArkPrefix(NETWORK, "ark", "bitcoin"),
   testnet: withArkPrefix(TEST_NETWORK, "tark", "testnet"),
@@ -1022,7 +1023,7 @@ function resolveEventSource(override) {
 }
 
 // package.json
-var version = "0.4.69";
+var version = "0.5.0-rc.1";
 
 // src/utils/fetch.ts
 var buildVersion = "0.9.9";
@@ -1620,8 +1621,9 @@ var RestArkProvider = class {
   /** Overrides {@link configureEventSource} for this provider's streams. */
   eventSource;
   /**
-   * Last server-info digest seen from {@link getInfo}. Sent as `X-Digest`
-   * so arkd can reject stale client configuration.
+   * Last server-info digest seen (from {@link getInfo}). Sent as `X-Digest`
+   * on outgoing requests so arkd can reject a client whose cached info is
+   * stale. Empty until the first {@link getInfo}.
    */
   _digest = "";
   _hasServerInfo = false;
@@ -1699,7 +1701,10 @@ var RestArkProvider = class {
   }
   async getInfo() {
     const url = `${this.serverUrl}/v1/info`;
-    const response = await rateGate.runHttp(url, () => fetch(url));
+    const response = await rateGate.runHttp(
+      url,
+      () => fetch(url, { signal: infoFetchSignal() })
+    );
     if (!response.ok) {
       const errorText = await response.text();
       throwIfHttpUnavailable(response, "arkade", errorText);
@@ -2183,11 +2188,16 @@ function decodeMusig2Nonces(noncesObject) {
     })
   );
 }
+var INFO_FETCH_TIMEOUT_MS = 12e3;
+function infoFetchSignal() {
+  return typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function" ? AbortSignal.timeout(INFO_FETCH_TIMEOUT_MS) : void 0;
+}
 function isFetchTimeoutError(err) {
   const checkError = (error) => {
     if (!(error instanceof Error)) return false;
     const isCloudflare524 = error.name === "TypeError" && error.message === "Failed to fetch";
-    return isCloudflare524 || error.name === "HeadersTimeoutError" || error.name === "BodyTimeoutError" || error.code === "UND_ERR_HEADERS_TIMEOUT" || error.code === "UND_ERR_BODY_TIMEOUT";
+    return isCloudflare524 || // AbortSignal.timeout rejects with a DOMException named this
+    error.name === "TimeoutError" || error.name === "HeadersTimeoutError" || error.name === "BodyTimeoutError" || error.code === "UND_ERR_HEADERS_TIMEOUT" || error.code === "UND_ERR_BODY_TIMEOUT";
   };
   return checkError(err) || checkError(err.cause);
 }
@@ -2424,6 +2434,6 @@ function isExpired(vtxo) {
   return n.isSwept || n.expiresAt !== void 0 && n.expiresAt.getTime() <= Date.now();
 }
 
-export { ArkAddress, ArkError, ArkErrorName, ArkPsbtFieldKey, ArkPsbtFieldKeyType, BITCOIN_EMULATOR_PUBKEY, CLTVMultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, ConditionWitness, CosignerPublicKey, DEFAULT_ARKADE_SERVER_URL, DEFAULT_NETWORK, DEFAULT_NETWORK_NAME, DEFAULT_PAGE_SIZE, DigestMismatchError, EventSourceUnavailableError, FetchError, Intent, MUTINYNET_EMULATOR_PUBKEY, MultisigTapscript, OP_RETURN_EMPTY_PKSCRIPT, PrevArkTxField, PrevoutTxField, ProviderUnavailableError, REGTEST_EMULATOR_PUBKEY, RestArkProvider, SCRIPT_QUERY_CHUNK_SIZE, ServerResponseMismatchError, SettlementEventType, TapTreeCoder, Transaction, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, assembleBtcdTaprootTree, assertAllowedSighashTypes, baseFetch, buildVersion, canRecoverOnchain, canSpendOffchain, canSweepOnchain, configureEventSource, convertVtxo, craftToSpendTx, decodeTapscript, defaultEmulatorPubkey, eventSourceIterator, fetch, fetchVtxoCreatedAtByTxid, formatSighash, getAllNormalizedVtxos, getArkPsbtFields, getConfiguredEventSource, getNetwork, getNormalizedVtxos, getSequence, hasTerminalSpend, isArkError, isEventSourceError, isEventSourceUnavailableError, isExpired, isFetchTimeoutError, isPastExpiry, isRecoverable, isRetryableProviderError, isSpendable, isVirtualCoin, maybeArkError, networks, normalizeVtxo, parseLegacyExpiry, rateGate, resolveEmulatorPubkey, resolveEventSource, resolveTimeHeight, scriptFromTapLeafScript, sdkVersion, sequenceToTimelock, setArkPsbtField, throwIfHttpUnavailable, timelockToSequence, toBatchExpiry, toOffchainInputFeeParams, toProviderUnavailable, toVirtualStatus };
-//# sourceMappingURL=chunk-L5SCQYHF.js.map
-//# sourceMappingURL=chunk-L5SCQYHF.js.map
+export { ArkAddress, ArkError, ArkErrorName, ArkPsbtFieldKey, ArkPsbtFieldKeyType, BITCOIN_EMULATOR_PUBKEY, CLTVMultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, ConditionWitness, CosignerPublicKey, DEFAULT_ARKADE_SERVER_URL, DEFAULT_NETWORK, DEFAULT_NETWORK_NAME, DEFAULT_PAGE_SIZE, DigestMismatchError, EventSourceUnavailableError, FetchError, INFO_FETCH_TIMEOUT_MS, Intent, MUTINYNET_EMULATOR_PUBKEY, MultisigTapscript, OP_RETURN_EMPTY_PKSCRIPT, PrevArkTxField, PrevoutTxField, ProviderUnavailableError, REGTEST_EMULATOR_PUBKEY, RestArkProvider, SCRIPT_QUERY_CHUNK_SIZE, ServerResponseMismatchError, SettlementEventType, TapTreeCoder, Transaction, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, assembleBtcdTaprootTree, assertAllowedSighashTypes, baseFetch, buildVersion, canRecoverOnchain, canSpendOffchain, canSweepOnchain, configureEventSource, convertVtxo, craftToSpendTx, decodeTapscript, defaultEmulatorPubkey, eventSourceIterator, fetch, fetchVtxoCreatedAtByTxid, formatSighash, getAllNormalizedVtxos, getArkPsbtFields, getConfiguredEventSource, getNetwork, getNormalizedVtxos, getSequence, hasTerminalSpend, isArkError, isEventSourceError, isEventSourceUnavailableError, isExpired, isFetchTimeoutError, isPastExpiry, isRecoverable, isRetryableProviderError, isSpendable, isVirtualCoin, maybeArkError, networkFromArkadeInfo, networks, normalizeVtxo, parseLegacyExpiry, rateGate, resolveEmulatorPubkey, resolveEventSource, resolveTimeHeight, scriptFromTapLeafScript, sdkVersion, sequenceToTimelock, setArkPsbtField, throwIfHttpUnavailable, timelockToSequence, toBatchExpiry, toOffchainInputFeeParams, toProviderUnavailable, toVirtualStatus };
+//# sourceMappingURL=chunk-6COJWPBO.js.map
+//# sourceMappingURL=chunk-6COJWPBO.js.map