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

package/README.md

@@ -574,6 +574,11 @@ const expiringVtxos = await manager.getExpiringVtxos()
 const urgentlyExpiring = await manager.getExpiringVtxos(60_000)
 ```
 
+A virtual output whose unilateral exit already happened is never offered for renewal, and the
+exported `isVtxoExpiringSoon` answers `false` for it regardless of its batch expiry: "expiring
+soon" is a renewal signal, and no batch can take an output that already lives onchain. Its remedy
+is `Unroll.completeUnroll`, and its value shows up in `balance.unrolled`.
+
 #### Boarding Input Sweep
 
 When a boarding input's CSV timelock expires, it can no longer be onboarded into Arkade cooperatively. The sweep feature detects these expired UTXOs and builds a raw onchain transaction that spends them via the unilateral exit path back to a fresh boarding address, restarting the timelock.
@@ -749,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...',
@@ -757,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:
@@ -1097,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:
@@ -1488,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 chunkR2YAMONM_cjs = require('../chunk-R2YAMONM.cjs');
-require('../chunk-CO3KKSWM.cjs');
-require('../chunk-2JV4VQ7C.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 chunkR2YAMONM_cjs.ExpoArkProvider; }
+  get: function () { return chunkRXWKCEZP_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkR2YAMONM_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-DU5o_hz7.cjs';
-export { q as ArkProvider, r as IndexerProvider } from '../index-DU5o_hz7.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-DU5o_hz7.js';
-export { q as ArkProvider, r as IndexerProvider } from '../index-DU5o_hz7.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-MZFUZUTQ.js';
-import '../chunk-X3VEMUVV.js';
-import '../chunk-3WIWNE4P.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 chunkMJUTO3PY_cjs = require('../chunk-MJUTO3PY.cjs');
-require('../chunk-CO3KKSWM.cjs');
-require('../chunk-OIZ2V2VD.cjs');
-require('../chunk-2JV4VQ7C.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 = chunkMJUTO3PY_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-AEWJU6NZ.js';
-import '../chunk-X3VEMUVV.js';
-import '../chunk-6TAQF6EV.js';
-import '../chunk-3WIWNE4P.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-Za-e_zMk.d.ts → asyncStorageTaskQueue-BCzN3Y45.d.ts}

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

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

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