@ixo/asks-mcp 2.0.0-dev.5 → 2.0.0

package/dist/asks-mcp.mjs

@@ -38786,9 +38786,9 @@ function nLength(n, nBitLength) {
   const nByteLength = Math.ceil(_nBitLength / 8);
   return { nBitLength: _nBitLength, nByteLength };
 }
-function Field(ORDER2, opts = {}) {
+function Field(ORDER3, opts = {}) {
   Object.freeze(_Field.prototype);
-  return new _Field(ORDER2, opts);
+  return new _Field(ORDER3, opts);
 }
 function FpSqrtEven(Fp2, elm) {
   validateField(Fp2);
@@ -38867,9 +38867,9 @@ var init_modular = __esm({
       ONE = _1n3;
       _lengths;
       _mod;
-      constructor(ORDER2, opts = {}) {
-        if (ORDER2 <= _1n3)
-          throw new Error("invalid field: expected ORDER > 1, got " + ORDER2);
+      constructor(ORDER3, opts = {}) {
+        if (ORDER3 <= _1n3)
+          throw new Error("invalid field: expected ORDER > 1, got " + ORDER3);
         let _nbitLength = void 0;
         this.isLE = false;
         if (opts != null && typeof opts === "object") {
@@ -38884,10 +38884,10 @@ var init_modular = __esm({
           if (typeof opts.modFromBytes === "boolean")
             this._mod = opts.modFromBytes;
         }
-        const { nBitLength, nByteLength } = nLength(ORDER2, _nbitLength);
+        const { nBitLength, nByteLength } = nLength(ORDER3, _nbitLength);
         if (nByteLength > 2048)
           throw new Error("invalid field: expected ORDER of <= 2048 bytes");
-        this.ORDER = ORDER2;
+        this.ORDER = ORDER3;
         this.BITS = nBitLength;
         this.BYTES = nByteLength;
         Object.freeze(this);
@@ -38961,7 +38961,7 @@ var init_modular = __esm({
       }
       fromBytes(bytes3, skipValidation = false) {
         abytes5(bytes3);
-        const { _lengths: allowedLengths, BYTES, isLE: isLE3, ORDER: ORDER2, _mod: modFromBytes } = this;
+        const { _lengths: allowedLengths, BYTES, isLE: isLE3, ORDER: ORDER3, _mod: modFromBytes } = this;
         if (allowedLengths) {
           if (bytes3.length < 1 || !allowedLengths.includes(bytes3.length) || bytes3.length > BYTES) {
             throw new Error("Field.fromBytes: expected " + allowedLengths + " bytes, got " + bytes3.length);
@@ -38974,7 +38974,7 @@ var init_modular = __esm({
           throw new Error("Field.fromBytes: expected " + BYTES + " bytes, got " + bytes3.length);
         let scalar = isLE3 ? bytesToNumberLE2(bytes3) : bytesToNumberBE(bytes3);
         if (modFromBytes)
-          scalar = mod2(scalar, ORDER2);
+          scalar = mod2(scalar, ORDER3);
         if (!skipValidation) {
           if (!this.isValid(scalar))
             throw new Error("invalid field element: outside of range 0..ORDER");
@@ -264720,7 +264720,7 @@ var init_inviteMessages = __esm({
       return rest;
     };
     linkedinMessage = (act, signer2, now3 = Date.now(), digest2 = "") => `linkedin:${act}:${signer2}:${now3}:${digest2}`;
-    CASHOUT_ACTS = ["quote", "draft", "status"];
+    CASHOUT_ACTS = ["quote", "draft", "status", "kyc"];
     cashoutMessage = (act, signer2, now3 = Date.now(), digest2 = "") => `cashout:${act}:${signer2}:${now3}:${digest2}`;
     ROOM_ACTS = ["mine", "read", "send", "bring", "export"];
     roomBody = (body) => {
@@ -266883,8 +266883,14 @@ var init_takeBack = __esm({
 var cashout_exports = {};
 __export(cashout_exports, {
   cashOut: () => cashOut,
-  cashOutStatus: () => cashOutStatus
+  cashOutStatus: () => cashOutStatus,
+  identityLine: () => identityLine
 });
+function whyOff(one) {
+  if (one.enabled === false) return one.reason === "not_in_country" ? "not offered in your country yet" : one.reason === "coming_soon" ? "coming soon" : "busy right now, try later";
+  if (one.provider === "yellowcard-worker" || one.method.startsWith("yellowcard")) return "coming soon";
+  return null;
+}
 async function call2(deps, path, body) {
   try {
     const response = await deps.fetch(`${deps.site.replace(/\/+$/, "")}${path}`, {
@@ -266903,52 +266909,60 @@ async function signedCall(deps, act, fields) {
   const message = await cashoutWords(act, deps.signer.address, full);
   return call2(deps, `/api/cashout/${act}`, { address: deps.signer.address, ...full, proof: { kind: "adr36", message, ...await signWords(deps.signer.mnemonic, message) } });
 }
+async function identityLine(deps) {
+  const answer = await signedCall(deps, "kyc", {});
+  const status = answer.status === 200 ? answer.body.status : "unknown";
+  if (status === "verified") return "Your identity check is done.";
+  if (status === "in_review") return "Your identity check is being reviewed.";
+  const info = await call2(deps, "/api/cashout/info");
+  const kycUrl = typeof info.body.kycUrl === "string" ? info.body.kycUrl : `${deps.site.replace(/\/+$/, "")}/me/identity`;
+  return `Do your identity check first: ${kycUrl}`;
+}
 async function cashOut(deps, input) {
   const person = deps.signer.principal ?? deps.signer.address;
-  const [ready, payBase] = await Promise.all([signedCall(deps, "status", {}), deps.payBase(person)]);
+  const [ready, payBase, kycLine] = await Promise.all([signedCall(deps, "status", {}), deps.payBase(person), identityLine(deps)]);
   if (ready.status !== 200) return said3(ready);
   const kyc = ready.body.kyc;
   if (!ready.body.linkedin) return "Cash-out needs your LinkedIn connected first. Next: connect_linkedin (about a minute), then cash_out again.";
   const available = payBase / 1e6;
   if (available <= 0) return "You have nothing to cash out yet.";
-  const kycLine = kyc?.status === "verified" ? "" : kyc?.status === "expired" ? `Your identity check has expired. Renew it first: ${deps.site.replace(/\/+$/, "")}/me/identity` : `Cash-out needs an identity check. If you haven't done it yet, do it first: ${deps.site.replace(/\/+$/, "")}/me/identity`;
-  if (kyc?.status === "expired") return kycLine;
+  if (kyc?.status === "expired") return `Your identity check has expired. Renew it first: ${deps.site.replace(/\/+$/, "")}/me/identity`;
   const country = input.country?.trim().toUpperCase();
   if (!country || !/^[A-Z]{2}$/.test(country)) return [`You have $${available.toFixed(2)} to cash out.`, kycLine, 'Which country are you in? (Ask the person; then call cash_out with country, like "NG" or "DE".)'].filter(Boolean).join("\n");
   const info = await call2(deps, `/api/cashout/info?country=${country}`);
   if (info.status !== 200) return said3(info);
-  const methods = info.body.methods ?? [];
+  const methods = (info.body.methods ?? []).filter((one) => WAYS[one.method]).sort((a, b) => ORDER2.indexOf(a.method) - ORDER2.indexOf(b.method));
   const fee = info.body.fee;
-  if (!methods.length) return `There's no way to cash out in ${country} yet.`;
-  const chosen2 = methods.find((one) => one.method === input.method);
+  if (!methods.some((one) => !whyOff(one))) return `We can't send money to ${country} yet.`;
+  const chosen2 = methods.find((one) => one.method === input.method && !whyOff(one));
   if (!chosen2)
     return [
       `You have $${available.toFixed(2)} to cash out. Ways to get paid in ${country}:`,
-      ...methods.map((one) => `- ${WAYS[one.method] ?? one.method} (method "${one.method}"): $${one.minUsd} to $${one.maxUsd}`),
+      ...methods.map((one) => `- ${WAYS[one.method]} (method "${one.method}"): ${whyOff(one) ?? `$${one.minUsd ?? "0.00"}${one.maxUsd ? ` to $${one.maxUsd}` : ""}`}`),
       `Fee: ${fee?.bps ? `${fee.bps / 100}%` : "none"}${fee?.minUsd && Number(fee.minUsd) > 0 ? `, at least $${fee.minUsd}` : ""}.`,
       kycLine,
       "(Ask which way and how much; then call cash_out with method and amount_usd.)"
     ].filter(Boolean).join("\n");
   const amount3 = input.amount_usd?.trim().replace(/^\$/, "");
-  if (!amount3 || !/^\d+(\.\d{1,2})?$/.test(amount3)) return `How much do you want to cash out? You have $${available.toFixed(2)}; this way takes $${chosen2.minUsd} to $${chosen2.maxUsd}. (Then call cash_out with amount_usd, like "25".)`;
+  if (!amount3 || !/^\d+(\.\d{1,2})?$/.test(amount3)) return `How much do you want to cash out? You have $${available.toFixed(2)}; this way takes $${chosen2.minUsd ?? "0.00"}${chosen2.maxUsd ? ` to $${chosen2.maxUsd}` : ""}. (Then call cash_out with amount_usd, like "25".)`;
   if (Number(amount3) > available) return `You have $${available.toFixed(2)} to cash out, less than $${amount3}. Pick a smaller amount.`;
-  if (Number(amount3) < Number(chosen2.minUsd)) return `The smallest you can cash out this way is $${chosen2.minUsd}.`;
-  if (Number(amount3) > Number(chosen2.maxUsd)) return `The largest you can cash out this way is $${chosen2.maxUsd}.`;
+  if (chosen2.minUsd && Number(amount3) < Number(chosen2.minUsd)) return `The smallest you can cash out this way is $${chosen2.minUsd}.`;
+  if (chosen2.maxUsd && Number(amount3) > Number(chosen2.maxUsd)) return `The largest you can cash out this way is $${chosen2.maxUsd}.`;
   const to = input.to?.trim();
   if (chosen2.fields.includes("address") && !(to && BASE_ADDRESS.test(to))) return "Which Base account should receive it? (Its address starts with 0x; then call cash_out with to.)";
   const quote = await signedCall(deps, "quote", { method: chosen2.method, country, amountUsd: amount3 });
   if (quote.status !== 201) return said3(quote);
   const q = quote.body;
-  const receive = `You'll receive $${q.receive?.amount ?? q.amountUsd}${q.receive?.currency && q.receive.currency !== "USD" ? ` in ${q.receive.currency}` : ""} (fee $${q.feeUsd ?? "0.00"}).`;
+  const receive = `You'll receive $${q.receive?.amount ?? q.amountUsd} (fee $${q.feeUsd ?? "0.00"}).`;
   const named = chosen2.fields.includes("accountHolder") ? NAME_LINE : "";
-  if (!input.confirm) return [`Cash out $${q.amountUsd} by ${WAYS[chosen2.method] ?? chosen2.method}${to ? ` to ${to}` : ""}.`, receive, named, kycLine, "Nothing is sent yet. To go ahead, call cash_out again with the same answers and confirm: true."].filter(Boolean).join("\n");
+  if (!input.confirm) return [`Cash out $${q.amountUsd}: ${WAYS[chosen2.method]}${to ? `, to ${to}` : ""}.`, receive, named, kycLine, "Nothing is sent yet. To go ahead, call cash_out again with the same answers and confirm: true."].filter(Boolean).join("\n");
   const link5 = new URL(`${deps.site.replace(/\/+$/, "")}/me/cash-out`);
   link5.searchParams.set("quote", String(q.quoteId));
   link5.searchParams.set("method", chosen2.method);
   link5.searchParams.set("amount", amount3);
   link5.searchParams.set("country", country);
   if (to) link5.searchParams.set("to", to);
-  return [receive, named, `Open this and confirm with one tap: ${link5.toString()}`, "Your money leaves only when you confirm there. I signed nothing. (Later, cash_out_status with the id that page shows says where it stands.)"].filter(Boolean).join("\n");
+  return [receive, named, `Open this and tap Confirm: ${link5.toString()}`, "Your money leaves only when you confirm there. I sent nothing. (Later, cash_out_status with the id that page shows says where it stands.)"].filter(Boolean).join("\n");
 }
 async function cashOutStatus(deps, id) {
   const answer = await signedCall(deps, "status", { id });
@@ -266960,12 +266974,12 @@ async function cashOutStatus(deps, id) {
   switch (lapsed ? "expired" : v.state) {
     case "open":
     case "signing":
-      return `Not confirmed yet: open the confirm link and tap confirm (${money2}).`;
+      return `Not confirmed yet: open the link and tap Confirm (${money2}).`;
     case "sent":
-      return "Confirmed. The payout is starting.";
+      return "Confirmed. It's on its way.";
     case "expired":
     case "failed":
-      return "This cash-out expired before it was confirmed. Nothing was taken. Start a new one with cash_out.";
+      return "This took too long, so it was stopped. Nothing was taken. Start a new one with cash_out.";
     case "converting":
     case "taking":
     case "paying":
@@ -266973,31 +266987,32 @@ async function cashOutStatus(deps, id) {
     case "paid":
       return `Paid: ${money2}.`;
     case "needs_attention":
-      return `Your payout didn't go through: ${v.reason ?? "the payout failed"}. Check your details or pick another way: ${v.fixUrl ?? ""}
-${NAME_LINE}`;
+      return v.fixUrl ? `Something needs fixing: the money didn't reach you. Check your details or pick another way here: ${v.fixUrl}
+${NAME_LINE}` : "Something needs fixing, and we're looking into it. Nothing to do on your side.";
     case "not_converted":
     case "cancelled":
-      return "This cash-out didn't go through, and nothing was taken.";
+      return "It didn't go through, and nothing was taken.";
     case "refunded":
-      return "Your money was sent back to you.";
+      return "Your money is back in your account.";
     default:
-      return `State: ${v.state ?? "unknown"}.`;
+      return "We're still checking where it stands. Ask again in a minute.";
   }
 }
-var WAYS, BASE_ADDRESS, NAME_LINE, said3;
+var WAYS, ORDER2, BASE_ADDRESS, NAME_LINE, said3;
 var init_cashout = __esm({
   "src/cashout.ts"() {
     "use strict";
     init_accountProof();
     init_inviteProof();
     WAYS = {
-      usdc_base: "Digital dollars to your own Base account (any country)",
-      stripe_bank: "Bank account, through Stripe",
-      yellowcard_bank: "Bank account, through Yellow Card",
-      yellowcard_momo: "Mobile money, through Yellow Card"
+      stripe_bank: "To your bank account (through Stripe)",
+      yellowcard_bank: "To your bank account (through Yellow Card)",
+      yellowcard_momo: "To your mobile money (M-PESA, MTN and others)",
+      usdc_base: "Digital dollars (USDC), to your own Base account (its address starts with 0x)"
     };
+    ORDER2 = Object.keys(WAYS);
     BASE_ADDRESS = /^0x[0-9a-fA-F]{40}$/;
-    NAME_LINE = "The payout account name must match the name on your ID.";
+    NAME_LINE = "The name on the account must match the name on your ID.";
     said3 = (answer) => answer.status === 503 && answer.body.code === "not-open" ? "Cash-out isn't open on this network yet." : String(answer.body.error ?? `Cash-out refused this (${answer.status}).`);
   }
 });
@@ -292365,7 +292380,7 @@ import { randomBytes as randomBytes7 } from "node:crypto";
 // package.json
 var package_default = {
   name: "@ixo/asks-mcp",
-  version: "2.0.0-dev.5",
+  version: "2.0.0",
   description: "The Openhands Network MCP server: read the board, answer asks, post work and get paid on the ixo chain, with a key of its own on your machine.",
   license: "Apache-2.0",
   repository: {
@@ -292589,7 +292604,7 @@ var TOOLS = {
   },
   cash_out: {
     title: "Cash out your earnings",
-    description: `Turn what the person earned into money: digital dollars to your own Base account, or a bank account where offered. One step per call: it reads what they have available, their LinkedIn and identity check, then asks the country, the way to get paid, the amount and (for a Base account) the address, and shows the quote in plain words ("You'll receive $X (fee $0)"). With confirm: true it gives ONE link: the person opens it and confirms with one tap; that page checks their identity and they sign there. Limits and fees come from IXO's cash-out service, never from here. No LinkedIn: say connect_linkedin first. Signs no money and holds no key of theirs.`,
+    description: `Turn what the person earned into money: to their bank account, their mobile money, or "Digital dollars (USDC)" to their own Base account, where offered. Speak plainly to the person: no technical words. One step per call: it reads what they have available, their LinkedIn and identity check, then asks the country, the way to get paid (every way is listed; the ones they can't pick say why), the amount and (for digital dollars) the 0x address, and shows "You'll receive $X (fee $0)". With confirm: true it gives ONE link: the person opens it and taps Confirm there, where their identity is checked and they confirm in their sign-in app. Limits and fees come from IXO's cash-out service, never from here. No LinkedIn: say connect_linkedin first. Signs no money and holds no key of theirs.`,
     spends: false,
     hosted: false,
     annotations: acts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ixo/asks-mcp",
-  "version": "2.0.0-dev.5",
+  "version": "2.0.0",
   "description": "The Openhands Network MCP server: read the board, answer asks, post work and get paid on the ixo chain, with a key of its own on your machine.",
   "license": "Apache-2.0",
   "repository": {