@aephia/atlas-kit 0.6.0-next.104 → 0.6.0-next.106

package/dist/claim-stakes/actions/index.js

@@ -362,11 +362,10 @@ export async function planPlaceClaimStake(ctx, body, player, input) {
     }
     const currentBodyAccount = requireAccount(bodyAccount, body.address, `Celestial Body ${body.address} is missing. Refresh the Body and retry placement.`);
     const currentPlayerAccount = requireAccount(playerAccount, player.address, `Starbase Player ${player.address} is missing. Refresh it and retry placement.`);
-    const currentCharacterAccount = requireAccount(characterAccount, character, `Canonical Character ${character} is missing. Refresh the Profile Character and retry placement.`);
     const currentSystemAccount = requireAccount(systemAccount, body.system.address, `Star System ${body.system.address} is missing. Refresh the System and retry placement.`);
     const currentBody = celestialBodyAccountDefinition.decode(currentBodyAccount);
     const currentPlayer = starbasePlayerAccountDefinition.decode(currentPlayerAccount);
-    const currentCharacter = characterAccountDefinition.decode(currentCharacterAccount);
+    const { account: currentCharacterAccount } = requireProfileCharacter(characterAccount, character, options.authorization.profile, game, 'placement');
     const currentSystem = starSystemAccountDefinition.decode(currentSystemAccount);
     const canonicalSystem = await deriveStarSystemAddress(game, currentSystem.systemId);
     if (canonicalSystem !== body.system.address ||
@@ -388,10 +387,6 @@ export async function planPlaceClaimStake(ctx, body, player, input) {
         currentPlayer.totalCrew - currentPlayer.busyCrew !== player.availableCrew) {
         fail(`Starbase Player ${player.address} changed or does not match the authorization Profile, canonical Character, System, or available crew. Refresh it and retry.`, player.address);
     }
-    if (currentCharacter.playerProfile !== options.authorization.profile ||
-        currentCharacter.game !== game) {
-        fail(`Character ${character} does not match authorization Profile ${options.authorization.profile} and configured Game ${game}. Refresh the Character and retry.`, character);
-    }
     const currentCargo = currentPlayer.cargo.amounts.find(({ cargoId }) => cargoId === definition.cargoId)?.amount ?? 0n;
     if (currentCargo !== cargoQuantity || currentCargo < 1n) {
         fail(`Starbase Player ${player.address} Claim Stake cargo changed from the loaded snapshot or is no longer sufficient. Refresh its cargo and retry.`, player.address);
@@ -418,7 +413,7 @@ export async function planPlaceClaimStake(ctx, body, player, input) {
                 precondition(freshGame.account, `The configured Game retains Claim Stake definition ${String(definition.id)} and bundled hub ${String(hub.id)} eligibility.`),
                 precondition(currentBodyAccount, `Planet ${body.name} retains an available ${definition.name} plot and its configured Game/System relationship.`),
                 precondition(currentPlayerAccount, `Starbase Player ${player.address} retains its Profile, Character, System, available crew, and ${cargoName} balance.`),
-                precondition(currentCharacterAccount, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game.`),
+                characterPrecondition(currentCharacterAccount, options.authorization.profile),
                 precondition(currentSystemAccount, `Star System ${currentSystem.name} retains its configured Game, sequence, and active Starbase level.`),
             ])),
             absentPrecondition(options.claimStake, 'The caller-supplied Claim Stake signer address remains unallocated.'),
@@ -469,6 +464,165 @@ function sameStakeState(left, right) {
                 sameQuantities(left.buildings, right.buildings));
     }
 }
+// Common facts for planners acting on an owned, placed Claim Stake. Each
+// planner keeps its own eligibility checks and Plan wording at its call site;
+// `action` completes the shared remedies ("retry <action>").
+/** Requires the loaded Claim Stake to belong to the configured Game and to the
+ * authorization Profile's canonical Character, which it returns. */
+async function requireOwnedStake(stake, game, profile) {
+    if (stake.game !== game) {
+        fail(`Claim Stake ${stake.address} does not match the configured Game ${game}. Refresh it through this context and retry.`, stake.address);
+    }
+    const character = await findCharacterPda(profile, game);
+    if (stake.ownerCharacter.address !== character) {
+        fail(`Claim Stake ${stake.address} does not belong to authorization Profile ${profile}'s canonical Character ${character}. Choose an owned Claim Stake, refresh it, and retry.`, stake.address);
+    }
+    return character;
+}
+/** Reads and decodes the fresh Claim Stake and Body, with `extra` accounts in
+ * the same batch. */
+async function readOwnedStake(ctx, stake, action, extra = []) {
+    const [stakeCandidate, bodyCandidate, ...extraAccounts] = await readContextRawAccounts(ctx, [
+        stake.address,
+        stake.body.address,
+        ...extra,
+    ]);
+    const stakeAccount = requireAccount(stakeCandidate, stake.address, `Claim Stake ${stake.address} is missing. Refresh it and retry ${action}.`);
+    const bodyAccount = requireAccount(bodyCandidate, stake.body.address, `Celestial Body ${stake.body.address} is missing. Refresh the Claim Stake Body and retry ${action}.`);
+    return {
+        bodyAccount,
+        currentBody: celestialBodyAccountDefinition.decode(bodyAccount),
+        currentStake: claimStakeAccountDefinition.decode(stakeAccount),
+        extraAccounts,
+        stakeAccount,
+    };
+}
+/** Whether the fresh Claim Stake keeps the loaded ownership, Body,
+ * definitions, buildings and System generation. */
+function sameOwnedStake(current, stake, game, character) {
+    return (current.game === game &&
+        current.body === stake.body.address &&
+        current.ownerCharacter === character &&
+        current.claimStakeDefinitionId === stake.claimStakeDefinitionId &&
+        current.claimStakeDefinitionSeqId === stake.claimStakeDefinitionSeqId &&
+        current.buildingDefinitionSeqId === stake.buildingDefinitionSeqId &&
+        current.systemSeqId === stake.systemSeqId &&
+        sameQuantities(current.buildings, stake.buildings));
+}
+/** Whether the fresh Claim Stake keeps the loaded transfer facts: ownership,
+ * Body, active state, System generation, resources and capacity. */
+function sameTransferStake(current, stake, game, character) {
+    return (current.game === game &&
+        current.ownerCharacter === character &&
+        current.body === stake.body.address &&
+        current.systemSeqId === stake.systemSeqId &&
+        current.state.kind === 'active' &&
+        current.production.cargoPod.storageCost ===
+            stake.resources.capacity.usedRaw &&
+        current.production.resourceCapacityRaw ===
+            stake.resources.capacity.totalRaw &&
+        sameCargoAmounts(current.production.cargoPod.amounts, stake.resources.inventory.items.map(({ id, quantityRaw }) => ({
+            amount: quantityRaw,
+            id,
+        }))));
+}
+/** Whether the fresh Fleet keeps the loaded Game, owner, name, cargo and
+ * capacities. */
+function sameTransferFleet(current, fleet, game, profile) {
+    return (current.game === game &&
+        current.ownerProfile === profile &&
+        current.name === fleet.name &&
+        current.ammoBank.cargoId === fleet.ammo.id &&
+        current.ammoBank.amount === fleet.ammo.amount &&
+        current.fuelTank.cargoId === fleet.fuel.id &&
+        current.fuelTank.amount === fleet.fuel.amount &&
+        current.cargoHold.storageCost === fleet.cargoHold.storageCost &&
+        sameCargoAmounts(current.cargoHold.amounts, fleet.cargoHold.items) &&
+        current.stats.cargo.ammoCapacity === fleet.capacities.ammo.total &&
+        current.stats.cargo.fuelCapacity === fleet.capacities.fuel.total &&
+        current.stats.cargo.cargoCapacity === fleet.capacities.cargo.total);
+}
+/** Requires the fresh Body to be the Claim Stake's canonical Planet in the
+ * configured Game at the Claim Stake's System generation. */
+async function requireStakePlanet(currentBody, stake, game, action) {
+    if (currentBody.kind !== 'planet' ||
+        currentBody.game !== game ||
+        currentBody.systemSequenceId !== stake.systemSeqId ||
+        (await deriveCelestialBodyAddress(game, currentBody.id)) !==
+            stake.body.address) {
+        fail(`Celestial Body ${stake.body.address} does not match the Claim Stake's configured Game, canonical Planet identity, or System generation. Refresh the Body and Claim Stake before retrying ${action}.`, stake.body.address);
+    }
+    return currentBody;
+}
+/** Requires and decodes the canonical Character of the authorization Profile in
+ * the configured Game. */
+function requireProfileCharacter(candidate, character, profile, game, action) {
+    const account = requireAccount(candidate, character, `Canonical Character ${character} is missing. Refresh the Profile Character and retry ${action}.`);
+    const current = characterAccountDefinition.decode(account);
+    if (current.playerProfile !== profile || current.game !== game) {
+        fail(`Character ${character} does not match authorization Profile ${profile} and configured Game ${game}. Refresh the Character and retry ${action}.`, character);
+    }
+    return { account, current };
+}
+/** Reads the Claim Stake's System and the authorization Profile's canonical
+ * Starbase Player there, with `extra` accounts in the same batch. Requires a
+ * canonical, current System with an active Starbase that lists the Body, and a
+ * Starbase Player of the Profile, Character and System. */
+async function readStakeStarbase(ctx, stake, game, system, character, profile, action, extra = []) {
+    const player = await deriveStarbasePlayerAddress(system, character);
+    const [systemCandidate, playerCandidate, ...extraAccounts] = await readContextRawAccounts(ctx, [system, player, ...extra]);
+    const systemAccount = requireAccount(systemCandidate, system, `Star System ${system} is missing. Refresh the Claim Stake's System and retry ${action}.`);
+    const playerAccount = requireAccount(playerCandidate, player, `Starbase Player ${player} is missing for authorization Profile ${profile}. Register or refresh it in the Claim Stake's System before retrying ${action}.`);
+    const currentSystem = starSystemAccountDefinition.decode(systemAccount);
+    const currentPlayer = starbasePlayerAccountDefinition.decode(playerAccount);
+    if (currentSystem.game !== game ||
+        currentSystem.sequenceId !== stake.systemSeqId ||
+        currentSystem.starbase === undefined ||
+        !currentSystem.celestialBodyAddresses.includes(stake.body.address) ||
+        (await deriveStarSystemAddress(game, currentSystem.systemId)) !== system) {
+        fail(`Star System ${system} does not match the configured Game, canonical identity, Claim Stake generation, active nested Starbase, or Claim Stake Body relationship. Refresh the System and retry ${action}.`, system);
+    }
+    if (currentPlayer.playerProfile !== profile ||
+        currentPlayer.character !== character ||
+        currentPlayer.system !== system) {
+        fail(`Starbase Player ${player} does not match the authorization Profile, canonical Character, and Claim Stake System. Refresh it and retry ${action}.`, player);
+    }
+    return {
+        currentPlayer,
+        currentSystem,
+        extraAccounts,
+        player,
+        playerAccount,
+        starbase: currentSystem.starbase,
+        systemAccount,
+    };
+}
+async function claimStakeCurrencyCache(game) {
+    const [currencyCache] = await deriveCurrencyCache(game);
+    return currencyCache;
+}
+/** Requires the canonical CurrencyCache and returns its Plan guard. */
+async function requireCurrencyCache(candidate, currencyCache, game, action, planName) {
+    await validateCurrencyCache(requireAccount(candidate, currencyCache, `Canonical CurrencyCache ${currencyCache} is missing for configured Game ${game}. Refresh the Game currency configuration and retry ${action}.`), game, planName);
+    return {
+        kind: 'currency-cache',
+        address: currencyCache,
+        game,
+        describes: 'The canonical CurrencyCache remains assigned to the configured Game; shared accounting may change.',
+    };
+}
+function planetPrecondition(account, system) {
+    return precondition(account, `The Claim Stake Planet remains assigned to System ${system} at the current generation.`);
+}
+function characterPrecondition(account, profile) {
+    return precondition(account, `The canonical Character remains assigned to Profile ${profile} in the configured Game.`);
+}
+function systemPrecondition(account, name) {
+    return precondition(account, `Star System ${name} retains its configured Game, sequence, nested Starbase, and Claim Stake Body relationship.`);
+}
+function playerPrecondition(account, player, facts = 'Profile, Character, and System') {
+    return precondition(account, `Starbase Player ${player} retains its ${facts}.`);
+}
 const LEGACY_CONTROLLER_ID = Object.freeze({
     unaligned: 0,
     mud: 1,
@@ -501,85 +655,37 @@ function buildingDescription(change, name) {
 export async function planClaimStakeBuildingChanges(ctx, stake, input) {
     const options = validateBuildingChangeOptions(input);
     const game = requireGameAddress(ctx);
+    const { profile } = options.authorization;
     if (stake.state.kind === 'deactivated') {
         fail(`Claim Stake ${stake.address} is deactivated; building changes require an active or design Claim Stake. Refresh it or choose another owned Claim Stake before retrying.`, stake.address);
     }
-    if (stake.game !== game) {
-        fail(`Claim Stake ${stake.address} does not match the configured Game ${game}. Refresh it through this context and retry.`, stake.address);
-    }
-    const character = await findCharacterPda(options.authorization.profile, game);
-    if (stake.ownerCharacter.address !== character) {
-        fail(`Claim Stake ${stake.address} does not belong to authorization Profile ${options.authorization.profile}'s canonical Character ${character}. Choose an owned Claim Stake, refresh it, and retry.`, stake.address);
-    }
-    const [freshGame, firstAccounts] = await Promise.all([
+    const character = await requireOwnedStake(stake, game, profile);
+    const action = 'building changes';
+    const [freshGame, loaded] = await Promise.all([
         readFreshGameClaimStakeConfiguration(ctx),
-        readContextRawAccounts(ctx, [stake.address, stake.body.address, character]),
+        readOwnedStake(ctx, stake, action, [character]),
     ]);
     if (freshGame === undefined) {
         fail(`Configured Game ${game} is missing. Refresh the Game catalog and retry building changes.`, game);
     }
-    const stakeAccount = requireAccount(firstAccounts[0], stake.address, `Claim Stake ${stake.address} is missing. Refresh it and retry building changes.`);
-    const bodyAccount = requireAccount(firstAccounts[1], stake.body.address, `Celestial Body ${stake.body.address} is missing. Refresh the Claim Stake Body and retry building changes.`);
-    const characterAccount = requireAccount(firstAccounts[2], character, `Canonical Character ${character} is missing. Refresh the Profile Character and retry building changes.`);
-    const currentStake = claimStakeAccountDefinition.decode(stakeAccount);
-    const currentBody = celestialBodyAccountDefinition.decode(bodyAccount);
-    const currentCharacter = characterAccountDefinition.decode(characterAccount);
-    if (currentStake.game !== game ||
-        currentStake.body !== stake.body.address ||
-        currentStake.ownerCharacter !== character ||
-        currentStake.claimStakeDefinitionId !== stake.claimStakeDefinitionId ||
-        currentStake.claimStakeDefinitionSeqId !==
-            stake.claimStakeDefinitionSeqId ||
-        currentStake.buildingDefinitionSeqId !== stake.buildingDefinitionSeqId ||
-        currentStake.systemSeqId !== stake.systemSeqId ||
-        !sameQuantities(currentStake.buildings, stake.buildings) ||
+    const { bodyAccount, currentStake, stakeAccount } = loaded;
+    if (!sameOwnedStake(currentStake, stake, game, character) ||
         currentStake.neededCrew !== stake.neededCrew) {
         fail(`Claim Stake ${stake.address} changed or does not match its loaded ownership, Body, definitions, buildings, crew, or System generation. Refresh it and retry building changes.`, stake.address);
     }
-    if (currentCharacter.playerProfile !== options.authorization.profile ||
-        currentCharacter.game !== game) {
-        fail(`Character ${character} does not match authorization Profile ${options.authorization.profile} and configured Game ${game}. Refresh the Character and retry building changes.`, character);
-    }
-    if (currentBody.kind !== 'planet' ||
-        currentBody.game !== game ||
-        currentBody.systemSequenceId !== stake.systemSeqId ||
-        (await deriveCelestialBodyAddress(game, currentBody.id)) !==
-            stake.body.address) {
-        fail(`Celestial Body ${stake.body.address} does not match the Claim Stake's configured Game, canonical Planet identity, or System generation. Refresh the Body and Claim Stake before retrying.`, stake.body.address);
-    }
-    const system = currentBody.system;
-    const [player, ownership, profileFaction] = await Promise.all([
-        deriveStarbasePlayerAddress(system, character),
+    const { system } = await requireStakePlanet(loaded.currentBody, stake, game, action);
+    const { account: characterAccount } = requireProfileCharacter(loaded.extraAccounts[0], character, profile, game, action);
+    const [ownership, profileFaction] = await Promise.all([
         deriveFactionOwnershipAddress(game, 'starbase', system),
-        deriveProfileFactionAddress(options.authorization.profile),
-    ]);
-    const [systemAccountCandidate, playerAccountCandidate, ownershipAccount, profileFactionAccountCandidate,] = await readContextRawAccounts(ctx, [
-        system,
-        player,
-        ownership,
-        profileFaction,
+        deriveProfileFactionAddress(profile),
     ]);
-    const systemAccount = requireAccount(systemAccountCandidate, system, `Star System ${system} is missing. Refresh the Claim Stake's System and retry building changes.`);
-    const playerAccount = requireAccount(playerAccountCandidate, player, `Starbase Player ${player} is missing for authorization Profile ${options.authorization.profile}. Register or refresh it in the Claim Stake's System before retrying.`);
-    const profileFactionAccount = requireAccount(profileFactionAccountCandidate, profileFaction, `ProfileFaction ${profileFaction} is missing for authorization Profile ${options.authorization.profile}. Choose or repair the Profile faction, refresh it, and retry building changes.`);
-    const currentSystem = starSystemAccountDefinition.decode(systemAccount);
-    const currentPlayer = starbasePlayerAccountDefinition.decode(playerAccount);
+    const { currentPlayer, currentSystem, extraAccounts: [ownershipAccount, profileFactionCandidate], player, playerAccount, starbase, systemAccount, } = await readStakeStarbase(ctx, stake, game, system, character, profile, action, [ownership, profileFaction]);
+    const profileFactionAccount = requireAccount(profileFactionCandidate, profileFaction, `ProfileFaction ${profileFaction} is missing for authorization Profile ${profile}. Choose or repair the Profile faction, refresh it, and retry building changes.`);
     const currentProfileFaction = profileFactionIdentityAccountDefinition.decode(profileFactionAccount);
-    if (currentSystem.game !== game ||
-        currentSystem.sequenceId !== stake.systemSeqId ||
-        currentSystem.starbase === undefined ||
-        (await deriveStarSystemAddress(game, currentSystem.systemId)) !== system) {
-        fail(`Star System ${system} does not match the configured Game, canonical identity, Claim Stake generation, or an active nested Starbase. Refresh the System and retry building changes.`, system);
-    }
-    if (currentPlayer.playerProfile !== options.authorization.profile ||
-        currentPlayer.character !== character ||
-        currentPlayer.system !== system) {
-        fail(`Starbase Player ${player} does not match the authorization Profile, canonical Character, and Claim Stake System. Refresh it and retry building changes.`, player);
+    if (currentProfileFaction.profile !== profile) {
+        fail(`ProfileFaction ${profileFaction} does not match authorization Profile ${profile}. Refresh or repair the Profile faction before retrying building changes.`, profileFaction);
     }
-    if (currentProfileFaction.profile !== options.authorization.profile) {
-        fail(`ProfileFaction ${profileFaction} does not match authorization Profile ${options.authorization.profile}. Refresh or repair the Profile faction before retrying building changes.`, profileFaction);
-    }
-    let controllerFactionId = LEGACY_CONTROLLER_ID[currentSystem.starbase.owner];
+    let controllerFactionId = LEGACY_CONTROLLER_ID[starbase.owner];
     let ownershipPrecondition;
     if (ownershipAccount === undefined) {
         ownershipPrecondition = absentPrecondition(ownership, `The canonical Starbase FactionOwnership ${ownership} remains unallocated so the chain applies its legacy controller gate.`);
@@ -724,7 +830,7 @@ export async function planClaimStakeBuildingChanges(ctx, stake, input) {
     if (currentStake.production.cargoPod.storageCost > resourceStorageRaw) {
         fail(`The resulting Claim Stake design provides ${String(resourceStorageRaw)} raw storage capacity, below the fresh known cargo usage of ${String(currentStake.production.cargoPod.storageCost)}. Keep enough storage buildings, remove cargo, refresh the Claim Stake, and retry building changes.`, stake.address);
     }
-    const currencyCache = await deriveCurrencyCache(game).then(([address]) => address);
+    const currencyCache = await claimStakeCurrencyCache(game);
     const description = `Change buildings on Claim Stake ${stake.address}: ${descriptions.join('; ')}.`;
     const xp = await resolveClaimStakeXp(ctx, game, stake.address);
     return createPlan({
@@ -733,11 +839,11 @@ export async function planClaimStakeBuildingChanges(ctx, stake, input) {
             ...(await Promise.all([
                 precondition(freshGame.account, 'The configured Game retains the exact Claim Stake and building definitions.'),
                 precondition(stakeAccount, `Claim Stake ${stake.address} retains its ownership, design sequence, buildings, cargo, crew, and Body relationship.`),
-                precondition(bodyAccount, `The Claim Stake Planet remains assigned to System ${system} at the current generation.`),
-                precondition(characterAccount, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game.`),
-                precondition(systemAccount, `Star System ${currentSystem.name} retains its configured Game, sequence, and nested Starbase.`),
-                precondition(playerAccount, `Starbase Player ${player} retains its Profile, Character, System, and available crew.`),
-                precondition(profileFactionAccount, `ProfileFaction ${profileFaction} remains assigned to Profile ${options.authorization.profile} and aligned with the current Starbase controller.`),
+                planetPrecondition(bodyAccount, system),
+                characterPrecondition(characterAccount, profile),
+                systemPrecondition(systemAccount, currentSystem.name),
+                playerPrecondition(playerAccount, player, 'Profile, Character, System, and available crew'),
+                precondition(profileFactionAccount, `ProfileFaction ${profileFaction} remains assigned to Profile ${profile} and aligned with the current Starbase controller.`),
             ])),
             ownershipPrecondition,
             xp.guard,
@@ -791,22 +897,18 @@ export async function planClaimStakeBuildingChanges(ctx, stake, input) {
 export async function planFinalizeClaimStakeBuildingChanges(ctx, stake, input) {
     const options = validateFinalizeBuildingChangeOptions(input);
     const game = requireGameAddress(ctx);
+    const { profile } = options.authorization;
     if (stake.state.kind !== 'design') {
         fail(`Claim Stake ${stake.address} is not in design state. Refresh it and finalize only a pending building design.`, stake.address);
     }
-    if (stake.game !== game) {
-        fail(`Claim Stake ${stake.address} does not match the configured Game ${game}. Refresh it through this context and retry.`, stake.address);
-    }
-    const character = await findCharacterPda(options.authorization.profile, game);
-    if (stake.ownerCharacter.address !== character) {
-        fail(`Claim Stake ${stake.address} does not belong to authorization Profile ${options.authorization.profile}'s canonical Character ${character}. Choose an owned Claim Stake, refresh it, and retry.`, stake.address);
-    }
+    const character = await requireOwnedStake(stake, game, profile);
     if (stake.rentBalanceRaw <= 0n) {
         fail(`Claim Stake ${stake.address} has a known delinquent rent balance of ${String(stake.rentBalanceRaw)} raw units. Top up rent, refresh the Claim Stake, and retry finalization.`, stake.address);
     }
-    const [freshGame, firstAccounts] = await Promise.all([
+    const action = 'finalization';
+    const [freshGame, loaded] = await Promise.all([
         readFreshGameClaimStakeConfiguration(ctx),
-        readContextRawAccounts(ctx, [stake.address, stake.body.address, character]),
+        readOwnedStake(ctx, stake, action, [character]),
     ]);
     if (freshGame === undefined) {
         fail(`Configured Game ${game} is missing. Refresh the Game catalog and retry finalization.`, game);
@@ -815,59 +917,19 @@ export async function planFinalizeClaimStakeBuildingChanges(ctx, stake, input) {
         freshGame.data.buildings.sequenceId !== stake.buildingDefinitionSeqId) {
         fail(`Claim Stake ${stake.address} definition sequence is stale against the current Game catalog. Refresh the Claim Stake and definitions to rule out stale local data. If the on-chain generation still differs, use a Claim Stake matching the current catalog before retrying finalization.`, stake.address);
     }
-    const stakeAccount = requireAccount(firstAccounts[0], stake.address, `Claim Stake ${stake.address} is missing. Refresh it and retry finalization.`);
-    const bodyAccount = requireAccount(firstAccounts[1], stake.body.address, `Celestial Body ${stake.body.address} is missing. Refresh the Claim Stake Body and retry finalization.`);
-    const characterAccount = requireAccount(firstAccounts[2], character, `Canonical Character ${character} is missing. Refresh the Profile Character and retry finalization.`);
-    const currentStake = claimStakeAccountDefinition.decode(stakeAccount);
-    const currentBody = celestialBodyAccountDefinition.decode(bodyAccount);
-    const currentCharacter = characterAccountDefinition.decode(characterAccount);
-    if (currentStake.game !== game ||
-        currentStake.body !== stake.body.address ||
-        currentStake.ownerCharacter !== character ||
-        currentStake.claimStakeDefinitionId !== stake.claimStakeDefinitionId ||
-        currentStake.claimStakeDefinitionSeqId !==
-            stake.claimStakeDefinitionSeqId ||
-        currentStake.buildingDefinitionSeqId !== stake.buildingDefinitionSeqId ||
-        currentStake.systemSeqId !== stake.systemSeqId ||
+    const { bodyAccount, currentStake, stakeAccount } = loaded;
+    if (!sameOwnedStake(currentStake, stake, game, character) ||
         currentStake.rentBalanceRaw !== stake.rentBalanceRaw ||
-        !sameQuantities(currentStake.buildings, stake.buildings) ||
         currentStake.state.kind !== 'design' ||
         currentStake.state.sequenceId !== stake.state.sequenceId ||
         !sameQuantities(currentStake.state.buildings, stake.state.buildings)) {
         fail(`Claim Stake ${stake.address} changed or does not match its loaded ownership, Body, definitions, buildings, design sequence, rent, or System generation. Refresh it and retry finalization.`, stake.address);
     }
-    if (currentCharacter.playerProfile !== options.authorization.profile ||
-        currentCharacter.game !== game) {
-        fail(`Character ${character} does not match authorization Profile ${options.authorization.profile} and configured Game ${game}. Refresh the Character and retry finalization.`, character);
-    }
-    if (currentBody.kind !== 'planet' ||
-        currentBody.game !== game ||
-        currentBody.systemSequenceId !== stake.systemSeqId ||
-        (await deriveCelestialBodyAddress(game, currentBody.id)) !==
-            stake.body.address) {
-        fail(`Celestial Body ${stake.body.address} does not match the Claim Stake's configured Game, canonical Planet identity, or System generation. Refresh the Body and Claim Stake before retrying finalization.`, stake.body.address);
-    }
-    const system = currentBody.system;
-    const player = await deriveStarbasePlayerAddress(system, character);
-    const currencyCache = await deriveCurrencyCache(game).then(([address]) => address);
-    const [systemCandidate, playerCandidate, currencyCandidate] = await readContextRawAccounts(ctx, [system, player, currencyCache]);
-    const systemAccount = requireAccount(systemCandidate, system, `Star System ${system} is missing. Refresh the Claim Stake's System and retry finalization.`);
-    const playerAccount = requireAccount(playerCandidate, player, `Starbase Player ${player} is missing for authorization Profile ${options.authorization.profile}. Register or refresh it in the Claim Stake's System before retrying finalization.`);
-    const currencyAccount = requireAccount(currencyCandidate, currencyCache, `Canonical CurrencyCache ${currencyCache} is missing for configured Game ${game}. Refresh the Game currency configuration and retry finalization.`);
-    const currentSystem = starSystemAccountDefinition.decode(systemAccount);
-    const currentPlayer = starbasePlayerAccountDefinition.decode(playerAccount);
-    if (currentSystem.game !== game ||
-        currentSystem.sequenceId !== stake.systemSeqId ||
-        currentSystem.starbase === undefined ||
-        (await deriveStarSystemAddress(game, currentSystem.systemId)) !== system) {
-        fail(`Star System ${system} does not match the configured Game, canonical identity, Claim Stake generation, or an active nested Starbase. Refresh the System and retry finalization.`, system);
-    }
-    if (currentPlayer.playerProfile !== options.authorization.profile ||
-        currentPlayer.character !== character ||
-        currentPlayer.system !== system) {
-        fail(`Starbase Player ${player} does not match the authorization Profile, canonical Character, and Claim Stake System. Refresh it and retry finalization.`, player);
-    }
-    await validateCurrencyCache(currencyAccount, game, 'Claim Stake finalization');
+    const { system } = await requireStakePlanet(loaded.currentBody, stake, game, action);
+    const { account: characterAccount } = requireProfileCharacter(loaded.extraAccounts[0], character, profile, game, action);
+    const currencyCache = await claimStakeCurrencyCache(game);
+    const { currentSystem, extraAccounts: [currencyCandidate], player, playerAccount, systemAccount, } = await readStakeStarbase(ctx, stake, game, system, character, profile, action, [currencyCache]);
+    const currencyGuard = await requireCurrencyCache(currencyCandidate, currencyCache, game, action, 'Claim Stake finalization');
     const description = `Finalize building changes on Claim Stake ${stake.address}.`;
     const xp = await resolveClaimStakeXp(ctx, game, stake.address, character);
     return createPlan({
@@ -877,17 +939,12 @@ export async function planFinalizeClaimStakeBuildingChanges(ctx, stake, input) {
             ...(await Promise.all([
                 precondition(freshGame.account, 'The configured Game remains current.'),
                 precondition(stakeAccount, `Claim Stake ${stake.address} retains its ownership, design sequence, rent balance, Body, and System generation.`),
-                precondition(characterAccount, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game.`),
-                precondition(bodyAccount, `The Claim Stake Planet remains assigned to System ${system} at the current generation.`),
-                precondition(systemAccount, `Star System ${currentSystem.name} retains its configured Game, sequence, and nested Starbase.`),
-                precondition(playerAccount, `Starbase Player ${player} retains its Profile, Character, and System.`),
+                characterPrecondition(characterAccount, profile),
+                planetPrecondition(bodyAccount, system),
+                systemPrecondition(systemAccount, currentSystem.name),
+                playerPrecondition(playerAccount, player),
             ])),
-            {
-                kind: 'currency-cache',
-                address: currencyCache,
-                game,
-                describes: 'The canonical CurrencyCache remains assigned to the configured Game; shared accounting may change.',
-            },
+            currencyGuard,
         ],
         steps: [
             {
@@ -934,66 +991,23 @@ export async function planFinalizeClaimStakeBuildingChanges(ctx, stake, input) {
 export async function planCancelClaimStakeBuildingChanges(ctx, stake, input) {
     const options = validateCancelBuildingChangeOptions(input);
     const game = requireGameAddress(ctx);
+    const { profile } = options.authorization;
     if (stake.state.kind !== 'design') {
         fail(`Claim Stake ${stake.address} is not in design state. Refresh it and cancel only a pending building design.`, stake.address);
     }
-    if (stake.game !== game) {
-        fail(`Claim Stake ${stake.address} does not match the configured Game ${game}. Refresh it through this context and retry.`, stake.address);
-    }
-    const character = await findCharacterPda(options.authorization.profile, game);
-    if (stake.ownerCharacter.address !== character) {
-        fail(`Claim Stake ${stake.address} does not belong to authorization Profile ${options.authorization.profile}'s canonical Character ${character}. Choose an owned Claim Stake, refresh it, and retry.`, stake.address);
-    }
-    const firstAccounts = await readContextRawAccounts(ctx, [
-        stake.address,
-        stake.body.address,
-    ]);
-    const stakeAccount = requireAccount(firstAccounts[0], stake.address, `Claim Stake ${stake.address} is missing. Refresh it and retry cancellation.`);
-    const bodyAccount = requireAccount(firstAccounts[1], stake.body.address, `Celestial Body ${stake.body.address} is missing. Refresh the Claim Stake Body and retry cancellation.`);
-    const currentStake = claimStakeAccountDefinition.decode(stakeAccount);
-    const currentBody = celestialBodyAccountDefinition.decode(bodyAccount);
-    if (currentStake.game !== game ||
-        currentStake.body !== stake.body.address ||
-        currentStake.ownerCharacter !== character ||
-        currentStake.claimStakeDefinitionId !== stake.claimStakeDefinitionId ||
-        currentStake.claimStakeDefinitionSeqId !==
-            stake.claimStakeDefinitionSeqId ||
-        currentStake.buildingDefinitionSeqId !== stake.buildingDefinitionSeqId ||
-        currentStake.systemSeqId !== stake.systemSeqId ||
-        !sameQuantities(currentStake.buildings, stake.buildings) ||
+    const character = await requireOwnedStake(stake, game, profile);
+    const action = 'cancellation';
+    const { bodyAccount, currentBody, currentStake, stakeAccount } = await readOwnedStake(ctx, stake, action);
+    if (!sameOwnedStake(currentStake, stake, game, character) ||
         currentStake.state.kind !== 'design' ||
         currentStake.state.sequenceId !== stake.state.sequenceId ||
         !sameQuantities(currentStake.state.buildings, stake.state.buildings)) {
         fail(`Claim Stake ${stake.address} changed or does not match its loaded ownership, Body, definitions, buildings, design sequence, or System generation. Refresh it and retry cancellation.`, stake.address);
     }
-    if (currentBody.kind !== 'planet' ||
-        currentBody.game !== game ||
-        currentBody.systemSequenceId !== stake.systemSeqId ||
-        (await deriveCelestialBodyAddress(game, currentBody.id)) !==
-            stake.body.address) {
-        fail(`Celestial Body ${stake.body.address} does not match the Claim Stake's configured Game, canonical Planet identity, or System generation. Refresh the Body and Claim Stake before retrying cancellation.`, stake.body.address);
-    }
-    const system = currentBody.system;
-    const player = await deriveStarbasePlayerAddress(system, character);
-    const currencyCache = await deriveCurrencyCache(game).then(([address]) => address);
-    const [systemCandidate, playerCandidate, currencyCandidate] = await readContextRawAccounts(ctx, [system, player, currencyCache]);
-    const systemAccount = requireAccount(systemCandidate, system, `Star System ${system} is missing. Refresh the Claim Stake's System and retry cancellation.`);
-    const playerAccount = requireAccount(playerCandidate, player, `Starbase Player ${player} is missing for authorization Profile ${options.authorization.profile}. Register or refresh it in the Claim Stake's System before retrying cancellation.`);
-    const currencyAccount = requireAccount(currencyCandidate, currencyCache, `Canonical CurrencyCache ${currencyCache} is missing for configured Game ${game}. Refresh the Game currency configuration and retry cancellation.`);
-    const currentSystem = starSystemAccountDefinition.decode(systemAccount);
-    const currentPlayer = starbasePlayerAccountDefinition.decode(playerAccount);
-    if (currentSystem.game !== game ||
-        currentSystem.sequenceId !== stake.systemSeqId ||
-        currentSystem.starbase === undefined ||
-        (await deriveStarSystemAddress(game, currentSystem.systemId)) !== system) {
-        fail(`Star System ${system} does not match the configured Game, canonical identity, Claim Stake generation, or an active nested Starbase. Refresh the System and retry cancellation.`, system);
-    }
-    if (currentPlayer.playerProfile !== options.authorization.profile ||
-        currentPlayer.character !== character ||
-        currentPlayer.system !== system) {
-        fail(`Starbase Player ${player} does not match the authorization Profile, canonical Character, and Claim Stake System. Refresh it and retry cancellation.`, player);
-    }
-    await validateCurrencyCache(currencyAccount, game, 'Claim Stake cancellation');
+    const { system } = await requireStakePlanet(currentBody, stake, game, action);
+    const currencyCache = await claimStakeCurrencyCache(game);
+    const { currentSystem, extraAccounts: [currencyCandidate], player, playerAccount, systemAccount, } = await readStakeStarbase(ctx, stake, game, system, character, profile, action, [currencyCache]);
+    const currencyGuard = await requireCurrencyCache(currencyCandidate, currencyCache, game, action, 'Claim Stake cancellation');
     const description = `Cancel the pending building design on Claim Stake ${stake.address} and return it to active state.`;
     const xp = await resolveClaimStakeXp(ctx, game, stake.address);
     return createPlan({
@@ -1002,16 +1016,11 @@ export async function planCancelClaimStakeBuildingChanges(ctx, stake, input) {
             xp.guard,
             ...(await Promise.all([
                 precondition(stakeAccount, `Claim Stake ${stake.address} retains its ownership, design sequence, buildings, Body, and System generation.`),
-                precondition(bodyAccount, `The Claim Stake Planet remains assigned to System ${system} at the current generation.`),
-                precondition(systemAccount, `Star System ${currentSystem.name} retains its configured Game, sequence, and nested Starbase.`),
-                precondition(playerAccount, `Starbase Player ${player} retains its Profile, Character, and System.`),
+                planetPrecondition(bodyAccount, system),
+                systemPrecondition(systemAccount, currentSystem.name),
+                playerPrecondition(playerAccount, player),
             ])),
-            {
-                kind: 'currency-cache',
-                address: currencyCache,
-                game,
-                describes: 'The canonical CurrencyCache remains assigned to the configured Game; shared accounting may change.',
-            },
+            currencyGuard,
         ],
         steps: [
             {
@@ -1053,46 +1062,25 @@ export async function planCancelClaimStakeBuildingChanges(ctx, stake, input) {
 export async function planDeconstructClaimStake(ctx, stake, input) {
     const options = validateDeconstructOptions(input);
     const game = requireGameAddress(ctx);
+    const { profile } = options.authorization;
     if (stake.state.kind !== 'active') {
         fail(`Claim Stake ${stake.address} is not in active state. Refresh it, finalize or cancel any pending design, and retry deconstruction.`, stake.address);
     }
-    if (stake.game !== game) {
-        fail(`Claim Stake ${stake.address} does not match the configured Game ${game}. Refresh it through this context and retry.`, stake.address);
-    }
-    const character = await findCharacterPda(options.authorization.profile, game);
-    if (stake.ownerCharacter.address !== character) {
-        fail(`Claim Stake ${stake.address} does not belong to authorization Profile ${options.authorization.profile}'s canonical Character ${character}. Choose an owned Claim Stake, refresh it, and retry.`, stake.address);
-    }
-    const [freshGame, firstAccounts] = await Promise.all([
+    const character = await requireOwnedStake(stake, game, profile);
+    const action = 'deconstruction';
+    const [freshGame, { bodyAccount, currentBody, currentStake, stakeAccount }] = await Promise.all([
         readFreshGameClaimStakeConfiguration(ctx),
-        readContextRawAccounts(ctx, [stake.address, stake.body.address]),
+        readOwnedStake(ctx, stake, action),
     ]);
     if (freshGame === undefined) {
         fail(`Configured Game ${game} is missing. Refresh the Game definitions and retry deconstruction.`, game);
     }
-    const stakeAccount = requireAccount(firstAccounts[0], stake.address, `Claim Stake ${stake.address} is missing. Refresh it and retry deconstruction.`);
-    const bodyAccount = requireAccount(firstAccounts[1], stake.body.address, `Celestial Body ${stake.body.address} is missing. Refresh the Claim Stake Body and retry deconstruction.`);
-    const currentStake = claimStakeAccountDefinition.decode(stakeAccount);
-    const currentBody = celestialBodyAccountDefinition.decode(bodyAccount);
-    if (currentStake.game !== game ||
-        currentStake.body !== stake.body.address ||
-        currentStake.ownerCharacter !== character ||
-        currentStake.claimStakeDefinitionId !== stake.claimStakeDefinitionId ||
-        currentStake.claimStakeDefinitionSeqId !==
-            stake.claimStakeDefinitionSeqId ||
-        currentStake.buildingDefinitionSeqId !== stake.buildingDefinitionSeqId ||
-        currentStake.systemSeqId !== stake.systemSeqId ||
-        !sameQuantities(currentStake.buildings, stake.buildings) ||
+    if (!sameOwnedStake(currentStake, stake, game, character) ||
         currentStake.state.kind !== 'active') {
         fail(`Claim Stake ${stake.address} changed or does not match its loaded ownership, Body, definitions, buildings, active state, or System generation. Refresh it and retry deconstruction.`, stake.address);
     }
-    if (currentBody.kind !== 'planet' ||
-        currentBody.game !== game ||
-        currentBody.systemSequenceId !== stake.systemSeqId ||
-        (await deriveCelestialBodyAddress(game, currentBody.id)) !==
-            stake.body.address) {
-        fail(`Celestial Body ${stake.body.address} does not match the Claim Stake's configured Game, canonical Planet identity, or System generation. Refresh the Body and Claim Stake before retrying deconstruction.`, stake.body.address);
-    }
+    const planet = await requireStakePlanet(currentBody, stake, game, action);
+    const { system } = planet;
     if (freshGame.data.claimStakes.sequenceId !== stake.claimStakeDefinitionSeqId) {
         fail(`Claim Stake ${stake.address} definition generation is stale against the current Game catalog. Refresh the Claim Stake and definitions to rule out stale local data. If the on-chain generation still differs, use a Claim Stake matching the current catalog before retrying deconstruction.`, stake.address);
     }
@@ -1126,7 +1114,7 @@ export async function planDeconstructClaimStake(ctx, stake, input) {
                 ? `Claim Stake ${stake.address} does not contain exactly one verified bundled hub. Refresh it and restore the definition-compatible bundled hub before retrying deconstruction.`
                 : `Claim Stake ${stake.address} holds ${bundledHub.name} (${String(bundledHub.id)}), which is not the zero-cost ${claimDefinition.tier} bundled hub for Claim Stake definition ${String(claimDefinition.id)} (${claimDefinition.name}). Refresh the Claim Stake and Game definitions so the recorded hub matches its definition before retrying deconstruction.`, stake.address);
     }
-    const groups = currentBody.details.claimedPlots.filter(({ key }) => key === claimDefinition.id);
+    const groups = planet.details.claimedPlots.filter(({ key }) => key === claimDefinition.id);
     if (groups.length !== 1) {
         fail(`Claim Stake definition ${String(claimDefinition.id)} does not have exactly one coherent group in Planet ${stake.body.address}'s Claim Stake Body data. Refresh the Body before retrying deconstruction.`, stake.body.address);
     }
@@ -1143,7 +1131,7 @@ export async function planDeconstructClaimStake(ctx, stake, input) {
     }
     const claimStakeIndex = chronologyMatches[0].index;
     const tierIndex = TIER_INDEX[claimDefinition.tier];
-    const plotCapacities = currentBody.details.claimStakePlots.map((row) => row[tierIndex]);
+    const plotCapacities = planet.details.claimStakePlots.map((row) => row[tierIndex]);
     if (plotCapacities.some((capacity, index) => index > 0 && capacity < plotCapacities[index - 1])) {
         fail(`Planet ${stake.body.address} Claim Stake plot capacity is not coherent across Starbase levels for definition tier ${claimDefinition.tier}. Refresh the Body and verify the pinned binding version before retrying deconstruction.`, stake.body.address);
     }
@@ -1152,31 +1140,8 @@ export async function planDeconstructClaimStake(ctx, stake, input) {
     }
     const plotLevelIndex = plotCapacities.findIndex((capacity) => claimStakeIndex < capacity);
     const claimStakeLevel = CLAIM_STAKE_PLOT_LEVELS[plotLevelIndex];
-    const system = currentBody.system;
-    const player = await deriveStarbasePlayerAddress(system, character);
-    const [characterCandidate, systemCandidate, playerCandidate] = await readContextRawAccounts(ctx, [character, system, player]);
-    const characterAccount = requireAccount(characterCandidate, character, `Canonical Character ${character} is missing. Refresh the Profile Character and retry deconstruction.`);
-    const systemAccount = requireAccount(systemCandidate, system, `Star System ${system} is missing. Refresh the Claim Stake's System and retry deconstruction.`);
-    const playerAccount = requireAccount(playerCandidate, player, `Starbase Player ${player} is missing for authorization Profile ${options.authorization.profile}. Register or refresh it in the Claim Stake's System before retrying deconstruction.`);
-    const currentCharacter = characterAccountDefinition.decode(characterAccount);
-    const currentSystem = starSystemAccountDefinition.decode(systemAccount);
-    const currentPlayer = starbasePlayerAccountDefinition.decode(playerAccount);
-    if (currentCharacter.playerProfile !== options.authorization.profile ||
-        currentCharacter.game !== game) {
-        fail(`Character ${character} does not match authorization Profile ${options.authorization.profile} and configured Game ${game}. Refresh the Character and retry deconstruction.`, character);
-    }
-    if (currentSystem.game !== game ||
-        currentSystem.sequenceId !== stake.systemSeqId ||
-        currentSystem.starbase === undefined ||
-        !currentSystem.celestialBodyAddresses.includes(stake.body.address) ||
-        (await deriveStarSystemAddress(game, currentSystem.systemId)) !== system) {
-        fail(`Star System ${system} does not match the configured Game, canonical identity, Claim Stake generation, or an active nested Starbase. Refresh the System and retry deconstruction.`, system);
-    }
-    if (currentPlayer.playerProfile !== options.authorization.profile ||
-        currentPlayer.character !== character ||
-        currentPlayer.system !== system) {
-        fail(`Starbase Player ${player} does not match the authorization Profile, canonical Character, and Claim Stake System. Refresh it and retry deconstruction.`, player);
-    }
+    const { currentSystem, extraAccounts: [characterCandidate], player, playerAccount, systemAccount, } = await readStakeStarbase(ctx, stake, game, system, character, profile, action, [character]);
+    const { account: characterAccount } = requireProfileCharacter(characterCandidate, character, profile, game, action);
     const description = `Deconstruct Claim Stake ${stake.address} and discard its bundled hub ${bundledHub.name}; rent settlement, cargo return, account closure, and any refund remain chain-authoritative.`;
     return createPlan({
         kind: 'claim-stakes.deconstruct',
@@ -1184,9 +1149,9 @@ export async function planDeconstructClaimStake(ctx, stake, input) {
             precondition(freshGame.account, `The configured Game retains Claim Stake definition ${String(claimDefinition.id)}, bundled hub ${String(bundledHub.id)}, and their current generations.`),
             precondition(stakeAccount, `Claim Stake ${stake.address} retains its ownership, active state, definitions, bundled hub, Body, and System generation.`),
             precondition(bodyAccount, `The Planet retains Claim Stake ${stake.address} at chronology index ${String(claimStakeIndex)} in definition group ${String(claimDefinition.id)}.`),
-            precondition(characterAccount, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game.`),
-            precondition(systemAccount, `Star System ${currentSystem.name} retains its configured Game, sequence, nested Starbase, and Claim Stake Body relationship.`),
-            precondition(playerAccount, `Starbase Player ${player} retains its Profile, Character, and System.`),
+            characterPrecondition(characterAccount, profile),
+            systemPrecondition(systemAccount, currentSystem.name),
+            playerPrecondition(playerAccount, player),
         ]),
         steps: [
             {
@@ -1230,86 +1195,34 @@ export async function planDeconstructClaimStake(ctx, stake, input) {
 export async function planTopUpClaimStakeRent(ctx, stake, input) {
     const options = validateTopUpRentOptions(input);
     const game = requireGameAddress(ctx);
+    const { profile } = options.authorization;
     const loadedState = stake.state;
     if (loadedState.kind === 'deactivated') {
         fail(`Claim Stake ${stake.address} is not placed. Refresh it and choose an active Claim Stake or pending building design before topping up rent.`, stake.address);
     }
-    if (stake.game !== game) {
-        fail(`Claim Stake ${stake.address} does not match the configured Game ${game}. Refresh it through this context and retry.`, stake.address);
-    }
-    const character = await findCharacterPda(options.authorization.profile, game);
-    if (stake.ownerCharacter.address !== character) {
-        fail(`Claim Stake ${stake.address} does not belong to authorization Profile ${options.authorization.profile}'s canonical Character ${character}. Choose an owned Claim Stake, refresh it, and retry.`, stake.address);
-    }
-    const firstAccounts = await readContextRawAccounts(ctx, [
-        stake.address,
-        stake.body.address,
-        character,
-    ]);
-    const stakeAccount = requireAccount(firstAccounts[0], stake.address, `Claim Stake ${stake.address} is missing. Refresh it and retry the rent top-up.`);
-    const bodyAccount = requireAccount(firstAccounts[1], stake.body.address, `Celestial Body ${stake.body.address} is missing. Refresh the Claim Stake Body and retry the rent top-up.`);
-    const characterAccount = requireAccount(firstAccounts[2], character, `Canonical Character ${character} is missing. Refresh the Profile Character and retry the rent top-up.`);
-    const currentStake = claimStakeAccountDefinition.decode(stakeAccount);
-    const currentBody = celestialBodyAccountDefinition.decode(bodyAccount);
-    const currentCharacter = characterAccountDefinition.decode(characterAccount);
-    if (currentStake.game !== game ||
-        currentStake.body !== stake.body.address ||
-        currentStake.ownerCharacter !== character ||
-        currentStake.claimStakeDefinitionId !== stake.claimStakeDefinitionId ||
-        currentStake.claimStakeDefinitionSeqId !==
-            stake.claimStakeDefinitionSeqId ||
-        currentStake.buildingDefinitionSeqId !== stake.buildingDefinitionSeqId ||
-        currentStake.systemSeqId !== stake.systemSeqId ||
+    const character = await requireOwnedStake(stake, game, profile);
+    const action = 'the rent top-up';
+    const { bodyAccount, currentBody, currentStake, extraAccounts: [characterCandidate], stakeAccount, } = await readOwnedStake(ctx, stake, action, [character]);
+    if (!sameOwnedStake(currentStake, stake, game, character) ||
         currentStake.rentBalanceRaw !== stake.rentBalanceRaw ||
-        !sameQuantities(currentStake.buildings, stake.buildings) ||
         !sameStakeState(currentStake.state, loadedState)) {
         fail(`Claim Stake ${stake.address} changed or does not match its loaded ownership, Body, definitions, buildings, rent balance, placed state, or System generation. Refresh it and retry the rent top-up.`, stake.address);
     }
-    if (currentBody.kind !== 'planet' ||
-        currentBody.game !== game ||
-        currentBody.systemSequenceId !== stake.systemSeqId ||
-        (await deriveCelestialBodyAddress(game, currentBody.id)) !==
-            stake.body.address) {
-        fail(`Celestial Body ${stake.body.address} does not match the Claim Stake's configured Game, canonical Planet identity, or System generation. Refresh the Body and Claim Stake before retrying the rent top-up.`, stake.body.address);
-    }
-    if (currentCharacter.playerProfile !== options.authorization.profile ||
-        currentCharacter.game !== game) {
-        fail(`Character ${character} does not match authorization Profile ${options.authorization.profile} and configured Game ${game}. Refresh the Character and retry the rent top-up.`, character);
-    }
+    const { system } = await requireStakePlanet(currentBody, stake, game, action);
+    const { account: characterAccount, current: currentCharacter } = requireProfileCharacter(characterCandidate, character, profile, game, action);
     if (currentCharacter.atlasRaw < options.amount) {
         fail(`Character ${character} has only ${String(currentCharacter.atlasRaw)} known raw ATLAS, below the requested ${String(options.amount)} raw rent top-up. Reduce the amount or add ATLAS, refresh the Character, and retry.`, character);
     }
-    const system = currentBody.system;
-    const player = await deriveStarbasePlayerAddress(system, character);
-    const [systemCandidate, playerCandidate] = await readContextRawAccounts(ctx, [
-        system,
-        player,
-    ]);
-    const systemAccount = requireAccount(systemCandidate, system, `Star System ${system} is missing. Refresh the Claim Stake's System and retry the rent top-up.`);
-    const playerAccount = requireAccount(playerCandidate, player, `Starbase Player ${player} is missing for authorization Profile ${options.authorization.profile}. Register or refresh it in the Claim Stake's System before retrying the rent top-up.`);
-    const currentSystem = starSystemAccountDefinition.decode(systemAccount);
-    const currentPlayer = starbasePlayerAccountDefinition.decode(playerAccount);
-    if (currentSystem.game !== game ||
-        currentSystem.sequenceId !== stake.systemSeqId ||
-        currentSystem.starbase === undefined ||
-        !currentSystem.celestialBodyAddresses.includes(stake.body.address) ||
-        (await deriveStarSystemAddress(game, currentSystem.systemId)) !== system) {
-        fail(`Star System ${system} does not match the configured Game, canonical identity, Claim Stake generation, active nested Starbase, or Claim Stake Body relationship. Refresh the System and retry the rent top-up.`, system);
-    }
-    if (currentPlayer.playerProfile !== options.authorization.profile ||
-        currentPlayer.character !== character ||
-        currentPlayer.system !== system) {
-        fail(`Starbase Player ${player} does not match the authorization Profile, canonical Character, and Claim Stake System. Refresh it and retry the rent top-up.`, player);
-    }
+    const { currentSystem, player, playerAccount, systemAccount } = await readStakeStarbase(ctx, stake, game, system, character, profile, action);
     const description = `Top up Claim Stake ${stake.address} rent with ${String(options.amount)} raw rent units; rent arithmetic remains chain-authoritative.`;
     return createPlan({
         kind: 'claim-stakes.top-up-rent',
         preconditions: await Promise.all([
             precondition(stakeAccount, `Claim Stake ${stake.address} retains its ownership, rent balance, placed state, Body, and System generation.`),
-            precondition(bodyAccount, `The Claim Stake Planet remains assigned to System ${system} at the current generation.`),
-            precondition(characterAccount, `The canonical Character remains assigned to Profile ${options.authorization.profile} with at least ${String(options.amount)} known raw ATLAS.`),
-            precondition(systemAccount, `Star System ${currentSystem.name} retains its configured Game, sequence, nested Starbase, and Claim Stake Body relationship.`),
-            precondition(playerAccount, `Starbase Player ${player} retains its Profile, Character, and System.`),
+            planetPrecondition(bodyAccount, system),
+            precondition(characterAccount, `The canonical Character remains assigned to Profile ${profile} with at least ${String(options.amount)} known raw ATLAS.`),
+            systemPrecondition(systemAccount, currentSystem.name),
+            playerPrecondition(playerAccount, player),
         ]),
         steps: [
             {
@@ -1388,118 +1301,53 @@ function describeCargoRequests(direction, requests) {
 export async function planStartClaimStakeFleetTransfer(ctx, fleet, stake, input) {
     const options = validateStartFleetTransferOptions(input);
     const game = requireGameAddress(ctx);
+    const { profile } = options.authorization;
     if (fleet.game !== game || stake.game !== game) {
         fail(`Fleet ${fleet.address} and Claim Stake ${stake.address} must both belong to configured Game ${game}. Refresh both snapshots through this context and retry.`, fleet.game !== game ? fleet.address : stake.address);
     }
-    if (fleet.ownerProfile.address !== options.authorization.profile) {
-        fail(`Fleet ${fleet.name} belongs to Profile ${fleet.ownerProfile.address}, not authorization Profile ${options.authorization.profile}. Use the owning Profile, refresh the Fleet, and retry.`, fleet.address);
+    if (fleet.ownerProfile.address !== profile) {
+        fail(`Fleet ${fleet.name} belongs to Profile ${fleet.ownerProfile.address}, not authorization Profile ${profile}. Use the owning Profile, refresh the Fleet, and retry.`, fleet.address);
     }
     if (fleet.state.kind !== 'idle') {
         fail(`Fleet ${fleet.name} is ${fleet.state.kind}, but starting a Claim Stake transfer requires an idle Fleet. Return it to idle state, refresh it, and retry.`, fleet.address);
     }
+    const crewFailure = `Fleet ${fleet.name} has no valid normalized crew and cannot start a Claim Stake transfer. Crew the Fleet, refresh it, and retry.`;
     if (!Number.isSafeInteger(fleet.crewCount) || fleet.crewCount <= 0) {
-        fail(`Fleet ${fleet.name} has no valid normalized crew and cannot start a Claim Stake transfer. Crew the Fleet, refresh it, and retry.`, fleet.address);
+        fail(crewFailure, fleet.address);
     }
     if (stake.state.kind !== 'active') {
         fail(`Claim Stake ${stake.address} is ${stake.state.kind}, but starting a Fleet transfer requires an active Claim Stake. Activate or restore it, refresh it, and retry.`, stake.address);
     }
-    const character = await findCharacterPda(options.authorization.profile, game);
-    if (stake.ownerCharacter.address !== character) {
-        fail(`Claim Stake ${stake.address} does not belong to authorization Profile ${options.authorization.profile}'s canonical Character ${character}. Choose an owned active Claim Stake, refresh it, and retry.`, stake.address);
-    }
-    const [fleetCandidate, stakeCandidate, bodyCandidate, characterCandidate] = await readContextRawAccounts(ctx, [
-        fleet.address,
-        stake.address,
-        stake.body.address,
-        character,
-    ]);
-    const fleetAccount = requireAccount(fleetCandidate, fleet.address, `Fleet ${fleet.name} is missing. Refresh it and retry the Claim Stake transfer.`);
-    const stakeAccount = requireAccount(stakeCandidate, stake.address, `Claim Stake ${stake.address} is missing. Refresh it and retry the Fleet transfer.`);
-    const bodyAccount = requireAccount(bodyCandidate, stake.body.address, `Celestial Body ${stake.body.address} is missing. Refresh the Claim Stake Body and retry the Fleet transfer.`);
-    const characterAccount = requireAccount(characterCandidate, character, `Canonical Character ${character} is missing. Refresh the Profile Character and retry the Claim Stake transfer.`);
+    const character = await requireOwnedStake(stake, game, profile);
+    const action = 'the Fleet transfer';
+    const { bodyAccount, currentBody, currentStake, extraAccounts: [fleetCandidate, characterCandidate], stakeAccount, } = await readOwnedStake(ctx, stake, action, [fleet.address, character]);
+    const fleetAccount = requireAccount(fleetCandidate, fleet.address, `Fleet ${fleet.name} is missing. Refresh it and retry the Fleet transfer.`);
     const currentFleet = fleetAccountDefinition.decode(fleetAccount);
-    const currentStake = claimStakeAccountDefinition.decode(stakeAccount);
-    const currentBody = celestialBodyAccountDefinition.decode(bodyAccount);
-    const currentCharacter = characterAccountDefinition.decode(characterAccount);
     if (!Number.isSafeInteger(currentFleet.crewCount) ||
         currentFleet.crewCount <= 0) {
-        fail(`Fleet ${fleet.name} has no valid normalized crew and cannot start a Claim Stake transfer. Crew the Fleet, refresh it, and retry.`, fleet.address);
+        fail(crewFailure, fleet.address);
     }
-    if (currentFleet.game !== game ||
-        currentFleet.ownerProfile !== options.authorization.profile ||
-        currentFleet.name !== fleet.name ||
+    if (!sameTransferFleet(currentFleet, fleet, game, profile) ||
         currentFleet.state.kind !== 'idle' ||
         currentFleet.crewCount !== fleet.crewCount ||
-        (await deriveFleetAddress(currentFleet)) !== fleet.address ||
-        currentFleet.ammoBank.cargoId !== fleet.ammo.id ||
-        currentFleet.ammoBank.amount !== fleet.ammo.amount ||
-        currentFleet.fuelTank.cargoId !== fleet.fuel.id ||
-        currentFleet.fuelTank.amount !== fleet.fuel.amount ||
-        currentFleet.cargoHold.storageCost !== fleet.cargoHold.storageCost ||
-        !sameCargoAmounts(currentFleet.cargoHold.amounts, fleet.cargoHold.items) ||
-        currentFleet.stats.cargo.ammoCapacity !== fleet.capacities.ammo.total ||
-        currentFleet.stats.cargo.fuelCapacity !== fleet.capacities.fuel.total ||
-        currentFleet.stats.cargo.cargoCapacity !== fleet.capacities.cargo.total) {
+        (await deriveFleetAddress(currentFleet)) !== fleet.address) {
         fail(`Fleet ${fleet.name} changed or no longer matches its loaded Game, owner, canonical address, name, idle state, normalized crew, cargo, or capacities. Refresh it and create a new Claim Stake transfer Plan.`, fleet.address);
     }
-    if (currentStake.game !== game ||
-        currentStake.ownerCharacter !== character ||
-        currentStake.body !== stake.body.address ||
-        currentStake.systemSeqId !== stake.systemSeqId ||
-        currentStake.state.kind !== 'active' ||
-        currentStake.production.cargoPod.storageCost !==
-            stake.resources.capacity.usedRaw ||
-        currentStake.production.resourceCapacityRaw !==
-            stake.resources.capacity.totalRaw ||
-        !sameCargoAmounts(currentStake.production.cargoPod.amounts, stake.resources.inventory.items.map(({ id, quantityRaw }) => ({
-            amount: quantityRaw,
-            id,
-        })))) {
+    if (!sameTransferStake(currentStake, stake, game, character)) {
         fail(`Claim Stake ${stake.address} changed or no longer matches its loaded Game, owner, Body, active state, resources, capacity, or System generation. Refresh it and create a new Fleet transfer Plan.`, stake.address);
     }
-    if (currentBody.kind !== 'planet' ||
-        currentBody.game !== game ||
-        currentBody.systemSequenceId !== stake.systemSeqId ||
-        (await deriveCelestialBodyAddress(game, currentBody.id)) !==
-            stake.body.address) {
-        fail(`Celestial Body ${stake.body.address} does not match the Claim Stake's configured Game, canonical Planet identity, or System generation. Refresh the Body and Claim Stake before retrying the Fleet transfer.`, stake.body.address);
-    }
-    if (currentCharacter.playerProfile !== options.authorization.profile ||
-        currentCharacter.game !== game) {
-        fail(`Character ${character} does not match authorization Profile ${options.authorization.profile} and configured Game ${game}. Refresh the Character and retry the Claim Stake transfer.`, character);
-    }
-    const system = currentBody.system;
-    const player = await deriveStarbasePlayerAddress(system, character);
-    const currencyCache = await deriveCurrencyCache(game).then(([address]) => address);
-    const crewBinding = await deriveFleetCrewBindingAddress(fleet.address);
-    const [systemCandidate, playerCandidate, currencyCandidate, crewCandidate] = await readContextRawAccounts(ctx, [
-        system,
-        player,
-        currencyCache,
-        crewBinding,
+    const { system } = await requireStakePlanet(currentBody, stake, game, action);
+    const { account: characterAccount } = requireProfileCharacter(characterCandidate, character, profile, game, action);
+    const [currencyCache, crewBinding] = await Promise.all([
+        claimStakeCurrencyCache(game),
+        deriveFleetCrewBindingAddress(fleet.address),
     ]);
-    const systemAccount = requireAccount(systemCandidate, system, `Star System ${system} is missing. Refresh the Claim Stake System and retry the Fleet transfer.`);
-    const playerAccount = requireAccount(playerCandidate, player, `Starbase Player ${player} is missing for authorization Profile ${options.authorization.profile}. Register or refresh it in the Claim Stake System before retrying the Fleet transfer.`);
-    const currencyAccount = requireAccount(currencyCandidate, currencyCache, `Canonical CurrencyCache ${currencyCache} is missing for configured Game ${game}. Refresh the Game currency configuration and retry the Fleet transfer.`);
-    const currentSystem = starSystemAccountDefinition.decode(systemAccount);
-    const currentPlayer = starbasePlayerAccountDefinition.decode(playerAccount);
-    if (currentSystem.game !== game ||
-        currentSystem.sequenceId !== stake.systemSeqId ||
-        currentSystem.starbase === undefined ||
-        !currentSystem.celestialBodyAddresses.includes(stake.body.address) ||
-        (await deriveStarSystemAddress(game, currentSystem.systemId)) !== system) {
-        fail(`Star System ${system} does not match the configured Game, canonical identity, Claim Stake generation, nested Starbase, or Claim Stake Body relationship. Refresh the System and retry the Fleet transfer.`, system);
-    }
-    if (currentPlayer.playerProfile !== options.authorization.profile ||
-        currentPlayer.character !== character ||
-        currentPlayer.system !== system) {
-        fail(`Starbase Player ${player} does not match the authorization Profile, canonical Character, and Claim Stake System. Refresh it and retry the Fleet transfer.`, player);
-    }
-    await validateCurrencyCache(currencyAccount, game, 'Claim Stake Fleet transfer');
+    const { currentSystem, extraAccounts: [currencyCandidate, crewCandidate], player, playerAccount, systemAccount, } = await readStakeStarbase(ctx, stake, game, system, character, profile, action, [currencyCache, crewBinding]);
+    const currencyGuard = await requireCurrencyCache(currencyCandidate, currencyCache, game, action, 'Claim Stake Fleet transfer');
     if (crewCandidate !== undefined) {
         const currentCrewBinding = fleetCrewBindingAccountDefinition.decode(crewCandidate);
         if (crewCandidate.address !== crewBinding ||
-            !matchesFleetCrewBindingIdentity(currentCrewBinding, fleet.address, options.authorization.profile)) {
+            !matchesFleetCrewBindingIdentity(currentCrewBinding, fleet.address, profile)) {
             fail(`FleetCrewBinding ${crewCandidate.address} does not match Fleet ${fleet.address}, its owner Profile, or its canonical PDA. Refresh the Fleet crew registration or remove the invalid binding before retrying.`, crewCandidate.address);
         }
     }
@@ -1542,22 +1390,17 @@ export async function planStartClaimStakeFleetTransfer(ctx, fleet, stake, input)
             ...(await Promise.all([
                 precondition(fleetAccount, `Fleet ${fleet.name} retains its owner, name, idle state, normalized crew, cargo balances, and destination capacities.`),
                 precondition(stakeAccount, `Claim Stake ${stake.address} retains its owner, active state, cargo balances, destination capacity, Body, and System generation.`),
-                precondition(bodyAccount, `The Claim Stake Planet remains assigned to System ${system} at the current generation.`),
-                precondition(characterAccount, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game.`),
-                precondition(systemAccount, `Star System ${currentSystem.name} retains its configured Game, sequence, nested Starbase, and Claim Stake Body relationship.`),
-                precondition(playerAccount, `Starbase Player ${player} retains its Profile, Character, and System.`),
+                planetPrecondition(bodyAccount, system),
+                characterPrecondition(characterAccount, profile),
+                systemPrecondition(systemAccount, currentSystem.name),
+                playerPrecondition(playerAccount, player),
                 ...(crewCandidate === undefined
                     ? []
                     : [
                         precondition(crewCandidate, `Fleet ${fleet.name}'s optional FleetCrewBinding remains assigned to the Fleet and owner Profile.`),
                     ]),
             ])),
-            {
-                kind: 'currency-cache',
-                address: currencyCache,
-                game,
-                describes: 'The canonical CurrencyCache remains assigned to the configured Game; shared accounting may change.',
-            },
+            currencyGuard,
         ],
         steps: [
             {
@@ -1630,10 +1473,7 @@ export async function planRecoverClaimStakeFleetTransfer(ctx, fleet, stake, inpu
     if (options.atUnixSeconds < fleet.state.endAtUnixSeconds) {
         fail(`Fleet ${fleet.name}'s Claim Stake transfer lock has not elapsed at Unix timestamp ${String(options.atUnixSeconds)}; it ends at ${String(fleet.state.endAtUnixSeconds)}. Wait until the lock elapses, provide a current timestamp, and retry recovery.`, fleet.address);
     }
-    const character = await findCharacterPda(options.authorization.profile, game);
-    if (stake.ownerCharacter.address !== character) {
-        fail(`Claim Stake ${stake.address} does not belong to authorization Profile ${options.authorization.profile}'s canonical Character ${character}. Supply the owned current Claim Stake and retry recovery.`, stake.address);
-    }
+    const character = await requireOwnedStake(stake, game, options.authorization.profile);
     const [fleetCandidate, stakeCandidate] = await readContextRawAccounts(ctx, [
         fleet.address,
         stake.address,
@@ -1642,40 +1482,17 @@ export async function planRecoverClaimStakeFleetTransfer(ctx, fleet, stake, inpu
     const stakeAccount = requireAccount(stakeCandidate, stake.address, `Claim Stake ${stake.address} is missing. Refresh it and retry Fleet transfer recovery.`);
     const currentFleet = fleetAccountDefinition.decode(fleetAccount);
     const currentStake = claimStakeAccountDefinition.decode(stakeAccount);
-    if (currentFleet.game !== game ||
-        currentFleet.ownerProfile !== options.authorization.profile ||
-        currentFleet.name !== fleet.name ||
+    if (!sameTransferFleet(currentFleet, fleet, game, options.authorization.profile) ||
         currentFleet.state.kind !== 'claimStakeTransfer' ||
         currentFleet.state.claimStake !== stake.address ||
         currentFleet.state.planet !== stake.body.address ||
         currentFleet.state.endAtUnixSeconds !== fleet.state.endAtUnixSeconds ||
         !sameCargoAmounts(currentFleet.state.load, fleet.state.load) ||
         !sameCargoAmounts(currentFleet.state.unload, fleet.state.unload) ||
-        (await deriveFleetAddress(currentFleet)) !== fleet.address ||
-        currentFleet.ammoBank.cargoId !== fleet.ammo.id ||
-        currentFleet.ammoBank.amount !== fleet.ammo.amount ||
-        currentFleet.fuelTank.cargoId !== fleet.fuel.id ||
-        currentFleet.fuelTank.amount !== fleet.fuel.amount ||
-        currentFleet.cargoHold.storageCost !== fleet.cargoHold.storageCost ||
-        !sameCargoAmounts(currentFleet.cargoHold.amounts, fleet.cargoHold.items) ||
-        currentFleet.stats.cargo.ammoCapacity !== fleet.capacities.ammo.total ||
-        currentFleet.stats.cargo.fuelCapacity !== fleet.capacities.fuel.total ||
-        currentFleet.stats.cargo.cargoCapacity !== fleet.capacities.cargo.total) {
+        (await deriveFleetAddress(currentFleet)) !== fleet.address) {
         fail(`Fleet ${fleet.name} changed or no longer matches its loaded owner, Game, canonical address, Claim Stake transfer snapshot, cargo, or capacities. Refresh it and retry recovery.`, fleet.address);
     }
-    if (currentStake.game !== game ||
-        currentStake.ownerCharacter !== character ||
-        currentStake.body !== stake.body.address ||
-        currentStake.systemSeqId !== stake.systemSeqId ||
-        currentStake.state.kind !== 'active' ||
-        currentStake.production.cargoPod.storageCost !==
-            stake.resources.capacity.usedRaw ||
-        currentStake.production.resourceCapacityRaw !==
-            stake.resources.capacity.totalRaw ||
-        !sameCargoAmounts(currentStake.production.cargoPod.amounts, stake.resources.inventory.items.map(({ id, quantityRaw }) => ({
-            amount: quantityRaw,
-            id,
-        })))) {
+    if (!sameTransferStake(currentStake, stake, game, character)) {
         fail(`Claim Stake ${stake.address} changed or no longer matches its loaded owner, Game, Body, active state, resources, capacity, or System generation. Refresh it and retry Fleet transfer recovery.`, stake.address);
     }
     let reason;