Quickstart for Buyers & Agents

npm install @stellarx402/client

import { discover } from "@stellarx402/client";

const results = await discover({
  facilitator: "https://facilitator.stellarx402.com",
  query: "weather forecast",
  maxPrice: "0.01",
  network: "stellar:testnet",
});

console.log(results[0]);
// {
//   resource: "https://api.example.com/weather",
//   description: "5-day weather forecast by lat/lng",
//   scheme: "exact",
//   amount: "0.005",
//   asset: { symbol: "USDC", ... },
//   ...
// }

import { fetchWithPayment, StellarWallet } from "@stellarx402/client";

const wallet = StellarWallet.fromSecret(process.env.STELLAR_SECRET_KEY!);

const response = await fetchWithPayment(results[0].resource, {
  wallet,
  facilitator: "https://facilitator.stellarx402.com",
});

if (response.ok) {
  console.log(await response.json());
  console.log("Paid tx:", response.headers.get("x-payment-response"));
}

import { PaymentError } from "@stellarx402/client";

try {
  await fetchWithPayment(url, { wallet, facilitator });
} catch (err) {
  if (err instanceof PaymentError) {
    switch (err.code) {
      case "insufficient_funds": /* top up wallet */ break;
      case "resource_gone":       /* remove from queue */ break;
      case "price_changed":       /* re-fetch requirements */ break;
      default:                    /* see error reference */
    }
  }
}