crypto-aio 0.1.0 → 0.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"fees.js","sourceRoot":"","sources":["../../../src/adapters/solana/fees.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The Solana fee policy (base fee plus priority), pure and bigint-only. The\n * priority fee is `ceil(computeUnitPrice × computeUnitLimit / 1_000_000)` lamports, charged\n * on the requested limit (Solana's fee documentation).\n */\nimport { ValidationError } from '../../core/errors/error';\nimport type {\n  FeeChargeDraft,\n  FeeEstimateDraft,\n  FeeOverride,\n  FeeSpeed,\n} from '../../core/model/fee';\nimport { DEFAULT_INSTRUCTION_COMPUTE_UNITS, MAX_COMPUTE_UNIT_LIMIT } from './programs';\nimport { malformed, u64 } from './rpc';\nimport type { SolanaFeeDetails, SolanaFeeOverride } from './types';\n\n/** Library policy: the percentile of recent prioritization fees each speed pays. */\nexport const SPEED_PERCENTILE: Readonly<Record<FeeSpeed, number>> = Object.freeze({\n  slow: 25,\n  normal: 50,\n  fast: 75,\n});\n\n/** Library policy: the compute-unit limit is the simulated usage plus 20% and 1,000 units. */\nexport function computeUnitLimitFor(unitsConsumed: bigint): bigint {\n  const limit = unitsConsumed + unitsConsumed / 5n + 1_000n;\n  return limit > MAX_COMPUTE_UNIT_LIMIT ? MAX_COMPUTE_UNIT_LIMIT : limit;\n}\n\n/** The runtime's own default when a simulation cannot measure the transaction. */\nexport function fallbackComputeUnitLimit(instructions: number): bigint {\n  const limit = DEFAULT_INSTRUCTION_COMPUTE_UNITS * BigInt(instructions);\n  return limit > MAX_COMPUTE_UNIT_LIMIT ? MAX_COMPUTE_UNIT_LIMIT : limit;\n}\n\n/**\n * Build variants: identical intents built on the same blockhash would\n * sign byte-identical messages, so a second Operation would silently share the first one's\n * signature and one payment would be lost. Each estimate therefore adds a variant to the\n * compute-unit limit (0 to 1,023 units) and, for a speed, to the price (0 to 999\n * micro-lamports): at most about one lamport of priority fee per 1,000 compute units.\n */\nexport const VARIANTS = 1_024 * 1_000;\n\nexport function variantOffsets(variant: number): {\n  readonly limit: bigint;\n  readonly price: bigint;\n} {\n  return {\n    limit: BigInt(variant % 1_024),\n    price: BigInt(Math.floor(variant / 1_024) % 1_000),\n  };\n}\n\n/** The largest price variant a speed adds, in micro-lamports per compute unit. */\nexport const MAX_PRICE_VARIANT = 999n;\n\n/**\n * A speed's signed price within the handle's `maxComputeUnitPrice`: the node's\n * percentile, at most the bound less the largest variant, plus this build's variant. The\n * signed price never exceeds the bound, and identical transfers still differ at it.\n * The bound is at least `MAX_PRICE_VARIANT` (`solanaNetworkConfig`).\n */\nexport function speedPrice(\n  percentile: bigint,\n  variant: bigint,\n  maxComputeUnitPrice: bigint,\n): bigint {\n  const ceiling = maxComputeUnitPrice - MAX_PRICE_VARIANT;\n  return (percentile < ceiling ? percentile : ceiling) + variant;\n}\n\n/**\n * An explicit price above the handle's bound, refused before anything is signed. The details\n * carry the price and the bound (decimal strings), so the caller sees what to allow.\n */\nexport function aboveMaxPrice(\n  price: bigint,\n  maxComputeUnitPrice: bigint,\n): ValidationError {\n  return new ValidationError(\n    'INVALID_INTENT',\n    'computeUnitPrice is above maxComputeUnitPrice, the Solana handle option that bounds it (micro-lamports per compute unit)',\n    {\n      details: {\n        required: price.toString(),\n        maxComputeUnitPrice: maxComputeUnitPrice.toString(),\n      },\n    },\n  );\n}\n\n/**\n * The highest recent price a speed pays: the u64 range less the largest price variant\n * (999), so the varied price still fits its u64 field.\n */\nconst MAX_RECENT_PRICE = 2n ** 64n - 1n - 999n;\n\n/** A per-driver counter from a random start: distinct in-process, rare across processes. */\nexport function variantCounter(start: number): () => number {\n  let next = start % VARIANTS;\n  return () => {\n    const variant = next;\n    next = (next + 1) % VARIANTS;\n    return variant;\n  };\n}\n\nexport function priorityFee(computeUnitPrice: bigint, computeUnitLimit: bigint): bigint {\n  return (computeUnitPrice * computeUnitLimit + 999_999n) / 1_000_000n;\n}\n\n/**\n * The nearest-rank percentile of `getRecentPrioritizationFees` answers (micro-lamports per\n * compute unit); `0n` when the node reports none. A malformed entry, including one outside\n * the u64 range or without room for the price variant, is a retryable\n * `PROVIDER_UNAVAILABLE`.\n */\nexport function priceForSpeed(recent: unknown, speed: FeeSpeed): bigint {\n  if (!Array.isArray(recent)) throw malformed('getRecentPrioritizationFees');\n  const fees = recent.map((entry: unknown) => {\n    const fee = u64(\n      (entry as { prioritizationFee?: unknown } | null)?.prioritizationFee,\n      'getRecentPrioritizationFees',\n    );\n    if (fee > MAX_RECENT_PRICE) throw malformed('getRecentPrioritizationFees');\n    return fee;\n  });\n  if (fees.length === 0) return 0n;\n  fees.sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));\n  const rank = Math.ceil((SPEED_PERCENTILE[speed] / 100) * fees.length);\n  return fees[Math.max(0, rank - 1)] as bigint;\n}\n\n/** A validated `SolanaFeeOverride`; anything else is `INVALID_INTENT`. */\nexport function parseOverride(fee: FeeOverride): SolanaFeeOverride {\n  const invalid = (reason: string) =>\n    new ValidationError('INVALID_INTENT', `Solana fee override: ${reason}`);\n  const keys = Object.keys(fee);\n  if (keys.some((key) => key !== 'computeUnitPrice' && key !== 'computeUnitLimit')) {\n    throw invalid('only computeUnitPrice and computeUnitLimit are allowed');\n  }\n  const { computeUnitPrice, computeUnitLimit } = fee;\n  if (\n    typeof computeUnitPrice !== 'bigint' ||\n    computeUnitPrice < 0n ||\n    computeUnitPrice >= 2n ** 64n\n  ) {\n    throw invalid('computeUnitPrice must be a bigint of micro-lamports in the u64 range');\n  }\n  if (\n    computeUnitLimit !== undefined &&\n    (typeof computeUnitLimit !== 'bigint' ||\n      computeUnitLimit < 1n ||\n      computeUnitLimit > MAX_COMPUTE_UNIT_LIMIT)\n  ) {\n    throw invalid('computeUnitLimit must be a bigint from 1 to 1,400,000');\n  }\n  return {\n    computeUnitPrice,\n    ...(computeUnitLimit !== undefined ? { computeUnitLimit } : {}),\n  };\n}\n\n/**\n * The fee draft: `network` (the signature fee), `priority` and, when the recipient's token\n * account is created, `rent`. The bound is `exact` unless rent is charged: that deposit is\n * skipped when someone else creates the account first, so it is an upper bound.\n */\nexport function feeDraft(\n  speed: FeeSpeed | 'custom',\n  details: SolanaFeeDetails,\n): FeeEstimateDraft {\n  const charges: FeeChargeDraft[] = [\n    { asset: 'native', amount: details.baseFee, label: 'network' },\n    { asset: 'native', amount: details.priorityFee, label: 'priority' },\n  ];\n  if (details.createsRecipientAccount) {\n    charges.push({ asset: 'native', amount: details.rent, label: 'rent' });\n  }\n  return {\n    kind: 'solana',\n    speed,\n    charges,\n    bound: details.createsRecipientAccount ? 'upper' : 'exact',\n    details: { ...details },\n  };\n}\n\n/** The `SolanaFeeDetails` of a draft this driver made; anything else is `INVALID_INTENT`. */\nexport function detailsOf(fee: FeeEstimateDraft): SolanaFeeDetails {\n  const d = fee.details as Partial<SolanaFeeDetails>;\n  if (\n    fee.kind !== 'solana' ||\n    typeof d.computeUnitLimit !== 'bigint' ||\n    typeof d.computeUnitPrice !== 'bigint' ||\n    typeof d.baseFee !== 'bigint' ||\n    typeof d.priorityFee !== 'bigint' ||\n    typeof d.rent !== 'bigint' ||\n    typeof d.signatures !== 'number' ||\n    typeof d.createsRecipientAccount !== 'boolean'\n  ) {\n    throw new ValidationError('INVALID_INTENT', 'not a Solana fee estimate');\n  }\n  return {\n    signatures: d.signatures,\n    baseFee: d.baseFee,\n    computeUnitLimit: d.computeUnitLimit,\n    computeUnitPrice: d.computeUnitPrice,\n    priorityFee: d.priorityFee,\n    rent: d.rent,\n    createsRecipientAccount: d.createsRecipientAccount,\n  };\n}\n\n/**\n * The compute budget `build` signs, checked wherever the estimate\n * came from (the store, `prepareTransfer`, a caller): the price within the handle's bound,\n * the limit within the protocol's, and the priority fee exactly the one that budget costs.\n */\nexport function signedFee(\n  fee: FeeEstimateDraft,\n  maxComputeUnitPrice: bigint,\n): SolanaFeeDetails {\n  const details = detailsOf(fee);\n  const { computeUnitPrice: price, computeUnitLimit: limit } = details;\n  if (price > maxComputeUnitPrice) throw aboveMaxPrice(price, maxComputeUnitPrice);\n  if (\n    price < 0n ||\n    limit < 1n ||\n    limit > MAX_COMPUTE_UNIT_LIMIT ||\n    details.priorityFee !== priorityFee(price, limit)\n  ) {\n    throw new ValidationError(\n      'INVALID_INTENT',\n      'the fee estimate is not consistent with its own compute budget',\n    );\n  }\n  return details;\n}\n\n/** The lamports every fee charge of `fee` adds up to. */\nexport const lamportsCharged = (fee: FeeEstimateDraft): bigint =>\n  fee.charges.reduce((sum, charge) => sum + charge.amount, 0n);\n"]}
+{"version":3,"file":"fees.js","sourceRoot":"","sources":["../../../src/adapters/solana/fees.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The Solana fee policy (base fee plus priority), pure and bigint-only. The base fee is\n * `LAMPORTS_PER_SIGNATURE` per signature, and the priority fee is\n * `ceil(computeUnitPrice × computeUnitLimit / 1_000_000)` lamports, charged on the requested\n * limit (Solana's fee documentation; agave `get_prioritization_fee`).\n */\nimport { ValidationError } from '../../core/errors/error';\nimport type {\n  FeeChargeDraft,\n  FeeEstimateDraft,\n  FeeOverride,\n  FeeSpeed,\n} from '../../core/model/fee';\nimport { DEFAULT_INSTRUCTION_COMPUTE_UNITS, MAX_COMPUTE_UNIT_LIMIT } from './programs';\nimport { malformed, u64 } from './rpc';\nimport type { SolanaFeeDetails, SolanaFeeOverride } from './types';\n\n/**\n * The signature fee, in lamports per signature of a message: agave's `FeeStructure` rate,\n * which every bank charges since the fee-rate governor was retired (`get_fee_for_message`\n * reads the blockhash's recorded rate only to know the blockhash). agave's\n * `calculate_signature_fee` also counts precompile (ed25519, secp256k1, secp256r1)\n * signatures; a transfer carries none, so its base fee follows from its signers alone.\n */\nexport const LAMPORTS_PER_SIGNATURE = 5_000n;\n\n/** Library policy: the percentile of recent prioritization fees each speed pays. */\nexport const SPEED_PERCENTILE: Readonly<Record<FeeSpeed, number>> = Object.freeze({\n  slow: 25,\n  normal: 50,\n  fast: 75,\n});\n\n/** Library policy: the compute-unit limit is the simulated usage plus 20% and 1,000 units. */\nexport function computeUnitLimitFor(unitsConsumed: bigint): bigint {\n  const limit = unitsConsumed + unitsConsumed / 5n + 1_000n;\n  return limit > MAX_COMPUTE_UNIT_LIMIT ? MAX_COMPUTE_UNIT_LIMIT : limit;\n}\n\n/** The runtime's own default when a simulation cannot measure the transaction. */\nexport function fallbackComputeUnitLimit(instructions: number): bigint {\n  const limit = DEFAULT_INSTRUCTION_COMPUTE_UNITS * BigInt(instructions);\n  return limit > MAX_COMPUTE_UNIT_LIMIT ? MAX_COMPUTE_UNIT_LIMIT : limit;\n}\n\n/**\n * Build variants: identical intents built on the same blockhash would\n * sign byte-identical messages, so a second Operation would silently share the first one's\n * signature and one payment would be lost. Each estimate therefore adds a variant to the\n * compute-unit limit (0 to 1,023 units) and, for a speed, to the price (0 to 999\n * micro-lamports): at most about one lamport of priority fee per 1,000 compute units.\n */\nexport const VARIANTS = 1_024 * 1_000;\n\nexport function variantOffsets(variant: number): {\n  readonly limit: bigint;\n  readonly price: bigint;\n} {\n  return {\n    limit: BigInt(variant % 1_024),\n    price: BigInt(Math.floor(variant / 1_024) % 1_000),\n  };\n}\n\n/** The largest price variant a speed adds, in micro-lamports per compute unit. */\nexport const MAX_PRICE_VARIANT = 999n;\n\n/**\n * A speed's signed price within the handle's `maxComputeUnitPrice`: the node's\n * percentile, at most the bound less the largest variant, plus this build's variant. The\n * signed price never exceeds the bound, and identical transfers still differ at it.\n * The bound is at least `MAX_PRICE_VARIANT` (`solanaNetworkConfig`).\n */\nexport function speedPrice(\n  percentile: bigint,\n  variant: bigint,\n  maxComputeUnitPrice: bigint,\n): bigint {\n  const ceiling = maxComputeUnitPrice - MAX_PRICE_VARIANT;\n  return (percentile < ceiling ? percentile : ceiling) + variant;\n}\n\n/**\n * An explicit price above the handle's bound, refused before anything is signed. The details\n * carry the price and the bound (decimal strings), so the caller sees what to allow.\n */\nexport function aboveMaxPrice(\n  price: bigint,\n  maxComputeUnitPrice: bigint,\n): ValidationError {\n  return new ValidationError(\n    'INVALID_INTENT',\n    'computeUnitPrice is above maxComputeUnitPrice, the Solana handle option that bounds it (micro-lamports per compute unit)',\n    {\n      details: {\n        required: price.toString(),\n        maxComputeUnitPrice: maxComputeUnitPrice.toString(),\n      },\n    },\n  );\n}\n\n/**\n * The highest recent price a speed pays: the u64 range less the largest price variant\n * (999), so the varied price still fits its u64 field.\n */\nconst MAX_RECENT_PRICE = 2n ** 64n - 1n - 999n;\n\n/** A per-driver counter from a random start: distinct in-process, rare across processes. */\nexport function variantCounter(start: number): () => number {\n  let next = start % VARIANTS;\n  return () => {\n    const variant = next;\n    next = (next + 1) % VARIANTS;\n    return variant;\n  };\n}\n\nexport function priorityFee(computeUnitPrice: bigint, computeUnitLimit: bigint): bigint {\n  return (computeUnitPrice * computeUnitLimit + 999_999n) / 1_000_000n;\n}\n\n/**\n * The nearest-rank percentile of `getRecentPrioritizationFees` answers (micro-lamports per\n * compute unit); `0n` when the node reports none. A malformed entry, including one outside\n * the u64 range or without room for the price variant, is a retryable\n * `PROVIDER_UNAVAILABLE`.\n */\nexport function priceForSpeed(recent: unknown, speed: FeeSpeed): bigint {\n  if (!Array.isArray(recent)) throw malformed('getRecentPrioritizationFees');\n  const fees = recent.map((entry: unknown) => {\n    const fee = u64(\n      (entry as { prioritizationFee?: unknown } | null)?.prioritizationFee,\n      'getRecentPrioritizationFees',\n    );\n    if (fee > MAX_RECENT_PRICE) throw malformed('getRecentPrioritizationFees');\n    return fee;\n  });\n  if (fees.length === 0) return 0n;\n  fees.sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));\n  const rank = Math.ceil((SPEED_PERCENTILE[speed] / 100) * fees.length);\n  return fees[Math.max(0, rank - 1)] as bigint;\n}\n\n/** A validated `SolanaFeeOverride`; anything else is `INVALID_INTENT`. */\nexport function parseOverride(fee: FeeOverride): SolanaFeeOverride {\n  const invalid = (reason: string) =>\n    new ValidationError('INVALID_INTENT', `Solana fee override: ${reason}`);\n  const keys = Object.keys(fee);\n  if (keys.some((key) => key !== 'computeUnitPrice' && key !== 'computeUnitLimit')) {\n    throw invalid('only computeUnitPrice and computeUnitLimit are allowed');\n  }\n  const { computeUnitPrice, computeUnitLimit } = fee;\n  if (\n    typeof computeUnitPrice !== 'bigint' ||\n    computeUnitPrice < 0n ||\n    computeUnitPrice >= 2n ** 64n\n  ) {\n    throw invalid('computeUnitPrice must be a bigint of micro-lamports in the u64 range');\n  }\n  if (\n    computeUnitLimit !== undefined &&\n    (typeof computeUnitLimit !== 'bigint' ||\n      computeUnitLimit < 1n ||\n      computeUnitLimit > MAX_COMPUTE_UNIT_LIMIT)\n  ) {\n    throw invalid('computeUnitLimit must be a bigint from 1 to 1,400,000');\n  }\n  return {\n    computeUnitPrice,\n    ...(computeUnitLimit !== undefined ? { computeUnitLimit } : {}),\n  };\n}\n\n/**\n * The fee draft: `network` (the signature fee), `priority` and, when the recipient's token\n * account is created, `rent`. The bound is `exact` unless rent is charged: that deposit is\n * skipped when someone else creates the account first, so it is an upper bound.\n */\nexport function feeDraft(\n  speed: FeeSpeed | 'custom',\n  details: SolanaFeeDetails,\n): FeeEstimateDraft {\n  const charges: FeeChargeDraft[] = [\n    { asset: 'native', amount: details.baseFee, label: 'network' },\n    { asset: 'native', amount: details.priorityFee, label: 'priority' },\n  ];\n  if (details.createsRecipientAccount) {\n    charges.push({ asset: 'native', amount: details.rent, label: 'rent' });\n  }\n  return {\n    kind: 'solana',\n    speed,\n    charges,\n    bound: details.createsRecipientAccount ? 'upper' : 'exact',\n    details: { ...details },\n  };\n}\n\n/** The `SolanaFeeDetails` of a draft this driver made; anything else is `INVALID_INTENT`. */\nexport function detailsOf(fee: FeeEstimateDraft): SolanaFeeDetails {\n  const d = fee.details as Partial<SolanaFeeDetails>;\n  if (\n    fee.kind !== 'solana' ||\n    typeof d.computeUnitLimit !== 'bigint' ||\n    typeof d.computeUnitPrice !== 'bigint' ||\n    typeof d.baseFee !== 'bigint' ||\n    typeof d.priorityFee !== 'bigint' ||\n    typeof d.rent !== 'bigint' ||\n    typeof d.signatures !== 'number' ||\n    typeof d.createsRecipientAccount !== 'boolean'\n  ) {\n    throw new ValidationError('INVALID_INTENT', 'not a Solana fee estimate');\n  }\n  return {\n    signatures: d.signatures,\n    baseFee: d.baseFee,\n    computeUnitLimit: d.computeUnitLimit,\n    computeUnitPrice: d.computeUnitPrice,\n    priorityFee: d.priorityFee,\n    rent: d.rent,\n    createsRecipientAccount: d.createsRecipientAccount,\n  };\n}\n\n/**\n * The compute budget `build` signs, checked wherever the estimate\n * came from (the store, `prepareTransfer`, a caller): the price within the handle's bound,\n * the limit within the protocol's, and the priority fee exactly the one that budget costs.\n */\nexport function signedFee(\n  fee: FeeEstimateDraft,\n  maxComputeUnitPrice: bigint,\n): SolanaFeeDetails {\n  const details = detailsOf(fee);\n  const { computeUnitPrice: price, computeUnitLimit: limit } = details;\n  if (price > maxComputeUnitPrice) throw aboveMaxPrice(price, maxComputeUnitPrice);\n  if (\n    price < 0n ||\n    limit < 1n ||\n    limit > MAX_COMPUTE_UNIT_LIMIT ||\n    details.priorityFee !== priorityFee(price, limit)\n  ) {\n    throw new ValidationError(\n      'INVALID_INTENT',\n      'the fee estimate is not consistent with its own compute budget',\n    );\n  }\n  return details;\n}\n\n/** The lamports every fee charge of `fee` adds up to. */\nexport const lamportsCharged = (fee: FeeEstimateDraft): bigint =>\n  fee.charges.reduce((sum, charge) => sum + charge.amount, 0n);\n"]}

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

@@ -0,0 +1,15 @@
+import type { SolanaInstruction } from './types';
+/**
+ * `findProgramAddressSync`: the first bump from 255 down whose address is off the curve,
+ * so no private key can sign for it. A seed is at most 32 bytes, as the runtime requires.
+ */
+export declare function programAddress(seeds: readonly Uint8Array[], programId: string): string;
+/** The associated token account of `owner` for `mint` (classic Token program). */
+export declare function associatedTokenAddress(owner: string, mint: string): string;
+/**
+ * A legacy message by the Solana message rules, as `@solana/web3.js` compiles it: the
+ * payer first, then the signers (writable, then read-only) and the non-signers (writable,
+ * then read-only), each group in order of first appearance, an instruction's program id
+ * before its accounts; an account is a signer or writable when any use makes it one.
+ */
+export declare function compileLegacyMessage(payer: string, recentBlockhash: string, instructions: readonly SolanaInstruction[]): Uint8Array;

package/dist/adapters/solana/message.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.programAddress = programAddress;
+exports.associatedTokenAddress = associatedTokenAddress;
+exports.compileLegacyMessage = compileLegacyMessage;
+/**
+ * The two pieces of Solana's wire format the driver builds itself, SDK-free: a legacy
+ * message and a program-derived address. Both used to come from `@solana/web3.js`, whose
+ * 3.x line dropped the synchronous derivation and rebuilt its classes on Kit; owning them
+ * keeps every signed byte independent of the SDK version a user installs. `codec.test.ts`
+ * checks both against `@solana/web3.js` 1.99 and frozen vectors.
+ */
+const ed25519_1 = require("@noble/curves/ed25519");
+const sha256_1 = require("@noble/hashes/sha256");
+const base_1 = require("@scure/base");
+const error_1 = require("../../core/errors/error");
+const programs_1 = require("./programs");
+const wire_1 = require("./wire");
+const PDA_MARKER = new TextEncoder().encode('ProgramDerivedAddress');
+/** A 32-byte public key from its base58 text; the inputs are already validated. */
+function key(address) {
+    const bytes = base_1.base58.decode(address);
+    if (bytes.length !== 32) {
+        throw new error_1.ValidationError('INVALID_ADDRESS', 'a Solana key is 32 bytes');
+    }
+    return bytes;
+}
+/** Whether `bytes` is a point of the ed25519 curve, i.e. could have a private key. */
+function onCurve(bytes) {
+    try {
+        ed25519_1.ed25519.ExtendedPoint.fromHex(bytes);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * `findProgramAddressSync`: the first bump from 255 down whose address is off the curve,
+ * so no private key can sign for it. A seed is at most 32 bytes, as the runtime requires.
+ */
+function programAddress(seeds, programId) {
+    const program = key(programId);
+    for (let bump = 255; bump >= 0; bump--) {
+        const hash = sha256_1.sha256
+            .create()
+            .update(Uint8Array.from(seeds.flatMap((seed) => [...seed])))
+            .update(Uint8Array.of(bump))
+            .update(program)
+            .update(PDA_MARKER)
+            .digest();
+        if (!onCurve(hash))
+            return base_1.base58.encode(hash);
+    }
+    // Each bump has a one-in-two chance; all 256 failing does not happen.
+    throw new error_1.ValidationError('INVALID_ADDRESS', 'no program address for these seeds');
+}
+/** The associated token account of `owner` for `mint` (classic Token program). */
+function associatedTokenAddress(owner, mint) {
+    return programAddress([key(owner), key(programs_1.TOKEN_PROGRAM), key(mint)], programs_1.ASSOCIATED_TOKEN_PROGRAM);
+}
+/**
+ * A legacy message by the Solana message rules, as `@solana/web3.js` compiles it: the
+ * payer first, then the signers (writable, then read-only) and the non-signers (writable,
+ * then read-only), each group in order of first appearance, an instruction's program id
+ * before its accounts; an account is a signer or writable when any use makes it one.
+ */
+function compileLegacyMessage(payer, recentBlockhash, instructions) {
+    const meta = new Map();
+    const note = (address, signer, writable) => {
+        const seen = meta.get(address);
+        meta.set(address, {
+            signer: (seen?.signer ?? false) || signer,
+            writable: (seen?.writable ?? false) || writable,
+        });
+    };
+    note(payer, true, true);
+    for (const ix of instructions) {
+        note(ix.programId, false, false);
+        for (const account of ix.accounts)
+            note(account.address, account.signer, account.writable);
+    }
+    const entries = [...meta.entries()];
+    const group = (signer, writable) => entries
+        .filter(([, m]) => m.signer === signer && m.writable === writable)
+        .map(([address]) => address);
+    const writableSigners = group(true, true);
+    const readonlySigners = group(true, false);
+    const writableOthers = group(false, true);
+    const readonlyOthers = group(false, false);
+    const keys = [
+        ...writableSigners,
+        ...readonlySigners,
+        ...writableOthers,
+        ...readonlyOthers,
+    ];
+    // Indices are single bytes in a legacy message.
+    if (keys.length > 256) {
+        throw new error_1.ValidationError('INVALID_INTENT', 'too many accounts for one message');
+    }
+    const index = new Map(keys.map((address, i) => [address, i]));
+    const parts = [
+        Uint8Array.of(writableSigners.length + readonlySigners.length, readonlySigners.length, readonlyOthers.length),
+        (0, wire_1.encodeLength)(keys.length),
+        ...keys.map(key),
+        key(recentBlockhash),
+        (0, wire_1.encodeLength)(instructions.length),
+    ];
+    for (const ix of instructions) {
+        parts.push(Uint8Array.of(index.get(ix.programId)), (0, wire_1.encodeLength)(ix.accounts.length), Uint8Array.from(ix.accounts.map((a) => index.get(a.address))), (0, wire_1.encodeLength)(ix.data.length), ix.data);
+    }
+    const out = new Uint8Array(parts.reduce((n, part) => n + part.length, 0));
+    let offset = 0;
+    for (const part of parts) {
+        out.set(part, offset);
+        offset += part.length;
+    }
+    return out;
+}
+//# sourceMappingURL=message.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/adapters/solana/message.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The two pieces of Solana's wire format the driver builds itself, SDK-free: a legacy\n * message and a program-derived address. Both used to come from `@solana/web3.js`, whose\n * 3.x line dropped the synchronous derivation and rebuilt its classes on Kit; owning them\n * keeps every signed byte independent of the SDK version a user installs. `codec.test.ts`\n * checks both against `@solana/web3.js` 1.99 and frozen vectors.\n */\nimport { ed25519 } from '@noble/curves/ed25519';\nimport { sha256 } from '@noble/hashes/sha256';\nimport { base58 } from '@scure/base';\nimport { ValidationError } from '../../core/errors/error';\nimport { ASSOCIATED_TOKEN_PROGRAM, TOKEN_PROGRAM } from './programs';\nimport type { SolanaInstruction } from './types';\nimport { encodeLength } from './wire';\n\nconst PDA_MARKER = new TextEncoder().encode('ProgramDerivedAddress');\n\n/** A 32-byte public key from its base58 text; the inputs are already validated. */\nfunction key(address: string): Uint8Array {\n  const bytes = base58.decode(address);\n  if (bytes.length !== 32) {\n    throw new ValidationError('INVALID_ADDRESS', 'a Solana key is 32 bytes');\n  }\n  return bytes;\n}\n\n/** Whether `bytes` is a point of the ed25519 curve, i.e. could have a private key. */\nfunction onCurve(bytes: Uint8Array): boolean {\n  try {\n    ed25519.ExtendedPoint.fromHex(bytes);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * `findProgramAddressSync`: the first bump from 255 down whose address is off the curve,\n * so no private key can sign for it. A seed is at most 32 bytes, as the runtime requires.\n */\nexport function programAddress(seeds: readonly Uint8Array[], programId: string): string {\n  const program = key(programId);\n  for (let bump = 255; bump >= 0; bump--) {\n    const hash = sha256\n      .create()\n      .update(Uint8Array.from(seeds.flatMap((seed) => [...seed])))\n      .update(Uint8Array.of(bump))\n      .update(program)\n      .update(PDA_MARKER)\n      .digest();\n    if (!onCurve(hash)) return base58.encode(hash);\n  }\n  // Each bump has a one-in-two chance; all 256 failing does not happen.\n  throw new ValidationError('INVALID_ADDRESS', 'no program address for these seeds');\n}\n\n/** The associated token account of `owner` for `mint` (classic Token program). */\nexport function associatedTokenAddress(owner: string, mint: string): string {\n  return programAddress(\n    [key(owner), key(TOKEN_PROGRAM), key(mint)],\n    ASSOCIATED_TOKEN_PROGRAM,\n  );\n}\n\n/**\n * A legacy message by the Solana message rules, as `@solana/web3.js` compiles it: the\n * payer first, then the signers (writable, then read-only) and the non-signers (writable,\n * then read-only), each group in order of first appearance, an instruction's program id\n * before its accounts; an account is a signer or writable when any use makes it one.\n */\nexport function compileLegacyMessage(\n  payer: string,\n  recentBlockhash: string,\n  instructions: readonly SolanaInstruction[],\n): Uint8Array {\n  const meta = new Map<string, { signer: boolean; writable: boolean }>();\n  const note = (address: string, signer: boolean, writable: boolean) => {\n    const seen = meta.get(address);\n    meta.set(address, {\n      signer: (seen?.signer ?? false) || signer,\n      writable: (seen?.writable ?? false) || writable,\n    });\n  };\n  note(payer, true, true);\n  for (const ix of instructions) {\n    note(ix.programId, false, false);\n    for (const account of ix.accounts)\n      note(account.address, account.signer, account.writable);\n  }\n  const entries = [...meta.entries()];\n  const group = (signer: boolean, writable: boolean) =>\n    entries\n      .filter(([, m]) => m.signer === signer && m.writable === writable)\n      .map(([address]) => address);\n  const writableSigners = group(true, true);\n  const readonlySigners = group(true, false);\n  const writableOthers = group(false, true);\n  const readonlyOthers = group(false, false);\n  const keys = [\n    ...writableSigners,\n    ...readonlySigners,\n    ...writableOthers,\n    ...readonlyOthers,\n  ];\n  // Indices are single bytes in a legacy message.\n  if (keys.length > 256) {\n    throw new ValidationError('INVALID_INTENT', 'too many accounts for one message');\n  }\n  const index = new Map(keys.map((address, i) => [address, i]));\n  const parts: Uint8Array[] = [\n    Uint8Array.of(\n      writableSigners.length + readonlySigners.length,\n      readonlySigners.length,\n      readonlyOthers.length,\n    ),\n    encodeLength(keys.length),\n    ...keys.map(key),\n    key(recentBlockhash),\n    encodeLength(instructions.length),\n  ];\n  for (const ix of instructions) {\n    parts.push(\n      Uint8Array.of(index.get(ix.programId) as number),\n      encodeLength(ix.accounts.length),\n      Uint8Array.from(ix.accounts.map((a) => index.get(a.address) as number)),\n      encodeLength(ix.data.length),\n      ix.data,\n    );\n  }\n  const out = new Uint8Array(parts.reduce((n, part) => n + part.length, 0));\n  let offset = 0;\n  for (const part of parts) {\n    out.set(part, offset);\n    offset += part.length;\n  }\n  return out;\n}\n"]}

package/dist/adapters/solana/plugin.js

@@ -8,7 +8,10 @@ const presets_1 = require("./presets");
 const tokens_1 = require("./tokens");
 /** The SDK versions this adapter is validated against, keyed by library. */
 exports.SOLANA_PEER_DEPENDENCIES = Object.freeze({
-    '@solana/web3.js': Object.freeze({ name: '@solana/web3.js', range: '^1.99.0' }),
+    '@solana/web3.js': Object.freeze({
+        name: '@solana/web3.js',
+        range: '^1.99.0 || ^3.0.0',
+    }),
 });
 /**
  * The `@solana/web3.js` manifest, built once, at module level, like the presets. Plugins

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/adapters/solana/plugin.ts"],"names":[],"mappings":";;;AA2CA,oCAQC;AAxCD,qCAAwC;AACxC,uCAAgD;AAChD,uCAA2C;AAC3C,qCAAyC;AAEzC,4EAA4E;AAC/D,QAAA,wBAAwB,GAEjC,MAAM,CAAC,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;CAChF,CAAC,CAAC;AAEH;;;;;GAKG;AACU,QAAA,cAAc,GAAoB,MAAM,CAAC,MAAM,CAAC;IAC3D,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,iBAAiB;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjC,YAAY,EAAE,6BAAmB;IACjC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,gCAAwB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC9E,IAAI,EAAE,KAAK,IAA4B,EAAE;QACvC,iEAAiE;QACjE,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAA4B,CAAC;QACzD,OAAO,GAAG,CAAC,iBAAiB,CAAC;IAC/B,CAAC;CACF,CAAC,CAAC;AAEH,+DAA+D;AAC/D,SAAgB,YAAY;IAC1B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,CAAC,qBAAY,CAAC;QACtB,QAAQ,EAAE,CAAC,sBAAc,CAAC;QAC1B,OAAO,EAAE,wBAAc;QACvB,MAAM,EAAE,sBAAa;KACtB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * The Solana family plugin: the chain, tokens and provider presets as data, plus\n * one adapter manifest. SDK-free: only the manifest's `load()` requires the `@solana/web3.js`\n * module, and with it the SDK.\n */\nimport type {\n  AdapterManifest,\n  DriverFactory,\n  PeerDependency,\n} from '../../core/driver/types';\nimport type { Plugin } from '../../core/registry/plugin';\nimport { SOLANA_CHAIN } from './chains';\nimport { SOLANA_CAPABILITIES } from './network';\nimport { SOLANA_PRESETS } from './presets';\nimport { SOLANA_TOKENS } from './tokens';\n\n/** The SDK versions this adapter is validated against, keyed by library. */\nexport const SOLANA_PEER_DEPENDENCIES: Readonly<\n  Record<'@solana/web3.js', PeerDependency>\n> = Object.freeze({\n  '@solana/web3.js': Object.freeze({ name: '@solana/web3.js', range: '^1.99.0' }),\n});\n\n/**\n * The `@solana/web3.js` manifest, built once, at module level, like the presets. Plugins\n * compare functions by identity, so every `solanaPlugin()` carries the same `load`\n * function and registering it again is the same plugin, not a conflicting one\n * (`CONFIG_INVALID`).\n */\nexport const solanaManifest: AdapterManifest = Object.freeze({\n  family: 'solana',\n  library: '@solana/web3.js',\n  chains: Object.freeze(['solana']),\n  capabilities: SOLANA_CAPABILITIES,\n  peerDependencies: Object.freeze([SOLANA_PEER_DEPENDENCIES['@solana/web3.js']]),\n  load: async (): Promise<DriverFactory> => {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const mod = require('./web3') as typeof import('./web3');\n    return mod.web3DriverFactory;\n  },\n});\n\n/** The built-in Solana family: mainnet, devnet and testnet. */\nexport function solanaPlugin(): Plugin {\n  return {\n    name: 'solana',\n    chains: [SOLANA_CHAIN],\n    adapters: [solanaManifest],\n    presets: SOLANA_PRESETS,\n    assets: SOLANA_TOKENS,\n  };\n}\n"]}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/adapters/solana/plugin.ts"],"names":[],"mappings":";;;AA8CA,oCAQC;AA3CD,qCAAwC;AACxC,uCAAgD;AAChD,uCAA2C;AAC3C,qCAAyC;AAEzC,4EAA4E;AAC/D,QAAA,wBAAwB,GAEjC,MAAM,CAAC,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC;QAC/B,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,mBAAmB;KAC3B,CAAC;CACH,CAAC,CAAC;AAEH;;;;;GAKG;AACU,QAAA,cAAc,GAAoB,MAAM,CAAC,MAAM,CAAC;IAC3D,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,iBAAiB;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjC,YAAY,EAAE,6BAAmB;IACjC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,gCAAwB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC9E,IAAI,EAAE,KAAK,IAA4B,EAAE;QACvC,iEAAiE;QACjE,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAA4B,CAAC;QACzD,OAAO,GAAG,CAAC,iBAAiB,CAAC;IAC/B,CAAC;CACF,CAAC,CAAC;AAEH,+DAA+D;AAC/D,SAAgB,YAAY;IAC1B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,CAAC,qBAAY,CAAC;QACtB,QAAQ,EAAE,CAAC,sBAAc,CAAC;QAC1B,OAAO,EAAE,wBAAc;QACvB,MAAM,EAAE,sBAAa;KACtB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * The Solana family plugin: the chain, tokens and provider presets as data, plus\n * one adapter manifest. SDK-free: only the manifest's `load()` requires the `@solana/web3.js`\n * module, and with it the SDK.\n */\nimport type {\n  AdapterManifest,\n  DriverFactory,\n  PeerDependency,\n} from '../../core/driver/types';\nimport type { Plugin } from '../../core/registry/plugin';\nimport { SOLANA_CHAIN } from './chains';\nimport { SOLANA_CAPABILITIES } from './network';\nimport { SOLANA_PRESETS } from './presets';\nimport { SOLANA_TOKENS } from './tokens';\n\n/** The SDK versions this adapter is validated against, keyed by library. */\nexport const SOLANA_PEER_DEPENDENCIES: Readonly<\n  Record<'@solana/web3.js', PeerDependency>\n> = Object.freeze({\n  '@solana/web3.js': Object.freeze({\n    name: '@solana/web3.js',\n    range: '^1.99.0 || ^3.0.0',\n  }),\n});\n\n/**\n * The `@solana/web3.js` manifest, built once, at module level, like the presets. Plugins\n * compare functions by identity, so every `solanaPlugin()` carries the same `load`\n * function and registering it again is the same plugin, not a conflicting one\n * (`CONFIG_INVALID`).\n */\nexport const solanaManifest: AdapterManifest = Object.freeze({\n  family: 'solana',\n  library: '@solana/web3.js',\n  chains: Object.freeze(['solana']),\n  capabilities: SOLANA_CAPABILITIES,\n  peerDependencies: Object.freeze([SOLANA_PEER_DEPENDENCIES['@solana/web3.js']]),\n  load: async (): Promise<DriverFactory> => {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const mod = require('./web3') as typeof import('./web3');\n    return mod.web3DriverFactory;\n  },\n});\n\n/** The built-in Solana family: mainnet, devnet and testnet. */\nexport function solanaPlugin(): Plugin {\n  return {\n    name: 'solana',\n    chains: [SOLANA_CHAIN],\n    adapters: [solanaManifest],\n    presets: SOLANA_PRESETS,\n    assets: SOLANA_TOKENS,\n  };\n}\n"]}

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

@@ -47,7 +47,11 @@ export interface SolanaExt {
  */
 export interface SolanaFeeDetails {
     readonly signatures: number;
-    /** The signature fee the node quoted for the message (`getFeeForMessage` minus priority). */
+    /**
+     * The signature fee: 5,000 lamports per signature of the message. The endpoint's
+     * `getFeeForMessage` quote must be exactly this plus `priorityFee`; any other quote fails
+     * the estimate with a retryable `PROVIDER_UNAVAILABLE`.
+     */
     readonly baseFee: bigint;
     readonly computeUnitLimit: bigint;
     /** Micro-lamports per compute unit. */
@@ -106,10 +110,9 @@ export interface SolanaInstruction {
     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.
+ * Program-derived addresses, legacy message compilation (both SDK-free, `message.ts`) and
+ * the native client. 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). */

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

@@ -1 +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"]}
+{"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  /**\n   * The signature fee: 5,000 lamports per signature of the message. The endpoint's\n   * `getFeeForMessage` quote must be exactly this plus `priorityFee`; any other quote fails\n   * the estimate with a retryable `PROVIDER_UNAVAILABLE`.\n   */\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 * Program-derived addresses, legacy message compilation (both SDK-free, `message.ts`) and\n * the native client. Inputs are already-validated canonical base58 keys; outputs are plain\n * bytes and strings, never SDK objects, since store records hold plain data 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.js

@@ -3,19 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.web3DriverFactory = void 0;
 exports.createWeb3Codec = createWeb3Codec;
 /**
- * The only module that imports `@solana/web3.js`: program-derived addresses, legacy
- * message compilation and the `crypto-aio/native` `Connection`. It is never on a driver
- * request path: `Connection` retries HTTP 429 on a real timer and would drop the call's
- * tags, so the driver sends every request straight to the transport, and the native
- * `Connection` reaches the same transport through `transport.createFetch`.
+ * The only module that imports `@solana/web3.js`, for the `crypto-aio/native`
+ * `Connection` alone: the driver builds messages and program-derived addresses itself
+ * (`message.ts`), so it works the same with every supported SDK line (1.x and the
+ * Kit-based 3.x). It is never on a driver request path: `Connection` retries HTTP 429 on
+ * a real timer and would drop the call's tags, so the driver sends every request straight
+ * to the transport, and the native `Connection` reaches the same transport through
+ * `transport.createFetch`.
  */
 const web3_js_1 = require("@solana/web3.js");
 const types_1 = require("../../core/transport/types");
 const driver_1 = require("./driver");
-const programs_1 = require("./programs");
+const message_1 = require("./message");
 const rpc_1 = require("./rpc");
-const TOKEN = new web3_js_1.PublicKey(programs_1.TOKEN_PROGRAM);
-const ASSOCIATED_TOKEN = new web3_js_1.PublicKey(programs_1.ASSOCIATED_TOKEN_PROGRAM);
 /**
  * The tags of a native client's requests: broadcasts for its writes (a transaction send
  * and a faucet airdrop, neither safe to retry as a read), plain reads for the rest.
@@ -28,30 +28,8 @@ function classify(_url, init) {
 }
 function createWeb3Codec(transport) {
     return {
-        associatedTokenAddress(owner, mint) {
-            const [address] = web3_js_1.PublicKey.findProgramAddressSync([
-                new web3_js_1.PublicKey(owner).toBuffer(),
-                TOKEN.toBuffer(),
-                new web3_js_1.PublicKey(mint).toBuffer(),
-            ], ASSOCIATED_TOKEN);
-            return address.toBase58();
-        },
-        compileMessage(payer, recentBlockhash, instructions) {
-            const message = new web3_js_1.TransactionMessage({
-                payerKey: new web3_js_1.PublicKey(payer),
-                recentBlockhash,
-                instructions: instructions.map((ix) => new web3_js_1.TransactionInstruction({
-                    programId: new web3_js_1.PublicKey(ix.programId),
-                    keys: ix.accounts.map((a) => ({
-                        pubkey: new web3_js_1.PublicKey(a.address),
-                        isSigner: a.signer,
-                        isWritable: a.writable,
-                    })),
-                    data: Buffer.from(ix.data),
-                })),
-            }).compileToLegacyMessage();
-            return new Uint8Array(message.serialize());
-        },
+        associatedTokenAddress: message_1.associatedTokenAddress,
+        compileMessage: message_1.compileLegacyMessage,
         createNative() {
             const connection = new web3_js_1.Connection(`${types_1.PLACEHOLDER_ORIGIN}/`, {
                 commitment: 'confirmed',

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

@@ -1 +1 @@
-{"version":3,"file":"web3.js","sourceRoot":"","sources":["../../../src/adapters/solana/web3.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The only module that imports `@solana/web3.js`: program-derived addresses, legacy\n * message compilation and the `crypto-aio/native` `Connection`. It is never on a driver\n * request path: `Connection` retries HTTP 429 on a real timer and would drop the call's\n * tags, so the driver sends every request straight to the transport, and the native\n * `Connection` reaches the same transport through `transport.createFetch`.\n */\nimport {\n  Connection,\n  PublicKey,\n  TransactionInstruction,\n  TransactionMessage,\n} from '@solana/web3.js';\nimport { PLACEHOLDER_ORIGIN, type Transport } from '../../core/transport/types';\nimport { solanaDriverFactory } from './driver';\nimport { ASSOCIATED_TOKEN_PROGRAM, TOKEN_PROGRAM } from './programs';\nimport { BROADCAST, READ } from './rpc';\nimport type { SolanaCodec } from './types';\n\nconst TOKEN = new PublicKey(TOKEN_PROGRAM);\nconst ASSOCIATED_TOKEN = new PublicKey(ASSOCIATED_TOKEN_PROGRAM);\n\n/**\n * The tags of a native client's requests: broadcasts for its writes (a transaction send\n * and a faucet airdrop, neither safe to retry as a read), plain reads for the rest.\n */\nfunction classify(_url: URL, init: RequestInit | undefined) {\n  const body = typeof init?.body === 'string' ? init.body : '';\n  return /\"method\"\\s*:\\s*\"(?:sendTransaction|requestAirdrop)\"/.test(body)\n    ? BROADCAST\n    : READ;\n}\n\nexport function createWeb3Codec(transport: Transport): SolanaCodec {\n  return {\n    associatedTokenAddress(owner, mint) {\n      const [address] = PublicKey.findProgramAddressSync(\n        [\n          new PublicKey(owner).toBuffer(),\n          TOKEN.toBuffer(),\n          new PublicKey(mint).toBuffer(),\n        ],\n        ASSOCIATED_TOKEN,\n      );\n      return address.toBase58();\n    },\n    compileMessage(payer, recentBlockhash, instructions) {\n      const message = new TransactionMessage({\n        payerKey: new PublicKey(payer),\n        recentBlockhash,\n        instructions: instructions.map(\n          (ix) =>\n            new TransactionInstruction({\n              programId: new PublicKey(ix.programId),\n              keys: ix.accounts.map((a) => ({\n                pubkey: new PublicKey(a.address),\n                isSigner: a.signer,\n                isWritable: a.writable,\n              })),\n              data: Buffer.from(ix.data),\n            }),\n        ),\n      }).compileToLegacyMessage();\n      return new Uint8Array(message.serialize());\n    },\n    createNative() {\n      const connection = new Connection(`${PLACEHOLDER_ORIGIN}/`, {\n        commitment: 'confirmed',\n        fetch: transport.createFetch(classify),\n        httpAgent: false,\n        disableRetryOnRateLimit: true,\n      });\n      return {\n        client: connection,\n        close: () => {\n          // Subscriptions have no transport bridge, so a socket client that was used only\n          // ever fails against the placeholder host and retries on a timer. Turn retries\n          // off (a flag: it does not cancel a retry already armed), cancel the armed one\n          // (while it waits there is no socket, so `close()` alone does nothing), then\n          // close the socket if there is one.\n          const socket = (\n            connection as unknown as {\n              _rpcWebSocket?: {\n                close(): void;\n                setAutoReconnect(on: boolean): void;\n                reconnect_timer_id?: ReturnType<typeof setTimeout>;\n              };\n            }\n          )._rpcWebSocket;\n          if (!socket) return;\n          socket.setAutoReconnect(false);\n          clearTimeout(socket.reconnect_timer_id);\n          socket.close();\n        },\n      };\n    },\n  };\n}\n\n/** The `@solana/web3.js` adapter's driver factory; the manifest's `load()` returns it. */\nexport const web3DriverFactory = solanaDriverFactory(createWeb3Codec);\n"]}
+{"version":3,"file":"web3.js","sourceRoot":"","sources":["../../../src/adapters/solana/web3.ts"],"names":[],"mappings":";;;AA2BA,0CAoCC;AA/DD;;;;;;;;GAQG;AACH,6CAA6C;AAC7C,sDAAgF;AAChF,qCAA+C;AAC/C,uCAAyE;AACzE,+BAAwC;AAGxC;;;GAGG;AACH,SAAS,QAAQ,CAAC,IAAS,EAAE,IAA6B;IACxD,MAAM,IAAI,GAAG,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,OAAO,qDAAqD,CAAC,IAAI,CAAC,IAAI,CAAC;QACrE,CAAC,CAAC,eAAS;QACX,CAAC,CAAC,UAAI,CAAC;AACX,CAAC;AAED,SAAgB,eAAe,CAAC,SAAoB;IAClD,OAAO;QACL,sBAAsB,EAAtB,gCAAsB;QACtB,cAAc,EAAE,8BAAoB;QACpC,YAAY;YACV,MAAM,UAAU,GAAG,IAAI,oBAAU,CAAC,GAAG,0BAAkB,GAAG,EAAE;gBAC1D,UAAU,EAAE,WAAW;gBACvB,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC;gBACtC,SAAS,EAAE,KAAK;gBAChB,uBAAuB,EAAE,IAAI;aAC9B,CAAC,CAAC;YACH,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,KAAK,EAAE,GAAG,EAAE;oBACV,gFAAgF;oBAChF,+EAA+E;oBAC/E,+EAA+E;oBAC/E,6EAA6E;oBAC7E,oCAAoC;oBACpC,MAAM,MAAM,GACV,UAOD,CAAC,aAAa,CAAC;oBAChB,IAAI,CAAC,MAAM;wBAAE,OAAO;oBACpB,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;oBAC/B,YAAY,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;oBACxC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,0FAA0F;AAC7E,QAAA,iBAAiB,GAAG,IAAA,4BAAmB,EAAC,eAAe,CAAC,CAAC","sourcesContent":["/**\n * The only module that imports `@solana/web3.js`, for the `crypto-aio/native`\n * `Connection` alone: the driver builds messages and program-derived addresses itself\n * (`message.ts`), so it works the same with every supported SDK line (1.x and the\n * Kit-based 3.x). It is never on a driver request path: `Connection` retries HTTP 429 on\n * a real timer and would drop the call's tags, so the driver sends every request straight\n * to the transport, and the native `Connection` reaches the same transport through\n * `transport.createFetch`.\n */\nimport { Connection } from '@solana/web3.js';\nimport { PLACEHOLDER_ORIGIN, type Transport } from '../../core/transport/types';\nimport { solanaDriverFactory } from './driver';\nimport { associatedTokenAddress, compileLegacyMessage } from './message';\nimport { BROADCAST, READ } from './rpc';\nimport type { SolanaCodec } from './types';\n\n/**\n * The tags of a native client's requests: broadcasts for its writes (a transaction send\n * and a faucet airdrop, neither safe to retry as a read), plain reads for the rest.\n */\nfunction classify(_url: URL, init: RequestInit | undefined) {\n  const body = typeof init?.body === 'string' ? init.body : '';\n  return /\"method\"\\s*:\\s*\"(?:sendTransaction|requestAirdrop)\"/.test(body)\n    ? BROADCAST\n    : READ;\n}\n\nexport function createWeb3Codec(transport: Transport): SolanaCodec {\n  return {\n    associatedTokenAddress,\n    compileMessage: compileLegacyMessage,\n    createNative() {\n      const connection = new Connection(`${PLACEHOLDER_ORIGIN}/`, {\n        commitment: 'confirmed',\n        fetch: transport.createFetch(classify),\n        httpAgent: false,\n        disableRetryOnRateLimit: true,\n      });\n      return {\n        client: connection,\n        close: () => {\n          // Subscriptions have no transport bridge, so a socket client that was used only\n          // ever fails against the placeholder host and retries on a timer. Turn retries\n          // off (a flag: it does not cancel a retry already armed), cancel the armed one\n          // (while it waits there is no socket, so `close()` alone does nothing), then\n          // close the socket if there is one.\n          const socket = (\n            connection as unknown as {\n              _rpcWebSocket?: {\n                close(): void;\n                setAutoReconnect(on: boolean): void;\n                reconnect_timer_id?: ReturnType<typeof setTimeout>;\n              };\n            }\n          )._rpcWebSocket;\n          if (!socket) return;\n          socket.setAutoReconnect(false);\n          clearTimeout(socket.reconnect_timer_id);\n          socket.close();\n        },\n      };\n    },\n  };\n}\n\n/** The `@solana/web3.js` adapter's driver factory; the manifest's `load()` returns it. */\nexport const web3DriverFactory = solanaDriverFactory(createWeb3Codec);\n"]}

package/dist/adapters/ton/proofs.js

@@ -6,28 +6,6 @@ exports.expiredAt = expiredAt;
 exports.replayVerdict = replayVerdict;
 exports.createTonProofs = createTonProofs;
 exports.createTonHistory = createTonHistory;
-/**
- * Proofs and address history. Every proof attests a fact at its own height, with a
- * monotone predicate or at a fixed block, and no endpoint proposes a height. The one
- * exception is the unanchored head: one endpoint's masterchain head, trailed by
- * `finalitySkewBlocks` and attested by a quorum read of that block, retried at the
- * transport's own lag tolerance. Every lookup is bound to what it asked for: a header
- * names the block asked, the shard tops cover the basechain, a state and a get-method
- * name the block asked and the state read there.
- *
- * "Not included" rests only on authenticated chain data, never on an indexer's records: a
- * lying or lagging indexer can miss a message that ran, and a `rebuild` on its word would
- * pay twice. The proof reads, at an attested block where the message is expired, the
- * account's own chain of transactions, as the liteserver serves their cells, each hashed
- * here and linked by its `prev_trans` fields back from the attested state's last
- * transaction. A wallet can be reset (deleted, or destroyed to uninitialized, then
- * re-deployed from its public `StateInit` with seqno 0), so an activation, a destruction
- * or a chain start inside what the proof must see decides nothing, unless the chain
- * itself shows our transaction. Anything not yet decidable throws a retryable
- * `PROVIDER_UNAVAILABLE`, and an answer the chain could not have produced a retryable
- * `PROVIDER_INCONSISTENT`; both decide nothing.
- */
-const core_1 = require("@ton/core");
 const error_1 = require("../../core/errors/error");
 const api_1 = require("./api");
 const messages_1 = require("./messages");
@@ -252,34 +230,6 @@ async function consumerOf(ctx, from, seqno, head, state) {
 }
 // ---- the account's own chain --------------------------------------------------------------
 const hex256 = (value) => value.toString(16).padStart(64, '0');
-/**
- * A transaction the liteserver served, authenticated: its cell (capped by the API before
- * this decodes it) hashes to the id expected, and it is the account's own at the lt
- * expected. Anything else is not the chain's.
- */
-const notTheChains = () => inconsistent("the liteserver answered a transaction that is not the chain's");
-function authenticated(row, expected, account) {
-    if (row.lt !== expected.lt || row.hash !== expected.hash)
-        throw notTheChains();
-    let cell;
-    let tx;
-    try {
-        const cells = core_1.Cell.fromBoc(Buffer.from(row.boc, 'base64'));
-        if (cells.length !== 1)
-            throw notTheChains();
-        cell = cells[0];
-        tx = (0, core_1.loadTransaction)(cell.beginParse());
-    }
-    catch {
-        throw notTheChains();
-    }
-    if (cell.hash().toString('hex') !== expected.hash ||
-        tx.lt !== expected.lt ||
-        tx.address !== account) {
-        throw notTheChains();
-    }
-    return tx;
-}
 /** The most transactions one walk visits, fetched or kept: `WALK_PAGES` full pages. */
 const WALK_LIMIT = exports.WALK_PAGES * WALK_PAGE;
 /**
@@ -292,7 +242,7 @@ const WALK_LIMIT = exports.WALK_PAGES * WALK_PAGE;
  * the chain it has not seen; a kept one is bound to the account as a fetched one is.
  */
 async function walkChain(ctx, wallet, from, visit) {
-    const account = BigInt(`0x${wallet.slice(wallet.indexOf(':') + 1)}`);
+    const account = (0, reader_1.accountId)(wallet);
     let expected = from;
     let page = [];
     let fetched = 0;
@@ -302,7 +252,7 @@ async function walkChain(ctx, wallet, from, visit) {
         let tx = ctx.chainTxs.get(key);
         if (tx !== undefined) {
             if (tx.address !== account)
-                throw notTheChains();
+                throw (0, reader_1.notTheChains)();
             // The page fetched earlier no longer follows the walk: drop it.
             if (row !== undefined && (row.lt !== expected.lt || row.hash !== expected.hash)) {
                 page = [];
@@ -320,7 +270,7 @@ async function walkChain(ctx, wallet, from, visit) {
                     throw undecided('the liteserver does not hold the transaction asked');
                 }
             }
-            tx = authenticated(next, expected, account);
+            tx = (0, reader_1.authenticated)(next, expected, account);
             // Only a wallet-sized transaction is kept (a lying endpoint's is not): the memo
             // stays bounded.
             if (next.boc.length <= reader_1.MEMO_TX_LENGTH)
@@ -346,7 +296,7 @@ function phasesOf(tx) {
          * activates the account (transaction.cpp). */
         ran: vm !== undefined,
         /** A request ran to the end, so a seqno moved (the action phase keeps it). */
-        consumed: d.type === 'generic' && vm?.success === true && d.actionPhase?.success === true,
+        consumed: (0, reader_1.chainRan)(tx),
         /** The account had code before or after. */
         lived: CODE.has(tx.oldStatus) || CODE.has(tx.endStatus),
         /** A re-deploy from no code: the seqno starts again (transaction.cpp activation). */
@@ -471,7 +421,7 @@ async function fromTheChain(ctx, q) {
         first = tx.lt;
         const t = phasesOf(tx);
         const inbound = tx.inMessage;
-        if (ourRun(tx, t, q.wallet, q.id)) {
+        if ((0, reader_1.ourRun)(tx, q.wallet, q.id)) {
             ours = hash;
             return true;
         }
@@ -508,16 +458,6 @@ async function fromTheChain(ctx, q) {
         await codeNeverRan(ctx, q.wallet, q.head.id.seqno, first);
     return { absent: true };
 }
-/**
- * Whether `tx` is our message run to the end: its inbound external message's TEP-467 hash,
- * computed here from the authenticated body, is `id`, and it consumed its seqno.
- */
-function ourRun(tx, t, wallet, id) {
-    const inbound = tx.inMessage;
-    return (t.consumed &&
-        inbound?.info.type === 'external-in' &&
-        (0, wallets_1.externalHashOf)(wallet, inbound.body) === id);
-}
 /**
  * The monotone predicate "my seqno is above `seqno`" at the endpoints' own states, under the
  * proof quorum; its key is the verdict itself and never throws.
@@ -603,7 +543,7 @@ async function replayVerdict(ctx, message) {
             linked = tx.lt === link.lastLt;
         }
         const t = phasesOf(tx);
-        if (ourRun(tx, t, wallet, id)) {
+        if ((0, reader_1.ourRun)(tx, wallet, id)) {
             ours = true;
             return true;
         }
@@ -632,11 +572,12 @@ async function replayVerdict(ctx, message) {
     return 'send';
 }
 /**
- * Our indexed transaction that consumed its seqno, proven: a complete trace, whose last
- * block the endpoints attest they hold, and the verdict, its jetton wallets confirmed at
- * that block under the proof quorum.
+ * Our indexed transaction that consumed its seqno (the Attempt `id`), proven: a complete
+ * trace, whose last block the endpoints attest they hold, and the verdict, its jetton
+ * wallets confirmed at that block and a bounce read from the chain itself, both under the
+ * proof quorum.
  */
-async function proveIncluded(ctx, tx, from) {
+async function proveIncluded(ctx, tx, from, id) {
     const trace = await ctx.api.trace(tx.hash, api_1.PROOF);
     if (!trace || !trace.complete)
         throw undecided('the message trace is not complete yet');
@@ -644,7 +585,7 @@ async function proveIncluded(ctx, tx, from) {
     if (!(await ctx.api.reachedMasterchain(last, api_1.PROOF))) {
         throw undecided('the endpoints have not reached the trace yet');
     }
-    const verdict = await (0, reader_1.confirmLegs)(ctx, (0, trace_1.attemptVerdict)(tx, trace), from, api_1.PROOF, last);
+    const verdict = await (0, reader_1.confirmBounce)(ctx, await (0, reader_1.confirmLegs)(ctx, (0, trace_1.attemptVerdict)(tx, trace), from, api_1.PROOF, last), from, id, api_1.PROOF);
     if (verdict.kind === 'pending')
         throw undecided('the message trace is not complete yet');
     const header = await masterchainBlock(ctx, tx.mcSeqno);
@@ -655,6 +596,7 @@ async function proveIncluded(ctx, tx, from) {
         blockHash: header.id.rootHash,
         txHash: tx.hash,
         ...(verdict.kind === 'failed' ? { reason: verdict.reason } : {}),
+        ...(verdict.kind === 'failed' && verdict.failure ? { failure: verdict.failure } : {}),
     };
 }
 /**
@@ -668,7 +610,7 @@ async function proveOurs(ctx, hash, wallet, id) {
     if (!(0, trace_1.isOwnAttempt)(record, wallet, id) || !(0, trace_1.consumesSeqno)(record)) {
         throw inconsistent("the indexer's record is not the chain's transaction");
     }
-    return proveIncluded(ctx, record, wallet);
+    return proveIncluded(ctx, record, wallet, id);
 }
 const seqnoOrdering = (ordering) => ordering.kind === 'seqno' ? ordering : undefined;
 function createTonProofs(ctx) {
@@ -688,12 +630,12 @@ function createTonProofs(ctx) {
             // Only our own wallet transaction, its hash computed here from the bound body. A
             // run that did not consume its seqno (a failed action phase) moved nothing and may
             // run again until the message expires: only the seqno decides it.
-            const own = await (0, reader_1.findOwnAttempt)(ctx, ref, wallet, api_1.PROOF);
-            if (own && (0, trace_1.consumesSeqno)(own))
-                return proveIncluded(ctx, own, wallet);
             const id = attemptId(ref.id);
             if (id === undefined)
                 throw undecided('a TON attempt needs its message hash');
+            const own = await (0, reader_1.findOwnAttempt)(ctx, ref, wallet, api_1.PROOF);
+            if (own && (0, trace_1.consumesSeqno)(own))
+                return proveIncluded(ctx, own, wallet, id);
             const slot = seqnoOrdering(ordering);
             if (!slot)
                 throw undecided('a TON attempt needs its seqno ordering');
@@ -726,7 +668,7 @@ function createTonProofs(ctx) {
                     });
                 }
                 if (hint && (0, trace_1.isOwnAttempt)(hint, wallet, id))
-                    return proveIncluded(ctx, hint, wallet);
+                    return proveIncluded(ctx, hint, wallet, id);
             }
             // Never "not included" while the message may still run: a reset of the wallet could
             // bring its seqno back to ours.