@perkos/agent-sdk 0.1.0 → 0.3.0

package/dist/x402-facilitator.d.ts

@@ -0,0 +1,86 @@
+import type { PaymentPayload, PaymentRequirements, SchemeNetworkFacilitator, SettleResponse, VerifyResponse } from "@x402/core/types";
+import type { PaymentAsset, PerkOSNetwork, ResolvedPerkOSConfig } from "./types.js";
+export type X402VerifierFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export interface PerkOSX402TransactionSource {
+    getTransaction(txid: string): Promise<unknown | null>;
+    getChainTip(): Promise<number>;
+}
+export interface HiroX402TransactionSourceOptions {
+    readonly network: PerkOSNetwork;
+    readonly apiUrl?: string;
+    readonly fetch?: X402VerifierFetch;
+}
+export interface PerkOSX402ReplayRecord {
+    readonly key: string;
+    readonly network: PerkOSNetwork;
+    readonly transaction: string;
+    readonly payer: string;
+    readonly asset: PaymentAsset;
+    readonly jobId: string;
+    readonly amount: string;
+    readonly resource?: string;
+    readonly consumedAt: string;
+}
+export interface PerkOSX402ReplayStore {
+    has(key: string): Promise<boolean>;
+    consume(key: string, record: PerkOSX402ReplayRecord): Promise<boolean>;
+}
+export interface PerkOSX402VerifiedPayment {
+    readonly network: PerkOSNetwork;
+    readonly transaction: string;
+    readonly payer: string;
+    readonly asset: PaymentAsset;
+    readonly jobId: bigint;
+    readonly amount: bigint;
+    readonly commerceContract: string;
+    readonly blockHeight: number;
+    readonly blockHash: string;
+    readonly blockTime: number;
+    readonly confirmations: number;
+    readonly replayKey: string;
+}
+export interface PerkOSX402FacilitatorOptions {
+    readonly config: ResolvedPerkOSConfig;
+    readonly replayStore: PerkOSX402ReplayStore;
+    readonly transactionSource?: PerkOSX402TransactionSource;
+    readonly minConfirmations?: number;
+    readonly clockSkewSeconds?: number;
+    readonly now?: () => number;
+}
+export declare class PerkOSX402VerificationError extends Error {
+    readonly reason: string;
+    readonly details: Readonly<Record<string, unknown>> | undefined;
+    constructor(reason: string, message: string, details?: Readonly<Record<string, unknown>>);
+}
+export declare function perkosX402ReplayKey(network: PerkOSNetwork, txid: string): string;
+export declare class HiroX402TransactionSource implements PerkOSX402TransactionSource {
+    private readonly apiUrl;
+    private readonly fetch;
+    constructor(options: HiroX402TransactionSourceOptions);
+    getTransaction(txidInput: string): Promise<unknown | null>;
+    getChainTip(): Promise<number>;
+}
+export declare class InMemoryX402ReplayStore implements PerkOSX402ReplayStore {
+    private readonly records;
+    has(key: string): Promise<boolean>;
+    consume(key: string, record: PerkOSX402ReplayRecord): Promise<boolean>;
+    get(key: string): PerkOSX402ReplayRecord | undefined;
+}
+export declare class PerkOSX402Facilitator implements SchemeNetworkFacilitator {
+    readonly scheme = "exact";
+    readonly caipFamily = "stacks:*";
+    private readonly config;
+    private readonly replayStore;
+    private readonly transactionSource;
+    private readonly minConfirmations;
+    private readonly clockSkewSeconds;
+    private readonly now;
+    constructor(options: PerkOSX402FacilitatorOptions);
+    getExtra(network: string): Record<string, unknown> | undefined;
+    getSigners(_network: string): string[];
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+    inspect(payload: PaymentPayload, requirements: PaymentRequirements): Promise<PerkOSX402VerifiedPayment>;
+    private asVerificationError;
+}
+//# sourceMappingURL=x402-facilitator.d.ts.map

package/dist/x402-facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-facilitator.d.ts","sourceRoot":"","sources":["../src/x402-facilitator.ts"],"names":[],"mappings":"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"}

package/dist/x402-facilitator.js

@@ -0,0 +1,480 @@
+import { deepEqual } from "@x402/core/utils";
+import { deserializeCV } from "@stacks/transactions";
+import { PerkOSError } from "./errors.js";
+import { expectPrincipal, expectString, expectTuple, expectUint, } from "./clarity.js";
+import { normalizeTxid } from "./txid.js";
+import { normalizeApiUrl } from "./validation.js";
+import { PERKOS_X402_ASSET_TRANSFER_METHOD, PERKOS_X402_PAYMENT_FLOW, PERKOS_X402_SCHEME, fromStacksX402Network, parsePerkOSX402PaymentPayload, parsePerkOSX402Requirement, toStacksX402Network, } from "./x402.js";
+const DEFAULT_API_URL = {
+    mainnet: "https://api.hiro.so",
+    testnet: "https://api.testnet.hiro.so",
+};
+const DEFAULT_MIN_CONFIRMATIONS = 1;
+const DEFAULT_CLOCK_SKEW_SECONDS = 30;
+export class PerkOSX402VerificationError extends Error {
+    reason;
+    details;
+    constructor(reason, message, details) {
+        super(message);
+        this.name = "PerkOSX402VerificationError";
+        this.reason = reason;
+        this.details = details;
+    }
+}
+function verificationError(reason, message, details) {
+    return new PerkOSX402VerificationError(reason, message, details);
+}
+function positiveInteger(value, fallback, field) {
+    const resolved = value ?? fallback;
+    if (!Number.isSafeInteger(resolved) || resolved < 1) {
+        throw new PerkOSError("CONFIG_INVALID", `${field} must be a positive safe integer.`, {
+            field,
+            value: resolved,
+        });
+    }
+    return resolved;
+}
+function nonNegativeInteger(value, fallback, field) {
+    const resolved = value ?? fallback;
+    if (!Number.isSafeInteger(resolved) || resolved < 0) {
+        throw new PerkOSError("CONFIG_INVALID", `${field} must be a non-negative safe integer.`, { field, value: resolved });
+    }
+    return resolved;
+}
+function asRecord(value, label) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw verificationError("verification_unavailable", `The Stacks API returned an invalid ${label}.`);
+    }
+    return value;
+}
+function requiredString(record, field) {
+    const value = record[field];
+    if (typeof value !== "string" || value.length === 0) {
+        throw verificationError("verification_unavailable", `The Stacks API response is missing ${field}.`);
+    }
+    return value;
+}
+function requiredInteger(record, field) {
+    const value = record[field];
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw verificationError("verification_unavailable", `The Stacks API response has an invalid ${field}.`);
+    }
+    return value;
+}
+function optionalPayloadString(payload, field) {
+    const value = payload.payload[field];
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function normalizePayloadTxid(payload) {
+    const transaction = optionalPayloadString(payload, "transaction");
+    if (!transaction)
+        return "";
+    try {
+        return normalizeTxid(transaction);
+    }
+    catch {
+        return "";
+    }
+}
+function payloadPayer(payload) {
+    return optionalPayloadString(payload, "payer");
+}
+function transferMatches(value, proof) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const event = value;
+    const expectedType = proof.asset === "sbtc" ? "ft_asset" : "stx_asset";
+    if (event.type !== expectedType)
+        return false;
+    const assetKey = proof.asset === "sbtc" ? "ft_asset" : "stx_asset";
+    const assetValue = event[assetKey];
+    if (!assetValue || typeof assetValue !== "object" || Array.isArray(assetValue)) {
+        return false;
+    }
+    const asset = assetValue;
+    if (asset.type !== "transfer" ||
+        asset.sender !== proof.payer ||
+        asset.recipient !== proof.commerceContract ||
+        asset.amount !== proof.amount.toString()) {
+        return false;
+    }
+    return proof.asset === "stx" || asset.asset_identifier === proof.assetIdentifier;
+}
+function fundingLogMatches(value, proof, sbtcToken) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const event = value;
+    if (event.type !== "contract_log")
+        return false;
+    if (!event.contract_log ||
+        typeof event.contract_log !== "object" ||
+        Array.isArray(event.contract_log)) {
+        return false;
+    }
+    const log = event.contract_log;
+    if (log.contract_id !== proof.commerceContract || log.topic !== "print") {
+        return false;
+    }
+    if (!log.value || typeof log.value !== "object" || Array.isArray(log.value)) {
+        return false;
+    }
+    const hex = log.value.hex;
+    if (typeof hex !== "string" || hex.length === 0)
+        return false;
+    try {
+        const tuple = expectTuple(deserializeCV(hex), "x402 funding event");
+        if (expectString(tuple.event, "x402 funding event.event") !== "job-funded" ||
+            expectUint(tuple["job-id"], "x402 funding event.job-id") !== proof.jobId ||
+            expectUint(tuple.amount, "x402 funding event.amount") !== proof.amount) {
+            return false;
+        }
+        return (proof.asset === "stx" ||
+            expectPrincipal(tuple.token, "x402 funding event.token") === sbtcToken);
+    }
+    catch {
+        return false;
+    }
+}
+function requirementFailure(cause) {
+    return verificationError("invalid_payment_requirements", "The payment requirements are not valid for the configured PerkOS deployment.", { cause });
+}
+function payloadFailure(cause) {
+    return verificationError("invalid_payload", "The payment payload is not a valid PerkOS Stacks proof.", { cause });
+}
+export function perkosX402ReplayKey(network, txid) {
+    return `${network}:${normalizeTxid(txid)}`;
+}
+export class HiroX402TransactionSource {
+    apiUrl;
+    fetch;
+    constructor(options) {
+        this.apiUrl = normalizeApiUrl(options.apiUrl ?? DEFAULT_API_URL[options.network], "HiroX402TransactionSource apiUrl");
+        this.fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    async getTransaction(txidInput) {
+        const txid = normalizeTxid(txidInput);
+        let response;
+        try {
+            response = await this.fetch(`${this.apiUrl}/extended/v3/transactions/${encodeURIComponent(txid)}`, { headers: { accept: "application/json" } });
+        }
+        catch (cause) {
+            throw new PerkOSError("X402_PAYMENT_FAILED", "Could not reach the Stacks transaction API.", { cause, txid });
+        }
+        if (response.status === 404)
+            return null;
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new PerkOSError("X402_PAYMENT_FAILED", `Stacks transaction API returned HTTP ${response.status}.`, { txid, status: response.status, body: body.slice(0, 500) });
+        }
+        let transaction;
+        try {
+            transaction = await response.json();
+        }
+        catch (cause) {
+            throw new PerkOSError("X402_PAYMENT_FAILED", "Stacks transaction API returned invalid JSON.", { cause, txid });
+        }
+        let eventsResponse;
+        try {
+            eventsResponse = await this.fetch(`${this.apiUrl}/extended/v3/transactions/${encodeURIComponent(txid)}/events?limit=50`, { headers: { accept: "application/json" } });
+        }
+        catch (cause) {
+            throw new PerkOSError("X402_PAYMENT_FAILED", "Could not reach the Stacks transaction events API.", { cause, txid });
+        }
+        if (!eventsResponse.ok) {
+            const body = await eventsResponse.text().catch(() => "");
+            throw new PerkOSError("X402_PAYMENT_FAILED", `Stacks transaction events API returned HTTP ${eventsResponse.status}.`, { txid, status: eventsResponse.status, body: body.slice(0, 500) });
+        }
+        let events;
+        try {
+            events = await eventsResponse.json();
+        }
+        catch (cause) {
+            throw new PerkOSError("X402_PAYMENT_FAILED", "Stacks transaction events API returned invalid JSON.", { cause, txid });
+        }
+        return { transaction, events };
+    }
+    async getChainTip() {
+        let response;
+        try {
+            response = await this.fetch(`${this.apiUrl}/v2/info`, {
+                headers: { accept: "application/json" },
+            });
+        }
+        catch (cause) {
+            throw new PerkOSError("X402_PAYMENT_FAILED", "Could not read the Stacks chain tip.", { cause });
+        }
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new PerkOSError("X402_PAYMENT_FAILED", `Stacks chain info API returned HTTP ${response.status}.`, { status: response.status, body: body.slice(0, 500) });
+        }
+        let raw;
+        try {
+            raw = await response.json();
+        }
+        catch (cause) {
+            throw new PerkOSError("X402_PAYMENT_FAILED", "Stacks chain info API returned invalid JSON.", { cause });
+        }
+        const record = asRecord(raw, "chain info response");
+        return requiredInteger(record, "stacks_tip_height");
+    }
+}
+export class InMemoryX402ReplayStore {
+    records = new Map();
+    async has(key) {
+        return this.records.has(key);
+    }
+    async consume(key, record) {
+        if (this.records.has(key))
+            return false;
+        this.records.set(key, record);
+        return true;
+    }
+    get(key) {
+        return this.records.get(key);
+    }
+}
+export class PerkOSX402Facilitator {
+    scheme = PERKOS_X402_SCHEME;
+    caipFamily = "stacks:*";
+    config;
+    replayStore;
+    transactionSource;
+    minConfirmations;
+    clockSkewSeconds;
+    now;
+    constructor(options) {
+        this.config = options.config;
+        this.replayStore = options.replayStore;
+        this.transactionSource =
+            options.transactionSource ??
+                new HiroX402TransactionSource({
+                    network: options.config.network,
+                    ...(options.config.apiUrl ? { apiUrl: options.config.apiUrl } : {}),
+                });
+        this.minConfirmations = positiveInteger(options.minConfirmations, DEFAULT_MIN_CONFIRMATIONS, "minConfirmations");
+        this.clockSkewSeconds = nonNegativeInteger(options.clockSkewSeconds, DEFAULT_CLOCK_SKEW_SECONDS, "clockSkewSeconds");
+        this.now = options.now ?? Date.now;
+    }
+    getExtra(network) {
+        try {
+            if (fromStacksX402Network(network) !== this.config.network)
+                return undefined;
+        }
+        catch {
+            return undefined;
+        }
+        return {
+            assetTransferMethod: PERKOS_X402_ASSET_TRANSFER_METHOD,
+            paymentFlow: PERKOS_X402_PAYMENT_FLOW,
+        };
+    }
+    getSigners(_network) {
+        return [];
+    }
+    async verify(payload, requirements) {
+        try {
+            const verified = await this.inspect(payload, requirements);
+            return {
+                isValid: true,
+                payer: verified.payer,
+                extra: {
+                    transaction: verified.transaction,
+                    blockHeight: verified.blockHeight,
+                    confirmations: verified.confirmations,
+                },
+            };
+        }
+        catch (cause) {
+            const failure = this.asVerificationError(cause);
+            const payer = payloadPayer(payload);
+            return {
+                isValid: false,
+                invalidReason: failure.reason,
+                invalidMessage: failure.message,
+                ...(payer ? { payer } : {}),
+            };
+        }
+    }
+    async settle(payload, requirements) {
+        const network = toStacksX402Network(this.config.network);
+        const claimedTransaction = normalizePayloadTxid(payload);
+        const claimedPayer = payloadPayer(payload);
+        try {
+            const verified = await this.inspect(payload, requirements);
+            const record = {
+                key: verified.replayKey,
+                network: verified.network,
+                transaction: verified.transaction,
+                payer: verified.payer,
+                asset: verified.asset,
+                jobId: verified.jobId.toString(),
+                amount: verified.amount.toString(),
+                ...(payload.resource?.url ? { resource: payload.resource.url } : {}),
+                consumedAt: new Date(this.now()).toISOString(),
+            };
+            let consumed;
+            try {
+                consumed = await this.replayStore.consume(verified.replayKey, record);
+            }
+            catch (cause) {
+                throw verificationError("replay_store_unavailable", "The replay store could not consume the payment proof.", { cause });
+            }
+            if (!consumed) {
+                throw verificationError("payment_already_used", "The Stacks funding transaction was already consumed.");
+            }
+            return {
+                success: true,
+                payer: verified.payer,
+                transaction: verified.transaction,
+                network,
+                amount: verified.amount.toString(),
+                extra: {
+                    asset: verified.asset,
+                    jobId: verified.jobId.toString(),
+                    blockHeight: verified.blockHeight,
+                    confirmations: verified.confirmations,
+                },
+            };
+        }
+        catch (cause) {
+            const failure = this.asVerificationError(cause);
+            return {
+                success: false,
+                errorReason: failure.reason,
+                errorMessage: failure.message,
+                ...(claimedPayer ? { payer: claimedPayer } : {}),
+                transaction: claimedTransaction,
+                network,
+            };
+        }
+    }
+    async inspect(payload, requirements) {
+        if (!deepEqual(payload.accepted, requirements)) {
+            throw verificationError("payment_requirements_mismatch", "The payload accepted requirements do not match the server requirements.");
+        }
+        try {
+            parsePerkOSX402Requirement(this.config, requirements);
+        }
+        catch (cause) {
+            throw requirementFailure(cause);
+        }
+        let proof;
+        try {
+            proof = parsePerkOSX402PaymentPayload(this.config, payload);
+        }
+        catch (cause) {
+            throw payloadFailure(cause);
+        }
+        let raw;
+        try {
+            raw = await this.transactionSource.getTransaction(proof.transaction);
+        }
+        catch (cause) {
+            throw verificationError("verification_unavailable", "The Stacks transaction could not be loaded.", { cause });
+        }
+        if (raw === null) {
+            throw verificationError("transaction_not_found", "The Stacks funding transaction was not found.");
+        }
+        const evidence = asRecord(raw, "transaction evidence");
+        const transaction = asRecord(evidence.transaction, "transaction");
+        const apiTxid = normalizeTxid(requiredString(transaction, "tx_id"));
+        if (apiTxid !== proof.transaction) {
+            throw verificationError("transaction_mismatch", "The Stacks API returned a different transaction ID.");
+        }
+        if (requiredString(transaction, "status") !== "success") {
+            throw verificationError("invalid_transaction_state", "The Stacks funding transaction did not execute successfully.");
+        }
+        if (requiredString(transaction, "type") !== "contract_call") {
+            throw verificationError("invalid_transaction_type", "The payment proof is not a Stacks contract call.");
+        }
+        const sender = asRecord(transaction.sender, "transaction sender");
+        if (requiredString(sender, "address") !== proof.payer) {
+            throw verificationError("payer_mismatch", "The Stacks transaction sender does not match the payment payer.");
+        }
+        const call = asRecord(transaction.contract_call, "contract call");
+        if (requiredString(call, "contract_id") !== proof.commerceContract) {
+            throw verificationError("contract_mismatch", "The funding call contract does not match the payment requirement.");
+        }
+        if (requiredString(call, "function_name") !== "fund-job") {
+            throw verificationError("function_mismatch", "The Stacks transaction did not call fund-job.");
+        }
+        const eventsPage = asRecord(evidence.events, "transaction events page");
+        if (!Array.isArray(eventsPage.results)) {
+            throw verificationError("verification_unavailable", "The Stacks API response has no transaction events.");
+        }
+        const eventTotal = requiredInteger(eventsPage, "total");
+        if (eventTotal !== eventsPage.results.length) {
+            throw verificationError("verification_unavailable", "The Stacks transaction event page is incomplete.");
+        }
+        if (!eventsPage.results.some((event) => fundingLogMatches(event, proof, this.config.contracts.sbtcToken))) {
+            throw verificationError("funding_event_mismatch", "No exact job-funded contract event matches the payment requirement.");
+        }
+        if (!eventsPage.results.some((event) => transferMatches(event, proof))) {
+            throw verificationError("transfer_mismatch", "No exact escrow transfer event matches the payment requirement.");
+        }
+        const block = asRecord(transaction.block, "transaction block");
+        const blockHeight = requiredInteger(block, "height");
+        const blockHash = requiredString(block, "hash");
+        const blockTime = requiredInteger(block, "time");
+        if ((proof.blockHeight !== undefined && proof.blockHeight !== blockHeight) ||
+            (proof.blockHash !== undefined && proof.blockHash !== blockHash)) {
+            throw verificationError("proof_block_mismatch", "The client proof block metadata does not match the Stacks API.");
+        }
+        let chainTip;
+        try {
+            chainTip = await this.transactionSource.getChainTip();
+        }
+        catch (cause) {
+            throw verificationError("verification_unavailable", "The Stacks chain tip could not be loaded.", { cause });
+        }
+        if (!Number.isSafeInteger(chainTip) || chainTip < blockHeight) {
+            throw verificationError("verification_unavailable", "The Stacks chain tip is inconsistent with the transaction block.");
+        }
+        const confirmations = chainTip - blockHeight + 1;
+        if (confirmations < this.minConfirmations) {
+            throw verificationError("insufficient_confirmations", "The Stacks funding transaction has insufficient confirmations.", { confirmations, required: this.minConfirmations });
+        }
+        const nowSeconds = Math.floor(this.now() / 1_000);
+        if (!Number.isSafeInteger(nowSeconds) || nowSeconds < 0) {
+            throw verificationError("verification_unavailable", "The verifier clock returned an invalid time.");
+        }
+        if (blockTime > nowSeconds + this.clockSkewSeconds) {
+            throw verificationError("transaction_time_in_future", "The Stacks funding transaction time is in the future.");
+        }
+        if (nowSeconds - blockTime >
+            proof.maxTimeoutSeconds + this.clockSkewSeconds) {
+            throw verificationError("payment_expired", "The Stacks funding transaction is older than the x402 payment window.");
+        }
+        const replayKey = perkosX402ReplayKey(proof.network, proof.transaction);
+        let alreadyUsed;
+        try {
+            alreadyUsed = await this.replayStore.has(replayKey);
+        }
+        catch (cause) {
+            throw verificationError("replay_store_unavailable", "The replay store could not check the payment proof.", { cause });
+        }
+        if (alreadyUsed) {
+            throw verificationError("payment_already_used", "The Stacks funding transaction was already consumed.");
+        }
+        return {
+            network: proof.network,
+            transaction: proof.transaction,
+            payer: proof.payer,
+            asset: proof.asset,
+            jobId: proof.jobId,
+            amount: proof.amount,
+            commerceContract: proof.commerceContract,
+            blockHeight,
+            blockHash,
+            blockTime,
+            confirmations,
+            replayKey,
+        };
+    }
+    asVerificationError(cause) {
+        if (cause instanceof PerkOSX402VerificationError)
+            return cause;
+        return verificationError("unexpected_verify_error", "The Stacks payment proof could not be verified.", { cause });
+    }
+}
+//# sourceMappingURL=x402-facilitator.js.map

package/dist/x402-facilitator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-facilitator.js","sourceRoot":"","sources":["../src/x402-facilitator.ts"],"names":[],"mappings":"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"}