@ar-agents/treasury 0.2.0

package/dist/index.js

@@ -0,0 +1,808 @@
+// src/manteca.ts
+var MantecaApiError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "MantecaApiError";
+  }
+  status;
+  body;
+};
+var MantecaAuthError = class extends MantecaApiError {
+  constructor(message, status, body) {
+    super(message, status, body);
+    this.name = "MantecaAuthError";
+  }
+};
+var MantecaRateLimitError = class extends MantecaApiError {
+  constructor(message, status, body) {
+    super(message, status, body);
+    this.name = "MantecaRateLimitError";
+  }
+};
+var DEFAULT_BASE_URL = "https://api.manteca.dev";
+function num(v) {
+  if (typeof v === "number" && Number.isFinite(v)) return v;
+  if (typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v))) {
+    return Number(v);
+  }
+  return void 0;
+}
+function parseDirectPrice(body, ticker) {
+  const fromObj = (o) => {
+    const direct = num(o);
+    if (direct !== void 0) return direct;
+    if (o && typeof o === "object") {
+      const rec = o;
+      for (const k of ["sell", "bid", "price", "ask", "buy", "value", "rate"]) {
+        const v = num(rec[k]);
+        if (v !== void 0) return v;
+      }
+    }
+    return void 0;
+  };
+  const env = body;
+  return fromObj(env?.[ticker]) ?? fromObj(body);
+}
+function normalizeMantecaStatus(raw) {
+  const s = (raw ?? "").toUpperCase();
+  if (["COMPLETED", "COMPLETE", "DONE", "SETTLED", "SUCCESS", "FINISHED"].includes(s))
+    return "COMPLETED";
+  if (["FAILED", "FAILURE", "ERROR", "REJECTED", "CANCELLED", "CANCELED"].includes(s))
+    return "FAILED";
+  if (["PROCESSING", "IN_PROGRESS", "INPROGRESS", "RUNNING", "PARTIAL"].includes(s))
+    return "PROCESSING";
+  if (["PENDING", "CREATED", "NEW", "QUEUED", "WAITING"].includes(s)) return "PENDING";
+  return "UNKNOWN";
+}
+var MantecaOffRampAdapter = class {
+  constructor(config) {
+    this.config = config;
+    if (!config.apiKey) throw new Error("MantecaConfig.apiKey is required");
+    if (!config.userId) throw new Error("MantecaConfig.userId is required");
+    if (!config.bankAccountId)
+      throw new Error("MantecaConfig.bankAccountId is required");
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.sellAsset = config.sellAsset ?? "USDC";
+    this.fiatAsset = config.fiatAsset ?? "ARS";
+    this.ticker = config.ticker ?? `${this.sellAsset}_${this.fiatAsset}`;
+    const f = config.fetchImpl ?? globalThis.fetch;
+    if (!f) throw new Error("no fetch available; pass MantecaConfig.fetchImpl");
+    this.fetchImpl = f;
+    this.now = config.now ?? Date.now;
+  }
+  config;
+  baseUrl;
+  sellAsset;
+  fiatAsset;
+  ticker;
+  fetchImpl;
+  now;
+  async request(method, path, body) {
+    const init = {
+      method,
+      headers: {
+        "md-api-key": this.config.apiKey,
+        "content-type": "application/json",
+        accept: "application/json"
+      }
+    };
+    if (body !== void 0) init.body = JSON.stringify(body);
+    let res;
+    try {
+      res = await this.fetchImpl(`${this.baseUrl}${path}`, init);
+    } catch (cause) {
+      throw new MantecaApiError(
+        `manteca ${method} ${path} transport error: ${String(cause)}`,
+        0
+      );
+    }
+    const text = await res.text();
+    let parsed = void 0;
+    if (text) {
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        parsed = text;
+      }
+    }
+    if (!res.ok) {
+      const msg = `manteca ${method} ${path} -> ${res.status}`;
+      if (res.status === 401 || res.status === 403)
+        throw new MantecaAuthError(msg, res.status, parsed);
+      if (res.status === 429)
+        throw new MantecaRateLimitError(msg, res.status, parsed);
+      throw new MantecaApiError(msg, res.status, parsed);
+    }
+    return parsed;
+  }
+  /** Quote a USDC->ARS off-ramp using the direct sell-side price. */
+  async quote(amountUsd) {
+    const body = await this.request(
+      "GET",
+      `/v2/prices/direct/${encodeURIComponent(this.ticker)}`
+    );
+    const rate = parseDirectPrice(body, this.ticker);
+    if (rate === void 0 || rate <= 0) {
+      throw new MantecaApiError(
+        `manteca: could not parse a sell price for ${this.ticker}`,
+        200,
+        body
+      );
+    }
+    return { amountUsd, arsOut: amountUsd * rate, rate, spread: 0 };
+  }
+  /**
+   * Fire the off-ramp synthetic: sell `amountUsd` of crypto and withdraw the ARS
+   * to the configured CVU. IRREVERSIBLE — gate behind requireConfirmation (RFC-001)
+   * and write to the signed audit log. Returns immediately with the synthetic id;
+   * the ARS settles asynchronously (poll getStatus). `arsReceived` is the EXPECTED
+   * amount at submission (from a fresh quote); the settled figure comes from getStatus.
+   */
+  async convert(amountUsd, opts) {
+    if (!opts?.externalId)
+      throw new Error("MantecaOffRampAdapter.convert: externalId (idempotency key) is required");
+    const q = await this.quote(amountUsd);
+    const externalId = opts.externalId;
+    const synthetic = await this.request(
+      "POST",
+      "/v2/synthetics/ramp-off",
+      {
+        userId: this.config.userId,
+        sellAmount: String(amountUsd),
+        sellAsset: this.sellAsset,
+        withdrawAsset: this.fiatAsset,
+        bankAccountId: this.config.bankAccountId,
+        externalId
+      }
+    );
+    const txId = synthetic.id ?? synthetic._id;
+    if (!txId) {
+      throw new MantecaApiError(
+        "manteca ramp-off: response had no synthetic id",
+        200,
+        synthetic
+      );
+    }
+    return { amountUsd, arsReceived: q.arsOut, rate: q.rate, txId };
+  }
+  /** Poll a ramp-off synthetic and normalize its settlement state. */
+  async getStatus(txId) {
+    const body = await this.request(
+      "GET",
+      `/v2/synthetics/${encodeURIComponent(txId)}`
+    );
+    const rawStatus = typeof body.status === "string" && body.status || typeof body.state === "string" && body.state || void 0;
+    const arsSettled = num(body.withdrawAmount) ?? num(body.fiatAmount) ?? num(body.arsAmount) ?? void 0;
+    const report = {
+      txId,
+      status: normalizeMantecaStatus(rawStatus)
+    };
+    if (rawStatus !== void 0) report.raw = rawStatus;
+    if (arsSettled !== void 0) report.arsSettled = arsSettled;
+    return report;
+  }
+  /**
+   * One-time onboarding helper: register the society's CBU/CVU/alias as a payout
+   * destination. The Manteca user must have `legalId` set first. Returns the
+   * created account id to use as `bankAccountId`.
+   */
+  async registerBankAccount(input) {
+    const body = await this.request(
+      "POST",
+      "/v2/onboarding-actions/add-bank-account",
+      {
+        userId: this.config.userId,
+        accountNumber: input.cbuOrCvuOrAlias,
+        description: input.label ?? "Sociedad Automatizada CVU"
+      }
+    );
+    const id = typeof body.id === "string" && body.id || typeof body._id === "string" && body._id || typeof body.bankAccountId === "string" && body.bankAccountId || "";
+    return { bankAccountId: id, raw: body };
+  }
+};
+
+// src/ripio.ts
+var RIPIO_SANDBOX = "https://sandbox-b2b.ripio.com";
+var RIPIO_PROD = "https://b2b-api.ripio.com";
+var RipioApiError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "RipioApiError";
+  }
+  status;
+  body;
+};
+var RipioAuthError = class extends RipioApiError {
+  constructor(message, status, body) {
+    super(message, status, body);
+    this.name = "RipioAuthError";
+  }
+};
+var RipioRateLimitError = class extends RipioApiError {
+  constructor(message, status, body) {
+    super(message, status, body);
+    this.name = "RipioRateLimitError";
+  }
+};
+function num2(v) {
+  if (typeof v === "number" && Number.isFinite(v)) return v;
+  if (typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v))) return Number(v);
+  return void 0;
+}
+function normalizeRipioStatus(raw) {
+  const s = (raw ?? "").toUpperCase();
+  if (["COMPLETED", "COMPLETE", "DONE", "SETTLED", "SUCCESS", "FINISHED", "PAID"].includes(s))
+    return "COMPLETED";
+  if (["FAILED", "FAILURE", "ERROR", "REJECTED", "CANCELLED", "CANCELED", "EXPIRED"].includes(s))
+    return "FAILED";
+  if (["PROCESSING", "IN_PROGRESS", "INPROGRESS", "RUNNING", "PARTIAL", "CONFIRMING"].includes(s))
+    return "PROCESSING";
+  if (["PENDING", "CREATED", "NEW", "QUEUED", "WAITING", "OPEN", "AWAITING_DEPOSIT"].includes(s))
+    return "PENDING";
+  return "UNKNOWN";
+}
+var RipioOffRampAdapter = class {
+  constructor(config) {
+    this.config = config;
+    if (!config.clientId || !config.clientSecret)
+      throw new Error("RipioConfig.clientId/clientSecret are required");
+    if (!config.customerId) throw new Error("RipioConfig.customerId is required");
+    if (!config.fiatAccountId) throw new Error("RipioConfig.fiatAccountId is required");
+    this.baseUrl = (config.baseUrl ?? RIPIO_SANDBOX).replace(/\/+$/, "");
+    this.chain = config.chain ?? "BASE";
+    this.fromCurrency = config.fromCurrency ?? "USDC";
+    this.toCurrency = config.toCurrency ?? "ARS";
+    this.paymentMethodType = config.paymentMethodType ?? "bank_transfer";
+    const f = config.fetchImpl ?? globalThis.fetch;
+    if (!f) throw new Error("no fetch available; pass RipioConfig.fetchImpl");
+    this.fetchImpl = f;
+    this.now = config.now ?? Date.now;
+  }
+  config;
+  baseUrl;
+  chain;
+  fromCurrency;
+  toCurrency;
+  paymentMethodType;
+  fetchImpl;
+  now;
+  token = null;
+  async getToken() {
+    const now = this.now();
+    if (this.token && this.token.expiresAtMs > now + 3e4) return this.token.value;
+    const basic = btoa(`${this.config.clientId}:${this.config.clientSecret}`);
+    let res;
+    try {
+      res = await this.fetchImpl(`${this.baseUrl}/oauth2/token/`, {
+        method: "POST",
+        headers: {
+          authorization: `Basic ${basic}`,
+          "content-type": "application/x-www-form-urlencoded",
+          accept: "application/json"
+        },
+        body: "grant_type=client_credentials"
+      });
+    } catch (cause) {
+      throw new RipioApiError(`ripio token transport error: ${String(cause)}`, 0);
+    }
+    const text = await res.text();
+    let parsed = void 0;
+    if (text) {
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        parsed = text;
+      }
+    }
+    if (!res.ok) throw new RipioAuthError(`ripio token -> ${res.status}`, res.status, parsed);
+    const body = parsed;
+    if (!body.access_token) throw new RipioAuthError("ripio token: no access_token", 200, parsed);
+    this.token = {
+      value: body.access_token,
+      expiresAtMs: now + (body.expires_in ?? 3600) * 1e3
+    };
+    return this.token.value;
+  }
+  async request(method, path, body) {
+    const token = await this.getToken();
+    const init = {
+      method,
+      headers: {
+        authorization: `Bearer ${token}`,
+        "content-type": "application/json",
+        accept: "application/json"
+      }
+    };
+    if (body !== void 0) init.body = JSON.stringify(body);
+    let res;
+    try {
+      res = await this.fetchImpl(`${this.baseUrl}${path}`, init);
+    } catch (cause) {
+      throw new RipioApiError(`ripio ${method} ${path} transport error: ${String(cause)}`, 0);
+    }
+    const text = await res.text();
+    let parsed = void 0;
+    if (text) {
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        parsed = text;
+      }
+    }
+    if (!res.ok) {
+      const msg = `ripio ${method} ${path} -> ${res.status}`;
+      if (res.status === 401 || res.status === 403) throw new RipioAuthError(msg, res.status, parsed);
+      if (res.status === 429) throw new RipioRateLimitError(msg, res.status, parsed);
+      throw new RipioApiError(msg, res.status, parsed);
+    }
+    return parsed;
+  }
+  async quote(amountUsd) {
+    const body = await this.request("POST", "/api/v1/quotes/", {
+      fromCurrency: this.fromCurrency,
+      toCurrency: this.toCurrency,
+      fromAmount: String(amountUsd),
+      chain: this.chain,
+      paymentMethodType: this.paymentMethodType
+    });
+    const arsOut = num2(body.finalToAmount) ?? num2(body.toAmount);
+    if (arsOut === void 0 || arsOut <= 0) {
+      throw new RipioApiError("ripio quote: could not parse toAmount", 200, body);
+    }
+    const rate = num2(body.rate) ?? arsOut / amountUsd;
+    return { amountUsd, arsOut, rate, spread: 0 };
+  }
+  /**
+   * Create an off-ramp session for `amountUsd`. Returns a receipt whose
+   * `depositAddress` is where the society must send the USDC to complete the
+   * payout; `txId` is the session id for getStatus. `arsReceived` is the EXPECTED
+   * amount (from a fresh quote); the settled figure comes from getStatus.
+   */
+  async convert(amountUsd, opts) {
+    if (!opts?.externalId)
+      throw new Error("RipioOffRampAdapter.convert: externalId (idempotency key) is required");
+    const q = await this.quote(amountUsd);
+    const session = await this.request(
+      "POST",
+      "/api/v1/offrampSession/",
+      {
+        fiatAccountId: this.config.fiatAccountId,
+        fromCurrency: this.fromCurrency,
+        toCurrency: this.toCurrency,
+        fromAmount: String(amountUsd),
+        chain: this.chain,
+        externalId: opts.externalId
+      }
+    );
+    const txId = typeof session.sessionId === "string" && session.sessionId || typeof session.id === "string" && session.id || "";
+    if (!txId) throw new RipioApiError("ripio offrampSession: no session id", 200, session);
+    const receipt = {
+      amountUsd,
+      arsReceived: q.arsOut,
+      rate: q.rate,
+      txId
+    };
+    const deposit = this.pickDepositAddress(session.depositAddresses);
+    if (deposit) receipt.depositAddress = deposit;
+    return receipt;
+  }
+  pickDepositAddress(raw) {
+    if (!Array.isArray(raw)) return void 0;
+    const entries = raw;
+    const match = entries.find((e) => (e.chain ?? "").toUpperCase() === this.chain.toUpperCase());
+    return (match ?? entries[0])?.address;
+  }
+  async getStatus(txId) {
+    const body = await this.request(
+      "GET",
+      `/api/v1/offrampSession/${encodeURIComponent(txId)}`
+    );
+    const rawStatus = typeof body.status === "string" && body.status || typeof body.state === "string" && body.state || void 0;
+    const arsSettled = num2(body.finalToAmount) ?? num2(body.toAmount) ?? num2(body.arsAmount);
+    const report = {
+      txId,
+      status: normalizeRipioStatus(rawStatus)
+    };
+    if (rawStatus !== void 0) report.raw = rawStatus;
+    if (arsSettled !== void 0) report.arsSettled = arsSettled;
+    return report;
+  }
+  /**
+   * One-time onboarding helper: register the society's CBU/CVU/alias as a fiat
+   * account payout destination. Returns the id to use as `fiatAccountId`.
+   */
+  async registerFiatAccount(input) {
+    const body = await this.request("POST", "/api/v1/fiatAccounts/", {
+      customerId: this.config.customerId,
+      paymentMethodType: this.paymentMethodType,
+      accountFields: { alias_or_cvu_destination: input.cbuOrCvuOrAlias }
+    });
+    const id = typeof body.id === "string" && body.id || typeof body.fiatAccountId === "string" && body.fiatAccountId || "";
+    return { fiatAccountId: id, raw: body };
+  }
+};
+
+// src/mural.ts
+var MURAL_PROD = "https://api.muralpay.com";
+var MURAL_SANDBOX = "https://api-staging.muralpay.com";
+var MuralApiError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "MuralApiError";
+  }
+  status;
+  body;
+};
+var MuralAuthError = class extends MuralApiError {
+  constructor(message, status, body) {
+    super(message, status, body);
+    this.name = "MuralAuthError";
+  }
+};
+var MuralRateLimitError = class extends MuralApiError {
+  constructor(message, status, body) {
+    super(message, status, body);
+    this.name = "MuralRateLimitError";
+  }
+};
+function num3(v) {
+  if (typeof v === "number" && Number.isFinite(v)) return v;
+  if (typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v))) return Number(v);
+  return void 0;
+}
+function normalizeMuralStatus(requestStatus, fiatPayoutType) {
+  const f = (fiatPayoutType ?? "").toLowerCase();
+  if (f) {
+    if (f === "completed") return "COMPLETED";
+    if (f === "failed" || f === "canceled" || f === "cancelled") return "FAILED";
+    if (f === "created") return "PENDING";
+    if (["pending", "on-hold", "refundinprogress", "refunded"].includes(f)) return "PROCESSING";
+  }
+  const s = (requestStatus ?? "").toUpperCase();
+  if (s === "EXECUTED" || s === "PENDING") return "PROCESSING";
+  if (s === "AWAITING_EXECUTION") return "PENDING";
+  if (s === "FAILED" || s === "CANCELED" || s === "CANCELLED") return "FAILED";
+  return "UNKNOWN";
+}
+var MuralOffRampAdapter = class {
+  constructor(config) {
+    this.config = config;
+    if (!config.apiKey) throw new Error("MuralConfig.apiKey is required");
+    if (!config.transferApiKey) throw new Error("MuralConfig.transferApiKey is required");
+    if (!config.sourceAccountId) throw new Error("MuralConfig.sourceAccountId is required");
+    if (!config.cvu) throw new Error("MuralConfig.cvu is required");
+    if (!config.documentNumber) throw new Error("MuralConfig.documentNumber is required");
+    this.baseUrl = (config.baseUrl ?? MURAL_PROD).replace(/\/+$/, "");
+    this.tokenSymbol = config.tokenSymbol ?? "USDC";
+    this.fiatRailCode = config.fiatRailCode ?? "ars";
+    const f = config.fetchImpl ?? globalThis.fetch;
+    if (!f) throw new Error("no fetch available; pass MuralConfig.fetchImpl");
+    this.fetchImpl = f;
+    this.now = config.now ?? Date.now;
+  }
+  config;
+  baseUrl;
+  tokenSymbol;
+  fiatRailCode;
+  fetchImpl;
+  now;
+  async request(method, path, body, extraHeaders) {
+    const headers = {
+      authorization: `Bearer ${this.config.apiKey}`,
+      "content-type": "application/json",
+      accept: "application/json",
+      ...this.config.organizationId ? { "on-behalf-of": this.config.organizationId } : {},
+      ...extraHeaders
+    };
+    const init = { method, headers };
+    if (body !== void 0) init.body = JSON.stringify(body);
+    let res;
+    try {
+      res = await this.fetchImpl(`${this.baseUrl}${path}`, init);
+    } catch (cause) {
+      throw new MuralApiError(`mural ${method} ${path} transport error: ${String(cause)}`, 0);
+    }
+    const text = await res.text();
+    let parsed = void 0;
+    if (text) {
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        parsed = text;
+      }
+    }
+    if (!res.ok) {
+      const msg = `mural ${method} ${path} -> ${res.status}`;
+      if (res.status === 401 || res.status === 403) throw new MuralAuthError(msg, res.status, parsed);
+      if (res.status === 429) throw new MuralRateLimitError(msg, res.status, parsed);
+      throw new MuralApiError(msg, res.status, parsed);
+    }
+    return parsed;
+  }
+  /** Quote a USDC->ARS off-ramp via the token-to-fiat fees endpoint. */
+  async quote(amountUsd) {
+    const body = {
+      tokenFeeRequests: [
+        {
+          amount: { tokenAmount: amountUsd, tokenSymbol: this.tokenSymbol },
+          fiatAndRailCode: this.fiatRailCode
+        }
+      ]
+    };
+    const res = await this.request("POST", "/api/payouts/fees/token-to-fiat", body);
+    const first = Array.isArray(res) ? res[0] : void 0;
+    if (!first) throw new MuralApiError("mural fees: empty response", 200, res);
+    if (first.type === "error") {
+      throw new MuralApiError(`mural fees error: ${String(first.message ?? "unknown")}`, 200, first);
+    }
+    const est = first.estimatedFiatAmount;
+    const arsOut = num3(est?.fiatAmount);
+    const rate = num3(first.exchangeRate);
+    if (arsOut === void 0 || rate === void 0 || rate <= 0) {
+      throw new MuralApiError("mural fees: could not parse rate/estimate", 200, first);
+    }
+    const spread = num3(first.exchangeFeePercentage) ?? 0;
+    return { amountUsd, arsOut, rate, spread };
+  }
+  /**
+   * Create + execute the off-ramp payout: convert `amountUsd` USDC and pay ARS to
+   * the configured CBU/CVU. IRREVERSIBLE — gate behind requireConfirmation (RFC-001)
+   * and write to the signed audit log. Returns the payout-request id as txId;
+   * `arsReceived` is the EXPECTED amount (from a fresh quote), the settled figure
+   * comes from getStatus.
+   */
+  async convert(amountUsd, opts) {
+    if (!opts?.externalId)
+      throw new Error("MuralOffRampAdapter.convert: externalId (idempotency key) is required");
+    const q = await this.quote(amountUsd);
+    const memo = opts.externalId;
+    const isBusiness = (this.config.recipient.type ?? "business") === "business";
+    const recipientInfo = isBusiness ? {
+      type: "business",
+      name: this.config.recipient.name ?? this.config.bankAccountOwner,
+      ...this.config.recipient.email ? { email: this.config.recipient.email } : {},
+      physicalAddress: this.config.recipient.physicalAddress
+    } : {
+      type: "individual",
+      firstName: this.config.recipient.firstName,
+      lastName: this.config.recipient.lastName,
+      ...this.config.recipient.email ? { email: this.config.recipient.email } : {},
+      physicalAddress: this.config.recipient.physicalAddress
+    };
+    const created = await this.request(
+      "POST",
+      "/api/payouts/payout",
+      {
+        sourceAccountId: this.config.sourceAccountId,
+        memo,
+        payouts: [
+          {
+            amount: { tokenAmount: amountUsd, tokenSymbol: this.tokenSymbol },
+            payoutDetails: {
+              type: "fiat",
+              bankName: this.config.bankName,
+              bankAccountOwner: this.config.bankAccountOwner,
+              fiatAndRailDetails: {
+                type: "ars",
+                symbol: "ARS",
+                bankAccountNumber: this.config.cvu,
+                documentNumber: this.config.documentNumber,
+                bankAccountNumberType: this.config.cvuType ?? "CVU"
+              }
+            },
+            recipientInfo
+          }
+        ]
+      }
+    );
+    const id = created.id;
+    if (!id) throw new MuralApiError("mural payout: response had no id", 200, created);
+    await this.request(
+      "POST",
+      `/api/payouts/payout/${encodeURIComponent(id)}/execute`,
+      void 0,
+      { "transfer-api-key": this.config.transferApiKey }
+    );
+    return { amountUsd, arsReceived: q.arsOut, rate: q.rate, txId: id };
+  }
+  /** Poll a payout request and normalize its settlement state. */
+  async getStatus(txId) {
+    const body = await this.request(
+      "GET",
+      `/api/payouts/payout/${encodeURIComponent(txId)}`
+    );
+    const requestStatus = typeof body.status === "string" ? body.status : void 0;
+    const payouts = Array.isArray(body.payouts) ? body.payouts : [];
+    const first = payouts[0];
+    const details = first?.details;
+    const fiatStatus = details?.fiatPayoutStatus;
+    const fiatType = typeof fiatStatus?.type === "string" ? fiatStatus.type : void 0;
+    const fiatAmount = details?.fiatAmount;
+    const arsSettled = fiatType === "completed" ? num3(fiatAmount?.fiatAmount) : void 0;
+    const report = {
+      txId,
+      status: normalizeMuralStatus(requestStatus, fiatType)
+    };
+    const raw = fiatType ?? requestStatus;
+    if (raw !== void 0) report.raw = raw;
+    if (arsSettled !== void 0) report.arsSettled = arsSettled;
+    return report;
+  }
+};
+
+// src/afip.ts
+var WSCREATEVEP_IS_GOV_ONLY = "AFIP/ARCA WSCREATEVEP is enabled only for public organisms (organismos recaudadores), not private taxpayers. Do not build VEP creation on it. See TREASURY-FISCAL-RAIL.md \xA73.";
+var MONOTRIBUTO_TABLE_EFFECTIVE = "2026-02-01";
+var MONOTRIBUTO_2026 = [
+  { category: "A", annualCapArs: 1027798813e-2, cuotaServicios: 42386.74, cuotaBienes: 42386.74, bienesOnly: false },
+  { category: "B", annualCapArs: 1505844771e-2, cuotaServicios: 48250.78, cuotaBienes: 48250.78, bienesOnly: false },
+  { category: "C", annualCapArs: 2111369652e-2, cuotaServicios: 56501.85, cuotaBienes: 55227.06, bienesOnly: false },
+  { category: "D", annualCapArs: 2621285342e-2, cuotaServicios: 72414.1, cuotaBienes: 70661.26, bienesOnly: false },
+  { category: "E", annualCapArs: 3083396437e-2, cuotaServicios: 102537.97, cuotaBienes: 92658.35, bienesOnly: false },
+  { category: "F", annualCapArs: 3864204836e-2, cuotaServicios: 129045.32, cuotaBienes: 111198.27, bienesOnly: false },
+  { category: "G", annualCapArs: 4621110937e-2, cuotaServicios: 197108.23, cuotaBienes: 135918.34, bienesOnly: false },
+  { category: "H", annualCapArs: 7011340733e-2, cuotaServicios: 447346.93, cuotaBienes: 272063.4, bienesOnly: false },
+  { category: "I", annualCapArs: 7847921162e-2, cuotaServicios: 824802.26, cuotaBienes: 406512.05, bienesOnly: true },
+  { category: "J", annualCapArs: 898726403e-1, cuotaServicios: 999007.65, cuotaBienes: 497059.41, bienesOnly: true },
+  { category: "K", annualCapArs: 10835708405e-2, cuotaServicios: 13816879e-1, cuotaBienes: 600879.51, bienesOnly: true }
+];
+function monotributoCuota(category, activity) {
+  const row = MONOTRIBUTO_2026.find((r) => r.category === category);
+  if (!row) throw new Error(`unknown monotributo category: ${category}`);
+  if (row.bienesOnly && activity === "servicios") {
+    throw new Error(
+      `category ${category} is only available for venta de bienes (servicios caps at H)`
+    );
+  }
+  return activity === "servicios" ? row.cuotaServicios : row.cuotaBienes;
+}
+function categoryForAnnualIncome(annualArs, activity) {
+  const rows = MONOTRIBUTO_2026.filter(
+    (r) => activity === "bienes" || !r.bienesOnly
+  );
+  for (const r of rows) {
+    if (annualArs <= r.annualCapArs) return r.category;
+  }
+  return null;
+}
+function settlementPlan(obligation, method) {
+  const base = {
+    amountArs: obligation.amountArs,
+    dueAtMs: obligation.dueAtMs,
+    canAutoExecute: false
+  };
+  switch (method) {
+    case "debito_automatico":
+      return {
+        ...base,
+        method,
+        autonomy: "passive",
+        instruction: "Manten\xE9 al menos ARS " + obligation.amountArs.toFixed(2) + " en el CVU antes del vencimiento; el d\xE9bito autom\xE1tico cobra la cuota solo.",
+        oneTimeSetup: "Adher\xED el CBU/CVU al d\xE9bito autom\xE1tico en el Portal Monotributo de ARCA (paso \xFAnico, no hay API; el alta debe estar antes del d\xEDa 20 para el d\xE9bito del d\xEDa 7 siguiente)."
+      };
+    case "vep_manual":
+      return {
+        ...base,
+        method,
+        autonomy: "human-required",
+        instruction: "Gener\xE1 el VEP/QR en ARCA (Mis Aplicaciones) y pagalo escaneando el QR o ingresando CUIT + n\xFAmero de VEP en tu billetera. El agente no puede pagar el VEP por API.",
+        oneTimeSetup: ""
+      };
+    case "mp_manual":
+      return {
+        ...base,
+        method,
+        autonomy: "human-required",
+        instruction: "Gener\xE1 el VEP en ARCA y pagalo en Mercado Pago (Cuentas y servicios \u2192 AFIP VEP, o escane\xE1 el QR). No existe API de Mercado Pago para pagar un VEP.",
+        oneTimeSetup: ""
+      };
+  }
+}
+
+// src/index.ts
+var ZERO_STATE = { usd: 0, ars: 0, costBasisPerUsd: 1 };
+var CEDULAR_RATE = { ARS: 0.05, FOREIGN: 0.15 };
+function cedularTax(amountUsd, costBasisPerUsd, fxRate, denom = "ARS") {
+  const proceeds = amountUsd * fxRate;
+  const cost = amountUsd * costBasisPerUsd * fxRate;
+  const gain = Math.max(0, proceeds - cost);
+  return gain * CEDULAR_RATE[denom];
+}
+function nextObligation(obligations, nowMs) {
+  const upcoming = obligations.filter((o) => o.dueAtMs >= nowMs).sort((a, b) => a.dueAtMs - b.dueAtMs);
+  return upcoming[0] ?? null;
+}
+function requiredArsBuffer(obligations, nowMs, horizonMs, safety = 1.1) {
+  const due = obligations.filter((o) => o.dueAtMs >= nowMs && o.dueAtMs <= nowMs + horizonMs);
+  const total = due.reduce((sum, o) => sum + o.amountArs, 0);
+  return total * safety;
+}
+function planConversion(state, requiredArs, fxRate, spread = 0.01) {
+  const shortfall = requiredArs - state.ars;
+  if (shortfall <= 0) {
+    return { convertUsd: 0, expectedArs: 0, reason: "ars buffer sufficient" };
+  }
+  const effectiveRate = fxRate * (1 - spread);
+  if (effectiveRate <= 0 || state.usd <= 0) {
+    return { convertUsd: 0, expectedArs: 0, reason: "no usd available or invalid rate" };
+  }
+  const neededUsd = shortfall / effectiveRate;
+  const convertUsd = Math.min(neededUsd, state.usd);
+  const expectedArs = convertUsd * effectiveRate;
+  return {
+    convertUsd,
+    expectedArs,
+    reason: convertUsd < neededUsd ? "partial: usd insufficient for full buffer" : "top up to buffer"
+  };
+}
+function applyConversion(state, receipt) {
+  return {
+    usd: state.usd - receipt.amountUsd,
+    ars: state.ars + receipt.arsReceived,
+    costBasisPerUsd: state.costBasisPerUsd
+  };
+}
+function applyPayment(state, amountArs) {
+  if (amountArs > state.ars) {
+    throw new Error(
+      `insufficient ARS: need ${amountArs.toFixed(2)}, have ${state.ars.toFixed(2)}`
+    );
+  }
+  return { ...state, ars: state.ars - amountArs };
+}
+var InMemoryOffRampAdapter = class {
+  constructor(rate, spread = 0.01) {
+    this.rate = rate;
+    this.spread = spread;
+  }
+  rate;
+  spread;
+  settled = /* @__PURE__ */ new Map();
+  async quote(amountUsd) {
+    return {
+      amountUsd,
+      arsOut: amountUsd * this.rate * (1 - this.spread),
+      rate: this.rate,
+      spread: this.spread
+    };
+  }
+  async convert(amountUsd, opts) {
+    if (!opts?.externalId)
+      throw new Error("InMemoryOffRampAdapter.convert: externalId (idempotency key) is required");
+    const cached = this.settled.get(opts.externalId);
+    if (cached) return cached;
+    const q = await this.quote(amountUsd);
+    const receipt = {
+      amountUsd,
+      arsReceived: q.arsOut,
+      rate: this.rate * (1 - this.spread),
+      txId: `mem-${opts.externalId}`
+    };
+    this.settled.set(opts.externalId, receipt);
+    return receipt;
+  }
+  /** The in-memory adapter settles instantly: any tx it issued is COMPLETED. */
+  async getStatus(txId) {
+    return { txId, status: "COMPLETED", raw: "in-memory" };
+  }
+};
+async function fundTaxBuffer(args) {
+  const required = requiredArsBuffer(args.obligations, args.nowMs, args.horizonMs, args.safety);
+  const plan = planConversion(args.state, required, args.fxRate, args.spread);
+  if (plan.convertUsd <= 0 || !args.offramp) {
+    return { plan, state: args.state };
+  }
+  const externalId = args.externalId ?? `fund-${args.obligations.map((o) => o.id).join("+")}-${plan.convertUsd.toFixed(2)}`;
+  const receipt = await args.offramp.convert(plan.convertUsd, { externalId });
+  return { plan, receipt, state: applyConversion(args.state, receipt) };
+}
+
+export { CEDULAR_RATE, InMemoryOffRampAdapter, MONOTRIBUTO_2026, MONOTRIBUTO_TABLE_EFFECTIVE, MURAL_PROD, MURAL_SANDBOX, MantecaApiError, MantecaAuthError, MantecaOffRampAdapter, MantecaRateLimitError, MuralApiError, MuralAuthError, MuralOffRampAdapter, MuralRateLimitError, RIPIO_PROD, RIPIO_SANDBOX, RipioApiError, RipioAuthError, RipioOffRampAdapter, RipioRateLimitError, WSCREATEVEP_IS_GOV_ONLY, ZERO_STATE, applyConversion, applyPayment, categoryForAnnualIncome, cedularTax, fundTaxBuffer, monotributoCuota, nextObligation, normalizeMuralStatus, normalizeRipioStatus, planConversion, requiredArsBuffer, settlementPlan };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map