@aephia/atlas-kit 0.6.0-next.143 → 0.6.0-next.145

package/dist/claim-stakes/actions/index.d.ts

@@ -242,6 +242,13 @@ interface FleetSnapshot extends Omit<ResolvedFleetAccountData, 'ownerProfile'> {
  * The new Claim Stake's rent settlement authority must not exist and stays
  * guarded absent until signing.
  *
+ * The program funds the new stake to its rent floor, the size it can reach
+ * once Deactivated with a cargo line for each resource it produces, and the
+ * Planet's claimed plot from the Profile vault with the signing key. The Plan
+ * bounds that debit; when it is positive the key must be Profile AUTH or hold
+ * `drainSolVault`, and the Profile needs that many lamports above its rent
+ * reserve. Execution checks again before signing.
+ *
  * @example
  * ```ts
  * declare const ctx: SageContext;
@@ -266,6 +273,11 @@ export declare function planPlaceClaimStake(ctx: SageContext, body: CelestialBod
  * the planner checks the fresh Starbase Player pod. Rent synchronization and
  * the final concurrent sequence race remain chain-authoritative.
  *
+ * Entering a design adds the design state and an entry for each building id
+ * the design does not yet hold. The program funds that growth, up to the
+ * stake's rent floor, from the Profile vault with the signing key; the Plan
+ * bounds the debit with the same key and balance checks as placement.
+ *
  * Requires Game 2 and its existing canonical Claim Stake XP ledger.
  * Missing XP state must be repaired outside this Plan; no accounts are created.
  *
@@ -290,6 +302,12 @@ export declare function planClaimStakeBuildingChanges(ctx: SageContext, stake: C
  * CurrencyCache, and a known positive rent balance. Rent timing and the final
  * crew/building validation remain chain-authoritative.
  *
+ * Finalization can draw Profile storage this Plan does not bound: a removed
+ * building's refund can open a Starbase Player cargo line, and a final layout
+ * that produces a new resource raises the stake's rent floor. The program
+ * funds both from the Profile vault with the signing key, so simulate before
+ * signing.
+ *
  * Requires Game 2 and its existing canonical Claim Stake XP ledger.
  * The Character XP budget and configuration must also be reconciled.
  * Missing XP state must be repaired outside this Plan; no accounts are created.
@@ -400,6 +418,12 @@ export declare function planTopUpClaimStakeRent(ctx: SageContext, stake: ClaimSt
  * chain remains authoritative for range, duration, permission bits, concurrent
  * state changes, and transfer arithmetic.
  *
+ * The Fleet stores the requested load and unload lines while the transfer
+ * runs. The program settles the Fleet and stake together: the stake's lamports
+ * above its rent floor fund the Fleet first and the Profile vault, with the
+ * signing key, funds the rest. The Plan bounds that debit with the same key and
+ * balance checks as placement.
+ *
  * Requires Game 2 and its existing canonical Claim Stake XP ledger.
  * Missing XP state must be repaired outside this Plan; no accounts are created.
  *

package/dist/claim-stakes/actions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/claim-stakes/actions/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/claim-stakes/actions/index.ts"],"names":[],"mappings":"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"}

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

@@ -15,6 +15,9 @@ import { deriveProfileFactionAddress, profileFactionIdentityAccountDefinition, }
 import { deriveStarbasePlayerAddress, starbasePlayerAccountDefinition, } from '../../internal/c4/starbase.js';
 import { celestialBodyAccountDefinition, deriveCelestialBodyAddress, deriveStarSystemAddress, starSystemAccountDefinition, } from '../../internal/c4/world.js';
 import { resolveXpRuntime } from '../../internal/planning/xp-runtime.js';
+import { readClaimStakeStorageAction } from '../../internal/planning/claim-stake-storage-actions.js';
+import { RENT_ADDRESS } from '../../internal/planning/rent.js';
+import { planStorageFunding } from '../../internal/planning/storage-actions.js';
 import { requireDisabledStakeRent, requireNewStakeRent, } from '../../internal/planning/rent-catalog.js';
 import { deriveStructureXpAccrualAddress } from '../../internal/c4/pda.js';
 import { requireProfileStarbasePlayer } from '../../internal/planning/starbase-player-owner.js';
@@ -268,6 +271,13 @@ function findHub(configuration, id, game) {
  * The new Claim Stake's rent settlement authority must not exist and stays
  * guarded absent until signing.
  *
+ * The program funds the new stake to its rent floor, the size it can reach
+ * once Deactivated with a cargo line for each resource it produces, and the
+ * Planet's claimed plot from the Profile vault with the signing key. The Plan
+ * bounds that debit; when it is positive the key must be Profile AUTH or hold
+ * `drainSolVault`, and the Profile needs that many lamports above its rent
+ * reserve. Execution checks again before signing.
+ *
  * @example
  * ```ts
  * declare const ctx: SageContext;
@@ -397,7 +407,24 @@ export async function planPlaceClaimStake(ctx, body, player, input) {
         fail(`Character ${character} has ${String(currentCharacter.atlasRaw)} raw ATLAS, below the ${String(placementFee)} raw placement fee plus ${String(rentDeposit)} raw initial rent. Add ATLAS or lower the rent, then retry.`, character);
     const profileFaction = await deriveProfileFactionAddress(options.authorization.profile);
     const currencyCache = await deriveCurrencyCache(game).then(([address]) => address);
-    const description = `Place ${definition.name} on Planet ${body.name} (${body.address}) with bundled hub ${hub.name}, ${String(hub.neededCrew)} crew, a ${String(placementFee)} raw ATLAS placement fee and ${String(rentDeposit)} raw initial rent.`;
+    const instruction = adaptPlaceClaimStakeInstruction({
+        authorization: options.authorization,
+        celestialBody: body.address,
+        character,
+        claimStakeDefinitionId: definition.id,
+        claimStakeInstance: options.claimStake,
+        currencyCache,
+        game,
+        hubBuildingId: hub.id,
+        initialRentAmount: options.initialRentAmount ?? null,
+        profileFaction,
+        rentAuthority: rent.rentAuthority,
+        systemAndStarbasePlayerStarbasePlayer: player.address,
+        systemAndStarbasePlayerSystem: body.system.address,
+    });
+    // The new stake and the claimed plot are funded from the Profile vault.
+    const storage = await planClaimStakeStorage(ctx, instruction, options.authorization.profile, [freshGame.account, currentBodyAccount, currentSystemAccount], 'Claim Stake placement');
+    const description = `Place ${definition.name} on Planet ${body.name} (${body.address}) with bundled hub ${hub.name}, ${String(hub.neededCrew)} crew, a ${String(placementFee)} raw ATLAS placement fee and ${String(rentDeposit)} raw initial rent. ${storage.disclosure}`;
     return buildPlannerPlan({
         kind: 'claim-stakes.place',
         preconditions: [
@@ -410,31 +437,36 @@ export async function planPlaceClaimStake(ctx, body, player, input) {
             ])),
             accountAbsentPrecondition(options.claimStake, 'The caller-supplied Claim Stake signer address remains unallocated.'),
             ...rent.guards,
+            storage.guard,
         ],
         steps: [
             {
                 describes: description,
-                instruction: adaptPlaceClaimStakeInstruction({
-                    authorization: options.authorization,
-                    celestialBody: body.address,
-                    character,
-                    claimStakeDefinitionId: definition.id,
-                    claimStakeInstance: options.claimStake,
-                    currencyCache,
-                    game,
-                    hubBuildingId: hub.id,
-                    initialRentAmount: options.initialRentAmount ?? null,
-                    profileFaction,
-                    rentAuthority: rent.rentAuthority,
-                    systemAndStarbasePlayerStarbasePlayer: player.address,
-                    systemAndStarbasePlayerSystem: body.system.address,
-                }),
+                instruction,
                 signers: [options.authorization.authority, options.claimStake],
             },
         ],
         summary: description,
     });
 }
+/** Plans a Claim Stake action's Profile storage funding from the fresh
+ * accounts the planner already read, plus the Profile and Rent sysvar. */
+async function planClaimStakeStorage(ctx, instruction, profile, known, label) {
+    const [profileAccount, rentAccount] = await readContextRawAccounts(ctx, [
+        profile,
+        RENT_ADDRESS,
+    ]);
+    const accounts = new Map([
+        ...known.map((raw) => [raw.address, raw]),
+        [profile, profileAccount],
+        [RENT_ADDRESS, rentAccount],
+    ]);
+    return planStorageFunding({
+        action: readClaimStakeStorageAction(instruction, accounts),
+        accounts,
+        label,
+    });
+}
 /** The ATLAS placement fee: the Planet's U32F32 base fee for the Starbase
  * level and tier, times the definition's U8F56 multiplier, rounded to the
  * nearest raw unit with halves rounded up. */
@@ -648,6 +680,11 @@ function buildingDescription(change, name) {
  * the planner checks the fresh Starbase Player pod. Rent synchronization and
  * the final concurrent sequence race remain chain-authoritative.
  *
+ * Entering a design adds the design state and an entry for each building id
+ * the design does not yet hold. The program funds that growth, up to the
+ * stake's rent floor, from the Profile vault with the signing key; the Plan
+ * bounds the debit with the same key and balance checks as placement.
+ *
  * Requires Game 2 and its existing canonical Claim Stake XP ledger.
  * Missing XP state must be repaired outside this Plan; no accounts are created.
  *
@@ -862,8 +899,25 @@ export async function planClaimStakeBuildingChanges(ctx, stake, input) {
         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 claimStakeCurrencyCache(game);
-    const description = `Change buildings on Claim Stake ${stake.address}: ${descriptions.join('; ')}.`;
     const xp = await resolveClaimStakeXp(ctx, game, stake.address);
+    const instruction = adaptClaimStakeBuildingChangesInstruction({
+        ...xp.accounts,
+        authorization: options.authorization,
+        buildingChanges: options.buildingChanges.map(({ buildingId, kind, quantity }) => [buildingId, kind === 'add' ? quantity : -quantity]),
+        celestialBody: stake.body.address,
+        claimStakeInstance: stake.address,
+        currencyCache,
+        factionOwnership: ownership,
+        game,
+        profileFaction,
+        ...rent.accounts,
+        sequenceId,
+        starbasePlayer: player,
+        system,
+    });
+    // The grown design is funded from the Profile vault.
+    const storage = await planClaimStakeStorage(ctx, instruction, profile, [stakeAccount], 'Claim Stake building changes');
+    const description = `Change buildings on Claim Stake ${stake.address}: ${descriptions.join('; ')}. ${storage.disclosure}`;
     return buildPlannerPlan({
         kind: 'claim-stakes.building-changes',
         preconditions: [
@@ -879,25 +933,12 @@ export async function planClaimStakeBuildingChanges(ctx, stake, input) {
             ownershipPrecondition,
             xp.guard,
             ...rent.guards,
+            storage.guard,
         ],
         steps: [
             {
                 describes: description,
-                instruction: adaptClaimStakeBuildingChangesInstruction({
-                    ...xp.accounts,
-                    authorization: options.authorization,
-                    buildingChanges: options.buildingChanges.map(({ buildingId, kind, quantity }) => [buildingId, kind === 'add' ? quantity : -quantity]),
-                    celestialBody: stake.body.address,
-                    claimStakeInstance: stake.address,
-                    currencyCache,
-                    factionOwnership: ownership,
-                    game,
-                    profileFaction,
-                    ...rent.accounts,
-                    sequenceId,
-                    starbasePlayer: player,
-                    system,
-                }),
+                instruction,
                 signers: [options.authorization.authority],
             },
         ],
@@ -911,6 +952,12 @@ export async function planClaimStakeBuildingChanges(ctx, stake, input) {
  * CurrencyCache, and a known positive rent balance. Rent timing and the final
  * crew/building validation remain chain-authoritative.
  *
+ * Finalization can draw Profile storage this Plan does not bound: a removed
+ * building's refund can open a Starbase Player cargo line, and a final layout
+ * that produces a new resource raises the stake's rent floor. The program
+ * funds both from the Profile vault with the signing key, so simulate before
+ * signing.
+ *
  * Requires Game 2 and its existing canonical Claim Stake XP ledger.
  * The Character XP budget and configuration must also be reconciled.
  * Missing XP state must be repaired outside this Plan; no accounts are created.
@@ -969,7 +1016,7 @@ export async function planFinalizeClaimStakeBuildingChanges(ctx, stake, input) {
     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 description = `Finalize building changes on Claim Stake ${stake.address}. A building refund that opens a Starbase Player cargo line, or a new resource that raises the stake's rent floor, is funded from the Profile vault with the signing key, which this Plan does not bound; simulate before signing.`;
     const xp = await resolveClaimStakeXp(ctx, game, stake.address, character);
     return buildPlannerPlan({
         kind: 'claim-stakes.finalize-building-changes',
@@ -1368,6 +1415,12 @@ function describeCargoRequests(direction, requests) {
  * chain remains authoritative for range, duration, permission bits, concurrent
  * state changes, and transfer arithmetic.
  *
+ * The Fleet stores the requested load and unload lines while the transfer
+ * runs. The program settles the Fleet and stake together: the stake's lamports
+ * above its rent floor fund the Fleet first and the Profile vault, with the
+ * signing key, funds the rest. The Plan bounds that debit with the same key and
+ * balance checks as placement.
+ *
  * Requires Game 2 and its existing canonical Claim Stake XP ledger.
  * Missing XP state must be repaired outside this Plan; no accounts are created.
  *
@@ -1464,8 +1517,27 @@ export async function planStartClaimStakeFleetTransfer(ctx, fleet, stake, input)
         ...describeCargoRequests('load', options.load),
         ...describeCargoRequests('unload', options.unload),
     ];
-    const description = `Start fleet ${fleet.name}'s transfer to Claim Stake ${stake.address}: ${descriptions.join('; ')}. Loaded cargo, including Fuel and Ammunition, arrives in the Fleet cargo hold; unloads come from the cargo hold only. Range and transfer duration remain chain-authoritative.`;
     const xp = await resolveClaimStakeXp(ctx, game, stake.address);
+    const instruction = adaptStartClaimStakeFleetTransferInstruction({
+        ...xp.accounts,
+        authorization: options.authorization,
+        celestialBody: stake.body.address,
+        character,
+        claimStakeInstance: stake.address,
+        ...(crewCandidate === undefined ? {} : { crewBinding }),
+        currencyCache,
+        fleet: fleet.address,
+        game,
+        ...rent.accounts,
+        systemAndStarbasePlayerStarbasePlayer: player,
+        systemAndStarbasePlayerSystem: system,
+        toLoad: options.load.map(({ amount, cargoId }) => [cargoId, amount]),
+        toUnload: options.unload.map(({ amount, cargoId }) => [cargoId, amount]),
+    });
+    // The Fleet's transfer state is funded first from the stake's surplus over
+    // its rent floor, then from the Profile vault.
+    const storage = await planClaimStakeStorage(ctx, instruction, profile, [fleetAccount, stakeAccount], 'Claim Stake Fleet transfer start');
+    const description = `Start fleet ${fleet.name}'s transfer to Claim Stake ${stake.address}: ${descriptions.join('; ')}. Loaded cargo, including Fuel and Ammunition, arrives in the Fleet cargo hold; unloads come from the cargo hold only. Range and transfer duration remain chain-authoritative. ${storage.disclosure}`;
     return buildPlannerPlan({
         kind: 'claim-stakes.start-fleet-transfer',
         preconditions: [
@@ -1485,29 +1557,12 @@ export async function planStartClaimStakeFleetTransfer(ctx, fleet, stake, input)
             ])),
             currencyGuard,
             ...rent.guards,
+            storage.guard,
         ],
         steps: [
             {
                 describes: description,
-                instruction: adaptStartClaimStakeFleetTransferInstruction({
-                    ...xp.accounts,
-                    authorization: options.authorization,
-                    celestialBody: stake.body.address,
-                    character,
-                    claimStakeInstance: stake.address,
-                    ...(crewCandidate === undefined ? {} : { crewBinding }),
-                    currencyCache,
-                    fleet: fleet.address,
-                    game,
-                    ...rent.accounts,
-                    systemAndStarbasePlayerStarbasePlayer: player,
-                    systemAndStarbasePlayerSystem: system,
-                    toLoad: options.load.map(({ amount, cargoId }) => [cargoId, amount]),
-                    toUnload: options.unload.map(({ amount, cargoId }) => [
-                        cargoId,
-                        amount,
-                    ]),
-                }),
+                instruction,
                 signers: [options.authorization.authority],
             },
         ],