@intent-engine/client 0.1.23 → 0.1.27

package/dist/src/reputation.js

@@ -0,0 +1,176 @@
+import { getTransferSolInstruction } from "@solana-program/system";
+import { decodeEvent, feedbackMemo, DELIVERY_MEMO_PREFIX, FILL_ATTESTED_SPLIT_COMMITTEE_DISCRIMINATOR, FILL_ATTESTED_SPLIT_DISCRIMINATOR, findAssociatedTokenAddress, getFillAttestedSplitCommitteeInstructionDataDecoder, getFillAttestedSplitInstructionDataDecoder, parseDeliveryMemo, parseFeedbackMemo, splitN, } from "@intent-engine/core";
+import { mintOf } from "./accounts.js";
+import { loadCommittee } from "./client-committee.js";
+import { HISTORY_LIMIT } from "./client-types.js";
+import { memoInstruction, recordedDelivery } from "./job-memos.js";
+import { NotSettleable } from "./client-errors.js";
+import { engineCalls } from "./job-origins.js";
+import { DELIVERY_PAGES, MEMOS_PER_TRANSACTION, scan } from "./job-scan.js";
+const SPLIT_INTENT_ACCOUNT = 2;
+const startsWith = (data, head) => data.length >= head.length && Array.from(head).every((b, i) => data[i] === b);
+function splitClaim(release, intent) {
+    for (const { data, accounts } of engineCalls(release)) {
+        if (accounts?.[SPLIT_INTENT_ACCOUNT] !== intent) {
+            continue;
+        }
+        try {
+            if (startsWith(data, FILL_ATTESTED_SPLIT_DISCRIMINATOR)) {
+                return getFillAttestedSplitInstructionDataDecoder().decode(data).claim;
+            }
+            if (startsWith(data, FILL_ATTESTED_SPLIT_COMMITTEE_DISCRIMINATOR)) {
+                return getFillAttestedSplitCommitteeInstructionDataDecoder().decode(data).claim;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+function announcedBy(wallet, transactions) {
+    const found = new Map();
+    for (const { signature, slot, blockTime, failed, memos, feePayer } of transactions) {
+        if (failed || feePayer !== wallet) {
+            continue;
+        }
+        for (const memo of (memos ?? []).slice(0, MEMOS_PER_TRANSACTION).map(parseDeliveryMemo)) {
+            if (memo === null) {
+                continue;
+            }
+            const key = `${memo.intent}:${memo.sha256}`;
+            const held = found.get(key);
+            if (held === undefined || slot < held.slot || (slot === held.slot && signature < held.announced)) {
+                found.set(key, { intent: memo.intent, sha256: memo.sha256, announced: signature, slot, blockTime });
+            }
+        }
+    }
+    return [...found.values()];
+}
+function eventsOf(transactions, intent) {
+    return transactions
+        .filter(({ failed }) => !failed)
+        .flatMap((transaction) => transaction.emitted
+        .map((data) => decodeEvent(data))
+        .filter((event) => event !== null && "intent" in event.fields && event.fields.intent === intent)
+        .map((event) => ({ event, transaction })));
+}
+function feedbackOf(transactions, intent, owner) {
+    const ordered = [...transactions].filter(({ failed }) => !failed).sort((a, b) => (a.slot < b.slot ? -1 : a.slot > b.slot ? 1 : 0));
+    for (const { memos, memoSigners } of ordered) {
+        for (const [i, text] of (memos ?? []).entries()) {
+            const memo = parseFeedbackMemo(text);
+            if (memo !== null && memo.intent === intent && memoSigners?.[i]?.includes(owner) === true) {
+                return memo.score;
+            }
+        }
+    }
+    return undefined;
+}
+async function judgeOf(transport, attestor) {
+    const committee = await loadCommittee(transport, attestor);
+    return committee === null ? undefined : [...committee.members];
+}
+async function recordOf(transport, wallet, work, history) {
+    const transactions = await transport.engineTransactions(history, work.intent);
+    const events = eventsOf(transactions, work.intent);
+    const created = events.find(({ event }) => event.name === "IntentCreated")?.event;
+    const released = events.find(({ event }) => event.name === "IntentAttested" || event.name === "IntentSplit");
+    const refunded = events.some(({ event }) => event.name === "IntentCancelled" || event.name === "IntentExpired");
+    const complete = created !== undefined || transactions.length < history;
+    const base = { ...work, selfDealt: false };
+    const owner = created?.name === "IntentCreated" ? created.fields.owner : released?.event.name === "IntentAttested" || released?.event.name === "IntentSplit" ? released.event.fields.owner : undefined;
+    const mint = created?.name === "IntentCreated" ? created.fields.inputMint : undefined;
+    if (released === undefined || (released.event.name !== "IntentAttested" && released.event.name !== "IntentSplit")) {
+        const outcome = refunded ? "refunded" : "open";
+        return { complete, record: { ...base, outcome, ...(owner === undefined ? {} : { owner }), ...(mint === undefined ? {} : { mint }) } };
+    }
+    const { event, transaction } = released;
+    const attestor = event.fields.attestor;
+    const committee = await judgeOf(transport, attestor);
+    const selfDealt = event.fields.owner === wallet ||
+        attestor === wallet ||
+        event.fields.owner === attestor ||
+        (committee !== undefined && (committee.includes(wallet) || committee.includes(event.fields.owner)));
+    const recorded = recordedDelivery(transactions, transaction, attestor);
+    const common = {
+        ...base,
+        owner: event.fields.owner,
+        attestor,
+        ...(committee === undefined ? {} : { committee }),
+        ...(mint === undefined ? {} : { mint }),
+        release: transaction.signature,
+        selfDealt,
+    };
+    if (recorded !== work.sha256) {
+        return { complete, record: { ...common, outcome: "paid-other" } };
+    }
+    let earned;
+    if (event.name === "IntentAttested") {
+        if (mint === undefined) {
+            return { complete: false, record: { ...common, outcome: "unknown" } };
+        }
+        const { tokenProgram } = await mintOf(transport, mint);
+        const own = await findAssociatedTokenAddress({ owner: wallet, mint, tokenProgram });
+        earned = event.fields.payee === own ? event.fields.net : undefined;
+    }
+    else {
+        const claim = splitClaim(transaction, work.intent);
+        const at = claim?.recipients.indexOf(wallet) ?? -1;
+        earned = claim === null || at < 0 ? undefined : splitN(event.fields.net, claim.weights)[at];
+    }
+    if (earned === undefined) {
+        return { complete, record: { ...common, outcome: "paid-other" } };
+    }
+    const feedback = feedbackOf(transactions, work.intent, event.fields.owner);
+    return { complete, record: { ...common, outcome: "paid", earned, ...(feedback === undefined ? {} : { feedback }) } };
+}
+export async function reputationOf(transport, wallet, options = {}) {
+    const { firstAvailableSlot } = transport;
+    const fullLedger = async () => firstAvailableSlot !== undefined && (await firstAvailableSlot.call(transport)) === 0n;
+    const scanned = await scan(transport, wallet, { memo: DELIVERY_MEMO_PREFIX, pages: options.pages ?? DELIVERY_PAGES, covered: fullLedger });
+    const works = announcedBy(wallet, scanned.transactions);
+    const read = await Promise.all(works.map((work) => recordOf(transport, wallet, work, options.history ?? HISTORY_LIMIT)));
+    const records = read.map(({ record }) => record).sort((a, b) => (a.slot < b.slot ? -1 : a.slot > b.slot ? 1 : 0));
+    const fair = records.filter((r) => r.outcome === "paid" && !r.selfDealt);
+    const earned = new Map();
+    for (const r of fair) {
+        if (r.mint !== undefined && r.earned !== undefined) {
+            earned.set(r.mint, (earned.get(r.mint) ?? 0n) + r.earned);
+        }
+    }
+    const scores = fair.flatMap((r) => (r.feedback === undefined ? [] : [r.feedback]));
+    const times = records.flatMap((r) => (r.blockTime === null ? [] : [r.blockTime]));
+    return {
+        wallet,
+        complete: scanned.complete && read.every(({ complete }) => complete),
+        announced: records.length,
+        paid: fair.length,
+        selfDealt: records.filter((r) => r.outcome === "paid" && r.selfDealt).length,
+        payers: new Set(fair.map((r) => r.owner)).size,
+        judges: new Set(fair.map((r) => r.attestor)).size,
+        committeeJudged: fair.filter((r) => r.committee !== undefined).length,
+        earned: [...earned].map(([mint, amount]) => ({ mint, amount })),
+        feedback: { count: scores.length, average: scores.length === 0 ? null : scores.reduce((a, b) => a + b, 0) / scores.length },
+        first: times.length === 0 ? null : times.reduce((a, b) => (a < b ? a : b)),
+        last: times.length === 0 ? null : times.reduce((a, b) => (a > b ? a : b)),
+        records,
+    };
+}
+export async function feedbackInstructions(transport, input, history = HISTORY_LIMIT) {
+    const memo = feedbackMemo({ intent: input.intent, score: input.score, ...(input.note === undefined ? {} : { note: input.note }) });
+    const transactions = await transport.engineTransactions(history, input.intent);
+    const events = eventsOf(transactions, input.intent);
+    const released = events.find(({ event }) => event.name === "IntentAttested" || event.name === "IntentSplit")?.event;
+    if (released === undefined || (released.name !== "IntentAttested" && released.name !== "IntentSplit")) {
+        throw new NotSettleable(input.intent, "has no release among its recent transactions, so there is no work to give feedback on");
+    }
+    if (released.fields.owner !== input.owner.address) {
+        throw new NotSettleable(input.intent, `was paid for by ${released.fields.owner}, and only that owner gives feedback on it`);
+    }
+    if (feedbackOf(transactions, input.intent, input.owner.address) !== undefined) {
+        throw new NotSettleable(input.intent, "already has its owner's feedback; the first one counts");
+    }
+    return [memoInstruction(input.owner, memo), getTransferSolInstruction({ source: input.owner, destination: input.intent, amount: 0n })];
+}
+//# sourceMappingURL=reputation.js.map

package/dist/src/reputation.js.map

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

package/dist/src/rpc-retry.d.ts

@@ -0,0 +1,16 @@
+export declare const POLL_MS = 500;
+export declare const sleep: (ms: number) => Promise<void>;
+export declare const RATE_LIMIT_ATTEMPTS = 6;
+export declare function rateLimited(error: unknown): boolean;
+export declare const MIN_CONTEXT_SLOT_NOT_REACHED = -32016;
+export declare function behindMinSlot(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 class FailedOnChain extends Charged {
+}
+export declare class BlockhashExpired extends Error {
+    constructor(message: string);
+}
+export declare const neverLanded: (error: unknown) => boolean;

package/dist/src/rpc-retry.js

@@ -0,0 +1,62 @@
+import { isSolanaError, SOLANA_ERROR__RPC__TRANSPORT_HTTP_ERROR } from "@solana/kit";
+export const POLL_MS = 500;
+export const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export const RATE_LIMIT_ATTEMPTS = 6;
+const CAUSE_DEPTH = 8;
+function causes(error) {
+    const chain = [];
+    for (let link = error; link instanceof Error && chain.length < CAUSE_DEPTH; link = link.cause) {
+        chain.push(link);
+    }
+    return chain;
+}
+const said = (chain, text) => chain.some((link) => !isSolanaError(link) && text.test(link.message));
+export function rateLimited(error) {
+    if (!(error instanceof Error) || error instanceof Charged) {
+        return false;
+    }
+    const chain = causes(error);
+    for (const link of chain) {
+        if (isSolanaError(link, SOLANA_ERROR__RPC__TRANSPORT_HTTP_ERROR)) {
+            return link.context.statusCode === 429;
+        }
+    }
+    return said(chain, /\b429\b/);
+}
+export const MIN_CONTEXT_SLOT_NOT_REACHED = -32016;
+export function behindMinSlot(error) {
+    if (!(error instanceof Error) || error instanceof Charged) {
+        return false;
+    }
+    const chain = causes(error);
+    return chain.some((link) => isSolanaError(link, MIN_CONTEXT_SLOT_NOT_REACHED)) || said(chain, /-32016\b|minimum context slot/i);
+}
+export async function patiently(call, wait = sleep) {
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await call();
+        }
+        catch (error) {
+            if (!(rateLimited(error) || behindMinSlot(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 class FailedOnChain extends Charged {
+}
+export class BlockhashExpired extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BlockhashExpired";
+    }
+}
+export const neverLanded = (error) => error instanceof FailedOnChain || error instanceof BlockhashExpired;
+//# sourceMappingURL=rpc-retry.js.map

package/dist/src/rpc-retry.js.map

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

package/dist/src/rpc-shapes.d.ts

@@ -0,0 +1,230 @@
+import type { Address, Base64EncodedWireTransaction, Blockhash, Instruction, Signature, TransactionSigner } from "@solana/kit";
+export type AccountView = {
+    owner: Address;
+    data: Uint8Array;
+    lamports: bigint;
+    executable?: boolean;
+};
+export type ProgramAccount = {
+    address: Address;
+    data: Uint8Array;
+};
+export type TokenHolding = {
+    account: Address;
+    mint: Address;
+    owner?: Address;
+};
+export type EngineTransaction = {
+    signature: string;
+    slot: bigint;
+    blockTime: bigint | null;
+    failed: boolean;
+    emitted: Uint8Array[];
+    emittedAccounts?: Address[][];
+    memos?: string[];
+    memoSigners?: Address[][];
+    feePayer?: Address;
+    called?: Uint8Array[];
+    calledAccounts?: Address[][];
+    tokens?: TokenHolding[];
+    unread?: true;
+};
+export type ListedSignature = {
+    signature: string;
+    slot: bigint;
+    blockTime: bigint | null;
+    failed: boolean;
+    memo: string | null;
+};
+export type Latest = {
+    blockhash: Blockhash;
+    lastValidBlockHeight: bigint;
+};
+export type IntentRead = {
+    minContextSlot?: bigint;
+    onSlot?: (slot: bigint) => void;
+};
+export type LookupTables = Readonly<Record<Address, Address[]>>;
+export type Simulation = {
+    err: string | null;
+    logs: string[];
+    unitsConsumed: bigint | null;
+    accounts: (Uint8Array | null)[];
+};
+export interface Transport {
+    getAccount(address: Address): Promise<AccountView | null>;
+    getAccounts(addresses: readonly Address[]): Promise<(AccountView | null)[]>;
+    warm?(addresses: readonly Address[]): Promise<void>;
+    send(instructions: readonly Instruction[], payer: TransactionSigner): Promise<string>;
+    latestBlockhash(): Promise<Latest>;
+    sendWire(wire: Base64EncodedWireTransaction, latest: Latest): Promise<string>;
+    submitWire(wire: Base64EncodedWireTransaction): Promise<string>;
+    simulate(wire: Base64EncodedWireTransaction, watch?: readonly Address[]): Promise<Simulation>;
+    genesisHash(): Promise<string>;
+    intents(owner?: Address, read?: IntentRead): Promise<ProgramAccount[]>;
+    engineTransactions(limit: number, of?: Address, memo?: string): Promise<EngineTransaction[]>;
+    signaturesOf?(of: Address, limit: number, before?: string): Promise<ListedSignature[]>;
+    transactionsOf?(listed: readonly ListedSignature[]): Promise<EngineTransaction[]>;
+    transactionOf?(signature: string): Promise<EngineTransaction | null>;
+    firstAvailableSlot?(): Promise<bigint>;
+    recentFees(accounts: readonly Address[]): Promise<bigint[]>;
+    budget(instructions: readonly Instruction[], feePayer: Address, tables?: LookupTables): Promise<Instruction[]>;
+    airdrop(address: Address, lamports: bigint): Promise<string>;
+}
+export type Pending<T> = {
+    send(): Promise<T>;
+};
+export type RawAccount = {
+    owner: Address;
+    data: readonly [string, string];
+    lamports: bigint;
+    executable: boolean;
+};
+export type AtLeast = {
+    minContextSlot?: bigint;
+};
+export type ProgramEntry = {
+    pubkey: Address;
+    account: {
+        data: readonly [string, string];
+    };
+};
+export type Status = {
+    err: unknown;
+    confirmationStatus: string | null;
+    slot?: bigint;
+};
+export type RpcLike = {
+    getMultipleAccounts(addresses: Address[], config: {
+        encoding: "base64";
+    } & AtLeast): Pending<{
+        value: (RawAccount | null)[];
+    }>;
+    getAccountInfo(address: Address, config: {
+        encoding: "base64";
+    } & AtLeast): 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";
+        skipPreflight?: boolean;
+    }): 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[], config?: {
+        searchTransactionHistory: boolean;
+    }): Pending<{
+        context: {
+            slot: bigint;
+        };
+        value: readonly (Status | null)[];
+    }>;
+    getEpochInfo(): Pending<{
+        blockHeight: bigint;
+        absoluteSlot: bigint;
+    }>;
+    getFirstAvailableBlock?(): 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";
+        commitment: "confirmed";
+        filters: readonly ({
+            dataSize: bigint;
+        } | {
+            memcmp: {
+                offset: bigint;
+                bytes: string;
+                encoding: "base58";
+            };
+        })[];
+        withContext?: true;
+    } & AtLeast): Pending<readonly ProgramEntry[] | {
+        context: {
+            slot: bigint;
+        };
+        value: readonly ProgramEntry[];
+    }>;
+    getSignaturesForAddress(address: Address, config: {
+        limit: number;
+        before?: Signature;
+    } & AtLeast): Pending<readonly {
+        signature: Signature;
+        slot: bigint;
+        blockTime: bigint | null;
+        err: unknown;
+        memo?: string | null;
+    }[]>;
+    getTransaction(signature: Signature, config: {
+        encoding: "json";
+        maxSupportedTransactionVersion: 0;
+        commitment: "confirmed";
+    }): Pending<{
+        slot?: bigint;
+        blockTime?: bigint | null;
+        transaction: {
+            message: {
+                accountKeys: readonly Address[];
+                header?: {
+                    numRequiredSignatures: number;
+                };
+                instructions?: readonly {
+                    programIdIndex: number;
+                    accounts?: readonly number[];
+                    data: string;
+                }[];
+            };
+        };
+        meta: {
+            err?: unknown;
+            loadedAddresses?: {
+                writable: readonly Address[];
+                readonly: readonly Address[];
+            };
+            innerInstructions?: readonly {
+                instructions: readonly {
+                    programIdIndex: number;
+                    accounts?: readonly number[];
+                    data: string;
+                }[];
+            }[] | null;
+            preTokenBalances?: readonly TokenBalance[] | null;
+            postTokenBalances?: readonly TokenBalance[] | null;
+        } | null;
+    } | null>;
+};
+export type TokenBalance = {
+    accountIndex: number;
+    mint: string;
+    owner?: string;
+};

package/dist/src/rpc-shapes.js

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

package/dist/src/rpc-shapes.js.map

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

package/dist/src/rpc-transport.d.ts

@@ -0,0 +1,6 @@
+import { type SignatureWatch } from "./confirmation.js";
+import type { RpcLike, Transport } from "./rpc-shapes.js";
+export declare const MULTIPLE_ACCOUNTS_LIMIT = 100;
+export declare const TRANSACTION_FETCHES = 4;
+export declare const KEPT_TRANSACTIONS = 256;
+export declare function rpcTransport(rpc: RpcLike, wait?: (ms: number) => Promise<void>, watch?: SignatureWatch): Transport;