@intent-engine/client 0.1.23 → 0.1.26

package/dist/src/intent-notifications.js.map

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

package/dist/src/job-deliveries.d.ts

@@ -0,0 +1,40 @@
+import type { Address, Instruction, Signature, TransactionSigner } from "@solana/kit";
+import type { Transport } from "./transport.js";
+export type DeliverInput = {
+    worker: TransactionSigner;
+    intent: Address;
+    sha256: string;
+    url: string;
+};
+export type Delivery = {
+    intent: Address;
+    worker: Address;
+    sha256: string;
+    url: string;
+    signature: Signature;
+    slot: bigint;
+    blockTime: bigint | null;
+};
+export type DeliveryRecord = {
+    deliveries: Delivery[];
+    complete: boolean;
+    pages: number;
+};
+export type Announcement = {
+    sha256: string;
+    first: Delivery;
+    copies: number;
+};
+export declare class NotDeliverable extends Error {
+    readonly intent: Address;
+    constructor(intent: Address, reason: string);
+}
+export declare function deliveryInstructions(transport: Transport, input: DeliverInput): Promise<{
+    attestor: Address;
+    instructions: Instruction[];
+}>;
+export declare function deliveryRecord(transport: Transport, judge: Address, intent?: Address, pages?: number): Promise<DeliveryRecord>;
+export declare function judgedDeliveries(transport: Transport, judge: Address, judged: ReadonlySet<Address>, floor: bigint | null, covered: () => Promise<boolean>, pages: number): Promise<DeliveryRecord>;
+export declare function deliveriesOf(transport: Transport, judge: Address, intent?: Address): Promise<Delivery[]>;
+export declare function firstDelivery(deliveries: readonly Delivery[], sha256: string): Delivery | null;
+export declare function announcements(deliveries: readonly Delivery[]): Announcement[];

package/dist/src/job-deliveries.js

@@ -0,0 +1,92 @@
+import { getTransferSolInstruction } from "@solana-program/system";
+import { deliveryMemo, IntentStatus, DELIVERY_MEMO_PREFIX, parseDeliveryMemo } from "@intent-engine/core";
+import { chainTime } from "./accounts.js";
+import { memoInstruction } from "./job-memos.js";
+import { historyCovers, openProofEscrows, proofAt } from "./job-proofs.js";
+import { DELIVERY_PAGES, MEMOS_PER_TRANSACTION, scan } from "./job-scan.js";
+import { PLAIN_HTTP_ON_PUBLIC, plainHttpOnPublic } from "./job-specs.js";
+export class NotDeliverable extends Error {
+    intent;
+    constructor(intent, reason) {
+        super(`intent ${intent} ${reason}`);
+        this.name = "NotDeliverable";
+        this.intent = intent;
+    }
+}
+export async function deliveryInstructions(transport, input) {
+    const { worker, intent } = input;
+    const memo = deliveryMemo({ intent, sha256: input.sha256.toLowerCase(), url: input.url });
+    if (await plainHttpOnPublic(transport, input.url)) {
+        throw new RangeError(`the work url ${input.url} ${PLAIN_HTTP_ON_PUBLIC}`);
+    }
+    const [proof, now] = await Promise.all([proofAt(transport, intent), chainTime(transport)]);
+    if (proof === null) {
+        throw new NotDeliverable(intent, "is not a proof escrow: an AttestedResult intent that commits a spec hash");
+    }
+    if (proof.intent.status !== IntentStatus.Open || proof.intent.expiresAt <= now) {
+        throw new NotDeliverable(intent, "is no longer open");
+    }
+    const attestor = proof.params.attestor;
+    return {
+        attestor,
+        instructions: [memoInstruction(worker, memo), getTransferSolInstruction({ source: worker, destination: attestor, amount: 0n })],
+    };
+}
+export async function deliveryRecord(transport, judge, intent, pages = DELIVERY_PAGES) {
+    let proofs;
+    if (intent === undefined) {
+        proofs = await openProofEscrows(transport, judge, Number.POSITIVE_INFINITY);
+    }
+    else {
+        const proof = await proofAt(transport, intent);
+        proofs = proof !== null && proof.params.attestor === judge ? [proof] : [];
+    }
+    const [first] = proofs;
+    if (first === undefined) {
+        return { deliveries: [], complete: true, pages: 0 };
+    }
+    const judged = new Set(proofs.map(({ address }) => address));
+    const oldest = proofs.reduce((low, proof) => (proof.intent.createdAt < low.intent.createdAt ? proof : low), first);
+    const floor = oldest.intent.createdAt;
+    return judgedDeliveries(transport, judge, judged, floor, () => historyCovers(transport, oldest.address, floor), pages);
+}
+export async function judgedDeliveries(transport, judge, judged, floor, covered, pages) {
+    const scanned = await scan(transport, judge, { floor, memo: DELIVERY_MEMO_PREFIX, pages, covered });
+    const { transactions, complete } = scanned;
+    const deliveries = transactions.flatMap(({ signature, slot, blockTime, failed, memos, feePayer }) => failed || feePayer === undefined
+        ? []
+        : (memos ?? [])
+            .slice(0, MEMOS_PER_TRANSACTION)
+            .map(parseDeliveryMemo)
+            .flatMap((memo) => memo === null || !judged.has(memo.intent)
+            ? []
+            : [{ ...memo, worker: feePayer, signature: signature, slot, blockTime }]));
+    return { deliveries, complete: complete && !transactions.some(({ unread }) => unread === true), pages: scanned.pages };
+}
+export async function deliveriesOf(transport, judge, intent) {
+    return (await deliveryRecord(transport, judge, intent)).deliveries;
+}
+const earlier = (a, b) => a.slot < b.slot || (a.slot === b.slot && a.signature < b.signature);
+export function firstDelivery(deliveries, sha256) {
+    let first = null;
+    for (const delivery of deliveries) {
+        if (delivery.sha256 === sha256 && (first === null || earlier(delivery, first))) {
+            first = delivery;
+        }
+    }
+    return first;
+}
+export function announcements(deliveries) {
+    const hashes = [...new Set(deliveries.map(({ sha256 }) => sha256))];
+    return hashes
+        .flatMap((sha256) => {
+        const first = firstDelivery(deliveries, sha256);
+        if (first === null) {
+            return [];
+        }
+        const others = new Set(deliveries.filter((d) => d.sha256 === sha256 && d.worker !== first.worker).map(({ worker }) => worker));
+        return [{ sha256, first, copies: others.size }];
+    })
+        .sort((a, b) => (earlier(a.first, b.first) ? -1 : earlier(b.first, a.first) ? 1 : 0));
+}
+//# sourceMappingURL=job-deliveries.js.map

package/dist/src/job-deliveries.js.map

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

package/dist/src/job-memos.d.ts

@@ -0,0 +1,16 @@
+import { type Address, type Instruction, type TransactionSigner } from "@solana/kit";
+import { type EngineTransaction } from "./transport.js";
+export declare const RELEASE_MARK = " release:";
+export type FollowUp = {
+    sha256: string;
+    release: string;
+};
+export declare function followUpMemo(sha256: string, release: string): string;
+export declare function parseFollowUpMemo(text: string): FollowUp | null;
+export declare function memosSignedBy(transaction: EngineTransaction, signer: Address): string[];
+export declare function followUpOf(transactions: readonly EngineTransaction[], release: string, attestor: Address): (FollowUp & {
+    signature: string;
+}) | null;
+export declare function recordedDelivery(transactions: readonly EngineTransaction[], release: EngineTransaction, attestor: Address): string | null;
+export declare function followUpInstructions(judge: TransactionSigner, intent: Address, sha256: string, release: string): Instruction[];
+export declare function memoInstruction(signer: TransactionSigner, text: string): Instruction;

package/dist/src/job-memos.js

@@ -0,0 +1,51 @@
+import { AccountRole } from "@solana/kit";
+import { getTransferSolInstruction } from "@solana-program/system";
+import { parseReleaseMemo, releaseMemo } from "@intent-engine/core";
+import { MEMO_PROGRAM_ADDRESS } from "./transport.js";
+export const RELEASE_MARK = " release:";
+const BASE58_SIGNATURE = /^[1-9A-HJ-NP-Za-km-z]{32,88}$/;
+export function followUpMemo(sha256, release) {
+    if (!BASE58_SIGNATURE.test(release)) {
+        throw new RangeError("a follow-up names its release by a base58 signature");
+    }
+    return `${releaseMemo(sha256)}${RELEASE_MARK}${release}`;
+}
+export function parseFollowUpMemo(text) {
+    const at = text.indexOf(RELEASE_MARK);
+    if (at < 0) {
+        return null;
+    }
+    const sha256 = parseReleaseMemo(text.slice(0, at));
+    const release = text.slice(at + RELEASE_MARK.length);
+    return sha256 === null || !BASE58_SIGNATURE.test(release) ? null : { sha256, release };
+}
+export function memosSignedBy(transaction, signer) {
+    return (transaction.memos ?? []).filter((_, i) => transaction.memoSigners?.[i]?.includes(signer) === true);
+}
+export function followUpOf(transactions, release, attestor) {
+    for (const transaction of transactions) {
+        if (transaction.failed || transaction.feePayer !== attestor) {
+            continue;
+        }
+        const found = (transaction.memos ?? []).map(parseFollowUpMemo).find((memo) => memo !== null && memo.release === release);
+        if (found !== undefined && found !== null) {
+            return { ...found, signature: transaction.signature };
+        }
+    }
+    return null;
+}
+export function recordedDelivery(transactions, release, attestor) {
+    const inline = memosSignedBy(release, attestor).map(parseReleaseMemo).find((hash) => hash !== null);
+    if (inline !== undefined) {
+        return inline;
+    }
+    return followUpOf(transactions, release.signature, attestor)?.sha256 ?? null;
+}
+export function followUpInstructions(judge, intent, sha256, release) {
+    return [memoInstruction(judge, followUpMemo(sha256, release)), getTransferSolInstruction({ source: judge, destination: intent, amount: 0n })];
+}
+export function memoInstruction(signer, text) {
+    const meta = { address: signer.address, role: AccountRole.READONLY_SIGNER, signer };
+    return { programAddress: MEMO_PROGRAM_ADDRESS, accounts: [meta], data: new TextEncoder().encode(text) };
+}
+//# sourceMappingURL=job-memos.js.map

package/dist/src/job-memos.js.map

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

package/dist/src/job-origins.d.ts

@@ -0,0 +1,30 @@
+import type { Address } from "@solana/kit";
+import { type DeliveryRecord } from "./job-deliveries.js";
+import type { EngineTransaction, Transport } from "./transport.js";
+export type EscrowProof = {
+    attestor: Address;
+    specHash: string;
+};
+export type EscrowOrigin = {
+    intent: Address;
+    signature: string;
+    slot: bigint;
+    createdAt: bigint | null;
+    proof: EscrowProof | null;
+};
+export type EngineCall = {
+    data: Uint8Array;
+    accounts: Address[] | undefined;
+    inner: boolean;
+};
+export declare function engineCalls(transaction: EngineTransaction): EngineCall[];
+export declare function creationProof(transaction: EngineTransaction, intent: Address): EscrowProof | null;
+export declare function escrowOrigin(transport: Transport, intent: Address, pages?: number): Promise<EscrowOrigin | null>;
+export declare function originDeliveries(transport: Transport, judge: Address, origin: EscrowOrigin, pages?: number): Promise<DeliveryRecord>;
+export type Lifecycle = {
+    intent: Address;
+    createdAt: bigint | null;
+    from: bigint | null;
+    to: bigint;
+};
+export declare function lifecycleDeliveries(transport: Transport, judge: Address, lifecycle: Lifecycle, pages?: number): Promise<DeliveryRecord>;

package/dist/src/job-origins.js

@@ -0,0 +1,53 @@
+import { decodeParams, getCreateIntentArgsDecoder, getCreateIntentByAgentDiscriminatorBytes, getCreateIntentDiscriminatorBytes, getCreateIntentSignedDiscriminatorBytes, Kind, } from "@intent-engine/core";
+import { judgedDeliveries } from "./job-deliveries.js";
+import { createdAtOf, createdIn, hex } from "./job-proofs.js";
+import { DELIVERY_PAGES, scan } from "./job-scan.js";
+const CREATE_DISCRIMINATORS = [
+    getCreateIntentDiscriminatorBytes(),
+    getCreateIntentByAgentDiscriminatorBytes(),
+    getCreateIntentSignedDiscriminatorBytes(),
+];
+const DISCRIMINATOR_BYTES = 8;
+export function engineCalls(transaction) {
+    return [
+        ...(transaction.called ?? []).map((data, i) => ({ data, accounts: transaction.calledAccounts?.[i], inner: false })),
+        ...transaction.emitted.map((data, i) => ({ data, accounts: transaction.emittedAccounts?.[i], inner: true })),
+    ];
+}
+const startsWith = (data, head) => data.length >= head.length && head.every((b, i) => data[i] === b);
+export function creationProof(transaction, intent) {
+    for (const { data, accounts } of engineCalls(transaction)) {
+        if (!CREATE_DISCRIMINATORS.some((head) => startsWith(data, head)) || accounts === undefined || !accounts.includes(intent)) {
+            continue;
+        }
+        try {
+            const args = getCreateIntentArgsDecoder().decode(data, DISCRIMINATOR_BYTES);
+            const params = decodeParams(args.kind, Uint8Array.from(args.params));
+            return params.kind === Kind.AttestedResult ? { attestor: params.attestor, specHash: hex(params.specHash) } : null;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+export async function escrowOrigin(transport, intent, pages = DELIVERY_PAGES) {
+    const floor = await createdAtOf(transport, intent);
+    const created = (transaction) => !transaction.failed && createdIn(transaction.emitted, intent);
+    const { transactions } = await scan(transport, intent, { floor, pages, until: created });
+    const tx = transactions.find(created);
+    return tx === undefined ? null : { intent, signature: tx.signature, slot: tx.slot, createdAt: floor ?? tx.blockTime, proof: creationProof(tx, intent) };
+}
+export async function originDeliveries(transport, judge, origin, pages = DELIVERY_PAGES) {
+    const { firstAvailableSlot } = transport;
+    const covered = async () => firstAvailableSlot !== undefined && (await firstAvailableSlot.call(transport)) <= origin.slot;
+    return judgedDeliveries(transport, judge, new Set([origin.intent]), origin.createdAt, covered, pages);
+}
+export async function lifecycleDeliveries(transport, judge, lifecycle, pages = DELIVERY_PAGES) {
+    const { firstAvailableSlot } = transport;
+    const { from, to } = lifecycle;
+    const covered = async () => from !== null && firstAvailableSlot !== undefined && (await firstAvailableSlot.call(transport)) <= from;
+    const record = await judgedDeliveries(transport, judge, new Set([lifecycle.intent]), lifecycle.createdAt, covered, pages);
+    return { ...record, deliveries: record.deliveries.filter(({ slot }) => (from === null || slot >= from) && slot <= to) };
+}
+//# sourceMappingURL=job-origins.js.map

package/dist/src/job-origins.js.map

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

package/dist/src/job-proofs.d.ts

@@ -0,0 +1,17 @@
+import type { Address } from "@solana/kit";
+import { type AttestedResultParams, type Intent } from "@intent-engine/core";
+import type { Transport } from "./transport.js";
+export declare const JOBS_LIMIT = 50;
+export type Proof = {
+    address: Address;
+    intent: Intent;
+    params: AttestedResultParams;
+};
+export declare const hex: (bytes: Uint8Array) => string;
+export declare function intentAt(transport: Transport, address: Address): Promise<Intent | null>;
+export declare function proofAt(transport: Transport, address: Address): Promise<Proof | null>;
+export declare function createdAtOf(transport: Transport, address: Address): Promise<bigint | null>;
+export declare function openProofEscrows(transport: Transport, attestor?: Address, limit?: number): Promise<Proof[]>;
+export declare const createdIn: (emitted: readonly Uint8Array[], intent: Address) => boolean;
+export declare function creationSlotOf(transport: Transport, intent: Address, createdAt?: bigint): Promise<bigint | null>;
+export declare function historyCovers(transport: Transport, intent: Address, createdAt?: bigint): Promise<boolean>;

package/dist/src/job-proofs.js

@@ -0,0 +1,54 @@
+import { decodeEvent, decodeParams, getIntentDecoder, getIntentDiscriminatorBytes, getIntentSize, INTENT_ENGINE_PROGRAM_ADDRESS, IntentStatus, Kind, } from "@intent-engine/core";
+import { chainTime, createdAccount } from "./accounts.js";
+import { scan } from "./job-scan.js";
+export const JOBS_LIMIT = 50;
+export const hex = (bytes) => Buffer.from(bytes).toString("hex");
+function proofOf(address, intent) {
+    const params = decodeParams(intent.kind, Uint8Array.from(intent.params));
+    return params.kind === Kind.AttestedResult && params.specHash.some((b) => b !== 0) ? { address, intent, params } : null;
+}
+export async function intentAt(transport, address) {
+    const view = await createdAccount(transport, address);
+    const tag = getIntentDiscriminatorBytes();
+    if (view === null || view.owner !== INTENT_ENGINE_PROGRAM_ADDRESS || view.data.length !== getIntentSize() || !tag.every((b, i) => view.data[i] === b)) {
+        return null;
+    }
+    return getIntentDecoder().decode(view.data);
+}
+export async function proofAt(transport, address) {
+    const intent = await intentAt(transport, address);
+    return intent === null ? null : proofOf(address, intent);
+}
+export async function createdAtOf(transport, address) {
+    return (await intentAt(transport, address))?.createdAt ?? null;
+}
+export async function openProofEscrows(transport, attestor, limit = JOBS_LIMIT) {
+    const [accounts, now] = await Promise.all([transport.intents(), chainTime(transport)]);
+    return accounts
+        .map(({ address, data }) => proofOf(address, getIntentDecoder().decode(data)))
+        .filter((proof) => proof !== null &&
+        proof.intent.status === IntentStatus.Open &&
+        proof.intent.expiresAt > now &&
+        (attestor === undefined || proof.params.attestor === attestor))
+        .sort((a, b) => (a.intent.expiresAt === b.intent.expiresAt ? 0 : a.intent.expiresAt > b.intent.expiresAt ? -1 : 1))
+        .slice(0, limit);
+}
+export const createdIn = (emitted, intent) => emitted.some((data) => {
+    const event = decodeEvent(data);
+    return event?.name === "IntentCreated" && "intent" in event.fields && event.fields.intent === intent;
+});
+export async function creationSlotOf(transport, intent, createdAt) {
+    const floor = createdAt ?? (await createdAtOf(transport, intent));
+    const created = (transaction) => !transaction.failed && createdIn(transaction.emitted, intent);
+    const { transactions } = await scan(transport, intent, { floor, until: created });
+    return transactions.find(created)?.slot ?? null;
+}
+export async function historyCovers(transport, intent, createdAt) {
+    const { firstAvailableSlot } = transport;
+    if (firstAvailableSlot === undefined) {
+        return false;
+    }
+    const slot = await creationSlotOf(transport, intent, createdAt);
+    return slot !== null && (await firstAvailableSlot.call(transport)) <= slot;
+}
+//# sourceMappingURL=job-proofs.js.map

package/dist/src/job-proofs.js.map

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

package/dist/src/job-scan.d.ts

@@ -0,0 +1,20 @@
+import type { Address } from "@solana/kit";
+import { type EngineTransaction, type Transport } from "./transport.js";
+export declare const DELIVERY_SCAN = 100;
+export declare const DELIVERY_PAGES = 100;
+export declare const SIGNATURE_PAGE = 1000;
+export declare const MEMOS_PER_TRANSACTION = 8;
+export type Scan = {
+    transactions: EngineTransaction[];
+    complete: boolean;
+    pages: number;
+};
+export type ScanOptions = {
+    floor?: bigint | null;
+    memo?: string;
+    pages?: number;
+    until?: (transaction: EngineTransaction) => boolean;
+    covered?: () => Promise<boolean>;
+};
+export declare function scan(transport: Transport, of: Address, options?: ScanOptions): Promise<Scan>;
+export declare function transactionAt(transport: Transport, signature: string, of?: Address): Promise<EngineTransaction | null>;

package/dist/src/job-scan.js

@@ -0,0 +1,70 @@
+import { TRANSACTION_FETCHES } from "./transport.js";
+export const DELIVERY_SCAN = 100;
+export const DELIVERY_PAGES = 100;
+export const SIGNATURE_PAGE = 1000;
+export const MEMOS_PER_TRANSACTION = 8;
+const memoMatches = (memo, texts) => memo === undefined || texts.some((text) => text.includes(memo));
+const reaches = (floor) => ({ blockTime }) => floor === null || blockTime === null || blockTime >= floor;
+async function fallbackScan(transport, of, options) {
+    const { floor = null, memo, until, covered } = options;
+    const found = await transport.engineTransactions(DELIVERY_SCAN, of);
+    const within = found.filter(reaches(floor));
+    const transactions = [];
+    for (const transaction of within) {
+        if (transaction.failed || !memoMatches(memo, transaction.memos ?? [])) {
+            continue;
+        }
+        transactions.push(transaction);
+        if (until?.(transaction) === true) {
+            return { transactions, complete: true, pages: 1 };
+        }
+    }
+    if (within.length < found.length) {
+        return { transactions, complete: true, pages: 1 };
+    }
+    return { transactions, complete: found.length < DELIVERY_SCAN && (await covered?.()) === true, pages: 1 };
+}
+export async function scan(transport, of, options = {}) {
+    const { floor = null, memo, pages = DELIVERY_PAGES, until, covered } = options;
+    const { signaturesOf, transactionsOf } = transport;
+    if (signaturesOf === undefined || transactionsOf === undefined) {
+        return fallbackScan(transport, of, options);
+    }
+    const transactions = [];
+    let before;
+    let next;
+    for (let page = 1; page <= pages; page++) {
+        const listed = next ?? (await signaturesOf.call(transport, of, SIGNATURE_PAGE, before));
+        next = undefined;
+        const within = listed.filter(reaches(floor));
+        const wanted = within.filter((entry) => !entry.failed && memoMatches(memo, entry.memo === null ? [] : [entry.memo]));
+        for (let at = 0; at < wanted.length; at += TRANSACTION_FETCHES) {
+            for (const transaction of await transactionsOf.call(transport, wanted.slice(at, at + TRANSACTION_FETCHES))) {
+                transactions.push(transaction);
+                if (until?.(transaction) === true) {
+                    return { transactions, complete: true, pages: page };
+                }
+            }
+        }
+        if (within.length < listed.length) {
+            return { transactions, complete: true, pages: page };
+        }
+        before = listed[listed.length - 1]?.signature;
+        if (listed.length < SIGNATURE_PAGE) {
+            const more = before === undefined ? [] : await signaturesOf.call(transport, of, SIGNATURE_PAGE, before);
+            if (more.length === 0) {
+                return { transactions, complete: (await covered?.()) === true, pages: page };
+            }
+            next = more;
+        }
+    }
+    return { transactions, complete: false, pages };
+}
+export async function transactionAt(transport, signature, of) {
+    const { transactionOf } = transport;
+    if (transactionOf !== undefined) {
+        return transactionOf.call(transport, signature);
+    }
+    return (await transport.engineTransactions(DELIVERY_SCAN, of)).find((transaction) => transaction.signature === signature) ?? null;
+}
+//# sourceMappingURL=job-scan.js.map

package/dist/src/job-scan.js.map

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

package/dist/src/job-specs.d.ts

@@ -0,0 +1,40 @@
+import type { Address } from "@solana/kit";
+import { type Transport } from "./transport.js";
+export declare const SPEC_SCAN = 10;
+export declare const MAINNET_GENESIS_HASH = "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+export declare const DEVNET_GENESIS_HASH = "EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG";
+export declare const TESTNET_GENESIS_HASH = "4uhcVJyU9pJkvQyS88uRDiswHXSCkY3zQawwpjk2NsfY";
+export declare const PUBLIC_GENESIS_HASHES: ReadonlySet<string>;
+export declare const MAX_SPEC_BYTES = 1048576;
+export declare const SPEC_TIMEOUT_MS = 10000;
+export declare const PLAIN_HTTP_ON_PUBLIC = "is a plain http url, which a public cluster may not use";
+export declare function plainHttpOnPublic(transport: Transport, url: string): Promise<boolean>;
+export type Job = {
+    intent: Address;
+    owner: Address;
+    nonce: bigint;
+    attestor: Address;
+    specHash: string;
+    specUrl: string | null;
+    sells: bigint;
+    judgeFee: bigint;
+    inputMint: Address;
+    expiresAt: bigint;
+};
+export type Spec = {
+    url: string;
+    text: string;
+    sha256: string;
+    matches: boolean;
+};
+export type SpecFetch = (url: string, init: {
+    redirect: "error";
+    signal: AbortSignal;
+}) => Promise<Response>;
+export declare class SpecUnreadable extends Error {
+    readonly url: string;
+    constructor(url: string, reason: string);
+}
+export declare function specUrlOf(transport: Transport, intent: Address, createdAt?: bigint): Promise<string | null>;
+export declare function jobsOf(transport: Transport, attestor?: Address): Promise<Job[]>;
+export declare function readSpec(transport: Transport, get: SpecFetch, intent: Address): Promise<Spec | null>;