@tabai/sdk 0.2.0

package/dist/payments/monad.js

@@ -0,0 +1,306 @@
+/**
+ * The Monad payment strategy: approve the Asset, call `TabSettlement.settle`, and
+ * read the Settlement back off the receipt.
+ *
+ * The transaction is signed by the Agent's own key. Nothing is escrowed and no
+ * facilitator is asked: the Asset moves straight to the Service's Collection
+ * address and `TabBook` applies the Settlement in the same transaction, so the
+ * transaction hash is the whole proof of payment.
+ *
+ * ## The signer
+ *
+ * A structural `EthersV6Signer` rather than the `ethers` class, so a test double
+ * or any wallet that can sign a transaction satisfies it. An `ethers.Signer`
+ * satisfies it as is; the `Assert` below fails to compile if that ever stops
+ * being true.
+ */
+import { Interface, MaxUint256, getAddress, isAddress as isEthersAddress } from "ethers";
+import { causeOf, ok, wrap } from "../_shared/index.js";
+import { defaultLogger } from "../logger.js";
+import { chainError, upstreamError, validationError } from "../errors.js";
+import { ERC20_ABI, TAB_SETTLEMENT_ABI } from "./abi.js";
+import { assetKey, validateAssetRef, validateSettleRequest, } from "./strategy.js";
+export const MONAD_STRATEGY_ID = "monad";
+const erc20 = new Interface(ERC20_ABI);
+const tabSettlement = new Interface(TAB_SETTLEMENT_ABI);
+const settledTopic = tabSettlement.getEvent("Settled")?.topicHash.toLowerCase() ?? "";
+/** Reads one `Settled` log emitted by the surface, or null for any other log. */
+export function decodeSettled(log, surface) {
+    if (log.address.toLowerCase() !== surface.toLowerCase())
+        return null;
+    if ((log.topics[0] ?? "").toLowerCase() !== settledTopic)
+        return null;
+    const fragment = tabSettlement.getEvent("Settled");
+    if (fragment === null)
+        return null;
+    const decoded = tabSettlement.decodeEventLog(fragment, log.data, [...log.topics]);
+    return {
+        settlementId: String(decoded.settlementId).toLowerCase(),
+        agent: getAddress(String(decoded.agent)),
+        serviceId: String(decoded.serviceId).toLowerCase(),
+        applied: BigInt(decoded.applied),
+        toPrepaid: BigInt(decoded.toPrepaid),
+    };
+}
+export function createMonadStrategy(config) {
+    const logger = config.logger ?? defaultLogger;
+    const id = config.id ?? MONAD_STRATEGY_ID;
+    const now = config.now ?? (() => Date.now());
+    const approval = config.approval ?? "exact";
+    const allowanceCheck = config.allowanceCheck ?? "read";
+    const receiptMode = config.receipt ?? "wait";
+    const assets = indexAssets(config.assets, id, logger);
+    const chainIds = [...new Set([...assets.values()].map((asset) => asset.chainId))].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+    const known = (asset) => assets.get(assetKey(asset));
+    const requireKnown = (asset) => {
+        const shape = validateAssetRef(asset, "request.asset");
+        if (!shape.ok)
+            return shape;
+        const found = known(shape.value);
+        if (found === undefined) {
+            return validationError("ASSET_NOT_CONFIGURED", `strategy \`${id}\` is not configured for asset ${assetKey(shape.value)}`, {
+                details: { asset: assetKey(shape.value), configured: [...assets.keys()].join(", ") },
+            });
+        }
+        if (found.decimals !== shape.value.decimals) {
+            return validationError("ASSET_DECIMALS_MISMATCH", `asset ${assetKey(found)} is configured with ${found.decimals} decimals and the request names ${shape.value.decimals}; amounts are base units and the two must agree`, { details: { asset: assetKey(found), configured: found.decimals, requested: shape.value.decimals } });
+        }
+        return ok(found);
+    };
+    const requireSurface = () => {
+        const address = config.tabSettlement;
+        if (typeof address !== "string" || !isEthersAddress(address)) {
+            return validationError("SETTLEMENT_CONTRACT_INVALID", `strategy \`${id}\` was given \`${String(address)}\` as its tabSettlement, which is not an address`);
+        }
+        return ok(getAddress(address));
+    };
+    const payer = async () => wrap(async () => getAddress(await config.signer.getAddress()), (error) => ({
+        category: "UPSTREAM",
+        code: "SIGNER_ADDRESS_UNAVAILABLE",
+        message: `strategy \`${id}\` could not read the payer address from its signer`,
+        retryable: true,
+        cause: causeOf(error),
+    }));
+    const send = async (to, data, what) => {
+        const response = await wrap(async () => config.signer.sendTransaction({ to, data }), (error) => ({
+            category: "CHAIN",
+            code: "SETTLEMENT_SUBMISSION_FAILED",
+            message: `strategy \`${id}\` could not submit ${what}`,
+            retryable: true,
+            details: { to },
+            cause: causeOf(error),
+        }));
+        if (!response.ok)
+            return response;
+        const hash = response.value.hash;
+        if (typeof hash !== "string" || !hash.startsWith("0x")) {
+            return chainError("SETTLEMENT_HASH_MISSING", `strategy \`${id}\` submitted ${what} but the signer returned no transaction hash`);
+        }
+        return ok(response.value);
+    };
+    /** Waits for the receipt and returns every `Settled` log the surface emitted in it. */
+    const settledLogs = async (response, surface) => {
+        if (receiptMode === "skip" || typeof response.wait !== "function")
+            return ok(null);
+        const receipt = await wrap(async () => response.wait?.() ?? null, (error) => ({
+            category: "CHAIN",
+            code: "SETTLEMENT_RECEIPT_UNAVAILABLE",
+            message: `strategy \`${id}\` submitted ${response.hash} but could not read its receipt`,
+            retryable: true,
+            details: { txHash: response.hash },
+            cause: causeOf(error),
+        }));
+        if (!receipt.ok)
+            return receipt;
+        if (receipt.value === null)
+            return ok(null);
+        if (receipt.value.status === 0) {
+            return chainError("SETTLEMENT_REVERTED", `settlement ${response.hash} was mined and reverted`, {
+                details: { txHash: response.hash },
+            });
+        }
+        const logs = [];
+        for (const log of receipt.value.logs) {
+            const settled = decodeSettled(log, surface);
+            if (settled !== null)
+                logs.push(settled);
+        }
+        return ok(logs);
+    };
+    const ensureAllowance = async (asset, owner, spender, needed) => {
+        if (allowanceCheck === "skip")
+            return ok(undefined);
+        const provider = config.signer.provider;
+        if (provider === undefined || provider === null) {
+            return upstreamError("PROVIDER_REQUIRED", `strategy \`${id}\` needs a connected signer to read the allowance before settling; connect one or set allowanceCheck to "skip"`);
+        }
+        const current = await wrap(async () => {
+            const raw = await provider.call({ to: asset.address, data: erc20.encodeFunctionData("allowance", [owner, spender]) });
+            return erc20.decodeFunctionResult("allowance", raw)[0];
+        }, (error) => ({
+            category: "UPSTREAM",
+            code: "ALLOWANCE_READ_FAILED",
+            message: `strategy \`${id}\` could not read the allowance of ${owner} for ${spender} on ${assetKey(asset)}`,
+            retryable: true,
+            cause: causeOf(error),
+        }));
+        if (!current.ok)
+            return current;
+        if (current.value >= needed)
+            return ok(undefined);
+        const amount = approval === "unlimited" ? MaxUint256 : needed;
+        const approved = await send(asset.address, erc20.encodeFunctionData("approve", [spender, amount]), `the allowance top-up for ${spender} on ${assetKey(asset)}`);
+        if (!approved.ok)
+            return approved;
+        // The approval has to land before the settlement is sent, or the settle reverts
+        // on allowance. Waiting here costs one block and saves a wasted transaction.
+        if (typeof approved.value.wait === "function") {
+            const landed = await wrap(async () => approved.value.wait?.() ?? null, (error) => ({
+                category: "CHAIN",
+                code: "APPROVAL_RECEIPT_UNAVAILABLE",
+                message: `strategy \`${id}\` could not confirm the allowance top-up ${approved.value.hash}`,
+                retryable: true,
+                cause: causeOf(error),
+            }));
+            if (!landed.ok)
+                return landed;
+        }
+        logger.debug("allowance topped up", { strategyId: id, asset: assetKey(asset), spender, amount: amount.toString(10), txHash: approved.value.hash });
+        return ok(undefined);
+    };
+    const receiptFor = (request, asset, payerAddress, txHash, settled, batchIndex) => ({
+        strategyId: id,
+        chainId: asset.chainId,
+        txHash,
+        asset,
+        amount: request.amount,
+        payer: payerAddress,
+        serviceId: request.serviceId,
+        settlementId: settled?.settlementId ?? null,
+        applied: settled?.applied ?? null,
+        toPrepaid: settled?.toPrepaid ?? null,
+        submittedAt: now(),
+        ...(batchIndex === undefined ? {} : { batchIndex }),
+    });
+    const strategy = {
+        id,
+        chainIds,
+        supports(asset) {
+            return known(asset) !== undefined;
+        },
+        async quote(request) {
+            const asset = requireKnown(request.asset);
+            if (!asset.ok)
+                return asset;
+            if (typeof request.amount !== "bigint") {
+                return validationError("CHARGE_INVALID", "request.amount must be a bigint count of Asset base units, never a number");
+            }
+            if (request.amount <= 0n) {
+                return validationError("AMOUNT_NOT_POSITIVE", "request.amount must be greater than zero base units");
+            }
+            return ok({
+                amount: request.amount,
+                asset: asset.value,
+                feeNote: "A stablecoin settles one-for-one in base units: the amount charged is the amount transferred, with no rate and no protocol fee. Gas is paid separately in MON and is never deducted from the Settlement amount.",
+            });
+        },
+        async settle(request) {
+            const validated = validateSettleRequest(request);
+            if (!validated.ok)
+                return validated;
+            const asset = requireKnown(request.asset);
+            if (!asset.ok)
+                return asset;
+            const surface = requireSurface();
+            if (!surface.ok)
+                return surface;
+            const from = await payer();
+            if (!from.ok)
+                return from;
+            const allowance = await ensureAllowance(asset.value, from.value, surface.value, request.amount);
+            if (!allowance.ok)
+                return allowance;
+            const sent = await send(surface.value, tabSettlement.encodeFunctionData("settle", [request.serviceId, asset.value.address, request.amount]), `a settlement of ${request.amount.toString(10)} ${asset.value.symbol} base units`);
+            if (!sent.ok)
+                return sent;
+            const logs = await settledLogs(sent.value, surface.value);
+            if (!logs.ok)
+                return logs;
+            return ok(receiptFor(request, asset.value, from.value, sent.value.hash, logs.value?.[0] ?? null));
+        },
+        async settleBatch(requests) {
+            if (requests.length === 0) {
+                return validationError("EMPTY_BATCH", "settleBatch was given no settlements");
+            }
+            const validatedAssets = [];
+            for (const request of requests) {
+                const validated = validateSettleRequest(request);
+                if (!validated.ok)
+                    return validated;
+                const asset = requireKnown(request.asset);
+                if (!asset.ok)
+                    return asset;
+                validatedAssets.push(asset.value);
+            }
+            const first = validatedAssets[0];
+            if (first === undefined) {
+                return validationError("EMPTY_BATCH", "settleBatch was given no settlements");
+            }
+            for (const [index, asset] of validatedAssets.entries()) {
+                if (asset.chainId !== first.chainId) {
+                    return validationError("BATCH_CHAIN_MIXED", `settleBatch entry ${index} settles on chain ${asset.chainId.toString(10)} and entry 0 on ${first.chainId.toString(10)}; one transaction settles on one chain`, { details: { index } });
+                }
+            }
+            const surface = requireSurface();
+            if (!surface.ok)
+                return surface;
+            const from = await payer();
+            if (!from.ok)
+                return from;
+            const owed = new Map();
+            for (const [index, asset] of validatedAssets.entries()) {
+                const request = requests[index];
+                if (request === undefined)
+                    continue;
+                const key = assetKey(asset);
+                const running = owed.get(key);
+                owed.set(key, { asset, total: (running?.total ?? 0n) + request.amount });
+            }
+            for (const { asset, total } of owed.values()) {
+                const allowance = await ensureAllowance(asset, from.value, surface.value, total);
+                if (!allowance.ok)
+                    return allowance;
+            }
+            const instructions = requests.map((request, index) => [
+                request.serviceId,
+                (validatedAssets[index] ?? request.asset).address,
+                request.amount,
+            ]);
+            const sent = await send(surface.value, tabSettlement.encodeFunctionData("settleBatch", [instructions]), `a batch of ${requests.length} settlements`);
+            if (!sent.ok)
+                return sent;
+            const logs = await settledLogs(sent.value, surface.value);
+            if (!logs.ok)
+                return logs;
+            return ok(requests.map((request, index) => receiptFor(request, validatedAssets[index] ?? request.asset, from.value, sent.value.hash, logs.value?.[index] ?? null, index)));
+        },
+    };
+    return strategy;
+}
+export function indexAssets(assets, id, logger) {
+    const indexed = new Map();
+    for (const [declaredKey, value] of Object.entries(assets)) {
+        const validated = validateAssetRef(value, `assets["${declaredKey}"]`);
+        if (!validated.ok) {
+            logger.error("payment strategy asset entry ignored", { strategyId: id, key: declaredKey, message: validated.error.message });
+            continue;
+        }
+        const derived = assetKey(validated.value);
+        if (declaredKey.toLowerCase() !== derived) {
+            logger.warn("payment strategy asset key disagrees with its value and the value wins", { strategyId: id, declaredKey, derivedKey: derived });
+        }
+        indexed.set(derived, validated.value);
+    }
+    return indexed;
+}
+//# sourceMappingURL=monad.js.map

package/dist/payments/monad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monad.js","sourceRoot":"","sources":["../../src/payments/monad.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The Monad payment strategy: approve the Asset, call `TabSettlement.settle`, and\n * read the Settlement back off the receipt.\n *\n * The transaction is signed by the Agent's own key. Nothing is escrowed and no\n * facilitator is asked: the Asset moves straight to the Service's Collection\n * address and `TabBook` applies the Settlement in the same transaction, so the\n * transaction hash is the whole proof of payment.\n *\n * ## The signer\n *\n * A structural `EthersV6Signer` rather than the `ethers` class, so a test double\n * or any wallet that can sign a transaction satisfies it. An `ethers.Signer`\n * satisfies it as is; the `Assert` below fails to compile if that ever stops\n * being true.\n */\nimport { Interface, MaxUint256, getAddress, isAddress as isEthersAddress } from \"ethers\";\nimport type { Signer } from \"ethers\";\nimport { causeOf, ok, wrap, type Address, type Bytes32, type Hex, type Result } from \"../_shared/index.js\";\nimport { defaultLogger, type Logger } from \"../logger.js\";\nimport { chainError, upstreamError, validationError } from \"../errors.js\";\nimport { ERC20_ABI, TAB_SETTLEMENT_ABI } from \"./abi.js\";\nimport {\n  assetKey,\n  validateAssetRef,\n  validateSettleRequest,\n  type AssetRef,\n  type ChargeQuote,\n  type ChargeRequest,\n  type PaymentStrategy,\n  type SettleRequest,\n  type SettlementReceipt,\n} from \"./strategy.js\";\n\nexport const MONAD_STRATEGY_ID = \"monad\";\n\nexport interface EthersV6TransactionRequest {\n  readonly to: string;\n  readonly data: string;\n  readonly value?: bigint;\n}\n\n/** One log as the receipt carries it. */\nexport interface EthersV6Log {\n  readonly address: string;\n  readonly topics: readonly string[];\n  readonly data: string;\n}\n\nexport interface EthersV6TransactionReceipt {\n  readonly hash: string;\n  readonly status: number | null;\n  readonly logs: readonly EthersV6Log[];\n}\n\nexport interface EthersV6TransactionResponse {\n  readonly hash: string;\n  wait?(confirmations?: number): Promise<EthersV6TransactionReceipt | null>;\n}\n\nexport interface EthersV6CallProvider {\n  call(transaction: { readonly to: string; readonly data: string }): Promise<string>;\n}\n\nexport interface EthersV6Signer {\n  getAddress(): Promise<string>;\n  sendTransaction(transaction: EthersV6TransactionRequest): Promise<EthersV6TransactionResponse>;\n  readonly provider?: EthersV6CallProvider | null;\n}\n\ntype Assert<T extends true> = T;\ntype SignerIsAccepted = Assert<Signer extends EthersV6Signer ? true : false>;\nexport type EthersV6SignerAcceptsEthersSigner = SignerIsAccepted;\n\nexport interface MonadStrategyConfig {\n  readonly signer: EthersV6Signer;\n  /** The deployed `TabSettlement`. */\n  readonly tabSettlement: Address;\n  /** The Assets this strategy will settle in, keyed by `<chainId>:<address>`. */\n  readonly assets: Readonly<Record<string, AssetRef>>;\n  readonly id?: string;\n  /** `exact` approves each amount; `unlimited` approves once. Default `exact`. */\n  readonly approval?: \"exact\" | \"unlimited\";\n  /** `skip` sends without reading the allowance first, for a signer with no provider. */\n  readonly allowanceCheck?: \"read\" | \"skip\";\n  /** Whether to wait for the receipt and decode the Settlement from it. Default `wait`. */\n  readonly receipt?: \"wait\" | \"skip\";\n  readonly logger?: Logger;\n  readonly now?: () => number;\n}\n\nconst erc20 = new Interface(ERC20_ABI);\nconst tabSettlement = new Interface(TAB_SETTLEMENT_ABI);\nconst settledTopic = tabSettlement.getEvent(\"Settled\")?.topicHash.toLowerCase() ?? \"\";\n\n/** What one `Settled` log says. */\nexport interface SettledLog {\n  readonly settlementId: Bytes32;\n  readonly agent: Address;\n  readonly serviceId: Bytes32;\n  readonly applied: bigint;\n  readonly toPrepaid: bigint;\n}\n\n/** Reads one `Settled` log emitted by the surface, or null for any other log. */\nexport function decodeSettled(log: EthersV6Log, surface: Address): SettledLog | null {\n  if (log.address.toLowerCase() !== surface.toLowerCase()) return null;\n  if ((log.topics[0] ?? \"\").toLowerCase() !== settledTopic) return null;\n  const fragment = tabSettlement.getEvent(\"Settled\");\n  if (fragment === null) return null;\n  const decoded = tabSettlement.decodeEventLog(fragment, log.data, [...log.topics]);\n  return {\n    settlementId: String(decoded.settlementId).toLowerCase() as Bytes32,\n    agent: getAddress(String(decoded.agent)) as Address,\n    serviceId: String(decoded.serviceId).toLowerCase() as Bytes32,\n    applied: BigInt(decoded.applied as bigint),\n    toPrepaid: BigInt(decoded.toPrepaid as bigint),\n  };\n}\n\nexport function createMonadStrategy(config: MonadStrategyConfig): PaymentStrategy {\n  const logger = config.logger ?? defaultLogger;\n  const id = config.id ?? MONAD_STRATEGY_ID;\n  const now = config.now ?? (() => Date.now());\n  const approval = config.approval ?? \"exact\";\n  const allowanceCheck = config.allowanceCheck ?? \"read\";\n  const receiptMode = config.receipt ?? \"wait\";\n  const assets = indexAssets(config.assets, id, logger);\n  const chainIds = [...new Set([...assets.values()].map((asset) => asset.chainId))].sort((left, right) =>\n    left < right ? -1 : left > right ? 1 : 0,\n  );\n\n  const known = (asset: AssetRef): AssetRef | undefined => assets.get(assetKey(asset));\n\n  const requireKnown = (asset: AssetRef): Result<AssetRef> => {\n    const shape = validateAssetRef(asset, \"request.asset\");\n    if (!shape.ok) return shape;\n    const found = known(shape.value);\n    if (found === undefined) {\n      return validationError(\"ASSET_NOT_CONFIGURED\", `strategy \\`${id}\\` is not configured for asset ${assetKey(shape.value)}`, {\n        details: { asset: assetKey(shape.value), configured: [...assets.keys()].join(\", \") },\n      });\n    }\n    if (found.decimals !== shape.value.decimals) {\n      return validationError(\n        \"ASSET_DECIMALS_MISMATCH\",\n        `asset ${assetKey(found)} is configured with ${found.decimals} decimals and the request names ${shape.value.decimals}; amounts are base units and the two must agree`,\n        { details: { asset: assetKey(found), configured: found.decimals, requested: shape.value.decimals } },\n      );\n    }\n    return ok(found);\n  };\n\n  const requireSurface = (): Result<Address> => {\n    const address = config.tabSettlement;\n    if (typeof address !== \"string\" || !isEthersAddress(address)) {\n      return validationError(\n        \"SETTLEMENT_CONTRACT_INVALID\",\n        `strategy \\`${id}\\` was given \\`${String(address)}\\` as its tabSettlement, which is not an address`,\n      );\n    }\n    return ok(getAddress(address) as Address);\n  };\n\n  const payer = async (): Promise<Result<Address>> =>\n    wrap(\n      async () => getAddress(await config.signer.getAddress()) as Address,\n      (error) => ({\n        category: \"UPSTREAM\",\n        code: \"SIGNER_ADDRESS_UNAVAILABLE\",\n        message: `strategy \\`${id}\\` could not read the payer address from its signer`,\n        retryable: true,\n        cause: causeOf(error),\n      }),\n    );\n\n  const send = async (to: Address, data: string, what: string): Promise<Result<EthersV6TransactionResponse>> => {\n    const response = await wrap(\n      async () => config.signer.sendTransaction({ to, data }),\n      (error) => ({\n        category: \"CHAIN\",\n        code: \"SETTLEMENT_SUBMISSION_FAILED\",\n        message: `strategy \\`${id}\\` could not submit ${what}`,\n        retryable: true,\n        details: { to },\n        cause: causeOf(error),\n      }),\n    );\n    if (!response.ok) return response;\n    const hash = response.value.hash;\n    if (typeof hash !== \"string\" || !hash.startsWith(\"0x\")) {\n      return chainError(\"SETTLEMENT_HASH_MISSING\", `strategy \\`${id}\\` submitted ${what} but the signer returned no transaction hash`);\n    }\n    return ok(response.value);\n  };\n\n  /** Waits for the receipt and returns every `Settled` log the surface emitted in it. */\n  const settledLogs = async (\n    response: EthersV6TransactionResponse,\n    surface: Address,\n  ): Promise<Result<readonly SettledLog[] | null>> => {\n    if (receiptMode === \"skip\" || typeof response.wait !== \"function\") return ok(null);\n    const receipt = await wrap(\n      async () => response.wait?.() ?? null,\n      (error) => ({\n        category: \"CHAIN\",\n        code: \"SETTLEMENT_RECEIPT_UNAVAILABLE\",\n        message: `strategy \\`${id}\\` submitted ${response.hash} but could not read its receipt`,\n        retryable: true,\n        details: { txHash: response.hash },\n        cause: causeOf(error),\n      }),\n    );\n    if (!receipt.ok) return receipt;\n    if (receipt.value === null) return ok(null);\n    if (receipt.value.status === 0) {\n      return chainError(\"SETTLEMENT_REVERTED\", `settlement ${response.hash} was mined and reverted`, {\n        details: { txHash: response.hash },\n      });\n    }\n    const logs: SettledLog[] = [];\n    for (const log of receipt.value.logs) {\n      const settled = decodeSettled(log, surface);\n      if (settled !== null) logs.push(settled);\n    }\n    return ok(logs);\n  };\n\n  const ensureAllowance = async (asset: AssetRef, owner: Address, spender: Address, needed: bigint): Promise<Result<void>> => {\n    if (allowanceCheck === \"skip\") return ok(undefined);\n    const provider = config.signer.provider;\n    if (provider === undefined || provider === null) {\n      return upstreamError(\n        \"PROVIDER_REQUIRED\",\n        `strategy \\`${id}\\` needs a connected signer to read the allowance before settling; connect one or set allowanceCheck to \"skip\"`,\n      );\n    }\n    const current = await wrap(\n      async () => {\n        const raw = await provider.call({ to: asset.address, data: erc20.encodeFunctionData(\"allowance\", [owner, spender]) });\n        return erc20.decodeFunctionResult(\"allowance\", raw)[0] as bigint;\n      },\n      (error) => ({\n        category: \"UPSTREAM\",\n        code: \"ALLOWANCE_READ_FAILED\",\n        message: `strategy \\`${id}\\` could not read the allowance of ${owner} for ${spender} on ${assetKey(asset)}`,\n        retryable: true,\n        cause: causeOf(error),\n      }),\n    );\n    if (!current.ok) return current;\n    if (current.value >= needed) return ok(undefined);\n    const amount = approval === \"unlimited\" ? MaxUint256 : needed;\n    const approved = await send(\n      asset.address,\n      erc20.encodeFunctionData(\"approve\", [spender, amount]),\n      `the allowance top-up for ${spender} on ${assetKey(asset)}`,\n    );\n    if (!approved.ok) return approved;\n    // The approval has to land before the settlement is sent, or the settle reverts\n    // on allowance. Waiting here costs one block and saves a wasted transaction.\n    if (typeof approved.value.wait === \"function\") {\n      const landed = await wrap(\n        async () => approved.value.wait?.() ?? null,\n        (error) => ({\n          category: \"CHAIN\",\n          code: \"APPROVAL_RECEIPT_UNAVAILABLE\",\n          message: `strategy \\`${id}\\` could not confirm the allowance top-up ${approved.value.hash}`,\n          retryable: true,\n          cause: causeOf(error),\n        }),\n      );\n      if (!landed.ok) return landed;\n    }\n    logger.debug(\"allowance topped up\", { strategyId: id, asset: assetKey(asset), spender, amount: amount.toString(10), txHash: approved.value.hash });\n    return ok(undefined);\n  };\n\n  const receiptFor = (\n    request: SettleRequest,\n    asset: AssetRef,\n    payerAddress: Address,\n    txHash: Hex,\n    settled: SettledLog | null,\n    batchIndex?: number,\n  ): SettlementReceipt => ({\n    strategyId: id,\n    chainId: asset.chainId,\n    txHash,\n    asset,\n    amount: request.amount,\n    payer: payerAddress,\n    serviceId: request.serviceId,\n    settlementId: settled?.settlementId ?? null,\n    applied: settled?.applied ?? null,\n    toPrepaid: settled?.toPrepaid ?? null,\n    submittedAt: now(),\n    ...(batchIndex === undefined ? {} : { batchIndex }),\n  });\n\n  const strategy: PaymentStrategy = {\n    id,\n    chainIds,\n    supports(asset) {\n      return known(asset) !== undefined;\n    },\n    async quote(request: ChargeRequest): Promise<Result<ChargeQuote>> {\n      const asset = requireKnown(request.asset);\n      if (!asset.ok) return asset;\n      if (typeof request.amount !== \"bigint\") {\n        return validationError(\"CHARGE_INVALID\", \"request.amount must be a bigint count of Asset base units, never a number\");\n      }\n      if (request.amount <= 0n) {\n        return validationError(\"AMOUNT_NOT_POSITIVE\", \"request.amount must be greater than zero base units\");\n      }\n      return ok({\n        amount: request.amount,\n        asset: asset.value,\n        feeNote:\n          \"A stablecoin settles one-for-one in base units: the amount charged is the amount transferred, with no rate and no protocol fee. Gas is paid separately in MON and is never deducted from the Settlement amount.\",\n      });\n    },\n    async settle(request: SettleRequest): Promise<Result<SettlementReceipt>> {\n      const validated = validateSettleRequest(request);\n      if (!validated.ok) return validated;\n      const asset = requireKnown(request.asset);\n      if (!asset.ok) return asset;\n      const surface = requireSurface();\n      if (!surface.ok) return surface;\n      const from = await payer();\n      if (!from.ok) return from;\n      const allowance = await ensureAllowance(asset.value, from.value, surface.value, request.amount);\n      if (!allowance.ok) return allowance;\n      const sent = await send(\n        surface.value,\n        tabSettlement.encodeFunctionData(\"settle\", [request.serviceId, asset.value.address, request.amount]),\n        `a settlement of ${request.amount.toString(10)} ${asset.value.symbol} base units`,\n      );\n      if (!sent.ok) return sent;\n      const logs = await settledLogs(sent.value, surface.value);\n      if (!logs.ok) return logs;\n      return ok(receiptFor(request, asset.value, from.value, sent.value.hash as Hex, logs.value?.[0] ?? null));\n    },\n    async settleBatch(requests: readonly SettleRequest[]): Promise<Result<readonly SettlementReceipt[]>> {\n      if (requests.length === 0) {\n        return validationError(\"EMPTY_BATCH\", \"settleBatch was given no settlements\");\n      }\n      const validatedAssets: AssetRef[] = [];\n      for (const request of requests) {\n        const validated = validateSettleRequest(request);\n        if (!validated.ok) return validated;\n        const asset = requireKnown(request.asset);\n        if (!asset.ok) return asset;\n        validatedAssets.push(asset.value);\n      }\n      const first = validatedAssets[0];\n      if (first === undefined) {\n        return validationError(\"EMPTY_BATCH\", \"settleBatch was given no settlements\");\n      }\n      for (const [index, asset] of validatedAssets.entries()) {\n        if (asset.chainId !== first.chainId) {\n          return validationError(\n            \"BATCH_CHAIN_MIXED\",\n            `settleBatch entry ${index} settles on chain ${asset.chainId.toString(10)} and entry 0 on ${first.chainId.toString(10)}; one transaction settles on one chain`,\n            { details: { index } },\n          );\n        }\n      }\n      const surface = requireSurface();\n      if (!surface.ok) return surface;\n      const from = await payer();\n      if (!from.ok) return from;\n      const owed = new Map<string, { asset: AssetRef; total: bigint }>();\n      for (const [index, asset] of validatedAssets.entries()) {\n        const request = requests[index];\n        if (request === undefined) continue;\n        const key = assetKey(asset);\n        const running = owed.get(key);\n        owed.set(key, { asset, total: (running?.total ?? 0n) + request.amount });\n      }\n      for (const { asset, total } of owed.values()) {\n        const allowance = await ensureAllowance(asset, from.value, surface.value, total);\n        if (!allowance.ok) return allowance;\n      }\n      const instructions = requests.map((request, index) => [\n        request.serviceId,\n        (validatedAssets[index] ?? request.asset).address,\n        request.amount,\n      ]);\n      const sent = await send(\n        surface.value,\n        tabSettlement.encodeFunctionData(\"settleBatch\", [instructions]),\n        `a batch of ${requests.length} settlements`,\n      );\n      if (!sent.ok) return sent;\n      const logs = await settledLogs(sent.value, surface.value);\n      if (!logs.ok) return logs;\n      return ok(\n        requests.map((request, index) =>\n          receiptFor(request, validatedAssets[index] ?? request.asset, from.value, sent.value.hash as Hex, logs.value?.[index] ?? null, index),\n        ),\n      );\n    },\n  };\n  return strategy;\n}\n\nexport function indexAssets(assets: Readonly<Record<string, AssetRef>>, id: string, logger: Logger): Map<string, AssetRef> {\n  const indexed = new Map<string, AssetRef>();\n  for (const [declaredKey, value] of Object.entries(assets)) {\n    const validated = validateAssetRef(value, `assets[\"${declaredKey}\"]`);\n    if (!validated.ok) {\n      logger.error(\"payment strategy asset entry ignored\", { strategyId: id, key: declaredKey, message: validated.error.message });\n      continue;\n    }\n    const derived = assetKey(validated.value);\n    if (declaredKey.toLowerCase() !== derived) {\n      logger.warn(\"payment strategy asset key disagrees with its value and the value wins\", { strategyId: id, declaredKey, derivedKey: derived });\n    }\n    indexed.set(derived, validated.value);\n  }\n  return indexed;\n}\n"]}

package/dist/payments/permit2.d.ts

@@ -0,0 +1,118 @@
+import { type Address, type Bytes32, type Hex, type Result } from "../_shared/index.js";
+import { type Logger } from "../logger.js";
+import { type EthersV6CallProvider, type EthersV6TransactionRequest, type EthersV6TransactionResponse } from "./monad.js";
+import { type AssetRef, type PaymentStrategy } from "./strategy.js";
+export declare const RELAYED_MONAD_STRATEGY_ID = "monad-relayed";
+/** How long a signature stays valid when the caller names no deadline: ten minutes. */
+export declare const DEFAULT_PERMIT_TTL_SECONDS = 600;
+/** A signer that can produce EIP-712 signatures, which an ethers `Signer` can. */
+export interface Permit2Signer {
+    getAddress(): Promise<string>;
+    signTypedData(domain: {
+        name: string;
+        chainId: bigint;
+        verifyingContract: string;
+    }, types: Record<string, readonly {
+        name: string;
+        type: string;
+    }[]>, value: Record<string, unknown>): Promise<string>;
+    readonly provider?: EthersV6CallProvider | null;
+    sendTransaction?(transaction: EthersV6TransactionRequest): Promise<EthersV6TransactionResponse>;
+}
+export interface SettlementPermitInput {
+    readonly signer: Permit2Signer;
+    readonly chainId: bigint | number;
+    /** The deployed `TabSettlement`, which is the `spender` Permit2 sees. */
+    readonly tabSettlement: Address;
+    readonly serviceId: Bytes32;
+    readonly asset: Address;
+    readonly amount: bigint;
+    /** The canonical Permit2 unless a deployment overrides it. */
+    readonly permit2?: Address;
+    /** A Permit2 unordered nonce. Random when omitted, which is what Permit2 is built for. */
+    readonly nonce?: bigint;
+    /** Unix seconds. Defaults to now plus {@link DEFAULT_PERMIT_TTL_SECONDS}. */
+    readonly deadline?: bigint;
+    readonly now?: () => number;
+}
+/** Exactly what `settleWithPermit2` takes, plus what was signed, for the record. */
+export interface SettlementPermit {
+    readonly agent: Address;
+    readonly serviceId: Bytes32;
+    readonly asset: Address;
+    readonly amount: bigint;
+    readonly nonce: bigint;
+    readonly deadline: bigint;
+    readonly signature: Hex;
+    readonly chainId: bigint;
+    readonly tabSettlement: Address;
+    readonly permit2: Address;
+}
+/** A random 256-bit unordered nonce. Permit2 keys them per owner in a bitmap. */
+export declare const randomPermitNonce: () => bigint;
+/**
+ * Signs one Settlement under Permit2's domain.
+ *
+ * The typed data is `PermitWitnessTransferFrom` with `TabSettlement` as the
+ * witness struct, field for field what the contract rebuilds before it hands
+ * Permit2 the signature. Nothing is sent.
+ */
+export declare function signSettlementPermit(input: SettlementPermitInput): Promise<Result<SettlementPermit>>;
+/** Calldata for `settleWithPermit2`, for a relayer that submits it itself. */
+export declare function encodeSettleWithPermit2(permit: SettlementPermit): Hex;
+/** The JSON body a relay endpoint takes: the permit with every integer as decimal text. */
+export interface RelaySettleBody {
+    readonly agent: string;
+    readonly serviceId: string;
+    readonly asset: string;
+    readonly amount: string;
+    readonly nonce: string;
+    readonly deadline: string;
+    readonly signature: string;
+    readonly chainId: string;
+    readonly tabSettlement: string;
+}
+export declare function toRelayBody(permit: SettlementPermit): RelaySettleBody;
+/** Reads a relay body back into a permit, refusing anything that is not one. */
+export declare function fromRelayBody(value: unknown, permit2?: Address): Result<SettlementPermit>;
+/** What a relay answers once the Settlement is mined. */
+export interface RelaySettleReply {
+    readonly ok: true;
+    readonly txHash: string;
+    readonly settlementId: string | null;
+    readonly applied: string | null;
+    readonly toPrepaid: string | null;
+}
+/** The little of `fetch` the strategy uses. */
+export type RelayFetch = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+}) => Promise<{
+    readonly status: number;
+    json(): Promise<unknown>;
+}>;
+export interface RelayedMonadStrategyConfig {
+    readonly signer: Permit2Signer;
+    readonly tabSettlement: Address;
+    /** The relay endpoint, for example `https://gateway.example/relay/settle`. */
+    readonly relayUrl: string;
+    readonly assets: Readonly<Record<string, AssetRef>>;
+    readonly permit2?: Address;
+    readonly id?: string;
+    /**
+     * What to do when the Agent has not approved Permit2 on the Asset. `require`
+     * refuses with `PERMIT2_ALLOWANCE_MISSING`; `approve` sends the one-time
+     * unlimited approval first, which needs MON once; `skip` does not read it.
+     */
+    readonly allowance?: "require" | "approve" | "skip";
+    readonly fetchImpl?: RelayFetch;
+    readonly logger?: Logger;
+    readonly now?: () => number;
+}
+/**
+ * A strategy that settles by signature and a relay, never by a transaction of
+ * the Agent's own.
+ */
+export declare function createRelayedMonadStrategy(config: RelayedMonadStrategyConfig): PaymentStrategy;
+//# sourceMappingURL=permit2.d.ts.map

package/dist/payments/permit2.d.ts.map

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