@violetclaire/popcorn-mcp 0.1.3 → 0.1.5

package/dist/verify/typescript/src/v2.d.ts

@@ -0,0 +1,192 @@
+export type PopcornJsonWebKey = JsonWebKey & {
+    kid?: string;
+};
+export type JsonWebKeySet = {
+    keys: PopcornJsonWebKey[];
+};
+export type TemporalReceipt = {
+    anchor_id: string;
+    node_id: string;
+    protocol_id: string;
+    request_received_at_utc: string;
+    observed_at_utc: string;
+    measurement_at_utc: string;
+    unix_time_milliseconds: number;
+    valid_until_utc: string;
+    freshness_window_ms: number;
+    server_processing_duration_ms: number;
+    post_anchor_processing_duration_ms: number;
+    validity_at_measurement_ms: number;
+    payment_identifier: string;
+    payment_transaction: string | null;
+    evidence_scope: {
+        type: string;
+        caller_bound: boolean;
+        task_bound: boolean;
+        authorization_granted: boolean;
+    };
+};
+export type PopcornResponse = {
+    temporal_receipt: TemporalReceipt;
+    temporal_attestation: {
+        format?: string;
+        algorithm?: string;
+        key_id?: string;
+        compact_jws: string;
+    };
+};
+export type MonotonicObservation = {
+    paid_request_start_monotonic_ms: number;
+    paid_response_receive_monotonic_ms: number;
+    decision_monotonic_ms?: number;
+};
+export type ExecutionWindowUtc = {
+    opens_at_utc: string;
+    closes_at_utc: string;
+};
+export type VerifiedTemporalEvidence = {
+    signature_verified: true;
+    key_id: string;
+    temporal_receipt: TemporalReceipt;
+    paid_request_rtt_ms: number;
+    network_uncertainty_ms: number;
+    remaining_validity_at_receipt_ms: number;
+    remaining_validity_now_ms: number;
+    temporal_interval_now_utc: {
+        earliest: string;
+        latest: string;
+    };
+    execution_window?: {
+        eligible: boolean;
+        next_action: "continue_task" | "request_new_temporal_anchor";
+        reason: "verified_interval_within_execution_window" | "temporal_evidence_expired" | "verified_interval_not_within_execution_window";
+    };
+};
+export type Sha256Digest = {
+    algorithm: "sha-256";
+    value: string;
+};
+export type WitnessCommitment = {
+    payload_digest: Sha256Digest;
+    nonce: string;
+    previous_attestation_digest: Sha256Digest | null;
+};
+export type WitnessReceipt = {
+    receipt_id: string;
+    tain: string;
+    node_id: string;
+    protocol_id: string;
+    request_received_at_utc: string;
+    witnessed_at_utc: string;
+    statement_created_at_utc: string;
+    unix_time_milliseconds: number;
+    clock_accuracy_radius_ms: number;
+    witness_window_utc: {
+        earliest: string;
+        latest: string;
+    };
+    server_processing_duration_ms: number;
+    post_witness_processing_duration_ms: number;
+    commitment: WitnessCommitment;
+    payment_identifier: string;
+    payment_transaction: string | null;
+    evidence_scope: {
+        type: string;
+        payload_disclosed: boolean;
+        caller_identity_proven: boolean;
+        recipient_delivery_proven: boolean;
+        action_execution_proven: boolean;
+        nonce_uniqueness_enforced: boolean;
+        replay_prevented: boolean;
+        authorization_granted: boolean;
+        external_atomic_clock_alignment_proven: boolean;
+        clock_accuracy_independently_verified: boolean;
+        payer_authorization_bound_to_commitment: boolean;
+    };
+    issuing_origin: string;
+    issuance_endpoint: string;
+    tain_verification_uri: string;
+    contribution_license_uri: string;
+    license_terms_digest: Sha256Digest;
+};
+export type PopcornWitnessResponse = {
+    witness_receipt: WitnessReceipt;
+    witness_attestation: {
+        format?: string;
+        algorithm?: string;
+        key_id?: string;
+        key_set?: string;
+        compact_jws: string;
+    };
+    payment_status: "settled";
+    tain_qr_png_base64?: string;
+    tain_qr_payload?: string;
+    letterhead_uri?: string;
+};
+export type WitnessVerificationOptions = {
+    expected_node_id?: string;
+    expected_nonce: string;
+    expected_payload?: string | Uint8Array;
+    expected_payload_digest?: string;
+    previous_receipt?: {
+        response: PopcornWitnessResponse;
+        jwks: JsonWebKeySet;
+        verification: WitnessVerificationOptions;
+    };
+    max_clock_accuracy_radius_ms?: number;
+};
+export type VerifiedWitnessEvidence = {
+    signature_verified: true;
+    key_id: string;
+    witness_receipt: WitnessReceipt;
+    payload_digest_verified: true;
+    nonce_verified: true;
+    previous_attestation_digest_matched: boolean;
+    replay_key: string;
+    payment_replay_key: string;
+    witness_window_utc: {
+        earliest: string;
+        latest: string;
+    };
+};
+export type WitnessChainVerificationOptions = Omit<WitnessVerificationOptions, "previous_receipt">;
+export type WitnessChainEntry = {
+    response: PopcornWitnessResponse;
+    jwks: JsonWebKeySet;
+    verification: WitnessChainVerificationOptions;
+};
+export type VerifiedWitnessChainEntry = {
+    index: number;
+    signed_payload_digest: string;
+    verified: VerifiedWitnessEvidence;
+};
+export type VerifiedWitnessChain = {
+    chain_length: number;
+    head_signed_payload_digest: string;
+    entries: VerifiedWitnessChainEntry[];
+};
+export type PortableScheduleExecutionWindowUtc = {
+    opens_at: string;
+    closes_at: string;
+};
+export type WitnessScheduleDecision = {
+    decision: "STOP" | "TIME_CHECK_PASSED" | "RECHECK";
+    authorization_granted: false;
+    reason: "witness_window_entirely_before_execution_window" | "witness_window_entirely_after_execution_window" | "witness_window_entirely_inside_execution_window" | "witness_uncertainty_crosses_execution_boundary";
+    witness_window_utc: {
+        earliest: string;
+        latest: string;
+    };
+    execution_window_utc: PortableScheduleExecutionWindowUtc;
+};
+export declare function digestWitnessSignedPayload(compactJws: string): Promise<string>;
+export declare function evaluateWitnessAgainstSchedule(witnessWindowUtc: {
+    earliest: string;
+    latest: string;
+}, executionWindowUtc: PortableScheduleExecutionWindowUtc): WitnessScheduleDecision;
+export declare function verifyPopcornTemporalEvidence(response: PopcornResponse, jwks: JsonWebKeySet, monotonic: MonotonicObservation, options?: {
+    expected_node_id?: string;
+    execution_window_utc?: ExecutionWindowUtc;
+}): Promise<VerifiedTemporalEvidence>;
+export declare function verifyPopcornWitnessEvidence(response: PopcornWitnessResponse, jwks: JsonWebKeySet, options: WitnessVerificationOptions): Promise<VerifiedWitnessEvidence>;
+export declare function verifyPopcornWitnessChain(entries: readonly WitnessChainEntry[]): Promise<VerifiedWitnessChain>;