@macalinao/codama-instruction-accounts-dedupe-visitor/dist/instruction-accounts-dedupe-visitor.d.ts

Codama visitor for deduplicating instruction accounts from Anchor IDL

import type { AnchorIdl } from "@codama/nodes-from-anchor";
import { rootNodeVisitor } from "codama";
/**
 * Creates a Codama visitor that deduplicates and flattens nested instruction accounts from an Anchor IDL.
 *
 * This visitor addresses the issue where Anchor IDLs can have nested account structures (account groups)
 * that need to be flattened into a single level for proper code generation. It preserves the relationships
 * between parent and child accounts through naming conventions.
 *
 * @param idl - The Anchor IDL containing the instruction definitions with potentially nested accounts
 * @returns A root node visitor that transforms all instruction nodes to have flattened account structures
 *
 * @example
 * ```typescript
 * // Given an Anchor IDL with nested accounts:
 * // {
 * //   name: "mintAccounts",
 * //   accounts: [
 * //     { name: "mint", ... },
 * //     { name: "metadata", ... }
 * //   ]
 * // }
 *
 * // The visitor will flatten to:
 * // [
 * //   { name: "mintAccounts_mint", ... },
 * //   { name: "mintAccounts_metadata", ... }
 * // ]
 *
 * const root = rootNodeFromAnchor(idl);
 * const visitor = instructionAccountsDedupeVisitor(idl);
 * const transformedRoot = visit(root, visitor);
 * ```
 *
 * @remarks
 * - Account names are joined with underscores to maintain parent-child relationships
 * - PDA seed paths are automatically updated to match the flattened structure
 * - All account metadata and constraints are preserved during flattening
 * - The visitor operates on instruction nodes using a bottom-up transformer
 */
export declare function instructionAccountsDedupeVisitor(idl: AnchorIdl): ReturnType<typeof rootNodeVisitor>;
//# sourceMappingURL=instruction-accounts-dedupe-visitor.d.ts.map