mppx 0.0.1 → 0.1.0

package/dist/stripe/client/MethodIntents.js

@@ -0,0 +1,34 @@
+import { charge as charge_ } from './Charge.js';
+/**
+ * Creates a Stripe `charge` client method intent.
+ *
+ * @example
+ * ```ts
+ * import { Mppx, stripe } from 'mppx/client'
+ *
+ * const mppx = Mppx.create({
+ *   methods: [
+ *     stripe({
+ *       createSpt: async (params) => {
+ *         const res = await fetch('/api/create-spt', {
+ *           method: 'POST',
+ *           headers: { 'Content-Type': 'application/json' },
+ *           body: JSON.stringify(params),
+ *         })
+ *         const { spt } = await res.json()
+ *         return spt
+ *       },
+ *       paymentMethod: 'pm_card_visa',
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+export function stripe(parameters) {
+    return [charge_(parameters)];
+}
+(function (stripe) {
+    /** Creates a Stripe `charge` client method intent for SPT-based payments. */
+    stripe.charge = charge_;
+})(stripe || (stripe = {}));
+//# sourceMappingURL=MethodIntents.js.map

package/dist/stripe/client/MethodIntents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MethodIntents.js","sourceRoot":"","sources":["../../../src/stripe/client/MethodIntents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,MAAM,CAAC,UAA6B;IAClD,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAU,CAAA;AACvC,CAAC;AAED,WAAiB,MAAM;IAGrB,6EAA6E;IAChE,aAAM,GAAG,OAAO,CAAA;AAC/B,CAAC,EALgB,MAAM,KAAN,MAAM,QAKtB"}

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

@@ -0,0 +1,3 @@
+export { charge } from './Charge.js';
+export { stripe } from './MethodIntents.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stripe/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/stripe/client/index.js

@@ -0,0 +1,3 @@
+export { charge } from './Charge.js';
+export { stripe } from './MethodIntents.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stripe/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/stripe/index.d.ts

@@ -0,0 +1,2 @@
+export * as MethodIntents from './Intents.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stripe/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,cAAc,CAAA"}

package/dist/stripe/index.js

@@ -0,0 +1,2 @@
+export * as MethodIntents from './Intents.js';
+//# sourceMappingURL=index.js.map

package/dist/stripe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stripe/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,cAAc,CAAA"}

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

@@ -0,0 +1,74 @@
+import type { LooseOmit } from '../../internal/types.js';
+import * as MethodIntent from '../../MethodIntent.js';
+import * as Intents from '../Intents.js';
+/**
+ * Creates a Stripe charge method intent for usage on the server.
+ *
+ * Verifies payment by creating a Stripe PaymentIntent with the provided SPT.
+ *
+ * @example
+ * ```ts
+ * import { stripe } from 'mppx/server'
+ *
+ * const charge = stripe.charge({ secretKey: 'sk_...' })
+ * ```
+ */
+export declare function charge<const parameters extends charge.Parameters>(parameters: parameters): MethodIntent.Server<MethodIntent.MethodIntent<{
+    readonly name: "charge";
+    readonly schema: {
+        readonly request: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniObject<{
+            amount: import("zod/mini").ZodMiniString<string>;
+            currency: import("zod/mini").ZodMiniString<string>;
+            decimals: import("zod/mini").ZodMiniNumber<number>;
+            description: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            expires: import("zod/mini").ZodMiniDefault<import("zod/mini").ZodMiniString<string>>;
+            externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            recipient: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+        }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniTransform<{
+            amount: string;
+            currency: string;
+            expires: string;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            recipient?: string | undefined;
+        }, {
+            amount: string;
+            currency: string;
+            decimals: number;
+            expires: string;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            recipient?: string | undefined;
+        }>>;
+    };
+}, {
+    readonly method: "stripe";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: import("zod/mini").ZodMiniObject<{
+                spt: import("zod/mini").ZodMiniString<string>;
+                externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            }, import("zod/v4/core").$strip>;
+        };
+        readonly request: {
+            readonly methodDetails: import("zod/mini").ZodMiniObject<{
+                networkId: import("zod/mini").ZodMiniString<string>;
+                paymentMethodTypes: import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniString<string>>;
+                metadata: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniRecord<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniString<string>>>;
+            }, import("zod/v4/core").$strip>;
+        };
+    };
+}>, charge.DeriveDefaults<parameters>, undefined>;
+export declare namespace charge {
+    type Defaults = LooseOmit<MethodIntent.RequestDefaults<typeof Intents.charge>, 'recipient'>;
+    type Parameters = {
+        /** Stripe secret API key. */
+        secretKey: string;
+        /** Optional metadata to include in SPT creation requests. */
+        metadata?: Record<string, string> | undefined;
+    } & Defaults;
+    type DeriveDefaults<parameters extends Parameters> = Pick<parameters, Extract<keyof parameters, keyof Defaults>> & {
+        decimals: number;
+    };
+}
+//# sourceMappingURL=Charge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Charge.d.ts","sourceRoot":"","sources":["../../../src/stripe/server/Charge.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AAExC;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,UAAU,SAAS,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kDAmFxF;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAC,eAAe,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAA;IAE3F,KAAK,UAAU,GAAG;QAChB,6BAA6B;QAC7B,SAAS,EAAE,MAAM,CAAA;QACjB,6DAA6D;QAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;KAC9C,GAAG,QAAQ,CAAA;IAEZ,KAAK,cAAc,CAAC,UAAU,SAAS,UAAU,IAAI,IAAI,CACvD,UAAU,EACV,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,QAAQ,CAAC,CAC1C,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CACzB"}

package/dist/stripe/server/Charge.js

@@ -0,0 +1,79 @@
+import { PaymentActionRequiredError, PaymentExpiredError, VerificationFailedError, } from '../../Errors.js';
+import * as MethodIntent from '../../MethodIntent.js';
+import * as Intents from '../Intents.js';
+/**
+ * Creates a Stripe charge method intent for usage on the server.
+ *
+ * Verifies payment by creating a Stripe PaymentIntent with the provided SPT.
+ *
+ * @example
+ * ```ts
+ * import { stripe } from 'mppx/server'
+ *
+ * const charge = stripe.charge({ secretKey: 'sk_...' })
+ * ```
+ */
+export function charge(parameters) {
+    const { amount, currency, decimals, description, externalId, metadata, networkId, paymentMethodTypes, secretKey, } = parameters;
+    return MethodIntent.toServer(Intents.charge, {
+        defaults: {
+            amount,
+            currency,
+            decimals,
+            description,
+            externalId,
+            metadata,
+            networkId,
+            paymentMethodTypes,
+        },
+        async verify({ credential }) {
+            const { challenge } = credential;
+            const { request } = challenge;
+            if (request.expires && new Date(request.expires) < new Date())
+                throw new PaymentExpiredError({ expires: request.expires });
+            const parsed = Intents.charge.schema.credential.payload.safeParse(credential.payload);
+            if (!parsed.success)
+                throw new Error('Invalid credential payload: missing or malformed spt');
+            const { spt, externalId: credentialExternalId } = parsed.data;
+            const body = new URLSearchParams({
+                amount: request.amount,
+                currency: request.currency,
+                shared_payment_granted_token: spt,
+                confirm: 'true',
+                'automatic_payment_methods[enabled]': 'true',
+                'automatic_payment_methods[allow_redirects]': 'never',
+            });
+            const resolvedMetadata = request.methodDetails?.metadata;
+            if (resolvedMetadata) {
+                for (const [key, value] of Object.entries(resolvedMetadata)) {
+                    body.set(`metadata[${key}]`, value);
+                }
+            }
+            const response = await fetch('https://api.stripe.com/v1/payment_intents', {
+                method: 'POST',
+                headers: {
+                    Authorization: `Basic ${btoa(`${secretKey}:`)}`,
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    'Idempotency-Key': `mppx_${challenge.id}_${spt}`,
+                },
+                body,
+            });
+            if (!response.ok)
+                throw new VerificationFailedError({ reason: 'Stripe PaymentIntent failed' });
+            const pi = (await response.json());
+            if (pi.status === 'requires_action') {
+                throw new PaymentActionRequiredError({ reason: 'Stripe PaymentIntent requires action' });
+            }
+            if (pi.status !== 'succeeded')
+                throw new Error(`Stripe PaymentIntent status: ${pi.status}`);
+            return {
+                method: 'stripe',
+                status: 'success',
+                timestamp: new Date().toISOString(),
+                reference: pi.id,
+                ...(credentialExternalId ? { externalId: credentialExternalId } : {}),
+            };
+        },
+    });
+}
+//# sourceMappingURL=Charge.js.map

package/dist/stripe/server/Charge.js.map

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

package/dist/stripe/server/MethodIntents.d.ts

@@ -0,0 +1,65 @@
+import { charge as charge_ } from './Charge.js';
+/**
+ * Creates a Stripe `charge` method intent for usage on the server.
+ *
+ * @example
+ * ```ts
+ * import { Mppx, stripe } from 'mppx/server'
+ *
+ * const mppx = Mppx.create({
+ *   methods: [stripe({ secretKey: 'sk_...' })],
+ * })
+ * ```
+ */
+export declare function stripe<const parameters extends stripe.Parameters>(parameters: parameters): readonly [import("../../MethodIntent.js").Server<import("../../MethodIntent.js").MethodIntent<{
+    readonly name: "charge";
+    readonly schema: {
+        readonly request: import("zod/mini").ZodMiniPipe<import("zod/mini").ZodMiniObject<{
+            amount: import("zod/mini").ZodMiniString<string>;
+            currency: import("zod/mini").ZodMiniString<string>;
+            decimals: import("zod/mini").ZodMiniNumber<number>;
+            description: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            expires: import("zod/mini").ZodMiniDefault<import("zod/mini").ZodMiniString<string>>;
+            externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            recipient: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+        }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniTransform<{
+            amount: string;
+            currency: string;
+            expires: string;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            recipient?: string | undefined;
+        }, {
+            amount: string;
+            currency: string;
+            decimals: number;
+            expires: string;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            recipient?: string | undefined;
+        }>>;
+    };
+}, {
+    readonly method: "stripe";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: import("zod/mini").ZodMiniObject<{
+                spt: import("zod/mini").ZodMiniString<string>;
+                externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            }, import("zod/v4/core").$strip>;
+        };
+        readonly request: {
+            readonly methodDetails: import("zod/mini").ZodMiniObject<{
+                networkId: import("zod/mini").ZodMiniString<string>;
+                paymentMethodTypes: import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniString<string>>;
+                metadata: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniRecord<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniString<string>>>;
+            }, import("zod/v4/core").$strip>;
+        };
+    };
+}>, charge_.DeriveDefaults<parameters>, undefined>];
+export declare namespace stripe {
+    type Parameters = charge_.Parameters;
+    /** Creates a Stripe `charge` method intent for SPT-based payments. */
+    const charge: typeof charge_;
+}
+//# sourceMappingURL=MethodIntents.d.ts.map

package/dist/stripe/server/MethodIntents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MethodIntents.d.ts","sourceRoot":"","sources":["../../../src/stripe/server/MethodIntents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,UAAU,SAAS,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oDAExF;AAED,yBAAiB,MAAM,CAAC;IACtB,KAAY,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;IAE3C,sEAAsE;IAC/D,MAAM,MAAM,gBAAU,CAAA;CAC9B"}

package/dist/stripe/server/MethodIntents.js

@@ -0,0 +1,21 @@
+import { charge as charge_ } from './Charge.js';
+/**
+ * Creates a Stripe `charge` method intent for usage on the server.
+ *
+ * @example
+ * ```ts
+ * import { Mppx, stripe } from 'mppx/server'
+ *
+ * const mppx = Mppx.create({
+ *   methods: [stripe({ secretKey: 'sk_...' })],
+ * })
+ * ```
+ */
+export function stripe(parameters) {
+    return [stripe.charge(parameters)];
+}
+(function (stripe) {
+    /** Creates a Stripe `charge` method intent for SPT-based payments. */
+    stripe.charge = charge_;
+})(stripe || (stripe = {}));
+//# sourceMappingURL=MethodIntents.js.map

package/dist/stripe/server/MethodIntents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MethodIntents.js","sourceRoot":"","sources":["../../../src/stripe/server/MethodIntents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,MAAM,CAA6C,UAAsB;IACvF,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAU,CAAA;AAC7C,CAAC;AAED,WAAiB,MAAM;IAGrB,sEAAsE;IACzD,aAAM,GAAG,OAAO,CAAA;AAC/B,CAAC,EALgB,MAAM,KAAN,MAAM,QAKtB"}

package/dist/stripe/server/index.d.ts

@@ -0,0 +1,3 @@
+export { charge } from './Charge.js';
+export { stripe } from './MethodIntents.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/stripe/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stripe/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/stripe/server/index.js

@@ -0,0 +1,3 @@
+export { charge } from './Charge.js';
+export { stripe } from './MethodIntents.js';
+//# sourceMappingURL=index.js.map

package/dist/stripe/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stripe/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/tempo/Attribution.d.ts

@@ -0,0 +1,101 @@
+/**
+ * MPP attribution memo encoding for TIP-20 `transferWithMemo`.
+ *
+ * When no user-provided memo is present, the SDK auto-generates an
+ * attribution memo so MPP transactions are identifiable on-chain.
+ *
+ * ## Byte Layout (32 bytes)
+ *
+ * | Offset | Size | Field                                     |
+ * |--------|------|-------------------------------------------|
+ * | 0..3   | 4    | TAG = keccak256("mpp")[0..3]               |
+ * | 4      | 1    | version (0x01)                            |
+ * | 5..14  | 10   | serverId = keccak256(serverId)[0..9]       |
+ * | 15..24 | 10   | clientId = keccak256(clientId)[0..9] or 0s |
+ * | 25..31 | 7    | nonce (random bytes)                      |
+ *
+ * The TAG prefix makes MPP transactions trivially distinguishable
+ * from arbitrary memos via `TransferWithMemo` event topic filtering.
+ *
+ * @module
+ */
+/** First 4 bytes of keccak256("mpp") — the on-chain MPP tag. */
+export declare const tag: `0x${string}`;
+/** 10 zero bytes representing an anonymous (no clientId) client. */
+export declare const anonymous: "0x00000000000000000000";
+/**
+ * Encodes an MPP attribution memo as a `bytes32` hex string.
+ *
+ * @param parameters - The serverId (server identity) and optional clientId.
+ * @returns A `0x`-prefixed 64-char hex string (32 bytes).
+ *
+ * @example
+ * ```ts
+ * import * as Attribution from './Attribution.js'
+ *
+ * const memo = Attribution.encode({ serverId: 'api.example.com', clientId: 'my-app' })
+ * ```
+ */
+export declare function encode(parameters: encode.Parameters): `0x${string}`;
+export declare namespace encode {
+    type Parameters = {
+        /** Server identity used to derive the server fingerprint. */
+        serverId: string;
+        /** Optional client identity used to derive the client fingerprint. */
+        clientId?: string | undefined;
+    };
+}
+/**
+ * Checks whether a memo was generated by the MPP attribution system.
+ *
+ * @param memo - A `0x`-prefixed hex string (bytes32).
+ * @returns `true` if the memo starts with the MPP tag and version byte.
+ *
+ * @example
+ * ```ts
+ * import * as Attribution from './Attribution.js'
+ *
+ * Attribution.isMppMemo(Attribution.encode({ serverId: 'api.example.com' })) // true
+ * Attribution.isMppMemo('0x0000...0000')      // false
+ * ```
+ */
+export declare function isMppMemo(memo: `0x${string}`): boolean;
+/**
+ * Verifies that a memo's server fingerprint matches the given serverId.
+ *
+ * Checks TAG, version byte, and that bytes 5–14 equal keccak256(serverId)[0..9].
+ *
+ * @param memo - A `0x`-prefixed hex string (bytes32).
+ * @param serverId - The expected server identity.
+ * @returns `true` if the memo has a valid MPP tag and matching server fingerprint.
+ */
+export declare function verifyServer(memo: `0x${string}`, serverId: string): boolean;
+/**
+ * Decodes an MPP attribution memo into its constituent parts.
+ *
+ * @param memo - A `0x`-prefixed hex string (bytes32).
+ * @returns The decoded fields, or `null` if the memo is not an MPP memo.
+ *
+ * @example
+ * ```ts
+ * import * as Attribution from './Attribution.js'
+ *
+ * const memo = Attribution.encode({ serverId: 'api.example.com', clientId: 'my-app' })
+ * const decoded = Attribution.decode(memo)
+ * // { version: 1, serverFingerprint: '0x...', clientFingerprint: '0x...', nonce: '0x...' }
+ * ```
+ */
+export declare function decode(memo: `0x${string}`): decode.Result | null;
+export declare namespace decode {
+    type Result = {
+        /** Memo version (currently always 1). */
+        version: number;
+        /** 10-byte server fingerprint hex (keccak256(serverId)[0..9]). */
+        serverFingerprint: `0x${string}`;
+        /** 10-byte client fingerprint hex, or `null` if anonymous. */
+        clientFingerprint: `0x${string}` | null;
+        /** 7-byte random nonce hex. */
+        nonce: `0x${string}`;
+    };
+}
+//# sourceMappingURL=Attribution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Attribution.d.ts","sourceRoot":"","sources":["../../src/tempo/Attribution.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,gEAAgE;AAChE,eAAO,MAAM,GAAG,eAA0E,CAAA;AAK1F,oEAAoE;AACpE,eAAO,MAAM,SAAS,EAAG,wBAAiC,CAAA;AAW1D;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,iBAanD;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,UAAU,GAAG;QAChB,6DAA6D;QAC7D,QAAQ,EAAE,MAAM,CAAA;QAChB,sEAAsE;QACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC9B,CAAA;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAKtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,CAWhE;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,MAAM,GAAG;QACZ,yCAAyC;QACzC,OAAO,EAAE,MAAM,CAAA;QACf,kEAAkE;QAClE,iBAAiB,EAAE,KAAK,MAAM,EAAE,CAAA;QAChC,8DAA8D;QAC9D,iBAAiB,EAAE,KAAK,MAAM,EAAE,GAAG,IAAI,CAAA;QACvC,+BAA+B;QAC/B,KAAK,EAAE,KAAK,MAAM,EAAE,CAAA;KACrB,CAAA;CACF"}

package/dist/tempo/Attribution.js

@@ -0,0 +1,124 @@
+import { Bytes, Hash, Hex } from 'ox';
+/**
+ * MPP attribution memo encoding for TIP-20 `transferWithMemo`.
+ *
+ * When no user-provided memo is present, the SDK auto-generates an
+ * attribution memo so MPP transactions are identifiable on-chain.
+ *
+ * ## Byte Layout (32 bytes)
+ *
+ * | Offset | Size | Field                                     |
+ * |--------|------|-------------------------------------------|
+ * | 0..3   | 4    | TAG = keccak256("mpp")[0..3]               |
+ * | 4      | 1    | version (0x01)                            |
+ * | 5..14  | 10   | serverId = keccak256(serverId)[0..9]       |
+ * | 15..24 | 10   | clientId = keccak256(clientId)[0..9] or 0s |
+ * | 25..31 | 7    | nonce (random bytes)                      |
+ *
+ * The TAG prefix makes MPP transactions trivially distinguishable
+ * from arbitrary memos via `TransferWithMemo` event topic filtering.
+ *
+ * @module
+ */
+/** First 4 bytes of keccak256("mpp") — the on-chain MPP tag. */
+export const tag = Hex.slice(Hash.keccak256(Bytes.fromString('mpp'), { as: 'Hex' }), 0, 4);
+/** Current memo version. */
+const version = 0x01;
+/** 10 zero bytes representing an anonymous (no clientId) client. */
+export const anonymous = '0x00000000000000000000';
+/**
+ * Computes a 10-byte fingerprint from a string via keccak256.
+ * @internal
+ */
+function fingerprint(value) {
+    const hash = Hash.keccak256(Bytes.fromString(value), { as: 'Hex' });
+    return Hex.toBytes(Hex.slice(hash, 0, 10));
+}
+/**
+ * Encodes an MPP attribution memo as a `bytes32` hex string.
+ *
+ * @param parameters - The serverId (server identity) and optional clientId.
+ * @returns A `0x`-prefixed 64-char hex string (32 bytes).
+ *
+ * @example
+ * ```ts
+ * import * as Attribution from './Attribution.js'
+ *
+ * const memo = Attribution.encode({ serverId: 'api.example.com', clientId: 'my-app' })
+ * ```
+ */
+export function encode(parameters) {
+    const { serverId, clientId } = parameters;
+    const buf = new Uint8Array(32);
+    buf.set(Hex.toBytes(tag), 0);
+    buf[4] = version;
+    buf.set(fingerprint(serverId), 5);
+    if (clientId)
+        buf.set(fingerprint(clientId), 15);
+    const nonce = crypto.getRandomValues(new Uint8Array(7));
+    buf.set(nonce, 25);
+    return Hex.fromBytes(buf);
+}
+/**
+ * Checks whether a memo was generated by the MPP attribution system.
+ *
+ * @param memo - A `0x`-prefixed hex string (bytes32).
+ * @returns `true` if the memo starts with the MPP tag and version byte.
+ *
+ * @example
+ * ```ts
+ * import * as Attribution from './Attribution.js'
+ *
+ * Attribution.isMppMemo(Attribution.encode({ serverId: 'api.example.com' })) // true
+ * Attribution.isMppMemo('0x0000...0000')      // false
+ * ```
+ */
+export function isMppMemo(memo) {
+    if (memo.length !== 66)
+        return false;
+    const memoTag = memo.slice(0, 10);
+    const memoVersion = Number.parseInt(memo.slice(10, 12), 16);
+    return memoTag.toLowerCase() === tag.toLowerCase() && memoVersion === version;
+}
+/**
+ * Verifies that a memo's server fingerprint matches the given serverId.
+ *
+ * Checks TAG, version byte, and that bytes 5–14 equal keccak256(serverId)[0..9].
+ *
+ * @param memo - A `0x`-prefixed hex string (bytes32).
+ * @param serverId - The expected server identity.
+ * @returns `true` if the memo has a valid MPP tag and matching server fingerprint.
+ */
+export function verifyServer(memo, serverId) {
+    if (!isMppMemo(memo))
+        return false;
+    const memoServerHex = `0x${memo.slice(12, 32)}`;
+    const expectedHex = Hex.fromBytes(fingerprint(serverId));
+    return memoServerHex.toLowerCase() === expectedHex.toLowerCase();
+}
+/**
+ * Decodes an MPP attribution memo into its constituent parts.
+ *
+ * @param memo - A `0x`-prefixed hex string (bytes32).
+ * @returns The decoded fields, or `null` if the memo is not an MPP memo.
+ *
+ * @example
+ * ```ts
+ * import * as Attribution from './Attribution.js'
+ *
+ * const memo = Attribution.encode({ serverId: 'api.example.com', clientId: 'my-app' })
+ * const decoded = Attribution.decode(memo)
+ * // { version: 1, serverFingerprint: '0x...', clientFingerprint: '0x...', nonce: '0x...' }
+ * ```
+ */
+export function decode(memo) {
+    if (!isMppMemo(memo))
+        return null;
+    const memoVersion = Number.parseInt(memo.slice(10, 12), 16);
+    const serverFingerprint = `0x${memo.slice(12, 32)}`;
+    const clientHex = `0x${memo.slice(32, 52)}`;
+    const nonce = `0x${memo.slice(52)}`;
+    const clientFingerprint = clientHex.toLowerCase() === anonymous.toLowerCase() ? null : clientHex;
+    return { version: memoVersion, serverFingerprint, clientFingerprint, nonce };
+}
+//# sourceMappingURL=Attribution.js.map

package/dist/tempo/Attribution.js.map

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