@intent-engine/cli 0.1.22 → 0.1.26

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

@@ -0,0 +1,137 @@
+import { getPublicKeyFromAddress, verifySignature } from "@solana/kit";
+import { buildEd25519Instruction, describeSignedIntent, formatAmount, findIntentPda, getIntentDecoder, signedIntentMessage, validate, } from "@intent-engine/core";
+import { chainTime, clusterDomain, createdAccount, loadUser, mintOf, tokenAccountIfMissing } from "@intent-engine/client";
+import { define } from "./actions.js";
+import { tool } from "./names.js";
+import { prepare } from "./prepare.js";
+import { AgentRefusal } from "./problems.js";
+import { createCost, rentFor, SIGNATURE_FEE, TOKEN_ACCOUNT_RENT_BYTES } from "./budget.js";
+import { admitRelay } from "./relay.js";
+import { enter } from "./claims.js";
+import { paramsOf } from "./shapes.js";
+import { tokenNames } from "../tokens.js";
+import { account, amount, integer, list, nullable, object, text } from "./schema.js";
+import { fieldsOf, published, publishedUrl, publishesLine, sameTerms, signatureBytes, signedTerms, SPEC_URL_UNSIGNED, } from "./signed-terms.js";
+import { paying, preparedFits, RELAY_TOO_LARGE, relayCreate, relayFloor, refuseRepricing, SPEC_URL_TOO_LONG, } from "./signed-relay.js";
+export const submitSignedIntent = define({
+    name: tool("submit_signed_intent"),
+    title: "Submit a signed intent",
+    description: `Relay an owner's signed intent: the relayer key this server was started with (--relayer) pays the fee and creates the intent on chain, within the relayer's limits: accepted input tokens and their minimum fee, lamport cost per intent and per hour, expiry, transaction size and intents per owner per hour. Pass the submit object from ${tool("prepare_signed_intent")} unchanged plus the owner's base58 signature of its message; ${tool("preview_signed_intent")} checks the same input first without sending. When submit carries a spec_url, the relayer also records it in a memo it signs with the create, so ${tool("find_jobs")} lists it; that url is not part of the owner's signature. Calling again after success returns the same intent without sending anything.`,
+    effect: "submit",
+    input: object({ ...signedTerms, signature: text("the owner's base58 Ed25519 signature of the message") }),
+    output: object({ intent: account(), signature: nullable(text("the relayed transaction's signature; null if it already existed")) }),
+    run: async ({ transport, relay, claims }, input, call) => {
+        if (relay === undefined) {
+            throw new AgentRefusal("RelayerNotConfigured", "this server has no relayer key; start it with --relayer to submit signed intents");
+        }
+        const leave = enter(claims, `${input.owner}:${input.nonce}`);
+        try {
+            return await relaySigned(transport, relay, input, call);
+        }
+        finally {
+            leave();
+        }
+    },
+});
+async function relaySigned(transport, relay, input, call) {
+    const params = validate(paramsOf(input.order));
+    const specUrl = await publishedUrl(transport, params, input.spec_url);
+    const outputToken = await mintOf(transport, input.output_mint);
+    const { config, inputToken, fields } = await fieldsOf(transport, input, params, outputToken.tokenProgram);
+    const [intent] = await findIntentPda({ owner: input.owner, nonce: input.nonce });
+    const existing = await createdAccount(transport, intent);
+    if (existing !== null) {
+        if (!sameTerms(getIntentDecoder().decode(existing.data), fields)) {
+            throw new AgentRefusal("NonceTaken", "a different intent already uses this owner's nonce; these signed terms can never be submitted");
+        }
+        return { intent, signature: null };
+    }
+    const floor = relayFloor(relay, input.input_mint);
+    if (input.relayer_fee < floor) {
+        throw new AgentRefusal("RelayFeeTooLow", `this relayer charges ${floor} raw units of ${input.input_mint} per intent; prepare and sign the intent again on this server`);
+    }
+    const message = await signedIntentMessage(fields);
+    const signature = signatureBytes(input.signature);
+    if (!(await verifySignature(await getPublicKeyFromAddress(input.owner), signature, message))) {
+        throw new AgentRefusal("SignatureInvalid", `the signature is not the owner's signature of these exact terms; sign the message from ${tool("prepare_signed_intent")} again`);
+    }
+    const feeAccount = input.relayer_fee === 0n
+        ? { create: [] }
+        : await tokenAccountIfMissing(transport, relay.signer, relay.signer.address, input.input_mint, inputToken.tokenProgram);
+    const relayed = [
+        buildEd25519Instruction({ publicKey: input.owner, signature, message }),
+        await relayCreate(input, relay, config, params, { input: inputToken.tokenProgram, output: outputToken.tokenProgram }),
+        ...published(relay.signer, specUrl),
+    ];
+    const now = await chainTime(transport);
+    let prepared = await prepare(transport, [...feeAccount.create, ...relayed], relay.signer.address);
+    const split = feeAccount.create.length !== 0 && !preparedFits(prepared);
+    const ticket = admitRelay(relay, input.owner, BigInt(config.createFee) + BigInt(config.crankBounty) + prepared.priorityLamports, createCost(config) +
+        prepared.priorityLamports +
+        (feeAccount.create.length > 0 ? rentFor(TOKEN_ACCOUNT_RENT_BYTES) : 0n) +
+        (split ? SIGNATURE_FEE + prepared.priorityLamports : 0n), input.expires_at, now);
+    const paid = { any: false };
+    call.undo.push(() => {
+        if (!paid.any) {
+            ticket.cancel();
+        }
+    });
+    const admitted = prepared.priorityLamports;
+    if (split) {
+        await paying(paid, transport.send(feeAccount.create, relay.signer));
+        prepared = await prepare(transport, relayed, relay.signer.address);
+        refuseRepricing(admitted, prepared.priorityLamports);
+    }
+    if (!preparedFits(prepared)) {
+        throw new AgentRefusal("RelayTooLarge", specUrl === undefined ? RELAY_TOO_LARGE : SPEC_URL_TOO_LONG);
+    }
+    return { intent, signature: await paying(paid, transport.send(prepared.instructions, relay.signer)) };
+}
+export const previewSignedIntent = define({
+    name: tool("preview_signed_intent"),
+    title: "Check a signed intent before relaying it",
+    description: `Verify an owner's signature over signed terms and describe what relaying them creates, without sending anything.`,
+    effect: "read",
+    input: object({ ...signedTerms, signature: text("the owner's base58 Ed25519 signature of the message") }),
+    output: object({
+        intent: account(),
+        exists: integer(0, 1, "1 if the intent is already on chain, else 0"),
+        relayer_fee: amount("raw input-token units the relayer receives"),
+        summary: list(text(), 32, "what relaying creates"),
+        warnings: list(text(), 16, "anything to check before relaying"),
+    }),
+    run: async ({ transport }, input) => {
+        const params = validate(paramsOf(input.order));
+        const specUrl = await publishedUrl(transport, params, input.spec_url);
+        const outputToken = await mintOf(transport, input.output_mint);
+        const { config, inputToken, fields } = await fieldsOf(transport, input, params, outputToken.tokenProgram);
+        const message = await signedIntentMessage(fields);
+        if (!(await verifySignature(await getPublicKeyFromAddress(input.owner), signatureBytes(input.signature), message))) {
+            throw new AgentRefusal("SignatureInvalid", "the signature is not the owner's signature of these exact terms");
+        }
+        const [intent] = await findIntentPda({ owner: input.owner, nonce: input.nonce });
+        const exists = (await createdAccount(transport, intent)) !== null;
+        const user = await loadUser(transport, input.owner);
+        const description = await describeSignedIntent(fields, {
+            now: await chainTime(transport),
+            currentEpoch: user?.epoch ?? 0n,
+            expectedDomain: await clusterDomain(transport),
+            outputTokenProgram: outputToken.tokenProgram,
+            inputDecimals: inputToken.decimals,
+            outputDecimals: outputToken.decimals,
+            ...tokenNames(fields.inputMint, fields.outputMint),
+        });
+        return {
+            intent,
+            exists: exists ? 1 : 0,
+            relayer_fee: input.relayer_fee,
+            summary: [
+                ...description.lines,
+                `Relaying costs you ${createCost(config)} lamports in create fee, crank bounty, rent and signature fee, plus any priority fee; you receive ${formatAmount(input.relayer_fee, inputToken.decimals)} of ${input.input_mint}`,
+                ...(specUrl === undefined ? [] : [publishesLine(specUrl)]),
+            ],
+            warnings: [...description.warnings, ...(specUrl === undefined ? [] : [SPEC_URL_UNSIGNED])],
+        };
+    },
+});
+//# sourceMappingURL=signed-submit.js.map

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

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

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

@@ -0,0 +1,85 @@
+import { type Address, type Instruction, type SignatureBytes, type TransactionSigner } from "@solana/kit";
+import { type Intent, type IntentParams, type SignedIntentFields } from "@intent-engine/core";
+import { type Transport } from "@intent-engine/client";
+import { type Order } from "./shapes.js";
+export declare const DEFAULT_SUBMIT_WITHIN: number;
+export declare const MAX_SUBMIT_WITHIN: number;
+export declare const signedTerms: {
+    owner: import("./schema.js").Schema<Address>;
+    input_mint: import("./schema.js").Schema<Address>;
+    output_mint: import("./schema.js").Schema<Address>;
+    order: import("./schema.js").Schema<({
+        kind: "attested";
+    } & {
+        amount_in: bigint;
+        min_result: bigint;
+        max_result: bigint;
+        attestor: Address;
+    } & {
+        spec_hash?: string;
+        judge_fee?: bigint;
+    }) | ({
+        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;
+    } & {})>;
+    expires_at: import("./schema.js").Schema<bigint>;
+    nonce: import("./schema.js").Schema<bigint>;
+    submit_by: import("./schema.js").Schema<bigint>;
+    epoch: import("./schema.js").Schema<bigint>;
+    relayer_fee: import("./schema.js").Schema<bigint>;
+    partner: {
+        optional: import("./schema.js").Schema<{
+            account: Address;
+            bps: number;
+        } & {}>;
+    };
+    spec_url: {
+        optional: import("./schema.js").Schema<string>;
+    };
+};
+export type SignedTerms = {
+    owner: Address;
+    input_mint: Address;
+    output_mint: Address;
+    order: Order;
+    expires_at: bigint;
+    nonce: bigint;
+    submit_by: bigint;
+    epoch: bigint;
+    relayer_fee: bigint;
+    partner?: {
+        account: Address;
+        bps: number;
+    };
+    spec_url?: string;
+};
+export declare const SPEC_URL_UNSIGNED: string;
+export declare const publishesLine: (url: string) => string;
+export declare function publishedUrl(transport: Transport, params: IntentParams, url: string | undefined): Promise<string | undefined>;
+export declare const published: (signer: TransactionSigner, url: string | undefined) => Instruction[];
+export declare function fieldsOf(transport: Transport, t: SignedTerms, params: IntentParams, outputTokenProgram: Address): Promise<{
+    config: import("@intent-engine/core").Config;
+    inputToken: {
+        tokenProgram: Address;
+        decimals: number;
+        scaled: boolean;
+    };
+    fields: SignedIntentFields;
+}>;
+export declare function sameTerms(stored: Intent, fields: SignedIntentFields): boolean;
+export declare function signatureBytes(text: string): SignatureBytes;

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

@@ -0,0 +1,84 @@
+import { getBase58Encoder } from "@solana/kit";
+import { createExt, encodeParams, findAssociatedTokenAddress, isMemoUrl, Kind, MEMO_URL_RULE, partnerOf, specMemo, } from "@intent-engine/core";
+import { loadConfig, memoInstruction, mintOf, plainHttpOnPublic } from "@intent-engine/client";
+import { tool } from "./names.js";
+import { SPEC_URL_PLAIN } from "./create.js";
+import { AgentRefusal } from "./problems.js";
+import { orderSchema, partnerSchema } from "./shapes.js";
+import { account, amount, InvalidInput, optional, text, time } from "./schema.js";
+export const DEFAULT_SUBMIT_WITHIN = 60 * 60;
+export const MAX_SUBMIT_WITHIN = 24 * 60 * 60;
+const SIGNATURE_PATTERN = "^[1-9A-HJ-NP-Za-km-z]{64,88}$";
+export const signedTerms = {
+    owner: account("the wallet that signs the message and sells"),
+    input_mint: account(),
+    output_mint: account(),
+    order: orderSchema,
+    expires_at: time(),
+    nonce: amount(),
+    submit_by: time("unix seconds after which the signature can no longer be submitted"),
+    epoch: amount("the owner's signing epoch the signature is bound to"),
+    relayer_fee: amount("raw input units the owner pays, from the same allowance, to whoever submits the signature"),
+    partner: optional(partnerSchema),
+    spec_url: optional(text(`where the acceptance spec is published, ${MEMO_URL_RULE}; the relayer records it in a memo it signs with the create. It is not part of the owner's signature`)),
+};
+export const SPEC_URL_UNSIGNED = `the spec url is not part of what the owner signs: the relayer publishes it in a memo it signs with the create, and a relayer could leave it out or change it; ${tool("find_jobs")} shows the url that was published`;
+export const publishesLine = (url) => `Publishes: the acceptance spec's url ${url}, in a memo the relayer signs`;
+export async function publishedUrl(transport, params, url) {
+    if (url === undefined) {
+        return undefined;
+    }
+    if (params.kind !== Kind.AttestedResult || params.specHash.every((b) => b === 0)) {
+        throw new InvalidInput([{ path: "spec_url", message: "needs an attested order with spec_hash" }]);
+    }
+    if (!isMemoUrl(url)) {
+        throw new InvalidInput([{ path: "spec_url", message: `must be ${MEMO_URL_RULE}` }]);
+    }
+    if (await plainHttpOnPublic(transport, url)) {
+        throw new InvalidInput([{ path: "spec_url", message: SPEC_URL_PLAIN }]);
+    }
+    return url;
+}
+export const published = (signer, url) => url === undefined ? [] : [memoInstruction(signer, specMemo(url))];
+export async function fieldsOf(transport, t, params, outputTokenProgram) {
+    const { config } = await loadConfig(transport);
+    const inputToken = await mintOf(transport, t.input_mint);
+    const fields = {
+        domain: Uint8Array.from(config.domain),
+        owner: t.owner,
+        ownerInput: await findAssociatedTokenAddress({ owner: t.owner, mint: t.input_mint, tokenProgram: inputToken.tokenProgram }),
+        inputMint: t.input_mint,
+        outputMint: t.output_mint,
+        receiver: await findAssociatedTokenAddress({ owner: t.owner, mint: t.output_mint, tokenProgram: outputTokenProgram }),
+        nonce: t.nonce,
+        expiresAt: t.expires_at,
+        submitBy: t.submit_by,
+        kind: params.kind,
+        params: encodeParams(params),
+        epoch: t.epoch,
+        relayerFee: t.relayer_fee,
+        ext: createExt(t.partner === undefined ? {} : { partner: { key: t.partner.account, bps: t.partner.bps } }),
+    };
+    return { config, inputToken, fields };
+}
+export function sameTerms(stored, fields) {
+    const partner = partnerOf(fields.ext ?? new Uint8Array());
+    return (stored.inputMint === fields.inputMint &&
+        stored.outputMint === fields.outputMint &&
+        stored.receiver === fields.receiver &&
+        stored.expiresAt === fields.expiresAt &&
+        stored.kind === fields.kind &&
+        stored.flags === (fields.flags ?? 0) &&
+        stored.partnerBps === (partner?.bps ?? 0) &&
+        (partner === undefined || stored.partner === partner.key) &&
+        stored.params.length === fields.params.length &&
+        stored.params.every((byte, i) => byte === fields.params[i]));
+}
+export function signatureBytes(text) {
+    const bytes = new RegExp(SIGNATURE_PATTERN).test(text) ? getBase58Encoder().encode(text) : new Uint8Array();
+    if (bytes.length !== 64) {
+        throw new AgentRefusal("SignatureMalformed", "the signature must be 64 bytes written in base58");
+    }
+    return bytes;
+}
+//# sourceMappingURL=signed-terms.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signed-terms.js","sourceRoot":"","sources":["../../../src/agent/signed-terms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,gBAAgB,EAAiE,MAAM,aAAa,CAAC;AAC5H,OAAO,EACL,SAAS,EACT,YAAY,EACZ,0BAA0B,EAG1B,SAAS,EACT,IAAI,EACJ,aAAa,EACb,SAAS,EAET,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,EAAkB,MAAM,uBAAuB,CAAC;AAC/G,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAc,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,GAAG,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAC9C,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;AAE1D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,OAAO,CAAC,6CAA6C,CAAC;IAC7D,UAAU,EAAE,OAAO,EAAE;IACrB,WAAW,EAAE,OAAO,EAAE;IACtB,KAAK,EAAE,WAAW;IAClB,UAAU,EAAE,IAAI,EAAE;IAClB,KAAK,EAAE,MAAM,EAAE;IACf,SAAS,EAAE,IAAI,CAAC,mEAAmE,CAAC;IACpF,KAAK,EAAE,MAAM,CAAC,qDAAqD,CAAC;IACpE,WAAW,EAAE,MAAM,CAAC,2FAA2F,CAAC;IAChH,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC;IAChC,QAAQ,EAAE,QAAQ,CAChB,IAAI,CAAC,2CAA2C,aAAa,sGAAsG,CAAC,CACrK;CACF,CAAC;AAgBF,MAAM,CAAC,MAAM,iBAAiB,GAAG,iKAAiK,IAAI,CAAC,WAAW,CAAC,mCAAmC,CAAC;AAEvP,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,wCAAwC,GAAG,+BAA+B,CAAC;AAEzH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAoB,EAAE,MAAoB,EAAE,GAAuB;IACpG,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC,CAAC,CAAC;IACpG,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,MAAM,iBAAiB,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAyB,EAAE,GAAuB,EAAiB,EAAE,CAC7F,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAAoB,EAAE,CAAc,EAAE,MAAoB,EAAE,kBAA2B;IACpH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IACzD,MAAM,MAAM,GAAuB;QACjC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QACtC,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,UAAU,EAAE,MAAM,0BAA0B,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,EAAE,CAAC;QAC3H,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,UAAU,EAAE,CAAC,CAAC,WAAW;QACzB,QAAQ,EAAE,MAAM,0BAA0B,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC;QACrH,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,QAAQ,EAAE,CAAC,CAAC,SAAS;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC;QAC5B,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,UAAU,EAAE,CAAC,CAAC,WAAW;QACzB,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;KAC3G,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,MAA0B;IAClE,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,UAAU,EAAE,CAAC,CAAC;IAC1D,OAAO,CACL,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;QACrC,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU;QACvC,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;QACnC,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;QACrC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAC3B,MAAM,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM;QAC7C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC;IAC5G,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,kDAAkD,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,KAAuB,CAAC;AACjC,CAAC"}

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

@@ -1,13 +1,4 @@
-import { type Intent, type SignedIntentFields } from "@intent-engine/core";
-export declare const DEFAULT_SUBMIT_WITHIN: number;
-export declare const MAX_SUBMIT_WITHIN: number;
-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 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 { DEFAULT_SUBMIT_WITHIN, MAX_SUBMIT_WITHIN, publishesLine, sameTerms, SPEC_URL_UNSIGNED } from "./signed-terms.js";
+export { paying, RELAY_TOO_LARGE, refuseRepricing, repriced, SPEC_URL_TOO_LONG } from "./signed-relay.js";
+export { prepareSignedIntent } from "./signed-prepare.js";
+export { previewSignedIntent, submitSignedIntent } from "./signed-submit.js";