mrmainspring 0.1.0

package/dist/x402/facilitator.d.ts

@@ -0,0 +1,84 @@
+import { type Server } from "node:http";
+import type { CasperCommandRunner } from "../casper/anchorClient.js";
+import type { JsonObject } from "../memory/types.js";
+import { type X402CasperCliSettlementConfig, type X402SettlementInput } from "./settlement.js";
+export type X402FacilitatorLogger = {
+    info?(message: string): void;
+    warn?(message: string): void;
+    error?(message: string): void;
+};
+export type X402FacilitatorHttpServerConfig = {
+    facilitatorUrl?: string | null;
+    settlementConfig: X402CasperCliSettlementConfig;
+    commandRunner?: CasperCommandRunner;
+    replayStore?: X402FacilitatorReplayStore;
+    now?: () => Date;
+    logger?: X402FacilitatorLogger;
+    maxBodyBytes?: number;
+};
+export type X402FacilitatorReplayState = "verified" | "settling" | "settled" | "failed";
+export type X402FacilitatorReplayRecord = {
+    replayKey: string;
+    payloadHash: string;
+    state: X402FacilitatorReplayState;
+    transactionHash: string | null;
+    updatedAt: string;
+};
+export type X402FacilitatorReplayStore = {
+    reserveVerify(payment: ValidatedX402FacilitatorPayment): X402ReplayReservation;
+    reserveSettle(payment: ValidatedX402FacilitatorPayment): X402ReplayReservation;
+    completeSettle(payment: ValidatedX402FacilitatorPayment, state: "settled" | "failed", transactionHash: string | null): void;
+};
+export type X402ReplayReservation = {
+    ok: true;
+} | {
+    ok: false;
+    reason: "payment_payload_replayed" | "nonce_replayed" | "payment_settlement_in_progress";
+};
+export type X402FacilitatorRejectionReason = "request_not_object" | "payment_payload_missing" | "payment_requirements_missing" | "payment_requirements_no_matching_accept" | "selected_requirement_hash_missing" | "selected_requirement_hash_invalid" | "selected_requirement_hash_mismatch" | "accepted_requirement_hash_mismatch" | "scheme_missing" | "scheme_unsupported" | "network_missing" | "network_mismatch" | "amount_missing" | "amount_invalid" | "amount_mismatch" | "resource_missing" | "resource_mismatch" | "method_missing" | "method_invalid" | "method_mismatch" | "asset_missing" | "asset_mismatch" | "payee_missing" | "payee_mismatch" | "payer_missing" | "authorization_missing" | "payment_id_missing" | "payment_id_invalid" | "policy_hash_missing" | "policy_hash_invalid" | "public_key_missing" | "public_key_invalid" | "signature_missing" | "signature_invalid" | "authorization_hash_mismatch" | "nonce_missing" | "nonce_invalid" | "nonce_mismatch" | "valid_after_missing" | "valid_until_missing" | "validity_window_invalid" | "payment_not_yet_valid" | "payment_expired" | "timeout_missing" | "timeout_invalid" | "timeout_exceeded";
+export type ValidatedX402FacilitatorPayment = {
+    paymentPayload: JsonObject;
+    paymentRequirements: JsonObject;
+    selectedRequirementHash: string;
+    payloadHash: string;
+    replayKey: string;
+    nonce: string;
+    paymentId: string;
+    policyHash: string;
+    payer: string;
+    publicKey: string;
+    signature: string;
+    requirement: NormalizedFacilitatorRequirement;
+    settlementInput: X402SettlementInput;
+};
+type NormalizedFacilitatorRequirement = {
+    scheme: "exact";
+    network: string;
+    amount: string;
+    resource: string;
+    method: string;
+    asset: string;
+    payTo: string;
+    timeoutSeconds: number;
+};
+type X402FacilitatorPaymentValidation = {
+    ok: true;
+    payment: ValidatedX402FacilitatorPayment;
+} | {
+    ok: false;
+    reason: X402FacilitatorRejectionReason;
+    statusCode: number;
+};
+export declare class InMemoryX402FacilitatorReplayStore implements X402FacilitatorReplayStore {
+    private readonly records;
+    reserveVerify(payment: ValidatedX402FacilitatorPayment): X402ReplayReservation;
+    reserveSettle(payment: ValidatedX402FacilitatorPayment): X402ReplayReservation;
+    completeSettle(payment: ValidatedX402FacilitatorPayment, state: "settled" | "failed", transactionHash: string | null): void;
+}
+export declare function createX402FacilitatorHttpServer(config: X402FacilitatorHttpServerConfig): Server;
+export declare function validateX402FacilitatorPayment(input: unknown, options?: {
+    expectedNetwork?: string | null;
+    now?: () => Date;
+    facilitatorUrl?: string | null;
+}): X402FacilitatorPaymentValidation;
+export {};