crypto-aio 0.0.2 → 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"proofs.js","sourceRoot":"","sources":["../../../src/adapters/solana/proofs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Proofs and block scanning. Each fact is attested at its own height with a monotone\n * predicate, never at a height one endpoint proposes. \"My finalized height is past H\" is\n * a quorum read of `getBlockHeight({ commitment: 'finalized' })` keyed on `height > H`;\n * the block at a height is a quorum read of `getBlock(slot, { commitment: 'finalized' })`\n * keyed on its consensus fields, so an endpoint that has not finalized it answers nothing\n * and decides nothing.\n *\n * The expiry height itself is never taken on trust: the build read it from one endpoint,\n * and a height reported too low would prove an Attempt expired while it can still land,\n * so `rebuild` would pay twice. A verdict rests on the height the quorum attests for the\n * transaction's blockhash: when the finalized block at the slot the build recorded\n * carries it, that block's height plus `BLOCKHASH_VALIDITY` is the last valid height,\n * whatever was recorded; otherwise the finalized block at the recorded height minus\n * `BLOCKHASH_VALIDITY` must carry it, which confirms the recorded height without the\n * slot. Neither decides nothing.\n *\n * A transaction is proven absent only by reading every block of its window\n * under finality: each block certifies its own height and its parent's hash, from the\n * blockhash's own block to the window's last, so a lagging, pruned, snapshot-jumped or\n * long-term-storage-gapped backend behind a load-balanced URL can only answer \"not\n * available\" (decides nothing), never a short window.\n *\n * Only a definitive negative proof answers \"no\". Every other RPC error\n * on these paths decides nothing (`undecided`: a retryable `PROVIDER_UNAVAILABLE`).\n *\n * Tags: every read a verdict rests on carries the contract table's proof tags (`ChainDriver`\n * in the core's `driver/types.ts`: purpose `proof`, quorum `'proof'`), with two deliberate\n * exceptions, both single-endpoint `monitor` reads of hints the quorum then re-attests: the\n * finalized height behind `finalizedHead` (the one unanchored head), and the\n * height-to-slot lookups of `HeightIndex` (`attestedBlock`). A wrong hint names a block the\n * quorum does not attest at that height, so it only ever decides nothing.\n */\nimport type { BlockSource, DriverBlock, ProofSource } from '../../core/driver/types';\nimport { ProviderError } from '../../core/errors/error';\nimport type { OrderingData } from '../../core/model/ordering';\nimport {\n  decodeTransaction,\n  isVote,\n  parseTransaction,\n  tokenTransfersLanded,\n  touches,\n} from './decode';\nimport { decodeBase58, isSignature } from './keys';\nimport { blockAtHeight, type SolanaContext } from './reader';\nimport {\n  BLOCK_FIELDS,\n  MONITOR,\n  PROOF,\n  blockHeader,\n  call,\n  headerOptions,\n  gone,\n  inconsistent,\n  isGone,\n  isNotAvailable,\n  isSkipped,\n  malformed,\n  notYet,\n  parsedOptions,\n  pick,\n  u64,\n  undecided,\n  type BlockHeader,\n} from './rpc';\nimport type { Commitment, SolanaExpiryOrdering } from './types';\n\n/**\n * A blockhash is valid for this many blocks after its own: agave's `MAX_PROCESSING_AGE`\n * (v4.3.0: `runtime/src/bank.rs` sets every bank's `max_processing_age` to it, and\n * `get_blockhash_last_valid_block_height` answers `block_height + max_processing_age −\n * age`, so the newest blockhash's last valid height is its block's height plus 150).\n */\nexport const BLOCKHASH_VALIDITY = 150n;\n\n/**\n * The heights that can hold a transaction whose blockhash gives `lastValidBlockHeight`:\n * from the block after the blockhash's own, through `lastValidBlockHeight + 1`. agave checks\n * a blockhash's age against the including block's PARENT, so the block after\n * `lastValidBlockHeight` still accepts it.\n */\nexport function windowOf(lastValidHeight: bigint): {\n  readonly first: bigint;\n  readonly end: bigint;\n} {\n  const first =\n    lastValidHeight >= BLOCKHASH_VALIDITY - 1n\n      ? lastValidHeight - BLOCKHASH_VALIDITY + 1n\n      : 0n;\n  return { first, end: lastValidHeight + 1n };\n}\n\n/** Signatures proven absent from their finalized windows, kept per driver. */\nconst ABSENT_MEMO = 1_024;\n/**\n * Window proofs in progress, kept per driver with the same bound: each window's\n * attested frame, and how far each signature's read of it got.\n */\nconst WINDOW_MEMO = 1_024;\n/** Attested last valid heights by blockhash (immutable chain data), kept per driver. */\nconst ANCHOR_MEMO = 1_024;\n\n/** Library policy: an unanchored head trails one endpoint's view by this peer skew. */\nexport const PEER_SKEW = 2n;\n\n/** Drops a bounded memo's oldest entry once it holds more than `size`. */\nfunction trim(memo: Set<string> | Map<string, unknown>, size: number): void {\n  if (memo.size > size) memo.delete(memo.keys().next().value as string);\n}\n\nasync function finalizedHeight(ctx: SolanaContext): Promise<bigint> {\n  return u64(\n    await call(ctx.transport, 'getBlockHeight', [{ commitment: 'finalized' }], MONITOR),\n    'getBlockHeight',\n  );\n}\n\n/**\n * Whether every quorum endpoint has finalized a block above `height`: the monotone\n * predicate \"my finalized height > height\". Endpoints that disagree throw a\n * retryable `PROVIDER_INCONSISTENT` (decides nothing); all saying no is `false`.\n */\nasync function finalizedPast(ctx: SolanaContext, height: bigint): Promise<boolean> {\n  const past = (result: unknown): boolean => {\n    if (typeof result === 'bigint') return result > height;\n    if (typeof result === 'number' && Number.isSafeInteger(result))\n      return BigInt(result) > height;\n    throw malformed('getBlockHeight');\n  };\n  const result = await call(\n    ctx.transport,\n    'getBlockHeight',\n    [{ commitment: 'finalized' }],\n    { ...PROOF, quorumKey: past },\n  );\n  return past(result);\n}\n\n/** What a build recorded with the height: one endpoint's word until attested. */\ninterface Recorded {\n  readonly lastValidHeight: bigint;\n  readonly blockhash: string;\n  /** Absent when not recorded, or not a slot a request can name exactly. */\n  readonly slot?: bigint;\n}\n\n/** Our own expiry ordering's recorded height, or `undefined` for any other ordering. */\nconst lastValidOf = (ordering: OrderingData): bigint | undefined =>\n  ordering.kind === 'expiry' ? ordering.lastValidHeight : undefined;\n\n/** The blockhash an expiry ordering names, if any (the key of the attested heights). */\nconst blockhashOf = (ordering: OrderingData): string | undefined => {\n  const { blockhash } = ordering as Partial<SolanaExpiryOrdering>;\n  return typeof blockhash === 'string' ? blockhash : undefined;\n};\n\n/**\n * The blockhash and slot a build recorded with the height (`SolanaExpiryOrdering`). An\n * ordering without a blockhash can never be attested: it decides nothing. A missing or\n * ill-typed slot only leaves the slot-free check.\n */\nfunction recordedOf(ordering: OrderingData, lastValidHeight: bigint): Recorded {\n  const { blockhash, blockhashSlot: slot } = ordering as Partial<SolanaExpiryOrdering>;\n  if (decodeBase58(blockhash, 32) === null) {\n    throw new ProviderError(\n      'PROVIDER_UNAVAILABLE',\n      'the expiry ordering does not name the blockhash its height belongs to',\n    );\n  }\n  const exact =\n    typeof slot === 'bigint' && slot >= 0n && slot <= BigInt(Number.MAX_SAFE_INTEGER);\n  return { lastValidHeight, blockhash: blockhash as string, ...(exact ? { slot } : {}) };\n}\n\nconst BLOCKHASH_BLOCK = \"the block of the transaction's blockhash\";\nconst LIE =\n  'the recorded expiry height disagrees with its blockhash; using the attested one';\n\n/**\n * The height of the finalized block at `slot` when it carries `blockhash`, or\n * `null` when the slot does not anchor it (another block there, a skipped or pruned slot,\n * no finalized block yet). The quorum key is the block's height and whether its hash\n * matches, so the height adopted is every endpoint's, never the first answer's. Only a\n * hash match yields a height; a disagreement or any other error decides nothing.\n */\nasync function heightAtSlot(\n  ctx: SolanaContext,\n  blockhash: string,\n  slot: bigint,\n): Promise<bigint | null> {\n  const key = (result: unknown) => {\n    if (result === null) return null;\n    const header = blockHeader(result);\n    return {\n      height: header.blockHeight.toString(),\n      matches: header.blockhash === blockhash,\n    };\n  };\n  let result: unknown;\n  try {\n    result = await call(\n      ctx.transport,\n      'getBlock',\n      [Number(slot), headerOptions('finalized')],\n      { ...PROOF, quorumKey: key },\n    );\n  } catch (error) {\n    if (isNotAvailable(error)) return null;\n    throw undecided(error, BLOCKHASH_BLOCK);\n  }\n  if (result === null) return null;\n  const header = blockHeader(result);\n  return header.blockhash === blockhash ? header.blockHeight : null;\n}\n\n/**\n * The last valid height the quorum attests for a recorded expiry. agave answers\n * `getLatestBlockhash` from one bank (its slot, its last blockhash, and that blockhash's\n * last valid height: `block_height + MAX_PROCESSING_AGE`), so an honest record anchors at\n * its slot. When it does, the attested block's height plus `BLOCKHASH_VALIDITY` is the\n * answer, and a recorded height that disagrees is a build-time lie: logged (fixed text) and\n * ignored. When the slot does not anchor the blockhash, the block at the recorded height\n * minus `BLOCKHASH_VALIDITY` must carry it, which confirms the recorded height. Only a\n * lie in both the slot and the height is never attested: it decides nothing, for good, so\n * such an Operation stays unresolved but is never paid twice.\n */\nasync function attestLastValid(ctx: SolanaContext, recorded: Recorded): Promise<bigint> {\n  const at =\n    recorded.slot === undefined\n      ? null\n      : await heightAtSlot(ctx, recorded.blockhash, recorded.slot);\n  if (at !== null) {\n    const last = at + BLOCKHASH_VALIDITY;\n    if (last !== recorded.lastValidHeight) ctx.log.warn(LIE);\n    return last;\n  }\n  const height = recorded.lastValidHeight - BLOCKHASH_VALIDITY;\n  const block = height < 0n ? null : await attestedBlock(ctx, height, 'finalized');\n  if (!block) throw notYet(BLOCKHASH_BLOCK);\n  if (block.header.blockhash !== recorded.blockhash) {\n    throw inconsistent(\n      'neither the recorded slot nor the recorded height holds the blockhash',\n    );\n  }\n  return recorded.lastValidHeight;\n}\n\n/**\n * The block at `height` as the quorum serves it at `commitment`, or `null` when an endpoint\n * cannot show it there yet. The slot of a height comes from one endpoint's block list; the\n * quorum then attests the block itself and its height, so a wrong slot only ever decides\n * nothing. Callers use it only for heights the quorum already holds as final (deep window\n * starts, heights at or below an attested finalized height) or for `'latest'` checks where\n * `null` decides nothing.\n */\nasync function attestedBlock(\n  ctx: SolanaContext,\n  height: bigint,\n  commitment: Commitment,\n): Promise<{ readonly slot: bigint; readonly header: BlockHeader } | null> {\n  const slot = await ctx.heights.slotAt(height, commitment, MONITOR);\n  if (slot === null) return null;\n  let result: unknown;\n  try {\n    result = await call(\n      ctx.transport,\n      'getBlock',\n      [Number(slot), headerOptions(commitment)],\n      PROOF,\n    );\n  } catch (error) {\n    if (isSkipped(error)) {\n      // The slot came from a list that named a slot with no block.\n      ctx.heights.forget();\n      throw inconsistent(`slot ${slot} holds no block`);\n    }\n    if (isNotAvailable(error)) return null;\n    throw undecided(error, `the block at height ${height}`);\n  }\n  if (result === null) return null;\n  const header = blockHeader(result);\n  if (header.blockHeight !== height) {\n    ctx.heights.forget();\n    throw inconsistent(`the block at slot ${slot} is not at height ${height}`);\n  }\n  return { slot, header };\n}\n\n/** The window a verdict reads: an attested last valid height, and its blockhash. */\ninterface Anchor {\n  readonly lastValidHeight: bigint;\n  readonly blockhash: string;\n}\n\n/**\n * A window's frame, attested under the proof quorum: the finalized slot of each of its\n * heights, and the hash of its last block. Finalized blocks never change, so it is kept.\n */\ninterface WindowFrame {\n  readonly slots: readonly bigint[];\n  readonly lastHash: string;\n}\n\n/**\n * How far one signature's read of a window got: the blocks before `next` are finalized,\n * attested, chained from the blockhash's own block to `parent`, and without the signature.\n * Immutable chain facts too; the signature lists themselves are never kept (a mainnet block\n * holds thousands).\n */\ninterface WindowCursor {\n  readonly next: number;\n  readonly parent: string;\n}\n\n/**\n * What a window proof keeps between passes, so a pass that fails part way (a\n * rate limit, an endpoint that is behind) resumes where it stopped instead of starting over.\n * Over the `public` preset a pass gets only a few `getBlock` reads, so without this the\n * proof never completed. Keyed by window (`<last valid height>:<blockhash>`) and by\n * `<signature>:<window>`, each bounded like the absence memo.\n */\ninterface WindowMemo {\n  readonly frames: Map<string, WindowFrame>;\n  readonly cursors: Map<string, WindowCursor>;\n}\n\n/** The frame of `anchor`'s window, attested once and then kept. */\nasync function windowFrame(\n  ctx: SolanaContext,\n  anchor: Anchor,\n  memo: WindowMemo,\n  key: string,\n): Promise<WindowFrame> {\n  const kept = memo.frames.get(key);\n  if (kept) return kept;\n  const { first, end } = windowOf(anchor.lastValidHeight);\n  const top = await attestedBlock(ctx, end, 'finalized');\n  const bottom = await attestedBlock(ctx, first, 'finalized');\n  if (!top || !bottom) throw notYet('the transaction window');\n  const listKey = (result: unknown): unknown => {\n    if (!Array.isArray(result)) throw malformed('getBlocks');\n    return result.map(String);\n  };\n  let listed: unknown;\n  try {\n    listed = await call(\n      ctx.transport,\n      'getBlocks',\n      [\n        Number(bottom.slot),\n        Number(top.slot),\n        { commitment: 'finalized', minContextSlot: Number(top.slot) },\n      ],\n      { ...PROOF, quorumKey: listKey },\n    );\n  } catch (error) {\n    if (isNotAvailable(error)) throw notYet('every block of the window');\n    throw undecided(error, 'every block of the window');\n  }\n  if (!Array.isArray(listed) || BigInt(listed.length) !== end - first + 1n) {\n    throw notYet('every block of the window');\n  }\n  const frame: WindowFrame = {\n    slots: listed.map((value) => u64(value, 'getBlocks slot')),\n    lastHash: top.header.blockhash,\n  };\n  memo.frames.set(key, frame);\n  trim(memo.frames, WINDOW_MEMO);\n  return frame;\n}\n\n/**\n * Whether `signature` is in none of the finalized blocks of its window.\n * The window's first and last blocks are attested by height; `getBlocks` must list exactly\n * one slot per height between them; every block is read whole (its signatures) under the\n * proof quorum and must sit at the next height with the previous block as its parent, the\n * first one on the attested blockhash's own block. A gap, a pruned block or a lagging\n * backend answers \"not available\" and decides nothing. `false` means a block holds the\n * transaction. Progress is kept between passes (`WindowMemo`): a resumed pass reads on from\n * the last verified block, chained to its hash; a chain that does not hold drops what was\n * kept for the window, so the next pass starts over.\n */\nasync function absentFromWindow(\n  ctx: SolanaContext,\n  signature: string,\n  anchor: Anchor,\n  memo: WindowMemo,\n): Promise<boolean> {\n  const { first } = windowOf(anchor.lastValidHeight);\n  const window = `${anchor.lastValidHeight}:${anchor.blockhash}`;\n  const frame = await windowFrame(ctx, anchor, memo, window);\n  const key = `${signature}:${window}`;\n  const holds = (result: unknown): boolean | null => {\n    const list = (result as { signatures?: unknown } | null)?.signatures;\n    return Array.isArray(list) ? list.includes(signature) : null;\n  };\n  const blockKey = (result: unknown): unknown => ({\n    ...(pick(result, BLOCK_FIELDS) as object),\n    holds: holds(result),\n  });\n  const brokenChain = (reason: string) => {\n    memo.frames.delete(window);\n    memo.cursors.delete(key);\n    return inconsistent(reason);\n  };\n  // The window hangs off the blockhash's own block, which the anchor attested.\n  let { next, parent } = memo.cursors.get(key) ?? { next: 0, parent: anchor.blockhash };\n  for (; next < frame.slots.length; next++) {\n    let block: unknown;\n    try {\n      block = await call(\n        ctx.transport,\n        'getBlock',\n        [\n          Number(frame.slots[next]),\n          { ...headerOptions('finalized'), transactionDetails: 'signatures' },\n        ],\n        { ...PROOF, quorumKey: blockKey },\n      );\n    } catch (error) {\n      if (isNotAvailable(error)) throw notYet('a block of the window');\n      throw undecided(error, 'a block of the window');\n    }\n    const found = holds(block);\n    if (found === null) throw notYet('a block of the window');\n    const header = blockHeader(block);\n    if (\n      header.blockHeight !== first + BigInt(next) ||\n      header.previousBlockhash !== parent\n    ) {\n      throw brokenChain('the window is not one chain of blocks');\n    }\n    if (found) {\n      memo.cursors.delete(key);\n      return false;\n    }\n    parent = header.blockhash;\n    memo.cursors.set(key, { next: next + 1, parent });\n    trim(memo.cursors, WINDOW_MEMO);\n  }\n  if (parent !== frame.lastHash) {\n    throw brokenChain('the window does not end at its attested block');\n  }\n  memo.cursors.delete(key);\n  return true;\n}\n\n/** The quorum's finalized transaction (`null`: every endpoint agrees it has none). */\nasync function finalTransaction(ctx: SolanaContext, signature: string): Promise<unknown> {\n  try {\n    return await call(\n      ctx.transport,\n      'getTransaction',\n      [signature, parsedOptions('finalized')],\n      PROOF,\n    );\n  } catch (error) {\n    if (isNotAvailable(error)) throw notYet('the transaction history');\n    throw undecided(error, 'the transaction history');\n  }\n}\n\n/** Whatever a proof method meets, no RPC error is ever a verdict. */\nfunction guarded<A extends unknown[], R>(\n  method: (...args: A) => Promise<R>,\n): (...args: A) => Promise<R> {\n  return async (...args) => {\n    try {\n      return await method(...args);\n    } catch (error) {\n      throw undecided(error, 'the proof');\n    }\n  };\n}\n\nexport function createSolanaProofs(ctx: SolanaContext): ProofSource {\n  const absent = new Set<string>();\n  const windows: WindowMemo = { frames: new Map(), cursors: new Map() };\n  /** Attested last valid heights by blockhash: a blockhash names one block, for good. */\n  const anchors = new Map<string, bigint>();\n  const known = (ordering: OrderingData): bigint | undefined => {\n    const blockhash = blockhashOf(ordering);\n    return blockhash === undefined ? undefined : anchors.get(blockhash);\n  };\n  /** The attested last valid height of `ordering`, remembered once attested. */\n  const attested = async (ordering: OrderingData, recorded: bigint): Promise<Anchor> => {\n    const record = recordedOf(ordering, recorded);\n    let last = anchors.get(record.blockhash);\n    if (last === undefined) {\n      last = await attestLastValid(ctx, record);\n      anchors.set(record.blockhash, last);\n      trim(anchors, ANCHOR_MEMO);\n    }\n    return { lastValidHeight: last, blockhash: record.blockhash };\n  };\n  /**\n   * While the recorded height has not passed, the last valid height the recorded\n   * slot alone attests (no height fallback), remembered as `attested` remembers it. A build\n   * that raised the recorded height would otherwise wait for that height, possibly for\n   * ever, although the real window has passed. `undefined` (not yet) when no slot was\n   * recorded, the slot does not hold the blockhash, or it cannot be read.\n   */\n  const attestedAtSlot = async (\n    ordering: OrderingData,\n    recorded: bigint,\n  ): Promise<bigint | undefined> => {\n    let record: Recorded;\n    let at: bigint | null;\n    try {\n      record = recordedOf(ordering, recorded);\n      if (record.slot === undefined) return undefined;\n      at = await heightAtSlot(ctx, record.blockhash, record.slot);\n    } catch {\n      return undefined;\n    }\n    if (at === null) return undefined;\n    const last = at + BLOCKHASH_VALIDITY;\n    if (last !== recorded) ctx.log.warn(LIE);\n    anchors.set(record.blockhash, last);\n    trim(anchors, ANCHOR_MEMO);\n    return last;\n  };\n  /**\n   * A finalized `getTransaction` answer, read under that method's quorum key, is the only\n   * verdict input (never a block's entry): the transaction asked for, in the finalized\n   * block at its slot, with the landing guard applied.\n   */\n  const included = async (result: unknown, signature: string, from: string) => {\n    const parsed = parseTransaction(result, signature);\n    if (parsed.slot === undefined) throw malformed('getTransaction');\n    let header: BlockHeader | null;\n    try {\n      const block = await call(\n        ctx.transport,\n        'getBlock',\n        [Number(parsed.slot), headerOptions('finalized')],\n        PROOF,\n      );\n      header = block === null ? null : blockHeader(block);\n    } catch (error) {\n      if (!isNotAvailable(error)) throw undecided(error, 'the block of the transaction');\n      header = null;\n    }\n    if (!header) throw notYet('the block of the transaction');\n    // Our own token transfers count only when the balances show them. The reasons are\n    // `observe`'s fixed texts, so the proven failure keeps the observed one.\n    const reason =\n      parsed.err !== null\n        ? 'transaction failed'\n        : tokenTransfersLanded(parsed, from)\n          ? undefined\n          : 'token transfer failed';\n    return {\n      included: true as const,\n      success: reason === undefined,\n      blockHeight: header.blockHeight,\n      blockHash: header.blockhash,\n      txHash: signature,\n      ...(reason !== undefined ? { reason } : {}),\n    };\n  };\n\n  const proofs: ProofSource = {\n    async finalizedHead() {\n      // The one unanchored head: one endpoint's view, trailed by a peer skew.\n      const seen = await finalizedHeight(ctx);\n      const height = seen > PEER_SKEW ? seen - PEER_SKEW : 0n;\n      const block = await attestedBlock(ctx, height, 'finalized');\n      if (!block) throw notYet('the finalized head');\n      return {\n        height,\n        hash: block.header.blockhash,\n        ...(block.header.blockTime !== undefined\n          ? { timestamp: block.header.blockTime }\n          : {}),\n      };\n    },\n\n    async includedFinal(ref, ordering, from) {\n      // A malformed signature can never be on chain.\n      if (!isSignature(ref.id)) return { included: false };\n      const found = await finalTransaction(ctx, ref.id);\n      if (found !== null) return included(found, ref.id, from);\n      // An index that shows nothing proves nothing; only the window can. Behind one URL,\n      // `getTransaction` may reach a backend that lags, was pruned or jumped to a\n      // snapshot, and agave ignores its `minContextSlot`.\n      const recorded = lastValidOf(ordering);\n      if (recorded === undefined) throw notYet('proof that the transaction is absent');\n      const remembered = known(ordering);\n      if (remembered !== undefined && absent.has(`${ref.id}:${remembered}`)) {\n        return { included: false };\n      }\n      // The window's last block (lastValidBlockHeight + 1) is final everywhere, at the\n      // attested height. An early \"no\" at the recorded one only delays, unless the\n      // recorded slot attests another height: its predicate is asked below.\n      const pastWindow = () => notYet('finality past the transaction window');\n      if (remembered === undefined && !(await finalizedPast(ctx, recorded))) {\n        const bySlot = await attestedAtSlot(ordering, recorded);\n        if (bySlot === undefined || bySlot === recorded) throw pastWindow();\n      }\n      const anchor = await attested(ordering, recorded);\n      const last = anchor.lastValidHeight;\n      if (last !== recorded || remembered !== undefined) {\n        if (!(await finalizedPast(ctx, last))) throw pastWindow();\n      }\n      const key = `${ref.id}:${last}`;\n      if (!absent.has(key)) {\n        if (!(await absentFromWindow(ctx, ref.id, anchor, windows))) {\n          throw inconsistent(\n            'a block of the window holds a transaction its index does not show',\n          );\n        }\n        absent.add(key);\n        trim(absent, ABSENT_MEMO);\n      }\n      return { included: false };\n    },\n\n    // Expiry ordering has no slot that another transaction could consume.\n    slotConsumed: async () => false,\n\n    async expired(ordering) {\n      const recorded = lastValidOf(ordering);\n      // \"Not expired\" is the safe answer: it never declares a transaction dead.\n      if (recorded === undefined) return false;\n      const remembered = known(ordering);\n      if (remembered !== undefined) return finalizedPast(ctx, remembered);\n      // An early \"no\" at the recorded height only delays, unless the recorded slot attests\n      // another height: then that height's own predicate answers.\n      if (!(await finalizedPast(ctx, recorded))) {\n        const bySlot = await attestedAtSlot(ordering, recorded);\n        return bySlot !== undefined && bySlot !== recorded && finalizedPast(ctx, bySlot);\n      }\n      // \"Expired\" rests on the attested height, and its own predicate read.\n      const { lastValidHeight } = await attested(ordering, recorded);\n      return lastValidHeight === recorded || finalizedPast(ctx, lastValidHeight);\n    },\n\n    async blockHash(height, level) {\n      // Null above the finalized height decides nothing; so does any endpoint that has\n      // not finalized `height` yet (the attested read answers nothing there).\n      if (level === 'finalized' && !(await finalizedPast(ctx, height - 1n))) return null;\n      const block = await attestedBlock(\n        ctx,\n        height,\n        level === 'finalized' ? 'finalized' : 'confirmed',\n      );\n      return block?.header.blockhash ?? null;\n    },\n  };\n  return {\n    finalizedHead: guarded(proofs.finalizedHead),\n    includedFinal: guarded(proofs.includedFinal),\n    slotConsumed: guarded(proofs.slotConsumed),\n    expired: guarded(proofs.expired),\n    blockHash: guarded(proofs.blockHash),\n  };\n}\n\nconst changed = (height: bigint) =>\n  inconsistent(`block ${height} changed while scanning`);\n\nexport function createSolanaBlocks(ctx: SolanaContext): BlockSource {\n  return {\n    header: async (height) => (await blockAtHeight(ctx, height, MONITOR))?.block ?? null,\n\n    async transactions(block: DriverBlock, filter) {\n      const slot = await ctx.heights.slotAt(block.height, 'confirmed', MONITOR);\n      if (slot === null) throw changed(block.height);\n      let result: unknown;\n      try {\n        result = await call(\n          ctx.transport,\n          'getBlock',\n          [\n            Number(slot),\n            { ...parsedOptions('confirmed'), transactionDetails: 'full', rewards: false },\n          ],\n          MONITOR,\n        );\n      } catch (error) {\n        if (isGone(error)) throw gone(`the block at height ${block.height}`);\n        // A slot the index named holds no block: drop the cache it came from.\n        if (isSkipped(error)) ctx.heights.forget();\n        if (isNotAvailable(error)) throw changed(block.height);\n        // Any other node error decides nothing; the scan retries.\n        throw undecided(error, `the block at height ${block.height}`);\n      }\n      const full = result as { blockhash?: unknown; transactions?: unknown } | null;\n      if (!full || full.blockhash !== block.hash) throw changed(block.height);\n      if (!Array.isArray(full.transactions)) throw malformed('getBlock');\n      const wanted = filter?.addresses?.length ? new Set(filter.addresses) : undefined;\n      const place = {\n        height: block.height,\n        hash: block.hash,\n        ...(block.timestamp !== undefined ? { blockTime: block.timestamp } : {}),\n      };\n      // All or nothing: a transaction that does not parse makes the whole block retry\n      // (retryable), never a block read short.\n      return full.transactions.flatMap((entry) => {\n        const parsed = parseTransaction(entry);\n        if (isVote(parsed)) return [];\n        const decoded = decodeTransaction(parsed, place);\n        return !wanted || touches(decoded, parsed, wanted) ? [decoded] : [];\n      });\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,82 @@
+/**
+ * Solana addresses, reads and the `ext.solana` API. Every call carries the tags of the
+ * `ChainDriver` contract table: `read` for point queries, `monitor` for heights and
+ * observations. Heads are read at `confirmed`, finality at `finalized`.
+ */
+import type { AddressCodec, ChainReader, DriverBlock } from '../../core/driver/types';
+import type { Logger } from '../../core/events/logger';
+import type { AssetRef } from '../../core/model/asset';
+import type { ChainInfo, NetworkInfo } from '../../core/model/chain';
+import type { Transport } from '../../core/transport/types';
+import { type ParsedTransaction } from './decode';
+import type { HeightIndex } from './heights';
+import type { SolanaNetworkConfig } from './network';
+import { type BlockHeader } from './rpc';
+import type { SolanaCallTags, SolanaCodec, SolanaExt, SolanaTokenAccount } from './types';
+/** What every Solana port is built from. */
+export interface SolanaContext {
+    readonly transport: Transport;
+    readonly codec: SolanaCodec;
+    readonly chain: ChainInfo;
+    readonly network: NetworkInfo;
+    readonly config: SolanaNetworkConfig;
+    readonly heights: HeightIndex;
+    readonly log: Logger;
+    /** The next build variant (`fees.ts`, `variantCounter`). */
+    readonly nextVariant: () => number;
+}
+export interface AccountInfo {
+    readonly owner: string;
+    readonly executable: boolean;
+    readonly data: Uint8Array;
+}
+/** `getAccountInfo` (base64) at `confirmed`; `null` when the account does not exist. */
+export declare function accountInfo(ctx: SolanaContext, address: string, tags: SolanaCallTags): Promise<AccountInfo | null>;
+/** The mint of an `spl` asset ref; any other standard is not a Solana token. */
+export declare function mintOf(asset: AssetRef): string;
+/**
+ * A classic Token mint's decimals: a missing mint, an account of another
+ * program or data that does not parse is the token's own `ASSET_RESOLUTION`; a Token-2022
+ * mint is `UNSUPPORTED_CAPABILITY`. A definitive node error is made retryable;
+ * `PROVIDER_MISCONFIGURED` and retryable errors propagate unchanged. Under a quorum (the
+ * token metadata the core caches), endpoints must agree on the verdict: a lagging one that
+ * has no mint yet, or one with other decimals, decides nothing (`PROVIDER_INCONSISTENT`).
+ */
+export declare function mintDecimals(ctx: SolanaContext, mint: string, tags: SolanaCallTags): Promise<number>;
+export declare function createSolanaAddressCodec(): AddressCodec;
+/**
+ * The block at dense `height` (`confirmed`), checked against the height it claims; `null`
+ * while the endpoint has no block there. A contradicting answer is a retryable
+ * `PROVIDER_INCONSISTENT`, and the cached slot it came from is dropped.
+ */
+export declare function blockAtHeight(ctx: SolanaContext, height: bigint, tags: SolanaCallTags): Promise<{
+    readonly slot: bigint;
+    readonly block: DriverBlock;
+} | null>;
+/**
+ * Reads a transaction at `confirmed`, with its block's height and hash. The answer must be
+ * the transaction asked for: another one decides nothing (a retryable "not yet"), never
+ * reads as ours.
+ */
+export declare function readTransaction(ctx: SolanaContext, signature: string, tags: SolanaCallTags): Promise<{
+    readonly parsed: ParsedTransaction;
+    readonly header: BlockHeader;
+} | null>;
+/**
+ * Token metadata is read under the proof quorum, stricter than
+ * the contract table's minimum: the core caches a token's decimals and "no such token" for
+ * the container's life, so one lagging or wrong endpoint must not mis-scale every amount
+ * until a restart. `mintDecimals` compares the mint's verdict only. The builder reads the
+ * decimals it signs into `transferChecked` the same way, so a lagging
+ * endpoint without the mint decides nothing instead of refusing the transfer.
+ */
+export declare const METADATA: SolanaCallTags;
+export declare function createSolanaReader(ctx: SolanaContext): ChainReader;
+/**
+ * The classic token accounts of `owner`, optionally for one mint. The answer is filtered to
+ * what was asked (lookups by id): an account of another owner or mint, as a node that
+ * drops a filter would list it, is none of the owner's. Token-2022 accounts are skipped
+ * (unsupported). An account listed twice is malformed, never a doubled balance.
+ */
+export declare function tokenAccountsOf(ctx: SolanaContext, owner: string, mint: string | undefined, tags: SolanaCallTags): Promise<SolanaTokenAccount[]>;
+export declare function createSolanaExt(ctx: SolanaContext): SolanaExt;

package/dist/adapters/solana/reader.js

@@ -0,0 +1,326 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.METADATA = void 0;
+exports.accountInfo = accountInfo;
+exports.mintOf = mintOf;
+exports.mintDecimals = mintDecimals;
+exports.createSolanaAddressCodec = createSolanaAddressCodec;
+exports.blockAtHeight = blockAtHeight;
+exports.readTransaction = readTransaction;
+exports.createSolanaReader = createSolanaReader;
+exports.tokenAccountsOf = tokenAccountsOf;
+exports.createSolanaExt = createSolanaExt;
+const error_1 = require("../../core/errors/error");
+const decode_1 = require("./decode");
+const keys_1 = require("./keys");
+const programs_1 = require("./programs");
+const rpc_1 = require("./rpc");
+/**
+ * Account data in agave's `base64` encoding, refused unless it is canonical: Node decodes
+ * leniently (a stray character is skipped, `AB==` reads as `AA==`), so the bytes must
+ * encode back to the same text. The check is linear, which matters: accounts hold up to
+ * 10 MiB, and a repeated-group regex overflows the stack on a few MiB.
+ */
+function base64Data(value, what) {
+    if (!Array.isArray(value) ||
+        value.length !== 2 ||
+        value[1] !== 'base64' ||
+        typeof value[0] !== 'string' ||
+        value[0].length % 4 !== 0) {
+        throw (0, rpc_1.malformed)(what);
+    }
+    const bytes = Buffer.from(value[0], 'base64');
+    if (bytes.toString('base64') !== value[0])
+        throw (0, rpc_1.malformed)(what);
+    return new Uint8Array(bytes);
+}
+/** A `getAccountInfo` answer (base64): the account, or `null` when it does not exist. */
+function parseAccount(result) {
+    const value = (0, rpc_1.contextValue)(result, 'getAccountInfo');
+    if (value === null)
+        return null;
+    const account = (0, rpc_1.record)(value);
+    if (!account || !(0, keys_1.isAddress)(account.owner) || typeof account.executable !== 'boolean') {
+        throw (0, rpc_1.malformed)('getAccountInfo');
+    }
+    return {
+        owner: account.owner,
+        executable: account.executable,
+        data: base64Data(account.data, 'getAccountInfo'),
+    };
+}
+/** `getAccountInfo` (base64) at `confirmed`; `null` when the account does not exist. */
+async function accountInfo(ctx, address, tags) {
+    return parseAccount(await (0, rpc_1.call)(ctx.transport, 'getAccountInfo', [address, { encoding: 'base64', commitment: 'confirmed' }], tags));
+}
+const assetError = (reason) => new error_1.ValidationError('ASSET_RESOLUTION', reason);
+/** The mint of an `spl` asset ref; any other standard is not a Solana token. */
+function mintOf(asset) {
+    if (asset === 'native' || asset.standard !== 'spl') {
+        throw assetError(`Solana tokens use the 'spl' standard`);
+    }
+    if (!(0, keys_1.isAddress)(asset.contract))
+        throw assetError('not a Solana mint address');
+    return asset.contract;
+}
+/**
+ * The verdict of a mint account, by its owning program first: a classic mint and a
+ * Token-2022 one cannot be told apart by their size.
+ */
+function mintVerdict(info) {
+    if (!info)
+        return { refused: 'missing' };
+    if (info.owner === programs_1.TOKEN_2022_PROGRAM)
+        return { refused: 'token-2022' };
+    if (info.owner !== programs_1.TOKEN_PROGRAM)
+        return { refused: 'other-program' };
+    const decoded = (0, programs_1.decodeMint)(info.data);
+    return decoded ? { decimals: decoded.decimals } : { refused: 'unparsable' };
+}
+/**
+ * A mint read's quorum key, verdict fields only: the verdict itself, never the
+ * context slot, the lamports or the supply, on which honest endpoints differ. A malformed
+ * answer keys as such, so it never agrees with a verdict.
+ */
+function mintKey(result) {
+    try {
+        return mintVerdict(parseAccount(result));
+    }
+    catch {
+        return 'malformed';
+    }
+}
+/**
+ * A classic Token mint's decimals: a missing mint, an account of another
+ * program or data that does not parse is the token's own `ASSET_RESOLUTION`; a Token-2022
+ * mint is `UNSUPPORTED_CAPABILITY`. A definitive node error is made retryable;
+ * `PROVIDER_MISCONFIGURED` and retryable errors propagate unchanged. Under a quorum (the
+ * token metadata the core caches), endpoints must agree on the verdict: a lagging one that
+ * has no mint yet, or one with other decimals, decides nothing (`PROVIDER_INCONSISTENT`).
+ */
+async function mintDecimals(ctx, mint, tags) {
+    let info;
+    try {
+        info = await accountInfo(ctx, mint, { ...tags, quorumKey: mintKey });
+    }
+    catch (error) {
+        if ((0, error_1.isCryptoAioError)(error, 'RPC_ERROR') && !error.retryable) {
+            throw (0, error_1.withContext)(error, {}, { retryable: true });
+        }
+        throw error;
+    }
+    const verdict = mintVerdict(info);
+    if ('decimals' in verdict)
+        return verdict.decimals;
+    switch (verdict.refused) {
+        case 'missing':
+            throw assetError('no mint at this address');
+        case 'token-2022':
+            throw new error_1.UnsupportedCapabilityError('UNSUPPORTED_CAPABILITY', 'Token-2022 mints are not supported');
+        case 'other-program':
+            throw assetError('not an SPL token mint');
+        case 'unparsable':
+            throw assetError('the mint does not parse');
+    }
+}
+function createSolanaAddressCodec() {
+    return {
+        validate: (value) => (0, keys_1.isAddress)(value),
+        normalize: (value) => {
+            if (!(0, keys_1.isAddress)(value)) {
+                throw new error_1.ValidationError('INVALID_ADDRESS', 'not a Solana address');
+            }
+            return { canonical: value, display: value };
+        },
+        fromPublicKey: (publicKey) => {
+            const canonical = (0, keys_1.addressFromPublicKey)(publicKey);
+            return { canonical, display: canonical };
+        },
+    };
+}
+function driverBlock(height, header) {
+    return {
+        height,
+        hash: header.blockhash,
+        parentHash: header.previousBlockhash,
+        ...(header.blockTime !== undefined ? { timestamp: header.blockTime } : {}),
+    };
+}
+/**
+ * The block at dense `height` (`confirmed`), checked against the height it claims; `null`
+ * while the endpoint has no block there. A contradicting answer is a retryable
+ * `PROVIDER_INCONSISTENT`, and the cached slot it came from is dropped.
+ */
+async function blockAtHeight(ctx, height, tags) {
+    const slot = await ctx.heights.slotAt(height, 'confirmed', tags);
+    if (slot === null)
+        return null;
+    const header = await ctx.heights.header(slot, 'confirmed', tags);
+    if (!header)
+        return null;
+    if (header.blockHeight !== height) {
+        ctx.heights.forget();
+        throw (0, rpc_1.inconsistent)(`the block at slot ${slot} is not at height ${height}`);
+    }
+    return { slot, block: driverBlock(height, header) };
+}
+/**
+ * Reads a transaction at `confirmed`, with its block's height and hash. The answer must be
+ * the transaction asked for: another one decides nothing (a retryable "not yet"), never
+ * reads as ours.
+ */
+async function readTransaction(ctx, signature, tags) {
+    const result = await (0, rpc_1.call)(ctx.transport, 'getTransaction', [signature, (0, rpc_1.parsedOptions)('confirmed')], tags);
+    if (result === null)
+        return null;
+    const parsed = (0, decode_1.parseTransaction)(result, signature);
+    if (parsed.slot === undefined)
+        throw (0, rpc_1.malformed)('getTransaction');
+    const header = await ctx.heights.header(parsed.slot, 'confirmed', tags);
+    if (!header)
+        throw (0, rpc_1.notYet)('the block of the transaction');
+    return { parsed, header };
+}
+/**
+ * Token metadata is read under the proof quorum, stricter than
+ * the contract table's minimum: the core caches a token's decimals and "no such token" for
+ * the container's life, so one lagging or wrong endpoint must not mis-scale every amount
+ * until a restart. `mintDecimals` compares the mint's verdict only. The builder reads the
+ * decimals it signs into `transferChecked` the same way, so a lagging
+ * endpoint without the mint decides nothing instead of refusing the transfer.
+ */
+exports.METADATA = Object.freeze({ ...rpc_1.READ, quorum: 'proof' });
+function createSolanaReader(ctx) {
+    const height = async (commitment) => (0, rpc_1.u64)(await (0, rpc_1.call)(ctx.transport, 'getBlockHeight', [{ commitment }], rpc_1.MONITOR), 'getBlockHeight');
+    return {
+        getBalance: async (address, asset) => {
+            if (asset === 'native') {
+                return (0, rpc_1.u64)((0, rpc_1.contextValue)(await (0, rpc_1.call)(ctx.transport, 'getBalance', [address, { commitment: 'confirmed' }], rpc_1.READ), 'getBalance'), 'balance');
+            }
+            const mint = mintOf(asset);
+            const accounts = await tokenAccountsOf(ctx, address, mint, rpc_1.READ);
+            return accounts.reduce((sum, account) => sum + account.amount, 0n);
+        },
+        getBlockHeight: () => height('confirmed'),
+        getFinalizedHeight: () => height('finalized'),
+        getBlock: async (ref) => {
+            if (typeof ref !== 'bigint') {
+                throw new error_1.UnsupportedCapabilityError('UNSUPPORTED_CAPABILITY', 'Solana has no block lookup by hash; pass a block height');
+            }
+            return (await blockAtHeight(ctx, ref, rpc_1.READ))?.block ?? null;
+        },
+        getTransaction: async (id) => {
+            if (!(0, keys_1.isSignature)(id))
+                return null;
+            const found = await readTransaction(ctx, id, rpc_1.READ);
+            if (!found)
+                return null;
+            return (0, decode_1.decodeTransaction)(found.parsed, {
+                height: found.header.blockHeight,
+                hash: found.header.blockhash,
+                ...(found.parsed.blockTime !== undefined
+                    ? { blockTime: found.parsed.blockTime }
+                    : {}),
+            });
+        },
+        observe: async (ref, ordering, from) => {
+            if (!(0, keys_1.isSignature)(ref.id))
+                return { seen: 'none' };
+            const found = await readTransaction(ctx, ref.id, rpc_1.MONITOR);
+            if (!found)
+                return { seen: 'none' };
+            const { parsed, header } = found;
+            let success = parsed.err === null;
+            let reason = success ? undefined : 'transaction failed';
+            // The phantom-success guard applies to our own Attempts only. This is
+            // one endpoint's `confirmed` view, so the core records it as observed evidence,
+            // never terminal: a verdict reads the finalized transaction under the proof quorum's
+            // key (`proofs.ts`). A node that drops the token instruction makes the transfer look
+            // native here, which that verdict catches.
+            if (success && ordering !== undefined && from !== undefined) {
+                if (!(0, decode_1.tokenTransfersLanded)(parsed, from)) {
+                    success = false;
+                    reason = 'token transfer failed';
+                }
+            }
+            return {
+                seen: 'block',
+                txHash: parsed.signature,
+                blockHeight: header.blockHeight,
+                blockHash: header.blockhash,
+                success,
+                ...(reason !== undefined ? { reason } : {}),
+            };
+        },
+        getTokenMetadata: async (ref) => {
+            const mint = mintOf(ref);
+            const decimals = await mintDecimals(ctx, mint, exports.METADATA);
+            // SPL mints carry no symbol on chain: a registered token has its own; any other
+            // shows the first characters of its mint (display only).
+            return { symbol: mint.slice(0, 8), decimals };
+        },
+        normalizeTokenRef: (ref) => ({ standard: 'spl', contract: mintOf(ref) }),
+    };
+}
+/**
+ * The classic token accounts of `owner`, optionally for one mint. The answer is filtered to
+ * what was asked (lookups by id): an account of another owner or mint, as a node that
+ * drops a filter would list it, is none of the owner's. Token-2022 accounts are skipped
+ * (unsupported). An account listed twice is malformed, never a doubled balance.
+ */
+async function tokenAccountsOf(ctx, owner, mint, tags) {
+    const value = (0, rpc_1.contextValue)(await (0, rpc_1.call)(ctx.transport, 'getTokenAccountsByOwner', [
+        owner,
+        mint !== undefined ? { mint } : { programId: programs_1.TOKEN_PROGRAM },
+        { encoding: 'base64', commitment: 'confirmed' },
+    ], tags), 'getTokenAccountsByOwner');
+    if (!Array.isArray(value))
+        throw (0, rpc_1.malformed)('getTokenAccountsByOwner');
+    const accounts = [];
+    const listed = new Set();
+    for (const entry of value) {
+        const item = (0, rpc_1.record)(entry);
+        const account = (0, rpc_1.record)(item?.account);
+        if (!item ||
+            !account ||
+            !(0, keys_1.isAddress)(item.pubkey) ||
+            listed.has(item.pubkey) ||
+            !(0, keys_1.isAddress)(account.owner)) {
+            throw (0, rpc_1.malformed)('getTokenAccountsByOwner');
+        }
+        listed.add(item.pubkey);
+        if (account.owner !== programs_1.TOKEN_PROGRAM)
+            continue; // Token-2022 is unsupported.
+        const decoded = (0, programs_1.decodeTokenAccount)(base64Data(account.data, 'getTokenAccountsByOwner'));
+        if (!decoded)
+            throw (0, rpc_1.malformed)('getTokenAccountsByOwner');
+        const accountMint = (0, keys_1.encodeBase58)(decoded.mint);
+        if ((0, keys_1.encodeBase58)(decoded.owner) !== owner)
+            continue;
+        if (mint !== undefined && accountMint !== mint)
+            continue;
+        accounts.push({
+            address: item.pubkey,
+            mint: accountMint,
+            amount: decoded.amount,
+            frozen: decoded.frozen,
+        });
+    }
+    return accounts;
+}
+function createSolanaExt(ctx) {
+    return {
+        solana: {
+            getTokenAccounts: async (owner, mint) => {
+                if (!(0, keys_1.isAddress)(owner)) {
+                    throw new error_1.ValidationError('INVALID_ADDRESS', 'not a Solana address');
+                }
+                if (mint !== undefined && (0, keys_1.decodeBase58)(mint, 32) === null) {
+                    throw new error_1.ValidationError('INVALID_ADDRESS', 'not a Solana mint address');
+                }
+                return tokenAccountsOf(ctx, owner, mint, rpc_1.READ);
+            },
+        },
+    };
+}
+//# sourceMappingURL=reader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../src/adapters/solana/reader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Solana addresses, reads and the `ext.solana` API. Every call carries the tags of the\n * `ChainDriver` contract table: `read` for point queries, `monitor` for heights and\n * observations. Heads are read at `confirmed`, finality at `finalized`.\n */\nimport type {\n  AddressCodec,\n  ChainReader,\n  DriverBlock,\n  DriverTxObservation,\n} from '../../core/driver/types';\nimport {\n  UnsupportedCapabilityError,\n  ValidationError,\n  isCryptoAioError,\n  withContext,\n} from '../../core/errors/error';\nimport type { Logger } from '../../core/events/logger';\nimport type { AssetMetadata, AssetRef, TokenRef } from '../../core/model/asset';\nimport type { ChainInfo, NetworkInfo } from '../../core/model/chain';\nimport type { Transport } from '../../core/transport/types';\nimport {\n  decodeTransaction,\n  parseTransaction,\n  tokenTransfersLanded,\n  type ParsedTransaction,\n} from './decode';\nimport type { HeightIndex } from './heights';\nimport {\n  addressFromPublicKey,\n  decodeBase58,\n  encodeBase58,\n  isAddress,\n  isSignature,\n} from './keys';\nimport type { SolanaNetworkConfig } from './network';\nimport {\n  TOKEN_2022_PROGRAM,\n  TOKEN_PROGRAM,\n  decodeMint,\n  decodeTokenAccount,\n} from './programs';\nimport {\n  MONITOR,\n  READ,\n  call,\n  contextValue,\n  inconsistent,\n  malformed,\n  notYet,\n  parsedOptions,\n  record,\n  u64,\n  type BlockHeader,\n} from './rpc';\nimport type { SolanaCallTags, SolanaCodec, SolanaExt, SolanaTokenAccount } from './types';\n\n/** What every Solana port is built from. */\nexport interface SolanaContext {\n  readonly transport: Transport;\n  readonly codec: SolanaCodec;\n  readonly chain: ChainInfo;\n  readonly network: NetworkInfo;\n  readonly config: SolanaNetworkConfig;\n  readonly heights: HeightIndex;\n  readonly log: Logger;\n  /** The next build variant (`fees.ts`, `variantCounter`). */\n  readonly nextVariant: () => number;\n}\n\nexport interface AccountInfo {\n  readonly owner: string;\n  readonly executable: boolean;\n  readonly data: Uint8Array;\n}\n\n/**\n * Account data in agave's `base64` encoding, refused unless it is canonical: Node decodes\n * leniently (a stray character is skipped, `AB==` reads as `AA==`), so the bytes must\n * encode back to the same text. The check is linear, which matters: accounts hold up to\n * 10 MiB, and a repeated-group regex overflows the stack on a few MiB.\n */\nfunction base64Data(value: unknown, what: string): Uint8Array {\n  if (\n    !Array.isArray(value) ||\n    value.length !== 2 ||\n    value[1] !== 'base64' ||\n    typeof value[0] !== 'string' ||\n    value[0].length % 4 !== 0\n  ) {\n    throw malformed(what);\n  }\n  const bytes = Buffer.from(value[0], 'base64');\n  if (bytes.toString('base64') !== value[0]) throw malformed(what);\n  return new Uint8Array(bytes);\n}\n\n/** A `getAccountInfo` answer (base64): the account, or `null` when it does not exist. */\nfunction parseAccount(result: unknown): AccountInfo | null {\n  const value = contextValue(result, 'getAccountInfo');\n  if (value === null) return null;\n  const account = record(value);\n  if (!account || !isAddress(account.owner) || typeof account.executable !== 'boolean') {\n    throw malformed('getAccountInfo');\n  }\n  return {\n    owner: account.owner,\n    executable: account.executable,\n    data: base64Data(account.data, 'getAccountInfo'),\n  };\n}\n\n/** `getAccountInfo` (base64) at `confirmed`; `null` when the account does not exist. */\nexport async function accountInfo(\n  ctx: SolanaContext,\n  address: string,\n  tags: SolanaCallTags,\n): Promise<AccountInfo | null> {\n  return parseAccount(\n    await call(\n      ctx.transport,\n      'getAccountInfo',\n      [address, { encoding: 'base64', commitment: 'confirmed' }],\n      tags,\n    ),\n  );\n}\n\nconst assetError = (reason: string) => new ValidationError('ASSET_RESOLUTION', reason);\n\n/** The mint of an `spl` asset ref; any other standard is not a Solana token. */\nexport function mintOf(asset: AssetRef): string {\n  if (asset === 'native' || asset.standard !== 'spl') {\n    throw assetError(`Solana tokens use the 'spl' standard`);\n  }\n  if (!isAddress(asset.contract)) throw assetError('not a Solana mint address');\n  return asset.contract;\n}\n\n/** What a mint account says about its token: the only fields a mint read decides on. */\ntype MintVerdict =\n  | { readonly decimals: number }\n  | { readonly refused: 'missing' | 'token-2022' | 'other-program' | 'unparsable' };\n\n/**\n * The verdict of a mint account, by its owning program first: a classic mint and a\n * Token-2022 one cannot be told apart by their size.\n */\nfunction mintVerdict(info: AccountInfo | null): MintVerdict {\n  if (!info) return { refused: 'missing' };\n  if (info.owner === TOKEN_2022_PROGRAM) return { refused: 'token-2022' };\n  if (info.owner !== TOKEN_PROGRAM) return { refused: 'other-program' };\n  const decoded = decodeMint(info.data);\n  return decoded ? { decimals: decoded.decimals } : { refused: 'unparsable' };\n}\n\n/**\n * A mint read's quorum key, verdict fields only: the verdict itself, never the\n * context slot, the lamports or the supply, on which honest endpoints differ. A malformed\n * answer keys as such, so it never agrees with a verdict.\n */\nfunction mintKey(result: unknown): unknown {\n  try {\n    return mintVerdict(parseAccount(result));\n  } catch {\n    return 'malformed';\n  }\n}\n\n/**\n * A classic Token mint's decimals: a missing mint, an account of another\n * program or data that does not parse is the token's own `ASSET_RESOLUTION`; a Token-2022\n * mint is `UNSUPPORTED_CAPABILITY`. A definitive node error is made retryable;\n * `PROVIDER_MISCONFIGURED` and retryable errors propagate unchanged. Under a quorum (the\n * token metadata the core caches), endpoints must agree on the verdict: a lagging one that\n * has no mint yet, or one with other decimals, decides nothing (`PROVIDER_INCONSISTENT`).\n */\nexport async function mintDecimals(\n  ctx: SolanaContext,\n  mint: string,\n  tags: SolanaCallTags,\n): Promise<number> {\n  let info: AccountInfo | null;\n  try {\n    info = await accountInfo(ctx, mint, { ...tags, quorumKey: mintKey });\n  } catch (error) {\n    if (isCryptoAioError(error, 'RPC_ERROR') && !error.retryable) {\n      throw withContext(error, {}, { retryable: true });\n    }\n    throw error;\n  }\n  const verdict = mintVerdict(info);\n  if ('decimals' in verdict) return verdict.decimals;\n  switch (verdict.refused) {\n    case 'missing':\n      throw assetError('no mint at this address');\n    case 'token-2022':\n      throw new UnsupportedCapabilityError(\n        'UNSUPPORTED_CAPABILITY',\n        'Token-2022 mints are not supported',\n      );\n    case 'other-program':\n      throw assetError('not an SPL token mint');\n    case 'unparsable':\n      throw assetError('the mint does not parse');\n  }\n}\n\nexport function createSolanaAddressCodec(): AddressCodec {\n  return {\n    validate: (value) => isAddress(value),\n    normalize: (value) => {\n      if (!isAddress(value)) {\n        throw new ValidationError('INVALID_ADDRESS', 'not a Solana address');\n      }\n      return { canonical: value, display: value };\n    },\n    fromPublicKey: (publicKey) => {\n      const canonical = addressFromPublicKey(publicKey);\n      return { canonical, display: canonical };\n    },\n  };\n}\n\nfunction driverBlock(height: bigint, header: BlockHeader): DriverBlock {\n  return {\n    height,\n    hash: header.blockhash,\n    parentHash: header.previousBlockhash,\n    ...(header.blockTime !== undefined ? { timestamp: header.blockTime } : {}),\n  };\n}\n\n/**\n * The block at dense `height` (`confirmed`), checked against the height it claims; `null`\n * while the endpoint has no block there. A contradicting answer is a retryable\n * `PROVIDER_INCONSISTENT`, and the cached slot it came from is dropped.\n */\nexport async function blockAtHeight(\n  ctx: SolanaContext,\n  height: bigint,\n  tags: SolanaCallTags,\n): Promise<{ readonly slot: bigint; readonly block: DriverBlock } | null> {\n  const slot = await ctx.heights.slotAt(height, 'confirmed', tags);\n  if (slot === null) return null;\n  const header = await ctx.heights.header(slot, 'confirmed', tags);\n  if (!header) return null;\n  if (header.blockHeight !== height) {\n    ctx.heights.forget();\n    throw inconsistent(`the block at slot ${slot} is not at height ${height}`);\n  }\n  return { slot, block: driverBlock(height, header) };\n}\n\n/**\n * Reads a transaction at `confirmed`, with its block's height and hash. The answer must be\n * the transaction asked for: another one decides nothing (a retryable \"not yet\"), never\n * reads as ours.\n */\nexport async function readTransaction(\n  ctx: SolanaContext,\n  signature: string,\n  tags: SolanaCallTags,\n): Promise<{ readonly parsed: ParsedTransaction; readonly header: BlockHeader } | null> {\n  const result = await call(\n    ctx.transport,\n    'getTransaction',\n    [signature, parsedOptions('confirmed')],\n    tags,\n  );\n  if (result === null) return null;\n  const parsed = parseTransaction(result, signature);\n  if (parsed.slot === undefined) throw malformed('getTransaction');\n  const header = await ctx.heights.header(parsed.slot, 'confirmed', tags);\n  if (!header) throw notYet('the block of the transaction');\n  return { parsed, header };\n}\n\n/**\n * Token metadata is read under the proof quorum, stricter than\n * the contract table's minimum: the core caches a token's decimals and \"no such token\" for\n * the container's life, so one lagging or wrong endpoint must not mis-scale every amount\n * until a restart. `mintDecimals` compares the mint's verdict only. The builder reads the\n * decimals it signs into `transferChecked` the same way, so a lagging\n * endpoint without the mint decides nothing instead of refusing the transfer.\n */\nexport const METADATA: SolanaCallTags = Object.freeze({ ...READ, quorum: 'proof' });\n\nexport function createSolanaReader(ctx: SolanaContext): ChainReader {\n  const height = async (commitment: 'confirmed' | 'finalized') =>\n    u64(\n      await call(ctx.transport, 'getBlockHeight', [{ commitment }], MONITOR),\n      'getBlockHeight',\n    );\n  return {\n    getBalance: async (address, asset) => {\n      if (asset === 'native') {\n        return u64(\n          contextValue(\n            await call(\n              ctx.transport,\n              'getBalance',\n              [address, { commitment: 'confirmed' }],\n              READ,\n            ),\n            'getBalance',\n          ),\n          'balance',\n        );\n      }\n      const mint = mintOf(asset);\n      const accounts = await tokenAccountsOf(ctx, address, mint, READ);\n      return accounts.reduce((sum, account) => sum + account.amount, 0n);\n    },\n    getBlockHeight: () => height('confirmed'),\n    getFinalizedHeight: () => height('finalized'),\n    getBlock: async (ref) => {\n      if (typeof ref !== 'bigint') {\n        throw new UnsupportedCapabilityError(\n          'UNSUPPORTED_CAPABILITY',\n          'Solana has no block lookup by hash; pass a block height',\n        );\n      }\n      return (await blockAtHeight(ctx, ref, READ))?.block ?? null;\n    },\n    getTransaction: async (id) => {\n      if (!isSignature(id)) return null;\n      const found = await readTransaction(ctx, id, READ);\n      if (!found) return null;\n      return decodeTransaction(found.parsed, {\n        height: found.header.blockHeight,\n        hash: found.header.blockhash,\n        ...(found.parsed.blockTime !== undefined\n          ? { blockTime: found.parsed.blockTime }\n          : {}),\n      });\n    },\n    observe: async (ref, ordering, from): Promise<DriverTxObservation> => {\n      if (!isSignature(ref.id)) return { seen: 'none' };\n      const found = await readTransaction(ctx, ref.id, MONITOR);\n      if (!found) return { seen: 'none' };\n      const { parsed, header } = found;\n      let success = parsed.err === null;\n      let reason = success ? undefined : 'transaction failed';\n      // The phantom-success guard applies to our own Attempts only. This is\n      // one endpoint's `confirmed` view, so the core records it as observed evidence,\n      // never terminal: a verdict reads the finalized transaction under the proof quorum's\n      // key (`proofs.ts`). A node that drops the token instruction makes the transfer look\n      // native here, which that verdict catches.\n      if (success && ordering !== undefined && from !== undefined) {\n        if (!tokenTransfersLanded(parsed, from)) {\n          success = false;\n          reason = 'token transfer failed';\n        }\n      }\n      return {\n        seen: 'block',\n        txHash: parsed.signature,\n        blockHeight: header.blockHeight,\n        blockHash: header.blockhash,\n        success,\n        ...(reason !== undefined ? { reason } : {}),\n      };\n    },\n    getTokenMetadata: async (ref: TokenRef): Promise<AssetMetadata> => {\n      const mint = mintOf(ref);\n      const decimals = await mintDecimals(ctx, mint, METADATA);\n      // SPL mints carry no symbol on chain: a registered token has its own; any other\n      // shows the first characters of its mint (display only).\n      return { symbol: mint.slice(0, 8), decimals };\n    },\n    normalizeTokenRef: (ref) => ({ standard: 'spl', contract: mintOf(ref) }),\n  };\n}\n\n/**\n * The classic token accounts of `owner`, optionally for one mint. The answer is filtered to\n * what was asked (lookups by id): an account of another owner or mint, as a node that\n * drops a filter would list it, is none of the owner's. Token-2022 accounts are skipped\n * (unsupported). An account listed twice is malformed, never a doubled balance.\n */\nexport async function tokenAccountsOf(\n  ctx: SolanaContext,\n  owner: string,\n  mint: string | undefined,\n  tags: SolanaCallTags,\n): Promise<SolanaTokenAccount[]> {\n  const value = contextValue(\n    await call(\n      ctx.transport,\n      'getTokenAccountsByOwner',\n      [\n        owner,\n        mint !== undefined ? { mint } : { programId: TOKEN_PROGRAM },\n        { encoding: 'base64', commitment: 'confirmed' },\n      ],\n      tags,\n    ),\n    'getTokenAccountsByOwner',\n  );\n  if (!Array.isArray(value)) throw malformed('getTokenAccountsByOwner');\n  const accounts: SolanaTokenAccount[] = [];\n  const listed = new Set<string>();\n  for (const entry of value) {\n    const item = record(entry);\n    const account = record(item?.account);\n    if (\n      !item ||\n      !account ||\n      !isAddress(item.pubkey) ||\n      listed.has(item.pubkey) ||\n      !isAddress(account.owner)\n    ) {\n      throw malformed('getTokenAccountsByOwner');\n    }\n    listed.add(item.pubkey);\n    if (account.owner !== TOKEN_PROGRAM) continue; // Token-2022 is unsupported.\n    const decoded = decodeTokenAccount(\n      base64Data(account.data, 'getTokenAccountsByOwner'),\n    );\n    if (!decoded) throw malformed('getTokenAccountsByOwner');\n    const accountMint = encodeBase58(decoded.mint);\n    if (encodeBase58(decoded.owner) !== owner) continue;\n    if (mint !== undefined && accountMint !== mint) continue;\n    accounts.push({\n      address: item.pubkey,\n      mint: accountMint,\n      amount: decoded.amount,\n      frozen: decoded.frozen,\n    });\n  }\n  return accounts;\n}\n\nexport function createSolanaExt(ctx: SolanaContext): SolanaExt {\n  return {\n    solana: {\n      getTokenAccounts: async (owner, mint) => {\n        if (!isAddress(owner)) {\n          throw new ValidationError('INVALID_ADDRESS', 'not a Solana address');\n        }\n        if (mint !== undefined && decodeBase58(mint, 32) === null) {\n          throw new ValidationError('INVALID_ADDRESS', 'not a Solana mint address');\n        }\n        return tokenAccountsOf(ctx, owner, mint, READ);\n      },\n    },\n  };\n}\n"]}