@intent-engine/cli 0.1.22 → 0.1.26

package/dist/src/agent/sales.js

@@ -0,0 +1,248 @@
+import { randomUUID } from "node:crypto";
+import { link, mkdir, open, readdir, readFile, rename, rm, stat } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { AgentRefusal } from "./problems.js";
+export const LOCK_WAIT_MS = 5_000;
+export const LOCK_STALE_MS = 30_000;
+export const LOCK_POLL_MS = 20;
+export const BUSY_ATTEMPTS = 10;
+export const BUSY_BACKOFF_MS = 10;
+export const BUSY_BACKOFF_CAP_MS = 200;
+export const LEFTOVER_MS = 60_000;
+export const salesPath = (keypair) => `${keypair}.sales.json`;
+export const salesBroken = (path) => `${path} is not a sale record this server wrote; delete it to reset the wallet's hourly count`;
+export const WALLET_BUSY = "another server using this wallet is recording a sale right now; call again in a moment";
+function parsed(text, path) {
+    let rows;
+    try {
+        rows = JSON.parse(text);
+    }
+    catch {
+        throw new Error(salesBroken(path));
+    }
+    if (!Array.isArray(rows)) {
+        throw new Error(salesBroken(path));
+    }
+    return rows.map((row) => {
+        if (typeof row?.id !== "string" || typeof row.mint !== "string" || typeof row.at !== "string" || typeof row.amount !== "string") {
+            throw new Error(salesBroken(path));
+        }
+        try {
+            return { id: row.id, mint: row.mint, at: BigInt(row.at), amount: BigInt(row.amount) };
+        }
+        catch {
+            throw new Error(salesBroken(path));
+        }
+    });
+}
+const codeOf = (error) => error?.code;
+const missing = (error) => codeOf(error) === "ENOENT";
+const taken = (error) => codeOf(error) === "EEXIST";
+const BUSY_CODES = new Set(["EPERM", "EACCES", "EBUSY"]);
+const busy = (error) => BUSY_CODES.has(codeOf(error));
+const UNLINKABLE_CODES = new Set(["EPERM", "ENOTSUP", "EOPNOTSUPP", "EXDEV"]);
+const unlinkable = (error) => UNLINKABLE_CODES.has(codeOf(error)) || (process.platform === "win32" && !taken(error) && !busy(error));
+const linkless = new Set();
+const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function retried(work) {
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await work();
+        }
+        catch (error) {
+            if (!busy(error) || attempt >= BUSY_ATTEMPTS) {
+                throw error;
+            }
+            await pause(Math.min(BUSY_BACKOFF_MS * 2 ** (attempt - 1), BUSY_BACKOFF_CAP_MS));
+        }
+    }
+}
+async function readSales(file, path) {
+    try {
+        return parsed(await retried(() => readFile(file, "utf8")), path);
+    }
+    catch (error) {
+        if (missing(error)) {
+            return [];
+        }
+        throw error;
+    }
+}
+async function written(file, text) {
+    const handle = await open(file, "wx", 0o600);
+    try {
+        await handle.writeFile(text);
+        await handle.sync();
+    }
+    catch (error) {
+        await handle.close().catch(() => undefined);
+        await rm(file, { force: true }).catch(() => undefined);
+        throw error;
+    }
+    await handle.close();
+}
+async function sweep(file) {
+    const folder = dirname(file);
+    const prefix = `${basename(file)}.`;
+    const names = await readdir(folder).catch(() => []);
+    const cutoff = Date.now() - LEFTOVER_MS;
+    await Promise.all(names
+        .filter((name) => name.startsWith(prefix) && name.endsWith(".tmp"))
+        .map(async (name) => {
+        const leftover = join(folder, name);
+        const seen = await stat(leftover).catch(() => null);
+        if (seen !== null && seen.mtimeMs < cutoff) {
+            await rm(leftover, { force: true }).catch(() => undefined);
+        }
+    }));
+}
+async function writeSales(file, sales, files) {
+    await sweep(file);
+    const rows = sales.map((s) => ({ id: s.id, mint: s.mint, at: s.at.toString(), amount: s.amount.toString() }));
+    const temporary = `${file}.${randomUUID()}.tmp`;
+    await written(temporary, JSON.stringify(rows));
+    try {
+        await retried(() => files.rename(temporary, file));
+    }
+    catch (error) {
+        await rm(temporary, { force: true }).catch(() => undefined);
+        throw error;
+    }
+}
+async function ownerOf(lock) {
+    try {
+        return await retried(() => readFile(lock, "utf8"));
+    }
+    catch (error) {
+        if (missing(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+async function linksFail(linker, temporary, lock) {
+    const probe = `${lock}.${randomUUID()}.tmp`;
+    try {
+        await linker(temporary, probe);
+    }
+    catch {
+        return true;
+    }
+    await rm(probe, { force: true }).catch(() => undefined);
+    return false;
+}
+async function created(lock, token) {
+    try {
+        await written(lock, token);
+    }
+    catch (error) {
+        if (taken(error) || busy(error)) {
+            return false;
+        }
+        throw error;
+    }
+    return true;
+}
+async function linked(lock, token, linker) {
+    const temporary = `${lock}.${randomUUID()}.tmp`;
+    await written(temporary, token);
+    try {
+        await linker(temporary, lock);
+    }
+    catch (error) {
+        if (taken(error)) {
+            return false;
+        }
+        if (unlinkable(error) && (await linksFail(linker, temporary, lock))) {
+            return null;
+        }
+        if (busy(error)) {
+            return false;
+        }
+        throw error;
+    }
+    finally {
+        await rm(temporary, { force: true }).catch(() => undefined);
+    }
+    return true;
+}
+async function claim(lock, token, linker) {
+    const folder = dirname(lock);
+    let placed = linkless.has(folder) ? null : await linked(lock, token, linker);
+    if (placed === null) {
+        linkless.add(folder);
+        placed = await created(lock, token);
+    }
+    return placed && (await ownerOf(lock)) === token;
+}
+async function release(lock, token) {
+    if ((await ownerOf(lock)) === token) {
+        await retried(() => rm(lock, { force: true }));
+    }
+}
+const stale = async (path) => {
+    const seen = await stat(path).catch(() => null);
+    return seen !== null && Date.now() - seen.mtimeMs > LOCK_STALE_MS;
+};
+async function takeOver(lock, token, linker) {
+    const old = await ownerOf(lock);
+    if (old === null) {
+        return false;
+    }
+    const breaker = `${lock}.break`;
+    if (!(await claim(breaker, token, linker))) {
+        if (await stale(breaker)) {
+            await rm(breaker, { force: true });
+        }
+        return false;
+    }
+    try {
+        if ((await ownerOf(lock)) !== old || !(await stale(lock))) {
+            return false;
+        }
+        await retried(() => rm(lock, { force: true }));
+        return await claim(lock, token, linker);
+    }
+    finally {
+        await release(breaker, token).catch(() => undefined);
+    }
+}
+async function locked(file, linker, work) {
+    const lock = `${file}.lock`;
+    const token = randomUUID();
+    await mkdir(dirname(file), { recursive: true, mode: 0o700 });
+    const deadline = Date.now() + LOCK_WAIT_MS;
+    for (;;) {
+        if (await claim(lock, token, linker)) {
+            break;
+        }
+        if ((await stale(lock)) && (await takeOver(lock, token, linker))) {
+            break;
+        }
+        if (Date.now() >= deadline) {
+            throw new AgentRefusal("WalletBusy", WALLET_BUSY);
+        }
+        await pause(LOCK_POLL_MS);
+    }
+    try {
+        return await work();
+    }
+    finally {
+        await release(lock, token).catch(() => undefined);
+    }
+}
+export function fileSales(locate = (path) => path, files = { rename }) {
+    const linker = files.link === undefined ? link : files.link.bind(files);
+    return {
+        read: (path) => readSales(locate(path), path),
+        update: (path, change) => {
+            const file = locate(path);
+            return locked(file, linker, async () => {
+                const { sales, value } = change(await readSales(file, path));
+                await writeSales(file, sales, files);
+                return value;
+            });
+        },
+    };
+}
+//# sourceMappingURL=sales.js.map

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

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

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

@@ -0,0 +1 @@
+export declare const prepareSignedIntent: import("./actions.js").AnyAction;

package/dist/src/agent/signed-prepare.js

@@ -0,0 +1,141 @@
+import { createNoopSigner, getBase64Decoder } from "@solana/kit";
+import { buildApproveDelegate, buildEd25519Instruction, describeSignedIntent, escrowAmount, formatAmount, MEMO_URL_RULE, signedIntentMessage, validate, } from "@intent-engine/core";
+import { chainTime, clusterDomain, initUserIfMissing, loadConfig, loadUser, mintOf, tokenAccountIfMissing, } from "@intent-engine/client";
+import { define } from "./actions.js";
+import { tool } from "./names.js";
+import { expiryOf, termsInput, termsOutput, warningsOf } from "./create.js";
+import { pickNonce, raiseAllowance, setupLines, unusedIntent } from "./owner.js";
+import { prepare } from "./prepare.js";
+import { AgentRefusal } from "./problems.js";
+import { SIGNATURE_FEE } from "./budget.js";
+import { refuseCostlyTerms, refuseLongRelay } from "./relay.js";
+import { claim, claimedBy } from "./claims.js";
+import { paramsOf, preparedSchema, preparedView } from "./shapes.js";
+import { tokenNames } from "../tokens.js";
+import { account, amount, integer, object, optional, text } from "./schema.js";
+import { DEFAULT_SUBMIT_WITHIN, fieldsOf, MAX_SUBMIT_WITHIN, published, publishedUrl, publishesLine, signedTerms, SPEC_URL_UNSIGNED, } from "./signed-terms.js";
+import { offeredFee, RELAY_TOO_LARGE, relayCreate, relayFits, relayFloor, SPEC_URL_TOO_LONG } from "./signed-relay.js";
+export const prepareSignedIntent = define({
+    name: tool("prepare_signed_intent"),
+    title: "Prepare a relayer-submitted signed intent",
+    description: `Build an intent the owner authorises by signing a message off-chain, so a relayer creates it on chain and pays its rent and fees. Steps: (1) the owner signs and sends the returned setup transaction; it registers them, creates the receiving token account and raises the engine's spending allowance on the input token by this intent's escrow plus any relayer fee, and it is the only part that costs the owner SOL: its network fee, which the summary gives in lamports, plus rent for any account it creates; (2) the owner signs message with their wallet's sign-message; (3) pass submit unchanged plus that base58 signature to ${tool("submit_signed_intent")}. When this server runs a relayer, it relays only the input tokens it lists a fee for, the message includes that fee, and the owner pays it in that token as the intent is created; it refuses, before the owner signs or pays anything, an expiry beyond that relayer's longest or a create fee and crank bounty above what it pays; without --relayer this server can prepare but not submit. Read summary and warnings before the owner signs anything.`,
+    effect: "prepare",
+    input: object({
+        ...termsInput,
+        owner: account("the wallet that signs the message off-chain; it pays only the setup transaction's network fee and any rent named in the summary, in SOL"),
+        submit_within: optional(integer(60, MAX_SUBMIT_WITHIN, `seconds the relayer has to submit the signature; default ${DEFAULT_SUBMIT_WITHIN}`)),
+        relayer_fee: optional(amount("raw input units offered to whoever submits; default and minimum is this server's relayer fee for the input token")),
+        spec_url: optional(text(`where the acceptance spec of an attested order with spec_hash is published, ${MEMO_URL_RULE}; passed on in submit for the relayer to record in a memo it signs with the create, so workers find it. It is not part of what the owner signs`)),
+    }),
+    output: object({
+        ...termsOutput,
+        message: text("base64 bytes the owner signs with sign-message"),
+        digest: text("sha-256 of the signed terms; the wallet shows the same value"),
+        submit: object(signedTerms, `pass these unchanged, plus the signature, to ${tool("submit_signed_intent")}`),
+        setup: preparedSchema,
+    }),
+    run: async ({ transport, claims, relay }, input, call) => {
+        const now = await chainTime(transport);
+        const expiresAt = expiryOf(input, now);
+        const params = validate(paramsOf(input.order));
+        const specUrl = await publishedUrl(transport, params, input.spec_url);
+        if (relay !== undefined) {
+            refuseLongRelay(relay, expiresAt, now);
+            const { config } = await loadConfig(transport);
+            refuseCostlyTerms(relay, BigInt(config.createFee) + BigInt(config.crankBounty));
+        }
+        const user = await loadUser(transport, input.owner);
+        const outputToken = await mintOf(transport, input.output_mint);
+        if (input.nonce !== undefined) {
+            await unusedIntent(transport, input.owner, input.nonce);
+        }
+        const terms = {
+            owner: input.owner,
+            input_mint: input.input_mint,
+            output_mint: input.output_mint,
+            order: input.order,
+            expires_at: expiresAt,
+            nonce: pickNonce(user, input.nonce, claimedBy(claims, input.owner, now)),
+            submit_by: now + BigInt(input.submit_within ?? DEFAULT_SUBMIT_WITHIN),
+            epoch: user?.epoch ?? 0n,
+            relayer_fee: offeredFee(relay === undefined ? 0n : relayFloor(relay, input.input_mint), input.relayer_fee),
+            ...(input.partner === undefined ? {} : { partner: input.partner }),
+            ...(specUrl === undefined ? {} : { spec_url: specUrl }),
+        };
+        claim(claims, call, input.owner, terms.nonce, terms.submit_by, now);
+        const { config, inputToken, fields } = await fieldsOf(transport, terms, params, outputToken.tokenProgram);
+        if (relay !== undefined) {
+            const placeholder = buildEd25519Instruction({
+                publicKey: input.owner,
+                signature: new Uint8Array(64),
+                message: await signedIntentMessage(fields),
+            });
+            const create = await relayCreate(terms, relay, config, params, {
+                input: inputToken.tokenProgram,
+                output: outputToken.tokenProgram,
+            });
+            if (!(await relayFits(transport, relay, [placeholder, create, ...published(relay.signer, specUrl)]))) {
+                const memoOnly = specUrl !== undefined && (await relayFits(transport, relay, [placeholder, create]));
+                throw new AgentRefusal("RelayTooLarge", memoOnly ? SPEC_URL_TOO_LONG : RELAY_TOO_LARGE);
+            }
+        }
+        const description = await describeSignedIntent(fields, {
+            now,
+            currentEpoch: terms.epoch,
+            expectedDomain: await clusterDomain(transport),
+            outputTokenProgram: outputToken.tokenProgram,
+            inputDecimals: inputToken.decimals,
+            outputDecimals: outputToken.decimals,
+            ...tokenNames(fields.inputMint, fields.outputMint),
+        });
+        const escrow = escrowAmount(params);
+        const allowance = await raiseAllowance(transport, input.owner, fields.ownerInput, escrow + terms.relayer_fee);
+        const receiver = await tokenAccountIfMissing(transport, createNoopSigner(input.owner), input.owner, input.output_mint, outputToken.tokenProgram);
+        const approve = await buildApproveDelegate({
+            owner: createNoopSigner(input.owner),
+            mint: input.input_mint,
+            tokenProgram: inputToken.tokenProgram,
+            amount: allowance.after,
+            decimals: inputToken.decimals,
+        });
+        const register = await initUserIfMissing(user, input.owner);
+        const setup = [...register, ...receiver.create, approve];
+        const intent = await unusedIntent(transport, input.owner, terms.nonce);
+        const disclosed = setupLines({
+            registers: register.length > 0,
+            creates: receiver.create.length > 0 ? [input.output_mint] : [],
+            allowance,
+            decimals: inputToken.decimals,
+        });
+        const ready = await prepare(transport, setup, input.owner);
+        const prepared = preparedView(ready);
+        const setupFee = SIGNATURE_FEE * BigInt(ready.signers.length) + ready.priorityLamports;
+        return {
+            intent,
+            nonce: terms.nonce,
+            expires_at: expiresAt,
+            escrow,
+            summary: [
+                ...description.lines,
+                terms.relayer_fee === 0n
+                    ? `Cost to you: no relayer fee; only ${setupFee} lamports of SOL for the setup transaction's network fee, once`
+                    : `Cost to you: ${formatAmount(terms.relayer_fee, inputToken.decimals)} of ${input.input_mint} to the relayer, plus ${setupFee} lamports of SOL for the setup transaction's network fee, once`,
+                ...(specUrl === undefined ? [] : [publishesLine(specUrl)]),
+                ...disclosed.lines,
+            ],
+            warnings: [
+                ...new Set([
+                    ...warningsOf(params, expiresAt, now, inputToken.scaled || outputToken.scaled),
+                    ...description.warnings,
+                    ...disclosed.warnings,
+                    ...(specUrl === undefined ? [] : [SPEC_URL_UNSIGNED]),
+                ]),
+            ],
+            message: getBase64Decoder().decode(await signedIntentMessage(fields)),
+            digest: description.digest,
+            submit: terms,
+            setup: prepared,
+        };
+    },
+});
+//# sourceMappingURL=signed-prepare.js.map

package/dist/src/agent/signed-prepare.js.map

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

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

@@ -0,0 +1,25 @@
+import { type Address, type Instruction } from "@solana/kit";
+import { type IntentParams } from "@intent-engine/core";
+import { type Transport } from "@intent-engine/client";
+import { type Prepared } from "./prepare.js";
+import type { Relay } from "./relay.js";
+import type { SignedTerms } from "./signed-terms.js";
+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 relayCreate(input: SignedTerms, relay: Relay, config: {
+    feeRecipient: Address;
+    createFee: number;
+    crankBounty: number;
+}, params: IntentParams, tokenPrograms: {
+    input: Address;
+    output: Address;
+}): Promise<Instruction>;
+export declare function relayFits(transport: Transport, relay: Relay, instructions: readonly Instruction[]): Promise<boolean>;
+export declare const SPEC_URL_TOO_LONG = "this server's relayer cannot fit the spec url's memo with these signed terms in one Solana transaction; give a shorter spec_url or leave it out";
+export declare const preparedFits: (prepared: Prepared) => boolean;
+export declare function offeredFee(floor: bigint, offered: bigint | undefined): bigint;
+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;

package/dist/src/agent/signed-relay.js

@@ -0,0 +1,68 @@
+import { getBase64Encoder } from "@solana/kit";
+import { buildCreateIntentSigned } from "@intent-engine/core";
+import { bytesFit } from "@intent-engine/solver";
+import { Charged } from "@intent-engine/client";
+import { transactionSize } from "./prepare.js";
+import { AgentRefusal } from "./problems.js";
+export function relayFloor(relay, mint) {
+    const floor = relay.fees.get(mint);
+    if (floor === undefined) {
+        throw new AgentRefusal("RelayMintNotAccepted", `this server's relayer does not relay intents selling ${mint}; it relays only ${[...relay.fees.keys()].join(", ")}`);
+    }
+    return floor;
+}
+export 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 async function relayCreate(input, relay, config, params, tokenPrograms) {
+    return buildCreateIntentSigned({
+        payer: relay.signer,
+        owner: input.owner,
+        treasury: config.feeRecipient,
+        maxCreateFee: config.createFee,
+        maxBounty: config.crankBounty,
+        nonce: input.nonce,
+        params,
+        expiresAt: input.expires_at,
+        ...(input.partner === undefined ? {} : { partner: { key: input.partner.account, bps: input.partner.bps } }),
+        inputMint: input.input_mint,
+        outputMint: input.output_mint,
+        inputTokenProgram: tokenPrograms.input,
+        outputTokenProgram: tokenPrograms.output,
+        submitBy: input.submit_by,
+        relayerFee: input.relayer_fee,
+    });
+}
+export async function relayFits(transport, relay, instructions) {
+    const budgeted = await transport.budget(instructions, relay.signer.address);
+    return bytesFit(await transactionSize(transport, budgeted, relay.signer.address));
+}
+export const SPEC_URL_TOO_LONG = "this server's relayer cannot fit the spec url's memo with these signed terms in one Solana transaction; give a shorter spec_url or leave it out";
+export const preparedFits = (prepared) => bytesFit(getBase64Encoder().encode(prepared.transaction).length);
+export function offeredFee(floor, offered) {
+    if (offered === undefined) {
+        return floor;
+    }
+    if (offered < floor) {
+        throw new AgentRefusal("RelayFeeTooLow", `this server's relayer charges ${floor} raw units of the input token; offer at least that or leave relayer_fee out`);
+    }
+    return offered;
+}
+export async function paying(paid, sending) {
+    try {
+        const result = await sending;
+        paid.any = true;
+        return result;
+    }
+    catch (error) {
+        if (error instanceof Charged) {
+            paid.any = true;
+        }
+        throw error;
+    }
+}
+export const repriced = (admitted, now) => `the priority fee rose from the admitted ${admitted} to ${now} lamports while relaying; ask again later`;
+export function refuseRepricing(admitted, now) {
+    if (now > admitted) {
+        throw new AgentRefusal("RelayTooCostly", repriced(admitted, now));
+    }
+}
+//# sourceMappingURL=signed-relay.js.map

package/dist/src/agent/signed-relay.js.map

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

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

@@ -0,0 +1,2 @@
+export declare const submitSignedIntent: import("./actions.js").AnyAction;
+export declare const previewSignedIntent: import("./actions.js").AnyAction;