applesauce-wallet 0.0.0-next-20251220152312 → 0.0.0-next-20251231055351

package/dist/actions/index.d.ts

@@ -2,3 +2,4 @@ export * from "./wallet.js";
 export * from "./tokens.js";
 export * from "./nutzaps.js";
 export * from "./nutzap-info.js";
+export * from "./mint-recomendation.js";

package/dist/actions/index.js

@@ -2,3 +2,4 @@ export * from "./wallet.js";
 export * from "./tokens.js";
 export * from "./nutzaps.js";
 export * from "./nutzap-info.js";
+export * from "./mint-recomendation.js";

package/dist/actions/mint-recomendation.d.ts

@@ -0,0 +1,30 @@
+import { Wallet } from "@cashu/cashu-ts";
+import { Action } from "applesauce-actions";
+import { NostrEvent } from "applesauce-core/helpers/event";
+import "../casts/__register__.js";
+/**
+ * Options for reviewing a mint
+ */
+export type ReviewMintOptions = {
+    /** Optional review/comment content */
+    comment?: string;
+    /** Optional relays to publish to */
+    relays?: string[];
+};
+/**
+ * An action that creates and publishes a mint recommendation event.
+ * Can accept a mint URL, Wallet instance, or MintInfo event.
+ */
+export declare function RecommendMint(input: string | Wallet | NostrEvent, options?: ReviewMintOptions): Action;
+/**
+ * Options for updating a mint recommendation
+ */
+export type UpdateMintRecommendationOptions = {
+    /** Optional relays to publish to */
+    relays?: string[];
+};
+/**
+ * An action that updates the comment on an existing mint recommendation event.
+ * Can accept a mint pubkey (to find the recommendation) or the recommendation event directly.
+ */
+export declare function UpdateMintRecommendation(input: string | NostrEvent, comment: string, options?: UpdateMintRecommendationOptions): Action;

package/dist/actions/mint-recomendation.js

@@ -0,0 +1,96 @@
+import { Wallet } from "@cashu/cashu-ts";
+import { MintRecommendationBlueprint } from "../blueprints/mint-recommendation.js";
+import { getCashuMintPubkey, getCashuMintURL, isValidCashuMintInfo } from "../helpers/mint-info.js";
+import { MINT_RECOMMENDATION_KIND, getRecommendationMintPubkey, isValidMintRecommendation, } from "../helpers/mint-recommendation.js";
+import { setComment } from "../operations/mint-recommendation.js";
+// Helper function to fetch mint pubkey from URL
+async function fetchMintPubkey(mintUrl) {
+    // Fetch mint info directly from the /v1/info endpoint
+    const infoUrl = new URL("/v1/info", mintUrl).toString();
+    const response = await fetch(infoUrl);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch mint info from ${mintUrl}: ${response.statusText}`);
+    }
+    const mintInfo = (await response.json());
+    return mintInfo.pubkey;
+}
+// Make sure the mint recommendation cast is registered
+import "../casts/__register__.js";
+/**
+ * An action that creates and publishes a mint recommendation event.
+ * Can accept a mint URL, Wallet instance, or MintInfo event.
+ */
+export function RecommendMint(input, options) {
+    return async ({ factory, sign, publish }) => {
+        let mintPubkey;
+        let url;
+        let addressPointer = undefined;
+        // Handle different input types
+        if (typeof input === "string") {
+            if (!URL.canParse(input))
+                throw new Error("Invalid mint URL");
+            // Input is a mint URL - fetch info directly
+            url = input;
+            mintPubkey = await fetchMintPubkey(url);
+        }
+        else if (input instanceof Wallet) {
+            const info = input.getMintInfo();
+            mintPubkey = info.pubkey;
+        }
+        else {
+            // Input is a MintInfo event (kind:38172)
+            if (!isValidCashuMintInfo(input))
+                throw new Error("Invalid mint info event. Expected kind:38172 with required `d` and `u` tags.");
+            mintPubkey = getCashuMintPubkey(input);
+            url = getCashuMintURL(input);
+            // Use the event itself as address pointer (blueprint will convert it)
+            addressPointer = input;
+        }
+        // Create the mint recommendation event
+        const recommendation = await factory
+            .create(MintRecommendationBlueprint, {
+            mintPubkey,
+            url,
+            addressPointer,
+            comment: options?.comment,
+        })
+            .then(sign);
+        // Publish the event
+        await publish(recommendation, options?.relays);
+    };
+}
+/**
+ * An action that updates the comment on an existing mint recommendation event.
+ * Can accept a mint pubkey (to find the recommendation) or the recommendation event directly.
+ */
+export function UpdateMintRecommendation(input, comment, options) {
+    return async ({ events, factory, self, sign, publish }) => {
+        let recommendation;
+        // Handle different input types
+        if (typeof input === "string") {
+            // Input is a mint pubkey - find the recommendation event
+            const recommendations = events.getTimeline({ kinds: [MINT_RECOMMENDATION_KIND], authors: [self] });
+            recommendation = recommendations.find((rec) => {
+                if (!isValidMintRecommendation(rec))
+                    return false;
+                const recMintPubkey = getRecommendationMintPubkey(rec);
+                return recMintPubkey === input;
+            });
+            if (!recommendation)
+                throw new Error(`No mint recommendation found for mint pubkey: ${input}`);
+        }
+        else {
+            // Input is a recommendation event
+            if (!isValidMintRecommendation(input))
+                throw new Error("Invalid mint recommendation event");
+            // Verify the event belongs to the current user
+            if (input.pubkey !== self)
+                throw new Error("Cannot update a mint recommendation that belongs to another user");
+            recommendation = input;
+        }
+        // Update the comment
+        const updated = await factory.modify(recommendation, setComment(comment)).then(sign);
+        // Publish the updated event
+        await publish(updated, options?.relays);
+    };
+}

package/dist/blueprints/index.d.ts

@@ -2,3 +2,4 @@ export * from "./history.js";
 export * from "./tokens.js";
 export * from "./wallet.js";
 export * from "./zaps.js";
+export * from "./mint-recommendation.js";

package/dist/blueprints/index.js

@@ -2,3 +2,4 @@ export * from "./history.js";
 export * from "./tokens.js";
 export * from "./wallet.js";
 export * from "./zaps.js";
+export * from "./mint-recommendation.js";

package/dist/blueprints/mint-recommendation.d.ts

@@ -0,0 +1,16 @@
+import { EventBlueprint } from "applesauce-core/event-factory";
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { AddressPointer } from "applesauce-core/helpers/pointers";
+/** Options for creating a mint recommendation */
+export type MintRecommendationOptions = {
+    /** The mint's pubkey (from the kind:38172 event's `d` tag) - required */
+    mintPubkey: string;
+    /** Optional URL to connect to the cashu mint */
+    url?: string;
+    /** Optional address pointer to the kind:38172 event */
+    addressPointer?: AddressPointer | NostrEvent | string;
+    /** Optional review/comment content */
+    comment?: string;
+};
+/** A blueprint to create a kind:38000 mint recommendation event */
+export declare function MintRecommendationBlueprint(options: MintRecommendationOptions): EventBlueprint;

package/dist/blueprints/mint-recommendation.js

@@ -0,0 +1,11 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { skip } from "applesauce-core/helpers";
+import { MINT_RECOMMENDATION_KIND } from "../helpers/mint-recommendation.js";
+import { CASHU_MINT_INFO_KIND } from "../helpers/mint-info.js";
+import { setAddressPointer, setComment, setKind, setMintPubkey, setURL } from "../operations/mint-recommendation.js";
+/** A blueprint to create a kind:38000 mint recommendation event */
+export function MintRecommendationBlueprint(options) {
+    const { mintPubkey, url, addressPointer, comment } = options;
+    return blueprint(MINT_RECOMMENDATION_KIND, setKind(CASHU_MINT_INFO_KIND), // Always 38172 for cashu mints
+    setMintPubkey(mintPubkey), url ? setURL(url) : skip(), addressPointer ? setAddressPointer(addressPointer) : skip(), comment ? setComment(comment) : skip());
+}

package/dist/casts/__register__.d.ts

@@ -2,10 +2,12 @@ import { ChainableObservable } from "applesauce-common/observable";
 import { NutzapInfo } from "./nutzap-info.js";
 import { Nutzap } from "./nutzap.js";
 import { Wallet } from "./wallet.js";
+import { MintRecommendation } from "./mint-recommendation.js";
 declare module "applesauce-common/casts/user" {
     interface User {
         readonly wallet$: ChainableObservable<Wallet | undefined>;
         readonly nutzap$: ChainableObservable<NutzapInfo | undefined>;
+        readonly mintRecommendation$: ChainableObservable<MintRecommendation | undefined>;
     }
 }
 declare module "applesauce-common/casts/stream" {

package/dist/casts/__register__.js

@@ -9,6 +9,8 @@ import { NUTZAP_INFO_KIND } from "../helpers/nutzap-info.js";
 import { NutzapInfo } from "./nutzap-info.js";
 import { Nutzap } from "./nutzap.js";
 import { Wallet } from "./wallet.js";
+import { MintRecommendation } from "./mint-recommendation.js";
+import { MINT_RECOMMENDATION_KIND } from "../helpers/mint-recommendation.js";
 Object.defineProperty(User.prototype, "wallet$", {
     get: function () {
         return this.$$ref("wallet$", (store) => this.outboxes$.pipe(switchMap((outboxes) => store
@@ -25,6 +27,15 @@ Object.defineProperty(User.prototype, "nutzap$", {
     enumerable: true,
     configurable: false,
 });
+Object.defineProperty(User.prototype, "mintRecommendation$", {
+    get: function () {
+        return this.$$ref("mintRecommendation$", (store) => store
+            .timeline({ kinds: [MINT_RECOMMENDATION_KIND], authors: [this.pubkey] })
+            .pipe(castTimelineStream(MintRecommendation, store)));
+    },
+    enumerable: true,
+    configurable: false,
+});
 Note.prototype.nutzaps$ = function () {
     return this.$$ref("nutzaps$", (store) => store
         .timeline(buildCommonEventRelationFilters({ kinds: [NUTZAP_KIND] }, this.event))

package/dist/casts/index.d.ts

@@ -1,3 +1,5 @@
+export * from "./mint-info.js";
+export * from "./mint-recommendation.js";
 export * from "./nutzap-info.js";
 export * from "./nutzap.js";
 export * from "./wallet-history.js";

package/dist/casts/index.js

@@ -1,3 +1,5 @@
+export * from "./mint-info.js";
+export * from "./mint-recommendation.js";
 export * from "./nutzap-info.js";
 export * from "./nutzap.js";
 export * from "./wallet-history.js";

package/dist/casts/mint-info.d.ts

@@ -0,0 +1,18 @@
+import { CastRefEventStore, EventCast } from "applesauce-common/casts";
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { CashuMintInfoEvent } from "../helpers/mint-info.js";
+import { MintRecommendation } from "./mint-recommendation.js";
+export declare class MintInfo extends EventCast<CashuMintInfoEvent> {
+    constructor(event: NostrEvent, store: CastRefEventStore);
+    /** The mint's pubkey (from the `d` tag) */
+    get mintPubkey(): string | undefined;
+    /** The URL to the cashu mint (from the `u` tag) */
+    get url(): string;
+    /** The supported nuts (comma-separated list of nut numbers) */
+    get nuts(): number[];
+    /** The network type (mainnet, testnet, signet, or regtest) */
+    get network(): import("../helpers/mint-info.js").NetworkType | undefined;
+    /** Optional metadata content (kind:0-style JSON object) */
+    get metadata(): Record<string, any> | undefined;
+    get recomendations$(): import("applesauce-common/observable").ChainableObservable<MintRecommendation[]>;
+}

package/dist/casts/mint-info.js

@@ -0,0 +1,42 @@
+import { EventCast } from "applesauce-common/casts";
+import { castTimelineStream } from "applesauce-common/observable";
+import { getCashuMintMetadata, getCashuMintNetwork, getCashuMintNuts, getCashuMintPubkey, getCashuMintURL, isValidCashuMintInfo, } from "../helpers/mint-info.js";
+import { MINT_RECOMMENDATION_KIND } from "../helpers/mint-recommendation.js";
+import { MintRecommendation } from "./mint-recommendation.js";
+export class MintInfo extends EventCast {
+    constructor(event, store) {
+        if (!isValidCashuMintInfo(event))
+            throw new Error("Invalid cashu mint info event");
+        super(event, store);
+    }
+    /** The mint's pubkey (from the `d` tag) */
+    get mintPubkey() {
+        return getCashuMintPubkey(this.event);
+    }
+    /** The URL to the cashu mint (from the `u` tag) */
+    get url() {
+        return getCashuMintURL(this.event);
+    }
+    /** The supported nuts (comma-separated list of nut numbers) */
+    get nuts() {
+        return getCashuMintNuts(this.event);
+    }
+    /** The network type (mainnet, testnet, signet, or regtest) */
+    get network() {
+        return getCashuMintNetwork(this.event);
+    }
+    /** Optional metadata content (kind:0-style JSON object) */
+    get metadata() {
+        return getCashuMintMetadata(this.event);
+    }
+    get recomendations$() {
+        return this.$$ref("recomendations$", (store) => store
+            .timeline([
+            // Based on the mint URL
+            { kinds: [MINT_RECOMMENDATION_KIND], "#u": [this.url] },
+            // Based on the mint pubkey
+            this.mintPubkey ? { kinds: [MINT_RECOMMENDATION_KIND], "#d": [this.mintPubkey] } : undefined,
+        ].filter((f) => !!f))
+            .pipe(castTimelineStream(MintRecommendation, store)));
+    }
+}

package/dist/casts/mint-recommendation.d.ts

@@ -0,0 +1,16 @@
+import { CastRefEventStore, EventCast } from "applesauce-common/casts";
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { MintRecommendationEvent } from "../helpers/mint-recommendation.js";
+export declare class MintRecommendation extends EventCast<MintRecommendationEvent> {
+    constructor(event: NostrEvent, store: CastRefEventStore);
+    /** The recommended event kind (should be 38172 for cashu mints) */
+    get kind(): number;
+    /** The mint's pubkey (from the `d` tag) */
+    get mintPubkey(): string | undefined;
+    /** Optional URL to connect to the cashu mint (from the `u` tag) */
+    get url(): string | undefined;
+    /** Optional address pointer to the kind:38172 event (from the `a` tag) */
+    get addressPointer(): import("nostr-tools/nip19").AddressPointer | undefined;
+    /** Optional review content */
+    get comment(): string;
+}

package/dist/casts/mint-recommendation.js

@@ -0,0 +1,29 @@
+import { EventCast } from "applesauce-common/casts";
+import { getRecommendationAddressPointer, getRecommendationMintPubkey, getRecommendationKind, getRecommendationURL, isValidMintRecommendation, } from "../helpers/mint-recommendation.js";
+export class MintRecommendation extends EventCast {
+    constructor(event, store) {
+        if (!isValidMintRecommendation(event))
+            throw new Error("Invalid mint recommendation event");
+        super(event, store);
+    }
+    /** The recommended event kind (should be 38172 for cashu mints) */
+    get kind() {
+        return getRecommendationKind(this.event);
+    }
+    /** The mint's pubkey (from the `d` tag) */
+    get mintPubkey() {
+        return getRecommendationMintPubkey(this.event);
+    }
+    /** Optional URL to connect to the cashu mint (from the `u` tag) */
+    get url() {
+        return getRecommendationURL(this.event);
+    }
+    /** Optional address pointer to the kind:38172 event (from the `a` tag) */
+    get addressPointer() {
+        return getRecommendationAddressPointer(this.event);
+    }
+    /** Optional review content */
+    get comment() {
+        return this.event.content;
+    }
+}

package/dist/helpers/index.d.ts

@@ -8,3 +8,5 @@ export * from "./cashu.js";
 export * from "./couch.js";
 export * from "./local-storage-couch.js";
 export * from "./indexed-db-couch.js";
+export * from "./mint-info.js";
+export * from "./mint-recommendation.js";

package/dist/helpers/index.js

@@ -8,3 +8,5 @@ export * from "./cashu.js";
 export * from "./couch.js";
 export * from "./local-storage-couch.js";
 export * from "./indexed-db-couch.js";
+export * from "./mint-info.js";
+export * from "./mint-recommendation.js";

package/dist/helpers/mint-info.d.ts

@@ -0,0 +1,40 @@
+import { KnownEvent } from "applesauce-core/helpers";
+import { NostrEvent } from "applesauce-core/helpers/event";
+export declare const CASHU_MINT_INFO_KIND = 38172;
+export type CashuMintInfoEvent = KnownEvent<typeof CASHU_MINT_INFO_KIND>;
+export type NetworkType = "mainnet" | "testnet" | "signet" | "regtest";
+export declare const CashuMintPubkeySymbol: unique symbol;
+export declare const CashuMintURLSymbol: unique symbol;
+export declare const CashuMintNutsSymbol: unique symbol;
+export declare const CashuMintNetworkSymbol: unique symbol;
+/**
+ * Returns the mint's pubkey from a kind:38172 cashu mint info event
+ * This is found in the `d` tag and is the pubkey from the mint's `/v1/info` endpoint
+ */
+export declare function getCashuMintPubkey(event: NostrEvent): string | undefined;
+/**
+ * Returns the mint URL from a kind:38172 cashu mint info event
+ * This is the URL to the cashu mint (from the `u` tag)
+ */
+export declare function getCashuMintURL(event: CashuMintInfoEvent): string;
+export declare function getCashuMintURL(event: NostrEvent): string | undefined;
+/**
+ * Returns the supported nuts from a kind:38172 cashu mint info event
+ * This is a comma-separated list of nut numbers (e.g., "1,2,3,4,5,6,7")
+ */
+export declare function getCashuMintNuts(event: NostrEvent): number[];
+/**
+ * Returns the network type from a kind:38172 cashu mint info event
+ * Should be one of: mainnet, testnet, signet, or regtest
+ */
+export declare function getCashuMintNetwork(event: NostrEvent): NetworkType | undefined;
+/**
+ * Returns the optional metadata content from a kind:38172 cashu mint info event
+ * This is a kind:0-style metadata JSON object, useful when the pubkey is not a normal user
+ */
+export declare function getCashuMintMetadata(event: NostrEvent): Record<string, any> | undefined;
+/**
+ * Validates that an event is a proper kind:38172 cashu mint info event
+ * Checks that the event is kind 38172 and has the required `d` and `u` tags
+ */
+export declare function isValidCashuMintInfo(event?: NostrEvent): event is CashuMintInfoEvent;

package/dist/helpers/mint-info.js

@@ -0,0 +1,80 @@
+import { getOrComputeCachedValue, getTagValue, isHex, safeParse } from "applesauce-core/helpers";
+import { getReplaceableIdentifier } from "applesauce-core/helpers/event";
+// NIP-87 Cashu Mint Information Event Kind
+export const CASHU_MINT_INFO_KIND = 38172;
+// Symbols for caching computed values
+export const CashuMintPubkeySymbol = Symbol.for("cashu-mint-pubkey");
+export const CashuMintURLSymbol = Symbol.for("cashu-mint-url");
+export const CashuMintNutsSymbol = Symbol.for("cashu-mint-nuts");
+export const CashuMintNetworkSymbol = Symbol.for("cashu-mint-network");
+// ============================================================================
+// Cashu Mint Information Event (kind:38172) Helpers
+// ============================================================================
+/**
+ * Returns the mint's pubkey from a kind:38172 cashu mint info event
+ * This is found in the `d` tag and is the pubkey from the mint's `/v1/info` endpoint
+ */
+export function getCashuMintPubkey(event) {
+    return getOrComputeCachedValue(event, CashuMintPubkeySymbol, () => {
+        const identifier = getReplaceableIdentifier(event);
+        // Only return hex pubkeys
+        if (!isHex(identifier))
+            return undefined;
+        return identifier || undefined;
+    });
+}
+export function getCashuMintURL(event) {
+    return getOrComputeCachedValue(event, CashuMintURLSymbol, () => {
+        const url = getTagValue(event, "u");
+        return url && URL.canParse(url) ? url : undefined;
+    });
+}
+/**
+ * Returns the supported nuts from a kind:38172 cashu mint info event
+ * This is a comma-separated list of nut numbers (e.g., "1,2,3,4,5,6,7")
+ */
+export function getCashuMintNuts(event) {
+    return getOrComputeCachedValue(event, CashuMintNutsSymbol, () => {
+        const nutsStr = getTagValue(event, "nuts");
+        if (!nutsStr)
+            return [];
+        return nutsStr
+            .split(",")
+            .map((n) => parseInt(n.trim(), 10))
+            .filter((n) => !isNaN(n));
+    });
+}
+/**
+ * Returns the network type from a kind:38172 cashu mint info event
+ * Should be one of: mainnet, testnet, signet, or regtest
+ */
+export function getCashuMintNetwork(event) {
+    return getOrComputeCachedValue(event, CashuMintNetworkSymbol, () => {
+        const network = getTagValue(event, "n");
+        if (!network)
+            return undefined;
+        const validNetworks = ["mainnet", "testnet", "signet", "regtest"];
+        return validNetworks.includes(network) ? network : undefined;
+    });
+}
+/**
+ * Returns the optional metadata content from a kind:38172 cashu mint info event
+ * This is a kind:0-style metadata JSON object, useful when the pubkey is not a normal user
+ */
+export function getCashuMintMetadata(event) {
+    if (!event.content)
+        return undefined;
+    return safeParse(event.content);
+}
+/**
+ * Validates that an event is a proper kind:38172 cashu mint info event
+ * Checks that the event is kind 38172 and has the required `d` and `u` tags
+ */
+export function isValidCashuMintInfo(event) {
+    if (!event)
+        return false;
+    if (event.kind !== CASHU_MINT_INFO_KIND)
+        return false;
+    const url = getCashuMintURL(event);
+    return url !== undefined;
+}

package/dist/helpers/mint-recommendation.d.ts

@@ -0,0 +1,41 @@
+import { KnownEvent } from "applesauce-core/helpers";
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { AddressPointer } from "applesauce-core/helpers/pointers";
+export declare const MINT_RECOMMENDATION_KIND = 38000;
+export type MintRecommendationEvent = KnownEvent<typeof MINT_RECOMMENDATION_KIND>;
+export declare const RecommendationKindSymbol: unique symbol;
+export declare const RecommendationURLSymbol: unique symbol;
+export declare const RecommendationAddressPointerSymbol: unique symbol;
+/**
+ * Returns the recommended event kind from a kind:38000 recommendation event
+ * This should be 38172 for cashu mints
+ */
+export declare function getRecommendationKind(event: MintRecommendationEvent): number;
+export declare function getRecommendationKind(event: NostrEvent): number | undefined;
+/**
+ * Returns the d-identifier from a kind:38000 recommendation event
+ * This is the kind:38172 event identifier this event is recommending
+ */
+export declare function getRecommendationMintPubkey(event: NostrEvent): string | undefined;
+/**
+ * Returns the URL from a kind:38000 recommendation event
+ * This is an optional `u` tag that provides a recommended way to connect to the cashu mint
+ * Each recommendation event recommends a single mint, so there is at most one `u` tag
+ */
+export declare function getRecommendationURL(event: MintRecommendationEvent): string | undefined;
+export declare function getRecommendationURL(event: NostrEvent): string | undefined;
+/**
+ * Returns the address pointer from a kind:38000 recommendation event
+ * This `a` tag points to the kind:38172 event of the cashu mint
+ * The first value is the event identifier, the second value is a relay hint
+ * Each recommendation event recommends a single mint, so there is at most one `a` tag
+ */
+export declare function getRecommendationAddressPointer(event: MintRecommendationEvent): AddressPointer | undefined;
+export declare function getRecommendationAddressPointer(event: NostrEvent): AddressPointer | undefined;
+/**
+ * Validates that an event is a proper kind:38000 recommendation event
+ * Checks that the event is kind 38000, has the required `k` and `d` tags,
+ * and that the `k` tag is 38172 (cashu mint kind)
+ * Each recommendation event recommends a single cashu mint
+ */
+export declare function isValidMintRecommendation(event?: NostrEvent): event is MintRecommendationEvent;

package/dist/helpers/mint-recommendation.js

@@ -0,0 +1,54 @@
+import { getAddressPointerFromATag, getOrComputeCachedValue, getTagValue, isATag, isHex, } from "applesauce-core/helpers";
+import { getReplaceableIdentifier } from "applesauce-core/helpers/event";
+import { CASHU_MINT_INFO_KIND } from "./mint-info.js";
+// NIP-87 Recommendation Event Kind
+export const MINT_RECOMMENDATION_KIND = 38000;
+// Symbols for caching computed values
+export const RecommendationKindSymbol = Symbol.for("mint-recommendation-kind");
+export const RecommendationURLSymbol = Symbol.for("mint-recommendation-url");
+export const RecommendationAddressPointerSymbol = Symbol.for("mint-recommendation-address-pointer");
+export function getRecommendationKind(event) {
+    return getOrComputeCachedValue(event, RecommendationKindSymbol, () => {
+        const kindStr = getTagValue(event, "k");
+        if (!kindStr)
+            return undefined;
+        const kind = parseInt(kindStr, 10);
+        return isNaN(kind) ? undefined : kind;
+    });
+}
+/**
+ * Returns the d-identifier from a kind:38000 recommendation event
+ * This is the kind:38172 event identifier this event is recommending
+ */
+export function getRecommendationMintPubkey(event) {
+    const identifier = getReplaceableIdentifier(event);
+    if (!isHex(identifier))
+        return undefined;
+    return identifier || undefined;
+}
+export function getRecommendationURL(event) {
+    return getOrComputeCachedValue(event, RecommendationURLSymbol, () => {
+        return getTagValue(event, "u");
+    });
+}
+export function getRecommendationAddressPointer(event) {
+    return getOrComputeCachedValue(event, RecommendationAddressPointerSymbol, () => {
+        const tag = event.tags.find(isATag);
+        return tag ? (getAddressPointerFromATag(tag) ?? undefined) : undefined;
+    });
+}
+/**
+ * Validates that an event is a proper kind:38000 recommendation event
+ * Checks that the event is kind 38000, has the required `k` and `d` tags,
+ * and that the `k` tag is 38172 (cashu mint kind)
+ * Each recommendation event recommends a single cashu mint
+ */
+export function isValidMintRecommendation(event) {
+    if (!event)
+        return false;
+    if (event.kind !== MINT_RECOMMENDATION_KIND)
+        return false;
+    const kind = getRecommendationKind(event);
+    // Only cashu mints (kind 38172) are supported
+    return kind === CASHU_MINT_INFO_KIND;
+}

package/dist/operations/index.d.ts

@@ -3,3 +3,4 @@ export * as Tokens from "./tokens.js";
 export * as Wallet from "./wallet.js";
 export * as ZapInfo from "./nutzap-info.js";
 export * as NutZap from "./nutzap.js";
+export * as MintRecommendation from "./mint-recommendation.js";

package/dist/operations/index.js

@@ -3,3 +3,4 @@ export * as Tokens from "./tokens.js";
 export * as Wallet from "./wallet.js";
 export * as ZapInfo from "./nutzap-info.js";
 export * as NutZap from "./nutzap.js";
+export * as MintRecommendation from "./mint-recommendation.js";

package/dist/operations/mint-recommendation.d.ts

@@ -0,0 +1,13 @@
+import { EventOperation } from "applesauce-core";
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { AddressPointer } from "applesauce-core/helpers/pointers";
+/** Sets the recommended event kind (should be 38172 for cashu mints) */
+export declare function setKind(kind: number): EventOperation;
+/** Sets the mint's pubkey (the `d` tag, which is the replaceable identifier) */
+export declare function setMintPubkey(pubkey: string): EventOperation;
+/** Sets the optional URL to connect to the cashu mint (the `u` tag) */
+export declare function setURL(url: string): EventOperation;
+/** Sets the optional address pointer to the kind:38172 event (the `a` tag) */
+export declare function setAddressPointer(pointer: AddressPointer | NostrEvent | string): EventOperation;
+/** Sets the optional review/comment content */
+export declare function setComment(comment: string): EventOperation;

package/dist/operations/mint-recommendation.js

@@ -0,0 +1,26 @@
+import { modifyPublicTags } from "applesauce-core/operations";
+import { setContent } from "applesauce-core/operations/content";
+import { addAddressPointerTag, setSingletonTag } from "applesauce-core/operations/tag/common";
+/** Sets the recommended event kind (should be 38172 for cashu mints) */
+export function setKind(kind) {
+    return modifyPublicTags(setSingletonTag(["k", kind.toString()]));
+}
+/** Sets the mint's pubkey (the `d` tag, which is the replaceable identifier) */
+export function setMintPubkey(pubkey) {
+    return modifyPublicTags(setSingletonTag(["d", pubkey]));
+}
+/** Sets the optional URL to connect to the cashu mint (the `u` tag) */
+export function setURL(url) {
+    // Enforce valid URL for cashu mints
+    if (url && !URL.canParse(url))
+        throw new Error("Invalid URL");
+    return modifyPublicTags(setSingletonTag(["u", url]));
+}
+/** Sets the optional address pointer to the kind:38172 event (the `a` tag) */
+export function setAddressPointer(pointer) {
+    return modifyPublicTags(addAddressPointerTag(pointer, true));
+}
+/** Sets the optional review/comment content */
+export function setComment(comment) {
+    return setContent(comment);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "applesauce-wallet",
-  "version": "0.0.0-next-20251220152312",
+  "version": "0.0.0-next-20251231055351",
   "description": "",
   "type": "module",
   "main": "dist/index.js",
@@ -16,83 +16,83 @@
   ],
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.js"
     },
     "./helpers": {
+      "types": "./dist/helpers/index.d.ts",
       "import": "./dist/helpers/index.js",
-      "require": "./dist/helpers/index.js",
-      "types": "./dist/helpers/index.d.ts"
+      "require": "./dist/helpers/index.js"
     },
     "./helpers/*": {
+      "types": "./dist/helpers/*.d.ts",
       "import": "./dist/helpers/*.js",
-      "require": "./dist/helpers/*.js",
-      "types": "./dist/helpers/*.d.ts"
+      "require": "./dist/helpers/*.js"
     },
     "./models": {
+      "types": "./dist/models/index.d.ts",
       "import": "./dist/models/index.js",
-      "require": "./dist/models/index.js",
-      "types": "./dist/models/index.d.ts"
+      "require": "./dist/models/index.js"
     },
     "./models/*": {
+      "types": "./dist/models/*.d.ts",
       "import": "./dist/models/*.js",
-      "require": "./dist/models/*.js",
-      "types": "./dist/models/*.d.ts"
+      "require": "./dist/models/*.js"
     },
     "./casts": {
+      "types": "./dist/casts/index.d.ts",
       "import": "./dist/casts/index.js",
-      "require": "./dist/casts/index.js",
-      "types": "./dist/casts/index.d.ts"
+      "require": "./dist/casts/index.js"
     },
     "./casts/*": {
+      "types": "./dist/casts/*.d.ts",
       "import": "./dist/casts/*.js",
-      "require": "./dist/casts/*.js",
-      "types": "./dist/casts/*.d.ts"
+      "require": "./dist/casts/*.js"
     },
     "./blueprints": {
+      "types": "./dist/blueprints/index.d.ts",
       "import": "./dist/blueprints/index.js",
-      "require": "./dist/blueprints/index.js",
-      "types": "./dist/blueprints/index.d.ts"
+      "require": "./dist/blueprints/index.js"
     },
     "./blueprints/*": {
+      "types": "./dist/blueprints/*.d.ts",
       "import": "./dist/blueprints/*.js",
-      "require": "./dist/blueprints/*.js",
-      "types": "./dist/blueprints/*.d.ts"
+      "require": "./dist/blueprints/*.js"
     },
     "./operations": {
+      "types": "./dist/operations/index.d.ts",
       "import": "./dist/operations/index.js",
-      "require": "./dist/operations/index.js",
-      "types": "./dist/operations/index.d.ts"
+      "require": "./dist/operations/index.js"
     },
     "./operations/*": {
+      "types": "./dist/operations/*.d.ts",
       "import": "./dist/operations/*.js",
-      "require": "./dist/operations/*.js",
-      "types": "./dist/operations/*.d.ts"
+      "require": "./dist/operations/*.js"
     },
     "./actions": {
+      "types": "./dist/actions/index.d.ts",
       "import": "./dist/actions/index.js",
-      "require": "./dist/actions/index.js",
-      "types": "./dist/actions/index.d.ts"
+      "require": "./dist/actions/index.js"
     },
     "./actions/*": {
+      "types": "./dist/actions/*.d.ts",
       "import": "./dist/actions/*.js",
-      "require": "./dist/actions/*.js",
-      "types": "./dist/actions/*.d.ts"
+      "require": "./dist/actions/*.js"
     }
   },
   "dependencies": {
     "@cashu/cashu-ts": "^3.1.1",
     "@gandlaf21/bc-ur": "^1.1.12",
-    "applesauce-actions": "0.0.0-next-20251220152312",
-    "applesauce-common": "0.0.0-next-20251220152312",
-    "applesauce-core": "0.0.0-next-20251220152312",
+    "applesauce-actions": "0.0.0-next-20251231055351",
+    "applesauce-common": "0.0.0-next-20251231055351",
+    "applesauce-core": "0.0.0-next-20251231055351",
     "rxjs": "^7.8.1"
   },
   "devDependencies": {
     "@hirez_io/observer-spy": "^2.2.0",
     "@types/debug": "^4.1.12",
-    "applesauce-signers": "0.0.0-next-20251220152312",
+    "applesauce-signers": "0.0.0-next-20251231055351",
     "rimraf": "^6.0.1",
     "typescript": "^5.8.3",
     "vitest": "^4.0.15"