applesauce-wallet 0.0.0-next-20250309231023 → 0.0.0-next-20250310121307

package/dist/helpers/history.d.ts

@@ -0,0 +1,18 @@
+import { HiddenContentSigner } from "applesauce-core/helpers";
+import { NostrEvent } from "nostr-tools";
+export declare const WALLET_HISTORY_KIND = 7376;
+export type HistoryDetails = {
+    /** The direction of the transaction, in = received, out = sent */
+    direction: "in" | "out";
+    /** The amount of the transaction */
+    amount: number;
+    /** An array of token event ids created */
+    created: string[];
+};
+export declare const HistoryDetailsSymbol: unique symbol;
+/** returns an array of redeemed event ids in a history event */
+export declare function getHistoryRedeemed(history: NostrEvent): string[];
+/** Returns the parsed details of a 7376 history event */
+export declare function getHistoryDetails(history: NostrEvent): HistoryDetails;
+/** Decrypts a wallet history event */
+export declare function unlockHistoryDetails(history: NostrEvent, signer: HiddenContentSigner): Promise<HistoryDetails>;

package/dist/helpers/history.js

@@ -0,0 +1,31 @@
+import { getHiddenTags, getOrComputeCachedValue, isETag, unlockHiddenTags, } from "applesauce-core/helpers";
+export const WALLET_HISTORY_KIND = 7376;
+export const HistoryDetailsSymbol = Symbol.for("history-details");
+/** returns an array of redeemed event ids in a history event */
+export function getHistoryRedeemed(history) {
+    return history.tags.filter((t) => isETag(t) && t[3] === "redeemed").map((t) => t[1]);
+}
+/** Returns the parsed details of a 7376 history event */
+export function getHistoryDetails(history) {
+    return getOrComputeCachedValue(history, HistoryDetailsSymbol, () => {
+        const tags = getHiddenTags(history);
+        if (!tags)
+            throw new Error("History event is locked");
+        const direction = tags.find((t) => t[0] === "direction")?.[1];
+        if (!direction)
+            throw new Error("History event missing direction");
+        const amountStr = tags.find((t) => t[0] === "amount")?.[1];
+        if (!amountStr)
+            throw new Error("History event missing amount");
+        const amount = parseInt(amountStr);
+        if (!Number.isFinite(amount))
+            throw new Error("Failed to parse amount");
+        const created = tags.filter((t) => isETag(t) && t[3] === "created").map((t) => t[1]);
+        return { direction, amount, created };
+    });
+}
+/** Decrypts a wallet history event */
+export async function unlockHistoryDetails(history, signer) {
+    await unlockHiddenTags(history, signer);
+    return getHistoryDetails(history);
+}

package/dist/helpers/index.d.ts

@@ -1 +1,3 @@
 export * from "./wallet.js";
+export * from "./tokens.js";
+export * from "./history.js";

package/dist/helpers/index.js

@@ -1 +1,3 @@
 export * from "./wallet.js";
+export * from "./tokens.js";
+export * from "./history.js";

package/dist/helpers/tokens.d.ts

@@ -0,0 +1,23 @@
+import { HiddenContentSigner } from "applesauce-core/helpers";
+import { NostrEvent } from "nostr-tools";
+export declare const WALLET_TOKEN_KIND = 7375;
+export type TokenDetails = {
+    /** Cashu mint for the proofs */
+    mint: string;
+    /** Cashu proofs */
+    proofs: {
+        amount: number;
+        secret: string;
+        C: string;
+        id: string;
+    }[];
+    /** tokens that were destroyed in the creation of this token (helps on wallet state transitions) */
+    del: string[];
+};
+export declare const TokenDetailsSymbol: unique symbol;
+/** Returns the decrypted and parsed details of a 7375 token event */
+export declare function getTokenDetails(token: NostrEvent): TokenDetails;
+/** Returns if token details are locked */
+export declare function isTokenDetailsLocked(token: NostrEvent): boolean;
+/** Decrypts a k:7375 token event */
+export declare function unlockTokenDetails(token: NostrEvent, signer: HiddenContentSigner): Promise<TokenDetails>;

package/dist/helpers/tokens.js

@@ -0,0 +1,29 @@
+import { getHiddenContent, getOrComputeCachedValue, isHiddenContentLocked, unlockHiddenContent, } from "applesauce-core/helpers";
+export const WALLET_TOKEN_KIND = 7375;
+export const TokenDetailsSymbol = Symbol.for("token-details");
+/** Returns the decrypted and parsed details of a 7375 token event */
+export function getTokenDetails(token) {
+    return getOrComputeCachedValue(token, TokenDetailsSymbol, () => {
+        const plaintext = getHiddenContent(token);
+        if (!plaintext)
+            throw new Error("Token is locked");
+        const details = JSON.parse(plaintext);
+        if (!details.mint)
+            throw new Error("Token missing mint");
+        if (!details.proofs)
+            details.proofs = [];
+        if (!details.del)
+            details.del = [];
+        return details;
+    });
+}
+/** Returns if token details are locked */
+export function isTokenDetailsLocked(token) {
+    return isHiddenContentLocked(token);
+}
+/** Decrypts a k:7375 token event */
+export async function unlockTokenDetails(token, signer) {
+    if (isHiddenContentLocked(token))
+        await unlockHiddenContent(token, signer);
+    return getTokenDetails(token);
+}

package/dist/queries/history.d.ts

@@ -0,0 +1,3 @@
+import { Query } from "applesauce-core";
+/** Query that returns an array of redeemed event ids for a wallet */
+export declare function WalletRedeemedQuery(pubkey: string): Query<string[]>;

package/dist/queries/history.js

@@ -0,0 +1,11 @@
+import { getHistoryRedeemed, WALLET_HISTORY_KIND } from "../helpers/history.js";
+import { scan } from "rxjs";
+/** Query that returns an array of redeemed event ids for a wallet */
+export function WalletRedeemedQuery(pubkey) {
+    return {
+        key: pubkey,
+        run: (events) => events
+            .filters({ kinds: [WALLET_HISTORY_KIND], authors: [pubkey] })
+            .pipe(scan((ids, history) => [...ids, ...getHistoryRedeemed(history)], [])),
+    };
+}

package/dist/queries/index.d.ts

@@ -1 +1,3 @@
 export * from "./wallet.js";
+export * from "./history.js";
+export * from "./tokens.js";

package/dist/queries/index.js

@@ -1 +1,3 @@
 export * from "./wallet.js";
+export * from "./history.js";
+export * from "./tokens.js";

package/dist/queries/tokens.d.ts

@@ -0,0 +1,6 @@
+import { Query } from "applesauce-core";
+import { NostrEvent } from "nostr-tools";
+/** A query that subscribes to all token events for a wallet, passing locked will filter by token locked status */
+export declare function WalletTokensQuery(pubkey: string, locked: boolean | undefined): Query<NostrEvent[]>;
+/** A query that returns the visible balance of a wallet for each mint */
+export declare function WalletBalanceQuery(pubkey: string): Query<Record<string, number>>;

package/dist/queries/tokens.js

@@ -0,0 +1,50 @@
+import { combineLatest, filter, map } from "rxjs";
+import { getTokenDetails, isTokenDetailsLocked, WALLET_TOKEN_KIND } from "../helpers/tokens.js";
+/** A query that subscribes to all token events for a wallet, passing locked will filter by token locked status */
+export function WalletTokensQuery(pubkey, locked) {
+    return {
+        key: pubkey + locked,
+        run: (events) => {
+            const updates = events.updates.pipe(filter((e) => e.kind === WALLET_TOKEN_KIND && e.pubkey === pubkey));
+            const timeline = events.timeline({ kinds: [WALLET_TOKEN_KIND], authors: [pubkey] });
+            return combineLatest([updates, timeline]).pipe(map(([_, tokens]) => {
+                if (locked !== undefined)
+                    return tokens.filter((t) => isTokenDetailsLocked(t) === locked);
+                else
+                    return tokens;
+            }));
+        },
+    };
+}
+/** A query that returns the visible balance of a wallet for each mint */
+export function WalletBalanceQuery(pubkey) {
+    return {
+        key: pubkey,
+        run: (events) => {
+            const updates = events.updates.pipe(filter((e) => e.kind === WALLET_TOKEN_KIND && e.pubkey === pubkey));
+            const timeline = events.timeline({ kinds: [WALLET_TOKEN_KIND], authors: [pubkey] });
+            return combineLatest([updates, timeline]).pipe(map(([_, tokens]) => {
+                const deleted = new Set();
+                return (tokens
+                    // count the tokens from newest to oldest (so del gets applied correctly)
+                    .reverse()
+                    .reduce((totals, token) => {
+                    // skip this event if it a newer event says its deleted
+                    if (deleted.has(token.id))
+                        return totals;
+                    // skip if token is locked
+                    if (isTokenDetailsLocked(token))
+                        return totals;
+                    const details = getTokenDetails(token);
+                    if (!details)
+                        return totals;
+                    // add deleted ids
+                    for (const id of details.del)
+                        deleted.add(id);
+                    const total = details.proofs.reduce((t, p) => t + p.amount, 0);
+                    return { ...totals, [details.mint]: (totals[details.mint] ?? 0) + total };
+                }, {}));
+            }));
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "applesauce-wallet",
-  "version": "0.0.0-next-20250309231023",
+  "version": "0.0.0-next-20250310121307",
   "description": "",
   "type": "module",
   "main": "dist/index.js",
@@ -42,7 +42,7 @@
     }
   },
   "dependencies": {
-    "applesauce-core": "0.0.0-next-20250309231023",
+    "applesauce-core": "0.0.0-next-20250310121307",
     "nostr-tools": "^2.10.4",
     "rxjs": "^7.8.1"
   },