mppx 0.1.1 → 0.2.0

package/dist/Method.d.ts

@@ -0,0 +1,154 @@
+import type * as Challenge from './Challenge.js';
+import type * as Credential from './Credential.js';
+import type { ExactPartial, LooseOmit, MaybePromise } from './internal/types.js';
+import type * as Receipt from './Receipt.js';
+import type * as Transport from './server/Transport.js';
+import type * as z from './zod.js';
+/**
+ * A payment method.
+ */
+export type Method = {
+    name: string;
+    intent: string;
+    schema: {
+        credential: {
+            payload: z.ZodMiniType;
+        };
+        request: z.ZodMiniType<Record<string, unknown>>;
+    };
+};
+/**
+ * Creates a payment method.
+ *
+ * @example
+ * ```ts
+ * import { z } from 'zod/mini'
+ * import { Method } from 'mppx'
+ *
+ * const tempoCharge = Method.from({
+ *   name: 'tempo',
+ *   intent: 'charge',
+ *   schema: {
+ *     credential: {
+ *       payload: z.object({
+ *         signature: z.string(),
+ *         type: z.literal('transaction'),
+ *       }),
+ *     },
+ *     request: z.object({
+ *       amount: z.string(),
+ *       currency: z.string(),
+ *       recipient: z.string(),
+ *     }),
+ *   },
+ * })
+ * ```
+ */
+export declare function from<const method extends Method>(method: method): method;
+/**
+ * A client-side configured method with credential creation logic.
+ */
+export type Client<method extends Method = Method, context extends z.ZodMiniType | undefined = z.ZodMiniType | undefined> = method & {
+    context?: context;
+    createCredential: CreateCredentialFn<method, context extends z.ZodMiniType ? z.output<context> : Record<never, never>>;
+};
+export type AnyClient = Client<any, any>;
+/**
+ * A server-side configured method with verification logic.
+ */
+export type Server<method extends Method = Method, defaults extends ExactPartial<z.input<method['schema']['request']>> = {}, transportOverride = undefined> = method & {
+    defaults?: defaults | undefined;
+    request?: RequestFn<method> | undefined;
+    respond?: RespondFn<method> | undefined;
+    transport?: transportOverride | undefined;
+    verify: VerifyFn<method>;
+};
+export type AnyServer = Server<any, any, any>;
+/** Credential creation function for a single method. */
+export type CreateCredentialFn<method extends Method, context = unknown> = (parameters: {
+    challenge: Challenge.Challenge<z.output<method['schema']['request']>, method['intent'], method['name']>;
+} & ([keyof context] extends [never] ? unknown : {
+    context: context;
+})) => Promise<string>;
+/** Request transform function for a single method. */
+export type RequestFn<method extends Method> = (options: {
+    credential?: Credential.Credential | null | undefined;
+    request: z.input<method['schema']['request']>;
+}) => MaybePromise<z.input<method['schema']['request']>>;
+/** Verification function for a single method. */
+export type VerifyFn<method extends Method> = (parameters: {
+    credential: Credential.Credential<z.output<method['schema']['credential']['payload']>, Challenge.Challenge<z.output<method['schema']['request']>, method['intent'], method['name']>>;
+    request: z.input<method['schema']['request']>;
+}) => Promise<Receipt.Receipt>;
+/**
+ * Optional respond function for a server-side method.
+ *
+ * Called after `verify` succeeds. If it returns a `Response`, the library
+ * treats the request as fully handled (e.g. channel open/close) and
+ * `withReceipt()` will short-circuit — returning the management response
+ * with the receipt header attached without invoking any user-supplied
+ * response or generator. If it returns `undefined`, the server handler
+ * is expected to serve content via `withReceipt(response)`.
+ *
+ * **HTTP-only.** The `input` parameter is a `Request` object; MCP transports
+ * do not invoke this hook.
+ */
+export type RespondFn<method extends Method> = (parameters: {
+    credential: Credential.Credential<z.output<method['schema']['credential']['payload']>, Challenge.Challenge<z.output<method['schema']['request']>, method['intent'], method['name']>>;
+    input: globalThis.Request;
+    receipt: Receipt.Receipt;
+    request: z.input<method['schema']['request']>;
+}) => MaybePromise<globalThis.Response | undefined>;
+/** Partial request type for defaults. */
+export type RequestDefaults<method extends Method> = ExactPartial<z.input<method['schema']['request']>>;
+/** Makes fields optional if they exist in defaults. */
+export type WithDefaults<request, defaults> = [keyof defaults] extends [never] ? request : LooseOmit<request, keyof defaults & string> & ExactPartial<Pick<request, keyof defaults & keyof request>>;
+/**
+ * Extends a method with client-side credential creation logic.
+ *
+ * @example
+ * ```ts
+ * import { Method } from 'mppx'
+ * import { Methods } from 'mppx/tempo'
+ *
+ * const tempoCharge = Method.toClient(Methods.charge, {
+ *   async createCredential({ challenge }) {
+ *     return Credential.serialize({ challenge, payload: { ... } })
+ *   },
+ * })
+ * ```
+ */
+export declare function toClient<const method extends Method, const context extends z.ZodMiniType | undefined = undefined>(method: method, options: toClient.Options<method, context>): Client<method, context>;
+export declare namespace toClient {
+    type Options<method extends Method, context extends z.ZodMiniType | undefined = undefined> = {
+        context?: context;
+        createCredential: CreateCredentialFn<method, context extends z.ZodMiniType ? z.output<context> : Record<never, never>>;
+    };
+}
+/**
+ * Extends a method with server-side verification logic.
+ *
+ * @example
+ * ```ts
+ * import { Method } from 'mppx'
+ * import { Methods } from 'mppx/tempo'
+ *
+ * const tempoCharge = Method.toServer(Methods.charge, {
+ *   async verify({ credential }) {
+ *     // verification logic
+ *     return { status: 'success', ... }
+ *   },
+ * })
+ * ```
+ */
+export declare function toServer<const method extends Method, const defaults extends RequestDefaults<method> = {}, const transportOverride extends Transport.AnyTransport | undefined = undefined>(method: method, options: toServer.Options<method, defaults, transportOverride>): Server<method, defaults, transportOverride>;
+export declare namespace toServer {
+    type Options<method extends Method, defaults extends RequestDefaults<method> = {}, transportOverride extends Transport.AnyTransport | undefined = undefined> = {
+        defaults?: defaults | undefined;
+        request?: RequestFn<method> | undefined;
+        respond?: RespondFn<method> | undefined;
+        transport?: transportOverride | undefined;
+        verify: VerifyFn<method>;
+    };
+}
+//# sourceMappingURL=Method.d.ts.map

package/dist/Method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Method.d.ts","sourceRoot":"","sources":["../src/Method.ts"],"names":[],"mappings":"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"}

package/dist/Method.js

@@ -0,0 +1,81 @@
+/**
+ * Creates a payment method.
+ *
+ * @example
+ * ```ts
+ * import { z } from 'zod/mini'
+ * import { Method } from 'mppx'
+ *
+ * const tempoCharge = Method.from({
+ *   name: 'tempo',
+ *   intent: 'charge',
+ *   schema: {
+ *     credential: {
+ *       payload: z.object({
+ *         signature: z.string(),
+ *         type: z.literal('transaction'),
+ *       }),
+ *     },
+ *     request: z.object({
+ *       amount: z.string(),
+ *       currency: z.string(),
+ *       recipient: z.string(),
+ *     }),
+ *   },
+ * })
+ * ```
+ */
+export function from(method) {
+    return method;
+}
+/**
+ * Extends a method with client-side credential creation logic.
+ *
+ * @example
+ * ```ts
+ * import { Method } from 'mppx'
+ * import { Methods } from 'mppx/tempo'
+ *
+ * const tempoCharge = Method.toClient(Methods.charge, {
+ *   async createCredential({ challenge }) {
+ *     return Credential.serialize({ challenge, payload: { ... } })
+ *   },
+ * })
+ * ```
+ */
+export function toClient(method, options) {
+    const { context, createCredential } = options;
+    return {
+        ...method,
+        context,
+        createCredential,
+    };
+}
+/**
+ * Extends a method with server-side verification logic.
+ *
+ * @example
+ * ```ts
+ * import { Method } from 'mppx'
+ * import { Methods } from 'mppx/tempo'
+ *
+ * const tempoCharge = Method.toServer(Methods.charge, {
+ *   async verify({ credential }) {
+ *     // verification logic
+ *     return { status: 'success', ... }
+ *   },
+ * })
+ * ```
+ */
+export function toServer(method, options) {
+    const { defaults, request, respond, transport, verify } = options;
+    return {
+        ...method,
+        defaults,
+        request,
+        respond,
+        transport,
+        verify,
+    };
+}
+//# sourceMappingURL=Method.js.map

package/dist/Method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Method.js","sourceRoot":"","sources":["../src/Method.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,IAAI,CAA8B,MAAc;IAC9D,OAAO,MAAM,CAAA;AACf,CAAC;AA6FD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAGtB,MAAc,EAAE,OAA0C;IAC1D,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAA;IAC7C,OAAO;QACL,GAAG,MAAM;QACT,OAAO;QACP,gBAAgB;KACU,CAAA;AAC9B,CAAC;AAYD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,QAAQ,CAKtB,MAAc,EACd,OAA8D;IAE9D,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IACjE,OAAO;QACL,GAAG,MAAM;QACT,QAAQ;QACR,OAAO;QACP,OAAO;QACP,SAAS;QACT,MAAM;KACwC,CAAA;AAClD,CAAC"}

package/dist/PaymentRequest.d.ts

@@ -1,5 +1,5 @@
 import type { Compute } from './internal/types.js';
-import type * as MethodIntent from './MethodIntent.js';
+import type * as Method from './Method.js';
 import type * as z from './zod.js';
 /**
  * Intent-specific payment parameters.
@@ -51,16 +51,16 @@ export declare function from<const request extends Request>(request: request): r
 /**
  * Creates a validated request from a method intent.
  *
- * @param intent - The method intent to validate against.
+ * @param method - The method to validate against.
  * @param request - Request parameters.
  * @returns A validated request.
  *
  * @example
  * ```ts
  * import { Request } from 'mppx'
- * import { Intents } from 'mppx/tempo'
+ * import { Methods } from 'mppx/tempo'
  *
- * const request = Request.fromIntent(Intents.charge, {
+ * const request = Request.fromIntent(Methods.charge, {
  *   amount: '1000000',
  *   currency: '0x20c0000000000000000000000000000000000001',
  *   recipient: '0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00',
@@ -69,7 +69,7 @@ export declare function from<const request extends Request>(request: request): r
  * })
  * ```
  */
-export declare function fromIntent<const intent extends MethodIntent.MethodIntent>(intent: intent, request: z.input<intent['schema']['request']>): Request<z.output<intent['schema']['request']>>;
+export declare function fromIntent<const method extends Method.Method>(method: method, request: z.input<method['schema']['request']>): Request<z.output<method['schema']['request']>>;
 /**
  * Serializes a request to a base64url string.
  *

package/dist/PaymentRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PaymentRequest.d.ts","sourceRoot":"","sources":["../src/PaymentRequest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,KAAK,CAAC,MAAM,UAAU,CAAA;AAElC;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,OAAO,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACnF,OAAO,CAAC,OAAO,CAAC,CAAA;AAElB;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,KAAK,CAAC,OAAO,SAAS,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,MAAM,SAAS,YAAY,CAAC,YAAY,EACvE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,GAC5C,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAEhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGlD"}
+{"version":3,"file":"PaymentRequest.d.ts","sourceRoot":"","sources":["../src/PaymentRequest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,KAAK,CAAC,MAAM,UAAU,CAAA;AAElC;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,OAAO,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACnF,OAAO,CAAC,OAAO,CAAC,CAAA;AAElB;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,KAAK,CAAC,OAAO,SAAS,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAC3D,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,GAC5C,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAEhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGlD"}

package/dist/PaymentRequest.js

@@ -39,16 +39,16 @@ export function from(request) {
 /**
  * Creates a validated request from a method intent.
  *
- * @param intent - The method intent to validate against.
+ * @param method - The method to validate against.
  * @param request - Request parameters.
  * @returns A validated request.
  *
  * @example
  * ```ts
  * import { Request } from 'mppx'
- * import { Intents } from 'mppx/tempo'
+ * import { Methods } from 'mppx/tempo'
  *
- * const request = Request.fromIntent(Intents.charge, {
+ * const request = Request.fromIntent(Methods.charge, {
  *   amount: '1000000',
  *   currency: '0x20c0000000000000000000000000000000000001',
  *   recipient: '0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00',
@@ -57,8 +57,8 @@ export function from(request) {
  * })
  * ```
  */
-export function fromIntent(intent, request) {
-    return intent.schema.request.parse(request);
+export function fromIntent(method, request) {
+    return method.schema.request.parse(request);
 }
 /**
  * Serializes a request to a base64url string.

package/dist/cli.js

@@ -34,15 +34,16 @@ cli
     .option('-L, --location', 'Follow redirects')
     .option('-X, --method <method>', 'HTTP method')
     .option('--channel <id>', 'Reuse existing stream channel ID')
+    .option('--confirm', 'Show confirmation prompts')
     .option('--deposit <amount>', 'Deposit amount for stream payments (human-readable units)')
     .option('--json <json>', 'Send JSON body (sets Content-Type and Accept, implies POST)')
-    .option('--yes', 'Skip confirmation prompts')
     .example(`${name} example.com/content`)
     .example(`${name} example.com/api --json '{"key":"value"}'`)
     .action(async (rawUrl, rawOptions) => {
     const options = parseOptions(z.object({
         account: z.optional(z.string()),
         channel: z.optional(z.coerce.string()),
+        confirm: z.optional(z.boolean()),
         data: z.optional(z.string()),
         deposit: z.optional(z.union([z.string(), z.number()])),
         fail: z.optional(z.boolean()),
@@ -56,7 +57,6 @@ cli
         silent: z.optional(z.boolean()),
         userAgent: z.optional(z.string()),
         verbose: z.optional(z.boolean()),
-        yes: z.optional(z.boolean()),
     }), rawOptions);
     if (!rawUrl) {
         cli.outputHelp();
@@ -65,7 +65,7 @@ cli
     const silent = options.silent ?? false;
     const info = silent ? (_msg) => { } : (msg) => process.stderr.write(msg);
     if (silent)
-        options.yes = true;
+        options.confirm = false;
     const accountName = resolveAccountName(options.account);
     const privateKey = process.env.MPPX_PRIVATE_KEY ?? (await createKeychain(accountName).get());
     if (!privateKey) {
@@ -257,9 +257,9 @@ cli
                         info(`${indent}${line}\n`);
                 }
             }
-            info('\n');
-            if (!options.yes) {
-                const ok = await confirm(`Proceed with ${challenge.intent}?`);
+            if (options.confirm) {
+                info('\n');
+                const ok = await confirm(`Proceed with ${challenge.intent}?`, true);
                 if (!ok) {
                     info('Aborted.\n');
                     process.exit(0);
@@ -314,7 +314,7 @@ cli
                 const depositDisplay = depositRaw
                     ? ` ${pc.dim(`(deposit ${depositRaw} ${tokenSymbol})`)}`
                     : '';
-                info(`${pc.dim(`Channel opened ${parsed.payload.channelId}`)}${depositDisplay}\n`);
+                info(`\n${pc.dim(`Channel opened ${parsed.payload.channelId}`)}${depositDisplay}\n`);
             }
         }
         const credentialFetchInit = {
@@ -361,11 +361,26 @@ cli
                     }
                     info(`\n${pc.bold(pc.green('Payment Receipt'))}\n`);
                     const rows = [];
+                    const channelId = receiptJson.channelId;
+                    const reference = receiptJson.reference;
+                    const skipReference = channelId && reference && channelId === reference;
+                    const receiptBalanceKeys = new Set(['acceptedCumulative', 'spent']);
                     for (const [key, value] of Object.entries(receiptJson)) {
                         if (value === undefined || shownKeys.has(key))
                             continue;
-                        if (key === 'reference' && typeof value === 'string' && explorerUrl)
+                        if (key === 'reference' && skipReference)
+                            continue;
+                        if (receiptBalanceKeys.has(key) && typeof value === 'string') {
+                            rows.push([
+                                key,
+                                `${value} ${pc.dim(`(${fmtBalance(BigInt(value), tokenSymbol, tokenDecimals)})`)}`,
+                            ]);
+                        }
+                        else if ((key === 'reference' || key === 'txHash') &&
+                            typeof value === 'string' &&
+                            explorerUrl) {
                             rows.push([key, pc.link(`${explorerUrl}/tx/${value}`, value)]);
+                        }
                         else
                             rows.push([key, String(value)]);
                     }
@@ -400,7 +415,7 @@ cli
                     ? BigInt(streamCred.payload.cumulativeAmount)
                     : 0n;
                 let _voucherSeq = 0;
-                const termBg = await detectTerminalBg();
+                const termBg = verbose ? await detectTerminalBg() : undefined;
                 const chunkBgs = (() => {
                     if (!termBg || !pc.isColorSupported)
                         return undefined;
@@ -476,10 +491,13 @@ cli
                                 const receipt = JSON.parse(data);
                                 info(`\n\n${pc.bold(pc.green('Payment Receipt'))}\n`);
                                 const rows = [];
+                                const skipRef = receipt.channelId &&
+                                    receipt.reference &&
+                                    receipt.channelId === receipt.reference;
                                 for (const [key, value] of Object.entries(receipt)) {
                                     if (value === undefined || shownKeys.has(key))
                                         continue;
-                                    if (key === 'channelId' && value === receipt.reference)
+                                    if (key === 'reference' && skipRef)
                                         continue;
                                     const receiptBalanceKeys = ['acceptedCumulative', 'spent'];
                                     if (receiptBalanceKeys.includes(key) && typeof value === 'string') {
@@ -488,8 +506,11 @@ cli
                                             `${value} ${pc.dim(`(${fmtBalance(BigInt(value), tokenSymbol, tokenDecimals)})`)}`,
                                         ]);
                                     }
-                                    else if (key === 'reference' && typeof value === 'string' && explorerUrl)
+                                    else if ((key === 'reference' || key === 'txHash') &&
+                                        typeof value === 'string' &&
+                                        explorerUrl) {
                                         rows.push([key, pc.link(`${explorerUrl}/tx/${value}`, value)]);
+                                    }
                                     else
                                         rows.push([key, String(value)]);
                                 }
@@ -546,7 +567,20 @@ cli
                         headers: { Authorization: closeCred },
                     });
                     if (closeRes.ok) {
-                        info(`\n${pc.dim('Channel closed.')} ${pc.dim(`Spent ${fmtBalance(cumulativeAmount, tokenSymbol, tokenDecimals)}.`)}\n`);
+                        const closeReceiptHeader = closeRes.headers.get('Payment-Receipt');
+                        let closeTxHash;
+                        if (closeReceiptHeader) {
+                            try {
+                                const r = JSON.parse(Base64.toString(closeReceiptHeader));
+                                if (typeof r.txHash === 'string')
+                                    closeTxHash = r.txHash;
+                            }
+                            catch { }
+                        }
+                        const txInfo = closeTxHash && explorerUrl
+                            ? ` ${pc.dim(pc.link(`${explorerUrl}/tx/${closeTxHash}`, closeTxHash))}`
+                            : '';
+                        info(`\n${pc.dim('Channel closed.')} ${pc.dim(`Spent ${fmtBalance(cumulativeAmount, tokenSymbol, tokenDecimals)}.`)}${txInfo}\n`);
                     }
                     else {
                         info(`\n${pc.dim(pc.yellow('Channel close failed'))} ${pc.dim(`(${closeRes.status})`)}\n`);
@@ -561,10 +595,10 @@ cli
                     streamChannelId &&
                     streamEscrowContract &&
                     streamChainId;
-                if (shouldClose && !options.yes) {
+                if (shouldClose && options.confirm) {
                     info('\n');
                 }
-                if (shouldClose && !(options.yes || (await confirm('Close channel?')))) {
+                if (shouldClose && options.confirm && !(await confirm('Close channel?', true))) {
                     info(`${pc.dim('Kept channel open.')}\n`);
                 }
                 else if (shouldClose) {
@@ -589,7 +623,20 @@ cli
                     });
                     if (closeRes.ok) {
                         deleteChannelState(streamChannelId);
-                        info(`${pc.dim('Channel closed.')} ${pc.dim(`Spent ${fmtBalance(streamCumulativeAmount, tokenSymbol, tokenDecimals)}.`)}\n`);
+                        const closeReceiptHeader = closeRes.headers.get('Payment-Receipt');
+                        let closeTxHash;
+                        if (closeReceiptHeader) {
+                            try {
+                                const r = JSON.parse(Base64.toString(closeReceiptHeader));
+                                if (typeof r.txHash === 'string')
+                                    closeTxHash = r.txHash;
+                            }
+                            catch { }
+                        }
+                        const txInfo = closeTxHash && explorerUrl
+                            ? ` ${pc.dim(pc.link(`${explorerUrl}/tx/${closeTxHash}`, closeTxHash))}`
+                            : '';
+                        info(`\n${pc.dim('Channel closed.')} ${pc.dim(`Spent ${fmtBalance(streamCumulativeAmount, tokenSymbol, tokenDecimals)}.`)}${txInfo}\n`);
                     }
                     else {
                         const closeBody = await closeRes.text().catch(() => '');
@@ -1024,12 +1071,14 @@ function prompt(message) {
         });
     });
 }
-function confirm(prompt) {
+function confirm(prompt, defaultYes = false) {
     const reader = readline.createInterface({ input: process.stdin, output: process.stderr });
     return new Promise((resolve) => {
-        reader.question(`${pc.bold(`▸ ${prompt}`)} ${pc.dim('(y/N)')} `, (answer) => {
+        const hint = defaultYes ? '(Y/n)' : '(y/N)';
+        reader.question(`${pc.bold(`▸ ${prompt}`)} ${pc.dim(hint)} `, (answer) => {
             reader.close();
-            resolve(answer.trim().toLowerCase() === 'y');
+            const trimmed = answer.trim().toLowerCase();
+            resolve(trimmed === '' ? defaultYes : trimmed === 'y');
         });
     });
 }