@intent-engine/cli 0.1.23 → 0.1.26

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

@@ -0,0 +1,27 @@
+import type { Address } from "@solana/kit";
+import type { EngineTransaction, Transport } from "@intent-engine/client";
+export declare const SWAP_HEADROOM_BPS = 200n;
+export declare const SWAP_BLIND_BPS = 2500n;
+export declare const SWAP_CAP_BPS = 20000n;
+export declare function recentFills(transport: Transport, inputMint: Address, outputMint: Address): Promise<Fill[]>;
+export declare const bestOf: (fills: Fill[]) => Fill | undefined;
+export declare const medianOf: (fills: Fill[]) => Fill | undefined;
+export declare function openingAsk(fills: Fill[], amount: bigint, floor: bigint): bigint;
+export type Fill = {
+    intent: Address;
+    amountIn: bigint;
+    delivered: bigint;
+    signature: string;
+    blockTime: bigint | null;
+};
+export type Pair = {
+    inputMint: Address;
+    outputMint: Address;
+};
+export declare function historyIn(transactions: readonly EngineTransaction[]): {
+    created: Map<Address, Pair>;
+    fills: Fill[];
+    ended: Map<Address, "cancelled" | "expired">;
+    unread: number;
+};
+export declare function pairOf(data: Uint8Array): Pair | null;

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

@@ -0,0 +1,80 @@
+import { decodeEvent, getIntentDecoder } from "@intent-engine/core";
+import { ESTIMATE_SCAN, ESTIMATE_FILLS } from "./guard.js";
+export const SWAP_HEADROOM_BPS = 200n;
+export const SWAP_BLIND_BPS = 2500n;
+export const SWAP_CAP_BPS = 20000n;
+export async function recentFills(transport, inputMint, outputMint) {
+    const { created, fills } = await engineHistory(transport, ESTIMATE_SCAN);
+    const unknown = [...new Set(fills.map((f) => f.intent).filter((intent) => !created.has(intent)))];
+    const views = unknown.length === 0 ? [] : await transport.getAccounts(unknown);
+    unknown.forEach((intent, i) => {
+        const view = views[i];
+        const pair = view === null || view === undefined ? null : pairOf(view.data);
+        if (pair !== null) {
+            created.set(intent, pair);
+        }
+    });
+    return fills
+        .filter((f) => f.amountIn > 0n && created.get(f.intent)?.inputMint === inputMint && created.get(f.intent)?.outputMint === outputMint)
+        .slice(0, ESTIMATE_FILLS);
+}
+const byRate = (fills) => [...fills].sort((a, b) => (a.delivered * b.amountIn < b.delivered * a.amountIn ? -1 : a.delivered * b.amountIn > b.delivered * a.amountIn ? 1 : 0));
+export const bestOf = (fills) => byRate(fills).at(-1);
+export const medianOf = (fills) => byRate(fills)[Math.floor((fills.length - 1) / 2)];
+export function openingAsk(fills, amount, floor) {
+    const typical = medianOf(fills);
+    const blind = (floor * (10000n + SWAP_BLIND_BPS)) / 10000n;
+    const seen = typical === undefined ? 0n : (amount * typical.delivered * (10000n + SWAP_HEADROOM_BPS)) / (typical.amountIn * 10000n);
+    const cap = (floor * SWAP_CAP_BPS) / 10000n;
+    const ask = seen > blind ? seen : blind;
+    return ask < cap ? ask : cap;
+}
+async function engineHistory(transport, limit) {
+    return historyIn(await transport.engineTransactions(limit));
+}
+export function historyIn(transactions) {
+    const created = new Map();
+    const fills = [];
+    const ended = new Map();
+    let unread = 0;
+    for (const tx of transactions) {
+        if (tx.unread === true) {
+            unread += 1;
+        }
+        if (tx.failed) {
+            continue;
+        }
+        const begun = new Map();
+        for (const event of tx.emitted.map(decodeEvent)) {
+            if (event === null) {
+                continue;
+            }
+            const fields = event.fields;
+            const intent = fields["intent"];
+            if (event.name === "IntentCreated") {
+                created.set(intent, { inputMint: fields["inputMint"], outputMint: fields["outputMint"] });
+            }
+            if (event.name === "FillBegun") {
+                begun.set(intent, fields["amountIn"]);
+            }
+            const amountIn = event.name === "IntentFilled" ? fields["amountIn"] : event.name === "FillEnded" ? begun.get(intent) : undefined;
+            if (amountIn !== undefined) {
+                fills.push({ intent, amountIn, delivered: fields["delivered"], signature: tx.signature, blockTime: tx.blockTime });
+            }
+            if (event.name === "IntentCancelled" || event.name === "IntentExpired") {
+                ended.set(intent, event.name === "IntentCancelled" ? "cancelled" : "expired");
+            }
+        }
+    }
+    return { created, fills, ended, unread };
+}
+export function pairOf(data) {
+    try {
+        const { inputMint, outputMint } = getIntentDecoder().decode(data);
+        return { inputMint, outputMint };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=fills.js.map

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

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

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

@@ -0,0 +1,57 @@
+import { type Address, type KeyPairSigner } from "@solana/kit";
+import { type Env, type WalletLimits } from "../../args.js";
+import { type Files } from "../../wallet.js";
+import type { AgentContext } from "../actions.js";
+import type { Call } from "../claims.js";
+import { type Sale, type SaleBook } from "../sales.js";
+export type WalletGuard = {
+    limits: WalletLimits;
+    book: SaleBook;
+};
+export declare const walletGuard: (limits: WalletLimits, book?: SaleBook) => WalletGuard;
+export type WalletAccess = {
+    url: string;
+    files: Files;
+    env: Env;
+    sleep(seconds: number): Promise<boolean>;
+    now(): bigint;
+    limits: WalletGuard;
+};
+export declare const SALE_WINDOW = 3600n;
+export declare const ESTIMATE_SCAN = 12;
+export declare const ESTIMATE_FILLS = 5;
+export declare const WAIT_DEFAULT = 30;
+export declare const WAIT_MAX = 40;
+export declare const WAIT_SCAN = 10;
+export declare const DEFAULT_EXPIRES_IN = 3600;
+export declare const LANDING_SECONDS = 10;
+export declare const MAINNET_GENESIS = "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+export declare const WALLET_NOTICE: string[];
+export declare const walletEmpty: (address: string) => string;
+export declare const NO_WALLET: string;
+export declare const WALLET_OFF = "this server runs without a wallet; start it with mcp --wallet to let it sign";
+export declare const PREVIEW_ONLY = "nothing was sent; show the summary to the user and call again with send: true only after they approve";
+export declare function access(ctx: AgentContext): WalletAccess;
+export declare function testCluster(ctx: AgentContext): Promise<WalletAccess>;
+export declare function savedKeypair(wallet: WalletAccess): Promise<string | undefined>;
+export declare function signerOf(ctx: AgentContext): Promise<KeyPairSigner>;
+export declare function mintNamed(text: string, url: string, path: string): Address;
+export declare function raw(tokens: string, decimals: number, path: string): bigint;
+export declare const nameOf: (mint: Address) => string;
+export declare const limited: (guard: WalletGuard) => boolean;
+export declare function limitLines(limits: WalletLimits): string[];
+export declare function bookOf(wallet: WalletAccess): Promise<string | undefined>;
+export declare const live: (sales: readonly Sale[], now: bigint) => Sale[];
+export declare function salesOf(wallet: WalletAccess, now: bigint): Promise<Sale[]>;
+export declare function checkSale(guard: WalletGuard, mint: Address, decimals: number, amount: bigint, now: bigint, sales: readonly Sale[]): void;
+export declare function checkHour(guard: WalletGuard, mint: Address, decimals: number, amount: bigint, now: bigint, sales: readonly Sale[]): void;
+export declare function sent(ctx: AgentContext, signer: KeyPairSigner, view: Record<string, unknown>, send: boolean | undefined, call: Call): Promise<{
+    sent: boolean;
+    next: string;
+} | {
+    sent: boolean;
+    signature: string;
+}>;
+export declare function sha256Of(text: string, path: string): string;
+export declare function rpcRefused(error: unknown): boolean;
+export declare const refusedBeforeSending: (error: unknown) => boolean;

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

@@ -0,0 +1,205 @@
+import { resolve } from "node:path";
+import { isSolanaError, SOLANA_ERROR__RPC__TRANSPORT_HTTP_ERROR } from "@solana/kit";
+import { formatAmount, parseAmount } from "@intent-engine/core";
+import { Charged, neverLanded } from "@intent-engine/client";
+import { ENV_KEYPAIR, WALLET_NOT_MAINNET } from "../../args.js";
+import { execute } from "../../flows.js";
+import { TOKEN_NAMES, tokenNamed } from "../../tokens.js";
+import { expandHome, FAUCET, PUBLIC_FAUCET, withSettings } from "../../wallet.js";
+import { tool } from "../names.js";
+import { AgentRefusal } from "../problems.js";
+import { InvalidInput } from "../schema.js";
+import { fileSales, salesPath } from "../sales.js";
+export const walletGuard = (limits, book = fileSales()) => ({ limits, book });
+export const SALE_WINDOW = 3600n;
+export const ESTIMATE_SCAN = 12;
+export const ESTIMATE_FILLS = 5;
+export const WAIT_DEFAULT = 30;
+export const WAIT_MAX = 40;
+export const WAIT_SCAN = 10;
+export const DEFAULT_EXPIRES_IN = 3_600;
+export const LANDING_SECONDS = 10;
+export const MAINNET_GENESIS = "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+export const WALLET_NOTICE = [
+    "Test network only: this wallet works on Solana devnet, testnet or localnet and refuses mainnet. Its tokens have no value.",
+    "Your key stays on this machine: setup makes one unless a keypair is already configured, and names its file. Only signed transactions leave it.",
+    "This server talks to no one but the RPC endpoint it was started with.",
+    "Nothing moves until you approve: swaps, auctions, escrows, releases and cancels only preview until you say yes.",
+    "Do not send real funds to this wallet or use its key anywhere else.",
+];
+export const walletEmpty = (address) => `the wallet ${address} holds no SOL yet; request devnet SOL for it at ${FAUCET} or ${PUBLIC_FAUCET}, then try again`;
+export const NO_WALLET = `this server has no wallet yet; call ${tool("wallet_setup")} first`;
+export const WALLET_OFF = "this server runs without a wallet; start it with mcp --wallet to let it sign";
+export const PREVIEW_ONLY = "nothing was sent; show the summary to the user and call again with send: true only after they approve";
+export function access(ctx) {
+    if (ctx.wallet === undefined) {
+        throw new AgentRefusal("WalletNotConfigured", WALLET_OFF);
+    }
+    return ctx.wallet;
+}
+const genesisOf = new WeakMap();
+export async function testCluster(ctx) {
+    const wallet = access(ctx);
+    let genesis = genesisOf.get(wallet);
+    if (genesis === undefined) {
+        const read = ctx.transport.genesisHash();
+        genesis = read;
+        genesisOf.set(wallet, read);
+        read.catch(() => {
+            if (genesisOf.get(wallet) === read) {
+                genesisOf.delete(wallet);
+            }
+        });
+    }
+    if ((await genesis) === MAINNET_GENESIS) {
+        throw new AgentRefusal("WalletNotMainnet", WALLET_NOT_MAINNET);
+    }
+    return wallet;
+}
+export async function savedKeypair(wallet) {
+    return (await withSettings(wallet.files, wallet.env))[ENV_KEYPAIR];
+}
+export async function signerOf(ctx) {
+    const wallet = await testCluster(ctx);
+    const path = await savedKeypair(wallet);
+    if (path === undefined) {
+        throw new AgentRefusal("NoWallet", NO_WALLET);
+    }
+    try {
+        return await wallet.files.loadSigner(path);
+    }
+    catch {
+        throw new AgentRefusal("NoWallet", NO_WALLET);
+    }
+}
+export function mintNamed(text, url, path) {
+    const mint = tokenNamed(text.trim(), url);
+    if (mint instanceof Error) {
+        throw new InvalidInput([{ path, message: mint.message }]);
+    }
+    if (!/^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(mint)) {
+        throw new InvalidInput([{ path, message: "name SOL, TEST or a token mint address" }]);
+    }
+    return mint;
+}
+export function raw(tokens, decimals, path) {
+    try {
+        return parseAmount(tokens, decimals);
+    }
+    catch (error) {
+        throw new InvalidInput([{ path, message: error instanceof Error ? error.message : String(error) }]);
+    }
+}
+export const nameOf = (mint) => TOKEN_NAMES[mint] ?? mint;
+export const limited = (guard) => guard.limits.perTrade.size + guard.limits.perHour.size > 0;
+export function limitLines(limits) {
+    const mints = [...new Set([...limits.perTrade.keys(), ...limits.perHour.keys()])];
+    if (mints.length === 0) {
+        return [];
+    }
+    return [
+        "Whoever started this server set sell limits that no tool call can change:",
+        ...mints.map((mint) => {
+            const caps = [
+                ...(limits.perTrade.has(mint) ? [`${limits.perTrade.get(mint)} per trade`] : []),
+                ...(limits.perHour.has(mint) ? [`${limits.perHour.get(mint)} per hour`] : []),
+            ];
+            return `- ${nameOf(mint)}: at most ${caps.join(" and ")}`;
+        }),
+        "It sells no other token. Plan trades within these limits and tell the user when a request exceeds them.",
+    ];
+}
+function capOf(text, decimals, mint) {
+    try {
+        return parseAmount(text, decimals);
+    }
+    catch {
+        throw new AgentRefusal("WalletTokenNotAllowed", `this server's limit of ${text} ${nameOf(mint)} does not fit a token with ${decimals} decimals, so it sells none; the user restarts it with a valid limit`);
+    }
+}
+export async function bookOf(wallet) {
+    const path = await savedKeypair(wallet);
+    return path === undefined ? undefined : salesPath(resolve(expandHome(path, wallet.files.home)));
+}
+export const live = (sales, now) => sales.filter((s) => s.at > now - SALE_WINDOW);
+export async function salesOf(wallet, now) {
+    if (!limited(wallet.limits)) {
+        return [];
+    }
+    const path = await bookOf(wallet);
+    return path === undefined ? [] : live(await wallet.limits.book.read(path), now);
+}
+export function checkSale(guard, mint, decimals, amount, now, sales) {
+    if (!limited(guard)) {
+        return;
+    }
+    const { perTrade, perHour } = guard.limits;
+    const name = nameOf(mint);
+    if (!perTrade.has(mint) && !perHour.has(mint)) {
+        const allowed = [...new Set([...perTrade.keys(), ...perHour.keys()])].map(nameOf).join(", ");
+        throw new AgentRefusal("WalletTokenNotAllowed", `this server sells only ${allowed}, not ${name}; its limits were set when it started`);
+    }
+    const trade = perTrade.get(mint);
+    if (trade !== undefined && amount > capOf(trade, decimals, mint)) {
+        throw new AgentRefusal("WalletTradeLimit", `this server sells at most ${trade} ${name} per trade and this sells ${formatAmount(amount, decimals)}; sell less, or the user restarts the server with a higher --wallet-per-trade`);
+    }
+    checkHour(guard, mint, decimals, amount, now, sales);
+}
+export function checkHour(guard, mint, decimals, amount, now, sales) {
+    const hour = guard.limits.perHour.get(mint);
+    const name = nameOf(mint);
+    if (hour === undefined) {
+        return;
+    }
+    const used = live(sales, now)
+        .filter((s) => s.mint === mint)
+        .reduce((sum, s) => sum + s.amount, 0n);
+    const cap = capOf(hour, decimals, mint);
+    if (used + amount > cap) {
+        throw new AgentRefusal("WalletHourLimit", `this server sells at most ${hour} ${name} per hour and has ${formatAmount(cap > used ? cap - used : 0n, decimals)} left; this sells ${formatAmount(amount, decimals)}`);
+    }
+}
+export async function sent(ctx, signer, view, send, call) {
+    for (const undo of call.undo.splice(0)) {
+        undo();
+    }
+    const { prepared, ...shown } = view;
+    if (send !== true) {
+        return { ...shown, sent: false, next: PREVIEW_ONLY };
+    }
+    if ((await ctx.transport.genesisHash()) === MAINNET_GENESIS) {
+        throw new AgentRefusal("WalletNotMainnet", WALLET_NOT_MAINNET);
+    }
+    return { ...shown, sent: true, signature: await execute(ctx.transport, prepared, signer) };
+}
+export function sha256Of(text, path) {
+    const hex = text.trim().toLowerCase();
+    if (!/^[0-9a-f]{64}$/.test(hex)) {
+        throw new InvalidInput([{ path, message: "give a sha256 as 64 hex digits" }]);
+    }
+    return hex;
+}
+const UNREACHED = new Set(["ECONNREFUSED", "ENOTFOUND", "EAI_AGAIN"]);
+const RPC_CAUSE_DEPTH = 8;
+const JSON_RPC_FIRST = -32_000;
+const JSON_RPC_LAST = -32_768;
+export function rpcRefused(error) {
+    if (error instanceof Charged) {
+        return false;
+    }
+    let link = error;
+    for (let depth = 0; depth < RPC_CAUSE_DEPTH && link instanceof Error; depth++, link = link.cause) {
+        if (isSolanaError(link, SOLANA_ERROR__RPC__TRANSPORT_HTTP_ERROR)) {
+            return link.context.statusCode >= 400 && link.context.statusCode < 500;
+        }
+        if (isSolanaError(link) && link.context.__code <= JSON_RPC_FIRST && link.context.__code >= JSON_RPC_LAST) {
+            return true;
+        }
+        if (UNREACHED.has(link.code)) {
+            return true;
+        }
+    }
+    return false;
+}
+export const refusedBeforeSending = (error) => neverLanded(error) || error instanceof AgentRefusal || error instanceof InvalidInput || rpcRefused(error);
+//# sourceMappingURL=guard.js.map

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

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

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

@@ -0,0 +1,50 @@
+import type { Address } from "@solana/kit";
+import { mintOf } from "@intent-engine/client";
+import type { AgentContext } from "../actions.js";
+import type { Call } from "../claims.js";
+import { type Schema } from "../schema.js";
+import { orderSchema } from "../shapes.js";
+export declare const offerFields: {
+    intent: Schema<Address>;
+    nonce: Schema<bigint>;
+    summary: Schema<string[]>;
+    warnings: Schema<string[]>;
+    sent: Schema<boolean>;
+    signature: {
+        optional: Schema<string>;
+    };
+    next: {
+        optional: Schema<string>;
+    };
+};
+export declare const offerOutput: Schema<{
+    intent: Address;
+    nonce: bigint;
+    summary: string[];
+    warnings: string[];
+    sent: boolean;
+} & {
+    signature?: string;
+    next?: string;
+}>;
+export type Token = Awaited<ReturnType<typeof mintOf>>;
+type Order = typeof orderSchema extends Schema<infer T> ? T : never;
+type Terms = {
+    order: Order;
+    expires_at: bigint;
+    spec_url?: string;
+};
+export declare function offered(ctx: AgentContext, call: Call, input: {
+    sell: string;
+    buy: string;
+    pay_to?: Address | undefined;
+    send?: boolean | undefined;
+}, terms: (sold: Token, bought: Token, now: bigint, inputMint: Address, outputMint: Address) => Promise<Terms> | Terms): Promise<{
+    sent: boolean;
+    next: string;
+} | {
+    sent: boolean;
+    signature: string;
+}>;
+export declare function nonceTaken(error: unknown): boolean;
+export {};

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

@@ -0,0 +1,80 @@
+import { randomUUID } from "node:crypto";
+import { chainTime, CLOCK_SYSVAR, explain, mintOf, unmemoized } from "@intent-engine/client";
+import { prepareCreate } from "../create.js";
+import { AgentRefusal, problemOf } from "../problems.js";
+import { account, amount, flag, list, object, optional, text } from "../schema.js";
+import { orderSchema } from "../shapes.js";
+import { walletEmpty, access, signerOf, mintNamed, limited, bookOf, live, salesOf, checkSale, sent, refusedBeforeSending } from "./guard.js";
+export const offerFields = {
+    intent: account(),
+    nonce: amount(),
+    summary: list(text(), 24),
+    warnings: list(text(), 16),
+    sent: flag(),
+    signature: optional(text()),
+    next: optional(text()),
+};
+export const offerOutput = object(offerFields);
+export async function offered(ctx, call, input, terms) {
+    const wallet = access(ctx);
+    const signer = await signerOf(ctx);
+    const inputMint = mintNamed(input.sell, wallet.url, "sell");
+    const outputMint = mintNamed(input.buy, wallet.url, "buy");
+    await ctx.transport.warm?.([signer.address, inputMint, outputMint, CLOCK_SYSVAR]);
+    if (((await ctx.transport.getAccount(signer.address))?.lamports ?? 0n) === 0n) {
+        throw new AgentRefusal("WalletEmpty", walletEmpty(signer.address));
+    }
+    const [inputToken, outputToken, now] = await Promise.all([
+        mintOf(ctx.transport, inputMint),
+        mintOf(ctx.transport, outputMint),
+        chainTime(ctx.transport),
+    ]);
+    const made = await terms(inputToken, outputToken, now, inputMint, outputMint);
+    const sold = made.order.amount_in;
+    const guard = wallet.limits;
+    checkSale(guard, inputMint, inputToken.decimals, sold, now, await salesOf(wallet, now));
+    const created = async (context) => {
+        const view = (await prepareCreate.run(context, { owner: signer.address, input_mint: inputMint, output_mint: outputMint, ...(input.pay_to === undefined ? {} : { pay_to: input.pay_to }), ...made }, call));
+        const { intent, nonce, summary, warnings, prepared } = view;
+        return { intent, nonce, summary, warnings, prepared };
+    };
+    const first = await created(ctx);
+    if (input.send !== true) {
+        return sent(ctx, signer, first, input.send, call);
+    }
+    const path = limited(guard) ? await bookOf(wallet) : undefined;
+    const sale = { id: randomUUID(), mint: inputMint, at: now, amount: sold };
+    if (path !== undefined) {
+        await guard.book.update(path, (sales) => {
+            const kept = live(sales, now);
+            checkSale(guard, inputMint, inputToken.decimals, sold, now, kept);
+            return { sales: [...kept, sale], value: undefined };
+        });
+    }
+    try {
+        try {
+            return await sent(ctx, signer, first, true, call);
+        }
+        catch (error) {
+            if (!nonceTaken(error)) {
+                throw error;
+            }
+            return await sent(ctx, signer, await created({ ...ctx, transport: unmemoized(ctx.transport) }), true, call);
+        }
+    }
+    catch (error) {
+        if (path !== undefined && refusedBeforeSending(error)) {
+            await guard.book.update(path, (sales) => ({ sales: sales.filter((s) => s.id !== sale.id), value: undefined })).catch(() => undefined);
+        }
+        throw error;
+    }
+}
+const NONCE_COLLISIONS = new Set(["NonceUsed", "NonceTaken"]);
+export function nonceTaken(error) {
+    if (NONCE_COLLISIONS.has(problemOf(error).code) || explain(error)?.name === "NonceUsed") {
+        return true;
+    }
+    const text = error instanceof Error ? error.message : String(error);
+    return /already in use/i.test(text);
+}
+//# sourceMappingURL=offer.js.map

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

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

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

@@ -0,0 +1,42 @@
+import { type Address } from "@solana/kit";
+import { type Transport } from "@intent-engine/client";
+export declare const NOT_RELEASED: string;
+export declare 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";
+export declare const walletReceipt: import("../actions.js").AnyAction;
+export declare const getReceipt: import("../actions.js").AnyAction;
+export declare function escrowReceipt(transport: Transport, owner: Address, nonce: bigint, sha256: string | undefined, releaseSignature?: string): Promise<{
+    intent: Address<string>;
+    released: boolean;
+    next: string;
+    complete?: never;
+} | {
+    intent: Address<string>;
+    released: boolean;
+    complete: boolean;
+    next: string;
+} | {
+    intent: Address<string>;
+    released: boolean;
+    complete?: boolean;
+    next?: string;
+    attestor: Address;
+    result: bigint;
+    signature: string;
+    delivered_sha256?: string;
+    matches?: boolean;
+    paid: string;
+    recipients: bigint;
+} | {
+    intent: Address<string>;
+    released: boolean;
+    complete?: boolean;
+    next?: string;
+    attestor: Address;
+    result: bigint;
+    signature: string;
+    delivered_sha256?: string;
+    matches?: boolean;
+    paid_to?: Address;
+    payee: Address;
+    paid: string;
+}>;