@aeon-ai-pay/aigateway 0.1.5 → 0.2.1

package/skills/aigateway/references/create-card.md

@@ -1,114 +0,0 @@
-# Create Virtual Card
-
-## Prerequisites
-
-Before creating a card, confirm the following:
-
-1. Wallet is configured — run `wallet-init`. If not ready, the CLI will auto-create one.
-2. Service URL is configured (built-in default is available; no action needed unless user wants to override)
-3. The `create` command automatically checks allowance and wallet balance before payment. If insufficient, it auto-initiates WalletConnect funding — no need to run `wallet` or `wallet-topup` separately.
-
-## Workflow
-
-### Step 1: Confirm Amount
-
-Ask the user how much to load onto the virtual card.
-
-- Amount limits are enforced by the CLI (`amountLimits.min` ~ `amountLimits.max`, from `wallet-init`).
-- Currency: USD (server handles crypto conversion)
-
-**If user does not specify an amount**, show the valid range and ask for confirmation (**copy must be verbatim**, variable substitution only):
-> "You can create a card of up to ${min}~${max}. How much would you like to load onto the card？"
-
-Once the user specifies an amount, **execute immediately** — no second confirmation needed.
-
-### Step 2: Execute
-
-```bash
-# Create card and auto-poll status
-npx @aeon-ai-pay/aigateway create --amount <amount> --poll
-
-# Optional: specify merchant app ID (defaults to TEST000001)
-npx @aeon-ai-pay/aigateway create --amount <amount> --app-id <merchantAppId> --poll
-```
-
-> `--app-id` is the merchant identifier sent with the request; defaults to `TEST000001` when omitted.
-
-CLI automatically handles the full flow:
-1. Send `GET /open/ai/x402/card/create?amount=X&appId=Y` → receive HTTP 402 + payment requirements (exact USDT amount)
-2. Check allowance → if insufficient and no BNB, mark BNB needed
-3. Check USDT balance → if insufficient, mark top-up needed
-4. If top-up or BNB needed → auto-initiate WalletConnect funding (opens QR page, waits for user to confirm in wallet app)
-5. After funding completes, auto-continue
-6. Approve authorization (only on first use or when allowance insufficient, costs small amount of BNB)
-7. Sign with the exact amount from the first 402 response using EIP-712
-8. Retry request with `PAYMENT-SIGNATURE` header → receive HTTP 200
-9. With `--poll`, polls up to 42 times (first 5 at 2-second intervals, then every 5 seconds) until card is ready
-
-### Step 3: Parse Result
-
-**stdout** outputs JSON (parseable), **stderr** outputs progress logs.
-
-Successful output:
-```json
-{
-  "success": true,
-  "data": {
-    "code": "0",
-    "msg": "success",
-    "model": { "orderNo": "300217748668047431791" }
-  },
-  "paymentResponse": {
-    "txHash": "0x...",
-    "networkId": "eip155:56"
-  }
-}
-```
-
-With `--poll`, additional output after card is ready:
-```json
-{
-  "pollResult": {
-    "orderNo": "300217748668047431791",
-    "orderStatus": "SUCCESS",
-    "channelStatus": "COMPLETED",
-    "orderAmount": 0.6,
-    "txHash": "0xabc...def",
-    "cardLastFour": "4321",
-    "cardBin": "485932",
-    "cardScheme": "VISA",
-    "cardBalance": 0.6,
-    "cardStatus": "ACTIVE"
-  }
-}
-```
-
-### Step 4: Present to User
-
-Fetching card details may take about 30 seconds. Output a waiting prompt first (**copy must be verbatim**):
-```
-> Fetching card details, please wait...
-```
-
-Once details are returned, on success (**copy must be verbatim**, variable substitution only):
-```
-Order No: {orderNo}
-Card: {cardScheme} •••• {last4}
-State: Active
-Remaining balance: ${amount} USD
-Usage: 0 / 1 (single-use)
-```
-
-Save the `orderNo` for subsequent status queries.
-
-## Error Handling
-
-| Scenario | CLI Output | Action |
-|------|---------|---------|
-| Amount out of range | Error JSON with allowed range | Relay to user |
-| Wallet not configured | `Wallet not configured` | Run `wallet-init` |
-| Funding signature timeout (5 min) | `Payment approval timed out. Please try again.` | Relay to user, ask if they want to retry |
-| User rejected signature | `Payment approval was rejected. Please try again if you'd like to proceed.` | Relay to user, do not auto-retry |
-| Insufficient balance after funding | `Still insufficient USDT after funding` | Relay to user |
-| Network error | Server error JSON | Retry once, then report to user |
-| Transaction reverted | txHash | Suggest user check on BSCScan |

package/skills/aigateway/references/store.md

@@ -1,87 +0,0 @@
-# AEON AI Card Store
-
-## When to use
-
-Trigger this reference when the user says:
-- "what can I buy"
-- "show me what's available"
-- "what can I do?"
-- "what can I use the card for"
-
-Present options conversationally. Do not dump the full list — highlight what's most relevant.
-
----
-
-## Virtual Card Use Cases
-
-### AEON Agent Card – Supported & Upcoming Use Cases
-
-**Coming Soon**
-- Subscriptions (ChatGPT, Claude, Midjourney)
-- Ads (Google, Meta)
-- Travel bookings
-- SaaS tools
-
-**Tell us what you want**
-
-Submit your request here:
-👉 [Google Form link]
-
----
-
-## x402 API Payments
-
-Pay these services directly using `x402 fetch`. No card needed — payment goes straight from your wallet.
-
-### AI & Data
-
-| Service | What it does | Chain |
-|---|---|---|
-| AskClaude | Per-question Claude AI access ($0.01–$0.10/query) | Base |
-| Arch AI Tools | 53 AI tools: web search, image generation, fact-checking | Base |
-| Firecrawl | Web scraping and LLM-ready content extraction | Base |
-| Gloria AI | Real-time news data for agents | Base |
-| Minifetch | Web metadata and content summaries | Base |
-
-### Blockchain & DeFi
-
-| Service | What it does | Chain |
-|---|---|---|
-| Messari | Crypto research and on-chain data | Base |
-| Nansen | Wallet intelligence and blockchain analytics | Base |
-| DiamondClaws | DeFi yield scoring and protocol risk analysis | Base |
-| Stakevia | Solana validator intelligence | Solana |
-
-### Infrastructure
-
-| Service | What it does | Chain |
-|---|---|---|
-| Pinata | IPFS file uploads and retrievals, no account required | Base |
-| Run402 | Postgres databases and serverless functions, no signup | Base |
-| Alchemy | Pay-per-request RPC / blockchain API access | Base |
-| Robtex | DNS and network intelligence APIs | Base |
-
-### Payments & Commerce
-
-| Service | What it does | Chain |
-|---|---|---|
-| Bitrefill | Buy gift cards and prepaid cards with crypto | Base |
-| ClawCredit | Access x402 services on credit, pay later | Base |
-
-Full registry: [x402.org/ecosystem](https://www.x402.org/ecosystem) · [x402list.fun](https://x402list.fun)
-
----
-
-## How to Present to the User
-
-Example response when user has no specific intent:
-
-> "Here's what you can do with AEON AI Card:
->
-> - **Virtual card** — coming soon: subscribe to ChatGPT, Claude, Midjourney, run ads, book travel
-> - **Pay AI APIs** — call Claude, Firecrawl, web search per request via x402
-> - **Access DeFi data** — Nansen, Messari on-chain analytics via x402
->
-> What would you like to do?"
-
-Adapt based on context. For virtual card intent → route to create-card flow. For x402 API intent → route to x402 flow.

package/src/commands/create-card-status.mjs

@@ -1,67 +0,0 @@
-import { resolve } from "../config.mjs";
-import { POLL_INTERVAL, MAX_POLLS } from "../constants.mjs";
-import { sanitizeOutput } from "../sanitize.mjs";
-import { emitOk, emitErr, logInfo } from "../output.mjs";
-
-export async function status(opts) {
-  const { default: axios } = await import("axios");
-  const serviceUrl = resolve(opts.serviceUrl, "AIGATEWAY_SERVICE_URL", "serviceUrl");
-  const { orderNo, poll, appId } = opts;
-
-  if (!serviceUrl) {
-    emitErr("create-card-status", "SERVICE_URL_MISSING", {
-      message: "Missing service URL. Set env AIGATEWAY_SERVICE_URL if you need to override the built-in default.",
-      appId,
-    });
-    return;
-  }
-
-  const url = `${serviceUrl}/open/ai/x402/card/status?orderNo=${encodeURIComponent(orderNo)}&appId=${encodeURIComponent(appId)}`;
-
-  if (!poll) {
-    try {
-      const res = await axios.get(url);
-      const sanitized = sanitizeOutput(res.data);
-      emitOk("create-card-status", { appId, ...sanitized }, sanitized);
-    } catch (error) {
-      emitErr("create-card-status", "SERVICE_UNAVAILABLE", {
-        message: error.message,
-        status: error.response?.status,
-        data: error.response?.data,
-        appId,
-      });
-    }
-    return;
-  }
-
-  logInfo(`Polling ${url} every ${POLL_INTERVAL / 1000}s (max ${MAX_POLLS} times)`);
-
-  for (let i = 1; i <= MAX_POLLS; i++) {
-    try {
-      const res = await axios.get(url);
-      const model = res.data?.model;
-
-      logInfo(
-        `[${i}/${MAX_POLLS}] orderStatus=${model?.orderStatus} channelStatus=${model?.channelStatus} cardStatus=${model?.cardStatus || "-"}`,
-      );
-
-      if (model?.orderStatus === "SUCCESS" || model?.orderStatus === "FAIL") {
-        const sanitized = sanitizeOutput(res.data);
-        emitOk("create-card-status", { appId, ...sanitized }, sanitized);
-        return;
-      }
-    } catch (e) {
-      logInfo(`[${i}/${MAX_POLLS}] Error: ${e.message}`);
-    }
-
-    if (i < MAX_POLLS) {
-      await new Promise((r) => setTimeout(r, POLL_INTERVAL));
-    }
-  }
-
-  emitErr("create-card-status", "POLL_TIMEOUT", {
-    orderNo,
-    appId,
-    message: "Polling timeout. Card may still be provisioning.",
-  });
-}

package/src/commands/create-card.mjs

@@ -1,352 +0,0 @@
-/**
- * create-card: issue a one-time virtual card by paying with USDT on BSC over the x402 protocol.
- *
- * Server endpoint: GET {serviceUrl}/open/ai/x402/card/create?amount=<usd>&appId=<merchant>
- * Flow: fetch payment requirements -> check balance + allowance
- *       -> (if balance is insufficient) top up via funding.mjs/fundSessionKey
- *       -> submit x402 EIP-712 signature -> optionally poll status
- */
-import { createX402Api, decodePaymentResponse, fetchPaymentRequirements } from "../x402.mjs";
-import { resolve } from "../config.mjs";
-import { getWalletBalance, getAllowance } from "../balance.mjs";
-import { sanitizeOutput } from "../sanitize.mjs";
-import axios from "axios";
-import {
-  MIN_AMOUNT, MAX_AMOUNT, POLL_INTERVAL, MAX_POLLS,
-} from "../constants.mjs";
-import { WalletConnectError } from "../walletconnect.mjs";
-import {
-  fundSessionKey,
-  promptTopupAmount,
-  MIN_TOPUP_USDT,
-  TOPUP_PRESETS,
-} from "../funding.mjs";
-import { emitOk, emitErr, logInfo } from "../output.mjs";
-
-export async function createCard(opts) {
-  logInfo("Creating Agent Card...");
-  const serviceUrl = resolve(opts.serviceUrl, "AIGATEWAY_SERVICE_URL", "serviceUrl");
-  const privateKey = resolve(opts.privateKey, "EVM_PRIVATE_KEY", "privateKey");
-  const { amount, poll, appId, dryRun } = opts;
-  const amountNum = parseFloat(amount);
-
-  if (!serviceUrl) {
-    emitErr("create-card", "SERVICE_URL_MISSING", {
-      message: "Missing service URL. Set env AIGATEWAY_SERVICE_URL if you need to override the built-in default.",
-      appId,
-    });
-    return;
-  }
-  if (!privateKey) {
-    emitErr("create-card", "WALLET_NOT_CONFIGURED", { appId });
-    return;
-  }
-  if (isNaN(amountNum) || amountNum < MIN_AMOUNT) {
-    emitErr("create-card", "AMOUNT_OUT_OF_RANGE", {
-      message: `Amount must be at least $${MIN_AMOUNT}. Allowed range: $${MIN_AMOUNT} ~ $${MAX_AMOUNT} USD.`,
-      min: MIN_AMOUNT,
-      max: MAX_AMOUNT,
-      appId,
-    });
-    return;
-  }
-  if (amountNum > MAX_AMOUNT) {
-    emitErr("create-card", "AMOUNT_OUT_OF_RANGE", {
-      message: `Amount must not exceed $${MAX_AMOUNT}. Allowed range: $${MIN_AMOUNT} ~ $${MAX_AMOUNT} USD.`,
-      min: MIN_AMOUNT,
-      max: MAX_AMOUNT,
-      appId,
-    });
-    return;
-  }
-
-  const url = `${serviceUrl}/open/ai/x402/card/create?amount=${encodeURIComponent(amount)}&appId=${encodeURIComponent(appId)}`;
-  logInfo("Fetching payment requirements...");
-  let requiredUsdt;
-  let paymentReq;
-  try {
-    paymentReq = await fetchPaymentRequirements(url);
-    requiredUsdt = paymentReq.amountUsdt;
-    logInfo(`Required: ${requiredUsdt} USDT (pay to ${paymentReq.payTo})`);
-  } catch (e) {
-    emitErr("create-card", "PAYMENT_FETCH_FAILED", {
-      message: `Failed to fetch payment requirements: ${e.message}`,
-      appId,
-    });
-    return;
-  }
-
-  logInfo("Checking wallet...");
-  let needTopup = false;
-  let needGas = false;
-  let sessionAddress;
-  let topupAmount = null;
-  let balanceInitialUsdt = null;
-  let balanceBeforeChargeUsdt = null;
-
-  try {
-    const { address, usdt, bnb, bnbRaw } = await getWalletBalance(privateKey);
-    sessionAddress = address;
-    balanceInitialUsdt = usdt;
-    balanceBeforeChargeUsdt = usdt;
-    const usdtNum = parseFloat(usdt);
-    logInfo(`Wallet: ${address}`);
-    logInfo(`Balance: ${usdt} USDT, ${bnb} BNB`);
-
-    const allowance = await getAllowance(address);
-    const requiredWei = BigInt(paymentReq.amountWei);
-    if (requiredWei === 0n) {
-      emitErr("create-card", "INVALID_PAYMENT_AMOUNT", {
-        message: "Server returned invalid payment amount (0). Please retry later.",
-        appId,
-      });
-      return;
-    }
-    if (allowance >= requiredWei) {
-      logInfo("Allowance sufficient, no approve needed.");
-    } else {
-      logInfo(`Allowance ${allowance} < required ${requiredWei}; approve needed.`);
-      if (bnbRaw === 0n) {
-        needGas = true;
-        logInfo("No BNB for approve gas, will request BNB transfer.");
-      }
-    }
-
-    if (usdtNum < requiredUsdt) {
-      needTopup = true;
-      const shortfall = requiredUsdt - usdtNum;
-      const minTopup = Math.max(MIN_TOPUP_USDT, Math.ceil(shortfall));
-      logInfo(`USDT insufficient: have ${usdtNum}, need ${requiredUsdt}, shortfall ${shortfall.toFixed(6)} (top-up minimum: ${minTopup} USDT)`);
-
-      if (opts.topupAmount != null && String(opts.topupAmount).trim() !== "") {
-        const amt = Number(opts.topupAmount);
-        if (!Number.isFinite(amt) || amt <= 0) {
-          emitErr("create-card", "AMOUNT_INVALID", {
-            message: `Invalid --topup-amount: ${opts.topupAmount}`,
-            appId,
-          });
-          return;
-        }
-        if (amt < minTopup) {
-          emitErr("create-card", "TOPUP_AMOUNT_TOO_SMALL", {
-            message: `--topup-amount ${amt} USDT is below the ${minTopup} USDT minimum for this call.`,
-            minTopup,
-            appId,
-          });
-          return;
-        }
-        topupAmount = String(opts.topupAmount);
-        logInfo(`Using --topup-amount: ${topupAmount} USDT`);
-      } else if (process.stdin.isTTY) {
-        topupAmount = await promptTopupAmount(minTopup);
-        logInfo(`Selected top-up amount: ${topupAmount} USDT`);
-      } else {
-        const presets = TOPUP_PRESETS.filter((v) => v >= minTopup);
-        emitErr("create-card", "TOPUP_REQUIRED", {
-          message: `USDT balance is below the ${minTopup} USDT minimum for this call. Choose a top-up amount and rerun with --topup-amount <usdt>.`,
-          minTopup,
-          required: requiredUsdt,
-          currentBalance: balanceInitialUsdt,
-          address: sessionAddress,
-          appId,
-          presets,
-          hint: `Rerun: aigateway wallet-topup --amount <usdt> --app-id ${appId}`,
-        });
-        return;
-      }
-    }
-  } catch (e) {
-    emitErr("create-card", "BALANCE_CHECK_FAILED", {
-      message: `Balance check failed: ${e.message}`,
-      appId,
-    });
-    return;
-  }
-
-  // Dry-run: exit after preflight checks complete
-  if (dryRun) {
-    const preview = {
-      dryRun: true,
-      appId,
-      url,
-      paymentRequirements: {
-        amountUsdt: requiredUsdt,
-        amountWei: paymentReq.amountWei,
-        asset: paymentReq.asset,
-        payTo: paymentReq.payTo,
-        orderNo: paymentReq.orderNo,
-      },
-      wallet: { address: sessionAddress },
-      decision: { needTopup, needGas, topupAmount },
-      will: [
-        ...(needTopup ? ["fund_usdt_via_walletconnect"] : []),
-        ...(needGas ? ["fund_bnb_via_walletconnect"] : []),
-        "approve_or_skip",
-        "sign_payment_eip712",
-        "submit_to_facilitator",
-        ...(poll ? ["poll_status"] : []),
-      ],
-    };
-    emitOk("create-card", preview, { success: true, ...preview });
-    return;
-  }
-
-  // WalletConnect top-up
-  if (needTopup || needGas) {
-    logInfo("Funding flow triggered...");
-    try {
-      await fundSessionKey({
-        sessionAddress,
-        usdtAmount: needTopup ? topupAmount : null,
-        needGas,
-      });
-    } catch (e) {
-      if (e instanceof WalletConnectError) {
-        emitErr("create-card", e.code, { message: e.message, address: sessionAddress, appId });
-      } else {
-        emitErr("create-card", "FUNDING_FAILED", { message: e.message, address: sessionAddress, appId });
-      }
-      return;
-    }
-
-    logInfo("Re-checking wallet balance...");
-    try {
-      const { usdt, bnbRaw } = await getWalletBalance(privateKey);
-      balanceBeforeChargeUsdt = usdt;
-      const usdtNum = parseFloat(usdt);
-      if (needGas && bnbRaw === 0n) {
-        emitErr("create-card", "INSUFFICIENT_BNB", {
-          message: "No BNB for approve transaction after funding. Run 'aigateway wallet-gas' to add BNB manually.",
-          address: sessionAddress,
-          appId,
-        });
-        return;
-      }
-      if (usdtNum < requiredUsdt) {
-        emitErr("create-card", "INSUFFICIENT_USDT", {
-          message: "Still insufficient USDT after funding.",
-          required: `${requiredUsdt} USDT`,
-          available: `${usdt} USDT`,
-          address: sessionAddress,
-          appId,
-        });
-        return;
-      }
-    } catch (e) {
-      emitErr("create-card", "BALANCE_CHECK_FAILED", {
-        message: `Balance re-check failed: ${e.message}`,
-        appId,
-      });
-      return;
-    }
-  }
-
-  const { client } = createX402Api(privateKey);
-  logInfo(`Creating card: $${amount} USD via ${url}`);
-
-  try {
-    const { x402HTTPClient } = await import("@aeon-ai-pay/core/client");
-    const httpClient = new x402HTTPClient(client);
-
-    const raw402 = paymentReq.raw402Response;
-    const getHeader = (name) => {
-      const value = raw402.headers[name] ?? raw402.headers[name.toLowerCase()];
-      return typeof value === "string" ? value : undefined;
-    };
-    const paymentRequired = httpClient.getPaymentRequiredResponse(getHeader, raw402.data);
-    const paymentPayload = await client.createPaymentPayload(paymentRequired);
-    const paymentHeaders = httpClient.encodePaymentSignatureHeader(paymentPayload);
-
-    const response = await axios.get(url, {
-      headers: { ...paymentHeaders, "Access-Control-Expose-Headers": "PAYMENT-RESPONSE" },
-    });
-    const paymentResponse = decodePaymentResponse(response.headers);
-    const orderNo = paymentReq.orderNo || response.data?.model?.orderNo || response.data?.orderNo;
-
-    let balanceAfterUsdt = null;
-    try {
-      const after = await getWalletBalance(privateKey);
-      balanceAfterUsdt = after.usdt;
-    } catch (e) {
-      logInfo(`Post-payment balance check failed: ${e.message}`);
-    }
-
-    const sanitizedData = sanitizeOutput(response.data);
-    const successData = {
-      appId,
-      orderNo,
-      amount,
-      data: sanitizedData,
-      paymentResponse,
-      balance: {
-        initial: balanceInitialUsdt,
-        before: balanceBeforeChargeUsdt,
-        after: balanceAfterUsdt,
-        charged: requiredUsdt,
-        topup: topupAmount,
-      },
-    };
-
-    function findCardStatus(obj) {
-      if (!obj || typeof obj !== 'object') return null;
-      if (obj.cardStatus) return obj.cardStatus;
-      for (const v of Object.values(obj)) {
-        const found = findCardStatus(v);
-        if (found) return found;
-      }
-      return null;
-    }
-    const initialOrderStatus = response.data?.model?.orderStatus;
-    const initialCardStatus = findCardStatus(response.data);
-    const cardReady = initialOrderStatus === "SUCCESS" || initialOrderStatus === "FAIL" || initialCardStatus === "ACTIVE";
-
-    if (cardReady) {
-      logInfo(`Card ready (orderStatus=${initialOrderStatus}, cardStatus=${initialCardStatus}), no polling needed.`);
-      emitOk("create-card", successData, { success: true, ...successData });
-      return;
-    }
-
-    if (poll && orderNo) {
-      logInfo(`\nPolling status for orderNo: ${orderNo}`);
-      const pollResult = await pollStatus(serviceUrl, orderNo, appId);
-      successData.pollResult = pollResult;
-      emitOk("create-card", successData, { success: true, ...successData, pollResult });
-      return;
-    }
-
-    if (poll && !orderNo) {
-      logInfo("Warning: No orderNo available for polling. Query status manually.");
-    }
-    emitOk("create-card", successData, { success: true, ...successData });
-  } catch (error) {
-    emitErr("create-card", "PAYMENT_FAILED", {
-      message: error.message,
-      status: error.response?.status,
-      data: error.response?.data,
-      appId,
-    });
-  }
-}
-
-async function pollStatus(serviceUrl, orderNo, appId) {
-  for (let i = 1; i <= MAX_POLLS; i++) {
-    if (i > 1) {
-      const delay = i <= 5 ? 2000 : POLL_INTERVAL;
-      await new Promise((r) => setTimeout(r, delay));
-    }
-    try {
-      const res = await axios.get(
-        `${serviceUrl}/open/ai/x402/card/status?orderNo=${encodeURIComponent(orderNo)}&appId=${encodeURIComponent(appId)}`,
-      );
-      const model = res.data?.model;
-      logInfo(`[${i}/${MAX_POLLS}] orderStatus=${model?.orderStatus} channelStatus=${model?.channelStatus}`);
-      if (model?.orderStatus === "SUCCESS" || model?.orderStatus === "FAIL" || model?.cardStatus === "ACTIVE") {
-        return sanitizeOutput(model);
-      }
-    } catch (e) {
-      logInfo(`[${i}/${MAX_POLLS}] Poll error: ${e.message}`);
-    }
-  }
-  logInfo(`Polling timeout after ${MAX_POLLS} attempts. Check manually with: aigateway create-card-status --order-no ${orderNo}`);
-  return null;
-}