@intent-engine/cli 0.0.0-stage → 0.1.0

package/dist/src/main.d.ts

@@ -0,0 +1,32 @@
+import type { Readable, Writable } from "node:stream";
+import { type KeyPairSigner } from "@solana/kit";
+import { type Runtime } from "./commands.js";
+export declare const EXIT_OK = 0;
+export declare const EXIT_FAILED = 1;
+export declare const EXIT_USAGE = 2;
+export declare const KEYPAIR_UNREADABLE = "--keypair must name a readable JSON file holding a 64-byte keypair";
+export declare const KEYPAIR_EXPOSED = "--keypair names a file other users can read or change; restrict it with chmod 600";
+export type Io = {
+    out(text: string): void;
+    err(text: string): void;
+};
+export { render } from "./render.js";
+export declare const unreachable: (url: string) => string;
+export declare function main(argv: readonly string[], runtime: Runtime, io: Io): Promise<number>;
+export declare function loadKeypairFile(path: string, platform?: string): Promise<KeyPairSigner>;
+export type Pipes = {
+    stdin: Readable;
+    stdout: Writable;
+};
+export declare const FETCH_TIMEOUT_MS = 10000;
+export declare function nodeRuntime(clock?: () => number, pipes?: Pipes, timeoutMs?: number): Runtime;
+export type ProcessLike = {
+    argv: readonly string[];
+    stdout: {
+        write(text: string): unknown;
+    };
+    stderr: {
+        write(text: string): unknown;
+    };
+};
+export declare function runProcess(proc: ProcessLike, runtime?: Runtime): Promise<number>;

package/dist/src/main.js

@@ -0,0 +1,99 @@
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname } from "node:path";
+import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
+import { createKeyPairSignerFromBytes, createSolanaRpc } from "@solana/kit";
+import { ENV_URL, outputOf, parse, UsageError } from "./args.js";
+import { follow, run } from "./commands.js";
+import { withPriority } from "./compute.js";
+import { printableLines, render, renderText } from "./render.js";
+import { rpcTransport } from "./transport.js";
+import { withSettings } from "./wallet.js";
+export const EXIT_OK = 0;
+export const EXIT_FAILED = 1;
+export const EXIT_USAGE = 2;
+export const KEYPAIR_UNREADABLE = "--keypair must name a readable JSON file holding a 64-byte keypair";
+export const KEYPAIR_EXPOSED = "--keypair names a file other users can read or change; restrict it with chmod 600";
+export { render } from "./render.js";
+export const unreachable = (url) => `cannot reach the RPC node at ${url}; pass --url devnet, --url mainnet-beta or an https URL, or set ${ENV_URL}`;
+const offline = (error) => error instanceof TypeError && error.message === "fetch failed";
+function message(error, url) {
+    if (url !== undefined && offline(error)) {
+        return unreachable(url);
+    }
+    return printableLines(error instanceof Error ? error.message : String(error));
+}
+export async function main(argv, runtime, io) {
+    let url;
+    try {
+        const command = parse(argv, await withSettings(runtime, runtime.env));
+        url = "url" in command ? command.url : undefined;
+        const show = (value) => io.out(command.name === "help" || outputOf(argv) === "text" ? renderText(value) : render(value));
+        if (command.name === "follow") {
+            const transport = withPriority(runtime.transport(command.url), command.priority);
+            await follow(transport, runtime, command.limit, command.interval, show);
+            return EXIT_OK;
+        }
+        const result = await run(command, runtime);
+        if (result !== null) {
+            show(result);
+        }
+        return EXIT_OK;
+    }
+    catch (error) {
+        io.err(message(error, url));
+        return error instanceof UsageError ? EXIT_USAGE : EXIT_FAILED;
+    }
+}
+export async function loadKeypairFile(path, platform = process.platform) {
+    let bytes;
+    let mode;
+    try {
+        mode = (await stat(path)).mode;
+        bytes = JSON.parse(await readFile(path, "utf8"));
+    }
+    catch {
+        throw new UsageError(KEYPAIR_UNREADABLE);
+    }
+    if (platform !== "win32" && (mode & 0o077) !== 0) {
+        throw new UsageError(KEYPAIR_EXPOSED);
+    }
+    if (!Array.isArray(bytes) ||
+        bytes.length !== 64 ||
+        !bytes.every((b) => Number.isInteger(b) && b >= 0 && b <= 255)) {
+        throw new UsageError(KEYPAIR_UNREADABLE);
+    }
+    return createKeyPairSignerFromBytes(new Uint8Array(bytes));
+}
+export const FETCH_TIMEOUT_MS = 10_000;
+export function nodeRuntime(clock = Date.now, pipes = process, timeoutMs = FETCH_TIMEOUT_MS) {
+    return {
+        transport: (url) => rpcTransport(createSolanaRpc(url)),
+        loadSigner: loadKeypairFile,
+        readText: (path) => readFile(path, "utf8"),
+        sleep: (seconds) => new Promise((resolve) => setTimeout(() => resolve(true), seconds * 1000)),
+        env: process.env,
+        writeText: (path, text) => writeFile(path, text, { flag: "wx" }),
+        saveText: async (path, text, secret) => {
+            await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+            await writeFile(path, text, secret ? { flag: "wx", mode: 0o600 } : { mode: 0o600 });
+        },
+        home: homedir().replaceAll("\\", "/"),
+        now: () => BigInt(Math.floor(clock() / 1000)),
+        fetch: (url, init) => fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs) }),
+        entropy: () => crypto.getRandomValues(new Uint32Array(1))[0] ?? 0,
+        serve: async (server) => {
+            const ended = new Promise((resolve) => pipes.stdin.once("end", () => resolve()));
+            await server.connect(new StdioServerTransport(pipes.stdin, pipes.stdout));
+            await ended;
+            await server.close();
+        },
+    };
+}
+export async function runProcess(proc, runtime = nodeRuntime()) {
+    return main(proc.argv.slice(2), runtime, {
+        out: (text) => proc.stdout.write(`${text}\n`),
+        err: (text) => proc.stderr.write(`${text}\n`),
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/src/main.js.map

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

package/dist/src/render.d.ts

@@ -0,0 +1,5 @@
+export declare function render(value: unknown): string;
+export declare const HIDDEN_RANGES: readonly (readonly [number, number])[];
+export declare const printable: (text: string) => string;
+export declare const printableLines: (text: string) => string;
+export declare function renderText(value: object): string;

package/dist/src/render.js

@@ -0,0 +1,46 @@
+export function render(value) {
+    return JSON.stringify(value, (_, v) => typeof v === "bigint" ? v.toString() : v instanceof Uint8Array ? Buffer.from(v).toString("hex") : v, 2);
+}
+export const HIDDEN_RANGES = [
+    [0x00, 0x1f],
+    [0x7f, 0x9f],
+    [0x61c, 0x61c],
+    [0x200e, 0x200f],
+    [0x2028, 0x202e],
+    [0x2066, 0x2069],
+];
+const hidden = (code) => HIDDEN_RANGES.some(([low, high]) => code >= low && code <= high);
+export const printable = (text) => Array.from(text, (c) => {
+    const code = c.codePointAt(0) ?? 0;
+    return hidden(code) ? `\\u${code.toString(16).padStart(4, "0")}` : c;
+}).join("");
+export const printableLines = (text) => text.split("\n").map(printable).join("\n");
+const plain = (v) => printable(typeof v === "bigint" ? v.toString() : v instanceof Uint8Array ? Buffer.from(v).toString("hex") : String(v));
+const scalar = (v) => v === null || ["string", "number", "bigint", "boolean"].includes(typeof v);
+export function renderText(value) {
+    const entries = Object.entries(value);
+    const summary = entries.find(([k]) => k === "summary")?.[1];
+    const lines = Array.isArray(summary) ? summary.map(plain) : [];
+    const warnings = entries.find(([k]) => k === "warnings")?.[1];
+    for (const warning of Array.isArray(warnings) ? warnings.map((w) => `WARNING: ${plain(w)}`) : []) {
+        if (!lines.includes(warning)) {
+            lines.push(warning);
+        }
+    }
+    for (const [key, v] of entries) {
+        if (key === "summary" || (key === "warnings" && Array.isArray(warnings))) {
+            continue;
+        }
+        if (scalar(v)) {
+            lines.push(`${printable(key)}: ${plain(v)}`);
+        }
+        else if (Array.isArray(v) && v.every(scalar)) {
+            lines.push(`${printable(key)}: ${v.length === 0 ? "none" : v.map(plain).join(", ")}`);
+        }
+        else {
+            lines.push(`${printable(key)}: ${printable(JSON.stringify(v, (_, x) => (typeof x === "bigint" ? x.toString() : x)))}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/src/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/render.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,IAAI,CAAC,SAAS,CACnB,KAAK,EACL,CAAC,CAAC,EAAE,CAAU,EAAE,EAAE,CAChB,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EACrG,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAA2C;IACnE,CAAC,IAAI,EAAE,IAAI,CAAC;IACZ,CAAC,IAAI,EAAE,IAAI,CAAC;IACZ,CAAC,KAAK,EAAE,KAAK,CAAC;IACd,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC;AAElG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE,CAChD,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE;IACrB,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAEd,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEnG,MAAM,KAAK,GAAG,CAAC,CAAU,EAAU,EAAE,CACnC,SAAS,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzH,MAAM,MAAM,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAE1G,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9D,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACjG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC/B,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACzE,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClI,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/src/tokens.d.ts

@@ -0,0 +1,6 @@
+import type { Address } from "@solana/kit";
+export declare const NATIVE_MINT: Address;
+export declare const TEST_TOKEN: Address;
+export declare const DEVNET_URL = "https://api.devnet.solana.com";
+export declare const testTokenElsewhere: (url: string) => string;
+export declare function tokenNamed(text: string, url: string): string | Error;

package/dist/src/tokens.js

@@ -0,0 +1,15 @@
+export const NATIVE_MINT = "So11111111111111111111111111111111111111112";
+export const TEST_TOKEN = "ETU8trkkfE8gNVPDGbCaJUoH88wy6yYV6ttJdc9NKB88";
+export const DEVNET_URL = "https://api.devnet.solana.com";
+export const testTokenElsewhere = (url) => `TEST names the devnet test token; on ${url} pass the token's mint address`;
+export function tokenNamed(text, url) {
+    const name = text.toUpperCase();
+    if (name === "SOL") {
+        return NATIVE_MINT;
+    }
+    if (name === "TEST") {
+        return url === DEVNET_URL ? TEST_TOKEN : new Error(testTokenElsewhere(url));
+    }
+    return text;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/src/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/tokens.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAG,6CAAwD,CAAC;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,8CAAyD,CAAC;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,+BAA+B,CAAC;AAE1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,wCAAwC,GAAG,gCAAgC,CAAC;AAE/H,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,GAAW;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/transport.d.ts

@@ -0,0 +1,155 @@
+import { type Address, type Base64EncodedWireTransaction, type Blockhash, type Instruction, type Signature, type TransactionSigner } from "@solana/kit";
+export type AccountView = {
+    owner: Address;
+    data: Uint8Array;
+    lamports: bigint;
+    executable?: boolean;
+};
+export type ProgramAccount = {
+    address: Address;
+    data: Uint8Array;
+};
+export type EngineTransaction = {
+    signature: string;
+    slot: bigint;
+    blockTime: bigint | null;
+    failed: boolean;
+    emitted: Uint8Array[];
+};
+export type Latest = {
+    blockhash: Blockhash;
+    lastValidBlockHeight: bigint;
+};
+export type Simulation = {
+    err: string | null;
+    logs: string[];
+    unitsConsumed: bigint | null;
+    accounts: (Uint8Array | null)[];
+};
+export interface Transport {
+    getAccount(address: Address): Promise<AccountView | null>;
+    send(instructions: readonly Instruction[], payer: TransactionSigner): Promise<string>;
+    latestBlockhash(): Promise<Latest>;
+    sendWire(wire: Base64EncodedWireTransaction, latest: Latest): Promise<string>;
+    simulate(wire: Base64EncodedWireTransaction, watch?: readonly Address[]): Promise<Simulation>;
+    genesisHash(): Promise<string>;
+    intents(owner?: Address): Promise<ProgramAccount[]>;
+    engineTransactions(limit: number): Promise<EngineTransaction[]>;
+    recentFees(accounts: readonly Address[]): Promise<bigint[]>;
+    budget(instructions: readonly Instruction[], feePayer: Address): Promise<Instruction[]>;
+    airdrop(address: Address, lamports: bigint): Promise<string>;
+}
+type Pending<T> = {
+    send(): Promise<T>;
+};
+export type RpcLike = {
+    getAccountInfo(address: Address, config: {
+        encoding: "base64";
+    }): Pending<{
+        value: {
+            owner: Address;
+            data: readonly [string, string];
+            lamports: bigint;
+            executable: boolean;
+        } | null;
+    }>;
+    getLatestBlockhash(): Pending<{
+        value: {
+            blockhash: Blockhash;
+            lastValidBlockHeight: bigint;
+        };
+    }>;
+    sendTransaction(wire: Base64EncodedWireTransaction, config: {
+        encoding: "base64";
+    }): Pending<Signature>;
+    simulateTransaction(wire: Base64EncodedWireTransaction, config: {
+        encoding: "base64";
+        sigVerify: false;
+        replaceRecentBlockhash: true;
+        accounts?: {
+            addresses: Address[];
+            encoding: "base64";
+        };
+    }): Pending<{
+        value: {
+            err: unknown;
+            logs: readonly string[] | null;
+            unitsConsumed?: bigint | undefined;
+            accounts?: readonly ({
+                data: readonly [string, string];
+            } | null)[] | null;
+        };
+    }>;
+    getSignatureStatuses(signatures: Signature[]): Pending<{
+        value: readonly ({
+            err: unknown;
+            confirmationStatus: string | null;
+        } | null)[];
+    }>;
+    getBlockHeight(): Pending<bigint>;
+    requestAirdrop(address: Address, lamports: bigint): Pending<Signature>;
+    getRecentPrioritizationFees(addresses: readonly Address[]): Pending<readonly {
+        prioritizationFee: bigint;
+    }[]>;
+    getGenesisHash(): Pending<string>;
+    getProgramAccounts(program: Address, config: {
+        encoding: "base64";
+        filters: readonly ({
+            dataSize: bigint;
+        } | {
+            memcmp: {
+                offset: bigint;
+                bytes: string;
+                encoding: "base58";
+            };
+        })[];
+    }): Pending<readonly {
+        pubkey: Address;
+        account: {
+            data: readonly [string, string];
+        };
+    }[]>;
+    getSignaturesForAddress(address: Address, config: {
+        limit: number;
+    }): Pending<readonly {
+        signature: Signature;
+        slot: bigint;
+        blockTime: bigint | null;
+        err: unknown;
+    }[]>;
+    getTransaction(signature: Signature, config: {
+        encoding: "json";
+        maxSupportedTransactionVersion: 0;
+        commitment: "confirmed";
+    }): Pending<{
+        transaction: {
+            message: {
+                accountKeys: readonly Address[];
+            };
+        };
+        meta: {
+            loadedAddresses?: {
+                writable: readonly Address[];
+                readonly: readonly Address[];
+            };
+            innerInstructions?: readonly {
+                instructions: readonly {
+                    programIdIndex: number;
+                    data: string;
+                }[];
+            }[] | null;
+        } | null;
+    } | null>;
+};
+export declare const POLL_MS = 500;
+export declare const CONFIRM_POLLS = 360;
+export declare const INTENT_OWNER_OFFSET = 8n;
+export declare const RATE_LIMIT_ATTEMPTS = 6;
+export declare function rateLimited(error: unknown): boolean;
+export declare function patiently<T>(call: () => Promise<T>, wait?: (ms: number) => Promise<void>): Promise<T>;
+export declare class Charged extends Error {
+    constructor(message: string);
+}
+export declare function confirm(rpc: RpcLike, signature: Signature, lastValidBlockHeight: bigint, wait?: (ms: number) => Promise<void>): Promise<void>;
+export declare function rpcTransport(rpc: RpcLike, wait?: (ms: number) => Promise<void>): Transport;
+export {};

package/dist/src/transport.js

@@ -0,0 +1,173 @@
+import { inspect } from "node:util";
+import { appendTransactionMessageInstructions, createTransactionMessage, getBase64EncodedWireTransaction, pipe, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, signTransactionMessageWithSigners, getBase58Decoder, getBase58Encoder, } from "@solana/kit";
+import { getIntentDiscriminatorBytes, getIntentSize, INTENT_ENGINE_PROGRAM_ADDRESS } from "@intent-engine/core";
+export const POLL_MS = 500;
+export const CONFIRM_POLLS = 360;
+export const INTENT_OWNER_OFFSET = 8n;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export const RATE_LIMIT_ATTEMPTS = 6;
+export function rateLimited(error) {
+    return error instanceof Error && /\b429\b/.test(error.message);
+}
+export async function patiently(call, wait = sleep) {
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await call();
+        }
+        catch (error) {
+            if (!rateLimited(error) || attempt >= RATE_LIMIT_ATTEMPTS) {
+                throw error;
+            }
+            await wait(POLL_MS * 2 ** attempt);
+        }
+    }
+}
+export class Charged extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "Charged";
+    }
+}
+export async function confirm(rpc, signature, lastValidBlockHeight, wait = sleep) {
+    for (let poll = 1;; poll++) {
+        const [status] = (await patiently(() => rpc.getSignatureStatuses([signature]).send(), wait)).value;
+        if (status) {
+            if (status.err !== null) {
+                throw new Charged(`transaction ${signature} failed: ${inspect(status.err)}`);
+            }
+            if (status.confirmationStatus === "confirmed" || status.confirmationStatus === "finalized") {
+                return;
+            }
+        }
+        if ((await patiently(() => rpc.getBlockHeight().send(), wait)) > lastValidBlockHeight) {
+            throw new Error(`transaction ${signature} expired before confirmation`);
+        }
+        if (poll >= CONFIRM_POLLS) {
+            throw new Charged(`transaction ${signature} was neither confirmed nor expired after ${CONFIRM_POLLS} checks; the node may be stuck, so look the signature up before sending again`);
+        }
+        await wait(POLL_MS);
+    }
+}
+export function rpcTransport(rpc, wait) {
+    return {
+        async getAccount(address) {
+            const { value } = await patiently(() => rpc.getAccountInfo(address, { encoding: "base64" }).send(), wait);
+            return value === null
+                ? null
+                : {
+                    owner: value.owner,
+                    data: new Uint8Array(Buffer.from(value.data[0], "base64")),
+                    lamports: value.lamports,
+                    executable: value.executable,
+                };
+        },
+        async send(instructions, payer) {
+            const { value: latest } = await patiently(() => rpc.getLatestBlockhash().send(), wait);
+            const message = pipe(createTransactionMessage({ version: 0 }), (m) => setTransactionMessageFeePayerSigner(payer, m), (m) => setTransactionMessageLifetimeUsingBlockhash(latest, m), (m) => appendTransactionMessageInstructions(instructions, m));
+            const signed = await signTransactionMessageWithSigners(message);
+            const wire = getBase64EncodedWireTransaction(signed);
+            const signature = await patiently(() => rpc.sendTransaction(wire, { encoding: "base64" }).send(), wait);
+            await confirm(rpc, signature, latest.lastValidBlockHeight, wait);
+            return signature;
+        },
+        async airdrop(address, lamports) {
+            const { value: latest } = await patiently(() => rpc.getLatestBlockhash().send(), wait);
+            const signature = await rpc.requestAirdrop(address, lamports).send();
+            await confirm(rpc, signature, latest.lastValidBlockHeight, wait);
+            return signature;
+        },
+        async latestBlockhash() {
+            const { value } = await patiently(() => rpc.getLatestBlockhash().send(), wait);
+            return value;
+        },
+        async sendWire(wire, latest) {
+            const signature = await patiently(() => rpc.sendTransaction(wire, { encoding: "base64" }).send(), wait);
+            await confirm(rpc, signature, latest.lastValidBlockHeight, wait);
+            return signature;
+        },
+        async simulate(wire, watch = []) {
+            const { value } = await patiently(() => rpc
+                .simulateTransaction(wire, {
+                encoding: "base64",
+                sigVerify: false,
+                replaceRecentBlockhash: true,
+                ...(watch.length === 0 ? {} : { accounts: { addresses: [...watch], encoding: "base64" } }),
+            })
+                .send(), wait);
+            return {
+                err: value.err === null ? null : inspect(value.err, { depth: null, breakLength: Infinity }),
+                logs: [...(value.logs ?? [])],
+                unitsConsumed: value.unitsConsumed ?? null,
+                accounts: watch.map((_, i) => {
+                    const found = value.accounts?.[i];
+                    return found === null || found === undefined ? null : new Uint8Array(Buffer.from(found.data[0], "base64"));
+                }),
+            };
+        },
+        async genesisHash() {
+            return patiently(() => rpc.getGenesisHash().send(), wait);
+        },
+        async recentFees(accounts) {
+            const fees = await patiently(() => rpc.getRecentPrioritizationFees(accounts).send(), wait);
+            return fees.map((f) => f.prioritizationFee);
+        },
+        async budget(instructions) {
+            return [...instructions];
+        },
+        async engineTransactions(limit) {
+            const signatures = await patiently(() => rpc.getSignaturesForAddress(INTENT_ENGINE_PROGRAM_ADDRESS, { limit }).send(), wait);
+            const found = [];
+            for (const entry of signatures) {
+                const tx = await patiently(() => rpc
+                    .getTransaction(entry.signature, {
+                    encoding: "json",
+                    maxSupportedTransactionVersion: 0,
+                    commitment: "confirmed",
+                })
+                    .send(), wait);
+                const keys = [
+                    ...(tx?.transaction.message.accountKeys ?? []),
+                    ...(tx?.meta?.loadedAddresses?.writable ?? []),
+                    ...(tx?.meta?.loadedAddresses?.readonly ?? []),
+                ];
+                const emitted = (tx?.meta?.innerInstructions ?? [])
+                    .flatMap((group) => group.instructions)
+                    .filter((ix) => keys[ix.programIdIndex] === INTENT_ENGINE_PROGRAM_ADDRESS)
+                    .map((ix) => Uint8Array.from(getBase58Encoder().encode(ix.data)));
+                found.push({
+                    signature: entry.signature,
+                    slot: entry.slot,
+                    blockTime: entry.blockTime,
+                    failed: entry.err !== null,
+                    emitted,
+                });
+            }
+            return found;
+        },
+        async intents(owner) {
+            const found = await patiently(() => rpc
+                .getProgramAccounts(INTENT_ENGINE_PROGRAM_ADDRESS, {
+                encoding: "base64",
+                filters: [
+                    { dataSize: BigInt(getIntentSize()) },
+                    {
+                        memcmp: {
+                            offset: 0n,
+                            bytes: getBase58Decoder().decode(getIntentDiscriminatorBytes()),
+                            encoding: "base58",
+                        },
+                    },
+                    ...(owner === undefined
+                        ? []
+                        : [{ memcmp: { offset: INTENT_OWNER_OFFSET, bytes: owner, encoding: "base58" } }]),
+                ],
+            })
+                .send(), wait);
+            return found.map(({ pubkey, account }) => ({
+                address: pubkey,
+                data: new Uint8Array(Buffer.from(account.data[0], "base64")),
+            }));
+        },
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/src/transport.js.map

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

package/dist/src/treasury.d.ts

@@ -0,0 +1,27 @@
+import { type Address, type KeyPairSigner } from "@solana/kit";
+import { SOL_DECIMALS } from "./agent/read.js";
+import type { Transport } from "./transport.js";
+export { SOL_DECIMALS };
+export type TreasuryToken = {
+    mint: Address;
+    token_program: Address;
+    decimals: number;
+    account: Address;
+    exists: boolean;
+    balance: bigint;
+    balance_tokens: string;
+};
+export type TreasuryView = {
+    fee_recipient: Address;
+    lamports: bigint;
+    sol: string;
+    tokens: TreasuryToken[];
+    missing: Address[];
+    warnings: string[];
+};
+export declare const TREASURY_IS_PROGRAM = "the treasury is a program account, which cannot receive SOL, so the engine withholds every create fee; point fee_recipient at a wallet or multisig vault";
+export declare const treasuryTooEmpty: (fee: number, short: bigint) => string;
+export declare function intentInputMints(transport: Transport): Promise<Address[]>;
+export declare function treasuryView(transport: Transport, mints: readonly Address[]): Promise<TreasuryView>;
+export declare const NOTHING_TO_CREATE = "nothing to create: the treasury already holds an account for every token listed";
+export declare function createTreasuryAccounts(transport: Transport, view: TreasuryView, payer: KeyPairSigner, yes: boolean): Promise<object>;