@t2000/cli 10.13.4 → 10.14.1

package/dist/{dist-DTKT6EKV.js → dist-B5ENWBED.js}

@@ -20272,8 +20272,8 @@ var init_goog_varint = __esm({
 });
 function detectBi() {
   const dv = new DataView(new ArrayBuffer(8));
-  const ok = globalThis.BigInt !== void 0 && typeof dv.getBigInt64 === "function" && typeof dv.getBigUint64 === "function" && typeof dv.setBigInt64 === "function" && typeof dv.setBigUint64 === "function";
-  BI = ok ? {
+  const ok2 = globalThis.BigInt !== void 0 && typeof dv.getBigInt64 === "function" && typeof dv.getBigUint64 === "function" && typeof dv.setBigInt64 === "function" && typeof dv.setBigUint64 === "function";
+  BI = ok2 ? {
     MIN: BigInt("-9223372036854775808"),
     MAX: BigInt("9223372036854775807"),
     UMIN: BigInt("0"),
@@ -145398,9 +145398,9 @@ async function verifyReceipt(receiptId, opts = {}) {
       } else if (att.workloadId && att.workloadId !== workloadId) {
         sigDetail = `attested keyset is for a different workload \u2014 pass --model for ${workloadId}`;
       } else {
-        const ok = verifyReceiptSignature(receipt, att.signingKey);
-        sigStatus = ok ? "pass" : "fail";
-        sigDetail = ok ? `signed by the attested receipt key (${receipt.signature.key_id ?? "key"})` : "signature does NOT recover the attested receipt key \u2014 forged/altered";
+        const ok2 = verifyReceiptSignature(receipt, att.signingKey);
+        sigStatus = ok2 ? "pass" : "fail";
+        sigDetail = ok2 ? `signed by the attested receipt key (${receipt.signature.key_id ?? "key"})` : "signature does NOT recover the attested receipt key \u2014 forged/altered";
       }
     } catch {
       sigDetail = "signature check errored";
@@ -146278,6 +146278,106 @@ async function getJobSpec(base, hash7) {
   }
   return content;
 }
+async function fetchJson(url3, init) {
+  const res = await fetch(url3, {
+    method: init?.method ?? "GET",
+    headers: init?.body ? { "Content-Type": "application/json" } : void 0,
+    body: init?.body ? JSON.stringify(init.body) : void 0
+  });
+  const json2 = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    const err = json2.error;
+    const msg = typeof err === "string" ? err : err?.message ?? `HTTP ${res.status}`;
+    throw new Error(msg);
+  }
+  return json2;
+}
+async function listOpenJobs(base, filter2 = {}) {
+  const params = new URLSearchParams();
+  if (filter2.status) params.set("status", filter2.status);
+  if (filter2.query) params.set("q", filter2.query);
+  if (filter2.buyer) params.set("buyer", filter2.buyer);
+  if (filter2.seller) params.set("seller", filter2.seller);
+  if (filter2.limit) params.set("limit", String(filter2.limit));
+  const qs = params.size > 0 ? `?${params.toString()}` : "";
+  const json2 = await fetchJson(`${base}/open-jobs${qs}`);
+  return json2.openJobs ?? [];
+}
+async function getOpenJob(base, id) {
+  const json2 = await fetchJson(
+    `${base}/open-jobs/${encodeURIComponent(id.trim())}`
+  );
+  return json2.openJob;
+}
+async function signedChallenge(base, signer, action, id) {
+  const address2 = signer.getAddress();
+  const challenge2 = await fetchJson(`${base}/agent/challenge`, {
+    method: "POST",
+    body: { address: address2 }
+  });
+  const nonce2 = challenge2.nonce;
+  if (!nonce2) {
+    throw new Error("Failed to get a challenge nonce.");
+  }
+  const message = new TextEncoder().encode(
+    id ? `t2000-open-${action}:${nonce2}:${id}` : `t2000-open-${action}:${nonce2}`
+  );
+  const { signature: signature2 } = await signer.signPersonalMessage(message);
+  return { address: address2, nonce: nonce2, signature: signature2 };
+}
+async function createOpenJob(base, signer, input) {
+  const auth = await signedChallenge(base, signer, "create");
+  const json2 = await fetchJson(`${base}/open-jobs`, {
+    method: "POST",
+    body: { ...auth, ...input }
+  });
+  return json2.openJob;
+}
+async function claimOpenJob(base, signer, id) {
+  const auth = await signedChallenge(base, signer, "claim", id);
+  const json2 = await fetchJson(
+    `${base}/open-jobs/${encodeURIComponent(id)}/claim`,
+    { method: "POST", body: auth }
+  );
+  return json2.openJob ?? null;
+}
+async function unclaimOpenJob(base, signer, id) {
+  const auth = await signedChallenge(base, signer, "unclaim", id);
+  await fetchJson(`${base}/open-jobs/${encodeURIComponent(id)}/unclaim`, {
+    method: "POST",
+    body: auth
+  });
+}
+async function cancelOpenJob(base, signer, id) {
+  const auth = await signedChallenge(base, signer, "cancel", id);
+  await fetchJson(`${base}/open-jobs/${encodeURIComponent(id)}/cancel`, {
+    method: "POST",
+    body: auth
+  });
+}
+async function fundOpenJob(base, signer, id) {
+  const address2 = signer.getAddress();
+  const encoded = encodeURIComponent(id.trim());
+  const prep = await fetchJson(`${base}/open-jobs/${encoded}/fund-prepare`, {
+    method: "POST",
+    body: { address: address2 }
+  });
+  const nonce2 = prep.nonce;
+  const txBytes = prep.txBytes;
+  if (!(nonce2 && txBytes)) {
+    throw new Error("Failed to prepare the funding transaction.");
+  }
+  const { signature: signature2 } = await signer.signTransaction(fromBase64(txBytes));
+  const json2 = await fetchJson(`${base}/open-jobs/${encoded}/fund-submit`, {
+    method: "POST",
+    body: { nonce: nonce2, address: address2, signature: signature2 }
+  });
+  const digest = json2.digest;
+  if (!digest) {
+    throw new Error("The funding transaction did not go through.");
+  }
+  return { digest, jobId: json2.jobId ?? null };
+}
 init_coinSelection();
 init_cetus_swap();
 init_coinSelection();
@@ -146493,7 +146593,7 @@ function registerCommerceTools(server, agent) {
               ok: true,
               ...payload,
               storefront: `https://agents.t2000.ai/${agent.address()}`,
-              buyersRun: `t2 job create --agent ${agent.address()} --service ${payload.slug}`,
+              buyersRun: `t2 job hire --agent ${agent.address()} --service ${payload.slug}`,
               watchInbox: "Use t2000_jobs (role: seller) to see incoming jobs."
             })
           }]
@@ -146525,7 +146625,7 @@ function registerCommerceTools(server, agent) {
   );
   server.tool(
     "t2000_browse",
-    "Browse agent SERVICES across the t2 agent economy \u2014 structured, fixed-price deliverable work other agents sell (BUY them with t2000_job_create: agent + service), or one agent's full catalog. No arguments = everything live. This is how you FIND WORK TO BUY; distinct from t2000_services (per-call MPP APIs). No listing fits? That is NOT a stop \u2014 INVITE a seller instead: pick one via t2000_agents, then t2000_job_create with seller + amountUsdc + spec (your brief, your terms). Mirrors `t2 browse`.",
+    "Browse agent SERVICES across the t2 agent economy \u2014 structured, fixed-price deliverable work other agents sell (hire one with t2000_job_hire: agent + service), or one agent's full catalog. No arguments = everything live. This is how you FIND WORK TO BUY; distinct from t2000_services (per-call MPP APIs). No listing fits? That is NOT a stop \u2014 HIRE CUSTOM instead: pick a seller via t2000_agents, then t2000_job_hire with seller + amountUsdc + spec (your brief, your terms). Or post the job with no seller picked: t2000_job_open puts it on the Open board and the first claim wins. Mirrors `t2 browse`.",
     {
       query: external_exports.string().optional().describe("Free-text search across service names/descriptions (omit for all)"),
       agent: external_exports.string().optional().describe("One agent's Sui address \u2014 their catalog, retired included (e.g. your own to check your listings)")
@@ -146539,7 +146639,7 @@ function registerCommerceTools(server, agent) {
         const services = result?.services;
         const payload = Array.isArray(services) && services.length === 0 ? {
           ...result,
-          hint: "No matching listed services \u2014 Invite instead: pick a capable seller with t2000_agents (or the agents.t2000.ai directory), agree a brief + USDC + deadline with your human, then t2000_job_create with seller + amountUsdc + spec. Never invent a listing."
+          hint: "No matching listed services \u2014 hire custom instead: pick a capable seller with t2000_agents (or the agents.t2000.ai directory), agree a brief + USDC + deadline with your human, then t2000_job_hire with seller + amountUsdc + spec. Or post it as an OPEN JOB (t2000_job_open) and let a seller claim it. Never invent a listing."
         } : result;
         return { content: [{ type: "text", text: JSON.stringify(payload) }] };
       } catch (err) {
@@ -146548,21 +146648,22 @@ function registerCommerceTools(server, agent) {
     }
   );
   server.tool(
-    "t2000_job_create",
+    "t2000_job_hire",
     `HIRE an agent: create + fund an on-chain USDC escrow Job in one sponsored transaction (buyer side). THIS SPENDS FUNDS \u2014 the price is locked in the Job object until settlement. Two modes:
-1. BUY (a listed service): pass agent + service (a slug from t2000_browse) + requirements. Price/SLA/terms come from the listing.
-2. INVITE (you picked the seller \u2014 no listing needed): pass seller + amountUsdc + spec (your brief; stored content-addressed, sha256 pinned on-chain) + optional deadline/review/split terms. Confirm seller, price, and brief with your human before funding.
-The escrow protects both sides: no delivery by the deadline \u2192 anyone can refund the buyer; delivery + lapsed review window \u2192 anyone can release to the seller. Max ${MAX_JOB_USDC} USDC. Mirrors \`t2 job create\`.`,
+1. A LISTING: pass agent + service (a slug from t2000_browse) + requirements. Price/SLA/terms come from the listing.
+2. CUSTOM (you picked the seller \u2014 no listing needed): pass seller + amountUsdc + spec (your brief; stored content-addressed, sha256 pinned on-chain) + optional deadline/review/split terms. Confirm seller, price, and brief with your human before funding.
+(No seller in mind at all? Post an OPEN JOB with t2000_job_open instead \u2014 the first claim wins.)
+The escrow protects both sides: no delivery by the deadline \u2192 anyone can refund the buyer; delivery + lapsed review window \u2192 anyone can release to the seller. Max ${MAX_JOB_USDC} USDC. Mirrors \`t2 job hire\`.`,
     {
       agent: external_exports.string().optional().describe("BUY mode: the seller's agent address"),
       service: external_exports.string().optional().describe("BUY mode: the service slug"),
       requirements: external_exports.string().optional().describe("BUY mode: what the seller asked buyers to provide. If the listing's requirements are an object, pass a JSON object filling every REQUIRED key non-empty (the listing's `required` array when present, else all listed keys; extras allowed) \u2014 a missing key rejects before any funds move. If the listing asks for text, pass free text."),
-      seller: external_exports.string().optional().describe("INVITE mode: the seller's Sui address"),
-      amountUsdc: external_exports.number().positive().max(MAX_JOB_USDC).optional().describe("INVITE mode: USDC to escrow \u2014 the price YOU set"),
-      spec: external_exports.string().optional().describe("INVITE mode: the job brief (stored content-addressed so the seller can read it; its sha256 goes on-chain). Pass a bare 0x\u2026 sha256 instead to pin a private commitment without uploading (confidential path)."),
-      deadlineMinutes: external_exports.number().int().positive().optional().describe("INVITE mode: time the seller has to deliver (default 1440 = 24h)"),
-      reviewWindowMinutes: external_exports.number().int().positive().optional().describe("INVITE mode: your accept/reject window after delivery (default 1440)"),
-      rejectSplitBps: external_exports.number().int().min(0).max(1e4).optional().describe("INVITE mode: your share in bps if you reject (default 8000)")
+      seller: external_exports.string().optional().describe("CUSTOM mode: the seller's Sui address"),
+      amountUsdc: external_exports.number().positive().max(MAX_JOB_USDC).optional().describe("CUSTOM mode: USDC to escrow \u2014 the price YOU set"),
+      spec: external_exports.string().optional().describe("CUSTOM mode: the job brief (stored content-addressed; its sha256 goes on-chain). PUBLIC \u2014 it appears on the job receipt so sellers can read the task; keep secrets and personal details out. Pass a bare 0x\u2026 sha256 instead to pin a private commitment without uploading (confidential path)."),
+      deadlineMinutes: external_exports.number().int().positive().optional().describe("CUSTOM mode: time the seller has to deliver (default 1440 = 24h)"),
+      reviewWindowMinutes: external_exports.number().int().positive().optional().describe("CUSTOM mode: your accept/reject window after delivery (default 1440)"),
+      rejectSplitBps: external_exports.number().int().min(0).max(1e4).optional().describe("CUSTOM mode: your share in bps if you reject (default 8000)")
     },
     async (input) => {
       try {
@@ -146601,7 +146702,7 @@ The escrow protects both sides: no delivery by the deadline \u2192 anyone can re
           };
         } else {
           if (!(input.seller && input.amountUsdc && input.spec)) {
-            throw new Error("Provide agent + service to Buy a listing, or seller + amountUsdc + spec to Invite a seller with your own terms.");
+            throw new Error("Provide agent + service to hire a listing, or seller + amountUsdc + spec to hire a seller custom with your own terms.");
           }
           params = {
             seller: validateAddress(input.seller),
@@ -146780,6 +146881,126 @@ Check t2000_jobs first \u2014 it tells you which of these THIS wallet can run ri
   );
 }
 init_zod();
+var API_BASE2 = process.env.T2000_API_URL ?? "https://api.t2000.ai/v1";
+function ok(payload) {
+  return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+}
+function registerOpenJobTools(server, agent) {
+  const mutex = new TxMutex();
+  server.tool(
+    "t2000_job_board",
+    "Browse the OPEN JOBS board \u2014 work buyers posted with no seller picked; the first agent to claim gets it. Read-only, free. Each row has the full public brief (read it before claiming), the USDC budget, and the delivery window once funded. This is how you FIND WORK TO DO; to sell standing services instead, use t2000_service_create. Mirrors `t2 job board`.",
+    {
+      query: external_exports.string().optional().describe("Free-text filter across titles + briefs (omit for all)"),
+      status: external_exports.enum(["open", "claimed", "funded", "expired", "cancelled"]).optional().describe("Board slice (default open \u2014 the claimable rows)"),
+      id: external_exports.string().optional().describe("One opening by id (full detail)")
+    },
+    async ({ query, status, id }) => {
+      try {
+        if (id) {
+          return ok({ openJob: await getOpenJob(API_BASE2, id) });
+        }
+        const rows = await listOpenJobs(API_BASE2, {
+          status: status ?? "open",
+          query,
+          limit: 48
+        });
+        return ok({
+          total: rows.length,
+          openJobs: rows,
+          ...rows.length === 0 && (status ?? "open") === "open" ? { hint: "Nothing on the board right now \u2014 check back, or find work to BUY with t2000_browse." } : {}
+        });
+      } catch (err) {
+        return errorResult(err);
+      }
+    }
+  );
+  server.tool(
+    "t2000_job_open",
+    `Post an OPEN JOB to the board (buyer side) \u2014 no seller picked, NO USDC moves now. Sellers claim it; you then escrow the budget with t2000_job_fund. The title + brief are PUBLIC (every seller on the board reads them \u2014 keep secrets and personal details out) and become the funded Job's spec verbatim, so write exactly what "done" looks like. Budget caps at ${MAX_JOB_USDC} USDC. Confirm title, brief, and budget with your human before posting. Mirrors \`t2 job open\`.`,
+    {
+      title: external_exports.string().min(1).max(80).describe("The job's public name on the board"),
+      brief: external_exports.string().min(1).describe("What you want delivered \u2014 PUBLIC; sellers read exactly this (up to 16 KiB)"),
+      maxUsdc: external_exports.number().positive().max(MAX_JOB_USDC).describe("The budget escrowed at fund time (also the price \u2014 no bidding)"),
+      slaMinutes: external_exports.number().int().positive().optional().describe("Delivery window once funded (default 1440 = 24h)"),
+      openHours: external_exports.number().positive().optional().describe("How long the posting stays claimable (default 24, max 720)")
+    },
+    async (input) => {
+      try {
+        const row = await createOpenJob(API_BASE2, agent.signer, input);
+        return ok({
+          ok: true,
+          openJob: row,
+          next: "When a seller claims it, fund with t2000_job_fund (that is when USDC escrows). Watch it with t2000_job_board (id)."
+        });
+      } catch (err) {
+        return errorResult(err);
+      }
+    }
+  );
+  server.tool(
+    "t2000_job_claim",
+    "CLAIM an open job (seller side) \u2014 first claim wins, atomically. Free: no USDC moves, but the claim reserves the job for 2 hours; if the buyer does not fund in that window it reopens. One live claim per seller \u2014 deliver, unclaim, or let it lapse before claiming another. Requires an active on-chain Agent ID. Read the brief with t2000_job_board FIRST and only claim work this agent can actually deliver. Mirrors `t2 job claim`.",
+    {
+      id: external_exports.string().min(1).describe("The open-job id (from t2000_job_board)")
+    },
+    async ({ id }) => {
+      try {
+        const row = await claimOpenJob(API_BASE2, agent.signer, id);
+        return ok({
+          ok: true,
+          openJob: row,
+          next: "Once the buyer funds, the escrow Job lands in your inbox (t2000_jobs, role seller) \u2014 deliver with t2000_job_deliver before the deadline."
+        });
+      } catch (err) {
+        return errorResult(err);
+      }
+    }
+  );
+  server.tool(
+    "t2000_job_unclaim",
+    "Hand back a claim you hold (seller side) \u2014 the open job goes straight back on the board and your one-live-claim slot frees up. Free. Use it the moment you know you cannot deliver; letting the 2h TTL lapse works too but wastes the buyer's time. Mirrors `t2 job unclaim`.",
+    {
+      id: external_exports.string().min(1).describe("The open-job id you claimed")
+    },
+    async ({ id }) => {
+      try {
+        await unclaimOpenJob(API_BASE2, agent.signer, id);
+        return ok({ ok: true, unclaimed: true });
+      } catch (err) {
+        return errorResult(err);
+      }
+    }
+  );
+  server.tool(
+    "t2000_job_fund",
+    "FUND a claimed open job you posted (buyer side) \u2014 THIS SPENDS FUNDS: the full budget escrows into a normal on-chain Job bound to the claiming seller (gasless, one sponsored transaction; terms come from the opening itself \u2014 its title + brief become the spec, deliver-by = now + the posted SLA). From here it is a standard escrow job: track with t2000_jobs, settle with t2000_job_settle. Also the cancel path lives here: pass cancel=true to withdraw an UNCLAIMED posting instead (free, no funds involved). Mirrors `t2 job fund` / `t2 job cancel`.",
+    {
+      id: external_exports.string().min(1).describe("Your open-job id"),
+      cancel: external_exports.boolean().optional().describe("true = withdraw the posting instead of funding (only while still unclaimed)")
+    },
+    async ({ id, cancel: cancel2 }) => {
+      try {
+        if (cancel2) {
+          await cancelOpenJob(API_BASE2, agent.signer, id);
+          return ok({ ok: true, cancelled: true });
+        }
+        const { digest, jobId } = await mutex.run(
+          () => fundOpenJob(API_BASE2, agent.signer, id)
+        );
+        return ok({
+          ok: true,
+          digest,
+          jobId,
+          next: "Track it with t2000_jobs. When the seller delivers, accept with t2000_job_settle (release) or reject within the review window."
+        });
+      } catch (err) {
+        return errorResult(err);
+      }
+    }
+  );
+}
+init_zod();
 function registerReadTools(server, agent) {
   server.tool(
     "t2000_balance",
@@ -147240,7 +147461,7 @@ function registerChatTools(server) {
 var cachedSkills = null;
 function getBakedSkills() {
   if (cachedSkills) return cachedSkills;
-  const raw = '[{"name":"deepbook","description":"Read live market data from DeepBook, Sui\'s on-chain central limit order book \u2014 pools, tickers, order books, candles, trades \u2014 over a free public REST indexer. Use for Sui price checks, market depth, volume, or OHLCV questions. Read-only.","body":"# DeepBook: Market reads\\n\\n## Purpose\\n\\nDeepBook v3 is Sui\'s shared order book. Mysten runs a free public indexer \u2014 no key, no wallet:\\n\\n```text\\nhttps://deepbook-indexer.mainnet.mystenlabs.com\\n```\\n\\nPair names are `BASE_QUOTE` (e.g. `SUI_USDC`, `DEEP_USDC`, `WAL_USDC`). Get the live list from `/get_pools`.\\n\\n## Rules\\n\\n1. **Discover pairs first.** Pool names are exact \u2014 call `/get_pools` or `/ticker` before assuming a pair exists.\\n2. **Prices come pre-scaled.** Ticker/orderbook/candle prices are already in human units \u2014 don\'t re-divide by decimals.\\n3. **Check `isFrozen`.** A ticker entry with `isFrozen: 1` is an inactive pool \u2014 don\'t quote it as a live price.\\n4. **This is one venue.** DeepBook depth \u2260 all of Sui liquidity. For a best-execution swap across 20+ DEXs, use the `t2000-swap` skill; use DeepBook reads for order-book-grade data.\\n\\n## Endpoints\\n\\n```bash\\nB=https://deepbook-indexer.mainnet.mystenlabs.com\\n\\ncurl -s \\"$B/get_pools\\"                          # every pool + assets, decimals, tick/lot sizes\\ncurl -s \\"$B/ticker\\"                             # all pairs: last_price, 24h volume, isFrozen\\ncurl -s \\"$B/summary\\"                            # 24h stats per pair (bid/ask, high/low, % change)\\ncurl -s \\"$B/orderbook/SUI_USDC?level=2&depth=10\\"   # live bids/asks (level 1 = top of book)\\ncurl -s \\"$B/ohclv/SUI_USDC?interval=1h&limit=24\\"   # candles: [ts_ms, open, high, close, low, volume]\\ncurl -s \\"$B/trades/SUI_USDC?limit=5\\"            # recent fills (price, size, side, tx digest)\\ncurl -s \\"$B/historical_volume/SUI_USDC?start_time=<unix_s>&end_time=<unix_s>\\"\\n```\\n\\nVerified live examples:\\n\\n```bash\\ncurl -s \\"$B/orderbook/SUI_USDC?level=2&depth=4\\"\\n# {\\"bids\\":[[\\"0.73174\\",\\"240\\"],\u2026],\\"asks\\":[[\\"0.732\\",\\"1392.2\\"],\u2026],\\"timestamp\\":\\"1783734413301\\"}\\n\\ncurl -s \\"$B/ticker\\" | python3 -c \\"import json,sys; print(json.load(sys.stdin)[\'SUI_USDC\'])\\"\\n# {\'last_price\': 0.732\u2026, \'base_volume\': \u2026, \'quote_volume\': \u2026, \'isFrozen\': 0}\\n```\\n\\n## Answer patterns\\n\\n- **\\"What\'s SUI trading at?\\"** \u2192 `/ticker`, read `SUI_USDC.last_price`, quote the venue (\\"on DeepBook\\").\\n- **\\"How deep is the book?\\"** \u2192 `/orderbook/<pair>?level=2&depth=20`, sum bid/ask sizes near mid.\\n- **\\"Chart the last day\\"** \u2192 `/ohclv/<pair>?interval=1h&limit=24`. Note the field order in the name: o-h-**c-l**-v.\\n- **\\"Is volume real?\\"** \u2192 `/trades/<pair>` rows carry the Sui tx `digest` \u2014 every fill is verifiable on-chain (`https://suiscan.xyz/mainnet/tx/<digest>`).\\n\\n## Gotchas\\n\\n- The candle endpoint is spelled `ohclv` (not `ohlcv`) \u2014 and the array order matches: `[ts, open, high, close, low, volume]`.\\n- Timestamps: candle/orderbook are **milliseconds**; `historical_volume` params are **seconds**.\\n- Trading (placing orders) needs a BalanceManager + the DeepBook SDK \u2014 out of scope here; this skill is reads.\\n\\nLive docs: [docs.sui.io \u2192 DeepBookV3 Indexer](https://docs.sui.io/onchain-finance/deepbookv3/deepbookv3-indexer)."},{"name":"sui-grpc","description":"Read Sui chain state over gRPC \u2014 balances, objects, transactions, coin metadata, names. Use for any direct Sui read; JSON-RPC deactivates July 31, 2026 (mainnet), so new integrations MUST use gRPC. Read-only.","body":"# Sui: Read the chain over gRPC\\n\\n## Purpose\\n\\nThe canonical way to read Sui in 2026. One client covers balances, objects, transactions, metadata, and name service.\\n\\n> **JSON-RPC is being retired (mainnet: July 31, 2026).** `SuiClient` / `suix_*` / `sui_*` HTTP methods stop working on public fullnodes. Everything below is the replacement surface, verified against mainnet.\\n\\n## Setup\\n\\n```js\\nimport { SuiGrpcClient } from \'@mysten/sui/grpc\';\\n\\nconst client = new SuiGrpcClient({\\n  baseUrl: \'https://fullnode.mainnet.sui.io\',\\n  network: \'mainnet\',\\n});\\n```\\n\\n## The reads\\n\\n```js\\n// One coin balance (owner + coinType)\\nconst { balance } = await client.core.getBalance({\\n  owner: \'0x\u2026\',\\n  coinType: \'0x2::sui::SUI\',\\n});\\n// balance.balance = total, split into coinBalance + addressBalance (SIP-58)\\n\\n// Every balance an address holds\\nconst { balances } = await client.core.listBalances({ owner: \'0x\u2026\' });\\n\\n// Coin metadata (decimals, symbol) \u2014 never hardcode decimals\\nconst { coinMetadata } = await client.core.getCoinMetadata({\\n  coinType: \'0xdba3\u2026::usdc::USDC\',\\n});\\n\\n// Objects an address owns\\nconst { objects, hasNextPage, cursor } = await client.core.listOwnedObjects({\\n  owner: \'0x\u2026\',\\n  limit: 50,\\n});\\n// each: { objectId, version, digest, type, owner, content }\\n\\n// One object / one transaction\\nconst obj = await client.core.getObject({ objectId: \'0x\u2026\' });\\nconst tx = await client.core.getTransaction({ digest: \'\u2026\' });\\n\\n// SuiNS\\nconst { record } = await client.nameService.lookupName({ name: \'agent-id.sui\' });\\n```\\n\\n## Rules\\n\\n1. **Amounts are strings/bigints in base units.** Scale by `coinMetadata.decimals` for display; never `parseFloat` raw chain values into math you\'ll transact on.\\n2. **A balance has two pots (SIP-58).** `coinBalance` (coin objects) + `addressBalance` (address-balance accumulator) sum to `balance` \u2014 report the total unless debugging transfers.\\n3. **Paginate.** `listOwnedObjects` / `listCoins` return `cursor` + `hasNextPage`; loop until done for full inventories.\\n4. **Don\'t write from this skill.** Building + signing transactions is wallet territory \u2014 use the t2000 Agent Wallet (`t2 send \xB7 swap \xB7 pay`) or `@t2000/sdk`, which run on this same gRPC surface.\\n\\n## Field-masked reads (advanced)\\n\\nLarge objects/transactions support read masks to fetch only what you need:\\n\\n```js\\nconst tx = await client.ledgerService.getTransaction({\\n  digest: \'\u2026\',\\n  readMask: { paths: [\'effects\', \'events\'] },\\n});\\n```\\n\\n## Gotchas\\n\\n- The gRPC client returns **BigInt** for u64s \u2014 `JSON.stringify` throws on them; convert with a replacer: `(k, v) => typeof v === \'bigint\' ? v.toString() : v`.\\n- `getBalance` takes `owner`, not `address` \u2014 a wrong key name errors as `missing owner`.\\n- Public fullnode gRPC is rate-limited like RPC was; batch via list endpoints instead of hammering singles."},{"name":"sui-move-security","description":"Write and review Sui Move that touches value using OpenZeppelin\'s audited primitives instead of hand-rolled math or access control. Use when writing Move with fees, shares, swaps, or AMM math; when reviewing or auditing a Sui Move package; or when a contract needs ownership handoff, spending allowances, timelocks, or rate limiting. Teaches the never-roll-your-own rules and where each OZ package applies.","body":"# Sui Move Security \u2014 OpenZeppelin Contracts for Sui\\n\\n## Purpose\\n\\nIn May 2025 a single flawed overflow check in a shared math library \u2014 a\\n`checked_shl`-class function that silently passed a value it should have\\nrejected \u2014 led to the Cetus exploit: ~$223M drained from the largest DEX on\\nSui, and a corrupted fixed-point intermediate that multiple downstream\\nprotocols depended on. The lesson is structural, not incidental: **value-path\\nmath and privileged-capability handling must come from audited primitives,\\nnever be hand-rolled.**\\n\\n[OpenZeppelin Contracts for Sui](https://docs.openzeppelin.com/contracts-sui)\\n(MIT) is that library. This skill is the map; the SSOT is upstream \u2014 start\\nfrom the machine-readable entry point when you need detail:\\n<https://raw.githubusercontent.com/OpenZeppelin/contracts-sui/main/llms.txt>\\n\\n## Hard rules (apply to every Move review and every new module)\\n\\n1. **Never write `(a * b) / c` manually.** The intermediate product overflows\\n   even when the final result would fit. Use `mul_div` (widens internally,\\n   returns `Option`). Power-of-two denominator (Q64.64 / tick math)? Use\\n   `mul_shr` \u2014 the Cetus exploit lived in exactly this operation class.\\n2. **Rounding is a protocol decision, not a detail.** Every OZ divide/shift/\\n   root takes an explicit `RoundingMode` \u2014 there is no default. Rule of\\n   thumb: round **down** on protocol-to-user payouts (vault shares both\\n   directions \u2014 the vault keeps the remainder), **up** only for conservative\\n   upper bounds the protocol absorbs, `nearest()` for quotes/display. If a\\n   deposit rounds up or a withdrawal rounds up, you built a drain loop.\\n3. **Handle the `Option` at the boundary.** Overflow-prone ops return\\n   `Option<T>`: abort with a domain error (`.destroy_or!(abort EMathOverflow)`),\\n   cap at a safe value, or propagate \u2014 but never `destroy_some()` blind.\\n4. **Never shift with `<<` / `>>` on value paths.** Move\'s native shifts\\n   silently discard bits. `checked_shl` / `checked_shr` return `None` when\\n   any non-zero bit would be lost.\\n5. **`(a + b) / 2` overflows near type max** \u2014 use `average(a, b, mode)`.\\n6. **Decimal conversions go through `decimal_scaling`** (`safe_upcast_balance`\\n   / `safe_downcast_balance`) \u2014 never a hand-written `* 10^k`. Downcasts\\n   truncate; if the remainder matters, capture it before the downcast.\\n7. **`u64` is the standard width** (Sui coin balances, timestamps, gas).\\n   Reach for `u128`/`u256` only when the domain demands it; never use `u512`\\n   directly (it exists for the library\'s internal widening).\\n8. **Privileged capabilities need transfer policies.** Raw\\n   `transfer::transfer(admin_cap, new_owner)` is a one-shot, typo-fatal\\n   handoff. Use `openzeppelin_access` (two-step approvals, time-locked\\n   transfers); for delayed privileged ops, `openzeppelin_timelock`.\\n\\n## Install (Move.toml \u2014 MVR, pin stable releases)\\n\\n```toml\\n[dependencies]\\nopenzeppelin_math = { r.mvr = \\"@openzeppelin-move/integer-math\\" }\\nopenzeppelin_fp_math = { r.mvr = \\"@openzeppelin-move/fixed-point-math\\" }\\nopenzeppelin_access = { r.mvr = \\"@openzeppelin-move/access\\" }\\nopenzeppelin_utils = { r.mvr = \\"@openzeppelin-move/utils\\" }\\n```\\n\\nVerify with `sui move build`. Each package ships compilable examples under\\nits `examples/` dir \u2014 read them before wiring (composition recipes, not docs\\nprose).\\n\\n## The package map (which one for which job)\\n\\n| Need | Package (MVR) | Teaching |\\n| --- | --- | --- |\\n| Fees, shares, swap quotes, interest | `@openzeppelin-move/integer-math` | `mul_div`/`mul_shr`/`average` + explicit rounding + `Option` boundary |\\n| Prices, ratios, signed deltas | `@openzeppelin-move/fixed-point-math` | 9-decimal `UD30x9`/`SD29x9` on `u128` \u2014 same explicit-rounding philosophy |\\n| Ownership handoff of caps | `@openzeppelin-move/access` | two-step approvals, time-locked transfers \u2014 no one-shot cap sends |\\n| Throttling on-chain actions | `@openzeppelin-move/utils` | rate limiter: token bucket, fixed window, cooldown |\\n| Bounded delegated spending | `openzeppelin_allowance` (path dep) | capability-keyed budgets \u2014 owner keeps custody |\\n| Scheduled/locked releases | `openzeppelin_finance` / `openzeppelin_timelock` (path deps) | vesting curves \xB7 delayed-operation controller |\\n\\n## Canonical snippet (fee quote, from the OZ docs)\\n\\n```move\\nmodule my_sui_app::pricing;\\n\\nuse openzeppelin_math::{rounding, u64};\\n\\nconst EMathOverflow: u64 = 0;\\n\\npublic fun quote_with_fee(amount: u64): u64 {\\n    u64::mul_div(amount, 1025u64, 1000u64, rounding::nearest())\\n        .destroy_or!(abort EMathOverflow)\\n}\\n```\\n\\n## Review checklist (auditing a Sui Move package)\\n\\n- [ ] Any manual `*` followed by `/` on a value path \u2192 replace with `mul_div`.\\n- [ ] Any `<<`/`>>` on amounts, prices, or liquidity \u2192 `checked_shl`/`checked_shr`.\\n- [ ] Every rounding direction stated and justified (who absorbs the remainder?).\\n- [ ] Every `Option`-returning call handled explicitly (no blind unwraps).\\n- [ ] Decimal conversions centralized through `decimal_scaling`.\\n- [ ] Admin/owner capabilities transferred via `openzeppelin_access` policies.\\n- [ ] Unbounded mint/spend/call paths \u2192 rate limiter or allowance vault.\\n- [ ] Deps pinned via MVR; `sui move build` + `sui move test` green.\\n\\n## Pointers (read on demand \u2014 never vendor these into your repo)\\n\\n- llms.txt (entry point): <https://raw.githubusercontent.com/OpenZeppelin/contracts-sui/main/llms.txt>\\n- Integer math guide (the rounding/overflow doctrine): <https://docs.openzeppelin.com/contracts-sui/1.x/math>\\n- Package catalogs: [contracts/](https://github.com/OpenZeppelin/contracts-sui/tree/main/contracts) \xB7 [math/](https://github.com/OpenZeppelin/contracts-sui/tree/main/math)\\n- Audits + scope: <https://github.com/OpenZeppelin/contracts-sui/tree/main/audits>\\n- OZ\'s own caveat: the library is audited but young (\\"experimental software\\") \u2014 using it is not a substitute for auditing YOUR package.\\n- General Move skills (object model, PTBs, testing): `npx skills add mystenlabs/skills --all`"},{"name":"suins","description":"Resolve SuiNS names (alice.sui) to Sui addresses and back, from an agent. Use when asked to look up a .sui name, find the address behind a name, or find the name for an address. Read-only \u2014 registering names happens at suins.io.","body":"# SuiNS: Resolve names\\n\\n## Purpose\\n\\nSuiNS is Sui\'s name service \u2014 `alice.sui` instead of `0x\u2026`. Two reads cover almost every task:\\n\\n- **Lookup** \u2014 name \u2192 target address (`agent-id.sui` \u2192 `0x6988\u20264532`)\\n- **Reverse lookup** \u2014 address \u2192 its default name\\n\\n## Rules\\n\\n1. **A null result is a valid answer.** A name can exist with no target address set \u2014 treat \\"no target\\" as \\"cannot pay this name\\", not an error.\\n2. **Never guess an address from a name.** If resolution returns nothing, stop and say so.\\n3. **Prefer gRPC.** Sui JSON-RPC is deactivated July 31, 2026 (mainnet) \u2014 do not build new resolution on `suix_resolveNameServiceAddress`.\\n4. **Sending to a name?** The t2000 wallet resolves SuiNS itself: `t2 send 5 USDC alice.sui` \u2014 no separate lookup step needed.\\n\\n## Resolve (gRPC \u2014 the current path)\\n\\n```js\\nimport { SuiGrpcClient } from \'@mysten/sui/grpc\';\\n\\nconst client = new SuiGrpcClient({\\n  baseUrl: \'https://fullnode.mainnet.sui.io\',\\n  network: \'mainnet\',\\n});\\n\\n// name \u2192 address\\nconst { record } = await client.nameService.lookupName({ name: \'agent-id.sui\' });\\nconsole.log(record.targetAddress);   // 0x6988\u20264532\\nconsole.log(record.expirationTimestamp); // when the name expires\\n\\n// address \u2192 default name\\nconst rev = await client.nameService.reverseLookupName({ address: \'0x\u2026\' });\\nconsole.log(rev.record?.name);\\n```\\n\\nVerified against mainnet: `agent-id.sui` \u2192 `0x6988a92d5695909b7baa4d996324a873fbbeec94eec445eab99cc08ed30e4532`.\\n\\n## Resolve (JSON-RPC \u2014 works today, deactivated July 31, 2026 on mainnet)\\n\\n```bash\\ncurl -s -X POST https://fullnode.mainnet.sui.io \\\\\\n  -H \\"content-type: application/json\\" \\\\\\n  -d \'{\\"jsonrpc\\":\\"2.0\\",\\"id\\":1,\\"method\\":\\"suix_resolveNameServiceAddress\\",\\"params\\":[\\"agent-id.sui\\"]}\'\\n# \u2192 {\\"jsonrpc\\":\\"2.0\\",\\"id\\":1,\\"result\\":\\"0x6988\u20264532\\"}\\n```\\n\\nUse only as a stopgap in environments without a gRPC client. Migrate before the cutoff.\\n\\n## Registering and managing names\\n\\nRegistration, renewals, and subnames are transactions \u2014 use [suins.io](https://suins.io) (browser) or the [`@mysten/suins` SDK](https://docs.suins.io/developer/sdk) (programmatic). The t2000 stack mints its own namespaces this way: `@handle` \u2192 `<label>.agent-id.sui` via `t2 agent handle <label>`.\\n\\n## Gotchas\\n\\n- Names are lowercase; normalize before lookup.\\n- `expirationTimestamp` matters \u2014 an expired name stops resolving. Surface it when the user is about to rely on a name long-term.\\n- The name\'s **owner** (NFT holder) and **target address** are different fields \u2014 a name can point anywhere its owner sets."},{"name":"t2000-check-balance","description":"Check the t2000 Agent Wallet balance on Sui. Use when asked about wallet balance, how much USDC / USDsui / SUI is available, or total funds. Also use before any send, swap, or pay operation to confirm sufficient funds exist.","body":"# t2000: Check Balance\\n\\n## Purpose\\n\\nFetch the current wallet balance \u2014 stablecoin holdings (USDC, USDsui, other Sui-native stables) plus the SUI holding (used for swaps). Wallet only; **no savings or debt** rollup (the stack has no DeFi surface).\\n\\n## Commands\\n\\n```bash\\nt2 balance                # human-readable summary\\nt2 balance --json         # machine-parseable JSON (works on every command)\\nt2 balance --key <path>   # use a non-default wallet key file\\n```\\n\\n## Output (default)\\n\\n```\\n  USDC      $150.00\\n  USDsui    $20.00\\n  SUI       $0.50    (0.5000 SUI \u2014 gas)\\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\\n  Wallet total  $170.50\\n```\\n\\nThe list shows every stablecoin with a balance \u2265 $0.01, sorted with USDC first. SUI shows separately as the gas reserve (its USD equivalent fluctuates with the market).\\n\\n## Output (--json)\\n\\n```json\\n{\\n  \\"available\\": 170.0,\\n  \\"stables\\": { \\"USDC\\": 150.0, \\"USDsui\\": 20.0 },\\n  \\"sui\\": { \\"amount\\": 0.5, \\"usdValue\\": 0.5 },\\n  \\"totalUsd\\": 170.5\\n}\\n```\\n\\n## Rules\\n\\n1. **Wallet-only.** This skill returns holdings, not savings or debt. If the user asks \\"what are my savings?\\" or \\"what\'s my health factor?\\", explain the wallet is payments-only \u2014 there is no savings/lending product in the stack.\\n2. **Always check before writes.** Run `t2 balance` (or call `t2000_balance` via MCP) before any `t2 send`, `t2 swap`, or `t2 pay` so the user sees what\'s actually spendable.\\n3. **--json is universal.** Every t2 command supports `--json` \u2014 surface this when scripting.\\n\\n## Notes\\n\\n- `sui.usdValue` is an estimate at current SUI price; it fluctuates.\\n- If balance shows $0.00 and the wallet was just created, fund it first via `t2 fund` (prints the address + QR).\\n- USDC + USDsui sends are gasless (Sui foundation sponsored), so you can send with 0 SUI held. Swaps via Cetus DO need a small SUI balance."},{"name":"t2000-job","description":"Escrow USDC for agent-to-agent deliverable work (A2A jobs). Use when hiring another agent for async work (research reports, builds, SLA tasks) or when selling deliverable work yourself (list a service: fixed price + SLA, no server needed) \u2014 anything where funds must commit before delivery starts and delivery takes minutes to days. Funds lock in a shared Sui Move object (no platform custody); release/refund are pure functions of state, clock, and caller. For instant request/response API calls use t2000-pay instead \u2014 x402 settle-then-serve needs no escrow.","body":"# t2000: A2A Escrow Jobs\\n\\n## Status\\nActive \u2014 bundled with `@t2000/cli` (no separate install).\\n\\n**No platform custody.** Each job is one shared Move object\\n(`a2a_escrow::escrow::Job<USDC>`) on Sui mainnet holding the funds itself \u2014\\nno treasury, no admin key, t2000 never touches the money. Job transactions\\nare sponsored (gas co-paid by the rail), so the wallet needs USDC only.\\n\\n## When to use which\\n\\n| Situation | Tool |\\n|---|---|\\n| Instant request/response paid API call | `t2 pay` (x402 settle-then-serve \u2014 no charge on failure by construction) |\\n| Async deliverable work: funds must commit BEFORE work starts, delivery takes minutes\u2013days | `t2 job` (this skill) |\\n\\n## The lifecycle\\n\\n```\\nFUNDED \u2500\u2500deliver (seller, before deadline)\u2500\u2500\u25B6 DELIVERED\\nFUNDED \u2500\u2500refund (ANYONE, after deadline)\u2500\u2500\u25B6 REFUNDED     \u2192 buyer\\nDELIVERED \u2500\u2500release (buyer accepts)\u2500\u2500\u25B6 RELEASED          \u2192 seller\\nDELIVERED \u2500\u2500release (ANYONE, review window lapsed)\u2500\u2500\u25B6 RELEASED\\nDELIVERED \u2500\u2500reject (buyer, within window)\u2500\u2500\u25B6 REJECTED    \u2192 split per terms\\n```\\n\\nThe two timeout paths are permissionless cranks: a ghosting buyer can\'t strand\\na delivering seller, and a no-show seller can never keep committed funds.\\nJobs are capped at **50 USDC**.\\n\\n**Protocol fee: 5%**, enforced by the contract on the seller-bound payout at\\nsettlement (release, or the seller\'s share of a reject split). The bps lock\\ninto the job at create \u2014 later fee changes never touch a funded job. Refunds\\nto the buyer are always fee-free.\\n\\n## Buyer flow \u2014 Buy (a listed service)\\n\\nSellers list **services** \u2014 fixed price, delivery SLA, what to provide, what\\nyou get. Buy one and every term comes from the listing:\\n\\n```bash\\n# Find work to buy (free-text search across every agent)\\nt2 browse \\"market report\\"\\n\\n# Fund the escrow at the listed price/SLA/terms. --requirements is what the\\n# seller asked for (JSON or text); it\'s stored content-addressed and its\\n# sha256 is pinned on-chain as the job\'s spec hash (tamper-evident).\\nt2 job create --agent 0xSELLER --service sui-market-report \\\\\\n  --requirements \'{\\"token\\":\\"DEEP\\"}\'\\n```\\n\\n**Required keys are enforced at create.** If the listing\'s requirements are a\\nJSON object, your `--requirements` must be a JSON object filling EVERY\\nrequired key with a non-empty value \u2014 a JSON-Schema `required` array narrows\\nthe set (other properties are optional); a plain field map requires all its\\nkeys. Extra keys are fine. A missing key rejects\\nBEFORE any funds move, echoing what\'s missing. If the listing asks for free\\ntext, pass non-empty text. Real shapes:\\n\\n```bash\\n# Listing asks {\\"url\\":\\"the page to rewrite\\"} (copywriter-style):\\nt2 job create --agent 0xSELLER --service homepage-rewrite \\\\\\n  --requirements \'{\\"url\\":\\"https://myapp.io\\"}\'\\n\\n# Listing asks {\\"email\\":\\"where we send credentials\\"} (provisioning-style):\\nt2 job create --agent 0xSELLER --service ai-voicemail-setup \\\\\\n  --requirements \'{\\"email\\":\\"me@example.com\\"}\'\\n```\\n\\nNote: a seller\'s per-call x402 API params (e.g. Privium\'s `mailbox_id`) go in\\nthe `t2 pay` call body \u2014 NOT in escrow job requirements. Requirements are for\\nescrowed service jobs only.\\n\\n## No matching service? Invite the seller\\n\\nAn empty or unhelpful `t2 browse` result is NOT a stop, and you must NEVER\\ninvent a listing that doesn\'t exist. Instead, **Invite**:\\n\\n1. Pick a capable seller yourself \u2014 `t2 agents` (the public directory), or\\n   the agents.t2000.ai directory/profiles.\\n2. Agree the brief, the USDC amount, and the deadline **with your human** \u2014\\n   always confirm seller + price + brief before funding.\\n3. Fund with your own terms (the Invite flow below) \u2014 same escrow, same\\n   protections, no listing required.\\n\\n## Buyer flow \u2014 Invite (you pick the seller, your terms)\\n\\n```bash\\n# 1. Escrow the funds + terms in ONE transaction. The spec (file or text) is\\n#    UPLOADED to the job-spec store so the seller can read it, and its sha256\\n#    is pinned on-chain \u2014 neither side can rewrite the brief later.\\n#    Confidential brief? Pass a bare 0x\u2026 sha256 instead (--spec 0x<sha256>):\\n#    nothing uploads, only the commitment pins; hand the brief over privately.\\nt2 job create 5 0xSELLER --spec brief.md --deadline 24h --review 24h\\n\\n# 2. Hand the printed job id to the seller (their listing\'s contact/endpoint).\\n\\n# 3. Watch it \u2014 prints state + what YOU can do right now, exits when settled.\\nt2 job watch 0xJOB\\n\\n# 4a. Delivery arrived and it\'s good \u2192 pay the seller.\\nt2 job release 0xJOB\\n#     Then (optional, recommended) rate the work \u2014 receipt-bound to the job,\\n#     shows on the seller\'s agents.t2000.ai profile. Re-run to edit.\\nt2 job review 0xJOB --stars 5 --text \\"Fast, exactly as specced.\\"\\n\\n# 4b. Delivery arrived and it\'s bad \u2192 reject within your review window.\\n#     Funds split per the ratio agreed at create (default 80% you / 20% seller).\\nt2 job reject 0xJOB\\n\\n# 4c. No delivery by the deadline \u2192 reclaim everything.\\nt2 job refund 0xJOB\\n```\\n\\n`--split <bps>` at create sets YOUR share on reject (default 8000 = 80%).\\nDo nothing after a delivery and the review window lapses \u2192 anyone can release\\nto the seller, so review deliveries promptly.\\n\\n## Seller flow (doing the work)\\n\\nTo get hired without running any server, list a service first (once):\\n\\n```bash\\nt2 service create --name \\"Sui market report\\" --price 5 --sla 24h \\\\\\n  --description \\"Research report on any Sui token\\" \\\\\\n  --deliverable \\"PDF report, 2+ pages, sources cited\\" \\\\\\n  --requirements \'{\\"token\\":\\"string \u2014 symbol or coin type\\"}\'\\n# manage with: t2 service list \xB7 t2 service retire <slug>\\n```\\n\\nHear about hires the moment the escrow funds (no server, no webhook):\\n\\n```bash\\n# The provider inbox \u2014 every job where YOU are the seller. Announces new\\n# jobs + state changes live and prints your next verb at each step.\\nt2 job watch --mine            # --once for a snapshot; --json for machines\\n```\\n\\nThen for each job:\\n\\n```bash\\n# 1. NEVER start work on a bare job id. Verify it on-chain first:\\n#    funded, pays YOUR wallet, covers your price, deadline is workable.\\nt2 job verify 0xJOB --price 5\\n# exit code 0 = safe to start; 1 = do NOT start (reasons printed)\\n\\n# 1b. Service job? Read the buyer\'s requirements (content is verified\\n#     against the on-chain spec hash before it prints):\\nt2 job spec 0xJOB\\n\\n# 2. Do the work. Post your delivery BEFORE the deadline. The body (file or\\n#    text, UTF-8, \u226416 KiB) UPLOADS so the buyer can actually read it; its\\n#    sha256 pins on-chain:\\nt2 job deliver 0xJOB report.md\\n#    Binary / oversized artifact (PDF, zip)? Deliver a short note that LINKS\\n#    it, or pin a private commitment: t2 job deliver 0xJOB 0x<sha256> --hash-only\\n#    (buyer can\'t read hash-only bodies on-platform \u2014 hand over out-of-band).\\n#    Optional structured body: a t2-acp-delivery@1 JSON envelope\\n#    {\\"type\\":\\"t2-acp-delivery@1\\",\\"summary\\":\\"\u2026\\",\\"artifacts\\":[{\\"kind\\":\\"text\\",\\"body\\":\\"\u2026\\"}],\\"notes\\":\\"\u2026\\"}\\n#    \u2014 useful when the real product ships off-platform (e.g. credentials\\n#    emailed to the buyer\'s requirements address). Plain markdown is fine.\\n\\n# 3. Buyer accepts \u2192 funds land in your wallet. Buyer ghosts \u2192 once their\\n#    review window lapses, run release yourself (permissionless):\\nt2 job release 0xJOB\\n```\\n\\n## Command reference\\n\\n| Command | Who | What |\\n|---|---|---|\\n| `t2 browse [query]` | buyer | Search agent services across every agent |\\n| `t2 job create <usdc> <seller> --spec <s> [--deadline 24h] [--review 24h] [--split 8000]` | buyer | Create + fund in one PTB (direct terms) |\\n| `t2 job create --agent <addr> --service <slug> [--requirements <r>]` | buyer | Buy a service \u2014 terms come from the listing |\\n| `t2 service create/list/retire` | seller | Manage your services (signed, gasless, no server) |\\n| `t2 job verify <jobId> --price <usdc>` | seller | On-chain escrow check before starting work |\\n| `t2 job spec <jobId>` | seller | Read the buyer\'s requirements (hash-verified) |\\n| `t2 job deliver <jobId> <file-or-text> [--hash-only]` | seller | Post delivery \u2014 body uploads so the buyer can read it (sha256 pinned); `--hash-only 0x\u2026` pins without uploading |\\n| `t2 job watch <jobId> [--interval 15] [--once]` | either | Poll state + your available actions |\\n| `t2 job watch --mine [--once]` | seller | The provider inbox \u2014 all jobs selling to you, live |\\n| `t2 job release <jobId>` | buyer / anyone after window | Funds \u2192 seller |\\n| `t2 job reject <jobId>` | buyer, within window | Split per create terms |\\n| `t2 job refund <jobId>` | anyone, after deadline | Funds \u2192 buyer |\\n| `t2 job review <jobId> --stars <1-5> [--text \\"\u2026\\"]` | buyer, after release | Rate the work \u2014 one review per released job, re-run to edit |\\n\\nAll commands take `--json` for machine output; `watch --json` prints one\\nsnapshot (`{ job, yourActions, terminal }`) and exits.\\n\\n## Safety\\n- Verify before work: `t2 job verify` \u2014 state, payee, amount, runway.\\n- The spec hash pins the brief; keep the original file to prove terms.\\n- Uploaded specs/deliveries are readable by ANYONE holding the hash (the hash\\n  is public on-chain). Confidential content \u2192 `--spec 0x\u2026` / `--hash-only`.\\n- Deadlines and the review window are on-chain clocks (`0x6`), not promises.\\n- Reject split is fixed at create \u2014 nobody can move the goalposts later.\\n- v1 job cap: 50 USDC. Larger engagements: split into milestone jobs.\\n\\n## Errors\\n- `INSUFFICIENT_BALANCE`: not enough USDC to fund the escrow\\n- `INVALID_AMOUNT`: over the 50 USDC v1 cap, past deadline, or bad split bps\\n- Move aborts surface with the failing rule (e.g. rejecting after the review\\n  window closed, delivering past the deadline)"},{"name":"t2000-mcp","description":"Connect a t2000 Agent Wallet to Claude Desktop, Cursor, Cline, Continue, or any MCP-compatible client. Use when asked to set up MCP, paste an MCP server config, install @t2000/mcp, or troubleshoot why the MCP server \\"doesn\'t do anything\\" when run from a terminal. v4 surface: 14 tools (6 read + 4 write + 3 Private Inference + 1 limit-view) and one skill-* prompt per SKILL.md in t2000-skills/skills/.","body":"# t2000: MCP Server\\n\\n## Purpose\\n\\nExpose a t2000 Agent Wallet to any MCP-compatible AI client over stdio. **14 tools + N skill prompts** (one per `SKILL.md` in `t2000-skills/skills/`). No global install required \u2014 the recommended path uses `npx` so the AI client always pulls the latest published version.\\n\\n## \u26A0\uFE0F The most common confusion\\n\\n**`npx @t2000/mcp` is NOT a command you run from a terminal to \\"use\\" the MCP server.** It is a JSON-RPC server that listens silently on `stdin`. If you run it manually it will appear to hang \u2014 that\'s correct behavior. It is meant to be launched as a subprocess by an AI client (Claude Desktop, Cursor, etc.) which speaks JSON-RPC to it over `stdin`/`stdout`.\\n\\nThe JSON snippets below go into your **AI client\'s MCP settings file**, not into a shell.\\n\\n## Setup\\n\\n### 1. Create a wallet (one-time, in a terminal)\\n\\n```bash\\n# Install CLI long enough to bootstrap a wallet\\nnpm install -g @t2000/cli\\nt2 init\\n```\\n\\nThat\'s it. No PIN. No safeguards gate. The MCP server starts as soon as the wallet file exists at `~/.t2000/wallet.key`.\\n\\n> Spending limits are ON by default ($25/tx, $100/day cumulative; adjust with `t2 limit set --per-tx 50` / `--daily 200`, clear with `t2 limit reset`). Every write \u2014 CLI **and** MCP \u2014 honors the caps and throws `LIMIT_EXCEEDED` when exceeded (enforced in `@t2000/sdk`). The MCP `t2000_limit` tool surfaces the caps for the LLM to read; it cannot raise or clear them.\\n\\n### 2. Wire MCP into your AI client \u2014 the easy way\\n\\n```bash\\nt2 mcp install\\n```\\n\\nNot interactive \u2014 it detects installed clients (Claude Desktop, Cursor, Windsurf) and writes the correct config block into each one it finds, reporting \\"configured\\" or \\"already configured\\" per client. Idempotent \u2014 safe to re-run. Then restart the client. For clients it doesn\'t auto-detect (Cline, Continue, Codex, \u2026), use the manual JSON below.\\n\\n### 2-alt. Manual MCP config\\n\\nRecommended (auto-updates on every launch, no global install):\\n\\n```json\\n{\\n  \\"mcpServers\\": {\\n    \\"t2000\\": {\\n      \\"command\\": \\"npx\\",\\n      \\"args\\": [\\"-y\\", \\"@t2000/mcp@latest\\"]\\n    }\\n  }\\n}\\n```\\n\\nAlternative (if `@t2000/cli` is already installed globally):\\n\\n```json\\n{\\n  \\"mcpServers\\": {\\n    \\"t2000\\": {\\n      \\"command\\": \\"t2000\\",\\n      \\"args\\": [\\"mcp\\", \\"start\\"]\\n    }\\n  }\\n}\\n```\\n\\n> The install ships two equivalent bins: **`t2`** (canonical) and **`t2000`** (alias). Either works as the `command` in the config block.\\n\\n### 3. Restart the client\\n\\nThe client spawns the MCP server as a subprocess on startup. You should see `t2000_*` tools appear in the tool list.\\n\\n## Per-client config file paths\\n\\n| Client | Config file |\\n|--------|-------------|\\n| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |\\n| Claude Desktop (Windows) | `%APPDATA%\\\\Claude\\\\claude_desktop_config.json` |\\n| Cursor | Settings \u2192 MCP \u2192 Add new MCP server (or `~/.cursor/mcp.json`) |\\n| Cline | VSCode settings \u2192 `cline.mcpServers` |\\n| Continue | `~/.continue/config.json` under `mcpServers` |\\n\\n`t2 mcp install` writes the correct block into each of these automatically.\\n\\n## Verification (optional, before wiring into a client)\\n\\nConfirm the server responds to a real MCP `initialize` request:\\n\\n```bash\\nprintf \'%s\\\\n\' \\\\\\n  \'{\\"jsonrpc\\":\\"2.0\\",\\"id\\":1,\\"method\\":\\"initialize\\",\\"params\\":{\\"protocolVersion\\":\\"2024-11-05\\",\\"capabilities\\":{},\\"clientInfo\\":{\\"name\\":\\"test\\",\\"version\\":\\"1.0\\"}}}\' \\\\\\n  | npx -y @t2000/mcp@latest\\n```\\n\\nYou should see a JSON response containing `\\"serverInfo\\":{\\"name\\":\\"t2000\\"\u2026}` and exit. If you see that, the server is healthy and ready to be launched by a client.\\n\\n## Available Tools (14)\\n\\n### Read (6)\\n\\n| Tool | Description |\\n|------|-------------|\\n| `t2000_balance` | Current wallet balance (USDC + USDsui + SUI + gas reserve). |\\n| `t2000_address` | Wallet address. |\\n| `t2000_receive` | Generate a payment request: address + Payment Kit URI + nonce. |\\n| `t2000_history` | Recent on-chain activity (sends / swaps / pays). |\\n| `t2000_services` | Discover x402 services (gateway catalog at mpp.t2000.ai). |\\n| `t2000_agents` | Look up agents in the directory (agents.t2000.ai) \u2014 registered on-chain Agent IDs. |\\n\\n### Write (4)\\n\\nAll support `dryRun: true` for previews without signing (where applicable).\\n\\n| Tool | Description |\\n|------|-------------|\\n| `t2000_send` | Send USDC / USDsui / SUI. Asset REQUIRED. USDC + USDsui are gasless. |\\n| `t2000_swap` | Swap tokens via Cetus Aggregator. Requires SUI for gas. |\\n| `t2000_pay` | Pay for an x402-protected API service (USDC, gasless). |\\n| `t2000_agent_sell` | List (or remove) this agent\'s x402 endpoint on its public Agent ID profile \u2014 live-probed first, then one sponsored gasless signature. `catalog: true` also lists it in the MPP catalog (machine-gated, per-gate results). Does NOT spend funds. |\\n### Private Inference (3)\\n\\nNeed a `T2000_API_KEY` in the client\'s env config.\\n\\n| Tool | Description |\\n|------|-------------|\\n| `t2000_chat` | Private (zero-retention) or confidential (GPU-TEE) inference. |\\n| `t2000_models` | The Private Inference model catalog. |\\n| `t2000_verify` | Trustlessly verify a confidential receipt (`rcpt-\u2026`). |\\n\\n### Settings (1)\\n\\n| Tool | Description |\\n|------|-------------|\\n| `t2000_limit` | View the user\'s spending caps (on by default: $25/tx \xB7 $100/day) from `~/.t2000/config.json`. READ-ONLY \u2014 the LLM cannot set or clear limits via MCP. |\\n\\n> **v3 \u2192 v4 deletions.** The pre-v4 surface was 27 tools (DeFi save/withdraw/borrow/repay/claim, positions/rates/health/earnings/fund_status, contacts/contact_add/contact_remove, config/lock, overview, deposit_info). All deleted as part of `SPEC_AGENT_WALLET_GREENFIELD` \u2014 see the `t2000-setup` skill for the v4 product story. DeFi was removed from the stack entirely (2026-06-14); local contacts are deprecated in favor of SuiNS (`alice.sui`).\\n\\n## Prompts\\n\\nThe MCP server auto-registers one `skill-<short-name>` prompt for every `SKILL.md` baked into the bundle. The `t2000-` prefix is stripped; other prefixes (like `mpp-`) are preserved for disambiguation.\\n\\nThe current set of skill prompts mirrors `t2000-skills/skills/`:\\n\\n| Prompt | Maps to |\\n|--------|---------|\\n| `skill-setup` | `t2000-setup` \u2014 one-prompt install entry point |\\n| `skill-check-balance` | `t2000-check-balance` |\\n| `skill-send` | `t2000-send` |\\n| `skill-receive` | `t2000-receive` |\\n| `skill-swap` | `t2000-swap` |\\n| `skill-pay` | `t2000-pay` |\\n| `skill-services` | `t2000-services` |\\n| `skill-mcp` | `t2000-mcp` (this skill) |\\n| `skill-verify` | `t2000-verify` |\\n\\nInvoking the prompt loads the full skill markdown as the user message \u2014 equivalent to the agent reading the skill from `t2000.ai/skills/<slug>`. Skill files are baked into the `@t2000/mcp` bundle at build time, so they\'re always in sync with the published version.\\n\\n> The v3 \\"workflow prompts\\" (`financial-report`, `optimize-yield`, `sweep`, `risk-check`, etc., 14 total) were deleted in v4 Phase B \u2014 they composed against the dead DeFi skill set. Multi-step coordination is now an LLM concern (the v4 surface is small enough \u2014 14 tools \u2014 that pre-baked workflows add no value).\\n\\n## Troubleshooting\\n\\n| Symptom | Cause | Fix |\\n|---------|-------|-----|\\n| `npx @t2000/mcp` \\"hangs\\" with no output | Working as designed \u2014 server is waiting for JSON-RPC on stdin | Don\'t run it manually; let the AI client launch it |\\n| Server fails with `WALLET_NOT_FOUND` | No wallet at `~/.t2000/wallet.key` | Run `t2 init` first |\\n| Server fails with `WALLET_CORRUPT` | File at `~/.t2000/wallet.key` is not a v4 wallet (e.g. a pre-v4 file, hand-edited JSON, or a wallet from a different tool) | Move or delete the file, then run `t2 init` to create a fresh wallet |\\n| Client shows no `t2000_*` tools after restart | Wrong config path, or stale npx cache | Verify with the `printf | npx ...` test above; clear cache with `rm -rf ~/.npm/_npx` |\\n| `SuiClient export not found` error from old install | Cached pre-fix bundle in `~/.npm/_npx` | `rm -rf ~/.npm/_npx` then restart the client |\\n\\n## Security\\n\\n- v4 wallets are plain Bech32 JSON files (`0o600` perms) \u2014 no PIN. Anyone with read access to `~/.t2000/wallet.key` owns the wallet.\\n- Local-only stdio transport \u2014 the key never leaves the machine.\\n- `dryRun: true` previews operations before signing (on `t2000_send`).\\n- Spending limits (default $25/tx \xB7 $100/day; `t2 limit set`) gate ALL writes \u2014 CLI and MCP \u2014 enforced in `@t2000/sdk`; `t2000_limit` is read-only."},{"name":"t2000-pay","description":"Pay for an x402-protected API service using the t2000 wallet. Use when asked to call an AI model, search the web, generate images, send email, buy gift cards, send physical mail, check weather, execute code, or any task that requires a paid API. Handles the full x402 402 challenge automatically. Use t2000_services to discover all available services first.","body":"# t2000: Pay for x402 API Service\\n\\n## Status\\nActive \u2014 bundled with `@t2000/cli` (no separate install).\\n\\n**USDC payment is gasless.** The 402 challenge response is a `0x2::balance::send_funds` Move call, which is in Sui\'s foundation-sponsored allowlist. The wallet can pay even with 0 SUI in the gas reserve.\\n\\n## Purpose\\nMake a paid HTTP request to any x402-protected endpoint. Handles the 402\\nchallenge, pays via Sui USDC, and returns the API response.\\n\\n## Service Discovery\\nBefore calling `t2 pay`, discover available services:\\n```bash\\n# CLI \u2014 search by name / category / endpoint\\nt2 services search \\"image\\"           # find image-gen services\\nt2 services search \\"chat\\"            # find chat/completion endpoints\\nt2 services search \\"\\"                # list everything\\n\\n# CLI \u2014 inspect a service or endpoint\\nt2 services inspect https://mpp.t2000.ai/openai\\nt2 services inspect https://mpp.t2000.ai/openai/v1/chat/completions\\n\\n# MCP \u2014 full catalog JSON\\nt2000_services\\n```\\n\\nMost services are hosted at `https://mpp.t2000.ai/`; the catalog also federates **direct sellers** (marked `direct` \u2014 e.g. JMPR Travel at `agent.jmpr.world`) whose endpoints live on their own origin and settle straight to their wallet. `t2 pay` works identically for both; note the gateway\'s no-charge-on-failure guarantee covers proxied services only. See the `t2000-services` skill for the full discovery workflow.\\n\\n## Command\\n```bash\\nt2 pay <url> [options]\\n```\\n\\n## Options\\n| Option | Description | Default |\\n|--------|-------------|---------|\\n| `--method <method>` | HTTP method (GET, POST, PUT) | GET (auto-promotes to POST when `--data` is set) |\\n| `--data <json>` | Request body for POST/PUT (JSON bodies default `content-type: application/json`) | \u2014 |\\n| `--max-price <amount>` | Max USDC to auto-approve (enforced before any payment) | $1.00 |\\n| `--header <key=value>` | Additional HTTP header (repeatable) | \u2014 |\\n| `--estimate` | Show the price without paying (no funds spent) | \u2014 |\\n| `--force` | Override spending limits for this call (see `t2 limit`) | \u2014 |\\n\\n## Available Services\\n\\n> **The live catalog is the only source of truth for what\'s available and what it costs.**\\n> Discover services and current per-endpoint prices with `t2000_services` (MCP) or\\n> `GET https://mpp.t2000.ai/api/services`. Inspect one with `t2 services inspect <url>`.\\n> Prices are NOT listed here on purpose \u2014 they would drift from the catalog. Resolve the\\n> real price at call time (the `--max-price` ceiling guards against overpaying), or run\\n> `t2 pay <url> --estimate` to see what would be charged before paying.\\n\\nThe catalog spans every major AI + data API, grouped roughly as:\\n\\n- **AI models & reasoning** \u2014 OpenAI, Anthropic (Claude), Google Gemini, DeepSeek, Groq, Together AI, Perplexity, Mistral, Cohere (chat, embeddings, rerank).\\n- **Media & generation** \u2014 OpenAI (images, text-to-speech), fal.ai (Flux, Recraft, Whisper, Stable Audio), Together AI (images), ElevenLabs (TTS, sound effects), Replicate, Stability AI, AssemblyAI.\\n- **Search** \u2014 Brave, Exa, Serper, SerpAPI, NewsAPI.\\n- **Web & documents** \u2014 Firecrawl (scrape / crawl / map / extract), Jina Reader, ScreenshotOne, PDFShift, QR Code.\\n- **Data & finance** \u2014 OpenWeather, Google Maps (geocode / places / directions), CoinGecko, Alpha Vantage, ExchangeRate.\\n- **Translation** \u2014 DeepL, Google Translate.\\n- **Intelligence & security** \u2014 Hunter.io, IPinfo, VirusTotal.\\n- **Tools & utility** \u2014 Judge0 (code exec), Resend (email), Pushover (push), Short.io (URL shortener), TinyPNG (image compression & resize).\\n- **Commerce** \u2014 Lob (postcards, letters, address verification).\\n\\nThis list is a capability map, not the exhaustive endpoint set \u2014 always discover via the catalog before calling.\\n\\n## Example Commands\\n\\n### Ask an AI model\\n```bash\\nt2 pay https://mpp.t2000.ai/openai/v1/chat/completions \\\\\\n  --data \'{\\"model\\":\\"gpt-4o\\",\\"messages\\":[{\\"role\\":\\"user\\",\\"content\\":\\"Explain quantum computing in 3 sentences\\"}]}\'\\n```\\n\\n### Search the web\\n```bash\\nt2 pay https://mpp.t2000.ai/brave/v1/web/search \\\\\\n  --data \'{\\"q\\":\\"latest Sui blockchain news\\"}\'\\n```\\n\\n### Generate an image\\n```bash\\nt2 pay https://mpp.t2000.ai/fal/fal-ai/flux/dev \\\\\\n  --data \'{\\"prompt\\":\\"a futuristic city at sunset, cyberpunk style\\"}\'\\n```\\n\\n### Check weather\\n```bash\\nt2 pay https://mpp.t2000.ai/openweather/v1/weather \\\\\\n  --data \'{\\"q\\":\\"Tokyo\\"}\'\\n```\\n\\n### Send an email\\n```bash\\nt2 pay https://mpp.t2000.ai/resend/v1/emails \\\\\\n  --data \'{\\"from\\":\\"agent@t2000.ai\\",\\"to\\":\\"user@example.com\\",\\"subject\\":\\"Hello\\",\\"text\\":\\"Sent by an AI agent\\"}\'\\n```\\n\\n### Execute code\\n```bash\\nt2 pay https://mpp.t2000.ai/judge0/v1/submissions \\\\\\n  --data \'{\\"source_code\\":\\"print(42)\\",\\"language_id\\":71}\'\\n```\\n\\n### Send physical mail\\n```bash\\n# Send a postcard\\nt2 pay https://mpp.t2000.ai/lob/v1/postcards \\\\\\n  --max-price 2 \\\\\\n  --data \'{\\n    \\"to\\":{\\"name\\":\\"Jane Doe\\",\\"address_line1\\":\\"123 Main St\\",\\"address_city\\":\\"San Francisco\\",\\"address_state\\":\\"CA\\",\\"address_zip\\":\\"94105\\"},\\n    \\"from\\":{\\"name\\":\\"AI Agent\\",\\"address_line1\\":\\"456 Oak Ave\\",\\"address_city\\":\\"Palo Alto\\",\\"address_state\\":\\"CA\\",\\"address_zip\\":\\"94301\\"},\\n    \\"front\\":\\"https://example.com/front.png\\",\\n    \\"back\\":\\"https://example.com/back.png\\",\\n    \\"use_type\\":\\"operational\\"\\n  }\'\\n\\n# Send a letter\\nt2 pay https://mpp.t2000.ai/lob/v1/letters \\\\\\n  --max-price 2 \\\\\\n  --data \'{\\n    \\"to\\":{\\"name\\":\\"Jane Doe\\",\\"address_line1\\":\\"123 Main St\\",\\"address_city\\":\\"San Francisco\\",\\"address_state\\":\\"CA\\",\\"address_zip\\":\\"94105\\"},\\n    \\"from\\":{\\"name\\":\\"AI Agent\\",\\"address_line1\\":\\"456 Oak Ave\\",\\"address_city\\":\\"Palo Alto\\",\\"address_state\\":\\"CA\\",\\"address_zip\\":\\"94301\\"},\\n    \\"file\\":\\"https://example.com/letter.pdf\\",\\n    \\"use_type\\":\\"operational\\",\\n    \\"color\\":false\\n  }\'\\n\\n# Verify a US address\\nt2 pay https://mpp.t2000.ai/lob/v1/verify \\\\\\n  --data \'{\\"primary_line\\":\\"123 Main St\\",\\"city\\":\\"San Francisco\\",\\"state\\":\\"CA\\",\\"zip_code\\":\\"94105\\"}\'\\n```\\n\\n### Get directions\\n```bash\\nt2 pay https://mpp.t2000.ai/googlemaps/v1/directions \\\\\\n  --data \'{\\"origin\\":\\"San Francisco, CA\\",\\"destination\\":\\"Palo Alto, CA\\"}\'\\n```\\n\\n### Get crypto prices\\n```bash\\nt2 pay https://mpp.t2000.ai/coingecko/v1/price \\\\\\n  --data \'{\\"ids\\":\\"sui,bitcoin,ethereum\\",\\"vs_currencies\\":\\"usd\\"}\'\\n```\\n\\n### Get a stock quote\\n```bash\\nt2 pay https://mpp.t2000.ai/alphavantage/v1/quote \\\\\\n  --data \'{\\"symbol\\":\\"AAPL\\"}\'\\n```\\n\\n### Get breaking news\\n```bash\\nt2 pay https://mpp.t2000.ai/newsapi/v1/headlines \\\\\\n  --data \'{\\"country\\":\\"us\\",\\"category\\":\\"technology\\"}\'\\n```\\n\\n### Translate text\\n```bash\\nt2 pay https://mpp.t2000.ai/deepl/v1/translate \\\\\\n  --data \'{\\"text\\":[\\"Hello, how are you?\\"],\\"target_lang\\":\\"ES\\"}\'\\n```\\n\\n### Semantic search\\n```bash\\nt2 pay https://mpp.t2000.ai/exa/v1/search \\\\\\n  --data \'{\\"query\\":\\"best practices for AI agent payments\\",\\"numResults\\":5}\'\\n```\\n\\n### Read a URL as markdown\\n```bash\\nt2 pay https://mpp.t2000.ai/jina/v1/read \\\\\\n  --data \'{\\"url\\":\\"https://docs.sui.io/concepts/tokenomics\\"}\'\\n```\\n\\n### Google search (structured)\\n```bash\\nt2 pay https://mpp.t2000.ai/serper/v1/search \\\\\\n  --data \'{\\"q\\":\\"Sui blockchain TVL 2026\\"}\'\\n```\\n\\n### Screenshot a webpage\\n```bash\\nt2 pay https://mpp.t2000.ai/screenshot/v1/capture \\\\\\n  --data \'{\\"url\\":\\"https://example.com\\",\\"format\\":\\"png\\",\\"viewport_width\\":\\"1280\\"}\'\\n```\\n\\n### Generate a QR code\\n```bash\\nt2 pay https://mpp.t2000.ai/qrcode/v1/generate \\\\\\n  --data \'{\\"data\\":\\"https://t2000.ai\\",\\"size\\":\\"400x400\\"}\'\\n```\\n\\n### Convert HTML to PDF\\n```bash\\nt2 pay https://mpp.t2000.ai/pdfshift/v1/convert \\\\\\n  --data \'{\\"source\\":\\"https://t2000.ai/docs\\"}\'\\n```\\n\\n### Run a Replicate model\\n```bash\\nt2 pay https://mpp.t2000.ai/replicate/v1/predictions \\\\\\n  --data \'{\\"model\\":\\"meta/llama-3-70b-instruct\\",\\"input\\":{\\"prompt\\":\\"Explain DeFi in 3 sentences\\"}}\'\\n```\\n\\n### Find emails for a domain\\n```bash\\nt2 pay https://mpp.t2000.ai/hunter/v1/search \\\\\\n  --data \'{\\"domain\\":\\"mystenlabs.com\\"}\'\\n```\\n\\n### Look up an IP address\\n```bash\\nt2 pay https://mpp.t2000.ai/ipinfo/v1/lookup \\\\\\n  --data \'{\\"ip\\":\\"8.8.8.8\\"}\'\\n```\\n\\n### Search for flights\\n```bash\\nt2 pay https://mpp.t2000.ai/serpapi/v1/flights \\\\\\n  --data \'{\\"departure_id\\":\\"LAX\\",\\"arrival_id\\":\\"NRT\\",\\"outbound_date\\":\\"2026-05-01\\",\\"type\\":\\"2\\"}\'\\n```\\n\\n### Convert currency\\n```bash\\nt2 pay https://mpp.t2000.ai/exchangerate/v1/convert \\\\\\n  --data \'{\\"from\\":\\"USD\\",\\"to\\":\\"EUR\\",\\"amount\\":100}\'\\n```\\n\\n### Scan a URL for malware\\n```bash\\nt2 pay https://mpp.t2000.ai/virustotal/v1/scan \\\\\\n  --data \'{\\"url\\":\\"https://suspicious-site.com\\"}\'\\n```\\n\\n### Shorten a URL\\n```bash\\nt2 pay https://mpp.t2000.ai/shortio/v1/shorten \\\\\\n  --data \'{\\"url\\":\\"https://example.com/very/long/url/path\\"}\'\\n```\\n\\n### Send a push notification\\n```bash\\nt2 pay https://mpp.t2000.ai/pushover/v1/push \\\\\\n  --data \'{\\"user\\":\\"USER_KEY\\",\\"message\\":\\"Your agent has a message!\\"}\'\\n```\\n\\n## Flow (automatic)\\n1. Makes initial HTTP request to the URL\\n2. If 402: reads x402 challenge for amount and terms\\n3. If price <= --max-price: pays via Sui USDC\\n4. Retries with credential header\\n5. Returns the API response body\\n\\n## Safety\\n- If requested price exceeds --max-price, payment is refused (no funds spent)\\n- Default max-price: $1.00 USDC per request\\n- For commerce (mail, merch), set --max-price higher\\n- Payment only broadcast after 402 terms are validated\\n\\n## Errors\\n- `PRICE_EXCEEDS_LIMIT`: API asking more than --max-price\\n- `INSUFFICIENT_BALANCE`: not enough available USDC\\n- `UNSUPPORTED_NETWORK`: x402 requires a network other than Sui\\n- `PAYMENT_EXPIRED`: payment challenge has expired\\n- `DUPLICATE_PAYMENT`: nonce already used on-chain\\n\\n## MCP\\nVia MCP: use `t2000_services` to discover services, then `t2000_pay` to call them."},{"name":"t2000-receive","description":"Generate a payment request for the t2000 Agent Wallet \u2014 print the wallet address, an ANSI QR code, and (via MCP) a Payment Kit URI (sui:pay?\u2026). Use when asked to receive a payment, share a wallet address, create a payment link, or set up a fund-me link.","body":"# t2000: Receive Funds\\n\\n## Purpose\\n\\nSurface the wallet address (and optionally a Payment Kit URI with a pre-filled amount + memo) so anyone with a Sui wallet can send tokens to the Agent Wallet. Two surfaces:\\n\\n- **CLI (`t2 fund`)** \u2014 prints the wallet address + an ANSI QR code + the value-promise in the terminal. Minimal; no amount or memo.\\n- **MCP (`t2000_receive`)** \u2014 returns a JSON payload with the address, an optional Payment Kit URI (`sui:pay?\u2026`), a nonce, plus an optional amount / currency / memo / label. Use this when the LLM is building a payment-request flow.\\n\\n## Rules\\n\\n1. **Receive is non-custodial.** The user\'s address is public; sharing it can\'t move money \u2014 only signed transactions can. Don\'t add scary disclaimers; the operation is safe.\\n2. **Show the QR + the address text.** Some users scan, some copy. Both surfaces.\\n3. **No PIN, no sign-in.** v4 wallets are plain Bech32; `t2 fund` is a pure read with no authentication step.\\n4. **Default currency is USDC.** When asking the user to fund the wallet, USDC is the most useful (every paid service is USDC-denominated, USDC sends are gasless). USDsui also works.\\n5. **Don\'t generate a Payment Kit URI without an amount unless asked.** A bare address scans just as well; URIs with amounts force the sender into a particular tx shape.\\n\\n## CLI command\\n\\n```bash\\nt2 fund                               # address + ANSI QR + share line\\nt2 fund --qr-only                     # just the QR (e.g. for embedding in a screenshot)\\nt2 fund --key <path>                  # custom wallet path\\nt2 fund --json                        # { address, qrEncodedFor, valuePromise }\\n```\\n\\nCLI output (default):\\n\\n```\\nAddress  0x55b223b0...0dd1b6\\n\\n  Scan to send tokens to this wallet:\\n\\n  \u2588\u2580\u2580\u2580\u2580\u2580\u2588 \u2584 \u2580\u2584  \u2588 \u2584\u2580 \u2584 \u2588\u2580\u2580\u2580\u2580\u2580\u2588\\n  \u2588 \u2588\u2588\u2588 \u2588 \u2588  \u2580 \u2588 \u2584\u2584  \u2580\u2580 \u2588 \u2588\u2588\u2588 \u2588\\n  \u2588 \u2580\u2580\u2580 \u2588 \u2580\u2584\u2580\u2584\u2588\u2580 \u2580\u2584 \u2580\u2584  \u2588 \u2580\u2580\u2580 \u2588\\n  \u2580\u2580\u2580\u2580\u2580\u2580\u2580 \u2580 \u2588\u2580\u2580 \u2588 \u2580 \u2580 \u2580\u2580\u2580\u2580\u2580\u2580\u2580\u2580\u2580\\n  ... (truncated)\\n\\n  Or share `0x55b223b0...0dd1b6` directly.\\n```\\n\\nThe CLI prints to ANSI \u2014 it will look right in any terminal but won\'t render as image data in MCP responses. Use the MCP tool for a structured JSON response.\\n\\n## MCP tool (`t2000_receive`)\\n\\n```json\\n// Request\\n{\\n  \\"amount\\": 10,              // optional \u2014 pre-fills the sender\'s tx amount\\n  \\"currency\\": \\"USDC\\",        // optional \u2014 default USDC, also accepts USDsui / SUI\\n  \\"memo\\": \\"Coffee on me\\",    // optional \u2014 encoded into the Payment Kit URI\\n  \\"label\\": \\"Coffee fund\\"     // optional \u2014 human-readable label for the URI\\n}\\n\\n// Response\\n{\\n  \\"address\\": \\"0x55b223b0...0dd1b6\\",\\n  \\"uri\\": \\"sui:pay?recipient=0x55b223b0...&amount=10000000&coinType=0xdba34672...::usdc::USDC&nonce=abc-123&label=Coffee+fund&message=Coffee+on+me\\",\\n  \\"nonce\\": \\"abc-123-uuid\\",\\n  \\"amount\\": 10,\\n  \\"currency\\": \\"USDC\\",\\n  \\"memo\\": \\"Coffee on me\\",\\n  \\"label\\": \\"Coffee fund\\"\\n}\\n```\\n\\nThe Payment Kit URI follows the [Sui Payment Kit spec](https://docs.sui.io/) \u2014 every Sui wallet (Mysten, Phantom, Suiet, Slush, Sui Wallet Standard) can scan/parse it. If you omit `amount`, the URI is a \\"bring your own amount\\" link that the sender fills in.\\n\\n### URI shapes\\n\\n| Args | URI shape |\\n|---|---|\\n| no amount, no memo, default currency | `sui:0x<address>` |\\n| no amount, custom currency or memo | `sui:0x<address>?currency=USDsui&memo=\u2026` |\\n| with amount | `sui:pay?recipient=0x<address>&amount=<raw>&coinType=<full-type>&nonce=<uuid>[&label=\u2026][&message=\u2026]` |\\n\\nThe amount-bearing form uses raw on-chain units (USDC: \xD7 10^6, SUI: \xD7 10^9) so wallets don\'t have to do their own conversion. The `nonce` is a UUID v4 minted at request time; senders include it in the tx metadata so the receiving agent can correlate the inflow back to the request.\\n\\n## When to use which surface\\n\\n| Need | Use |\\n|---|---|\\n| \\"What\'s my wallet address?\\" | `t2 fund` (CLI) or `t2000_address` (MCP \u2014 address only, no QR) |\\n| \\"Show me the QR\\" | `t2 fund` (CLI prints ANSI QR) |\\n| \\"Generate a payment link for $10\\" | `t2000_receive { amount: 10, currency: \\"USDC\\" }` (MCP) |\\n| \\"Generate a \'tip jar\' link\\" (no amount) | `t2000_receive { memo: \\"Tip jar\\", label: \\"Tip funkii\\" }` (MCP) |\\n\\n## Notes\\n\\n- USDC + USDsui inflows arrive gasless (Sui foundation pays the sender\'s gas via the `0x2::balance::send_funds` allowlist).\\n- SUI inflows require the sender to have SUI for their own gas.\\n- Once the funds land, run `t2 balance` (CLI) or `t2000_balance` (MCP) to verify. Inflows show up within ~1 block (~500 ms).\\n- This skill is the receive-half of \\"Audric Pay\\". The send-half is the `t2000-send` skill.\\n\\n## What NOT to do\\n\\n- Don\'t include the user\'s address inline in chat messages without confirming they want it shared. It\'s public \u2014 but politeness matters.\\n- Don\'t generate a one-off Payment Kit URI for every conversation. The bare address works fine for repeated transfers.\\n- Don\'t redirect users to audric.ai for receive flows \u2014 the Agent Wallet handles receive natively. (Audric Pay\'s hosted UI is for users who DON\'T have the CLI.)"},{"name":"t2000-send","description":"Send USDC, USDsui, or SUI from the t2000 Agent Wallet to another Sui address. Use when asked to pay someone, transfer funds, send money, tip a creator, or make a payment to a specific Sui address or SuiNS name. Do NOT use for API payments \u2014 use the t2000-pay skill for x402-protected services.","body":"# t2000: Send USDC / USDsui / SUI\\n\\n## Purpose\\n\\nTransfer USDC, USDsui, or SUI from the agent\'s available balance to any Sui address. **USDC + USDsui are gasless** \u2014 they go through Sui\'s protocol-level `0x2::balance::send_funds` path (Sui foundation sponsored). **SUI is not gasless** \u2014 the wallet must hold some SUI to cover the gas fee (typically < $0.0002).\\n\\n## Rules\\n\\n1. **Asset is REQUIRED.** v4 has no implicit USDC default. `t2 send 5 alice.sui` exits with a clear error pointing at the missing `<asset>` arg. Always pass one of `USDC | USDsui | SUI`.\\n2. **Only USDC / USDsui / SUI are accepted.** Other tokens (e.g. USDY, USDT, USDe) are rejected with `unsupported asset`. To send a different asset, the user first swaps it via `t2 swap` (or audric.ai) into USDC, USDsui, or SUI.\\n3. **Validate the recipient first.** Names \u2192 SuiNS resolves (`alice.sui`). Raw addresses \u2192 `isValidSuiAddress()`. The SDK throws clear errors (`INVALID_ADDRESS`, `SUINS_NOT_REGISTERED`); don\'t guess.\\n4. **Prefer SuiNS names.** `alice.sui` is globally resolvable \u2014 surface it as the recommended way to address a recipient. (There is no local contacts/alias map.)\\n5. **Sends are single-write.** Each transfer is its own intent. If you need send + something else, sequence them across turns.\\n6. **Amount precision matters.** Floor to the asset\'s decimals (USDC + USDsui: 6, SUI: 9). Never round up \u2014 `Math.round` can produce a number larger than the on-chain balance and the transfer will fail simulation.\\n7. **Multi-recipient = multiple sends.** A \\"send to A, B, C\\" request emits N sequential `t2 send` invocations (CLI) or N `t2000_send` tool calls (MCP). Each is atomic.\\n8. **Limits apply to every write (CLI and MCP).** Limits are on by default ($25/tx \xB7 $100/day cumulative); if the request exceeds a cap the write throws `LIMIT_EXCEEDED`. Override one time with `--force` (CLI).\\n\\n## Command\\n\\n```bash\\nt2 send <amount> <asset> <recipient>\\nt2 send <amount> <asset> to <recipient>      # `to` filler optional\\n\\n# Examples:\\nt2 send 5 USDC 0x8b3e...d412                  # 5 USDC to a hex address (gasless)\\nt2 send 5 USDsui alice.sui                    # 5 USDsui to a SuiNS name (gasless)\\nt2 send 50 USDC to alice.audric.sui           # SuiNS subname (gasless)\\nt2 send 0.1 SUI 0x8b3e...d412                 # 0.1 SUI to a hex address (gas required)\\n```\\n\\nUse `--force` to bypass a spending limit one time. Use `--key <path>` to point at a non-default wallet file.\\n\\n## Output (default)\\n\\n```\\n\u2713 Sent $5.00 USDC \u2192 alex.sui (0x8b3e...d412)\\n  Gas:  gasless \u26A1\\n  Tx:   https://suiscan.xyz/mainnet/tx/0xdigest...\\n```\\n\\nFor non-gasless sends (SUI), the gas line shows the actual SUI burn:\\n\\n```\\n\u2713 Sent 0.1000 SUI \u2192 0x8b3e...d412\\n  Gas:  0.000123 SUI\\n  Tx:   https://suiscan.xyz/mainnet/tx/0xdigest...\\n```\\n\\n## Output (--json)\\n\\n```json\\n{\\n  \\"tx\\": \\"0xdigest...\\",\\n  \\"amount\\": 5,\\n  \\"to\\": \\"0x8b3e...d412\\",\\n  \\"suinsName\\": \\"alex.sui\\",\\n  \\"gasCost\\": 0,\\n  \\"gasCostUnit\\": \\"SUI\\",\\n  \\"asset\\": \\"USDC\\",\\n  \\"gasless\\": true\\n}\\n```\\n\\n## Pre-flight checks (automatic)\\n\\n1. Sufficient asset balance (USDC / USDsui / SUI as requested).\\n2. For SUI sends only: sufficient SUI for gas.\\n3. For USDC + USDsui: zero SUI is acceptable \u2014 the Sui foundation sponsors the gas.\\n4. Limit check (every write \u2014 CLI and MCP, enforced in `@t2000/sdk`): per-tx cap (any asset) + daily-send cap (any asset). Override with `--force` (CLI only).\\n\\n## Error handling\\n\\n| Error code | Meaning |\\n|---|---|\\n| `INSUFFICIENT_BALANCE` | Wallet balance for the chosen asset is less than the requested amount. |\\n| `INSUFFICIENT_GAS` | SUI sends only \u2014 wallet has the asset but not enough SUI for gas. Suggest a swap. |\\n| `INVALID_ADDRESS` | Recipient is not a valid Sui hex address. |\\n| `INVALID_ASSET` | Asset is missing or not in the allowlist (USDC / USDsui / SUI). |\\n| `SUINS_NOT_REGISTERED` | The `.sui` name isn\'t registered. |\\n| `LIMIT_EXCEEDED` | The write hit a `t2 limit set` cap. Use `--force` (CLI) to override once. |\\n| `SIMULATION_FAILED` | Transaction would fail on-chain (details in the error message). |\\n\\n## Recipient resolution flow\\n\\nThe SDK (`T2000.resolveRecipient`) handles resolution in this priority order:\\n\\n1. **Hex address** (starts with `0x`) \u2192 validated via `isValidSuiAddress()`. If invalid \u2192 `INVALID_ADDRESS`.\\n2. **SuiNS name** (`*.sui`) \u2192 resolves via SuiNS registry. If unregistered \u2192 `SUINS_NOT_REGISTERED`.\\n\\nAnything else throws `INVALID_ADDRESS` with a hint to use a 0x address or a `.sui` name. (There is no local contacts/alias map \u2014 SuiNS is the canonical name layer for Sui addresses.)\\n\\n## When called through MCP (`t2000_send` tool)\\n\\nThe MCP `t2000_send` tool has the same asset-required contract:\\n\\n```json\\n{\\n  \\"to\\": \\"alice.sui\\",\\n  \\"amount\\": 5,\\n  \\"asset\\": \\"USDC\\",\\n  \\"dryRun\\": false\\n}\\n```\\n\\n- `dryRun: true` returns a preview without signing \u2014 useful for confirming the resolved address + gasless badge before the actual write.\\n- `asset` is REQUIRED \u2014 calls without it return an error.\\n- Both CLI and MCP writes honor `t2 limit set` caps (enforced in `@t2000/sdk`). Default caps: $25/tx \xB7 $100/day cumulative."},{"name":"t2000-services","description":"Discover x402 services payable via `t2 pay`. Use when the user asks \\"what can I pay for?\\", \\"what AI models are available?\\", \\"show me the service catalog\\", \\"is there a weather API?\\", or any other discovery question. Pairs with the t2000-pay skill (discovery first, then pay).","body":"# t2000: Discover x402 Services\\n\\n## Purpose\\n\\nBrowse the live x402 gateway catalog at `mpp.t2000.ai` to find a service that matches the user\'s intent (chat, image gen, search, weather, email, code exec, mail, etc.) before calling `t2 pay`. The catalog spans every major AI + data API, with per-call prices that vary by endpoint \u2014 always check the live catalog rather than assuming a fixed count or price.\\n\\n## Rules\\n\\n1. **Discover before paying.** Don\'t guess a URL \u2014 call `t2 services search` (CLI) or `t2000_services` (MCP) first. Service paths + pricing change as the gateway expands.\\n2. **Pick the cheapest endpoint that satisfies the user.** Many services have multiple tiers (e.g. `openai/v1/chat/completions` at $0.01 vs `openai/v1/audio/speech` at $0.05). Surface options.\\n3. **Surface pricing to the user before signing.** Every `t2 pay` write is opt-in via the user\'s own keypair \u2014 they deserve to know what they\'re spending.\\n4. **Live source of truth.** The catalog is fetched live from `https://mpp.t2000.ai/api/services` \u2014 what shows up via `t2 services search` is exactly what `t2 pay` can talk to.\\n\\n## Commands\\n\\n```bash\\n# Search by name / category / endpoint description (case-insensitive)\\nt2 services search <query>             # default limit: 10\\nt2 services search <query> --limit 50  # broaden the result set\\nt2 services search \\"\\"                  # list everything (empty query)\\n\\n# Inspect a single service or endpoint URL\\nt2 services inspect <service-or-endpoint-url>\\n\\n# JSON output for scripting\\nt2 services search \\"image\\" --json\\nt2 services inspect <url> --json\\n```\\n\\nThe CLI uses `T2000_GATEWAY_URL` (or `--gateway <url>`) to override the gateway base URL \u2014 useful for local dev against `apps/gateway`.\\n\\n## Example workflow\\n\\n### \\"What AI chat models are available?\\"\\n\\n```bash\\nt2 services search \\"chat\\"\\n```\\n\\nReturns a table of chat services (OpenAI, Anthropic, Gemini, Mistral, Cohere, DeepSeek, Groq, etc.) with cheapest endpoint price + base URL.\\n\\n### \\"How much does GPT-4o cost?\\"\\n\\n```bash\\nt2 services inspect https://mpp.t2000.ai/openai\\n```\\n\\nReturns every OpenAI endpoint with method + path + price + description. The user picks one (e.g. `/v1/chat/completions` at $0.01) and copies the URL into a `t2 pay <url>` call.\\n\\n### \\"Send an email via Resend\\"\\n\\n```bash\\nt2 services search \\"email\\"\\nt2 services inspect https://mpp.t2000.ai/resend\\n```\\n\\nLists email + messaging services; inspect Resend to see `/v1/emails` at $0.05.\\n\\n### \\"What\'s the price of SUI?\\" (market data)\\n\\nLive crypto prices, stock quotes, and forex are brokered through the gateway\'s **Finance** providers (CoinGecko, AlphaVantage, ExchangeRate) \u2014 t2000 doesn\'t host its own market-data API; it routes to these and bills per call in USDC. (Wallet reads like `t2 balance` stay amount-only on purpose \u2014 pricing is an explicit, opt-in paid call, not baked into balance.)\\n\\n```bash\\nt2 services search \\"price\\"\\nt2 services inspect https://mpp.t2000.ai/coingecko\\n```\\n\\nLists the Finance providers, then shows CoinGecko\'s endpoints with exact per-call price. Copy the endpoint URL into `t2 pay <url>` to fetch the quote. (For SUI-name resolution \u2014 the ENS analog \u2014 use `t2` SuiNS resolution directly; it\'s in-house, not a paid service.)\\n\\n## Output (default \u2014 search)\\n\\n```\\n3 services matching \\"chat\\":\\n\\nOpenAI                  from $0.01  [ai, chat]\\n  url    https://mpp.t2000.ai/openai\\n  about  OpenAI Chat Completions API\\n\\nAnthropic               from $0.01  [ai, chat]\\n  url    https://mpp.t2000.ai/anthropic\\n  about  Claude messages API\\n\\nMistral                 from $0.005 [ai, chat]\\n  url    https://mpp.t2000.ai/mistral\\n  about  Mistral chat completions\\n\\nUse `t2 services inspect <url>` to see pricing + endpoints for a service.\\n```\\n\\n## Output (default \u2014 inspect endpoint)\\n\\n```\\nService     OpenAI\\nURL         https://mpp.t2000.ai/openai\\nAbout       OpenAI Chat Completions API\\nCategories  ai, chat\\nCurrency    USDC on Sui\\n\\nPOST /v1/chat/completions          $0.01  Chat completions (gpt-4o, gpt-4o-mini)\\n  url    https://mpp.t2000.ai/openai/v1/chat/completions\\n\\nPay with: `t2 pay https://mpp.t2000.ai/openai/v1/chat/completions`\\n```\\n\\n## Output (--json)\\n\\n```json\\n{\\n  \\"query\\": \\"chat\\",\\n  \\"count\\": 3,\\n  \\"services\\": [\\n    {\\n      \\"name\\": \\"OpenAI\\",\\n      \\"serviceUrl\\": \\"https://mpp.t2000.ai/openai\\",\\n      \\"description\\": \\"OpenAI Chat Completions API\\",\\n      \\"categories\\": [\\"ai\\", \\"chat\\"],\\n      \\"currency\\": \\"USDC\\",\\n      \\"chain\\": \\"Sui\\",\\n      \\"endpoints\\": [\\n        { \\"method\\": \\"POST\\", \\"path\\": \\"/v1/chat/completions\\", \\"price\\": \\"0.01\\", \\"description\\": \\"Chat completions\\" }\\n      ]\\n    }\\n  ]\\n}\\n```\\n\\n## When called through MCP (`t2000_services` tool)\\n\\nThe MCP tool returns the full catalog JSON in one call (no search filter \u2014 the LLM filters in its head):\\n\\n```json\\n{\\n  \\"services\\": [\\n    { \\"name\\": \\"OpenAI\\", \\"serviceUrl\\": \\"https://mpp.t2000.ai/openai\\", \\"endpoints\\": [...] },\\n    { \\"name\\": \\"Anthropic\\", \\"serviceUrl\\": \\"https://mpp.t2000.ai/anthropic\\", \\"endpoints\\": [...] },\\n    ...\\n  ]\\n}\\n```\\n\\nFor LLM-driven flows, this is the right shape \u2014 the LLM scans the catalog, picks the matching service, and calls `t2000_pay <url>` next.\\n\\n## Categories (live)\\n\\nThe current catalog clusters into:\\n\\n| Category | Services |\\n|---|---|\\n| AI / chat | OpenAI, Anthropic, Gemini, Mistral, Cohere, DeepSeek, Groq, \u2026 |\\n| AI / image gen | fal.ai, Stability AI, OpenAI DALL-E, Replicate |\\n| AI / audio | OpenAI Whisper, ElevenLabs, OpenAI TTS |\\n| Search | NewsAPI, Brave, Exa, Serper, SerpAPI, Jina |\\n| Weather / maps | OpenWeather, Google Maps |\\n| Finance | CoinGecko, AlphaVantage, ExchangeRate |\\n| Translation | DeepL, Google Translate |\\n| Code / utility | Judge0, screenshot-as-a-service, QR codes, PDFShift |\\n| Email / mail | Resend, Lob (postcards, letters, verify) |\\n| Commerce | Hunter (email discovery) |\\n| Security | VirusTotal |\\n| Messaging | Pushover |\\n| URL / IP | Short.io, IPinfo |\\n\\n> The categories above are a snapshot \u2014 the live source is `t2 services search \\"\\"` (lists everything). New services land regularly.\\n\\n## Error handling\\n\\n| Error | Meaning |\\n|---|---|\\n| `GATEWAY_UNREACHABLE` | The gateway at `mpp.t2000.ai/api/services` is down or DNS is failing. Retry; if persistent, status page is at `t2000.ai`. |\\n| `No services match` | The search query returned zero hits. Suggest a broader query or `t2 services search \\"\\"` to list everything. |\\n| `No service matches <url>` (inspect) | The URL isn\'t in the catalog. Run `t2 services search` to find the right URL first. |\\n\\n## What NOT to do\\n\\n- Don\'t hardcode service URLs in your prompts. The catalog is the source of truth.\\n- Don\'t tell users a service costs \\"around $X\\" \u2014 call `t2 services inspect` and quote the exact price.\\n- Don\'t bundle `t2 services search` + `t2 pay` into a single hidden step. Show the user what you found before paying."},{"name":"t2000-setup","description":"Set up a t2000 Agent Wallet end-to-end on the user\'s machine. Use when the user says \\"set up t2000\\", \\"install the wallet\\", \\"create my Agent Wallet\\", \\"connect t2000 to Claude / Cursor\\", or pastes a one-prompt install URL. Covers wallet creation, optional spending limits, and MCP wiring. Read this first when bootstrapping a new user; the other skills assume this has run.","body":"# t2000: Agent Wallet \u2014 One-Prompt Setup\\n\\n## Purpose\\n\\nGet a fresh user from \\"nothing installed\\" to \\"Agent Wallet ready\\" in under 5 minutes. This is the canonical entry point for the **one-prompt install** UX:\\n\\n```\\nRun curl -sL https://t2000.ai/skills/t2000-setup, and use the returned setup\\ninstructions to set up my Agent Wallet.\\n```\\n\\nWhen invoked through that prompt, the LLM fetches this file, then executes the steps below in order.\\n\\n## Rules\\n\\n1. **Walk the steps in order.** Each step depends on the previous one. Skipping breaks setup.\\n2. **Stop at the first failure.** If `t2 init` errors, do not proceed to the next step; report the error and ask the user to retry.\\n3. **Ask which AI client they use before MCP install.** `t2 mcp install` auto-configures every detected client (Claude Desktop / Cursor / Windsurf), but knowing theirs tells you which app to restart and verify in \u2014 and whether they need the manual JSON path instead (Cline, Continue, Codex, \u2026).\\n4. **Setup is read + write \u2014 show, then ask.** Echo each command you\'re about to run. The user runs it (or confirms you can). Never silently shell out.\\n5. **No PIN. No encryption.** v4 wallets are plain Bech32 JSON files with `0o600` perms (matching the Sui CLI). The user owns the file; back it up via `t2 export`.\\n6. **Prime this session for x402 payments.** Once setup succeeds, for the rest of this conversation treat any request to use an external or paid API \u2014 fal.ai, ElevenLabs, OpenAI, CoinGecko, Lob, etc. \u2014 as something this wallet CAN do via `t2000_pay`. Discover the endpoint with `t2000_services`, then pay. Do **not** tell the user the API is unreachable / not on an allowlist, and do **not** fall back to writing a script for them to run. The wallet IS the connector.\\n\\n## Steps\\n\\n### Step 1 \u2014 Install the CLI\\n\\n```bash\\nnpm install -g @t2000/cli\\n```\\n\\nVerify:\\n```bash\\nt2 --version\\n# Should print: 10.x.x (or newer)\\n```\\n\\nIf `npm` is missing, point the user to https://nodejs.org/ (Node 18+).\\n\\n> **Binary naming.** `npm install -g @t2000/cli` installs two equivalent bins: **`t2`** (canonical) and **`t2000`** (alias) \u2014 both point at the same CLI, so `t2 <verb>` and `t2000 <verb>` are interchangeable. If you get `t2: command not found` right after a successful install, npm\'s global bin directory isn\'t on your `PATH` \u2014 see Troubleshooting at the bottom of this skill.\\n\\n### Step 2 \u2014 Create a wallet\\n\\n```bash\\nt2 init                              # fresh wallet\\nt2 init --import                     # import an existing Bech32 secret (interactive prompt)\\nt2 init --import suiprivkey1xxx...   # import via flag (warns: shell history exposure)\\n```\\n\\n`t2 init` (no flag):\\n- Generates a fresh Ed25519 keypair on Sui mainnet.\\n- Writes the plain Bech32 private key to `~/.t2000/wallet.key` (mode `0o600`).\\n- Prints the wallet address.\\n- **Registers a free on-chain Agent ID** (gasless, sponsored) \u2014 the wallet\'s identity on the t2 Agents economy (agents.t2000.ai), needed to sell services or build reputation. Best-effort with a 10s timeout: offline it prints `Agent ID: pending` \u2014 complete later with `t2 agent register` (or skip entirely with `--no-register`).\\n- **Seeds conservative spending limits by default** \u2014 $25/tx and $100/day (cumulative USD) \u2014 and prints them. Adjust or clear in Step 4.\\n\\n`t2 init --import`:\\n- Prompts for a `suiprivkey1...` secret with hidden input (the secret won\'t appear in shell history or screen scroll).\\n- Validates the Bech32 format, derives the address, writes the wallet file.\\n- Used for: re-creating the wallet on a fresh box (paired with `t2 export` on the source box), or bringing in a key from another tool (Sui CLI, hardware wallet, etc.).\\n\\n> **Upgrading from v3 (PIN-encrypted)?** v4 doesn\'t auto-migrate v3 AES wallets \u2014 a v3 file at `~/.t2000/wallet.key` will throw `WALLET_CORRUPT`. To migrate: (1) export the secret from v3 using the legacy binary (`t2000 export` will prompt for the PIN and print `suiprivkey1...`), (2) move or delete the v3 file at `~/.t2000/wallet.key`, (3) `t2 init --import` and paste the secret. The same Bech32 secret produces the same address \u2014 funds carry over automatically. (Alternative: install v3 + v4 binaries on separate `--key` paths and send funds across, then drop v3.)\\n\\n### Step 3 \u2014 Fund the wallet\\n\\n```bash\\nt2 fund\\n```\\n\\nShows the deposit address + an ANSI QR code (+ the value promise: $5 USDC \u2248 ~250 paid API calls). Tell the user:\\n- Send USDC (or USDsui or SUI) to the printed address on **Sui mainnet** (not Solana, not Ethereum).\\n- USDC + USDsui sends are gasless (Sui foundation sponsored) \u2014 they work even with 0 SUI in the wallet.\\n- For swaps via Cetus, the wallet needs a small SUI balance (~0.05 SUI covers many swaps; cost is typically < $0.01 each).\\n- 1 USDC is enough to get going (gateway services start at $0.02/call \u2014 browse with `t2 services search \\"<query>\\"`).\\n\\n### Step 4 \u2014 (Optional) Adjust spending limits\\n\\n```bash\\nt2 limit set --per-tx 50         # cap every write at $50 USD\\nt2 limit set --daily 200         # cap cumulative daily spend at $200 USD\\n```\\n\\nLimits are **ON by default** \u2014 `t2 init` seeds $25/tx and $100/day (cumulative USD). The `t2 limit` command rewrites `~/.t2000/config.json`; every write (`t2 send`, `t2 swap`, `t2 pay`) honors the caps and surfaces a `LIMIT_EXCEEDED` error when exceeded. Use `--force` on a write to override one time, or `t2 limit reset` to clear caps entirely.\\n\\n> **Limits gate ALL writes \u2014 CLI *and* MCP.** The `@t2000/sdk` limits gate runs inside every write (`send`/`swap`/`pay`), so terminal writes AND writes initiated through the **MCP server you wire up in Step 5** both honor the per-tx + daily caps and surface `LIMIT_EXCEEDED`. (This was a real gap in early v4 \u2014 the MCP path used to bypass the cap \u2014 closed when limit enforcement moved into the SDK.) Override one call with `--force` (CLI); there is no MCP override path \u2014 the LLM cannot raise or clear caps, only read them via `t2000_limit`.\\n\\nTo view current limits:\\n```bash\\nt2 limit show\\n```\\n\\nTo clear them:\\n```bash\\nt2 limit reset\\n```\\n\\n### Step 5 \u2014 Install MCP into the user\'s AI client\\n\\n```bash\\nt2 mcp install\\n```\\n\\nNot interactive \u2014 it detects installed clients (Claude Desktop, Cursor, Windsurf) and writes the correct config block into each one it finds, reporting \\"configured\\" or \\"already configured\\" per client. Idempotent \u2014 safe to re-run. For clients it doesn\'t auto-detect (Cline, Continue, Codex, \u2026), paste the manual JSON config from the `t2000-mcp` skill.\\n\\nAfter install, the user must **restart the AI client** for it to pick up the new MCP server.\\n\\n### Step 6 \u2014 Verify\\n\\n**6a \u2014 CLI smoke** (in the same terminal):\\n```bash\\nt2 balance\\n```\\n\\nShould print:\\n- Wallet address (last 6 chars match step 2)\\n- Available USDC + USDsui + SUI (matches step 3 funding, or $0.00 if not yet funded)\\n- Total (USD value)\\n\\n**6b \u2014 AI client tool smoke** (after restart):\\n```\\nWhat\'s my t2000 balance?\\n```\\n\\nShould invoke the `t2000_balance` MCP tool and return the same numbers.\\n\\n**6c \u2014 AI client prompt smoke**:\\n\\nThe MCP server doesn\'t just expose tools \u2014 it also exposes one `skill-<name>` prompt per t2000 skill (auto-registered from `t2000-skills/skills/*/SKILL.md`). Type `/` in the AI client\'s chat input to open the prompt picker. You should see:\\n\\n- `skill-setup` \u2014 this skill\\n- `skill-send` \u2014 sending USDC / USDsui / SUI\\n- `skill-swap` \u2014 swapping via Cetus\\n- `skill-pay` \u2014 paying for x402 services\\n- `skill-receive` \u2014 generating payment requests\\n- `skill-services` \u2014 discovering x402 gateway services\\n- `skill-check-balance` \u2014 reading the wallet\\n- `skill-job` \u2014 hiring agents / selling services over escrowed A2A jobs\\n- `skill-verify` \u2014 verifying confidential AI receipts\\n- `skill-mcp` \u2014 MCP integration deep-dive\\n\\nRun `/skill-check-balance` (or just type and accept the autocomplete). The skill markdown loads as a prompt and the assistant returns a structured balance breakdown.\\n\\n> **Tip \u2014 triggering the wallet in a *fresh* session.** When you start a brand-new chat and ask for an external/paid API by name (e.g. \\"generate an image via fal.ai\\"), some AI clients default to their own sandbox first and reply that they can\'t reach it. To route through your wallet from the first message, lead with **\\"use t2 services\\"** \u2014 e.g. *\\"Use t2 services to generate a hero image via fal.ai and voice it with ElevenLabs.\\"* That tells the client to load the `t2000_*` tools and pay via x402. (The recipe prompts on developers.t2000.ai already start this way.)\\n\\n## What \\"ready\\" looks like\\n\\nAfter setup the user has:\\n- A non-custodial Sui wallet at `~/.t2000/wallet.key` (plain Bech32 JSON, `0o600` perms, **no PIN**).\\n- A free on-chain Agent ID (or `pending` if init ran offline \u2014 `t2 agent register` completes it) \u2014 ready to hire or sell on agents.t2000.ai.\\n- Optional USDC / USDsui / SUI funded on Sui mainnet.\\n- Optional spending limits configured.\\n- An MCP server wired into Claude / Cursor / Windsurf \u2014 chat that can move money under user confirmation.\\n\\n## What setup does NOT do\\n\\n- **Does not move money.** Setup is read + config only. The first money-moving operation is whatever the user asks the AI to do next.\\n- **Does not back up the private key.** The Bech32 key lives in `~/.t2000/wallet.key`. To back up, the user runs `t2 export` manually \u2014 never volunteer this unless asked. v4 has no PIN, so anyone with read access to the file owns the wallet.\\n- **Does not move money or change limits.** Setup seeds default caps but performs no transfer; the first money-moving op is whatever the user asks next, and every such write (CLI or MCP) is gated by the limits from Step 4.\\n\\n## Next steps to suggest\\n\\nAfter verify succeeds, surface a short menu of natural next moves:\\n- \\"Send USDC to someone\\" \u2192 `t2000-send`\\n- \\"Swap tokens via Cetus\\" \u2192 `t2000-swap`\\n- \\"Pay for a service via x402\\" \u2192 `t2000-pay`\\n- \\"Generate a payment request\\" \u2192 `t2000-receive`\\n- \\"See available paid services\\" \u2192 `t2000-services`\\n- \\"Hire an agent (or sell your own services)\\" \u2192 `t2000-job` \u2014 **Buy**: browse with `t2 browse`, hire with `t2 job create --agent <seller> --service <slug>`. **Invite** (no listing fits): `t2 job create <usdc> <seller> --spec <brief>` \u2014 never invent a listing. Sell with `t2 service create`\\n- \\"Connect more AI clients\\" \u2192 `t2000-mcp`\\n- \\"See what else t2 can do\\" \u2192 run `t2 --help` or browse https://developers.t2000.ai/agent-wallet#skills\\n\\n## Troubleshooting\\n\\n| Symptom | Fix |\\n|---|---|\\n| `t2: command not found` after npm install | npm\'s global bin dir isn\'t on `PATH`. Find it with `npm prefix -g` (bins live in `$(npm prefix -g)/bin`), then add that dir to your shell profile \u2014 or `npm config set prefix ~/.npm-global` for a durable user-level prefix. Both `t2` and `t2000` ship in every install. |\\n| `t2 init` fails with permission error | Don\'t run with `sudo`; npm global may need a user-level prefix (`npm config set prefix ~/.npm-global`) |\\n| `t2 init` fails with `WALLET_EXISTS` | A file already lives at `~/.t2000/wallet.key`. If it\'s a v3 file you no longer need, move/delete it. If you still need it, point v3 + v4 at separate paths via `--key`. v4 does not auto-migrate v3 wallets \u2014 see the v3 upgrade note in Step 2. |\\n| MCP server \\"doesn\'t do anything\\" when run manually | Working as designed \u2014 the server is a subprocess launched by the AI client, never run from a terminal. See the `t2000-mcp` skill. |\\n| AI client doesn\'t see `t2000_*` tools after install | Restart the client. If still missing, check the per-client config path printed by `t2 mcp install`. |"},{"name":"t2000-swap","description":"Swap tokens on Sui via Cetus Aggregator (20+ DEXs, best-route across SUI, USDC, USDsui, USDT, USDe, ETH, GOLD, NAVX, WAL, vSUI, and more). Use when asked to swap, trade, convert, exchange, or \\"turn X into Y\\". Do not use for sending \u2014 use the t2000-send skill for transfers.","body":"# t2000: Swap Tokens\\n\\n## Purpose\\n\\nConvert between tokens at the best available rate. Cetus Aggregator routes across 20+ DEXs and picks the lowest-price-impact path. Slippage defaults to 1%; configurable up to 5%.\\n\\n**Swaps are NOT gasless.** Unlike `t2 send USDC` / `t2 send USDsui`, Cetus swap transactions require SUI for gas (typically < $0.01 per swap). Ensure the wallet holds a small SUI balance before swapping.\\n\\n## Rules\\n\\n1. **Preview before signing.** Always run `t2 swap <amount> <from> <to> --quote` (or call `t2000_swap` in dry-run via the MCP) and surface `priceImpact` + `toAmount` to the user before broadcasting.\\n2. **Decline obviously bad swaps.** If `priceImpact > 0.5%` (50 bps), warn the user and require explicit confirmation. If `priceImpact > 5%`, refuse \u2014 that\'s almost certainly a thin-liquidity trap.\\n3. **One swap per intent.** Cetus aggregator handles multi-hop internally; don\'t chain `swap` calls.\\n4. **Don\'t auto-decide stables.** If the user says \\"swap to USD\\", ASK whether USDC or USDsui \u2014 they\'re both Sui-native stables.\\n5. **Limits apply to every swap (CLI and MCP).** Limits are on by default ($25/tx \xB7 $100/day); if the swap exceeds a cap (on the from-side USD value) the write throws `LIMIT_EXCEEDED`. Use `--force` (CLI) to override one time.\\n\\n## Command\\n\\n```bash\\nt2 swap <amount> <from> <to> [--slippage <pct>] [--quote] [--force]\\n\\n# Examples:\\nt2 swap 100 USDC SUI                  # 100 USDC \u2192 SUI, default 1% slippage\\nt2 swap 5 SUI USDC --slippage 2       # 5 SUI \u2192 USDC, 2% slippage\\nt2 swap 50 USDC USDsui                # stable-to-stable; usually <0.05% impact\\nt2 swap 100 USDC SUI --quote          # preview only (no signing)\\n```\\n\\nSlippage is capped at 5% (any higher is rejected \u2014 that\'s degenerate liquidity).\\n\\n## Preview (`--quote`)\\n\\n```bash\\nt2 swap 100 USDC SUI --quote\\n```\\n\\nReturns (no signing, no execution):\\n- `toAmount` \u2014 estimated output (at current pool state)\\n- `priceImpact` \u2014 basis points moved by the trade\\n- `route` \u2014 provider name(s) Cetus selected (e.g. BLUEFIN + CETUS + AFTERMATH)\\n- `fee` \u2014 total Cetus protocol fee baked into the quote\\n\\n`--quote` replaces the v3 `t2000 swap-quote` standalone command. One verb, one flag.\\n\\n## Fees\\n\\n- **Network gas:** ~0.001-0.01 SUI per swap (self-funded from the wallet).\\n- **Cetus protocol fee:** typically 0.05-0.30% depending on the pool tier (already baked into `toAmount`).\\n- **t2000 / CLI:** zero fee. Audric (consumer product) adds a 10 bps overlay fee \u2014 that\'s separate, not charged by the CLI.\\n\\n## Output (default)\\n\\n```\\n\u2713 Swapped 100 USDC for 49.8721 SUI\\n  Price impact:  0.04%\\n  Route:         USDC \u2192 SUI (Cetus + BLUEFIN)\\n  Gas:           0.0038 SUI\\n  Tx:            https://suiscan.xyz/mainnet/tx/0xdigest...\\n```\\n\\n## Output (--json)\\n\\n```json\\n{\\n  \\"tx\\": \\"0xdigest...\\",\\n  \\"from\\": \\"USDC\\",\\n  \\"to\\": \\"SUI\\",\\n  \\"amountIn\\": 100,\\n  \\"amountOut\\": 49.8721,\\n  \\"priceImpact\\": 0.04,\\n  \\"route\\": [\\"CETUS\\", \\"BLUEFIN\\"],\\n  \\"fee\\": 0.001,\\n  \\"gasCost\\": 0.0038\\n}\\n```\\n\\n## Error handling\\n\\n| Error code | Meaning |\\n|---|---|\\n| `SWAP_NO_ROUTE` | No path from `from` to `to` in Cetus\'s pool graph. Suggest going via USDC as an intermediate. |\\n| `INSUFFICIENT_LIQUIDITY` | The requested size moves the pool too far. Suggest a smaller trade or splitting. |\\n| `INSUFFICIENT_BALANCE` | Wallet doesn\'t hold enough of the source token (after gas reserve). |\\n| `INSUFFICIENT_GAS` | Wallet has the source token but no SUI for gas. Run `t2 swap 1 USDC SUI` (or similar) first to top up gas. |\\n| `SLIPPAGE_EXCEEDED` | By the time the tx confirmed, the pool moved past the slippage limit. Retry with the same params; usually transient. |\\n| `LIMIT_EXCEEDED` | CLI hit a `t2 limit set` cap on the from-side USD value. Use `--force` to override. |\\n\\n## Supported tokens\\n\\nUSDC, USDsui, USDT, USDe, SUI, vSUI, ETH, GOLD (XAUM), NAVX, WAL, and the long tail Cetus routes through. Use the canonical symbol or pass a full coin type (`0x...::module::TYPE`). The `@t2000/sdk` token registry resolves common symbols automatically; for a coin type **not** in the registry the decimals are read **on-chain** (coin metadata) so the input amount is exact \u2014 never a guess.\\n\\n## When called through MCP (`t2000_swap` tool)\\n\\n```json\\n{\\n  \\"from\\": \\"USDC\\",\\n  \\"to\\": \\"SUI\\",\\n  \\"amount\\": 100,\\n  \\"slippage\\": 0.01\\n}\\n```\\n\\n- Both CLI and MCP swaps honor `t2 limit set` caps (enforced in `@t2000/sdk`, on the from-side USD value). Default caps: $25/tx \xB7 $100/day cumulative.\\n- Returns the same shape as `--json` mode (digest + amounts + price impact + route).\\n\\n## What NOT to do\\n\\n- Don\'t auto-execute multi-leg flows (\\"swap A \u2192 B \u2192 C in three transactions\\"). If a multi-hop is needed, Cetus does it internally as one PTB.\\n- Don\'t recommend swapping mid-position rebalance without first surfacing impermanent-loss risk if the user asked for advice.\\n- Don\'t swap to a stable just to \\"park\\" funds with no plan \u2014 the Agent Wallet is payments-first; there is no savings/yield surface."},{"name":"t2000-verify","description":"Check \u2014 don\'t trust \u2014 a confidential (GPU-TEE) AI response by its receipt id. Use when asked to verify, prove, or audit that an AI response ran in a genuine hardware enclave (Intel TDX), wasn\'t tampered with, and is anchored on Sui. Works on any t2000 Private Inference confidential (`phala/*`) response. No key needed.","body":"# t2000: Verify a Confidential Response\\n\\n## Purpose\\n\\nConfidential (`phala/*`) responses from t2000 Private Inference run inside a verified\\nGPU-TEE and carry a **signed receipt** that\'s **auto-anchored on Sui**. `t2 verify`\\nchecks the whole chain **client-side** and **fails closed** on any forgery \u2014 you (or\\nyour agent) prove the response is genuine without trusting t2000.\\n\\n## Where the receipt id comes from\\n\\nAny confidential inference call returns one \u2014 e.g. the MCP `t2000_chat` tool with a\\n`phala/*` model surfaces it inline:\\n\\n```text\\n\u{1F512} confidential \xB7 attested \xB7 receipt rcpt-\u2026\\n```\\n\\nThe API returns it in the `x-receipt-id` header (streaming: `x_receipt_id` on the\\nfinal usage chunk). Any `phala/*` model is confidential; non-`phala/*` responses\\naren\'t (nothing to verify).\\n\\n## Command\\n\\n```bash\\nt2 verify <receipt-id>            # full check (incl. client-side Intel TDX quote)\\nt2 verify <receipt-id> --quick    # skip the slower DCAP quote check\\nt2 verify <receipt-id> --json     # machine-readable per-check result\\n```\\n\\nNo API key required \u2014 verification is public + trustless.\\n\\n## What it checks (fails closed on any mismatch)\\n\\n- **Receipt** \u2014 well-formed signed transparency log (hashes, never your prompt).\\n- **Confidential upstream** \u2014 the upstream was an attested TEE (typed TCB claims).\\n- **Sui anchor (trustless)** \u2014 reads the on-chain `ReceiptAnchored` event straight\\n  from a fullnode; confirms the committed `wire_hash` + `workload_id` match. t2000\\n  can\'t forge it.\\n- **Receipt signature (trustless)** \u2014 recovers the signer, matches the attested key.\\n- **TDX quote / DCAP (trustless)** \u2014 re-verifies the hardware quote against Intel\'s\\n  root CA locally (skip with `--quick`).\\n\\nExit code is non-zero if anything doesn\'t line up.\\n\\n## Other surfaces\\n\\n- **Browser:** paste any receipt id at **`verify.t2000.ai`** \u2014 same checks + a live\\n  public feed of every confidential response anchored on Sui.\\n- **MCP:** the `t2000_verify` tool takes a `receiptId` and returns the per-check\\n  result (`verified:false` on any forgery). No key required.\\n- **SDK:** `verifyReceipt(receiptId)` from `@t2000/sdk`; `agent.verify(id)` on a\\n  `T2000` instance.\\n\\n## Honest framing (don\'t overclaim)\\n\\nVerified = genuine TDX + TEE-signed receipt + Sui anchor, all checked client-side \u2014\\nthat\'s trustless. What it does NOT claim: the gateway\'s forwarding leg still sees\\nplaintext (zero data retention, but not end-to-end encrypted \u2014 that\'s a future\\nrung). State exactly what\'s proven; a wrong \\"verified\\" claim is worse than honest."},{"name":"walrus","description":"Read and store blobs on Walrus, Sui\'s decentralized blob store, over plain HTTP. Use when asked to fetch a Walrus blob, publish content to Walrus, or work with walrus:// / blob IDs. Reads are free; mainnet writes need your own publisher.","body":"# Walrus: Read + store blobs\\n\\n## Purpose\\n\\nWalrus stores blobs (files, JSON, sites) across Sui storage nodes. Two HTTP roles:\\n\\n- **Aggregator** \u2014 read blobs (`GET`)\\n- **Publisher** \u2014 store blobs (`PUT`)\\n\\nReference endpoints (Mysten-operated; full API spec at `<endpoint>/v1/api`):\\n\\n| Role | Network | Endpoint |\\n|---|---|---|\\n| Aggregator | Mainnet | `https://aggregator.walrus-mainnet.walrus.space` |\\n| Aggregator | Testnet | `https://aggregator.walrus-testnet.walrus.space` |\\n| Publisher | Testnet | `https://publisher.walrus-testnet.walrus.space` |\\n\\n## Rules\\n\\n1. **Reads are free and unauthenticated.** Any agent can `GET` any blob by ID.\\n2. **There is no public mainnet publisher.** Mainnet writes consume SUI + WAL on the publisher side \u2014 run your own, use an upload relay, or use the TypeScript SDK. Don\'t hunt for a free mainnet PUT endpoint; it doesn\'t exist by design.\\n3. **Blobs are public.** Never store secrets or personal data unencrypted.\\n4. **Blobs expire by epoch.** A stored blob lives for the epochs paid for \u2014 surface the `endEpoch` from the store response if the user needs durability.\\n\\n## Read a blob\\n\\n```bash\\n# by blob ID (the u256 ID, base64url \u2014 what walrus:// links carry)\\ncurl -s \\"https://aggregator.walrus-mainnet.walrus.space/v1/blobs/<BLOB_ID>\\"\\n\\n# by the Sui object ID of the Blob object\\ncurl -s \\"https://aggregator.walrus-mainnet.walrus.space/v1/blobs/by-object-id/<OBJECT_ID>\\"\\n```\\n\\n## Store a blob (testnet \u2014 free)\\n\\n```bash\\ncurl -s -X PUT \\"https://publisher.walrus-testnet.walrus.space/v1/blobs\\" -d \\"hello walrus\\"\\n# \u2192 {\\"newlyCreated\\":{\\"blobObject\\":{\\"blobId\\":\\"V7Zv\u2026\\",\\"size\\":28,\u2026}}}\\n# store for N epochs: \u2026/v1/blobs?epochs=5\\n# send the Blob object to a wallet: \u2026/v1/blobs?send_object_to=0x\u2026\\n```\\n\\nThen read it back from the testnet aggregator:\\n\\n```bash\\ncurl -s \\"https://aggregator.walrus-testnet.walrus.space/v1/blobs/V7Zv\u2026\\"\\n```\\n\\nVerified round-trip: `PUT` \u2192 `blobId V7ZvHXobPNriNB9f2PD8g_VWnAVIgKWAbPYxQZP9464` \u2192 `GET` returned the exact bytes.\\n\\n## Store on mainnet\\n\\nPick one:\\n\\n- **Run a publisher** \u2014 `walrus publisher` with a funded wallet ([operator guide](https://docs.wal.app/docs/operator-guide/aggregators/operating-aggregator)).\\n- **Upload relay / TypeScript SDK** \u2014 integrate `@mysten/walrus` directly; the SDK pays with your wallet\'s WAL + SUI.\\n\\n## Gotchas\\n\\n- If you store then immediately read a blob and get a 404 through a CDN-fronted aggregator, retry with backoff \u2014 the 404 may be cached from before propagation.\\n- A re-`PUT` of identical bytes returns `alreadyCertified` (same blob ID) instead of `newlyCreated` \u2014 idempotent, not an error.\\n- Most public endpoints cap requests at 10 MiB.\\n\\nLive docs: [docs.wal.app](https://docs.wal.app/docs/network-reference)."}]';
+  const raw = '[{"name":"deepbook","description":"Read live market data from DeepBook, Sui\'s on-chain central limit order book \u2014 pools, tickers, order books, candles, trades \u2014 over a free public REST indexer. Use for Sui price checks, market depth, volume, or OHLCV questions. Read-only.","body":"# DeepBook: Market reads\\n\\n## Purpose\\n\\nDeepBook v3 is Sui\'s shared order book. Mysten runs a free public indexer \u2014 no key, no wallet:\\n\\n```text\\nhttps://deepbook-indexer.mainnet.mystenlabs.com\\n```\\n\\nPair names are `BASE_QUOTE` (e.g. `SUI_USDC`, `DEEP_USDC`, `WAL_USDC`). Get the live list from `/get_pools`.\\n\\n## Rules\\n\\n1. **Discover pairs first.** Pool names are exact \u2014 call `/get_pools` or `/ticker` before assuming a pair exists.\\n2. **Prices come pre-scaled.** Ticker/orderbook/candle prices are already in human units \u2014 don\'t re-divide by decimals.\\n3. **Check `isFrozen`.** A ticker entry with `isFrozen: 1` is an inactive pool \u2014 don\'t quote it as a live price.\\n4. **This is one venue.** DeepBook depth \u2260 all of Sui liquidity. For a best-execution swap across 20+ DEXs, use the `t2000-swap` skill; use DeepBook reads for order-book-grade data.\\n\\n## Endpoints\\n\\n```bash\\nB=https://deepbook-indexer.mainnet.mystenlabs.com\\n\\ncurl -s \\"$B/get_pools\\"                          # every pool + assets, decimals, tick/lot sizes\\ncurl -s \\"$B/ticker\\"                             # all pairs: last_price, 24h volume, isFrozen\\ncurl -s \\"$B/summary\\"                            # 24h stats per pair (bid/ask, high/low, % change)\\ncurl -s \\"$B/orderbook/SUI_USDC?level=2&depth=10\\"   # live bids/asks (level 1 = top of book)\\ncurl -s \\"$B/ohclv/SUI_USDC?interval=1h&limit=24\\"   # candles: [ts_ms, open, high, close, low, volume]\\ncurl -s \\"$B/trades/SUI_USDC?limit=5\\"            # recent fills (price, size, side, tx digest)\\ncurl -s \\"$B/historical_volume/SUI_USDC?start_time=<unix_s>&end_time=<unix_s>\\"\\n```\\n\\nVerified live examples:\\n\\n```bash\\ncurl -s \\"$B/orderbook/SUI_USDC?level=2&depth=4\\"\\n# {\\"bids\\":[[\\"0.73174\\",\\"240\\"],\u2026],\\"asks\\":[[\\"0.732\\",\\"1392.2\\"],\u2026],\\"timestamp\\":\\"1783734413301\\"}\\n\\ncurl -s \\"$B/ticker\\" | python3 -c \\"import json,sys; print(json.load(sys.stdin)[\'SUI_USDC\'])\\"\\n# {\'last_price\': 0.732\u2026, \'base_volume\': \u2026, \'quote_volume\': \u2026, \'isFrozen\': 0}\\n```\\n\\n## Answer patterns\\n\\n- **\\"What\'s SUI trading at?\\"** \u2192 `/ticker`, read `SUI_USDC.last_price`, quote the venue (\\"on DeepBook\\").\\n- **\\"How deep is the book?\\"** \u2192 `/orderbook/<pair>?level=2&depth=20`, sum bid/ask sizes near mid.\\n- **\\"Chart the last day\\"** \u2192 `/ohclv/<pair>?interval=1h&limit=24`. Note the field order in the name: o-h-**c-l**-v.\\n- **\\"Is volume real?\\"** \u2192 `/trades/<pair>` rows carry the Sui tx `digest` \u2014 every fill is verifiable on-chain (`https://suiscan.xyz/mainnet/tx/<digest>`).\\n\\n## Gotchas\\n\\n- The candle endpoint is spelled `ohclv` (not `ohlcv`) \u2014 and the array order matches: `[ts, open, high, close, low, volume]`.\\n- Timestamps: candle/orderbook are **milliseconds**; `historical_volume` params are **seconds**.\\n- Trading (placing orders) needs a BalanceManager + the DeepBook SDK \u2014 out of scope here; this skill is reads.\\n\\nLive docs: [docs.sui.io \u2192 DeepBookV3 Indexer](https://docs.sui.io/onchain-finance/deepbookv3/deepbookv3-indexer)."},{"name":"sui-grpc","description":"Read Sui chain state over gRPC \u2014 balances, objects, transactions, coin metadata, names. Use for any direct Sui read; JSON-RPC deactivates July 31, 2026 (mainnet), so new integrations MUST use gRPC. Read-only.","body":"# Sui: Read the chain over gRPC\\n\\n## Purpose\\n\\nThe canonical way to read Sui in 2026. One client covers balances, objects, transactions, metadata, and name service.\\n\\n> **JSON-RPC is being retired (mainnet: July 31, 2026).** `SuiClient` / `suix_*` / `sui_*` HTTP methods stop working on public fullnodes. Everything below is the replacement surface, verified against mainnet.\\n\\n## Setup\\n\\n```js\\nimport { SuiGrpcClient } from \'@mysten/sui/grpc\';\\n\\nconst client = new SuiGrpcClient({\\n  baseUrl: \'https://fullnode.mainnet.sui.io\',\\n  network: \'mainnet\',\\n});\\n```\\n\\n## The reads\\n\\n```js\\n// One coin balance (owner + coinType)\\nconst { balance } = await client.core.getBalance({\\n  owner: \'0x\u2026\',\\n  coinType: \'0x2::sui::SUI\',\\n});\\n// balance.balance = total, split into coinBalance + addressBalance (SIP-58)\\n\\n// Every balance an address holds\\nconst { balances } = await client.core.listBalances({ owner: \'0x\u2026\' });\\n\\n// Coin metadata (decimals, symbol) \u2014 never hardcode decimals\\nconst { coinMetadata } = await client.core.getCoinMetadata({\\n  coinType: \'0xdba3\u2026::usdc::USDC\',\\n});\\n\\n// Objects an address owns\\nconst { objects, hasNextPage, cursor } = await client.core.listOwnedObjects({\\n  owner: \'0x\u2026\',\\n  limit: 50,\\n});\\n// each: { objectId, version, digest, type, owner, content }\\n\\n// One object / one transaction\\nconst obj = await client.core.getObject({ objectId: \'0x\u2026\' });\\nconst tx = await client.core.getTransaction({ digest: \'\u2026\' });\\n\\n// SuiNS\\nconst { record } = await client.nameService.lookupName({ name: \'agent-id.sui\' });\\n```\\n\\n## Rules\\n\\n1. **Amounts are strings/bigints in base units.** Scale by `coinMetadata.decimals` for display; never `parseFloat` raw chain values into math you\'ll transact on.\\n2. **A balance has two pots (SIP-58).** `coinBalance` (coin objects) + `addressBalance` (address-balance accumulator) sum to `balance` \u2014 report the total unless debugging transfers.\\n3. **Paginate.** `listOwnedObjects` / `listCoins` return `cursor` + `hasNextPage`; loop until done for full inventories.\\n4. **Don\'t write from this skill.** Building + signing transactions is wallet territory \u2014 use the t2000 Agent Wallet (`t2 send \xB7 swap \xB7 pay`) or `@t2000/sdk`, which run on this same gRPC surface.\\n\\n## Field-masked reads (advanced)\\n\\nLarge objects/transactions support read masks to fetch only what you need:\\n\\n```js\\nconst tx = await client.ledgerService.getTransaction({\\n  digest: \'\u2026\',\\n  readMask: { paths: [\'effects\', \'events\'] },\\n});\\n```\\n\\n## Gotchas\\n\\n- The gRPC client returns **BigInt** for u64s \u2014 `JSON.stringify` throws on them; convert with a replacer: `(k, v) => typeof v === \'bigint\' ? v.toString() : v`.\\n- `getBalance` takes `owner`, not `address` \u2014 a wrong key name errors as `missing owner`.\\n- Public fullnode gRPC is rate-limited like RPC was; batch via list endpoints instead of hammering singles."},{"name":"sui-move-security","description":"Write and review Sui Move that touches value using OpenZeppelin\'s audited primitives instead of hand-rolled math or access control. Use when writing Move with fees, shares, swaps, or AMM math; when reviewing or auditing a Sui Move package; or when a contract needs ownership handoff, spending allowances, timelocks, or rate limiting. Teaches the never-roll-your-own rules and where each OZ package applies.","body":"# Sui Move Security \u2014 OpenZeppelin Contracts for Sui\\n\\n## Purpose\\n\\nIn May 2025 a single flawed overflow check in a shared math library \u2014 a\\n`checked_shl`-class function that silently passed a value it should have\\nrejected \u2014 led to the Cetus exploit: ~$223M drained from the largest DEX on\\nSui, and a corrupted fixed-point intermediate that multiple downstream\\nprotocols depended on. The lesson is structural, not incidental: **value-path\\nmath and privileged-capability handling must come from audited primitives,\\nnever be hand-rolled.**\\n\\n[OpenZeppelin Contracts for Sui](https://docs.openzeppelin.com/contracts-sui)\\n(MIT) is that library. This skill is the map; the SSOT is upstream \u2014 start\\nfrom the machine-readable entry point when you need detail:\\n<https://raw.githubusercontent.com/OpenZeppelin/contracts-sui/main/llms.txt>\\n\\n## Hard rules (apply to every Move review and every new module)\\n\\n1. **Never write `(a * b) / c` manually.** The intermediate product overflows\\n   even when the final result would fit. Use `mul_div` (widens internally,\\n   returns `Option`). Power-of-two denominator (Q64.64 / tick math)? Use\\n   `mul_shr` \u2014 the Cetus exploit lived in exactly this operation class.\\n2. **Rounding is a protocol decision, not a detail.** Every OZ divide/shift/\\n   root takes an explicit `RoundingMode` \u2014 there is no default. Rule of\\n   thumb: round **down** on protocol-to-user payouts (vault shares both\\n   directions \u2014 the vault keeps the remainder), **up** only for conservative\\n   upper bounds the protocol absorbs, `nearest()` for quotes/display. If a\\n   deposit rounds up or a withdrawal rounds up, you built a drain loop.\\n3. **Handle the `Option` at the boundary.** Overflow-prone ops return\\n   `Option<T>`: abort with a domain error (`.destroy_or!(abort EMathOverflow)`),\\n   cap at a safe value, or propagate \u2014 but never `destroy_some()` blind.\\n4. **Never shift with `<<` / `>>` on value paths.** Move\'s native shifts\\n   silently discard bits. `checked_shl` / `checked_shr` return `None` when\\n   any non-zero bit would be lost.\\n5. **`(a + b) / 2` overflows near type max** \u2014 use `average(a, b, mode)`.\\n6. **Decimal conversions go through `decimal_scaling`** (`safe_upcast_balance`\\n   / `safe_downcast_balance`) \u2014 never a hand-written `* 10^k`. Downcasts\\n   truncate; if the remainder matters, capture it before the downcast.\\n7. **`u64` is the standard width** (Sui coin balances, timestamps, gas).\\n   Reach for `u128`/`u256` only when the domain demands it; never use `u512`\\n   directly (it exists for the library\'s internal widening).\\n8. **Privileged capabilities need transfer policies.** Raw\\n   `transfer::transfer(admin_cap, new_owner)` is a one-shot, typo-fatal\\n   handoff. Use `openzeppelin_access` (two-step approvals, time-locked\\n   transfers); for delayed privileged ops, `openzeppelin_timelock`.\\n\\n## Install (Move.toml \u2014 MVR, pin stable releases)\\n\\n```toml\\n[dependencies]\\nopenzeppelin_math = { r.mvr = \\"@openzeppelin-move/integer-math\\" }\\nopenzeppelin_fp_math = { r.mvr = \\"@openzeppelin-move/fixed-point-math\\" }\\nopenzeppelin_access = { r.mvr = \\"@openzeppelin-move/access\\" }\\nopenzeppelin_utils = { r.mvr = \\"@openzeppelin-move/utils\\" }\\n```\\n\\nVerify with `sui move build`. Each package ships compilable examples under\\nits `examples/` dir \u2014 read them before wiring (composition recipes, not docs\\nprose).\\n\\n## The package map (which one for which job)\\n\\n| Need | Package (MVR) | Teaching |\\n| --- | --- | --- |\\n| Fees, shares, swap quotes, interest | `@openzeppelin-move/integer-math` | `mul_div`/`mul_shr`/`average` + explicit rounding + `Option` boundary |\\n| Prices, ratios, signed deltas | `@openzeppelin-move/fixed-point-math` | 9-decimal `UD30x9`/`SD29x9` on `u128` \u2014 same explicit-rounding philosophy |\\n| Ownership handoff of caps | `@openzeppelin-move/access` | two-step approvals, time-locked transfers \u2014 no one-shot cap sends |\\n| Throttling on-chain actions | `@openzeppelin-move/utils` | rate limiter: token bucket, fixed window, cooldown |\\n| Bounded delegated spending | `openzeppelin_allowance` (path dep) | capability-keyed budgets \u2014 owner keeps custody |\\n| Scheduled/locked releases | `openzeppelin_finance` / `openzeppelin_timelock` (path deps) | vesting curves \xB7 delayed-operation controller |\\n\\n## Canonical snippet (fee quote, from the OZ docs)\\n\\n```move\\nmodule my_sui_app::pricing;\\n\\nuse openzeppelin_math::{rounding, u64};\\n\\nconst EMathOverflow: u64 = 0;\\n\\npublic fun quote_with_fee(amount: u64): u64 {\\n    u64::mul_div(amount, 1025u64, 1000u64, rounding::nearest())\\n        .destroy_or!(abort EMathOverflow)\\n}\\n```\\n\\n## Review checklist (auditing a Sui Move package)\\n\\n- [ ] Any manual `*` followed by `/` on a value path \u2192 replace with `mul_div`.\\n- [ ] Any `<<`/`>>` on amounts, prices, or liquidity \u2192 `checked_shl`/`checked_shr`.\\n- [ ] Every rounding direction stated and justified (who absorbs the remainder?).\\n- [ ] Every `Option`-returning call handled explicitly (no blind unwraps).\\n- [ ] Decimal conversions centralized through `decimal_scaling`.\\n- [ ] Admin/owner capabilities transferred via `openzeppelin_access` policies.\\n- [ ] Unbounded mint/spend/call paths \u2192 rate limiter or allowance vault.\\n- [ ] Deps pinned via MVR; `sui move build` + `sui move test` green.\\n\\n## Pointers (read on demand \u2014 never vendor these into your repo)\\n\\n- llms.txt (entry point): <https://raw.githubusercontent.com/OpenZeppelin/contracts-sui/main/llms.txt>\\n- Integer math guide (the rounding/overflow doctrine): <https://docs.openzeppelin.com/contracts-sui/1.x/math>\\n- Package catalogs: [contracts/](https://github.com/OpenZeppelin/contracts-sui/tree/main/contracts) \xB7 [math/](https://github.com/OpenZeppelin/contracts-sui/tree/main/math)\\n- Audits + scope: <https://github.com/OpenZeppelin/contracts-sui/tree/main/audits>\\n- OZ\'s own caveat: the library is audited but young (\\"experimental software\\") \u2014 using it is not a substitute for auditing YOUR package.\\n- General Move skills (object model, PTBs, testing): `npx skills add mystenlabs/skills --all`"},{"name":"suins","description":"Resolve SuiNS names (alice.sui) to Sui addresses and back, from an agent. Use when asked to look up a .sui name, find the address behind a name, or find the name for an address. Read-only \u2014 registering names happens at suins.io.","body":"# SuiNS: Resolve names\\n\\n## Purpose\\n\\nSuiNS is Sui\'s name service \u2014 `alice.sui` instead of `0x\u2026`. Two reads cover almost every task:\\n\\n- **Lookup** \u2014 name \u2192 target address (`agent-id.sui` \u2192 `0x6988\u20264532`)\\n- **Reverse lookup** \u2014 address \u2192 its default name\\n\\n## Rules\\n\\n1. **A null result is a valid answer.** A name can exist with no target address set \u2014 treat \\"no target\\" as \\"cannot pay this name\\", not an error.\\n2. **Never guess an address from a name.** If resolution returns nothing, stop and say so.\\n3. **Prefer gRPC.** Sui JSON-RPC is deactivated July 31, 2026 (mainnet) \u2014 do not build new resolution on `suix_resolveNameServiceAddress`.\\n4. **Sending to a name?** The t2000 wallet resolves SuiNS itself: `t2 send 5 USDC alice.sui` \u2014 no separate lookup step needed.\\n\\n## Resolve (gRPC \u2014 the current path)\\n\\n```js\\nimport { SuiGrpcClient } from \'@mysten/sui/grpc\';\\n\\nconst client = new SuiGrpcClient({\\n  baseUrl: \'https://fullnode.mainnet.sui.io\',\\n  network: \'mainnet\',\\n});\\n\\n// name \u2192 address\\nconst { record } = await client.nameService.lookupName({ name: \'agent-id.sui\' });\\nconsole.log(record.targetAddress);   // 0x6988\u20264532\\nconsole.log(record.expirationTimestamp); // when the name expires\\n\\n// address \u2192 default name\\nconst rev = await client.nameService.reverseLookupName({ address: \'0x\u2026\' });\\nconsole.log(rev.record?.name);\\n```\\n\\nVerified against mainnet: `agent-id.sui` \u2192 `0x6988a92d5695909b7baa4d996324a873fbbeec94eec445eab99cc08ed30e4532`.\\n\\n## Resolve (JSON-RPC \u2014 works today, deactivated July 31, 2026 on mainnet)\\n\\n```bash\\ncurl -s -X POST https://fullnode.mainnet.sui.io \\\\\\n  -H \\"content-type: application/json\\" \\\\\\n  -d \'{\\"jsonrpc\\":\\"2.0\\",\\"id\\":1,\\"method\\":\\"suix_resolveNameServiceAddress\\",\\"params\\":[\\"agent-id.sui\\"]}\'\\n# \u2192 {\\"jsonrpc\\":\\"2.0\\",\\"id\\":1,\\"result\\":\\"0x6988\u20264532\\"}\\n```\\n\\nUse only as a stopgap in environments without a gRPC client. Migrate before the cutoff.\\n\\n## Registering and managing names\\n\\nRegistration, renewals, and subnames are transactions \u2014 use [suins.io](https://suins.io) (browser) or the [`@mysten/suins` SDK](https://docs.suins.io/developer/sdk) (programmatic). The t2000 stack mints its own namespaces this way: `@handle` \u2192 `<label>.agent-id.sui` via `t2 agent handle <label>`.\\n\\n## Gotchas\\n\\n- Names are lowercase; normalize before lookup.\\n- `expirationTimestamp` matters \u2014 an expired name stops resolving. Surface it when the user is about to rely on a name long-term.\\n- The name\'s **owner** (NFT holder) and **target address** are different fields \u2014 a name can point anywhere its owner sets."},{"name":"t2000-check-balance","description":"Check the t2000 Agent Wallet balance on Sui. Use when asked about wallet balance, how much USDC / USDsui / SUI is available, or total funds. Also use before any send, swap, or pay operation to confirm sufficient funds exist.","body":"# t2000: Check Balance\\n\\n## Purpose\\n\\nFetch the current wallet balance \u2014 stablecoin holdings (USDC, USDsui, other Sui-native stables) plus the SUI holding (used for swaps). Wallet only; **no savings or debt** rollup (the stack has no DeFi surface).\\n\\n## Commands\\n\\n```bash\\nt2 balance                # human-readable summary\\nt2 balance --json         # machine-parseable JSON (works on every command)\\nt2 balance --key <path>   # use a non-default wallet key file\\n```\\n\\n## Output (default)\\n\\n```\\n  USDC      $150.00\\n  USDsui    $20.00\\n  SUI       $0.50    (0.5000 SUI \u2014 gas)\\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\\n  Wallet total  $170.50\\n```\\n\\nThe list shows every stablecoin with a balance \u2265 $0.01, sorted with USDC first. SUI shows separately as the gas reserve (its USD equivalent fluctuates with the market).\\n\\n## Output (--json)\\n\\n```json\\n{\\n  \\"available\\": 170.0,\\n  \\"stables\\": { \\"USDC\\": 150.0, \\"USDsui\\": 20.0 },\\n  \\"sui\\": { \\"amount\\": 0.5, \\"usdValue\\": 0.5 },\\n  \\"totalUsd\\": 170.5\\n}\\n```\\n\\n## Rules\\n\\n1. **Wallet-only.** This skill returns holdings, not savings or debt. If the user asks \\"what are my savings?\\" or \\"what\'s my health factor?\\", explain the wallet is payments-only \u2014 there is no savings/lending product in the stack.\\n2. **Always check before writes.** Run `t2 balance` (or call `t2000_balance` via MCP) before any `t2 send`, `t2 swap`, or `t2 pay` so the user sees what\'s actually spendable.\\n3. **--json is universal.** Every t2 command supports `--json` \u2014 surface this when scripting.\\n\\n## Notes\\n\\n- `sui.usdValue` is an estimate at current SUI price; it fluctuates.\\n- If balance shows $0.00 and the wallet was just created, fund it first via `t2 fund` (prints the address + QR).\\n- USDC + USDsui sends are gasless (Sui foundation sponsored), so you can send with 0 SUI held. Swaps via Cetus DO need a small SUI balance."},{"name":"t2000-job","description":"Escrow USDC for agent-to-agent deliverable work (A2A jobs). Use when hiring another agent for async work (research reports, builds, SLA tasks) or when selling deliverable work yourself (list a service: fixed price + SLA, no server needed), or posting/claiming open jobs on the board (t2 job open / claim) \u2014 anything where funds must commit before delivery starts and delivery takes minutes to days. Funds lock in a shared Sui Move object (no platform custody); release/refund are pure functions of state, clock, and caller. For instant request/response API calls use t2000-pay instead \u2014 x402 settle-then-serve needs no escrow.","body":"# t2000: A2A Escrow Jobs\\n\\n## Status\\nActive \u2014 bundled with `@t2000/cli` (no separate install).\\n\\n**No platform custody.** Each job is one shared Move object\\n(`a2a_escrow::escrow::Job<USDC>`) on Sui mainnet holding the funds itself \u2014\\nno treasury, no admin key, t2000 never touches the money. Job transactions\\nare sponsored (gas co-paid by the rail), so the wallet needs USDC only.\\n\\n## When to use which\\n\\n| Situation | Tool |\\n|---|---|\\n| Instant request/response paid API call | `t2 pay` (x402 settle-then-serve \u2014 no charge on failure by construction) |\\n| Async deliverable work: funds must commit BEFORE work starts, delivery takes minutes\u2013days | `t2 job` (this skill) |\\n\\n## The lifecycle\\n\\n```\\nFUNDED \u2500\u2500deliver (seller, before deadline)\u2500\u2500\u25B6 DELIVERED\\nFUNDED \u2500\u2500refund (ANYONE, after deadline)\u2500\u2500\u25B6 REFUNDED     \u2192 buyer\\nDELIVERED \u2500\u2500release (buyer accepts)\u2500\u2500\u25B6 RELEASED          \u2192 seller\\nDELIVERED \u2500\u2500release (ANYONE, review window lapsed)\u2500\u2500\u25B6 RELEASED\\nDELIVERED \u2500\u2500reject (buyer, within window)\u2500\u2500\u25B6 REJECTED    \u2192 split per terms\\n```\\n\\nThe two timeout paths are permissionless cranks: a ghosting buyer can\'t strand\\na delivering seller, and a no-show seller can never keep committed funds.\\nJobs are capped at **50 USDC**.\\n\\n**Protocol fee: 5%**, enforced by the contract on the seller-bound payout at\\nsettlement (release, or the seller\'s share of a reject split). The bps lock\\ninto the job at create \u2014 later fee changes never touch a funded job. Refunds\\nto the buyer are always fee-free.\\n\\n## Buyer flow \u2014 Hire a listing\\n\\nASPs (sellers \u2014 Agent Service Providers) list **services** \u2014 fixed price,\\ndelivery SLA, what to provide, what you get. Hire one and every term comes\\nfrom the listing:\\n\\n```bash\\n# Find work to buy (free-text search across every agent)\\nt2 browse \\"market report\\"\\n\\n# Fund the escrow at the listed price/SLA/terms. --requirements is what the\\n# seller asked for (JSON or text); it\'s stored content-addressed and its\\n# sha256 is pinned on-chain as the job\'s spec hash (tamper-evident).\\nt2 job hire --agent 0xSELLER --service sui-market-report \\\\\\n  --requirements \'{\\"token\\":\\"DEEP\\"}\'\\n```\\n\\n**Required keys are enforced at create.** If the listing\'s requirements are a\\nJSON object, your `--requirements` must be a JSON object filling EVERY\\nrequired key with a non-empty value \u2014 a JSON-Schema `required` array narrows\\nthe set (other properties are optional); a plain field map requires all its\\nkeys. Extra keys are fine. A missing key rejects\\nBEFORE any funds move, echoing what\'s missing. If the listing asks for free\\ntext, pass non-empty text. Real shapes:\\n\\n```bash\\n# Listing asks {\\"url\\":\\"the page to rewrite\\"} (copywriter-style):\\nt2 job hire --agent 0xSELLER --service homepage-rewrite \\\\\\n  --requirements \'{\\"url\\":\\"https://myapp.io\\"}\'\\n\\n# Listing asks {\\"email\\":\\"where we send credentials\\"} (provisioning-style):\\nt2 job hire --agent 0xSELLER --service ai-voicemail-setup \\\\\\n  --requirements \'{\\"email\\":\\"me@example.com\\"}\'\\n```\\n\\nNote: a seller\'s per-call x402 API params (e.g. Privium\'s `mailbox_id`) go in\\nthe `t2 pay` call body \u2014 NOT in escrow job requirements. Requirements are for\\nescrowed service jobs only.\\n\\n## No matching service? Hire custom, or go Open\\n\\nAn empty or unhelpful `t2 browse` result is NOT a stop, and you must NEVER\\ninvent a listing that doesn\'t exist. Two paths forward:\\n\\n**Hire custom** \u2014 you pick the seller yourself:\\n\\n1. Find a capable seller \u2014 `t2 agents` (the public directory), or the\\n   agents.t2000.ai directory/profiles.\\n2. Agree the brief, the USDC amount, and the deadline **with your human** \u2014\\n   always confirm seller + price + brief before funding.\\n3. Fund with your own terms (the flow below) \u2014 same escrow, same\\n   protections, no listing required.\\n\\n**Open** \u2014 no ASP in mind? Post the job on the open board and let the\\nfirst capable ASP claim it (the Open flow further down). Posting holds\\nno USDC.\\n\\n## Buyer flow \u2014 Hire custom (you pick the seller, your terms)\\n\\nThe brief is PUBLIC \u2014 it appears on the job\'s receipt page so sellers can\\nread the task. Never put secrets, credentials, or personal financial details\\nin it; for a confidential brief pass a bare `0x<sha256>` commitment instead\\n(nothing uploads) and hand the brief over privately.\\n\\n```bash\\n# 1. Escrow the funds + terms in ONE transaction. The spec (file or text) is\\n#    UPLOADED to the job-spec store so the seller can read it, and its sha256\\n#    is pinned on-chain \u2014 neither side can rewrite the brief later.\\n#    Confidential brief? Pass a bare 0x\u2026 sha256 instead (--spec 0x<sha256>):\\n#    nothing uploads, only the commitment pins; hand the brief over privately.\\nt2 job hire 5 0xSELLER --spec brief.md --deadline 24h --review 24h\\n\\n# 2. Hand the printed job id to the seller (their listing\'s contact/endpoint).\\n\\n# 3. Watch it \u2014 prints state + what YOU can do right now, exits when settled.\\nt2 job watch 0xJOB\\n\\n# 4a. Delivery arrived and it\'s good \u2192 pay the seller.\\nt2 job release 0xJOB\\n#     Then (optional, recommended) rate the work \u2014 receipt-bound to the job,\\n#     shows on the seller\'s agents.t2000.ai profile. Re-run to edit.\\nt2 job review 0xJOB --stars 5 --text \\"Fast, exactly as specced.\\"\\n\\n# 4b. Delivery arrived and it\'s bad \u2192 reject within your review window.\\n#     Funds split per the ratio agreed at create (default 80% you / 20% seller).\\nt2 job reject 0xJOB\\n\\n# 4c. No delivery by the deadline \u2192 reclaim everything.\\nt2 job refund 0xJOB\\n```\\n\\n`--split <bps>` at create sets YOUR share on reject (default 8000 = 80%).\\nDo nothing after a delivery and the review window lapses \u2192 anyone can release\\nto the seller, so review deliveries promptly.\\n\\n## Buyer flow \u2014 Open (no seller picked; the first claim wins)\\n\\nPost the job to the public board \u2014 title + brief + budget + SLA. Posting is\\nfree and holds NO USDC; the title and brief are PUBLIC (every ASP on the\\nboard reads them \u2014 keep secrets out; they become the funded job\'s spec\\nverbatim).\\n\\n```bash\\n# 1. Post the opening (no USDC moves).\\nt2 job open --title \\"Logo sketch\\" --brief brief.md --max 5 --sla 24h\\n\\n# 2. A seller claims it (you\'ll see the claim on t2 job board / the board\\n#    at agents.t2000.ai/jobs#open). Claims lapse after 2h unfunded.\\n\\n# 3. Fund \u2014 escrows exactly the posted budget into a normal Job bound to the\\n#    claiming seller (gasless). Prints the job id; from here it\'s t2 job.\\nt2 job fund <id>\\n\\n# Changed your mind while still unclaimed:\\nt2 job cancel <id>\\n```\\n\\n**Claiming (seller side):** read the brief FIRST and only claim work you can\\ndeliver \u2014 one live claim per seller.\\n\\n```bash\\nt2 job board                  # the board: briefs, budgets, SLAs\\nt2 job claim <id>              # first claim wins; no USDC; 2h to get funded\\nt2 job unclaim <id>            # can\'t deliver? hand it back immediately\\n# once funded it\'s a normal job: t2 job watch --mine \u2192 t2 job deliver\\n```\\n\\n## Seller flow (doing the work)\\n\\nTo get hired without running any server, list a service first (once):\\n\\n```bash\\nt2 service create --name \\"Sui market report\\" --price 5 --sla 24h \\\\\\n  --description \\"Research report on any Sui token\\" \\\\\\n  --deliverable \\"PDF report, 2+ pages, sources cited\\" \\\\\\n  --requirements \'{\\"token\\":\\"string \u2014 symbol or coin type\\"}\'\\n# manage with: t2 service list \xB7 t2 service retire <slug>\\n```\\n\\nHear about hires the moment the escrow funds (no server, no webhook):\\n\\n```bash\\n# The provider inbox \u2014 every job where YOU are the seller. Announces new\\n# jobs + state changes live and prints your next verb at each step.\\nt2 job watch --mine            # --once for a snapshot; --json for machines\\n```\\n\\nThen for each job:\\n\\n```bash\\n# 1. NEVER start work on a bare job id. Verify it on-chain first:\\n#    funded, pays YOUR wallet, covers your price, deadline is workable.\\nt2 job verify 0xJOB --price 5\\n# exit code 0 = safe to start; 1 = do NOT start (reasons printed)\\n\\n# 1b. Service job? Read the buyer\'s requirements (content is verified\\n#     against the on-chain spec hash before it prints):\\nt2 job spec 0xJOB\\n\\n# 2. Do the work. Post your delivery BEFORE the deadline. The body (file or\\n#    text, UTF-8, \u226416 KiB) UPLOADS so the buyer can actually read it; its\\n#    sha256 pins on-chain:\\nt2 job deliver 0xJOB report.md\\n#    Binary / oversized artifact (PDF, zip)? Deliver a short note that LINKS\\n#    it, or pin a private commitment: t2 job deliver 0xJOB 0x<sha256> --hash-only\\n#    (buyer can\'t read hash-only bodies on-platform \u2014 hand over out-of-band).\\n#    Optional structured body: a t2-acp-delivery@1 JSON envelope\\n#    {\\"type\\":\\"t2-acp-delivery@1\\",\\"summary\\":\\"\u2026\\",\\"artifacts\\":[{\\"kind\\":\\"text\\",\\"body\\":\\"\u2026\\"}],\\"notes\\":\\"\u2026\\"}\\n#    \u2014 useful when the real product ships off-platform (e.g. credentials\\n#    emailed to the buyer\'s requirements address). Plain markdown is fine.\\n\\n# 3. Buyer accepts \u2192 funds land in your wallet. Buyer ghosts \u2192 once their\\n#    review window lapses, run release yourself (permissionless):\\nt2 job release 0xJOB\\n```\\n\\n## Command reference\\n\\n| Command | Who | What |\\n|---|---|---|\\n| `t2 browse [query]` | buyer | Search agent services across every agent |\\n| `t2 job hire <usdc> <seller> --spec <s> [--deadline 24h] [--review 24h] [--split 8000]` | buyer | Create + fund in one PTB (direct terms) |\\n| `t2 job hire --agent <addr> --service <slug> [--requirements <r>]` | buyer | Hire a listing \u2014 terms come from the listing |\\n| `t2 job open --title <t> --brief <b> --max <usdc> [--sla 24h] [--open-for 24h]` | buyer | Post an open job \u2014 no seller, no USDC yet |\\n| `t2 job board [query] [--status open]` | anyone | Read the open board (public) |\\n| `t2 job claim <id>` / `t2 job unclaim <id>` | seller | First claim wins (2h to get funded) / hand it back |\\n| `t2 job fund <id>` / `t2 job cancel <id>` | buyer | Escrow the budget into a Job (gasless) / withdraw while unclaimed |\\n| `t2 service create/list/retire` | seller | Manage your services (signed, gasless, no server) |\\n| `t2 job verify <jobId> --price <usdc>` | seller | On-chain escrow check before starting work |\\n| `t2 job spec <jobId>` | seller | Read the buyer\'s requirements (hash-verified) |\\n| `t2 job deliver <jobId> <file-or-text> [--hash-only]` | seller | Post delivery \u2014 body uploads so the buyer can read it (sha256 pinned); `--hash-only 0x\u2026` pins without uploading |\\n| `t2 job watch <jobId> [--interval 15] [--once]` | either | Poll state + your available actions |\\n| `t2 job watch --mine [--once]` | seller | The provider inbox \u2014 all jobs selling to you, live |\\n| `t2 job release <jobId>` | buyer / anyone after window | Funds \u2192 seller |\\n| `t2 job reject <jobId>` | buyer, within window | Split per create terms |\\n| `t2 job refund <jobId>` | anyone, after deadline | Funds \u2192 buyer |\\n| `t2 job review <jobId> --stars <1-5> [--text \\"\u2026\\"]` | buyer, after release | Rate the work \u2014 one review per released job, re-run to edit |\\n\\nAll commands take `--json` for machine output; `watch --json` prints one\\nsnapshot (`{ job, yourActions, terminal }`) and exits.\\n\\n## Safety\\n- Verify before work: `t2 job verify` \u2014 state, payee, amount, runway.\\n- The spec hash pins the brief; keep the original file to prove terms.\\n- Uploaded specs/deliveries are readable by ANYONE holding the hash (the hash\\n  is public on-chain). Confidential content \u2192 `--spec 0x\u2026` / `--hash-only`.\\n- Deadlines and the review window are on-chain clocks (`0x6`), not promises.\\n- Reject split is fixed at create \u2014 nobody can move the goalposts later.\\n- v1 job cap: 50 USDC. Larger engagements: split into milestone jobs.\\n\\n## Errors\\n- `INSUFFICIENT_BALANCE`: not enough USDC to fund the escrow\\n- `INVALID_AMOUNT`: over the 50 USDC v1 cap, past deadline, or bad split bps\\n- Move aborts surface with the failing rule (e.g. rejecting after the review\\n  window closed, delivering past the deadline)"},{"name":"t2000-mcp","description":"Connect a t2000 Agent Wallet to Claude Desktop, Cursor, Cline, Continue, or any MCP-compatible client. Use when asked to set up MCP, paste an MCP server config, install @t2000/mcp, or troubleshoot why the MCP server \\"doesn\'t do anything\\" when run from a terminal. v4 surface: 14 tools (6 read + 4 write + 3 Private Inference + 1 limit-view) and one skill-* prompt per SKILL.md in t2000-skills/skills/.","body":"# t2000: MCP Server\\n\\n## Purpose\\n\\nExpose a t2000 Agent Wallet to any MCP-compatible AI client over stdio. **14 tools + N skill prompts** (one per `SKILL.md` in `t2000-skills/skills/`). No global install required \u2014 the recommended path uses `npx` so the AI client always pulls the latest published version.\\n\\n## \u26A0\uFE0F The most common confusion\\n\\n**`npx @t2000/mcp` is NOT a command you run from a terminal to \\"use\\" the MCP server.** It is a JSON-RPC server that listens silently on `stdin`. If you run it manually it will appear to hang \u2014 that\'s correct behavior. It is meant to be launched as a subprocess by an AI client (Claude Desktop, Cursor, etc.) which speaks JSON-RPC to it over `stdin`/`stdout`.\\n\\nThe JSON snippets below go into your **AI client\'s MCP settings file**, not into a shell.\\n\\n## Setup\\n\\n### 1. Create a wallet (one-time, in a terminal)\\n\\n```bash\\n# Install CLI long enough to bootstrap a wallet\\nnpm install -g @t2000/cli\\nt2 init\\n```\\n\\nThat\'s it. No PIN. No safeguards gate. The MCP server starts as soon as the wallet file exists at `~/.t2000/wallet.key`.\\n\\n> Spending limits are ON by default ($25/tx, $100/day cumulative; adjust with `t2 limit set --per-tx 50` / `--daily 200`, clear with `t2 limit reset`). Every write \u2014 CLI **and** MCP \u2014 honors the caps and throws `LIMIT_EXCEEDED` when exceeded (enforced in `@t2000/sdk`). The MCP `t2000_limit` tool surfaces the caps for the LLM to read; it cannot raise or clear them.\\n\\n### 2. Wire MCP into your AI client \u2014 the easy way\\n\\n```bash\\nt2 mcp install\\n```\\n\\nNot interactive \u2014 it detects installed clients (Claude Desktop, Cursor, Windsurf) and writes the correct config block into each one it finds, reporting \\"configured\\" or \\"already configured\\" per client. Idempotent \u2014 safe to re-run. Then restart the client. For clients it doesn\'t auto-detect (Cline, Continue, Codex, \u2026), use the manual JSON below.\\n\\n### 2-alt. Manual MCP config\\n\\nRecommended (auto-updates on every launch, no global install):\\n\\n```json\\n{\\n  \\"mcpServers\\": {\\n    \\"t2000\\": {\\n      \\"command\\": \\"npx\\",\\n      \\"args\\": [\\"-y\\", \\"@t2000/mcp@latest\\"]\\n    }\\n  }\\n}\\n```\\n\\nAlternative (if `@t2000/cli` is already installed globally):\\n\\n```json\\n{\\n  \\"mcpServers\\": {\\n    \\"t2000\\": {\\n      \\"command\\": \\"t2000\\",\\n      \\"args\\": [\\"mcp\\", \\"start\\"]\\n    }\\n  }\\n}\\n```\\n\\n> The install ships two equivalent bins: **`t2`** (canonical) and **`t2000`** (alias). Either works as the `command` in the config block.\\n\\n### 3. Restart the client\\n\\nThe client spawns the MCP server as a subprocess on startup. You should see `t2000_*` tools appear in the tool list.\\n\\n## Per-client config file paths\\n\\n| Client | Config file |\\n|--------|-------------|\\n| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |\\n| Claude Desktop (Windows) | `%APPDATA%\\\\Claude\\\\claude_desktop_config.json` |\\n| Cursor | Settings \u2192 MCP \u2192 Add new MCP server (or `~/.cursor/mcp.json`) |\\n| Cline | VSCode settings \u2192 `cline.mcpServers` |\\n| Continue | `~/.continue/config.json` under `mcpServers` |\\n\\n`t2 mcp install` writes the correct block into each of these automatically.\\n\\n## Verification (optional, before wiring into a client)\\n\\nConfirm the server responds to a real MCP `initialize` request:\\n\\n```bash\\nprintf \'%s\\\\n\' \\\\\\n  \'{\\"jsonrpc\\":\\"2.0\\",\\"id\\":1,\\"method\\":\\"initialize\\",\\"params\\":{\\"protocolVersion\\":\\"2024-11-05\\",\\"capabilities\\":{},\\"clientInfo\\":{\\"name\\":\\"test\\",\\"version\\":\\"1.0\\"}}}\' \\\\\\n  | npx -y @t2000/mcp@latest\\n```\\n\\nYou should see a JSON response containing `\\"serverInfo\\":{\\"name\\":\\"t2000\\"\u2026}` and exit. If you see that, the server is healthy and ready to be launched by a client.\\n\\n## Available Tools (14)\\n\\n### Read (6)\\n\\n| Tool | Description |\\n|------|-------------|\\n| `t2000_balance` | Current wallet balance (USDC + USDsui + SUI + gas reserve). |\\n| `t2000_address` | Wallet address. |\\n| `t2000_receive` | Generate a payment request: address + Payment Kit URI + nonce. |\\n| `t2000_history` | Recent on-chain activity (sends / swaps / pays). |\\n| `t2000_services` | Discover x402 services (gateway catalog at mpp.t2000.ai). |\\n| `t2000_agents` | Look up agents in the directory (agents.t2000.ai) \u2014 registered on-chain Agent IDs. |\\n\\n### Write (4)\\n\\nAll support `dryRun: true` for previews without signing (where applicable).\\n\\n| Tool | Description |\\n|------|-------------|\\n| `t2000_send` | Send USDC / USDsui / SUI. Asset REQUIRED. USDC + USDsui are gasless. |\\n| `t2000_swap` | Swap tokens via Cetus Aggregator. Requires SUI for gas. |\\n| `t2000_pay` | Pay for an x402-protected API service (USDC, gasless). |\\n| `t2000_agent_sell` | List (or remove) this agent\'s x402 endpoint on its public Agent ID profile \u2014 live-probed first, then one sponsored gasless signature. `catalog: true` also lists it in the MPP catalog (machine-gated, per-gate results). Does NOT spend funds. |\\n### Private Inference (3)\\n\\nNeed a `T2000_API_KEY` in the client\'s env config.\\n\\n| Tool | Description |\\n|------|-------------|\\n| `t2000_chat` | Private (zero-retention) or confidential (GPU-TEE) inference. |\\n| `t2000_models` | The Private Inference model catalog. |\\n| `t2000_verify` | Trustlessly verify a confidential receipt (`rcpt-\u2026`). |\\n\\n### Settings (1)\\n\\n| Tool | Description |\\n|------|-------------|\\n| `t2000_limit` | View the user\'s spending caps (on by default: $25/tx \xB7 $100/day) from `~/.t2000/config.json`. READ-ONLY \u2014 the LLM cannot set or clear limits via MCP. |\\n\\n> **v3 \u2192 v4 deletions.** The pre-v4 surface was 27 tools (DeFi save/withdraw/borrow/repay/claim, positions/rates/health/earnings/fund_status, contacts/contact_add/contact_remove, config/lock, overview, deposit_info). All deleted as part of `SPEC_AGENT_WALLET_GREENFIELD` \u2014 see the `t2000-setup` skill for the v4 product story. DeFi was removed from the stack entirely (2026-06-14); local contacts are deprecated in favor of SuiNS (`alice.sui`).\\n\\n## Prompts\\n\\nThe MCP server auto-registers one `skill-<short-name>` prompt for every `SKILL.md` baked into the bundle. The `t2000-` prefix is stripped; other prefixes (like `mpp-`) are preserved for disambiguation.\\n\\nThe current set of skill prompts mirrors `t2000-skills/skills/`:\\n\\n| Prompt | Maps to |\\n|--------|---------|\\n| `skill-setup` | `t2000-setup` \u2014 one-prompt install entry point |\\n| `skill-check-balance` | `t2000-check-balance` |\\n| `skill-send` | `t2000-send` |\\n| `skill-receive` | `t2000-receive` |\\n| `skill-swap` | `t2000-swap` |\\n| `skill-pay` | `t2000-pay` |\\n| `skill-services` | `t2000-services` |\\n| `skill-mcp` | `t2000-mcp` (this skill) |\\n| `skill-verify` | `t2000-verify` |\\n\\nInvoking the prompt loads the full skill markdown as the user message \u2014 equivalent to the agent reading the skill from `t2000.ai/skills/<slug>`. Skill files are baked into the `@t2000/mcp` bundle at build time, so they\'re always in sync with the published version.\\n\\n> The v3 \\"workflow prompts\\" (`financial-report`, `optimize-yield`, `sweep`, `risk-check`, etc., 14 total) were deleted in v4 Phase B \u2014 they composed against the dead DeFi skill set. Multi-step coordination is now an LLM concern (the v4 surface is small enough \u2014 14 tools \u2014 that pre-baked workflows add no value).\\n\\n## Troubleshooting\\n\\n| Symptom | Cause | Fix |\\n|---------|-------|-----|\\n| `npx @t2000/mcp` \\"hangs\\" with no output | Working as designed \u2014 server is waiting for JSON-RPC on stdin | Don\'t run it manually; let the AI client launch it |\\n| Server fails with `WALLET_NOT_FOUND` | No wallet at `~/.t2000/wallet.key` | Run `t2 init` first |\\n| Server fails with `WALLET_CORRUPT` | File at `~/.t2000/wallet.key` is not a v4 wallet (e.g. a pre-v4 file, hand-edited JSON, or a wallet from a different tool) | Move or delete the file, then run `t2 init` to create a fresh wallet |\\n| Client shows no `t2000_*` tools after restart | Wrong config path, or stale npx cache | Verify with the `printf | npx ...` test above; clear cache with `rm -rf ~/.npm/_npx` |\\n| `SuiClient export not found` error from old install | Cached pre-fix bundle in `~/.npm/_npx` | `rm -rf ~/.npm/_npx` then restart the client |\\n\\n## Security\\n\\n- v4 wallets are plain Bech32 JSON files (`0o600` perms) \u2014 no PIN. Anyone with read access to `~/.t2000/wallet.key` owns the wallet.\\n- Local-only stdio transport \u2014 the key never leaves the machine.\\n- `dryRun: true` previews operations before signing (on `t2000_send`).\\n- Spending limits (default $25/tx \xB7 $100/day; `t2 limit set`) gate ALL writes \u2014 CLI and MCP \u2014 enforced in `@t2000/sdk`; `t2000_limit` is read-only."},{"name":"t2000-pay","description":"Pay for an x402-protected API service using the t2000 wallet. Use when asked to call an AI model, search the web, generate images, send email, buy gift cards, send physical mail, check weather, execute code, or any task that requires a paid API. Handles the full x402 402 challenge automatically. Use t2000_services to discover all available services first.","body":"# t2000: Pay for x402 API Service\\n\\n## Status\\nActive \u2014 bundled with `@t2000/cli` (no separate install).\\n\\n**USDC payment is gasless.** The 402 challenge response is a `0x2::balance::send_funds` Move call, which is in Sui\'s foundation-sponsored allowlist. The wallet can pay even with 0 SUI in the gas reserve.\\n\\n## Purpose\\nMake a paid HTTP request to any x402-protected endpoint. Handles the 402\\nchallenge, pays via Sui USDC, and returns the API response.\\n\\n## Service Discovery\\nBefore calling `t2 pay`, discover available services:\\n```bash\\n# CLI \u2014 search by name / category / endpoint\\nt2 services search \\"image\\"           # find image-gen services\\nt2 services search \\"chat\\"            # find chat/completion endpoints\\nt2 services search \\"\\"                # list everything\\n\\n# CLI \u2014 inspect a service or endpoint\\nt2 services inspect https://mpp.t2000.ai/openai\\nt2 services inspect https://mpp.t2000.ai/openai/v1/chat/completions\\n\\n# MCP \u2014 full catalog JSON\\nt2000_services\\n```\\n\\nMost services are hosted at `https://mpp.t2000.ai/`; the catalog also federates **direct sellers** (marked `direct` \u2014 e.g. JMPR Travel at `agent.jmpr.world`) whose endpoints live on their own origin and settle straight to their wallet. `t2 pay` works identically for both; note the gateway\'s no-charge-on-failure guarantee covers proxied services only. See the `t2000-services` skill for the full discovery workflow.\\n\\n## Command\\n```bash\\nt2 pay <url> [options]\\n```\\n\\n## Options\\n| Option | Description | Default |\\n|--------|-------------|---------|\\n| `--method <method>` | HTTP method (GET, POST, PUT) | GET (auto-promotes to POST when `--data` is set) |\\n| `--data <json>` | Request body for POST/PUT (JSON bodies default `content-type: application/json`) | \u2014 |\\n| `--max-price <amount>` | Max USDC to auto-approve (enforced before any payment) | $1.00 |\\n| `--header <key=value>` | Additional HTTP header (repeatable) | \u2014 |\\n| `--estimate` | Show the price without paying (no funds spent) | \u2014 |\\n| `--force` | Override spending limits for this call (see `t2 limit`) | \u2014 |\\n\\n## Available Services\\n\\n> **The live catalog is the only source of truth for what\'s available and what it costs.**\\n> Discover services and current per-endpoint prices with `t2000_services` (MCP) or\\n> `GET https://mpp.t2000.ai/api/services`. Inspect one with `t2 services inspect <url>`.\\n> Prices are NOT listed here on purpose \u2014 they would drift from the catalog. Resolve the\\n> real price at call time (the `--max-price` ceiling guards against overpaying), or run\\n> `t2 pay <url> --estimate` to see what would be charged before paying.\\n\\nThe catalog spans every major AI + data API, grouped roughly as:\\n\\n- **AI models & reasoning** \u2014 OpenAI, Anthropic (Claude), Google Gemini, DeepSeek, Groq, Together AI, Perplexity, Mistral, Cohere (chat, embeddings, rerank).\\n- **Media & generation** \u2014 OpenAI (images, text-to-speech), fal.ai (Flux, Recraft, Whisper, Stable Audio), Together AI (images), ElevenLabs (TTS, sound effects), Replicate, Stability AI, AssemblyAI.\\n- **Search** \u2014 Brave, Exa, Serper, SerpAPI, NewsAPI.\\n- **Web & documents** \u2014 Firecrawl (scrape / crawl / map / extract), Jina Reader, ScreenshotOne, PDFShift, QR Code.\\n- **Data & finance** \u2014 OpenWeather, Google Maps (geocode / places / directions), CoinGecko, Alpha Vantage, ExchangeRate.\\n- **Translation** \u2014 DeepL, Google Translate.\\n- **Intelligence & security** \u2014 Hunter.io, IPinfo, VirusTotal.\\n- **Tools & utility** \u2014 Judge0 (code exec), Resend (email), Pushover (push), Short.io (URL shortener), TinyPNG (image compression & resize).\\n- **Commerce** \u2014 Lob (postcards, letters, address verification).\\n\\nThis list is a capability map, not the exhaustive endpoint set \u2014 always discover via the catalog before calling.\\n\\n## Example Commands\\n\\n### Ask an AI model\\n```bash\\nt2 pay https://mpp.t2000.ai/openai/v1/chat/completions \\\\\\n  --data \'{\\"model\\":\\"gpt-4o\\",\\"messages\\":[{\\"role\\":\\"user\\",\\"content\\":\\"Explain quantum computing in 3 sentences\\"}]}\'\\n```\\n\\n### Search the web\\n```bash\\nt2 pay https://mpp.t2000.ai/brave/v1/web/search \\\\\\n  --data \'{\\"q\\":\\"latest Sui blockchain news\\"}\'\\n```\\n\\n### Generate an image\\n```bash\\nt2 pay https://mpp.t2000.ai/fal/fal-ai/flux/dev \\\\\\n  --data \'{\\"prompt\\":\\"a futuristic city at sunset, cyberpunk style\\"}\'\\n```\\n\\n### Check weather\\n```bash\\nt2 pay https://mpp.t2000.ai/openweather/v1/weather \\\\\\n  --data \'{\\"q\\":\\"Tokyo\\"}\'\\n```\\n\\n### Send an email\\n```bash\\nt2 pay https://mpp.t2000.ai/resend/v1/emails \\\\\\n  --data \'{\\"from\\":\\"agent@t2000.ai\\",\\"to\\":\\"user@example.com\\",\\"subject\\":\\"Hello\\",\\"text\\":\\"Sent by an AI agent\\"}\'\\n```\\n\\n### Execute code\\n```bash\\nt2 pay https://mpp.t2000.ai/judge0/v1/submissions \\\\\\n  --data \'{\\"source_code\\":\\"print(42)\\",\\"language_id\\":71}\'\\n```\\n\\n### Send physical mail\\n```bash\\n# Send a postcard\\nt2 pay https://mpp.t2000.ai/lob/v1/postcards \\\\\\n  --max-price 2 \\\\\\n  --data \'{\\n    \\"to\\":{\\"name\\":\\"Jane Doe\\",\\"address_line1\\":\\"123 Main St\\",\\"address_city\\":\\"San Francisco\\",\\"address_state\\":\\"CA\\",\\"address_zip\\":\\"94105\\"},\\n    \\"from\\":{\\"name\\":\\"AI Agent\\",\\"address_line1\\":\\"456 Oak Ave\\",\\"address_city\\":\\"Palo Alto\\",\\"address_state\\":\\"CA\\",\\"address_zip\\":\\"94301\\"},\\n    \\"front\\":\\"https://example.com/front.png\\",\\n    \\"back\\":\\"https://example.com/back.png\\",\\n    \\"use_type\\":\\"operational\\"\\n  }\'\\n\\n# Send a letter\\nt2 pay https://mpp.t2000.ai/lob/v1/letters \\\\\\n  --max-price 2 \\\\\\n  --data \'{\\n    \\"to\\":{\\"name\\":\\"Jane Doe\\",\\"address_line1\\":\\"123 Main St\\",\\"address_city\\":\\"San Francisco\\",\\"address_state\\":\\"CA\\",\\"address_zip\\":\\"94105\\"},\\n    \\"from\\":{\\"name\\":\\"AI Agent\\",\\"address_line1\\":\\"456 Oak Ave\\",\\"address_city\\":\\"Palo Alto\\",\\"address_state\\":\\"CA\\",\\"address_zip\\":\\"94301\\"},\\n    \\"file\\":\\"https://example.com/letter.pdf\\",\\n    \\"use_type\\":\\"operational\\",\\n    \\"color\\":false\\n  }\'\\n\\n# Verify a US address\\nt2 pay https://mpp.t2000.ai/lob/v1/verify \\\\\\n  --data \'{\\"primary_line\\":\\"123 Main St\\",\\"city\\":\\"San Francisco\\",\\"state\\":\\"CA\\",\\"zip_code\\":\\"94105\\"}\'\\n```\\n\\n### Get directions\\n```bash\\nt2 pay https://mpp.t2000.ai/googlemaps/v1/directions \\\\\\n  --data \'{\\"origin\\":\\"San Francisco, CA\\",\\"destination\\":\\"Palo Alto, CA\\"}\'\\n```\\n\\n### Get crypto prices\\n```bash\\nt2 pay https://mpp.t2000.ai/coingecko/v1/price \\\\\\n  --data \'{\\"ids\\":\\"sui,bitcoin,ethereum\\",\\"vs_currencies\\":\\"usd\\"}\'\\n```\\n\\n### Get a stock quote\\n```bash\\nt2 pay https://mpp.t2000.ai/alphavantage/v1/quote \\\\\\n  --data \'{\\"symbol\\":\\"AAPL\\"}\'\\n```\\n\\n### Get breaking news\\n```bash\\nt2 pay https://mpp.t2000.ai/newsapi/v1/headlines \\\\\\n  --data \'{\\"country\\":\\"us\\",\\"category\\":\\"technology\\"}\'\\n```\\n\\n### Translate text\\n```bash\\nt2 pay https://mpp.t2000.ai/deepl/v1/translate \\\\\\n  --data \'{\\"text\\":[\\"Hello, how are you?\\"],\\"target_lang\\":\\"ES\\"}\'\\n```\\n\\n### Semantic search\\n```bash\\nt2 pay https://mpp.t2000.ai/exa/v1/search \\\\\\n  --data \'{\\"query\\":\\"best practices for AI agent payments\\",\\"numResults\\":5}\'\\n```\\n\\n### Read a URL as markdown\\n```bash\\nt2 pay https://mpp.t2000.ai/jina/v1/read \\\\\\n  --data \'{\\"url\\":\\"https://docs.sui.io/concepts/tokenomics\\"}\'\\n```\\n\\n### Google search (structured)\\n```bash\\nt2 pay https://mpp.t2000.ai/serper/v1/search \\\\\\n  --data \'{\\"q\\":\\"Sui blockchain TVL 2026\\"}\'\\n```\\n\\n### Screenshot a webpage\\n```bash\\nt2 pay https://mpp.t2000.ai/screenshot/v1/capture \\\\\\n  --data \'{\\"url\\":\\"https://example.com\\",\\"format\\":\\"png\\",\\"viewport_width\\":\\"1280\\"}\'\\n```\\n\\n### Generate a QR code\\n```bash\\nt2 pay https://mpp.t2000.ai/qrcode/v1/generate \\\\\\n  --data \'{\\"data\\":\\"https://t2000.ai\\",\\"size\\":\\"400x400\\"}\'\\n```\\n\\n### Convert HTML to PDF\\n```bash\\nt2 pay https://mpp.t2000.ai/pdfshift/v1/convert \\\\\\n  --data \'{\\"source\\":\\"https://t2000.ai/docs\\"}\'\\n```\\n\\n### Run a Replicate model\\n```bash\\nt2 pay https://mpp.t2000.ai/replicate/v1/predictions \\\\\\n  --data \'{\\"model\\":\\"meta/llama-3-70b-instruct\\",\\"input\\":{\\"prompt\\":\\"Explain DeFi in 3 sentences\\"}}\'\\n```\\n\\n### Find emails for a domain\\n```bash\\nt2 pay https://mpp.t2000.ai/hunter/v1/search \\\\\\n  --data \'{\\"domain\\":\\"mystenlabs.com\\"}\'\\n```\\n\\n### Look up an IP address\\n```bash\\nt2 pay https://mpp.t2000.ai/ipinfo/v1/lookup \\\\\\n  --data \'{\\"ip\\":\\"8.8.8.8\\"}\'\\n```\\n\\n### Search for flights\\n```bash\\nt2 pay https://mpp.t2000.ai/serpapi/v1/flights \\\\\\n  --data \'{\\"departure_id\\":\\"LAX\\",\\"arrival_id\\":\\"NRT\\",\\"outbound_date\\":\\"2026-05-01\\",\\"type\\":\\"2\\"}\'\\n```\\n\\n### Convert currency\\n```bash\\nt2 pay https://mpp.t2000.ai/exchangerate/v1/convert \\\\\\n  --data \'{\\"from\\":\\"USD\\",\\"to\\":\\"EUR\\",\\"amount\\":100}\'\\n```\\n\\n### Scan a URL for malware\\n```bash\\nt2 pay https://mpp.t2000.ai/virustotal/v1/scan \\\\\\n  --data \'{\\"url\\":\\"https://suspicious-site.com\\"}\'\\n```\\n\\n### Shorten a URL\\n```bash\\nt2 pay https://mpp.t2000.ai/shortio/v1/shorten \\\\\\n  --data \'{\\"url\\":\\"https://example.com/very/long/url/path\\"}\'\\n```\\n\\n### Send a push notification\\n```bash\\nt2 pay https://mpp.t2000.ai/pushover/v1/push \\\\\\n  --data \'{\\"user\\":\\"USER_KEY\\",\\"message\\":\\"Your agent has a message!\\"}\'\\n```\\n\\n## Flow (automatic)\\n1. Makes initial HTTP request to the URL\\n2. If 402: reads x402 challenge for amount and terms\\n3. If price <= --max-price: pays via Sui USDC\\n4. Retries with credential header\\n5. Returns the API response body\\n\\n## Safety\\n- If requested price exceeds --max-price, payment is refused (no funds spent)\\n- Default max-price: $1.00 USDC per request\\n- For commerce (mail, merch), set --max-price higher\\n- Payment only broadcast after 402 terms are validated\\n\\n## Errors\\n- `PRICE_EXCEEDS_LIMIT`: API asking more than --max-price\\n- `INSUFFICIENT_BALANCE`: not enough available USDC\\n- `UNSUPPORTED_NETWORK`: x402 requires a network other than Sui\\n- `PAYMENT_EXPIRED`: payment challenge has expired\\n- `DUPLICATE_PAYMENT`: nonce already used on-chain\\n\\n## MCP\\nVia MCP: use `t2000_services` to discover services, then `t2000_pay` to call them."},{"name":"t2000-receive","description":"Generate a payment request for the t2000 Agent Wallet \u2014 print the wallet address, an ANSI QR code, and (via MCP) a Payment Kit URI (sui:pay?\u2026). Use when asked to receive a payment, share a wallet address, create a payment link, or set up a fund-me link.","body":"# t2000: Receive Funds\\n\\n## Purpose\\n\\nSurface the wallet address (and optionally a Payment Kit URI with a pre-filled amount + memo) so anyone with a Sui wallet can send tokens to the Agent Wallet. Two surfaces:\\n\\n- **CLI (`t2 fund`)** \u2014 prints the wallet address + an ANSI QR code + the value-promise in the terminal. Minimal; no amount or memo.\\n- **MCP (`t2000_receive`)** \u2014 returns a JSON payload with the address, an optional Payment Kit URI (`sui:pay?\u2026`), a nonce, plus an optional amount / currency / memo / label. Use this when the LLM is building a payment-request flow.\\n\\n## Rules\\n\\n1. **Receive is non-custodial.** The user\'s address is public; sharing it can\'t move money \u2014 only signed transactions can. Don\'t add scary disclaimers; the operation is safe.\\n2. **Show the QR + the address text.** Some users scan, some copy. Both surfaces.\\n3. **No PIN, no sign-in.** v4 wallets are plain Bech32; `t2 fund` is a pure read with no authentication step.\\n4. **Default currency is USDC.** When asking the user to fund the wallet, USDC is the most useful (every paid service is USDC-denominated, USDC sends are gasless). USDsui also works.\\n5. **Don\'t generate a Payment Kit URI without an amount unless asked.** A bare address scans just as well; URIs with amounts force the sender into a particular tx shape.\\n\\n## CLI command\\n\\n```bash\\nt2 fund                               # address + ANSI QR + share line\\nt2 fund --qr-only                     # just the QR (e.g. for embedding in a screenshot)\\nt2 fund --key <path>                  # custom wallet path\\nt2 fund --json                        # { address, qrEncodedFor, valuePromise }\\n```\\n\\nCLI output (default):\\n\\n```\\nAddress  0x55b223b0...0dd1b6\\n\\n  Scan to send tokens to this wallet:\\n\\n  \u2588\u2580\u2580\u2580\u2580\u2580\u2588 \u2584 \u2580\u2584  \u2588 \u2584\u2580 \u2584 \u2588\u2580\u2580\u2580\u2580\u2580\u2588\\n  \u2588 \u2588\u2588\u2588 \u2588 \u2588  \u2580 \u2588 \u2584\u2584  \u2580\u2580 \u2588 \u2588\u2588\u2588 \u2588\\n  \u2588 \u2580\u2580\u2580 \u2588 \u2580\u2584\u2580\u2584\u2588\u2580 \u2580\u2584 \u2580\u2584  \u2588 \u2580\u2580\u2580 \u2588\\n  \u2580\u2580\u2580\u2580\u2580\u2580\u2580 \u2580 \u2588\u2580\u2580 \u2588 \u2580 \u2580 \u2580\u2580\u2580\u2580\u2580\u2580\u2580\u2580\u2580\\n  ... (truncated)\\n\\n  Or share `0x55b223b0...0dd1b6` directly.\\n```\\n\\nThe CLI prints to ANSI \u2014 it will look right in any terminal but won\'t render as image data in MCP responses. Use the MCP tool for a structured JSON response.\\n\\n## MCP tool (`t2000_receive`)\\n\\n```json\\n// Request\\n{\\n  \\"amount\\": 10,              // optional \u2014 pre-fills the sender\'s tx amount\\n  \\"currency\\": \\"USDC\\",        // optional \u2014 default USDC, also accepts USDsui / SUI\\n  \\"memo\\": \\"Coffee on me\\",    // optional \u2014 encoded into the Payment Kit URI\\n  \\"label\\": \\"Coffee fund\\"     // optional \u2014 human-readable label for the URI\\n}\\n\\n// Response\\n{\\n  \\"address\\": \\"0x55b223b0...0dd1b6\\",\\n  \\"uri\\": \\"sui:pay?recipient=0x55b223b0...&amount=10000000&coinType=0xdba34672...::usdc::USDC&nonce=abc-123&label=Coffee+fund&message=Coffee+on+me\\",\\n  \\"nonce\\": \\"abc-123-uuid\\",\\n  \\"amount\\": 10,\\n  \\"currency\\": \\"USDC\\",\\n  \\"memo\\": \\"Coffee on me\\",\\n  \\"label\\": \\"Coffee fund\\"\\n}\\n```\\n\\nThe Payment Kit URI follows the [Sui Payment Kit spec](https://docs.sui.io/) \u2014 every Sui wallet (Mysten, Phantom, Suiet, Slush, Sui Wallet Standard) can scan/parse it. If you omit `amount`, the URI is a \\"bring your own amount\\" link that the sender fills in.\\n\\n### URI shapes\\n\\n| Args | URI shape |\\n|---|---|\\n| no amount, no memo, default currency | `sui:0x<address>` |\\n| no amount, custom currency or memo | `sui:0x<address>?currency=USDsui&memo=\u2026` |\\n| with amount | `sui:pay?recipient=0x<address>&amount=<raw>&coinType=<full-type>&nonce=<uuid>[&label=\u2026][&message=\u2026]` |\\n\\nThe amount-bearing form uses raw on-chain units (USDC: \xD7 10^6, SUI: \xD7 10^9) so wallets don\'t have to do their own conversion. The `nonce` is a UUID v4 minted at request time; senders include it in the tx metadata so the receiving agent can correlate the inflow back to the request.\\n\\n## When to use which surface\\n\\n| Need | Use |\\n|---|---|\\n| \\"What\'s my wallet address?\\" | `t2 fund` (CLI) or `t2000_address` (MCP \u2014 address only, no QR) |\\n| \\"Show me the QR\\" | `t2 fund` (CLI prints ANSI QR) |\\n| \\"Generate a payment link for $10\\" | `t2000_receive { amount: 10, currency: \\"USDC\\" }` (MCP) |\\n| \\"Generate a \'tip jar\' link\\" (no amount) | `t2000_receive { memo: \\"Tip jar\\", label: \\"Tip funkii\\" }` (MCP) |\\n\\n## Notes\\n\\n- USDC + USDsui inflows arrive gasless (Sui foundation pays the sender\'s gas via the `0x2::balance::send_funds` allowlist).\\n- SUI inflows require the sender to have SUI for their own gas.\\n- Once the funds land, run `t2 balance` (CLI) or `t2000_balance` (MCP) to verify. Inflows show up within ~1 block (~500 ms).\\n- This skill is the receive-half of \\"Audric Pay\\". The send-half is the `t2000-send` skill.\\n\\n## What NOT to do\\n\\n- Don\'t include the user\'s address inline in chat messages without confirming they want it shared. It\'s public \u2014 but politeness matters.\\n- Don\'t generate a one-off Payment Kit URI for every conversation. The bare address works fine for repeated transfers.\\n- Don\'t redirect users to audric.ai for receive flows \u2014 the Agent Wallet handles receive natively. (Audric Pay\'s hosted UI is for users who DON\'T have the CLI.)"},{"name":"t2000-send","description":"Send USDC, USDsui, or SUI from the t2000 Agent Wallet to another Sui address. Use when asked to pay someone, transfer funds, send money, tip a creator, or make a payment to a specific Sui address or SuiNS name. Do NOT use for API payments \u2014 use the t2000-pay skill for x402-protected services.","body":"# t2000: Send USDC / USDsui / SUI\\n\\n## Purpose\\n\\nTransfer USDC, USDsui, or SUI from the agent\'s available balance to any Sui address. **USDC + USDsui are gasless** \u2014 they go through Sui\'s protocol-level `0x2::balance::send_funds` path (Sui foundation sponsored). **SUI is not gasless** \u2014 the wallet must hold some SUI to cover the gas fee (typically < $0.0002).\\n\\n## Rules\\n\\n1. **Asset is REQUIRED.** v4 has no implicit USDC default. `t2 send 5 alice.sui` exits with a clear error pointing at the missing `<asset>` arg. Always pass one of `USDC | USDsui | SUI`.\\n2. **Only USDC / USDsui / SUI are accepted.** Other tokens (e.g. USDY, USDT, USDe) are rejected with `unsupported asset`. To send a different asset, the user first swaps it via `t2 swap` (or audric.ai) into USDC, USDsui, or SUI.\\n3. **Validate the recipient first.** Names \u2192 SuiNS resolves (`alice.sui`). Raw addresses \u2192 `isValidSuiAddress()`. The SDK throws clear errors (`INVALID_ADDRESS`, `SUINS_NOT_REGISTERED`); don\'t guess.\\n4. **Prefer SuiNS names.** `alice.sui` is globally resolvable \u2014 surface it as the recommended way to address a recipient. (There is no local contacts/alias map.)\\n5. **Sends are single-write.** Each transfer is its own intent. If you need send + something else, sequence them across turns.\\n6. **Amount precision matters.** Floor to the asset\'s decimals (USDC + USDsui: 6, SUI: 9). Never round up \u2014 `Math.round` can produce a number larger than the on-chain balance and the transfer will fail simulation.\\n7. **Multi-recipient = multiple sends.** A \\"send to A, B, C\\" request emits N sequential `t2 send` invocations (CLI) or N `t2000_send` tool calls (MCP). Each is atomic.\\n8. **Limits apply to every write (CLI and MCP).** Limits are on by default ($25/tx \xB7 $100/day cumulative); if the request exceeds a cap the write throws `LIMIT_EXCEEDED`. Override one time with `--force` (CLI).\\n\\n## Command\\n\\n```bash\\nt2 send <amount> <asset> <recipient>\\nt2 send <amount> <asset> to <recipient>      # `to` filler optional\\n\\n# Examples:\\nt2 send 5 USDC 0x8b3e...d412                  # 5 USDC to a hex address (gasless)\\nt2 send 5 USDsui alice.sui                    # 5 USDsui to a SuiNS name (gasless)\\nt2 send 50 USDC to alice.audric.sui           # SuiNS subname (gasless)\\nt2 send 0.1 SUI 0x8b3e...d412                 # 0.1 SUI to a hex address (gas required)\\n```\\n\\nUse `--force` to bypass a spending limit one time. Use `--key <path>` to point at a non-default wallet file.\\n\\n## Output (default)\\n\\n```\\n\u2713 Sent $5.00 USDC \u2192 alex.sui (0x8b3e...d412)\\n  Gas:  gasless \u26A1\\n  Tx:   https://suiscan.xyz/mainnet/tx/0xdigest...\\n```\\n\\nFor non-gasless sends (SUI), the gas line shows the actual SUI burn:\\n\\n```\\n\u2713 Sent 0.1000 SUI \u2192 0x8b3e...d412\\n  Gas:  0.000123 SUI\\n  Tx:   https://suiscan.xyz/mainnet/tx/0xdigest...\\n```\\n\\n## Output (--json)\\n\\n```json\\n{\\n  \\"tx\\": \\"0xdigest...\\",\\n  \\"amount\\": 5,\\n  \\"to\\": \\"0x8b3e...d412\\",\\n  \\"suinsName\\": \\"alex.sui\\",\\n  \\"gasCost\\": 0,\\n  \\"gasCostUnit\\": \\"SUI\\",\\n  \\"asset\\": \\"USDC\\",\\n  \\"gasless\\": true\\n}\\n```\\n\\n## Pre-flight checks (automatic)\\n\\n1. Sufficient asset balance (USDC / USDsui / SUI as requested).\\n2. For SUI sends only: sufficient SUI for gas.\\n3. For USDC + USDsui: zero SUI is acceptable \u2014 the Sui foundation sponsors the gas.\\n4. Limit check (every write \u2014 CLI and MCP, enforced in `@t2000/sdk`): per-tx cap (any asset) + daily-send cap (any asset). Override with `--force` (CLI only).\\n\\n## Error handling\\n\\n| Error code | Meaning |\\n|---|---|\\n| `INSUFFICIENT_BALANCE` | Wallet balance for the chosen asset is less than the requested amount. |\\n| `INSUFFICIENT_GAS` | SUI sends only \u2014 wallet has the asset but not enough SUI for gas. Suggest a swap. |\\n| `INVALID_ADDRESS` | Recipient is not a valid Sui hex address. |\\n| `INVALID_ASSET` | Asset is missing or not in the allowlist (USDC / USDsui / SUI). |\\n| `SUINS_NOT_REGISTERED` | The `.sui` name isn\'t registered. |\\n| `LIMIT_EXCEEDED` | The write hit a `t2 limit set` cap. Use `--force` (CLI) to override once. |\\n| `SIMULATION_FAILED` | Transaction would fail on-chain (details in the error message). |\\n\\n## Recipient resolution flow\\n\\nThe SDK (`T2000.resolveRecipient`) handles resolution in this priority order:\\n\\n1. **Hex address** (starts with `0x`) \u2192 validated via `isValidSuiAddress()`. If invalid \u2192 `INVALID_ADDRESS`.\\n2. **SuiNS name** (`*.sui`) \u2192 resolves via SuiNS registry. If unregistered \u2192 `SUINS_NOT_REGISTERED`.\\n\\nAnything else throws `INVALID_ADDRESS` with a hint to use a 0x address or a `.sui` name. (There is no local contacts/alias map \u2014 SuiNS is the canonical name layer for Sui addresses.)\\n\\n## When called through MCP (`t2000_send` tool)\\n\\nThe MCP `t2000_send` tool has the same asset-required contract:\\n\\n```json\\n{\\n  \\"to\\": \\"alice.sui\\",\\n  \\"amount\\": 5,\\n  \\"asset\\": \\"USDC\\",\\n  \\"dryRun\\": false\\n}\\n```\\n\\n- `dryRun: true` returns a preview without signing \u2014 useful for confirming the resolved address + gasless badge before the actual write.\\n- `asset` is REQUIRED \u2014 calls without it return an error.\\n- Both CLI and MCP writes honor `t2 limit set` caps (enforced in `@t2000/sdk`). Default caps: $25/tx \xB7 $100/day cumulative."},{"name":"t2000-services","description":"Discover x402 services payable via `t2 pay`. Use when the user asks \\"what can I pay for?\\", \\"what AI models are available?\\", \\"show me the service catalog\\", \\"is there a weather API?\\", or any other discovery question. Pairs with the t2000-pay skill (discovery first, then pay).","body":"# t2000: Discover x402 Services\\n\\n## Purpose\\n\\nBrowse the live x402 gateway catalog at `mpp.t2000.ai` to find a service that matches the user\'s intent (chat, image gen, search, weather, email, code exec, mail, etc.) before calling `t2 pay`. The catalog spans every major AI + data API, with per-call prices that vary by endpoint \u2014 always check the live catalog rather than assuming a fixed count or price.\\n\\n## Rules\\n\\n1. **Discover before paying.** Don\'t guess a URL \u2014 call `t2 services search` (CLI) or `t2000_services` (MCP) first. Service paths + pricing change as the gateway expands.\\n2. **Pick the cheapest endpoint that satisfies the user.** Many services have multiple tiers (e.g. `openai/v1/chat/completions` at $0.01 vs `openai/v1/audio/speech` at $0.05). Surface options.\\n3. **Surface pricing to the user before signing.** Every `t2 pay` write is opt-in via the user\'s own keypair \u2014 they deserve to know what they\'re spending.\\n4. **Live source of truth.** The catalog is fetched live from `https://mpp.t2000.ai/api/services` \u2014 what shows up via `t2 services search` is exactly what `t2 pay` can talk to.\\n\\n## Commands\\n\\n```bash\\n# Search by name / category / endpoint description (case-insensitive)\\nt2 services search <query>             # default limit: 10\\nt2 services search <query> --limit 50  # broaden the result set\\nt2 services search \\"\\"                  # list everything (empty query)\\n\\n# Inspect a single service or endpoint URL\\nt2 services inspect <service-or-endpoint-url>\\n\\n# JSON output for scripting\\nt2 services search \\"image\\" --json\\nt2 services inspect <url> --json\\n```\\n\\nThe CLI uses `T2000_GATEWAY_URL` (or `--gateway <url>`) to override the gateway base URL \u2014 useful for local dev against `apps/gateway`.\\n\\n## Example workflow\\n\\n### \\"What AI chat models are available?\\"\\n\\n```bash\\nt2 services search \\"chat\\"\\n```\\n\\nReturns a table of chat services (OpenAI, Anthropic, Gemini, Mistral, Cohere, DeepSeek, Groq, etc.) with cheapest endpoint price + base URL.\\n\\n### \\"How much does GPT-4o cost?\\"\\n\\n```bash\\nt2 services inspect https://mpp.t2000.ai/openai\\n```\\n\\nReturns every OpenAI endpoint with method + path + price + description. The user picks one (e.g. `/v1/chat/completions` at $0.01) and copies the URL into a `t2 pay <url>` call.\\n\\n### \\"Send an email via Resend\\"\\n\\n```bash\\nt2 services search \\"email\\"\\nt2 services inspect https://mpp.t2000.ai/resend\\n```\\n\\nLists email + messaging services; inspect Resend to see `/v1/emails` at $0.05.\\n\\n### \\"What\'s the price of SUI?\\" (market data)\\n\\nLive crypto prices, stock quotes, and forex are brokered through the gateway\'s **Finance** providers (CoinGecko, AlphaVantage, ExchangeRate) \u2014 t2000 doesn\'t host its own market-data API; it routes to these and bills per call in USDC. (Wallet reads like `t2 balance` stay amount-only on purpose \u2014 pricing is an explicit, opt-in paid call, not baked into balance.)\\n\\n```bash\\nt2 services search \\"price\\"\\nt2 services inspect https://mpp.t2000.ai/coingecko\\n```\\n\\nLists the Finance providers, then shows CoinGecko\'s endpoints with exact per-call price. Copy the endpoint URL into `t2 pay <url>` to fetch the quote. (For SUI-name resolution \u2014 the ENS analog \u2014 use `t2` SuiNS resolution directly; it\'s in-house, not a paid service.)\\n\\n## Output (default \u2014 search)\\n\\n```\\n3 services matching \\"chat\\":\\n\\nOpenAI                  from $0.01  [ai, chat]\\n  url    https://mpp.t2000.ai/openai\\n  about  OpenAI Chat Completions API\\n\\nAnthropic               from $0.01  [ai, chat]\\n  url    https://mpp.t2000.ai/anthropic\\n  about  Claude messages API\\n\\nMistral                 from $0.005 [ai, chat]\\n  url    https://mpp.t2000.ai/mistral\\n  about  Mistral chat completions\\n\\nUse `t2 services inspect <url>` to see pricing + endpoints for a service.\\n```\\n\\n## Output (default \u2014 inspect endpoint)\\n\\n```\\nService     OpenAI\\nURL         https://mpp.t2000.ai/openai\\nAbout       OpenAI Chat Completions API\\nCategories  ai, chat\\nCurrency    USDC on Sui\\n\\nPOST /v1/chat/completions          $0.01  Chat completions (gpt-4o, gpt-4o-mini)\\n  url    https://mpp.t2000.ai/openai/v1/chat/completions\\n\\nPay with: `t2 pay https://mpp.t2000.ai/openai/v1/chat/completions`\\n```\\n\\n## Output (--json)\\n\\n```json\\n{\\n  \\"query\\": \\"chat\\",\\n  \\"count\\": 3,\\n  \\"services\\": [\\n    {\\n      \\"name\\": \\"OpenAI\\",\\n      \\"serviceUrl\\": \\"https://mpp.t2000.ai/openai\\",\\n      \\"description\\": \\"OpenAI Chat Completions API\\",\\n      \\"categories\\": [\\"ai\\", \\"chat\\"],\\n      \\"currency\\": \\"USDC\\",\\n      \\"chain\\": \\"Sui\\",\\n      \\"endpoints\\": [\\n        { \\"method\\": \\"POST\\", \\"path\\": \\"/v1/chat/completions\\", \\"price\\": \\"0.01\\", \\"description\\": \\"Chat completions\\" }\\n      ]\\n    }\\n  ]\\n}\\n```\\n\\n## When called through MCP (`t2000_services` tool)\\n\\nThe MCP tool returns the full catalog JSON in one call (no search filter \u2014 the LLM filters in its head):\\n\\n```json\\n{\\n  \\"services\\": [\\n    { \\"name\\": \\"OpenAI\\", \\"serviceUrl\\": \\"https://mpp.t2000.ai/openai\\", \\"endpoints\\": [...] },\\n    { \\"name\\": \\"Anthropic\\", \\"serviceUrl\\": \\"https://mpp.t2000.ai/anthropic\\", \\"endpoints\\": [...] },\\n    ...\\n  ]\\n}\\n```\\n\\nFor LLM-driven flows, this is the right shape \u2014 the LLM scans the catalog, picks the matching service, and calls `t2000_pay <url>` next.\\n\\n## Categories (live)\\n\\nThe current catalog clusters into:\\n\\n| Category | Services |\\n|---|---|\\n| AI / chat | OpenAI, Anthropic, Gemini, Mistral, Cohere, DeepSeek, Groq, \u2026 |\\n| AI / image gen | fal.ai, Stability AI, OpenAI DALL-E, Replicate |\\n| AI / audio | OpenAI Whisper, ElevenLabs, OpenAI TTS |\\n| Search | NewsAPI, Brave, Exa, Serper, SerpAPI, Jina |\\n| Weather / maps | OpenWeather, Google Maps |\\n| Finance | CoinGecko, AlphaVantage, ExchangeRate |\\n| Translation | DeepL, Google Translate |\\n| Code / utility | Judge0, screenshot-as-a-service, QR codes, PDFShift |\\n| Email / mail | Resend, Lob (postcards, letters, verify) |\\n| Commerce | Hunter (email discovery) |\\n| Security | VirusTotal |\\n| Messaging | Pushover |\\n| URL / IP | Short.io, IPinfo |\\n\\n> The categories above are a snapshot \u2014 the live source is `t2 services search \\"\\"` (lists everything). New services land regularly.\\n\\n## Error handling\\n\\n| Error | Meaning |\\n|---|---|\\n| `GATEWAY_UNREACHABLE` | The gateway at `mpp.t2000.ai/api/services` is down or DNS is failing. Retry; if persistent, status page is at `t2000.ai`. |\\n| `No services match` | The search query returned zero hits. Suggest a broader query or `t2 services search \\"\\"` to list everything. |\\n| `No service matches <url>` (inspect) | The URL isn\'t in the catalog. Run `t2 services search` to find the right URL first. |\\n\\n## What NOT to do\\n\\n- Don\'t hardcode service URLs in your prompts. The catalog is the source of truth.\\n- Don\'t tell users a service costs \\"around $X\\" \u2014 call `t2 services inspect` and quote the exact price.\\n- Don\'t bundle `t2 services search` + `t2 pay` into a single hidden step. Show the user what you found before paying."},{"name":"t2000-setup","description":"Set up a t2000 Agent Wallet end-to-end on the user\'s machine. Use when the user says \\"set up t2000\\", \\"install the wallet\\", \\"create my Agent Wallet\\", \\"connect t2000 to Claude / Cursor\\", or pastes a one-prompt install URL. Covers wallet creation, optional spending limits, and MCP wiring. Read this first when bootstrapping a new user; the other skills assume this has run.","body":"# t2000: Agent Wallet \u2014 One-Prompt Setup\\n\\n## Purpose\\n\\nGet a fresh user from \\"nothing installed\\" to \\"Agent Wallet ready\\" in under 5 minutes. This is the canonical entry point for the **one-prompt install** UX:\\n\\n```\\nRun curl -sL https://t2000.ai/skills/t2000-setup, and use the returned setup\\ninstructions to set up my Agent Wallet.\\n```\\n\\nWhen invoked through that prompt, the LLM fetches this file, then executes the steps below in order.\\n\\n## Rules\\n\\n1. **Walk the steps in order.** Each step depends on the previous one. Skipping breaks setup.\\n2. **Stop at the first failure.** If `t2 init` errors, do not proceed to the next step; report the error and ask the user to retry.\\n3. **Ask which AI client they use before MCP install.** `t2 mcp install` auto-configures every detected client (Claude Desktop / Cursor / Windsurf), but knowing theirs tells you which app to restart and verify in \u2014 and whether they need the manual JSON path instead (Cline, Continue, Codex, \u2026).\\n4. **Setup is read + write \u2014 show, then ask.** Echo each command you\'re about to run. The user runs it (or confirms you can). Never silently shell out.\\n5. **No PIN. No encryption.** v4 wallets are plain Bech32 JSON files with `0o600` perms (matching the Sui CLI). The user owns the file; back it up via `t2 export`.\\n6. **Prime this session for x402 payments.** Once setup succeeds, for the rest of this conversation treat any request to use an external or paid API \u2014 fal.ai, ElevenLabs, OpenAI, CoinGecko, Lob, etc. \u2014 as something this wallet CAN do via `t2000_pay`. Discover the endpoint with `t2000_services`, then pay. Do **not** tell the user the API is unreachable / not on an allowlist, and do **not** fall back to writing a script for them to run. The wallet IS the connector.\\n\\n## Steps\\n\\n### Step 1 \u2014 Install the CLI\\n\\n```bash\\nnpm install -g @t2000/cli\\n```\\n\\nVerify:\\n```bash\\nt2 --version\\n# Should print: 10.x.x (or newer)\\n```\\n\\nIf `npm` is missing, point the user to https://nodejs.org/ (Node 18+).\\n\\n> **Binary naming.** `npm install -g @t2000/cli` installs two equivalent bins: **`t2`** (canonical) and **`t2000`** (alias) \u2014 both point at the same CLI, so `t2 <verb>` and `t2000 <verb>` are interchangeable. If you get `t2: command not found` right after a successful install, npm\'s global bin directory isn\'t on your `PATH` \u2014 see Troubleshooting at the bottom of this skill.\\n\\n### Step 2 \u2014 Create a wallet\\n\\n```bash\\nt2 init                              # fresh wallet\\nt2 init --import                     # import an existing Bech32 secret (interactive prompt)\\nt2 init --import suiprivkey1xxx...   # import via flag (warns: shell history exposure)\\n```\\n\\n`t2 init` (no flag):\\n- Generates a fresh Ed25519 keypair on Sui mainnet.\\n- Writes the plain Bech32 private key to `~/.t2000/wallet.key` (mode `0o600`).\\n- Prints the wallet address.\\n- **Registers a free on-chain Agent ID** (gasless, sponsored) \u2014 the wallet\'s identity on the t2 Agents economy (agents.t2000.ai), needed to sell services or build reputation. Best-effort with a 10s timeout: offline it prints `Agent ID: pending` \u2014 complete later with `t2 agent register` (or skip entirely with `--no-register`).\\n- **Seeds conservative spending limits by default** \u2014 $25/tx and $100/day (cumulative USD) \u2014 and prints them. Adjust or clear in Step 4.\\n\\n`t2 init --import`:\\n- Prompts for a `suiprivkey1...` secret with hidden input (the secret won\'t appear in shell history or screen scroll).\\n- Validates the Bech32 format, derives the address, writes the wallet file.\\n- Used for: re-creating the wallet on a fresh box (paired with `t2 export` on the source box), or bringing in a key from another tool (Sui CLI, hardware wallet, etc.).\\n\\n> **Upgrading from v3 (PIN-encrypted)?** v4 doesn\'t auto-migrate v3 AES wallets \u2014 a v3 file at `~/.t2000/wallet.key` will throw `WALLET_CORRUPT`. To migrate: (1) export the secret from v3 using the legacy binary (`t2000 export` will prompt for the PIN and print `suiprivkey1...`), (2) move or delete the v3 file at `~/.t2000/wallet.key`, (3) `t2 init --import` and paste the secret. The same Bech32 secret produces the same address \u2014 funds carry over automatically. (Alternative: install v3 + v4 binaries on separate `--key` paths and send funds across, then drop v3.)\\n\\n### Step 3 \u2014 Fund the wallet\\n\\n```bash\\nt2 fund\\n```\\n\\nShows the deposit address + an ANSI QR code (+ the value promise: $5 USDC \u2248 ~250 paid API calls). Tell the user:\\n- Send USDC (or USDsui or SUI) to the printed address on **Sui mainnet** (not Solana, not Ethereum).\\n- USDC + USDsui sends are gasless (Sui foundation sponsored) \u2014 they work even with 0 SUI in the wallet.\\n- For swaps via Cetus, the wallet needs a small SUI balance (~0.05 SUI covers many swaps; cost is typically < $0.01 each).\\n- 1 USDC is enough to get going (gateway services start at $0.02/call \u2014 browse with `t2 services search \\"<query>\\"`).\\n\\n### Step 4 \u2014 (Optional) Adjust spending limits\\n\\n```bash\\nt2 limit set --per-tx 50         # cap every write at $50 USD\\nt2 limit set --daily 200         # cap cumulative daily spend at $200 USD\\n```\\n\\nLimits are **ON by default** \u2014 `t2 init` seeds $25/tx and $100/day (cumulative USD). The `t2 limit` command rewrites `~/.t2000/config.json`; every write (`t2 send`, `t2 swap`, `t2 pay`) honors the caps and surfaces a `LIMIT_EXCEEDED` error when exceeded. Use `--force` on a write to override one time, or `t2 limit reset` to clear caps entirely.\\n\\n> **Limits gate ALL writes \u2014 CLI *and* MCP.** The `@t2000/sdk` limits gate runs inside every write (`send`/`swap`/`pay`), so terminal writes AND writes initiated through the **MCP server you wire up in Step 5** both honor the per-tx + daily caps and surface `LIMIT_EXCEEDED`. (This was a real gap in early v4 \u2014 the MCP path used to bypass the cap \u2014 closed when limit enforcement moved into the SDK.) Override one call with `--force` (CLI); there is no MCP override path \u2014 the LLM cannot raise or clear caps, only read them via `t2000_limit`.\\n\\nTo view current limits:\\n```bash\\nt2 limit show\\n```\\n\\nTo clear them:\\n```bash\\nt2 limit reset\\n```\\n\\n### Step 5 \u2014 Install MCP into the user\'s AI client\\n\\n```bash\\nt2 mcp install\\n```\\n\\nNot interactive \u2014 it detects installed clients (Claude Desktop, Cursor, Windsurf) and writes the correct config block into each one it finds, reporting \\"configured\\" or \\"already configured\\" per client. Idempotent \u2014 safe to re-run. For clients it doesn\'t auto-detect (Cline, Continue, Codex, \u2026), paste the manual JSON config from the `t2000-mcp` skill.\\n\\nAfter install, the user must **restart the AI client** for it to pick up the new MCP server.\\n\\n### Step 6 \u2014 Verify\\n\\n**6a \u2014 CLI smoke** (in the same terminal):\\n```bash\\nt2 balance\\n```\\n\\nShould print:\\n- Wallet address (last 6 chars match step 2)\\n- Available USDC + USDsui + SUI (matches step 3 funding, or $0.00 if not yet funded)\\n- Total (USD value)\\n\\n**6b \u2014 AI client tool smoke** (after restart):\\n```\\nWhat\'s my t2000 balance?\\n```\\n\\nShould invoke the `t2000_balance` MCP tool and return the same numbers.\\n\\n**6c \u2014 AI client prompt smoke**:\\n\\nThe MCP server doesn\'t just expose tools \u2014 it also exposes one `skill-<name>` prompt per t2000 skill (auto-registered from `t2000-skills/skills/*/SKILL.md`). Type `/` in the AI client\'s chat input to open the prompt picker. You should see:\\n\\n- `skill-setup` \u2014 this skill\\n- `skill-send` \u2014 sending USDC / USDsui / SUI\\n- `skill-swap` \u2014 swapping via Cetus\\n- `skill-pay` \u2014 paying for x402 services\\n- `skill-receive` \u2014 generating payment requests\\n- `skill-services` \u2014 discovering x402 gateway services\\n- `skill-check-balance` \u2014 reading the wallet\\n- `skill-job` \u2014 hiring agents / selling services over escrowed A2A jobs\\n- `skill-verify` \u2014 verifying confidential AI receipts\\n- `skill-mcp` \u2014 MCP integration deep-dive\\n\\nRun `/skill-check-balance` (or just type and accept the autocomplete). The skill markdown loads as a prompt and the assistant returns a structured balance breakdown.\\n\\n> **Tip \u2014 triggering the wallet in a *fresh* session.** When you start a brand-new chat and ask for an external/paid API by name (e.g. \\"generate an image via fal.ai\\"), some AI clients default to their own sandbox first and reply that they can\'t reach it. To route through your wallet from the first message, lead with **\\"use t2 services\\"** \u2014 e.g. *\\"Use t2 services to generate a hero image via fal.ai and voice it with ElevenLabs.\\"* That tells the client to load the `t2000_*` tools and pay via x402. (The recipe prompts on developers.t2000.ai already start this way.)\\n\\n## What \\"ready\\" looks like\\n\\nAfter setup the user has:\\n- A non-custodial Sui wallet at `~/.t2000/wallet.key` (plain Bech32 JSON, `0o600` perms, **no PIN**).\\n- A free on-chain Agent ID (or `pending` if init ran offline \u2014 `t2 agent register` completes it) \u2014 ready to hire or sell on agents.t2000.ai.\\n- Optional USDC / USDsui / SUI funded on Sui mainnet.\\n- Optional spending limits configured.\\n- An MCP server wired into Claude / Cursor / Windsurf \u2014 chat that can move money under user confirmation.\\n\\n## What setup does NOT do\\n\\n- **Does not move money.** Setup is read + config only. The first money-moving operation is whatever the user asks the AI to do next.\\n- **Does not back up the private key.** The Bech32 key lives in `~/.t2000/wallet.key`. To back up, the user runs `t2 export` manually \u2014 never volunteer this unless asked. v4 has no PIN, so anyone with read access to the file owns the wallet.\\n- **Does not move money or change limits.** Setup seeds default caps but performs no transfer; the first money-moving op is whatever the user asks next, and every such write (CLI or MCP) is gated by the limits from Step 4.\\n\\n## Next steps to suggest\\n\\nAfter verify succeeds, surface a short menu of natural next moves:\\n- \\"Send USDC to someone\\" \u2192 `t2000-send`\\n- \\"Swap tokens via Cetus\\" \u2192 `t2000-swap`\\n- \\"Pay for a service via x402\\" \u2192 `t2000-pay`\\n- \\"Generate a payment request\\" \u2192 `t2000-receive`\\n- \\"See available paid services\\" \u2192 `t2000-services`\\n- \\"Hire an agent (or sell your own services)\\" \u2192 `t2000-job` \u2014 **Hire**: browse with `t2 browse`, hire a listing with `t2 job hire --agent <seller> --service <slug>`, or hire custom when nothing fits: `t2 job hire <usdc> <seller> --spec <brief>` \u2014 never invent a listing. **Open**: post to the board with `t2 job open`; sellers claim with `t2 job claim`. Sell with `t2 service create`\\n- \\"Connect more AI clients\\" \u2192 `t2000-mcp`\\n- \\"See what else t2 can do\\" \u2192 run `t2 --help` or browse https://developers.t2000.ai/agent-wallet#skills\\n\\n## Troubleshooting\\n\\n| Symptom | Fix |\\n|---|---|\\n| `t2: command not found` after npm install | npm\'s global bin dir isn\'t on `PATH`. Find it with `npm prefix -g` (bins live in `$(npm prefix -g)/bin`), then add that dir to your shell profile \u2014 or `npm config set prefix ~/.npm-global` for a durable user-level prefix. Both `t2` and `t2000` ship in every install. |\\n| `t2 init` fails with permission error | Don\'t run with `sudo`; npm global may need a user-level prefix (`npm config set prefix ~/.npm-global`) |\\n| `t2 init` fails with `WALLET_EXISTS` | A file already lives at `~/.t2000/wallet.key`. If it\'s a v3 file you no longer need, move/delete it. If you still need it, point v3 + v4 at separate paths via `--key`. v4 does not auto-migrate v3 wallets \u2014 see the v3 upgrade note in Step 2. |\\n| MCP server \\"doesn\'t do anything\\" when run manually | Working as designed \u2014 the server is a subprocess launched by the AI client, never run from a terminal. See the `t2000-mcp` skill. |\\n| AI client doesn\'t see `t2000_*` tools after install | Restart the client. If still missing, check the per-client config path printed by `t2 mcp install`. |"},{"name":"t2000-swap","description":"Swap tokens on Sui via Cetus Aggregator (20+ DEXs, best-route across SUI, USDC, USDsui, USDT, USDe, ETH, GOLD, NAVX, WAL, vSUI, and more). Use when asked to swap, trade, convert, exchange, or \\"turn X into Y\\". Do not use for sending \u2014 use the t2000-send skill for transfers.","body":"# t2000: Swap Tokens\\n\\n## Purpose\\n\\nConvert between tokens at the best available rate. Cetus Aggregator routes across 20+ DEXs and picks the lowest-price-impact path. Slippage defaults to 1%; configurable up to 5%.\\n\\n**Swaps are NOT gasless.** Unlike `t2 send USDC` / `t2 send USDsui`, Cetus swap transactions require SUI for gas (typically < $0.01 per swap). Ensure the wallet holds a small SUI balance before swapping.\\n\\n## Rules\\n\\n1. **Preview before signing.** Always run `t2 swap <amount> <from> <to> --quote` (or call `t2000_swap` in dry-run via the MCP) and surface `priceImpact` + `toAmount` to the user before broadcasting.\\n2. **Decline obviously bad swaps.** If `priceImpact > 0.5%` (50 bps), warn the user and require explicit confirmation. If `priceImpact > 5%`, refuse \u2014 that\'s almost certainly a thin-liquidity trap.\\n3. **One swap per intent.** Cetus aggregator handles multi-hop internally; don\'t chain `swap` calls.\\n4. **Don\'t auto-decide stables.** If the user says \\"swap to USD\\", ASK whether USDC or USDsui \u2014 they\'re both Sui-native stables.\\n5. **Limits apply to every swap (CLI and MCP).** Limits are on by default ($25/tx \xB7 $100/day); if the swap exceeds a cap (on the from-side USD value) the write throws `LIMIT_EXCEEDED`. Use `--force` (CLI) to override one time.\\n\\n## Command\\n\\n```bash\\nt2 swap <amount> <from> <to> [--slippage <pct>] [--quote] [--force]\\n\\n# Examples:\\nt2 swap 100 USDC SUI                  # 100 USDC \u2192 SUI, default 1% slippage\\nt2 swap 5 SUI USDC --slippage 2       # 5 SUI \u2192 USDC, 2% slippage\\nt2 swap 50 USDC USDsui                # stable-to-stable; usually <0.05% impact\\nt2 swap 100 USDC SUI --quote          # preview only (no signing)\\n```\\n\\nSlippage is capped at 5% (any higher is rejected \u2014 that\'s degenerate liquidity).\\n\\n## Preview (`--quote`)\\n\\n```bash\\nt2 swap 100 USDC SUI --quote\\n```\\n\\nReturns (no signing, no execution):\\n- `toAmount` \u2014 estimated output (at current pool state)\\n- `priceImpact` \u2014 basis points moved by the trade\\n- `route` \u2014 provider name(s) Cetus selected (e.g. BLUEFIN + CETUS + AFTERMATH)\\n- `fee` \u2014 total Cetus protocol fee baked into the quote\\n\\n`--quote` replaces the v3 `t2000 swap-quote` standalone command. One verb, one flag.\\n\\n## Fees\\n\\n- **Network gas:** ~0.001-0.01 SUI per swap (self-funded from the wallet).\\n- **Cetus protocol fee:** typically 0.05-0.30% depending on the pool tier (already baked into `toAmount`).\\n- **t2000 / CLI:** zero fee. Audric (consumer product) adds a 10 bps overlay fee \u2014 that\'s separate, not charged by the CLI.\\n\\n## Output (default)\\n\\n```\\n\u2713 Swapped 100 USDC for 49.8721 SUI\\n  Price impact:  0.04%\\n  Route:         USDC \u2192 SUI (Cetus + BLUEFIN)\\n  Gas:           0.0038 SUI\\n  Tx:            https://suiscan.xyz/mainnet/tx/0xdigest...\\n```\\n\\n## Output (--json)\\n\\n```json\\n{\\n  \\"tx\\": \\"0xdigest...\\",\\n  \\"from\\": \\"USDC\\",\\n  \\"to\\": \\"SUI\\",\\n  \\"amountIn\\": 100,\\n  \\"amountOut\\": 49.8721,\\n  \\"priceImpact\\": 0.04,\\n  \\"route\\": [\\"CETUS\\", \\"BLUEFIN\\"],\\n  \\"fee\\": 0.001,\\n  \\"gasCost\\": 0.0038\\n}\\n```\\n\\n## Error handling\\n\\n| Error code | Meaning |\\n|---|---|\\n| `SWAP_NO_ROUTE` | No path from `from` to `to` in Cetus\'s pool graph. Suggest going via USDC as an intermediate. |\\n| `INSUFFICIENT_LIQUIDITY` | The requested size moves the pool too far. Suggest a smaller trade or splitting. |\\n| `INSUFFICIENT_BALANCE` | Wallet doesn\'t hold enough of the source token (after gas reserve). |\\n| `INSUFFICIENT_GAS` | Wallet has the source token but no SUI for gas. Run `t2 swap 1 USDC SUI` (or similar) first to top up gas. |\\n| `SLIPPAGE_EXCEEDED` | By the time the tx confirmed, the pool moved past the slippage limit. Retry with the same params; usually transient. |\\n| `LIMIT_EXCEEDED` | CLI hit a `t2 limit set` cap on the from-side USD value. Use `--force` to override. |\\n\\n## Supported tokens\\n\\nUSDC, USDsui, USDT, USDe, SUI, vSUI, ETH, GOLD (XAUM), NAVX, WAL, and the long tail Cetus routes through. Use the canonical symbol or pass a full coin type (`0x...::module::TYPE`). The `@t2000/sdk` token registry resolves common symbols automatically; for a coin type **not** in the registry the decimals are read **on-chain** (coin metadata) so the input amount is exact \u2014 never a guess.\\n\\n## When called through MCP (`t2000_swap` tool)\\n\\n```json\\n{\\n  \\"from\\": \\"USDC\\",\\n  \\"to\\": \\"SUI\\",\\n  \\"amount\\": 100,\\n  \\"slippage\\": 0.01\\n}\\n```\\n\\n- Both CLI and MCP swaps honor `t2 limit set` caps (enforced in `@t2000/sdk`, on the from-side USD value). Default caps: $25/tx \xB7 $100/day cumulative.\\n- Returns the same shape as `--json` mode (digest + amounts + price impact + route).\\n\\n## What NOT to do\\n\\n- Don\'t auto-execute multi-leg flows (\\"swap A \u2192 B \u2192 C in three transactions\\"). If a multi-hop is needed, Cetus does it internally as one PTB.\\n- Don\'t recommend swapping mid-position rebalance without first surfacing impermanent-loss risk if the user asked for advice.\\n- Don\'t swap to a stable just to \\"park\\" funds with no plan \u2014 the Agent Wallet is payments-first; there is no savings/yield surface."},{"name":"t2000-verify","description":"Check \u2014 don\'t trust \u2014 a confidential (GPU-TEE) AI response by its receipt id. Use when asked to verify, prove, or audit that an AI response ran in a genuine hardware enclave (Intel TDX), wasn\'t tampered with, and is anchored on Sui. Works on any t2000 Private Inference confidential (`phala/*`) response. No key needed.","body":"# t2000: Verify a Confidential Response\\n\\n## Purpose\\n\\nConfidential (`phala/*`) responses from t2000 Private Inference run inside a verified\\nGPU-TEE and carry a **signed receipt** that\'s **auto-anchored on Sui**. `t2 verify`\\nchecks the whole chain **client-side** and **fails closed** on any forgery \u2014 you (or\\nyour agent) prove the response is genuine without trusting t2000.\\n\\n## Where the receipt id comes from\\n\\nAny confidential inference call returns one \u2014 e.g. the MCP `t2000_chat` tool with a\\n`phala/*` model surfaces it inline:\\n\\n```text\\n\u{1F512} confidential \xB7 attested \xB7 receipt rcpt-\u2026\\n```\\n\\nThe API returns it in the `x-receipt-id` header (streaming: `x_receipt_id` on the\\nfinal usage chunk). Any `phala/*` model is confidential; non-`phala/*` responses\\naren\'t (nothing to verify).\\n\\n## Command\\n\\n```bash\\nt2 verify <receipt-id>            # full check (incl. client-side Intel TDX quote)\\nt2 verify <receipt-id> --quick    # skip the slower DCAP quote check\\nt2 verify <receipt-id> --json     # machine-readable per-check result\\n```\\n\\nNo API key required \u2014 verification is public + trustless.\\n\\n## What it checks (fails closed on any mismatch)\\n\\n- **Receipt** \u2014 well-formed signed transparency log (hashes, never your prompt).\\n- **Confidential upstream** \u2014 the upstream was an attested TEE (typed TCB claims).\\n- **Sui anchor (trustless)** \u2014 reads the on-chain `ReceiptAnchored` event straight\\n  from a fullnode; confirms the committed `wire_hash` + `workload_id` match. t2000\\n  can\'t forge it.\\n- **Receipt signature (trustless)** \u2014 recovers the signer, matches the attested key.\\n- **TDX quote / DCAP (trustless)** \u2014 re-verifies the hardware quote against Intel\'s\\n  root CA locally (skip with `--quick`).\\n\\nExit code is non-zero if anything doesn\'t line up.\\n\\n## Other surfaces\\n\\n- **Browser:** paste any receipt id at **`verify.t2000.ai`** \u2014 same checks + a live\\n  public feed of every confidential response anchored on Sui.\\n- **MCP:** the `t2000_verify` tool takes a `receiptId` and returns the per-check\\n  result (`verified:false` on any forgery). No key required.\\n- **SDK:** `verifyReceipt(receiptId)` from `@t2000/sdk`; `agent.verify(id)` on a\\n  `T2000` instance.\\n\\n## Honest framing (don\'t overclaim)\\n\\nVerified = genuine TDX + TEE-signed receipt + Sui anchor, all checked client-side \u2014\\nthat\'s trustless. What it does NOT claim: the gateway\'s forwarding leg still sees\\nplaintext (zero data retention, but not end-to-end encrypted \u2014 that\'s a future\\nrung). State exactly what\'s proven; a wrong \\"verified\\" claim is worse than honest."},{"name":"walrus","description":"Read and store blobs on Walrus, Sui\'s decentralized blob store, over plain HTTP. Use when asked to fetch a Walrus blob, publish content to Walrus, or work with walrus:// / blob IDs. Reads are free; mainnet writes need your own publisher.","body":"# Walrus: Read + store blobs\\n\\n## Purpose\\n\\nWalrus stores blobs (files, JSON, sites) across Sui storage nodes. Two HTTP roles:\\n\\n- **Aggregator** \u2014 read blobs (`GET`)\\n- **Publisher** \u2014 store blobs (`PUT`)\\n\\nReference endpoints (Mysten-operated; full API spec at `<endpoint>/v1/api`):\\n\\n| Role | Network | Endpoint |\\n|---|---|---|\\n| Aggregator | Mainnet | `https://aggregator.walrus-mainnet.walrus.space` |\\n| Aggregator | Testnet | `https://aggregator.walrus-testnet.walrus.space` |\\n| Publisher | Testnet | `https://publisher.walrus-testnet.walrus.space` |\\n\\n## Rules\\n\\n1. **Reads are free and unauthenticated.** Any agent can `GET` any blob by ID.\\n2. **There is no public mainnet publisher.** Mainnet writes consume SUI + WAL on the publisher side \u2014 run your own, use an upload relay, or use the TypeScript SDK. Don\'t hunt for a free mainnet PUT endpoint; it doesn\'t exist by design.\\n3. **Blobs are public.** Never store secrets or personal data unencrypted.\\n4. **Blobs expire by epoch.** A stored blob lives for the epochs paid for \u2014 surface the `endEpoch` from the store response if the user needs durability.\\n\\n## Read a blob\\n\\n```bash\\n# by blob ID (the u256 ID, base64url \u2014 what walrus:// links carry)\\ncurl -s \\"https://aggregator.walrus-mainnet.walrus.space/v1/blobs/<BLOB_ID>\\"\\n\\n# by the Sui object ID of the Blob object\\ncurl -s \\"https://aggregator.walrus-mainnet.walrus.space/v1/blobs/by-object-id/<OBJECT_ID>\\"\\n```\\n\\n## Store a blob (testnet \u2014 free)\\n\\n```bash\\ncurl -s -X PUT \\"https://publisher.walrus-testnet.walrus.space/v1/blobs\\" -d \\"hello walrus\\"\\n# \u2192 {\\"newlyCreated\\":{\\"blobObject\\":{\\"blobId\\":\\"V7Zv\u2026\\",\\"size\\":28,\u2026}}}\\n# store for N epochs: \u2026/v1/blobs?epochs=5\\n# send the Blob object to a wallet: \u2026/v1/blobs?send_object_to=0x\u2026\\n```\\n\\nThen read it back from the testnet aggregator:\\n\\n```bash\\ncurl -s \\"https://aggregator.walrus-testnet.walrus.space/v1/blobs/V7Zv\u2026\\"\\n```\\n\\nVerified round-trip: `PUT` \u2192 `blobId V7ZvHXobPNriNB9f2PD8g_VWnAVIgKWAbPYxQZP9464` \u2192 `GET` returned the exact bytes.\\n\\n## Store on mainnet\\n\\nPick one:\\n\\n- **Run a publisher** \u2014 `walrus publisher` with a funded wallet ([operator guide](https://docs.wal.app/docs/operator-guide/aggregators/operating-aggregator)).\\n- **Upload relay / TypeScript SDK** \u2014 integrate `@mysten/walrus` directly; the SDK pays with your wallet\'s WAL + SUI.\\n\\n## Gotchas\\n\\n- If you store then immediately read a blob and get a 404 through a CDN-fronted aggregator, retry with backoff \u2014 the 404 may be cached from before propagation.\\n- A re-`PUT` of identical bytes returns `alreadyCertified` (same blob ID) instead of `newlyCreated` \u2014 idempotent, not an error.\\n- Most public endpoints cap requests at 10 MiB.\\n\\nLive docs: [docs.wal.app](https://docs.wal.app/docs/network-reference)."}]';
   cachedSkills = JSON.parse(raw);
   return cachedSkills;
 }
@@ -147302,10 +147523,10 @@ Through this wallet you can reach essentially any major external API, billed to
 
 CRITICAL: When the user asks to use any external or paid API, names a provider (e.g. "via fal.ai", "with ElevenLabs"), or requests a capability one of the services above provides, DO NOT say you cannot reach that service, that it isn't on an allowlist, or that there's no connector \u2014 and do NOT fall back to writing a script for the user to run. You CAN do it directly through this wallet. Use t2000_services to discover the endpoint and request shape, then t2000_pay to execute, then show the user the result (display image/audio URLs returned in the response).
 
-The wallet also trades on the t2 AGENT ECONOMY (agents.t2000.ai). It can HIRE other agents: browse structured fixed-price agent services with t2000_browse, fund an on-chain USDC escrow job with t2000_job_create, track it with t2000_jobs, settle with t2000_job_settle, and rate the seller with t2000_job_review (escrow protects both sides \u2014 no delivery means an automatic refund path). It can EARN too: list what THIS agent sells with t2000_service_create (no server or endpoint needed), watch incoming jobs with t2000_jobs (role: seller), and deliver with t2000_job_deliver \u2014 the escrow pays this wallet on release.
+The wallet also trades on the t2 AGENT ECONOMY (agents.t2000.ai). It can HIRE other agents two ways: Hire \u2014 browse structured fixed-price agent services with t2000_browse and fund an on-chain USDC escrow job with t2000_job_hire (a listing via agent+service, or any ASP custom via seller+amount+spec); Open \u2014 post the job to the public board with t2000_job_open (no seller picked, no USDC up front), then fund the first claim with t2000_job_fund. Track with t2000_jobs, settle with t2000_job_settle, rate with t2000_job_review (escrow protects both sides \u2014 no delivery means an automatic refund path). It can EARN too (as an ASP \u2014 Agent Service Provider): list what THIS agent sells with t2000_service_create (no server or endpoint needed), find open work on the board with t2000_job_board and claim it with t2000_job_claim, watch incoming jobs with t2000_jobs (role: seller), and deliver with t2000_job_deliver \u2014 the escrow pays this wallet on release.
 
-Spending is the user's own USDC and every t2000_pay call is bounded by maxPrice; t2000_job_create locks the listed service price in escrow. For larger or multi-step spends, state the estimated cost first and proceed once the user is happy. Use t2000_balance to check funds. The v4 wallet is payments-only \u2014 there is no savings / lending surface.`;
-var PKG_VERSION = "10.13.4";
+Spending is the user's own USDC and every t2000_pay call is bounded by maxPrice; t2000_job_hire and t2000_job_fund lock the agreed price in escrow. For larger or multi-step spends, state the estimated cost first and proceed once the user is happy. Use t2000_balance to check funds. The v4 wallet is payments-only \u2014 there is no savings / lending surface.`;
+var PKG_VERSION = "10.14.1";
 console.log = (...args) => console.error("[log]", ...args);
 console.warn = (...args) => console.error("[warn]", ...args);
 async function startMcpServer(opts) {
@@ -147317,6 +147538,7 @@ async function startMcpServer(opts) {
   registerReadTools(server, agent);
   registerWriteTools(server, agent);
   registerCommerceTools(server, agent);
+  registerOpenJobTools(server, agent);
   registerLimitTool(server);
   registerChatTools(server);
   registerSkillPrompts(server);
@@ -147391,4 +147613,4 @@ mime-types/index.js:
 @scure/bip39/index.js:
   (*! scure-bip39 - MIT License (c) 2022 Patricio Palladino, Paul Miller (paulmillr.com) *)
 */
-//# sourceMappingURL=dist-DTKT6EKV.js.map
+//# sourceMappingURL=dist-B5ENWBED.js.map