x402 Payments

import { x402 } from "@oviato/connect";

// Fetch with automatic payment handling
const { response, paid, amount, token } = await x402.pay(
  "https://api.example.com/premium"
);

const data = await response.json();

if (paid) {
  console.log(`Paid ${amount} ${token} for access`);
}

const { response, paid } = await x402.pay("https://api.example.com/data", {
  method: "POST",
  body: JSON.stringify({ query: "..." }),
  headers: { "Content-Type": "application/json" },
});

import { x402 } from "@oviato/connect";

// Make initial request
const response = await fetch("https://api.example.com/premium");

if (response.status === 402) {
  // Get payment header
  const paymentHeader = response.headers.get("payment-required");

  // Sign the payment
  const { signedPayload } = await x402.sign({ paymentHeader });

  // Retry with signature
  const paidResponse = await fetch("https://api.example.com/premium", {
    headers: { "payment-signature": signedPayload },
  });

  const data = await paidResponse.json();
}

import { x402 } from "@oviato/connect";

const response = await fetch(url);

if (x402.isPaymentRequired(response)) {
  // Handle 402...
}

import { x402 } from "@oviato/connect";

const response = await fetch(url);
const details = x402.getPaymentDetails(response);

if (details) {
  console.log("Amount:", details.accepts[0].amount);
  console.log("Network:", details.accepts[0].network);
}

type X402PayOptions = RequestInit & {
  acceptIndex?: number; // Which payment option to use (default: 0)
  method?: "popup" | "iframe"; // Bridge method
};

type X402PayResult = {
  response: Response; // Final HTTP response
  paid: boolean; // Whether payment was made
  amount?: string; // Formatted amount paid
  token?: string; // Token name (e.g., "USDC")
  network?: string; // Network name
};

type X402SignOptions = {
  paymentHeader: string | X402PaymentRequired; // Base64 header or parsed object
  acceptIndex?: number; // Which payment option (default: 0)
  method?: "popup" | "iframe"; // Bridge method
};

type X402SignResult = {
  signedPayload: string; // Signed payment to send in header
  authorization: object; // Authorization details
  signature: string; // Raw signature
  network: string; // Network used
  chainId: number; // Chain ID
};

import { x402 } from "@oviato/connect";

try {
  const { response, paid } = await x402.pay(url);
  // Success...
} catch (error) {
  if (error.message.includes("User rejected")) {
    console.log("User cancelled payment");
  } else if (error.message.includes("Insufficient")) {
    console.log("Not enough balance");
  } else {
    console.log("Payment failed:", error.message);
  }
}