Skip to content
Integra Agentic Connectors

Status

Read a record, its state and what it proves.

GET /status/{atrHash} returns the record for an ATR hash, in either case. The record is the payment's state: a connector keeps none of its own.

The record

FieldMeaning
atrHashH.
stateissued, settling, paid or closed. See records.
expiresAtWhen the challenge lapses.
settlement{pairing, network?, reference?} once a payment is recorded, else null.
proves{claimed, pattern, settledBy}: what the record proves.
agreementThe agreement leg {state, network, transaction}, or null when the record needs no agreement step.
channelThe channel leg {network, channel, until, closed}, or null.

A hash the door never issued for this tenant answers 404 door/not-found.

Show what the record proves

Vector CV9 is a card checkout whose agreement payment was recorded before the card payment. Its record reads:

proves.ts
import type { RecordView } from "@integraledger/agentic-connectors";

const  = .. ?? "https://seller.example/door";
const  = .. ?? "";
const  = "0xcfa3a6589bf1e273ab105bb7144a2d5944af1caed14f58b39145d46842f825d8";

const  = await (`${}/status/${}`, { : { : `Bearer ${}` } });
const  = (await .()) as RecordView;

/** One line for a receipt page: what was checked, and how the payment is known to be paid. */
function (: RecordView): string {
  const  = .. ? "the buyer's payment carried this ATR's hash" : "no signed hash was checked";
  const  = { : "read on the rail", : "the facilitator's settle answer", "seller-report": "the seller's report" };
  const  = .. === null ? "not yet paid" : `paid on ${[..]}`;
  const  = .?. === "recorded" ? `; agreement recorded in ${..} on ${..}` : "";
  return `${.}: ${}; ${}${}`;
}

.(());
paid: no signed hash was checked; paid on the seller's report; agreement recorded in 0x2222222222222222222222222222222222222222222222222222222222222222 on eip155:84532

Show proves.pattern.proves as the door returns it, and never claim that the buyer signed the hash where claimed is false.

Edit on GitHub

Last updated on

On this page