/**
 * This code was AUTOGENERATED using the Codama library.
 * Please DO NOT EDIT THIS FILE, instead use visitors
 * to add features, then rerun Codama to update it.
 *
 * @see https://github.com/codama-idl/codama
 */

import {
  AccountRole,
  combineCodec,
  fixDecoderSize,
  fixEncoderSize,
  getAddressEncoder,
  getArrayDecoder,
  getArrayEncoder,
  getBytesDecoder,
  getBytesEncoder,
  getI32Decoder,
  getI32Encoder,
  getProgramDerivedAddress,
  getStructDecoder,
  getStructEncoder,
  getTupleDecoder,
  getTupleEncoder,
  getU16Decoder,
  getU16Encoder,
  getU32Decoder,
  getU32Encoder,
  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 ReadonlyAccount,
  type ReadonlySignerAccount,
  type ReadonlyUint8Array,
  type TransactionSigner,
  type WritableAccount,
} from '@solana/kit';
import {
  getAccountMetaFactory,
  getAddressFromResolvedInstructionAccount,
  type ResolvedInstructionAccount,
} from '@solana/program-client-core';
import { SAGE_PROGRAM_ADDRESS } from '../programs';
import {
  getBuildingIdDecoder,
  getBuildingIdEncoder,
  type BuildingId,
  type BuildingIdArgs,
} from '../types';

export const PLACE_CLAIM_STAKE_BUILDINGS_DISCRIMINATOR = new Uint8Array([
  8, 184, 146, 6, 121, 33, 138, 67,
]);

export function getPlaceClaimStakeBuildingsDiscriminatorBytes() {
  return fixEncoderSize(getBytesEncoder(), 8).encode(
    PLACE_CLAIM_STAKE_BUILDINGS_DISCRIMINATOR,
  );
}

export type PlaceClaimStakeBuildingsInstruction<
  TProgram extends string = typeof SAGE_PROGRAM_ADDRESS,
  TAccountGame extends string | AccountMeta<string> = string,
  TAccountProfileValidationSigner extends string | AccountMeta<string> = string,
  TAccountProfileValidationProfile extends string | AccountMeta<string> =
    string,
  TAccountProfileValidationCertificate extends string | AccountMeta<string> =
    string,
  TAccountProfileValidationProgram extends string | AccountMeta<string> =
    'C4PRoFNroxxzdgeCoM31LJjYRg7kT6ymogSTAT99iD1u',
  TAccountProfileFaction extends string | AccountMeta<string> = string,
  TAccountClaimStakeInstance extends string | AccountMeta<string> = string,
  TAccountSystem extends string | AccountMeta<string> = string,
  TAccountStarbasePlayer extends string | AccountMeta<string> = string,
  TAccountCelestialBody extends string | AccountMeta<string> = string,
  TAccountCurrencyCache extends string | AccountMeta<string> = string,
  TAccountFactionOwnership extends string | AccountMeta<string> = string,
  TAccountSystemProgram extends string | AccountMeta<string> =
    '11111111111111111111111111111111',
  TAccountXpAccrual extends string | AccountMeta<string> = string,
  TAccountRentCatalog extends string | AccountMeta<string> = string,
  TAccountRentAuthority extends string | AccountMeta<string> = string,
  TAccountRentGridHead extends string | AccountMeta<string> = string,
  TAccountRentLevelHead extends string | AccountMeta<string> = string,
  TAccountRentDefHead extends string | AccountMeta<string> = string,
  TRemainingAccounts extends readonly AccountMeta<string>[] = [],
> = Instruction<TProgram> &
  InstructionWithData<ReadonlyUint8Array> &
  InstructionWithAccounts<
    [
      TAccountGame extends string
        ? ReadonlyAccount<TAccountGame>
        : TAccountGame,
      TAccountProfileValidationSigner extends string
        ? ReadonlySignerAccount<TAccountProfileValidationSigner> &
            AccountSignerMeta<TAccountProfileValidationSigner>
        : TAccountProfileValidationSigner,
      TAccountProfileValidationProfile extends string
        ? WritableAccount<TAccountProfileValidationProfile>
        : TAccountProfileValidationProfile,
      TAccountProfileValidationCertificate extends string
        ? ReadonlyAccount<TAccountProfileValidationCertificate>
        : TAccountProfileValidationCertificate,
      TAccountProfileValidationProgram extends string
        ? ReadonlyAccount<TAccountProfileValidationProgram>
        : TAccountProfileValidationProgram,
      TAccountProfileFaction extends string
        ? ReadonlyAccount<TAccountProfileFaction>
        : TAccountProfileFaction,
      TAccountClaimStakeInstance extends string
        ? WritableAccount<TAccountClaimStakeInstance>
        : TAccountClaimStakeInstance,
      TAccountSystem extends string
        ? ReadonlyAccount<TAccountSystem>
        : TAccountSystem,
      TAccountStarbasePlayer extends string
        ? WritableAccount<TAccountStarbasePlayer>
        : TAccountStarbasePlayer,
      TAccountCelestialBody extends string
        ? WritableAccount<TAccountCelestialBody>
        : TAccountCelestialBody,
      TAccountCurrencyCache extends string
        ? WritableAccount<TAccountCurrencyCache>
        : TAccountCurrencyCache,
      TAccountFactionOwnership extends string
        ? ReadonlyAccount<TAccountFactionOwnership>
        : TAccountFactionOwnership,
      TAccountSystemProgram extends string
        ? ReadonlyAccount<TAccountSystemProgram>
        : TAccountSystemProgram,
      TAccountXpAccrual extends string
        ? WritableAccount<TAccountXpAccrual>
        : TAccountXpAccrual,
      TAccountRentCatalog extends string
        ? ReadonlyAccount<TAccountRentCatalog>
        : TAccountRentCatalog,
      TAccountRentAuthority extends string
        ? WritableAccount<TAccountRentAuthority>
        : TAccountRentAuthority,
      TAccountRentGridHead extends string
        ? ReadonlyAccount<TAccountRentGridHead>
        : TAccountRentGridHead,
      TAccountRentLevelHead extends string
        ? ReadonlyAccount<TAccountRentLevelHead>
        : TAccountRentLevelHead,
      TAccountRentDefHead extends string
        ? ReadonlyAccount<TAccountRentDefHead>
        : TAccountRentDefHead,
      ...TRemainingAccounts,
    ]
  >;

export type PlaceClaimStakeBuildingsInstructionData = {
  discriminator: ReadonlyUint8Array;
  /** The index of the key in the player profile */
  keyIndex: number;
  /** The sequence id of the claim stake instance */
  sequenceId: number;
  /** A list of tuples of the building id and the number of buildings to place */
  buildingChanges: Array<readonly [BuildingId, number]>;
  /**
   * Rent Option B: the GRID / LEVEL / DEF baseline-record indices at `max(paid_clock, activation_time)`
   * (read only under an Active catalog).
   */
  rentHints: Array<number>;
};

export type PlaceClaimStakeBuildingsInstructionDataArgs = {
  /** The index of the key in the player profile */
  keyIndex: number;
  /** The sequence id of the claim stake instance */
  sequenceId: number;
  /** A list of tuples of the building id and the number of buildings to place */
  buildingChanges: Array<readonly [BuildingIdArgs, number]>;
  /**
   * Rent Option B: the GRID / LEVEL / DEF baseline-record indices at `max(paid_clock, activation_time)`
   * (read only under an Active catalog).
   */
  rentHints: Array<number>;
};

export function getPlaceClaimStakeBuildingsInstructionDataEncoder(): Encoder<PlaceClaimStakeBuildingsInstructionDataArgs> {
  return transformEncoder(
    getStructEncoder([
      ['discriminator', fixEncoderSize(getBytesEncoder(), 8)],
      ['keyIndex', getU16Encoder()],
      ['sequenceId', getU16Encoder()],
      [
        'buildingChanges',
        getArrayEncoder(
          getTupleEncoder([getBuildingIdEncoder(), getI32Encoder()]),
        ),
      ],
      ['rentHints', getArrayEncoder(getU32Encoder(), { size: 3 })],
    ]),
    (value) => ({
      ...value,
      discriminator: PLACE_CLAIM_STAKE_BUILDINGS_DISCRIMINATOR,
    }),
  );
}

export function getPlaceClaimStakeBuildingsInstructionDataDecoder(): Decoder<PlaceClaimStakeBuildingsInstructionData> {
  return getStructDecoder([
    ['discriminator', fixDecoderSize(getBytesDecoder(), 8)],
    ['keyIndex', getU16Decoder()],
    ['sequenceId', getU16Decoder()],
    [
      'buildingChanges',
      getArrayDecoder(
        getTupleDecoder([getBuildingIdDecoder(), getI32Decoder()]),
      ),
    ],
    ['rentHints', getArrayDecoder(getU32Decoder(), { size: 3 })],
  ]);
}

export function getPlaceClaimStakeBuildingsInstructionDataCodec(): Codec<
  PlaceClaimStakeBuildingsInstructionDataArgs,
  PlaceClaimStakeBuildingsInstructionData
> {
  return combineCodec(
    getPlaceClaimStakeBuildingsInstructionDataEncoder(),
    getPlaceClaimStakeBuildingsInstructionDataDecoder(),
  );
}

export type PlaceClaimStakeBuildingsAsyncInput<
  TAccountGame extends string = string,
  TAccountProfileValidationSigner extends string = string,
  TAccountProfileValidationProfile extends string = string,
  TAccountProfileValidationCertificate extends string = string,
  TAccountProfileValidationProgram extends string = string,
  TAccountProfileFaction extends string = string,
  TAccountClaimStakeInstance extends string = string,
  TAccountSystem extends string = string,
  TAccountStarbasePlayer extends string = string,
  TAccountCelestialBody extends string = string,
  TAccountCurrencyCache extends string = string,
  TAccountFactionOwnership extends string = string,
  TAccountSystemProgram extends string = string,
  TAccountXpAccrual extends string = string,
  TAccountRentCatalog extends string = string,
  TAccountRentAuthority extends string = string,
  TAccountRentGridHead extends string = string,
  TAccountRentLevelHead extends string = string,
  TAccountRentDefHead extends string = string,
> = {
  /** The game account */
  game: Address<TAccountGame>;
  profileValidationSigner: TransactionSigner<TAccountProfileValidationSigner>;
  profileValidationProfile: Address<TAccountProfileValidationProfile>;
  profileValidationCertificate?: Address<TAccountProfileValidationCertificate>;
  profileValidationProgram?: Address<TAccountProfileValidationProgram>;
  /** The profile faction account associated with the player profile */
  profileFaction: Address<TAccountProfileFaction>;
  /** The claim stake instance to modify the buildings of */
  claimStakeInstance: Address<TAccountClaimStakeInstance>;
  /** The [`StarSystem`] account */
  system: Address<TAccountSystem>;
  /** The [`crate::state::StarbasePlayer`] Account */
  starbasePlayer: Address<TAccountStarbasePlayer>;
  /** The CelestialBody account containing the claim stake */
  celestialBody: Address<TAccountCelestialBody>;
  /** The currency config cache account */
  currencyCache?: Address<TAccountCurrencyCache>;
  /**
   * P5 Bridge #2 (REQUIRED, fail-closed): the starbase's `FactionOwnership(STARBASE)` sidecar. A REQUIRED,
   * PDA-bound account that MAY be uninitialized — so the displaced legacy owner can no longer keep placing
   * buildings on a captured starbase by OMITTING it (this is a control/mutation gate, so omission is worse
   * here than at the dock). When initialized, the owner gate resolves via the dynamic controller
   * (witness-checked); uninitialized PDA ⇒ legacy gate (byte-identical to pre-P5). See
   * `resolve_starbase_controller_fail_closed`.
   */
  factionOwnership: Address<TAccountFactionOwnership>;
  /** The Solana System program */
  systemProgram?: Address<TAccountSystemProgram>;
  /**
   * Building XP ledger (spec §5): REQUIRED by `Game.version == v1` (fail closed) and
   * rejected on legacy games. Appended after every pre-existing account so legacy
   * transactions keep their positional prefix.
   */
  xpAccrual?: Address<TAccountXpAccrual>;
  /** The game's rent-catalog PDA (REQUIRED; never created = Disabled). */
  rentCatalog: Address<TAccountRentCatalog>;
  /** The stake's settlement-authority PDA (REQUIRED; never created = never evaluated). */
  rentAuthority: Address<TAccountRentAuthority>;
  /** The stake's GRID source head (required iff the catalog is Active). */
  rentGridHead?: Address<TAccountRentGridHead>;
  /** The stake's system LEVEL source head (required iff the catalog is Active). */
  rentLevelHead?: Address<TAccountRentLevelHead>;
  /** The stake's definition DEF source head (required iff the catalog is Active). */
  rentDefHead?: Address<TAccountRentDefHead>;
  keyIndex: PlaceClaimStakeBuildingsInstructionDataArgs['keyIndex'];
  sequenceId: PlaceClaimStakeBuildingsInstructionDataArgs['sequenceId'];
  buildingChanges: PlaceClaimStakeBuildingsInstructionDataArgs['buildingChanges'];
  rentHints: PlaceClaimStakeBuildingsInstructionDataArgs['rentHints'];
  rentPages: Array<Address>;
};

export async function getPlaceClaimStakeBuildingsInstructionAsync<
  TAccountGame extends string,
  TAccountProfileValidationSigner extends string,
  TAccountProfileValidationProfile extends string,
  TAccountProfileValidationCertificate extends string,
  TAccountProfileValidationProgram extends string,
  TAccountProfileFaction extends string,
  TAccountClaimStakeInstance extends string,
  TAccountSystem extends string,
  TAccountStarbasePlayer extends string,
  TAccountCelestialBody extends string,
  TAccountCurrencyCache extends string,
  TAccountFactionOwnership extends string,
  TAccountSystemProgram extends string,
  TAccountXpAccrual extends string,
  TAccountRentCatalog extends string,
  TAccountRentAuthority extends string,
  TAccountRentGridHead extends string,
  TAccountRentLevelHead extends string,
  TAccountRentDefHead extends string,
  TProgramAddress extends Address = typeof SAGE_PROGRAM_ADDRESS,
>(
  input: PlaceClaimStakeBuildingsAsyncInput<
    TAccountGame,
    TAccountProfileValidationSigner,
    TAccountProfileValidationProfile,
    TAccountProfileValidationCertificate,
    TAccountProfileValidationProgram,
    TAccountProfileFaction,
    TAccountClaimStakeInstance,
    TAccountSystem,
    TAccountStarbasePlayer,
    TAccountCelestialBody,
    TAccountCurrencyCache,
    TAccountFactionOwnership,
    TAccountSystemProgram,
    TAccountXpAccrual,
    TAccountRentCatalog,
    TAccountRentAuthority,
    TAccountRentGridHead,
    TAccountRentLevelHead,
    TAccountRentDefHead
  >,
  config?: { programAddress?: TProgramAddress },
): Promise<
  PlaceClaimStakeBuildingsInstruction<
    TProgramAddress,
    TAccountGame,
    TAccountProfileValidationSigner,
    TAccountProfileValidationProfile,
    TAccountProfileValidationCertificate,
    TAccountProfileValidationProgram,
    TAccountProfileFaction,
    TAccountClaimStakeInstance,
    TAccountSystem,
    TAccountStarbasePlayer,
    TAccountCelestialBody,
    TAccountCurrencyCache,
    TAccountFactionOwnership,
    TAccountSystemProgram,
    TAccountXpAccrual,
    TAccountRentCatalog,
    TAccountRentAuthority,
    TAccountRentGridHead,
    TAccountRentLevelHead,
    TAccountRentDefHead
  >
> {
  // Program address.
  const programAddress = config?.programAddress ?? SAGE_PROGRAM_ADDRESS;

  // Original accounts.
  const originalAccounts = {
    game: { value: input.game ?? null, isWritable: false },
    profileValidationSigner: {
      value: input.profileValidationSigner ?? null,
      isWritable: false,
    },
    profileValidationProfile: {
      value: input.profileValidationProfile ?? null,
      isWritable: true,
    },
    profileValidationCertificate: {
      value: input.profileValidationCertificate ?? null,
      isWritable: false,
    },
    profileValidationProgram: {
      value: input.profileValidationProgram ?? null,
      isWritable: false,
    },
    profileFaction: { value: input.profileFaction ?? null, isWritable: false },
    claimStakeInstance: {
      value: input.claimStakeInstance ?? null,
      isWritable: true,
    },
    system: { value: input.system ?? null, isWritable: false },
    starbasePlayer: { value: input.starbasePlayer ?? null, isWritable: true },
    celestialBody: { value: input.celestialBody ?? null, isWritable: true },
    currencyCache: { value: input.currencyCache ?? null, isWritable: true },
    factionOwnership: {
      value: input.factionOwnership ?? null,
      isWritable: false,
    },
    systemProgram: { value: input.systemProgram ?? null, isWritable: false },
    xpAccrual: { value: input.xpAccrual ?? null, isWritable: true },
    rentCatalog: { value: input.rentCatalog ?? null, isWritable: false },
    rentAuthority: { value: input.rentAuthority ?? null, isWritable: true },
    rentGridHead: { value: input.rentGridHead ?? null, isWritable: false },
    rentLevelHead: { value: input.rentLevelHead ?? null, isWritable: false },
    rentDefHead: { value: input.rentDefHead ?? null, isWritable: false },
  };
  const accounts = originalAccounts as Record<
    keyof typeof originalAccounts,
    ResolvedInstructionAccount
  >;

  // Original args.
  const args = { ...input };

  // Resolve default values.
  if (!accounts.profileValidationProgram.value) {
    accounts.profileValidationProgram.value =
      'C4PRoFNroxxzdgeCoM31LJjYRg7kT6ymogSTAT99iD1u' as Address<'C4PRoFNroxxzdgeCoM31LJjYRg7kT6ymogSTAT99iD1u'>;
  }
  if (!accounts.currencyCache.value) {
    accounts.currencyCache.value = await getProgramDerivedAddress({
      programAddress,
      seeds: [
        getBytesEncoder().encode(
          new Uint8Array([
            67, 117, 114, 114, 101, 110, 99, 121, 67, 111, 110, 102, 105, 103,
          ]),
        ),
        getAddressEncoder().encode(
          getAddressFromResolvedInstructionAccount('game', accounts.game.value),
        ),
      ],
    });
  }
  if (!accounts.systemProgram.value) {
    accounts.systemProgram.value =
      '11111111111111111111111111111111' as Address<'11111111111111111111111111111111'>;
  }

  // Remaining accounts.
  const remainingAccounts: AccountMeta[] = args.rentPages.map((address) => ({
    address,
    role: AccountRole.READONLY,
  }));

  const getAccountMeta = getAccountMetaFactory(programAddress, 'programId');
  return Object.freeze({
    accounts: [
      getAccountMeta('game', accounts.game),
      getAccountMeta(
        'profileValidationSigner',
        accounts.profileValidationSigner,
      ),
      getAccountMeta(
        'profileValidationProfile',
        accounts.profileValidationProfile,
      ),
      getAccountMeta(
        'profileValidationCertificate',
        accounts.profileValidationCertificate,
      ),
      getAccountMeta(
        'profileValidationProgram',
        accounts.profileValidationProgram,
      ),
      getAccountMeta('profileFaction', accounts.profileFaction),
      getAccountMeta('claimStakeInstance', accounts.claimStakeInstance),
      getAccountMeta('system', accounts.system),
      getAccountMeta('starbasePlayer', accounts.starbasePlayer),
      getAccountMeta('celestialBody', accounts.celestialBody),
      getAccountMeta('currencyCache', accounts.currencyCache),
      getAccountMeta('factionOwnership', accounts.factionOwnership),
      getAccountMeta('systemProgram', accounts.systemProgram),
      getAccountMeta('xpAccrual', accounts.xpAccrual),
      getAccountMeta('rentCatalog', accounts.rentCatalog),
      getAccountMeta('rentAuthority', accounts.rentAuthority),
      getAccountMeta('rentGridHead', accounts.rentGridHead),
      getAccountMeta('rentLevelHead', accounts.rentLevelHead),
      getAccountMeta('rentDefHead', accounts.rentDefHead),
      ...remainingAccounts,
    ],
    data: getPlaceClaimStakeBuildingsInstructionDataEncoder().encode(
      args as PlaceClaimStakeBuildingsInstructionDataArgs,
    ),
    programAddress,
  } as PlaceClaimStakeBuildingsInstruction<
    TProgramAddress,
    TAccountGame,
    TAccountProfileValidationSigner,
    TAccountProfileValidationProfile,
    TAccountProfileValidationCertificate,
    TAccountProfileValidationProgram,
    TAccountProfileFaction,
    TAccountClaimStakeInstance,
    TAccountSystem,
    TAccountStarbasePlayer,
    TAccountCelestialBody,
    TAccountCurrencyCache,
    TAccountFactionOwnership,
    TAccountSystemProgram,
    TAccountXpAccrual,
    TAccountRentCatalog,
    TAccountRentAuthority,
    TAccountRentGridHead,
    TAccountRentLevelHead,
    TAccountRentDefHead
  >);
}

export type PlaceClaimStakeBuildingsInput<
  TAccountGame extends string = string,
  TAccountProfileValidationSigner extends string = string,
  TAccountProfileValidationProfile extends string = string,
  TAccountProfileValidationCertificate extends string = string,
  TAccountProfileValidationProgram extends string = string,
  TAccountProfileFaction extends string = string,
  TAccountClaimStakeInstance extends string = string,
  TAccountSystem extends string = string,
  TAccountStarbasePlayer extends string = string,
  TAccountCelestialBody extends string = string,
  TAccountCurrencyCache extends string = string,
  TAccountFactionOwnership extends string = string,
  TAccountSystemProgram extends string = string,
  TAccountXpAccrual extends string = string,
  TAccountRentCatalog extends string = string,
  TAccountRentAuthority extends string = string,
  TAccountRentGridHead extends string = string,
  TAccountRentLevelHead extends string = string,
  TAccountRentDefHead extends string = string,
> = {
  /** The game account */
  game: Address<TAccountGame>;
  profileValidationSigner: TransactionSigner<TAccountProfileValidationSigner>;
  profileValidationProfile: Address<TAccountProfileValidationProfile>;
  profileValidationCertificate?: Address<TAccountProfileValidationCertificate>;
  profileValidationProgram?: Address<TAccountProfileValidationProgram>;
  /** The profile faction account associated with the player profile */
  profileFaction: Address<TAccountProfileFaction>;
  /** The claim stake instance to modify the buildings of */
  claimStakeInstance: Address<TAccountClaimStakeInstance>;
  /** The [`StarSystem`] account */
  system: Address<TAccountSystem>;
  /** The [`crate::state::StarbasePlayer`] Account */
  starbasePlayer: Address<TAccountStarbasePlayer>;
  /** The CelestialBody account containing the claim stake */
  celestialBody: Address<TAccountCelestialBody>;
  /** The currency config cache account */
  currencyCache: Address<TAccountCurrencyCache>;
  /**
   * P5 Bridge #2 (REQUIRED, fail-closed): the starbase's `FactionOwnership(STARBASE)` sidecar. A REQUIRED,
   * PDA-bound account that MAY be uninitialized — so the displaced legacy owner can no longer keep placing
   * buildings on a captured starbase by OMITTING it (this is a control/mutation gate, so omission is worse
   * here than at the dock). When initialized, the owner gate resolves via the dynamic controller
   * (witness-checked); uninitialized PDA ⇒ legacy gate (byte-identical to pre-P5). See
   * `resolve_starbase_controller_fail_closed`.
   */
  factionOwnership: Address<TAccountFactionOwnership>;
  /** The Solana System program */
  systemProgram?: Address<TAccountSystemProgram>;
  /**
   * Building XP ledger (spec §5): REQUIRED by `Game.version == v1` (fail closed) and
   * rejected on legacy games. Appended after every pre-existing account so legacy
   * transactions keep their positional prefix.
   */
  xpAccrual?: Address<TAccountXpAccrual>;
  /** The game's rent-catalog PDA (REQUIRED; never created = Disabled). */
  rentCatalog: Address<TAccountRentCatalog>;
  /** The stake's settlement-authority PDA (REQUIRED; never created = never evaluated). */
  rentAuthority: Address<TAccountRentAuthority>;
  /** The stake's GRID source head (required iff the catalog is Active). */
  rentGridHead?: Address<TAccountRentGridHead>;
  /** The stake's system LEVEL source head (required iff the catalog is Active). */
  rentLevelHead?: Address<TAccountRentLevelHead>;
  /** The stake's definition DEF source head (required iff the catalog is Active). */
  rentDefHead?: Address<TAccountRentDefHead>;
  keyIndex: PlaceClaimStakeBuildingsInstructionDataArgs['keyIndex'];
  sequenceId: PlaceClaimStakeBuildingsInstructionDataArgs['sequenceId'];
  buildingChanges: PlaceClaimStakeBuildingsInstructionDataArgs['buildingChanges'];
  rentHints: PlaceClaimStakeBuildingsInstructionDataArgs['rentHints'];
  rentPages: Array<Address>;
};

export function getPlaceClaimStakeBuildingsInstruction<
  TAccountGame extends string,
  TAccountProfileValidationSigner extends string,
  TAccountProfileValidationProfile extends string,
  TAccountProfileValidationCertificate extends string,
  TAccountProfileValidationProgram extends string,
  TAccountProfileFaction extends string,
  TAccountClaimStakeInstance extends string,
  TAccountSystem extends string,
  TAccountStarbasePlayer extends string,
  TAccountCelestialBody extends string,
  TAccountCurrencyCache extends string,
  TAccountFactionOwnership extends string,
  TAccountSystemProgram extends string,
  TAccountXpAccrual extends string,
  TAccountRentCatalog extends string,
  TAccountRentAuthority extends string,
  TAccountRentGridHead extends string,
  TAccountRentLevelHead extends string,
  TAccountRentDefHead extends string,
  TProgramAddress extends Address = typeof SAGE_PROGRAM_ADDRESS,
>(
  input: PlaceClaimStakeBuildingsInput<
    TAccountGame,
    TAccountProfileValidationSigner,
    TAccountProfileValidationProfile,
    TAccountProfileValidationCertificate,
    TAccountProfileValidationProgram,
    TAccountProfileFaction,
    TAccountClaimStakeInstance,
    TAccountSystem,
    TAccountStarbasePlayer,
    TAccountCelestialBody,
    TAccountCurrencyCache,
    TAccountFactionOwnership,
    TAccountSystemProgram,
    TAccountXpAccrual,
    TAccountRentCatalog,
    TAccountRentAuthority,
    TAccountRentGridHead,
    TAccountRentLevelHead,
    TAccountRentDefHead
  >,
  config?: { programAddress?: TProgramAddress },
): PlaceClaimStakeBuildingsInstruction<
  TProgramAddress,
  TAccountGame,
  TAccountProfileValidationSigner,
  TAccountProfileValidationProfile,
  TAccountProfileValidationCertificate,
  TAccountProfileValidationProgram,
  TAccountProfileFaction,
  TAccountClaimStakeInstance,
  TAccountSystem,
  TAccountStarbasePlayer,
  TAccountCelestialBody,
  TAccountCurrencyCache,
  TAccountFactionOwnership,
  TAccountSystemProgram,
  TAccountXpAccrual,
  TAccountRentCatalog,
  TAccountRentAuthority,
  TAccountRentGridHead,
  TAccountRentLevelHead,
  TAccountRentDefHead
> {
  // Program address.
  const programAddress = config?.programAddress ?? SAGE_PROGRAM_ADDRESS;

  // Original accounts.
  const originalAccounts = {
    game: { value: input.game ?? null, isWritable: false },
    profileValidationSigner: {
      value: input.profileValidationSigner ?? null,
      isWritable: false,
    },
    profileValidationProfile: {
      value: input.profileValidationProfile ?? null,
      isWritable: true,
    },
    profileValidationCertificate: {
      value: input.profileValidationCertificate ?? null,
      isWritable: false,
    },
    profileValidationProgram: {
      value: input.profileValidationProgram ?? null,
      isWritable: false,
    },
    profileFaction: { value: input.profileFaction ?? null, isWritable: false },
    claimStakeInstance: {
      value: input.claimStakeInstance ?? null,
      isWritable: true,
    },
    system: { value: input.system ?? null, isWritable: false },
    starbasePlayer: { value: input.starbasePlayer ?? null, isWritable: true },
    celestialBody: { value: input.celestialBody ?? null, isWritable: true },
    currencyCache: { value: input.currencyCache ?? null, isWritable: true },
    factionOwnership: {
      value: input.factionOwnership ?? null,
      isWritable: false,
    },
    systemProgram: { value: input.systemProgram ?? null, isWritable: false },
    xpAccrual: { value: input.xpAccrual ?? null, isWritable: true },
    rentCatalog: { value: input.rentCatalog ?? null, isWritable: false },
    rentAuthority: { value: input.rentAuthority ?? null, isWritable: true },
    rentGridHead: { value: input.rentGridHead ?? null, isWritable: false },
    rentLevelHead: { value: input.rentLevelHead ?? null, isWritable: false },
    rentDefHead: { value: input.rentDefHead ?? null, isWritable: false },
  };
  const accounts = originalAccounts as Record<
    keyof typeof originalAccounts,
    ResolvedInstructionAccount
  >;

  // Original args.
  const args = { ...input };

  // Resolve default values.
  if (!accounts.profileValidationProgram.value) {
    accounts.profileValidationProgram.value =
      'C4PRoFNroxxzdgeCoM31LJjYRg7kT6ymogSTAT99iD1u' as Address<'C4PRoFNroxxzdgeCoM31LJjYRg7kT6ymogSTAT99iD1u'>;
  }
  if (!accounts.systemProgram.value) {
    accounts.systemProgram.value =
      '11111111111111111111111111111111' as Address<'11111111111111111111111111111111'>;
  }

  // Remaining accounts.
  const remainingAccounts: AccountMeta[] = args.rentPages.map((address) => ({
    address,
    role: AccountRole.READONLY,
  }));

  const getAccountMeta = getAccountMetaFactory(programAddress, 'programId');
  return Object.freeze({
    accounts: [
      getAccountMeta('game', accounts.game),
      getAccountMeta(
        'profileValidationSigner',
        accounts.profileValidationSigner,
      ),
      getAccountMeta(
        'profileValidationProfile',
        accounts.profileValidationProfile,
      ),
      getAccountMeta(
        'profileValidationCertificate',
        accounts.profileValidationCertificate,
      ),
      getAccountMeta(
        'profileValidationProgram',
        accounts.profileValidationProgram,
      ),
      getAccountMeta('profileFaction', accounts.profileFaction),
      getAccountMeta('claimStakeInstance', accounts.claimStakeInstance),
      getAccountMeta('system', accounts.system),
      getAccountMeta('starbasePlayer', accounts.starbasePlayer),
      getAccountMeta('celestialBody', accounts.celestialBody),
      getAccountMeta('currencyCache', accounts.currencyCache),
      getAccountMeta('factionOwnership', accounts.factionOwnership),
      getAccountMeta('systemProgram', accounts.systemProgram),
      getAccountMeta('xpAccrual', accounts.xpAccrual),
      getAccountMeta('rentCatalog', accounts.rentCatalog),
      getAccountMeta('rentAuthority', accounts.rentAuthority),
      getAccountMeta('rentGridHead', accounts.rentGridHead),
      getAccountMeta('rentLevelHead', accounts.rentLevelHead),
      getAccountMeta('rentDefHead', accounts.rentDefHead),
      ...remainingAccounts,
    ],
    data: getPlaceClaimStakeBuildingsInstructionDataEncoder().encode(
      args as PlaceClaimStakeBuildingsInstructionDataArgs,
    ),
    programAddress,
  } as PlaceClaimStakeBuildingsInstruction<
    TProgramAddress,
    TAccountGame,
    TAccountProfileValidationSigner,
    TAccountProfileValidationProfile,
    TAccountProfileValidationCertificate,
    TAccountProfileValidationProgram,
    TAccountProfileFaction,
    TAccountClaimStakeInstance,
    TAccountSystem,
    TAccountStarbasePlayer,
    TAccountCelestialBody,
    TAccountCurrencyCache,
    TAccountFactionOwnership,
    TAccountSystemProgram,
    TAccountXpAccrual,
    TAccountRentCatalog,
    TAccountRentAuthority,
    TAccountRentGridHead,
    TAccountRentLevelHead,
    TAccountRentDefHead
  >);
}

export type ParsedPlaceClaimStakeBuildingsInstruction<
  TProgram extends string = typeof SAGE_PROGRAM_ADDRESS,
  TAccountMetas extends readonly AccountMeta[] = readonly AccountMeta[],
> = {
  programAddress: Address<TProgram>;
  accounts: {
    /** The game account */
    game: TAccountMetas[0];
    profileValidationSigner: TAccountMetas[1];
    profileValidationProfile: TAccountMetas[2];
    profileValidationCertificate?: TAccountMetas[3] | undefined;
    profileValidationProgram: TAccountMetas[4];
    /** The profile faction account associated with the player profile */
    profileFaction: TAccountMetas[5];
    /** The claim stake instance to modify the buildings of */
    claimStakeInstance: TAccountMetas[6];
    /** The [`StarSystem`] account */
    system: TAccountMetas[7];
    /** The [`crate::state::StarbasePlayer`] Account */
    starbasePlayer: TAccountMetas[8];
    /** The CelestialBody account containing the claim stake */
    celestialBody: TAccountMetas[9];
    /** The currency config cache account */
    currencyCache: TAccountMetas[10];
    /**
     * P5 Bridge #2 (REQUIRED, fail-closed): the starbase's `FactionOwnership(STARBASE)` sidecar. A REQUIRED,
     * PDA-bound account that MAY be uninitialized — so the displaced legacy owner can no longer keep placing
     * buildings on a captured starbase by OMITTING it (this is a control/mutation gate, so omission is worse
     * here than at the dock). When initialized, the owner gate resolves via the dynamic controller
     * (witness-checked); uninitialized PDA ⇒ legacy gate (byte-identical to pre-P5). See
     * `resolve_starbase_controller_fail_closed`.
     */
    factionOwnership: TAccountMetas[11];
    /** The Solana System program */
    systemProgram: TAccountMetas[12];
    /**
     * Building XP ledger (spec §5): REQUIRED by `Game.version == v1` (fail closed) and
     * rejected on legacy games. Appended after every pre-existing account so legacy
     * transactions keep their positional prefix.
     */
    xpAccrual?: TAccountMetas[13] | undefined;
    /** The game's rent-catalog PDA (REQUIRED; never created = Disabled). */
    rentCatalog: TAccountMetas[14];
    /** The stake's settlement-authority PDA (REQUIRED; never created = never evaluated). */
    rentAuthority: TAccountMetas[15];
    /** The stake's GRID source head (required iff the catalog is Active). */
    rentGridHead?: TAccountMetas[16] | undefined;
    /** The stake's system LEVEL source head (required iff the catalog is Active). */
    rentLevelHead?: TAccountMetas[17] | undefined;
    /** The stake's definition DEF source head (required iff the catalog is Active). */
    rentDefHead?: TAccountMetas[18] | undefined;
  };
  data: PlaceClaimStakeBuildingsInstructionData;
};

export function parsePlaceClaimStakeBuildingsInstruction<
  TProgram extends string,
  TAccountMetas extends readonly AccountMeta[],
>(
  instruction: Instruction<TProgram> &
    InstructionWithAccounts<TAccountMetas> &
    InstructionWithData<ReadonlyUint8Array>,
): ParsedPlaceClaimStakeBuildingsInstruction<TProgram, TAccountMetas> {
  if (instruction.accounts.length < 19) {
    throw new SolanaError(
      SOLANA_ERROR__PROGRAM_CLIENTS__INSUFFICIENT_ACCOUNT_METAS,
      {
        actualAccountMetas: instruction.accounts.length,
        expectedAccountMetas: 19,
      },
    );
  }
  let accountIndex = 0;
  const getNextAccount = () => {
    const accountMeta = (instruction.accounts as TAccountMetas)[accountIndex]!;
    accountIndex += 1;
    return accountMeta;
  };
  const getNextOptionalAccount = () => {
    const accountMeta = getNextAccount();
    return accountMeta.address === SAGE_PROGRAM_ADDRESS
      ? undefined
      : accountMeta;
  };
  return {
    programAddress: instruction.programAddress,
    accounts: {
      game: getNextAccount(),
      profileValidationSigner: getNextAccount(),
      profileValidationProfile: getNextAccount(),
      profileValidationCertificate: getNextOptionalAccount(),
      profileValidationProgram: getNextAccount(),
      profileFaction: getNextAccount(),
      claimStakeInstance: getNextAccount(),
      system: getNextAccount(),
      starbasePlayer: getNextAccount(),
      celestialBody: getNextAccount(),
      currencyCache: getNextAccount(),
      factionOwnership: getNextAccount(),
      systemProgram: getNextAccount(),
      xpAccrual: getNextOptionalAccount(),
      rentCatalog: getNextAccount(),
      rentAuthority: getNextAccount(),
      rentGridHead: getNextOptionalAccount(),
      rentLevelHead: getNextOptionalAccount(),
      rentDefHead: getNextOptionalAccount(),
    },
    data: getPlaceClaimStakeBuildingsInstructionDataDecoder().decode(
      instruction.data,
    ),
  };
}