moltspay 1.6.0 → 2.4.0

package/dist/client/index.mjs

@@ -1,8 +1,9 @@
 // src/client/node/index.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2, statSync, chmodSync } from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
-import { Wallet as Wallet2, ethers as ethers2 } from "ethers";
+import { existsSync as existsSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3, statSync, chmodSync, readdirSync as readdirSync2 } from "fs";
+import { homedir as homedir4 } from "os";
+import { join as join4 } from "path";
+import { randomUUID as randomUUID3 } from "crypto";
+import { Wallet as Wallet2, ethers as ethers3 } from "ethers";
 
 // src/chains/index.ts
 var CHAINS = {
@@ -328,6 +329,16 @@ function networkToChainName(network) {
 // src/client/core/base64.ts
 var BufferCtor = globalThis.Buffer;
 
+// src/client/core/errors.ts
+var MoltsPayError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "MoltsPayError";
+    this.code = code;
+  }
+};
+
 // src/client/core/eip3009.ts
 var EIP3009_TYPES = {
   TransferWithAuthorization: [
@@ -464,6 +475,936 @@ function findChainByChainId(chainId) {
   return void 0;
 }
 
+// src/client/alipay/index.ts
+import { randomUUID } from "crypto";
+import { mkdir, writeFile } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+
+// src/client/alipay/cli.ts
+import { spawn } from "child_process";
+
+// src/client/alipay/log.ts
+var RANK = { off: 0, info: 1, debug: 2 };
+function normalizeLevel(v) {
+  const s = (v ?? "").toLowerCase();
+  return s === "info" || s === "debug" ? s : "off";
+}
+var level = normalizeLevel(process.env.MOLTSPAY_ALIPAY_LOG);
+var sink = (line) => {
+  process.stderr.write(line + "\n");
+};
+function enabledFor(want) {
+  return RANK[level] >= RANK[want];
+}
+function render(event, fields) {
+  const parts = ["[moltspay:alipay]", String(fields.ts), event];
+  if (fields.flow) parts.push(`flow=${fields.flow}`);
+  if (fields.step) parts.push(`step=${fields.step}`);
+  if (typeof fields.ms === "number") parts.push(`${fields.ms}ms`);
+  for (const [k, v] of Object.entries(fields)) {
+    if (["ts", "level", "event", "flow", "step", "ms"].includes(k)) continue;
+    parts.push(`${k}=${typeof v === "string" ? v : JSON.stringify(v)}`);
+  }
+  return parts.join(" ");
+}
+function emit(lvl, event, fields) {
+  if (!enabledFor(lvl)) return;
+  const full = { ts: (/* @__PURE__ */ new Date()).toISOString(), level: lvl, event, ...fields };
+  try {
+    sink(render(event, full), full);
+  } catch {
+  }
+}
+var alipayLog = {
+  info: (event, fields = {}) => emit("info", event, fields),
+  debug: (event, fields = {}) => emit("debug", event, fields),
+  /** True if anything at all would be logged (cheap guard for hot paths). */
+  enabled: () => level !== "off"
+};
+async function timeStep(step, flow, fn) {
+  if (!alipayLog.enabled()) return fn();
+  const t0 = Date.now();
+  alipayLog.debug("step.start", { flow, step });
+  try {
+    const out = await fn();
+    alipayLog.info("step.end", { flow, step, ms: Date.now() - t0, ok: true });
+    return out;
+  } catch (err) {
+    alipayLog.info("step.end", {
+      flow,
+      step,
+      ms: Date.now() - t0,
+      ok: false,
+      err: err instanceof Error ? err.message : String(err)
+    });
+    throw err;
+  }
+}
+
+// src/client/alipay/cli.ts
+var ALLOWED_ENV = /* @__PURE__ */ new Set([
+  "AIPAY_OUTPUT_CHANNEL",
+  "AIPAY_SESSION_ID",
+  "AIPAY_FRAMEWORK",
+  "AIPAY_MODEL",
+  "AIPAY_OS",
+  // Minimal survival set for spawn to find the binary and a home dir.
+  "PATH",
+  "HOME"
+]);
+function filterEnv(env) {
+  return Object.fromEntries(
+    Object.entries(env).filter(([k]) => ALLOWED_ENV.has(k))
+  );
+}
+function makeLineSplitter(onLine) {
+  let buf = "";
+  return (chunk) => {
+    buf += chunk.toString("utf-8");
+    let nl;
+    while ((nl = buf.indexOf("\n")) !== -1) {
+      onLine(buf.slice(0, nl));
+      buf = buf.slice(nl + 1);
+    }
+  };
+}
+function profileEnv(step, flow) {
+  const want = process.env.MOLTSPAY_ALIPAY_CLI_PROFILE;
+  const hook = process.env.MOLTSPAY_ALIPAY_CLI_PROFILE_HOOK;
+  if (!want || !hook) return {};
+  const steps = want.split(",").map((s) => s.trim());
+  if (!steps.includes("all") && !steps.includes(step)) return {};
+  const dir = process.env.MOLTSPAY_ALIPAY_CLI_PROFILE_DIR || "/tmp";
+  const safe = `${flow ?? "noflow"}-${step}-${Date.now()}`.replace(/[^a-zA-Z0-9._-]/g, "_");
+  const out = `${dir}/cli-profile-${safe}.json`;
+  alipayLog.info("cli.profile", { flow, step, out });
+  return {
+    NODE_OPTIONS: `--require=${hook}`,
+    MOLTSPAY_CLI_PROFILE_OUT: out
+  };
+}
+var runCli = (args, opts = {}) => {
+  const bin = opts.bin ?? "alipay-bot";
+  const step = opts.step ?? args[0] ?? "(no-arg)";
+  const startedAt = Date.now();
+  const lines = [];
+  const collect = (line) => {
+    lines.push(line);
+    alipayLog.debug("cli.line", {
+      flow: opts.flow,
+      step,
+      ms: Date.now() - startedAt,
+      preview: line.slice(0, 120)
+    });
+    opts.onLine?.(line);
+  };
+  alipayLog.debug("step.start", { flow: opts.flow, step });
+  return new Promise((resolve, reject) => {
+    const child = spawn(bin, args, {
+      env: { ...filterEnv(process.env), ...profileEnv(step, opts.flow), ...opts.env ?? {} }
+    });
+    if (opts.signal) {
+      if (opts.signal.aborted) child.kill("SIGTERM");
+      opts.signal.addEventListener("abort", () => child.kill("SIGTERM"), { once: true });
+    }
+    let sawByte = false;
+    const onChunk = (stream) => (chunk) => {
+      const ms = Date.now() - startedAt;
+      if (!sawByte) {
+        sawByte = true;
+        alipayLog.debug("cli.firstbyte", { flow: opts.flow, step, ms });
+      }
+      alipayLog.debug("cli.chunk", { flow: opts.flow, step, ms, stream, bytes: chunk.length });
+    };
+    const onStdout = makeLineSplitter(collect);
+    const onStderr = makeLineSplitter(collect);
+    child.stdout?.on("data", onChunk("out"));
+    child.stderr?.on("data", onChunk("err"));
+    child.stdout?.on("data", onStdout);
+    child.stderr?.on("data", onStderr);
+    child.on("error", (err) => {
+      alipayLog.info("cli.exit", {
+        flow: opts.flow,
+        step,
+        ms: Date.now() - startedAt,
+        ok: false,
+        err: err.message
+      });
+      reject(err);
+    });
+    child.on("close", (code) => {
+      alipayLog.info("cli.exit", {
+        flow: opts.flow,
+        step,
+        ms: Date.now() - startedAt,
+        ok: (code ?? 1) === 0,
+        code: code ?? 1
+      });
+      resolve({ exitCode: code ?? 1, lines });
+    });
+  });
+};
+
+// src/client/alipay/install.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+
+// src/client/alipay/errors.ts
+var AlipayCliNotFoundError = class extends MoltsPayError {
+  constructor(message) {
+    super("ALIPAY_CLI_NOT_FOUND", message);
+    this.name = "AlipayCliNotFoundError";
+  }
+};
+var AlipayCliVersionError = class extends MoltsPayError {
+  constructor(message) {
+    super("ALIPAY_CLI_VERSION", message);
+    this.name = "AlipayCliVersionError";
+  }
+};
+var NeedsWalletSetupError = class extends MoltsPayError {
+  constructor(message = "Alipay wallet not set up. Run: moltspay alipay apply") {
+    super("ALIPAY_NEEDS_WALLET_SETUP", message);
+    this.name = "NeedsWalletSetupError";
+  }
+};
+var AlipayPaymentRejectedError = class extends MoltsPayError {
+  constructor(message) {
+    super("ALIPAY_PAYMENT_REJECTED", message);
+    this.name = "AlipayPaymentRejectedError";
+  }
+};
+var AlipayPaymentTimeoutError = class extends MoltsPayError {
+  constructor(message) {
+    super("ALIPAY_PAYMENT_TIMEOUT", message);
+    this.name = "AlipayPaymentTimeoutError";
+  }
+};
+var AlipayProtocolError = class extends MoltsPayError {
+  constructor(message) {
+    super("ALIPAY_PROTOCOL", message);
+    this.name = "AlipayProtocolError";
+  }
+};
+var UnsupportedRailError = class extends MoltsPayError {
+  constructor(rail, message) {
+    super("UNSUPPORTED_RAIL", message ?? `Rail not supported by server: ${rail}`);
+    this.rail = rail;
+    this.name = "UnsupportedRailError";
+  }
+};
+
+// src/client/alipay/install.ts
+var execFileAsync = promisify(execFile);
+var MIN_CLI_VERSION = "0.3.15";
+function semverLt(a, b) {
+  const pa = a.split(".").map((n) => parseInt(n, 10));
+  const pb = b.split(".").map((n) => parseInt(n, 10));
+  for (let i = 0; i < 3; i++) {
+    const x = pa[i] ?? 0;
+    const y = pb[i] ?? 0;
+    if (x !== y) return x < y;
+  }
+  return false;
+}
+function parseVersion(stdout) {
+  return stdout.match(/v?(\d+\.\d+\.\d+)/)?.[1] ?? null;
+}
+var defaultGetVersion = async () => {
+  const { stdout } = await execFileAsync("alipay-bot", ["--version"]);
+  return stdout;
+};
+async function ensureCliUncached(getVersion) {
+  let stdout;
+  try {
+    stdout = await getVersion();
+  } catch (e) {
+    if (e?.code === "ENOENT") {
+      throw new AlipayCliNotFoundError(
+        "alipay-bot not installed. Run: npx -y @alipay/agent-payment install-cli"
+      );
+    }
+    throw e;
+  }
+  const version = parseVersion(stdout);
+  if (!version || semverLt(version, MIN_CLI_VERSION)) {
+    throw new AlipayCliVersionError(
+      `alipay-bot ${version ?? "?"} found, need \u2265 ${MIN_CLI_VERSION}. Run: npx -y @alipay/agent-payment@latest update`
+    );
+  }
+  return version;
+}
+var cachedVersion = null;
+var inflight = null;
+async function ensureCli(getVersion = defaultGetVersion) {
+  if (getVersion !== defaultGetVersion) {
+    return ensureCliUncached(getVersion);
+  }
+  if (cachedVersion) return cachedVersion;
+  if (!inflight) {
+    inflight = ensureCliUncached(getVersion).then((v) => {
+      cachedVersion = v;
+      return v;
+    }).finally(() => {
+      inflight = null;
+    });
+  }
+  return inflight;
+}
+
+// src/client/alipay/poll.ts
+var POLL_INTERVAL_MS = 3e3;
+var POLL_MAX_INFLIGHT = 2;
+function resolveMaxInflight(override) {
+  if (override !== void 0) return Math.max(1, Math.floor(override));
+  const raw = process.env.MOLTSPAY_ALIPAY_POLL_MAX_INFLIGHT;
+  if (raw !== void 0 && raw.trim() !== "") {
+    const n = Number(raw);
+    if (Number.isFinite(n) && n >= 1) return Math.floor(n);
+  }
+  return POLL_MAX_INFLIGHT;
+}
+function resolveLaunchGap(override) {
+  if (override !== void 0) return Math.max(0, override);
+  const raw = process.env.MOLTSPAY_ALIPAY_POLL_LAUNCH_MS;
+  if (raw !== void 0 && raw.trim() !== "") {
+    const n = Number(raw);
+    if (Number.isFinite(n) && n >= 0) return n;
+  }
+  return POLL_INTERVAL_MS;
+}
+function parseStatus(lines) {
+  const raw = lines.join("\n").trim();
+  try {
+    const json = JSON.parse(raw);
+    if (json && typeof json === "object") {
+      if (typeof json.success === "boolean") {
+        if (json.success) return "paid";
+        const err = String(json.errorCode ?? "").toUpperCase();
+        if (/UNPAID|WAIT|PENDING|PROCESS|NOTPAY/.test(err)) return "pending";
+        if (/CLOSED|CANCEL|FAIL|REJECT|REFUSE|TIMEOUT|EXPIRE/.test(err)) return "rejected";
+        return "pending";
+      }
+      if (typeof json.code !== "undefined") {
+        if (Number(json.code) === 200) return "paid";
+        const msg = `${json.message ?? ""}${json.reason ?? ""}`;
+        if (/关闭|失败|拒绝|取消|超时|已撤销/.test(msg)) return "rejected";
+        return "pending";
+      }
+      if (typeof json.body === "string") {
+        return classifyReportText(json.body);
+      }
+    }
+  } catch {
+  }
+  return classifyReportText(raw);
+}
+function classifyReportText(s) {
+  const text = s.toUpperCase();
+  if (/查询支付状态成功并获取资源/.test(s) || /资源响应状态[^0-9\n]{0,8}200/.test(s) || /TRADE_SUCCESS|TRADE_FINISHED|"STATUS":\s*"FULFILLED"/.test(text)) return "paid";
+  if (/TRADE_CLOSED|REJECTED|REFUSE|CANCEL/.test(text) || /交易关闭|支付失败|已拒绝|已取消|已撤销|交易超时/.test(s)) return "rejected";
+  if (/WAIT_BUYER_PAY|UNPAID|PENDING|WAITING/.test(text) || /交易未支付|等待付款|待支付|未支付/.test(s)) return "pending";
+  return "unknown";
+}
+function defaultSleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) return reject(new Error("aborted"));
+    const t = setTimeout(resolve, ms);
+    signal?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(t);
+        reject(new Error("aborted"));
+      },
+      { once: true }
+    );
+  });
+}
+var LAUNCH = /* @__PURE__ */ Symbol("launch");
+async function pollUntil(tradeNo, resourceUrl, opts) {
+  const runner = opts.runner ?? runCli;
+  const sleep = opts.sleep ?? defaultSleep;
+  const now = opts.now ?? Date.now;
+  const maxInflight = resolveMaxInflight(opts.maxInflight);
+  const launchGap = resolveLaunchGap(opts.launchIntervalMs);
+  const args = [
+    "402-query-payment-status",
+    "-t",
+    tradeNo,
+    "-r",
+    resourceUrl,
+    ...opts.method ? ["-m", opts.method] : [],
+    ...opts.data ? ["-d", opts.data] : []
+  ];
+  const internal = new AbortController();
+  const signal = opts.signal ? AbortSignal.any([opts.signal, internal.signal]) : internal.signal;
+  let tick = 0;
+  let lastLaunch = -Infinity;
+  const inflight2 = /* @__PURE__ */ new Set();
+  const launch = () => {
+    tick += 1;
+    const myTick = tick;
+    lastLaunch = now();
+    const run = (async () => {
+      const { lines } = await runner(args, {
+        signal,
+        step: "query-payment-status",
+        flow: tradeNo
+      });
+      const status = parseStatus(lines);
+      alipayLog.debug("poll.tick", { flow: tradeNo, tick: myTick, status });
+      return { status, lines };
+    })();
+    const tracked = run.finally(() => {
+      inflight2.delete(tracked);
+    });
+    inflight2.add(tracked);
+  };
+  try {
+    for (; ; ) {
+      if (opts.signal?.aborted) throw new Error("aborted");
+      const expired = now() >= opts.deadline;
+      if (expired && inflight2.size === 0) {
+        throw new AlipayPaymentTimeoutError(
+          `Payment ${tradeNo} not completed before pay_before deadline`
+        );
+      }
+      while (!expired && inflight2.size < maxInflight && now() - lastLaunch >= launchGap) {
+        launch();
+      }
+      const waiters = [...inflight2];
+      if (!expired && inflight2.size < maxInflight) {
+        const untilNext = Math.max(0, launchGap - (now() - lastLaunch));
+        waiters.push(sleep(untilNext, signal).then(() => LAUNCH, () => LAUNCH));
+      }
+      const winner = await Promise.race(waiters);
+      if (winner === LAUNCH) continue;
+      if (winner.status === "paid") return { status: "paid", lines: winner.lines };
+      if (winner.status === "rejected") {
+        throw new AlipayPaymentRejectedError(`Payment ${tradeNo} was rejected`);
+      }
+    }
+  } finally {
+    internal.abort();
+    for (const p of inflight2) p.catch(() => void 0);
+  }
+}
+
+// src/client/alipay/index.ts
+var TRADE_NO_RE = /^\d{32}$/;
+function resolveSessionId(explicit, envSession) {
+  return explicit ?? envSession ?? randomUUID();
+}
+function assertTradeNo(t) {
+  if (!TRADE_NO_RE.test(t)) {
+    throw new AlipayProtocolError(`invalid tradeNo (expect 32 digits): ${t}`);
+  }
+}
+function parseTradeNo(lines) {
+  for (const line of lines) {
+    const labeled = line.match(/trade[_-]?no["'\s:=]+(\d{32})/i);
+    if (labeled) return labeled[1];
+    const bare = line.match(/\b(\d{32})\b/);
+    if (bare) return bare[1];
+  }
+  return null;
+}
+function parsePaymentUrl(lines) {
+  let paymentUrl;
+  let shortenUrl;
+  for (const line of lines) {
+    const m = line.match(/(alipays?:\/\/\S+|https?:\/\/\S+)/i);
+    if (!m) continue;
+    const url = m[1].replace(/[)\]`>]+$/, "");
+    if (/short|qr\.alipay|surl|\/s\//i.test(line) && !shortenUrl) shortenUrl = url;
+    else if (!paymentUrl) paymentUrl = url;
+  }
+  if (!paymentUrl && shortenUrl) paymentUrl = shortenUrl;
+  return { paymentUrl, shortenUrl };
+}
+function extractMedia(line) {
+  const m = line.match(/^\s*MEDIA:\s*(.+?)\s*$/);
+  return m ? m[1] : null;
+}
+function isWalletReady(lines) {
+  const text = lines.join("\n").trim();
+  try {
+    const json = JSON.parse(text);
+    if (json && typeof json.code !== "undefined") return Number(json.code) === 200;
+  } catch {
+  }
+  return !/未开通|未开启|NOT[_\s-]*(OPEN|BOUND|SET)|NEEDS?[_\s-]*SETUP|NO[_\s-]*WALLET/i.test(text);
+}
+function extractResourceFromReport(report) {
+  const label = report.search(/资源响应体/);
+  const start = report.indexOf("{", label === -1 ? 0 : label);
+  if (start === -1) return void 0;
+  let depth = 0, inStr = false, esc = false;
+  for (let i = start; i < report.length; i++) {
+    const ch = report[i];
+    if (inStr) {
+      if (esc) esc = false;
+      else if (ch === "\\") esc = true;
+      else if (ch === '"') inStr = false;
+      continue;
+    }
+    if (ch === '"') inStr = true;
+    else if (ch === "{") depth++;
+    else if (ch === "}" && --depth === 0) {
+      const slice = report.slice(start, i + 1);
+      try {
+        const obj = JSON.parse(slice);
+        const r = obj?.resourceResponse ?? obj?.result ?? obj?.data ?? obj?.body ?? obj;
+        return typeof r === "string" ? r : JSON.stringify(r);
+      } catch {
+        return slice;
+      }
+    }
+  }
+  return void 0;
+}
+function extractBody(lines) {
+  const text = lines.join("\n").trim();
+  try {
+    const json = JSON.parse(text);
+    if (json && typeof json === "object") {
+      if (json.resourceResponse !== void 0 && json.resourceResponse !== null) {
+        const rr = json.resourceResponse;
+        const r = typeof rr === "object" ? rr.result ?? rr.data ?? rr.body ?? rr : rr;
+        return typeof r === "string" ? r : JSON.stringify(r);
+      }
+      if (typeof json.body === "string") {
+        const inner = extractResourceFromReport(json.body);
+        return inner ?? json.body;
+      }
+      const body = json.data ?? json.result ?? json.body ?? json.resource;
+      if (body !== void 0) return typeof body === "string" ? body : JSON.stringify(body);
+      return text;
+    }
+  } catch {
+  }
+  const idx = lines.findIndex((l) => /^\s*BODY:/.test(l));
+  if (idx !== -1) {
+    const first = lines[idx].replace(/^\s*BODY:\s*/, "");
+    return [first, ...lines.slice(idx + 1)].join("\n").trim();
+  }
+  return lines.filter((l) => !/^\s*(MEDIA|STATUS|INFO):/.test(l)).join("\n").trim();
+}
+var DEFAULT_WALLET_TTL_MS = 10 * 60 * 1e3;
+function resolveWalletTtlMs() {
+  const raw = process.env.MOLTSPAY_ALIPAY_WALLET_TTL_MS;
+  if (raw === void 0 || raw.trim() === "") return DEFAULT_WALLET_TTL_MS;
+  const n = Number(raw);
+  return Number.isFinite(n) && n >= 0 ? n : DEFAULT_WALLET_TTL_MS;
+}
+var walletReadyUntil = /* @__PURE__ */ new Map();
+var DEFAULT_INTENT_TTL_MS = 10 * 60 * 1e3;
+function resolveIntentTtlMs() {
+  const raw = process.env.MOLTSPAY_ALIPAY_INTENT_TTL_MS;
+  if (raw === void 0 || raw.trim() === "") return DEFAULT_INTENT_TTL_MS;
+  const n = Number(raw);
+  return Number.isFinite(n) && n >= 0 ? n : DEFAULT_INTENT_TTL_MS;
+}
+var intentDoneUntil = /* @__PURE__ */ new Map();
+var AlipayClient = class {
+  sessionId;
+  configDir;
+  framework;
+  runner;
+  getVersion;
+  now;
+  /** Only the default runner may use the process-level wallet cache. */
+  walletCacheable;
+  /** Only the default runner may use the process-level payment-intent cache. */
+  intentCacheable;
+  constructor(opts = {}) {
+    this.sessionId = resolveSessionId(opts.sessionId, process.env.AIPAY_SESSION_ID);
+    this.configDir = opts.configDir ?? join2(homedir2(), ".moltspay");
+    this.framework = opts.framework ?? process.env.AIPAY_FRAMEWORK ?? "openclaw";
+    this.runner = opts.runner ?? runCli;
+    this.getVersion = opts.getVersion;
+    this.now = opts.now ?? Date.now;
+    this.walletCacheable = opts.cacheWallet ?? !opts.runner;
+    this.intentCacheable = opts.cacheIntent ?? !opts.runner;
+  }
+  /**
+   * Throws NeedsWalletSetupError unless alipay-bot reports an opened wallet.
+   *
+   * Skips the ~22s `check-wallet` spawn entirely when a prior call cached a
+   * "ready" verdict within the TTL (see {@link DEFAULT_WALLET_TTL_MS}).
+   */
+  async checkWallet(signal, flow) {
+    const ttlMs = resolveWalletTtlMs();
+    const cacheKey = `${this.configDir}::${this.framework}`;
+    const useCache = this.walletCacheable && ttlMs > 0;
+    if (useCache) {
+      const until = walletReadyUntil.get(cacheKey);
+      if (until !== void 0 && this.now() < until) {
+        alipayLog.info("wallet.cache", { flow, step: "check-wallet", hit: true, ttlMsLeft: until - this.now() });
+        return;
+      }
+    }
+    const { lines } = await this.runner(["check-wallet"], { signal, step: "check-wallet", flow });
+    if (!isWalletReady(lines)) {
+      if (this.walletCacheable) walletReadyUntil.delete(cacheKey);
+      throw new NeedsWalletSetupError(
+        "Alipay wallet not opened. Run: moltspay alipay apply (then: moltspay alipay bind)"
+      );
+    }
+    if (useCache) {
+      walletReadyUntil.set(cacheKey, this.now() + ttlMs);
+      alipayLog.info("wallet.cache", { flow, step: "check-wallet", hit: false, cachedForMs: ttlMs });
+    }
+  }
+  /** Run the full 8-step flow and resolve with the resource body. */
+  async pay402(opts) {
+    const { resourceUrl, requirement, signal } = opts;
+    const extra = requirement.extra ?? {};
+    const paymentNeededHeader = String(extra.payment_needed_header ?? "");
+    if (!paymentNeededHeader) {
+      throw new AlipayProtocolError("alipay requirement missing extra.payment_needed_header");
+    }
+    const flow = this.sessionId;
+    const flowStart = this.now();
+    alipayLog.info("flow.start", { flow, resource: resourceUrl });
+    const media = [];
+    const onLine = (line) => {
+      const m = extractMedia(line);
+      if (m) media.push(m);
+      else opts.onLine?.(line);
+    };
+    const intentSummary = opts.intentSummary?.trim() || `Pay ${requirement.amount ?? ""} ${requirement.asset ?? "CNY"}`.trim();
+    await timeStep("ensure-cli", flow, () => ensureCli(this.getVersion));
+    const intentTtlMs = resolveIntentTtlMs();
+    const intentKey = `${this.configDir}::${this.framework}`;
+    const useIntentCache = this.intentCacheable && intentTtlMs > 0;
+    const intentUntil = useIntentCache ? intentDoneUntil.get(intentKey) : void 0;
+    if (intentUntil !== void 0 && this.now() < intentUntil) {
+      alipayLog.info("intent.cache", { flow, step: "payment-intent", hit: true, ttlMsLeft: intentUntil - this.now() });
+    } else {
+      await this.runner(
+        [
+          "payment-intent",
+          "--session-id",
+          this.sessionId,
+          "--intent-summary",
+          intentSummary,
+          "--framework",
+          this.framework
+        ],
+        { onLine, signal, step: "payment-intent", flow }
+      );
+      if (useIntentCache) {
+        intentDoneUntil.set(intentKey, this.now() + intentTtlMs);
+        alipayLog.info("intent.cache", { flow, step: "payment-intent", hit: false, cachedForMs: intentTtlMs });
+      }
+    }
+    await this.checkWallet(signal, flow);
+    const reqId = String(extra.out_trade_no ?? randomUUID());
+    const dir = join2(this.configDir, "alipay");
+    await mkdir(dir, { recursive: true });
+    const challengeFile = join2(dir, `402_${reqId}.txt`);
+    await writeFile(challengeFile, paymentNeededHeader, "utf-8");
+    const payArgs = [
+      "402-buyer-pay",
+      "-f",
+      challengeFile,
+      "-r",
+      resourceUrl,
+      "-s",
+      this.sessionId,
+      "-i",
+      intentSummary,
+      "-w",
+      this.framework
+    ];
+    if (opts.method) payArgs.push("-m", opts.method);
+    if (opts.data) payArgs.push("-d", opts.data);
+    const payRun = await this.runner(payArgs, { onLine, signal, step: "402-buyer-pay", flow });
+    const tradeNo = parseTradeNo(payRun.lines);
+    if (!tradeNo) {
+      throw new AlipayProtocolError("402-buyer-pay did not return a tradeNo");
+    }
+    assertTradeNo(tradeNo);
+    const { paymentUrl, shortenUrl } = parsePaymentUrl(payRun.lines);
+    if (paymentUrl) {
+      alipayLog.info("flow.pending", { flow, tradeNo, ms: this.now() - flowStart });
+      opts.onPaymentPending?.({ paymentUrl, shortenUrl, tradeNo });
+    }
+    const pendingAt = this.now();
+    const windowMs = (requirement.maxTimeoutSeconds ?? 30 * 60) * 1e3;
+    const deadline = this.now() + (opts.timeoutMs ?? windowMs);
+    const poll = await pollUntil(tradeNo, resourceUrl, {
+      // No onLine: the status-poll output embeds the resource and must not reach
+      // the log stream — the body is surfaced via the return value below (§9.3).
+      deadline,
+      signal,
+      runner: this.runner,
+      now: this.now,
+      // Re-fetch the resource the same way it was paid (POST + body), else the
+      // status poll defaults to GET and 404s on a POST-only `/execute`.
+      method: opts.method,
+      data: opts.data
+    });
+    alipayLog.info("flow.settled", { flow, tradeNo, ms: this.now() - pendingAt });
+    const body = extractBody(poll.lines);
+    void this.runner(["402-buyer-fulfillment-ack", "-t", tradeNo], {
+      onLine,
+      signal,
+      step: "402-buyer-fulfillment-ack",
+      flow
+    }).catch(() => void 0);
+    return { body, payment: { tradeNo, outTradeNo: reqId }, media };
+  }
+};
+
+// src/client/wechat/index.ts
+import { randomUUID as randomUUID2 } from "crypto";
+import { mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { homedir as homedir3 } from "os";
+import { join as join3 } from "path";
+var WECHAT_SCHEME = "wechatpay-native";
+var WECHAT_NETWORK = "wechat";
+var POLL_INTERVAL_MS2 = 3e3;
+var TIMEOUT_MS = 5 * 60 * 1e3;
+var WechatClient = class {
+  configDir;
+  sessionDir;
+  now;
+  constructor(options = {}) {
+    this.configDir = options.configDir || join3(homedir3(), ".moltspay");
+    this.sessionDir = join3(this.configDir, "wechat-sessions");
+    this.now = options.now ?? Date.now;
+  }
+  async pay402(opts) {
+    const session = this.start402({ ...opts });
+    const result = await this.pollSession(session.paymentSessionId, {
+      pollIntervalMs: opts.pollIntervalMs,
+      timeoutMs: opts.timeoutMs,
+      signal: opts.signal
+    });
+    if (result.status === "paid" || result.status === "completed") {
+      return {
+        body: result.resultBody ?? "",
+        status: result.lastHttpStatus ?? 200
+      };
+    }
+    throw new Error(result.lastError || `WeChat payment ended with status ${result.status}`);
+  }
+  /**
+   * Start a recoverable WeChat payment session. This returns immediately after
+   * persisting `out_trade_no`, QR payload, original request body, and context.
+   */
+  start402(opts) {
+    const extra = opts.requirement.extra ?? {};
+    const codeUrl = typeof extra.code_url === "string" ? extra.code_url : "";
+    const outTradeNo = typeof extra.out_trade_no === "string" ? extra.out_trade_no : "";
+    if (!codeUrl || !outTradeNo) {
+      throw new Error(
+        "WechatClient.pay402: wechatpay-native requirement is missing extra.code_url / extra.out_trade_no"
+      );
+    }
+    const now = new Date(this.now());
+    const timeoutMs = opts.timeoutMs ?? (opts.requirement.maxTimeoutSeconds ?? TIMEOUT_MS / 1e3) * 1e3;
+    const session = {
+      paymentSessionId: opts.paymentSessionId ?? `mpay_sess_${randomUUID2()}`,
+      status: "pending",
+      resourceUrl: opts.resourceUrl,
+      method: opts.method ?? "POST",
+      data: opts.data,
+      requirement: opts.requirement,
+      codeUrl,
+      outTradeNo,
+      createdAt: now.toISOString(),
+      updatedAt: now.toISOString(),
+      expiresAt: new Date(this.now() + timeoutMs).toISOString(),
+      context: opts.context
+    };
+    this.saveSession(session);
+    opts.onPaymentPending?.({ codeUrl, outTradeNo });
+    return session;
+  }
+  /**
+   * Query a persisted session once by replaying the original request with the
+   * stored `out_trade_no` proof. 200 means paid + fulfilled; 402 means pending.
+   */
+  async status(identifier) {
+    const session = this.loadSession(identifier);
+    if (session.status === "cancelled" || session.status === "completed") return session;
+    if (this.now() >= new Date(session.expiresAt).getTime()) {
+      return this.updateSession(session, {
+        status: "expired",
+        lastError: `WeChat payment expired at ${session.expiresAt}`
+      });
+    }
+    const xPayment = this.buildPaymentHeader(session);
+    const res = await fetch(session.resourceUrl, {
+      method: session.method,
+      headers: { "Content-Type": "application/json", "X-Payment": xPayment },
+      body: session.method === "POST" ? session.data : void 0
+    });
+    const text = await res.text().catch(() => "");
+    if (res.status === 200) {
+      return this.updateSession(session, {
+        status: "completed",
+        lastHttpStatus: res.status,
+        lastError: void 0,
+        resultBody: text
+      });
+    }
+    if (res.status === 402) {
+      return this.updateSession(session, {
+        status: "pending",
+        lastHttpStatus: res.status,
+        lastError: text.slice(0, 500) || "wechat payment pending"
+      });
+    }
+    return this.updateSession(session, {
+      status: "failed",
+      lastHttpStatus: res.status,
+      lastError: `WeChat /execute returned HTTP ${res.status}: ${text.slice(0, 500)}`
+    });
+  }
+  /** Poll a session until it completes, expires, fails, or is aborted. */
+  async pollSession(identifier, opts = {}) {
+    const first = this.loadSession(identifier);
+    const deadline = Math.min(
+      new Date(first.expiresAt).getTime(),
+      this.now() + (opts.timeoutMs ?? TIMEOUT_MS)
+    );
+    const interval = opts.pollIntervalMs ?? POLL_INTERVAL_MS2;
+    let session = first;
+    while (this.now() < deadline) {
+      if (opts.signal?.aborted) throw new Error("WeChat payment aborted");
+      session = await this.status(session.paymentSessionId);
+      if (session.status !== "pending") return session;
+      await new Promise((r) => setTimeout(r, interval));
+    }
+    return this.updateSession(session, {
+      status: "expired",
+      lastError: `WeChat payment timed out after ${Math.round((opts.timeoutMs ?? TIMEOUT_MS) / 1e3)}s (out_trade_no=${session.outTradeNo}, last status ${session.lastHttpStatus ?? 0})`
+    });
+  }
+  /** `fulfill` is an idempotent status check: paid sessions return stored body. */
+  async fulfill(identifier) {
+    const session = this.loadSession(identifier);
+    if (session.status === "completed") return session;
+    return this.status(identifier);
+  }
+  /** Mark a local session cancelled. Closing the merchant order is server-side. */
+  cancel(identifier) {
+    const session = this.loadSession(identifier);
+    return this.updateSession(session, {
+      status: "cancelled",
+      lastError: "cancelled locally"
+    });
+  }
+  listSessions() {
+    this.ensureSessionDir();
+    return readdirSync(this.sessionDir).filter((name) => name.endsWith(".json")).map((name) => JSON.parse(readFileSync2(join3(this.sessionDir, name), "utf-8"))).sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+  }
+  buildPaymentHeader(session) {
+    const proof = {
+      x402Version: 2,
+      scheme: WECHAT_SCHEME,
+      network: WECHAT_NETWORK,
+      accepted: {
+        scheme: WECHAT_SCHEME,
+        network: WECHAT_NETWORK,
+        extra: { out_trade_no: session.outTradeNo }
+      },
+      payload: { out_trade_no: session.outTradeNo }
+    };
+    return Buffer.from(JSON.stringify(proof)).toString("base64");
+  }
+  loadSession(identifier) {
+    this.ensureSessionDir();
+    const direct = join3(this.sessionDir, `${identifier}.json`);
+    try {
+      return JSON.parse(readFileSync2(direct, "utf-8"));
+    } catch {
+      const byTradeNo = this.listSessions().find((s) => s.outTradeNo === identifier);
+      if (byTradeNo) return byTradeNo;
+      throw new Error(`WeChat payment session not found: ${identifier}`);
+    }
+  }
+  saveSession(session) {
+    this.ensureSessionDir();
+    writeFileSync2(
+      join3(this.sessionDir, `${session.paymentSessionId}.json`),
+      JSON.stringify(session, null, 2)
+    );
+  }
+  updateSession(session, updates) {
+    const next = {
+      ...session,
+      ...updates,
+      updatedAt: new Date(this.now()).toISOString()
+    };
+    this.saveSession(next);
+    return next;
+  }
+  ensureSessionDir() {
+    mkdirSync2(this.sessionDir, { recursive: true });
+  }
+};
+
+// src/client/alipay/router.ts
+var ALIPAY_RAIL = "alipay";
+var WECHAT_RAIL = "wechat";
+var BALANCE_RAIL = "balance";
+function railOf(req) {
+  if (req.scheme === "alipay-aipay" || req.network === ALIPAY_RAIL) return ALIPAY_RAIL;
+  if (req.scheme === "wechatpay-native" || req.network === WECHAT_RAIL) return WECHAT_RAIL;
+  if (req.scheme === BALANCE_RAIL || req.network === BALANCE_RAIL) return BALANCE_RAIL;
+  return networkToChainName(req.network) ?? req.network;
+}
+function findRail(accepts, rail) {
+  const requirement = accepts.find((r) => railOf(r) === rail);
+  return requirement ? { rail, requirement } : null;
+}
+function selectRail(input) {
+  const { serverAccepts, explicitRail, preference, availability } = input;
+  if (!serverAccepts || serverAccepts.length === 0) {
+    throw new UnsupportedRailError(explicitRail ?? "unknown", "Server offered no payment options");
+  }
+  if (explicitRail) {
+    const hit = findRail(serverAccepts, explicitRail);
+    if (!hit) {
+      const offered = serverAccepts.map(railOf);
+      throw new UnsupportedRailError(
+        explicitRail,
+        `Server doesn't accept rail '${explicitRail}'. Offered: ${offered.join(", ")}`
+      );
+    }
+    return hit;
+  }
+  if (preference) {
+    for (const pref of preference) {
+      const hit = findRail(serverAccepts, pref);
+      if (hit) return hit;
+    }
+  }
+  if (availability?.evmReady) {
+    const evm = serverAccepts.find((r) => railOf(r) !== ALIPAY_RAIL);
+    if (evm) return { rail: railOf(evm), requirement: evm };
+  }
+  if (availability?.alipayReady) {
+    const hit = findRail(serverAccepts, ALIPAY_RAIL);
+    if (hit) return hit;
+  }
+  return { rail: railOf(serverAccepts[0]), requirement: serverAccepts[0] };
+}
+
+// src/facilitators/balance/auth.ts
+import { ethers as ethers2 } from "ethers";
+var BALANCE_AUTH_DOMAIN = "moltspay-balance-auth:v1";
+var BALANCE_AUTH_MAX_SKEW_MS = 5 * 60 * 1e3;
+function buildDeductMessage(f) {
+  return [BALANCE_AUTH_DOMAIN, "balance-deduct", f.buyerId, f.requestId, f.service, String(f.timestamp)].join("\n");
+}
+
 // src/client/node/index.ts
 var DEFAULT_CONFIG = {
   chain: "base",
@@ -480,9 +1421,13 @@ var MoltsPayClient = class {
   signer = null;
   todaySpending = 0;
   lastSpendingReset = 0;
+  railPreference;
+  alipaySessionId;
   constructor(options = {}) {
-    this.configDir = options.configDir || join2(homedir2(), ".moltspay");
+    this.configDir = options.configDir || join4(homedir4(), ".moltspay");
     this.config = this.loadConfig();
+    this.railPreference = options.railPreference ?? this.config.railPreference;
+    this.alipaySessionId = options.alipaySessionId;
     this.walletData = this.loadWallet();
     this.loadSpending();
     if (this.walletData) {
@@ -560,6 +1505,15 @@ var MoltsPayClient = class {
    * @param options - Payment options (token selection)
    */
   async pay(serverUrl, service, params, options = {}) {
+    if (options.rail === ALIPAY_RAIL) {
+      return this.payViaAlipay(serverUrl, service, params, options);
+    }
+    if (options.rail === WECHAT_RAIL) {
+      return this.payViaWechat(serverUrl, service, params, options);
+    }
+    if (options.rail === BALANCE_RAIL) {
+      return this.payViaBalance(serverUrl, service, params, options);
+    }
     if (!this.wallet || !this.walletData) {
       throw new Error("Client not initialized. Run: npx moltspay init");
     }
@@ -751,6 +1705,469 @@ Please specify: --chain <chain_name>`
     console.log(`[MoltsPay] Success! Payment: ${result.payment?.status || "claimed"}`);
     return result.result || result;
   }
+  /**
+   * Pay for a service over the Alipay fiat rail (2.0.0).
+   *
+   * Unlike the crypto path this needs no EVM wallet — it shells out to
+   * alipay-bot via {@link AlipayClient}. Flow: hit the resource with no
+   * payment to get the 402 challenge, confirm the server actually offers the
+   * alipay rail (selectRail), then run the 8-step state machine and return the
+   * resource body.
+   */
+  async payViaAlipay(serverUrl, service, params, options) {
+    const flow = this.alipaySessionId;
+    let executeUrl = `${serverUrl}/execute`;
+    try {
+      const services = await timeStep(
+        "discover-services",
+        flow,
+        () => this.getServices(serverUrl)
+      );
+      const svc = services.services?.find((s) => s.id === service);
+      if (svc?.endpoint) executeUrl = `${serverUrl}${svc.endpoint}`;
+    } catch {
+    }
+    const requestBody = options.rawData ? { service, ...params } : { service, params };
+    const bodyJson = JSON.stringify(requestBody);
+    const res = await timeStep(
+      "challenge-402",
+      flow,
+      () => fetch(executeUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: bodyJson
+      })
+    );
+    if (res.status !== 402) {
+      const data = await res.json().catch(() => ({}));
+      if (res.ok && data.result) return data.result;
+      throw new Error(data.error || `Expected 402, got ${res.status}`);
+    }
+    const header = res.headers.get(PAYMENT_REQUIRED_HEADER);
+    if (!header) throw new Error("Missing x-payment-required header on 402");
+    const parsed = JSON.parse(Buffer.from(header, "base64").toString("utf-8"));
+    const accepts = Array.isArray(parsed) ? parsed : parsed.accepts ?? [parsed];
+    const { requirement } = selectRail({
+      serverAccepts: accepts,
+      explicitRail: ALIPAY_RAIL,
+      preference: this.railPreference,
+      availability: { evmReady: this.isInitialized }
+    });
+    const onLine = options.onLine ?? ((line) => process.stdout.write(line + "\n"));
+    const alipay = new AlipayClient({
+      sessionId: this.alipaySessionId,
+      configDir: this.configDir
+    });
+    const result = await alipay.pay402({
+      resourceUrl: executeUrl,
+      requirement,
+      method: "POST",
+      data: bodyJson,
+      onLine,
+      onPaymentPending: options.onPaymentPending,
+      timeoutMs: options.timeoutMs,
+      signal: options.signal
+    });
+    try {
+      const json = JSON.parse(result.body);
+      return json.result ?? json;
+    } catch {
+      return { body: result.body, payment: result.payment, media: result.media };
+    }
+  }
+  /**
+   * Pay for a service over the WeChat Pay Native fiat rail (2.1.0).
+   *
+   * Mirrors {@link payViaAlipay} and needs no EVM wallet. The server placed the
+   * Native order when it built the 402, so its `wechatpay-native` accepts[]
+   * entry already carries `extra.code_url` + `extra.out_trade_no`. Flow: hit the
+   * resource to get the 402, confirm the server offers the wechat rail, surface
+   * the code_url (caller renders a QR), then poll the resource with the
+   * out_trade_no proof until the server verifies the order paid and delivers.
+   */
+  async payViaWechat(serverUrl, service, params, options) {
+    const session = await this.startWechatPayment(serverUrl, service, params, options);
+    const wechat = new WechatClient({ configDir: this.configDir });
+    const result = await wechat.pollSession(session.paymentSessionId, {
+      timeoutMs: options.timeoutMs,
+      signal: options.signal
+    });
+    if (result.status !== "completed") {
+      throw new Error(result.lastError || `WeChat payment ended with status ${result.status}`);
+    }
+    try {
+      const json = JSON.parse(result.resultBody ?? "");
+      return json.result ?? json;
+    } catch {
+      return { body: result.resultBody ?? "" };
+    }
+  }
+  /**
+   * The ethers wallet used to sign balance-rail deductions: the client's EVM
+   * wallet if it has one, else a per-configDir identity key persisted at
+   * `<configDir>/balance-identity.key` (0600) so a balance-only client works
+   * without a full crypto wallet. Under `agent 统一代付`, one key spends every
+   * account the agent tops up.
+   */
+  balanceSigner() {
+    if (this.wallet) return this.wallet;
+    const p = join4(this.configDir, "balance-identity.key");
+    let pk;
+    if (existsSync2(p)) {
+      pk = readFileSync3(p, "utf-8").trim();
+    } else {
+      mkdirSync3(this.configDir, { recursive: true });
+      pk = Wallet2.createRandom().privateKey;
+      writeFileSync3(p, pk, { mode: 384 });
+    }
+    return new Wallet2(pk);
+  }
+  /** The balance-rail spending signer address (lowercase 0x…). Stable per
+   *  configDir; this is the identity the server TOFU-binds and later verifies. */
+  getBalanceSignerAddress() {
+    return this.balanceSigner().address.toLowerCase();
+  }
+  /** The buyer id for the balance rail: explicit option > persisted config. */
+  resolveBuyerId(explicit) {
+    const buyerId = explicit ?? this.config.buyerId;
+    if (!buyerId) {
+      throw new Error(
+        "Balance rail needs a buyer id. Pass { buyerId } or persist one with setBuyerId()."
+      );
+    }
+    return buyerId;
+  }
+  /**
+   * Pay via the custodial balance rail (2.2.0, password-free).
+   *
+   * No wallet, no QR: the request carries `{buyer_id, request_id}` in the
+   * X-Payment payload and the server deducts the prepaid balance atomically
+   * before running the skill. The client-generated `request_id` makes the
+   * charge idempotent — a network retry can never double-deduct.
+   */
+  async payViaBalance(serverUrl, service, params, options) {
+    const buyerId = this.resolveBuyerId(options.buyerId);
+    let attempt = await this.balanceDeduct(serverUrl, service, params, options, buyerId);
+    if (attempt.ok) return attempt.result;
+    const fundable = attempt.status === 402 && (attempt.code === "buyer_not_found" || attempt.code === "insufficient_balance" || /insufficient balance|unknown buyer|top up first/i.test(attempt.error || ""));
+    if (!fundable || options.autoTopup === false) {
+      throw new Error(attempt.error || `Balance payment failed with HTTP ${attempt.status}`);
+    }
+    if (options.topupMode === "manual") {
+      const order = await this.createBalanceTopupOrder(serverUrl, {
+        pack: options.topupPack,
+        buyerId,
+        context: { service }
+      });
+      options.onTopupRequired?.(order.pack, order.codeUrl);
+      return {
+        status: "topup_required",
+        out_trade_no: order.outTradeNo,
+        code_url: order.codeUrl,
+        pack: order.pack,
+        server_url: serverUrl
+      };
+    }
+    const credited = await this.topupBalancePack(serverUrl, {
+      pack: options.topupPack,
+      buyerId,
+      pollIntervalMs: options.topupPollIntervalMs,
+      signal: options.signal,
+      onCodeUrl: (pack, codeUrl) => options.onTopupRequired?.(pack, codeUrl)
+    });
+    options.onTopupCredited?.(credited.balance);
+    attempt = await this.balanceDeduct(serverUrl, service, params, options, buyerId);
+    if (attempt.ok) return attempt.result;
+    throw new Error(attempt.error || "Balance payment failed after top-up");
+  }
+  /** One password-free deduct attempt. Never throws on an HTTP error; the
+   *  caller inspects `{ ok, status, error }` to decide whether to auto-fund. */
+  async balanceDeduct(serverUrl, service, params, options, buyerId) {
+    let executeUrl = `${serverUrl}/execute`;
+    try {
+      const services = await this.getServices(serverUrl);
+      const svc = services.services?.find((s) => s.id === service);
+      if (svc?.endpoint) executeUrl = `${serverUrl}${svc.endpoint}`;
+    } catch {
+    }
+    const requestBody = options.rawData ? { service, ...params } : { service, params };
+    const requestId = randomUUID3();
+    const timestamp = Math.floor(Date.now() / 1e3);
+    const signature = await this.balanceSigner().signMessage(
+      buildDeductMessage({ buyerId, requestId, service, timestamp })
+    );
+    const xPayment = Buffer.from(JSON.stringify({
+      x402Version: 2,
+      scheme: BALANCE_RAIL,
+      network: BALANCE_RAIL,
+      payload: { buyer_id: buyerId, request_id: requestId, auth: { timestamp, signature } }
+    })).toString("base64");
+    const res = await fetch(executeUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Payment": xPayment },
+      body: JSON.stringify(requestBody),
+      signal: options.signal
+    });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) return { ok: false, status: res.status, error: data.error, code: data.code };
+    return { ok: true, status: res.status, result: data.result ?? data };
+  }
+  /**
+   * Non-blocking: POST /balance/topup/order, persist a recoverable session, and
+   * return at once (no polling). Use with {@link confirmBalanceTopup} for
+   * turn-based agents; the blocking {@link topupBalancePack} is built on this.
+   */
+  async createBalanceTopupOrder(serverUrl, opts = {}) {
+    const id = this.resolveBuyerId(opts.buyerId);
+    const orderRes = await fetch(`${serverUrl}/balance/topup/order`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      // Carry the spending signer so the server binds it to the account on
+      // confirm (topup-time binding). The same key signs deductions later.
+      body: JSON.stringify({ buyer_id: id, pack: opts.pack, signer_address: this.getBalanceSignerAddress() })
+    });
+    const order = await orderRes.json().catch(() => ({}));
+    if (!orderRes.ok) throw new Error(order.error || `Top-up order failed with HTTP ${orderRes.status}`);
+    const maxTimeoutSeconds = order.max_timeout_seconds ?? 300;
+    const now = Date.now();
+    this.saveBalanceTopupSession({
+      out_trade_no: order.out_trade_no,
+      buyer_id: id,
+      pack: order.pack,
+      server_url: serverUrl,
+      code_url: order.code_url,
+      status: "pending",
+      created_at: new Date(now).toISOString(),
+      expires_at: new Date(now + maxTimeoutSeconds * 1e3).toISOString(),
+      context: opts.context
+    });
+    return { outTradeNo: order.out_trade_no, codeUrl: order.code_url, pack: order.pack, maxTimeoutSeconds };
+  }
+  /**
+   * One-shot: POST /balance/topup/confirm for a single order. No polling.
+   * Updates the persisted session on credit. `serverUrl` defaults to the one
+   * recorded in the session (recover by out_trade_no alone).
+   */
+  async confirmBalanceTopup(outTradeNo, opts = {}) {
+    const session = this.getBalanceTopupSession(outTradeNo);
+    const serverUrl = opts.serverUrl || session?.server_url;
+    if (!serverUrl) {
+      return { credited: false, reason: `No server URL for ${outTradeNo}: pass serverUrl or run topup-order first` };
+    }
+    const confRes = await fetch(`${serverUrl}/balance/topup/confirm`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ out_trade_no: outTradeNo })
+    });
+    const conf = await confRes.json().catch(() => ({}));
+    if (!confRes.ok) return { credited: false, reason: conf.error || `Confirm failed with HTTP ${confRes.status}` };
+    if (conf.credited) {
+      if (session) {
+        session.status = "credited";
+        session.tx_id = conf.tx_id;
+        session.balance = conf.balance;
+        this.saveBalanceTopupSession(session);
+      }
+      return { credited: true, balance: conf.balance, txId: conf.tx_id };
+    }
+    return { credited: false, pending: !!conf.pending, reason: conf.reason };
+  }
+  /**
+   * Blocking terminal wrapper: create the order then poll confirm until the
+   * scan is credited (or the order expires). Built on
+   * {@link createBalanceTopupOrder} + {@link confirmBalanceTopup}.
+   */
+  async topupBalancePack(serverUrl, opts = {}) {
+    const order = await this.createBalanceTopupOrder(serverUrl, { pack: opts.pack, buyerId: opts.buyerId });
+    opts.onCodeUrl?.(order.pack, order.codeUrl);
+    const interval = opts.pollIntervalMs ?? 2e3;
+    const deadline = Date.now() + order.maxTimeoutSeconds * 1e3;
+    while (Date.now() < deadline) {
+      if (opts.signal?.aborted) throw new Error("Top-up aborted");
+      const conf = await this.confirmBalanceTopup(order.outTradeNo, { serverUrl });
+      if (conf.credited) return { balance: conf.balance, outTradeNo: order.outTradeNo, txId: conf.txId };
+      await this.sleep(interval, opts.signal);
+    }
+    throw new Error("Top-up timed out before the payment was confirmed");
+  }
+  // --- Recoverable balance top-up sessions (<configDir>/balance-topup-sessions) ---
+  balanceTopupSessionDir() {
+    return join4(this.configDir, "balance-topup-sessions");
+  }
+  saveBalanceTopupSession(session) {
+    const dir = this.balanceTopupSessionDir();
+    mkdirSync3(dir, { recursive: true });
+    writeFileSync3(join4(dir, `${session.out_trade_no}.json`), JSON.stringify(session, null, 2));
+  }
+  /** Read a persisted top-up session by out_trade_no, or null. */
+  getBalanceTopupSession(outTradeNo) {
+    const p = join4(this.balanceTopupSessionDir(), `${outTradeNo}.json`);
+    if (!existsSync2(p)) return null;
+    try {
+      return JSON.parse(readFileSync3(p, "utf-8"));
+    } catch {
+      return null;
+    }
+  }
+  /** List persisted top-up sessions, newest first. */
+  listBalanceTopupSessions() {
+    const dir = this.balanceTopupSessionDir();
+    if (!existsSync2(dir)) return [];
+    return readdirSync2(dir).filter((f) => f.endsWith(".json")).map((f) => {
+      try {
+        return JSON.parse(readFileSync3(join4(dir, f), "utf-8"));
+      } catch {
+        return null;
+      }
+    }).filter((s) => s !== null).sort((a, b) => (b.created_at || "").localeCompare(a.created_at || ""));
+  }
+  /** Abortable sleep used by the top-up poll loop. */
+  sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+      if (signal?.aborted) return reject(new Error("aborted"));
+      const t = setTimeout(resolve, ms);
+      signal?.addEventListener("abort", () => {
+        clearTimeout(t);
+        reject(new Error("aborted"));
+      }, { once: true });
+    });
+  }
+  /** Persist the buyer id used by the balance rail (bearer semantics). */
+  setBuyerId(buyerId) {
+    this.config.buyerId = buyerId;
+    this.saveConfig();
+  }
+  /** GET /balance — custodial balance, limits, and today's spend for a buyer. */
+  async getBuyerBalance(serverUrl, buyerId) {
+    const id = this.resolveBuyerId(buyerId);
+    const res = await fetch(`${serverUrl}/balance?buyer_id=${encodeURIComponent(id)}`);
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) throw new Error(data.error || `Balance query failed with HTTP ${res.status}`);
+    return data;
+  }
+  /**
+   * POST /balance/topup — report an externally settled payment (on-chain
+   * tx hash / Alipay trade_no / WeChat out_trade_no) so the server verifies
+   * and credits the ledger. Idempotent per reference.
+   */
+  async topupBalance(serverUrl, opts) {
+    const id = this.resolveBuyerId(opts.buyerId);
+    const res = await fetch(`${serverUrl}/balance/topup`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        buyer_id: id,
+        rail: opts.rail,
+        amount: opts.amount,
+        tx_hash: opts.txHash,
+        chain: opts.chain,
+        trade_no: opts.tradeNo,
+        out_trade_no: opts.outTradeNo
+      })
+    });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) throw new Error(data.error || `Top-up failed with HTTP ${res.status}`);
+    return data;
+  }
+  /** GET /balance/transactions — ledger history for a buyer, newest first. */
+  async listBalanceTransactions(serverUrl, opts = {}) {
+    const id = this.resolveBuyerId(opts.buyerId);
+    const qs = new URLSearchParams({ buyer_id: id });
+    if (opts.limit) qs.set("limit", String(opts.limit));
+    if (opts.offset) qs.set("offset", String(opts.offset));
+    const res = await fetch(`${serverUrl}/balance/transactions?${qs}`);
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) throw new Error(data.error || `Transaction query failed with HTTP ${res.status}`);
+    return data;
+  }
+  /**
+   * Start a recoverable WeChat Pay Native session and return immediately with
+   * QR metadata. The SDK client persists enough context to poll/fulfill later.
+   */
+  async startWechatPayment(serverUrl, service, params, options = {}) {
+    let executeUrl = `${serverUrl}/execute`;
+    try {
+      const services = await this.getServices(serverUrl);
+      const svc = services.services?.find((s) => s.id === service);
+      if (svc?.endpoint) executeUrl = `${serverUrl}${svc.endpoint}`;
+    } catch {
+    }
+    const requestBody = options.rawData ? { service, ...params } : { service, params };
+    const bodyJson = JSON.stringify(requestBody);
+    const res = await fetch(executeUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: bodyJson
+    });
+    if (res.status !== 402) {
+      const data = await res.json().catch(() => ({}));
+      if (res.ok && data.result) return data.result;
+      throw new Error(data.error || `Expected 402, got ${res.status}`);
+    }
+    const header = res.headers.get(PAYMENT_REQUIRED_HEADER);
+    if (!header) throw new Error("Missing x-payment-required header on 402");
+    const parsed = JSON.parse(Buffer.from(header, "base64").toString("utf-8"));
+    const accepts = Array.isArray(parsed) ? parsed : parsed.accepts ?? [parsed];
+    const { requirement } = selectRail({
+      serverAccepts: accepts,
+      explicitRail: WECHAT_RAIL,
+      preference: this.railPreference,
+      availability: { evmReady: this.isInitialized }
+    });
+    const wechat = new WechatClient({ configDir: this.configDir });
+    const session = wechat.start402({
+      resourceUrl: executeUrl,
+      requirement,
+      method: "POST",
+      data: bodyJson,
+      onPaymentPending: options.onPaymentPending ? (info) => options.onPaymentPending({ paymentUrl: info.codeUrl, tradeNo: info.outTradeNo }) : void 0,
+      timeoutMs: options.timeoutMs,
+      signal: options.signal,
+      context: {
+        serverUrl,
+        service,
+        params,
+        rawData: options.rawData ?? false,
+        rail: WECHAT_RAIL
+      }
+    });
+    if (options.autoPoll || options.onWechatPaymentCompleted || options.onWechatPaymentFailed) {
+      void wechat.pollSession(session.paymentSessionId, {
+        timeoutMs: options.timeoutMs,
+        signal: options.signal
+      }).then(async (finalSession) => {
+        if (finalSession.status === "completed") {
+          await options.onWechatPaymentCompleted?.(finalSession);
+        } else {
+          await options.onWechatPaymentFailed?.(finalSession);
+        }
+      }).catch(async (error) => {
+        const failed = await wechat.fulfill(session.paymentSessionId).catch(() => ({
+          ...session,
+          status: "failed",
+          lastError: error instanceof Error ? error.message : String(error)
+        }));
+        await options.onWechatPaymentFailed?.(failed);
+      });
+    }
+    return session;
+  }
+  /** Query a persisted WeChat session once. */
+  async getWechatPaymentStatus(identifier) {
+    return new WechatClient({ configDir: this.configDir }).status(identifier);
+  }
+  /** Idempotently fulfill a paid WeChat session, returning stored or fetched result. */
+  async fulfillWechatPayment(identifier) {
+    return new WechatClient({ configDir: this.configDir }).fulfill(identifier);
+  }
+  /** Mark a local WeChat session as cancelled. */
+  cancelWechatPayment(identifier) {
+    return new WechatClient({ configDir: this.configDir }).cancel(identifier);
+  }
+  /** List persisted WeChat sessions, newest first. */
+  listWechatPaymentSessions() {
+    return new WechatClient({ configDir: this.configDir }).listSessions();
+  }
   /**
    * Handle MPP (Machine Payments Protocol) payment flow
    * Called when pay() detects WWW-Authenticate header in 402 response
@@ -846,14 +2263,14 @@ Please specify: --chain <chain_name>`
   async handleBNBPayment(executeUrl, service, params, paymentDetails, options = {}) {
     const { to, amount, token, chainName, chain, spender } = paymentDetails;
     const tokenConfig = chain.tokens[token];
-    const provider = new ethers2.JsonRpcProvider(chain.rpc);
+    const provider = new ethers3.JsonRpcProvider(chain.rpc);
     const allowance = await this.checkAllowance(tokenConfig.address, spender, provider);
     const amountWeiCheck = BigInt(Math.floor(amount * 10 ** tokenConfig.decimals));
     if (allowance < amountWeiCheck) {
       const nativeBalance = await provider.getBalance(this.wallet.address);
-      const minGasBalance = ethers2.parseEther("0.0005");
+      const minGasBalance = ethers3.parseEther("0.0005");
       if (nativeBalance < minGasBalance) {
-        const nativeBNB = parseFloat(ethers2.formatEther(nativeBalance)).toFixed(4);
+        const nativeBNB = parseFloat(ethers3.formatEther(nativeBalance)).toFixed(4);
         const isTestnet = chainName === "bnb_testnet";
         if (isTestnet) {
           throw new Error(
@@ -1026,7 +2443,7 @@ Run: npx moltspay approve --chain ${chainName} --spender ${spender}`
    * Check ERC20 allowance for a spender
    */
   async checkAllowance(tokenAddress, spender, provider) {
-    const contract = new ethers2.Contract(
+    const contract = new ethers3.Contract(
       tokenAddress,
       ["function allowance(address owner, address spender) view returns (uint256)"],
       provider
@@ -1045,7 +2462,7 @@ Run: npx moltspay approve --chain ${chainName} --spender ${spender}`
   async signEIP3009(to, amount, chain, token = "USDC", domainOverride) {
     const tokenConfig = chain.tokens[token];
     const value = BigInt(Math.floor(amount * 10 ** tokenConfig.decimals)).toString();
-    const nonce = ethers2.hexlify(ethers2.randomBytes(32));
+    const nonce = ethers3.hexlify(ethers3.randomBytes(32));
     const tokenName = domainOverride?.name || tokenConfig.eip712Name || (token === "USDC" ? "USD Coin" : "Tether USD");
     const tokenVersion = domainOverride?.version || "2";
     const envelope = buildEIP3009TypedData({
@@ -1091,26 +2508,26 @@ Run: npx moltspay approve --chain ${chainName} --spender ${spender}`
   }
   // --- Config & Wallet Management ---
   loadConfig() {
-    const configPath = join2(this.configDir, "config.json");
+    const configPath = join4(this.configDir, "config.json");
     if (existsSync2(configPath)) {
-      const content = readFileSync2(configPath, "utf-8");
+      const content = readFileSync3(configPath, "utf-8");
       return { ...DEFAULT_CONFIG, ...JSON.parse(content) };
     }
     return { ...DEFAULT_CONFIG };
   }
   saveConfig() {
-    mkdirSync2(this.configDir, { recursive: true });
-    const configPath = join2(this.configDir, "config.json");
-    writeFileSync2(configPath, JSON.stringify(this.config, null, 2));
+    mkdirSync3(this.configDir, { recursive: true });
+    const configPath = join4(this.configDir, "config.json");
+    writeFileSync3(configPath, JSON.stringify(this.config, null, 2));
   }
   /**
    * Load spending data from disk
    */
   loadSpending() {
-    const spendingPath = join2(this.configDir, "spending.json");
+    const spendingPath = join4(this.configDir, "spending.json");
     if (existsSync2(spendingPath)) {
       try {
-        const data = JSON.parse(readFileSync2(spendingPath, "utf-8"));
+        const data = JSON.parse(readFileSync3(spendingPath, "utf-8"));
         const today = (/* @__PURE__ */ new Date()).setHours(0, 0, 0, 0);
         if (data.date && data.date === today) {
           this.todaySpending = data.amount || 0;
@@ -1129,17 +2546,17 @@ Run: npx moltspay approve --chain ${chainName} --spender ${spender}`
    * Save spending data to disk
    */
   saveSpending() {
-    mkdirSync2(this.configDir, { recursive: true });
-    const spendingPath = join2(this.configDir, "spending.json");
+    mkdirSync3(this.configDir, { recursive: true });
+    const spendingPath = join4(this.configDir, "spending.json");
     const data = {
       date: this.lastSpendingReset || (/* @__PURE__ */ new Date()).setHours(0, 0, 0, 0),
       amount: this.todaySpending,
       updatedAt: Date.now()
     };
-    writeFileSync2(spendingPath, JSON.stringify(data, null, 2));
+    writeFileSync3(spendingPath, JSON.stringify(data, null, 2));
   }
   loadWallet() {
-    const walletPath = join2(this.configDir, "wallet.json");
+    const walletPath = join4(this.configDir, "wallet.json");
     if (existsSync2(walletPath)) {
       if (process.platform !== "win32") {
         try {
@@ -1153,7 +2570,7 @@ Run: npx moltspay approve --chain ${chainName} --spender ${spender}`
         } catch {
         }
       }
-      const content = readFileSync2(walletPath, "utf-8");
+      const content = readFileSync3(walletPath, "utf-8");
       return JSON.parse(content);
     }
     return null;
@@ -1162,15 +2579,15 @@ Run: npx moltspay approve --chain ${chainName} --spender ${spender}`
    * Initialize a new wallet (called by CLI)
    */
   static init(configDir, options) {
-    mkdirSync2(configDir, { recursive: true });
+    mkdirSync3(configDir, { recursive: true });
     const wallet = Wallet2.createRandom();
     const walletData = {
       address: wallet.address,
       privateKey: wallet.privateKey,
       createdAt: Date.now()
     };
-    const walletPath = join2(configDir, "wallet.json");
-    writeFileSync2(walletPath, JSON.stringify(walletData, null, 2), { mode: 384 });
+    const walletPath = join4(configDir, "wallet.json");
+    writeFileSync3(walletPath, JSON.stringify(walletData, null, 2), { mode: 384 });
     const config = {
       chain: options.chain,
       limits: {
@@ -1178,8 +2595,8 @@ Run: npx moltspay approve --chain ${chainName} --spender ${spender}`
         maxPerDay: options.maxPerDay
       }
     };
-    const configPath = join2(configDir, "config.json");
-    writeFileSync2(configPath, JSON.stringify(config, null, 2));
+    const configPath = join4(configDir, "config.json");
+    writeFileSync3(configPath, JSON.stringify(config, null, 2));
     return { address: wallet.address, configDir };
   }
   /**
@@ -1195,17 +2612,17 @@ Run: npx moltspay approve --chain ${chainName} --spender ${spender}`
     } catch {
       throw new Error(`Unknown chain: ${this.config.chain}`);
     }
-    const provider = new ethers2.JsonRpcProvider(chain.rpc);
+    const provider = new ethers3.JsonRpcProvider(chain.rpc);
     const tokenAbi = ["function balanceOf(address) view returns (uint256)"];
     const [nativeBalance, usdcBalance, usdtBalance] = await Promise.all([
       provider.getBalance(this.wallet.address),
-      new ethers2.Contract(chain.tokens.USDC.address, tokenAbi, provider).balanceOf(this.wallet.address),
-      new ethers2.Contract(chain.tokens.USDT.address, tokenAbi, provider).balanceOf(this.wallet.address)
+      new ethers3.Contract(chain.tokens.USDC.address, tokenAbi, provider).balanceOf(this.wallet.address),
+      new ethers3.Contract(chain.tokens.USDT.address, tokenAbi, provider).balanceOf(this.wallet.address)
     ]);
     return {
-      usdc: parseFloat(ethers2.formatUnits(usdcBalance, chain.tokens.USDC.decimals)),
-      usdt: parseFloat(ethers2.formatUnits(usdtBalance, chain.tokens.USDT.decimals)),
-      native: parseFloat(ethers2.formatEther(nativeBalance))
+      usdc: parseFloat(ethers3.formatUnits(usdcBalance, chain.tokens.USDC.decimals)),
+      usdt: parseFloat(ethers3.formatUnits(usdtBalance, chain.tokens.USDT.decimals)),
+      native: parseFloat(ethers3.formatEther(nativeBalance))
     };
   }
   /**
@@ -1228,38 +2645,38 @@ Run: npx moltspay approve --chain ${chainName} --spender ${spender}`
       supportedChains.map(async (chainName) => {
         try {
           const chain = getChain(chainName);
-          const provider = new ethers2.JsonRpcProvider(chain.rpc);
+          const provider = new ethers3.JsonRpcProvider(chain.rpc);
           if (chainName === "tempo_moderato") {
             const [nativeBalance, pathUSD, alphaUSD, betaUSD, thetaUSD] = await Promise.all([
               provider.getBalance(this.wallet.address),
-              new ethers2.Contract(tempoTokens.pathUSD, tokenAbi, provider).balanceOf(this.wallet.address),
-              new ethers2.Contract(tempoTokens.alphaUSD, tokenAbi, provider).balanceOf(this.wallet.address),
-              new ethers2.Contract(tempoTokens.betaUSD, tokenAbi, provider).balanceOf(this.wallet.address),
-              new ethers2.Contract(tempoTokens.thetaUSD, tokenAbi, provider).balanceOf(this.wallet.address)
+              new ethers3.Contract(tempoTokens.pathUSD, tokenAbi, provider).balanceOf(this.wallet.address),
+              new ethers3.Contract(tempoTokens.alphaUSD, tokenAbi, provider).balanceOf(this.wallet.address),
+              new ethers3.Contract(tempoTokens.betaUSD, tokenAbi, provider).balanceOf(this.wallet.address),
+              new ethers3.Contract(tempoTokens.thetaUSD, tokenAbi, provider).balanceOf(this.wallet.address)
             ]);
             results[chainName] = {
-              usdc: parseFloat(ethers2.formatUnits(pathUSD, 6)),
+              usdc: parseFloat(ethers3.formatUnits(pathUSD, 6)),
               // pathUSD as default USDC
-              usdt: parseFloat(ethers2.formatUnits(alphaUSD, 6)),
+              usdt: parseFloat(ethers3.formatUnits(alphaUSD, 6)),
               // alphaUSD as default USDT
-              native: parseFloat(ethers2.formatEther(nativeBalance)),
+              native: parseFloat(ethers3.formatEther(nativeBalance)),
               tempo: {
-                pathUSD: parseFloat(ethers2.formatUnits(pathUSD, 6)),
-                alphaUSD: parseFloat(ethers2.formatUnits(alphaUSD, 6)),
-                betaUSD: parseFloat(ethers2.formatUnits(betaUSD, 6)),
-                thetaUSD: parseFloat(ethers2.formatUnits(thetaUSD, 6))
+                pathUSD: parseFloat(ethers3.formatUnits(pathUSD, 6)),
+                alphaUSD: parseFloat(ethers3.formatUnits(alphaUSD, 6)),
+                betaUSD: parseFloat(ethers3.formatUnits(betaUSD, 6)),
+                thetaUSD: parseFloat(ethers3.formatUnits(thetaUSD, 6))
               }
             };
           } else {
             const [nativeBalance, usdcBalance, usdtBalance] = await Promise.all([
               provider.getBalance(this.wallet.address),
-              new ethers2.Contract(chain.tokens.USDC.address, tokenAbi, provider).balanceOf(this.wallet.address),
-              new ethers2.Contract(chain.tokens.USDT.address, tokenAbi, provider).balanceOf(this.wallet.address)
+              new ethers3.Contract(chain.tokens.USDC.address, tokenAbi, provider).balanceOf(this.wallet.address),
+              new ethers3.Contract(chain.tokens.USDT.address, tokenAbi, provider).balanceOf(this.wallet.address)
             ]);
             results[chainName] = {
-              usdc: parseFloat(ethers2.formatUnits(usdcBalance, chain.tokens.USDC.decimals)),
-              usdt: parseFloat(ethers2.formatUnits(usdtBalance, chain.tokens.USDT.decimals)),
-              native: parseFloat(ethers2.formatEther(nativeBalance))
+              usdc: parseFloat(ethers3.formatUnits(usdcBalance, chain.tokens.USDC.decimals)),
+              usdt: parseFloat(ethers3.formatUnits(usdtBalance, chain.tokens.USDT.decimals)),
+              native: parseFloat(ethers3.formatEther(nativeBalance))
             };
           }
         } catch (err) {
@@ -1386,6 +2803,7 @@ Run: npx moltspay approve --chain ${chainName} --spender ${spender}`
   }
 };
 export {
-  MoltsPayClient
+  MoltsPayClient,
+  WechatClient
 };
 //# sourceMappingURL=index.mjs.map