@intent-engine/client 0.1.22 → 0.1.26

package/dist/src/job-specs.js

@@ -0,0 +1,107 @@
+import { createHash } from "node:crypto";
+import { parseSpecMemo, remainingOf, SPEC_MEMO_PREFIX } from "@intent-engine/core";
+import { createdIn, hex, openProofEscrows, proofAt } from "./job-proofs.js";
+import { MEMOS_PER_TRANSACTION, scan } from "./job-scan.js";
+import { TRANSACTION_FETCHES } from "./transport.js";
+export const SPEC_SCAN = 10;
+export const MAINNET_GENESIS_HASH = "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+export const DEVNET_GENESIS_HASH = "EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG";
+export const TESTNET_GENESIS_HASH = "4uhcVJyU9pJkvQyS88uRDiswHXSCkY3zQawwpjk2NsfY";
+export const PUBLIC_GENESIS_HASHES = new Set([MAINNET_GENESIS_HASH, DEVNET_GENESIS_HASH, TESTNET_GENESIS_HASH]);
+export const MAX_SPEC_BYTES = 1_048_576;
+export const SPEC_TIMEOUT_MS = 10_000;
+export const PLAIN_HTTP_ON_PUBLIC = "is a plain http url, which a public cluster may not use";
+export async function plainHttpOnPublic(transport, url) {
+    let protocol;
+    try {
+        protocol = new URL(url).protocol;
+    }
+    catch {
+        return false;
+    }
+    return protocol === "http:" && PUBLIC_GENESIS_HASHES.has(await transport.genesisHash());
+}
+export class SpecUnreadable extends Error {
+    url;
+    constructor(url, reason) {
+        super(`the spec at ${url} ${reason}`);
+        this.name = "SpecUnreadable";
+        this.url = url;
+    }
+}
+export async function specUrlOf(transport, intent, createdAt) {
+    const floor = createdAt ?? (await proofAt(transport, intent))?.intent.createdAt ?? null;
+    const created = (transaction) => !transaction.failed && createdIn(transaction.emitted, intent);
+    const { transactions } = await scan(transport, intent, { floor, memo: SPEC_MEMO_PREFIX, until: created });
+    const tx = transactions.find(created);
+    if (tx === undefined) {
+        return null;
+    }
+    const urls = new Set((tx.memos ?? [])
+        .slice(0, MEMOS_PER_TRANSACTION)
+        .map(parseSpecMemo)
+        .flatMap((memo) => (memo === null ? [] : [memo.url])));
+    return urls.size === 1 ? ([...urls][0] ?? null) : null;
+}
+export async function jobsOf(transport, attestor) {
+    const proofs = await openProofEscrows(transport, attestor);
+    const urls = [];
+    for (let at = 0; at < proofs.length; at += TRANSACTION_FETCHES) {
+        urls.push(...(await Promise.all(proofs.slice(at, at + TRANSACTION_FETCHES).map(({ address, intent }) => specUrlOf(transport, address, intent.createdAt)))));
+    }
+    return proofs.map(({ address, intent, params }, i) => ({
+        intent: address,
+        owner: intent.owner,
+        nonce: intent.nonce,
+        attestor: params.attestor,
+        specHash: hex(params.specHash),
+        specUrl: urls[i] ?? null,
+        sells: remainingOf(intent),
+        judgeFee: params.judgeFee,
+        inputMint: intent.inputMint,
+        expiresAt: intent.expiresAt,
+    }));
+}
+async function discarded(response) {
+    await response.body?.cancel().catch(() => undefined);
+}
+async function bounded(response, url) {
+    if (!response.ok) {
+        await discarded(response);
+        throw new SpecUnreadable(url, `answered ${response.status}`);
+    }
+    const declared = Number(response.headers.get("content-length") ?? "0");
+    if (declared > MAX_SPEC_BYTES) {
+        await discarded(response);
+        throw new SpecUnreadable(url, `is larger than ${MAX_SPEC_BYTES} bytes`);
+    }
+    const reader = response.body?.getReader();
+    const chunks = [];
+    let size = 0;
+    for (let next = await reader?.read(); next !== undefined && next.done !== true; next = await reader?.read()) {
+        size += next.value.length;
+        if (size > MAX_SPEC_BYTES) {
+            await reader?.cancel();
+            throw new SpecUnreadable(url, `is larger than ${MAX_SPEC_BYTES} bytes`);
+        }
+        chunks.push(next.value);
+    }
+    return Buffer.concat(chunks);
+}
+export async function readSpec(transport, get, intent) {
+    const proof = await proofAt(transport, intent);
+    if (proof === null) {
+        return null;
+    }
+    const url = await specUrlOf(transport, intent, proof.intent.createdAt);
+    if (url === null) {
+        return null;
+    }
+    if (await plainHttpOnPublic(transport, url)) {
+        throw new SpecUnreadable(url, PLAIN_HTTP_ON_PUBLIC);
+    }
+    const bytes = await bounded(await get(url, { redirect: "error", signal: AbortSignal.timeout(SPEC_TIMEOUT_MS) }), url);
+    const sha256 = createHash("sha256").update(bytes).digest("hex");
+    return { url, text: new TextDecoder().decode(bytes), sha256, matches: sha256 === hex(proof.params.specHash) };
+}
+//# sourceMappingURL=job-specs.js.map

package/dist/src/job-specs.js.map

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

package/dist/src/jobs.d.ts

@@ -0,0 +1,6 @@
+export { DELIVERY_PAGES, DELIVERY_SCAN, MEMOS_PER_TRANSACTION, type Scan, scan, type ScanOptions, SIGNATURE_PAGE, transactionAt, } from "./job-scan.js";
+export { createdAtOf, creationSlotOf, historyCovers, intentAt, JOBS_LIMIT, openProofEscrows } from "./job-proofs.js";
+export { DEVNET_GENESIS_HASH, type Job, jobsOf, MAINNET_GENESIS_HASH, MAX_SPEC_BYTES, PLAIN_HTTP_ON_PUBLIC, plainHttpOnPublic, PUBLIC_GENESIS_HASHES, readSpec, type Spec, type SpecFetch, SPEC_SCAN, SPEC_TIMEOUT_MS, SpecUnreadable, specUrlOf, TESTNET_GENESIS_HASH, } from "./job-specs.js";
+export { type FollowUp, followUpInstructions, followUpMemo, followUpOf, memoInstruction, memosSignedBy, parseFollowUpMemo, recordedDelivery, RELEASE_MARK, } from "./job-memos.js";
+export { type Announcement, announcements, type DeliverInput, deliveriesOf, type Delivery, deliveryInstructions, deliveryRecord, type DeliveryRecord, firstDelivery, NotDeliverable, } from "./job-deliveries.js";
+export { creationProof, type EngineCall, engineCalls, escrowOrigin, type EscrowOrigin, type EscrowProof, type Lifecycle, lifecycleDeliveries, originDeliveries, } from "./job-origins.js";

package/dist/src/jobs.js

@@ -0,0 +1,7 @@
+export { DELIVERY_PAGES, DELIVERY_SCAN, MEMOS_PER_TRANSACTION, scan, SIGNATURE_PAGE, transactionAt, } from "./job-scan.js";
+export { createdAtOf, creationSlotOf, historyCovers, intentAt, JOBS_LIMIT, openProofEscrows } from "./job-proofs.js";
+export { DEVNET_GENESIS_HASH, jobsOf, MAINNET_GENESIS_HASH, MAX_SPEC_BYTES, PLAIN_HTTP_ON_PUBLIC, plainHttpOnPublic, PUBLIC_GENESIS_HASHES, readSpec, SPEC_SCAN, SPEC_TIMEOUT_MS, SpecUnreadable, specUrlOf, TESTNET_GENESIS_HASH, } from "./job-specs.js";
+export { followUpInstructions, followUpMemo, followUpOf, memoInstruction, memosSignedBy, parseFollowUpMemo, recordedDelivery, RELEASE_MARK, } from "./job-memos.js";
+export { announcements, deliveriesOf, deliveryInstructions, deliveryRecord, firstDelivery, NotDeliverable, } from "./job-deliveries.js";
+export { creationProof, engineCalls, escrowOrigin, lifecycleDeliveries, originDeliveries, } from "./job-origins.js";
+//# sourceMappingURL=jobs.js.map

package/dist/src/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,qBAAqB,EAErB,IAAI,EAEJ,cAAc,EACd,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACrH,OAAO,EACL,mBAAmB,EAEnB,MAAM,EACN,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,QAAQ,EAGR,SAAS,EACT,eAAe,EACf,cAAc,EACd,SAAS,EACT,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,aAAa,EAEb,YAAY,EAEZ,oBAAoB,EACpB,cAAc,EAEd,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,aAAa,EAEb,WAAW,EACX,YAAY,EAIZ,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { Transport } from "./rpc-shapes.js";
+export declare function boundMembers<T extends object>(inner: T): T;
+export declare const unmemoized: (transport: Transport) => Transport;
+export declare function memoized(inner: Transport): Transport;

package/dist/src/memoized-transport.js

@@ -0,0 +1,66 @@
+export function boundMembers(inner) {
+    const members = {};
+    for (let at = inner; at !== null && at !== Object.prototype; at = Object.getPrototypeOf(at)) {
+        for (const key of Reflect.ownKeys(at)) {
+            if (key === "constructor" || Object.prototype.hasOwnProperty.call(members, key)) {
+                continue;
+            }
+            const value = Reflect.get(inner, key);
+            members[key] = typeof value === "function" ? value.bind(inner) : value;
+        }
+    }
+    return members;
+}
+const MEMOIZED = Symbol("memoized");
+const UNDERLYING = Symbol("underlying");
+export const unmemoized = (transport) => transport[UNDERLYING] ?? transport;
+export function memoized(inner) {
+    if (inner[MEMOIZED] === true) {
+        return inner;
+    }
+    const members = boundMembers(inner);
+    const seen = new Map();
+    const keep = (address, pending) => {
+        seen.set(address, pending);
+        pending.catch(() => {
+            if (seen.get(address) === pending) {
+                seen.delete(address);
+            }
+        });
+        return pending;
+    };
+    const getAccount = (address) => seen.get(address) ?? keep(address, members.getAccount(address));
+    const warm = async (addresses) => {
+        const missing = [...new Set(addresses)].filter((address) => !seen.has(address));
+        if (missing.length === 0) {
+            return;
+        }
+        const fetched = members.getAccounts(missing);
+        missing.forEach((address, i) => keep(address, fetched.then((views) => views[i] ?? null)));
+        await fetched;
+    };
+    const writing = (write) => async (...args) => {
+        try {
+            return await write(...args);
+        }
+        finally {
+            seen.clear();
+        }
+    };
+    return {
+        ...members,
+        [MEMOIZED]: true,
+        [UNDERLYING]: inner,
+        getAccount,
+        send: writing(members.send),
+        sendWire: writing(members.sendWire),
+        submitWire: writing(members.submitWire),
+        airdrop: writing(members.airdrop),
+        getAccounts: async (addresses) => {
+            await warm(addresses);
+            return Promise.all(addresses.map(getAccount));
+        },
+        warm,
+    };
+}
+//# sourceMappingURL=memoized-transport.js.map

package/dist/src/memoized-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoized-transport.js","sourceRoot":"","sources":["../../src/memoized-transport.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;