/** * 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 { combineCodec, fixDecoderSize, fixEncoderSize, getAddressEncoder, getArrayDecoder, getArrayEncoder, getBytesDecoder, getBytesEncoder, getProgramDerivedAddress, getStructDecoder, getStructEncoder, getU16Decoder, getU16Encoder, 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 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'; export const LOAD_FLEET_CREW_ROSTER_DISCRIMINATOR = new Uint8Array([ 226, 64, 151, 190, 30, 121, 221, 205, ]); export function getLoadFleetCrewRosterDiscriminatorBytes() { return fixEncoderSize(getBytesEncoder(), 8).encode( LOAD_FLEET_CREW_ROSTER_DISCRIMINATOR, ); } export type LoadFleetCrewRosterInstruction< TProgram extends string = typeof SAGE_PROGRAM_ADDRESS, TAccountProfileValidationSigner extends string | AccountMeta = string, TAccountProfileValidationProfile extends string | AccountMeta = string, TAccountProfileValidationCertificate extends string | AccountMeta = string, TAccountProfileValidationProgram extends string | AccountMeta = 'C4PRoFNroxxzdgeCoM31LJjYRg7kT6ymogSTAT99iD1u', TAccountFleet extends string | AccountMeta = string, TAccountGame extends string | AccountMeta = string, TAccountCharacter extends string | AccountMeta = string, TAccountSystemAndStarbasePlayerSystem extends string | AccountMeta = string, TAccountSystemAndStarbasePlayerStarbasePlayer extends | string | AccountMeta = string, TAccountRoster extends string | AccountMeta = string, TAccountCrewBinding extends string | AccountMeta = string, TRemainingAccounts extends readonly AccountMeta[] = [], > = Instruction & InstructionWithData & InstructionWithAccounts< [ TAccountProfileValidationSigner extends string ? ReadonlySignerAccount & AccountSignerMeta : TAccountProfileValidationSigner, TAccountProfileValidationProfile extends string ? WritableAccount : TAccountProfileValidationProfile, TAccountProfileValidationCertificate extends string ? ReadonlyAccount : TAccountProfileValidationCertificate, TAccountProfileValidationProgram extends string ? ReadonlyAccount : TAccountProfileValidationProgram, TAccountFleet extends string ? WritableAccount : TAccountFleet, TAccountGame extends string ? ReadonlyAccount : TAccountGame, TAccountCharacter extends string ? WritableAccount : TAccountCharacter, TAccountSystemAndStarbasePlayerSystem extends string ? ReadonlyAccount : TAccountSystemAndStarbasePlayerSystem, TAccountSystemAndStarbasePlayerStarbasePlayer extends string ? WritableAccount : TAccountSystemAndStarbasePlayerStarbasePlayer, TAccountRoster extends string ? WritableAccount : TAccountRoster, TAccountCrewBinding extends string ? WritableAccount : TAccountCrewBinding, ...TRemainingAccounts, ] >; export type LoadFleetCrewRosterInstructionData = { discriminator: ReadonlyUint8Array; /** passenger count (the fungible quantity; preserved exactly, fleet_crew_rs:19). */ count: number; /** * The specific crew (by asset id) to flip `AtStarbase → OnFleet`. Empty ⇒ fungible-only * (no individuated records touched). When non-empty its `len()` must equal `count`. */ crewAssetIds: Array>; /** the roster page the named crew live on. */ pageIndex: number; /** the index of the key in the player profile. */ keyIndex: number; /** * PER-SHIP POSTING (appended last so the pre-posting payload is a strict prefix): the * ship MODEL (raw `ShipId`) within the fleet to post the named crew to. `0` = fleet pool * (no posting — exactly the pre-posting behavior). Non-zero ⇒ validated against * `Game.ship_definitions` and the fleet's own composition, with a per-model seat cap; * the posted crew's aptitude contribution to the per-fleet average is weighted by the * model's `required_crew` (snapshotted on the record). One model per call — batch * multiple calls to post across models. */ shipId: number; }; export type LoadFleetCrewRosterInstructionDataArgs = { /** passenger count (the fungible quantity; preserved exactly, fleet_crew_rs:19). */ count: number; /** * The specific crew (by asset id) to flip `AtStarbase → OnFleet`. Empty ⇒ fungible-only * (no individuated records touched). When non-empty its `len()` must equal `count`. */ crewAssetIds: Array>; /** the roster page the named crew live on. */ pageIndex: number; /** the index of the key in the player profile. */ keyIndex: number; /** * PER-SHIP POSTING (appended last so the pre-posting payload is a strict prefix): the * ship MODEL (raw `ShipId`) within the fleet to post the named crew to. `0` = fleet pool * (no posting — exactly the pre-posting behavior). Non-zero ⇒ validated against * `Game.ship_definitions` and the fleet's own composition, with a per-model seat cap; * the posted crew's aptitude contribution to the per-fleet average is weighted by the * model's `required_crew` (snapshotted on the record). One model per call — batch * multiple calls to post across models. */ shipId: number; }; export function getLoadFleetCrewRosterInstructionDataEncoder(): Encoder { return transformEncoder( getStructEncoder([ ['discriminator', fixEncoderSize(getBytesEncoder(), 8)], ['count', getU16Encoder()], [ 'crewAssetIds', getArrayEncoder(getArrayEncoder(getU8Encoder(), { size: 32 })), ], ['pageIndex', getU16Encoder()], ['keyIndex', getU16Encoder()], ['shipId', getU16Encoder()], ]), (value) => ({ ...value, discriminator: LOAD_FLEET_CREW_ROSTER_DISCRIMINATOR, }), ); } export function getLoadFleetCrewRosterInstructionDataDecoder(): Decoder { return getStructDecoder([ ['discriminator', fixDecoderSize(getBytesDecoder(), 8)], ['count', getU16Decoder()], [ 'crewAssetIds', getArrayDecoder(getArrayDecoder(getU8Decoder(), { size: 32 })), ], ['pageIndex', getU16Decoder()], ['keyIndex', getU16Decoder()], ['shipId', getU16Decoder()], ]); } export function getLoadFleetCrewRosterInstructionDataCodec(): Codec< LoadFleetCrewRosterInstructionDataArgs, LoadFleetCrewRosterInstructionData > { return combineCodec( getLoadFleetCrewRosterInstructionDataEncoder(), getLoadFleetCrewRosterInstructionDataDecoder(), ); } export type LoadFleetCrewRosterAsyncInput< TAccountProfileValidationSigner extends string = string, TAccountProfileValidationProfile extends string = string, TAccountProfileValidationCertificate extends string = string, TAccountProfileValidationProgram extends string = string, TAccountFleet extends string = string, TAccountGame extends string = string, TAccountCharacter extends string = string, TAccountSystemAndStarbasePlayerSystem extends string = string, TAccountSystemAndStarbasePlayerStarbasePlayer extends string = string, TAccountRoster extends string = string, TAccountCrewBinding extends string = string, > = { profileValidationSigner: TransactionSigner; profileValidationProfile: Address; profileValidationCertificate?: Address; profileValidationProgram?: Address; /** The `Fleet` account (fleet_crew_rs:38-43). */ fleet: Address; /** The game account. */ game: Address; /** * The caller's `Character` — the crew-roster OWNER anchor (PR #732 second review). * Validated against the signer's profile + game; a supplied roster must then BE this * character's `(character, page_index)` PDA, so loading ANOTHER player's crew into * this fleet (and stealing their bonuses into the binding) is impossible. */ character?: Address; /** The [`StarSystem`] account */ systemAndStarbasePlayerSystem: Address; /** The [`StarbasePlayer`] Account */ systemAndStarbasePlayerStarbasePlayer: Address; /** The crew roster page holding the named individuated crew. Append-last optional. */ roster?: Address; crewBinding: Address; count: LoadFleetCrewRosterInstructionDataArgs['count']; crewAssetIds: LoadFleetCrewRosterInstructionDataArgs['crewAssetIds']; pageIndex: LoadFleetCrewRosterInstructionDataArgs['pageIndex']; keyIndex: LoadFleetCrewRosterInstructionDataArgs['keyIndex']; shipId: LoadFleetCrewRosterInstructionDataArgs['shipId']; }; export async function getLoadFleetCrewRosterInstructionAsync< TAccountProfileValidationSigner extends string, TAccountProfileValidationProfile extends string, TAccountProfileValidationCertificate extends string, TAccountProfileValidationProgram extends string, TAccountFleet extends string, TAccountGame extends string, TAccountCharacter extends string, TAccountSystemAndStarbasePlayerSystem extends string, TAccountSystemAndStarbasePlayerStarbasePlayer extends string, TAccountRoster extends string, TAccountCrewBinding extends string, TProgramAddress extends Address = typeof SAGE_PROGRAM_ADDRESS, >( input: LoadFleetCrewRosterAsyncInput< TAccountProfileValidationSigner, TAccountProfileValidationProfile, TAccountProfileValidationCertificate, TAccountProfileValidationProgram, TAccountFleet, TAccountGame, TAccountCharacter, TAccountSystemAndStarbasePlayerSystem, TAccountSystemAndStarbasePlayerStarbasePlayer, TAccountRoster, TAccountCrewBinding >, config?: { programAddress?: TProgramAddress }, ): Promise< LoadFleetCrewRosterInstruction< TProgramAddress, TAccountProfileValidationSigner, TAccountProfileValidationProfile, TAccountProfileValidationCertificate, TAccountProfileValidationProgram, TAccountFleet, TAccountGame, TAccountCharacter, TAccountSystemAndStarbasePlayerSystem, TAccountSystemAndStarbasePlayerStarbasePlayer, TAccountRoster, TAccountCrewBinding > > { // Program address. const programAddress = config?.programAddress ?? SAGE_PROGRAM_ADDRESS; // Original accounts. const originalAccounts = { 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, }, fleet: { value: input.fleet ?? null, isWritable: true }, game: { value: input.game ?? null, isWritable: false }, character: { value: input.character ?? null, isWritable: true }, systemAndStarbasePlayerSystem: { value: input.systemAndStarbasePlayerSystem ?? null, isWritable: false, }, systemAndStarbasePlayerStarbasePlayer: { value: input.systemAndStarbasePlayerStarbasePlayer ?? null, isWritable: true, }, roster: { value: input.roster ?? null, isWritable: true }, crewBinding: { value: input.crewBinding ?? null, isWritable: true }, }; 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.character.value) { accounts.character.value = await getProgramDerivedAddress({ programAddress, seeds: [ getBytesEncoder().encode( new Uint8Array([67, 104, 97, 114, 97, 99, 116, 101, 114]), ), getAddressEncoder().encode( getAddressFromResolvedInstructionAccount( 'profileValidationProfile', accounts.profileValidationProfile.value, ), ), getAddressEncoder().encode( getAddressFromResolvedInstructionAccount('game', accounts.game.value), ), ], }); } const getAccountMeta = getAccountMetaFactory(programAddress, 'programId'); return Object.freeze({ accounts: [ getAccountMeta( 'profileValidationSigner', accounts.profileValidationSigner, ), getAccountMeta( 'profileValidationProfile', accounts.profileValidationProfile, ), getAccountMeta( 'profileValidationCertificate', accounts.profileValidationCertificate, ), getAccountMeta( 'profileValidationProgram', accounts.profileValidationProgram, ), getAccountMeta('fleet', accounts.fleet), getAccountMeta('game', accounts.game), getAccountMeta('character', accounts.character), getAccountMeta( 'systemAndStarbasePlayerSystem', accounts.systemAndStarbasePlayerSystem, ), getAccountMeta( 'systemAndStarbasePlayerStarbasePlayer', accounts.systemAndStarbasePlayerStarbasePlayer, ), getAccountMeta('roster', accounts.roster), getAccountMeta('crewBinding', accounts.crewBinding), ], data: getLoadFleetCrewRosterInstructionDataEncoder().encode( args as LoadFleetCrewRosterInstructionDataArgs, ), programAddress, } as LoadFleetCrewRosterInstruction< TProgramAddress, TAccountProfileValidationSigner, TAccountProfileValidationProfile, TAccountProfileValidationCertificate, TAccountProfileValidationProgram, TAccountFleet, TAccountGame, TAccountCharacter, TAccountSystemAndStarbasePlayerSystem, TAccountSystemAndStarbasePlayerStarbasePlayer, TAccountRoster, TAccountCrewBinding >); } export type LoadFleetCrewRosterInput< TAccountProfileValidationSigner extends string = string, TAccountProfileValidationProfile extends string = string, TAccountProfileValidationCertificate extends string = string, TAccountProfileValidationProgram extends string = string, TAccountFleet extends string = string, TAccountGame extends string = string, TAccountCharacter extends string = string, TAccountSystemAndStarbasePlayerSystem extends string = string, TAccountSystemAndStarbasePlayerStarbasePlayer extends string = string, TAccountRoster extends string = string, TAccountCrewBinding extends string = string, > = { profileValidationSigner: TransactionSigner; profileValidationProfile: Address; profileValidationCertificate?: Address; profileValidationProgram?: Address; /** The `Fleet` account (fleet_crew_rs:38-43). */ fleet: Address; /** The game account. */ game: Address; /** * The caller's `Character` — the crew-roster OWNER anchor (PR #732 second review). * Validated against the signer's profile + game; a supplied roster must then BE this * character's `(character, page_index)` PDA, so loading ANOTHER player's crew into * this fleet (and stealing their bonuses into the binding) is impossible. */ character: Address; /** The [`StarSystem`] account */ systemAndStarbasePlayerSystem: Address; /** The [`StarbasePlayer`] Account */ systemAndStarbasePlayerStarbasePlayer: Address; /** The crew roster page holding the named individuated crew. Append-last optional. */ roster?: Address; crewBinding: Address; count: LoadFleetCrewRosterInstructionDataArgs['count']; crewAssetIds: LoadFleetCrewRosterInstructionDataArgs['crewAssetIds']; pageIndex: LoadFleetCrewRosterInstructionDataArgs['pageIndex']; keyIndex: LoadFleetCrewRosterInstructionDataArgs['keyIndex']; shipId: LoadFleetCrewRosterInstructionDataArgs['shipId']; }; export function getLoadFleetCrewRosterInstruction< TAccountProfileValidationSigner extends string, TAccountProfileValidationProfile extends string, TAccountProfileValidationCertificate extends string, TAccountProfileValidationProgram extends string, TAccountFleet extends string, TAccountGame extends string, TAccountCharacter extends string, TAccountSystemAndStarbasePlayerSystem extends string, TAccountSystemAndStarbasePlayerStarbasePlayer extends string, TAccountRoster extends string, TAccountCrewBinding extends string, TProgramAddress extends Address = typeof SAGE_PROGRAM_ADDRESS, >( input: LoadFleetCrewRosterInput< TAccountProfileValidationSigner, TAccountProfileValidationProfile, TAccountProfileValidationCertificate, TAccountProfileValidationProgram, TAccountFleet, TAccountGame, TAccountCharacter, TAccountSystemAndStarbasePlayerSystem, TAccountSystemAndStarbasePlayerStarbasePlayer, TAccountRoster, TAccountCrewBinding >, config?: { programAddress?: TProgramAddress }, ): LoadFleetCrewRosterInstruction< TProgramAddress, TAccountProfileValidationSigner, TAccountProfileValidationProfile, TAccountProfileValidationCertificate, TAccountProfileValidationProgram, TAccountFleet, TAccountGame, TAccountCharacter, TAccountSystemAndStarbasePlayerSystem, TAccountSystemAndStarbasePlayerStarbasePlayer, TAccountRoster, TAccountCrewBinding > { // Program address. const programAddress = config?.programAddress ?? SAGE_PROGRAM_ADDRESS; // Original accounts. const originalAccounts = { 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, }, fleet: { value: input.fleet ?? null, isWritable: true }, game: { value: input.game ?? null, isWritable: false }, character: { value: input.character ?? null, isWritable: true }, systemAndStarbasePlayerSystem: { value: input.systemAndStarbasePlayerSystem ?? null, isWritable: false, }, systemAndStarbasePlayerStarbasePlayer: { value: input.systemAndStarbasePlayerStarbasePlayer ?? null, isWritable: true, }, roster: { value: input.roster ?? null, isWritable: true }, crewBinding: { value: input.crewBinding ?? null, isWritable: true }, }; 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'>; } const getAccountMeta = getAccountMetaFactory(programAddress, 'programId'); return Object.freeze({ accounts: [ getAccountMeta( 'profileValidationSigner', accounts.profileValidationSigner, ), getAccountMeta( 'profileValidationProfile', accounts.profileValidationProfile, ), getAccountMeta( 'profileValidationCertificate', accounts.profileValidationCertificate, ), getAccountMeta( 'profileValidationProgram', accounts.profileValidationProgram, ), getAccountMeta('fleet', accounts.fleet), getAccountMeta('game', accounts.game), getAccountMeta('character', accounts.character), getAccountMeta( 'systemAndStarbasePlayerSystem', accounts.systemAndStarbasePlayerSystem, ), getAccountMeta( 'systemAndStarbasePlayerStarbasePlayer', accounts.systemAndStarbasePlayerStarbasePlayer, ), getAccountMeta('roster', accounts.roster), getAccountMeta('crewBinding', accounts.crewBinding), ], data: getLoadFleetCrewRosterInstructionDataEncoder().encode( args as LoadFleetCrewRosterInstructionDataArgs, ), programAddress, } as LoadFleetCrewRosterInstruction< TProgramAddress, TAccountProfileValidationSigner, TAccountProfileValidationProfile, TAccountProfileValidationCertificate, TAccountProfileValidationProgram, TAccountFleet, TAccountGame, TAccountCharacter, TAccountSystemAndStarbasePlayerSystem, TAccountSystemAndStarbasePlayerStarbasePlayer, TAccountRoster, TAccountCrewBinding >); } export type ParsedLoadFleetCrewRosterInstruction< TProgram extends string = typeof SAGE_PROGRAM_ADDRESS, TAccountMetas extends readonly AccountMeta[] = readonly AccountMeta[], > = { programAddress: Address; accounts: { profileValidationSigner: TAccountMetas[0]; profileValidationProfile: TAccountMetas[1]; profileValidationCertificate?: TAccountMetas[2] | undefined; profileValidationProgram: TAccountMetas[3]; /** The `Fleet` account (fleet_crew_rs:38-43). */ fleet: TAccountMetas[4]; /** The game account. */ game: TAccountMetas[5]; /** * The caller's `Character` — the crew-roster OWNER anchor (PR #732 second review). * Validated against the signer's profile + game; a supplied roster must then BE this * character's `(character, page_index)` PDA, so loading ANOTHER player's crew into * this fleet (and stealing their bonuses into the binding) is impossible. */ character: TAccountMetas[6]; /** The [`StarSystem`] account */ systemAndStarbasePlayerSystem: TAccountMetas[7]; /** The [`StarbasePlayer`] Account */ systemAndStarbasePlayerStarbasePlayer: TAccountMetas[8]; /** The crew roster page holding the named individuated crew. Append-last optional. */ roster?: TAccountMetas[9] | undefined; crewBinding: TAccountMetas[10]; }; data: LoadFleetCrewRosterInstructionData; }; export function parseLoadFleetCrewRosterInstruction< TProgram extends string, TAccountMetas extends readonly AccountMeta[], >( instruction: Instruction & InstructionWithAccounts & InstructionWithData, ): ParsedLoadFleetCrewRosterInstruction { if (instruction.accounts.length < 11) { throw new SolanaError( SOLANA_ERROR__PROGRAM_CLIENTS__INSUFFICIENT_ACCOUNT_METAS, { actualAccountMetas: instruction.accounts.length, expectedAccountMetas: 11, }, ); } 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: { profileValidationSigner: getNextAccount(), profileValidationProfile: getNextAccount(), profileValidationCertificate: getNextOptionalAccount(), profileValidationProgram: getNextAccount(), fleet: getNextAccount(), game: getNextAccount(), character: getNextAccount(), systemAndStarbasePlayerSystem: getNextAccount(), systemAndStarbasePlayerStarbasePlayer: getNextAccount(), roster: getNextOptionalAccount(), crewBinding: getNextAccount(), }, data: getLoadFleetCrewRosterInstructionDataDecoder().decode( instruction.data, ), }; }