@aephia/atlas-kit 0.6.0-next.10 → 0.6.0-next.101

package/dist/internal/c4/fleet-arrival.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-arrival.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/fleet-arrival.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,uBAAuB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,uBAAuB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN,oFAAoF;AACpF,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,UAAU;;;;;;;GAuC3D"}

package/dist/internal/c4/fleet-arrival.js

@@ -0,0 +1,42 @@
+import { getFleetDecoder } from '@staratlas/dev-sage';
+import { fleetAccountDefinition, deriveFleetAddress } from './fleet.js';
+/** Preserve generated fixed-point fields without round-tripping display numbers. */
+export async function decodeFleetArrival(account) {
+    // Existing adapter owns exact account validation and retained PDA label seeds.
+    const fleet = fleetAccountDefinition.decode(account);
+    const canonical = await deriveFleetAddress(fleet);
+    const exact = getFleetDecoder().decode(account.data);
+    const coordinates = (values) => ({ x: values[0].raw, y: values[1].raw });
+    let journey;
+    if (exact.state.__kind === 'MoveSubwarp') {
+        const value = exact.state.fields[0].journey;
+        journey = {
+            kind: 'subwarp',
+            from: coordinates(value.from),
+            to: coordinates(value.to),
+            departure: value.departureTime,
+            duration: value.duration.raw,
+        };
+    }
+    else if (exact.state.__kind === 'MoveWarp') {
+        const value = exact.state.fields[0];
+        journey = {
+            kind: 'warp',
+            from: coordinates(exact.location),
+            to: coordinates(value.to),
+            departure: value.warpStart,
+            arrival: value.warpFinish,
+        };
+    }
+    return {
+        game: fleet.game,
+        profile: fleet.ownerProfile,
+        canonical,
+        subProfile: fleet.subProfile,
+        journey,
+        lowFuel: exact.state.__kind === 'MoveSubwarp' &&
+            exact.fuelTank.amount << 56n <
+                exact.state.fields[0].totalFuelExpenditure.raw,
+    };
+}
+//# sourceMappingURL=fleet-arrival.js.map

package/dist/internal/c4/fleet-arrival.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-arrival.js","sourceRoot":"","sources":["../../../src/internal/c4/fleet-arrival.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAsBxE,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAmB;IAC1D,+EAA+E;IAC/E,MAAM,KAAK,GAAG,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,CAClB,MAA6B,EACJ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IACzE,IAAI,OAAwC,CAAC;IAC7C,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5C,OAAO,GAAG;YACR,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;YAC7B,EAAE,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,SAAS,EAAE,KAAK,CAAC,aAAa;YAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG;SAC7B,CAAC;IACJ,CAAC;SAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpC,OAAO,GAAG;YACR,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC;YACjC,EAAE,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,UAAU;SAC1B,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,YAAY;QAC3B,SAAS;QACT,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO;QACP,OAAO,EACL,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,aAAa;YACpC,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG;gBAC1B,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,GAAG;KACnD,CAAC;AACJ,CAAC"}

package/dist/internal/c4/fleet-creation.d.ts

@@ -0,0 +1,7 @@
+import { type Address, type Instruction } from '@solana/kit';
+import type { FleetCreationAccounts, FleetCreationIntent } from '../planning/fleet-creation.js';
+export declare function deriveFleetCreationAddress(game: Address, profile: Address, label: string): Promise<Address>;
+/** Allocation is computed from the pinned empty Docked wire shape, not a decoder minimum or captured rent rate. Fixed-size fields use zero values only for sizing. */
+export declare function emptyDockedFleetSize(): number;
+export declare function createFleetInstruction(input: FleetCreationIntent, accounts: FleetCreationAccounts): Instruction;
+//# sourceMappingURL=fleet-creation.d.ts.map

package/dist/internal/c4/fleet-creation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-creation.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/fleet-creation.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,OAAO,EACZ,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAQrB,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AACvC,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAclB;AACD,sKAAsK;AACtK,wBAAgB,oBAAoB,IAAI,MAAM,CAqI7C;AACD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,qBAAqB,GAC9B,WAAW,CA2Bb"}

package/dist/internal/c4/fleet-creation.js

@@ -0,0 +1,180 @@
+import { AccountRole, getAddressEncoder, getProgramDerivedAddress, } from '@solana/kit';
+import { SAGE_PROGRAM_ADDRESS, getNameEncoder, getFleetEncoder, getCreateFleetInstructionDataEncoder, } from '@staratlas/dev-sage';
+import { PLAYER_PROFILE_PROGRAM_ADDRESS } from '@staratlas/dev-player-profile';
+export async function deriveFleetCreationAddress(game, profile, label) {
+    const name = getNameEncoder().encode(label);
+    return (await getProgramDerivedAddress({
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        seeds: [
+            new TextEncoder().encode('Fleet'),
+            getAddressEncoder().encode(game),
+            getAddressEncoder().encode(profile),
+            name.slice(0, 32),
+            name.slice(32),
+        ],
+    }))[0];
+}
+/** Allocation is computed from the pinned empty Docked wire shape, not a decoder minimum or captured rent rate. Fixed-size fields use zero values only for sizing. */
+export function emptyDockedFleetSize() {
+    const zero = '11111111111111111111111111111111';
+    const cargo = { seqId: 0, storageCost: 0n, amounts: new Map() };
+    return getFleetEncoder().encode({
+        version: 0,
+        bump: 0,
+        gameId: zero,
+        ownerProfile: zero,
+        subProfile: zero,
+        subProfileInvalidator: zero,
+        faction: 0,
+        npcFactionId: 0,
+        fleetLabel: '',
+        shipCounts: {
+            total: 0,
+            xxSmall: 0,
+            xSmall: 0,
+            small: 0,
+            medium: 0,
+            large: 0,
+            capital: 0,
+            commander: 0,
+            titan: 0,
+        },
+        warpCooldownExpiresAt: 0n,
+        scanCooldownExpiresAt: 0n,
+        stats: {
+            movementStats: {
+                subwarpSpeed: 0,
+                warpSpeed: 0,
+                warpLaneSpeed: 0,
+                maxWarpDistance: 0,
+                warpCoolDown: 0,
+                subwarpFuelConsumptionRate: 0,
+                warpFuelConsumptionRate: 0,
+                planetExitFuelAmount: 0,
+                warpXpRate: 0,
+                subwarpXpRate: 0,
+            },
+            cargoStats: {
+                cargoCapacity: 0,
+                fuelCapacity: 0,
+                ammoCapacity: 0,
+                ammoConsumptionRate: 0,
+                foodConsumptionRate: 0,
+                miningRate: 0,
+                loadRate: 0,
+            },
+            combatStats: {
+                ap: 0,
+                hp: 0,
+                sp: 0,
+                ammoConsumptionRate: 0,
+                apRegenRate: 0,
+                shieldRechargeRate: 0,
+                repairRate: 0,
+                repairAbility: 0,
+                repairEfficiency: 0,
+                repairCost: 0,
+                lootRate: 0,
+                shieldBreakDelay: 0,
+                warpSpoolTime: 0,
+                damageKinetic: 0,
+                damageKineticVariance: 0,
+                damageEnergy: 0,
+                damageEnergyVariance: 0,
+                damageEmp: 0,
+                damageEmpVariance: 0,
+                damageSuperchill: 0,
+                damageSuperchillVariance: 0,
+                damageShockwave: 0,
+                damageShockwaveVariance: 0,
+                damageGraygoo: 0,
+                damageGraygooVariance: 0,
+                damageHeat: 0,
+                damageHeatVariance: 0,
+                damageBomb: 0,
+                damageBombVariance: 0,
+                counterDecoy: 0,
+                counterEnergyCapacitor: 0,
+                counterFireSuppressor: 0,
+                counterFlare: 0,
+                counterHealingNanobots: 0,
+                counterMine: 0,
+                counterNegativeRemPlating: 0,
+                counterWarmingPlates: 0,
+                counterFaradayShielding: 0,
+                stealthPower: 0,
+                hitChance: 0,
+                aimAbility: 0,
+                critChance: 0,
+                critMultiplier: 0,
+                fuelConsumptionRate: 0,
+                missileDamage: 0,
+                missileFireRate: 0,
+            },
+            miscStats: {
+                requiredCrew: 0,
+                passengerCapacity: 0,
+                respawnTimeWithoutFee: 0,
+                respawnTimeWithFee: 0,
+                recoveryFee: 0,
+                scanCoolDown: 0,
+                scanPower: 0,
+                scanCost: 0,
+                scanBonus: 0,
+                lpValue: 0,
+                medallionValue: 0,
+                xpValue: 0,
+            },
+        },
+        fuelTank: { cargoId: 0, amount: 0n },
+        ammoBank: { cargoId: 0, amount: 0n },
+        crewCount: 0,
+        rentedCrew: 0,
+        shipDefinitionsSeqId: 0,
+        ap: 0,
+        sp: 0,
+        hp: 0,
+        pendingHp: 0,
+        stance: { ammoUsage: 0 },
+        apReloadExpiresAt: 0n,
+        shieldBreakDelayExpiresAt: 0n,
+        lastCombatUpdate: 0n,
+        location: [0, 0],
+        lastUpdateAt: 0n,
+        fleetShips: new Map(),
+        respawningCargo: cargo,
+        components: cargo,
+        cargoHold: cargo,
+        activeStimulants: new Map(),
+        state: { __kind: 'Docked', fields: [{ system: zero, systemSeqId: 0n }] },
+    }).length;
+}
+export function createFleetInstruction(input, accounts) {
+    return {
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        accounts: [
+            { address: input.authority, role: AccountRole.READONLY_SIGNER },
+            { address: input.profile, role: AccountRole.WRITABLE },
+            { address: SAGE_PROGRAM_ADDRESS, role: AccountRole.READONLY },
+            {
+                address: PLAYER_PROFILE_PROGRAM_ADDRESS,
+                role: AccountRole.READONLY,
+            },
+            { address: accounts.profileFaction, role: AccountRole.READONLY },
+            { address: accounts.character, role: AccountRole.WRITABLE },
+            { address: input.game, role: AccountRole.READONLY },
+            { address: accounts.fleet, role: AccountRole.WRITABLE },
+            { address: input.system, role: AccountRole.READONLY },
+            { address: accounts.starbasePlayer, role: AccountRole.WRITABLE },
+            {
+                address: '11111111111111111111111111111111',
+                role: AccountRole.READONLY,
+            },
+        ],
+        data: getCreateFleetInstructionDataEncoder().encode({
+            fleetLabel: input.label,
+            keyIndex: input.keyIndex,
+        }),
+    };
+}
+//# sourceMappingURL=fleet-creation.js.map

package/dist/internal/c4/fleet-creation.js.map

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

package/dist/internal/c4/fleet-crew-binding.d.ts

@@ -4,9 +4,18 @@ import type { C4AccountAdapter } from './adapter.js';
 export interface FleetCrewBindingAccountData {
     readonly fleet: Address;
     readonly ownerProfile: Address;
+    /** Exact empty body created by the deployed fungible-only roster path. */
+    readonly isNeutral: boolean;
 }
 /** Minimal validated internal definition; no public crew domain is exposed. */
 export declare const fleetCrewBindingAccountDefinition: C4AccountAdapter<FleetCrewBindingAccountData>;
+/**
+ * Matches validated binding identity: only the exact all-zero 395-byte body
+ * waives stored Fleet/Profile equality. Alternative empty encodings (including
+ * nonzero version, bump or lastActionEpoch) are unsupported. Callers must still
+ * require the canonical Fleet-only PDA; neutral status never waives that check.
+ */
+export declare function matchesFleetCrewBindingIdentity(data: FleetCrewBindingAccountData, fleet: Address, ownerProfile: Address): boolean;
 /** Derives the canonical Fleet-only FleetCrewBinding PDA. */
 export declare function deriveFleetCrewBindingAddress(fleet: Address): Promise<Address>;
 //# sourceMappingURL=fleet-crew-binding.d.ts.map

package/dist/internal/c4/fleet-crew-binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fleet-crew-binding.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/fleet-crew-binding.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,2BAA2B,CAAC;AAMrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAUrD,gFAAgF;AAChF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAgCD,+EAA+E;AAC/E,eAAO,MAAM,iCAAiC,EAAE,gBAAgB,CAAC,2BAA2B,CAexF,CAAC;AAEL,6DAA6D;AAC7D,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CASlB"}
+{"version":3,"file":"fleet-crew-binding.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/fleet-crew-binding.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,2BAA2B,CAAC;AAMrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAUrD,gFAAgF;AAChF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAgCD,+EAA+E;AAC/E,eAAO,MAAM,iCAAiC,EAAE,gBAAgB,CAAC,2BAA2B,CAoBxF,CAAC;AAEL;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,2BAA2B,EACjC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,OAAO,GACpB,OAAO,CAKT;AAED,6DAA6D;AAC7D,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CASlB"}

package/dist/internal/c4/fleet-crew-binding.js

@@ -2,10 +2,11 @@ import { FLEET_CREW_BINDING_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, getFleetCrewBin
 import { getAddressEncoder, getBytesEncoder, getProgramDerivedAddress, } from '@solana/kit';
 import { AccountDecodeError, InvalidAccountOwnerError, InvalidDiscriminatorError, } from '../../client/errors.js';
 const FLEET_CREW_BINDING_ACCOUNT_LENGTH = 403;
-const FLEET_CREW_BINDING_PDA_PREFIX = new Uint8Array([
+const FLEET_CREW_BINDING_PDA_PREFIX = /* @__PURE__ */ new Uint8Array([
     70, 108, 101, 101, 116, 67, 114, 101, 119, 66, 105, 110, 100, 105, 110, 103,
 ]);
-const DISCRIMINATOR = Object.freeze(Array.from(FLEET_CREW_BINDING_DISCRIMINATOR));
+const DISCRIMINATOR = /* @__PURE__ */ Object.freeze(
+/* @__PURE__ */ Array.from(FLEET_CREW_BINDING_DISCRIMINATOR));
 function validateFleetCrewBindingAccount(account) {
     if (account.owner !== SAGE_PROGRAM_ADDRESS) {
         throw new InvalidAccountOwnerError('fleetCrewBinding', account.address, SAGE_PROGRAM_ADDRESS, account.owner);
@@ -22,13 +23,19 @@ function decodeExactly(account) {
     return getFleetCrewBindingDecoder().decode(account.data);
 }
 /** Minimal validated internal definition; no public crew domain is exposed. */
-export const fleetCrewBindingAccountDefinition = Object.freeze({
+export const fleetCrewBindingAccountDefinition = 
+/* @__PURE__ */ Object.freeze({
     decode(account) {
         validateFleetCrewBindingAccount(account);
         const decoded = decodeExactly(account);
         return {
             fleet: decoded.fleet,
             ownerProfile: decoded.ownerProfile,
+            // #489: zero identities alone are insufficient; the entire validated
+            // body must match the chain-created neutral encoding.
+            isNeutral: account.data
+                .subarray(DISCRIMINATOR.length)
+                .every((byte) => byte === 0),
         };
     },
     discriminator: DISCRIMINATOR,
@@ -37,6 +44,16 @@ export const fleetCrewBindingAccountDefinition = Object.freeze({
     type: 'fleetCrewBinding',
     validate: validateFleetCrewBindingAccount,
 });
+/**
+ * Matches validated binding identity: only the exact all-zero 395-byte body
+ * waives stored Fleet/Profile equality. Alternative empty encodings (including
+ * nonzero version, bump or lastActionEpoch) are unsupported. Callers must still
+ * require the canonical Fleet-only PDA; neutral status never waives that check.
+ */
+export function matchesFleetCrewBindingIdentity(data, fleet, ownerProfile) {
+    return (data.isNeutral ||
+        (data.fleet === fleet && data.ownerProfile === ownerProfile));
+}
 /** Derives the canonical Fleet-only FleetCrewBinding PDA. */
 export async function deriveFleetCrewBindingAddress(fleet) {
     const [address] = await getProgramDerivedAddress({

package/dist/internal/c4/fleet-crew-binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"fleet-crew-binding.js","sourceRoot":"","sources":["../../../src/internal/c4/fleet-crew-binding.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,oBAAoB,EACpB,0BAA0B,GAE3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAGhC,MAAM,iCAAiC,GAAG,GAAG,CAAC;AAC9C,MAAM,6BAA6B,GAAG,IAAI,UAAU,CAAC;IACnD,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CAC5E,CAAC,CAAC;AACH,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CACjC,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAC7C,CAAC;AAQF,SAAS,+BAA+B,CAAC,OAAmB;IAC1D,IAAI,OAAO,CAAC,KAAK,KAAK,oBAAoB,EAAE,CAAC;QAC3C,MAAM,IAAI,wBAAwB,CAChC,kBAAkB,EAClB,OAAO,CAAC,OAAO,EACf,oBAAoB,EACpB,OAAO,CAAC,KAAK,CACd,CAAC;IACJ,CAAC;IACD,IACE,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM;QAC1C,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,EACjE,CAAC;QACD,MAAM,IAAI,yBAAyB,CAAC,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,iCAAiC,EAAE,CAAC;QAC9D,MAAM,IAAI,kBAAkB,CAC1B,kBAAkB,EAClB,OAAO,CAAC,OAAO,EACf,IAAI,UAAU,CACZ,oBAAoB,MAAM,CAAC,iCAAiC,CAAC,6CAA6C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CACzI,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAmB;IACxC,OAAO,0BAA0B,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iCAAiC,GAC5C,MAAM,CAAC,MAAM,CAAC;IACZ,MAAM,CAAC,OAAmB;QACxB,+BAA+B,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO;YACL,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC;IACJ,CAAC;IACD,aAAa,EAAE,aAAa;IAC5B,iBAAiB,EAAE,iCAAiC;IACpD,cAAc,EAAE,oBAAoB;IACpC,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,+BAA+B;CAC1C,CAAC,CAAC;AAEL,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,KAAc;IAEd,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,wBAAwB,CAAC;QAC/C,cAAc,EAAE,oBAAoB;QACpC,KAAK,EAAE;YACL,eAAe,EAAE,CAAC,MAAM,CAAC,6BAA6B,CAAC;YACvD,iBAAiB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;SAClC;KACF,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"fleet-crew-binding.js","sourceRoot":"","sources":["../../../src/internal/c4/fleet-crew-binding.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,oBAAoB,EACpB,0BAA0B,GAE3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAGhC,MAAM,iCAAiC,GAAG,GAAG,CAAC;AAC9C,MAAM,6BAA6B,GAAG,eAAe,CAAC,IAAI,UAAU,CAAC;IACnE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CAC5E,CAAC,CAAC;AACH,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM;AACjD,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAC7D,CAAC;AAUF,SAAS,+BAA+B,CAAC,OAAmB;IAC1D,IAAI,OAAO,CAAC,KAAK,KAAK,oBAAoB,EAAE,CAAC;QAC3C,MAAM,IAAI,wBAAwB,CAChC,kBAAkB,EAClB,OAAO,CAAC,OAAO,EACf,oBAAoB,EACpB,OAAO,CAAC,KAAK,CACd,CAAC;IACJ,CAAC;IACD,IACE,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM;QAC1C,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,EACjE,CAAC;QACD,MAAM,IAAI,yBAAyB,CAAC,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,iCAAiC,EAAE,CAAC;QAC9D,MAAM,IAAI,kBAAkB,CAC1B,kBAAkB,EAClB,OAAO,CAAC,OAAO,EACf,IAAI,UAAU,CACZ,oBAAoB,MAAM,CAAC,iCAAiC,CAAC,6CAA6C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CACzI,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAmB;IACxC,OAAO,0BAA0B,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iCAAiC;AAC5C,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,MAAM,CAAC,OAAmB;QACxB,+BAA+B,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO;YACL,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,qEAAqE;YACrE,sDAAsD;YACtD,SAAS,EAAE,OAAO,CAAC,IAAI;iBACpB,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC;iBAC9B,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC;SAC/B,CAAC;IACJ,CAAC;IACD,aAAa,EAAE,aAAa;IAC5B,iBAAiB,EAAE,iCAAiC;IACpD,cAAc,EAAE,oBAAoB;IACpC,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,+BAA+B;CAC1C,CAAC,CAAC;AAEL;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,IAAiC,EACjC,KAAc,EACd,YAAqB;IAErB,OAAO,CACL,IAAI,CAAC,SAAS;QACd,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,YAAY,KAAK,YAAY,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,KAAc;IAEd,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,wBAAwB,CAAC;QAC/C,cAAc,EAAE,oBAAoB;QACpC,KAAK,EAAE;YACL,eAAe,EAAE,CAAC,MAAM,CAAC,6BAA6B,CAAC;YACvD,iBAAiB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;SAClC;KACF,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,17 @@
+import { type Address, type Instruction } from '@solana/kit';
+import { SAGE_PROGRAM_ADDRESS } from '@staratlas/dev-sage';
+import type { RawAccount } from '../../client/contracts.js';
+import type { FleetRespawnIntent } from '../planning/fleet-respawn.js';
+export { SAGE_PROGRAM_ADDRESS };
+/** Sizes only the audited state transition while preserving every stored variable collection. */
+export declare function fleetRespawnSize(raw: RawAccount, phase: FleetRespawnIntent['phase'], system: Address): number;
+export interface FleetRespawnAccounts {
+    readonly character: Address;
+    readonly regionTracker: Address;
+    readonly currencyCache: Address;
+    readonly crewBinding?: Address;
+    readonly starbasePlayer: Address;
+}
+/** Address-only pinned instructions: no signer object is created or retained. */
+export declare function fleetRespawnInstruction(intent: FleetRespawnIntent, accounts: FleetRespawnAccounts): Instruction;
+//# sourceMappingURL=fleet-respawn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-respawn.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/fleet-respawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EACL,oBAAoB,EAKrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAChC,iGAAiG;AACjG,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAClC,MAAM,EAAE,OAAO,GACd,MAAM,CAiBR;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AACD,iFAAiF;AACjF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,oBAAoB,GAC7B,WAAW,CAyCb"}

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

@@ -0,0 +1,62 @@
+import { AccountRole } from '@solana/kit';
+import { SAGE_PROGRAM_ADDRESS, getFleetDecoder, getFleetEncoder, getIdleToRespawnInstructionDataEncoder, getRespawnToDockedInstructionDataEncoder, } from '@staratlas/dev-sage';
+import { PLAYER_PROFILE_PROGRAM_ADDRESS } from '@staratlas/dev-player-profile';
+import { SageSdkError } from '../../client/errors.js';
+export { SAGE_PROGRAM_ADDRESS };
+/** Sizes only the audited state transition while preserving every stored variable collection. */
+export function fleetRespawnSize(raw, phase, system) {
+    const fleet = getFleetDecoder().decode(raw.data);
+    if (getFleetEncoder().encode(fleet).length !== raw.data.length)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Recovery Fleet collections cannot be re-encoded losslessly. Refresh a canonical Fleet and recreate the Plan.');
+    return getFleetEncoder().encode({
+        ...fleet,
+        state: phase === 'start'
+            ? {
+                __kind: 'Respawn',
+                fields: [{ start: 0n, end: 0n, wasInLowRiskZone: false }],
+            }
+            : { __kind: 'Docked', fields: [{ system, systemSeqId: 0n }] },
+    }).length;
+}
+/** Address-only pinned instructions: no signer object is created or retained. */
+export function fleetRespawnInstruction(intent, accounts) {
+    const readonly = (address) => ({
+        address,
+        role: AccountRole.READONLY,
+    });
+    const writable = (address) => ({
+        address,
+        role: AccountRole.WRITABLE,
+    });
+    const common = [
+        { address: intent.authority, role: AccountRole.READONLY_SIGNER },
+        writable(intent.profile),
+        readonly(SAGE_PROGRAM_ADDRESS),
+        readonly(PLAYER_PROFILE_PROGRAM_ADDRESS),
+    ];
+    return {
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        accounts: intent.phase === 'start'
+            ? [
+                ...common,
+                writable(accounts.character),
+                writable(intent.fleet),
+                readonly(intent.system),
+                readonly(accounts.regionTracker),
+                readonly(intent.game),
+                writable(accounts.currencyCache),
+                readonly(accounts.crewBinding ?? SAGE_PROGRAM_ADDRESS),
+            ]
+            : [
+                ...common,
+                writable(intent.fleet),
+                readonly(intent.game),
+                readonly(intent.system),
+                readonly(accounts.starbasePlayer),
+            ],
+        data: (intent.phase === 'start'
+            ? getIdleToRespawnInstructionDataEncoder()
+            : getRespawnToDockedInstructionDataEncoder()).encode({ keyIndex: intent.keyIndex }),
+    };
+}
+//# sourceMappingURL=fleet-respawn.js.map

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

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

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

@@ -0,0 +1,11 @@
+import { type Instruction } from '@solana/kit';
+import { type Ship } from '@staratlas/dev-sage';
+import type { RawAccount } from '../../client/contracts.js';
+import type { FleetShipAssemblyIntent, FleetShipAssemblyAccounts } from '../planning/fleet-ship-assembly.js';
+/** Finite supported assembly configuration; all other eligibility remains outside this route. */
+export declare function isBasicFleetAssemblyShip(ship: Ship | undefined): ship is Ship;
+/** Sizes the complete already-validated pinned Fleet encoding, preserving every variable field and zero-valued map entry. */
+export declare function fleetShipAssemblySize(raw: RawAccount, shipId: number, amount: bigint): number;
+/** Audited singleton instruction with deployment-tested inert legacy indices. */
+export declare function addShipToFleetInstruction(input: FleetShipAssemblyIntent, accounts: FleetShipAssemblyAccounts): Instruction;
+//# sourceMappingURL=fleet-ship-assembly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-ship-assembly.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/fleet-ship-assembly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAGL,KAAK,IAAI,EAIV,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,oCAAoC,CAAC;AAC5C,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,IAAI,IAAI,CAO7E;AACD,6HAA6H;AAC7H,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAYR;AACD,iFAAiF;AACjF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,EAAE,yBAAyB,GAClC,WAAW,CAqBb"}

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

@@ -0,0 +1,44 @@
+import { AccountRole } from '@solana/kit';
+import { SAGE_PROGRAM_ADDRESS, SizeClass, getAddShipToFleetInstructionDataEncoder, getFleetDecoder, getFleetEncoder, } from '@staratlas/dev-sage';
+import { PLAYER_PROFILE_PROGRAM_ADDRESS } from '@staratlas/dev-player-profile';
+import { AccountDecodeError } from '../../client/errors.js';
+/** Finite supported assembly configuration; all other eligibility remains outside this route. */
+export function isBasicFleetAssemblyShip(ship) {
+    return (ship !== undefined &&
+        ship.sizeClass === SizeClass.XxSmall &&
+        ship.researchRequirements.length === 0 &&
+        ship.componentRequirements.size === 0);
+}
+/** Sizes the complete already-validated pinned Fleet encoding, preserving every variable field and zero-valued map entry. */
+export function fleetShipAssemblySize(raw, shipId, amount) {
+    const fleet = getFleetDecoder().decode(raw.data);
+    if (getFleetEncoder().encode(fleet).length !== raw.data.length)
+        throw new AccountDecodeError('fleet', raw.address, new RangeError('Fleet decoding lost variable collection entries.'), 'The Fleet contains noncanonical variable collections. Refresh a valid Fleet before estimating ship assembly rent.');
+    const fleetShips = new Map(fleet.fleetShips);
+    fleetShips.set(shipId, (fleetShips.get(shipId) ?? 0n) + amount);
+    return getFleetEncoder().encode({ ...fleet, fleetShips }).length;
+}
+/** Audited singleton instruction with deployment-tested inert legacy indices. */
+export function addShipToFleetInstruction(input, accounts) {
+    return {
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        accounts: [
+            { address: input.authority, role: AccountRole.READONLY_SIGNER },
+            { address: input.profile, role: AccountRole.WRITABLE },
+            { address: SAGE_PROGRAM_ADDRESS, role: AccountRole.READONLY },
+            { address: PLAYER_PROFILE_PROGRAM_ADDRESS, role: AccountRole.READONLY },
+            { address: accounts.character, role: AccountRole.WRITABLE },
+            { address: accounts.fleet, role: AccountRole.WRITABLE },
+            { address: input.game, role: AccountRole.READONLY },
+            { address: input.system, role: AccountRole.READONLY },
+            { address: accounts.starbasePlayer, role: AccountRole.WRITABLE },
+        ],
+        data: getAddShipToFleetInstructionDataEncoder().encode({
+            ships: [{ id: input.shipId, amount: Number(input.amount) }],
+            shipEscrowIndex: 0,
+            fleetShipInfoIndex: null,
+            keyIndex: input.keyIndex,
+        }),
+    };
+}
+//# sourceMappingURL=fleet-ship-assembly.js.map

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

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

package/dist/internal/c4/fleet.d.ts

@@ -180,21 +180,29 @@ export interface FleetCombatStatsData {
     readonly shieldBreakDelaySeconds: number;
     readonly warpSpoolTimeSeconds: number;
     readonly damageKinetic: number;
-    readonly damageKineticVariance: number;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly damageKineticVariance: FleetFixedValue;
     readonly damageEnergy: number;
-    readonly damageEnergyVariance: number;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly damageEnergyVariance: FleetFixedValue;
     readonly damageEmp: number;
-    readonly damageEmpVariance: number;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly damageEmpVariance: FleetFixedValue;
     readonly damageSuperchill: number;
-    readonly damageSuperchillVariance: number;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly damageSuperchillVariance: FleetFixedValue;
     readonly damageShockwave: number;
-    readonly damageShockwaveVariance: number;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly damageShockwaveVariance: FleetFixedValue;
     readonly damageGraygoo: number;
-    readonly damageGraygooVariance: number;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly damageGraygooVariance: FleetFixedValue;
     readonly damageHeat: number;
-    readonly damageHeatVariance: number;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly damageHeatVariance: FleetFixedValue;
     readonly damageBomb: number;
-    readonly damageBombVariance: number;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly damageBombVariance: FleetFixedValue;
     readonly counterDecoy: number;
     readonly counterEnergyCapacitor: number;
     readonly counterFireSuppressor: number;
@@ -204,14 +212,22 @@ export interface FleetCombatStatsData {
     readonly counterNegativeRemPlating: number;
     readonly counterWarmingPlates: number;
     readonly counterFaradayShielding: number;
-    readonly stealthPower: number;
-    readonly hitChance: number;
-    readonly aimAbility: number;
-    readonly critChance: number;
-    readonly critMultiplier: number;
-    readonly fuelConsumptionRate: number;
-    readonly missileDamage: number;
-    readonly missileFireRate: number;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly stealthPower: FleetFixedValue;
+    /** U26F6 fixed-point hit value; no probability or percentage interpretation is implied. */
+    readonly hitChance: FleetFixedValue;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly aimAbility: FleetFixedValue;
+    /** U26F6 fixed-point critical-hit value; no probability or percentage interpretation is implied. */
+    readonly critChance: FleetFixedValue;
+    /** U26F6 fixed-point critical multiplier. */
+    readonly critMultiplier: FleetFixedValue;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly fuelConsumptionRate: FleetFixedValue;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly missileDamage: FleetFixedValue;
+    /** U26F6 fixed-point client display value; exact encoded integer retained in `raw`. */
+    readonly missileFireRate: FleetFixedValue;
 }
 /** Translated miscellaneous Fleet statistics.
  * @example
@@ -227,13 +243,16 @@ export interface FleetMiscStatsData {
     readonly respawnTimeWithFeeSeconds: number;
     readonly respawnFeeRaw: bigint;
     readonly respawnFeeAtlas: number;
-    readonly scanCoolDownSeconds: number;
-    readonly scanPower: number;
+    /** U16F16 fixed-point scanning cooldown in seconds. */
+    readonly scanCoolDownSeconds: FleetFixedValue;
+    /** U26F6 fixed-point scanning power. */
+    readonly scanPower: FleetFixedValue;
     readonly scanCost: number;
     readonly scanBonus: number;
     readonly lpValue: number;
     readonly medallionValue: number;
-    readonly xpValue: number;
+    /** U16F16 fixed-point configured XP value; not an awarded-XP calculation. */
+    readonly xpValue: FleetFixedValue;
 }
 /** Grouped translated Fleet statistics.
  * @example
@@ -285,6 +304,11 @@ export interface FleetAccountData {
     readonly shieldBreakDelayExpiresAt: bigint;
     readonly lastCombatUpdate: bigint;
     readonly location: WorldCoordinates;
+    /** Exact stored I8F56 coordinates; use these for arithmetic, not the display numbers. */
+    readonly locationRaw: {
+        readonly x: bigint;
+        readonly y: bigint;
+    };
     readonly lastUpdateAt: bigint;
     readonly fleetShips: readonly FleetShipAmountData[];
     readonly respawningCargo: FleetCargoPodData;
@@ -305,6 +329,8 @@ export declare function assertCanonicalFleetAddress(fleet: SnapshotEnvelope<Flee
 export declare const fleetAccountDefinition: C4AccountAdapter<FleetAccountData>;
 /** Builds the three stable Fleet memcmp filters; Fleet tails and data size are excluded. */
 export declare function buildFleetDiscoveryFilters(game: Address, ownerProfile: Address): readonly ProgramAccountFilter[];
+/** Discovers decoded Fleet candidates and verifies the stable Game field after decoding. */
+export declare function discoverFleetAccountsForGame(context: SageContext, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<FleetAccountData>[]>;
 /** Discovers decoded Fleet candidates and verifies the stable query fields after decoding. */
 export declare function discoverFleetAccounts(context: SageContext, ownerProfile: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<FleetAccountData>[]>;
 //# sourceMappingURL=fleet.d.ts.map