@intent-engine/cli 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,40 @@
+import { type Address, type Instruction, type TransactionSigner } from "@solana/kit";
+import type { Transport } from "../transport.js";
+export type UserWindow = {
+    nonceBase: bigint;
+    nonceBitmap: readonly bigint[];
+    epoch: bigint;
+};
+export declare function userOf(transport: Transport, owner: Address): Promise<UserWindow | null>;
+export declare const NONCE_WINDOW = 256n;
+export declare function pickNonce(user: UserWindow | null, requested: bigint | undefined, reserved?: ReadonlySet<bigint>): bigint;
+export declare function initUserIfMissing(user: UserWindow | null, owner: Address): Promise<Instruction[]>;
+export declare function tokenAccountIfMissing(transport: Transport, payer: TransactionSigner, owner: Address, mint: Address, tokenProgram: Address): Promise<{
+    address: Address;
+    create: Instruction[];
+}>;
+export type Wrap = {
+    instructions: Instruction[];
+    lamports: bigint;
+};
+export declare function wrapIfShort(transport: Transport, owner: Address, mint: Address, tokenProgram: Address, needed: bigint): Promise<Wrap>;
+export declare function unusedIntent(transport: Transport, owner: Address, nonce: bigint): Promise<Address>;
+export type Allowance = {
+    account: Address;
+    before: bigint;
+    after: bigint;
+    replaces: Address | null;
+};
+export declare function raiseAllowance(transport: Transport, owner: Address, account: Address, by: bigint): Promise<Allowance>;
+export declare function lowerAllowance(transport: Transport, owner: Address, account: Address, by: bigint): Promise<Allowance>;
+export declare const WARN_REPLACES_DELEGATE = "the setup replaces another app's spending approval on your token account";
+export declare function setupLines(o: {
+    registers: boolean;
+    creates: Address[];
+    allowance: Allowance | null;
+    decimals?: number;
+    wraps?: bigint;
+}): {
+    lines: string[];
+    warnings: string[];
+};

package/dist/src/agent/owner.js

@@ -0,0 +1,123 @@
+import { createNoopSigner, isSome } from "@solana/kit";
+import { getTransferSolInstruction } from "@solana-program/system";
+import { getCreateAssociatedTokenIdempotentInstructionAsync, getSyncNativeInstruction, getTokenDecoder, TOKEN_PROGRAM_ADDRESS, } from "@solana-program/token";
+import { buildInitUser, findAssociatedTokenAddress, findDelegatePda, formatAmount, INTENT_ENGINE_PROGRAM_ADDRESS, U64_MAX, findIntentPda, findUserStatePda, getUserStateDecoder, } from "@intent-engine/core";
+import { createdAccount, TOKEN_PROGRAMS } from "../accounts.js";
+import { NATIVE_MINT } from "../tokens.js";
+import { AgentRefusal, ENGINE_PROBLEMS } from "./problems.js";
+import { SOL_DECIMALS } from "./read.js";
+export async function userOf(transport, owner) {
+    const [address] = await findUserStatePda({ owner });
+    const view = await createdAccount(transport, address);
+    if (view === null) {
+        return null;
+    }
+    if (view.owner !== INTENT_ENGINE_PROGRAM_ADDRESS) {
+        throw new Error(`${address} is not an engine user account`);
+    }
+    return getUserStateDecoder().decode(view.data);
+}
+export const NONCE_WINDOW = 256n;
+export function pickNonce(user, requested, reserved = new Set()) {
+    if (requested !== undefined) {
+        return requested;
+    }
+    const base = user?.nonceBase ?? 0n;
+    for (let offset = 0n; offset < NONCE_WINDOW && base + offset <= U64_MAX; offset++) {
+        const word = user?.nonceBitmap[Number(offset / 64n)] ?? 0n;
+        const used = ((word >> offset % 64n) & 1n) === 1n;
+        if (!used && !reserved.has(base + offset)) {
+            return base + offset;
+        }
+    }
+    throw new AgentRefusal("NoFreeNonce", "every nonce in the owner's window is used or promised to a pending signature; the owner must advance the nonce window first");
+}
+export async function initUserIfMissing(user, owner) {
+    return user === null ? [await buildInitUser({ owner: createNoopSigner(owner) })] : [];
+}
+export async function tokenAccountIfMissing(transport, payer, owner, mint, tokenProgram) {
+    const address = await findAssociatedTokenAddress({ owner, mint, tokenProgram });
+    const create = (await createdAccount(transport, address)) === null
+        ? [
+            await getCreateAssociatedTokenIdempotentInstructionAsync({
+                payer,
+                owner,
+                mint,
+                tokenProgram,
+            }),
+        ]
+        : [];
+    return { address, create };
+}
+export async function wrapIfShort(transport, owner, mint, tokenProgram, needed) {
+    if (mint !== NATIVE_MINT || tokenProgram !== TOKEN_PROGRAM_ADDRESS) {
+        return { instructions: [], lamports: 0n };
+    }
+    const account = await findAssociatedTokenAddress({ owner, mint, tokenProgram });
+    const view = await createdAccount(transport, account);
+    const held = view === null ? 0n : getTokenDecoder().decode(view.data).amount;
+    if (held >= needed) {
+        return { instructions: [], lamports: 0n };
+    }
+    const payer = createNoopSigner(owner);
+    return {
+        instructions: [
+            ...(view === null ? [await getCreateAssociatedTokenIdempotentInstructionAsync({ payer, owner, mint, tokenProgram })] : []),
+            getTransferSolInstruction({ source: payer, destination: account, amount: needed - held }),
+            getSyncNativeInstruction({ account }),
+        ],
+        lamports: needed - held,
+    };
+}
+export async function unusedIntent(transport, owner, nonce) {
+    const [intent] = await findIntentPda({ owner, nonce });
+    if ((await createdAccount(transport, intent)) !== null) {
+        throw new AgentRefusal("NonceUsed", ENGINE_PROBLEMS.NonceUsed.hint);
+    }
+    return intent;
+}
+export async function raiseAllowance(transport, owner, account, by) {
+    const view = await createdAccount(transport, account);
+    if (view !== null && !TOKEN_PROGRAMS.includes(view.owner)) {
+        throw new Error(`${account} is not a token account`);
+    }
+    const token = view === null ? null : getTokenDecoder().decode(view.data);
+    const [engine] = await findDelegatePda({ owner });
+    const current = token !== null && isSome(token.delegate) ? token.delegate.value : null;
+    const before = current === engine && token !== null ? token.delegatedAmount : 0n;
+    return {
+        account,
+        before,
+        after: before > U64_MAX - by ? U64_MAX : before + by,
+        replaces: current === null || current === engine ? null : current,
+    };
+}
+export async function lowerAllowance(transport, owner, account, by) {
+    const view = await createdAccount(transport, account);
+    const token = view === null || !TOKEN_PROGRAMS.includes(view.owner) ? null : getTokenDecoder().decode(view.data);
+    const [engine] = await findDelegatePda({ owner });
+    const current = token !== null && isSome(token.delegate) ? token.delegate.value : null;
+    const before = current === engine && token !== null ? token.delegatedAmount : 0n;
+    return { account, before, after: before > by ? before - by : 0n, replaces: null };
+}
+export const WARN_REPLACES_DELEGATE = "the setup replaces another app's spending approval on your token account";
+export function setupLines(o) {
+    const a = o.allowance;
+    return {
+        lines: [
+            ...(o.registers ? ["Setup: registers you with the engine (a one-time account you pay rent for)"] : []),
+            ...o.creates.map((mint) => `Setup: creates your token account for ${mint} (you pay its rent)`),
+            ...(o.wraps === undefined || o.wraps === 0n
+                ? []
+                : [`Setup: wraps ${formatAmount(o.wraps, SOL_DECIMALS)} of your SOL into your wrapped SOL account`]),
+            ...(a === null
+                ? []
+                : [
+                    `Setup: sets the engine's spending allowance on ${a.account} to ${formatAmount(a.after, o.decimals)} (now ${formatAmount(a.before, o.decimals)})`,
+                    ...(a.replaces === null ? [] : [`Setup: removes the approval ${a.replaces} holds on ${a.account}`]),
+                ]),
+        ],
+        warnings: a !== null && a.replaces !== null ? [WARN_REPLACES_DELEGATE] : [],
+    };
+}
+//# sourceMappingURL=owner.js.map

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

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

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

@@ -0,0 +1,14 @@
+import { type Address, type Instruction } from "@solana/kit";
+import type { Transport } from "../transport.js";
+export type Prepared = {
+    transaction: string;
+    instructions: Instruction[];
+    priorityLamports: bigint;
+    feePayer: Address;
+    signers: Address[];
+    lastValidBlockHeight: bigint;
+    unitsConsumed: bigint | null;
+    logs: string[];
+};
+export declare function transactionSize(transport: Transport, instructions: readonly Instruction[], feePayer: Address): Promise<number>;
+export declare function prepare(transport: Transport, instructions: readonly Instruction[], feePayer: Address): Promise<Prepared>;

package/dist/src/agent/prepare.js

@@ -0,0 +1,32 @@
+import { appendTransactionMessageInstructions, compileTransaction, getTransactionEncoder, partiallySignTransactionMessageWithSigners, createTransactionMessage, getBase64EncodedWireTransaction, pipe, setTransactionMessageFeePayer, setTransactionMessageLifetimeUsingBlockhash, } from "@solana/kit";
+import { priorityLamports } from "../compute.js";
+import { LOG_LINE_LIMIT, LOG_TAIL, SimulationFailed, simulationProblem, untrusted } from "./problems.js";
+export async function transactionSize(transport, instructions, feePayer) {
+    const latest = await transport.latestBlockhash();
+    const message = pipe(createTransactionMessage({ version: 0 }), (m) => setTransactionMessageFeePayer(feePayer, m), (m) => setTransactionMessageLifetimeUsingBlockhash(latest, m), (m) => appendTransactionMessageInstructions(instructions, m));
+    return getTransactionEncoder().encode(compileTransaction(message)).length;
+}
+export async function prepare(transport, instructions, feePayer) {
+    const budgeted = await transport.budget(instructions, feePayer);
+    const latest = await transport.latestBlockhash();
+    const message = pipe(createTransactionMessage({ version: 0 }), (m) => setTransactionMessageFeePayer(feePayer, m), (m) => setTransactionMessageLifetimeUsingBlockhash(latest, m), (m) => appendTransactionMessageInstructions(budgeted, m));
+    const compiled = await partiallySignTransactionMessageWithSigners(message);
+    const transaction = getBase64EncodedWireTransaction(compiled);
+    const simulation = await transport.simulate(transaction);
+    if (simulation.err !== null) {
+        throw new SimulationFailed(simulationProblem(simulation.err, simulation.logs));
+    }
+    return {
+        transaction,
+        instructions: budgeted,
+        priorityLamports: priorityLamports(budgeted),
+        feePayer,
+        signers: Object.entries(compiled.signatures)
+            .filter(([, signature]) => signature === null)
+            .map(([signer]) => signer),
+        lastValidBlockHeight: latest.lastValidBlockHeight,
+        unitsConsumed: simulation.unitsConsumed,
+        logs: simulation.logs.slice(-LOG_TAIL).map((line) => untrusted(line).slice(0, LOG_LINE_LIMIT)),
+    };
+}
+//# sourceMappingURL=prepare.js.map

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

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

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

@@ -0,0 +1,120 @@
+import type { Address } from "@solana/kit";
+import { type Issue } from "./schema.js";
+export type Problem = {
+    code: string;
+    retryable: boolean;
+    hint: string;
+    programError?: number;
+    program?: Address;
+    issues?: Issue[];
+    logs?: string[];
+};
+type Entry = {
+    retryable: boolean;
+    hint: string;
+};
+export declare const ENGINE_PROBLEMS: {
+    readonly Overflow: Entry;
+    readonly DivideByZero: Entry;
+    readonly Truncated: Entry;
+    readonly NonCanonical: Entry;
+    readonly UnknownKind: Entry;
+    readonly UnknownStatus: Entry;
+    readonly InvalidParams: Entry;
+    readonly AmountMismatch: Entry;
+    readonly InsufficientOutput: Entry;
+    readonly InvalidTransition: Entry;
+    readonly IntentExpired: Entry;
+    readonly NotExpired: Entry;
+    readonly NonceUsed: Entry;
+    readonly NonceOutOfWindow: Entry;
+    readonly NonceRegression: Entry;
+    readonly Unauthorized: Entry;
+    readonly CreatePaused: Entry;
+    readonly KindDisabled: Entry;
+    readonly UnknownKindBits: Entry;
+    readonly InvalidPauseFlags: Entry;
+    readonly FeeTooHigh: Entry;
+    readonly NotPendingAdmin: Entry;
+    readonly ExpiryNotInFuture: Entry;
+    readonly SameMint: Entry;
+    readonly MintNotAllowed: Entry;
+    readonly RefundNotCanonical: Entry;
+    readonly ReceiverNotAllowed: Entry;
+    readonly AuctionOutlivesExpiry: Entry;
+    readonly FillPaused: Entry;
+    readonly FeeAccountNotCanonical: Entry;
+    readonly FeeAccountMissing: Entry;
+    readonly SolverOutputNotAllowed: Entry;
+    readonly SigProgram: Entry;
+    readonly SigHeader: Entry;
+    readonly SigPubkey: Entry;
+    readonly SigMessage: Entry;
+    readonly KindMismatch: Entry;
+    readonly ResultOutOfBounds: Entry;
+    readonly SigMissing: Entry;
+    readonly InvalidDomain: Entry;
+    readonly SignatureExpired: Entry;
+    readonly FlashCpi: Entry;
+    readonly FlashEndProgram: Entry;
+    readonly FlashEndDiscriminator: Entry;
+    readonly FlashEndIntent: Entry;
+    readonly FlashEndOrder: Entry;
+    readonly ReceiverCannotReceive: Entry;
+    readonly RefundCannotReceive: Entry;
+    readonly FeeAboveBound: Entry;
+    readonly ExtTooLong: Entry;
+    readonly ExtMalformed: Entry;
+    readonly ExtUnknown: Entry;
+    readonly FlagsUnknown: Entry;
+    readonly FillKindDisabled: Entry;
+    readonly UnsupportedVersion: Entry;
+    readonly AmountInMismatch: Entry;
+    readonly EpochRegression: Entry;
+    readonly TreasuryMismatch: Entry;
+    readonly CrankBountyTooHigh: Entry;
+    readonly CreateFeeTooHigh: Entry;
+    readonly PartnerCutTooHigh: Entry;
+    readonly PartnerFeeTooHigh: Entry;
+    readonly PartnerAccountMissing: Entry;
+    readonly PartnerAccountNotCanonical: Entry;
+    readonly MandateInvalid: Entry;
+    readonly MandateExpired: Entry;
+    readonly MandateKind: Entry;
+    readonly MandateTtl: Entry;
+    readonly MandateCap: Entry;
+    readonly MandateBudget: Entry;
+    readonly MandateCount: Entry;
+    readonly MandatePrice: Entry;
+    readonly MandateRevoked: Entry;
+    readonly MandateMismatch: Entry;
+    readonly CreateCostAboveCeiling: Entry;
+    readonly NonceJumpTooLarge: Entry;
+    readonly EpochJumpTooLarge: Entry;
+};
+export type EngineErrorName = keyof typeof ENGINE_PROBLEMS;
+export declare const ENGINE_ERROR_BASE = 6000;
+export declare const ENGINE_ERROR_NAMES: EngineErrorName[];
+export declare const TOKEN_PROGRAMS: Address[];
+export declare const TOKEN_PROBLEMS: Record<number, {
+    code: string;
+} & Entry>;
+export declare function failureOf(logs: readonly string[]): {
+    program: Address;
+    code: number;
+} | null;
+export declare const LOG_TAIL = 12;
+export declare const LOG_LINE_LIMIT = 200;
+export declare function simulationProblem(err: string, logs: readonly string[]): Problem;
+export declare class SimulationFailed extends Error {
+    readonly problem: Problem;
+    constructor(problem: Problem);
+}
+export declare class AgentRefusal extends Error {
+    readonly problem: Problem;
+    constructor(code: string, hint: string, retryable?: boolean);
+}
+export declare const HINT_LIMIT = 300;
+export declare const untrusted: (text: string) => string;
+export declare function problemOf(error: unknown): Problem;
+export {};

package/dist/src/agent/problems.js

@@ -0,0 +1,189 @@
+import { tool } from "./names.js";
+import { BPS_DENOMINATOR, INTENT_ENGINE_PROGRAM_ADDRESS, IntentCoreError, MAX_PARTNER_BPS } from "@intent-engine/core";
+import { MissingAccount, NotAMint } from "../accounts.js";
+import { rateLimited } from "../transport.js";
+import { InvalidInput } from "./schema.js";
+const never = (hint) => ({ retryable: false, hint });
+const later = (hint) => ({ retryable: true, hint });
+export const ENGINE_PROBLEMS = {
+    Overflow: never("an amount is too large for the arithmetic; use smaller amounts"),
+    DivideByZero: never("the arithmetic divided by zero; validated order terms never reach this, so rebuild the transaction with this server"),
+    Truncated: never("the instruction data was cut short; rebuild the transaction with this server"),
+    NonCanonical: never("the instruction data was not encoded canonically; rebuild the transaction with this server"),
+    UnknownKind: never("the intent kind is not one the program knows; use swap, limit, dutch or attested"),
+    UnknownStatus: never(`the intent holds a status this client does not know; read it again with ${tool("get_intent")}`),
+    InvalidParams: never("the order terms are inconsistent; check amounts are non-zero and the auction times are ordered"),
+    AmountMismatch: never("the amounts do not match what the intent escrows; read the intent again and use its remaining amount"),
+    InsufficientOutput: later(`the fill pays less than the intent requires right now; quote again with ${tool("quote")}`),
+    InvalidTransition: never(`the intent is not in a state that allows this; read it with ${tool("get_intent")}`),
+    IntentExpired: never(`the intent has expired and can no longer be filled; its owner can still cancel it, and anyone can expire and close it (${tool("prepare_crank")})`),
+    NotExpired: later("the intent has not expired yet; wait until its expiry time and try again"),
+    NonceUsed: never("this nonce is already used; omit the nonce so the next free one is chosen"),
+    NonceOutOfWindow: never("this nonce is outside the owner's 256-nonce window or inside the agent nonce lanes; omit the nonce so the next free one is chosen"),
+    NonceRegression: never("the nonce base can only move forward"),
+    Unauthorized: never("a signer or a named account does not match the one recorded on-chain (owner, rent payer, mandate agent, admin, guardian or upgrade authority); let this server pick the accounts and sign with the recorded key"),
+    CreatePaused: later(`creating intents is paused by the guardian or admin; check paused.create in ${tool("get_config")} and try again later`),
+    KindDisabled: never(`this intent kind is not enabled; see kinds[].enabled in ${tool("get_config")}`),
+    UnknownKindBits: never("the kind mask names kinds the program does not know"),
+    InvalidPauseFlags: never("the pause flags are empty or name pauses the program does not know; use create, fill or all"),
+    FeeTooHigh: never("the configured fee exceeds the program's maximum"),
+    NotPendingAdmin: never("only the proposed admin can accept the admin role"),
+    ExpiryNotInFuture: never("the expiry must be later than the current chain time; use a later expiry"),
+    SameMint: never("the input and output mints must differ"),
+    MintNotAllowed: never("this mint cannot be used: it has a token extension the program refuses"),
+    RefundNotCanonical: never("refunds go only to the owner's canonical token account; let this server pick accounts"),
+    ReceiverNotAllowed: never("the receiver account is not owned by the named receiver authority, the authority is an engine account, or (for a mandate) the receiver is not an account the owner controls"),
+    AuctionOutlivesExpiry: never("the dutch auction must end at or before the intent expires"),
+    FillPaused: later(`fills are paused by the guardian or admin; check paused.fill in ${tool("get_config")} and try again later`),
+    FeeAccountNotCanonical: never("a fee must go to its payee's canonical token account (the treasury's, or the agent's); let this server pick it"),
+    FeeAccountMissing: never("a fee account was not passed: the treasury's or agent's at fill, or the relayer's at a signed create; create that token account and pass it"),
+    SolverOutputNotAllowed: never("the solver's output account is not acceptable for this fill"),
+    SigProgram: never("the signature instruction must come from the Ed25519 program"),
+    SigHeader: never("the Ed25519 instruction is malformed; rebuild it with this server"),
+    SigPubkey: never("the signature was made by a different key than the owner"),
+    SigMessage: never(`the signed message does not match this intent; sign the exact message from ${tool("prepare_signed_intent")}`),
+    KindMismatch: never("the instruction does not match the intent's kind"),
+    ResultOutOfBounds: never("the attested result is outside the intent's bounds"),
+    SigMissing: never("the Ed25519 signature instruction is missing; rebuild the transaction with this server"),
+    InvalidDomain: never("the config domain must not be zero; pass this cluster's genesis hash to init-config"),
+    SignatureExpired: never("the signed intent passed its submit-by time; ask the owner to sign a new one"),
+    FlashCpi: never("a flash fill cannot be started from inside another program"),
+    FlashEndProgram: never("the flash fill must end with this program's end_fill"),
+    FlashEndDiscriminator: never("the flash fill's closing instruction is not end_fill"),
+    FlashEndIntent: never("the flash fill ends a different intent than it began"),
+    FlashEndOrder: never("the flash fill's begin and end are out of order"),
+    ReceiverCannotReceive: never("the receiver token account cannot receive: frozen, closed, not initialized, for another mint or owner, or with an extension other than ImmutableOwner; use another receiver"),
+    RefundCannotReceive: never("the refund account cannot take the refund: frozen, for another mint or owner, or with a foreign delegate, close authority or extension; refund to another account the owner controls, or wait for a frozen one to be thawed"),
+    FeeAboveBound: never("the current fees exceed the bound the solver accepted"),
+    ExtTooLong: never("the extension data is too long"),
+    ExtMalformed: never("the extension data is malformed: badly encoded, tags unsorted or repeated, or a partner with a zero key or zero bps"),
+    ExtUnknown: never("the extension data holds a field the program does not know"),
+    FlagsUnknown: never("the intent flags name options the program does not know; leave flags unset"),
+    FillKindDisabled: never(`the admin stopped fills of this kind; see kinds[].fills_stopped in ${tool("get_config")}`),
+    UnsupportedVersion: never("an account has a version this program does not support"),
+    AmountInMismatch: never("the fill must sell exactly the intent's remaining amount; read the intent again"),
+    EpochRegression: never("the signing epoch can only move forward"),
+    TreasuryMismatch: never("the treasury account must be the configured fee recipient; let this server pick it"),
+    CrankBountyTooHigh: never("the crank bounty exceeds the program's maximum"),
+    CreateFeeTooHigh: never("the create fee exceeds the program's maximum"),
+    PartnerCutTooHigh: never(`the partner cut must be at most ${BPS_DENOMINATOR} bps`),
+    PartnerFeeTooHigh: never(`a partner fee can be at most ${MAX_PARTNER_BPS} bps`),
+    PartnerAccountMissing: later("the partner has no token account for the input mint yet; it must be created before a fill"),
+    PartnerAccountNotCanonical: never("the partner fee must go to the partner's canonical token account"),
+    MandateInvalid: never("the mandate's terms are unsound: kinds must be swap, limit or dutch; per-intent cap above the agent fee; total at least the per-intent cap; max intents, max lifetime and floors non-zero; valid until a future time; a partner needs both key and bps; the agent neither empty nor the owner; or the owner has used every grant lane"),
+    MandateExpired: never(`the mandate has expired; the owner must grant a new one with ${tool("prepare_mandate")}`),
+    MandateKind: never("the mandate does not allow this kind of intent"),
+    MandateTtl: never("the intent lives longer than the mandate allows; choose an earlier expiry within it"),
+    MandateCap: never("the intent draws more than the mandate's per-intent cap (amount sold plus agent fee); the owner set that cap, so stay within it or ask the owner, and never split or reword an order to get around it"),
+    MandateBudget: never(`the mandate's total budget would be exceeded; check what remains with ${tool("get_mandate")}`),
+    MandateCount: never("the mandate has already created as many intents as it allows"),
+    MandatePrice: never("the minimum output is below the price floor the owner set; do not weaken the person's price on your own: tell them the order is cheaper than the owner allows, or ask for at least the floor"),
+    MandateRevoked: never("this mandate no longer stands: the owner revoked it, granted that id again, or advanced their signing epoch; the owner must grant a new one"),
+    MandateMismatch: never("the intent differs from the mandate's fixed terms: same mints, no flags, the owner's partner only, and proceeds to an account the owner holds"),
+    CreateCostAboveCeiling: later("the engine's create fee or crank bounty rose above what this transaction allows; prepare it again and check the new cost before signing"),
+    NonceJumpTooLarge: never("one advance may move the nonce base at most 2^32 past its current value and never into the agent nonce lanes; advance in smaller steps"),
+    EpochJumpTooLarge: never("one advance may raise the signing epoch at most 2^48; pick a smaller next epoch"),
+};
+export const ENGINE_ERROR_BASE = 6000;
+export const ENGINE_ERROR_NAMES = Object.keys(ENGINE_PROBLEMS);
+export const TOKEN_PROGRAMS = [
+    "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
+    "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
+];
+export const TOKEN_PROBLEMS = {
+    1: { code: "InsufficientFunds", ...never("a token account, or the allowance a signed or agent create draws through, holds less than the amount; lower the amount or fund the account") },
+    3: { code: "MintMismatch", ...never("a token account belongs to a different mint than the intent uses") },
+    4: { code: "OwnerMismatch", ...never("a token account is not owned by the expected wallet") },
+    17: { code: "AccountFrozen", ...later("a token account is frozen by its issuer; try again once it is thawed") },
+    36: { code: "NoMemo", ...never("a token account requires a memo on incoming transfers; its owner must turn that off before it can receive") },
+    42: {
+        code: "CpiGuardTransferBlocked",
+        ...never(`the owner's token account has CPI Guard on, which stops the engine moving tokens on the owner's signature; use ${tool("prepare_signed_intent")}, which draws through the engine's allowance, or turn CPI Guard off`),
+    },
+};
+const FAILED = /^Program (\w{32,44}) failed: custom program error: 0x([0-9a-f]+)$/;
+export function failureOf(logs) {
+    for (const line of logs) {
+        const match = FAILED.exec(line);
+        if (match !== null) {
+            return { program: match[1], code: Number.parseInt(match[2] ?? "", 16) };
+        }
+    }
+    return null;
+}
+const engineProblem = (name) => ({
+    code: name,
+    programError: ENGINE_ERROR_BASE + ENGINE_ERROR_NAMES.indexOf(name),
+    program: INTENT_ENGINE_PROGRAM_ADDRESS,
+    ...ENGINE_PROBLEMS[name],
+});
+export const LOG_TAIL = 12;
+export const LOG_LINE_LIMIT = 200;
+export function simulationProblem(err, logs) {
+    const tail = logs.slice(-LOG_TAIL).map((line) => untrusted(line).slice(0, LOG_LINE_LIMIT));
+    const failure = failureOf(logs);
+    if (failure !== null && failure.program === INTENT_ENGINE_PROGRAM_ADDRESS) {
+        const name = ENGINE_ERROR_NAMES[failure.code - ENGINE_ERROR_BASE];
+        if (name !== undefined) {
+            return { ...engineProblem(name), logs: tail };
+        }
+    }
+    if (failure !== null && TOKEN_PROGRAMS.includes(failure.program)) {
+        const known = TOKEN_PROBLEMS[failure.code];
+        if (known !== undefined) {
+            return { ...known, programError: failure.code, program: failure.program, logs: tail };
+        }
+    }
+    return {
+        code: "TransactionFailed",
+        retryable: false,
+        hint: `the transaction would fail (${untrusted(err)}); read the logs for the cause`,
+        ...(failure === null ? {} : { programError: failure.code, program: failure.program }),
+        logs: tail,
+    };
+}
+export class SimulationFailed extends Error {
+    problem;
+    constructor(problem) {
+        super(problem.hint);
+        this.name = "SimulationFailed";
+        this.problem = problem;
+    }
+}
+export class AgentRefusal extends Error {
+    problem;
+    constructor(code, hint, retryable = false) {
+        super(hint);
+        this.name = "AgentRefusal";
+        this.problem = { code, retryable, hint };
+    }
+}
+export const HINT_LIMIT = 300;
+export const untrusted = (text) => text.replace(/[^ -~]+/g, " ").slice(0, HINT_LIMIT);
+export function problemOf(error) {
+    if (error instanceof InvalidInput) {
+        return { code: "InvalidInput", retryable: false, hint: "fix the listed fields and call again", issues: error.issues };
+    }
+    if (error instanceof SimulationFailed || error instanceof AgentRefusal) {
+        return error.problem;
+    }
+    if (error instanceof IntentCoreError) {
+        return engineProblem(error.code);
+    }
+    if (error instanceof MissingAccount) {
+        return { code: "NotFound", retryable: false, hint: error.message };
+    }
+    if (error instanceof NotAMint) {
+        return {
+            code: "NotAMint",
+            retryable: false,
+            hint: `${error.address} is not a token mint; pass the mint of the token itself, not a wallet or a token account`,
+        };
+    }
+    if (rateLimited(error)) {
+        return { code: "RateLimited", retryable: true, hint: "the RPC node is rate limiting; wait a few seconds and call again" };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return { code: "Failed", retryable: false, hint: untrusted(message) };
+}
+//# sourceMappingURL=problems.js.map

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

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

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

@@ -0,0 +1,13 @@
+import type { Address } from "@solana/kit";
+import type { Transport } from "../transport.js";
+import { type Decimals } from "./shapes.js";
+export declare const LIST_LIMIT = 100;
+export declare const LIST_DEFAULT = 20;
+export declare const getConfig: import("./actions.js").AnyAction;
+export declare const getIntent: import("./actions.js").AnyAction;
+export declare const listIntents: import("./actions.js").AnyAction;
+export declare const BALANCE_MINTS = 8;
+export declare const SOL_DECIMALS = 9;
+export declare function decimalsFor(transport: Transport, cache: Map<Address, number | null>, inputMint: Address, outputMint: Address): Promise<Decimals>;
+export declare const getBalances: import("./actions.js").AnyAction;
+export declare const quote: import("./actions.js").AnyAction;