mppx 0.8.13 → 0.8.15

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

@@ -1,13 +1,15 @@
+import { Transaction } from 'viem/tempo';
 import type { LooseOmit, NoExtraKeys } from '../../internal/types.js';
 import * as Method from '../../Method.js';
 import type * as Html from '../../server/internal/html/config.ts';
 import * as Store from '../../Store.js';
 import * as Client from '../../viem/Client.js';
-import type * as z from '../../zod.js';
 import * as Account from '../internal/account.js';
 import * as FeePayer from '../internal/fee-payer.js';
 import type * as types from '../internal/types.js';
 import * as Methods from '../Methods.js';
+import * as Relay from './Relay.js';
+import * as SponsorBudget from './SponsorBudget.js';
 /**
  * Creates a Tempo charge method intent for usage on the server.
  *
@@ -18,83 +20,19 @@ import * as Methods from '../Methods.js';
  * const charge = tempo.charge()
  * ```
  */
-export declare function charge<const parameters extends charge.Parameters>(parameters?: NoExtraKeys<parameters, charge.Parameters>): Method.Server<{
-    readonly name: "tempo";
-    readonly intent: "charge";
-    readonly schema: {
-        readonly credential: {
-            readonly payload: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
-                hash: z.ZodMiniString<string>;
-                type: z.ZodMiniLiteral<"hash">;
-            }, z.core.$strip>, z.ZodMiniObject<{
-                signature: z.ZodMiniString<string>;
-                type: z.ZodMiniLiteral<"transaction">;
-            }, z.core.$strip>, z.ZodMiniObject<{
-                signature: z.ZodMiniString<string>;
-                type: z.ZodMiniLiteral<"proof">;
-            }, z.core.$strip>], "type">;
-        };
-        readonly request: z.ZodMiniPipe<z.ZodMiniObject<{
-            amount: z.ZodMiniString<string>;
-            chainId: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-            currency: z.ZodMiniString<string>;
-            decimals: z.ZodMiniNumber<number>;
-            description: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            externalId: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            feePayer: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniBoolean<boolean>, z.ZodMiniCustom<import("viem").Account, import("viem").Account>]>, z.ZodMiniTransform<boolean, boolean | import("viem").Account>>>;
-            memo: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            recipient: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            splits: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
-                amount: z.ZodMiniString<string>;
-                memo: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                recipient: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<`0x${string}`, string>>;
-            }, z.core.$strip>>>;
-            supportedModes: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-                push: "push";
-                pull: "pull";
-            }>>>;
-        }, z.core.$strip>, z.ZodMiniTransform<{
-            methodDetails?: {
-                supportedModes?: ("push" | "pull")[] | undefined;
-                splits?: {
-                    amount: string;
-                    recipient: `0x${string}`;
-                    memo?: string | undefined;
-                }[] | undefined;
-                memo?: string | undefined;
-                feePayer?: boolean | undefined;
-                chainId?: number | undefined;
-            } | undefined;
-            amount: string;
-            currency: string;
-            description?: string | undefined;
-            externalId?: string | undefined;
-            recipient?: string | undefined;
-        }, {
-            amount: string;
-            currency: string;
-            decimals: number;
-            chainId?: number | undefined;
-            description?: string | undefined;
-            externalId?: string | undefined;
-            feePayer?: boolean | undefined;
-            memo?: string | undefined;
-            recipient?: string | undefined;
-            splits?: {
-                amount: string;
-                recipient: `0x${string}`;
-                memo?: string | undefined;
-            }[] | undefined;
-            supportedModes?: ("push" | "pull")[] | undefined;
-        }>>;
-    };
-}, charge.DeriveDefaults<parameters>, undefined, {}, undefined>;
+export declare function charge<const parameters extends charge.Parameters>(parameters?: NoExtraKeys<parameters, charge.Parameters>): Method.Server<typeof Methods.charge, charge.DeriveDefaults<parameters>>;
 export declare namespace charge {
     type StoreItemMap = {
-        [key: `mppx:charge:${string}`]: number;
+        [key: `mppx:charge:${string}`]: number | SponsorBudget.State;
     };
     type Defaults = LooseOmit<Method.RequestDefaults<typeof Methods.charge>, 'feePayer' | 'recipient'>;
     type ValidateSender = (parameters: ValidateSenderParameters) => boolean | Promise<boolean>;
+    type ValidationDetails = {
+        mode: 'proof' | 'pull' | 'push';
+        sender?: `0x${string}` | undefined;
+        serializedTransaction?: Transaction.TransactionSerializedTempo | undefined;
+        transfers?: readonly ExpectedTransfer[] | undefined;
+    };
     type ValidateSenderParameters = {
         /** Actual TIP-20 `Transfer.from` address. */
         sender: `0x${string}`;
@@ -112,10 +50,13 @@ export declare namespace charge {
         /**
          * Override the fee-sponsor policy used when co-signing Tempo charge
          * transactions. Defaults resolve per chain, including a higher
-         * priority-fee ceiling on Moderato.
+         * priority-fee ceiling on Moderato and a bounded aggregate in-flight fee
+         * budget. Sponsored transactions reserve their declared maximum fee
+         * atomically; independent expiring-nonce transactions run concurrently
+         * while capacity remains and wait for capacity when the budget is full.
          *
-         * If you increase `maxGas` or `maxFeePerGas`, you may also need to raise
-         * `maxTotalFee` so the combined fee budget remains valid.
+         * If you increase `maxGas`, `maxFeePerGas`, or `maxTotalFee`, you may also
+         * need to raise `maxInFlightTotalFee`.
          */
         feePayerPolicy?: FeePayerPolicy | undefined;
         /**
@@ -155,6 +96,16 @@ export declare namespace charge {
          * By default, no prefix is applied.
          */
         storeKeyPrefix?: string | undefined;
+        /**
+         * Delegates Tempo charge credential validation and broadcast to Tempo API
+         * or a compatible MPP relay.
+         *
+         * The adapter delegates finalization to the relay for both modes. The
+         * relay broadcasts pull credentials, while it recognizes a push
+         * credential as already broadcast and returns its receipt without sending
+         * it again.
+         */
+        relay?: RelayOptions | undefined;
         /**
          * Whether to wait for the charge transaction to confirm on-chain before
          * responding. @default true
@@ -172,6 +123,24 @@ export declare namespace charge {
         currency: string;
         decimals: number;
     }>;
-    type FeePayerPolicy = Partial<FeePayer.Policy>;
+    type FeePayerPolicy = Partial<FeePayer.Policy> & {
+        /** Maximum number of sponsored transactions awaiting a terminal receipt. @default 100 */
+        maxInFlightReservations?: number | undefined;
+        /**
+         * Maximum aggregate declared fee exposure awaiting terminal receipts.
+         *
+         * @default `maxTotalFee * 10`
+         */
+        maxInFlightTotalFee?: bigint | undefined;
+    };
+    /** Tempo API relay configuration for server-side charges. */
+    type RelayOptions = Relay.configure.Options;
 }
+type ExpectedTransfer = {
+    amount: string;
+    allowAnyMemo?: boolean | undefined;
+    memo?: `0x${string}` | undefined;
+    recipient: `0x${string}`;
+};
+export {};
 //# sourceMappingURL=Charge.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Charge.d.ts","sourceRoot":"","sources":["../../../src/tempo/server/Charge.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,IAAI,MAAM,sCAAsC,CAAA;AACjE,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,sBAAsB,CAAA;AAC9C,OAAO,KAAK,KAAK,CAAC,MAAM,cAAc,CAAA;AAEtC,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAA;AAIjD,OAAO,KAAK,QAAQ,MAAM,0BAA0B,CAAA;AAIpD,OAAO,KAAK,KAAK,KAAK,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AAGxC;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,UAAU,SAAS,MAAM,CAAC,UAAU,EAC/D,UAAU,GAAE,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAGpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAseF;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,YAAY,GAAG;QAAE,CAAC,GAAG,EAAE,eAAe,MAAM,EAAE,GAAG,MAAM,CAAA;KAAE,CAAA;IAE9D,KAAK,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC,CAAA;IAElG,KAAK,cAAc,GAAG,CAAC,UAAU,EAAE,wBAAwB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE1F,KAAK,wBAAwB,GAAG;QAC9B,6CAA6C;QAC7C,MAAM,EAAE,KAAK,MAAM,EAAE,CAAA;QACrB,8DAA8D;QAC9D,cAAc,EAAE,KAAK,MAAM,EAAE,CAAA;QAC7B,sEAAsE;QACtE,MAAM,CAAC,EAAE;YAAE,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAA;KACjE,CAAA;IAED,KAAK,UAAU,GAAG;QAChB,6EAA6E;QAC7E,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;QACxC;;;;;;;WAOG;QACH,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;QAC3C;;;;;;WAMG;QACH,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,SAAS,CAAA;QACpC,oBAAoB;QACpB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B;;;;;;;;;;;;;WAaG;QACH,KAAK,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAA;QACrC;;;;WAIG;QACH,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;QAC3C;;;;WAIG;QACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACnC;;;;;;;;;;WAUG;QACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAC1C,GAAG,MAAM,CAAC,WAAW,CAAC,UAAU,GAC/B,OAAO,CAAC,OAAO,CAAC,UAAU,GAC1B,QAAQ,CAAA;IAEV,KAAK,cAAc,CAAC,UAAU,SAAS,UAAU,IAAI,KAAK,CAAC,cAAc,CACvE,UAAU,EACV,QAAQ,EACR;QACE,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;KACjB,CACF,CAAA;IAED,KAAK,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;CAC/C"}
+{"version":3,"file":"Charge.d.ts","sourceRoot":"","sources":["../../../src/tempo/server/Charge.ts"],"names":[],"mappings":"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"}