@suimpp/mpp 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 suimpp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,210 @@
+# @suimpp/mpp
+
+Sui USDC payment method for the [Machine Payments Protocol (MPP)](https://mpp.dev). Accept and make payments on any API — the first MPP implementation on Sui.
+
+[![npm](https://img.shields.io/npm/v/@suimpp/mpp)](https://www.npmjs.com/package/@suimpp/mpp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+**[Website](https://suimpp.dev)** · **[GitHub](https://github.com/mission69b/suimpp)** · **[SDK](https://www.npmjs.com/package/@t2000/sdk)** · **[CLI](https://www.npmjs.com/package/@t2000/cli)**
+
+> **Migrated from `@mppsui/mpp`.** If you were using the old package, switch your imports to `@suimpp/mpp`.
+
+## What is MPP?
+
+The [Machine Payments Protocol](https://mpp.dev) is an open standard by Stripe and Tempo Labs for agent-to-service payments. When a server returns HTTP `402 Payment Required`, the client pays automatically and retries — no API keys, no subscriptions, no human approval.
+
+`@suimpp/mpp` adds **Sui USDC** as a payment method. It works with any MPP-compatible client or server via the `mppx` SDK.
+
+## Installation
+
+```bash
+npm install @suimpp/mpp mppx
+```
+
+## Accept Payments (Server)
+
+Add payments to any API in 5 lines:
+
+```typescript
+import { sui } from '@suimpp/mpp/server';
+import { Mppx } from 'mppx';
+
+const SUI_USDC = '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC';
+
+const mppx = Mppx.create({
+  methods: [sui({ currency: SUI_USDC, recipient: '0xYOUR_ADDRESS' })],
+});
+
+export const GET = mppx.charge({ amount: '0.01' })(
+  () => Response.json({ data: 'paid content' })
+);
+```
+
+No webhooks. No Stripe dashboard. No KYC. USDC arrives directly in your wallet.
+
+## Make Payments (Client)
+
+```typescript
+import { sui } from '@suimpp/mpp/client';
+import { Mppx } from 'mppx/client';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
+import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
+
+const client = new SuiGrpcClient({
+  baseUrl: 'https://fullnode.mainnet.sui.io:443',
+  network: 'mainnet',
+});
+const signer = Ed25519Keypair.deriveKeypair('your mnemonic');
+
+const mppx = Mppx.create({
+  methods: [sui({ client, signer })],
+});
+
+const response = await mppx.fetch('https://api.example.com/resource');
+// If the API returns 402, mppx pays automatically via Sui USDC.
+```
+
+## With t2000 SDK
+
+If you're using the [t2000 SDK](https://www.npmjs.com/package/@t2000/sdk), payments are even simpler:
+
+```typescript
+import { T2000 } from '@t2000/sdk';
+
+const agent = await T2000.create({ pin: 'my-secret' });
+
+const result = await agent.pay({
+  url: 'https://api.example.com/generate',
+  body: { prompt: 'a sunset' },
+  maxPrice: 0.05,
+});
+// Handles 402 → pay → retry automatically.
+// Safeguards enforced (max per tx, daily limits).
+```
+
+### CLI
+
+```bash
+t2000 pay https://api.example.com/data --max-price 0.10
+
+t2000 pay https://api.example.com/analyze \
+  --method POST \
+  --data '{"text":"hello"}' \
+  --max-price 0.05
+```
+
+## How It Works
+
+```
+Agent                    API Server
+  │                          │
+  │── GET /resource ────────>│
+  │<── 402 Payment Required ─│
+  │    {amount, currency,    │
+  │     recipient}           │
+  │                          │
+  │── USDC transfer on Sui ──│  (~400ms finality)
+  │                          │
+  │── GET /resource ────────>│
+  │   + payment credential   │── verify TX on-chain via gRPC
+  │   (Sui tx digest)        │
+  │<── 200 OK + data ────────│
+```
+
+No facilitator. No intermediary. The server verifies the Sui transaction directly via gRPC.
+
+## Server API
+
+### `sui(options)`
+
+Creates a Sui payment method for the server.
+
+```typescript
+import { sui } from '@suimpp/mpp/server';
+
+const method = sui({
+  currency: SUI_USDC,         // Sui coin type (e.g. USDC)
+  recipient: '0xYOUR_ADDR',   // Where payments are sent
+  decimals: 6,                // Optional: currency decimals (default: 6)
+  rpcUrl: '...',              // Optional: custom gRPC endpoint
+  network: 'mainnet',         // Optional: 'mainnet' | 'testnet' | 'devnet'
+  registryUrl: 'https://suimpp.dev/api/report', // Optional: report payments to suimpp.dev
+});
+```
+
+Verification checks:
+- Transaction succeeded on-chain
+- Payment sent to correct recipient (address-normalized comparison)
+- Amount >= requested (BigInt precision, no floating-point)
+
+## Client API
+
+### `sui(options)`
+
+Creates a Sui payment method for the client.
+
+```typescript
+import { sui } from '@suimpp/mpp/client';
+
+const method = sui({
+  client: grpcClient,            // Any Sui client (SuiGrpcClient, etc.)
+  signer: ed25519Keypair,        // Signer from @mysten/sui/cryptography
+  decimals: 6,                   // Optional: currency decimals (default: 6)
+  execute: async (tx) => {       // Optional: custom execution (gas sponsor, etc.)
+    return myGasManager.execute(tx);
+  },
+});
+```
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `client` | `ClientWithCoreApi` | Yes | Any Sui client implementing the core API |
+| `signer` | `Signer` | Yes | Any `Signer` from `@mysten/sui/cryptography` — `Ed25519Keypair` works |
+| `decimals` | `number` | No | Decimal places for the currency (default: 6) |
+| `execute` | `(tx: Transaction) => Promise<{ digest: string }>` | No | Override transaction execution (e.g. gas sponsor/manager) |
+
+The client uses the [`coinWithBalance`](https://sdk.mystenlabs.com/sui/transaction-building/intents) intent to automatically resolve, merge, and split coins for the exact payment amount, then signs and broadcasts the transaction (or delegates to `execute` if provided).
+
+## Constants
+
+### `SUI_USDC_TYPE`
+
+The Sui coin type for Circle-issued USDC on mainnet.
+
+```typescript
+import { SUI_USDC_TYPE } from '@suimpp/mpp';
+// '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC'
+```
+
+## Utilities
+
+### `parseAmountToRaw(amount, decimals)`
+
+Converts a string amount to BigInt raw units without floating-point math.
+
+```typescript
+parseAmountToRaw('0.01', 6);  // 10000n
+parseAmountToRaw('1.50', 6);  // 1500000n
+```
+
+## Why Sui?
+
+MPP is chain-agnostic. We chose Sui because agent payments need:
+
+| | Sui |
+|---|---|
+| **Finality** | ~400ms |
+| **Gas** | <$0.001 per payment |
+| **USDC** | Circle-issued, native |
+| **Verification** | Direct gRPC — no facilitator |
+
+## Testing
+
+```bash
+pnpm --filter @suimpp/mpp test    # 13 tests
+pnpm --filter @suimpp/mpp typecheck
+```
+
+## License
+
+MIT — see [LICENSE](https://github.com/mission69b/suimpp/blob/main/LICENSE)

package/dist/client.cjs

@@ -0,0 +1,79 @@
+'use strict';
+
+var mppx = require('mppx');
+var transactions = require('@mysten/sui/transactions');
+
+// src/client.ts
+var suiCharge = mppx.Method.from({
+  intent: "charge",
+  name: "sui",
+  schema: {
+    credential: {
+      payload: mppx.z.object({
+        digest: mppx.z.string()
+      })
+    },
+    request: mppx.z.object({
+      amount: mppx.z.string(),
+      currency: mppx.z.string(),
+      recipient: mppx.z.string()
+    })
+  }
+});
+
+// src/utils.ts
+function parseAmountToRaw(amount, decimals) {
+  const [whole = "0", frac = ""] = amount.split(".");
+  const paddedFrac = frac.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(whole + paddedFrac);
+}
+
+// src/constants.ts
+var SUI_USDC_TYPE = "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
+
+// src/client.ts
+function sui(options) {
+  const address = options.signer.toSuiAddress();
+  const decimals = options.decimals ?? 6;
+  return mppx.Method.toClient(suiCharge, {
+    async createCredential({ challenge }) {
+      const { amount, currency, recipient } = challenge.request;
+      const amountRaw = parseAmountToRaw(amount, decimals);
+      const tx = new transactions.Transaction();
+      tx.setSender(address);
+      const payment = transactions.coinWithBalance({ balance: amountRaw, type: currency });
+      tx.transferObjects([payment], recipient);
+      let result;
+      try {
+        if (options.execute) {
+          result = await options.execute(tx);
+        } else {
+          const built = await tx.build({ client: options.client });
+          const { signature } = await options.signer.signTransaction(built);
+          const execResult = await options.client.core.executeTransaction({
+            transaction: built,
+            signatures: [signature],
+            include: { effects: true }
+          });
+          if (execResult.FailedTransaction) {
+            throw new Error(execResult.FailedTransaction.status.error?.message ?? "Transaction failed");
+          }
+          result = execResult.Transaction;
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Payment transaction failed: ${msg}`);
+      }
+      return mppx.Credential.serialize({
+        challenge,
+        payload: { digest: result.digest }
+      });
+    }
+  });
+}
+
+exports.SUI_USDC_TYPE = SUI_USDC_TYPE;
+exports.sui = sui;
+exports.suiCharge = suiCharge;
+//# sourceMappingURL=client.cjs.map
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/method.ts","../src/utils.ts","../src/constants.ts","../src/client.ts"],"names":["Method","z","Transaction","coinWithBalance","Credential"],"mappings":"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","file":"client.cjs","sourcesContent":["import { Method, z } from 'mppx';\n\nexport const suiCharge = Method.from({\n  intent: 'charge',\n  name: 'sui',\n  schema: {\n    credential: {\n      payload: z.object({\n        digest: z.string(),\n      }),\n    },\n    request: z.object({\n      amount: z.string(),\n      currency: z.string(),\n      recipient: z.string(),\n    }),\n  },\n});\n","/**\n * Parse a string amount to raw bigint units without floating-point math.\n * \"0.01\" with 6 decimals → 10000n\n */\nexport function parseAmountToRaw(amount: string, decimals: number): bigint {\n  const [whole = '0', frac = ''] = amount.split('.');\n  const paddedFrac = frac.padEnd(decimals, '0').slice(0, decimals);\n  return BigInt(whole + paddedFrac);\n}\n\n/**\n * Retry an async function with linear backoff.\n * Throws the last error if all attempts fail.\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  { attempts = 5, baseDelayMs = 1000 }: { attempts?: number; baseDelayMs?: number } = {},\n): Promise<T> {\n  let lastError: unknown;\n  for (let i = 0; i < attempts; i++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err;\n      if (i < attempts - 1) {\n        await new Promise((r) => setTimeout(r, baseDelayMs * (i + 1)));\n      }\n    }\n  }\n  throw lastError;\n}\n","export const SUI_USDC_TYPE =\n  '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC';\n","import { Method, Credential } from 'mppx';\nimport type { ClientWithCoreApi } from '@mysten/sui/client';\nimport type { Signer } from '@mysten/sui/cryptography';\nimport { coinWithBalance, Transaction } from '@mysten/sui/transactions';\nimport { suiCharge } from './method.js';\nimport { parseAmountToRaw } from './utils.js';\n\nexport { suiCharge } from './method.js';\nexport { SUI_USDC_TYPE } from './constants.js';\n\nexport interface SuiChargeOptions {\n  client: ClientWithCoreApi;\n  signer: Signer;\n  /** Number of decimal places for the currency (default: 6, e.g. USDC). */\n  decimals?: number;\n  /** Override transaction execution (e.g. to route through a gas manager). */\n  execute?: (tx: Transaction) => Promise<{ digest: string }>;\n}\n\nexport function sui(options: SuiChargeOptions) {\n  const address = options.signer.toSuiAddress();\n  const decimals = options.decimals ?? 6;\n\n  return Method.toClient(suiCharge, {\n    async createCredential({ challenge }) {\n      const { amount, currency, recipient } = challenge.request;\n      const amountRaw = parseAmountToRaw(amount, decimals);\n\n      const tx = new Transaction();\n      tx.setSender(address);\n\n      const payment = coinWithBalance({ balance: amountRaw, type: currency });\n      tx.transferObjects([payment], recipient);\n\n      let result;\n      try {\n        if (options.execute) {\n          result = await options.execute(tx);\n        } else {\n          const built = await tx.build({ client: options.client });\n          const { signature } = await options.signer.signTransaction(built);\n          const execResult = await options.client.core.executeTransaction({\n            transaction: built,\n            signatures: [signature],\n            include: { effects: true },\n          });\n          if (execResult.FailedTransaction) {\n            throw new Error(execResult.FailedTransaction.status.error?.message ?? 'Transaction failed');\n          }\n          result = execResult.Transaction!;\n        }\n      } catch (err: unknown) {\n        const msg = err instanceof Error ? err.message : String(err);\n        throw new Error(`Payment transaction failed: ${msg}`);\n      }\n\n      return Credential.serialize({\n        challenge,\n        payload: { digest: result.digest },\n      });\n    },\n  });\n}\n"]}

package/dist/client.d.cts

@@ -0,0 +1,36 @@
+import * as zod_v4_core from 'zod/v4/core';
+import * as zod_mini from 'zod/mini';
+import { Method } from 'mppx';
+import { ClientWithCoreApi } from '@mysten/sui/client';
+import { Signer } from '@mysten/sui/cryptography';
+import { Transaction } from '@mysten/sui/transactions';
+export { S as SUI_USDC_TYPE, s as suiCharge } from './constants-D31h0GdU.cjs';
+
+interface SuiChargeOptions {
+    client: ClientWithCoreApi;
+    signer: Signer;
+    /** Number of decimal places for the currency (default: 6, e.g. USDC). */
+    decimals?: number;
+    /** Override transaction execution (e.g. to route through a gas manager). */
+    execute?: (tx: Transaction) => Promise<{
+        digest: string;
+    }>;
+}
+declare function sui(options: SuiChargeOptions): Method.Client<{
+    readonly intent: "charge";
+    readonly name: "sui";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: zod_mini.ZodMiniObject<{
+                digest: zod_mini.ZodMiniString<string>;
+            }, zod_v4_core.$strip>;
+        };
+        readonly request: zod_mini.ZodMiniObject<{
+            amount: zod_mini.ZodMiniString<string>;
+            currency: zod_mini.ZodMiniString<string>;
+            recipient: zod_mini.ZodMiniString<string>;
+        }, zod_v4_core.$strip>;
+    };
+}, undefined>;
+
+export { type SuiChargeOptions, sui };

package/dist/client.d.ts

@@ -0,0 +1,36 @@
+import * as zod_v4_core from 'zod/v4/core';
+import * as zod_mini from 'zod/mini';
+import { Method } from 'mppx';
+import { ClientWithCoreApi } from '@mysten/sui/client';
+import { Signer } from '@mysten/sui/cryptography';
+import { Transaction } from '@mysten/sui/transactions';
+export { S as SUI_USDC_TYPE, s as suiCharge } from './constants-D31h0GdU.js';
+
+interface SuiChargeOptions {
+    client: ClientWithCoreApi;
+    signer: Signer;
+    /** Number of decimal places for the currency (default: 6, e.g. USDC). */
+    decimals?: number;
+    /** Override transaction execution (e.g. to route through a gas manager). */
+    execute?: (tx: Transaction) => Promise<{
+        digest: string;
+    }>;
+}
+declare function sui(options: SuiChargeOptions): Method.Client<{
+    readonly intent: "charge";
+    readonly name: "sui";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: zod_mini.ZodMiniObject<{
+                digest: zod_mini.ZodMiniString<string>;
+            }, zod_v4_core.$strip>;
+        };
+        readonly request: zod_mini.ZodMiniObject<{
+            amount: zod_mini.ZodMiniString<string>;
+            currency: zod_mini.ZodMiniString<string>;
+            recipient: zod_mini.ZodMiniString<string>;
+        }, zod_v4_core.$strip>;
+    };
+}, undefined>;
+
+export { type SuiChargeOptions, sui };

package/dist/client.js

@@ -0,0 +1,75 @@
+import { Method, z, Credential } from 'mppx';
+import { Transaction, coinWithBalance } from '@mysten/sui/transactions';
+
+// src/client.ts
+var suiCharge = Method.from({
+  intent: "charge",
+  name: "sui",
+  schema: {
+    credential: {
+      payload: z.object({
+        digest: z.string()
+      })
+    },
+    request: z.object({
+      amount: z.string(),
+      currency: z.string(),
+      recipient: z.string()
+    })
+  }
+});
+
+// src/utils.ts
+function parseAmountToRaw(amount, decimals) {
+  const [whole = "0", frac = ""] = amount.split(".");
+  const paddedFrac = frac.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(whole + paddedFrac);
+}
+
+// src/constants.ts
+var SUI_USDC_TYPE = "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
+
+// src/client.ts
+function sui(options) {
+  const address = options.signer.toSuiAddress();
+  const decimals = options.decimals ?? 6;
+  return Method.toClient(suiCharge, {
+    async createCredential({ challenge }) {
+      const { amount, currency, recipient } = challenge.request;
+      const amountRaw = parseAmountToRaw(amount, decimals);
+      const tx = new Transaction();
+      tx.setSender(address);
+      const payment = coinWithBalance({ balance: amountRaw, type: currency });
+      tx.transferObjects([payment], recipient);
+      let result;
+      try {
+        if (options.execute) {
+          result = await options.execute(tx);
+        } else {
+          const built = await tx.build({ client: options.client });
+          const { signature } = await options.signer.signTransaction(built);
+          const execResult = await options.client.core.executeTransaction({
+            transaction: built,
+            signatures: [signature],
+            include: { effects: true }
+          });
+          if (execResult.FailedTransaction) {
+            throw new Error(execResult.FailedTransaction.status.error?.message ?? "Transaction failed");
+          }
+          result = execResult.Transaction;
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Payment transaction failed: ${msg}`);
+      }
+      return Credential.serialize({
+        challenge,
+        payload: { digest: result.digest }
+      });
+    }
+  });
+}
+
+export { SUI_USDC_TYPE, sui, suiCharge };
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/method.ts","../src/utils.ts","../src/constants.ts","../src/client.ts"],"names":["Method"],"mappings":"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","file":"client.js","sourcesContent":["import { Method, z } from 'mppx';\n\nexport const suiCharge = Method.from({\n  intent: 'charge',\n  name: 'sui',\n  schema: {\n    credential: {\n      payload: z.object({\n        digest: z.string(),\n      }),\n    },\n    request: z.object({\n      amount: z.string(),\n      currency: z.string(),\n      recipient: z.string(),\n    }),\n  },\n});\n","/**\n * Parse a string amount to raw bigint units without floating-point math.\n * \"0.01\" with 6 decimals → 10000n\n */\nexport function parseAmountToRaw(amount: string, decimals: number): bigint {\n  const [whole = '0', frac = ''] = amount.split('.');\n  const paddedFrac = frac.padEnd(decimals, '0').slice(0, decimals);\n  return BigInt(whole + paddedFrac);\n}\n\n/**\n * Retry an async function with linear backoff.\n * Throws the last error if all attempts fail.\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  { attempts = 5, baseDelayMs = 1000 }: { attempts?: number; baseDelayMs?: number } = {},\n): Promise<T> {\n  let lastError: unknown;\n  for (let i = 0; i < attempts; i++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err;\n      if (i < attempts - 1) {\n        await new Promise((r) => setTimeout(r, baseDelayMs * (i + 1)));\n      }\n    }\n  }\n  throw lastError;\n}\n","export const SUI_USDC_TYPE =\n  '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC';\n","import { Method, Credential } from 'mppx';\nimport type { ClientWithCoreApi } from '@mysten/sui/client';\nimport type { Signer } from '@mysten/sui/cryptography';\nimport { coinWithBalance, Transaction } from '@mysten/sui/transactions';\nimport { suiCharge } from './method.js';\nimport { parseAmountToRaw } from './utils.js';\n\nexport { suiCharge } from './method.js';\nexport { SUI_USDC_TYPE } from './constants.js';\n\nexport interface SuiChargeOptions {\n  client: ClientWithCoreApi;\n  signer: Signer;\n  /** Number of decimal places for the currency (default: 6, e.g. USDC). */\n  decimals?: number;\n  /** Override transaction execution (e.g. to route through a gas manager). */\n  execute?: (tx: Transaction) => Promise<{ digest: string }>;\n}\n\nexport function sui(options: SuiChargeOptions) {\n  const address = options.signer.toSuiAddress();\n  const decimals = options.decimals ?? 6;\n\n  return Method.toClient(suiCharge, {\n    async createCredential({ challenge }) {\n      const { amount, currency, recipient } = challenge.request;\n      const amountRaw = parseAmountToRaw(amount, decimals);\n\n      const tx = new Transaction();\n      tx.setSender(address);\n\n      const payment = coinWithBalance({ balance: amountRaw, type: currency });\n      tx.transferObjects([payment], recipient);\n\n      let result;\n      try {\n        if (options.execute) {\n          result = await options.execute(tx);\n        } else {\n          const built = await tx.build({ client: options.client });\n          const { signature } = await options.signer.signTransaction(built);\n          const execResult = await options.client.core.executeTransaction({\n            transaction: built,\n            signatures: [signature],\n            include: { effects: true },\n          });\n          if (execResult.FailedTransaction) {\n            throw new Error(execResult.FailedTransaction.status.error?.message ?? 'Transaction failed');\n          }\n          result = execResult.Transaction!;\n        }\n      } catch (err: unknown) {\n        const msg = err instanceof Error ? err.message : String(err);\n        throw new Error(`Payment transaction failed: ${msg}`);\n      }\n\n      return Credential.serialize({\n        challenge,\n        payload: { digest: result.digest },\n      });\n    },\n  });\n}\n"]}

package/dist/constants-D31h0GdU.d.cts

@@ -0,0 +1,22 @@
+import { z } from 'mppx';
+
+declare const suiCharge: {
+    readonly intent: "charge";
+    readonly name: "sui";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: z.ZodMiniObject<{
+                digest: z.ZodMiniString<string>;
+            }, z.core.$strip>;
+        };
+        readonly request: z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            recipient: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+    };
+};
+
+declare const SUI_USDC_TYPE = "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
+
+export { SUI_USDC_TYPE as S, suiCharge as s };

package/dist/constants-D31h0GdU.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'mppx';
+
+declare const suiCharge: {
+    readonly intent: "charge";
+    readonly name: "sui";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: z.ZodMiniObject<{
+                digest: z.ZodMiniString<string>;
+            }, z.core.$strip>;
+        };
+        readonly request: z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            recipient: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+    };
+};
+
+declare const SUI_USDC_TYPE = "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
+
+export { SUI_USDC_TYPE as S, suiCharge as s };

package/dist/index.cjs

@@ -0,0 +1,146 @@
+'use strict';
+
+var mppx = require('mppx');
+var transactions = require('@mysten/sui/transactions');
+var grpc = require('@mysten/sui/grpc');
+var utils = require('@mysten/sui/utils');
+
+// src/method.ts
+var suiCharge = mppx.Method.from({
+  intent: "charge",
+  name: "sui",
+  schema: {
+    credential: {
+      payload: mppx.z.object({
+        digest: mppx.z.string()
+      })
+    },
+    request: mppx.z.object({
+      amount: mppx.z.string(),
+      currency: mppx.z.string(),
+      recipient: mppx.z.string()
+    })
+  }
+});
+
+// src/utils.ts
+function parseAmountToRaw(amount, decimals) {
+  const [whole = "0", frac = ""] = amount.split(".");
+  const paddedFrac = frac.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(whole + paddedFrac);
+}
+async function withRetry(fn, { attempts = 5, baseDelayMs = 1e3 } = {}) {
+  let lastError;
+  for (let i = 0; i < attempts; i++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+      if (i < attempts - 1) {
+        await new Promise((r) => setTimeout(r, baseDelayMs * (i + 1)));
+      }
+    }
+  }
+  throw lastError;
+}
+
+// src/constants.ts
+var SUI_USDC_TYPE = "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
+
+// src/client.ts
+function sui(options) {
+  const address = options.signer.toSuiAddress();
+  const decimals = options.decimals ?? 6;
+  return mppx.Method.toClient(suiCharge, {
+    async createCredential({ challenge }) {
+      const { amount, currency, recipient } = challenge.request;
+      const amountRaw = parseAmountToRaw(amount, decimals);
+      const tx = new transactions.Transaction();
+      tx.setSender(address);
+      const payment = transactions.coinWithBalance({ balance: amountRaw, type: currency });
+      tx.transferObjects([payment], recipient);
+      let result;
+      try {
+        if (options.execute) {
+          result = await options.execute(tx);
+        } else {
+          const built = await tx.build({ client: options.client });
+          const { signature } = await options.signer.signTransaction(built);
+          const execResult = await options.client.core.executeTransaction({
+            transaction: built,
+            signatures: [signature],
+            include: { effects: true }
+          });
+          if (execResult.FailedTransaction) {
+            throw new Error(execResult.FailedTransaction.status.error?.message ?? "Transaction failed");
+          }
+          result = execResult.Transaction;
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Payment transaction failed: ${msg}`);
+      }
+      return mppx.Credential.serialize({
+        challenge,
+        payload: { digest: result.digest }
+      });
+    }
+  });
+}
+function sui2(options) {
+  const network = options.network ?? "mainnet";
+  const decimals = options.decimals ?? 6;
+  const client = new grpc.SuiGrpcClient({
+    baseUrl: options.rpcUrl ?? `https://fullnode.${network}.sui.io:443`,
+    network
+  });
+  const normalizedRecipient = utils.normalizeSuiAddress(options.recipient);
+  return mppx.Method.toServer(suiCharge, {
+    defaults: {
+      currency: options.currency,
+      recipient: options.recipient
+    },
+    async verify({ credential }) {
+      const digest = credential.payload.digest;
+      const tx = await withRetry(
+        () => client.core.getTransaction({ digest, include: { balanceChanges: true } })
+      ).catch(() => {
+        throw new Error(`Could not find the referenced transaction [${digest}]`);
+      });
+      const resolved = tx.Transaction ?? tx.FailedTransaction;
+      if (!resolved?.status.success) {
+        throw new Error("Transaction failed on-chain");
+      }
+      const payment = resolved.balanceChanges.find(
+        (bc) => bc.coinType === options.currency && utils.normalizeSuiAddress(bc.address) === normalizedRecipient && BigInt(bc.amount) > 0n
+      );
+      if (!payment) {
+        throw new Error(
+          "Payment not found in transaction balance changes"
+        );
+      }
+      const transferredRaw = BigInt(payment.amount);
+      const requestedRaw = parseAmountToRaw(credential.challenge.request.amount, decimals);
+      if (transferredRaw < requestedRaw) {
+        throw new Error(
+          `Transferred ${transferredRaw} < requested ${requestedRaw} (raw units)`
+        );
+      }
+      return mppx.Receipt.from({
+        method: "sui",
+        reference: credential.payload.digest,
+        status: "success",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+  });
+}
+
+exports.SUI_USDC_TYPE = SUI_USDC_TYPE;
+exports.parseAmountToRaw = parseAmountToRaw;
+exports.suiCharge = suiCharge;
+exports.suiClient = sui;
+exports.suiServer = sui2;
+exports.withRetry = withRetry;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/method.ts","../src/utils.ts","../src/constants.ts","../src/client.ts","../src/server.ts"],"names":["Method","z","Transaction","coinWithBalance","Credential","sui","SuiGrpcClient","normalizeSuiAddress","Receipt"],"mappings":"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","file":"index.cjs","sourcesContent":["import { Method, z } from 'mppx';\n\nexport const suiCharge = Method.from({\n  intent: 'charge',\n  name: 'sui',\n  schema: {\n    credential: {\n      payload: z.object({\n        digest: z.string(),\n      }),\n    },\n    request: z.object({\n      amount: z.string(),\n      currency: z.string(),\n      recipient: z.string(),\n    }),\n  },\n});\n","/**\n * Parse a string amount to raw bigint units without floating-point math.\n * \"0.01\" with 6 decimals → 10000n\n */\nexport function parseAmountToRaw(amount: string, decimals: number): bigint {\n  const [whole = '0', frac = ''] = amount.split('.');\n  const paddedFrac = frac.padEnd(decimals, '0').slice(0, decimals);\n  return BigInt(whole + paddedFrac);\n}\n\n/**\n * Retry an async function with linear backoff.\n * Throws the last error if all attempts fail.\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  { attempts = 5, baseDelayMs = 1000 }: { attempts?: number; baseDelayMs?: number } = {},\n): Promise<T> {\n  let lastError: unknown;\n  for (let i = 0; i < attempts; i++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err;\n      if (i < attempts - 1) {\n        await new Promise((r) => setTimeout(r, baseDelayMs * (i + 1)));\n      }\n    }\n  }\n  throw lastError;\n}\n","export const SUI_USDC_TYPE =\n  '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC';\n","import { Method, Credential } from 'mppx';\nimport type { ClientWithCoreApi } from '@mysten/sui/client';\nimport type { Signer } from '@mysten/sui/cryptography';\nimport { coinWithBalance, Transaction } from '@mysten/sui/transactions';\nimport { suiCharge } from './method.js';\nimport { parseAmountToRaw } from './utils.js';\n\nexport { suiCharge } from './method.js';\nexport { SUI_USDC_TYPE } from './constants.js';\n\nexport interface SuiChargeOptions {\n  client: ClientWithCoreApi;\n  signer: Signer;\n  /** Number of decimal places for the currency (default: 6, e.g. USDC). */\n  decimals?: number;\n  /** Override transaction execution (e.g. to route through a gas manager). */\n  execute?: (tx: Transaction) => Promise<{ digest: string }>;\n}\n\nexport function sui(options: SuiChargeOptions) {\n  const address = options.signer.toSuiAddress();\n  const decimals = options.decimals ?? 6;\n\n  return Method.toClient(suiCharge, {\n    async createCredential({ challenge }) {\n      const { amount, currency, recipient } = challenge.request;\n      const amountRaw = parseAmountToRaw(amount, decimals);\n\n      const tx = new Transaction();\n      tx.setSender(address);\n\n      const payment = coinWithBalance({ balance: amountRaw, type: currency });\n      tx.transferObjects([payment], recipient);\n\n      let result;\n      try {\n        if (options.execute) {\n          result = await options.execute(tx);\n        } else {\n          const built = await tx.build({ client: options.client });\n          const { signature } = await options.signer.signTransaction(built);\n          const execResult = await options.client.core.executeTransaction({\n            transaction: built,\n            signatures: [signature],\n            include: { effects: true },\n          });\n          if (execResult.FailedTransaction) {\n            throw new Error(execResult.FailedTransaction.status.error?.message ?? 'Transaction failed');\n          }\n          result = execResult.Transaction!;\n        }\n      } catch (err: unknown) {\n        const msg = err instanceof Error ? err.message : String(err);\n        throw new Error(`Payment transaction failed: ${msg}`);\n      }\n\n      return Credential.serialize({\n        challenge,\n        payload: { digest: result.digest },\n      });\n    },\n  });\n}\n","import { Method, Receipt } from 'mppx';\nimport { SuiGrpcClient } from '@mysten/sui/grpc';\nimport { normalizeSuiAddress } from '@mysten/sui/utils';\nimport { suiCharge } from './method.js';\nimport { parseAmountToRaw, withRetry } from './utils.js';\n\nexport { suiCharge } from './method.js';\nexport { SUI_USDC_TYPE } from './constants.js';\n\nexport interface SuiServerOptions {\n  currency: string;\n  recipient: string;\n  /** Number of decimal places for the currency (default: 6, e.g. USDC). */\n  decimals?: number;\n  rpcUrl?: string;\n  network?: 'mainnet' | 'testnet' | 'devnet';\n}\n\nexport function sui(options: SuiServerOptions) {\n  const network = options.network ?? 'mainnet';\n  const decimals = options.decimals ?? 6;\n  const client = new SuiGrpcClient({\n    baseUrl: options.rpcUrl ?? `https://fullnode.${network}.sui.io:443`,\n    network,\n  });\n\n  const normalizedRecipient = normalizeSuiAddress(options.recipient);\n\n  return Method.toServer(suiCharge, {\n    defaults: {\n      currency: options.currency,\n      recipient: options.recipient,\n    },\n\n    async verify({ credential }) {\n      const digest = credential.payload.digest;\n\n      const tx = await withRetry(\n        () => client.core.getTransaction({ digest, include: { balanceChanges: true } }),\n      ).catch(() => {\n        throw new Error(`Could not find the referenced transaction [${digest}]`);\n      });\n\n      const resolved = tx.Transaction ?? tx.FailedTransaction;\n      if (!resolved?.status.success) {\n        throw new Error('Transaction failed on-chain');\n      }\n\n      const payment = resolved.balanceChanges.find(\n        (bc) =>\n          bc.coinType === options.currency &&\n          normalizeSuiAddress(bc.address) === normalizedRecipient &&\n          BigInt(bc.amount) > 0n,\n      );\n\n      if (!payment) {\n        throw new Error(\n          'Payment not found in transaction balance changes',\n        );\n      }\n\n      const transferredRaw = BigInt(payment.amount);\n      const requestedRaw = parseAmountToRaw(credential.challenge.request.amount, decimals);\n      if (transferredRaw < requestedRaw) {\n        throw new Error(\n          `Transferred ${transferredRaw} < requested ${requestedRaw} (raw units)`,\n        );\n      }\n\n      return Receipt.from({\n        method: 'sui',\n        reference: credential.payload.digest,\n        status: 'success',\n        timestamp: new Date().toISOString(),\n      });\n    },\n  });\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,25 @@
+export { S as SUI_USDC_TYPE, s as suiCharge } from './constants-D31h0GdU.cjs';
+export { SuiChargeOptions, sui as suiClient } from './client.cjs';
+export { SuiServerOptions, sui as suiServer } from './server.cjs';
+import 'mppx';
+import 'zod/v4/core';
+import 'zod/mini';
+import '@mysten/sui/client';
+import '@mysten/sui/cryptography';
+import '@mysten/sui/transactions';
+
+/**
+ * Parse a string amount to raw bigint units without floating-point math.
+ * "0.01" with 6 decimals → 10000n
+ */
+declare function parseAmountToRaw(amount: string, decimals: number): bigint;
+/**
+ * Retry an async function with linear backoff.
+ * Throws the last error if all attempts fail.
+ */
+declare function withRetry<T>(fn: () => Promise<T>, { attempts, baseDelayMs }?: {
+    attempts?: number;
+    baseDelayMs?: number;
+}): Promise<T>;
+
+export { parseAmountToRaw, withRetry };

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export { S as SUI_USDC_TYPE, s as suiCharge } from './constants-D31h0GdU.js';
+export { SuiChargeOptions, sui as suiClient } from './client.js';
+export { SuiServerOptions, sui as suiServer } from './server.js';
+import 'mppx';
+import 'zod/v4/core';
+import 'zod/mini';
+import '@mysten/sui/client';
+import '@mysten/sui/cryptography';
+import '@mysten/sui/transactions';
+
+/**
+ * Parse a string amount to raw bigint units without floating-point math.
+ * "0.01" with 6 decimals → 10000n
+ */
+declare function parseAmountToRaw(amount: string, decimals: number): bigint;
+/**
+ * Retry an async function with linear backoff.
+ * Throws the last error if all attempts fail.
+ */
+declare function withRetry<T>(fn: () => Promise<T>, { attempts, baseDelayMs }?: {
+    attempts?: number;
+    baseDelayMs?: number;
+}): Promise<T>;
+
+export { parseAmountToRaw, withRetry };

package/dist/index.js

@@ -0,0 +1,139 @@
+import { Method, z, Credential, Receipt } from 'mppx';
+import { Transaction, coinWithBalance } from '@mysten/sui/transactions';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
+import { normalizeSuiAddress } from '@mysten/sui/utils';
+
+// src/method.ts
+var suiCharge = Method.from({
+  intent: "charge",
+  name: "sui",
+  schema: {
+    credential: {
+      payload: z.object({
+        digest: z.string()
+      })
+    },
+    request: z.object({
+      amount: z.string(),
+      currency: z.string(),
+      recipient: z.string()
+    })
+  }
+});
+
+// src/utils.ts
+function parseAmountToRaw(amount, decimals) {
+  const [whole = "0", frac = ""] = amount.split(".");
+  const paddedFrac = frac.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(whole + paddedFrac);
+}
+async function withRetry(fn, { attempts = 5, baseDelayMs = 1e3 } = {}) {
+  let lastError;
+  for (let i = 0; i < attempts; i++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+      if (i < attempts - 1) {
+        await new Promise((r) => setTimeout(r, baseDelayMs * (i + 1)));
+      }
+    }
+  }
+  throw lastError;
+}
+
+// src/constants.ts
+var SUI_USDC_TYPE = "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
+
+// src/client.ts
+function sui(options) {
+  const address = options.signer.toSuiAddress();
+  const decimals = options.decimals ?? 6;
+  return Method.toClient(suiCharge, {
+    async createCredential({ challenge }) {
+      const { amount, currency, recipient } = challenge.request;
+      const amountRaw = parseAmountToRaw(amount, decimals);
+      const tx = new Transaction();
+      tx.setSender(address);
+      const payment = coinWithBalance({ balance: amountRaw, type: currency });
+      tx.transferObjects([payment], recipient);
+      let result;
+      try {
+        if (options.execute) {
+          result = await options.execute(tx);
+        } else {
+          const built = await tx.build({ client: options.client });
+          const { signature } = await options.signer.signTransaction(built);
+          const execResult = await options.client.core.executeTransaction({
+            transaction: built,
+            signatures: [signature],
+            include: { effects: true }
+          });
+          if (execResult.FailedTransaction) {
+            throw new Error(execResult.FailedTransaction.status.error?.message ?? "Transaction failed");
+          }
+          result = execResult.Transaction;
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Payment transaction failed: ${msg}`);
+      }
+      return Credential.serialize({
+        challenge,
+        payload: { digest: result.digest }
+      });
+    }
+  });
+}
+function sui2(options) {
+  const network = options.network ?? "mainnet";
+  const decimals = options.decimals ?? 6;
+  const client = new SuiGrpcClient({
+    baseUrl: options.rpcUrl ?? `https://fullnode.${network}.sui.io:443`,
+    network
+  });
+  const normalizedRecipient = normalizeSuiAddress(options.recipient);
+  return Method.toServer(suiCharge, {
+    defaults: {
+      currency: options.currency,
+      recipient: options.recipient
+    },
+    async verify({ credential }) {
+      const digest = credential.payload.digest;
+      const tx = await withRetry(
+        () => client.core.getTransaction({ digest, include: { balanceChanges: true } })
+      ).catch(() => {
+        throw new Error(`Could not find the referenced transaction [${digest}]`);
+      });
+      const resolved = tx.Transaction ?? tx.FailedTransaction;
+      if (!resolved?.status.success) {
+        throw new Error("Transaction failed on-chain");
+      }
+      const payment = resolved.balanceChanges.find(
+        (bc) => bc.coinType === options.currency && normalizeSuiAddress(bc.address) === normalizedRecipient && BigInt(bc.amount) > 0n
+      );
+      if (!payment) {
+        throw new Error(
+          "Payment not found in transaction balance changes"
+        );
+      }
+      const transferredRaw = BigInt(payment.amount);
+      const requestedRaw = parseAmountToRaw(credential.challenge.request.amount, decimals);
+      if (transferredRaw < requestedRaw) {
+        throw new Error(
+          `Transferred ${transferredRaw} < requested ${requestedRaw} (raw units)`
+        );
+      }
+      return Receipt.from({
+        method: "sui",
+        reference: credential.payload.digest,
+        status: "success",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+  });
+}
+
+export { SUI_USDC_TYPE, parseAmountToRaw, suiCharge, sui as suiClient, sui2 as suiServer, withRetry };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/method.ts","../src/utils.ts","../src/constants.ts","../src/client.ts","../src/server.ts"],"names":["Method","sui"],"mappings":"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","file":"index.js","sourcesContent":["import { Method, z } from 'mppx';\n\nexport const suiCharge = Method.from({\n  intent: 'charge',\n  name: 'sui',\n  schema: {\n    credential: {\n      payload: z.object({\n        digest: z.string(),\n      }),\n    },\n    request: z.object({\n      amount: z.string(),\n      currency: z.string(),\n      recipient: z.string(),\n    }),\n  },\n});\n","/**\n * Parse a string amount to raw bigint units without floating-point math.\n * \"0.01\" with 6 decimals → 10000n\n */\nexport function parseAmountToRaw(amount: string, decimals: number): bigint {\n  const [whole = '0', frac = ''] = amount.split('.');\n  const paddedFrac = frac.padEnd(decimals, '0').slice(0, decimals);\n  return BigInt(whole + paddedFrac);\n}\n\n/**\n * Retry an async function with linear backoff.\n * Throws the last error if all attempts fail.\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  { attempts = 5, baseDelayMs = 1000 }: { attempts?: number; baseDelayMs?: number } = {},\n): Promise<T> {\n  let lastError: unknown;\n  for (let i = 0; i < attempts; i++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err;\n      if (i < attempts - 1) {\n        await new Promise((r) => setTimeout(r, baseDelayMs * (i + 1)));\n      }\n    }\n  }\n  throw lastError;\n}\n","export const SUI_USDC_TYPE =\n  '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC';\n","import { Method, Credential } from 'mppx';\nimport type { ClientWithCoreApi } from '@mysten/sui/client';\nimport type { Signer } from '@mysten/sui/cryptography';\nimport { coinWithBalance, Transaction } from '@mysten/sui/transactions';\nimport { suiCharge } from './method.js';\nimport { parseAmountToRaw } from './utils.js';\n\nexport { suiCharge } from './method.js';\nexport { SUI_USDC_TYPE } from './constants.js';\n\nexport interface SuiChargeOptions {\n  client: ClientWithCoreApi;\n  signer: Signer;\n  /** Number of decimal places for the currency (default: 6, e.g. USDC). */\n  decimals?: number;\n  /** Override transaction execution (e.g. to route through a gas manager). */\n  execute?: (tx: Transaction) => Promise<{ digest: string }>;\n}\n\nexport function sui(options: SuiChargeOptions) {\n  const address = options.signer.toSuiAddress();\n  const decimals = options.decimals ?? 6;\n\n  return Method.toClient(suiCharge, {\n    async createCredential({ challenge }) {\n      const { amount, currency, recipient } = challenge.request;\n      const amountRaw = parseAmountToRaw(amount, decimals);\n\n      const tx = new Transaction();\n      tx.setSender(address);\n\n      const payment = coinWithBalance({ balance: amountRaw, type: currency });\n      tx.transferObjects([payment], recipient);\n\n      let result;\n      try {\n        if (options.execute) {\n          result = await options.execute(tx);\n        } else {\n          const built = await tx.build({ client: options.client });\n          const { signature } = await options.signer.signTransaction(built);\n          const execResult = await options.client.core.executeTransaction({\n            transaction: built,\n            signatures: [signature],\n            include: { effects: true },\n          });\n          if (execResult.FailedTransaction) {\n            throw new Error(execResult.FailedTransaction.status.error?.message ?? 'Transaction failed');\n          }\n          result = execResult.Transaction!;\n        }\n      } catch (err: unknown) {\n        const msg = err instanceof Error ? err.message : String(err);\n        throw new Error(`Payment transaction failed: ${msg}`);\n      }\n\n      return Credential.serialize({\n        challenge,\n        payload: { digest: result.digest },\n      });\n    },\n  });\n}\n","import { Method, Receipt } from 'mppx';\nimport { SuiGrpcClient } from '@mysten/sui/grpc';\nimport { normalizeSuiAddress } from '@mysten/sui/utils';\nimport { suiCharge } from './method.js';\nimport { parseAmountToRaw, withRetry } from './utils.js';\n\nexport { suiCharge } from './method.js';\nexport { SUI_USDC_TYPE } from './constants.js';\n\nexport interface SuiServerOptions {\n  currency: string;\n  recipient: string;\n  /** Number of decimal places for the currency (default: 6, e.g. USDC). */\n  decimals?: number;\n  rpcUrl?: string;\n  network?: 'mainnet' | 'testnet' | 'devnet';\n}\n\nexport function sui(options: SuiServerOptions) {\n  const network = options.network ?? 'mainnet';\n  const decimals = options.decimals ?? 6;\n  const client = new SuiGrpcClient({\n    baseUrl: options.rpcUrl ?? `https://fullnode.${network}.sui.io:443`,\n    network,\n  });\n\n  const normalizedRecipient = normalizeSuiAddress(options.recipient);\n\n  return Method.toServer(suiCharge, {\n    defaults: {\n      currency: options.currency,\n      recipient: options.recipient,\n    },\n\n    async verify({ credential }) {\n      const digest = credential.payload.digest;\n\n      const tx = await withRetry(\n        () => client.core.getTransaction({ digest, include: { balanceChanges: true } }),\n      ).catch(() => {\n        throw new Error(`Could not find the referenced transaction [${digest}]`);\n      });\n\n      const resolved = tx.Transaction ?? tx.FailedTransaction;\n      if (!resolved?.status.success) {\n        throw new Error('Transaction failed on-chain');\n      }\n\n      const payment = resolved.balanceChanges.find(\n        (bc) =>\n          bc.coinType === options.currency &&\n          normalizeSuiAddress(bc.address) === normalizedRecipient &&\n          BigInt(bc.amount) > 0n,\n      );\n\n      if (!payment) {\n        throw new Error(\n          'Payment not found in transaction balance changes',\n        );\n      }\n\n      const transferredRaw = BigInt(payment.amount);\n      const requestedRaw = parseAmountToRaw(credential.challenge.request.amount, decimals);\n      if (transferredRaw < requestedRaw) {\n        throw new Error(\n          `Transferred ${transferredRaw} < requested ${requestedRaw} (raw units)`,\n        );\n      }\n\n      return Receipt.from({\n        method: 'sui',\n        reference: credential.payload.digest,\n        status: 'success',\n        timestamp: new Date().toISOString(),\n      });\n    },\n  });\n}\n"]}

package/dist/server.cjs

@@ -0,0 +1,103 @@
+'use strict';
+
+var mppx = require('mppx');
+var grpc = require('@mysten/sui/grpc');
+var utils = require('@mysten/sui/utils');
+
+// src/server.ts
+var suiCharge = mppx.Method.from({
+  intent: "charge",
+  name: "sui",
+  schema: {
+    credential: {
+      payload: mppx.z.object({
+        digest: mppx.z.string()
+      })
+    },
+    request: mppx.z.object({
+      amount: mppx.z.string(),
+      currency: mppx.z.string(),
+      recipient: mppx.z.string()
+    })
+  }
+});
+
+// src/utils.ts
+function parseAmountToRaw(amount, decimals) {
+  const [whole = "0", frac = ""] = amount.split(".");
+  const paddedFrac = frac.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(whole + paddedFrac);
+}
+async function withRetry(fn, { attempts = 5, baseDelayMs = 1e3 } = {}) {
+  let lastError;
+  for (let i = 0; i < attempts; i++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+      if (i < attempts - 1) {
+        await new Promise((r) => setTimeout(r, baseDelayMs * (i + 1)));
+      }
+    }
+  }
+  throw lastError;
+}
+
+// src/constants.ts
+var SUI_USDC_TYPE = "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
+
+// src/server.ts
+function sui(options) {
+  const network = options.network ?? "mainnet";
+  const decimals = options.decimals ?? 6;
+  const client = new grpc.SuiGrpcClient({
+    baseUrl: options.rpcUrl ?? `https://fullnode.${network}.sui.io:443`,
+    network
+  });
+  const normalizedRecipient = utils.normalizeSuiAddress(options.recipient);
+  return mppx.Method.toServer(suiCharge, {
+    defaults: {
+      currency: options.currency,
+      recipient: options.recipient
+    },
+    async verify({ credential }) {
+      const digest = credential.payload.digest;
+      const tx = await withRetry(
+        () => client.core.getTransaction({ digest, include: { balanceChanges: true } })
+      ).catch(() => {
+        throw new Error(`Could not find the referenced transaction [${digest}]`);
+      });
+      const resolved = tx.Transaction ?? tx.FailedTransaction;
+      if (!resolved?.status.success) {
+        throw new Error("Transaction failed on-chain");
+      }
+      const payment = resolved.balanceChanges.find(
+        (bc) => bc.coinType === options.currency && utils.normalizeSuiAddress(bc.address) === normalizedRecipient && BigInt(bc.amount) > 0n
+      );
+      if (!payment) {
+        throw new Error(
+          "Payment not found in transaction balance changes"
+        );
+      }
+      const transferredRaw = BigInt(payment.amount);
+      const requestedRaw = parseAmountToRaw(credential.challenge.request.amount, decimals);
+      if (transferredRaw < requestedRaw) {
+        throw new Error(
+          `Transferred ${transferredRaw} < requested ${requestedRaw} (raw units)`
+        );
+      }
+      return mppx.Receipt.from({
+        method: "sui",
+        reference: credential.payload.digest,
+        status: "success",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+  });
+}
+
+exports.SUI_USDC_TYPE = SUI_USDC_TYPE;
+exports.sui = sui;
+exports.suiCharge = suiCharge;
+//# sourceMappingURL=server.cjs.map
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/method.ts","../src/utils.ts","../src/constants.ts","../src/server.ts"],"names":["Method","z","SuiGrpcClient","normalizeSuiAddress","Receipt"],"mappings":";;;;;;;AAEO,IAAM,SAAA,GAAYA,YAAO,IAAA,CAAK;AAAA,EACnC,MAAA,EAAQ,QAAA;AAAA,EACR,IAAA,EAAM,KAAA;AAAA,EACN,MAAA,EAAQ;AAAA,IACN,UAAA,EAAY;AAAA,MACV,OAAA,EAASC,OAAE,MAAA,CAAO;AAAA,QAChB,MAAA,EAAQA,OAAE,MAAA;AAAO,OAClB;AAAA,KACH;AAAA,IACA,OAAA,EAASA,OAAE,MAAA,CAAO;AAAA,MAChB,MAAA,EAAQA,OAAE,MAAA,EAAO;AAAA,MACjB,QAAA,EAAUA,OAAE,MAAA,EAAO;AAAA,MACnB,SAAA,EAAWA,OAAE,MAAA;AAAO,KACrB;AAAA;AAEL,CAAC;;;ACbM,SAAS,gBAAA,CAAiB,QAAgB,QAAA,EAA0B;AACzE,EAAA,MAAM,CAAC,QAAQ,GAAA,EAAK,IAAA,GAAO,EAAE,CAAA,GAAI,MAAA,CAAO,MAAM,GAAG,CAAA;AACjD,EAAA,MAAM,UAAA,GAAa,KAAK,MAAA,CAAO,QAAA,EAAU,GAAG,CAAA,CAAE,KAAA,CAAM,GAAG,QAAQ,CAAA;AAC/D,EAAA,OAAO,MAAA,CAAO,QAAQ,UAAU,CAAA;AAClC;AAMA,eAAsB,SAAA,CACpB,IACA,EAAE,QAAA,GAAW,GAAG,WAAA,GAAc,GAAA,EAAK,GAAiD,EAAC,EACzE;AACZ,EAAA,IAAI,SAAA;AACJ,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,QAAA,EAAU,CAAA,EAAA,EAAK;AACjC,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,EAAA,EAAG;AAAA,IAClB,SAAS,GAAA,EAAK;AACZ,MAAA,SAAA,GAAY,GAAA;AACZ,MAAA,IAAI,CAAA,GAAI,WAAW,CAAA,EAAG;AACpB,QAAA,MAAM,IAAI,QAAQ,CAAC,CAAA,KAAM,WAAW,CAAA,EAAG,WAAA,IAAe,CAAA,GAAI,CAAA,CAAE,CAAC,CAAA;AAAA,MAC/D;AAAA,IACF;AAAA,EACF;AACA,EAAA,MAAM,SAAA;AACR;;;AC9BO,IAAM,aAAA,GACX;;;ACiBK,SAAS,IAAI,OAAA,EAA2B;AAC7C,EAAA,MAAM,OAAA,GAAU,QAAQ,OAAA,IAAW,SAAA;AACnC,EAAA,MAAM,QAAA,GAAW,QAAQ,QAAA,IAAY,CAAA;AACrC,EAAA,MAAM,MAAA,GAAS,IAAIC,kBAAA,CAAc;AAAA,IAC/B,OAAA,EAAS,OAAA,CAAQ,MAAA,IAAU,CAAA,iBAAA,EAAoB,OAAO,CAAA,WAAA,CAAA;AAAA,IACtD;AAAA,GACD,CAAA;AAED,EAAA,MAAM,mBAAA,GAAsBC,yBAAA,CAAoB,OAAA,CAAQ,SAAS,CAAA;AAEjE,EAAA,OAAOH,WAAAA,CAAO,SAAS,SAAA,EAAW;AAAA,IAChC,QAAA,EAAU;AAAA,MACR,UAAU,OAAA,CAAQ,QAAA;AAAA,MAClB,WAAW,OAAA,CAAQ;AAAA,KACrB;AAAA,IAEA,MAAM,MAAA,CAAO,EAAE,UAAA,EAAW,EAAG;AAC3B,MAAA,MAAM,MAAA,GAAS,WAAW,OAAA,CAAQ,MAAA;AAElC,MAAA,MAAM,KAAK,MAAM,SAAA;AAAA,QACf,MAAM,MAAA,CAAO,IAAA,CAAK,cAAA,CAAe,EAAE,MAAA,EAAQ,OAAA,EAAS,EAAE,cAAA,EAAgB,IAAA,EAAK,EAAG;AAAA,OAChF,CAAE,MAAM,MAAM;AACZ,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,2CAAA,EAA8C,MAAM,CAAA,CAAA,CAAG,CAAA;AAAA,MACzE,CAAC,CAAA;AAED,MAAA,MAAM,QAAA,GAAW,EAAA,CAAG,WAAA,IAAe,EAAA,CAAG,iBAAA;AACtC,MAAA,IAAI,CAAC,QAAA,EAAU,MAAA,CAAO,OAAA,EAAS;AAC7B,QAAA,MAAM,IAAI,MAAM,6BAA6B,CAAA;AAAA,MAC/C;AAEA,MAAA,MAAM,OAAA,GAAU,SAAS,cAAA,CAAe,IAAA;AAAA,QACtC,CAAC,EAAA,KACC,EAAA,CAAG,QAAA,KAAa,QAAQ,QAAA,IACxBG,yBAAA,CAAoB,EAAA,CAAG,OAAO,CAAA,KAAM,mBAAA,IACpC,MAAA,CAAO,EAAA,CAAG,MAAM,CAAA,GAAI;AAAA,OACxB;AAEA,MAAA,IAAI,CAAC,OAAA,EAAS;AACZ,QAAA,MAAM,IAAI,KAAA;AAAA,UACR;AAAA,SACF;AAAA,MACF;AAEA,MAAA,MAAM,cAAA,GAAiB,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA;AAC5C,MAAA,MAAM,eAAe,gBAAA,CAAiB,UAAA,CAAW,SAAA,CAAU,OAAA,CAAQ,QAAQ,QAAQ,CAAA;AACnF,MAAA,IAAI,iBAAiB,YAAA,EAAc;AACjC,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAA,YAAA,EAAe,cAAc,CAAA,aAAA,EAAgB,YAAY,CAAA,YAAA;AAAA,SAC3D;AAAA,MACF;AAEA,MAAA,OAAOC,aAAQ,IAAA,CAAK;AAAA,QAClB,MAAA,EAAQ,KAAA;AAAA,QACR,SAAA,EAAW,WAAW,OAAA,CAAQ,MAAA;AAAA,QAC9B,MAAA,EAAQ,SAAA;AAAA,QACR,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,OACnC,CAAA;AAAA,IACH;AAAA,GACD,CAAA;AACH","file":"server.cjs","sourcesContent":["import { Method, z } from 'mppx';\n\nexport const suiCharge = Method.from({\n  intent: 'charge',\n  name: 'sui',\n  schema: {\n    credential: {\n      payload: z.object({\n        digest: z.string(),\n      }),\n    },\n    request: z.object({\n      amount: z.string(),\n      currency: z.string(),\n      recipient: z.string(),\n    }),\n  },\n});\n","/**\n * Parse a string amount to raw bigint units without floating-point math.\n * \"0.01\" with 6 decimals → 10000n\n */\nexport function parseAmountToRaw(amount: string, decimals: number): bigint {\n  const [whole = '0', frac = ''] = amount.split('.');\n  const paddedFrac = frac.padEnd(decimals, '0').slice(0, decimals);\n  return BigInt(whole + paddedFrac);\n}\n\n/**\n * Retry an async function with linear backoff.\n * Throws the last error if all attempts fail.\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  { attempts = 5, baseDelayMs = 1000 }: { attempts?: number; baseDelayMs?: number } = {},\n): Promise<T> {\n  let lastError: unknown;\n  for (let i = 0; i < attempts; i++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err;\n      if (i < attempts - 1) {\n        await new Promise((r) => setTimeout(r, baseDelayMs * (i + 1)));\n      }\n    }\n  }\n  throw lastError;\n}\n","export const SUI_USDC_TYPE =\n  '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC';\n","import { Method, Receipt } from 'mppx';\nimport { SuiGrpcClient } from '@mysten/sui/grpc';\nimport { normalizeSuiAddress } from '@mysten/sui/utils';\nimport { suiCharge } from './method.js';\nimport { parseAmountToRaw, withRetry } from './utils.js';\n\nexport { suiCharge } from './method.js';\nexport { SUI_USDC_TYPE } from './constants.js';\n\nexport interface SuiServerOptions {\n  currency: string;\n  recipient: string;\n  /** Number of decimal places for the currency (default: 6, e.g. USDC). */\n  decimals?: number;\n  rpcUrl?: string;\n  network?: 'mainnet' | 'testnet' | 'devnet';\n}\n\nexport function sui(options: SuiServerOptions) {\n  const network = options.network ?? 'mainnet';\n  const decimals = options.decimals ?? 6;\n  const client = new SuiGrpcClient({\n    baseUrl: options.rpcUrl ?? `https://fullnode.${network}.sui.io:443`,\n    network,\n  });\n\n  const normalizedRecipient = normalizeSuiAddress(options.recipient);\n\n  return Method.toServer(suiCharge, {\n    defaults: {\n      currency: options.currency,\n      recipient: options.recipient,\n    },\n\n    async verify({ credential }) {\n      const digest = credential.payload.digest;\n\n      const tx = await withRetry(\n        () => client.core.getTransaction({ digest, include: { balanceChanges: true } }),\n      ).catch(() => {\n        throw new Error(`Could not find the referenced transaction [${digest}]`);\n      });\n\n      const resolved = tx.Transaction ?? tx.FailedTransaction;\n      if (!resolved?.status.success) {\n        throw new Error('Transaction failed on-chain');\n      }\n\n      const payment = resolved.balanceChanges.find(\n        (bc) =>\n          bc.coinType === options.currency &&\n          normalizeSuiAddress(bc.address) === normalizedRecipient &&\n          BigInt(bc.amount) > 0n,\n      );\n\n      if (!payment) {\n        throw new Error(\n          'Payment not found in transaction balance changes',\n        );\n      }\n\n      const transferredRaw = BigInt(payment.amount);\n      const requestedRaw = parseAmountToRaw(credential.challenge.request.amount, decimals);\n      if (transferredRaw < requestedRaw) {\n        throw new Error(\n          `Transferred ${transferredRaw} < requested ${requestedRaw} (raw units)`,\n        );\n      }\n\n      return Receipt.from({\n        method: 'sui',\n        reference: credential.payload.digest,\n        status: 'success',\n        timestamp: new Date().toISOString(),\n      });\n    },\n  });\n}\n"]}

package/dist/server.d.cts

@@ -0,0 +1,34 @@
+import * as zod_v4_core from 'zod/v4/core';
+import * as zod_mini from 'zod/mini';
+import { Method } from 'mppx';
+export { S as SUI_USDC_TYPE, s as suiCharge } from './constants-D31h0GdU.cjs';
+
+interface SuiServerOptions {
+    currency: string;
+    recipient: string;
+    /** Number of decimal places for the currency (default: 6, e.g. USDC). */
+    decimals?: number;
+    rpcUrl?: string;
+    network?: 'mainnet' | 'testnet' | 'devnet';
+}
+declare function sui(options: SuiServerOptions): Method.Server<{
+    readonly intent: "charge";
+    readonly name: "sui";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: zod_mini.ZodMiniObject<{
+                digest: zod_mini.ZodMiniString<string>;
+            }, zod_v4_core.$strip>;
+        };
+        readonly request: zod_mini.ZodMiniObject<{
+            amount: zod_mini.ZodMiniString<string>;
+            currency: zod_mini.ZodMiniString<string>;
+            recipient: zod_mini.ZodMiniString<string>;
+        }, zod_v4_core.$strip>;
+    };
+}, {
+    readonly currency: string;
+    readonly recipient: string;
+}, undefined>;
+
+export { type SuiServerOptions, sui };

package/dist/server.d.ts

@@ -0,0 +1,34 @@
+import * as zod_v4_core from 'zod/v4/core';
+import * as zod_mini from 'zod/mini';
+import { Method } from 'mppx';
+export { S as SUI_USDC_TYPE, s as suiCharge } from './constants-D31h0GdU.js';
+
+interface SuiServerOptions {
+    currency: string;
+    recipient: string;
+    /** Number of decimal places for the currency (default: 6, e.g. USDC). */
+    decimals?: number;
+    rpcUrl?: string;
+    network?: 'mainnet' | 'testnet' | 'devnet';
+}
+declare function sui(options: SuiServerOptions): Method.Server<{
+    readonly intent: "charge";
+    readonly name: "sui";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: zod_mini.ZodMiniObject<{
+                digest: zod_mini.ZodMiniString<string>;
+            }, zod_v4_core.$strip>;
+        };
+        readonly request: zod_mini.ZodMiniObject<{
+            amount: zod_mini.ZodMiniString<string>;
+            currency: zod_mini.ZodMiniString<string>;
+            recipient: zod_mini.ZodMiniString<string>;
+        }, zod_v4_core.$strip>;
+    };
+}, {
+    readonly currency: string;
+    readonly recipient: string;
+}, undefined>;
+
+export { type SuiServerOptions, sui };

package/dist/server.js

@@ -0,0 +1,99 @@
+import { Method, z, Receipt } from 'mppx';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
+import { normalizeSuiAddress } from '@mysten/sui/utils';
+
+// src/server.ts
+var suiCharge = Method.from({
+  intent: "charge",
+  name: "sui",
+  schema: {
+    credential: {
+      payload: z.object({
+        digest: z.string()
+      })
+    },
+    request: z.object({
+      amount: z.string(),
+      currency: z.string(),
+      recipient: z.string()
+    })
+  }
+});
+
+// src/utils.ts
+function parseAmountToRaw(amount, decimals) {
+  const [whole = "0", frac = ""] = amount.split(".");
+  const paddedFrac = frac.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(whole + paddedFrac);
+}
+async function withRetry(fn, { attempts = 5, baseDelayMs = 1e3 } = {}) {
+  let lastError;
+  for (let i = 0; i < attempts; i++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+      if (i < attempts - 1) {
+        await new Promise((r) => setTimeout(r, baseDelayMs * (i + 1)));
+      }
+    }
+  }
+  throw lastError;
+}
+
+// src/constants.ts
+var SUI_USDC_TYPE = "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
+
+// src/server.ts
+function sui(options) {
+  const network = options.network ?? "mainnet";
+  const decimals = options.decimals ?? 6;
+  const client = new SuiGrpcClient({
+    baseUrl: options.rpcUrl ?? `https://fullnode.${network}.sui.io:443`,
+    network
+  });
+  const normalizedRecipient = normalizeSuiAddress(options.recipient);
+  return Method.toServer(suiCharge, {
+    defaults: {
+      currency: options.currency,
+      recipient: options.recipient
+    },
+    async verify({ credential }) {
+      const digest = credential.payload.digest;
+      const tx = await withRetry(
+        () => client.core.getTransaction({ digest, include: { balanceChanges: true } })
+      ).catch(() => {
+        throw new Error(`Could not find the referenced transaction [${digest}]`);
+      });
+      const resolved = tx.Transaction ?? tx.FailedTransaction;
+      if (!resolved?.status.success) {
+        throw new Error("Transaction failed on-chain");
+      }
+      const payment = resolved.balanceChanges.find(
+        (bc) => bc.coinType === options.currency && normalizeSuiAddress(bc.address) === normalizedRecipient && BigInt(bc.amount) > 0n
+      );
+      if (!payment) {
+        throw new Error(
+          "Payment not found in transaction balance changes"
+        );
+      }
+      const transferredRaw = BigInt(payment.amount);
+      const requestedRaw = parseAmountToRaw(credential.challenge.request.amount, decimals);
+      if (transferredRaw < requestedRaw) {
+        throw new Error(
+          `Transferred ${transferredRaw} < requested ${requestedRaw} (raw units)`
+        );
+      }
+      return Receipt.from({
+        method: "sui",
+        reference: credential.payload.digest,
+        status: "success",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+  });
+}
+
+export { SUI_USDC_TYPE, sui, suiCharge };
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/method.ts","../src/utils.ts","../src/constants.ts","../src/server.ts"],"names":["Method"],"mappings":"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","file":"server.js","sourcesContent":["import { Method, z } from 'mppx';\n\nexport const suiCharge = Method.from({\n  intent: 'charge',\n  name: 'sui',\n  schema: {\n    credential: {\n      payload: z.object({\n        digest: z.string(),\n      }),\n    },\n    request: z.object({\n      amount: z.string(),\n      currency: z.string(),\n      recipient: z.string(),\n    }),\n  },\n});\n","/**\n * Parse a string amount to raw bigint units without floating-point math.\n * \"0.01\" with 6 decimals → 10000n\n */\nexport function parseAmountToRaw(amount: string, decimals: number): bigint {\n  const [whole = '0', frac = ''] = amount.split('.');\n  const paddedFrac = frac.padEnd(decimals, '0').slice(0, decimals);\n  return BigInt(whole + paddedFrac);\n}\n\n/**\n * Retry an async function with linear backoff.\n * Throws the last error if all attempts fail.\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  { attempts = 5, baseDelayMs = 1000 }: { attempts?: number; baseDelayMs?: number } = {},\n): Promise<T> {\n  let lastError: unknown;\n  for (let i = 0; i < attempts; i++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err;\n      if (i < attempts - 1) {\n        await new Promise((r) => setTimeout(r, baseDelayMs * (i + 1)));\n      }\n    }\n  }\n  throw lastError;\n}\n","export const SUI_USDC_TYPE =\n  '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC';\n","import { Method, Receipt } from 'mppx';\nimport { SuiGrpcClient } from '@mysten/sui/grpc';\nimport { normalizeSuiAddress } from '@mysten/sui/utils';\nimport { suiCharge } from './method.js';\nimport { parseAmountToRaw, withRetry } from './utils.js';\n\nexport { suiCharge } from './method.js';\nexport { SUI_USDC_TYPE } from './constants.js';\n\nexport interface SuiServerOptions {\n  currency: string;\n  recipient: string;\n  /** Number of decimal places for the currency (default: 6, e.g. USDC). */\n  decimals?: number;\n  rpcUrl?: string;\n  network?: 'mainnet' | 'testnet' | 'devnet';\n}\n\nexport function sui(options: SuiServerOptions) {\n  const network = options.network ?? 'mainnet';\n  const decimals = options.decimals ?? 6;\n  const client = new SuiGrpcClient({\n    baseUrl: options.rpcUrl ?? `https://fullnode.${network}.sui.io:443`,\n    network,\n  });\n\n  const normalizedRecipient = normalizeSuiAddress(options.recipient);\n\n  return Method.toServer(suiCharge, {\n    defaults: {\n      currency: options.currency,\n      recipient: options.recipient,\n    },\n\n    async verify({ credential }) {\n      const digest = credential.payload.digest;\n\n      const tx = await withRetry(\n        () => client.core.getTransaction({ digest, include: { balanceChanges: true } }),\n      ).catch(() => {\n        throw new Error(`Could not find the referenced transaction [${digest}]`);\n      });\n\n      const resolved = tx.Transaction ?? tx.FailedTransaction;\n      if (!resolved?.status.success) {\n        throw new Error('Transaction failed on-chain');\n      }\n\n      const payment = resolved.balanceChanges.find(\n        (bc) =>\n          bc.coinType === options.currency &&\n          normalizeSuiAddress(bc.address) === normalizedRecipient &&\n          BigInt(bc.amount) > 0n,\n      );\n\n      if (!payment) {\n        throw new Error(\n          'Payment not found in transaction balance changes',\n        );\n      }\n\n      const transferredRaw = BigInt(payment.amount);\n      const requestedRaw = parseAmountToRaw(credential.challenge.request.amount, decimals);\n      if (transferredRaw < requestedRaw) {\n        throw new Error(\n          `Transferred ${transferredRaw} < requested ${requestedRaw} (raw units)`,\n        );\n      }\n\n      return Receipt.from({\n        method: 'sui',\n        reference: credential.payload.digest,\n        status: 'success',\n        timestamp: new Date().toISOString(),\n      });\n    },\n  });\n}\n"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@suimpp/mpp",
+  "version": "0.3.0",
+  "description": "Sui USDC payment method for the Machine Payments Protocol (MPP)",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mpp",
+    "sui",
+    "payment",
+    "usdc",
+    "ai",
+    "agent",
+    "402",
+    "machine-payments",
+    "suimpp"
+  ],
+  "author": "suimpp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mission69b/suimpp.git",
+    "directory": "packages/mpp"
+  },
+  "homepage": "https://suimpp.dev",
+  "dependencies": {
+    "@mysten/sui": "^2",
+    "mppx": "^0.4.9",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "eslint": "^9",
+    "tsup": "^8",
+    "typescript": "^5",
+    "vitest": "^3"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  }
+}