@arkade-os/sdk 0.4.39 → 0.4.41

package/README.md

@@ -360,6 +360,30 @@ const txid = await wallet.send({
 })
 ```
 
+### Activity history
+
+Group the wallet's transaction history into labelled, logical activities. Register an
+`ActivityResolver` object; its optional `prepare()` can refresh correlation data, and
+its synchronous `resolve(tx)` returns memberships. `getActivityHistory()` buckets
+the transactions into `Activity` rows. The `boarding` built-in is pre-registered,
+and a transaction can belong to multiple groups (e.g. a batched settlement).
+
+```typescript
+// Tag your app's transactions (correlate by txid however you track them)
+wallet.activity.use({
+  id: 'my-app',
+  resolve: (tx) => {
+    const action = myActions.get(tx.key.arkTxid)
+    return action ? [{ groupId: action.id, label: action.label, kind: 'app' }] : undefined
+  },
+})
+
+// Built-ins (boarding) + your resolver; txs grouped oldest-first per activity
+const activities = await wallet.getActivityHistory()
+// amount is signed sats: positive received, negative sent; same-key change rows are excluded
+// each Activity: { id, intent?, txs, amount, createdAt, settled }
+```
+
 ### Assets (Issue, Reissue, Burn, Send)
 
 The wallet's `assetManager` lets you create and manage assets on Arkade. The `send` method supports sending assets.

package/dist/adapters/expo.cjs

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunkN56IDZON_cjs = require('../chunk-N56IDZON.cjs');
-require('../chunk-LJLEFPWD.cjs');
-require('../chunk-CMPJR3HS.cjs');
+var chunkWBF3FNS3_cjs = require('../chunk-WBF3FNS3.cjs');
+require('../chunk-ALISWEQ5.cjs');
+require('../chunk-HXDZ2QTW.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkN56IDZON_cjs.ExpoArkProvider; }
+  get: function () { return chunkWBF3FNS3_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkN56IDZON_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkWBF3FNS3_cjs.ExpoIndexerProvider; }
 });
 //# sourceMappingURL=expo.cjs.map
 //# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.d.cts

@@ -1,5 +1,5 @@
-import { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-BzUNnkoc.cjs';
-export { m as ArkProvider, n as IndexerProvider } from '../ark-BzUNnkoc.cjs';
+import { l as RestArkProvider, j as SettlementEvent, T as TxNotification, m as RestIndexerProvider, n as SubscriptionResponse } from '../ark-CSqMJczW.cjs';
+export { o as ArkProvider, p as IndexerProvider } from '../ark-CSqMJczW.cjs';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/adapters/expo.d.ts

@@ -1,5 +1,5 @@
-import { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-BzUNnkoc.js';
-export { m as ArkProvider, n as IndexerProvider } from '../ark-BzUNnkoc.js';
+import { l as RestArkProvider, j as SettlementEvent, T as TxNotification, m as RestIndexerProvider, n as SubscriptionResponse } from '../ark-CSqMJczW.js';
+export { o as ArkProvider, p as IndexerProvider } from '../ark-CSqMJczW.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/adapters/expo.js

@@ -1,6 +1,6 @@
-export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-VGXTJ7HR.js';
-import '../chunk-D744IES4.js';
-import '../chunk-OUVTG72A.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-DDG4RE5F.js';
+import '../chunk-5XAYUPK4.js';
+import '../chunk-BE5MUB7T.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 chunkP5FKMIGY_cjs = require('../chunk-P5FKMIGY.cjs');
-require('../chunk-LJLEFPWD.cjs');
-require('../chunk-GUTKJMSF.cjs');
-require('../chunk-CMPJR3HS.cjs');
+var chunk3MPXMLP4_cjs = require('../chunk-3MPXMLP4.cjs');
+require('../chunk-ALISWEQ5.cjs');
+require('../chunk-32YKLQPS.cjs');
+require('../chunk-HXDZ2QTW.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 // src/storage/indexedDB.ts
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunkP5FKMIGY_cjs.DB_VERSION) {
+  constructor(dbName, version = chunk3MPXMLP4_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,7 +1,7 @@
-import { DB_VERSION } from '../chunk-SYEGCMNV.js';
-import '../chunk-D744IES4.js';
-import '../chunk-CUSABEUQ.js';
-import '../chunk-OUVTG72A.js';
+import { DB_VERSION } from '../chunk-D5MQYYYF.js';
+import '../chunk-5XAYUPK4.js';
+import '../chunk-YNEDJTX2.js';
+import '../chunk-BE5MUB7T.js';
 import '../chunk-NSBPE2FW.js';
 
 // src/storage/indexedDB.ts

package/dist/{ark-BzUNnkoc.d.cts → ark-CSqMJczW.d.cts}

@@ -1384,6 +1384,7 @@ interface Network {
     scriptHash: number;
     wif: number;
 }
+declare const getNetwork: (network: NetworkName) => Network;
 declare const networks: {
     bitcoin: Network;
     testnet: Network;
@@ -1404,6 +1405,17 @@ declare const networks: {
 declare const ESPLORA_URL: Record<NetworkName, string>;
 type ExplorerTransaction = {
     txid: string;
+    /**
+     * Inputs as returned by Esplora's `/address/:addr/txs`, each carrying the
+     * outpoint it spends (`txid:vout`). Optional: not every provider populates
+     * it (the electrum provider omits inputs), so consumers that correlate
+     * spenders must tolerate its absence. Used to recover a boarding output's
+     * spending (commitment) tx when `/outspends` omits the spender txid.
+     */
+    vin?: {
+        txid: string;
+        vout: number;
+    }[];
     vout: {
         scriptpubkey_address: string;
         value: string;
@@ -1443,12 +1455,14 @@ interface OnchainProvider {
      * Fetch outspend information for every output in a transaction.
      *
      * @param txid - Transaction id to inspect
-     * @returns Per-output spend status information
+     * @returns Per-output spend status information. `txid` (the spender) may be
+     *   absent even when `spent` is true: some Esplora deployments
+     *   (e.g. mempool.arkade.sh) omit it from `/outspends`.
      * @see getTxStatus
      */
     getTxOutspends(txid: string): Promise<{
         spent: boolean;
-        txid: string;
+        txid?: string;
     }[]>;
     /**
      * Fetch transactions associated with an address.
@@ -1519,7 +1533,7 @@ declare class EsploraProvider implements OnchainProvider {
     broadcastTransaction(...txs: string[]): Promise<string>;
     getTxOutspends(txid: string): Promise<{
         spent: boolean;
-        txid: string;
+        txid?: string;
     }[]>;
     getTransactions(address: string): Promise<ExplorerTransaction[]>;
     getTxStatus(txid: string): Promise<{
@@ -2901,6 +2915,90 @@ declare class DelegateManagerImpl implements IDelegateManager {
 declare const DelegatorManagerImpl: typeof DelegateManagerImpl;
 type DelegatorManagerImpl = DelegateManagerImpl;
 
+/** One transaction's participation in one logical action. */
+interface GroupMembership {
+    /**
+     * Stable id of the action; txs sharing it group together. Third-party
+     * resolvers should namespace it (`"vendor:thing"`) to avoid colliding with
+     * other resolvers' groups. SDK built-ins use namespaced ids such as `boarding:`.
+     * A membership with an empty groupId is dropped.
+     */
+    groupId: string;
+    /** Human label for the action, e.g. "Dice game". */
+    label?: string;
+    /** App category for icon/filtering, e.g. "game". */
+    kind?: string;
+    /**
+     * Free-form row data. Same-group metadata is shallow-merged with
+     * earlier-resolver keys winning.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * This tx's unsigned sat contribution to this group. Defaults to the tx's
+     * full amount; the builder applies direction. Use it to split a batched tx
+     * across groups. Same-key receive rows paired with a sent row are treated
+     * as change and excluded from `Activity.amount`. A membership with a
+     * non-finite amount (NaN/Infinity) is dropped.
+     */
+    amount?: number;
+}
+/** A pluggable resolver keyed by `id`. */
+interface ActivityResolver {
+    /**
+     * Registry key — override or remove by it. Namespace it (`"vendor:games"`)
+     * so independent libraries don't clobber each other; `use()` overwrites
+     * silently on a duplicate id.
+     */
+    id: string;
+    /**
+     * Load correlation data before `resolve` runs. If it rejects, this resolver
+     * contributes no memberships.
+     */
+    prepare?(): Promise<void>;
+    /** Pure and synchronous. The groups this tx belongs to, or undefined to leave it plain. */
+    resolve(tx: ArkTransaction): GroupMembership[] | undefined;
+}
+/** The non-id, non-amount part of a {@link GroupMembership}. */
+interface ActivityIntent {
+    /** Human label for the action, e.g. "Dice game". */
+    label?: string;
+    /** App category for icon/filtering, e.g. "game". */
+    kind?: string;
+    /** Free-form row data, shallow-merged across the group's resolvers (first-writer-wins). */
+    metadata?: Record<string, unknown>;
+}
+/** One logical activity. */
+interface Activity {
+    /** The groupId, or the natural tx key for untagged rows. */
+    id: string;
+    /** Merged intent for the group, if any resolver tagged it. */
+    intent?: ActivityIntent;
+    /** Member txs, oldest-first. */
+    txs: ArkTransaction[];
+    /** Signed net sats: positive received, negative sent; same-key change rows are excluded. */
+    amount: number;
+    /** Earliest member createdAt (ms since epoch). */
+    createdAt: number;
+    /** True once every member tx is settled. */
+    settled: boolean;
+}
+/** Resolver registry keyed by id. */
+declare class ActivityRegistry {
+    private readonly resolvers;
+    /** Add a resolver, or override an existing one with the same id (kept in place). */
+    use(resolver: ActivityResolver): void;
+    /** Remove a resolver (built-in or custom) by id. */
+    remove(id: string): void;
+    /** The registered resolver ids, in registration order. */
+    list(): string[];
+    /** All registered resolvers, in registration (priority) order. */
+    all(): ActivityResolver[];
+}
+/** Built-in resolver: labels on-chain boarding (deposit) transactions. */
+declare function boardingResolver(): ActivityResolver;
+/** Default registry with SDK built-ins. */
+declare function createDefaultActivityRegistry(): ActivityRegistry;
+
 /**
  * Wallet receive-address strategy.
  *
@@ -3672,6 +3770,10 @@ interface IReadonlyWallet {
     getBoardingUtxos(): Promise<ExtendedCoin[]>;
     /** @returns Wallet transaction history derived from boarding and Arkade activity. */
     getTransactionHistory(): Promise<ArkTransaction[]>;
+    /** Resolvers that group/label {@link getActivityHistory} rows. */
+    readonly activity: ActivityRegistry;
+    /** @returns Wallet history grouped into logical activities with signed net amounts. */
+    getActivityHistory(): Promise<Activity[]>;
     /**
      * Get the contract manager associated with this wallet.
      * This is useful for querying contract state and watching for contract events.
@@ -3681,6 +3783,11 @@ interface IReadonlyWallet {
     getContractManager(): Promise<IContractManager>;
     /** Readonly asset manager bound to this wallet instance. */
     assetManager: IReadonlyAssetManager;
+    /**
+     * Wipe all locally persisted wallet data (VTXOs, UTXOs, history, sync
+     * cursor, contracts).
+     */
+    clear(): Promise<void>;
 }
 
 type PaginationOptions = {
@@ -4432,4 +4539,4 @@ declare namespace ProtoTypes {
     export {  };
 }
 
-export { type SignerSession as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type DescriptorProvider as D, type ExtendedVirtualCoin as E, type IReadonlyWallet as F, type GetVtxosFilter as G, type ReadonlyIdentity as H, type IWallet as I, type DelegateProvider as J, type ReadonlyWalletConfig as K, type IReadonlyAssetManager as L, type NetworkName as M, type Network as N, type OnchainProvider as O, type ArkInfo as P, ArkAddress as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type Coin as U, VtxoScript as V, type WalletRepository as W, ContractManager as X, CSVMultisigTapscript as Y, type SettlementConfig as Z, VtxoManager as _, type Identity as a, DigestMismatchError as a$, type SignedIntent as a0, Intent as a1, type VtxoRepositoryKey as a2, type WalletState as a3, type ContractFilter as a4, type DescriptorSigningRequest as a5, Transaction as a6, type IntentFeeConfig as a7, type OffchainInput as a8, FeeAmount as a9, type Outpoint as aA, type ChainTx as aB, type PathContext as aC, type ArkTapscript as aD, type Asset as aE, type AssetMetadata as aF, type BaseWalletConfig as aG, type BatchInfo as aH, type BatchSignableIdentity as aI, CLTVMultisigTapscript as aJ, ChainTxType as aK, type CommitmentTx as aL, ConditionCSVMultisigTapscript as aM, ConditionMultisigTapscript as aN, type ContractBalance as aO, type ContractEventCallback as aP, type ContractHandler as aQ, type ContractManagerConfig as aR, type ContractState as aS, type ContractVtxo as aT, ContractWatcher as aU, DelegateManagerImpl as aV, type DelegateOptions as aW, DelegatorManagerImpl as aX, type DelegatorProvider as aY, type DeprecatedSignerMigrationReport as aZ, type DeprecatedSignerReport as a_, type OnchainInput as aa, type FeeOutput as ab, type ContractWatcherConfig as ac, type FeeInfo as ad, type CreateContractParams as ae, type GetContractsFilter as af, type GetSpendablePathsOptions as ag, type GetAllSpendingPathsOptions as ah, type IssuanceParams as ai, type ReissuanceParams as aj, type BurnParams as ak, type RenewVtxosOptions as al, type ContractWithVtxos as am, type PathSelection as an, type ContractEvent as ao, type AssetDetails as ap, type IssuanceResult as aq, type DelegateInfo as ar, type MigrationGlobalSkipReason as as, type MigrationLegSkipReason as at, type SignerStatus as au, type StorageConfig as av, type IVtxoManager as aw, type ExplorerTransaction as ax, type EncodedVtxoScript as ay, type Status as az, type WalletConfig as b, type Discoverable as b0, type DiscoveredContract as b1, type DiscoveryDeps as b2, ESPLORA_URL as b3, EsploraProvider as b4, type ExtendedContractVtxo as b5, type HandlerError as b6, type IDelegatorManager as b7, IndexerTxType as b8, type KnownMetadata as b9, type Tx as bA, type TxHistoryRecord as bB, type TxKey as bC, type TxTreeNode as bD, TxType as bE, type VirtualStatus as bF, type Vtxo as bG, type VtxoChain as bH, type VtxoType as bI, type WalletMode as bJ, classifyAgainstSignerSet as bK, classifyContractSigner as bL, decodeTapscript as bM, getSequence as bN, isBatchSignable as bO, isCooperativelyMigratable as bP, isDiscoverable as bQ, isExpired as bR, isRecoverable as bS, isSpendable as bT, isSubdust as bU, isVtxoExpiringSoon as bV, networks as bW, signerSetFromInfo as bX, toXOnlySignerHex as bY, type MigrateDeprecatedSignerOptions as ba, type MigrationLegReport as bb, type MigrationVtxoRef as bc, MultisigTapscript as bd, type Nonces as be, type Output as bf, type PageResponse as bg, type PaginationOptions as bh, PartialSig as bi, type ProviderClass as bj, RestDelegateProvider as bk, RestDelegatorProvider as bl, type ScanContractsOptions as bm, type ScanResult as bn, type ScheduledSession as bo, SettlementEventType as bp, type SignRequest as bq, type SignerClassification as br, type SignerSet as bs, type SubscriptionEvent as bt, type SubscriptionHeartbeat as bu, type TapLeaves as bv, TapTreeCoder as bw, TapscriptType as bx, type TreeNonces as by, type TreePartialSigs as bz, type WalletBalance as c, type ExtendedCoin as d, type IContractManager as e, type IDelegateManager as f, type SettleParams as g, type SettlementEvent as h, type IAssetManager as i, RestArkProvider as j, RestIndexerProvider as k, type SubscriptionResponse as l, type ArkProvider as m, type IndexerProvider as n, type RelativeTimelock as o, type TapLeafScript as p, type VirtualCoin as q, type Contract as r, type TreeSigningStartedEvent as s, TxTree as t, type TreeNoncesEvent as u, type BatchFinalizationEvent as v, type BatchFinalizedEvent as w, type BatchFailedEvent as x, type TreeTxEvent as y, type TreeSignatureEvent as z };
+export { type Coin as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type BatchFinalizationEvent as D, type ExtendedVirtualCoin as E, type BatchFinalizedEvent as F, type GetVtxosFilter as G, type BatchFailedEvent as H, type IWallet as I, type TreeTxEvent as J, type TreeSignatureEvent as K, type DescriptorProvider as L, type IReadonlyWallet as M, type ReadonlyIdentity as N, type Network as O, type OnchainProvider as P, type DelegateProvider as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type ReadonlyWalletConfig as U, VtxoScript as V, type WalletRepository as W, type IReadonlyAssetManager as X, type NetworkName as Y, type ArkInfo as Z, ArkAddress as _, type Identity as a, DelegatorManagerImpl as a$, ContractManager as a0, CSVMultisigTapscript as a1, type SettlementConfig as a2, VtxoManager as a3, type SignerSession as a4, type SignedIntent as a5, Intent as a6, type DescriptorSigningRequest as a7, Transaction as a8, type IntentFeeConfig as a9, type EncodedVtxoScript as aA, type Status as aB, type Outpoint as aC, type ChainTx as aD, type PathContext as aE, type ActivityIntent as aF, type ActivityResolver as aG, type ArkTapscript as aH, type Asset as aI, type AssetMetadata as aJ, type BaseWalletConfig as aK, type BatchInfo as aL, type BatchSignableIdentity as aM, CLTVMultisigTapscript as aN, ChainTxType as aO, type CommitmentTx as aP, ConditionCSVMultisigTapscript as aQ, ConditionMultisigTapscript as aR, type ContractBalance as aS, type ContractEventCallback as aT, type ContractHandler as aU, type ContractManagerConfig as aV, type ContractState as aW, type ContractVtxo as aX, ContractWatcher as aY, DelegateManagerImpl as aZ, type DelegateOptions as a_, type OffchainInput as aa, FeeAmount as ab, type OnchainInput as ac, type FeeOutput as ad, type ContractWatcherConfig as ae, type FeeInfo as af, type CreateContractParams as ag, type GetContractsFilter as ah, type GetSpendablePathsOptions as ai, type GetAllSpendingPathsOptions as aj, type IssuanceParams as ak, type ReissuanceParams as al, type BurnParams as am, type RenewVtxosOptions as an, type ContractWithVtxos as ao, type PathSelection as ap, type ContractEvent as aq, type AssetDetails as ar, type IssuanceResult as as, type DelegateInfo as at, type MigrationGlobalSkipReason as au, type MigrationLegSkipReason as av, type SignerStatus as aw, type StorageConfig as ax, type IVtxoManager as ay, type ExplorerTransaction as az, type WalletConfig as b, isSpendable as b$, type DelegatorProvider as b0, type DeprecatedSignerMigrationReport as b1, type DeprecatedSignerReport as b2, DigestMismatchError as b3, type Discoverable as b4, type DiscoveredContract as b5, type DiscoveryDeps as b6, ESPLORA_URL as b7, EsploraProvider as b8, type ExtendedContractVtxo as b9, type TapLeaves as bA, TapTreeCoder as bB, TapscriptType as bC, type TreeNonces as bD, type TreePartialSigs as bE, type Tx as bF, type TxHistoryRecord as bG, type TxKey as bH, type TxTreeNode as bI, TxType as bJ, type VirtualStatus as bK, type Vtxo as bL, type VtxoChain as bM, type VtxoType as bN, type WalletMode as bO, boardingResolver as bP, classifyAgainstSignerSet as bQ, classifyContractSigner as bR, createDefaultActivityRegistry as bS, decodeTapscript as bT, getNetwork as bU, getSequence as bV, isBatchSignable as bW, isCooperativelyMigratable as bX, isDiscoverable as bY, isExpired as bZ, isRecoverable as b_, type GroupMembership as ba, type HandlerError as bb, type IDelegatorManager as bc, IndexerTxType as bd, type KnownMetadata as be, type MigrateDeprecatedSignerOptions as bf, type MigrationLegReport as bg, type MigrationVtxoRef as bh, MultisigTapscript as bi, type Nonces as bj, type Output as bk, type PageResponse as bl, type PaginationOptions as bm, PartialSig as bn, type ProviderClass as bo, RestDelegateProvider as bp, RestDelegatorProvider as bq, type ScanContractsOptions as br, type ScanResult as bs, type ScheduledSession as bt, SettlementEventType as bu, type SignRequest as bv, type SignerClassification as bw, type SignerSet as bx, type SubscriptionEvent as by, type SubscriptionHeartbeat as bz, type WalletBalance as c, isSubdust as c0, isVtxoExpiringSoon as c1, networks as c2, signerSetFromInfo as c3, toXOnlySignerHex as c4, type ExtendedCoin as d, ActivityRegistry as e, type Activity as f, type IContractManager as g, type IDelegateManager as h, type SettleParams as i, type SettlementEvent as j, type IAssetManager as k, RestArkProvider as l, RestIndexerProvider as m, type SubscriptionResponse as n, type ArkProvider as o, type IndexerProvider as p, type RelativeTimelock as q, type TapLeafScript as r, type VirtualCoin as s, type Contract as t, type VtxoRepositoryKey as u, type WalletState as v, type ContractFilter as w, type TreeSigningStartedEvent as x, TxTree as y, type TreeNoncesEvent as z };

package/dist/{ark-BzUNnkoc.d.ts → ark-CSqMJczW.d.ts}

@@ -1384,6 +1384,7 @@ interface Network {
     scriptHash: number;
     wif: number;
 }
+declare const getNetwork: (network: NetworkName) => Network;
 declare const networks: {
     bitcoin: Network;
     testnet: Network;
@@ -1404,6 +1405,17 @@ declare const networks: {
 declare const ESPLORA_URL: Record<NetworkName, string>;
 type ExplorerTransaction = {
     txid: string;
+    /**
+     * Inputs as returned by Esplora's `/address/:addr/txs`, each carrying the
+     * outpoint it spends (`txid:vout`). Optional: not every provider populates
+     * it (the electrum provider omits inputs), so consumers that correlate
+     * spenders must tolerate its absence. Used to recover a boarding output's
+     * spending (commitment) tx when `/outspends` omits the spender txid.
+     */
+    vin?: {
+        txid: string;
+        vout: number;
+    }[];
     vout: {
         scriptpubkey_address: string;
         value: string;
@@ -1443,12 +1455,14 @@ interface OnchainProvider {
      * Fetch outspend information for every output in a transaction.
      *
      * @param txid - Transaction id to inspect
-     * @returns Per-output spend status information
+     * @returns Per-output spend status information. `txid` (the spender) may be
+     *   absent even when `spent` is true: some Esplora deployments
+     *   (e.g. mempool.arkade.sh) omit it from `/outspends`.
      * @see getTxStatus
      */
     getTxOutspends(txid: string): Promise<{
         spent: boolean;
-        txid: string;
+        txid?: string;
     }[]>;
     /**
      * Fetch transactions associated with an address.
@@ -1519,7 +1533,7 @@ declare class EsploraProvider implements OnchainProvider {
     broadcastTransaction(...txs: string[]): Promise<string>;
     getTxOutspends(txid: string): Promise<{
         spent: boolean;
-        txid: string;
+        txid?: string;
     }[]>;
     getTransactions(address: string): Promise<ExplorerTransaction[]>;
     getTxStatus(txid: string): Promise<{
@@ -2901,6 +2915,90 @@ declare class DelegateManagerImpl implements IDelegateManager {
 declare const DelegatorManagerImpl: typeof DelegateManagerImpl;
 type DelegatorManagerImpl = DelegateManagerImpl;
 
+/** One transaction's participation in one logical action. */
+interface GroupMembership {
+    /**
+     * Stable id of the action; txs sharing it group together. Third-party
+     * resolvers should namespace it (`"vendor:thing"`) to avoid colliding with
+     * other resolvers' groups. SDK built-ins use namespaced ids such as `boarding:`.
+     * A membership with an empty groupId is dropped.
+     */
+    groupId: string;
+    /** Human label for the action, e.g. "Dice game". */
+    label?: string;
+    /** App category for icon/filtering, e.g. "game". */
+    kind?: string;
+    /**
+     * Free-form row data. Same-group metadata is shallow-merged with
+     * earlier-resolver keys winning.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * This tx's unsigned sat contribution to this group. Defaults to the tx's
+     * full amount; the builder applies direction. Use it to split a batched tx
+     * across groups. Same-key receive rows paired with a sent row are treated
+     * as change and excluded from `Activity.amount`. A membership with a
+     * non-finite amount (NaN/Infinity) is dropped.
+     */
+    amount?: number;
+}
+/** A pluggable resolver keyed by `id`. */
+interface ActivityResolver {
+    /**
+     * Registry key — override or remove by it. Namespace it (`"vendor:games"`)
+     * so independent libraries don't clobber each other; `use()` overwrites
+     * silently on a duplicate id.
+     */
+    id: string;
+    /**
+     * Load correlation data before `resolve` runs. If it rejects, this resolver
+     * contributes no memberships.
+     */
+    prepare?(): Promise<void>;
+    /** Pure and synchronous. The groups this tx belongs to, or undefined to leave it plain. */
+    resolve(tx: ArkTransaction): GroupMembership[] | undefined;
+}
+/** The non-id, non-amount part of a {@link GroupMembership}. */
+interface ActivityIntent {
+    /** Human label for the action, e.g. "Dice game". */
+    label?: string;
+    /** App category for icon/filtering, e.g. "game". */
+    kind?: string;
+    /** Free-form row data, shallow-merged across the group's resolvers (first-writer-wins). */
+    metadata?: Record<string, unknown>;
+}
+/** One logical activity. */
+interface Activity {
+    /** The groupId, or the natural tx key for untagged rows. */
+    id: string;
+    /** Merged intent for the group, if any resolver tagged it. */
+    intent?: ActivityIntent;
+    /** Member txs, oldest-first. */
+    txs: ArkTransaction[];
+    /** Signed net sats: positive received, negative sent; same-key change rows are excluded. */
+    amount: number;
+    /** Earliest member createdAt (ms since epoch). */
+    createdAt: number;
+    /** True once every member tx is settled. */
+    settled: boolean;
+}
+/** Resolver registry keyed by id. */
+declare class ActivityRegistry {
+    private readonly resolvers;
+    /** Add a resolver, or override an existing one with the same id (kept in place). */
+    use(resolver: ActivityResolver): void;
+    /** Remove a resolver (built-in or custom) by id. */
+    remove(id: string): void;
+    /** The registered resolver ids, in registration order. */
+    list(): string[];
+    /** All registered resolvers, in registration (priority) order. */
+    all(): ActivityResolver[];
+}
+/** Built-in resolver: labels on-chain boarding (deposit) transactions. */
+declare function boardingResolver(): ActivityResolver;
+/** Default registry with SDK built-ins. */
+declare function createDefaultActivityRegistry(): ActivityRegistry;
+
 /**
  * Wallet receive-address strategy.
  *
@@ -3672,6 +3770,10 @@ interface IReadonlyWallet {
     getBoardingUtxos(): Promise<ExtendedCoin[]>;
     /** @returns Wallet transaction history derived from boarding and Arkade activity. */
     getTransactionHistory(): Promise<ArkTransaction[]>;
+    /** Resolvers that group/label {@link getActivityHistory} rows. */
+    readonly activity: ActivityRegistry;
+    /** @returns Wallet history grouped into logical activities with signed net amounts. */
+    getActivityHistory(): Promise<Activity[]>;
     /**
      * Get the contract manager associated with this wallet.
      * This is useful for querying contract state and watching for contract events.
@@ -3681,6 +3783,11 @@ interface IReadonlyWallet {
     getContractManager(): Promise<IContractManager>;
     /** Readonly asset manager bound to this wallet instance. */
     assetManager: IReadonlyAssetManager;
+    /**
+     * Wipe all locally persisted wallet data (VTXOs, UTXOs, history, sync
+     * cursor, contracts).
+     */
+    clear(): Promise<void>;
 }
 
 type PaginationOptions = {
@@ -4432,4 +4539,4 @@ declare namespace ProtoTypes {
     export {  };
 }
 
-export { type SignerSession as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type DescriptorProvider as D, type ExtendedVirtualCoin as E, type IReadonlyWallet as F, type GetVtxosFilter as G, type ReadonlyIdentity as H, type IWallet as I, type DelegateProvider as J, type ReadonlyWalletConfig as K, type IReadonlyAssetManager as L, type NetworkName as M, type Network as N, type OnchainProvider as O, type ArkInfo as P, ArkAddress as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type Coin as U, VtxoScript as V, type WalletRepository as W, ContractManager as X, CSVMultisigTapscript as Y, type SettlementConfig as Z, VtxoManager as _, type Identity as a, DigestMismatchError as a$, type SignedIntent as a0, Intent as a1, type VtxoRepositoryKey as a2, type WalletState as a3, type ContractFilter as a4, type DescriptorSigningRequest as a5, Transaction as a6, type IntentFeeConfig as a7, type OffchainInput as a8, FeeAmount as a9, type Outpoint as aA, type ChainTx as aB, type PathContext as aC, type ArkTapscript as aD, type Asset as aE, type AssetMetadata as aF, type BaseWalletConfig as aG, type BatchInfo as aH, type BatchSignableIdentity as aI, CLTVMultisigTapscript as aJ, ChainTxType as aK, type CommitmentTx as aL, ConditionCSVMultisigTapscript as aM, ConditionMultisigTapscript as aN, type ContractBalance as aO, type ContractEventCallback as aP, type ContractHandler as aQ, type ContractManagerConfig as aR, type ContractState as aS, type ContractVtxo as aT, ContractWatcher as aU, DelegateManagerImpl as aV, type DelegateOptions as aW, DelegatorManagerImpl as aX, type DelegatorProvider as aY, type DeprecatedSignerMigrationReport as aZ, type DeprecatedSignerReport as a_, type OnchainInput as aa, type FeeOutput as ab, type ContractWatcherConfig as ac, type FeeInfo as ad, type CreateContractParams as ae, type GetContractsFilter as af, type GetSpendablePathsOptions as ag, type GetAllSpendingPathsOptions as ah, type IssuanceParams as ai, type ReissuanceParams as aj, type BurnParams as ak, type RenewVtxosOptions as al, type ContractWithVtxos as am, type PathSelection as an, type ContractEvent as ao, type AssetDetails as ap, type IssuanceResult as aq, type DelegateInfo as ar, type MigrationGlobalSkipReason as as, type MigrationLegSkipReason as at, type SignerStatus as au, type StorageConfig as av, type IVtxoManager as aw, type ExplorerTransaction as ax, type EncodedVtxoScript as ay, type Status as az, type WalletConfig as b, type Discoverable as b0, type DiscoveredContract as b1, type DiscoveryDeps as b2, ESPLORA_URL as b3, EsploraProvider as b4, type ExtendedContractVtxo as b5, type HandlerError as b6, type IDelegatorManager as b7, IndexerTxType as b8, type KnownMetadata as b9, type Tx as bA, type TxHistoryRecord as bB, type TxKey as bC, type TxTreeNode as bD, TxType as bE, type VirtualStatus as bF, type Vtxo as bG, type VtxoChain as bH, type VtxoType as bI, type WalletMode as bJ, classifyAgainstSignerSet as bK, classifyContractSigner as bL, decodeTapscript as bM, getSequence as bN, isBatchSignable as bO, isCooperativelyMigratable as bP, isDiscoverable as bQ, isExpired as bR, isRecoverable as bS, isSpendable as bT, isSubdust as bU, isVtxoExpiringSoon as bV, networks as bW, signerSetFromInfo as bX, toXOnlySignerHex as bY, type MigrateDeprecatedSignerOptions as ba, type MigrationLegReport as bb, type MigrationVtxoRef as bc, MultisigTapscript as bd, type Nonces as be, type Output as bf, type PageResponse as bg, type PaginationOptions as bh, PartialSig as bi, type ProviderClass as bj, RestDelegateProvider as bk, RestDelegatorProvider as bl, type ScanContractsOptions as bm, type ScanResult as bn, type ScheduledSession as bo, SettlementEventType as bp, type SignRequest as bq, type SignerClassification as br, type SignerSet as bs, type SubscriptionEvent as bt, type SubscriptionHeartbeat as bu, type TapLeaves as bv, TapTreeCoder as bw, TapscriptType as bx, type TreeNonces as by, type TreePartialSigs as bz, type WalletBalance as c, type ExtendedCoin as d, type IContractManager as e, type IDelegateManager as f, type SettleParams as g, type SettlementEvent as h, type IAssetManager as i, RestArkProvider as j, RestIndexerProvider as k, type SubscriptionResponse as l, type ArkProvider as m, type IndexerProvider as n, type RelativeTimelock as o, type TapLeafScript as p, type VirtualCoin as q, type Contract as r, type TreeSigningStartedEvent as s, TxTree as t, type TreeNoncesEvent as u, type BatchFinalizationEvent as v, type BatchFinalizedEvent as w, type BatchFailedEvent as x, type TreeTxEvent as y, type TreeSignatureEvent as z };
+export { type Coin as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type BatchFinalizationEvent as D, type ExtendedVirtualCoin as E, type BatchFinalizedEvent as F, type GetVtxosFilter as G, type BatchFailedEvent as H, type IWallet as I, type TreeTxEvent as J, type TreeSignatureEvent as K, type DescriptorProvider as L, type IReadonlyWallet as M, type ReadonlyIdentity as N, type Network as O, type OnchainProvider as P, type DelegateProvider as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type ReadonlyWalletConfig as U, VtxoScript as V, type WalletRepository as W, type IReadonlyAssetManager as X, type NetworkName as Y, type ArkInfo as Z, ArkAddress as _, type Identity as a, DelegatorManagerImpl as a$, ContractManager as a0, CSVMultisigTapscript as a1, type SettlementConfig as a2, VtxoManager as a3, type SignerSession as a4, type SignedIntent as a5, Intent as a6, type DescriptorSigningRequest as a7, Transaction as a8, type IntentFeeConfig as a9, type EncodedVtxoScript as aA, type Status as aB, type Outpoint as aC, type ChainTx as aD, type PathContext as aE, type ActivityIntent as aF, type ActivityResolver as aG, type ArkTapscript as aH, type Asset as aI, type AssetMetadata as aJ, type BaseWalletConfig as aK, type BatchInfo as aL, type BatchSignableIdentity as aM, CLTVMultisigTapscript as aN, ChainTxType as aO, type CommitmentTx as aP, ConditionCSVMultisigTapscript as aQ, ConditionMultisigTapscript as aR, type ContractBalance as aS, type ContractEventCallback as aT, type ContractHandler as aU, type ContractManagerConfig as aV, type ContractState as aW, type ContractVtxo as aX, ContractWatcher as aY, DelegateManagerImpl as aZ, type DelegateOptions as a_, type OffchainInput as aa, FeeAmount as ab, type OnchainInput as ac, type FeeOutput as ad, type ContractWatcherConfig as ae, type FeeInfo as af, type CreateContractParams as ag, type GetContractsFilter as ah, type GetSpendablePathsOptions as ai, type GetAllSpendingPathsOptions as aj, type IssuanceParams as ak, type ReissuanceParams as al, type BurnParams as am, type RenewVtxosOptions as an, type ContractWithVtxos as ao, type PathSelection as ap, type ContractEvent as aq, type AssetDetails as ar, type IssuanceResult as as, type DelegateInfo as at, type MigrationGlobalSkipReason as au, type MigrationLegSkipReason as av, type SignerStatus as aw, type StorageConfig as ax, type IVtxoManager as ay, type ExplorerTransaction as az, type WalletConfig as b, isSpendable as b$, type DelegatorProvider as b0, type DeprecatedSignerMigrationReport as b1, type DeprecatedSignerReport as b2, DigestMismatchError as b3, type Discoverable as b4, type DiscoveredContract as b5, type DiscoveryDeps as b6, ESPLORA_URL as b7, EsploraProvider as b8, type ExtendedContractVtxo as b9, type TapLeaves as bA, TapTreeCoder as bB, TapscriptType as bC, type TreeNonces as bD, type TreePartialSigs as bE, type Tx as bF, type TxHistoryRecord as bG, type TxKey as bH, type TxTreeNode as bI, TxType as bJ, type VirtualStatus as bK, type Vtxo as bL, type VtxoChain as bM, type VtxoType as bN, type WalletMode as bO, boardingResolver as bP, classifyAgainstSignerSet as bQ, classifyContractSigner as bR, createDefaultActivityRegistry as bS, decodeTapscript as bT, getNetwork as bU, getSequence as bV, isBatchSignable as bW, isCooperativelyMigratable as bX, isDiscoverable as bY, isExpired as bZ, isRecoverable as b_, type GroupMembership as ba, type HandlerError as bb, type IDelegatorManager as bc, IndexerTxType as bd, type KnownMetadata as be, type MigrateDeprecatedSignerOptions as bf, type MigrationLegReport as bg, type MigrationVtxoRef as bh, MultisigTapscript as bi, type Nonces as bj, type Output as bk, type PageResponse as bl, type PaginationOptions as bm, PartialSig as bn, type ProviderClass as bo, RestDelegateProvider as bp, RestDelegatorProvider as bq, type ScanContractsOptions as br, type ScanResult as bs, type ScheduledSession as bt, SettlementEventType as bu, type SignRequest as bv, type SignerClassification as bw, type SignerSet as bx, type SubscriptionEvent as by, type SubscriptionHeartbeat as bz, type WalletBalance as c, isSubdust as c0, isVtxoExpiringSoon as c1, networks as c2, signerSetFromInfo as c3, toXOnlySignerHex as c4, type ExtendedCoin as d, ActivityRegistry as e, type Activity as f, type IContractManager as g, type IDelegateManager as h, type SettleParams as i, type SettlementEvent as j, type IAssetManager as k, RestArkProvider as l, RestIndexerProvider as m, type SubscriptionResponse as n, type ArkProvider as o, type IndexerProvider as p, type RelativeTimelock as q, type TapLeafScript as r, type VirtualCoin as s, type Contract as t, type VtxoRepositoryKey as u, type WalletState as v, type ContractFilter as w, type TreeSigningStartedEvent as x, TxTree as y, type TreeNoncesEvent as z };

package/dist/{asyncStorageTaskQueue-C0kQoY1x.d.cts → asyncStorageTaskQueue-79XdGsdW.d.cts}

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

package/dist/{asyncStorageTaskQueue-CIYeI6GM.d.ts → asyncStorageTaskQueue-SZPrhw23.d.ts}

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