@prb/effect-solana 1.0.0-beta.3 → 1.0.0-beta.5

package/dist/program/reader.js

@@ -0,0 +1,288 @@
+import { Program } from "@coral-xyz/anchor";
+import { Buffer } from "buffer";
+import { Cause, Context, Effect, Exit, Layer, Option, Runtime } from "effect";
+import { WalletNotConnectedError } from "#src/core/errors/index.js";
+import { RpcService } from "#src/rpc/index.js";
+import { SignerService } from "#src/signer/index.js";
+import { SpanNames } from "#src/telemetry/index.js";
+import { makeProgramConnectionShim, toAnchorAccounts, toAnchorArgs, toPublicKey, } from "./internal/anchor-helpers.js";
+import { InstructionNotFoundError, ProgramCreationError, ProgramReadError, ViewNotSupportedError, } from "./types.js";
+function mutateTransactionForSimulation(tx, feePayer, blockhash, signers) {
+    if ("feePayer" in tx) {
+        tx.feePayer = feePayer;
+    }
+    if ("recentBlockhash" in tx) {
+        tx.recentBlockhash = blockhash;
+    }
+    if (signers && signers.length > 0 && "partialSign" in tx) {
+        tx.partialSign(...signers);
+    }
+}
+function toBase64WireTransaction(tx) {
+    const wireTransaction = "version" in tx
+        ? tx.serialize()
+        : tx.serialize({
+            requireAllSignatures: false,
+            verifySignatures: false,
+        });
+    return Buffer.from(wireTransaction).toString("base64");
+}
+function hasWritableAccounts(accounts) {
+    return accounts.some((account) => {
+        if (typeof account !== "object" || account === null) {
+            return false;
+        }
+        if ("accounts" in account && Array.isArray(account.accounts)) {
+            return hasWritableAccounts(account.accounts);
+        }
+        if ("writable" in account && account.writable === true) {
+            return true;
+        }
+        return "isMut" in account && account.isMut === true;
+    });
+}
+function getIdlName(program) {
+    return program.idl.metadata?.name ?? "unknown";
+}
+function resolveProgramIdAttribute(programId, idlAddress) {
+    if (programId) {
+        return String(programId);
+    }
+    if (typeof idlAddress === "string") {
+        return idlAddress;
+    }
+    return "unknown";
+}
+function makeInstructionNotFoundError(method, idlName) {
+    return new InstructionNotFoundError({
+        idlName,
+        message: `Instruction "${method}" not found in IDL "${idlName}"`,
+        method,
+    });
+}
+function makeViewNotSupportedError(method, idlName) {
+    return new ViewNotSupportedError({
+        idlName,
+        message: `Method "${method}" in IDL "${idlName}" does not support .view()`,
+        method,
+    });
+}
+function makeProgramReadError(method, cause) {
+    return new ProgramReadError({
+        cause,
+        message: `Failed to read "${method}" via .view()`,
+        method,
+    });
+}
+class SignerSimulationDefectError extends Error {
+    defect;
+    constructor(defect) {
+        super("Signer service defect during ProgramReader simulation");
+        this.name = "SignerSimulationDefectError";
+        this.defect = defect;
+    }
+}
+function isWalletNotConnectedError(error) {
+    return ((typeof error === "object" &&
+        error !== null &&
+        error._tag === "WalletNotConnectedError") ||
+        error instanceof WalletNotConnectedError);
+}
+function getTransactionBlockhash(tx) {
+    if ("recentBlockhash" in tx &&
+        typeof tx.recentBlockhash === "string" &&
+        tx.recentBlockhash.length > 0) {
+        return tx.recentBlockhash;
+    }
+    if ("message" in tx &&
+        typeof tx.message?.recentBlockhash === "string") {
+        return tx.message.recentBlockhash;
+    }
+    return undefined;
+}
+function toWeb3SimulationResponse(value) {
+    const returnData = value.returnData
+        ? {
+            data: [value.returnData.data[0], "base64"],
+            programId: String(value.returnData.programId),
+        }
+        : null;
+    return {
+        logs: value.logs ?? null,
+        returnData,
+        unitsConsumed: value.unitsConsumed === undefined ? undefined : Number(value.unitsConsumed),
+    };
+}
+function formatSimulationError(error) {
+    const MAX_ERROR_MESSAGE_LENGTH = 500;
+    if (typeof error === "string") {
+        return error.slice(0, MAX_ERROR_MESSAGE_LENGTH);
+    }
+    if (error instanceof Error) {
+        return error.message.slice(0, MAX_ERROR_MESSAGE_LENGTH);
+    }
+    try {
+        return JSON.stringify(error, null, 2).slice(0, MAX_ERROR_MESSAGE_LENGTH);
+    }
+    catch {
+        return String(error).slice(0, MAX_ERROR_MESSAGE_LENGTH);
+    }
+}
+function normalizeSimulationCommitment(commitment) {
+    if (!commitment) {
+        return undefined;
+    }
+    switch (commitment) {
+        case "processed":
+        case "confirmed":
+        case "finalized":
+            return commitment;
+        case "recent":
+            return "processed";
+        case "single":
+        case "singleGossip":
+            return "confirmed";
+        case "max":
+        case "root":
+            return "finalized";
+        default:
+            return undefined;
+    }
+}
+function normalizeMethodName(name) {
+    return name.replaceAll("_", "").toLowerCase();
+}
+function resolveViewBuilder(program, params) {
+    return Effect.gen(function* () {
+        const { method, args, accounts } = params;
+        const idlName = getIdlName(program);
+        const methodFn = program.methods[method];
+        if (!methodFn || typeof methodFn !== "function") {
+            return yield* Effect.fail(makeInstructionNotFoundError(method, idlName));
+        }
+        const normalizedMethod = normalizeMethodName(method);
+        const exactInstruction = program.idl.instructions.find((instruction) => instruction.name === method);
+        const normalizedMatches = program.idl.instructions.filter((instruction) => normalizeMethodName(instruction.name) === normalizedMethod);
+        const idlInstruction = exactInstruction ?? (normalizedMatches.length === 1 ? normalizedMatches[0] : undefined);
+        if (idlInstruction) {
+            const hasWritableAccount = hasWritableAccounts(idlInstruction.accounts);
+            const hasReturnType = Boolean(idlInstruction.returns);
+            if (hasWritableAccount) {
+                return yield* Effect.fail(makeViewNotSupportedError(method, idlName));
+            }
+            if (!hasReturnType) {
+                yield* Effect.logWarning(`ProgramReader found instruction "${idlInstruction.name}" in "${idlName}" without IDL return metadata. Skipping return-type pre-validation and deferring to Anchor runtime.`);
+            }
+        }
+        else if (normalizedMatches.length > 1) {
+            yield* Effect.logWarning(`ProgramReader found ambiguous normalized IDL matches for method "${method}" in "${idlName}". Skipping pre-validation and deferring to Anchor runtime.`);
+        }
+        else {
+            yield* Effect.logWarning(`ProgramReader could not match method "${method}" to an IDL instruction in "${idlName}". Skipping pre-validation and deferring to Anchor runtime.`);
+        }
+        const anchorArgs = toAnchorArgs(args);
+        const anchorAccounts = toAnchorAccounts(accounts);
+        const builder = methodFn(...anchorArgs);
+        const withAccounts = builder.accountsPartial(anchorAccounts);
+        if (!withAccounts || typeof withAccounts.view !== "function") {
+            return yield* Effect.fail(makeViewNotSupportedError(method, idlName));
+        }
+        return withAccounts;
+    });
+}
+export class ProgramReader extends Context.Tag("esolana/ProgramReader")() {
+}
+export const ProgramReaderLive = Layer.effect(ProgramReader, Effect.gen(function* () {
+    const rpcService = yield* RpcService;
+    const signerService = yield* SignerService;
+    const runtime = yield* Effect.runtime();
+    const service = {
+        createProgram: (params) => Effect.gen(function* () {
+            const { idl, programId } = params;
+            const rpc = yield* rpcService.getRpc();
+            const initialWalletAddress = yield* signerService.getAddress();
+            const resolveSimulationFeePayer = async () => {
+                const exit = await Runtime.runPromiseExit(runtime, signerService.getAddress());
+                if (Exit.isSuccess(exit)) {
+                    return toPublicKey(exit.value);
+                }
+                const failure = Cause.failureOption(exit.cause);
+                if (Option.isSome(failure)) {
+                    throw failure.value;
+                }
+                throw new SignerSimulationDefectError(Cause.squash(exit.cause));
+            };
+            const idlWithAddress = programId ? { ...idl, address: programId } : idl;
+            return yield* Effect.try({
+                catch: (error) => new ProgramCreationError({
+                    cause: error,
+                    message: "Failed to create Anchor program",
+                }),
+                try: () => new Program(idlWithAddress, {
+                    connection: makeProgramConnectionShim(rpc, "ProgramReader"),
+                    publicKey: toPublicKey(initialWalletAddress),
+                    simulate: async (tx, signers, commitment) => {
+                        const feePayer = await resolveSimulationFeePayer();
+                        const transactionBlockhash = getTransactionBlockhash(tx) ??
+                            (await rpc.getLatestBlockhash().send()).value.blockhash;
+                        mutateTransactionForSimulation(tx, feePayer, transactionBlockhash, signers);
+                        const base64WireTransaction = toBase64WireTransaction(tx);
+                        const normalizedCommitment = normalizeSimulationCommitment(commitment);
+                        const simulation = await rpc
+                            .simulateTransaction(base64WireTransaction, {
+                            ...(normalizedCommitment ? { commitment: normalizedCommitment } : {}),
+                            encoding: "base64",
+                        })
+                            .send();
+                        if (simulation.value.err) {
+                            throw new Error(`View simulation failed: ${formatSimulationError(simulation.value.err)}`, { cause: simulation.value.err });
+                        }
+                        return toWeb3SimulationResponse(simulation.value);
+                    },
+                }),
+            });
+        }).pipe(Effect.withSpan(SpanNames.PROGRAM_CREATE_FOR_READ, {
+            attributes: {
+                programId: resolveProgramIdAttribute(params.programId, params.idl.address),
+            },
+        })),
+        view: (params) => Effect.gen(function* () {
+            const { idl, method, args, accounts, programId } = params;
+            const program = yield* service.createProgram({ idl, programId });
+            return yield* service.viewWithProgram(program, { accounts, args, method });
+        }).pipe(Effect.withSpan(SpanNames.PROGRAM_VIEW, {
+            attributes: {
+                method: params.method,
+                programId: resolveProgramIdAttribute(params.programId, params.idl.address),
+            },
+        })),
+        viewWithProgram: (program, params) => Effect.gen(function* () {
+            const { method } = params;
+            const idlName = getIdlName(program);
+            const withAccounts = yield* resolveViewBuilder(program, params);
+            return yield* Effect.tryPromise({
+                catch: (error) => {
+                    if (error instanceof SignerSimulationDefectError) {
+                        throw error.defect;
+                    }
+                    if (isWalletNotConnectedError(error)) {
+                        return error;
+                    }
+                    if (error instanceof Error &&
+                        error.message.includes("Method does not support views")) {
+                        return makeViewNotSupportedError(method, idlName);
+                    }
+                    return makeProgramReadError(method, error);
+                },
+                try: () => withAccounts.view(),
+            });
+        }).pipe(Effect.withSpan(SpanNames.PROGRAM_VIEW_WITH_PROGRAM, {
+            attributes: {
+                method: params.method,
+                programId: resolveProgramIdAttribute(undefined, program.idl.address),
+            },
+        })),
+    };
+    return ProgramReader.of(service);
+}));
+//# sourceMappingURL=reader.js.map

package/dist/program/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/program/reader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ProgramReader - Effect-based Anchor program read service using `.view()`.\n *\n * Provides first-class signer-path `.view()` support for Anchor programs.\n * This is the read counterpart to ProgramWriter (instruction building).\n *\n * `.view()` requires a connected wallet (signer) because Anchor constructs\n * a transaction internally and simulates it on behalf of the signer.\n *\n * @module program/reader\n */\n\nimport type { Idl } from \"@coral-xyz/anchor\";\nimport { Program } from \"@coral-xyz/anchor\";\nimport type { Address } from \"@solana/addresses\";\nimport type { Rpc, SolanaRpcApi } from \"@solana/kit\";\nimport type { Commitment } from \"@solana/rpc-types\";\nimport type { Base64EncodedWireTransaction } from \"@solana/transactions\";\nimport type {\n  Signer as AnchorSigner,\n  PublicKey,\n  SimulatedTransactionResponse,\n  Transaction,\n  TransactionReturnData,\n  VersionedTransaction,\n} from \"@solana/web3.js\";\nimport { Buffer } from \"buffer\";\nimport { Cause, Context, Effect, Exit, Layer, Option, Runtime } from \"effect\";\nimport { WalletNotConnectedError } from \"#src/core/errors/index.js\";\nimport { RpcService } from \"#src/rpc/index.js\";\nimport { SignerService } from \"#src/signer/index.js\";\nimport { SpanNames } from \"#src/telemetry/index.js\";\nimport {\n  makeProgramConnectionShim,\n  toAnchorAccounts,\n  toAnchorArgs,\n  toPublicKey,\n} from \"./internal/anchor-helpers.js\";\nimport type { CreateProgramParams, ViewParams } from \"./types.js\";\nimport {\n  InstructionNotFoundError,\n  ProgramCreationError,\n  ProgramReadError,\n  ViewNotSupportedError,\n} from \"./types.js\";\n\n// =============================================================================\n// Helpers\n// =============================================================================\n\nfunction mutateTransactionForSimulation(\n  tx: Transaction | VersionedTransaction,\n  feePayer: PublicKey,\n  blockhash: string,\n  signers?: readonly AnchorSigner[]\n): void {\n  if (\"feePayer\" in tx) {\n    tx.feePayer = feePayer;\n  }\n  if (\"recentBlockhash\" in tx) {\n    tx.recentBlockhash = blockhash;\n  }\n  if (signers && signers.length > 0 && \"partialSign\" in tx) {\n    tx.partialSign(...signers);\n  }\n}\n\nfunction toBase64WireTransaction(\n  tx: Transaction | VersionedTransaction\n): Base64EncodedWireTransaction {\n  const wireTransaction =\n    \"version\" in tx\n      ? tx.serialize()\n      : tx.serialize({\n          requireAllSignatures: false,\n          verifySignatures: false,\n        });\n\n  return Buffer.from(wireTransaction).toString(\"base64\") as Base64EncodedWireTransaction;\n}\n\nfunction hasWritableAccounts(accounts: readonly unknown[]): boolean {\n  // Support both modern Anchor IDL (`writable`) and legacy IDL (`isMut`) shapes.\n  // Nested account groups appear for composite account declarations.\n  return accounts.some((account) => {\n    if (typeof account !== \"object\" || account === null) {\n      return false;\n    }\n\n    if (\"accounts\" in account && Array.isArray(account.accounts)) {\n      return hasWritableAccounts(account.accounts);\n    }\n\n    if (\"writable\" in account && account.writable === true) {\n      return true;\n    }\n\n    return \"isMut\" in account && account.isMut === true;\n  });\n}\n\nfunction getIdlName<T extends Idl>(program: Program<T>): string {\n  return program.idl.metadata?.name ?? \"unknown\";\n}\n\nfunction resolveProgramIdAttribute(programId?: Address, idlAddress?: unknown): string {\n  if (programId) {\n    return String(programId);\n  }\n  if (typeof idlAddress === \"string\") {\n    return idlAddress;\n  }\n  return \"unknown\";\n}\n\nfunction makeInstructionNotFoundError(method: string, idlName: string): InstructionNotFoundError {\n  return new InstructionNotFoundError({\n    idlName,\n    message: `Instruction \"${method}\" not found in IDL \"${idlName}\"`,\n    method,\n  });\n}\n\nfunction makeViewNotSupportedError(method: string, idlName: string): ViewNotSupportedError {\n  return new ViewNotSupportedError({\n    idlName,\n    message: `Method \"${method}\" in IDL \"${idlName}\" does not support .view()`,\n    method,\n  });\n}\n\nfunction makeProgramReadError(method: string, cause: unknown): ProgramReadError {\n  return new ProgramReadError({\n    cause,\n    message: `Failed to read \"${method}\" via .view()`,\n    method,\n  });\n}\n\nclass SignerSimulationDefectError extends Error {\n  readonly defect: unknown;\n\n  constructor(defect: unknown) {\n    super(\"Signer service defect during ProgramReader simulation\");\n    this.name = \"SignerSimulationDefectError\";\n    this.defect = defect;\n  }\n}\n\nfunction isWalletNotConnectedError(error: unknown): error is WalletNotConnectedError {\n  return (\n    (typeof error === \"object\" &&\n      error !== null &&\n      (error as { readonly _tag?: unknown })._tag === \"WalletNotConnectedError\") ||\n    error instanceof WalletNotConnectedError\n  );\n}\n\nfunction getTransactionBlockhash(tx: Transaction | VersionedTransaction): string | undefined {\n  // Supports @solana/web3.js 1.95.x transaction shapes used by Anchor 0.31.x.\n  // Re-check these guards if web3.js changes message/blockhash field layouts.\n  if (\n    \"recentBlockhash\" in tx &&\n    typeof tx.recentBlockhash === \"string\" &&\n    tx.recentBlockhash.length > 0\n  ) {\n    return tx.recentBlockhash;\n  }\n\n  if (\n    \"message\" in tx &&\n    typeof (\n      tx as {\n        readonly message?: { readonly recentBlockhash?: unknown };\n      }\n    ).message?.recentBlockhash === \"string\"\n  ) {\n    return (\n      tx as {\n        readonly message: { readonly recentBlockhash: string };\n      }\n    ).message.recentBlockhash;\n  }\n\n  return undefined;\n}\n\nfunction toWeb3SimulationResponse(\n  value: Awaited<ReturnType<ReturnType<Rpc<SolanaRpcApi>[\"simulateTransaction\"]>[\"send\"]>>[\"value\"]\n): Omit<SimulatedTransactionResponse, \"err\"> {\n  // ProgramReader requests simulation with { encoding: \"base64\" } only.\n  // We map only the response fields Anchor currently reads (logs/returnData) and\n  // normalize unitsConsumed to web3.js' number shape.\n  const returnData: TransactionReturnData | null = value.returnData\n    ? {\n        data: [value.returnData.data[0], \"base64\"] as [string, \"base64\"],\n        programId: String(value.returnData.programId),\n      }\n    : null;\n\n  return {\n    logs: value.logs ?? null,\n    returnData,\n    unitsConsumed: value.unitsConsumed === undefined ? undefined : Number(value.unitsConsumed),\n  };\n}\n\nfunction formatSimulationError(error: unknown): string {\n  const MAX_ERROR_MESSAGE_LENGTH = 500;\n\n  if (typeof error === \"string\") {\n    return error.slice(0, MAX_ERROR_MESSAGE_LENGTH);\n  }\n\n  if (error instanceof Error) {\n    return error.message.slice(0, MAX_ERROR_MESSAGE_LENGTH);\n  }\n\n  try {\n    return JSON.stringify(error, null, 2).slice(0, MAX_ERROR_MESSAGE_LENGTH);\n  } catch {\n    return String(error).slice(0, MAX_ERROR_MESSAGE_LENGTH);\n  }\n}\n\nfunction normalizeSimulationCommitment(commitment?: string): Commitment | undefined {\n  if (!commitment) {\n    return undefined;\n  }\n\n  switch (commitment) {\n    case \"processed\":\n    case \"confirmed\":\n    case \"finalized\":\n      return commitment;\n    case \"recent\":\n      return \"processed\";\n    case \"single\":\n    case \"singleGossip\":\n      return \"confirmed\";\n    case \"max\":\n    case \"root\":\n      return \"finalized\";\n    default:\n      return undefined;\n  }\n}\n\nfunction normalizeMethodName(name: string): string {\n  // Keep normalization intentionally simple for snake_case vs camelCase IDL/method parity.\n  // Normalization may produce collisions; ambiguity is handled by skipping pre-validation.\n  return name.replaceAll(\"_\", \"\").toLowerCase();\n}\n\nfunction resolveViewBuilder<T extends Idl>(\n  program: Program<T>,\n  params: Pick<ViewParams, \"method\" | \"args\" | \"accounts\">\n): Effect.Effect<\n  { view: () => Promise<unknown> },\n  InstructionNotFoundError | ViewNotSupportedError\n> {\n  return Effect.gen(function* () {\n    const { method, args, accounts } = params;\n    const idlName = getIdlName(program);\n\n    const methodFn = (program.methods as Record<string, unknown>)[method];\n    if (!methodFn || typeof methodFn !== \"function\") {\n      return yield* Effect.fail(makeInstructionNotFoundError(method, idlName));\n    }\n\n    const normalizedMethod = normalizeMethodName(method);\n    const exactInstruction = program.idl.instructions.find(\n      (instruction) => instruction.name === method\n    );\n    const normalizedMatches = program.idl.instructions.filter(\n      (instruction) => normalizeMethodName(instruction.name) === normalizedMethod\n    );\n    const idlInstruction =\n      exactInstruction ?? (normalizedMatches.length === 1 ? normalizedMatches[0] : undefined);\n\n    // Keep pre-validation when we can confidently match an IDL instruction.\n    // If no match is found, defer to Anchor's runtime .view() support checks.\n    if (idlInstruction) {\n      const hasWritableAccount = hasWritableAccounts(idlInstruction.accounts);\n      const hasReturnType = Boolean(idlInstruction.returns);\n      if (hasWritableAccount) {\n        return yield* Effect.fail(makeViewNotSupportedError(method, idlName));\n      }\n      if (!hasReturnType) {\n        yield* Effect.logWarning(\n          `ProgramReader found instruction \"${idlInstruction.name}\" in \"${idlName}\" without IDL return metadata. Skipping return-type pre-validation and deferring to Anchor runtime.`\n        );\n      }\n    } else if (normalizedMatches.length > 1) {\n      yield* Effect.logWarning(\n        `ProgramReader found ambiguous normalized IDL matches for method \"${method}\" in \"${idlName}\". Skipping pre-validation and deferring to Anchor runtime.`\n      );\n    } else {\n      yield* Effect.logWarning(\n        `ProgramReader could not match method \"${method}\" to an IDL instruction in \"${idlName}\". Skipping pre-validation and deferring to Anchor runtime.`\n      );\n    }\n\n    const anchorArgs = toAnchorArgs(args);\n    const anchorAccounts = toAnchorAccounts(accounts);\n    const builder = (methodFn as (...methodArgs: unknown[]) => unknown)(...anchorArgs);\n    const withAccounts = (builder as { accountsPartial: (a: unknown) => unknown }).accountsPartial(\n      anchorAccounts\n    );\n\n    if (!withAccounts || typeof (withAccounts as { view?: unknown }).view !== \"function\") {\n      return yield* Effect.fail(makeViewNotSupportedError(method, idlName));\n    }\n\n    return withAccounts as { view: () => Promise<unknown> };\n  });\n}\n\n// =============================================================================\n// Service Definition\n// =============================================================================\n\n/**\n * Shape of the ProgramReader for type inference.\n *\n * @category Services\n */\nexport type ProgramReaderShape = {\n  /**\n   * Create an Anchor Program instance with a signer-backed provider.\n   *\n   * Unlike ProgramWriter's createProgram (which uses a minimal connection-only provider),\n   * this creates a provider with wallet capabilities required for `.view()`.\n   */\n  readonly createProgram: <T extends Idl>(\n    params: CreateProgramParams<T>\n  ) => Effect.Effect<Program<T>, ProgramCreationError | WalletNotConnectedError>;\n\n  /**\n   * Call `.view()` on an Anchor program method.\n   *\n   * Requires a connected wallet — Anchor uses the signer's publicKey\n   * as the payer for the simulated transaction.\n   */\n  readonly view: (\n    params: ViewParams\n  ) => Effect.Effect<\n    unknown,\n    | ProgramCreationError\n    | InstructionNotFoundError\n    | ViewNotSupportedError\n    | ProgramReadError\n    | WalletNotConnectedError\n  >;\n\n  /**\n   * Call `.view()` on a pre-created Program instance.\n   *\n   * Useful for batched reads where the program is already constructed.\n   */\n  readonly viewWithProgram: <T extends Idl>(\n    program: Program<T>,\n    params: Pick<ViewParams, \"method\" | \"args\" | \"accounts\">\n  ) => Effect.Effect<\n    unknown,\n    InstructionNotFoundError | ViewNotSupportedError | ProgramReadError | WalletNotConnectedError\n  >;\n};\n\n/**\n * Service tag for program read operations.\n *\n * @category Services\n */\nexport class ProgramReader extends Context.Tag(\"esolana/ProgramReader\")<\n  ProgramReader,\n  ProgramReaderShape\n>() {}\n\n// =============================================================================\n// Service Implementation\n// =============================================================================\n\n/**\n * Create a ProgramReader layer.\n *\n * Requires RpcService (connection) and SignerService (wallet) to construct\n * Anchor providers that support `.view()`.\n *\n * @category Layers\n */\nexport const ProgramReaderLive = Layer.effect(\n  ProgramReader,\n  Effect.gen(function* () {\n    const rpcService = yield* RpcService;\n    const signerService = yield* SignerService;\n    const runtime = yield* Effect.runtime();\n\n    const service: ProgramReaderShape = {\n      createProgram: (params) =>\n        Effect.gen(function* () {\n          const { idl, programId } = params;\n\n          const rpc = yield* rpcService.getRpc();\n          const initialWalletAddress = yield* signerService.getAddress();\n          const resolveSimulationFeePayer = async (): Promise<PublicKey> => {\n            // Anchor invokes provider.simulate outside Effect. Use the captured runtime\n            // so logger/tracer configuration remains consistent with this layer.\n            const exit = await Runtime.runPromiseExit(runtime, signerService.getAddress());\n            if (Exit.isSuccess(exit)) {\n              return toPublicKey(exit.value);\n            }\n\n            const failure = Cause.failureOption(exit.cause);\n            if (Option.isSome(failure)) {\n              throw failure.value;\n            }\n\n            throw new SignerSimulationDefectError(Cause.squash(exit.cause));\n          };\n\n          const idlWithAddress = programId ? { ...idl, address: programId as string } : idl;\n\n          return yield* Effect.try({\n            catch: (error) =>\n              new ProgramCreationError({\n                cause: error,\n                message: \"Failed to create Anchor program\",\n              }),\n            try: () =>\n              new Program(\n                idlWithAddress as Idl,\n                {\n                  connection: makeProgramConnectionShim(rpc, \"ProgramReader\"),\n                  // Observed on @coral-xyz/anchor 0.31.x: provider.publicKey is read when\n                  // constructing simulation transactions, and this value is captured at\n                  // Program creation time. We intentionally keep this static and refresh the\n                  // effective fee payer in `simulate` for wallet-switch safety, so the two\n                  // addresses can diverge by design.\n                  publicKey: toPublicKey(initialWalletAddress),\n                  simulate: async (\n                    tx: Transaction | VersionedTransaction,\n                    signers?: readonly AnchorSigner[],\n                    commitment?: string\n                  ): Promise<Omit<SimulatedTransactionResponse, \"err\">> => {\n                    // Resolve the signer lazily on each simulation to avoid stale\n                    // fee payer when a pre-created Program is reused across wallet changes.\n                    const feePayer = await resolveSimulationFeePayer();\n                    const transactionBlockhash =\n                      getTransactionBlockhash(tx) ??\n                      (await rpc.getLatestBlockhash().send()).value.blockhash;\n                    mutateTransactionForSimulation(tx, feePayer, transactionBlockhash, signers);\n\n                    const base64WireTransaction = toBase64WireTransaction(tx);\n                    const normalizedCommitment = normalizeSimulationCommitment(commitment);\n                    const simulation = await rpc\n                      .simulateTransaction(base64WireTransaction, {\n                        ...(normalizedCommitment ? { commitment: normalizedCommitment } : {}),\n                        encoding: \"base64\",\n                      })\n                      .send();\n\n                    if (simulation.value.err) {\n                      throw new Error(\n                        `View simulation failed: ${formatSimulationError(simulation.value.err)}`,\n                        { cause: simulation.value.err }\n                      );\n                    }\n\n                    return toWeb3SimulationResponse(simulation.value);\n                  },\n                } as unknown as Program[\"provider\"]\n              ) as unknown as Program<typeof params.idl>,\n          });\n        }).pipe(\n          Effect.withSpan(SpanNames.PROGRAM_CREATE_FOR_READ, {\n            attributes: {\n              programId: resolveProgramIdAttribute(params.programId, params.idl.address),\n            },\n          })\n        ),\n\n      view: (params) =>\n        Effect.gen(function* () {\n          const { idl, method, args, accounts, programId } = params;\n          const program = yield* service.createProgram({ idl, programId });\n          return yield* service.viewWithProgram(program, { accounts, args, method });\n        }).pipe(\n          Effect.withSpan(SpanNames.PROGRAM_VIEW, {\n            attributes: {\n              method: params.method,\n              programId: resolveProgramIdAttribute(params.programId, params.idl.address),\n            },\n          })\n        ),\n\n      viewWithProgram: (program, params) =>\n        Effect.gen(function* () {\n          const { method } = params;\n          const idlName = getIdlName(program);\n          const withAccounts = yield* resolveViewBuilder(program, params);\n\n          return yield* Effect.tryPromise({\n            catch: (error) => {\n              if (error instanceof SignerSimulationDefectError) {\n                throw error.defect;\n              }\n              if (isWalletNotConnectedError(error)) {\n                return error;\n              }\n              // Anchor currently surfaces this as an untyped Error message (observed on 0.31.x).\n              // Re-validate this guard if Anchor changes .view() failure message semantics.\n              if (\n                error instanceof Error &&\n                error.message.includes(\"Method does not support views\")\n              ) {\n                return makeViewNotSupportedError(method, idlName);\n              }\n              return makeProgramReadError(method, error);\n            },\n            try: () => withAccounts.view(),\n          });\n        }).pipe(\n          Effect.withSpan(SpanNames.PROGRAM_VIEW_WITH_PROGRAM, {\n            attributes: {\n              method: params.method,\n              programId: resolveProgramIdAttribute(undefined, program.idl.address),\n            },\n          })\n        ),\n    };\n\n    return ProgramReader.of(service);\n  })\n);\n"]}

package/dist/program/service.d.ts

@@ -3,7 +3,7 @@ import { Program } from "@coral-xyz/anchor";
 import type { Address } from "@solana/addresses";
 import type { Instruction } from "@solana/instructions";
 import { Context, Effect, Layer } from "effect";
-import { RpcService } from "../rpc/index.js";
+import { RpcService } from "#src/rpc/index.js";
 import type { BuildInstructionParams, CreateProgramParams } from "./types.js";
 import { InstructionBuildError, InstructionNotFoundError, ProgramCreationError } from "./types.js";
 export type ProgramWriterShape = {

package/dist/program/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/program/service.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKxD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,KAAK,EAAe,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAgFnG,MAAM,MAAM,kBAAkB,GAAG;IAO/B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,SAAS,GAAG,EACpC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAerD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC,SAAS,GAAG,EACvC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,MAAM,EAAE,sBAAsB,KAC3B,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,wBAAwB,GAAG,qBAAqB,CAAC,CAAC;IAYlF,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,GAAG,EAC5B,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,KAChB,MAAM,CAAC,MAAM,CAChB,WAAW,EACX,oBAAoB,GAAG,wBAAwB,GAAG,qBAAqB,CACxE,CAAC;CACH,CAAC;;AAOF,qBAAa,aAAc,SAAQ,kBAGhC;CAAG;AAWN,eAAO,MAAM,iBAAiB,+CAqF7B,CAAC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/program/service.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAO/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAuCnG,MAAM,MAAM,kBAAkB,GAAG;IAO/B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,SAAS,GAAG,EACpC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAerD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC,SAAS,GAAG,EACvC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,MAAM,EAAE,sBAAsB,KAC3B,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,wBAAwB,GAAG,qBAAqB,CAAC,CAAC;IAYlF,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,GAAG,EAC5B,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,KAChB,MAAM,CAAC,MAAM,CAChB,WAAW,EACX,oBAAoB,GAAG,wBAAwB,GAAG,qBAAqB,CACxE,CAAC;CACH,CAAC;;AAOF,qBAAa,aAAc,SAAQ,kBAGhC;CAAG;AAWN,eAAO,MAAM,iBAAiB,+CA2F7B,CAAC"}

package/dist/program/service.js

@@ -1,35 +1,10 @@
 import { Program } from "@coral-xyz/anchor";
 import { AccountRole } from "@solana/instructions";
-import { PublicKey } from "@solana/web3.js";
-import BN from "bn.js";
 import { Context, Effect, Layer } from "effect";
-import { RpcService } from "../rpc/index.js";
-import { SpanNames } from "../telemetry/index.js";
+import { RpcService } from "#src/rpc/index.js";
+import { SpanNames } from "#src/telemetry/index.js";
+import { makeProgramConnectionShim, toAnchorAccounts, toAnchorArgs, } from "./internal/anchor-helpers.js";
 import { InstructionBuildError, InstructionNotFoundError, ProgramCreationError } from "./types.js";
-function toPublicKey(address) {
-    return new PublicKey(address);
-}
-function toAnchorAccounts(accounts) {
-    const result = {};
-    for (const [key, value] of Object.entries(accounts)) {
-        result[key] = toPublicKey(value);
-    }
-    return result;
-}
-function toBN(value) {
-    return new BN(value.toString());
-}
-function toAnchorArgs(args) {
-    return args.map((arg) => {
-        if (typeof arg === "bigint") {
-            return toBN(arg);
-        }
-        if (typeof arg === "number" && Number.isInteger(arg)) {
-            return toBN(arg);
-        }
-        return arg;
-    });
-}
 function getAccountRole(isSigner, isWritable) {
     if (isSigner) {
         return isWritable ? AccountRole.WRITABLE_SIGNER : AccountRole.READONLY_SIGNER;
@@ -59,14 +34,22 @@ export const ProgramWriterLive = Layer.effect(ProgramWriter, Effect.gen(function
             const { method, args, accounts } = params;
             const methodFn = program.methods[method];
             if (!methodFn || typeof methodFn !== "function") {
-                return yield* Effect.fail(new InstructionNotFoundError(method, program.idl.metadata?.name ?? "unknown"));
+                return yield* Effect.fail(new InstructionNotFoundError({
+                    idlName: program.idl.metadata?.name ?? "unknown",
+                    message: `Instruction "${method}" not found in IDL "${program.idl.metadata?.name ?? "unknown"}"`,
+                    method,
+                }));
             }
             const anchorArgs = toAnchorArgs(args);
             const anchorAccounts = toAnchorAccounts(accounts);
             const builder = methodFn(...anchorArgs);
             const withAccounts = builder.accountsPartial(anchorAccounts);
             const anchorInstruction = yield* Effect.tryPromise({
-                catch: (error) => new InstructionBuildError(method, error),
+                catch: (error) => new InstructionBuildError({
+                    cause: error,
+                    message: `Failed to build instruction "${method}"`,
+                    method,
+                }),
                 try: () => withAccounts.instruction(),
             });
             return toKitInstruction(anchorInstruction);
@@ -78,14 +61,12 @@ export const ProgramWriterLive = Layer.effect(ProgramWriter, Effect.gen(function
             const rpc = yield* rpcService.getRpc();
             const idlWithAddress = programId ? { ...idl, address: programId } : idl;
             return yield* Effect.try({
-                catch: (error) => new ProgramCreationError(error),
+                catch: (error) => new ProgramCreationError({
+                    cause: error,
+                    message: "Failed to create Anchor program",
+                }),
                 try: () => new Program(idlWithAddress, {
-                    connection: {
-                        getAccountInfo: (pubkey) => rpc
-                            .getAccountInfo(pubkey.toBase58(), { encoding: "base64" })
-                            .send(),
-                        getLatestBlockhash: () => rpc.getLatestBlockhash().send(),
-                    },
+                    connection: makeProgramConnectionShim(rpc, "ProgramWriter"),
                 }),
             });
         }).pipe(Effect.withSpan(SpanNames.PROGRAM_CREATE)),

package/dist/program/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/program/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/program/service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ProgramWriter - Effect-based Anchor program interaction service.\n *\n * Wraps @coral-xyz/anchor Program class for clean, type-safe instruction building.\n * This mirrors how ContractWriter works for EVM ABIs.\n *\n * @module program/service\n */\n\nimport type { Idl } from \"@coral-xyz/anchor\";\nimport { Program } from \"@coral-xyz/anchor\";\nimport type { Address } from \"@solana/addresses\";\nimport type { Instruction } from \"@solana/instructions\";\nimport { AccountRole } from \"@solana/instructions\";\nimport type { TransactionInstruction } from \"@solana/web3.js\";\nimport { Context, Effect, Layer } from \"effect\";\nimport { RpcService } from \"#src/rpc/index.js\";\nimport { SpanNames } from \"#src/telemetry/index.js\";\nimport {\n  makeProgramConnectionShim,\n  toAnchorAccounts,\n  toAnchorArgs,\n} from \"./internal/anchor-helpers.js\";\nimport type { BuildInstructionParams, CreateProgramParams } from \"./types.js\";\nimport { InstructionBuildError, InstructionNotFoundError, ProgramCreationError } from \"./types.js\";\n\n// =============================================================================\n// Helpers\n// =============================================================================\n\n/**\n * Get account role from signer and writable flags.\n */\nfunction getAccountRole(isSigner: boolean, isWritable: boolean): AccountRole {\n  if (isSigner) {\n    return isWritable ? AccountRole.WRITABLE_SIGNER : AccountRole.READONLY_SIGNER;\n  }\n  return isWritable ? AccountRole.WRITABLE : AccountRole.READONLY;\n}\n\n/**\n * Convert Anchor TransactionInstruction to Solana kit Instruction format.\n */\nfunction toKitInstruction(anchorIx: TransactionInstruction): Instruction {\n  return {\n    accounts: anchorIx.keys.map((key) => ({\n      address: key.pubkey.toBase58() as Address,\n      role: getAccountRole(key.isSigner, key.isWritable),\n    })),\n    data: new Uint8Array(anchorIx.data),\n    programAddress: anchorIx.programId.toBase58() as Address,\n  };\n}\n\n// =============================================================================\n// Service Definition\n// =============================================================================\n\n/**\n * Shape of the ProgramWriter for type inference.\n *\n * @category Services\n */\nexport type ProgramWriterShape = {\n  /**\n   * Create an Anchor Program instance from an IDL.\n   *\n   * @param params - Program creation parameters\n   * @returns The Anchor Program instance\n   */\n  readonly createProgram: <T extends Idl>(\n    params: CreateProgramParams<T>\n  ) => Effect.Effect<Program<T>, ProgramCreationError>;\n\n  /**\n   * Build an instruction using Anchor's Program.methods API.\n   *\n   * This is the cleanest way to build instructions - Anchor handles:\n   * - Discriminator generation from method name\n   * - Account ordering from IDL\n   * - Argument serialization\n   * - PDA derivation (for accounts with seeds in IDL)\n   *\n   * @param program - The Anchor Program instance\n   * @param params - Instruction building parameters\n   * @returns The built instruction in Solana kit format\n   */\n  readonly buildInstruction: <T extends Idl>(\n    program: Program<T>,\n    params: BuildInstructionParams\n  ) => Effect.Effect<Instruction, InstructionNotFoundError | InstructionBuildError>;\n\n  /**\n   * Build an instruction directly from IDL (creates program internally).\n   *\n   * Convenience method that combines createProgram + buildInstruction.\n   *\n   * @param idl - The Anchor IDL\n   * @param params - Instruction building parameters\n   * @param programId - Optional program ID override\n   * @returns The built instruction\n   */\n  readonly build: <T extends Idl>(\n    idl: T,\n    params: BuildInstructionParams,\n    programId?: Address\n  ) => Effect.Effect<\n    Instruction,\n    ProgramCreationError | InstructionNotFoundError | InstructionBuildError\n  >;\n};\n\n/**\n * Service tag for program operations (Solana equivalent of ContractWriter).\n *\n * @category Services\n */\nexport class ProgramWriter extends Context.Tag(\"esolana/ProgramWriter\")<\n  ProgramWriter,\n  ProgramWriterShape\n>() {}\n\n// =============================================================================\n// Service Implementation\n// =============================================================================\n\n/**\n * Create a ProgramWriter layer.\n *\n * @category Layers\n */\nexport const ProgramWriterLive = Layer.effect(\n  ProgramWriter,\n  Effect.gen(function* () {\n    const rpcService = yield* RpcService;\n\n    const service: ProgramWriterShape = {\n      build: (idl, params, programId) =>\n        Effect.gen(function* () {\n          const program = yield* service.createProgram({ idl, programId });\n          return yield* service.buildInstruction(program, params);\n        }).pipe(Effect.withSpan(SpanNames.PROGRAM_BUILD)),\n\n      buildInstruction: (program, params) =>\n        Effect.gen(function* () {\n          const { method, args, accounts } = params;\n\n          // Check if method exists\n          const methodFn = (program.methods as Record<string, unknown>)[method];\n          if (!methodFn || typeof methodFn !== \"function\") {\n            return yield* Effect.fail(\n              new InstructionNotFoundError({\n                idlName: program.idl.metadata?.name ?? \"unknown\",\n                message: `Instruction \"${method}\" not found in IDL \"${program.idl.metadata?.name ?? \"unknown\"}\"`,\n                method,\n              })\n            );\n          }\n\n          // Convert args to Anchor format (bigint -> BN)\n          const anchorArgs = toAnchorArgs(args);\n\n          // Convert accounts to PublicKeys\n          const anchorAccounts = toAnchorAccounts(accounts);\n\n          // Build instruction using Anchor's fluent API\n          const builder = (methodFn as (...methodArgs: unknown[]) => unknown)(...anchorArgs);\n          const withAccounts = (\n            builder as { accountsPartial: (a: unknown) => unknown }\n          ).accountsPartial(anchorAccounts);\n\n          const anchorInstruction = yield* Effect.tryPromise({\n            catch: (error) =>\n              new InstructionBuildError({\n                cause: error,\n                message: `Failed to build instruction \"${method}\"`,\n                method,\n              }),\n            try: () =>\n              (\n                withAccounts as { instruction: () => Promise<TransactionInstruction> }\n              ).instruction(),\n          });\n\n          // Convert to Solana kit format\n          return toKitInstruction(anchorInstruction);\n        }).pipe(\n          Effect.withSpan(SpanNames.PROGRAM_BUILD_INSTRUCTION, {\n            attributes: { method: params.method },\n          })\n        ),\n      createProgram: (params) =>\n        Effect.gen(function* () {\n          const { idl, programId } = params;\n\n          // Create a minimal provider for Anchor (it just needs the connection for PDAs)\n          const rpc = yield* rpcService.getRpc();\n\n          // Build IDL with address override if provided\n          const idlWithAddress = programId ? { ...idl, address: programId as string } : idl;\n\n          return yield* Effect.try({\n            catch: (error) =>\n              new ProgramCreationError({\n                cause: error,\n                message: \"Failed to create Anchor program\",\n              }),\n            try: () =>\n              // Create Program with a dummy provider (we're only using it for instruction building)\n              // Anchor requires a provider but we only need the IDL parsing\n              new Program(\n                idlWithAddress as Idl,\n                {\n                  connection: makeProgramConnectionShim(rpc, \"ProgramWriter\"),\n                } as unknown as Program[\"provider\"]\n              ) as unknown as Program<typeof params.idl>,\n          });\n        }).pipe(Effect.withSpan(SpanNames.PROGRAM_CREATE)),\n    };\n\n    return ProgramWriter.of(service);\n  })\n);\n"]}

package/dist/program/types.d.ts

@@ -1,5 +1,6 @@
 import type { Address } from "@solana/addresses";
 import type { Instruction } from "@solana/instructions";
+import { Schema } from "effect";
 export type { Idl, Program } from "@coral-xyz/anchor";
 export type AccountsMap = Record<string, Address | string>;
 export type CreateProgramParams<T extends import("@coral-xyz/anchor").Idl = import("@coral-xyz/anchor").Idl> = {
@@ -14,21 +15,55 @@ export type BuildInstructionParams<TArgs extends readonly unknown[] = readonly u
 export type BuildInstructionResult = {
     readonly instruction: Instruction;
 };
-export declare class InstructionNotFoundError extends Error {
-    readonly _tag = "InstructionNotFoundError";
+export type ViewParams<TArgs extends readonly unknown[] = readonly unknown[]> = {
+    readonly idl: import("@coral-xyz/anchor").Idl;
     readonly method: string;
-    readonly idlName: string;
-    constructor(method: string, idlName: string);
+    readonly args: TArgs;
+    readonly accounts: AccountsMap;
+    readonly programId?: Address;
+};
+declare const InstructionNotFoundError_base: Schema.TaggedErrorClass<InstructionNotFoundError, "InstructionNotFoundError", {
+    readonly _tag: Schema.tag<"InstructionNotFoundError">;
+} & {
+    idlName: typeof Schema.String;
+    message: typeof Schema.String;
+    method: typeof Schema.String;
+}>;
+export declare class InstructionNotFoundError extends InstructionNotFoundError_base {
 }
-export declare class ProgramCreationError extends Error {
-    readonly _tag = "ProgramCreationError";
-    readonly cause: unknown;
-    constructor(cause: unknown, message?: string);
+declare const ProgramCreationError_base: Schema.TaggedErrorClass<ProgramCreationError, "ProgramCreationError", {
+    readonly _tag: Schema.tag<"ProgramCreationError">;
+} & {
+    cause: Schema.optional<typeof Schema.Unknown>;
+    message: typeof Schema.String;
+}>;
+export declare class ProgramCreationError extends ProgramCreationError_base {
 }
-export declare class InstructionBuildError extends Error {
-    readonly _tag = "InstructionBuildError";
-    readonly method: string;
-    readonly cause: unknown;
-    constructor(method: string, cause: unknown);
+declare const InstructionBuildError_base: Schema.TaggedErrorClass<InstructionBuildError, "InstructionBuildError", {
+    readonly _tag: Schema.tag<"InstructionBuildError">;
+} & {
+    cause: Schema.optional<typeof Schema.Unknown>;
+    message: typeof Schema.String;
+    method: typeof Schema.String;
+}>;
+export declare class InstructionBuildError extends InstructionBuildError_base {
+}
+declare const ProgramReadError_base: Schema.TaggedErrorClass<ProgramReadError, "ProgramReadError", {
+    readonly _tag: Schema.tag<"ProgramReadError">;
+} & {
+    cause: Schema.optional<typeof Schema.Unknown>;
+    message: typeof Schema.String;
+    method: typeof Schema.String;
+}>;
+export declare class ProgramReadError extends ProgramReadError_base {
+}
+declare const ViewNotSupportedError_base: Schema.TaggedErrorClass<ViewNotSupportedError, "ViewNotSupportedError", {
+    readonly _tag: Schema.tag<"ViewNotSupportedError">;
+} & {
+    idlName: typeof Schema.String;
+    message: typeof Schema.String;
+    method: typeof Schema.String;
+}>;
+export declare class ViewNotSupportedError extends ViewNotSupportedError_base {
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/program/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/program/types.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMxD,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAUtD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;AAK3D,MAAM,MAAM,mBAAmB,CAC7B,CAAC,SAAS,OAAO,mBAAmB,EAAE,GAAG,GAAG,OAAO,mBAAmB,EAAE,GAAG,IACzE;IAEF,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;IAEhB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAKF,MAAM,MAAM,sBAAsB,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,GAAG,SAAS,OAAO,EAAE,IAAI;IAE1F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAErB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC,CAAC;AAKF,MAAM,MAAM,sBAAsB,GAAG;IAEnC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC,CAAC;AASF,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM5C;AAKD,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,0BAA0B;IACvC,SAAkB,KAAK,EAAE,OAAO,CAAC;gBAErB,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM;CAK7C;AAKD,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,2BAA2B;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,SAAkB,KAAK,EAAE,OAAO,CAAC;gBAErB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAM3C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/program/types.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMhC,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAUtD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;AAK3D,MAAM,MAAM,mBAAmB,CAC7B,CAAC,SAAS,OAAO,mBAAmB,EAAE,GAAG,GAAG,OAAO,mBAAmB,EAAE,GAAG,IACzE;IAEF,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;IAEhB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAKF,MAAM,MAAM,sBAAsB,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,GAAG,SAAS,OAAO,EAAE,IAAI;IAE1F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAErB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC,CAAC;AAKF,MAAM,MAAM,sBAAsB,GAAG;IAEnC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC,CAAC;AASF,MAAM,MAAM,UAAU,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,GAAG,SAAS,OAAO,EAAE,IAAI;IAE9E,QAAQ,CAAC,GAAG,EAAE,OAAO,mBAAmB,EAAE,GAAG,CAAC;IAE9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAErB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAE/B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;;;;;;;;AASF,qBAAa,wBAAyB,SAAQ,6BAO7C;CAAG;;;;;;;AAKJ,qBAAa,oBAAqB,SAAQ,yBAMzC;CAAG;;;;;;;;AAKJ,qBAAa,qBAAsB,SAAQ,0BAO1C;CAAG;;;;;;;;AAKJ,qBAAa,gBAAiB,SAAQ,qBAIpC;CAAG;;;;;;;;AAKL,qBAAa,qBAAsB,SAAQ,0BAO1C;CAAG"}