@solana/mpp 0.0.0 → 0.1.0-beta.0

package/dist/Methods.js

@@ -0,0 +1,217 @@
+import { Method, z } from 'mppx';
+/**
+ * Solana charge method — shared schema used by both server and client.
+ *
+ * Supports two settlement modes:
+ *
+ * - **Pull mode** (`type="transaction"`, default): Client signs the
+ *   transaction and sends the bytes to the server. The server broadcasts,
+ *   confirms, and verifies the transfer on-chain.
+ *
+ * - **Push mode** (`type="signature"`): Client broadcasts the transaction
+ *   itself and sends the confirmed signature. The server verifies on-chain.
+ */
+export const charge = Method.from({
+    intent: 'charge',
+    name: 'solana',
+    schema: {
+        credential: {
+            payload: z.object({
+                /** Base58-encoded transaction signature (when type="signature"). */
+                signature: z.optional(z.string()),
+                /** Base64-encoded serialized signed transaction (when type="transaction"). */
+                transaction: z.optional(z.string()),
+                /** Payload type: "transaction" (server broadcasts) or "signature" (client already broadcast). */
+                type: z.string(),
+            }),
+        },
+        request: z.object({
+            /** Amount in smallest unit (lamports for SOL, base units for SPL tokens). */
+            amount: z.string(),
+            /** Identifies the unit for amount. "SOL" for native, or token symbol/mint (e.g. "USDC"). */
+            currency: z.string(),
+            /** Human-readable memo describing the resource or service being paid for. */
+            description: z.optional(z.string()),
+            /** Merchant's reference (e.g., order ID, invoice number) for reconciliation. */
+            externalId: z.optional(z.string()),
+            methodDetails: z.object({
+                /** Token decimals (required for SPL token transfers). */
+                decimals: z.optional(z.number()),
+                /** If true, server pays transaction fees. Client must use the server's feePayerKey. */
+                feePayer: z.optional(z.boolean()),
+                /** Server's base58-encoded public key for fee payment. Present when feePayer is true. */
+                feePayerKey: z.optional(z.string()),
+                /** Solana network: mainnet-beta, devnet, or localnet. */
+                network: z.optional(z.string()),
+                /** Server-provided base58-encoded recent blockhash. Saves the client an RPC round-trip. */
+                recentBlockhash: z.optional(z.string()),
+                /** Unique reference ID for this charge (server-generated, used for tracking). */
+                reference: z.string(),
+                /** SPL token mint address. If absent, payment is in native SOL. */
+                splToken: z.optional(z.string()),
+                /** Token program address (TOKEN_PROGRAM or TOKEN_2022_PROGRAM). Defaults to TOKEN_PROGRAM. */
+                tokenProgram: z.optional(z.string()),
+            }),
+            /** Base58-encoded recipient public key. */
+            recipient: z.string(),
+        }),
+    },
+});
+const voucherSchema = z.object({
+    /** Chain identifier, for example `solana:mainnet-beta`. */
+    chainId: z.string(),
+    /** Channel identifier bound to this voucher. */
+    channelId: z.string(),
+    /** Channel program address expected by server verifier. */
+    channelProgram: z.string(),
+    /** Monotonic cumulative authorized amount. */
+    cumulativeAmount: z.string(),
+    /** Optional voucher expiration timestamp in ISO-8601 format. */
+    expiresAt: z.optional(z.string()),
+    /** Meter name for priced usage tracking. */
+    meter: z.string(),
+    /** Wallet payer bound to this voucher. */
+    payer: z.string(),
+    /** Channel recipient service wallet. */
+    recipient: z.string(),
+    /** Monotonic sequence number for replay protection. */
+    sequence: z.number(),
+    /** Server-provided nonce for challenge binding. */
+    serverNonce: z.string(),
+    /** Meter units associated with this authorization update. */
+    units: z.string(),
+});
+const signedVoucherSchema = z.object({
+    /** Base58/encoded signature over canonical voucher bytes. */
+    signature: z.string(),
+    /** Signature scheme discriminator (`ed25519` or `swig-session`). */
+    signatureType: z.string(),
+    /** Voucher signer public key. */
+    signer: z.string(),
+    voucher: voucherSchema,
+});
+/**
+ * Solana session method shared schema used by both server and client.
+ *
+ * Supports four credential actions:
+ *
+ * - **open**: opens a payment channel, records deposit, and anchors setup tx.
+ * - **update**: submits a new monotonic voucher for cumulative usage.
+ * - **topup**: increases channel escrow using a separate topup transaction.
+ * - **close**: final voucher update used to finalize channel settlement.
+ */
+export const session = Method.from({
+    intent: 'session',
+    name: 'solana',
+    schema: {
+        credential: {
+            payload: z.discriminatedUnion('action', [
+                z.object({
+                    /** Session lifecycle action. */
+                    action: z.literal('open'),
+                    /** Authorization mode selected by the authorizer implementation. */
+                    authorizationMode: z.string(),
+                    /** Optional advertised authorizer capabilities for client hints. */
+                    capabilities: z.optional(z.object({
+                        /** Allowed action subset advertised by the authorizer. */
+                        allowedActions: z.optional(z.array(z.string())),
+                        /** Maximum cumulative authorized amount for this channel. */
+                        maxCumulativeAmount: z.optional(z.string()),
+                    })),
+                    /** Unique channel identifier generated by the client authorizer. */
+                    channelId: z.string(),
+                    /** Initial escrow amount committed for this channel. */
+                    depositAmount: z.string(),
+                    /** Optional voucher expiration timestamp in ISO-8601 format. */
+                    expiresAt: z.optional(z.string()),
+                    /** On-chain transaction reference proving open/setup step. */
+                    openTx: z.string(),
+                    /** Wallet payer for this channel (base58 public key). */
+                    payer: z.string(),
+                    /** Signed session voucher payload for open action. */
+                    voucher: signedVoucherSchema,
+                }),
+                z.object({
+                    /** Session lifecycle action. */
+                    action: z.literal('update'),
+                    /** Existing channel identifier targeted by this update. */
+                    channelId: z.string(),
+                    /** Signed session voucher payload for usage update. */
+                    voucher: signedVoucherSchema,
+                }),
+                z.object({
+                    /** Session lifecycle action. */
+                    action: z.literal('topup'),
+                    /** Additional escrow amount to add to channel deposit. */
+                    additionalAmount: z.string(),
+                    /** Existing channel identifier targeted by this topup. */
+                    channelId: z.string(),
+                    /** On-chain transaction reference proving topup execution. */
+                    topupTx: z.string(),
+                }),
+                z.object({
+                    /** Session lifecycle action. */
+                    action: z.literal('close'),
+                    /** Existing channel identifier targeted by this close. */
+                    channelId: z.string(),
+                    /** Optional on-chain settlement transaction reference for this close. */
+                    closeTx: z.optional(z.string()),
+                    /** Signed final voucher payload for close action. */
+                    voucher: signedVoucherSchema,
+                }),
+            ]),
+        },
+        request: z.object({
+            asset: z.object({
+                /** Token decimals for amount normalization. */
+                decimals: z.number(),
+                /** Asset kind: native SOL or SPL token. */
+                kind: z.string(),
+                /** SPL mint address when kind is `spl`. */
+                mint: z.optional(z.string()),
+                /** Optional ticker/symbol used for display. */
+                symbol: z.optional(z.string()),
+            }),
+            /** Channel program address used to verify vouchers and actions. */
+            channelProgram: z.string(),
+            /** Solana network name, for example mainnet-beta, devnet, localnet. */
+            network: z.optional(z.string()),
+            /** Optional pricing contract used to derive debit increments. */
+            pricing: z.optional(z.object({
+                /** Price per unit in asset base units. */
+                amountPerUnit: z.string(),
+                /** Meter identifier for usage accounting. */
+                meter: z.string(),
+                /** Optional minimum debit to apply per request. */
+                minDebit: z.optional(z.string()),
+                /** Logical unit name charged by the service. */
+                unit: z.string(),
+            })),
+            /** Service recipient wallet that receives settlement funds. */
+            recipient: z.string(),
+            /** Optional server hints for default session behavior. */
+            sessionDefaults: z.optional(z.object({
+                /** Optional close behavior hint for client UX. */
+                closeBehavior: z.optional(z.string()),
+                /** Optional settlement cadence policy hints. */
+                settleInterval: z.optional(z.object({
+                    kind: z.string(),
+                    minIncrement: z.optional(z.string()),
+                    seconds: z.optional(z.number()),
+                })),
+                /** Suggested channel deposit to use on auto-open. */
+                suggestedDeposit: z.optional(z.string()),
+                /** Suggested time-to-live for channel/session in seconds. */
+                ttlSeconds: z.optional(z.number()),
+            })),
+            /** Optional server-side verifier policy hints. */
+            verifier: z.optional(z.object({
+                /** Supported authorization modes for this endpoint. */
+                acceptAuthorizationModes: z.optional(z.array(z.string())),
+                /** Maximum allowable client/server clock skew in seconds. */
+                maxClockSkewSeconds: z.optional(z.number()),
+            })),
+        }),
+    },
+});
+//# sourceMappingURL=Methods.js.map

package/dist/Methods.js.map

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

package/dist/client/Charge.d.ts

@@ -0,0 +1,112 @@
+import { type TransactionSigner } from '@solana/kit';
+import { Method } from 'mppx';
+/**
+ * Creates a Solana `charge` method for usage on the client.
+ *
+ * Supports two modes controlled by the `broadcast` option:
+ *
+ * - **Pull mode** (`broadcast: false`, default): Signs the transaction
+ *   and sends the serialized bytes as a `type="transaction"` credential.
+ *   The server broadcasts it to the Solana network.
+ *
+ * - **Push mode** (`broadcast: true`): Signs, broadcasts, confirms
+ *   the transaction on-chain, and sends the signature as a `type="signature"`
+ *   credential. Cannot be used with fee sponsorship.
+ *
+ * When the server advertises `feePayer: true` in the challenge, the client
+ * sets the server's `feePayerKey` as the transaction fee payer and partially
+ * signs (transfer authority only). The server adds its fee payer signature
+ * before broadcasting.
+ *
+ * @example
+ * ```ts
+ * import { Mppx, solana } from 'solana-mpp-sdk/client'
+ *
+ * const method = solana.charge({ signer, rpcUrl: 'https://api.devnet.solana.com' })
+ * const mppx = Mppx.create({ methods: [method] })
+ *
+ * const response = await mppx.fetch('https://api.example.com/paid-content')
+ * console.log(await response.json())
+ * ```
+ */
+export declare function charge(parameters: charge.Parameters): Method.Client<{
+    readonly intent: "charge";
+    readonly name: "solana";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: import("zod/mini").ZodMiniObject<{
+                signature: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+                transaction: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+                type: import("zod/mini").ZodMiniString<string>;
+            }, import("zod/v4/core").$strip>;
+        };
+        readonly request: import("zod/mini").ZodMiniObject<{
+            amount: import("zod/mini").ZodMiniString<string>;
+            currency: import("zod/mini").ZodMiniString<string>;
+            description: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            externalId: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            methodDetails: import("zod/mini").ZodMiniObject<{
+                decimals: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniNumber<number>>;
+                feePayer: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniBoolean<boolean>>;
+                feePayerKey: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+                network: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+                recentBlockhash: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+                reference: import("zod/mini").ZodMiniString<string>;
+                splToken: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+                tokenProgram: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            }, import("zod/v4/core").$strip>;
+            recipient: import("zod/mini").ZodMiniString<string>;
+        }, import("zod/v4/core").$strip>;
+    };
+}, undefined>;
+export declare namespace charge {
+    type Parameters = {
+        /**
+         * If true, the client broadcasts the transaction and sends the signature
+         * as a `type="signature"` credential. If false (default), the client sends
+         * the signed transaction bytes as a `type="transaction"` credential and the
+         * server broadcasts it.
+         *
+         * Cannot be used with server fee sponsorship (feePayer mode).
+         */
+        broadcast?: boolean;
+        /** Compute unit limit. Defaults to 50,000. */
+        computeUnitLimit?: number;
+        /** Compute unit price in micro-lamports for priority fees. Defaults to 1. */
+        computeUnitPrice?: bigint;
+        /** Called at each step of the payment process. */
+        onProgress?: (event: ProgressEvent) => void;
+        /** Custom RPC URL. If not set, inferred from the challenge's network field. */
+        rpcUrl?: string;
+        /**
+         * Solana transaction signer. Compatible with:
+         * - ConnectorKit's `useTransactionSigner()` hook
+         * - `createKeyPairSignerFromBytes()` from `@solana/kit` for headless usage
+         * - Solana Keychain's `SolanaSigner` for remote signers
+         * - Any `TransactionSigner` implementation
+         */
+        signer: TransactionSigner;
+    };
+    type ProgressEvent = {
+        amount: string;
+        currency: string;
+        feePayerKey?: string;
+        recipient: string;
+        splToken?: string;
+        type: 'challenge';
+    } | {
+        signature: string;
+        type: 'confirming';
+    } | {
+        signature: string;
+        type: 'paid';
+    } | {
+        transaction: string;
+        type: 'signed';
+    } | {
+        type: 'paying';
+    } | {
+        type: 'signing';
+    };
+}
+//# sourceMappingURL=Charge.d.ts.map

package/dist/client/Charge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Charge.d.ts","sourceRoot":"","sources":["../../sdk/src/client/Charge.ts"],"names":[],"mappings":"AAAA,OAAO,EAkBH,KAAK,iBAAiB,EACzB,MAAM,aAAa,CAAC;AAQrB,OAAO,EAAc,MAAM,EAAE,MAAM,MAAM,CAAC;AAQ1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmLnD;AAkED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC5B,KAAK,UAAU,GAAG;QACd;;;;;;;WAOG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,8CAA8C;QAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,6EAA6E;QAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,kDAAkD;QAClD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;QAC5C,+EAA+E;QAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;;;;;WAMG;QACH,MAAM,EAAE,iBAAiB,CAAC;KAC7B,CAAC;IAEF,KAAK,aAAa,GACZ;QACI,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,WAAW,CAAC;KACrB,GACD;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,CAAA;KAAE,GACzC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GACnC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,GACvC;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,GAClB;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC;CAC7B"}

package/dist/client/Charge.js

@@ -0,0 +1,216 @@
+import { AccountRole, address, appendTransactionMessageInstructions, createSolanaRpc, createTransactionMessage, getBase64EncodedWireTransaction, partiallySignTransactionMessageWithSigners, pipe, prependTransactionMessageInstructions, setTransactionMessageFeePayer, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, signature as toSignature, signTransactionMessageWithSigners, } from '@solana/kit';
+import { getSetComputeUnitLimitInstruction, getSetComputeUnitPriceInstruction } from '@solana-program/compute-budget';
+import { getTransferSolInstruction } from '@solana-program/system';
+import { findAssociatedTokenPda, getCreateAssociatedTokenIdempotentInstruction, getTransferCheckedInstruction, } from '@solana-program/token';
+import { Credential, Method } from 'mppx';
+import { ASSOCIATED_TOKEN_PROGRAM, DEFAULT_RPC_URLS, TOKEN_PROGRAM } from '../constants.js';
+import * as Methods from '../Methods.js';
+const MEMO_PROGRAM = 'MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr';
+const textEncoder = new TextEncoder();
+/**
+ * Creates a Solana `charge` method for usage on the client.
+ *
+ * Supports two modes controlled by the `broadcast` option:
+ *
+ * - **Pull mode** (`broadcast: false`, default): Signs the transaction
+ *   and sends the serialized bytes as a `type="transaction"` credential.
+ *   The server broadcasts it to the Solana network.
+ *
+ * - **Push mode** (`broadcast: true`): Signs, broadcasts, confirms
+ *   the transaction on-chain, and sends the signature as a `type="signature"`
+ *   credential. Cannot be used with fee sponsorship.
+ *
+ * When the server advertises `feePayer: true` in the challenge, the client
+ * sets the server's `feePayerKey` as the transaction fee payer and partially
+ * signs (transfer authority only). The server adds its fee payer signature
+ * before broadcasting.
+ *
+ * @example
+ * ```ts
+ * import { Mppx, solana } from 'solana-mpp-sdk/client'
+ *
+ * const method = solana.charge({ signer, rpcUrl: 'https://api.devnet.solana.com' })
+ * const mppx = Mppx.create({ methods: [method] })
+ *
+ * const response = await mppx.fetch('https://api.example.com/paid-content')
+ * console.log(await response.json())
+ * ```
+ */
+export function charge(parameters) {
+    const { signer, broadcast = false, onProgress } = parameters;
+    const method = Method.toClient(Methods.charge, {
+        async createCredential({ challenge }) {
+            const { amount, currency, recipient, methodDetails } = challenge.request;
+            const { network, splToken, decimals, reference, tokenProgram: tokenProgramAddr, feePayer: serverPaysFees, feePayerKey, recentBlockhash: serverBlockhash, } = methodDetails;
+            const rpcUrl = parameters.rpcUrl ?? DEFAULT_RPC_URLS[network || 'mainnet-beta'] ?? DEFAULT_RPC_URLS['mainnet-beta'];
+            const rpc = createSolanaRpc(rpcUrl);
+            onProgress?.({
+                amount,
+                currency: currency || (splToken ? 'token' : 'SOL'),
+                feePayerKey: feePayerKey || undefined,
+                recipient,
+                splToken: splToken || undefined,
+                type: 'challenge',
+            });
+            const useServerFeePayer = serverPaysFees && feePayerKey && !broadcast;
+            // Build transfer instructions.
+            const instructions = [];
+            if (splToken) {
+                // ── SPL token transfer ──
+                const mint = address(splToken);
+                const tokenProg = address(tokenProgramAddr || TOKEN_PROGRAM);
+                const [sourceAta] = await findAssociatedTokenPda({
+                    mint,
+                    owner: signer.address,
+                    tokenProgram: tokenProg,
+                });
+                const [destAta] = await findAssociatedTokenPda({
+                    mint,
+                    owner: address(recipient),
+                    tokenProgram: tokenProg,
+                });
+                // Create destination ATA if it doesn't exist (idempotent).
+                // WARNING: When the server is fee payer, it pays ~0.002 SOL rent for ATA
+                // creation. The recipient can close the ATA to reclaim rent, then the next
+                // payment re-creates it — repeatedly draining the fee payer. Servers SHOULD
+                // verify the ATA exists before signing, or require recipients to pre-create
+                // their ATAs, or factor rent cost into pricing.
+                if (useServerFeePayer) {
+                    // In fee payer mode, the server's key pays ATA rent.
+                    // We build the instruction manually since the payer isn't a local signer.
+                    instructions.push(createAssociatedTokenAccountIdempotent(address(feePayerKey), address(recipient), mint, destAta, tokenProg));
+                }
+                else {
+                    // Standard mode: client pays ATA rent via Codama-generated instruction.
+                    instructions.push(getCreateAssociatedTokenIdempotentInstruction({
+                        ata: destAta,
+                        mint,
+                        owner: address(recipient),
+                        payer: signer,
+                        tokenProgram: tokenProg,
+                    }));
+                }
+                instructions.push(getTransferCheckedInstruction({
+                    amount: BigInt(amount),
+                    authority: signer,
+                    decimals: decimals ?? 6,
+                    destination: destAta,
+                    mint,
+                    source: sourceAta,
+                }, { programAddress: tokenProg }));
+            }
+            else {
+                // ── Native SOL transfer ──
+                instructions.push(getTransferSolInstruction({
+                    amount: BigInt(amount),
+                    destination: address(recipient),
+                    source: signer,
+                }));
+            }
+            if (reference?.trim()) {
+                instructions.push(createReferenceMemoInstruction(reference));
+            }
+            onProgress?.({ type: 'signing' });
+            // Use server-provided blockhash if available, otherwise fetch one.
+            const latestBlockhash = serverBlockhash
+                ? {
+                    blockhash: serverBlockhash,
+                    lastValidBlockHeight: BigInt(0), // Server doesn't provide this; tx lifetime is managed by the blockhash itself.
+                }
+                : (await rpc.getLatestBlockhash().send()).value;
+            const txMessage = pipe(createTransactionMessage({ version: 0 }), msg => useServerFeePayer
+                ? setTransactionMessageFeePayer(address(feePayerKey), msg)
+                : setTransactionMessageFeePayerSigner(signer, msg), msg => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, msg), msg => appendTransactionMessageInstructions(instructions, msg), 
+            // Prepend compute budget instructions per best practice.
+            msg => prependTransactionMessageInstructions([
+                getSetComputeUnitPriceInstruction({ microLamports: parameters.computeUnitPrice ?? 1n }),
+                getSetComputeUnitLimitInstruction({ units: parameters.computeUnitLimit ?? 50_000 }),
+            ], msg));
+            // When server pays fees, partially sign (only the transfer authority).
+            // The server will add its fee payer signature before broadcasting.
+            const signedTx = useServerFeePayer
+                ? await partiallySignTransactionMessageWithSigners(txMessage)
+                : await signTransactionMessageWithSigners(txMessage);
+            const encodedTx = getBase64EncodedWireTransaction(signedTx);
+            if (broadcast) {
+                // ── Push mode (type="signature") ──
+                onProgress?.({ type: 'paying' });
+                const signature = await rpc
+                    .sendTransaction(encodedTx, {
+                    encoding: 'base64',
+                    skipPreflight: false,
+                })
+                    .send();
+                onProgress?.({ signature, type: 'confirming' });
+                await confirmTransaction(rpc, signature);
+                onProgress?.({ signature, type: 'paid' });
+                return Credential.serialize({
+                    challenge,
+                    payload: { signature, type: 'signature' },
+                });
+            }
+            // ── Pull mode (type="transaction", default) ──
+            onProgress?.({ transaction: encodedTx, type: 'signed' });
+            return Credential.serialize({
+                challenge,
+                payload: { transaction: encodedTx, type: 'transaction' },
+            });
+        },
+    });
+    return method;
+}
+// ── Helpers ──
+/**
+ * Creates an Associated Token Account using the idempotent instruction
+ * (CreateIdempotent = discriminator 1). This is a no-op if the ATA exists.
+ *
+ * Used in fee payer mode where the payer is the server's key (not a local
+ * signer). The server adds its signature before broadcasting.
+ */
+function createAssociatedTokenAccountIdempotent(payer, owner, mint, ata, tokenProgram) {
+    return {
+        accounts: [
+            { address: payer, role: AccountRole.WRITABLE_SIGNER },
+            { address: ata, role: AccountRole.WRITABLE },
+            { address: owner, role: AccountRole.READONLY },
+            { address: mint, role: AccountRole.READONLY },
+            { address: address('11111111111111111111111111111111'), role: AccountRole.READONLY },
+            { address: tokenProgram, role: AccountRole.READONLY },
+        ],
+        data: new Uint8Array([1]),
+        programAddress: address(ASSOCIATED_TOKEN_PROGRAM), // CreateIdempotent discriminator
+    };
+}
+/**
+ * Adds challenge reference as memo to make rapid identical payments unique
+ * per challenge (important for local simnets such as Surfpool).
+ */
+function createReferenceMemoInstruction(reference) {
+    return {
+        accounts: [],
+        data: textEncoder.encode(`mppx:${reference}`),
+        programAddress: address(MEMO_PROGRAM),
+    };
+}
+/**
+ * Polls for transaction confirmation via getSignatureStatuses.
+ * Only used in push mode.
+ */
+async function confirmTransaction(rpc, signature, timeoutMs = 30_000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        const { value } = await rpc.getSignatureStatuses([toSignature(signature)]).send();
+        const status = value[0];
+        if (status) {
+            if (status.err) {
+                throw new Error(`Transaction failed: ${JSON.stringify(status.err)}`);
+            }
+            if (status.confirmationStatus === 'confirmed' || status.confirmationStatus === 'finalized') {
+                return;
+            }
+        }
+        await new Promise(r => setTimeout(r, 2_000));
+    }
+    throw new Error('Transaction confirmation timeout');
+}
+//# sourceMappingURL=Charge.js.map

package/dist/client/Charge.js.map

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

package/dist/client/Methods.d.ts

@@ -0,0 +1,27 @@
+import { charge as charge_ } from './Charge.js';
+import { session as session_ } from './Session.js';
+/**
+ * Creates a Solana `charge` method for usage on the client.
+ *
+ * Intercepts 402 responses, sends a Solana transaction to pay the challenge,
+ * and retries with the transaction signature as credential automatically.
+ *
+ * @example
+ * ```ts
+ * import { Mppx, solana } from 'solana-mpp-sdk/client'
+ *
+ * const method = solana.charge({ signer })
+ * const mppx = Mppx.create({ methods: [method] })
+ *
+ * const response = await mppx.fetch('https://api.example.com/paid-content')
+ * ```
+ */
+export declare const solana: {
+    (parameters: solana.Parameters): ReturnType<typeof charge_>;
+    charge: typeof charge_;
+    session: typeof session_;
+};
+export declare namespace solana {
+    type Parameters = charge_.Parameters;
+}
+//# sourceMappingURL=Methods.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Methods.d.ts","sourceRoot":"","sources":["../../sdk/src/client/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,MAAM,EAAE;IACjB,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;IAC5D,MAAM,EAAE,OAAO,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,QAAQ,CAAC;CAI3B,CAAC;AAEH,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC5B,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CACxC"}

package/dist/client/Methods.js

@@ -0,0 +1,23 @@
+import { charge as charge_ } from './Charge.js';
+import { session as session_ } from './Session.js';
+/**
+ * Creates a Solana `charge` method for usage on the client.
+ *
+ * Intercepts 402 responses, sends a Solana transaction to pay the challenge,
+ * and retries with the transaction signature as credential automatically.
+ *
+ * @example
+ * ```ts
+ * import { Mppx, solana } from 'solana-mpp-sdk/client'
+ *
+ * const method = solana.charge({ signer })
+ * const mppx = Mppx.create({ methods: [method] })
+ *
+ * const response = await mppx.fetch('https://api.example.com/paid-content')
+ * ```
+ */
+export const solana = Object.assign((parameters) => charge_(parameters), {
+    charge: charge_,
+    session: session_,
+});
+//# sourceMappingURL=Methods.js.map

package/dist/client/Methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Methods.js","sourceRoot":"","sources":["../../sdk/src/client/Methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,MAAM,GAIf,MAAM,CAAC,MAAM,CAAC,CAAC,UAA6B,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;IACtE,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,QAAQ;CACpB,CAAC,CAAC"}