@macalinao/clients-mpl-bubblegum 0.3.0 → 0.3.2

package/src/generated/instructions/createTree.ts

@@ -6,26 +6,6 @@
  * @see https://github.com/codama-idl/codama
  */
 
-import type {
-  AccountMeta,
-  AccountSignerMeta,
-  Address,
-  Codec,
-  Decoder,
-  Encoder,
-  Instruction,
-  InstructionWithAccounts,
-  InstructionWithData,
-  Option,
-  OptionOrNullable,
-  ReadonlyAccount,
-  ReadonlySignerAccount,
-  ReadonlyUint8Array,
-  TransactionSigner,
-  WritableAccount,
-  WritableSignerAccount,
-} from "@solana/kit";
-import type { ResolvedInstructionAccount } from "@solana/program-client-core";
 import {
   combineCodec,
   fixDecoderSize,
@@ -43,10 +23,28 @@ import {
   SOLANA_ERROR__PROGRAM_CLIENTS__INSUFFICIENT_ACCOUNT_METAS,
   SolanaError,
   transformEncoder,
+  type AccountMeta,
+  type AccountSignerMeta,
+  type Address,
+  type Codec,
+  type Decoder,
+  type Encoder,
+  type Instruction,
+  type InstructionWithAccounts,
+  type InstructionWithData,
+  type Option,
+  type OptionOrNullable,
+  type ReadonlyAccount,
+  type ReadonlySignerAccount,
+  type ReadonlyUint8Array,
+  type TransactionSigner,
+  type WritableAccount,
+  type WritableSignerAccount,
 } from "@solana/kit";
 import {
   getAccountMetaFactory,
   getAddressFromResolvedInstructionAccount,
+  type ResolvedInstructionAccount,
 } from "@solana/program-client-core";
 import { findTreeConfigPda } from "../pdas/index.js";
 import { BUBBLEGUM_PROGRAM_ADDRESS } from "../programs/index.js";
@@ -65,15 +63,12 @@ export type CreateTreeInstruction<
   TAccountMerkleTree extends string | AccountMeta<string> = string,
   TAccountPayer extends string | AccountMeta<string> = string,
   TAccountTreeCreator extends string | AccountMeta<string> = string,
-  TAccountLogWrapper extends
-    | string
-    | AccountMeta<string> = "noopb9bkMVfRPU8AsbpTUg8AQkHtKwMYZiFUjNRtMmV",
-  TAccountCompressionProgram extends
-    | string
-    | AccountMeta<string> = "cmtDvXumGCrqC1Age74AVPhSRVXJMd8PJS91L8KbNCK",
-  TAccountSystemProgram extends
-    | string
-    | AccountMeta<string> = "11111111111111111111111111111111",
+  TAccountLogWrapper extends string | AccountMeta<string> =
+    "noopb9bkMVfRPU8AsbpTUg8AQkHtKwMYZiFUjNRtMmV",
+  TAccountCompressionProgram extends string | AccountMeta<string> =
+    "cmtDvXumGCrqC1Age74AVPhSRVXJMd8PJS91L8KbNCK",
+  TAccountSystemProgram extends string | AccountMeta<string> =
+    "11111111111111111111111111111111",
   TRemainingAccounts extends readonly AccountMeta<string>[] = [],
 > = Instruction<TProgram> &
   InstructionWithData<ReadonlyUint8Array> &
@@ -106,18 +101,42 @@ export type CreateTreeInstruction<
     ]
   >;
 
-export interface CreateTreeInstructionData {
+export type CreateTreeInstructionData = {
   discriminator: ReadonlyUint8Array;
+  /**
+   * Maximum depth of the Merkle tree, i.e. log2 of the maximum number of
+   * leaves it can hold. Fixed for the lifetime of the tree.
+   */
   maxDepth: number;
+  /**
+   * Maximum number of concurrent, unconflicting modifications the tree's
+   * changelog buffer can track. Fixed for the lifetime of the tree.
+   */
   maxBufferSize: number;
+  /**
+   * Optional flag; when `true`, any signer may mint into the tree, not
+   * just the tree delegate. Defaults to `false`.
+   */
   public: Option<boolean>;
-}
+};
 
-export interface CreateTreeInstructionDataArgs {
+export type CreateTreeInstructionDataArgs = {
+  /**
+   * Maximum depth of the Merkle tree, i.e. log2 of the maximum number of
+   * leaves it can hold. Fixed for the lifetime of the tree.
+   */
   maxDepth: number;
+  /**
+   * Maximum number of concurrent, unconflicting modifications the tree's
+   * changelog buffer can track. Fixed for the lifetime of the tree.
+   */
   maxBufferSize: number;
+  /**
+   * Optional flag; when `true`, any signer may mint into the tree, not
+   * just the tree delegate. Defaults to `false`.
+   */
   public: OptionOrNullable<boolean>;
-}
+};
 
 export function getCreateTreeInstructionDataEncoder(): Encoder<CreateTreeInstructionDataArgs> {
   return transformEncoder(
@@ -150,7 +169,7 @@ export function getCreateTreeInstructionDataCodec(): Codec<
   );
 }
 
-export interface CreateTreeAsyncInput<
+export type CreateTreeAsyncInput<
   TAccountTreeAuthority extends string = string,
   TAccountMerkleTree extends string = string,
   TAccountPayer extends string = string,
@@ -158,19 +177,49 @@ export interface CreateTreeAsyncInput<
   TAccountLogWrapper extends string = string,
   TAccountCompressionProgram extends string = string,
   TAccountSystemProgram extends string = string,
-> {
+> = {
+  /**
+   * The tree's `TreeConfig` PDA, which stores its configuration and acts
+   * as the tree's authority for CPIs into the compression program.
+   */
   treeAuthority?: Address<TAccountTreeAuthority>;
+  /**
+   * The concurrent Merkle tree account storing the compressed leaves,
+   * owned by the account compression program.
+   */
   merkleTree: Address<TAccountMerkleTree>;
+  /** Account that pays for the transaction and any account rent. */
   payer: TransactionSigner<TAccountPayer>;
+  /**
+   * Creator of the tree, recorded in `TreeConfig` when the tree was
+   * created.
+   */
   treeCreator: TransactionSigner<TAccountTreeCreator>;
+  /**
+   * The SPL/MPL Noop program, used to log leaf data so off-chain indexers
+   * can reconstruct the tree.
+   */
   logWrapper?: Address<TAccountLogWrapper>;
+  /**
+   * The SPL/MPL Account Compression program that owns and manages the
+   * Merkle tree.
+   */
   compressionProgram?: Address<TAccountCompressionProgram>;
+  /** The Solana System program. */
   systemProgram?: Address<TAccountSystemProgram>;
   maxDepth: CreateTreeInstructionDataArgs["maxDepth"];
   maxBufferSize: CreateTreeInstructionDataArgs["maxBufferSize"];
   public: CreateTreeInstructionDataArgs["public"];
-}
+};
 
+/**
+ * Creates a new empty Merkle tree for storing compressed (V1) NFTs.
+ *
+ * Initializes both the underlying concurrent Merkle tree account and its
+ * `TreeConfig` PDA. `maxDepth` and `maxBufferSize` are fixed for the life
+ * of the tree and bound its maximum leaf capacity and the number of
+ * concurrent modifications it can support.
+ */
 export async function getCreateTreeInstructionAsync<
   TAccountTreeAuthority extends string,
   TAccountMerkleTree extends string,
@@ -276,7 +325,7 @@ export async function getCreateTreeInstructionAsync<
   >);
 }
 
-export interface CreateTreeInput<
+export type CreateTreeInput<
   TAccountTreeAuthority extends string = string,
   TAccountMerkleTree extends string = string,
   TAccountPayer extends string = string,
@@ -284,19 +333,49 @@ export interface CreateTreeInput<
   TAccountLogWrapper extends string = string,
   TAccountCompressionProgram extends string = string,
   TAccountSystemProgram extends string = string,
-> {
+> = {
+  /**
+   * The tree's `TreeConfig` PDA, which stores its configuration and acts
+   * as the tree's authority for CPIs into the compression program.
+   */
   treeAuthority: Address<TAccountTreeAuthority>;
+  /**
+   * The concurrent Merkle tree account storing the compressed leaves,
+   * owned by the account compression program.
+   */
   merkleTree: Address<TAccountMerkleTree>;
+  /** Account that pays for the transaction and any account rent. */
   payer: TransactionSigner<TAccountPayer>;
+  /**
+   * Creator of the tree, recorded in `TreeConfig` when the tree was
+   * created.
+   */
   treeCreator: TransactionSigner<TAccountTreeCreator>;
+  /**
+   * The SPL/MPL Noop program, used to log leaf data so off-chain indexers
+   * can reconstruct the tree.
+   */
   logWrapper?: Address<TAccountLogWrapper>;
+  /**
+   * The SPL/MPL Account Compression program that owns and manages the
+   * Merkle tree.
+   */
   compressionProgram?: Address<TAccountCompressionProgram>;
+  /** The Solana System program. */
   systemProgram?: Address<TAccountSystemProgram>;
   maxDepth: CreateTreeInstructionDataArgs["maxDepth"];
   maxBufferSize: CreateTreeInstructionDataArgs["maxBufferSize"];
   public: CreateTreeInstructionDataArgs["public"];
-}
+};
 
+/**
+ * Creates a new empty Merkle tree for storing compressed (V1) NFTs.
+ *
+ * Initializes both the underlying concurrent Merkle tree account and its
+ * `TreeConfig` PDA. `maxDepth` and `maxBufferSize` are fixed for the life
+ * of the tree and bound its maximum leaf capacity and the number of
+ * concurrent modifications it can support.
+ */
 export function getCreateTreeInstruction<
   TAccountTreeAuthority extends string,
   TAccountMerkleTree extends string,
@@ -392,22 +471,44 @@ export function getCreateTreeInstruction<
   >);
 }
 
-export interface ParsedCreateTreeInstruction<
+export type ParsedCreateTreeInstruction<
   TProgram extends string = typeof BUBBLEGUM_PROGRAM_ADDRESS,
   TAccountMetas extends readonly AccountMeta[] = readonly AccountMeta[],
-> {
+> = {
   programAddress: Address<TProgram>;
   accounts: {
+    /**
+     * The tree's `TreeConfig` PDA, which stores its configuration and acts
+     * as the tree's authority for CPIs into the compression program.
+     */
     treeAuthority: TAccountMetas[0];
+    /**
+     * The concurrent Merkle tree account storing the compressed leaves,
+     * owned by the account compression program.
+     */
     merkleTree: TAccountMetas[1];
+    /** Account that pays for the transaction and any account rent. */
     payer: TAccountMetas[2];
+    /**
+     * Creator of the tree, recorded in `TreeConfig` when the tree was
+     * created.
+     */
     treeCreator: TAccountMetas[3];
+    /**
+     * The SPL/MPL Noop program, used to log leaf data so off-chain indexers
+     * can reconstruct the tree.
+     */
     logWrapper: TAccountMetas[4];
+    /**
+     * The SPL/MPL Account Compression program that owns and manages the
+     * Merkle tree.
+     */
     compressionProgram: TAccountMetas[5];
+    /** The Solana System program. */
     systemProgram: TAccountMetas[6];
   };
   data: CreateTreeInstructionData;
-}
+};
 
 export function parseCreateTreeInstruction<
   TProgram extends string,

package/src/generated/instructions/createTreeV2.ts

@@ -6,26 +6,6 @@
  * @see https://github.com/codama-idl/codama
  */
 
-import type {
-  AccountMeta,
-  AccountSignerMeta,
-  Address,
-  Codec,
-  Decoder,
-  Encoder,
-  Instruction,
-  InstructionWithAccounts,
-  InstructionWithData,
-  Option,
-  OptionOrNullable,
-  ReadonlyAccount,
-  ReadonlySignerAccount,
-  ReadonlyUint8Array,
-  TransactionSigner,
-  WritableAccount,
-  WritableSignerAccount,
-} from "@solana/kit";
-import type { ResolvedInstructionAccount } from "@solana/program-client-core";
 import {
   combineCodec,
   fixDecoderSize,
@@ -43,10 +23,28 @@ import {
   SOLANA_ERROR__PROGRAM_CLIENTS__INSUFFICIENT_ACCOUNT_METAS,
   SolanaError,
   transformEncoder,
+  type AccountMeta,
+  type AccountSignerMeta,
+  type Address,
+  type Codec,
+  type Decoder,
+  type Encoder,
+  type Instruction,
+  type InstructionWithAccounts,
+  type InstructionWithData,
+  type Option,
+  type OptionOrNullable,
+  type ReadonlyAccount,
+  type ReadonlySignerAccount,
+  type ReadonlyUint8Array,
+  type TransactionSigner,
+  type WritableAccount,
+  type WritableSignerAccount,
 } from "@solana/kit";
 import {
   getAccountMetaFactory,
   getAddressFromResolvedInstructionAccount,
+  type ResolvedInstructionAccount,
 } from "@solana/program-client-core";
 import { findTreeConfigPda } from "../pdas/index.js";
 import { BUBBLEGUM_PROGRAM_ADDRESS } from "../programs/index.js";
@@ -67,15 +65,12 @@ export type CreateTreeV2Instruction<
   TAccountMerkleTree extends string | AccountMeta<string> = string,
   TAccountPayer extends string | AccountMeta<string> = string,
   TAccountTreeCreator extends string | AccountMeta<string> = string,
-  TAccountLogWrapper extends
-    | string
-    | AccountMeta<string> = "mnoopTCrg4p8ry25e4bcWA9XZjbNjMTfgYVGGEdRsf3",
-  TAccountCompressionProgram extends
-    | string
-    | AccountMeta<string> = "mcmt6YrQEMKw8Mw43FmpRLmf7BqRnFMKmAcbxE3xkAW",
-  TAccountSystemProgram extends
-    | string
-    | AccountMeta<string> = "11111111111111111111111111111111",
+  TAccountLogWrapper extends string | AccountMeta<string> =
+    "mnoopTCrg4p8ry25e4bcWA9XZjbNjMTfgYVGGEdRsf3",
+  TAccountCompressionProgram extends string | AccountMeta<string> =
+    "mcmt6YrQEMKw8Mw43FmpRLmf7BqRnFMKmAcbxE3xkAW",
+  TAccountSystemProgram extends string | AccountMeta<string> =
+    "11111111111111111111111111111111",
   TRemainingAccounts extends readonly AccountMeta<string>[] = [],
 > = Instruction<TProgram> &
   InstructionWithData<ReadonlyUint8Array> &
@@ -108,18 +103,42 @@ export type CreateTreeV2Instruction<
     ]
   >;
 
-export interface CreateTreeV2InstructionData {
+export type CreateTreeV2InstructionData = {
   discriminator: ReadonlyUint8Array;
+  /**
+   * Maximum depth of the Merkle tree, i.e. log2 of the maximum number of
+   * leaves it can hold. Fixed for the lifetime of the tree.
+   */
   maxDepth: number;
+  /**
+   * Maximum number of concurrent, unconflicting modifications the tree's
+   * changelog buffer can track. Fixed for the lifetime of the tree.
+   */
   maxBufferSize: number;
+  /**
+   * Optional flag; when `true`, any signer may mint into the tree, not
+   * just the tree delegate. Defaults to `false`.
+   */
   public: Option<boolean>;
-}
+};
 
-export interface CreateTreeV2InstructionDataArgs {
+export type CreateTreeV2InstructionDataArgs = {
+  /**
+   * Maximum depth of the Merkle tree, i.e. log2 of the maximum number of
+   * leaves it can hold. Fixed for the lifetime of the tree.
+   */
   maxDepth: number;
+  /**
+   * Maximum number of concurrent, unconflicting modifications the tree's
+   * changelog buffer can track. Fixed for the lifetime of the tree.
+   */
   maxBufferSize: number;
+  /**
+   * Optional flag; when `true`, any signer may mint into the tree, not
+   * just the tree delegate. Defaults to `false`.
+   */
   public: OptionOrNullable<boolean>;
-}
+};
 
 export function getCreateTreeV2InstructionDataEncoder(): Encoder<CreateTreeV2InstructionDataArgs> {
   return transformEncoder(
@@ -152,7 +171,7 @@ export function getCreateTreeV2InstructionDataCodec(): Codec<
   );
 }
 
-export interface CreateTreeV2AsyncInput<
+export type CreateTreeV2AsyncInput<
   TAccountTreeAuthority extends string = string,
   TAccountMerkleTree extends string = string,
   TAccountPayer extends string = string,
@@ -160,20 +179,46 @@ export interface CreateTreeV2AsyncInput<
   TAccountLogWrapper extends string = string,
   TAccountCompressionProgram extends string = string,
   TAccountSystemProgram extends string = string,
-> {
+> = {
+  /**
+   * The tree's `TreeConfig` PDA, which stores its configuration and acts
+   * as the tree's authority for CPIs into the compression program.
+   */
   treeAuthority?: Address<TAccountTreeAuthority>;
+  /**
+   * The concurrent Merkle tree account storing the compressed leaves,
+   * owned by the account compression program.
+   */
   merkleTree: Address<TAccountMerkleTree>;
+  /** Account that pays for the transaction and any account rent. */
   payer: TransactionSigner<TAccountPayer>;
-  /** Optional tree creator, defaults to `payer` */
+  /** Optional tree creator, defaults to `payer`. */
   treeCreator?: TransactionSigner<TAccountTreeCreator>;
+  /**
+   * The SPL/MPL Noop program, used to log leaf data so off-chain indexers
+   * can reconstruct the tree.
+   */
   logWrapper?: Address<TAccountLogWrapper>;
+  /**
+   * The SPL/MPL Account Compression program that owns and manages the
+   * Merkle tree.
+   */
   compressionProgram?: Address<TAccountCompressionProgram>;
+  /** The Solana System program. */
   systemProgram?: Address<TAccountSystemProgram>;
   maxDepth: CreateTreeV2InstructionDataArgs["maxDepth"];
   maxBufferSize: CreateTreeV2InstructionDataArgs["maxBufferSize"];
   public: CreateTreeV2InstructionDataArgs["public"];
-}
+};
 
+/**
+ * Creates a new tree for use with `LeafSchema` V2 leaf nodes.
+ *
+ * Identical in shape to `createTree`, but the resulting tree's leaves
+ * support the V2 functionality (MPL Core collections, freezing,
+ * non-transferable assets, and permanent delegate plugins) enabled by
+ * `mintV2` and the other `*V2` instructions.
+ */
 export async function getCreateTreeV2InstructionAsync<
   TAccountTreeAuthority extends string,
   TAccountMerkleTree extends string,
@@ -279,7 +324,7 @@ export async function getCreateTreeV2InstructionAsync<
   >);
 }
 
-export interface CreateTreeV2Input<
+export type CreateTreeV2Input<
   TAccountTreeAuthority extends string = string,
   TAccountMerkleTree extends string = string,
   TAccountPayer extends string = string,
@@ -287,20 +332,46 @@ export interface CreateTreeV2Input<
   TAccountLogWrapper extends string = string,
   TAccountCompressionProgram extends string = string,
   TAccountSystemProgram extends string = string,
-> {
+> = {
+  /**
+   * The tree's `TreeConfig` PDA, which stores its configuration and acts
+   * as the tree's authority for CPIs into the compression program.
+   */
   treeAuthority: Address<TAccountTreeAuthority>;
+  /**
+   * The concurrent Merkle tree account storing the compressed leaves,
+   * owned by the account compression program.
+   */
   merkleTree: Address<TAccountMerkleTree>;
+  /** Account that pays for the transaction and any account rent. */
   payer: TransactionSigner<TAccountPayer>;
-  /** Optional tree creator, defaults to `payer` */
+  /** Optional tree creator, defaults to `payer`. */
   treeCreator?: TransactionSigner<TAccountTreeCreator>;
+  /**
+   * The SPL/MPL Noop program, used to log leaf data so off-chain indexers
+   * can reconstruct the tree.
+   */
   logWrapper?: Address<TAccountLogWrapper>;
+  /**
+   * The SPL/MPL Account Compression program that owns and manages the
+   * Merkle tree.
+   */
   compressionProgram?: Address<TAccountCompressionProgram>;
+  /** The Solana System program. */
   systemProgram?: Address<TAccountSystemProgram>;
   maxDepth: CreateTreeV2InstructionDataArgs["maxDepth"];
   maxBufferSize: CreateTreeV2InstructionDataArgs["maxBufferSize"];
   public: CreateTreeV2InstructionDataArgs["public"];
-}
+};
 
+/**
+ * Creates a new tree for use with `LeafSchema` V2 leaf nodes.
+ *
+ * Identical in shape to `createTree`, but the resulting tree's leaves
+ * support the V2 functionality (MPL Core collections, freezing,
+ * non-transferable assets, and permanent delegate plugins) enabled by
+ * `mintV2` and the other `*V2` instructions.
+ */
 export function getCreateTreeV2Instruction<
   TAccountTreeAuthority extends string,
   TAccountMerkleTree extends string,
@@ -396,23 +467,41 @@ export function getCreateTreeV2Instruction<
   >);
 }
 
-export interface ParsedCreateTreeV2Instruction<
+export type ParsedCreateTreeV2Instruction<
   TProgram extends string = typeof BUBBLEGUM_PROGRAM_ADDRESS,
   TAccountMetas extends readonly AccountMeta[] = readonly AccountMeta[],
-> {
+> = {
   programAddress: Address<TProgram>;
   accounts: {
+    /**
+     * The tree's `TreeConfig` PDA, which stores its configuration and acts
+     * as the tree's authority for CPIs into the compression program.
+     */
     treeAuthority: TAccountMetas[0];
+    /**
+     * The concurrent Merkle tree account storing the compressed leaves,
+     * owned by the account compression program.
+     */
     merkleTree: TAccountMetas[1];
+    /** Account that pays for the transaction and any account rent. */
     payer: TAccountMetas[2];
-    /** Optional tree creator, defaults to `payer` */
+    /** Optional tree creator, defaults to `payer`. */
     treeCreator?: TAccountMetas[3] | undefined;
+    /**
+     * The SPL/MPL Noop program, used to log leaf data so off-chain indexers
+     * can reconstruct the tree.
+     */
     logWrapper: TAccountMetas[4];
+    /**
+     * The SPL/MPL Account Compression program that owns and manages the
+     * Merkle tree.
+     */
     compressionProgram: TAccountMetas[5];
+    /** The Solana System program. */
     systemProgram: TAccountMetas[6];
   };
   data: CreateTreeV2InstructionData;
-}
+};
 
 export function parseCreateTreeV2Instruction<
   TProgram extends string,