@intent-engine/cli 0.0.0-stage → 0.1.1

package/dist/src/agent/settle.js

@@ -0,0 +1,145 @@
+import { createNoopSigner } from "@solana/kit";
+import { buildCancelIntent, buildCloseIntent, decodeParamsLoose, describeTerms, findVaultPda, formatAmount, getIntentDecoder, tokenOf, } from "@intent-engine/core";
+import { chainTime, loadIntent, tokenProgramOf } from "../accounts.js";
+import { closing, CostlyFunding, crankAction, expiring, UnfundedAccount, vaultBalance } from "../crank.js";
+import { define } from "./actions.js";
+import { tool } from "./names.js";
+import { prepare } from "./prepare.js";
+import { AgentRefusal } from "./problems.js";
+import { preparedSchema, preparedView } from "./shapes.js";
+import { account, amount, choice, flag, integer, list, object, optional, text } from "./schema.js";
+import { TOKEN_NAMES, tokenNames } from "../tokens.js";
+import { decimalsFor, SOL_DECIMALS } from "./read.js";
+export const WORK_LIMIT = 100;
+export const OWNER_ACCOUNT_MISSING = "the owner has no token account that can take the refund; set fund_accounts to create one for them at the cranker's cost";
+const intentRef = {
+    owner: account("the wallet that created the intent"),
+    nonce: amount("the intent's nonce under that owner"),
+};
+export const prepareCancel = define({
+    name: tool("prepare_cancel"),
+    title: "Prepare a cancel",
+    description: "Build the transaction that cancels an open intent and returns what is left in escrow to the owner's token account. The intent account stays readable as cancelled and keeps its rent and bounty until whoever paid them closes it; if the owner paid them, set close to close it in the same transaction and get them back now. Only the owner can sign it.",
+    effect: "prepare",
+    input: object({
+        ...intentRef,
+        close: optional(flag("also close the intent account and return its rent and bounty to the owner, who must have paid them; it can no longer be read afterwards")),
+    }),
+    output: object({
+        intent: account(),
+        refund: amount("raw input units returned to the owner"),
+        summary: list(text(), 16, "what signing does, in plain words"),
+        warnings: list(text(), 8, "anything to check before signing"),
+        prepared: preparedSchema,
+    }),
+    run: async ({ transport }, input) => {
+        const { address, intent } = await loadIntent(transport, input.owner, input.nonce);
+        const owner = createNoopSigner(input.owner);
+        const ref = {
+            owner: input.owner,
+            nonce: input.nonce,
+            inputMint: intent.inputMint,
+            tokenProgram: await tokenProgramOf(transport, intent.inputMint),
+        };
+        const ix = await buildCancelIntent({ ...ref, owner });
+        const ownPaid = intent.rentPayer === input.owner;
+        const andClose = input.close ?? false;
+        if (andClose && !ownPaid) {
+            throw new AgentRefusal("NotRentPayer", `${intent.rentPayer} paid this intent's rent and bounty, so only it can close the intent; cancel without close`);
+        }
+        const close = andClose ? [await buildCloseIntent({ ...ref, cranker: owner, rentPayer: input.owner })] : [];
+        const [vault] = await findVaultPda({ intent: address });
+        let held = 0n;
+        for (const account of [address, vault]) {
+            held += (await transport.getAccount(account))?.lamports ?? 0n;
+        }
+        const rent = `${held} lamports (${formatAmount(held, SOL_DECIMALS)} SOL)`;
+        const refund = await vaultBalance(transport, address);
+        const decimals = await decimalsFor(transport, new Map(), intent.inputMint, intent.outputMint);
+        const params = decodeParamsLoose(intent.kind, Uint8Array.from(intent.params));
+        const terms = "unknown" in params
+            ? []
+            : describeTerms({ kind: intent.kind, params: Uint8Array.from(intent.params), inputMint: intent.inputMint, outputMint: intent.outputMint }, { ...decimals, ...tokenNames(intent.inputMint, intent.outputMint) });
+        return {
+            intent: address,
+            refund,
+            summary: [
+                `Cancels intent ${address} (nonce ${intent.nonce}); nobody can fill it afterwards`,
+                ...terms.map((line) => `Cancelled terms: ${line}`),
+                `Returns ${formatAmount(refund, decimals.inputDecimals)} of ${tokenOf(intent.inputMint, TOKEN_NAMES[intent.inputMint])} to your token account`,
+                andClose
+                    ? `Closes the intent and its escrow account in the same transaction and returns their ${rent} of rent and bounty to you; the intent can no longer be read afterwards`
+                    : ownPaid
+                        ? `The intent and its escrow account stay readable as cancelled and hold ${rent} of rent and bounty that are yours; set close to get them back in this transaction, or close it later with ${tool("prepare_crank")}`
+                        : `The intent and its escrow account stay until ${intent.rentPayer}, who paid for them, closes them; that returns their ${rent} to them`,
+            ],
+            warnings: [],
+            prepared: preparedView(await prepare(transport, [ix, ...close], input.owner)),
+        };
+    },
+});
+export const findCrankWork = define({
+    name: tool("find_crank_work"),
+    title: "Find crank work",
+    description: "List intents anyone may settle now for their bounty: open intents past their expiry (expire refunds the owner) and filled or expired intents waiting to be closed (close returns their rent to whoever paid it, or to the cranker when that payer has since become a program). A cancelled intent's bounty goes back to its payer, so it is listed only for that payer, given as cranker. Each comes with the bounty in lamports.",
+    effect: "read",
+    input: object({
+        cranker: optional(account("include the cancelled intents this wallet paid for, whose bounty and rent return to it")),
+        limit: optional(integer(1, WORK_LIMIT)),
+    }),
+    output: object({
+        now: amount("chain time in unix seconds"),
+        work: list(object({ intent: account(), owner: account(), nonce: amount(), action: choice(["expire", "close"]), bounty: amount() }), WORK_LIMIT),
+        more: flag(),
+    }),
+    run: async ({ transport }, input) => {
+        const now = await chainTime(transport);
+        const work = [];
+        for (const { address, data } of await transport.intents()) {
+            const intent = getIntentDecoder().decode(data);
+            const action = crankAction(intent, now, input.cranker);
+            if (action !== undefined) {
+                work.push({ intent: address, owner: intent.owner, nonce: intent.nonce, action, bounty: BigInt(intent.bounty) });
+            }
+        }
+        const limit = input.limit ?? WORK_LIMIT;
+        return { now, work: work.slice(0, limit), more: work.length > limit };
+    },
+});
+export const prepareCrank = define({
+    name: tool("prepare_crank"),
+    title: "Prepare a crank",
+    description: "Build the transaction that expires an overdue intent (refunding its owner) and closes it, or closes an already settled one, paying the intent's bounty to the cranker. The cranker signs and pays the fee. If the owner's token account is gone or cannot take the refund, set fund_accounts to create one for the owner at the cranker's cost; that is refused when its rent exceeds the bounty.",
+    effect: "prepare",
+    input: object({
+        cranker: account("the wallet that signs, pays the fee and receives the bounty"),
+        ...intentRef,
+        fund_accounts: optional(flag("recreate the owner's missing token account at the cranker's cost, only when the bounty covers its rent")),
+    }),
+    output: object({ intent: account(), action: choice(["expire", "close"]), bounty: amount(), prepared: preparedSchema }),
+    run: async ({ transport }, input) => {
+        const { address, intent } = await loadIntent(transport, input.owner, input.nonce);
+        const action = crankAction(intent, await chainTime(transport), input.cranker);
+        if (action === undefined) {
+            throw new AgentRefusal("NothingToCrank", "this intent is still open and not yet expired, was cancelled and pays nothing to this cranker, or is not one this client can read", true);
+        }
+        const cranker = createNoopSigner(input.cranker);
+        const fund = (input.fund_accounts ?? false) ? "covered" : "never";
+        try {
+            const ixs = action === "expire"
+                ? await expiring(transport, cranker, address, intent, fund, true)
+                : await closing(transport, cranker, address, intent, fund);
+            return { intent: address, action, bounty: BigInt(intent.bounty), prepared: preparedView(await prepare(transport, ixs, input.cranker)) };
+        }
+        catch (error) {
+            if (error instanceof CostlyFunding) {
+                throw new AgentRefusal("FundingExceedsBounty", error.message);
+            }
+            if (error instanceof UnfundedAccount) {
+                throw new AgentRefusal("OwnerAccountMissing", OWNER_ACCOUNT_MISSING);
+            }
+            throw error;
+        }
+    },
+});
+//# sourceMappingURL=settle.js.map

package/dist/src/agent/settle.js.map

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

package/dist/src/agent/shapes.d.ts

@@ -0,0 +1,165 @@
+import type { Address } from "@solana/kit";
+import { type Intent, type IntentParams, Kind } from "@intent-engine/core";
+import type { Prepared } from "./prepare.js";
+import { type Infer } from "./schema.js";
+export declare const orderSchema: import("./schema.js").Schema<({
+    kind: "attested";
+} & {
+    amount_in: bigint;
+    min_result: bigint;
+    max_result: bigint;
+    attestor: Address;
+} & {}) | ({
+    kind: "dutch";
+} & {
+    amount_in: bigint;
+    start_out: bigint;
+    end_out: bigint;
+    start_time: bigint;
+    end_time: bigint;
+} & {}) | ({
+    kind: "limit";
+} & {
+    make_amount: bigint;
+    take_amount: bigint;
+} & {}) | ({
+    kind: "swap";
+} & {
+    amount_in: bigint;
+    min_out: bigint;
+} & {})>;
+export type Order = Infer<typeof orderSchema>;
+export declare function paramsOf(order: Order): IntentParams;
+export declare function orderOf(params: IntentParams): Order;
+export declare const KIND_NAMES: {
+    readonly 1: "swap";
+    readonly 2: "limit";
+    readonly 3: "dutch";
+    readonly 4: "attested";
+};
+export declare const KINDS: readonly [Kind.SwapExactIn, Kind.LimitOrder, Kind.DutchAuction, Kind.AttestedResult];
+export declare const partnerSchema: import("./schema.js").Schema<{
+    account: Address;
+    bps: number;
+} & {}>;
+export declare const STATUSES: readonly ["open", "filled", "cancelled", "expired", "filling", "unknown"];
+export declare const intentSchema: import("./schema.js").Schema<{
+    address: Address;
+    owner: Address;
+    input_mint: Address;
+    output_mint: Address;
+    receiver: Address;
+    nonce: bigint;
+    status: "cancelled" | "expired" | "filled" | "filling" | "open" | "unknown";
+    escrowed: bigint;
+    filled: bigint;
+    remaining: bigint;
+    created_at: bigint;
+    expires_at: bigint;
+    order: ({
+        kind: "attested";
+    } & {
+        amount_in: bigint;
+        min_result: bigint;
+        max_result: bigint;
+        attestor: Address;
+    } & {}) | ({
+        kind: "dutch";
+    } & {
+        amount_in: bigint;
+        start_out: bigint;
+        end_out: bigint;
+        start_time: bigint;
+        end_time: bigint;
+    } & {}) | ({
+        kind: "limit";
+    } & {
+        make_amount: bigint;
+        take_amount: bigint;
+    } & {}) | ({
+        kind: "swap";
+    } & {
+        amount_in: bigint;
+        min_out: bigint;
+    } & {}) | null;
+    partner: ({
+        account: Address;
+        bps: number;
+    } & {}) | null;
+    bounty: bigint;
+    mandate: Address | null;
+    agent_fee: bigint;
+    summary: string[];
+} & {}>;
+export type Decimals = {
+    inputDecimals?: number;
+    outputDecimals?: number;
+};
+export declare const SETTLED: ReadonlySet<number>;
+export declare const SETTLED_LINE = "No longer open: its escrow was refunded or paid out, so nothing is locked in it; escrowed only records what was locked at creation";
+export declare function intentView(address: Address, intent: Intent, decimals?: Decimals): {
+    address: Address;
+    owner: Address;
+    input_mint: Address;
+    output_mint: Address;
+    receiver: Address;
+    nonce: bigint;
+    status: string;
+    escrowed: bigint;
+    filled: bigint;
+    remaining: bigint;
+    created_at: bigint;
+    expires_at: bigint;
+    order: ({
+        kind: "attested";
+    } & {
+        amount_in: bigint;
+        min_result: bigint;
+        max_result: bigint;
+        attestor: Address;
+    } & {}) | ({
+        kind: "dutch";
+    } & {
+        amount_in: bigint;
+        start_out: bigint;
+        end_out: bigint;
+        start_time: bigint;
+        end_time: bigint;
+    } & {}) | ({
+        kind: "limit";
+    } & {
+        make_amount: bigint;
+        take_amount: bigint;
+    } & {}) | ({
+        kind: "swap";
+    } & {
+        amount_in: bigint;
+        min_out: bigint;
+    } & {}) | null;
+    partner: {
+        account: Address;
+        bps: number;
+    } | null;
+    bounty: bigint;
+    mandate: Address | null;
+    agent_fee: bigint;
+    summary: string[];
+};
+export declare const preparedSchema: import("./schema.js").Schema<{
+    transaction: string;
+    fee_payer: Address;
+    signers: Address[];
+    last_valid_block_height: bigint;
+    units_consumed: bigint | null;
+    priority_fee_lamports: bigint;
+    logs: string[];
+} & {}>;
+export declare function preparedView(p: Prepared): {
+    transaction: string;
+    fee_payer: Address;
+    signers: Address[];
+    last_valid_block_height: bigint;
+    units_consumed: bigint | null;
+    priority_fee_lamports: bigint;
+    logs: string[];
+};

package/dist/src/agent/shapes.js

@@ -0,0 +1,163 @@
+import { decodeParamsLoose, describeTerms, INTENT_VERSION, Kind, MAX_PARTNER_BPS, NO_MANDATE, IntentStatus, remainingOf, } from "@intent-engine/core";
+import { STATUS } from "../accounts.js";
+import { tokenNames } from "../tokens.js";
+import { account, amount, choice, integer, list, nullable, object, text, time, variants, } from "./schema.js";
+export const orderSchema = variants("kind", {
+    swap: object({
+        amount_in: amount("exact raw units of the input token to sell"),
+        min_out: amount("least raw units of the output token to receive for the whole amount"),
+    }),
+    limit: object({
+        make_amount: amount("raw units of the input token offered; a fill always takes all of it at once"),
+        take_amount: amount("least raw units of the output token wanted for the whole make_amount"),
+    }),
+    dutch: object({
+        amount_in: amount("exact raw units of the input token to sell"),
+        start_out: amount("output wanted at start_time; the requirement falls linearly from here"),
+        end_out: amount("output wanted from end_time on"),
+        start_time: time("unix seconds when the price starts falling"),
+        end_time: time("unix seconds when the price stops falling; at or before the expiry"),
+    }),
+    attested: object({
+        amount_in: amount("exact raw units of the input token to sell"),
+        min_result: amount("least attested result that settles the intent"),
+        max_result: amount("greatest attested result that settles the intent"),
+        attestor: account("the key whose signature alone decides the result"),
+    }),
+}, "what to sell and the least to receive");
+export function paramsOf(order) {
+    switch (order.kind) {
+        case "swap":
+            return { kind: Kind.SwapExactIn, amountIn: order.amount_in, minOut: order.min_out };
+        case "limit":
+            return { kind: Kind.LimitOrder, makeAmount: order.make_amount, takeAmount: order.take_amount };
+        case "dutch":
+            return {
+                kind: Kind.DutchAuction,
+                amountIn: order.amount_in,
+                startOut: order.start_out,
+                endOut: order.end_out,
+                startTs: order.start_time,
+                endTs: order.end_time,
+            };
+        case "attested":
+            return {
+                kind: Kind.AttestedResult,
+                amountIn: order.amount_in,
+                minResult: order.min_result,
+                maxResult: order.max_result,
+                attestor: order.attestor,
+            };
+    }
+}
+export function orderOf(params) {
+    switch (params.kind) {
+        case Kind.SwapExactIn:
+            return { kind: "swap", amount_in: params.amountIn, min_out: params.minOut };
+        case Kind.LimitOrder:
+            return { kind: "limit", make_amount: params.makeAmount, take_amount: params.takeAmount };
+        case Kind.DutchAuction:
+            return {
+                kind: "dutch",
+                amount_in: params.amountIn,
+                start_out: params.startOut,
+                end_out: params.endOut,
+                start_time: params.startTs,
+                end_time: params.endTs,
+            };
+        case Kind.AttestedResult:
+            return {
+                kind: "attested",
+                amount_in: params.amountIn,
+                min_result: params.minResult,
+                max_result: params.maxResult,
+                attestor: params.attestor,
+            };
+    }
+}
+export const KIND_NAMES = { [Kind.SwapExactIn]: "swap", [Kind.LimitOrder]: "limit", [Kind.DutchAuction]: "dutch", [Kind.AttestedResult]: "attested" };
+export const KINDS = [Kind.SwapExactIn, Kind.LimitOrder, Kind.DutchAuction, Kind.AttestedResult];
+export const partnerSchema = object({
+    account: account("the integrator paid the partner fee"),
+    bps: integer(1, MAX_PARTNER_BPS, "partner fee in basis points of the sold amount"),
+}, "an integrator fee taken from the sold amount at fill time");
+export const STATUSES = [...STATUS, "unknown"];
+export const intentSchema = object({
+    address: account(),
+    owner: account(),
+    input_mint: account(),
+    output_mint: account(),
+    receiver: account(),
+    nonce: amount(),
+    status: choice(STATUSES),
+    escrowed: amount("raw input units locked when the intent was created"),
+    filled: amount("raw input units already sold"),
+    remaining: amount("raw input units still for sale; 0 once the intent is no longer open, its escrow refunded or paid out"),
+    created_at: time(),
+    expires_at: time(),
+    order: nullable(orderSchema),
+    partner: nullable(partnerSchema),
+    bounty: amount("lamports paid to whoever expires or closes the intent"),
+    mandate: nullable(account("the mandate an agent created this under; fills stop once it is revoked")),
+    agent_fee: amount("raw input units held for the agent that created it, paid only when it fills"),
+    summary: list(text(), 16, "the terms in plain words"),
+});
+function termsOf(intent, raw) {
+    if (intent.version !== INTENT_VERSION) {
+        return `unsupported intent version ${intent.version}`;
+    }
+    const params = decodeParamsLoose(intent.kind, raw);
+    return "unknown" in params ? params.reason : params;
+}
+export const SETTLED = new Set([IntentStatus.Filled, IntentStatus.Cancelled, IntentStatus.Expired]);
+export const SETTLED_LINE = "No longer open: its escrow was refunded or paid out, so nothing is locked in it; escrowed only records what was locked at creation";
+export function intentView(address, intent, decimals = {}) {
+    const raw = Uint8Array.from(intent.params);
+    const params = termsOf(intent, raw);
+    return {
+        address,
+        owner: intent.owner,
+        input_mint: intent.inputMint,
+        output_mint: intent.outputMint,
+        receiver: intent.receiver,
+        nonce: intent.nonce,
+        status: STATUS[intent.status] ?? "unknown",
+        escrowed: intent.escrowed,
+        filled: intent.filled,
+        remaining: intent.status === IntentStatus.Open ? remainingOf(intent) : 0n,
+        created_at: intent.createdAt,
+        expires_at: intent.expiresAt,
+        order: typeof params === "string" ? null : orderOf(params),
+        partner: intent.partnerBps === 0 ? null : { account: intent.partner, bps: intent.partnerBps },
+        bounty: BigInt(intent.bounty),
+        mandate: intent.mandate === NO_MANDATE ? null : intent.mandate,
+        agent_fee: intent.agentFee,
+        summary: [
+            ...(typeof params === "string"
+                ? [`Unreadable terms: ${params}`]
+                : describeTerms({ kind: params.kind, params: raw, inputMint: intent.inputMint, outputMint: intent.outputMint }, { ...decimals, ...tokenNames(intent.inputMint, intent.outputMint) })),
+            ...(SETTLED.has(intent.status) ? [SETTLED_LINE] : []),
+        ],
+    };
+}
+export const preparedSchema = object({
+    transaction: text("base64 wire transaction with empty signature slots; sign it with the wallets in signers"),
+    fee_payer: account(),
+    signers: list(account(), 4, "every wallet that must sign before sending"),
+    last_valid_block_height: amount("send before the cluster passes this block height"),
+    units_consumed: nullable(amount("compute units the simulation used")),
+    priority_fee_lamports: amount("lamports of priority fee the fee payer pays on top of the network fee"),
+    logs: list(text(), 16, "the last simulation log lines"),
+}, "an unsigned transaction that simulated successfully");
+export function preparedView(p) {
+    return {
+        transaction: p.transaction,
+        fee_payer: p.feePayer,
+        signers: p.signers,
+        last_valid_block_height: p.lastValidBlockHeight,
+        units_consumed: p.unitsConsumed,
+        priority_fee_lamports: p.priorityLamports,
+        logs: p.logs,
+    };
+}
+//# sourceMappingURL=shapes.js.map

package/dist/src/agent/shapes.js.map

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

package/dist/src/agent/signed.d.ts

@@ -0,0 +1,21 @@
+import { type Address, type Instruction, type SignatureBytes } from "@solana/kit";
+import { type Intent, type SignedIntentFields } from "@intent-engine/core";
+import { type Transport } from "../transport.js";
+import { type Relay } from "./relay.js";
+export declare const DEFAULT_SUBMIT_WITHIN: number;
+export declare const MAX_SUBMIT_WITHIN: number;
+export declare const SIGNATURE_PATTERN = "^[1-9A-HJ-NP-Za-km-z]{64,88}$";
+export declare function relayFloor(relay: Relay, mint: Address): bigint;
+export declare const RELAY_TOO_LARGE = "this server's relayer cannot fit these signed terms in one Solana transaction; drop the partner fee or use a relayer that adds no priority fee";
+export declare function relayFits(transport: Transport, relay: Relay, instructions: readonly Instruction[]): Promise<boolean>;
+export declare function offeredFee(floor: bigint, offered: bigint | undefined): bigint;
+export declare const prepareSignedIntent: import("./actions.js").AnyAction;
+export declare const submitSignedIntent: import("./actions.js").AnyAction;
+export declare function paying<T>(paid: {
+    any: boolean;
+}, sending: Promise<T>): Promise<T>;
+export declare const repriced: (admitted: bigint, now: bigint) => string;
+export declare function refuseRepricing(admitted: bigint, now: bigint): void;
+export declare const previewSignedIntent: import("./actions.js").AnyAction;
+export declare function sameTerms(stored: Intent, fields: SignedIntentFields): boolean;
+export declare function signatureBytes(text: string): SignatureBytes;