/** * 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, getBytesDecoder, getBytesEncoder, getI64Decoder, getI64Encoder, getStructDecoder, getStructEncoder, getU16Decoder, getU16Encoder, getU8Decoder, getU8Encoder, 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, type WritableSignerAccount, } from '@solana/kit'; import { getAccountMetaFactory, type ResolvedInstructionAccount, } from '@solana/program-client-core'; import { SAGE_PROGRAM_ADDRESS } from '../programs'; export const START_QUEST_DISCRIMINATOR = new Uint8Array([ 212, 181, 79, 44, 200, 242, 13, 105, ]); export function getStartQuestDiscriminatorBytes() { return fixEncoderSize(getBytesEncoder(), 8).encode(START_QUEST_DISCRIMINATOR); } export type StartQuestInstruction< 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', TAccountGame extends string | AccountMeta = string, TAccountSystemAndStarbasePlayerSystem extends string | AccountMeta = string, TAccountSystemAndStarbasePlayerStarbasePlayer extends | string | AccountMeta = string, TAccountQuestProcess extends string | AccountMeta = string, TAccountSystemProgram extends string | AccountMeta = '11111111111111111111111111111111', 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, TAccountGame extends string ? ReadonlyAccount : TAccountGame, TAccountSystemAndStarbasePlayerSystem extends string ? ReadonlyAccount : TAccountSystemAndStarbasePlayerSystem, TAccountSystemAndStarbasePlayerStarbasePlayer extends string ? WritableAccount : TAccountSystemAndStarbasePlayerStarbasePlayer, TAccountQuestProcess extends string ? WritableSignerAccount & AccountSignerMeta : TAccountQuestProcess, TAccountSystemProgram extends string ? ReadonlyAccount : TAccountSystemProgram, ...TRemainingAccounts, ] >; export type StartQuestInstructionData = { discriminator: ReadonlyUint8Array; /** the index of the key in the player profile. */ keyIndex: number; /** the number of crew to reserve Busy for this quest (the engine's `num_crew`). */ crew: number; /** the quest duration in seconds (`end_time = now + duration`). */ duration: bigint; /** * the flat XP reward poured on completion (credited as XP toward perk-point milestones, * NOT a direct perk-point mint — PR #732 fourth review; saturated at `PERK_POINTS_MAX`). */ rewardXp: number; /** * the roster page the reward must land on (PR #732 third review). The owner pins it here * (they sign `StartQuest`); `CompleteQuest` credits EXACTLY this page of the owner's * character, so a permissionless cranker can neither omit the roster nor steer the payout * to a dust page. Ignored when `reward_xp == 0`. */ rewardPage: number; }; export type StartQuestInstructionDataArgs = { /** the index of the key in the player profile. */ keyIndex: number; /** the number of crew to reserve Busy for this quest (the engine's `num_crew`). */ crew: number; /** the quest duration in seconds (`end_time = now + duration`). */ duration: number | bigint; /** * the flat XP reward poured on completion (credited as XP toward perk-point milestones, * NOT a direct perk-point mint — PR #732 fourth review; saturated at `PERK_POINTS_MAX`). */ rewardXp: number; /** * the roster page the reward must land on (PR #732 third review). The owner pins it here * (they sign `StartQuest`); `CompleteQuest` credits EXACTLY this page of the owner's * character, so a permissionless cranker can neither omit the roster nor steer the payout * to a dust page. Ignored when `reward_xp == 0`. */ rewardPage: number; }; export function getStartQuestInstructionDataEncoder(): FixedSizeEncoder { return transformEncoder( getStructEncoder([ ['discriminator', fixEncoderSize(getBytesEncoder(), 8)], ['keyIndex', getU16Encoder()], ['crew', getU16Encoder()], ['duration', getI64Encoder()], ['rewardXp', getU8Encoder()], ['rewardPage', getU16Encoder()], ]), (value) => ({ ...value, discriminator: START_QUEST_DISCRIMINATOR }), ); } export function getStartQuestInstructionDataDecoder(): FixedSizeDecoder { return getStructDecoder([ ['discriminator', fixDecoderSize(getBytesDecoder(), 8)], ['keyIndex', getU16Decoder()], ['crew', getU16Decoder()], ['duration', getI64Decoder()], ['rewardXp', getU8Decoder()], ['rewardPage', getU16Decoder()], ]); } export function getStartQuestInstructionDataCodec(): FixedSizeCodec< StartQuestInstructionDataArgs, StartQuestInstructionData > { return combineCodec( getStartQuestInstructionDataEncoder(), getStartQuestInstructionDataDecoder(), ); } export type StartQuestInput< TAccountProfileValidationSigner extends string = string, TAccountProfileValidationProfile extends string = string, TAccountProfileValidationCertificate extends string = string, TAccountProfileValidationProgram extends string = string, TAccountGame extends string = string, TAccountSystemAndStarbasePlayerSystem extends string = string, TAccountSystemAndStarbasePlayerStarbasePlayer extends string = string, TAccountQuestProcess extends string = string, TAccountSystemProgram extends string = string, > = { profileValidationSigner: TransactionSigner; profileValidationProfile: Address; profileValidationCertificate?: Address; profileValidationProgram?: Address; /** The game account. */ game: Address; /** The [`StarSystem`] account */ systemAndStarbasePlayerSystem: Address; /** The [`StarbasePlayer`] Account */ systemAndStarbasePlayerStarbasePlayer: Address; /** * The NEW quest process account (created here, closed on a terminal call). Init+Signer, * exactly as the upgrade process (contribute_rs:66-68); `Create(())` because it is a * keypair account (not a PDA) — the process's own key is its sequence id (state-slice * quest_rs note). */ questProcess: TransactionSigner; /** The Solana System program. */ systemProgram?: Address; keyIndex: StartQuestInstructionDataArgs['keyIndex']; crew: StartQuestInstructionDataArgs['crew']; duration: StartQuestInstructionDataArgs['duration']; rewardXp: StartQuestInstructionDataArgs['rewardXp']; rewardPage: StartQuestInstructionDataArgs['rewardPage']; }; export function getStartQuestInstruction< TAccountProfileValidationSigner extends string, TAccountProfileValidationProfile extends string, TAccountProfileValidationCertificate extends string, TAccountProfileValidationProgram extends string, TAccountGame extends string, TAccountSystemAndStarbasePlayerSystem extends string, TAccountSystemAndStarbasePlayerStarbasePlayer extends string, TAccountQuestProcess extends string, TAccountSystemProgram extends string, TProgramAddress extends Address = typeof SAGE_PROGRAM_ADDRESS, >( input: StartQuestInput< TAccountProfileValidationSigner, TAccountProfileValidationProfile, TAccountProfileValidationCertificate, TAccountProfileValidationProgram, TAccountGame, TAccountSystemAndStarbasePlayerSystem, TAccountSystemAndStarbasePlayerStarbasePlayer, TAccountQuestProcess, TAccountSystemProgram >, config?: { programAddress?: TProgramAddress }, ): StartQuestInstruction< TProgramAddress, TAccountProfileValidationSigner, TAccountProfileValidationProfile, TAccountProfileValidationCertificate, TAccountProfileValidationProgram, TAccountGame, TAccountSystemAndStarbasePlayerSystem, TAccountSystemAndStarbasePlayerStarbasePlayer, TAccountQuestProcess, TAccountSystemProgram > { // 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, }, game: { value: input.game ?? null, isWritable: false }, systemAndStarbasePlayerSystem: { value: input.systemAndStarbasePlayerSystem ?? null, isWritable: false, }, systemAndStarbasePlayerStarbasePlayer: { value: input.systemAndStarbasePlayerStarbasePlayer ?? null, isWritable: true, }, questProcess: { value: input.questProcess ?? null, isWritable: true }, systemProgram: { value: input.systemProgram ?? 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'>; } 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('game', accounts.game), getAccountMeta( 'systemAndStarbasePlayerSystem', accounts.systemAndStarbasePlayerSystem, ), getAccountMeta( 'systemAndStarbasePlayerStarbasePlayer', accounts.systemAndStarbasePlayerStarbasePlayer, ), getAccountMeta('questProcess', accounts.questProcess), getAccountMeta('systemProgram', accounts.systemProgram), ], data: getStartQuestInstructionDataEncoder().encode( args as StartQuestInstructionDataArgs, ), programAddress, } as StartQuestInstruction< TProgramAddress, TAccountProfileValidationSigner, TAccountProfileValidationProfile, TAccountProfileValidationCertificate, TAccountProfileValidationProgram, TAccountGame, TAccountSystemAndStarbasePlayerSystem, TAccountSystemAndStarbasePlayerStarbasePlayer, TAccountQuestProcess, TAccountSystemProgram >); } export type ParsedStartQuestInstruction< 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 game account. */ game: TAccountMetas[4]; /** The [`StarSystem`] account */ systemAndStarbasePlayerSystem: TAccountMetas[5]; /** The [`StarbasePlayer`] Account */ systemAndStarbasePlayerStarbasePlayer: TAccountMetas[6]; /** * The NEW quest process account (created here, closed on a terminal call). Init+Signer, * exactly as the upgrade process (contribute_rs:66-68); `Create(())` because it is a * keypair account (not a PDA) — the process's own key is its sequence id (state-slice * quest_rs note). */ questProcess: TAccountMetas[7]; /** The Solana System program. */ systemProgram: TAccountMetas[8]; }; data: StartQuestInstructionData; }; export function parseStartQuestInstruction< TProgram extends string, TAccountMetas extends readonly AccountMeta[], >( instruction: Instruction & InstructionWithAccounts & InstructionWithData, ): ParsedStartQuestInstruction { if (instruction.accounts.length < 9) { throw new SolanaError( SOLANA_ERROR__PROGRAM_CLIENTS__INSUFFICIENT_ACCOUNT_METAS, { actualAccountMetas: instruction.accounts.length, expectedAccountMetas: 9, }, ); } 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(), game: getNextAccount(), systemAndStarbasePlayerSystem: getNextAccount(), systemAndStarbasePlayerStarbasePlayer: getNextAccount(), questProcess: getNextAccount(), systemProgram: getNextAccount(), }, data: getStartQuestInstructionDataDecoder().decode(instruction.data), }; }