@rail402.dev/sdk

npm install @rail402.dev/sdk

const config = {
  bazaarUrl: "https://facilitator.rail402.dev", // the Bazaar is served at the facilitator base URL
  stellarSecret: process.env.RAIL402_SECRET,    // omit for search-only
  network: "stellar:testnet",
  // maxAmountCeiling?: string   a hard ceiling applied regardless of the per-call cap
  // allowPrivateHosts?: boolean opt in to pay a loopback or private host (a local seller)
};

import { searchBazaar, payAndFetch, discoverAndPay } from "@rail402.dev/sdk";

searchBazaar(config, query: string, options?: {
  network?: string;
  type?: "http" | "mcp";
  maxPrice?: string;   // atomic units
  limit?: number;
})

payAndFetch(config, resourceUrl: string, { maxAmount: string })   // maxAmount is REQUIRED

discoverAndPay(config, query: string, { maxAmount: string /* + the searchBazaar options */ })

type Result<T> =
  | { ok: true; data: T }
  | { ok: false; error: { code: string; reason: string; retryable: boolean } };

const result = await payAndFetch(config, "https://seller.example/quote?symbol=XLM", {
  maxAmount: "500000", // 0.05 USDC
});

if (!result.ok) {
  console.error(result.error.code, result.error.reason);
} else {
  console.log(result.data.body); // the resource response
}

import { describeEndpoint, describeTool, preflight } from "@rail402.dev/sdk";

describeEndpoint({
  params: {
    symbol: { description: "Ticker such as XLM or BTC.", type?, required?, example?, enum? },
  },
  outputExample?,
  bodyType?,
}) // returns { bazaar: ... }, a branded object

describeTool({ toolName: string, description: string, params: { /* ... */ }, outputExample?, transport? })

preflight({ payTo, asset, network?, horizonUrl? })
// -> { ok: boolean, findings: [{ code, reason, severity }] }