@stablecoin.xyz/radius-mpp 0.1.0

package/README.md

@@ -0,0 +1,172 @@
+# @stablecoin.xyz/radius-mpp
+
+MPP custom payment method for **Radius blockchain** ERC-20 token transfers.
+
+Built on the [mppx](https://github.com/wevm/mppx) SDK using the `Method.from` / `Method.toClient` / `Method.toServer` pattern.
+
+## Install
+
+```bash
+npm install @stablecoin.xyz/radius-mpp mppx viem
+```
+
+## Client usage
+
+The client signs and broadcasts an ERC-20 `transfer()` on Radius, waits for confirmation, then returns the `txHash` as the credential payload. Gas price is estimated automatically via the chain's RPC (Radius uses legacy gas pricing, not EIP-1559).
+
+```ts
+import { Mppx, radius } from '@stablecoin.xyz/radius-mpp/client'
+import { radiusMainnet } from '@stablecoin.xyz/radius-mpp'
+import { createWalletClient, http } from 'viem'
+import { privateKeyToAccount } from 'viem/accounts'
+
+const account = privateKeyToAccount('0x...')
+const walletClient = createWalletClient({
+  account,
+  chain: radiusMainnet,
+  transport: http(radiusMainnet.rpcUrls.default.http[0]),
+})
+
+const { fetch } = Mppx.create({
+  methods: [radius({ walletClient })],
+  polyfill: false,
+})
+
+// Any 402 response from an MPP server using the "radius" method
+// will be handled automatically
+const response = await fetch('https://api.example.com/premium-endpoint')
+```
+
+## Server usage
+
+The server verifies that the `txHash` corresponds to a successful ERC-20 transfer on Radius with the correct amount, token, and recipient. Import `Mppx` from the framework adapter you're using (`mppx/hono`, `mppx/express`, `mppx/nextjs`, or `mppx/elysia`).
+
+```ts
+import { Mppx } from 'mppx/hono'
+import { Expires } from 'mppx/server'
+import { radius } from '@stablecoin.xyz/radius-mpp/server'
+import { SBC_TOKEN, radiusMainnet } from '@stablecoin.xyz/radius-mpp'
+
+const mppx = Mppx.create({
+  methods: [radius({ confirmations: 1 })],
+})
+
+// Hono example — gate a route behind a 1 SBC payment
+app.get(
+  '/premium',
+  mppx.charge({
+    amount: '1000000',        // 1 SBC (6 decimals)
+    currency: 'SBC',
+    chainId: radiusMainnet.id,
+    token: SBC_TOKEN.mainnet,
+    recipient: '0xYourAddress',
+    expires: Expires.minutes(5),
+  }),
+  (c) => c.json({ data: 'premium content' }),
+)
+```
+
+### Server options
+
+`radius()` accepts a config object passed to `Mppx.create`:
+
+```ts
+const mppx = Mppx.create({
+  methods: [radius({
+    confirmations: 1,       // optional
+    rpcUrl: 'https://...',  // optional
+  })],
+})
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `confirmations` | `1` | How many block confirmations to wait before accepting the payment. Radius has fast finality so `1` is usually sufficient. Increase for high-value transactions where you want extra certainty the tx won't reorg. |
+| `rpcUrl` | Chain's default RPC | Override the RPC endpoint used to fetch and verify transaction receipts. Useful if you're running your own Radius node or need a higher-throughput RPC provider. |
+
+Both are optional — `radius()` with no arguments works out of the box using chain defaults.
+
+See [`examples/`](./examples) for complete working examples with Hono, Express, Next.js, and Elysia.
+
+## Supported chains
+
+| Network | Chain ID | RPC | Explorer |
+|---------|----------|-----|----------|
+| Radius Mainnet | 723487 | `https://rpc.radiustech.xyz` | [network.radiustech.xyz](https://network.radiustech.xyz) |
+| Radius Testnet | 72344 | `https://rpc.testnet.radiustech.xyz` | [testnet.radiustech.xyz](https://testnet.radiustech.xyz) |
+
+Legacy chain ID `723` is aliased to mainnet for backwards compatibility.
+
+### Explorer helper
+
+```ts
+import { explorerTxUrl } from '@stablecoin.xyz/radius-mpp'
+
+const url = explorerTxUrl(72344, '0xee483...')
+// → "https://testnet.radiustech.xyz/tx/0xee483..."
+```
+
+## Token
+
+| Token | Address | Decimals |
+|-------|---------|----------|
+| SBC | `0x33ad9e4bd16b69b5bfded37d8b5d9ff9aba014fb` | 6 |
+
+Same contract address on both mainnet and testnet.
+
+## Examples
+
+Self-contained in `examples/` with their own `package.json`. To run:
+
+```bash
+cd examples
+pnpm install
+MPP_SECRET_KEY=your-secret RECIPIENT=0xYourAddress pnpm hono
+```
+
+| Script | Framework | Description |
+|--------|-----------|-------------|
+| `pnpm hono` | Hono | Single paid endpoint |
+| `pnpm express` | Express | Express middleware |
+| `pnpm testnet` | Hono | Testnet configuration |
+| `pnpm multi-tier` | Hono | Multiple price tiers |
+| `pnpm client` | — | Client auto-payment (`NETWORK=testnet` by default) |
+| [`nextjs-route.ts`](./examples/nextjs-route.ts) | Next.js | App Router route handler (copy into your app) |
+| [`elysia-server.ts`](./examples/elysia-server.ts) | Elysia | Bun/Elysia guard pattern |
+
+### Environment variables
+
+| Variable | Used by | Description |
+|----------|---------|-------------|
+| `MPP_SECRET_KEY` | Server | HMAC signing key for challenges |
+| `RECIPIENT` | Server | Wallet address to receive SBC payments |
+| `PRIVATE_KEY` | Client | Hex-encoded wallet private key |
+| `API_URL` | Client | Server URL (default: `http://localhost:3000`) |
+| `NETWORK` | Client | `mainnet` or `testnet` (default: `testnet`) |
+
+## Development
+
+```bash
+pnpm build             # Build with tsup (ESM → dist/)
+pnpm dev               # Build in watch mode
+pnpm typecheck         # tsc --noEmit
+pnpm test              # Run all tests
+pnpm test:coverage     # Tests with coverage thresholds
+pnpm test:unit         # Unit tests only
+pnpm test:integration  # Integration tests only
+```
+
+Pre-commit hook runs typecheck → build → tests with coverage enforcement. Installed automatically via `pnpm prepare`.
+
+### Coverage thresholds
+
+| Metric | Threshold |
+|--------|-----------|
+| Lines | 90% |
+| Branches | 85% |
+| Functions | 90% |
+| Statements | 90% |
+
+## License
+
+MIT

package/dist/chunk-TM4JSIP6.js

@@ -0,0 +1,100 @@
+// src/index.ts
+import { Method, z } from "mppx";
+
+// src/constants.ts
+import { defineChain } from "viem";
+var SBC_TOKEN = {
+  mainnet: "0x33ad9e4bd16b69b5bfded37d8b5d9ff9aba014fb",
+  testnet: "0x33ad9e4bd16b69b5bfded37d8b5d9ff9aba014fb"
+};
+var SBC_DECIMALS = 6;
+var radiusMainnet = defineChain({
+  id: 723487,
+  name: "Radius",
+  nativeCurrency: { name: "RUSD", symbol: "RUSD", decimals: 18 },
+  rpcUrls: {
+    default: { http: ["https://rpc.radiustech.xyz"] }
+  },
+  blockExplorers: {
+    default: { name: "Radius Explorer", url: "https://network.radiustech.xyz" }
+  }
+});
+var radiusTestnet = defineChain({
+  id: 72344,
+  name: "Radius Testnet",
+  nativeCurrency: { name: "RUSD", symbol: "RUSD", decimals: 18 },
+  rpcUrls: {
+    default: { http: ["https://rpc.testnet.radiustech.xyz"] }
+  },
+  blockExplorers: {
+    default: { name: "Radius Testnet Explorer", url: "https://testnet.radiustech.xyz" }
+  },
+  testnet: true
+});
+function resolveChain(chainId) {
+  if (chainId === radiusMainnet.id || chainId === 723) return radiusMainnet;
+  if (chainId === radiusTestnet.id) return radiusTestnet;
+  return null;
+}
+function explorerTxUrl(chainId, txHash) {
+  const chain = resolveChain(chainId);
+  if (!chain?.blockExplorers?.default) return null;
+  return `${chain.blockExplorers.default.url}/tx/${txHash}`;
+}
+var ERC20_ABI = [
+  {
+    inputs: [
+      { name: "to", type: "address" },
+      { name: "amount", type: "uint256" }
+    ],
+    name: "transfer",
+    outputs: [{ name: "", type: "bool" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ name: "account", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  }
+];
+
+// src/index.ts
+var charge = Method.from({
+  intent: "charge",
+  name: "radius",
+  schema: {
+    credential: {
+      payload: z.object({
+        /** The on-chain transaction hash of the ERC-20 transfer */
+        txHash: z.string()
+      })
+    },
+    request: z.object({
+      /** Transfer amount in atomic units (e.g. "1000000" for 1 SBC with 6 decimals) */
+      amount: z.string(),
+      /** Token symbol or identifier (e.g. "SBC") */
+      currency: z.string(),
+      /** Chain ID (723487 for mainnet, 72344 for testnet) */
+      chainId: z.number(),
+      /** ERC-20 token contract address on Radius */
+      token: z.string(),
+      /** Recipient address (the seller / payee) */
+      recipient: z.string()
+    })
+  }
+});
+
+export {
+  SBC_TOKEN,
+  SBC_DECIMALS,
+  radiusMainnet,
+  radiusTestnet,
+  resolveChain,
+  explorerTxUrl,
+  ERC20_ABI,
+  charge
+};
+//# sourceMappingURL=chunk-TM4JSIP6.js.map

package/dist/chunk-TM4JSIP6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constants.ts"],"sourcesContent":["/**\n * @stablecoin.xyz/radius-mpp\n *\n * Shared method definition for Radius ERC-20 payments via MPP.\n * Import from the root path in code that needs the schema but not\n * client or server logic (e.g. shared types).\n */\n\nimport { Method, z } from 'mppx'\n\nexport { radiusMainnet, radiusTestnet, SBC_TOKEN, SBC_DECIMALS, explorerTxUrl } from './constants.js'\n\n/**\n * Radius charge method — one-time ERC-20 token transfer on Radius.\n *\n * Request schema: the Challenge fields the server sends to the client.\n * Credential payload: what the client returns after broadcasting the tx.\n */\nexport const charge = Method.from({\n  intent: 'charge',\n  name: 'radius',\n  schema: {\n    credential: {\n      payload: z.object({\n        /** The on-chain transaction hash of the ERC-20 transfer */\n        txHash: z.string(),\n      }),\n    },\n    request: z.object({\n      /** Transfer amount in atomic units (e.g. \"1000000\" for 1 SBC with 6 decimals) */\n      amount: z.string(),\n      /** Token symbol or identifier (e.g. \"SBC\") */\n      currency: z.string(),\n      /** Chain ID (723487 for mainnet, 72344 for testnet) */\n      chainId: z.number(),\n      /** ERC-20 token contract address on Radius */\n      token: z.string(),\n      /** Recipient address (the seller / payee) */\n      recipient: z.string(),\n    }),\n  },\n})\n\n/** Re-export the inferred types for external consumers */\nexport type RadiusCharge = typeof charge\n","import { defineChain } from 'viem'\n\n// ---------------------------------------------------------------------------\n// Token addresses (SBC stablecoin on Radius)\n// ---------------------------------------------------------------------------\n\nexport const SBC_TOKEN = {\n  mainnet: '0x33ad9e4bd16b69b5bfded37d8b5d9ff9aba014fb' as const,\n  testnet: '0x33ad9e4bd16b69b5bfded37d8b5d9ff9aba014fb' as const,\n}\n\nexport const SBC_DECIMALS = 6\n\n// ---------------------------------------------------------------------------\n// Chain definitions (viem-compatible)\n// ---------------------------------------------------------------------------\n\nexport const radiusMainnet = defineChain({\n  id: 723487,\n  name: 'Radius',\n  nativeCurrency: { name: 'RUSD', symbol: 'RUSD', decimals: 18 },\n  rpcUrls: {\n    default: { http: ['https://rpc.radiustech.xyz'] },\n  },\n  blockExplorers: {\n    default: { name: 'Radius Explorer', url: 'https://network.radiustech.xyz' },\n  },\n})\n\nexport const radiusTestnet = defineChain({\n  id: 72344,\n  name: 'Radius Testnet',\n  nativeCurrency: { name: 'RUSD', symbol: 'RUSD', decimals: 18 },\n  rpcUrls: {\n    default: { http: ['https://rpc.testnet.radiustech.xyz'] },\n  },\n  blockExplorers: {\n    default: { name: 'Radius Testnet Explorer', url: 'https://testnet.radiustech.xyz' },\n  },\n  testnet: true,\n})\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/** Resolve chain definition by chain ID. Returns mainnet for 723 (legacy alias). */\nexport function resolveChain(chainId: number) {\n  if (chainId === radiusMainnet.id || chainId === 723) return radiusMainnet\n  if (chainId === radiusTestnet.id) return radiusTestnet\n  return null\n}\n\n/** Resolve the SBC token address for a given chain ID. */\nexport function resolveTokenAddress(chainId: number) {\n  if (chainId === radiusMainnet.id || chainId === 723) return SBC_TOKEN.mainnet\n  if (chainId === radiusTestnet.id) return SBC_TOKEN.testnet\n  return null\n}\n\n/** Build an explorer URL for a transaction hash on a given chain. */\nexport function explorerTxUrl(chainId: number, txHash: string): string | null {\n  const chain = resolveChain(chainId)\n  if (!chain?.blockExplorers?.default) return null\n  return `${chain.blockExplorers.default.url}/tx/${txHash}`\n}\n\n// Standard ERC-20 ABI subset used by client and server\nexport const ERC20_ABI = [\n  {\n    inputs: [\n      { name: 'to', type: 'address' },\n      { name: 'amount', type: 'uint256' },\n    ],\n    name: 'transfer',\n    outputs: [{ name: '', type: 'bool' }],\n    stateMutability: 'nonpayable',\n    type: 'function',\n  },\n  {\n    inputs: [{ name: 'account', type: 'address' }],\n    name: 'balanceOf',\n    outputs: [{ name: '', type: 'uint256' }],\n    stateMutability: 'view',\n    type: 'function',\n  },\n] as const\n"],"mappings":";AAQA,SAAS,QAAQ,SAAS;;;ACR1B,SAAS,mBAAmB;AAMrB,IAAM,YAAY;AAAA,EACvB,SAAS;AAAA,EACT,SAAS;AACX;AAEO,IAAM,eAAe;AAMrB,IAAM,gBAAgB,YAAY;AAAA,EACvC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,gBAAgB,EAAE,MAAM,QAAQ,QAAQ,QAAQ,UAAU,GAAG;AAAA,EAC7D,SAAS;AAAA,IACP,SAAS,EAAE,MAAM,CAAC,4BAA4B,EAAE;AAAA,EAClD;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,EAAE,MAAM,mBAAmB,KAAK,iCAAiC;AAAA,EAC5E;AACF,CAAC;AAEM,IAAM,gBAAgB,YAAY;AAAA,EACvC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,gBAAgB,EAAE,MAAM,QAAQ,QAAQ,QAAQ,UAAU,GAAG;AAAA,EAC7D,SAAS;AAAA,IACP,SAAS,EAAE,MAAM,CAAC,oCAAoC,EAAE;AAAA,EAC1D;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,EAAE,MAAM,2BAA2B,KAAK,iCAAiC;AAAA,EACpF;AAAA,EACA,SAAS;AACX,CAAC;AAOM,SAAS,aAAa,SAAiB;AAC5C,MAAI,YAAY,cAAc,MAAM,YAAY,IAAK,QAAO;AAC5D,MAAI,YAAY,cAAc,GAAI,QAAO;AACzC,SAAO;AACT;AAUO,SAAS,cAAc,SAAiB,QAA+B;AAC5E,QAAM,QAAQ,aAAa,OAAO;AAClC,MAAI,CAAC,OAAO,gBAAgB,QAAS,QAAO;AAC5C,SAAO,GAAG,MAAM,eAAe,QAAQ,GAAG,OAAO,MAAM;AACzD;AAGO,IAAM,YAAY;AAAA,EACvB;AAAA,IACE,QAAQ;AAAA,MACN,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,MAC9B,EAAE,MAAM,UAAU,MAAM,UAAU;AAAA,IACpC;AAAA,IACA,MAAM;AAAA,IACN,SAAS,CAAC,EAAE,MAAM,IAAI,MAAM,OAAO,CAAC;AAAA,IACpC,iBAAiB;AAAA,IACjB,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,QAAQ,CAAC,EAAE,MAAM,WAAW,MAAM,UAAU,CAAC;AAAA,IAC7C,MAAM;AAAA,IACN,SAAS,CAAC,EAAE,MAAM,IAAI,MAAM,UAAU,CAAC;AAAA,IACvC,iBAAiB;AAAA,IACjB,MAAM;AAAA,EACR;AACF;;;ADpEO,IAAM,SAAS,OAAO,KAAK;AAAA,EAChC,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,QAAQ;AAAA,IACN,YAAY;AAAA,MACV,SAAS,EAAE,OAAO;AAAA;AAAA,QAEhB,QAAQ,EAAE,OAAO;AAAA,MACnB,CAAC;AAAA,IACH;AAAA,IACA,SAAS,EAAE,OAAO;AAAA;AAAA,MAEhB,QAAQ,EAAE,OAAO;AAAA;AAAA,MAEjB,UAAU,EAAE,OAAO;AAAA;AAAA,MAEnB,SAAS,EAAE,OAAO;AAAA;AAAA,MAElB,OAAO,EAAE,OAAO;AAAA;AAAA,MAEhB,WAAW,EAAE,OAAO;AAAA,IACtB,CAAC;AAAA,EACH;AACF,CAAC;","names":[]}

package/dist/client.d.ts

@@ -0,0 +1,22 @@
+import { Method } from 'mppx';
+export { Mppx } from 'mppx/client';
+import { WalletClient, Transport, Chain, Account } from 'viem';
+import { RadiusCharge } from './index.js';
+
+/**
+ * @stablecoin.xyz/radius-mpp/client
+ *
+ * Client-side: signs and broadcasts an ERC-20 transfer on Radius,
+ * then returns the txHash as the Credential payload.
+ */
+
+interface RadiusClientConfig {
+    /**
+     * A viem WalletClient that can sign and send transactions on Radius.
+     * Must have an account attached (e.g. via privateKeyToAccount or browser wallet).
+     */
+    walletClient: WalletClient<Transport, Chain, Account>;
+}
+declare function radius(config: RadiusClientConfig): Method.Client<RadiusCharge>;
+
+export { type RadiusClientConfig, radius };

package/dist/client.js

@@ -0,0 +1,55 @@
+import {
+  ERC20_ABI,
+  charge,
+  resolveChain
+} from "./chunk-TM4JSIP6.js";
+
+// src/client.ts
+import { Credential, Method } from "mppx";
+import { Mppx } from "mppx/client";
+import {
+  createPublicClient,
+  http,
+  encodeFunctionData
+} from "viem";
+function radius(config) {
+  const { walletClient } = config;
+  return Method.toClient(charge, {
+    async createCredential({ challenge }) {
+      const { amount, chainId, token, recipient } = challenge.request;
+      const chain = resolveChain(chainId);
+      if (!chain) {
+        throw new Error(`Unsupported Radius chain ID: ${chainId}`);
+      }
+      const data = encodeFunctionData({
+        abi: ERC20_ABI,
+        functionName: "transfer",
+        args: [recipient, BigInt(amount)]
+      });
+      const publicClient = createPublicClient({
+        chain,
+        transport: http(chain.rpcUrls.default.http[0])
+      });
+      const gasPrice = await publicClient.getGasPrice();
+      const txHash = await walletClient.sendTransaction({
+        to: token,
+        data,
+        chain,
+        gasPrice
+      });
+      await publicClient.waitForTransactionReceipt({
+        hash: txHash,
+        confirmations: 1
+      });
+      return Credential.serialize({
+        challenge,
+        payload: { txHash }
+      });
+    }
+  });
+}
+export {
+  Mppx,
+  radius
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["/**\n * @stablecoin.xyz/radius-mpp/client\n *\n * Client-side: signs and broadcasts an ERC-20 transfer on Radius,\n * then returns the txHash as the Credential payload.\n */\n\nimport { Credential, Method } from 'mppx'\nimport { Mppx } from 'mppx/client'\nimport {\n  createPublicClient,\n  createWalletClient,\n  http,\n  type Account,\n  type Chain,\n  type Transport,\n  type WalletClient,\n  encodeFunctionData,\n} from 'viem'\nimport { charge, type RadiusCharge } from './index.js'\nimport { ERC20_ABI, resolveChain } from './constants.js'\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface RadiusClientConfig {\n  /**\n   * A viem WalletClient that can sign and send transactions on Radius.\n   * Must have an account attached (e.g. via privateKeyToAccount or browser wallet).\n   */\n  walletClient: WalletClient<Transport, Chain, Account>\n}\n\n// ---------------------------------------------------------------------------\n// Client method factory\n// ---------------------------------------------------------------------------\n\nexport function radius(config: RadiusClientConfig): Method.Client<RadiusCharge> {\n  const { walletClient } = config\n\n  return Method.toClient(charge, {\n    async createCredential({ challenge }) {\n      const { amount, chainId, token, recipient } = challenge.request\n\n      // Resolve the Radius chain definition for RPC access\n      const chain = resolveChain(chainId)\n      if (!chain) {\n        throw new Error(`Unsupported Radius chain ID: ${chainId}`)\n      }\n\n      // Build the ERC-20 transfer calldata\n      const data = encodeFunctionData({\n        abi: ERC20_ABI,\n        functionName: 'transfer',\n        args: [recipient as `0x${string}`, BigInt(amount)],\n      })\n\n      // Use the chain's RPC for gas estimation and receipt waiting\n      const publicClient = createPublicClient({\n        chain,\n        transport: http(chain.rpcUrls.default.http[0]),\n      })\n\n      // Estimate gas price (Radius doesn't support EIP-1559 fee estimation)\n      const gasPrice = await publicClient.getGasPrice()\n\n      // Send the transaction using the resolved chain's RPC\n      const txHash = await walletClient.sendTransaction({\n        to: token as `0x${string}`,\n        data,\n        chain,\n        gasPrice,\n      })\n\n      // TODO: Make confirmation count configurable (Radius has fast blocks,\n      // 1 confirmation should suffice but we may want to allow tuning)\n      await publicClient.waitForTransactionReceipt({\n        hash: txHash,\n        confirmations: 1,\n      })\n\n      return Credential.serialize({\n        challenge,\n        payload: { txHash },\n      })\n    },\n  })\n}\n\n// Re-export Mppx so consumers only need one import\nexport { Mppx }\n"],"mappings":";;;;;;;AAOA,SAAS,YAAY,cAAc;AACnC,SAAS,YAAY;AACrB;AAAA,EACE;AAAA,EAEA;AAAA,EAKA;AAAA,OACK;AAoBA,SAAS,OAAO,QAAyD;AAC9E,QAAM,EAAE,aAAa,IAAI;AAEzB,SAAO,OAAO,SAAS,QAAQ;AAAA,IAC7B,MAAM,iBAAiB,EAAE,UAAU,GAAG;AACpC,YAAM,EAAE,QAAQ,SAAS,OAAO,UAAU,IAAI,UAAU;AAGxD,YAAM,QAAQ,aAAa,OAAO;AAClC,UAAI,CAAC,OAAO;AACV,cAAM,IAAI,MAAM,gCAAgC,OAAO,EAAE;AAAA,MAC3D;AAGA,YAAM,OAAO,mBAAmB;AAAA,QAC9B,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM,CAAC,WAA4B,OAAO,MAAM,CAAC;AAAA,MACnD,CAAC;AAGD,YAAM,eAAe,mBAAmB;AAAA,QACtC;AAAA,QACA,WAAW,KAAK,MAAM,QAAQ,QAAQ,KAAK,CAAC,CAAC;AAAA,MAC/C,CAAC;AAGD,YAAM,WAAW,MAAM,aAAa,YAAY;AAGhD,YAAM,SAAS,MAAM,aAAa,gBAAgB;AAAA,QAChD,IAAI;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAID,YAAM,aAAa,0BAA0B;AAAA,QAC3C,MAAM;AAAA,QACN,eAAe;AAAA,MACjB,CAAC;AAED,aAAO,WAAW,UAAU;AAAA,QAC1B;AAAA,QACA,SAAS,EAAE,OAAO;AAAA,MACpB,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,147 @@
+import { z } from 'mppx';
+import * as viem from 'viem';
+
+declare const SBC_TOKEN: {
+    mainnet: "0x33ad9e4bd16b69b5bfded37d8b5d9ff9aba014fb";
+    testnet: "0x33ad9e4bd16b69b5bfded37d8b5d9ff9aba014fb";
+};
+declare const SBC_DECIMALS = 6;
+declare const radiusMainnet: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Radius Explorer";
+            readonly url: "https://network.radiustech.xyz";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 723487;
+    name: "Radius";
+    nativeCurrency: {
+        readonly name: "RUSD";
+        readonly symbol: "RUSD";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc.radiustech.xyz"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: viem.ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+};
+declare const radiusTestnet: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Radius Testnet Explorer";
+            readonly url: "https://testnet.radiustech.xyz";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 72344;
+    name: "Radius Testnet";
+    nativeCurrency: {
+        readonly name: "RUSD";
+        readonly symbol: "RUSD";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc.testnet.radiustech.xyz"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet: true;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: viem.ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+};
+/** Build an explorer URL for a transaction hash on a given chain. */
+declare function explorerTxUrl(chainId: number, txHash: string): string | null;
+
+/**
+ * @stablecoin.xyz/radius-mpp
+ *
+ * Shared method definition for Radius ERC-20 payments via MPP.
+ * Import from the root path in code that needs the schema but not
+ * client or server logic (e.g. shared types).
+ */
+
+/**
+ * Radius charge method — one-time ERC-20 token transfer on Radius.
+ *
+ * Request schema: the Challenge fields the server sends to the client.
+ * Credential payload: what the client returns after broadcasting the tx.
+ */
+declare const charge: {
+    readonly intent: "charge";
+    readonly name: "radius";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: z.ZodMiniObject<{
+                /** The on-chain transaction hash of the ERC-20 transfer */
+                txHash: z.ZodMiniString<string>;
+            }, z.core.$strip>;
+        };
+        readonly request: z.ZodMiniObject<{
+            /** Transfer amount in atomic units (e.g. "1000000" for 1 SBC with 6 decimals) */
+            amount: z.ZodMiniString<string>;
+            /** Token symbol or identifier (e.g. "SBC") */
+            currency: z.ZodMiniString<string>;
+            /** Chain ID (723487 for mainnet, 72344 for testnet) */
+            chainId: z.ZodMiniNumber<number>;
+            /** ERC-20 token contract address on Radius */
+            token: z.ZodMiniString<string>;
+            /** Recipient address (the seller / payee) */
+            recipient: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+    };
+};
+/** Re-export the inferred types for external consumers */
+type RadiusCharge = typeof charge;
+
+export { type RadiusCharge, SBC_DECIMALS, SBC_TOKEN, charge, explorerTxUrl, radiusMainnet, radiusTestnet };

package/dist/index.js

@@ -0,0 +1,17 @@
+import {
+  SBC_DECIMALS,
+  SBC_TOKEN,
+  charge,
+  explorerTxUrl,
+  radiusMainnet,
+  radiusTestnet
+} from "./chunk-TM4JSIP6.js";
+export {
+  SBC_DECIMALS,
+  SBC_TOKEN,
+  charge,
+  explorerTxUrl,
+  radiusMainnet,
+  radiusTestnet
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server.d.ts

@@ -0,0 +1,26 @@
+import { Method } from 'mppx';
+export { Expires, Mppx, Store } from 'mppx/server';
+import { RadiusCharge } from './index.js';
+import 'viem';
+
+/**
+ * @stablecoin.xyz/radius-mpp/server
+ *
+ * Server-side: verifies that an ERC-20 transfer actually landed on Radius
+ * with the correct amount, recipient, and token.
+ */
+
+interface RadiusServerConfig {
+    /**
+     * Optional custom RPC URL. If not provided, uses the default from chain config.
+     */
+    rpcUrl?: string;
+    /**
+     * Number of confirmations to require before accepting the tx.
+     * Defaults to 1 (Radius has fast finality).
+     */
+    confirmations?: number;
+}
+declare function radius(config?: RadiusServerConfig): Method.Server<RadiusCharge>;
+
+export { type RadiusServerConfig, radius };

package/dist/server.js

@@ -0,0 +1,104 @@
+import {
+  charge,
+  resolveChain
+} from "./chunk-TM4JSIP6.js";
+
+// src/server.ts
+import { Method, Receipt } from "mppx";
+import { Mppx, Expires, Store } from "mppx/server";
+import {
+  createPublicClient,
+  http,
+  decodeEventLog
+} from "viem";
+var TRANSFER_EVENT_ABI = [
+  {
+    type: "event",
+    name: "Transfer",
+    inputs: [
+      { indexed: true, name: "from", type: "address" },
+      { indexed: true, name: "to", type: "address" },
+      { indexed: false, name: "value", type: "uint256" }
+    ]
+  }
+];
+function radius(config = {}) {
+  const { confirmations = 1 } = config;
+  return Method.toServer(charge, {
+    async verify({ credential }) {
+      const { txHash } = credential.payload;
+      const { amount, chainId, token, recipient } = credential.challenge.request;
+      const chain = resolveChain(chainId);
+      if (!chain) {
+        throw new Error(`Unsupported Radius chain ID: ${chainId}`);
+      }
+      const rpcUrl = config.rpcUrl ?? chain.rpcUrls.default.http[0];
+      const publicClient = createPublicClient({
+        chain,
+        transport: http(rpcUrl)
+      });
+      const receipt = await publicClient.getTransactionReceipt({
+        hash: txHash
+      });
+      if (receipt.status !== "success") {
+        throw new Error(`Transaction ${txHash} failed on-chain (status: ${receipt.status})`);
+      }
+      const txToAddress = receipt.to?.toLowerCase();
+      if (txToAddress !== token.toLowerCase()) {
+        throw new Error(
+          `Transaction target ${txToAddress} does not match expected token ${token}`
+        );
+      }
+      const transferLog = findMatchingTransferLog(
+        receipt.logs,
+        token,
+        recipient,
+        BigInt(amount)
+      );
+      if (!transferLog) {
+        throw new Error(
+          `No matching ERC-20 Transfer event found for recipient ${recipient} with amount >= ${amount}`
+        );
+      }
+      if (confirmations > 1) {
+        await publicClient.waitForTransactionReceipt({
+          hash: txHash,
+          confirmations
+        });
+      }
+      return Receipt.from({
+        method: "radius",
+        reference: txHash,
+        status: "success",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+  });
+}
+function findMatchingTransferLog(logs, token, recipient, minAmount) {
+  for (const log of logs) {
+    if (log.address.toLowerCase() !== token.toLowerCase()) continue;
+    try {
+      const decoded = decodeEventLog({
+        abi: TRANSFER_EVENT_ABI,
+        data: log.data,
+        topics: log.topics
+      });
+      if (decoded.eventName !== "Transfer") continue;
+      const { to, value } = decoded.args;
+      if (to.toLowerCase() === recipient.toLowerCase() && value >= minAmount) {
+        return { from: decoded.args.from, to, value };
+      }
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+export {
+  Expires,
+  Mppx,
+  Store,
+  radius
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["/**\n * @stablecoin.xyz/radius-mpp/server\n *\n * Server-side: verifies that an ERC-20 transfer actually landed on Radius\n * with the correct amount, recipient, and token.\n */\n\nimport { Method, Receipt } from 'mppx'\nimport { Mppx, Expires, Store } from 'mppx/server'\nimport {\n  createPublicClient,\n  http,\n  decodeEventLog,\n  type Log,\n} from 'viem'\nimport { charge, type RadiusCharge } from './index.js'\nimport { resolveChain, SBC_DECIMALS } from './constants.js'\n\n// ---------------------------------------------------------------------------\n// ERC-20 Transfer event ABI (for log decoding)\n// ---------------------------------------------------------------------------\n\nconst TRANSFER_EVENT_ABI = [\n  {\n    type: 'event',\n    name: 'Transfer',\n    inputs: [\n      { indexed: true, name: 'from', type: 'address' },\n      { indexed: true, name: 'to', type: 'address' },\n      { indexed: false, name: 'value', type: 'uint256' },\n    ],\n  },\n] as const\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface RadiusServerConfig {\n  /**\n   * Optional custom RPC URL. If not provided, uses the default from chain config.\n   */\n  rpcUrl?: string\n\n  /**\n   * Number of confirmations to require before accepting the tx.\n   * Defaults to 1 (Radius has fast finality).\n   */\n  confirmations?: number\n}\n\n// ---------------------------------------------------------------------------\n// Server method factory\n// ---------------------------------------------------------------------------\n\nexport function radius(config: RadiusServerConfig = {}): Method.Server<RadiusCharge> {\n  const { confirmations = 1 } = config\n\n  return Method.toServer(charge, {\n    async verify({ credential }) {\n      const { txHash } = credential.payload\n      const { amount, chainId, token, recipient } = credential.challenge.request\n\n      // Resolve chain\n      const chain = resolveChain(chainId)\n      if (!chain) {\n        throw new Error(`Unsupported Radius chain ID: ${chainId}`)\n      }\n\n      const rpcUrl = config.rpcUrl ?? chain.rpcUrls.default.http[0]\n      const publicClient = createPublicClient({\n        chain,\n        transport: http(rpcUrl),\n      })\n\n      // Fetch the transaction receipt\n      const receipt = await publicClient.getTransactionReceipt({\n        hash: txHash as `0x${string}`,\n      })\n\n      // Check tx succeeded\n      if (receipt.status !== 'success') {\n        throw new Error(`Transaction ${txHash} failed on-chain (status: ${receipt.status})`)\n      }\n\n      // Check the tx was sent to the correct token contract\n      // TODO: Also verify receipt.from if we want to enforce payer identity\n      const txToAddress = receipt.to?.toLowerCase()\n      if (txToAddress !== token.toLowerCase()) {\n        throw new Error(\n          `Transaction target ${txToAddress} does not match expected token ${token}`\n        )\n      }\n\n      // Find the Transfer event log that matches recipient and amount\n      const transferLog = findMatchingTransferLog(\n        receipt.logs,\n        token,\n        recipient,\n        BigInt(amount),\n      )\n\n      if (!transferLog) {\n        throw new Error(\n          `No matching ERC-20 Transfer event found for recipient ${recipient} with amount >= ${amount}`\n        )\n      }\n\n      // Optionally wait for additional confirmations\n      if (confirmations > 1) {\n        await publicClient.waitForTransactionReceipt({\n          hash: txHash as `0x${string}`,\n          confirmations,\n        })\n      }\n\n      return Receipt.from({\n        method: 'radius',\n        reference: txHash,\n        status: 'success',\n        timestamp: new Date().toISOString(),\n      })\n    },\n  })\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction findMatchingTransferLog(\n  logs: Log[],\n  token: string,\n  recipient: string,\n  minAmount: bigint,\n) {\n  for (const log of logs) {\n    // Only look at logs from the correct token contract\n    if (log.address.toLowerCase() !== token.toLowerCase()) continue\n\n    try {\n      const decoded = decodeEventLog({\n        abi: TRANSFER_EVENT_ABI,\n        data: log.data,\n        topics: log.topics,\n      })\n\n      if (decoded.eventName !== 'Transfer') continue\n\n      const { to, value } = decoded.args\n      if (\n        to.toLowerCase() === recipient.toLowerCase() &&\n        value >= minAmount\n      ) {\n        return { from: decoded.args.from, to, value }\n      }\n    } catch {\n      // Not a Transfer event from this ABI, skip\n      continue\n    }\n  }\n\n  return null\n}\n\n// Re-export Mppx, Expires, Store so consumers only need one import\nexport { Mppx, Expires, Store }\n"],"mappings":";;;;;;AAOA,SAAS,QAAQ,eAAe;AAChC,SAAS,MAAM,SAAS,aAAa;AACrC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAQP,IAAM,qBAAqB;AAAA,EACzB;AAAA,IACE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,QAAQ;AAAA,MACN,EAAE,SAAS,MAAM,MAAM,QAAQ,MAAM,UAAU;AAAA,MAC/C,EAAE,SAAS,MAAM,MAAM,MAAM,MAAM,UAAU;AAAA,MAC7C,EAAE,SAAS,OAAO,MAAM,SAAS,MAAM,UAAU;AAAA,IACnD;AAAA,EACF;AACF;AAuBO,SAAS,OAAO,SAA6B,CAAC,GAAgC;AACnF,QAAM,EAAE,gBAAgB,EAAE,IAAI;AAE9B,SAAO,OAAO,SAAS,QAAQ;AAAA,IAC7B,MAAM,OAAO,EAAE,WAAW,GAAG;AAC3B,YAAM,EAAE,OAAO,IAAI,WAAW;AAC9B,YAAM,EAAE,QAAQ,SAAS,OAAO,UAAU,IAAI,WAAW,UAAU;AAGnE,YAAM,QAAQ,aAAa,OAAO;AAClC,UAAI,CAAC,OAAO;AACV,cAAM,IAAI,MAAM,gCAAgC,OAAO,EAAE;AAAA,MAC3D;AAEA,YAAM,SAAS,OAAO,UAAU,MAAM,QAAQ,QAAQ,KAAK,CAAC;AAC5D,YAAM,eAAe,mBAAmB;AAAA,QACtC;AAAA,QACA,WAAW,KAAK,MAAM;AAAA,MACxB,CAAC;AAGD,YAAM,UAAU,MAAM,aAAa,sBAAsB;AAAA,QACvD,MAAM;AAAA,MACR,CAAC;AAGD,UAAI,QAAQ,WAAW,WAAW;AAChC,cAAM,IAAI,MAAM,eAAe,MAAM,6BAA6B,QAAQ,MAAM,GAAG;AAAA,MACrF;AAIA,YAAM,cAAc,QAAQ,IAAI,YAAY;AAC5C,UAAI,gBAAgB,MAAM,YAAY,GAAG;AACvC,cAAM,IAAI;AAAA,UACR,sBAAsB,WAAW,kCAAkC,KAAK;AAAA,QAC1E;AAAA,MACF;AAGA,YAAM,cAAc;AAAA,QAClB,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,QACA,OAAO,MAAM;AAAA,MACf;AAEA,UAAI,CAAC,aAAa;AAChB,cAAM,IAAI;AAAA,UACR,yDAAyD,SAAS,mBAAmB,MAAM;AAAA,QAC7F;AAAA,MACF;AAGA,UAAI,gBAAgB,GAAG;AACrB,cAAM,aAAa,0BAA0B;AAAA,UAC3C,MAAM;AAAA,UACN;AAAA,QACF,CAAC;AAAA,MACH;AAEA,aAAO,QAAQ,KAAK;AAAA,QAClB,QAAQ;AAAA,QACR,WAAW;AAAA,QACX,QAAQ;AAAA,QACR,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MACpC,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AACH;AAMA,SAAS,wBACP,MACA,OACA,WACA,WACA;AACA,aAAW,OAAO,MAAM;AAEtB,QAAI,IAAI,QAAQ,YAAY,MAAM,MAAM,YAAY,EAAG;AAEvD,QAAI;AACF,YAAM,UAAU,eAAe;AAAA,QAC7B,KAAK;AAAA,QACL,MAAM,IAAI;AAAA,QACV,QAAQ,IAAI;AAAA,MACd,CAAC;AAED,UAAI,QAAQ,cAAc,WAAY;AAEtC,YAAM,EAAE,IAAI,MAAM,IAAI,QAAQ;AAC9B,UACE,GAAG,YAAY,MAAM,UAAU,YAAY,KAC3C,SAAS,WACT;AACA,eAAO,EAAE,MAAM,QAAQ,KAAK,MAAM,IAAI,MAAM;AAAA,MAC9C;AAAA,IACF,QAAQ;AAEN;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@stablecoin.xyz/radius-mpp",
+  "version": "0.1.0",
+  "description": "MPP custom payment method for Radius blockchain — ERC-20 token transfers",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "test:unit": "vitest run test/unit",
+    "test:integration": "vitest run test/integration",
+    "prepare": "cp scripts/pre-commit .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit"
+  },
+  "peerDependencies": {
+    "mppx": ">=0.4.0"
+  },
+  "dependencies": {
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.2",
+    "mppx": "^0.4.11",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^4.1.2",
+    "zod": "^4.3.6"
+  },
+  "license": "MIT"
+}

package/src/client.ts

@@ -0,0 +1,92 @@
+/**
+ * @stablecoin.xyz/radius-mpp/client
+ *
+ * Client-side: signs and broadcasts an ERC-20 transfer on Radius,
+ * then returns the txHash as the Credential payload.
+ */
+
+import { Credential, Method } from 'mppx'
+import { Mppx } from 'mppx/client'
+import {
+  createPublicClient,
+  createWalletClient,
+  http,
+  type Account,
+  type Chain,
+  type Transport,
+  type WalletClient,
+  encodeFunctionData,
+} from 'viem'
+import { charge, type RadiusCharge } from './index.js'
+import { ERC20_ABI, resolveChain } from './constants.js'
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface RadiusClientConfig {
+  /**
+   * A viem WalletClient that can sign and send transactions on Radius.
+   * Must have an account attached (e.g. via privateKeyToAccount or browser wallet).
+   */
+  walletClient: WalletClient<Transport, Chain, Account>
+}
+
+// ---------------------------------------------------------------------------
+// Client method factory
+// ---------------------------------------------------------------------------
+
+export function radius(config: RadiusClientConfig): Method.Client<RadiusCharge> {
+  const { walletClient } = config
+
+  return Method.toClient(charge, {
+    async createCredential({ challenge }) {
+      const { amount, chainId, token, recipient } = challenge.request
+
+      // Resolve the Radius chain definition for RPC access
+      const chain = resolveChain(chainId)
+      if (!chain) {
+        throw new Error(`Unsupported Radius chain ID: ${chainId}`)
+      }
+
+      // Build the ERC-20 transfer calldata
+      const data = encodeFunctionData({
+        abi: ERC20_ABI,
+        functionName: 'transfer',
+        args: [recipient as `0x${string}`, BigInt(amount)],
+      })
+
+      // Use the chain's RPC for gas estimation and receipt waiting
+      const publicClient = createPublicClient({
+        chain,
+        transport: http(chain.rpcUrls.default.http[0]),
+      })
+
+      // Estimate gas price (Radius doesn't support EIP-1559 fee estimation)
+      const gasPrice = await publicClient.getGasPrice()
+
+      // Send the transaction using the resolved chain's RPC
+      const txHash = await walletClient.sendTransaction({
+        to: token as `0x${string}`,
+        data,
+        chain,
+        gasPrice,
+      })
+
+      // TODO: Make confirmation count configurable (Radius has fast blocks,
+      // 1 confirmation should suffice but we may want to allow tuning)
+      await publicClient.waitForTransactionReceipt({
+        hash: txHash,
+        confirmations: 1,
+      })
+
+      return Credential.serialize({
+        challenge,
+        payload: { txHash },
+      })
+    },
+  })
+}
+
+// Re-export Mppx so consumers only need one import
+export { Mppx }

package/src/constants.ts

@@ -0,0 +1,87 @@
+import { defineChain } from 'viem'
+
+// ---------------------------------------------------------------------------
+// Token addresses (SBC stablecoin on Radius)
+// ---------------------------------------------------------------------------
+
+export const SBC_TOKEN = {
+  mainnet: '0x33ad9e4bd16b69b5bfded37d8b5d9ff9aba014fb' as const,
+  testnet: '0x33ad9e4bd16b69b5bfded37d8b5d9ff9aba014fb' as const,
+}
+
+export const SBC_DECIMALS = 6
+
+// ---------------------------------------------------------------------------
+// Chain definitions (viem-compatible)
+// ---------------------------------------------------------------------------
+
+export const radiusMainnet = defineChain({
+  id: 723487,
+  name: 'Radius',
+  nativeCurrency: { name: 'RUSD', symbol: 'RUSD', decimals: 18 },
+  rpcUrls: {
+    default: { http: ['https://rpc.radiustech.xyz'] },
+  },
+  blockExplorers: {
+    default: { name: 'Radius Explorer', url: 'https://network.radiustech.xyz' },
+  },
+})
+
+export const radiusTestnet = defineChain({
+  id: 72344,
+  name: 'Radius Testnet',
+  nativeCurrency: { name: 'RUSD', symbol: 'RUSD', decimals: 18 },
+  rpcUrls: {
+    default: { http: ['https://rpc.testnet.radiustech.xyz'] },
+  },
+  blockExplorers: {
+    default: { name: 'Radius Testnet Explorer', url: 'https://testnet.radiustech.xyz' },
+  },
+  testnet: true,
+})
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/** Resolve chain definition by chain ID. Returns mainnet for 723 (legacy alias). */
+export function resolveChain(chainId: number) {
+  if (chainId === radiusMainnet.id || chainId === 723) return radiusMainnet
+  if (chainId === radiusTestnet.id) return radiusTestnet
+  return null
+}
+
+/** Resolve the SBC token address for a given chain ID. */
+export function resolveTokenAddress(chainId: number) {
+  if (chainId === radiusMainnet.id || chainId === 723) return SBC_TOKEN.mainnet
+  if (chainId === radiusTestnet.id) return SBC_TOKEN.testnet
+  return null
+}
+
+/** Build an explorer URL for a transaction hash on a given chain. */
+export function explorerTxUrl(chainId: number, txHash: string): string | null {
+  const chain = resolveChain(chainId)
+  if (!chain?.blockExplorers?.default) return null
+  return `${chain.blockExplorers.default.url}/tx/${txHash}`
+}
+
+// Standard ERC-20 ABI subset used by client and server
+export const ERC20_ABI = [
+  {
+    inputs: [
+      { name: 'to', type: 'address' },
+      { name: 'amount', type: 'uint256' },
+    ],
+    name: 'transfer',
+    outputs: [{ name: '', type: 'bool' }],
+    stateMutability: 'nonpayable',
+    type: 'function',
+  },
+  {
+    inputs: [{ name: 'account', type: 'address' }],
+    name: 'balanceOf',
+    outputs: [{ name: '', type: 'uint256' }],
+    stateMutability: 'view',
+    type: 'function',
+  },
+] as const

package/src/index.ts

@@ -0,0 +1,45 @@
+/**
+ * @stablecoin.xyz/radius-mpp
+ *
+ * Shared method definition for Radius ERC-20 payments via MPP.
+ * Import from the root path in code that needs the schema but not
+ * client or server logic (e.g. shared types).
+ */
+
+import { Method, z } from 'mppx'
+
+export { radiusMainnet, radiusTestnet, SBC_TOKEN, SBC_DECIMALS, explorerTxUrl } from './constants.js'
+
+/**
+ * Radius charge method — one-time ERC-20 token transfer on Radius.
+ *
+ * Request schema: the Challenge fields the server sends to the client.
+ * Credential payload: what the client returns after broadcasting the tx.
+ */
+export const charge = Method.from({
+  intent: 'charge',
+  name: 'radius',
+  schema: {
+    credential: {
+      payload: z.object({
+        /** The on-chain transaction hash of the ERC-20 transfer */
+        txHash: z.string(),
+      }),
+    },
+    request: z.object({
+      /** Transfer amount in atomic units (e.g. "1000000" for 1 SBC with 6 decimals) */
+      amount: z.string(),
+      /** Token symbol or identifier (e.g. "SBC") */
+      currency: z.string(),
+      /** Chain ID (723487 for mainnet, 72344 for testnet) */
+      chainId: z.number(),
+      /** ERC-20 token contract address on Radius */
+      token: z.string(),
+      /** Recipient address (the seller / payee) */
+      recipient: z.string(),
+    }),
+  },
+})
+
+/** Re-export the inferred types for external consumers */
+export type RadiusCharge = typeof charge

package/src/server.ts

@@ -0,0 +1,167 @@
+/**
+ * @stablecoin.xyz/radius-mpp/server
+ *
+ * Server-side: verifies that an ERC-20 transfer actually landed on Radius
+ * with the correct amount, recipient, and token.
+ */
+
+import { Method, Receipt } from 'mppx'
+import { Mppx, Expires, Store } from 'mppx/server'
+import {
+  createPublicClient,
+  http,
+  decodeEventLog,
+  type Log,
+} from 'viem'
+import { charge, type RadiusCharge } from './index.js'
+import { resolveChain, SBC_DECIMALS } from './constants.js'
+
+// ---------------------------------------------------------------------------
+// ERC-20 Transfer event ABI (for log decoding)
+// ---------------------------------------------------------------------------
+
+const TRANSFER_EVENT_ABI = [
+  {
+    type: 'event',
+    name: 'Transfer',
+    inputs: [
+      { indexed: true, name: 'from', type: 'address' },
+      { indexed: true, name: 'to', type: 'address' },
+      { indexed: false, name: 'value', type: 'uint256' },
+    ],
+  },
+] as const
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface RadiusServerConfig {
+  /**
+   * Optional custom RPC URL. If not provided, uses the default from chain config.
+   */
+  rpcUrl?: string
+
+  /**
+   * Number of confirmations to require before accepting the tx.
+   * Defaults to 1 (Radius has fast finality).
+   */
+  confirmations?: number
+}
+
+// ---------------------------------------------------------------------------
+// Server method factory
+// ---------------------------------------------------------------------------
+
+export function radius(config: RadiusServerConfig = {}): Method.Server<RadiusCharge> {
+  const { confirmations = 1 } = config
+
+  return Method.toServer(charge, {
+    async verify({ credential }) {
+      const { txHash } = credential.payload
+      const { amount, chainId, token, recipient } = credential.challenge.request
+
+      // Resolve chain
+      const chain = resolveChain(chainId)
+      if (!chain) {
+        throw new Error(`Unsupported Radius chain ID: ${chainId}`)
+      }
+
+      const rpcUrl = config.rpcUrl ?? chain.rpcUrls.default.http[0]
+      const publicClient = createPublicClient({
+        chain,
+        transport: http(rpcUrl),
+      })
+
+      // Fetch the transaction receipt
+      const receipt = await publicClient.getTransactionReceipt({
+        hash: txHash as `0x${string}`,
+      })
+
+      // Check tx succeeded
+      if (receipt.status !== 'success') {
+        throw new Error(`Transaction ${txHash} failed on-chain (status: ${receipt.status})`)
+      }
+
+      // Check the tx was sent to the correct token contract
+      // TODO: Also verify receipt.from if we want to enforce payer identity
+      const txToAddress = receipt.to?.toLowerCase()
+      if (txToAddress !== token.toLowerCase()) {
+        throw new Error(
+          `Transaction target ${txToAddress} does not match expected token ${token}`
+        )
+      }
+
+      // Find the Transfer event log that matches recipient and amount
+      const transferLog = findMatchingTransferLog(
+        receipt.logs,
+        token,
+        recipient,
+        BigInt(amount),
+      )
+
+      if (!transferLog) {
+        throw new Error(
+          `No matching ERC-20 Transfer event found for recipient ${recipient} with amount >= ${amount}`
+        )
+      }
+
+      // Optionally wait for additional confirmations
+      if (confirmations > 1) {
+        await publicClient.waitForTransactionReceipt({
+          hash: txHash as `0x${string}`,
+          confirmations,
+        })
+      }
+
+      return Receipt.from({
+        method: 'radius',
+        reference: txHash,
+        status: 'success',
+        timestamp: new Date().toISOString(),
+      })
+    },
+  })
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function findMatchingTransferLog(
+  logs: Log[],
+  token: string,
+  recipient: string,
+  minAmount: bigint,
+) {
+  for (const log of logs) {
+    // Only look at logs from the correct token contract
+    if (log.address.toLowerCase() !== token.toLowerCase()) continue
+
+    try {
+      const decoded = decodeEventLog({
+        abi: TRANSFER_EVENT_ABI,
+        data: log.data,
+        topics: log.topics,
+      })
+
+      if (decoded.eventName !== 'Transfer') continue
+
+      const { to, value } = decoded.args
+      if (
+        to.toLowerCase() === recipient.toLowerCase() &&
+        value >= minAmount
+      ) {
+        return { from: decoded.args.from, to, value }
+      }
+    } catch {
+      // Not a Transfer event from this ABI, skip
+      continue
+    }
+  }
+
+  return null
+}
+
+// Re-export Mppx, Expires, Store so consumers only need one import
+export { Mppx, Expires, Store }