@heraldprotocol/mpp 0.0.1

package/dist/esm/chunk-XBFBAAXJ.js

@@ -0,0 +1,87 @@
+// src/defaults.ts
+var chainId = {
+  mainnet: 16661,
+  testnet: 16602
+};
+var USDC_E = "0x1f3aa82227281ca364bfb3d253b0f1af1da6473e";
+var currency = {
+  [chainId.mainnet]: USDC_E
+};
+var decimals = 6;
+var rpcUrl = {
+  [chainId.mainnet]: "https://evmrpc.0g.ai",
+  [chainId.testnet]: "https://evmrpc-testnet.0g.ai"
+};
+var erc3009Abi = [
+  {
+    type: "function",
+    name: "transferWithAuthorization",
+    inputs: [
+      { name: "from", type: "address" },
+      { name: "to", type: "address" },
+      { name: "value", type: "uint256" },
+      { name: "validAfter", type: "uint256" },
+      { name: "validBefore", type: "uint256" },
+      { name: "nonce", type: "bytes32" },
+      { name: "v", type: "uint8" },
+      { name: "r", type: "bytes32" },
+      { name: "s", type: "bytes32" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "receiveWithAuthorization",
+    inputs: [
+      { name: "from", type: "address" },
+      { name: "to", type: "address" },
+      { name: "value", type: "uint256" },
+      { name: "validAfter", type: "uint256" },
+      { name: "validBefore", type: "uint256" },
+      { name: "nonce", type: "bytes32" },
+      { name: "v", type: "uint8" },
+      { name: "r", type: "bytes32" },
+      { name: "s", type: "bytes32" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "name",
+    inputs: [],
+    outputs: [{ name: "", type: "string" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "version",
+    inputs: [],
+    outputs: [{ name: "", type: "string" }],
+    stateMutability: "view"
+  }
+];
+var erc3009Tokens = {
+  [USDC_E.toLowerCase()]: {
+    name: "Bridged USDC",
+    version: "2"
+  }
+};
+function resolveCurrency(parameters) {
+  const id = parameters.chainId ?? (parameters.testnet ? chainId.testnet : chainId.mainnet);
+  const resolved = currency[id];
+  if (!resolved)
+    throw new Error(`No default currency configured for chainId ${id}.`);
+  return resolved;
+}
+
+export {
+  chainId,
+  decimals,
+  rpcUrl,
+  erc3009Abi,
+  erc3009Tokens,
+  resolveCurrency
+};
+//# sourceMappingURL=chunk-XBFBAAXJ.js.map

package/dist/esm/chunk-XBFBAAXJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/defaults.ts"],"sourcesContent":["export const chainId = {\n  mainnet: 16661,\n  testnet: 16602,\n} as const;\n\nexport type ChainId = (typeof chainId)[keyof typeof chainId];\n\nconst USDC_E = \"0x1f3aa82227281ca364bfb3d253b0f1af1da6473e\";\n\n/** Chain ID → default currency. */\nexport const currency: Partial<Record<ChainId, string>> = {\n  [chainId.mainnet]: USDC_E,\n};\n\n/** Default token decimals for USDC.e. */\nexport const decimals = 6;\n\n/** Default RPC URLs per chain. */\nexport const rpcUrl: Record<number, string> = {\n  [chainId.mainnet]: \"https://evmrpc.0g.ai\",\n  [chainId.testnet]: \"https://evmrpc-testnet.0g.ai\",\n};\n\n/** ERC-3009 ABI (`transferWithAuthorization`, `receiveWithAuthorization`). */\nexport const erc3009Abi = [\n  {\n    type: \"function\",\n    name: \"transferWithAuthorization\",\n    inputs: [\n      { name: \"from\", type: \"address\" },\n      { name: \"to\", type: \"address\" },\n      { name: \"value\", type: \"uint256\" },\n      { name: \"validAfter\", type: \"uint256\" },\n      { name: \"validBefore\", type: \"uint256\" },\n      { name: \"nonce\", type: \"bytes32\" },\n      { name: \"v\", type: \"uint8\" },\n      { name: \"r\", type: \"bytes32\" },\n      { name: \"s\", type: \"bytes32\" },\n    ],\n    outputs: [],\n    stateMutability: \"nonpayable\",\n  },\n  {\n    type: \"function\",\n    name: \"receiveWithAuthorization\",\n    inputs: [\n      { name: \"from\", type: \"address\" },\n      { name: \"to\", type: \"address\" },\n      { name: \"value\", type: \"uint256\" },\n      { name: \"validAfter\", type: \"uint256\" },\n      { name: \"validBefore\", type: \"uint256\" },\n      { name: \"nonce\", type: \"bytes32\" },\n      { name: \"v\", type: \"uint8\" },\n      { name: \"r\", type: \"bytes32\" },\n      { name: \"s\", type: \"bytes32\" },\n    ],\n    outputs: [],\n    stateMutability: \"nonpayable\",\n  },\n  {\n    type: \"function\",\n    name: \"name\",\n    inputs: [],\n    outputs: [{ name: \"\", type: \"string\" }],\n    stateMutability: \"view\",\n  },\n  {\n    type: \"function\",\n    name: \"version\",\n    inputs: [],\n    outputs: [{ name: \"\", type: \"string\" }],\n    stateMutability: \"view\",\n  },\n] as const;\n\n/**\n * Known tokens that support ERC-3009 (TransferWithAuthorization).\n * Keyed by lowercase address for case-insensitive lookup.\n */\nexport const erc3009Tokens: Record<string, { name: string; version: string }> =\n  {\n    [USDC_E.toLowerCase()]: {\n      name: \"Bridged USDC\",\n      version: \"2\",\n    },\n  };\n\n/** Resolves the default currency for a given chain. */\nexport function resolveCurrency(parameters: {\n  chainId?: number | undefined;\n  testnet?: boolean | undefined;\n}): string {\n  const id =\n    parameters.chainId ??\n    (parameters.testnet ? chainId.testnet : chainId.mainnet);\n  const resolved = currency[id as ChainId];\n  if (!resolved)\n    throw new Error(`No default currency configured for chainId ${id}.`);\n  return resolved;\n}\n"],"mappings":";AAAO,IAAM,UAAU;AAAA,EACrB,SAAS;AAAA,EACT,SAAS;AACX;AAIA,IAAM,SAAS;AAGR,IAAM,WAA6C;AAAA,EACxD,CAAC,QAAQ,OAAO,GAAG;AACrB;AAGO,IAAM,WAAW;AAGjB,IAAM,SAAiC;AAAA,EAC5C,CAAC,QAAQ,OAAO,GAAG;AAAA,EACnB,CAAC,QAAQ,OAAO,GAAG;AACrB;AAGO,IAAM,aAAa;AAAA,EACxB;AAAA,IACE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,QAAQ;AAAA,MACN,EAAE,MAAM,QAAQ,MAAM,UAAU;AAAA,MAChC,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,MAC9B,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,MACjC,EAAE,MAAM,cAAc,MAAM,UAAU;AAAA,MACtC,EAAE,MAAM,eAAe,MAAM,UAAU;AAAA,MACvC,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,MACjC,EAAE,MAAM,KAAK,MAAM,QAAQ;AAAA,MAC3B,EAAE,MAAM,KAAK,MAAM,UAAU;AAAA,MAC7B,EAAE,MAAM,KAAK,MAAM,UAAU;AAAA,IAC/B;AAAA,IACA,SAAS,CAAC;AAAA,IACV,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,QAAQ;AAAA,MACN,EAAE,MAAM,QAAQ,MAAM,UAAU;AAAA,MAChC,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,MAC9B,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,MACjC,EAAE,MAAM,cAAc,MAAM,UAAU;AAAA,MACtC,EAAE,MAAM,eAAe,MAAM,UAAU;AAAA,MACvC,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,MACjC,EAAE,MAAM,KAAK,MAAM,QAAQ;AAAA,MAC3B,EAAE,MAAM,KAAK,MAAM,UAAU;AAAA,MAC7B,EAAE,MAAM,KAAK,MAAM,UAAU;AAAA,IAC/B;AAAA,IACA,SAAS,CAAC;AAAA,IACV,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,QAAQ,CAAC;AAAA,IACT,SAAS,CAAC,EAAE,MAAM,IAAI,MAAM,SAAS,CAAC;AAAA,IACtC,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,MAAM;AAAA,IACN,QAAQ,CAAC;AAAA,IACT,SAAS,CAAC,EAAE,MAAM,IAAI,MAAM,SAAS,CAAC;AAAA,IACtC,iBAAiB;AAAA,EACnB;AACF;AAMO,IAAM,gBACX;AAAA,EACE,CAAC,OAAO,YAAY,CAAC,GAAG;AAAA,IACtB,MAAM;AAAA,IACN,SAAS;AAAA,EACX;AACF;AAGK,SAAS,gBAAgB,YAGrB;AACT,QAAM,KACJ,WAAW,YACV,WAAW,UAAU,QAAQ,UAAU,QAAQ;AAClD,QAAM,WAAW,SAAS,EAAa;AACvC,MAAI,CAAC;AACH,UAAM,IAAI,MAAM,8CAA8C,EAAE,GAAG;AACrE,SAAO;AACT;","names":[]}

package/dist/esm/client.d.ts

@@ -0,0 +1,112 @@
+import { Account, Address, Client } from 'viem';
+import { Method, z } from 'mppx';
+import { M as MaybePromise } from './types-CKXzdGiJ.js';
+
+/**
+ * Creates a 0G charge method intent for usage on the client.
+ *
+ * @example
+ * ```ts
+ * import { zerog } from "@heraldprotocol/mpp/client";
+ * import { privateKeyToAccount } from "viem/accounts";
+ *
+ * const charge = zerog.charge({
+ *   account: privateKeyToAccount("0x..."),
+ * });
+ * ```
+ */
+declare function charge(parameters?: charge.Parameters): Method.Client<{
+    readonly name: "zerog";
+    readonly intent: "charge";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+                hash: z.ZodMiniString<string>;
+                type: z.ZodMiniLiteral<"hash">;
+            }, z.core.$strip>, z.ZodMiniObject<{
+                type: z.ZodMiniLiteral<"authorization">;
+                from: z.ZodMiniString<string>;
+                to: z.ZodMiniString<string>;
+                value: z.ZodMiniString<string>;
+                validAfter: z.ZodMiniString<string>;
+                validBefore: z.ZodMiniString<string>;
+                nonce: z.ZodMiniString<string>;
+                signature: z.ZodMiniString<string>;
+            }, z.core.$strip>], "type">;
+        };
+        readonly request: z.ZodMiniPipe<z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            chainId: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            externalId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            recipient: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.core.$strip>, z.ZodMiniTransform<{
+            methodDetails?: {
+                chainId: number;
+            } | undefined;
+            amount: string;
+            currency: string;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            recipient?: string | undefined;
+        }, {
+            amount: string;
+            currency: string;
+            decimals: number;
+            chainId?: number | undefined;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            recipient?: string | undefined;
+        }>>;
+    };
+}, z.ZodMiniObject<{
+    account: z.ZodMiniOptional<z.ZodMiniCustom<`0x${string}` | Account, `0x${string}` | Account>>;
+    mode: z.ZodMiniOptional<z.ZodMiniEnum<{
+        push: "push";
+        pull: "pull";
+    }>>;
+}, z.core.$strip>>;
+declare namespace charge {
+    type Parameters = {
+        /** Account to use for signing. */
+        account?: Account | Address | undefined;
+        /** Function that returns a viem Client for the given chain ID. */
+        getClient?: ((parameters: {
+            chainId?: number | undefined;
+        }) => MaybePromise<Client>) | undefined;
+        /**
+         * Controls how the charge transaction is submitted.
+         *
+         * - `'push'`: Client broadcasts the transaction and sends the tx hash.
+         * - `'pull'`: Client signs an ERC-3009 TransferWithAuthorization
+         *   message. Server calls `transferWithAuthorization` and pays gas.
+         *
+         * @default `'push'` for JSON-RPC accounts, `'pull'` for local accounts.
+         */
+        mode?: "push" | "pull" | undefined;
+    };
+}
+
+/**
+ * Creates a 0G `charge` client method.
+ *
+ * @example
+ * ```ts
+ * import { Mppx } from "mppx/client";
+ * import { zerog } from "@heraldprotocol/mpp/client";
+ *
+ * const mppx = Mppx.create({
+ *   methods: [zerog({ account })],
+ * });
+ * ```
+ */
+declare function zerog(parameters?: zerog.Parameters): readonly [Method.AnyClient];
+declare namespace zerog {
+    type Parameters = charge.Parameters;
+    /** Creates a 0G `charge` client method for one-time ERC-20 token transfers. */
+    const charge: typeof charge;
+}
+
+export { charge, zerog };

package/dist/esm/client.js

@@ -0,0 +1,150 @@
+import {
+  chainId,
+  erc3009Tokens,
+  rpcUrl
+} from "./chunk-XBFBAAXJ.js";
+import {
+  charge
+} from "./chunk-CRRGQQSN.js";
+
+// src/client/Charge.ts
+import { Credential, Method, z } from "mppx";
+import { encodeFunctionData, erc20Abi } from "viem";
+import { parseAccount } from "viem/accounts";
+import { sendTransactionSync, signTypedData } from "viem/actions";
+function charge2(parameters = {}) {
+  const resolveAccount = (client, override) => {
+    const raw = override ?? parameters.account;
+    if (raw) return typeof raw === "string" ? parseAccount(raw) : raw;
+    if (client.account) return client.account;
+    throw new Error(
+      "No `account` provided. Pass `account` to parameters or context."
+    );
+  };
+  const resolveClient = async (chainId2) => {
+    if (parameters.getClient) return parameters.getClient({ chainId: chainId2 });
+    const id = chainId2 ?? chainId.mainnet;
+    const url = rpcUrl[id];
+    if (!url) throw new Error(`No RPC URL configured for chainId ${id}.`);
+    const { createClient, http } = await import("viem");
+    return createClient({ chain: { id }, transport: http(url) });
+  };
+  return Method.toClient(charge, {
+    context: z.object({
+      account: z.optional(z.custom()),
+      mode: z.optional(z.enum(["push", "pull"]))
+    }),
+    async createCredential({ challenge, context }) {
+      const chainId2 = challenge.request.methodDetails?.chainId;
+      const client = await resolveClient(chainId2);
+      const account = resolveAccount(client, context?.account);
+      const mode = context?.mode ?? parameters.mode ?? (account.type === "json-rpc" ? "push" : "pull");
+      const { request } = challenge;
+      const amount = BigInt(request.amount);
+      const currency = request.currency;
+      const recipient = request.recipient;
+      if (mode === "pull") {
+        const tokenMeta = erc3009Tokens[currency.toLowerCase()];
+        if (!tokenMeta) {
+          throw new Error(
+            `Token ${currency} does not support ERC-3009 (TransferWithAuthorization). Cannot use pull mode.`
+          );
+        }
+        const resolvedChainId = chainId2 ?? client.chain?.id;
+        if (!resolvedChainId)
+          throw new Error("Could not determine chainId for EIP-712 domain.");
+        const { name: tokenName, version: tokenVersion } = tokenMeta;
+        const validAfter = 0n;
+        const validBefore = challenge.expires ? BigInt(Math.floor(new Date(challenge.expires).getTime() / 1e3)) : BigInt(Math.floor(Date.now() / 1e3) + 3600);
+        const nonce = randomNonce();
+        const signature = await signTypedData(client, {
+          account,
+          domain: {
+            name: tokenName,
+            version: tokenVersion,
+            chainId: resolvedChainId,
+            verifyingContract: currency
+          },
+          types: {
+            TransferWithAuthorization: [
+              { name: "from", type: "address" },
+              { name: "to", type: "address" },
+              { name: "value", type: "uint256" },
+              { name: "validAfter", type: "uint256" },
+              { name: "validBefore", type: "uint256" },
+              { name: "nonce", type: "bytes32" }
+            ]
+          },
+          primaryType: "TransferWithAuthorization",
+          message: {
+            from: account.address,
+            to: recipient,
+            value: amount,
+            validAfter,
+            validBefore,
+            nonce
+          }
+        });
+        return Credential.serialize({
+          challenge,
+          payload: {
+            type: "authorization",
+            from: account.address,
+            to: recipient,
+            value: amount.toString(),
+            validAfter: validAfter.toString(),
+            validBefore: validBefore.toString(),
+            nonce,
+            signature
+          },
+          source: `did:pkh:eip155:${resolvedChainId}:${account.address}`
+        });
+      }
+      if (mode === "push") {
+        const receipt = await sendTransactionSync(client, {
+          account,
+          chain: client.chain,
+          to: currency,
+          data: encodeFunctionData({
+            abi: erc20Abi,
+            functionName: "transfer",
+            args: [recipient, amount]
+          })
+        });
+        const hash = receipt.transactionHash;
+        return Credential.serialize({
+          challenge,
+          payload: { hash, type: "hash" },
+          source: `did:pkh:eip155:${chainId2 ?? client.chain?.id}:${account.address}`
+        });
+      }
+      throw new Error(`Unsupported mode: ${mode}`);
+    }
+  });
+}
+function randomNonce() {
+  const bytes = new Uint8Array(32);
+  if (typeof crypto !== "undefined") {
+    crypto.getRandomValues(bytes);
+  } else if (typeof globalThis !== "undefined" && "crypto" in globalThis) {
+    globalThis.crypto.getRandomValues(bytes);
+  } else {
+    for (let i = 0; i < bytes.length; i++) {
+      bytes[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  return `0x${[...bytes].map((b) => b.toString(16).padStart(2, "0")).join("")}`;
+}
+
+// src/client/Methods.ts
+function zerog(parameters = {}) {
+  return [charge2(parameters)];
+}
+((zerog2) => {
+  zerog2.charge = charge2;
+})(zerog || (zerog = {}));
+export {
+  charge2 as charge,
+  zerog
+};
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/Charge.ts","../../src/client/Methods.ts"],"sourcesContent":["import type { Account, Address, Chain, Client } from \"viem\";\nimport { Credential, Method, z } from \"mppx\";\nimport { encodeFunctionData, erc20Abi } from \"viem\";\nimport { parseAccount } from \"viem/accounts\";\nimport { sendTransactionSync, signTypedData } from \"viem/actions\";\n\nimport type { MaybePromise } from \"../types.js\";\nimport * as defaults from \"../defaults.js\";\nimport * as Methods from \"../Methods.js\";\n\n/**\n * Creates a 0G charge method intent for usage on the client.\n *\n * @example\n * ```ts\n * import { zerog } from \"@heraldprotocol/mpp/client\";\n * import { privateKeyToAccount } from \"viem/accounts\";\n *\n * const charge = zerog.charge({\n *   account: privateKeyToAccount(\"0x...\"),\n * });\n * ```\n */\nexport function charge(parameters: charge.Parameters = {}) {\n  const resolveAccount = (\n    client: Client,\n    override?: Account | Address | undefined\n  ): Account => {\n    const raw = override ?? parameters.account;\n    if (raw) return typeof raw === \"string\" ? parseAccount(raw) : raw;\n    if (client.account) return client.account;\n    throw new Error(\n      \"No `account` provided. Pass `account` to parameters or context.\"\n    );\n  };\n\n  const resolveClient = async (\n    chainId?: number | undefined\n  ): Promise<Client> => {\n    if (parameters.getClient) return parameters.getClient({ chainId });\n    const id = chainId ?? defaults.chainId.mainnet;\n    const url = defaults.rpcUrl[id];\n    if (!url) throw new Error(`No RPC URL configured for chainId ${id}.`);\n    const { createClient, http } = await import(\"viem\");\n    return createClient({ chain: { id } as Chain, transport: http(url) });\n  };\n\n  return Method.toClient(Methods.charge, {\n    context: z.object({\n      account: z.optional(z.custom<Account | Address>()),\n      mode: z.optional(z.enum([\"push\", \"pull\"])),\n    }),\n\n    async createCredential({ challenge, context }) {\n      const chainId = challenge.request.methodDetails?.chainId as\n        | number\n        | undefined;\n      const client = await resolveClient(chainId);\n      const account = resolveAccount(client, context?.account);\n\n      const mode =\n        context?.mode ??\n        parameters.mode ??\n        (account.type === \"json-rpc\" ? \"push\" : \"pull\");\n\n      const { request } = challenge;\n      const amount = BigInt(request.amount);\n      const currency = request.currency as Address;\n      const recipient = request.recipient as Address;\n\n      if (mode === \"pull\") {\n        const tokenMeta = defaults.erc3009Tokens[currency.toLowerCase()];\n        if (!tokenMeta) {\n          throw new Error(\n            `Token ${currency} does not support ERC-3009 (TransferWithAuthorization). ` +\n              `Cannot use pull mode.`\n          );\n        }\n\n        const resolvedChainId = chainId ?? client.chain?.id;\n        if (!resolvedChainId)\n          throw new Error(\"Could not determine chainId for EIP-712 domain.\");\n\n        const { name: tokenName, version: tokenVersion } = tokenMeta;\n\n        const validAfter = 0n;\n        const validBefore = challenge.expires\n          ? BigInt(Math.floor(new Date(challenge.expires).getTime() / 1000))\n          : BigInt(Math.floor(Date.now() / 1000) + 3600); // 1 hour default\n        const nonce = randomNonce();\n\n        const signature = await signTypedData(client, {\n          account,\n          domain: {\n            name: tokenName,\n            version: tokenVersion,\n            chainId: resolvedChainId,\n            verifyingContract: currency,\n          },\n          types: {\n            TransferWithAuthorization: [\n              { name: \"from\", type: \"address\" },\n              { name: \"to\", type: \"address\" },\n              { name: \"value\", type: \"uint256\" },\n              { name: \"validAfter\", type: \"uint256\" },\n              { name: \"validBefore\", type: \"uint256\" },\n              { name: \"nonce\", type: \"bytes32\" },\n            ],\n          },\n          primaryType: \"TransferWithAuthorization\",\n          message: {\n            from: account.address,\n            to: recipient,\n            value: amount,\n            validAfter,\n            validBefore,\n            nonce,\n          },\n        });\n\n        return Credential.serialize({\n          challenge,\n          payload: {\n            type: \"authorization\" as const,\n            from: account.address,\n            to: recipient,\n            value: amount.toString(),\n            validAfter: validAfter.toString(),\n            validBefore: validBefore.toString(),\n            nonce,\n            signature,\n          },\n          source: `did:pkh:eip155:${resolvedChainId}:${account.address}`,\n        });\n      }\n\n      if (mode === \"push\") {\n        const receipt = await sendTransactionSync(client, {\n          account,\n          chain: client.chain,\n          to: currency,\n          data: encodeFunctionData({\n            abi: erc20Abi,\n            functionName: \"transfer\",\n            args: [recipient, amount],\n          }),\n        });\n        const hash = receipt.transactionHash;\n        return Credential.serialize({\n          challenge,\n          payload: { hash, type: \"hash\" },\n          source: `did:pkh:eip155:${chainId ?? client.chain?.id}:${account.address}`,\n        });\n      }\n\n      throw new Error(`Unsupported mode: ${mode}`);\n    },\n  });\n}\n\nexport declare namespace charge {\n  type Parameters = {\n    /** Account to use for signing. */\n    account?: Account | Address | undefined;\n    /** Function that returns a viem Client for the given chain ID. */\n    getClient?:\n      | ((parameters: { chainId?: number | undefined }) => MaybePromise<Client>)\n      | undefined;\n    /**\n     * Controls how the charge transaction is submitted.\n     *\n     * - `'push'`: Client broadcasts the transaction and sends the tx hash.\n     * - `'pull'`: Client signs an ERC-3009 TransferWithAuthorization\n     *   message. Server calls `transferWithAuthorization` and pays gas.\n     *\n     * @default `'push'` for JSON-RPC accounts, `'pull'` for local accounts.\n     */\n    mode?: \"push\" | \"pull\" | undefined;\n  };\n}\n\n/** Generates a random 32-byte hex nonce. */\nfunction randomNonce(): `0x${string}` {\n  const bytes = new Uint8Array(32);\n  if (typeof crypto !== \"undefined\") {\n    crypto.getRandomValues(bytes);\n  } else if (typeof globalThis !== \"undefined\" && \"crypto\" in globalThis) {\n    (globalThis as unknown as { crypto: Crypto }).crypto.getRandomValues(bytes);\n  } else {\n    for (let i = 0; i < bytes.length; i++) {\n      bytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n  return `0x${[...bytes].map((b) => b.toString(16).padStart(2, \"0\")).join(\"\")}`;\n}\n","import type { Method } from \"mppx\";\n\nimport { charge as charge_ } from \"./Charge.js\";\n\n/**\n * Creates a 0G `charge` client method.\n *\n * @example\n * ```ts\n * import { Mppx } from \"mppx/client\";\n * import { zerog } from \"@heraldprotocol/mpp/client\";\n *\n * const mppx = Mppx.create({\n *   methods: [zerog({ account })],\n * });\n * ```\n */\nexport function zerog(\n  parameters: zerog.Parameters = {}\n): readonly [Method.AnyClient] {\n  return [charge_(parameters)] as const;\n}\n\nexport namespace zerog {\n  export type Parameters = charge_.Parameters;\n\n  /** Creates a 0G `charge` client method for one-time ERC-20 token transfers. */\n  export const charge = charge_;\n}\n"],"mappings":"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","names":["charge","chainId","charge","zerog"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'mppx';
+
+/**
+ * 0G charge intent for one-time ERC-20 token transfers.
+ */
+declare const charge: {
+    readonly name: "zerog";
+    readonly intent: "charge";
+    readonly schema: {
+        readonly credential: {
+            readonly payload: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+                hash: z.ZodMiniString<string>;
+                type: z.ZodMiniLiteral<"hash">;
+            }, z.core.$strip>, z.ZodMiniObject<{
+                type: z.ZodMiniLiteral<"authorization">;
+                from: z.ZodMiniString<string>;
+                to: z.ZodMiniString<string>;
+                value: z.ZodMiniString<string>;
+                validAfter: z.ZodMiniString<string>;
+                validBefore: z.ZodMiniString<string>;
+                nonce: z.ZodMiniString<string>;
+                signature: z.ZodMiniString<string>;
+            }, z.core.$strip>], "type">;
+        };
+        readonly request: z.ZodMiniPipe<z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            chainId: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            externalId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            recipient: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.core.$strip>, z.ZodMiniTransform<{
+            methodDetails?: {
+                chainId: number;
+            } | undefined;
+            amount: string;
+            currency: string;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            recipient?: string | undefined;
+        }, {
+            amount: string;
+            currency: string;
+            decimals: number;
+            chainId?: number | undefined;
+            description?: string | undefined;
+            externalId?: string | undefined;
+            recipient?: string | undefined;
+        }>>;
+    };
+};
+
+export { charge };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import {
+  charge
+} from "./chunk-CRRGQQSN.js";
+export {
+  charge
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/server.d.ts

@@ -0,0 +1,84 @@
+import { Client, Account, Address } from 'viem';
+import { Method, Store } from 'mppx';
+import { M as MaybePromise } from './types-CKXzdGiJ.js';
+
+/**
+ * Creates a 0G charge method intent for usage on the server.
+ *
+ * @example
+ * ```ts
+ * import { zerog } from "@heraldprotocol/mpp/server";
+ *
+ * const charge = zerog.charge({
+ *   recipient: "0x...",
+ *   currency: "0x...",
+ *   account: privateKeyToAccount("0x..."),
+ * });
+ * ```
+ */
+declare function charge(parameters?: charge.Parameters): Method.AnyServer;
+declare namespace charge {
+    type StoreItemMap = {
+        [key: `mppx:charge:${string}`]: number;
+    };
+    type Parameters = {
+        /** Default payment amount (human-readable, e.g. "1.50"). */
+        amount?: string | undefined;
+        /** ERC-20 token contract address. */
+        currency?: string | undefined;
+        /** Token decimals. @default 6 */
+        decimals?: number | undefined;
+        /** Human-readable description. */
+        description?: string | undefined;
+        /** External identifier to echo back in receipt. */
+        externalId?: string | undefined;
+        /** Recipient address for payments. */
+        recipient?: string | undefined;
+        /** Testnet mode. */
+        testnet?: boolean | undefined;
+        /**
+         * Whether to wait for the charge transaction to confirm on-chain.
+         * @default true
+         */
+        waitForConfirmation?: boolean | undefined;
+        /** Function that returns a viem Client for the given chain ID. */
+        getClient?: ((parameters: {
+            chainId?: number | undefined;
+        }) => MaybePromise<Client>) | undefined;
+        /**
+         * Server account used to broadcast `transferWithAuthorization` transactions.
+         * Required when accepting `authorization` payloads. The server pays gas
+         * from this account.
+         */
+        account?: Account | Address | undefined;
+        /**
+         * Store for transaction hash replay protection.
+         *
+         * Use a shared store in multi-instance deployments so consumed hashes are
+         * visible across all server instances.
+         */
+        store?: Store.Store | undefined;
+    };
+}
+
+/**
+ * Creates a 0G `charge` server method.
+ *
+ * @example
+ * ```ts
+ * import { Mppx } from "mppx/server";
+ * import { zerog } from "@heraldprotocol/mpp/server";
+ *
+ * const mppx = Mppx.create({
+ *   methods: [zerog({ recipient: "0x...", currency: "0x..." })],
+ * });
+ * ```
+ */
+declare function zerog(parameters?: zerog.Parameters): readonly [Method.AnyServer];
+declare namespace zerog {
+    type Parameters = charge.Parameters;
+    /** Creates a 0G `charge` method for one-time ERC-20 token transfers. */
+    const charge: typeof charge;
+}
+
+export { charge, zerog };