@intent-engine/client 0.1.23 → 0.1.27

package/dist/src/client-settle.js

@@ -0,0 +1,180 @@
+import { createNoopSigner, getAddressDecoder } from "@solana/kit";
+import { attestedProofMessage, buildCommitteeBatch, buildFillAttested, claimBoardAddress, CLAIMS_OPEN, getClaimBoardDecoder, getClaimBoardDiscriminatorBytes, IntentCoreError, stakeReceiverOnRelease, buildFillAttestedCommittee, committeeProofDigest, committeeSigners, decodeParams, feeBpsFor, IntentStatus, isSha256Hex, Kind, releaseMemo, signEd25519Instruction, splitFees, verifyCommitteeVote, } from "@intent-engine/core";
+import { chainTime, createdAccount, engineAccount, loadIntent, SYSTEM_PROGRAM_ADDRESS } from "./accounts.js";
+import { loadCommittee } from "./client-committee.js";
+import { EscrowExpired, NotSettleable, PayeeMoved, PayToNotWallet, VoteRejected } from "./client-errors.js";
+import { memoInstruction } from "./jobs.js";
+import { tokenAccountIfMissing } from "./setup.js";
+async function claimStakeTo(transport, intent, claims, payTo) {
+    if (claims !== CLAIMS_OPEN)
+        return null;
+    const board = await claimBoardAddress(intent);
+    const data = await engineAccount(transport, board, getClaimBoardDiscriminatorBytes(), "claim board");
+    const view = getClaimBoardDecoder().decode(data);
+    try {
+        return stakeReceiverOnRelease(view, await chainTime(transport), [payTo]);
+    }
+    catch (error) {
+        if (error instanceof IntentCoreError) {
+            throw new NotSettleable(intent, `is claimed by ${view.worker} until ${view.until}, so only that worker can be paid until then`);
+        }
+        throw error;
+    }
+}
+function checkedSha256(deliveredSha256) {
+    const lowered = deliveredSha256?.toLowerCase();
+    if (lowered !== undefined && !isSha256Hex(lowered)) {
+        throw new RangeError("deliveredSha256 must be 64 hex digits");
+    }
+    return lowered;
+}
+async function planRelease({ transport, mint, config }, target, judgeOf) {
+    const { owner, nonce, payTo, result, payer } = target;
+    const [{ address, intent: held }, settings] = await Promise.all([loadIntent(transport, owner, nonce), config()]);
+    const params = decodeParams(held.kind, Uint8Array.from(held.params));
+    if (params.kind !== Kind.AttestedResult) {
+        throw new NotSettleable(address, "is not an AttestedResult intent");
+    }
+    if (params.specHash.every((b) => b === 0)) {
+        throw new NotSettleable(address, "commits no spec hash, so it is not a proof intent");
+    }
+    if (held.status !== IntentStatus.Open) {
+        throw new NotSettleable(address, "is not open");
+    }
+    const { feeOwner, judge } = await judgeOf(params.attestor, address);
+    if (held.expiresAt <= (await chainTime(transport))) {
+        throw new EscrowExpired(address, held.expiresAt);
+    }
+    const holder = await transport.getAccount(payTo);
+    if (holder !== null && holder.owner !== SYSTEM_PROGRAM_ADDRESS) {
+        throw new PayToNotWallet(payTo, holder.owner);
+    }
+    const stakeTo = await claimStakeTo(transport, address, held.claims, payTo);
+    const { tokenProgram } = await mint(held.inputMint);
+    const account = (wallet) => tokenAccountIfMissing(transport, payer, wallet, held.inputMint, tokenProgram);
+    const amountIn = held.escrowed - held.filled;
+    const kindBps = feeBpsFor(settings, held.kind);
+    const maxFeeBps = kindBps + held.partnerBps;
+    const shares = splitFees(amountIn - params.judgeFee, kindBps, held.partnerBps, held.partnerCutBps);
+    const feeRecipient = shares.protocol > 0n ? settings.feeRecipient : undefined;
+    const partner = shares.partner > 0n ? held.partner : undefined;
+    const paidJudge = params.judgeFee > 0n ? feeOwner : undefined;
+    const payee = await account(payTo);
+    if (payee.create.length === 0) {
+        const existing = await createdAccount(transport, payee.address);
+        const data = existing === null || existing.owner !== tokenProgram || existing.data.length < 64 ? null : existing.data;
+        if (data === null ||
+            getAddressDecoder().decode(data.subarray(0, 32)) !== held.inputMint ||
+            getAddressDecoder().decode(data.subarray(32, 64)) !== payTo) {
+            throw new PayeeMoved(payTo, payee.address);
+        }
+    }
+    const others = await Promise.all([feeRecipient, partner, paidJudge].filter((wallet) => wallet !== undefined).map(account));
+    const fields = { amountIn, result, maxFeeBps };
+    return {
+        intent: address,
+        judge,
+        proof: {
+            ...fields,
+            domain: Uint8Array.from(settings.domain),
+            intent: address,
+            payee: payee.address,
+            filled: held.filled,
+            revision: held.revision,
+            specHash: params.specHash,
+        },
+        fill: {
+            ...fields,
+            owner,
+            nonce,
+            inputMint: held.inputMint,
+            inputTokenProgram: tokenProgram,
+            payee: payee.address,
+            ...(feeRecipient === undefined ? {} : { feeRecipient }),
+            ...(partner === undefined ? {} : { partner }),
+            ...(paidJudge === undefined ? {} : { judge: paidJudge }),
+        },
+        setup: [payee, ...others].flatMap(({ create }) => create),
+        claims: held.claims === CLAIMS_OPEN
+            ? { claims: await claimBoardAddress(address), ...(stakeTo === null ? {} : { stakeTo }) }
+            : {},
+    };
+}
+function recorded(payer, deliveredSha256) {
+    return deliveredSha256 === undefined ? [] : [memoInstruction(payer, releaseMemo(deliveredSha256))];
+}
+export function proofSettlement(context) {
+    const settleProof = async (input) => {
+        const { judge } = input;
+        const deliveredSha256 = checkedSha256(input.deliveredSha256);
+        const payer = input.payer ?? judge;
+        const plan = await planRelease(context, { ...input, payer }, async (attestor, intent) => {
+            if (attestor !== judge.address) {
+                throw new NotSettleable(intent, `names ${attestor} as its judge, not ${judge.address}`);
+            }
+            return { feeOwner: judge.address, judge: judge.address };
+        });
+        const message = await attestedProofMessage(judge.address, plan.proof);
+        const settle = await buildFillAttested({ ...plan.fill, ...plan.claims, solver: judge });
+        return context.send([...plan.setup, await signEd25519Instruction(judge, message), settle, ...recorded(judge, deliveredSha256)], payer);
+    };
+    return settleProof;
+}
+export function committeeSettlement(context) {
+    const planned = async (target) => {
+        const plan = await planRelease(context, target, async (attestor, intent) => {
+            const committee = await loadCommittee(context.transport, attestor);
+            if (committee === null) {
+                throw new NotSettleable(intent, `names ${attestor} as its judge, which is not a committee`);
+            }
+            return { feeOwner: committee.feeWallet, judge: committee };
+        });
+        return { plan, committee: plan.judge, digest: await committeeProofDigest(plan.proof) };
+    };
+    const committeeBallot = async (input) => {
+        const { plan, committee, digest } = await planned({ ...input, payer: createNoopSigner(input.payTo) });
+        return { intent: plan.intent, committee, payee: plan.proof.payee, digest };
+    };
+    const prepareCommitteeRelease = async (input) => {
+        const deliveredSha256 = checkedSha256(input.deliveredSha256);
+        const payer = input.payer ?? input.solver;
+        const { plan, committee, digest } = await planned({ ...input, payer });
+        for (const vote of input.votes) {
+            if (!(await verifyCommitteeVote(vote, digest))) {
+                throw new VoteRejected(vote.member, plan.intent);
+            }
+        }
+        if (deliveredSha256 !== undefined && !input.votes.some((vote) => vote.member === input.solver.address)) {
+            throw new NotSettleable(plan.intent, `records the delivered work only when a member who voted submits the release, and ${input.solver.address} did not vote`);
+        }
+        const needed = [...input.votes]
+            .sort((a, b) => committee.members.indexOf(a.member) - committee.members.indexOf(b.member))
+            .slice(0, committee.threshold);
+        const { instruction, mask } = buildCommitteeBatch(committee, digest, needed);
+        const settle = await buildFillAttestedCommittee({
+            ...plan.fill,
+            ...plan.claims,
+            solver: input.solver,
+            committee: committee.address,
+            signers: mask,
+        });
+        return {
+            intent: plan.intent,
+            committee,
+            payee: plan.proof.payee,
+            signers: committeeSigners(committee, mask),
+            payer,
+            setup: plan.setup,
+            instructions: [instruction, settle, ...recorded(input.solver, deliveredSha256)],
+        };
+    };
+    const settleCommittee = async (input) => {
+        const { setup, instructions, payer } = await prepareCommitteeRelease(input);
+        if (setup.length > 0) {
+            await context.send(setup, payer);
+        }
+        return context.send(instructions, payer);
+    };
+    return { committeeBallot, prepareCommitteeRelease, settleCommittee };
+}
+//# sourceMappingURL=client-settle.js.map

package/dist/src/client-settle.js.map

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

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

@@ -0,0 +1,192 @@
+import type { Address, Instruction, KeyPairSigner, Signature, TransactionSigner } from "@solana/kit";
+import type { CommitteeTerms, CommitteeVote, Config, EngineEvent, Intent, IntentParams } from "@intent-engine/core";
+import type { Priority } from "./budget.js";
+import type { FeedbackInput, Reputation, ReputationOptions } from "./reputation.js";
+import type { EngineError } from "./errors.js";
+import type { DeliverInput, Delivery, DeliveryRecord, Job, Spec, SpecFetch } from "./jobs.js";
+import type { Notifications, Simulation, Transport } from "./transport.js";
+export type ClientOptions = {
+    url: string;
+    transport?: Transport;
+    notifications?: Notifications;
+    priority?: Priority;
+    pollMs?: number;
+    resyncSeconds?: number;
+    fetch?: SpecFetch;
+};
+export type IntentAccount = {
+    address: Address;
+    intent: Intent;
+};
+export type IntentFilter = {
+    owner?: Address;
+    status?: number;
+};
+export type WatchCallback = (changed: IntentAccount[], closed: IntentAccount[]) => void;
+export type WatchOptions = {
+    owner?: Address;
+    onError?: (error: unknown) => void;
+};
+export type Mint = {
+    decimals: number;
+    tokenProgram: Address;
+};
+export type CreateIntentInput = {
+    signer: TransactionSigner;
+    params: IntentParams;
+    inputMint: Address;
+    outputMint: Address;
+    expiresIn?: bigint;
+    expiresAt?: bigint;
+    nonce?: bigint;
+    receiver?: Address;
+    specUrl?: string;
+};
+export type CreatedIntent = {
+    signature: Signature;
+    intent: Address;
+    nonce: bigint;
+};
+export type SettleProofInput = {
+    judge: KeyPairSigner;
+    owner: Address;
+    nonce: bigint;
+    payTo: Address;
+    result: bigint;
+    payer?: TransactionSigner;
+    deliveredSha256?: string;
+};
+export type CommitteeView = CommitteeTerms & {
+    address: Address;
+    id: Uint8Array;
+    createdAt: bigint;
+};
+export type CreateCommitteeInput = CommitteeTerms & {
+    payer: TransactionSigner;
+};
+export type CreatedCommittee = {
+    committee: Address;
+    signature: Signature | null;
+};
+export type BallotInput = {
+    owner: Address;
+    nonce: bigint;
+    payTo: Address;
+    result: bigint;
+};
+export type CommitteeBallot = {
+    intent: Address;
+    committee: CommitteeView;
+    payee: Address;
+    digest: Uint8Array;
+};
+export type SettleCommitteeInput = BallotInput & {
+    solver: TransactionSigner;
+    votes: readonly CommitteeVote[];
+    payer?: TransactionSigner;
+    deliveredSha256?: string;
+};
+export type CommitteeRelease = {
+    intent: Address;
+    committee: CommitteeView;
+    payee: Address;
+    signers: Address[];
+    payer: TransactionSigner;
+    setup: Instruction[];
+    instructions: Instruction[];
+};
+export type HistoryEvent = EngineEvent & {
+    signature: Signature;
+    slot: bigint;
+    blockTime: bigint | null;
+    deliveredSha256?: string;
+};
+export type FillInput = {
+    solver: TransactionSigner;
+    owner: Address;
+    nonce: bigint;
+    amountIn?: bigint;
+    amountOut?: bigint;
+    route?: readonly Instruction[];
+};
+export type Fill = {
+    steps: 1 | 2;
+    solver: Address;
+    delivered: bigint;
+    required: bigint;
+    fee: bigint;
+    net: bigint;
+    signature: Signature;
+    slot: bigint;
+    blockTime: bigint | null;
+};
+export type TokenBalance = {
+    mint: Address;
+    name: string | undefined;
+    account: Address;
+    amount: bigint;
+    decimals: number;
+};
+export type Balances = {
+    sol: bigint;
+    tokens: TokenBalance[];
+};
+export type Client = {
+    readonly url: string;
+    readonly transport: Transport;
+    config(): Promise<Config>;
+    intent(owner: Address, nonce: bigint): Promise<IntentAccount | null>;
+    intents(filter?: IntentFilter): Promise<IntentAccount[]>;
+    history(intent: Address, limit?: number): Promise<HistoryEvent[]>;
+    nextNonce(owner: Address): Promise<bigint>;
+    simulate(instructions: readonly Instruction[], signer: TransactionSigner): Promise<Simulation>;
+    send(instructions: readonly Instruction[], signer: TransactionSigner): Promise<Signature>;
+    watch(onChange: WatchCallback, signal: AbortSignal, filter?: WatchOptions): Promise<void>;
+    explain(error: unknown): EngineError | null;
+    mint(address: Address): Promise<Mint>;
+    chainTime(): Promise<bigint>;
+    createIntent(input: CreateIntentInput): Promise<CreatedIntent>;
+    cancel(signer: TransactionSigner, nonce: bigint): Promise<Signature>;
+    unwrap(signer: TransactionSigner): Promise<Signature | null>;
+    settleProof(input: SettleProofInput): Promise<Signature>;
+    committee(address: Address): Promise<CommitteeView | null>;
+    createCommittee(input: CreateCommitteeInput): Promise<CreatedCommittee>;
+    committeeBallot(input: BallotInput): Promise<CommitteeBallot>;
+    prepareCommitteeRelease(input: SettleCommitteeInput): Promise<CommitteeRelease>;
+    settleCommittee(input: SettleCommitteeInput): Promise<Signature>;
+    reputation(wallet: Address, options?: ReputationOptions): Promise<Reputation>;
+    feedback(input: FeedbackInput): Promise<Signature>;
+    fill(input: FillInput): Promise<Signature>;
+    fillOf(intent: Address): Promise<Fill | null>;
+    expire(cranker: TransactionSigner, owner: Address, nonce: bigint): Promise<Signature>;
+    close(cranker: TransactionSigner, owner: Address, nonce: bigint): Promise<Signature>;
+    balances(owner: Address, mints: readonly Address[]): Promise<Balances>;
+    jobs(filter?: {
+        attestor?: Address;
+    }): Promise<Job[]>;
+    spec(intent: Address): Promise<Spec | null>;
+    deliver(input: DeliverInput): Promise<Signature>;
+    deliveries(filter: {
+        judge: Address;
+        intent?: Address;
+    }): Promise<Delivery[]>;
+    deliveryRecord(filter: {
+        judge: Address;
+        intent?: Address;
+        pages?: number;
+    }): Promise<DeliveryRecord>;
+};
+export declare const SPEC_URL_NEEDS_PROOF = "specUrl needs an AttestedResult intent with a non-zero specHash";
+export declare const DEFAULT_EXPIRES_IN = 3600n;
+export declare const MIN_EXPIRES_IN = 60n;
+export declare const MAX_EXPIRES_IN = 31536000n;
+export declare const EXPIRES_IN_RANGE: string;
+export declare const HISTORY_LIMIT = 100;
+export declare const WATCH_POLL_MS = 2000;
+export declare const WATCH_WAIT_SECONDS = 10;
+export type ClientContext = {
+    transport: Transport;
+    send(instructions: readonly Instruction[], signer: TransactionSigner): Promise<Signature>;
+    mint(address: Address): Promise<Mint>;
+    config(): Promise<Config>;
+};

package/dist/src/client-types.js

@@ -0,0 +1,9 @@
+export const SPEC_URL_NEEDS_PROOF = "specUrl needs an AttestedResult intent with a non-zero specHash";
+export const DEFAULT_EXPIRES_IN = 3600n;
+export const MIN_EXPIRES_IN = 60n;
+export const MAX_EXPIRES_IN = 31536000n;
+export const EXPIRES_IN_RANGE = `expiresIn must be from ${MIN_EXPIRES_IN} to ${MAX_EXPIRES_IN} seconds`;
+export const HISTORY_LIMIT = 100;
+export const WATCH_POLL_MS = 2_000;
+export const WATCH_WAIT_SECONDS = 10;
+//# sourceMappingURL=client-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client-types.js","sourceRoot":"","sources":["../../src/client-types.ts"],"names":[],"mappings":"AAyJA,MAAM,CAAC,MAAM,oBAAoB,GAAG,iEAAiE,CAAC;AAEtG,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAM,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAG,SAAW,CAAC;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAA0B,cAAc,OAAO,cAAc,UAAU,CAAC;AACxG,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC"}

package/dist/src/client-watch.d.ts

@@ -0,0 +1,4 @@
+import type { IntentAccount, WatchCallback, WatchOptions } from "./client-types.js";
+import { type Notifications, type ProgramAccount, type Transport } from "./transport.js";
+export declare const decoded: ({ address, data }: ProgramAccount) => IntentAccount;
+export declare function watchIntents(transport: Transport, notifications: Notifications | undefined, pollMs: number, resyncSeconds: number): (onChange: WatchCallback, signal: AbortSignal, filter?: WatchOptions) => Promise<void>;

package/dist/src/client-watch.js

@@ -0,0 +1,97 @@
+import { getIntentDecoder } from "@intent-engine/core";
+import { changesFrom, pause } from "./transport.js";
+export const decoded = ({ address, data }) => ({ address, intent: getIntentDecoder().decode(data) });
+export function watchIntents(transport, notifications, pollMs, resyncSeconds) {
+    const watch = async (onChange, signal, filter = {}) => {
+        if (signal.aborted) {
+            return;
+        }
+        const seen = new Map();
+        const fresh = (accounts) => accounts.flatMap((account) => {
+            const view = decoded(account);
+            if (filter.owner !== undefined && view.intent.owner !== filter.owner) {
+                return [];
+            }
+            const key = Buffer.from(account.data).toString("base64");
+            if (seen.get(account.address)?.key === key) {
+                return [];
+            }
+            seen.set(account.address, { key, view });
+            return [view];
+        });
+        let read = false;
+        const report = (changed, closed, first = false) => {
+            if ((changed.length > 0 || closed.length > 0 || first) && !signal.aborted) {
+                onChange(changed, closed);
+            }
+        };
+        let highest;
+        const raise = (slot) => {
+            if (slot !== undefined && (highest === undefined || slot > highest)) {
+                highest = slot;
+            }
+        };
+        const failed = (error) => {
+            if (!signal.aborted) {
+                filter.onError?.(error);
+            }
+        };
+        const sync = async (heard) => {
+            raise(heard);
+            const floor = highest;
+            const reading = {
+                ...(floor === undefined ? {} : { minContextSlot: floor }),
+                onSlot: (slot) => {
+                    reading.at = slot;
+                },
+            };
+            const accounts = await transport.intents(filter.owner, reading).catch((error) => {
+                failed(error);
+                return null;
+            });
+            if (accounts === null) {
+                return;
+            }
+            if (reading.at !== undefined && floor !== undefined && reading.at < floor) {
+                failed(new Error(`the intents read at slot ${reading.at} is older than slot ${floor}, which the watch has already seen`));
+                return;
+            }
+            raise(reading.at);
+            const present = new Set(accounts.map(({ address }) => address));
+            const changed = fresh(accounts);
+            const closed = [...seen].filter(([address]) => !present.has(address)).map(([, { view }]) => view);
+            for (const { address } of closed) {
+                seen.delete(address);
+            }
+            report(changed, closed, !read);
+            read = true;
+        };
+        if (notifications === undefined) {
+            while (!signal.aborted) {
+                await sync();
+                await pause(pollMs, signal);
+            }
+            return;
+        }
+        const changes = changesFrom(notifications);
+        const stop = () => changes.close();
+        signal.addEventListener("abort", stop, { once: true });
+        try {
+            await sync();
+            let synced = Date.now();
+            while (!signal.aborted) {
+                report(fresh((await changes.wait(resyncSeconds)) ?? []), []);
+                if (!signal.aborted && Date.now() - synced >= resyncSeconds * 1000) {
+                    await sync(changes.slot?.());
+                    synced = Date.now();
+                }
+            }
+        }
+        finally {
+            signal.removeEventListener("abort", stop);
+            changes.close();
+        }
+    };
+    return watch;
+}
+//# sourceMappingURL=client-watch.js.map

package/dist/src/client-watch.js.map

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

package/dist/src/client.d.ts

@@ -1,141 +1,6 @@
-import { type Address, type Instruction, type KeyPairSigner, type Signature, type TransactionSigner } from "@solana/kit";
-import { type Config, type EngineEvent, type Intent, type IntentParams } from "@intent-engine/core";
-import { type Priority } from "./budget.js";
-import { type EngineError } from "./errors.js";
-import { type DeliverInput, type Delivery, type Job, type Spec, type SpecFetch } from "./jobs.js";
-import { type Notifications, type Simulation, type Transport } from "./transport.js";
-export type ClientOptions = {
-    url: string;
-    transport?: Transport;
-    notifications?: Notifications;
-    priority?: Priority;
-    pollMs?: number;
-    resyncSeconds?: number;
-    fetch?: SpecFetch;
-};
-export type IntentAccount = {
-    address: Address;
-    intent: Intent;
-};
-export type IntentFilter = {
-    owner?: Address;
-    status?: number;
-};
-export type WatchCallback = (changed: IntentAccount[], closed: IntentAccount[]) => void;
-export type Mint = {
-    decimals: number;
-    tokenProgram: Address;
-};
-export type CreateIntentInput = {
-    signer: TransactionSigner;
-    params: IntentParams;
-    inputMint: Address;
-    outputMint: Address;
-    expiresIn?: bigint;
-    expiresAt?: bigint;
-    nonce?: bigint;
-    receiver?: Address;
-    specUrl?: string;
-};
-export type CreatedIntent = {
-    signature: Signature;
-    intent: Address;
-    nonce: bigint;
-};
-export type SettleProofInput = {
-    judge: KeyPairSigner;
-    owner: Address;
-    nonce: bigint;
-    payTo: Address;
-    result: bigint;
-    payer?: TransactionSigner;
-    deliveredSha256?: string;
-};
-export type HistoryEvent = EngineEvent & {
-    signature: Signature;
-    slot: bigint;
-    blockTime: bigint | null;
-};
-export type FillInput = {
-    solver: TransactionSigner;
-    owner: Address;
-    nonce: bigint;
-    amountIn?: bigint;
-    amountOut?: bigint;
-    route?: readonly Instruction[];
-};
-export type Fill = {
-    steps: 1 | 2;
-    solver: Address;
-    delivered: bigint;
-    required: bigint;
-    fee: bigint;
-    net: bigint;
-    signature: Signature;
-    slot: bigint;
-    blockTime: bigint | null;
-};
-export type TokenBalance = {
-    mint: Address;
-    name: string | undefined;
-    account: Address;
-    amount: bigint;
-    decimals: number;
-};
-export type Balances = {
-    sol: bigint;
-    tokens: TokenBalance[];
-};
-export type Client = {
-    readonly url: string;
-    readonly transport: Transport;
-    config(): Promise<Config>;
-    intent(owner: Address, nonce: bigint): Promise<IntentAccount | null>;
-    intents(filter?: IntentFilter): Promise<IntentAccount[]>;
-    history(intent: Address, limit?: number): Promise<HistoryEvent[]>;
-    nextNonce(owner: Address): Promise<bigint>;
-    simulate(instructions: readonly Instruction[], signer: TransactionSigner): Promise<Simulation>;
-    send(instructions: readonly Instruction[], signer: TransactionSigner): Promise<Signature>;
-    watch(onChange: WatchCallback, signal: AbortSignal, filter?: {
-        owner?: Address;
-    }): Promise<void>;
-    explain(error: unknown): EngineError | null;
-    mint(address: Address): Promise<Mint>;
-    chainTime(): Promise<bigint>;
-    createIntent(input: CreateIntentInput): Promise<CreatedIntent>;
-    cancel(signer: TransactionSigner, nonce: bigint): Promise<Signature>;
-    unwrap(signer: TransactionSigner): Promise<Signature | null>;
-    settleProof(input: SettleProofInput): Promise<Signature>;
-    fill(input: FillInput): Promise<Signature>;
-    fillOf(intent: Address): Promise<Fill | null>;
-    expire(cranker: TransactionSigner, owner: Address, nonce: bigint): Promise<Signature>;
-    close(cranker: TransactionSigner, owner: Address, nonce: bigint): Promise<Signature>;
-    balances(owner: Address, mints: readonly Address[]): Promise<Balances>;
-    jobs(filter?: {
-        attestor?: Address;
-    }): Promise<Job[]>;
-    spec(intent: Address): Promise<Spec | null>;
-    deliver(input: DeliverInput): Promise<Signature>;
-    deliveries(filter: {
-        judge: Address;
-        intent?: Address;
-    }): Promise<Delivery[]>;
-};
-export declare const SPEC_URL_NEEDS_PROOF = "specUrl needs an AttestedResult intent with a non-zero specHash";
-export declare const DEFAULT_EXPIRES_IN = 3600n;
-export declare const HISTORY_LIMIT = 100;
-export declare const WATCH_POLL_MS = 2000;
-export declare const WATCH_WAIT_SECONDS = 10;
-export declare class NoFreeNonce extends Error {
-    readonly owner: Address;
-    constructor(owner: Address);
-}
-export declare class NotSettleable extends Error {
-    readonly intent: Address;
-    constructor(intent: Address, reason: string);
-}
-export declare class NotFillable extends Error {
-    readonly intent: Address;
-    constructor(intent: Address, reason: string);
-}
+export { loadCommittee } from "./client-committee.js";
+import { type Client, type ClientOptions } from "./client-types.js";
+export type { Balances, BallotInput, Client, ClientOptions, CommitteeBallot, CommitteeRelease, CommitteeView, CreateCommitteeInput, CreatedCommittee, CreatedIntent, CreateIntentInput, Fill, FillInput, HistoryEvent, IntentAccount, IntentFilter, Mint, SettleCommitteeInput, SettleProofInput, TokenBalance, WatchCallback, WatchOptions, } from "./client-types.js";
+export { DEFAULT_EXPIRES_IN, EXPIRES_IN_RANGE, HISTORY_LIMIT, MAX_EXPIRES_IN, MIN_EXPIRES_IN, SPEC_URL_NEEDS_PROOF, WATCH_POLL_MS, WATCH_WAIT_SECONDS, } from "./client-types.js";
+export { EscrowExpired, NoFreeNonce, NotFillable, NotSettleable, PayeeMoved, PayToNotWallet, VoteRejected, } from "./client-errors.js";
 export declare function createClient(options: ClientOptions): Client;