crypto-aio 0.0.2 → 0.1.0

package/dist/adapters/solana/rpc.d.ts

@@ -0,0 +1,102 @@
+/**
+ * The Solana driver's path to the core transport. Every JSON-RPC call
+ * is one direct `transport.rpc` call carrying the tags of the `ChainDriver` method that made
+ * it; `@solana/web3.js` is never on a request path. Answers are validated here: a malformed
+ * answer is a retryable `PROVIDER_UNAVAILABLE`, never a foreign error.
+ */
+import { ProviderError, type CryptoAioError } from '../../core/errors/error';
+import type { Transport } from '../../core/transport/types';
+import type { Commitment, SolanaCallTags } from './types';
+export declare const READ: SolanaCallTags;
+export declare const MONITOR: SolanaCallTags;
+export declare const PROOF: SolanaCallTags;
+export declare const BROADCAST: SolanaCallTags;
+export declare const withSignal: (tags: SolanaCallTags, signal?: AbortSignal) => SolanaCallTags;
+/** Solana's JSON-RPC server errors (agave `rpc-client-api/src/custom_error.rs`). */
+export declare const RPC_CODES: Readonly<{
+    BLOCK_CLEANED_UP: -32001;
+    SEND_TRANSACTION_PREFLIGHT_FAILURE: -32002;
+    TRANSACTION_SIGNATURE_VERIFICATION_FAILURE: -32003;
+    BLOCK_NOT_AVAILABLE: -32004;
+    SLOT_SKIPPED: -32007;
+    LONG_TERM_STORAGE_SLOT_SKIPPED: -32009;
+    TRANSACTION_HISTORY_NOT_AVAILABLE: -32011;
+    BLOCK_STATUS_NOT_AVAILABLE_YET: -32014;
+    MIN_CONTEXT_SLOT_NOT_REACHED: -32016;
+    LONG_TERM_STORAGE_UNREACHABLE: -32019;
+    FILTER_TRANSACTION_NOT_FOUND: -32020;
+}>;
+/** The JSON-RPC code of a definitive, non-ambiguous `RPC_ERROR`; otherwise `undefined`. */
+export declare function rpcCode(error: unknown): number | undefined;
+/** The node's message of a definitive, non-ambiguous `RPC_ERROR`. */
+export declare function rpcMessage(error: CryptoAioError): string;
+/** The endpoint has not reached that block or state yet (`null`, decides nothing). */
+export declare const isNotYet: (error: unknown) => boolean;
+/** The endpoint no longer holds that block or history, or never did (decides nothing). */
+export declare const isGone: (error: unknown) => boolean;
+/** The endpoint says the slot was skipped, or is missing on this endpoint (`-32007`). */
+export declare const isSkipped: (error: unknown) => boolean;
+/** Any answer meaning "this endpoint cannot show that": it never decides anything. */
+export declare const isNotAvailable: (error: unknown) => boolean;
+/** A retryable error that decides nothing: the endpoint no longer holds what was asked. */
+export declare const gone: (what: string) => ProviderError;
+/** A retryable error that decides nothing: the endpoints cannot show this yet. */
+export declare const notYet: (what: string) => ProviderError;
+/**
+ * On a proof path only a definitive negative proof answers "no". Any
+ * other definitive RPC error (agave 4.3.0's `getBlocks` answers `-32602 "BigTable query
+ * failed"` for a range below its local ledger, `-32603` on a blockstore error) decides
+ * nothing: it becomes a retryable `PROVIDER_UNAVAILABLE`. Every other error (retryable
+ * ones, `PROVIDER_MISCONFIGURED`) is returned unchanged.
+ */
+export declare function undecided(error: unknown, what: string): unknown;
+export declare const malformed: (what: string) => ProviderError;
+export declare const inconsistent: (what: string) => ProviderError;
+/** A JSON object's fields, or `null` for anything else (arrays and `null` included). */
+export declare const record: (value: unknown) => Record<string, unknown> | null;
+/**
+ * An unsigned 64-bit JSON integer (lamports, slots, heights) as a `bigint`. Every call
+ * parses with `exactIntegers`, so a value above 2^53 − 1 arrives as a `bigint`; a
+ * number outside the safe range was rounded somewhere and is refused as malformed.
+ */
+export declare function u64(value: unknown, what: string): bigint;
+/** A decimal string of base units (token amounts), as a `bigint`. */
+export declare function amountString(value: unknown, what: string): bigint;
+/** The `value` of an RPC response with context (`{ context: { slot }, value }`). */
+export declare function contextValue(result: unknown, what: string): unknown;
+/** A block header as `getBlock` returns it with `transactionDetails: 'none'`. */
+export interface BlockHeader {
+    readonly blockhash: string;
+    readonly previousBlockhash: string;
+    readonly parentSlot: bigint;
+    readonly blockHeight: bigint;
+    /** Unix seconds, when the node estimates one. */
+    readonly blockTime?: number;
+}
+export declare function blockHeader(result: unknown): BlockHeader;
+export declare const pick: (value: unknown, keys: readonly string[]) => unknown;
+/** The consensus fields of a block header, compared under a quorum. */
+export declare const BLOCK_FIELDS: readonly ["blockhash", "previousBlockhash", "parentSlot", "blockHeight"];
+/**
+ * The consensus facts compared under a quorum, per method. A key that throws
+ * counts as a disagreement (a retryable `PROVIDER_INCONSISTENT`).
+ */
+export declare function quorumKeyFor(method: string): ((result: unknown) => unknown) | undefined;
+/**
+ * One JSON-RPC call through the transport, under the calling driver method's tags. Solana
+ * sends u64 values (lamports) as JSON numbers, so every answer is parsed with
+ * `exactIntegers`: nothing above 2^53 − 1 is ever rounded.
+ */
+export declare function call(transport: Transport, method: string, params: readonly unknown[], tags: SolanaCallTags): Promise<unknown>;
+/** `getBlock` options for a header (no transactions, no rewards). */
+export declare const headerOptions: (commitment: Commitment) => {
+    commitment: Commitment;
+    transactionDetails: string;
+    rewards: boolean;
+};
+/** `getBlock`/`getTransaction` options for decoding (every transaction version we parse). */
+export declare const parsedOptions: (commitment: Commitment) => {
+    commitment: Commitment;
+    encoding: string;
+    maxSupportedTransactionVersion: number;
+};

package/dist/adapters/solana/rpc.js

@@ -0,0 +1,301 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsedOptions = exports.headerOptions = exports.BLOCK_FIELDS = exports.pick = exports.record = exports.inconsistent = exports.malformed = exports.notYet = exports.gone = exports.isNotAvailable = exports.isSkipped = exports.isGone = exports.isNotYet = exports.RPC_CODES = exports.withSignal = exports.BROADCAST = exports.PROOF = exports.MONITOR = exports.READ = void 0;
+exports.rpcCode = rpcCode;
+exports.rpcMessage = rpcMessage;
+exports.undecided = undecided;
+exports.u64 = u64;
+exports.amountString = amountString;
+exports.contextValue = contextValue;
+exports.blockHeader = blockHeader;
+exports.quorumKeyFor = quorumKeyFor;
+exports.call = call;
+/**
+ * The Solana driver's path to the core transport. Every JSON-RPC call
+ * is one direct `transport.rpc` call carrying the tags of the `ChainDriver` method that made
+ * it; `@solana/web3.js` is never on a request path. Answers are validated here: a malformed
+ * answer is a retryable `PROVIDER_UNAVAILABLE`, never a foreign error.
+ */
+const error_1 = require("../../core/errors/error");
+const json_1 = require("../../core/util/json");
+exports.READ = Object.freeze({ purpose: 'read', retry: 'safe' });
+exports.MONITOR = Object.freeze({
+    purpose: 'monitor',
+    retry: 'safe',
+});
+exports.PROOF = Object.freeze({
+    purpose: 'proof',
+    retry: 'safe',
+    quorum: 'proof',
+});
+exports.BROADCAST = Object.freeze({
+    purpose: 'broadcast',
+    retry: 'ambiguous-on-failure',
+});
+const withSignal = (tags, signal) => signal ? { ...tags, signal } : tags;
+exports.withSignal = withSignal;
+/** Solana's JSON-RPC server errors (agave `rpc-client-api/src/custom_error.rs`). */
+exports.RPC_CODES = Object.freeze({
+    BLOCK_CLEANED_UP: -32001,
+    SEND_TRANSACTION_PREFLIGHT_FAILURE: -32002,
+    TRANSACTION_SIGNATURE_VERIFICATION_FAILURE: -32003,
+    BLOCK_NOT_AVAILABLE: -32004,
+    SLOT_SKIPPED: -32007,
+    LONG_TERM_STORAGE_SLOT_SKIPPED: -32009,
+    TRANSACTION_HISTORY_NOT_AVAILABLE: -32011,
+    BLOCK_STATUS_NOT_AVAILABLE_YET: -32014,
+    MIN_CONTEXT_SLOT_NOT_REACHED: -32016,
+    LONG_TERM_STORAGE_UNREACHABLE: -32019,
+    FILTER_TRANSACTION_NOT_FOUND: -32020,
+});
+/** "Not yet": the endpoint has not reached that slot or state. */
+const NOT_YET = new Set([
+    exports.RPC_CODES.BLOCK_NOT_AVAILABLE,
+    exports.RPC_CODES.BLOCK_STATUS_NOT_AVAILABLE_YET,
+    exports.RPC_CODES.MIN_CONTEXT_SLOT_NOT_REACHED,
+]);
+/** "No longer, or never here": pruned, not in long-term storage, or no history at all. */
+const GONE = new Set([
+    exports.RPC_CODES.BLOCK_CLEANED_UP,
+    exports.RPC_CODES.LONG_TERM_STORAGE_SLOT_SKIPPED,
+    exports.RPC_CODES.TRANSACTION_HISTORY_NOT_AVAILABLE,
+    exports.RPC_CODES.LONG_TERM_STORAGE_UNREACHABLE,
+]);
+/** The JSON-RPC code of a definitive, non-ambiguous `RPC_ERROR`; otherwise `undefined`. */
+function rpcCode(error) {
+    if (!(0, error_1.isCryptoAioError)(error, 'RPC_ERROR') || error.ambiguous)
+        return undefined;
+    const code = error.details?.rpcCode;
+    return typeof code === 'number' ? code : undefined;
+}
+/** The node's message of a definitive, non-ambiguous `RPC_ERROR`. */
+function rpcMessage(error) {
+    return String(error.details?.rpcMessage ?? error.message);
+}
+const hasCode = (error, codes) => {
+    const code = rpcCode(error);
+    return code !== undefined && codes.has(code);
+};
+/** The endpoint has not reached that block or state yet (`null`, decides nothing). */
+const isNotYet = (error) => hasCode(error, NOT_YET);
+exports.isNotYet = isNotYet;
+/** The endpoint no longer holds that block or history, or never did (decides nothing). */
+const isGone = (error) => hasCode(error, GONE);
+exports.isGone = isGone;
+/** The endpoint says the slot was skipped, or is missing on this endpoint (`-32007`). */
+const isSkipped = (error) => rpcCode(error) === exports.RPC_CODES.SLOT_SKIPPED;
+exports.isSkipped = isSkipped;
+/** Any answer meaning "this endpoint cannot show that": it never decides anything. */
+const isNotAvailable = (error) => (0, exports.isNotYet)(error) || (0, exports.isGone)(error) || (0, exports.isSkipped)(error);
+exports.isNotAvailable = isNotAvailable;
+/** A retryable error that decides nothing: the endpoint no longer holds what was asked. */
+const gone = (what) => new error_1.ProviderError('PROVIDER_UNAVAILABLE', `the endpoint no longer holds ${what}`);
+exports.gone = gone;
+/** A retryable error that decides nothing: the endpoints cannot show this yet. */
+const notYet = (what) => new error_1.ProviderError('PROVIDER_UNAVAILABLE', `the endpoints cannot show ${what} yet`);
+exports.notYet = notYet;
+/**
+ * On a proof path only a definitive negative proof answers "no". Any
+ * other definitive RPC error (agave 4.3.0's `getBlocks` answers `-32602 "BigTable query
+ * failed"` for a range below its local ledger, `-32603` on a blockstore error) decides
+ * nothing: it becomes a retryable `PROVIDER_UNAVAILABLE`. Every other error (retryable
+ * ones, `PROVIDER_MISCONFIGURED`) is returned unchanged.
+ */
+function undecided(error, what) {
+    if (!(0, error_1.isCryptoAioError)(error, 'RPC_ERROR'))
+        return error;
+    return new error_1.ProviderError('PROVIDER_UNAVAILABLE', `the endpoints cannot show ${what}: ${rpcMessage(error)}`, {
+        cause: error,
+        context: error.context,
+        ...(error.details ? { details: error.details } : {}),
+    });
+}
+const malformed = (what) => new error_1.ProviderError('PROVIDER_UNAVAILABLE', `malformed ${what} answer`);
+exports.malformed = malformed;
+const inconsistent = (what) => new error_1.ProviderError('PROVIDER_INCONSISTENT', what, { retryable: true });
+exports.inconsistent = inconsistent;
+/** A JSON object's fields, or `null` for anything else (arrays and `null` included). */
+const record = (value) => value !== null && typeof value === 'object' && !Array.isArray(value)
+    ? value
+    : null;
+exports.record = record;
+/**
+ * An unsigned 64-bit JSON integer (lamports, slots, heights) as a `bigint`. Every call
+ * parses with `exactIntegers`, so a value above 2^53 − 1 arrives as a `bigint`; a
+ * number outside the safe range was rounded somewhere and is refused as malformed.
+ */
+function u64(value, what) {
+    if (typeof value === 'bigint' && value >= 0n && value < 2n ** 64n)
+        return value;
+    if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0) {
+        return BigInt(value);
+    }
+    throw (0, exports.malformed)(what);
+}
+/** A decimal string of base units (token amounts), as a `bigint`. */
+function amountString(value, what) {
+    if (typeof value !== 'string' || !/^(0|[1-9][0-9]{0,19})$/.test(value)) {
+        throw (0, exports.malformed)(what);
+    }
+    const amount = BigInt(value);
+    if (amount >= 2n ** 64n)
+        throw (0, exports.malformed)(what);
+    return amount;
+}
+/** The `value` of an RPC response with context (`{ context: { slot }, value }`). */
+function contextValue(result, what) {
+    const body = (0, exports.record)(result);
+    if (!body || !(0, exports.record)(body.context) || !('value' in body))
+        throw (0, exports.malformed)(what);
+    return body.value;
+}
+function blockHeader(result) {
+    const block = (0, exports.record)(result);
+    if (!block)
+        throw (0, exports.malformed)('getBlock');
+    const { blockhash, previousBlockhash, parentSlot, blockHeight, blockTime } = block;
+    if (typeof blockhash !== 'string' || typeof previousBlockhash !== 'string') {
+        throw (0, exports.malformed)('getBlock');
+    }
+    // Blocks from before block heights were recorded (2020) carry `blockHeight: null`.
+    if (blockHeight === null)
+        throw (0, exports.malformed)('getBlock (no block height)');
+    return {
+        blockhash,
+        previousBlockhash,
+        parentSlot: u64(parentSlot, 'parent slot'),
+        blockHeight: u64(blockHeight, 'block height'),
+        ...(typeof blockTime === 'number' && Number.isSafeInteger(blockTime)
+            ? { blockTime }
+            : {}),
+    };
+}
+const pick = (value, keys) => {
+    const object = (0, exports.record)(value);
+    if (!object)
+        return value;
+    return Object.fromEntries(keys.map((key) => [key, object[key] ?? null]));
+};
+exports.pick = pick;
+/** The consensus fields of a block header, compared under a quorum. */
+exports.BLOCK_FIELDS = [
+    'blockhash',
+    'previousBlockhash',
+    'parentSlot',
+    'blockHeight',
+];
+/** The token-program instructions (outer and inner) projected to what a verdict reads. */
+function tokenInstructions(tx) {
+    const message = (0, exports.record)((0, exports.record)(tx.transaction)?.message);
+    const meta = (0, exports.record)(tx.meta);
+    const outer = Array.isArray(message?.instructions) ? message.instructions : [];
+    const inner = Array.isArray(meta?.innerInstructions)
+        ? meta.innerInstructions.flatMap((group) => {
+            const list = (0, exports.record)(group)?.instructions;
+            return Array.isArray(list) ? list : [];
+        })
+        : [];
+    return [...outer, ...inner].flatMap((ix) => {
+        const instruction = (0, exports.record)(ix);
+        const parsed = (0, exports.record)(instruction?.parsed);
+        const info = (0, exports.record)(parsed?.info);
+        if (instruction?.program !== 'spl-token' || !parsed || !info)
+            return [];
+        return [
+            {
+                programId: instruction.programId ?? null,
+                type: parsed.type ?? null,
+                source: info.source ?? null,
+                destination: info.destination ?? null,
+                authority: info.authority ?? info.multisigAuthority ?? null,
+                mint: info.mint ?? null,
+                amount: info.amount ?? (0, exports.record)(info.tokenAmount)?.amount ?? null,
+            },
+        ];
+    });
+}
+/** Token balances by account index (providers may list them in another order). */
+const tokenBalances = (list) => Array.isArray(list)
+    ? list
+        .map((entry) => {
+        const balance = (0, exports.record)(entry);
+        return {
+            accountIndex: balance?.accountIndex ?? null,
+            mint: balance?.mint ?? null,
+            amount: (0, exports.record)(balance?.uiTokenAmount)?.amount ?? null,
+        };
+    })
+        .sort((a, b) => Number(a.accountIndex) - Number(b.accountIndex))
+    : null;
+/**
+ * A finalized transaction's consensus facts, as far as a verdict reads them
+ * (slot, error, signatures, account keys, token balances, token transfer instructions).
+ * Formatting that honest providers differ on (`uiAmount` floats, `stackHeight`, `owner` and
+ * `programId` on balances, log messages, compute units, `blockTime`) is left out. The landing
+ * guard (`decode.ts`) still requires `programId` on the transfer's balances: providers must
+ * report it (current agave does), and through one that leaves it out no SPL verdict ever
+ * decides, which costs liveness only.
+ */
+function transactionKey(result) {
+    if (result === null)
+        return null;
+    const tx = (0, exports.record)(result);
+    if (!tx)
+        throw (0, exports.malformed)('getTransaction');
+    const meta = (0, exports.record)(tx.meta);
+    const message = (0, exports.record)((0, exports.record)(tx.transaction)?.message);
+    const keys = Array.isArray(message?.accountKeys)
+        ? message.accountKeys.map((key) => (0, exports.record)(key)?.pubkey ?? key)
+        : null;
+    return {
+        slot: tx.slot ?? null,
+        err: (0, json_1.canonicalJson)(meta?.err ?? null),
+        signatures: (0, exports.record)(tx.transaction)?.signatures ?? null,
+        accountKeys: keys,
+        preTokenBalances: tokenBalances(meta?.preTokenBalances),
+        postTokenBalances: tokenBalances(meta?.postTokenBalances),
+        tokenInstructions: tokenInstructions(tx),
+    };
+}
+/**
+ * The consensus facts compared under a quorum, per method. A key that throws
+ * counts as a disagreement (a retryable `PROVIDER_INCONSISTENT`).
+ */
+function quorumKeyFor(method) {
+    switch (method) {
+        case 'getBlock':
+            return (result) => (0, exports.pick)(result, exports.BLOCK_FIELDS);
+        case 'getTransaction':
+            return transactionKey;
+        default:
+            return undefined;
+    }
+}
+/**
+ * One JSON-RPC call through the transport, under the calling driver method's tags. Solana
+ * sends u64 values (lamports) as JSON numbers, so every answer is parsed with
+ * `exactIntegers`: nothing above 2^53 − 1 is ever rounded.
+ */
+function call(transport, method, params, tags) {
+    const quorumKey = tags.quorum !== undefined ? (tags.quorumKey ?? quorumKeyFor(method)) : undefined;
+    return transport.rpc(method, params, {
+        ...tags,
+        ...(quorumKey ? { quorumKey } : {}),
+        exactIntegers: true,
+    });
+}
+/** `getBlock` options for a header (no transactions, no rewards). */
+const headerOptions = (commitment) => ({
+    commitment,
+    transactionDetails: 'none',
+    rewards: false,
+});
+exports.headerOptions = headerOptions;
+/** `getBlock`/`getTransaction` options for decoding (every transaction version we parse). */
+const parsedOptions = (commitment) => ({
+    commitment,
+    encoding: 'jsonParsed',
+    maxSupportedTransactionVersion: 0,
+});
+exports.parsedOptions = parsedOptions;
+//# sourceMappingURL=rpc.js.map

package/dist/adapters/solana/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../../src/adapters/solana/rpc.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The Solana driver's path to the core transport. Every JSON-RPC call\n * is one direct `transport.rpc` call carrying the tags of the `ChainDriver` method that made\n * it; `@solana/web3.js` is never on a request path. Answers are validated here: a malformed\n * answer is a retryable `PROVIDER_UNAVAILABLE`, never a foreign error.\n */\nimport {\n  ProviderError,\n  isCryptoAioError,\n  type CryptoAioError,\n} from '../../core/errors/error';\nimport type { Transport } from '../../core/transport/types';\nimport { canonicalJson } from '../../core/util/json';\nimport type { Commitment, SolanaCallTags } from './types';\n\nexport const READ: SolanaCallTags = Object.freeze({ purpose: 'read', retry: 'safe' });\nexport const MONITOR: SolanaCallTags = Object.freeze({\n  purpose: 'monitor',\n  retry: 'safe',\n});\nexport const PROOF: SolanaCallTags = Object.freeze({\n  purpose: 'proof',\n  retry: 'safe',\n  quorum: 'proof',\n});\nexport const BROADCAST: SolanaCallTags = Object.freeze({\n  purpose: 'broadcast',\n  retry: 'ambiguous-on-failure',\n});\n\nexport const withSignal = (tags: SolanaCallTags, signal?: AbortSignal): SolanaCallTags =>\n  signal ? { ...tags, signal } : tags;\n\n/** Solana's JSON-RPC server errors (agave `rpc-client-api/src/custom_error.rs`). */\nexport const RPC_CODES = Object.freeze({\n  BLOCK_CLEANED_UP: -32001,\n  SEND_TRANSACTION_PREFLIGHT_FAILURE: -32002,\n  TRANSACTION_SIGNATURE_VERIFICATION_FAILURE: -32003,\n  BLOCK_NOT_AVAILABLE: -32004,\n  SLOT_SKIPPED: -32007,\n  LONG_TERM_STORAGE_SLOT_SKIPPED: -32009,\n  TRANSACTION_HISTORY_NOT_AVAILABLE: -32011,\n  BLOCK_STATUS_NOT_AVAILABLE_YET: -32014,\n  MIN_CONTEXT_SLOT_NOT_REACHED: -32016,\n  LONG_TERM_STORAGE_UNREACHABLE: -32019,\n  FILTER_TRANSACTION_NOT_FOUND: -32020,\n});\n\n/** \"Not yet\": the endpoint has not reached that slot or state. */\nconst NOT_YET = new Set<number>([\n  RPC_CODES.BLOCK_NOT_AVAILABLE,\n  RPC_CODES.BLOCK_STATUS_NOT_AVAILABLE_YET,\n  RPC_CODES.MIN_CONTEXT_SLOT_NOT_REACHED,\n]);\n\n/** \"No longer, or never here\": pruned, not in long-term storage, or no history at all. */\nconst GONE = new Set<number>([\n  RPC_CODES.BLOCK_CLEANED_UP,\n  RPC_CODES.LONG_TERM_STORAGE_SLOT_SKIPPED,\n  RPC_CODES.TRANSACTION_HISTORY_NOT_AVAILABLE,\n  RPC_CODES.LONG_TERM_STORAGE_UNREACHABLE,\n]);\n\n/** The JSON-RPC code of a definitive, non-ambiguous `RPC_ERROR`; otherwise `undefined`. */\nexport function rpcCode(error: unknown): number | undefined {\n  if (!isCryptoAioError(error, 'RPC_ERROR') || error.ambiguous) return undefined;\n  const code = error.details?.rpcCode;\n  return typeof code === 'number' ? code : undefined;\n}\n\n/** The node's message of a definitive, non-ambiguous `RPC_ERROR`. */\nexport function rpcMessage(error: CryptoAioError): string {\n  return String(error.details?.rpcMessage ?? error.message);\n}\n\nconst hasCode = (error: unknown, codes: ReadonlySet<number>): boolean => {\n  const code = rpcCode(error);\n  return code !== undefined && codes.has(code);\n};\n\n/** The endpoint has not reached that block or state yet (`null`, decides nothing). */\nexport const isNotYet = (error: unknown): boolean => hasCode(error, NOT_YET);\n\n/** The endpoint no longer holds that block or history, or never did (decides nothing). */\nexport const isGone = (error: unknown): boolean => hasCode(error, GONE);\n\n/** The endpoint says the slot was skipped, or is missing on this endpoint (`-32007`). */\nexport const isSkipped = (error: unknown): boolean =>\n  rpcCode(error) === RPC_CODES.SLOT_SKIPPED;\n\n/** Any answer meaning \"this endpoint cannot show that\": it never decides anything. */\nexport const isNotAvailable = (error: unknown): boolean =>\n  isNotYet(error) || isGone(error) || isSkipped(error);\n\n/** A retryable error that decides nothing: the endpoint no longer holds what was asked. */\nexport const gone = (what: string) =>\n  new ProviderError('PROVIDER_UNAVAILABLE', `the endpoint no longer holds ${what}`);\n\n/** A retryable error that decides nothing: the endpoints cannot show this yet. */\nexport const notYet = (what: string) =>\n  new ProviderError('PROVIDER_UNAVAILABLE', `the endpoints cannot show ${what} yet`);\n\n/**\n * On a proof path only a definitive negative proof answers \"no\". Any\n * other definitive RPC error (agave 4.3.0's `getBlocks` answers `-32602 \"BigTable query\n * failed\"` for a range below its local ledger, `-32603` on a blockstore error) decides\n * nothing: it becomes a retryable `PROVIDER_UNAVAILABLE`. Every other error (retryable\n * ones, `PROVIDER_MISCONFIGURED`) is returned unchanged.\n */\nexport function undecided(error: unknown, what: string): unknown {\n  if (!isCryptoAioError(error, 'RPC_ERROR')) return error;\n  return new ProviderError(\n    'PROVIDER_UNAVAILABLE',\n    `the endpoints cannot show ${what}: ${rpcMessage(error)}`,\n    {\n      cause: error,\n      context: error.context,\n      ...(error.details ? { details: error.details } : {}),\n    },\n  );\n}\n\nexport const malformed = (what: string) =>\n  new ProviderError('PROVIDER_UNAVAILABLE', `malformed ${what} answer`);\n\nexport const inconsistent = (what: string) =>\n  new ProviderError('PROVIDER_INCONSISTENT', what, { retryable: true });\n\n/** A JSON object's fields, or `null` for anything else (arrays and `null` included). */\nexport const record = (value: unknown): Record<string, unknown> | null =>\n  value !== null && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n\n/**\n * An unsigned 64-bit JSON integer (lamports, slots, heights) as a `bigint`. Every call\n * parses with `exactIntegers`, so a value above 2^53 − 1 arrives as a `bigint`; a\n * number outside the safe range was rounded somewhere and is refused as malformed.\n */\nexport function u64(value: unknown, what: string): bigint {\n  if (typeof value === 'bigint' && value >= 0n && value < 2n ** 64n) return value;\n  if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0) {\n    return BigInt(value);\n  }\n  throw malformed(what);\n}\n\n/** A decimal string of base units (token amounts), as a `bigint`. */\nexport function amountString(value: unknown, what: string): bigint {\n  if (typeof value !== 'string' || !/^(0|[1-9][0-9]{0,19})$/.test(value)) {\n    throw malformed(what);\n  }\n  const amount = BigInt(value);\n  if (amount >= 2n ** 64n) throw malformed(what);\n  return amount;\n}\n\n/** The `value` of an RPC response with context (`{ context: { slot }, value }`). */\nexport function contextValue(result: unknown, what: string): unknown {\n  const body = record(result);\n  if (!body || !record(body.context) || !('value' in body)) throw malformed(what);\n  return body.value;\n}\n\n/** A block header as `getBlock` returns it with `transactionDetails: 'none'`. */\nexport interface BlockHeader {\n  readonly blockhash: string;\n  readonly previousBlockhash: string;\n  readonly parentSlot: bigint;\n  readonly blockHeight: bigint;\n  /** Unix seconds, when the node estimates one. */\n  readonly blockTime?: number;\n}\n\nexport function blockHeader(result: unknown): BlockHeader {\n  const block = record(result);\n  if (!block) throw malformed('getBlock');\n  const { blockhash, previousBlockhash, parentSlot, blockHeight, blockTime } = block;\n  if (typeof blockhash !== 'string' || typeof previousBlockhash !== 'string') {\n    throw malformed('getBlock');\n  }\n  // Blocks from before block heights were recorded (2020) carry `blockHeight: null`.\n  if (blockHeight === null) throw malformed('getBlock (no block height)');\n  return {\n    blockhash,\n    previousBlockhash,\n    parentSlot: u64(parentSlot, 'parent slot'),\n    blockHeight: u64(blockHeight, 'block height'),\n    ...(typeof blockTime === 'number' && Number.isSafeInteger(blockTime)\n      ? { blockTime }\n      : {}),\n  };\n}\n\nexport const pick = (value: unknown, keys: readonly string[]): unknown => {\n  const object = record(value);\n  if (!object) return value;\n  return Object.fromEntries(keys.map((key) => [key, object[key] ?? null]));\n};\n\n/** The consensus fields of a block header, compared under a quorum. */\nexport const BLOCK_FIELDS = [\n  'blockhash',\n  'previousBlockhash',\n  'parentSlot',\n  'blockHeight',\n] as const;\n\n/** The token-program instructions (outer and inner) projected to what a verdict reads. */\nfunction tokenInstructions(tx: Record<string, unknown>): unknown[] {\n  const message = record(record(tx.transaction)?.message);\n  const meta = record(tx.meta);\n  const outer = Array.isArray(message?.instructions) ? message.instructions : [];\n  const inner = Array.isArray(meta?.innerInstructions)\n    ? meta.innerInstructions.flatMap((group) => {\n        const list = record(group)?.instructions;\n        return Array.isArray(list) ? list : [];\n      })\n    : [];\n  return [...outer, ...inner].flatMap((ix) => {\n    const instruction = record(ix);\n    const parsed = record(instruction?.parsed);\n    const info = record(parsed?.info);\n    if (instruction?.program !== 'spl-token' || !parsed || !info) return [];\n    return [\n      {\n        programId: instruction.programId ?? null,\n        type: parsed.type ?? null,\n        source: info.source ?? null,\n        destination: info.destination ?? null,\n        authority: info.authority ?? info.multisigAuthority ?? null,\n        mint: info.mint ?? null,\n        amount: info.amount ?? record(info.tokenAmount)?.amount ?? null,\n      },\n    ];\n  });\n}\n\n/** Token balances by account index (providers may list them in another order). */\nconst tokenBalances = (list: unknown): unknown =>\n  Array.isArray(list)\n    ? list\n        .map((entry) => {\n          const balance = record(entry);\n          return {\n            accountIndex: balance?.accountIndex ?? null,\n            mint: balance?.mint ?? null,\n            amount: record(balance?.uiTokenAmount)?.amount ?? null,\n          };\n        })\n        .sort((a, b) => Number(a.accountIndex) - Number(b.accountIndex))\n    : null;\n\n/**\n * A finalized transaction's consensus facts, as far as a verdict reads them\n * (slot, error, signatures, account keys, token balances, token transfer instructions).\n * Formatting that honest providers differ on (`uiAmount` floats, `stackHeight`, `owner` and\n * `programId` on balances, log messages, compute units, `blockTime`) is left out. The landing\n * guard (`decode.ts`) still requires `programId` on the transfer's balances: providers must\n * report it (current agave does), and through one that leaves it out no SPL verdict ever\n * decides, which costs liveness only.\n */\nfunction transactionKey(result: unknown): unknown {\n  if (result === null) return null;\n  const tx = record(result);\n  if (!tx) throw malformed('getTransaction');\n  const meta = record(tx.meta);\n  const message = record(record(tx.transaction)?.message);\n  const keys = Array.isArray(message?.accountKeys)\n    ? message.accountKeys.map((key) => record(key)?.pubkey ?? key)\n    : null;\n  return {\n    slot: tx.slot ?? null,\n    err: canonicalJson(meta?.err ?? null),\n    signatures: record(tx.transaction)?.signatures ?? null,\n    accountKeys: keys,\n    preTokenBalances: tokenBalances(meta?.preTokenBalances),\n    postTokenBalances: tokenBalances(meta?.postTokenBalances),\n    tokenInstructions: tokenInstructions(tx),\n  };\n}\n\n/**\n * The consensus facts compared under a quorum, per method. A key that throws\n * counts as a disagreement (a retryable `PROVIDER_INCONSISTENT`).\n */\nexport function quorumKeyFor(method: string): ((result: unknown) => unknown) | undefined {\n  switch (method) {\n    case 'getBlock':\n      return (result) => pick(result, BLOCK_FIELDS);\n    case 'getTransaction':\n      return transactionKey;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * One JSON-RPC call through the transport, under the calling driver method's tags. Solana\n * sends u64 values (lamports) as JSON numbers, so every answer is parsed with\n * `exactIntegers`: nothing above 2^53 − 1 is ever rounded.\n */\nexport function call(\n  transport: Transport,\n  method: string,\n  params: readonly unknown[],\n  tags: SolanaCallTags,\n): Promise<unknown> {\n  const quorumKey =\n    tags.quorum !== undefined ? (tags.quorumKey ?? quorumKeyFor(method)) : undefined;\n  return transport.rpc(method, params, {\n    ...tags,\n    ...(quorumKey ? { quorumKey } : {}),\n    exactIntegers: true,\n  });\n}\n\n/** `getBlock` options for a header (no transactions, no rewards). */\nexport const headerOptions = (commitment: Commitment) => ({\n  commitment,\n  transactionDetails: 'none',\n  rewards: false,\n});\n\n/** `getBlock`/`getTransaction` options for decoding (every transaction version we parse). */\nexport const parsedOptions = (commitment: Commitment) => ({\n  commitment,\n  encoding: 'jsonParsed',\n  maxSupportedTransactionVersion: 0,\n});\n"]}

package/dist/adapters/solana/tokens.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Well-known SPL tokens: USDC and USDT where their issuers list a Solana mint (Circle's
+ * USDC addresses page, Tether's supported-protocols page). All are classic Token program
+ * mints with 6 decimals, read from the chain (`getAccountInfo` on mainnet and devnet).
+ */
+import type { AssetRegistration } from '../../core/registry/assets';
+export declare const SOLANA_TOKENS: readonly AssetRegistration[];

package/dist/adapters/solana/tokens.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOLANA_TOKENS = void 0;
+const freeze_1 = require("../../core/util/freeze");
+function token(network, symbol, mint) {
+    return {
+        chain: 'solana',
+        network,
+        ref: { standard: 'spl', contract: mint },
+        metadata: { symbol, decimals: 6 },
+        aliases: [symbol],
+    };
+}
+exports.SOLANA_TOKENS = (0, freeze_1.deepFreeze)([
+    token('mainnet', 'USDC', 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'),
+    token('mainnet', 'USDT', 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB'),
+    token('devnet', 'USDC', '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU'),
+]);
+//# sourceMappingURL=tokens.js.map

package/dist/adapters/solana/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/adapters/solana/tokens.ts"],"names":[],"mappings":";;;AAMA,mDAAoD;AAEpD,SAAS,KAAK,CACZ,OAA6B,EAC7B,MAAuB,EACvB,IAAY;IAEZ,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,OAAO;QACP,GAAG,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;QACjC,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB,CAAC;AACJ,CAAC;AAEY,QAAA,aAAa,GAAiC,IAAA,mBAAU,EAAC;IACpE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,8CAA8C,CAAC;IACxE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,8CAA8C,CAAC;IACxE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,8CAA8C,CAAC;CACxE,CAAC,CAAC","sourcesContent":["/**\n * Well-known SPL tokens: USDC and USDT where their issuers list a Solana mint (Circle's\n * USDC addresses page, Tether's supported-protocols page). All are classic Token program\n * mints with 6 decimals, read from the chain (`getAccountInfo` on mainnet and devnet).\n */\nimport type { AssetRegistration } from '../../core/registry/assets';\nimport { deepFreeze } from '../../core/util/freeze';\n\nfunction token(\n  network: 'mainnet' | 'devnet',\n  symbol: 'USDC' | 'USDT',\n  mint: string,\n): AssetRegistration {\n  return {\n    chain: 'solana',\n    network,\n    ref: { standard: 'spl', contract: mint },\n    metadata: { symbol, decimals: 6 },\n    aliases: [symbol],\n  };\n}\n\nexport const SOLANA_TOKENS: readonly AssetRegistration[] = deepFreeze([\n  token('mainnet', 'USDC', 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'),\n  token('mainnet', 'USDT', 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB'),\n  token('devnet', 'USDC', '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU'),\n]);\n"]}

package/dist/adapters/solana/types.d.ts

@@ -0,0 +1,121 @@
+/**
+ * SDK-free types of the Solana family: the `ext.solana` API, fee details and overrides, and
+ * the narrow `SolanaCodec` that the `@solana/web3.js` module implements. Nothing
+ * here imports an SDK, so the composition root can export these types.
+ */
+import type { DisposableNativeClient } from '../../core/driver/types';
+import type { CallOptions } from '../../core/transport/types';
+declare module '../../index' {
+    interface ChainRegistry {
+        solana: {
+            family: 'solana';
+            network: 'mainnet' | 'devnet' | 'testnet';
+        };
+    }
+    interface FamilyRegistry {
+        solana: {
+            library: '@solana/web3.js';
+            ext: SolanaExt;
+            fee: SolanaFeeDetails;
+        };
+    }
+}
+/** One SPL token account (classic Token program) of an owner. */
+export interface SolanaTokenAccount {
+    /** The token account's own address (an associated token account or any other). */
+    readonly address: string;
+    readonly mint: string;
+    /** Base units of the mint. */
+    readonly amount: bigint;
+    readonly frozen: boolean;
+}
+/** `bc.ext.solana`: the Solana family extension. */
+export interface SolanaExt {
+    readonly solana: {
+        /**
+         * The owner's classic SPL token accounts, optionally for one mint, at the `confirmed`
+         * commitment. Token-2022 accounts are not listed (Token-2022 is unsupported).
+         */
+        getTokenAccounts(owner: string, mint?: string): Promise<readonly SolanaTokenAccount[]>;
+    };
+}
+/**
+ * `FeeEstimate.details` of the `solana` fee kind (lamports; compute-unit price in
+ * micro-lamports). The charges are `network` (the signature fee), `priority`
+ * (`ceil(computeUnitPrice × computeUnitLimit / 1_000_000)`) and, when the recipient's
+ * associated token account is created, `rent`.
+ */
+export interface SolanaFeeDetails {
+    readonly signatures: number;
+    /** The signature fee the node quoted for the message (`getFeeForMessage` minus priority). */
+    readonly baseFee: bigint;
+    readonly computeUnitLimit: bigint;
+    /** Micro-lamports per compute unit. */
+    readonly computeUnitPrice: bigint;
+    readonly priorityFee: bigint;
+    /** The rent-exempt deposit of a created associated token account; `0n` otherwise. */
+    readonly rent: bigint;
+    /** Whether the transaction creates the recipient's associated token account. */
+    readonly createsRecipientAccount: boolean;
+}
+/**
+ * An explicit Solana fee (`TransferIntent.fee`): the compute-unit price in micro-lamports
+ * (at most the handle's `maxComputeUnitPrice`) and, optionally, the compute-unit limit (1 to
+ * 1,400,000), which otherwise comes from a simulation of the transaction. A type alias, not
+ * an interface, so a value of this type is assignable to the core's `FeeOverride` record.
+ */
+export type SolanaFeeOverride = {
+    readonly computeUnitPrice: bigint;
+    readonly computeUnitLimit?: bigint;
+};
+/**
+ * The transport tags every Solana I/O call carries: purpose, retry, quorum, fanout, signal,
+ * and optionally the caller's own `quorumKey`, which replaces the method's
+ * default consensus key.
+ */
+export type SolanaCallTags = Pick<CallOptions, 'purpose' | 'retry' | 'quorum' | 'quorumKey' | 'fanout' | 'signal'>;
+export type Commitment = 'confirmed' | 'finalized';
+/**
+ * The expiry ordering a Solana build records: the recent blockhash's
+ * `lastValidBlockHeight`, the blockhash itself and the slot of its block, all from one
+ * `getLatestBlockhash` answer, so one endpoint's word. A verdict rests on the height the
+ * proof quorum attests for `blockhash` instead: the finalized block at
+ * `blockhashSlot`, when it carries the blockhash, gives the last valid height as its own
+ * height plus 150 (agave's `MAX_PROCESSING_AGE`); otherwise the finalized block 150 below
+ * `lastValidHeight` must carry it. No endpoint proposes the height: trusting the recorded
+ * one would let an endpoint that reported it too low prove the transfer expired while it
+ * can still land, and `rebuild` would pay twice. For the same reason a store must keep
+ * this ordering whole and unmodified: a changed `blockhash` misplaces the window.
+ */
+export interface SolanaExpiryOrdering {
+    readonly kind: 'expiry';
+    readonly lastValidHeight: bigint;
+    /** The message's recent blockhash (base58). */
+    readonly blockhash: string;
+    /** The slot of the block whose hash `blockhash` is. */
+    readonly blockhashSlot: bigint;
+}
+/** One instruction of a transaction we build: program, accounts and data. */
+export interface SolanaInstruction {
+    readonly programId: string;
+    readonly accounts: readonly {
+        readonly address: string;
+        readonly signer: boolean;
+        readonly writable: boolean;
+    }[];
+    readonly data: Uint8Array;
+}
+/**
+ * The codec work the driver delegates to `@solana/web3.js`: program-derived addresses and
+ * legacy message compilation. Inputs are already-validated canonical base58 keys; outputs
+ * are plain bytes and strings, never SDK objects, since store records hold plain data
+ * only.
+ */
+export interface SolanaCodec {
+    /** The associated token account of `owner` for `mint` (classic Token program). */
+    associatedTokenAddress(owner: string, mint: string): string;
+    /** The legacy message bytes: header, account keys, recent blockhash, instructions. */
+    compileMessage(payer: string, recentBlockhash: string, instructions: readonly SolanaInstruction[]): Uint8Array;
+    /** A fresh `Connection` on the same transport, for `crypto-aio/native`. */
+    createNative(): DisposableNativeClient;
+}

package/dist/{type/lib-types.js → adapters/solana/types.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=lib-types.js.map
+//# sourceMappingURL=types.js.map

package/dist/adapters/solana/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/solana/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * SDK-free types of the Solana family: the `ext.solana` API, fee details and overrides, and\n * the narrow `SolanaCodec` that the `@solana/web3.js` module implements. Nothing\n * here imports an SDK, so the composition root can export these types.\n */\nimport type { DisposableNativeClient } from '../../core/driver/types';\nimport type { CallOptions } from '../../core/transport/types';\n\n// Augment the registries through the package entry, as users do with 'crypto-aio'.\ndeclare module '../../index' {\n  interface ChainRegistry {\n    solana: { family: 'solana'; network: 'mainnet' | 'devnet' | 'testnet' };\n  }\n  interface FamilyRegistry {\n    solana: { library: '@solana/web3.js'; ext: SolanaExt; fee: SolanaFeeDetails };\n  }\n}\n\n/** One SPL token account (classic Token program) of an owner. */\nexport interface SolanaTokenAccount {\n  /** The token account's own address (an associated token account or any other). */\n  readonly address: string;\n  readonly mint: string;\n  /** Base units of the mint. */\n  readonly amount: bigint;\n  readonly frozen: boolean;\n}\n\n/** `bc.ext.solana`: the Solana family extension. */\nexport interface SolanaExt {\n  readonly solana: {\n    /**\n     * The owner's classic SPL token accounts, optionally for one mint, at the `confirmed`\n     * commitment. Token-2022 accounts are not listed (Token-2022 is unsupported).\n     */\n    getTokenAccounts(\n      owner: string,\n      mint?: string,\n    ): Promise<readonly SolanaTokenAccount[]>;\n  };\n}\n\n/**\n * `FeeEstimate.details` of the `solana` fee kind (lamports; compute-unit price in\n * micro-lamports). The charges are `network` (the signature fee), `priority`\n * (`ceil(computeUnitPrice × computeUnitLimit / 1_000_000)`) and, when the recipient's\n * associated token account is created, `rent`.\n */\nexport interface SolanaFeeDetails {\n  readonly signatures: number;\n  /** The signature fee the node quoted for the message (`getFeeForMessage` minus priority). */\n  readonly baseFee: bigint;\n  readonly computeUnitLimit: bigint;\n  /** Micro-lamports per compute unit. */\n  readonly computeUnitPrice: bigint;\n  readonly priorityFee: bigint;\n  /** The rent-exempt deposit of a created associated token account; `0n` otherwise. */\n  readonly rent: bigint;\n  /** Whether the transaction creates the recipient's associated token account. */\n  readonly createsRecipientAccount: boolean;\n}\n\n/**\n * An explicit Solana fee (`TransferIntent.fee`): the compute-unit price in micro-lamports\n * (at most the handle's `maxComputeUnitPrice`) and, optionally, the compute-unit limit (1 to\n * 1,400,000), which otherwise comes from a simulation of the transaction. A type alias, not\n * an interface, so a value of this type is assignable to the core's `FeeOverride` record.\n */\nexport type SolanaFeeOverride = {\n  readonly computeUnitPrice: bigint;\n  readonly computeUnitLimit?: bigint;\n};\n\n/**\n * The transport tags every Solana I/O call carries: purpose, retry, quorum, fanout, signal,\n * and optionally the caller's own `quorumKey`, which replaces the method's\n * default consensus key.\n */\nexport type SolanaCallTags = Pick<\n  CallOptions,\n  'purpose' | 'retry' | 'quorum' | 'quorumKey' | 'fanout' | 'signal'\n>;\n\nexport type Commitment = 'confirmed' | 'finalized';\n\n/**\n * The expiry ordering a Solana build records: the recent blockhash's\n * `lastValidBlockHeight`, the blockhash itself and the slot of its block, all from one\n * `getLatestBlockhash` answer, so one endpoint's word. A verdict rests on the height the\n * proof quorum attests for `blockhash` instead: the finalized block at\n * `blockhashSlot`, when it carries the blockhash, gives the last valid height as its own\n * height plus 150 (agave's `MAX_PROCESSING_AGE`); otherwise the finalized block 150 below\n * `lastValidHeight` must carry it. No endpoint proposes the height: trusting the recorded\n * one would let an endpoint that reported it too low prove the transfer expired while it\n * can still land, and `rebuild` would pay twice. For the same reason a store must keep\n * this ordering whole and unmodified: a changed `blockhash` misplaces the window.\n */\nexport interface SolanaExpiryOrdering {\n  readonly kind: 'expiry';\n  readonly lastValidHeight: bigint;\n  /** The message's recent blockhash (base58). */\n  readonly blockhash: string;\n  /** The slot of the block whose hash `blockhash` is. */\n  readonly blockhashSlot: bigint;\n}\n\n/** One instruction of a transaction we build: program, accounts and data. */\nexport interface SolanaInstruction {\n  readonly programId: string;\n  readonly accounts: readonly {\n    readonly address: string;\n    readonly signer: boolean;\n    readonly writable: boolean;\n  }[];\n  readonly data: Uint8Array;\n}\n\n/**\n * The codec work the driver delegates to `@solana/web3.js`: program-derived addresses and\n * legacy message compilation. Inputs are already-validated canonical base58 keys; outputs\n * are plain bytes and strings, never SDK objects, since store records hold plain data\n * only.\n */\nexport interface SolanaCodec {\n  /** The associated token account of `owner` for `mint` (classic Token program). */\n  associatedTokenAddress(owner: string, mint: string): string;\n  /** The legacy message bytes: header, account keys, recent blockhash, instructions. */\n  compileMessage(\n    payer: string,\n    recentBlockhash: string,\n    instructions: readonly SolanaInstruction[],\n  ): Uint8Array;\n  /** A fresh `Connection` on the same transport, for `crypto-aio/native`. */\n  createNative(): DisposableNativeClient;\n}\n"]}

package/dist/adapters/solana/web3.d.ts

@@ -0,0 +1,5 @@
+import { type Transport } from '../../core/transport/types';
+import type { SolanaCodec } from './types';
+export declare function createWeb3Codec(transport: Transport): SolanaCodec;
+/** The `@solana/web3.js` adapter's driver factory; the manifest's `load()` returns it. */
+export declare const web3DriverFactory: import("../..").DriverFactory;