mppx 0.6.19 → 0.6.20

package/dist/tempo/client/Methods.d.ts

@@ -1,6 +1,7 @@
 import { charge as charge_ } from './Charge.js';
 import { session as sessionIntent_ } from './Session.js';
 import { sessionManager as session_ } from './SessionManager.js';
+import { subscription as subscription_ } from './Subscription.js';
 /**
  * Creates both Tempo `charge` and `session` client methods from shared parameters.
  *
@@ -183,5 +184,7 @@ export declare namespace tempo {
     const charge: typeof charge_;
     /** Creates a client-side streaming session for managing payment channels. */
     const session: typeof session_;
+    /** Creates a Tempo `subscription` client method for recurring TIP-20 payments. */
+    const subscription: typeof subscription_;
 }
 //# sourceMappingURL=Methods.d.ts.map

package/dist/tempo/client/Methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Methods.d.ts","sourceRoot":"","sources":["../../../src/tempo/client/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,cAAc,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEhE;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,UAAU,GAAE,KAAK,CAAC,UAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAEtD;AAED,yBAAiB,KAAK,CAAC;IACrB,KAAY,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,cAAc,CAAC,UAAU,CAAA;IAEvE,kFAAkF;IAC3E,MAAM,MAAM,gBAAU,CAAA;IAC7B,6EAA6E;IACtE,MAAM,OAAO,iBAAW,CAAA;CAChC"}
+{"version":3,"file":"Methods.d.ts","sourceRoot":"","sources":["../../../src/tempo/client/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,cAAc,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjE;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,UAAU,GAAE,KAAK,CAAC,UAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAEtD;AAED,yBAAiB,KAAK,CAAC;IACrB,KAAY,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,cAAc,CAAC,UAAU,CAAA;IAEvE,kFAAkF;IAC3E,MAAM,MAAM,gBAAU,CAAA;IAC7B,6EAA6E;IACtE,MAAM,OAAO,iBAAW,CAAA;IAC/B,kFAAkF;IAC3E,MAAM,YAAY,sBAAgB,CAAA;CAC1C"}

package/dist/tempo/client/Methods.js

@@ -1,6 +1,7 @@
 import { charge as charge_ } from './Charge.js';
 import { session as sessionIntent_ } from './Session.js';
 import { sessionManager as session_ } from './SessionManager.js';
+import { subscription as subscription_ } from './Subscription.js';
 /**
  * Creates both Tempo `charge` and `session` client methods from shared parameters.
  *
@@ -21,5 +22,7 @@ export function tempo(parameters = {}) {
     tempo.charge = charge_;
     /** Creates a client-side streaming session for managing payment channels. */
     tempo.session = session_;
+    /** Creates a Tempo `subscription` client method for recurring TIP-20 payments. */
+    tempo.subscription = subscription_;
 })(tempo || (tempo = {}));
 //# sourceMappingURL=Methods.js.map

package/dist/tempo/client/Methods.js.map

@@ -1 +1 @@
-{"version":3,"file":"Methods.js","sourceRoot":"","sources":["../../../src/tempo/client/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,cAAc,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEhE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,aAA+B,EAAE;IACrD,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAU,CAAA;AACnE,CAAC;AAED,WAAiB,KAAK;IAGpB,kFAAkF;IACrE,YAAM,GAAG,OAAO,CAAA;IAC7B,6EAA6E;IAChE,aAAO,GAAG,QAAQ,CAAA;AACjC,CAAC,EAPgB,KAAK,KAAL,KAAK,QAOrB"}
+{"version":3,"file":"Methods.js","sourceRoot":"","sources":["../../../src/tempo/client/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,cAAc,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,aAA+B,EAAE;IACrD,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAU,CAAA;AACnE,CAAC;AAED,WAAiB,KAAK;IAGpB,kFAAkF;IACrE,YAAM,GAAG,OAAO,CAAA;IAC7B,6EAA6E;IAChE,aAAO,GAAG,QAAQ,CAAA;IAC/B,kFAAkF;IACrE,kBAAY,GAAG,aAAa,CAAA;AAC3C,CAAC,EATgB,KAAK,KAAL,KAAK,QASrB"}

package/dist/tempo/client/Subscription.d.ts

@@ -0,0 +1,114 @@
+import type { MaybePromise } from '../../internal/types.js';
+import * as Method from '../../Method.js';
+import * as Account from '../../viem/Account.js';
+import * as Client from '../../viem/Client.js';
+import * as z from '../../zod.js';
+import * as Methods from '../Methods.js';
+import type { SubscriptionAccessKey } from '../subscription/Types.js';
+/** Context accepted by the Tempo subscription client method. */
+export declare const subscriptionContextSchema: z.ZodMiniObject<{
+    accessKey: z.ZodMiniOptional<z.ZodMiniCustom<SubscriptionAccessKey, SubscriptionAccessKey>>;
+    account: z.ZodMiniOptional<z.ZodMiniCustom<`0x${string}` | Account.Account | undefined, `0x${string}` | Account.Account | undefined>>;
+}, z.core.$strip>;
+/** Runtime context for creating a Tempo subscription credential. */
+export type SubscriptionContext = z.infer<typeof subscriptionContextSchema>;
+/** Creates a Tempo subscription client method. */
+export declare function subscription(parameters?: subscription.Parameters): Method.Client<{
+    readonly name: "tempo";
+    readonly intent: "subscription";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: z.ZodMiniObject<{
+                signature: z.ZodMiniString<string>;
+                type: z.ZodMiniLiteral<"keyAuthorization">;
+            }, z.core.$strip>;
+        };
+        readonly request: z.ZodMiniPipe<z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            accessKey: z.ZodMiniOptional<z.ZodMiniObject<{
+                accessKeyAddress: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<`0x${string}`, string>>;
+                keyType: z.ZodMiniEnum<{
+                    secp256k1: "secp256k1";
+                    p256: "p256";
+                    webAuthn: "webAuthn";
+                }>;
+            }, z.core.$strip>>;
+            chainId: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+            currency: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<`0x${string}`, string>>;
+            decimals: z.ZodMiniNumber<number>;
+            description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            externalId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            methodDetails: z.ZodMiniOptional<z.ZodMiniObject<{
+                accessKey: z.ZodMiniOptional<z.ZodMiniObject<{
+                    accessKeyAddress: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<`0x${string}`, string>>;
+                    keyType: z.ZodMiniEnum<{
+                        secp256k1: "secp256k1";
+                        p256: "p256";
+                        webAuthn: "webAuthn";
+                    }>;
+                }, z.core.$strip>>;
+                chainId: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+            }, z.core.$strip>>;
+            periodCount: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniBigInt<bigint>, z.ZodMiniCustom<number, number>]>, z.ZodMiniTransform<string, string | number | bigint>>;
+            periodUnit: z.ZodMiniEnum<{
+                day: "day";
+                week: "week";
+            }>;
+            recipient: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<`0x${string}`, string>>;
+            subscriptionExpires: z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniCustom<Date, Date>]>, z.ZodMiniTransform<Date, z.DatetimeInput>>;
+        }, z.core.$strip>, z.ZodMiniTransform<{
+            methodDetails?: {
+                accessKey?: z.infer<z.ZodMiniObject<{
+                    accessKeyAddress: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<`0x${string}`, string>>;
+                    keyType: z.ZodMiniEnum<{
+                        secp256k1: "secp256k1";
+                        p256: "p256";
+                        webAuthn: "webAuthn";
+                    }>;
+                }, z.core.$strip>> | undefined;
+                chainId?: number | undefined;
+            } | undefined;
+            amount: string;
+            subscriptionExpires: string;
+            currency: `0x${string}`;
+            periodCount: string;
+            periodUnit: "day" | "week";
+            recipient: `0x${string}`;
+            description?: string | undefined;
+            externalId?: string | undefined;
+        }, {
+            amount: string;
+            currency: `0x${string}`;
+            decimals: number;
+            periodCount: string;
+            periodUnit: "day" | "week";
+            recipient: `0x${string}`;
+            subscriptionExpires: Date;
+            accessKey?: {
+                accessKeyAddress: `0x${string}`;
+                keyType: "secp256k1" | "p256" | "webAuthn";
+            } | undefined;
+            chainId?: number | undefined;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            methodDetails?: {
+                accessKey?: {
+                    accessKeyAddress: `0x${string}`;
+                    keyType: "secp256k1" | "p256" | "webAuthn";
+                } | undefined;
+                chainId?: number | undefined;
+            } | undefined;
+        }>>;
+    };
+}, z.ZodMiniObject<{
+    accessKey: z.ZodMiniOptional<z.ZodMiniCustom<SubscriptionAccessKey, SubscriptionAccessKey>>;
+    account: z.ZodMiniOptional<z.ZodMiniCustom<`0x${string}` | Account.Account | undefined, `0x${string}` | Account.Account | undefined>>;
+}, z.core.$strip>>;
+export declare namespace subscription {
+    /** Parameters for creating a Tempo subscription credential. */
+    type Parameters = Account.getResolver.Parameters & Client.getResolver.Parameters & {
+        accessKey?: SubscriptionAccessKey | undefined;
+        validateRequest?: ((request: ReturnType<typeof Methods.subscription.schema.request.parse>) => MaybePromise<void>) | undefined;
+    };
+}
+//# sourceMappingURL=Subscription.d.ts.map

package/dist/tempo/client/Subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Subscription.d.ts","sourceRoot":"","sources":["../../../src/tempo/client/Subscription.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,uBAAuB,CAAA;AAChD,OAAO,KAAK,MAAM,MAAM,sBAAsB,CAAA;AAC9C,OAAO,KAAK,CAAC,MAAM,cAAc,CAAA;AAEjC,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AASxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAIrE,gEAAgE;AAChE,eAAO,MAAM,yBAAyB;;;iBAGpC,CAAA;AAEF,oEAAoE;AACpE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,UAAU,GAAE,YAAY,CAAC,UAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAwDpE;AAqDD,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,+DAA+D;IAC/D,KAAK,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,GAC9C,MAAM,CAAC,WAAW,CAAC,UAAU,GAAG;QAC9B,SAAS,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAA;QAC7C,eAAe,CAAC,EACZ,CAAC,CACC,OAAO,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAClE,YAAY,CAAC,IAAI,CAAC,CAAC,GACxB,SAAS,CAAA;KACd,CAAA;CACJ"}

package/dist/tempo/client/Subscription.js

@@ -0,0 +1,100 @@
+import { KeyAuthorization } from 'ox/tempo';
+import { isAddressEqual } from 'viem';
+import { tempo as tempo_chain } from 'viem/chains';
+import * as Credential from '../../Credential.js';
+import * as Method from '../../Method.js';
+import * as Account from '../../viem/Account.js';
+import * as Client from '../../viem/Client.js';
+import * as z from '../../zod.js';
+import * as defaults from '../internal/defaults.js';
+import * as Methods from '../Methods.js';
+import { getSubscriptionRpcAllowedCalls, signSubscriptionKeyAuthorization, toSubscriptionExpiryDate, toSubscriptionExpirySeconds, toSubscriptionPeriodSeconds, verifySubscriptionKeyAuthorization, } from '../subscription/KeyAuthorization.js';
+/** Context accepted by the Tempo subscription client method. */
+export const subscriptionContextSchema = z.object({
+    accessKey: z.optional(z.custom()),
+    account: z.optional(z.custom()),
+});
+/** Creates a Tempo subscription client method. */
+export function subscription(parameters = {}) {
+    const getClient = Client.getResolver({
+        chain: tempo_chain,
+        getClient: parameters.getClient,
+        rpcUrl: defaults.rpcUrl,
+    });
+    const getAccount = Account.getResolver({ account: parameters.account });
+    return Method.toClient(Methods.subscription, {
+        context: subscriptionContextSchema,
+        async createCredential({ challenge, context }) {
+            const chainId = challenge.request.methodDetails?.chainId ?? defaults.chainId.testnet;
+            const client = await getClient({ chainId });
+            const account = getAccount(client, context);
+            const accessKey = context?.accessKey ?? parameters.accessKey ?? challenge.request.methodDetails?.accessKey;
+            if (!accessKey) {
+                throw new Error('No `accessKey` provided. The subscription challenge must include `accessKey`, or the client must pass one to parameters/context.');
+            }
+            assertSubscriptionRequestRepresentable(challenge.request);
+            await parameters.validateRequest?.(challenge.request);
+            const keyAuthorization = await authorizeAccessKey(client, {
+                accessKey,
+                account,
+                chainId,
+                request: challenge.request,
+            });
+            const verified = verifySubscriptionKeyAuthorization({
+                accessKey,
+                chainId,
+                payload: {
+                    signature: KeyAuthorization.serialize(keyAuthorization),
+                    type: 'keyAuthorization',
+                },
+                request: challenge.request,
+            });
+            if (!isAddressEqual(verified.source.address, account.address)) {
+                throw new Error('keyAuthorization signer does not match the selected account');
+            }
+            return Credential.serialize({
+                challenge,
+                payload: {
+                    signature: KeyAuthorization.serialize(keyAuthorization),
+                    type: 'keyAuthorization',
+                },
+                source: `did:pkh:eip155:${chainId}:${account.address.toLowerCase()}`,
+            });
+        },
+    });
+}
+async function authorizeAccessKey(client, parameters) {
+    const { accessKey, account, chainId, request } = parameters;
+    const local = await signSubscriptionKeyAuthorization({
+        accessKey,
+        account,
+        chainId,
+        request,
+    });
+    if (local)
+        return local;
+    const result = (await client.request({
+        method: 'wallet_authorizeAccessKey',
+        params: [
+            {
+                address: accessKey.accessKeyAddress,
+                allowedCalls: getSubscriptionRpcAllowedCalls(request),
+                expiry: toSubscriptionExpirySeconds(toSubscriptionExpiryDate(request.subscriptionExpires)),
+                keyType: accessKey.keyType,
+                limits: [
+                    {
+                        token: request.currency,
+                        limit: BigInt(request.amount),
+                        period: toSubscriptionPeriodSeconds(request),
+                    },
+                ],
+            },
+        ],
+    }));
+    return KeyAuthorization.fromRpc(result.keyAuthorization);
+}
+function assertSubscriptionRequestRepresentable(request) {
+    toSubscriptionPeriodSeconds(request);
+    toSubscriptionExpirySeconds(toSubscriptionExpiryDate(request.subscriptionExpires));
+}
+//# sourceMappingURL=Subscription.js.map

package/dist/tempo/client/Subscription.js.map

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

package/dist/tempo/client/index.d.ts

@@ -1,6 +1,7 @@
 export { charge } from './Charge.js';
 export { tempo } from './Methods.js';
 export { session } from './Session.js';
+export { subscription } from './Subscription.js';
 export type { PaymentResponse, SessionManager } from './SessionManager.js';
 export { sessionManager } from './SessionManager.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tempo/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tempo/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tempo/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/tempo/client/index.js

@@ -1,5 +1,6 @@
 export { charge } from './Charge.js';
 export { tempo } from './Methods.js';
 export { session } from './Session.js';
+export { subscription } from './Subscription.js';
 export { sessionManager } from './SessionManager.js';
 //# sourceMappingURL=index.js.map

package/dist/tempo/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tempo/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tempo/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/tempo/index.d.ts

@@ -1,4 +1,5 @@
 export * as Proof from './Proof.js';
 export * as Methods from './Methods.js';
 export * as Session from './session/index.js';
+export * as Subscription from './subscription/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tempo/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tempo/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tempo/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAA"}

package/dist/tempo/index.js

@@ -1,4 +1,5 @@
 export * as Proof from './Proof.js';
 export * as Methods from './Methods.js';
 export * as Session from './session/index.js';
+export * as Subscription from './subscription/index.js';
 //# sourceMappingURL=index.js.map

package/dist/tempo/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tempo/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tempo/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAA"}

package/dist/tempo/server/Methods.d.ts

@@ -1,6 +1,7 @@
 import * as Ws_ from '../session/Ws.js';
 import { charge as charge_ } from './Charge.js';
 import { session as session_, settle as settle_ } from './Session.js';
+import { renew as renewSubscription_, subscription as subscription_ } from './Subscription.js';
 /**
  * Creates both Tempo `charge` and `session` methods from shared parameters.
  *
@@ -160,6 +161,10 @@ export declare namespace tempo {
     const charge: typeof charge_;
     /** Creates a Tempo `session` method for session-based TIP-20 token payments. */
     const session: typeof session_;
+    /** Creates a Tempo `subscription` method for recurring TIP-20 token payments. */
+    const subscription: typeof subscription_;
+    /** Renews an overdue Tempo subscription outside of the HTTP request path. */
+    const renewSubscription: typeof renewSubscription_;
     /** One-shot settle: reads highest voucher from storage and submits on-chain. */
     const settle: typeof settle_;
     /** Experimental websocket helpers for Tempo sessions. */

package/dist/tempo/server/Methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Methods.d.ts","sourceRoot":"","sources":["../../../src/tempo/server/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,cAAc,CAAA;AAErE;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,KAAK,CAAC,UAAU,SAAS,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAKvF;AAED,yBAAiB,KAAK,CAAC;IACrB,KAAY,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAA;IAEjE,2EAA2E;IACpE,MAAM,MAAM,gBAAU,CAAA;IAC7B,gFAAgF;IACzE,MAAM,OAAO,iBAAW,CAAA;IAC/B,gFAAgF;IACzE,MAAM,MAAM,gBAAU,CAAA;IAC7B,yDAAyD;IAClD,MAAM,EAAE,YAAM,CAAA;CACtB"}
+{"version":3,"file":"Methods.d.ts","sourceRoot":"","sources":["../../../src/tempo/server/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EAAE,KAAK,IAAI,kBAAkB,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAE9F;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,KAAK,CAAC,UAAU,SAAS,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAKvF;AAED,yBAAiB,KAAK,CAAC;IACrB,KAAY,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAA;IAEjE,2EAA2E;IACpE,MAAM,MAAM,gBAAU,CAAA;IAC7B,gFAAgF;IACzE,MAAM,OAAO,iBAAW,CAAA;IAC/B,iFAAiF;IAC1E,MAAM,YAAY,sBAAgB,CAAA;IACzC,6EAA6E;IACtE,MAAM,iBAAiB,2BAAqB,CAAA;IACnD,gFAAgF;IACzE,MAAM,MAAM,gBAAU,CAAA;IAC7B,yDAAyD;IAClD,MAAM,EAAE,YAAM,CAAA;CACtB"}

package/dist/tempo/server/Methods.js

@@ -1,6 +1,7 @@
 import * as Ws_ from '../session/Ws.js';
 import { charge as charge_ } from './Charge.js';
 import { session as session_, settle as settle_ } from './Session.js';
+import { renew as renewSubscription_, subscription as subscription_ } from './Subscription.js';
 /**
  * Creates both Tempo `charge` and `session` methods from shared parameters.
  *
@@ -24,6 +25,10 @@ export function tempo(parameters) {
     tempo.charge = charge_;
     /** Creates a Tempo `session` method for session-based TIP-20 token payments. */
     tempo.session = session_;
+    /** Creates a Tempo `subscription` method for recurring TIP-20 token payments. */
+    tempo.subscription = subscription_;
+    /** Renews an overdue Tempo subscription outside of the HTTP request path. */
+    tempo.renewSubscription = renewSubscription_;
     /** One-shot settle: reads highest voucher from storage and submits on-chain. */
     tempo.settle = settle_;
     /** Experimental websocket helpers for Tempo sessions. */

package/dist/tempo/server/Methods.js.map

@@ -1 +1 @@
-{"version":3,"file":"Methods.js","sourceRoot":"","sources":["../../../src/tempo/server/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,cAAc,CAAA;AAErE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAA4C,UAAuB;IACtF,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,UAAyC,CAAC;QACvD,KAAK,CAAC,OAAO,CAAC,UAA0C,CAAC;KACjD,CAAA;AACZ,CAAC;AAED,WAAiB,KAAK;IAGpB,2EAA2E;IAC9D,YAAM,GAAG,OAAO,CAAA;IAC7B,gFAAgF;IACnE,aAAO,GAAG,QAAQ,CAAA;IAC/B,gFAAgF;IACnE,YAAM,GAAG,OAAO,CAAA;IAC7B,yDAAyD;IAC5C,QAAE,GAAG,GAAG,CAAA;AACvB,CAAC,EAXgB,KAAK,KAAL,KAAK,QAWrB"}
+{"version":3,"file":"Methods.js","sourceRoot":"","sources":["../../../src/tempo/server/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EAAE,KAAK,IAAI,kBAAkB,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAE9F;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAA4C,UAAuB;IACtF,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,UAAyC,CAAC;QACvD,KAAK,CAAC,OAAO,CAAC,UAA0C,CAAC;KACjD,CAAA;AACZ,CAAC;AAED,WAAiB,KAAK;IAGpB,2EAA2E;IAC9D,YAAM,GAAG,OAAO,CAAA;IAC7B,gFAAgF;IACnE,aAAO,GAAG,QAAQ,CAAA;IAC/B,iFAAiF;IACpE,kBAAY,GAAG,aAAa,CAAA;IACzC,6EAA6E;IAChE,uBAAiB,GAAG,kBAAkB,CAAA;IACnD,gFAAgF;IACnE,YAAM,GAAG,OAAO,CAAA;IAC7B,yDAAyD;IAC5C,QAAE,GAAG,GAAG,CAAA;AACvB,CAAC,EAfgB,KAAK,KAAL,KAAK,QAerB"}

package/dist/tempo/server/Subscription.d.ts

@@ -0,0 +1,221 @@
+import { type Address } from 'viem';
+import type { LooseOmit, MaybePromise, NoExtraKeys } from '../../internal/types.js';
+import * as Method from '../../Method.js';
+import * as Store from '../../Store.js';
+import type * as Client from '../../viem/Client.js';
+import * as Account from '../internal/account.js';
+import type * as types from '../internal/types.js';
+import * as Methods from '../Methods.js';
+import type { SubscriptionAccessKey, SubscriptionCredentialPayload, SubscriptionLookup, SubscriptionPeriodUnit, SubscriptionRecord, SubscriptionReceipt as SubscriptionReceiptValue } from '../subscription/Types.js';
+type SubscriptionRequest = ReturnType<typeof Methods.subscription.schema.request.parse>;
+/**
+ * Creates a Tempo subscription method for recurring TIP-20 token payments.
+ *
+ * The method handles activation, request-path reuse, and optional lazy renewals.
+ */
+export declare function subscription<const parameters extends subscription.Parameters>(p: NoExtraKeys<parameters, subscription.Parameters>): Method.Server<{
+    readonly name: "tempo";
+    readonly intent: "subscription";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: import("zod/mini").ZodMiniObject<{
+                signature: import("zod/mini").ZodMiniString<string>;
+                type: import("zod/mini").ZodMiniLiteral<"keyAuthorization">;
+            }, import("zod/v4/core").$strip>;
+        };
+        readonly request: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniObject<{
+            amount: import("zod/mini").ZodMiniString<string>;
+            accessKey: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniObject<{
+                accessKeyAddress: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<`0x${string}`, string>>;
+                keyType: import("zod/mini").ZodMiniEnum<{
+                    secp256k1: "secp256k1";
+                    p256: "p256";
+                    webAuthn: "webAuthn";
+                }>;
+            }, import("zod/v4/core").$strip>>;
+            chainId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniNumber<number>>;
+            currency: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<`0x${string}`, string>>;
+            decimals: import("zod/mini").ZodMiniNumber<number>;
+            description: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            methodDetails: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniObject<{
+                accessKey: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniObject<{
+                    accessKeyAddress: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<`0x${string}`, string>>;
+                    keyType: import("zod/mini").ZodMiniEnum<{
+                        secp256k1: "secp256k1";
+                        p256: "p256";
+                        webAuthn: "webAuthn";
+                    }>;
+                }, import("zod/v4/core").$strip>>;
+                chainId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniNumber<number>>;
+            }, import("zod/v4/core").$strip>>;
+            periodCount: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniBigInt<bigint>, import("zod/mini").ZodMiniCustom<number, number>]>, import("zod/mini").ZodMiniTransform<string, string | number | bigint>>;
+            periodUnit: import("zod/mini").ZodMiniEnum<{
+                day: "day";
+                week: "week";
+            }>;
+            recipient: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<`0x${string}`, string>>;
+            subscriptionExpires: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniCustom<Date, Date>]>, import("zod/mini").ZodMiniTransform<Date, import("../../zod.js").DatetimeInput>>;
+        }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniTransform<{
+            methodDetails?: {
+                accessKey?: import("zod").infer<import("zod/mini").ZodMiniObject<{
+                    accessKeyAddress: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniTransform<`0x${string}`, string>>;
+                    keyType: import("zod/mini").ZodMiniEnum<{
+                        secp256k1: "secp256k1";
+                        p256: "p256";
+                        webAuthn: "webAuthn";
+                    }>;
+                }, import("zod/v4/core").$strip>> | undefined;
+                chainId?: number | undefined;
+            } | undefined;
+            amount: string;
+            subscriptionExpires: string;
+            currency: `0x${string}`;
+            periodCount: string;
+            periodUnit: "day" | "week";
+            recipient: `0x${string}`;
+            description?: string | undefined;
+            externalId?: string | undefined;
+        }, {
+            amount: string;
+            currency: `0x${string}`;
+            decimals: number;
+            periodCount: string;
+            periodUnit: "day" | "week";
+            recipient: `0x${string}`;
+            subscriptionExpires: Date;
+            accessKey?: {
+                accessKeyAddress: `0x${string}`;
+                keyType: "secp256k1" | "p256" | "webAuthn";
+            } | undefined;
+            chainId?: number | undefined;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            methodDetails?: {
+                accessKey?: {
+                    accessKeyAddress: `0x${string}`;
+                    keyType: "secp256k1" | "p256" | "webAuthn";
+                } | undefined;
+                chainId?: number | undefined;
+            } | undefined;
+        }>>;
+    };
+}, subscription.DeriveDefaults<parameters>, undefined>;
+/**
+ * Renews an overdue subscription outside of the HTTP request path.
+ * Intended for cron jobs or background workers that bill subscriptions on a schedule.
+ *
+ * Returns the renewal result if the subscription was overdue, or `null` if already current.
+ */
+export declare function renew(parameters: renew.Parameters): Promise<renew.Result | null>;
+export declare namespace renew {
+    /** Parameters for renewing an overdue subscription outside the request path. */
+    type Parameters = {
+        /** The subscription to renew. */
+        subscriptionId: string;
+        /** Billing callback — same signature as the `renew` hook on {@link subscription}. */
+        renew?: ((parameters: {
+            /** Stable idempotency/reconciliation reference persisted before the renewal hook runs. */
+            inFlightReference: string;
+            periodIndex: number;
+            subscription: SubscriptionRecord;
+        }) => Promise<subscription.RenewalResult>) | undefined;
+        /** Store containing subscription records. */
+        store: Store.AtomicStore<Record<string, unknown>>;
+        /**
+         * Milliseconds before an in-flight renewal lock can be replaced.
+         * Keeps concurrent renewal safe while allowing recovery from abandoned attempts.
+         */
+        renewalTimeoutMs?: number | undefined;
+        waitForConfirmation?: boolean | undefined;
+    } & Client.getResolver.Parameters;
+    /** Renewal result returned by {@link renew}. */
+    type Result = subscription.RenewalResult;
+}
+export declare namespace subscription {
+    /** Request-scoped lookup key used to find the active subscription. */
+    type ResolvedSubscription = SubscriptionLookup;
+    /** Activation result returned after the initial credential is verified. */
+    type ActivationResult = {
+        receipt: SubscriptionReceiptValue;
+        subscription: SubscriptionRecord;
+    };
+    /** Renewal result returned when an overdue subscription is charged. */
+    type RenewalResult = {
+        receipt: SubscriptionReceiptValue;
+        subscription: SubscriptionRecord;
+    };
+    /** Request defaults supported by the subscription method. */
+    type Defaults = LooseOmit<Method.RequestDefaults<typeof Methods.subscription>, 'accessKey' | 'recipient'>;
+    /** Parameters for configuring a Tempo subscription method. */
+    type Parameters = Account.resolve.Parameters & Client.getResolver.Parameters & {
+        accessKey?: ((parameters: {
+            input: Request;
+            request: SubscriptionRequest;
+            resolved: ResolvedSubscription;
+        }) => MaybePromise<SubscriptionAccessKey>) | undefined;
+        /**
+         * Milliseconds before an in-flight activation lock can be replaced.
+         * Keeps concurrent activation safe while allowing recovery from abandoned attempts.
+         */
+        activationTimeoutMs?: number | undefined;
+        /**
+         * Milliseconds before an in-flight renewal lock can be replaced.
+         * Keeps concurrent renewal safe while allowing recovery from abandoned attempts.
+         */
+        renewalTimeoutMs?: number | undefined;
+        activate?: ((parameters: {
+            /** Custom activation must verify this access key matches the resolved subscription. */
+            accessKey: SubscriptionAccessKey;
+            credential: {
+                payload: SubscriptionCredentialPayload;
+                source?: string | undefined;
+            };
+            input: Request;
+            request: SubscriptionRequest;
+            resolved: ResolvedSubscription;
+            source: {
+                address: Address;
+                chainId: number;
+            } | null;
+        }) => Promise<ActivationResult>) | undefined;
+        hooks?: {
+            activated?: ((parameters: {
+                receipt: SubscriptionReceiptValue;
+                subscription: SubscriptionRecord;
+            }) => MaybePromise<void>) | undefined;
+            renewed?: ((parameters: {
+                periodIndex: number;
+                receipt: SubscriptionReceiptValue;
+                subscription: SubscriptionRecord;
+            }) => MaybePromise<void>) | undefined;
+        } | undefined;
+        periodCount?: Methods.SubscriptionPeriodCountInput | undefined;
+        periodUnit?: SubscriptionPeriodUnit | undefined;
+        /**
+         * Resolves the request identity. This callback must authenticate and
+         * authorize the caller before returning a key; automatic mode may create
+         * a server-owned access key for that key while issuing a challenge.
+         */
+        resolve: (parameters: {
+            input: Request;
+            request: SubscriptionRequest;
+        }) => MaybePromise<ResolvedSubscription | null>;
+        renew?: (parameters: {
+            /** Stable idempotency/reconciliation reference persisted before the renewal hook runs. */
+            inFlightReference: string;
+            periodIndex: number;
+            /** Custom renewal hooks must preserve amount, currency, recipient, period, expiry, and lookup key. */
+            subscription: SubscriptionRecord;
+        }) => Promise<RenewalResult>;
+        store?: Store.AtomicStore<Record<string, unknown>> | undefined;
+        testnet?: boolean | undefined;
+        waitForConfirmation?: boolean | undefined;
+    } & Defaults;
+    /** Derived defaults after account and chain configuration are applied. */
+    type DeriveDefaults<parameters extends Parameters> = types.DeriveDefaults<parameters, Defaults> & {
+        decimals: number;
+    };
+}
+export {};
+//# sourceMappingURL=Subscription.d.ts.map

package/dist/tempo/server/Subscription.d.ts.map

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