@intent-engine/cli 0.1.23 → 0.1.26

package/dist/src/agent/wallet/receipt.js

@@ -0,0 +1,102 @@
+import { getAddressDecoder } from "@solana/kit";
+import { findIntentPda, formatAmount } from "@intent-engine/core";
+import { intentAt, mintOf, recordedDelivery } from "@intent-engine/client";
+import { define } from "../actions.js";
+import { tool } from "../names.js";
+import { AgentRefusal } from "../problems.js";
+import { account, amount, flag, object, optional, text } from "../schema.js";
+import { signerOf, sha256Of } from "./guard.js";
+import { RELEASE_INPUT, releaseOf, otherLifecycle, coverageOf } from "./record.js";
+import { RELEASE_UNKNOWN, outlives, releaseLookup, namedRelease, releasedMint, createdMint, heldMint } from "./releases.js";
+export const NOT_RELEASED = `no release of this escrow is in its history; ${tool("wallet_wait")} or ${tool("wallet_intents")} shows whether it is still open`;
+export const RECEIPT_PARTIAL = "the escrow's history after this release could not be read in full: it is longer than the pages read or the RPC node could not return some of its transactions yet, so a follow-up recording the delivered work may be missing, and without release given, the escrow address may have been made again since; pass release, the signature the release returned, or call again in a few seconds";
+const receiptOutput = object({
+    intent: account(),
+    released: flag(),
+    complete: optional(flag("false when the history read was not enough: with released false, no release was found in it, so released is unknown rather than known; with released true, a follow-up recording the delivered work, or a later lifecycle of the escrow address, may be missing from it")),
+    paid_to: optional(account("the wallet the release paid")),
+    payee: optional(account("the token account the release paid")),
+    paid: optional(text("whole tokens the payee received")),
+    attestor: optional(account()),
+    result: optional(amount()),
+    recipients: optional(amount("how many co-authors a split release paid")),
+    signature: optional(text("the release's transaction")),
+    delivered_sha256: optional(text("the sha256 the release recorded, if any, in its own memo or in a follow-up transaction its attestor signed")),
+    matches: optional(flag("whether sha256 equals the recorded one")),
+    next: optional(text()),
+});
+export const walletReceipt = define({
+    name: tool("wallet_receipt"),
+    title: "Check an escrow's release",
+    description: `Look up whether an escrow made with ${tool("wallet_escrow")} was released: to whom, for how much, by which attestor, and which delivered work the release recorded. Give sha256, the hash of the work you received, to check it is the work that was paid for, and release, the signature the release returned, to read the release from that one transaction however long the escrow's history grew. It reads the escrow's own transactions and sends nothing.`,
+    effect: "read",
+    input: object({
+        owner: optional(account("the wallet that made the escrow; default this server's wallet")),
+        nonce: amount("the escrow intent's nonce"),
+        sha256: optional(text("the sha256, as 64 hex digits, of the work you received, to compare with the one the release recorded")),
+        release: optional(text(RELEASE_INPUT)),
+    }),
+    output: receiptOutput,
+    run: async (ctx, input) => escrowReceipt(ctx.transport, input.owner ?? (await signerOf(ctx)).address, input.nonce, input.sha256, input.release),
+});
+export const getReceipt = define({
+    name: tool("get_receipt"),
+    title: "Check an escrow's release",
+    description: `Look up whether an escrow was released: to whom, for how much, by which attestor, and which delivered work the release recorded. Give sha256, the hash of the work you received, to check it is the work that was paid for, and release, the signature the release returned, to read the release from that one transaction however long the escrow's history grew. It reads the escrow's own transactions, sends nothing and needs no wallet.`,
+    effect: "read",
+    input: object({
+        owner: account("the wallet that made the escrow"),
+        nonce: amount("the escrow intent's nonce"),
+        sha256: optional(text("the sha256, as 64 hex digits, of the work you received, to compare with the one the release recorded")),
+        release: optional(text(RELEASE_INPUT)),
+    }),
+    output: receiptOutput,
+    run: async (ctx, input) => escrowReceipt(ctx.transport, input.owner, input.nonce, input.sha256, input.release),
+});
+export async function escrowReceipt(transport, owner, nonce, sha256, releaseSignature) {
+    const wanted = sha256 === undefined ? undefined : sha256Of(sha256, "sha256");
+    const named = releaseOf(releaseSignature);
+    const [intent] = await findIntentPda({ owner, nonce });
+    const lookup = named === undefined ? await releaseLookup(transport, intent) : await namedRelease(transport, intent, named);
+    const { release, transactions, complete, bound, creation } = lookup;
+    if (release === null) {
+        return complete ? { intent, released: false, next: NOT_RELEASED } : { intent, released: false, complete: false, next: coverageOf(transport, RELEASE_UNKNOWN) };
+    }
+    const { tx } = release;
+    if (named !== undefined) {
+        const now = await intentAt(transport, intent);
+        if (lookup.later === true || (now !== null && outlives(now, tx, creation))) {
+            throw new AgentRefusal("OtherLifecycle", otherLifecycle(named, intent));
+        }
+    }
+    const fields = release.event.fields;
+    let mint = createdMint([...transactions, ...(creation === null || creation === undefined ? [] : [creation])], intent) ?? releasedMint(tx, intent, fields["payee"]);
+    const recorded = recordedDelivery(transactions, tx, fields["attestor"]) ?? undefined;
+    const common = {
+        intent,
+        released: true,
+        ...(complete && bound ? {} : { complete: false, next: RECEIPT_PARTIAL }),
+        attestor: fields["attestor"],
+        result: fields["result"],
+        signature: tx.signature,
+        ...(recorded === undefined ? {} : { delivered_sha256: recorded }),
+        ...(wanted === undefined ? {} : { matches: wanted === recorded }),
+    };
+    if (release.event.name === "IntentSplit") {
+        mint ??= await heldMint(transport, intent);
+        const decimals = mint === undefined ? undefined : (await mintOf(transport, mint)).decimals;
+        return { ...common, paid: formatAmount(fields["net"], decimals), recipients: BigInt(fields["recipients"]) };
+    }
+    const payee = fields["payee"];
+    const held = await transport.getAccount(payee);
+    mint ??= held === null || held.data.length < 64 ? await heldMint(transport, intent) : getAddressDecoder().decode(held.data.subarray(0, 32));
+    const decimals = mint === undefined ? undefined : (await mintOf(transport, mint)).decimals;
+    const paidTo = tx.tokens?.find(({ account }) => account === payee)?.owner ?? (held === null || held.data.length < 64 ? undefined : getAddressDecoder().decode(held.data.subarray(32, 64)));
+    return {
+        ...common,
+        ...(paidTo === undefined ? {} : { paid_to: paidTo }),
+        payee,
+        paid: formatAmount(fields["net"], decimals),
+    };
+}
+//# sourceMappingURL=receipt.js.map

package/dist/src/agent/wallet/receipt.js.map

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

package/dist/src/agent/wallet/record.d.ts

@@ -0,0 +1,31 @@
+import { type Address, type Instruction, type TransactionSigner } from "@solana/kit";
+import { type Transport } from "@intent-engine/client";
+export declare const RELEASE_INPUT: string;
+export declare const RELEASE_SIGNATURE = "must be a base58 transaction signature";
+export declare function releaseOf(signature: string | undefined): string | undefined;
+export declare const notReleasedYet: (intent: string) => string;
+export declare const alreadyRecorded: (sha256: string) => string;
+export declare const releasedBy: (attestor: string, signer: string) => string;
+export declare const escrowGone: (intent: string) => string;
+export declare const creationUnread: (intent: string, creation: string) => string;
+export declare const notAProofEscrow: (intent: string) => string;
+export declare const neverAnnounced: (sha256: string, intent: string) => string;
+export declare const paidOther: (worker: string, sha256: string, payee: string) => string;
+export declare const splitPaidOthers: (worker: string, sha256: string) => string;
+export declare const recipientsUnread: (release: string) => string;
+export declare const followUpsUnknown: (release: string) => string;
+export declare const historyLagging: (release: string, intent: string) => string;
+export declare const otherLifecycle: (release: string, intent: string) => string;
+export declare const COVERAGE_UNPROVABLE = "this transport cannot report the first slot its RPC node keeps, so it cannot prove that the history read reaches back to the escrow's creation and an escrow without a release found reads as unknown rather than not released";
+export type Recording = {
+    intent: Address;
+    release: string;
+    attestor: Address;
+    sha256: string;
+    memo: string;
+    instructions: Instruction[];
+    summary: string[];
+};
+export declare const coverageOf: (transport: Transport, text: string) => string;
+export declare function recordingOf(transport: Transport, judge: TransactionSigner, owner: Address, nonce: bigint, sha256: string, releaseSignature?: string): Promise<Recording>;
+export declare const walletRecordDelivery: import("../actions.js").AnyAction;

package/dist/src/agent/wallet/record.js

@@ -0,0 +1,178 @@
+import { getAddressDecoder } from "@solana/kit";
+import { decodeParams, findAssociatedTokenAddress, findIntentPda, Kind } from "@intent-engine/core";
+import { creationProof, firstDelivery, followUpInstructions, followUpMemo, intentAt, lifecycleDeliveries, mintOf, recordedDelivery, } from "@intent-engine/client";
+import { define } from "../actions.js";
+import { tool } from "../names.js";
+import { AgentRefusal } from "../problems.js";
+import { InvalidInput, account, amount, flag, list, object, optional, text } from "../schema.js";
+import { preparedView } from "../shapes.js";
+import { prepare } from "../prepare.js";
+import { signerOf, sent, sha256Of } from "./guard.js";
+import { HISTORY_TOO_LONG } from "./delivery.js";
+import { RELEASE_UNKNOWN, outlives, releaseLookup, aroundRelease, namedRelease, releasedMint, heldMint, splitRecipients } from "./releases.js";
+export const RELEASE_INPUT = `the release's transaction signature, as ${tool("wallet_attest")}, ${tool("wallet_attest_split")} or judge returned it; with it the release is read from that one transaction, with no search of the escrow's history`;
+const BASE58_SIGNATURE = /^[1-9A-HJ-NP-Za-km-z]{32,88}$/;
+export const RELEASE_SIGNATURE = "must be a base58 transaction signature";
+export function releaseOf(signature) {
+    if (signature !== undefined && !BASE58_SIGNATURE.test(signature)) {
+        throw new InvalidInput([{ path: "release", message: RELEASE_SIGNATURE }]);
+    }
+    return signature;
+}
+export const notReleasedYet = (intent) => `no release of the escrow ${intent} is in its history, so no delivery can be recorded for it`;
+export const alreadyRecorded = (sha256) => `this release already records the delivered work's sha256 ${sha256}, which a receipt reads; nothing more is recorded`;
+export const releasedBy = (attestor, signer) => `this escrow was released by its attestor ${attestor}, not by ${signer}; only the attestor that released it records what it paid for`;
+export const escrowGone = (intent) => `the escrow ${intent} is closed and the transaction that made it is not in the history this RPC node returned, so when work could first be announced for it is unknown and no sha256 can be checked against it; nothing is recorded; use an RPC node that keeps the full ledger`;
+export const creationUnread = (intent, creation) => `the escrow ${intent} is closed and its creation ${creation} holds no create instruction this client can read, so its attestor and spec hash are unknown and no sha256 can be checked against it; nothing is recorded`;
+export const notAProofEscrow = (intent) => `the escrow ${intent} commits no spec hash, so no work is announced for it and no delivery can be recorded for its release`;
+export const neverAnnounced = (sha256, intent) => `no work with sha256 ${sha256} was announced for the escrow ${intent}, so it is not what the release paid for; record the sha256 the payee announced`;
+export const paidOther = (worker, sha256, payee) => `${worker} announced the work with sha256 ${sha256} first, but the release paid the token account ${payee}, which is not ${worker}'s; a release records only work its payee announced first`;
+export const splitPaidOthers = (worker, sha256) => `${worker} announced the work with sha256 ${sha256} first, but is not among the recipients the split paid; a split records only work one of its recipients announced first`;
+export const recipientsUnread = (release) => `the recipients of the split ${release} cannot be read from its transaction: it holds no split instruction for this escrow, neither at the top level nor inside another program's call, so whether it paid the earliest announcer is unknown and nothing is recorded; ask its attestor which wallets the split paid`;
+export const followUpsUnknown = (release) => `the history after the release ${release} could not be read in full: it is longer than the pages read, the RPC node could not return some of its transactions yet, or it is too long to show that the escrow address was not made again since, so whether a follow-up already records a delivered sha256 for it is unknown and nothing more is recorded; when the node lagged, call again in a few seconds`;
+export const historyLagging = (release, intent) => `the node has not returned every transaction yet; call again in a few seconds: the history of the escrow ${intent} before the release ${release} holds a transaction the RPC node could not return, so where the escrow was made is not known yet and nothing is recorded`;
+export const otherLifecycle = (release, intent) => `the release ${release} belongs to an earlier lifecycle of the escrow address ${intent}, which was closed and made again at the same nonce since, so it is not a release of the escrow there now; leave release out to read the current one`;
+export const COVERAGE_UNPROVABLE = "this transport cannot report the first slot its RPC node keeps, so it cannot prove that the history read reaches back to the escrow's creation and an escrow without a release found reads as unknown rather than not released";
+const ZERO_HASH = /^0+$/;
+function heldProof(held) {
+    const params = decodeParams(held.kind, Uint8Array.from(held.params));
+    return params.kind === Kind.AttestedResult ? { attestor: params.attestor, specHash: Buffer.from(params.specHash).toString("hex") } : null;
+}
+async function announcedFor(transport, judge, intent, held, creation, release) {
+    const proof = (creation === null ? null : creationProof(creation, intent)) ?? (held === null ? null : heldProof(held));
+    if (proof === null) {
+        if (held !== null) {
+            throw new AgentRefusal("NotDeliverable", notAProofEscrow(intent));
+        }
+        throw new AgentRefusal("HistoryTooLong", creation === null ? escrowGone(intent) : creationUnread(intent, creation.signature));
+    }
+    if (ZERO_HASH.test(proof.specHash)) {
+        throw new AgentRefusal("NotDeliverable", notAProofEscrow(intent));
+    }
+    if (proof.attestor !== judge) {
+        throw new AgentRefusal("Unauthorized", releasedBy(proof.attestor, judge));
+    }
+    return lifecycleDeliveries(transport, judge, { intent, createdAt: creation?.blockTime ?? held?.createdAt ?? null, from: creation?.slot ?? null, to: release.slot });
+}
+export const coverageOf = (transport, text) => (transport.firstAvailableSlot === undefined ? `${text}; ${COVERAGE_UNPROVABLE}` : text);
+export async function recordingOf(transport, judge, owner, nonce, sha256, releaseSignature) {
+    const [intent] = await findIntentPda({ owner, nonce });
+    const lookup = releaseSignature === undefined ? await releaseLookup(transport, intent) : await namedRelease(transport, intent, releaseSignature);
+    const { release, transactions, complete } = lookup;
+    if (release === null) {
+        throw complete ? new AgentRefusal("NotReleased", notReleasedYet(intent)) : new AgentRefusal("HistoryTooLong", coverageOf(transport, RELEASE_UNKNOWN));
+    }
+    const { tx, event } = release;
+    const fields = event.fields;
+    const attestor = fields["attestor"];
+    if (attestor !== judge.address) {
+        throw new AgentRefusal("Unauthorized", releasedBy(attestor, judge.address));
+    }
+    const recorded = recordedDelivery(transactions, tx, attestor);
+    if (recorded !== null) {
+        throw new AgentRefusal("AlreadyRecorded", alreadyRecorded(recorded));
+    }
+    if (lookup.lagged === true) {
+        throw new AgentRefusal("HistoryLagging", historyLagging(tx.signature, intent));
+    }
+    if (!complete || !lookup.bound) {
+        throw new AgentRefusal("HistoryTooLong", coverageOf(transport, followUpsUnknown(tx.signature)));
+    }
+    const around = lookup.creation !== undefined ? null : await aroundRelease(transport, intent, tx);
+    if (around?.lagged === true) {
+        throw new AgentRefusal("HistoryLagging", historyLagging(tx.signature, intent));
+    }
+    const creation = around === null ? (lookup.creation ?? null) : around.creation;
+    const held = await intentAt(transport, intent);
+    const record = await announcedFor(transport, judge.address, intent, held !== null && !outlives(held, tx, creation) ? held : null, creation, tx);
+    if (!record.complete) {
+        throw new AgentRefusal("HistoryTooLong", HISTORY_TOO_LONG);
+    }
+    const first = firstDelivery(record.deliveries, sha256);
+    if (first === null) {
+        throw new AgentRefusal("NotAnnounced", neverAnnounced(sha256, intent));
+    }
+    if (event.name === "IntentSplit") {
+        const recipients = splitRecipients(tx, intent);
+        if (recipients === null) {
+            throw new AgentRefusal("HistoryTooLong", recipientsUnread(tx.signature));
+        }
+        if (!recipients.includes(first.worker)) {
+            throw new AgentRefusal("NotEarliestAnnouncer", splitPaidOthers(first.worker, sha256));
+        }
+    }
+    else if (!(await paidWallet(transport, tx, fields["payee"], first.worker, intent))) {
+        throw new AgentRefusal("NotEarliestAnnouncer", paidOther(first.worker, sha256, fields["payee"]));
+    }
+    return {
+        intent,
+        release: tx.signature,
+        attestor,
+        sha256,
+        memo: followUpMemo(sha256, tx.signature),
+        instructions: followUpInstructions(judge, intent, sha256, tx.signature),
+        summary: [
+            `Records: the delivered work's sha256 ${sha256} for the release ${tx.signature} of the escrow ${intent}, in a memo ${attestor} signs`,
+            `Notifies: the escrow ${intent}, with a transfer of 0 lamports, so the memo shows in its history`,
+            "Costs: the transaction fee; no tokens move",
+        ],
+    };
+}
+async function paidWallet(transport, release, payee, wallet, intent) {
+    const recorded = release.tokens?.find(({ account }) => account === payee)?.owner;
+    if (recorded !== undefined) {
+        return recorded === wallet;
+    }
+    const released = releasedMint(release, intent, payee);
+    const held = await transport.getAccount(payee);
+    if (held !== null && held.data.length >= 64) {
+        return getAddressDecoder().decode(held.data.subarray(32, 64)) === wallet;
+    }
+    const mint = released ?? (await heldMint(transport, intent));
+    if (mint === undefined) {
+        return false;
+    }
+    const { tokenProgram } = await mintOf(transport, mint);
+    return (await findAssociatedTokenAddress({ owner: wallet, mint, tokenProgram })) === payee;
+}
+export const walletRecordDelivery = define({
+    name: tool("wallet_record_delivery"),
+    title: "Record which work a release paid for",
+    description: `As the attestor that released a proof escrow, record the sha256 of the delivered work the release paid for when the release itself recorded none, such as when ${tool("wallet_attest_split")} returned recorded: false: this server's wallet sends one transaction with the follow-up memo naming the release and the sha256, and a transfer of 0 lamports to the escrow so ${tool("wallet_receipt")} reads it. Pass release, the signature the release returned: the release is then read from that one transaction, however long the escrow's history grew, and it works after the escrow is closed. It refuses unless the escrow has a release, made by this wallet, that records no sha256 yet, and the sha256 is work announced for the escrow whose earliest announcer the release paid, or for a split one of its recipients; it also refuses while the record of announced work is incomplete. It moves no tokens and costs only the transaction fee. Without send it only previews; show the user the summary and call again with send: true once they approve.`,
+    effect: "submit",
+    destructive: false,
+    input: object({
+        owner: account("the wallet that made the escrow"),
+        nonce: amount("the escrow intent's nonce"),
+        sha256: text("the sha256, as 64 hex digits, of the work the release paid for: the delivered_sha256 it was sent with"),
+        release: optional(text(RELEASE_INPUT)),
+        send: optional(flag("true signs and sends; leave out to preview")),
+    }),
+    output: object({
+        intent: account(),
+        release: text("the release's transaction"),
+        sha256: text(),
+        memo: text("the memo the transaction records"),
+        summary: list(text(), 8),
+        warnings: list(text(), 8),
+        sent: flag(),
+        signature: optional(text()),
+        next: optional(text()),
+    }),
+    run: async (ctx, input, call) => {
+        const signer = await signerOf(ctx);
+        const sha256 = sha256Of(input.sha256, "sha256");
+        const recording = await recordingOf(ctx.transport, signer, input.owner, input.nonce, sha256, releaseOf(input.release));
+        const view = {
+            intent: recording.intent,
+            release: recording.release,
+            sha256,
+            memo: recording.memo,
+            summary: recording.summary,
+            warnings: [],
+            prepared: preparedView(await prepare(ctx.transport, recording.instructions, signer.address)),
+        };
+        return sent(ctx, signer, view, input.send, call);
+    },
+});
+//# sourceMappingURL=record.js.map

package/dist/src/agent/wallet/record.js.map

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

package/dist/src/agent/wallet/releases.d.ts

@@ -0,0 +1,40 @@
+import type { Address } from "@solana/kit";
+import { decodeEvent, type Intent } from "@intent-engine/core";
+import { type EngineTransaction, type Transport } from "@intent-engine/client";
+export declare const releaseNotOf: (signature: string, intent: string) => string;
+export declare const releaseUnread: (signature: string) => string;
+export declare const HISTORY_PAGES = 10;
+export declare function escrowHistory(transport: Transport, intent: Address): Promise<EngineTransaction[]>;
+export declare const RELEASE_PAGES = 50;
+export declare const RELEASE_UNKNOWN = "the escrow's history could not be read in full and no release was found in what was read, so whether it was released is unknown: it is longer than the 10 pages read, the RPC node's ledger does not reach back to its creation, or the node could not return some of its transactions yet; a release that carries a memo is found past this cap, one without a memo is not, so pass release, the signature the release returned, to read it directly";
+type ReleaseEvent = NonNullable<ReturnType<typeof decodeEvent>>;
+export type ReleaseLookup = {
+    release: {
+        tx: EngineTransaction;
+        event: ReleaseEvent;
+    } | null;
+    transactions: EngineTransaction[];
+    complete: boolean;
+    bound: boolean;
+    creation?: EngineTransaction | null;
+    later?: boolean;
+    lagged?: boolean;
+};
+export declare const LIFECYCLE_FETCHES = 1000;
+export declare const outlives: (held: Intent, release: EngineTransaction, creation: EngineTransaction | null | undefined) => boolean;
+export declare function releaseLookup(transport: Transport, intent: Address): Promise<ReleaseLookup>;
+export type AroundRelease = {
+    followUps: EngineTransaction[];
+    creation: EngineTransaction | null;
+    later: boolean;
+    complete: boolean;
+    lagged?: boolean;
+};
+export declare function aroundRelease(transport: Transport, intent: Address, release: EngineTransaction): Promise<AroundRelease>;
+export declare function namedRelease(transport: Transport, intent: Address, signature: string): Promise<ReleaseLookup>;
+export declare function releasedMint(tx: EngineTransaction, intent: Address, payee?: Address): Address | undefined;
+export declare function createdMint(transactions: readonly EngineTransaction[], intent: Address): Address | undefined;
+export declare function heldMint(transport: Transport, intent: Address): Promise<Address | undefined>;
+export declare const SPLIT_INTENT_ACCOUNT = 2;
+export declare function splitRecipients(tx: EngineTransaction, intent?: Address): Address[] | null;
+export {};

package/dist/src/agent/wallet/releases.js

@@ -0,0 +1,236 @@
+import { decodeEvent, FILL_ATTESTED_SPLIT_DISCRIMINATOR, getFillAttestedSplitInstructionDataDecoder, getIntentSize, INTENT_ENGINE_PROGRAM_ADDRESS, IntentStatus, parseReleaseMemo, } from "@intent-engine/core";
+import { createdAtOf, DELIVERY_SCAN, engineCalls, historyCovers, intentAt, parseFollowUpMemo, recordedDelivery, scan, SIGNATURE_PAGE, TRANSACTION_FETCHES, transactionAt, } from "@intent-engine/client";
+import { tool } from "../names.js";
+import { AgentRefusal } from "../problems.js";
+import { pairOf } from "./fills.js";
+export const releaseNotOf = (signature, intent) => `the transaction ${signature} is not a release of the escrow ${intent}; pass the release signature that ${tool("wallet_attest")}, ${tool("wallet_attest_split")} or judge returned`;
+export const releaseUnread = (signature) => `the RPC node could not return the transaction ${signature}, so the release cannot be read from it; call again in a few seconds, or leave release out to search the escrow's history`;
+export const HISTORY_PAGES = 10;
+const createdIn = (tx, intent) => !tx.failed &&
+    tx.emitted.some((data) => {
+        const event = decodeEvent(data);
+        return event?.name === "IntentCreated" && event.fields["intent"] === intent;
+    });
+export async function escrowHistory(transport, intent) {
+    const floor = await createdAtOf(transport, intent);
+    return (await scan(transport, intent, { floor, pages: HISTORY_PAGES, until: (tx) => createdIn(tx, intent) })).transactions;
+}
+export const RELEASE_PAGES = 50;
+export const RELEASE_UNKNOWN = `the escrow's history could not be read in full and no release was found in what was read, so whether it was released is unknown: it is longer than the ${HISTORY_PAGES} pages read, the RPC node's ledger does not reach back to its creation, or the node could not return some of its transactions yet; a release that carries a memo is found past this cap, one without a memo is not, so pass release, the signature the release returned, to read it directly`;
+export const LIFECYCLE_FETCHES = SIGNATURE_PAGE;
+function releaseEventIn(tx, intent) {
+    if (tx.failed) {
+        return null;
+    }
+    for (const event of tx.emitted.map(decodeEvent)) {
+        if (event !== null && (event.name === "IntentAttested" || event.name === "IntentSplit") && event.fields["intent"] === intent) {
+            return event;
+        }
+    }
+    return null;
+}
+export const outlives = (held, release, creation) => held.status !== IntentStatus.Filled ||
+    (release.blockTime !== null && release.blockTime < held.createdAt) ||
+    (creation !== null && creation !== undefined && creation.blockTime !== null && creation.blockTime < held.createdAt);
+const LISTED_MEMO_LENGTH = /^\[\d+\] /;
+const listedMemos = (memo) => (memo === null ? [] : memo.split("; ").map((part) => part.replace(LISTED_MEMO_LENGTH, "")));
+const namesRelease = (texts, release) => texts.some((text) => parseFollowUpMemo(text)?.release === release);
+const unreadIn = (transactions) => transactions.some((tx) => tx.unread === true);
+async function fetched(transport, listed) {
+    const { transactionsOf } = transport;
+    const found = [];
+    for (let at = 0; transactionsOf !== undefined && at < listed.length; at += TRANSACTION_FETCHES) {
+        found.push(...(await transactionsOf.call(transport, listed.slice(at, at + TRANSACTION_FETCHES))));
+    }
+    return found;
+}
+async function markedRelease(transport, intent, floor) {
+    const { signaturesOf, transactionsOf } = transport;
+    if (signaturesOf === undefined || transactionsOf === undefined) {
+        return null;
+    }
+    const followUps = new Map();
+    const newer = [];
+    let before;
+    for (let page = 1; page <= RELEASE_PAGES; page++) {
+        const listed = await signaturesOf.call(transport, intent, SIGNATURE_PAGE, before);
+        const within = listed.filter((entry) => floor === null || entry.blockTime === null || entry.blockTime >= floor);
+        const candidates = [];
+        for (const entry of within) {
+            if (entry.failed) {
+                continue;
+            }
+            const memos = listedMemos(entry.memo);
+            for (const named of memos.map(parseFollowUpMemo)) {
+                if (named !== null) {
+                    followUps.set(named.release, [...(followUps.get(named.release) ?? []), entry]);
+                }
+            }
+            if (followUps.has(entry.signature) || memos.some((text) => parseReleaseMemo(text) !== null)) {
+                candidates.push(entry);
+            }
+        }
+        for (let at = 0; at < candidates.length; at += TRANSACTION_FETCHES) {
+            for (const tx of await transactionsOf.call(transport, candidates.slice(at, at + TRANSACTION_FETCHES))) {
+                const event = releaseEventIn(tx, intent);
+                if (event === null) {
+                    continue;
+                }
+                const since = [...newer, ...within.slice(0, within.findIndex((entry) => entry.signature === tx.signature))].filter((entry) => !entry.failed);
+                if (floor !== null || since.length > LIFECYCLE_FETCHES) {
+                    const recorded = await fetched(transport, followUps.get(tx.signature) ?? []);
+                    const bound = floor !== null;
+                    return { release: { tx, event }, transactions: [...recorded, tx], complete: bound && !unreadIn(recorded), bound };
+                }
+                const read = await fetched(transport, since);
+                if (read.some((later) => createdIn(later, intent))) {
+                    return null;
+                }
+                const bound = read.length === since.length && !unreadIn(read);
+                return { release: { tx, event }, transactions: [...read, tx], complete: bound, bound };
+            }
+        }
+        newer.push(...within);
+        before = listed[listed.length - 1]?.signature;
+        if (within.length < listed.length || before === undefined) {
+            return null;
+        }
+    }
+    return null;
+}
+export async function releaseLookup(transport, intent) {
+    const held = await intentAt(transport, intent);
+    const floor = held?.createdAt ?? null;
+    const ours = (tx) => held === null || !outlives(held, tx, null);
+    const marked = await markedRelease(transport, intent, floor);
+    if (marked !== null && marked.release !== null && ours(marked.release.tx)) {
+        return marked;
+    }
+    const covered = () => historyCovers(transport, intent, floor ?? undefined);
+    const scanned = await scan(transport, intent, { floor, pages: HISTORY_PAGES, until: (tx) => createdIn(tx, intent), covered });
+    const at = scanned.transactions.findIndex((tx) => releaseEventIn(tx, intent) !== null);
+    const tx = scanned.transactions[at];
+    const event = tx === undefined ? null : releaseEventIn(tx, intent);
+    if (tx !== undefined && event !== null && ours(tx)) {
+        return { release: { tx, event }, transactions: scanned.transactions, complete: !unreadIn(scanned.transactions.slice(0, at)), bound: true };
+    }
+    return { release: null, transactions: scanned.transactions, complete: scanned.complete && !unreadIn(scanned.transactions), bound: true };
+}
+const atOrBefore = (entry, release) => entry.slot <= release.slot || (entry.blockTime !== null && release.blockTime !== null && entry.blockTime <= release.blockTime);
+export async function aroundRelease(transport, intent, release) {
+    const { signaturesOf, transactionsOf } = transport;
+    if (signaturesOf === undefined || transactionsOf === undefined) {
+        const found = await transport.engineTransactions(DELIVERY_SCAN, intent);
+        const at = found.findIndex((tx) => tx.signature === release.signature);
+        const newer = at < 0 ? found : found.slice(0, at);
+        const followUps = newer.filter((tx) => tx.unread === true || namesRelease(tx.memos ?? [], release.signature));
+        return {
+            followUps,
+            creation: at < 0 ? null : (found.slice(at + 1).find((tx) => createdIn(tx, intent)) ?? null),
+            later: newer.some((tx) => createdIn(tx, intent)),
+            complete: at >= 0 && !unreadIn(followUps),
+        };
+    }
+    const held = await intentAt(transport, intent);
+    const current = held !== null && release.blockTime !== null && !outlives(held, release, null);
+    const candidate = (entry) => !entry.failed && (current ? entry.blockTime !== null && entry.blockTime === held?.createdAt : atOrBefore(entry, release));
+    const named = [];
+    let reached = false;
+    let creation = null;
+    let settled = false;
+    let capped = false;
+    let lagged = false;
+    let spent = 0;
+    let before;
+    for (let page = 1; page <= RELEASE_PAGES && !(reached && settled); page++) {
+        const listed = await signaturesOf.call(transport, intent, SIGNATURE_PAGE, before);
+        let older = listed;
+        if (!reached) {
+            const end = listed.findIndex((entry) => entry.signature === release.signature || entry.slot < release.slot);
+            named.push(...(end < 0 ? listed : listed.slice(0, end)).filter((entry) => !entry.failed && namesRelease(listedMemos(entry.memo), release.signature)));
+            reached = end >= 0;
+            older = end < 0 ? [] : listed.slice(listed[end]?.signature === release.signature ? end + 1 : end);
+        }
+        const wanted = settled ? [] : older.filter(candidate);
+        for (let at = 0; at < wanted.length && !settled; at += TRANSACTION_FETCHES) {
+            if (spent >= LIFECYCLE_FETCHES) {
+                capped = !current;
+                settled = true;
+                break;
+            }
+            const batch = wanted.slice(at, at + Math.min(TRANSACTION_FETCHES, LIFECYCLE_FETCHES - spent));
+            spent += batch.length;
+            for (const tx of await transactionsOf.call(transport, batch)) {
+                if (tx.unread === true || createdIn(tx, intent)) {
+                    creation = tx.unread === true ? null : tx;
+                    lagged = tx.unread === true && !current;
+                    settled = true;
+                    break;
+                }
+            }
+        }
+        before = listed[listed.length - 1]?.signature;
+        if (before === undefined || listed.length < SIGNATURE_PAGE) {
+            break;
+        }
+    }
+    const followUps = await fetched(transport, named);
+    return { followUps, creation, later: false, complete: reached && !capped && !lagged && !unreadIn(followUps), ...(lagged ? { lagged } : {}) };
+}
+export async function namedRelease(transport, intent, signature) {
+    const tx = await transactionAt(transport, signature, intent);
+    if (tx === null || tx.unread === true) {
+        throw new AgentRefusal("ReleaseUnread", releaseUnread(signature));
+    }
+    const event = releaseEventIn(tx, intent);
+    if (event === null) {
+        throw new AgentRefusal("NotARelease", releaseNotOf(signature, intent));
+    }
+    const attestor = event.fields["attestor"];
+    const around = await aroundRelease(transport, intent, tx);
+    const inline = recordedDelivery([], tx, attestor) !== null;
+    return {
+        release: { tx, event },
+        transactions: [...(inline ? [] : around.followUps), tx],
+        complete: inline || around.complete,
+        bound: true,
+        creation: around.creation,
+        later: around.later,
+        ...(around.lagged === true ? { lagged: true } : {}),
+    };
+}
+export function releasedMint(tx, intent, payee) {
+    const tokens = tx.tokens ?? [];
+    return (tokens.find((held) => held.owner === intent) ?? tokens.find((held) => payee !== undefined && held.account === payee))?.mint;
+}
+export function createdMint(transactions, intent) {
+    for (const tx of transactions) {
+        for (const event of tx.emitted.map(decodeEvent)) {
+            const fields = (event?.fields ?? {});
+            if (event?.name === "IntentCreated" && fields["intent"] === intent) {
+                return fields["inputMint"];
+            }
+        }
+    }
+    return undefined;
+}
+export async function heldMint(transport, intent) {
+    const view = await transport.getAccount(intent);
+    return view === null || view.owner !== INTENT_ENGINE_PROGRAM_ADDRESS || view.data.length !== getIntentSize() ? undefined : pairOf(view.data)?.inputMint;
+}
+export const SPLIT_INTENT_ACCOUNT = 2;
+const isSplit = (data) => data.length >= FILL_ATTESTED_SPLIT_DISCRIMINATOR.length && FILL_ATTESTED_SPLIT_DISCRIMINATOR.every((b, i) => data[i] === b);
+export function splitRecipients(tx, intent) {
+    const calls = engineCalls(tx).filter(({ data, accounts }) => isSplit(data) && (intent === undefined || accounts?.[SPLIT_INTENT_ACCOUNT] === intent));
+    const call = calls.find(({ inner }) => !inner) ?? calls[0];
+    if (call === undefined) {
+        return null;
+    }
+    try {
+        return getFillAttestedSplitInstructionDataDecoder().decode(call.data).recipients;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=releases.js.map