@intent-engine/client 0.1.26 → 0.1.27

package/dist/src/simple-tokens.js

@@ -0,0 +1,84 @@
+import { isAddress } from "@solana/kit";
+import { DEVNET_TEST_MINT, formatAmount, NATIVE_MINT, parseAmount, tokenName } from "@intent-engine/core";
+export const CLUSTER_URLS = {
+    devnet: "https://api.devnet.solana.com",
+    testnet: "https://api.testnet.solana.com",
+    mainnet: "https://api.mainnet-beta.solana.com",
+    localnet: "http://127.0.0.1:8899",
+};
+export const MAINNET_REFUSED = "this url serves mainnet; pass allowMainnet: true to connect to it";
+export class MainnetNotAllowed extends Error {
+    url;
+    constructor(url) {
+        super(`${url}: ${MAINNET_REFUSED}`);
+        this.name = "MainnetNotAllowed";
+        this.url = url;
+    }
+}
+export function clusterUrl(options) {
+    if (options.url !== undefined && options.cluster !== undefined) {
+        throw new TypeError("pass cluster or url, not both");
+    }
+    if (options.url !== undefined) {
+        return options.url;
+    }
+    if (options.cluster === undefined || !(options.cluster in CLUSTER_URLS)) {
+        throw new TypeError(`pass url, or cluster as one of ${Object.keys(CLUSTER_URLS).join(", ")}`);
+    }
+    return CLUSTER_URLS[options.cluster];
+}
+export function mintOfToken(token, url) {
+    const name = token.trim();
+    if (name.toUpperCase() === "SOL") {
+        return NATIVE_MINT;
+    }
+    if (name.toUpperCase() === "TEST") {
+        if (url !== CLUSTER_URLS.devnet) {
+            throw new RangeError(`TEST names the devnet test token; on ${url} pass the token's mint address`);
+        }
+        return DEVNET_TEST_MINT;
+    }
+    if (!isAddress(name)) {
+        throw new RangeError(`${token} is not SOL, TEST or a token mint address`);
+    }
+    return name;
+}
+export const nameOfMint = (mint) => tokenName(mint) ?? mint;
+export function tokenAmount(text, decimals, field = "amount") {
+    let raw;
+    try {
+        raw = parseAmount(text.trim(), decimals);
+    }
+    catch (error) {
+        throw new RangeError(`${field}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (raw === 0n) {
+        throw new RangeError(`${field}: ${text} must be more than 0`);
+    }
+    return raw;
+}
+export const wholeTokens = (raw, decimals, mint) => `${formatAmount(raw, decimals)} ${nameOfMint(mint)}`;
+export function secondsOf(value, fallback) {
+    if (value === undefined) {
+        return fallback;
+    }
+    if (typeof value === "number" && !Number.isSafeInteger(value)) {
+        throw new RangeError(`expiresIn ${value} is not a whole number of seconds`);
+    }
+    return BigInt(value);
+}
+export function specHashBytes(specHash) {
+    if (typeof specHash !== "string") {
+        if (specHash.length !== 32) {
+            throw new RangeError("specHash must be 32 bytes");
+        }
+        return Uint8Array.from(specHash);
+    }
+    const hex = specHash.trim().toLowerCase();
+    if (!/^[0-9a-f]{64}$/.test(hex)) {
+        throw new RangeError("specHash must be a sha256 as 64 hex digits");
+    }
+    return Uint8Array.from(hex.match(/../g) ?? [], (pair) => Number.parseInt(pair, 16));
+}
+export const hexOf = (bytes) => Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+//# sourceMappingURL=simple-tokens.js.map

package/dist/src/simple-tokens.js.map

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

package/dist/src/simple-types.d.ts

@@ -0,0 +1,111 @@
+import type { Address, Instruction, Signature, TransactionSigner } from "@solana/kit";
+import type { Priority } from "./budget.js";
+import type { Client, WatchCallback, WatchOptions } from "./client-types.js";
+import type { Job } from "./jobs.js";
+import type { Cluster } from "./simple-tokens.js";
+import type { Transport } from "./transport.js";
+export type ConnectOptions = ({
+    cluster: Cluster;
+    url?: undefined;
+} | {
+    url: string;
+    cluster?: undefined;
+}) & {
+    signer: TransactionSigner;
+    transport?: Transport;
+    priority?: Priority;
+    allowMainnet?: boolean;
+};
+export type Sent = {
+    signature: Signature;
+    intent?: Address;
+    nonce?: bigint;
+    summary: string;
+};
+export type Preview = {
+    summary: string;
+    instructions: Instruction[];
+    intent?: Address;
+    nonce?: bigint;
+};
+export type PreviewOption = {
+    preview?: boolean;
+};
+export type Outcome<I> = I extends {
+    preview: true;
+} ? Preview : Sent;
+export type Seconds = number | bigint;
+export type SwapInput = PreviewOption & {
+    sell: string;
+    amount: string;
+    buy: string;
+    minReceive: string;
+    expiresIn?: Seconds;
+};
+export type LimitInput = PreviewOption & {
+    sell: string;
+    amount: string;
+    buy: string;
+    price: string;
+    expiresIn?: Seconds;
+};
+export type PayForWorkInput = PreviewOption & {
+    amount: string;
+    token?: string;
+    judge: Address;
+    specHash: string | Uint8Array;
+    specUrl?: string;
+    judgeFee?: string;
+    expiresIn?: Seconds;
+    recordToken?: string;
+};
+export type DeliverWorkInput = PreviewOption & {
+    escrow: Address;
+    sha256: string;
+    url: string;
+};
+export type ReleaseInput = PreviewOption & {
+    escrow: Address;
+    to: Address;
+    deliveredSha256: string;
+    result?: number | bigint;
+};
+export type CancelInput = PreviewOption & ({
+    escrow: Address;
+    intent?: undefined;
+} | {
+    intent: Address;
+    escrow?: undefined;
+});
+export type HeldToken = {
+    token: string;
+    mint: Address;
+    account: Address;
+    amount: string;
+};
+export type WalletBalance = {
+    sol: string;
+    tokens: HeldToken[];
+    summary: string;
+};
+export type OpenWork = Job & {
+    amount: string;
+    fee: string;
+    token: string;
+};
+export type SimpleClient = {
+    readonly url: string;
+    readonly signer: TransactionSigner;
+    readonly client: Client;
+    balance(tokens?: readonly string[]): Promise<WalletBalance>;
+    swap<I extends SwapInput>(input: I): Promise<Outcome<I>>;
+    limit<I extends LimitInput>(input: I): Promise<Outcome<I>>;
+    payForWork<I extends PayForWorkInput>(input: I): Promise<Outcome<I>>;
+    findWork(filter?: {
+        judge?: Address;
+    }): Promise<OpenWork[]>;
+    deliver<I extends DeliverWorkInput>(input: I): Promise<Outcome<I>>;
+    release<I extends ReleaseInput>(input: I): Promise<Outcome<I>>;
+    cancel<I extends CancelInput>(input: I): Promise<Outcome<I>>;
+    watch(onChange: WatchCallback, signal: AbortSignal, filter?: WatchOptions): Promise<void>;
+};

package/dist/src/simple-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=simple-types.js.map

package/dist/src/simple-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-types.js","sourceRoot":"","sources":["../../src/simple-types.ts"],"names":[],"mappings":""}

package/dist/src/simple-work.d.ts

@@ -0,0 +1,12 @@
+import { type Address } from "@solana/kit";
+import { type SimpleContext } from "./simple-orders.js";
+import type { CancelInput, DeliverWorkInput, OpenWork, ReleaseInput } from "./simple-types.js";
+export declare const RELEASE_NEEDS_KEY_PAIR = "release signs the judge's verdict, so connect with a key pair signer";
+export declare function workSends(ctx: SimpleContext): {
+    findWork: (filter?: {
+        judge?: Address;
+    }) => Promise<OpenWork[]>;
+    deliver: (input: DeliverWorkInput) => Promise<import("./simple-types.js").Preview | import("./simple-types.js").Sent>;
+    release: (input: ReleaseInput) => Promise<import("./simple-types.js").Preview | import("./simple-types.js").Sent>;
+    cancel: (input: CancelInput) => Promise<import("./simple-types.js").Preview | import("./simple-types.js").Sent>;
+};

package/dist/src/simple-work.js

@@ -0,0 +1,69 @@
+import { isKeyPairSigner } from "@solana/kit";
+import { formatAmount, isSha256Hex } from "@intent-engine/core";
+import { NotSettleable } from "./client-errors.js";
+import { intentAt } from "./jobs.js";
+import { outcome } from "./simple-orders.js";
+import { nameOfMint, wholeTokens } from "./simple-tokens.js";
+export const RELEASE_NEEDS_KEY_PAIR = "release signs the judge's verdict, so connect with a key pair signer";
+export function workSends(ctx) {
+    const held = async (address) => {
+        const intent = await intentAt(ctx.client.transport, address);
+        if (intent === null) {
+            throw new NotSettleable(address, "is not an intent account of the engine");
+        }
+        return { intent, mint: await ctx.client.mint(intent.inputMint) };
+    };
+    const findWork = async (filter = {}) => {
+        const jobs = await ctx.client.jobs(filter.judge === undefined ? {} : { attestor: filter.judge });
+        return Promise.all(jobs.map(async (job) => {
+            const { decimals } = await ctx.client.mint(job.inputMint);
+            return { ...job, amount: formatAmount(job.sells, decimals), fee: formatAmount(job.judgeFee, decimals), token: nameOfMint(job.inputMint) };
+        }));
+    };
+    const deliver = async (input) => {
+        if (!isSha256Hex(input.sha256.trim().toLowerCase())) {
+            throw new RangeError("sha256 must be 64 hex digits");
+        }
+        const sha256 = input.sha256.trim().toLowerCase();
+        const summary = `Deliver work ${sha256} at ${input.url} for escrow ${input.escrow}`;
+        return outcome(ctx, input.preview, summary, async (client) => ({
+            signature: await client.deliver({ worker: ctx.signer, intent: input.escrow, sha256, url: input.url }),
+        }));
+    };
+    const release = async (input) => {
+        const judge = ctx.signer;
+        if (!isKeyPairSigner(judge)) {
+            throw new TypeError(RELEASE_NEEDS_KEY_PAIR);
+        }
+        const { intent, mint } = await held(input.escrow);
+        const result = BigInt(input.result ?? 1n);
+        const summary = `Release escrow ${input.escrow} holding ${wholeTokens(intent.escrowed - intent.filled, mint.decimals, intent.inputMint)} to ${input.to} for work ${input.deliveredSha256.toLowerCase()}`;
+        return outcome(ctx, input.preview, summary, async (client) => ({
+            signature: await client.settleProof({
+                judge,
+                owner: intent.owner,
+                nonce: intent.nonce,
+                payTo: input.to,
+                result,
+                deliveredSha256: input.deliveredSha256,
+            }),
+            intent: input.escrow,
+            nonce: intent.nonce,
+        }));
+    };
+    const cancel = async (input) => {
+        const address = input.escrow ?? input.intent;
+        const { intent, mint } = await held(address);
+        if (intent.owner !== ctx.signer.address) {
+            throw new RangeError(`intent ${address} belongs to ${intent.owner}, not to ${ctx.signer.address}`);
+        }
+        const summary = `Cancel ${address} and return ${wholeTokens(intent.escrowed - intent.filled, mint.decimals, intent.inputMint)} to ${ctx.signer.address}`;
+        return outcome(ctx, input.preview, summary, async (client) => ({
+            signature: await client.cancel(ctx.signer, intent.nonce),
+            intent: address,
+            nonce: intent.nonce,
+        }));
+    };
+    return { findWork, deliver, release, cancel };
+}
+//# sourceMappingURL=simple-work.js.map

package/dist/src/simple-work.js.map

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

package/dist/src/simple.d.ts

@@ -0,0 +1,6 @@
+import type { ConnectOptions, SimpleClient } from "./simple-types.js";
+export type { CancelInput, ConnectOptions, DeliverWorkInput, HeldToken, LimitInput, OpenWork, Outcome, PayForWorkInput, Preview, ReleaseInput, Seconds, Sent, SimpleClient, SwapInput, WalletBalance, } from "./simple-types.js";
+export { ESCROW_EXPIRES_IN, PREVIEW_SIGNATURE, RECORD_TOKEN_NEEDED } from "./simple-orders.js";
+export { RELEASE_NEEDS_KEY_PAIR } from "./simple-work.js";
+export { type Cluster, CLUSTER_URLS, clusterUrl, MAINNET_REFUSED, MainnetNotAllowed, mintOfToken, tokenAmount, } from "./simple-tokens.js";
+export declare function connect(options: ConnectOptions): Promise<SimpleClient>;

package/dist/src/simple.js

@@ -0,0 +1,53 @@
+import { formatAmount, NATIVE_MINT } from "@intent-engine/core";
+import { createClient } from "./client.js";
+import { MAINNET_GENESIS_HASH } from "./jobs.js";
+import { orderSends } from "./simple-orders.js";
+import { CLUSTER_URLS, clusterUrl, MainnetNotAllowed, mintOfToken, nameOfMint, wholeTokens } from "./simple-tokens.js";
+import { workSends } from "./simple-work.js";
+export { ESCROW_EXPIRES_IN, PREVIEW_SIGNATURE, RECORD_TOKEN_NEEDED } from "./simple-orders.js";
+export { RELEASE_NEEDS_KEY_PAIR } from "./simple-work.js";
+export { CLUSTER_URLS, clusterUrl, MAINNET_REFUSED, MainnetNotAllowed, mintOfToken, tokenAmount, } from "./simple-tokens.js";
+const SOL_DECIMALS = 9;
+export async function connect(options) {
+    const url = clusterUrl(options);
+    const { signer } = options;
+    const clientOptions = {
+        url,
+        ...(options.transport === undefined ? {} : { transport: options.transport }),
+        ...(options.priority === undefined ? {} : { priority: options.priority }),
+    };
+    const client = createClient(clientOptions);
+    if (options.allowMainnet !== true && (await client.transport.genesisHash()) === MAINNET_GENESIS_HASH) {
+        throw new MainnetNotAllowed(url);
+    }
+    const ctx = { url, signer, client, options: clientOptions };
+    const { swap, limit, payForWork } = orderSends(ctx);
+    const { findWork, deliver, release, cancel } = workSends(ctx);
+    const balance = async (tokens) => {
+        const named = tokens ?? (url === CLUSTER_URLS.devnet ? ["SOL", "TEST"] : ["SOL"]);
+        const mints = [...new Set(named.map((token) => mintOfToken(token, url)))];
+        const { sol, tokens: held } = await client.balances(signer.address, mints);
+        const listed = held.map(({ mint, account, amount, decimals }) => ({
+            token: nameOfMint(mint),
+            mint,
+            account,
+            amount: formatAmount(amount, decimals),
+        }));
+        const summary = [
+            `${wholeTokens(sol, SOL_DECIMALS, NATIVE_MINT)} in ${signer.address}`,
+            ...held.map(({ mint, amount, decimals }) => `${wholeTokens(amount, decimals, mint)}${mint === NATIVE_MINT ? " wrapped" : ""}`),
+        ].join(", ");
+        return { sol: formatAmount(sol, SOL_DECIMALS), tokens: listed, summary };
+    };
+    const send = { swap, limit, payForWork, deliver, release, cancel };
+    return {
+        url,
+        signer,
+        client,
+        balance,
+        ...send,
+        findWork,
+        watch: (onChange, signal, filter = { owner: signer.address }) => client.watch(onChange, signal, filter),
+    };
+}
+//# sourceMappingURL=simple.js.map

package/dist/src/simple.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intent-engine/client",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "description": "Runtime client for the intent engine on Solana: transport, confirmation, account readers and intent notifications",
   "license": "Apache-2.0",
   "repository": {
@@ -37,8 +37,8 @@
   "dependencies": {
     "@solana-program/system": "0.14.1",
     "@solana-program/token": "0.16.1",
-    "@solana/kit": "^8.4.0",
-    "@intent-engine/core": "0.1.26"
+    "@solana/kit": "8.4.0",
+    "@intent-engine/core": "0.1.27"
   },
   "peerDependencies": {
     "litesvm": "^1.5.0"