@aephia/atlas-kit 0.6.0-next.17 → 0.6.0-next.171

package/dist/internal/planning/fleet-docking.js

@@ -0,0 +1,106 @@
+import { getAddressEncoder } from '@solana/kit';
+import { SAGE_PROGRAM_ADDRESS, getFactionOwnershipDecoder, getFactionRelationTrackerDecoder, } from '../c4/runtime-bindings.js';
+import { defineAccount } from '../c4/account-decoding.js';
+import { SageSdkError } from '../../client/errors.js';
+import { FACTION_OWNERSHIP_DISCRIMINATOR, FACTION_RELATION_TRACKER_DISCRIMINATOR, } from '../c4/discriminators.js';
+import { deriveFactionRelationTrackerPda, deriveStarbaseOwnershipPda, } from '../c4/factions.js';
+import { factionValue } from '../c4/faction.js';
+import { deriveStarbasePlayerAddress, starbasePlayerAccountDefinition, } from '../c4/starbase.js';
+import { starSystemAccountDefinition } from '../c4/world.js';
+// Reuse the exact generated codecs and shared raw-account validation without
+// bringing unrelated faction gameplay projections into the Plan execution bundle.
+const trackerDefinition = /* @__PURE__ */ defineAccount({
+    type: 'factionRelationTracker',
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    discriminator: FACTION_RELATION_TRACKER_DISCRIMINATOR,
+    length: 78,
+}, getFactionRelationTrackerDecoder, (value) => value);
+const ownershipDefinition = /* @__PURE__ */ defineAccount({
+    type: 'factionOwnership',
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    discriminator: FACTION_OWNERSHIP_DISCRIMINATOR,
+    length: 145,
+    exact: true,
+}, getFactionOwnershipDecoder, (value) => value);
+// Callers pass decoded faction ids 0–3 only.
+const FACTION_NAMES = ['Unaligned', 'MUD', 'ONI', 'Ustur'];
+const factionName = (id) => FACTION_NAMES[id];
+/** Validates the docking admission the program applies, for the cases the SDK
+ * can decide exactly. The legacy Starbase owner, Starbase generation and
+ * Starbase Player faction are decoded from the fresh System and Starbase
+ * Player the instruction docks against, never taken from the saved Plan. A Starbase Player of the controlling faction always
+ * docks, whatever the territory and economics flags. A foreign Starbase
+ * Player is refused while territory access is disabled. Foreign docking under
+ * territory access (relationship and standing) and dynamic-faction operators
+ * stay unsupported. The controller is the legacy Starbase owner unless dynamic
+ * capture is enabled and a current ownership sidecar records another faction;
+ * an uninitialized sidecar means the legacy owner. */
+export async function validateFleetDockingPolicy(accounts, scope) {
+    const invalid = (address, cause) => {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Docking at Star System ${scope.system}: ${cause}. Refresh the indicated faction account for the configured Game and System, verify its current binding version, and recreate the docking Plan.`, { address });
+    };
+    // Every account must be present, non-executable and at its expected address.
+    const read = (raw, address, label) => {
+        if (!raw)
+            invalid(address, `missing ${label} ${address}`);
+        if (raw.executable)
+            invalid(address, `${label} ${address} is executable`);
+        if (raw.address !== address)
+            invalid(address, `${label} ${address} returned account ${raw.address}`);
+        return raw;
+    };
+    const tracker = read(accounts.tracker, scope.address, 'Game faction relation tracker');
+    const [trackerPda, ownershipPda] = await Promise.all([
+        deriveFactionRelationTrackerPda(scope.game),
+        deriveStarbaseOwnershipPda(scope.game, scope.system),
+    ]);
+    const relation = trackerDefinition.decode(tracker);
+    if (relation.version !== 0)
+        invalid(scope.address, `Game faction relation tracker ${scope.address} has unsupported account version ${String(relation.version)}`);
+    if (trackerPda[0] !== scope.address ||
+        relation.bump !== trackerPda[1] ||
+        relation.gameId !== scope.game)
+        invalid(scope.address, `Game faction relation tracker ${scope.address} does not match its canonical Game identity or PDA`);
+    if (ownershipPda[0] !== scope.ownership)
+        invalid(scope.ownership, `System ownership ${scope.ownership} is not the canonical ownership PDA for this System`);
+    const system = starSystemAccountDefinition.decode(read(accounts.system, scope.system, 'Star System'));
+    if (system.game !== scope.game || system.starbase === undefined)
+        invalid(scope.system, `Star System ${scope.system} is not an active Starbase System of this Game`);
+    const player = starbasePlayerAccountDefinition.decode(read(accounts.starbasePlayer, scope.starbasePlayer, 'Starbase Player'));
+    if (player.system !== scope.system ||
+        (await deriveStarbasePlayerAddress(scope.system, player.character)) !==
+            scope.starbasePlayer)
+        invalid(scope.starbasePlayer, `Starbase Player ${scope.starbasePlayer} is not its Character's canonical Starbase Player at this System`);
+    const playerFaction = factionValue(player.faction);
+    // An uninitialized ownership sidecar means the legacy Starbase owner.
+    let controller = factionValue(system.starbase.owner);
+    if (accounts.ownership !== undefined) {
+        const owner = ownershipDefinition.decode(read(accounts.ownership, scope.ownership, 'System ownership'));
+        if (owner.version !== 0)
+            invalid(scope.ownership, `System ownership ${scope.ownership} has unsupported account version ${String(owner.version)}`);
+        if (owner.bump !== ownershipPda[1] ||
+            owner.gameId !== scope.game ||
+            owner.assetKind !== 0 ||
+            !getAddressEncoder()
+                .encode(scope.system)
+                .every((byte, index) => owner.assetKey[index] === byte))
+            invalid(scope.ownership, `System ownership ${scope.ownership} does not match its canonical Game/System identity or PDA`);
+        if (relation.dynamicCaptureEnabled !== 0) {
+            if (owner.capturedSeqId !== system.sequenceId)
+                invalid(scope.ownership, `System ownership ${scope.ownership} records Starbase generation ${String(owner.capturedSeqId)}, not the current ${String(system.sequenceId)}, and the chain refuses docking against a stale ownership record`);
+            if (owner.controllingFaction !== 0)
+                controller = owner.controllingFaction;
+        }
+    }
+    if (controller === playerFaction)
+        return;
+    const unsupported = (cause) => {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Docking at Star System ${scope.system}: ${cause}; the SDK does not model this admission. Dock at a Starbase your faction controls, or simulate and qualify this case separately. Refresh the faction accounts and recreate the Plan after the policy changes.`, { address: scope.address });
+    };
+    if (controller > 3)
+        unsupported(`dynamic faction ${String(controller)} controls this Starbase, and only its configured operator Profile docks without standing`);
+    if (relation.territoryAccessEnabled === 0)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Docking at Star System ${scope.system}: the Starbase is controlled by ${factionName(controller)} and your Starbase Player belongs to ${factionName(playerFaction)}. With territory access disabled only the controlling faction can dock. Dock at a Starbase your faction controls instead.`, { address: scope.address });
+    unsupported(`the Starbase is controlled by ${factionName(controller)}, and foreign docking under territory access depends on diplomacy and standing`);
+}
+//# sourceMappingURL=fleet-docking.js.map

package/dist/internal/planning/fleet-docking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-docking.js","sourceRoot":"","sources":["../../../src/internal/planning/fleet-docking.ts"],"names":[],"mappings":"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"}

package/dist/internal/planning/fleet-rental.d.ts

@@ -0,0 +1,5 @@
+import type { Address } from '@solana/kit';
+/** How a Fleet with a sub-profile is held: the SAGE program address marks a
+ * Fleet listed for rent with no renter; any other address is the renter. */
+export declare function describeFleetRental(subProfile: Address): string;
+//# sourceMappingURL=fleet-rental.d.ts.map

package/dist/internal/planning/fleet-rental.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-rental.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-rental.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C;4EAC4E;AAC5E,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAI/D"}

package/dist/internal/planning/fleet-rental.js

@@ -0,0 +1,9 @@
+import { SAGE_PROGRAM_ADDRESS } from '../c4/runtime-bindings.js';
+/** How a Fleet with a sub-profile is held: the SAGE program address marks a
+ * Fleet listed for rent with no renter; any other address is the renter. */
+export function describeFleetRental(subProfile) {
+    return subProfile === SAGE_PROGRAM_ADDRESS
+        ? 'listed for rent'
+        : `rented to Profile ${subProfile}`;
+}
+//# sourceMappingURL=fleet-rental.js.map

package/dist/internal/planning/fleet-rental.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-rental.js","sourceRoot":"","sources":["../../../src/internal/planning/fleet-rental.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE;4EAC4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,UAAmB;IACrD,OAAO,UAAU,KAAK,oBAAoB;QACxC,CAAC,CAAC,iBAAiB;QACnB,CAAC,CAAC,qBAAqB,UAAU,EAAE,CAAC;AACxC,CAAC"}

package/dist/internal/planning/fleet-respawn.d.ts

@@ -0,0 +1,28 @@
+import { type Address, type Commitment } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+export interface FleetRespawnIntent {
+    readonly phase: 'start' | 'complete';
+    readonly fleet: Address;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly keyIndex: number;
+    readonly system: Address;
+}
+/** Fresh bounded eligibility and debit checks shared by planning and pre-sign validation. */
+export declare function resolveFleetRespawn(ctx: SageContext, input: FleetRespawnIntent, expected?: {
+    readonly fleetHash: string;
+    readonly maximumRecoveryFee: bigint;
+    readonly maximumProfileDebit: bigint;
+}, commitment?: Commitment): Promise<{
+    instruction: import("@solana/kit").Instruction<string, readonly (import("@solana/kit").AccountMeta<string> | import("@solana/kit").AccountLookupMeta<string, string>)[]>;
+    recoveryFee: bigint;
+    profileDebit: bigint;
+    fleetHash: string;
+    inventory: {
+        cargo: readonly import("../c4/fleet.js").FleetCargoAmountData[];
+        ammunition: import("../c4/fleet.js").FleetCargoAmountData;
+        fuel: import("../c4/fleet.js").FleetCargoAmountData;
+    };
+}>;
+//# sourceMappingURL=fleet-respawn.d.ts.map

package/dist/internal/planning/fleet-respawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-respawn.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-respawn.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA2CzE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAOD,6FAA6F;AAC7F,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,CAAC,EAAE;IACT,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC,EACD,UAAU,GAAE,UAAwB;;;;;;;;;;GAuNrC"}

package/dist/internal/planning/fleet-respawn.js

@@ -0,0 +1,164 @@
+import { deriveCurrencyCache, validateCurrencyCache, } from '../c4/currency-cache.js';
+import { isOffCurveAddress } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { requireGameAddress } from '../game-context.js';
+import { readFreshGameShipAssemblyCatalog } from '../../registry/ships.js';
+import { readFreshGameRuntimeVersion } from '../../registry/xp-runtime.js';
+import { fleetAccountDefinition, deriveFleetAddress } from '../c4/fleet.js';
+import { profileAccountDefinition } from '../c4/identity.js';
+import { characterAccountDefinition, findCharacterPda, } from '../c4/character.js';
+import { starSystemAccountDefinition, deriveStarSystemAddress, } from '../c4/world.js';
+import { starbasePlayerAccountDefinition, deriveStarbasePlayerAddress, } from '../c4/starbase.js';
+import { deriveRegionTrackerAddress, regionTrackerAccountDefinition, } from '../c4/factions.js';
+import { deriveFleetCrewBindingAddress, fleetCrewBindingAccountDefinition, matchesFleetCrewBindingIdentity, } from '../c4/fleet-crew-binding.js';
+import { PROFILE_SCOPE, SAGE_SCOPE } from '../c4/profile-permissions.js';
+import { fleetRespawnSize, fleetRespawnInstruction, } from '../c4/fleet-respawn.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+import { RENT_ADDRESS, readRent } from './rent.js';
+import { hashAccountState } from './account-state.js';
+import { directProfileKey, grantsPermission, hasPermissionBit, profileKeyExpired, } from './profile-key.js';
+function fail(message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', `${message} Refresh the Fleet and required recovery accounts, then recreate and inspect the recovery Plan before signing.`);
+}
+/** Fresh bounded eligibility and debit checks shared by planning and pre-sign validation. */
+export async function resolveFleetRespawn(ctx, input, expected, commitment = 'confirmed') {
+    const intent = { ...input };
+    if (requireGameAddress(ctx) !== intent.game ||
+        !['start', 'complete'].includes(intent.phase) ||
+        !Number.isInteger(intent.keyIndex) ||
+        intent.keyIndex < 0 ||
+        intent.keyIndex > 65535 ||
+        isOffCurveAddress(intent.authority))
+        fail('Recovery requires this deployment’s Game and an on-curve direct Profile key with a valid key index.');
+    const [character, regionTracker, crewBinding, [currencyCache]] = await Promise.all([
+        findCharacterPda(intent.profile, intent.game),
+        deriveRegionTrackerAddress(intent.game),
+        deriveFleetCrewBindingAddress(intent.fleet),
+        deriveCurrencyCache(intent.game),
+    ]);
+    const starbasePlayer = await deriveStarbasePlayerAddress(intent.system, character);
+    const addresses = [
+        intent.fleet,
+        intent.profile,
+        intent.system,
+        CLOCK_ADDRESS,
+        RENT_ADDRESS,
+        ...(intent.phase === 'start'
+            ? [character, regionTracker, crewBinding, currencyCache]
+            : [starbasePlayer]),
+    ];
+    const rows = await readContextRawAccounts(ctx, addresses, {
+        commitment,
+    });
+    if (rows.some((raw) => raw?.executable))
+        fail('Recovery account reads contain an executable account.');
+    const accounts = new Map(addresses.map((address, i) => [address, rows[i]]));
+    const required = (address) => accounts.get(address) ?? fail(`Recovery account ${address} is missing.`);
+    const fleetRaw = required(intent.fleet), profileRaw = required(intent.profile);
+    const fleet = fleetAccountDefinition.decode(fleetRaw), profile = profileAccountDefinition.decode(profileRaw), system = starSystemAccountDefinition.decode(required(intent.system));
+    if (fleet.game !== intent.game ||
+        fleet.ownerProfile !== intent.profile ||
+        fleet.npcFactionId !== 0 ||
+        fleet.faction === 'unaligned' ||
+        (await deriveFleetAddress(fleet)) !== intent.fleet ||
+        fleet.subProfile !== '11111111111111111111111111111111')
+        fail('Recovery requires a canonical owned player Fleet without a SubProfile route.');
+    if (system.game !== intent.game ||
+        (await deriveStarSystemAddress(intent.game, system.systemId)) !==
+            intent.system ||
+        system.starbase?.level !== 'css' ||
+        system.starbase.owner !== fleet.faction)
+        fail('Recovery destination must be the canonical same-Game CSS matching the Fleet faction.');
+    const now = readClock(required(CLOCK_ADDRESS)), rent = readRent(required(RENT_ADDRESS));
+    if (fleet.hp <= 0)
+        fail('This recovery route requires a Fleet with positive hull health; use a separately supported destroyed-Fleet recovery route.');
+    if (intent.phase === 'start'
+        ? fleet.state.kind !== 'idle'
+        : fleet.state.kind !== 'respawn' ||
+            now < fleet.state.recoversAtUnixSeconds)
+        fail(intent.phase === 'start'
+            ? 'Recovery start requires a non-destroyed Idle Fleet.'
+            : 'Timed recovery completion requires a Respawn Fleet whose timer has elapsed according to chain time.');
+    const fleetHash = await hashAccountState(fleetRaw.owner, fleetRaw.data);
+    if (expected && fleetHash !== expected.fleetHash)
+        fail('The Fleet changed after this recovery Plan was prepared; its assets or recovery state may differ.');
+    let recoveryFee = 0n;
+    let selectedCrew;
+    if (intent.phase === 'start') {
+        const owner = characterAccountDefinition.decode(required(character));
+        if (owner.playerProfile !== intent.profile || owner.game !== intent.game)
+            fail('Recovery Character does not belong to the selected Profile and Game.');
+        const tracker = regionTrackerAccountDefinition.decode(required(regionTracker));
+        if (tracker.game !== intent.game)
+            fail('Recovery RegionTracker belongs to a different Game.');
+        await validateCurrencyCache(required(currencyCache), intent.game, 'Fleet recovery');
+        const binding = accounts.get(crewBinding);
+        if (binding) {
+            if (!matchesFleetCrewBindingIdentity(fleetCrewBindingAccountDefinition.decode(binding), intent.fleet, intent.profile))
+                fail('Recovery CrewBinding belongs to a different Fleet or Profile.');
+            selectedCrew = crewBinding;
+        }
+        const { catalog, rawAccount } = await readFreshGameShipAssemblyCatalog(ctx, { commitment });
+        if (rawAccount.address !== intent.game ||
+            rawAccount.executable ||
+            rawAccount.slot < fleetRaw.slot)
+            fail('Recovery ship definitions are older than the selected Fleet or belong to a different Game.');
+        if (rawAccount.data[8] !== 2)
+            fail('Recovery start requires the supported current Game runtime.');
+        for (const held of fleet.fleetShips) {
+            const ship = catalog.rows.find((row) => row.id === held.shipId);
+            if (!ship)
+                fail(`Recovery hull definition ${held.shipId} is missing from the current Game.`);
+            recoveryFee += ship.stats.miscStats.recoveryFee * held.quantity;
+        }
+        if (owner.atlasRaw < recoveryFee)
+            fail(`The Character ATLAS vault cannot cover the ${recoveryFee} Floyd recovery fee. Deposit sufficient ATLAS explicitly before preparing recovery.`);
+    }
+    else {
+        if ((await readFreshGameRuntimeVersion(ctx, intent.game, {
+            commitment,
+        })) !== 2)
+            fail('Recovery completion requires the supported current Game runtime.');
+        const player = starbasePlayerAccountDefinition.decode(required(starbasePlayer));
+        if (player.character !== character ||
+            player.playerProfile !== intent.profile ||
+            player.system !== intent.system ||
+            player.faction !== fleet.faction)
+            fail('Recovery CSS StarbasePlayer has a different Profile, Character, System or faction.');
+    }
+    const targetRent = rent(fleetRespawnSize(fleetRaw, intent.phase, intent.system));
+    const profileDebit = targetRent > fleetRaw.lamports ? targetRent - fleetRaw.lamports : 0n;
+    if (expected &&
+        (profileDebit > expected.maximumProfileDebit ||
+            recoveryFee > expected.maximumRecoveryFee))
+        fail('Recovery fees or Profile rent debit now exceed the amounts approved by this Plan.');
+    if (profileRaw.lamports < rent(profileRaw.data.length) + profileDebit)
+        fail('The Profile cannot fund Fleet storage growth while preserving its own rent reserve. Fund the Profile or Fleet explicitly.');
+    const key = directProfileKey(profile.keys, intent.keyIndex, intent.authority);
+    if (!key || profileKeyExpired(key, now))
+        fail('Recovery authority is not the selected current unexpired direct Profile key.');
+    const auth = grantsPermission(key, PROFILE_SCOPE, 0n);
+    if (!auth && !grantsPermission(key, SAGE_SCOPE, 21n))
+        fail('Recovery requires a direct Profile AUTH key or SAGE respawn permission.');
+    if (profileDebit > 0n && !auth && !hasPermissionBit(key, 63n))
+        fail('Recovery storage growth requires Profile vault funding authority. Explicitly prefund the Fleet or choose an authorized drainSolVault key.');
+    return {
+        instruction: fleetRespawnInstruction(intent, {
+            character,
+            regionTracker,
+            currencyCache,
+            starbasePlayer,
+            ...(selectedCrew ? { crewBinding: selectedCrew } : {}),
+        }),
+        recoveryFee,
+        profileDebit,
+        fleetHash,
+        inventory: {
+            cargo: fleet.cargoHold.amounts,
+            ammunition: fleet.ammoBank,
+            fuel: fleet.fuelTank,
+        },
+    };
+}
+//# sourceMappingURL=fleet-respawn.js.map

package/dist/internal/planning/fleet-respawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-respawn.js","sourceRoot":"","sources":["../../../src/internal/planning/fleet-respawn.ts"],"names":[],"mappings":"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"}

package/dist/internal/planning/fleet-ship-assembly.d.ts

@@ -0,0 +1,38 @@
+import { type ShipAssemblyCatalog } from '../../registry/ships.js';
+import { type Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+export interface FleetShipAssemblyIntent {
+    readonly address: Address;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly system: Address;
+    readonly keyIndex: number;
+    readonly shipId: number;
+    readonly amount: bigint;
+}
+export interface FleetShipAssemblyAccounts {
+    readonly game: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly system: Address;
+    readonly character: Address;
+    readonly profileFaction: Address;
+    readonly starbasePlayer: Address;
+    readonly fleet: Address;
+    readonly rent: Address;
+    readonly clock: Address;
+}
+export declare function resolveFleetShipAssembly(input: FleetShipAssemblyIntent): Promise<FleetShipAssemblyAccounts>;
+export declare function validateFleetShipAssembly(input: FleetShipAssemblyIntent, resolved: FleetShipAssemblyAccounts, accounts: ReadonlyMap<Address, RawAccount | undefined>, expected?: {
+    readonly configHash: string;
+    readonly maximumProfileDebit: bigint;
+}, catalog?: ShipAssemblyCatalog): Promise<{
+    profileDebit: bigint;
+    profileReserve: bigint;
+    fleetRent: bigint;
+    configHash: string;
+    /** Components moved from the StarbasePlayer into the Fleet, by cargo id. */
+    components: ReadonlyMap<number, bigint>;
+}>;
+//# sourceMappingURL=fleet-ship-assembly.d.ts.map

package/dist/internal/planning/fleet-ship-assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-ship-assembly.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-ship-assembly.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAgB5D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AACD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,yBAAyB,CAAC,CAkBpC;AAID,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,EAAE,yBAAyB,EACnC,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,EACtD,QAAQ,CAAC,EAAE;IACT,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC,EACD,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC;IACT,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC,CAAC,CA2OD"}

package/dist/internal/planning/fleet-ship-assembly.js

@@ -0,0 +1,167 @@
+import { SYSTEM_PROGRAM } from '../system-program.js';
+import { describeFleetRental } from './fleet-rental.js';
+import { fleetAccountDefinition, deriveFleetAddress } from '../c4/fleet.js';
+import { MAX_COMMANDERS_AND_TITANS_PER_FLEET, MAX_TITANS_PER_FLEET, fleetCapacityPoints, fleetShipAssemblySize, prospectiveShipCounts, shipSizeName, shipSizeRank, starbasePlayerEscrowGrowth, } from '../c4/fleet-ship-assembly.js';
+import { decodeGameShipAssemblyCatalog, hashShipAssemblyConfiguration, } from '../../registry/ships.js';
+import { isOffCurveAddress } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { findCharacterPda } from '../c4/character.js';
+import { deriveProfileFactionAddress } from '../c4/profile-faction.js';
+import { deriveStarbasePlayerAddress } from '../c4/starbase.js';
+import { PROFILE_SCOPE, SAGE_SCOPE } from '../c4/profile-permissions.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+import { RENT_ADDRESS, readRent } from './rent.js';
+import { directProfileKey, grantsPermission, hasPermissionBit, profileKeyExpired, } from './profile-key.js';
+import { readOwnStarbaseFacts } from './own-starbase-facts.js';
+export async function resolveFleetShipAssembly(input) {
+    const intent = { ...input };
+    const [character, profileFaction] = await Promise.all([
+        findCharacterPda(intent.profile, intent.game),
+        deriveProfileFactionAddress(intent.profile),
+    ]);
+    return {
+        game: intent.game,
+        profile: intent.profile,
+        authority: intent.authority,
+        system: intent.system,
+        character,
+        profileFaction,
+        fleet: intent.address,
+        starbasePlayer: await deriveStarbasePlayerAddress(intent.system, character),
+        rent: RENT_ADDRESS,
+        clock: CLOCK_ADDRESS,
+    };
+}
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+export async function validateFleetShipAssembly(input, resolved, accounts, expected, catalog) {
+    const intent = { ...input };
+    if (isOffCurveAddress(intent.authority))
+        fail(intent.profile, 'Ship assembly requires an on-curve direct Profile authority. Select a current direct key and replan.');
+    const required = (address, name) => {
+        const raw = accounts.get(address);
+        if (!raw)
+            fail(address, `${name} ${address} is missing. Create or select the required account, then replan ship assembly.`);
+        if (raw.executable)
+            fail(address, `${name} ${address} is executable. Refresh valid account state before assembling ships.`);
+        return raw;
+    };
+    // The program assembles at any Starbase where the Character has a current
+    // StarbasePlayer of the Fleet's faction, whoever owns the Starbase.
+    const { profileRaw, profile, character, faction, system, player } = await readOwnStarbaseFacts(intent, resolved, required, {
+        replan: 'replan ship assembly',
+        before: 'before assembling ships',
+    }, { anyStarbase: true });
+    if (player.sequenceId !== system.sequenceId)
+        fail(resolved.starbasePlayer, `The StarbasePlayer belongs to Starbase generation ${String(player.sequenceId)}, but the Starbase is at generation ${String(system.sequenceId)}; the program treats it as destroyed. Register a current StarbasePlayer at this Starbase and replan ship assembly.`);
+    const fleetRaw = required(resolved.fleet, 'Fleet');
+    const fleet = fleetAccountDefinition.decode(fleetRaw);
+    if ((await deriveFleetAddress(fleet)) !== intent.address ||
+        fleet.game !== intent.game ||
+        fleet.ownerProfile !== intent.profile ||
+        fleet.faction !== faction.faction ||
+        fleet.npcFactionId !== 0)
+        fail(resolved.fleet, 'The Fleet has a noncanonical address or different Game, Profile, faction or NPC affiliation. Select a canonical owned player Fleet and replan ship assembly.');
+    if (fleet.state.kind !== 'docked' || fleet.state.system !== intent.system)
+        fail(resolved.fleet, 'Ship assembly requires the Fleet to remain Docked at the selected System. Dock at a Starbase where the Character has a current StarbasePlayer and replan.');
+    // A Fleet listed for rent (SAGE address) or rented to a sub-profile is
+    // never given ships by the program.
+    if (fleet.subProfile !== SYSTEM_PROGRAM)
+        fail(resolved.fleet, `The Fleet is ${describeFleetRental(fleet.subProfile)}, and ships cannot be added to it. End the rental, refresh the Fleet, and replan ship assembly.`);
+    // The program needs full AP, SP and HP. HP can only recover from the
+    // pending repair reservoir, so a Fleet whose HP plus reservoir is below its
+    // maximum can never qualify; AP and SP recover on timers and stay
+    // chain-authoritative.
+    if (fleet.hp + fleet.pendingHp < fleet.stats.combat.hp)
+        fail(resolved.fleet, `The Fleet has ${String(fleet.hp)} HP and ${String(fleet.pendingHp)} pending repair, below its ${String(fleet.stats.combat.hp)} maximum, and ships can only be added to a fully repaired Fleet. Repair the Fleet, refresh it, and replan ship assembly.`);
+    const gameRaw = required(resolved.game, 'Game');
+    const definitions = catalog ?? decodeGameShipAssemblyCatalog(gameRaw);
+    if (fleet.shipDefinitionsSeqId !== definitions.sequenceId)
+        fail(resolved.fleet, 'The Fleet was built under older ship definitions. The program resynchronizes it inside the assembly, which can change its stats, and this SDK plans current Fleets only. Plan planSyncFleetWithGame, confirm it, then replan.');
+    const selected = definitions.rows.find((row) => row.id === intent.shipId);
+    if (!selected)
+        fail(resolved.game, `Ship configuration ${String(intent.shipId)} is not in the current Game ship definitions. Select a defined configuration and replan.`);
+    // The program moves each required component, times the ship amount, from
+    // the StarbasePlayer's cargo into the Fleet's components pod; they are
+    // stored, not consumed. A missing or short line makes it refuse.
+    const components = new Map();
+    for (const [cargoId, required] of selected.componentRequirements)
+        components.set(cargoId, BigInt(required) * intent.amount);
+    const held = new Map(player.cargo.amounts.map(({ cargoId, amount }) => [cargoId, amount]));
+    const short = [...components].filter(([cargoId, moved]) => (held.get(cargoId) ?? 0n) < moved);
+    if (short.length > 0)
+        fail(resolved.starbasePlayer, `Ship configuration ${String(intent.shipId)} needs components the StarbasePlayer does not hold: ${short.map(([cargoId, moved]) => `${String(moved)} of cargo ${String(cargoId)} (holds ${String(held.get(cargoId) ?? 0n)})`).join(', ')}. Buy, craft or move them to this StarbasePlayer, or reduce the amount, then replan.`);
+    const size = shipSizeName(selected.sizeClass);
+    const maxSize = character.modifiers.values.maxShipSize;
+    if (selected.sizeClass > shipSizeRank(maxSize))
+        fail(resolved.character, `Ship configuration ${String(intent.shipId)} is ${size}, above the Character's maximum ship size ${maxSize}. Unlock research that raises the maximum ship size, then replan.`);
+    const tags = character.modifiers.values.researchTags;
+    const missing = selected.researchRequirements.filter((tag) => !tags.includes(tag));
+    if (missing.length > 0)
+        fail(resolved.character, `Ship configuration ${String(intent.shipId)} requires every research tag in [${selected.researchRequirements.join(', ')}]; the Character lacks [${missing.join(', ')}]. Unlock the research nodes that grant them, then replan.`);
+    const current = fleet.fleetShips.find((entry) => entry.shipId === intent.shipId)
+        ?.quantity ?? 0n;
+    if (current + intent.amount > 18446744073709551615n)
+        fail(resolved.fleet, 'The resulting Fleet ship quantity exceeds the stored u64 limit. Select a smaller valid quantity and replan.');
+    // The program checks the Fleet's stored ship counts plus the added ships,
+    // never the requirements of ships already aboard.
+    const classes = prospectiveShipCounts(fleet.shipCounts, selected.sizeClass, Number(intent.amount));
+    const points = fleetCapacityPoints(classes);
+    if (points > character.modifiers.values.fleetSize)
+        fail(resolved.character, `The resulting Fleet uses ${String(points)} Fleet points, above the Character's Fleet size ${String(character.modifiers.values.fleetSize)}. Reduce the amount or unlock Fleet-size research, then replan.`);
+    if (points > definitions.maxFleetSize)
+        fail(resolved.game, `The resulting Fleet uses ${String(points)} Fleet points, above the Game's ${String(definitions.maxFleetSize)}-point Fleet limit. Reduce the resulting Fleet composition, then replan; a larger Character allowance does not override it.`);
+    const [commanders, titans] = [classes[6], classes[7]];
+    if (titans > MAX_TITANS_PER_FLEET)
+        fail(resolved.fleet, `The resulting Fleet would hold ${String(titans)} Titans; a Fleet holds at most ${String(MAX_TITANS_PER_FLEET)}. Add the Titan to another Fleet and replan.`);
+    if (commanders + titans > MAX_COMMANDERS_AND_TITANS_PER_FLEET)
+        fail(resolved.fleet, `The resulting Fleet would hold ${String(commanders + titans)} Commander and Titan ships; a Fleet holds at most ${String(MAX_COMMANDERS_AND_TITANS_PER_FLEET)} together. Add the ship to another Fleet and replan.`);
+    // Escrowed hulls of any configuration of the same ship count: the program
+    // re-tags them to the selected configuration.
+    const siblings = new Set(definitions.rows
+        .filter((row) => row.mint === selected.mint)
+        .map((row) => row.id));
+    const entitlement = player.shipsInEscrow
+        .filter((entry) => siblings.has(entry.shipId))
+        .reduce((total, entry) => total + entry.quantityRaw, 0n);
+    if (entitlement < intent.amount)
+        fail(resolved.starbasePlayer, `The StarbasePlayer holds ${String(entitlement)} escrowed hulls of this ship across its configurations, fewer than the ${String(intent.amount)} requested. Explicitly import more of this ship or reduce the amount, then replan.`);
+    const configHash = await hashShipAssemblyConfiguration(definitions, selected);
+    if (expected && expected.configHash !== configHash)
+        fail(resolved.game, 'The selected ship configuration has changed. Replan and inspect its current configuration before signing.');
+    const rent = readRent(required(resolved.rent, 'Rent sysvar'));
+    const now = readClock(required(resolved.clock, 'Clock sysvar'));
+    const fleetRent = rent(fleetShipAssemblySize(fleetRaw, intent.shipId, intent.amount, components));
+    const shortfall = (raw, minimum) => raw.lamports < minimum ? minimum - raw.lamports : 0n;
+    // The program funds the Fleet, StarbasePlayer and Character as one group.
+    // Re-tagging adds an escrow entry when the configuration has none, and its
+    // cost is counted in full. A component line the move empties shrinks the
+    // StarbasePlayer, but that refund is not credited, so the debit stays an
+    // upper bound. A StarbasePlayer already below its rent minimum is left out,
+    // as a combined ship import funds that shortfall first.
+    const playerRaw = required(resolved.starbasePlayer, 'StarbasePlayer');
+    const profileDebit = shortfall(fleetRaw, fleetRent) +
+        rent(playerRaw.data.length +
+            starbasePlayerEscrowGrowth(playerRaw, intent.shipId)) -
+        rent(playerRaw.data.length);
+    if (expected !== undefined && profileDebit > expected.maximumProfileDebit)
+        fail(resolved.profile, 'Ship assembly now requires a larger Profile debit than this Plan approved. Replan and inspect the updated rent shortfall before signing.');
+    const profileReserve = rent(profileRaw.data.length);
+    if (profileRaw.lamports < profileReserve + profileDebit)
+        fail(resolved.profile, 'The Profile lacks the Fleet rent shortfall while preserving its own rent reserve. Fund the Profile or Fleet target explicitly, then replan.');
+    const key = directProfileKey(profile.keys, intent.keyIndex, intent.authority);
+    if (!key)
+        fail(resolved.profile, 'The selected direct Profile key is absent or belongs to another authority. Select the current key index for this authority and replan.');
+    if (profileKeyExpired(key, now))
+        fail(resolved.profile, 'The selected Profile key has expired. Renew it or select a current direct key and replan ship assembly.');
+    const auth = grantsPermission(key, PROFILE_SCOPE, 0n);
+    const manages = grantsPermission(key, SAGE_SCOPE, 18n) ||
+        grantsPermission(key, intent.address, 18n);
+    if (!auth && !manages)
+        fail(resolved.profile, 'The selected key cannot manage Fleets. Use a direct Profile AUTH key or a manageFleet key scoped to SAGE or this Fleet, and replan.');
+    if (profileDebit > 0n && !auth && !hasPermissionBit(key, 63n))
+        fail(resolved.profile, 'The selected manageFleet key cannot fund the Fleet from the Profile vault. Explicitly prefund the target or choose an authorized vault-funding key, then replan; drainSolVault grants vault withdrawal authority.');
+    return { profileDebit, profileReserve, fleetRent, configHash, components };
+}
+//# sourceMappingURL=fleet-ship-assembly.js.map

package/dist/internal/planning/fleet-ship-assembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-ship-assembly.js","sourceRoot":"","sources":["../../../src/internal/planning/fleet-ship-assembly.ts"],"names":[],"mappings":"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"}

package/dist/internal/planning/fleet-state.d.ts

@@ -0,0 +1,25 @@
+import type { Address } from '@solana/kit';
+import type { FleetStateData } from '../c4/fleet.js';
+import type { WorldCoordinates } from '../c4/world.js';
+type LeavableFleetState = Exclude<FleetStateData['kind'], 'idle'>;
+interface NamedFleet {
+    readonly address: Address;
+    readonly name: string;
+}
+/** Rejects a Fleet whose `state` cannot start `action`, stating the
+ * `requirement` and the first step out of that state. */
+export declare function failFleetState(fleet: NamedFleet, state: LeavableFleetState, action: string, requirement: string): never;
+/** The coordinate an idle or moving Fleet acts from: its location when idle,
+ * else its warp or subwarp destination. Other states fail with `action` and
+ * `requirement`. */
+export declare function requireActionCoordinate(fleet: NamedFleet & {
+    readonly location: WorldCoordinates;
+    readonly state: {
+        readonly kind: 'warp' | 'subwarp';
+        readonly to: WorldCoordinates;
+    } | {
+        readonly kind: Exclude<FleetStateData['kind'], 'warp' | 'subwarp'>;
+    };
+}, action: string, requirement: string): WorldCoordinates;
+export {};
+//# sourceMappingURL=fleet-state.d.ts.map