@macalinao/clients-mpl-bubblegum 0.3.0 → 0.3.2

package/src/generated/instructions/setTreeDelegate.ts

@@ -6,23 +6,6 @@
  * @see https://github.com/codama-idl/codama
  */
 
-import type {
-  AccountMeta,
-  AccountSignerMeta,
-  Address,
-  FixedSizeCodec,
-  FixedSizeDecoder,
-  FixedSizeEncoder,
-  Instruction,
-  InstructionWithAccounts,
-  InstructionWithData,
-  ReadonlyAccount,
-  ReadonlySignerAccount,
-  ReadonlyUint8Array,
-  TransactionSigner,
-  WritableAccount,
-} from "@solana/kit";
-import type { ResolvedInstructionAccount } from "@solana/program-client-core";
 import {
   combineCodec,
   fixDecoderSize,
@@ -34,10 +17,25 @@ import {
   SOLANA_ERROR__PROGRAM_CLIENTS__INSUFFICIENT_ACCOUNT_METAS,
   SolanaError,
   transformEncoder,
+  type AccountMeta,
+  type AccountSignerMeta,
+  type Address,
+  type FixedSizeCodec,
+  type FixedSizeDecoder,
+  type FixedSizeEncoder,
+  type Instruction,
+  type InstructionWithAccounts,
+  type InstructionWithData,
+  type ReadonlyAccount,
+  type ReadonlySignerAccount,
+  type ReadonlyUint8Array,
+  type TransactionSigner,
+  type WritableAccount,
 } 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";
@@ -57,9 +55,8 @@ export type SetTreeDelegateInstruction<
   TAccountTreeCreator extends string | AccountMeta<string> = string,
   TAccountNewTreeDelegate extends string | AccountMeta<string> = string,
   TAccountMerkleTree extends string | AccountMeta<string> = string,
-  TAccountSystemProgram extends
-    | string
-    | AccountMeta<string> = "11111111111111111111111111111111",
+  TAccountSystemProgram extends string | AccountMeta<string> =
+    "11111111111111111111111111111111",
   TRemainingAccounts extends readonly AccountMeta<string>[] = [],
 > = Instruction<TProgram> &
   InstructionWithData<ReadonlyUint8Array> &
@@ -85,9 +82,9 @@ export type SetTreeDelegateInstruction<
     ]
   >;
 
-export interface SetTreeDelegateInstructionData {
+export type SetTreeDelegateInstructionData = {
   discriminator: ReadonlyUint8Array;
-}
+};
 
 export type SetTreeDelegateInstructionDataArgs = {};
 
@@ -114,20 +111,41 @@ export function getSetTreeDelegateInstructionDataCodec(): FixedSizeCodec<
   );
 }
 
-export interface SetTreeDelegateAsyncInput<
+export type SetTreeDelegateAsyncInput<
   TAccountTreeAuthority extends string = string,
   TAccountTreeCreator extends string = string,
   TAccountNewTreeDelegate extends string = string,
   TAccountMerkleTree 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>;
+  /**
+   * Creator of the tree, recorded in `TreeConfig` when the tree was
+   * created.
+   */
   treeCreator: TransactionSigner<TAccountTreeCreator>;
+  /** New delegate authority to set for the tree. */
   newTreeDelegate: Address<TAccountNewTreeDelegate>;
+  /**
+   * The concurrent Merkle tree account storing the compressed leaves,
+   * owned by the account compression program.
+   */
   merkleTree: Address<TAccountMerkleTree>;
+  /** The Solana System program. */
   systemProgram?: Address<TAccountSystemProgram>;
-}
+};
 
+/**
+ * Sets a new delegate authority for a tree.
+ *
+ * Only the current tree creator may reassign the tree delegate, which
+ * is authorized to mint into the tree and manage it on the creator's
+ * behalf.
+ */
 export async function getSetTreeDelegateInstructionAsync<
   TAccountTreeAuthority extends string,
   TAccountTreeCreator extends string,
@@ -208,20 +226,41 @@ export async function getSetTreeDelegateInstructionAsync<
   >);
 }
 
-export interface SetTreeDelegateInput<
+export type SetTreeDelegateInput<
   TAccountTreeAuthority extends string = string,
   TAccountTreeCreator extends string = string,
   TAccountNewTreeDelegate extends string = string,
   TAccountMerkleTree 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>;
+  /**
+   * Creator of the tree, recorded in `TreeConfig` when the tree was
+   * created.
+   */
   treeCreator: TransactionSigner<TAccountTreeCreator>;
+  /** New delegate authority to set for the tree. */
   newTreeDelegate: Address<TAccountNewTreeDelegate>;
+  /**
+   * The concurrent Merkle tree account storing the compressed leaves,
+   * owned by the account compression program.
+   */
   merkleTree: Address<TAccountMerkleTree>;
+  /** The Solana System program. */
   systemProgram?: Address<TAccountSystemProgram>;
-}
+};
 
+/**
+ * Sets a new delegate authority for a tree.
+ *
+ * Only the current tree creator may reassign the tree delegate, which
+ * is authorized to mint into the tree and manage it on the creator's
+ * behalf.
+ */
 export function getSetTreeDelegateInstruction<
   TAccountTreeAuthority extends string,
   TAccountTreeCreator extends string,
@@ -292,20 +331,34 @@ export function getSetTreeDelegateInstruction<
   >);
 }
 
-export interface ParsedSetTreeDelegateInstruction<
+export type ParsedSetTreeDelegateInstruction<
   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];
+    /**
+     * Creator of the tree, recorded in `TreeConfig` when the tree was
+     * created.
+     */
     treeCreator: TAccountMetas[1];
+    /** New delegate authority to set for the tree. */
     newTreeDelegate: TAccountMetas[2];
+    /**
+     * The concurrent Merkle tree account storing the compressed leaves,
+     * owned by the account compression program.
+     */
     merkleTree: TAccountMetas[3];
+    /** The Solana System program. */
     systemProgram: TAccountMetas[4];
   };
   data: SetTreeDelegateInstructionData;
-}
+};
 
 export function parseSetTreeDelegateInstruction<
   TProgram extends string,

package/src/generated/instructions/thawAndRevokeV2.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,
@@ -38,19 +18,37 @@ import {
   getOptionEncoder,
   getStructDecoder,
   getStructEncoder,
-  getU8Decoder,
-  getU8Encoder,
   getU32Decoder,
   getU32Encoder,
   getU64Decoder,
   getU64Encoder,
+  getU8Decoder,
+  getU8Encoder,
   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";
@@ -71,15 +69,12 @@ export type ThawAndRevokeV2Instruction<
   TAccountLeafDelegate extends string | AccountMeta<string> = string,
   TAccountLeafOwner extends string | AccountMeta<string> = string,
   TAccountMerkleTree 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> &
@@ -115,28 +110,94 @@ export type ThawAndRevokeV2Instruction<
     ]
   >;
 
-export interface ThawAndRevokeV2InstructionData {
+export type ThawAndRevokeV2InstructionData = {
   discriminator: ReadonlyUint8Array;
-  root: number[];
-  dataHash: number[];
-  creatorHash: number[];
-  collectionHash: Option<number[]>;
-  assetDataHash: Option<number[]>;
+  /**
+   * Current Merkle root of the tree, used together with the Merkle proof
+   * (passed as remaining accounts) to verify the leaf being operated on.
+   */
+  root: Array<number>;
+  /**
+   * Keccak256 hash of the leaf's metadata, used together with `root` to
+   * verify the leaf before it is modified.
+   */
+  dataHash: Array<number>;
+  /**
+   * Keccak256 hash of the leaf's creators array, used together with
+   * `root` to verify the leaf before it is modified.
+   */
+  creatorHash: Array<number>;
+  /**
+   * Expected current `collectionHash` of the `LeafSchema` V2 leaf, if
+   * any, verified before this instruction updates the leaf.
+   */
+  collectionHash: Option<Array<number>>;
+  /**
+   * Expected current `assetDataHash` of the `LeafSchema` V2 leaf, if any,
+   * carried through unchanged by this instruction.
+   */
+  assetDataHash: Option<Array<number>>;
+  /**
+   * Expected current status flags (e.g. frozen, non-transferable) of the
+   * `LeafSchema` V2 leaf, verified before this instruction updates them.
+   */
   flags: Option<number>;
+  /**
+   * Tree-scoped nonce identifying the leaf, equal to the tree's
+   * `numMinted` at the time the leaf was minted. Combined with the tree
+   * address to derive the leaf's asset id.
+   */
   nonce: bigint;
+  /**
+   * Position of the leaf within the Merkle tree, used with the Merkle
+   * proof to locate and verify the leaf.
+   */
   index: number;
-}
+};
 
-export interface ThawAndRevokeV2InstructionDataArgs {
-  root: number[];
-  dataHash: number[];
-  creatorHash: number[];
-  collectionHash: OptionOrNullable<number[]>;
-  assetDataHash: OptionOrNullable<number[]>;
+export type ThawAndRevokeV2InstructionDataArgs = {
+  /**
+   * Current Merkle root of the tree, used together with the Merkle proof
+   * (passed as remaining accounts) to verify the leaf being operated on.
+   */
+  root: Array<number>;
+  /**
+   * Keccak256 hash of the leaf's metadata, used together with `root` to
+   * verify the leaf before it is modified.
+   */
+  dataHash: Array<number>;
+  /**
+   * Keccak256 hash of the leaf's creators array, used together with
+   * `root` to verify the leaf before it is modified.
+   */
+  creatorHash: Array<number>;
+  /**
+   * Expected current `collectionHash` of the `LeafSchema` V2 leaf, if
+   * any, verified before this instruction updates the leaf.
+   */
+  collectionHash: OptionOrNullable<Array<number>>;
+  /**
+   * Expected current `assetDataHash` of the `LeafSchema` V2 leaf, if any,
+   * carried through unchanged by this instruction.
+   */
+  assetDataHash: OptionOrNullable<Array<number>>;
+  /**
+   * Expected current status flags (e.g. frozen, non-transferable) of the
+   * `LeafSchema` V2 leaf, verified before this instruction updates them.
+   */
   flags: OptionOrNullable<number>;
+  /**
+   * Tree-scoped nonce identifying the leaf, equal to the tree's
+   * `numMinted` at the time the leaf was minted. Combined with the tree
+   * address to derive the leaf's asset id.
+   */
   nonce: number | bigint;
+  /**
+   * Position of the leaf within the Merkle tree, used with the Merkle
+   * proof to locate and verify the leaf.
+   */
   index: number;
-}
+};
 
 export function getThawAndRevokeV2InstructionDataEncoder(): Encoder<ThawAndRevokeV2InstructionDataArgs> {
   return transformEncoder(
@@ -191,7 +252,7 @@ export function getThawAndRevokeV2InstructionDataCodec(): Codec<
   );
 }
 
-export interface ThawAndRevokeV2AsyncInput<
+export type ThawAndRevokeV2AsyncInput<
   TAccountTreeAuthority extends string = string,
   TAccountPayer extends string = string,
   TAccountLeafDelegate extends string = string,
@@ -200,15 +261,34 @@ export interface ThawAndRevokeV2AsyncInput<
   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>;
+  /** Account that pays for the transaction and any account rent. */
   payer: TransactionSigner<TAccountPayer>;
-  /** Optional leaf delegate, defaults to `payer` */
+  /** Optional leaf delegate, defaults to `payer`. */
   leafDelegate?: TransactionSigner<TAccountLeafDelegate>;
+  /** Owner of the compressed NFT leaf being operated on. */
   leafOwner: Address<TAccountLeafOwner>;
+  /**
+   * The concurrent Merkle tree account storing the compressed leaves,
+   * owned by the account compression program.
+   */
   merkleTree: Address<TAccountMerkleTree>;
+  /**
+   * 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>;
   root: ThawAndRevokeV2InstructionDataArgs["root"];
   dataHash: ThawAndRevokeV2InstructionDataArgs["dataHash"];
@@ -218,8 +298,13 @@ export interface ThawAndRevokeV2AsyncInput<
   flags: ThawAndRevokeV2InstructionDataArgs["flags"];
   nonce: ThawAndRevokeV2InstructionDataArgs["nonce"];
   index: ThawAndRevokeV2InstructionDataArgs["index"];
-}
+};
 
+/**
+ * Thaws a previously frozen `LeafSchema` V2 leaf node and revokes its
+ * delegate (resetting the delegate back to the leaf owner) in a single
+ * instruction.
+ */
 export async function getThawAndRevokeV2InstructionAsync<
   TAccountTreeAuthority extends string,
   TAccountPayer extends string,
@@ -331,7 +416,7 @@ export async function getThawAndRevokeV2InstructionAsync<
   >);
 }
 
-export interface ThawAndRevokeV2Input<
+export type ThawAndRevokeV2Input<
   TAccountTreeAuthority extends string = string,
   TAccountPayer extends string = string,
   TAccountLeafDelegate extends string = string,
@@ -340,15 +425,34 @@ export interface ThawAndRevokeV2Input<
   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>;
+  /** Account that pays for the transaction and any account rent. */
   payer: TransactionSigner<TAccountPayer>;
-  /** Optional leaf delegate, defaults to `payer` */
+  /** Optional leaf delegate, defaults to `payer`. */
   leafDelegate?: TransactionSigner<TAccountLeafDelegate>;
+  /** Owner of the compressed NFT leaf being operated on. */
   leafOwner: Address<TAccountLeafOwner>;
+  /**
+   * The concurrent Merkle tree account storing the compressed leaves,
+   * owned by the account compression program.
+   */
   merkleTree: Address<TAccountMerkleTree>;
+  /**
+   * 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>;
   root: ThawAndRevokeV2InstructionDataArgs["root"];
   dataHash: ThawAndRevokeV2InstructionDataArgs["dataHash"];
@@ -358,8 +462,13 @@ export interface ThawAndRevokeV2Input<
   flags: ThawAndRevokeV2InstructionDataArgs["flags"];
   nonce: ThawAndRevokeV2InstructionDataArgs["nonce"];
   index: ThawAndRevokeV2InstructionDataArgs["index"];
-}
+};
 
+/**
+ * Thaws a previously frozen `LeafSchema` V2 leaf node and revokes its
+ * delegate (resetting the delegate back to the leaf owner) in a single
+ * instruction.
+ */
 export function getThawAndRevokeV2Instruction<
   TAccountTreeAuthority extends string,
   TAccountPayer extends string,
@@ -461,24 +570,43 @@ export function getThawAndRevokeV2Instruction<
   >);
 }
 
-export interface ParsedThawAndRevokeV2Instruction<
+export type ParsedThawAndRevokeV2Instruction<
   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];
+    /** Account that pays for the transaction and any account rent. */
     payer: TAccountMetas[1];
-    /** Optional leaf delegate, defaults to `payer` */
+    /** Optional leaf delegate, defaults to `payer`. */
     leafDelegate?: TAccountMetas[2] | undefined;
+    /** Owner of the compressed NFT leaf being operated on. */
     leafOwner: TAccountMetas[3];
+    /**
+     * The concurrent Merkle tree account storing the compressed leaves,
+     * owned by the account compression program.
+     */
     merkleTree: TAccountMetas[4];
+    /**
+     * The SPL/MPL Noop program, used to log leaf data so off-chain indexers
+     * can reconstruct the tree.
+     */
     logWrapper: TAccountMetas[5];
+    /**
+     * The SPL/MPL Account Compression program that owns and manages the
+     * Merkle tree.
+     */
     compressionProgram: TAccountMetas[6];
+    /** The Solana System program. */
     systemProgram: TAccountMetas[7];
   };
   data: ThawAndRevokeV2InstructionData;
-}
+};
 
 export function parseThawAndRevokeV2Instruction<
   TProgram extends string,