MPP Protocol

// 1. Agent calls an API, gets 402
// 2. Pay via mag3nt
const payment = await mag3nt.payments.paymentsExecute({
  cardId: "sx_...",
  cardToken: "tok_...",
  url: "https://api.example.com/data",
});

// 3. mag3nt broadcasts the transaction and returns the cryptographic receipt
console.log(payment.credential.header_name);  // "Authorization"
console.log(payment.credential.header_value); // "Payment eyJjaGFs..."

// 4. Your agent replays the request with the receipt!
const response = await fetch("https://api.example.com/data", {
  headers: {
    [payment.credential.header_name]: payment.credential.header_value
  }
});

// Open stream with $5 budget
const stream = await mag3nt.mpp.mppStreamsOpen({
  payerCardId: "sx_payer...",
  payerCardToken: "tok_...",
  receiverCardId: "sx_receiver...",
  budget: 5.0,
});

// Send micro-payments as resources are consumed
await mag3nt.mpp.mppStreamsTick({
  streamId: stream.stream.id,
  amount: 0.001,
  resource: "token-generation",
});

// Check running totals
const status = await mag3nt.mpp.mppStreamsGet(stream.stream.id);
console.log(`Spent: ${status.stream.totalSettled} / ${status.stream.budget}`);

// Close when done
await mag3nt.mpp.mppStreamsClose({ streamId: stream.stream.id });