@arkade-os/sdk 0.4.68 → 0.5.0-rc.0

package/README.md

@@ -754,7 +754,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...',
@@ -762,6 +762,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:
@@ -1102,13 +1133,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:
@@ -1493,7 +1523,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 chunkJGMSZIE4_cjs = require('../chunk-JGMSZIE4.cjs');
-require('../chunk-PJR63FTK.cjs');
-require('../chunk-EJOFL5WH.cjs');
+var chunkRXWKCEZP_cjs = require('../chunk-RXWKCEZP.cjs');
+require('../chunk-CZ32XADN.cjs');
+require('../chunk-6AFUNKK7.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkJGMSZIE4_cjs.ExpoArkProvider; }
+  get: function () { return chunkRXWKCEZP_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkJGMSZIE4_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkRXWKCEZP_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-C7RZCfoY.cjs';
-export { q as ArkProvider, r as IndexerProvider } from '../index-C7RZCfoY.cjs';
+import { r as RestArkProvider, o as SettlementEvent, T as TxNotificationEvent, s as RestIndexerProvider, t as SubscriptionResponse } from '../index-Udm5V2xW.cjs';
+export { u as ArkProvider, v as IndexerProvider } from '../index-Udm5V2xW.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-C7RZCfoY.js';
-export { q as ArkProvider, r as IndexerProvider } from '../index-C7RZCfoY.js';
+import { r as RestArkProvider, o as SettlementEvent, T as TxNotificationEvent, s as RestIndexerProvider, t as SubscriptionResponse } from '../index-Udm5V2xW.js';
+export { u as ArkProvider, v as IndexerProvider } from '../index-Udm5V2xW.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-G4I6PU5H.js';
-import '../chunk-33Q2RFET.js';
-import '../chunk-4CMXV5SF.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-JYP7YXT2.js';
+import '../chunk-FVTJJQNM.js';
+import '../chunk-PPG6W34P.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 chunkWCJVKFAP_cjs = require('../chunk-WCJVKFAP.cjs');
-require('../chunk-PJR63FTK.cjs');
-require('../chunk-6YUACVX4.cjs');
-require('../chunk-EJOFL5WH.cjs');
+var chunk5MJHZHG7_cjs = require('../chunk-5MJHZHG7.cjs');
+require('../chunk-CZ32XADN.cjs');
+require('../chunk-HL7EC2Z5.cjs');
+require('../chunk-6AFUNKK7.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 // src/storage/indexedDB.ts
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunkWCJVKFAP_cjs.DB_VERSION) {
+  constructor(dbName, version = chunk5MJHZHG7_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,7 +1,7 @@
-import { DB_VERSION } from '../chunk-VBHXBI7F.js';
-import '../chunk-33Q2RFET.js';
-import '../chunk-45FKMOJH.js';
-import '../chunk-4CMXV5SF.js';
+import { DB_VERSION } from '../chunk-6F2Q32KA.js';
+import '../chunk-FVTJJQNM.js';
+import '../chunk-KTU44AEH.js';
+import '../chunk-PPG6W34P.js';
 import '../chunk-NSBPE2FW.js';
 
 // src/storage/indexedDB.ts

package/dist/{asyncStorageTaskQueue-DaZlVTbM.d.ts → asyncStorageTaskQueue-BCzN3Y45.d.ts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-DuwK9t8O.js';
+import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-ZdS16Ypm.js';
 
 /**
  * Minimal async key-value storage interface.

package/dist/{asyncStorageTaskQueue-B2CcXIHU.d.cts → asyncStorageTaskQueue-CdF_ELX8.d.cts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-D2vnpPBT.cjs';
+import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-DxZciNaa.cjs';
 
 /**
  * Minimal async key-value storage interface.