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

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,14 @@
+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>;
+/** Ship, component and cargo-hold lines of a Docked Fleet being sized. */
+export interface DockedFleetContents {
+    readonly fleetShips: ReadonlyMap<number, bigint>;
+    readonly components: ReadonlyMap<number, bigint>;
+    readonly cargoHold: ReadonlyMap<number, bigint>;
+}
+/** 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.
+ * Given contents, sizes the same Fleet holding those lines; amounts do not change the size. */
+export declare function emptyDockedFleetSize(contents?: DockedFleetContents): 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,EAAe,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ1E,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AAGvC,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAElB;AACD,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD;AAED;+FAC+F;AAC/F,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,MAAM,CA0I3E;AACD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,qBAAqB,GAC9B,WAAW,CA2Bb"}

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

@@ -0,0 +1,177 @@
+import { AccountRole } from '@solana/kit';
+import { SAGE_PROGRAM_ADDRESS, getNameEncoder, getFleetEncoder, getCreateFleetInstructionDataEncoder, } from '@staratlas/dev-sage';
+import { PLAYER_PROFILE_PROGRAM_ADDRESS } from '@staratlas/dev-player-profile';
+import { deriveFleetLabelAddress } from './fleet.js';
+export async function deriveFleetCreationAddress(game, profile, label) {
+    return deriveFleetLabelAddress(game, profile, getNameEncoder().encode(label));
+}
+/** 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.
+ * Given contents, sizes the same Fleet holding those lines; amounts do not change the size. */
+export function emptyDockedFleetSize(contents) {
+    const zero = '11111111111111111111111111111111';
+    const pod = (amounts = new Map()) => ({
+        seqId: 0,
+        storageCost: 0n,
+        amounts: new Map(amounts),
+    });
+    const cargo = pod();
+    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(contents?.fleetShips),
+        respawningCargo: cargo,
+        components: pod(contents?.components),
+        cargoHold: pod(contents?.cargoHold),
+        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":"AAAA,OAAO,EAAE,WAAW,EAAkC,MAAM,aAAa,CAAC;AAC1E,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,oCAAoC,GACrC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAK/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAAa,EACb,OAAgB,EAChB,KAAa;IAEb,OAAO,uBAAuB,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAChF,CAAC;AAQD;+FAC+F;AAC/F,MAAM,UAAU,oBAAoB,CAAC,QAA8B;IACjE,MAAM,IAAI,GAAG,kCAA6C,CAAC;IAC3D,MAAM,GAAG,GAAG,CAAC,UAAuC,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QACjE,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC;KAC1B,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;IACpB,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC;QAC9B,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,IAAI;QAChB,qBAAqB,EAAE,IAAI;QAC3B,OAAO,EAAE,CAAC;QACV,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,EAAE;QACd,UAAU,EAAE;YACV,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,CAAC;YACT,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;YACT,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,CAAC;YACZ,KAAK,EAAE,CAAC;SACT;QACD,qBAAqB,EAAE,EAAE;QACzB,qBAAqB,EAAE,EAAE;QACzB,KAAK,EAAE;YACL,aAAa,EAAE;gBACb,YAAY,EAAE,CAAC;gBACf,SAAS,EAAE,CAAC;gBACZ,aAAa,EAAE,CAAC;gBAChB,eAAe,EAAE,CAAC;gBAClB,YAAY,EAAE,CAAC;gBACf,0BAA0B,EAAE,CAAC;gBAC7B,uBAAuB,EAAE,CAAC;gBAC1B,oBAAoB,EAAE,CAAC;gBACvB,UAAU,EAAE,CAAC;gBACb,aAAa,EAAE,CAAC;aACjB;YACD,UAAU,EAAE;gBACV,aAAa,EAAE,CAAC;gBAChB,YAAY,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC;gBACf,mBAAmB,EAAE,CAAC;gBACtB,mBAAmB,EAAE,CAAC;gBACtB,UAAU,EAAE,CAAC;gBACb,QAAQ,EAAE,CAAC;aACZ;YACD,WAAW,EAAE;gBACX,EAAE,EAAE,CAAC;gBACL,EAAE,EAAE,CAAC;gBACL,EAAE,EAAE,CAAC;gBACL,mBAAmB,EAAE,CAAC;gBACtB,WAAW,EAAE,CAAC;gBACd,kBAAkB,EAAE,CAAC;gBACrB,UAAU,EAAE,CAAC;gBACb,aAAa,EAAE,CAAC;gBAChB,gBAAgB,EAAE,CAAC;gBACnB,UAAU,EAAE,CAAC;gBACb,QAAQ,EAAE,CAAC;gBACX,gBAAgB,EAAE,CAAC;gBACnB,aAAa,EAAE,CAAC;gBAChB,aAAa,EAAE,CAAC;gBAChB,qBAAqB,EAAE,CAAC;gBACxB,YAAY,EAAE,CAAC;gBACf,oBAAoB,EAAE,CAAC;gBACvB,SAAS,EAAE,CAAC;gBACZ,iBAAiB,EAAE,CAAC;gBACpB,gBAAgB,EAAE,CAAC;gBACnB,wBAAwB,EAAE,CAAC;gBAC3B,eAAe,EAAE,CAAC;gBAClB,uBAAuB,EAAE,CAAC;gBAC1B,aAAa,EAAE,CAAC;gBAChB,qBAAqB,EAAE,CAAC;gBACxB,UAAU,EAAE,CAAC;gBACb,kBAAkB,EAAE,CAAC;gBACrB,UAAU,EAAE,CAAC;gBACb,kBAAkB,EAAE,CAAC;gBACrB,YAAY,EAAE,CAAC;gBACf,sBAAsB,EAAE,CAAC;gBACzB,qBAAqB,EAAE,CAAC;gBACxB,YAAY,EAAE,CAAC;gBACf,sBAAsB,EAAE,CAAC;gBACzB,WAAW,EAAE,CAAC;gBACd,yBAAyB,EAAE,CAAC;gBAC5B,oBAAoB,EAAE,CAAC;gBACvB,uBAAuB,EAAE,CAAC;gBAC1B,YAAY,EAAE,CAAC;gBACf,SAAS,EAAE,CAAC;gBACZ,UAAU,EAAE,CAAC;gBACb,UAAU,EAAE,CAAC;gBACb,cAAc,EAAE,CAAC;gBACjB,mBAAmB,EAAE,CAAC;gBACtB,aAAa,EAAE,CAAC;gBAChB,eAAe,EAAE,CAAC;aACnB;YACD,SAAS,EAAE;gBACT,YAAY,EAAE,CAAC;gBACf,iBAAiB,EAAE,CAAC;gBACpB,qBAAqB,EAAE,CAAC;gBACxB,kBAAkB,EAAE,CAAC;gBACrB,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC;gBACf,SAAS,EAAE,CAAC;gBACZ,QAAQ,EAAE,CAAC;gBACX,SAAS,EAAE,CAAC;gBACZ,OAAO,EAAE,CAAC;gBACV,cAAc,EAAE,CAAC;gBACjB,OAAO,EAAE,CAAC;aACX;SACF;QACD,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;QACpC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;QACpC,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;QACb,oBAAoB,EAAE,CAAC;QACvB,EAAE,EAAE,CAAC;QACL,EAAE,EAAE,CAAC;QACL,EAAE,EAAE,CAAC;QACL,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE;QACxB,iBAAiB,EAAE,EAAE;QACrB,yBAAyB,EAAE,EAAE;QAC7B,gBAAgB,EAAE,EAAE;QACpB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAChB,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,IAAI,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC;QACzC,eAAe,EAAE,KAAK;QACtB,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC;QACrC,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC;QACnC,gBAAgB,EAAE,IAAI,GAAG,EAAE;QAC3B,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE;KACzE,CAAC,CAAC,MAAM,CAAC;AACZ,CAAC;AACD,MAAM,UAAU,sBAAsB,CACpC,KAA0B,EAC1B,QAA+B;IAE/B,OAAO;QACL,cAAc,EAAE,oBAAoB;QACpC,QAAQ,EAAE;YACR,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,eAAe,EAAE;YAC/D,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YACtD,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAC7D;gBACE,OAAO,EAAE,8BAA8B;gBACvC,IAAI,EAAE,WAAW,CAAC,QAAQ;aAC3B;YACD,EAAE,OAAO,EAAE,QAAQ,CAAC,cAAc,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAChE,EAAE,OAAO,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAC3D,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YACnD,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YACvD,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YACrD,EAAE,OAAO,EAAE,QAAQ,CAAC,cAAc,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAChE;gBACE,OAAO,EAAE,kCAA6C;gBACtD,IAAI,EAAE,WAAW,CAAC,QAAQ;aAC3B;SACF;QACD,IAAI,EAAE,oCAAoC,EAAE,CAAC,MAAM,CAAC;YAClD,UAAU,EAAE,KAAK,CAAC,KAAK;YACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC;KACH,CAAC;AACJ,CAAC"}

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":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMrD,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;AAED,+EAA+E;AAC/E,eAAO,MAAM,iCAAiC,EAAE,gBAAgB,CAAC,2BAA2B,CAoBzF,CAAC;AAEJ;;;;;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,CAElB"}

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

@@ -1,51 +1,38 @@
-import { FLEET_CREW_BINDING_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, getFleetCrewBindingDecoder, } from '@staratlas/dev-sage';
-import { getAddressEncoder, getBytesEncoder, getProgramDerivedAddress, } from '@solana/kit';
-import { AccountDecodeError, InvalidAccountOwnerError, InvalidDiscriminatorError, } from '../../client/errors.js';
+import { SAGE_PROGRAM_ADDRESS, getFleetCrewBindingDecoder, } from '@staratlas/dev-sage';
+import { defineAccount } from './account-decoding.js';
+import { FLEET_CREW_BINDING_DISCRIMINATOR } from './discriminators.js';
+import { addressSeed, deriveSageAddress } from './pda.js';
 const FLEET_CREW_BINDING_ACCOUNT_LENGTH = 403;
-const FLEET_CREW_BINDING_PDA_PREFIX = 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));
-function validateFleetCrewBindingAccount(account) {
-    if (account.owner !== SAGE_PROGRAM_ADDRESS) {
-        throw new InvalidAccountOwnerError('fleetCrewBinding', account.address, SAGE_PROGRAM_ADDRESS, account.owner);
-    }
-    if (account.data.length < DISCRIMINATOR.length ||
-        DISCRIMINATOR.some((byte, index) => account.data[index] !== byte)) {
-        throw new InvalidDiscriminatorError('fleetCrewBinding', account.address);
-    }
-    if (account.data.length !== FLEET_CREW_BINDING_ACCOUNT_LENGTH) {
-        throw new AccountDecodeError('fleetCrewBinding', account.address, new RangeError(`Expected exactly ${String(FLEET_CREW_BINDING_ACCOUNT_LENGTH)} FleetCrewBinding account bytes, received ${String(account.data.length)}.`));
-    }
-}
-function decodeExactly(account) {
-    return getFleetCrewBindingDecoder().decode(account.data);
-}
 /** Minimal validated internal definition; no public crew domain is exposed. */
-export const fleetCrewBindingAccountDefinition = Object.freeze({
-    decode(account) {
-        validateFleetCrewBindingAccount(account);
-        const decoded = decodeExactly(account);
-        return {
-            fleet: decoded.fleet,
-            ownerProfile: decoded.ownerProfile,
-        };
-    },
-    discriminator: DISCRIMINATOR,
-    minimumDataLength: FLEET_CREW_BINDING_ACCOUNT_LENGTH,
-    programAddress: SAGE_PROGRAM_ADDRESS,
+export const fleetCrewBindingAccountDefinition = 
+/* @__PURE__ */ defineAccount({
     type: 'fleetCrewBinding',
-    validate: validateFleetCrewBindingAccount,
-});
+    label: 'FleetCrewBinding',
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    discriminator: FLEET_CREW_BINDING_DISCRIMINATOR,
+    length: FLEET_CREW_BINDING_ACCOUNT_LENGTH,
+    exact: true,
+}, getFleetCrewBindingDecoder, (decoded, account) => ({
+    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(FLEET_CREW_BINDING_DISCRIMINATOR.length)
+        .every((byte) => byte === 0),
+}));
+/**
+ * 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({
-        programAddress: SAGE_PROGRAM_ADDRESS,
-        seeds: [
-            getBytesEncoder().encode(FLEET_CREW_BINDING_PDA_PREFIX),
-            getAddressEncoder().encode(fleet),
-        ],
-    });
-    return address;
+    return deriveSageAddress('FleetCrewBinding', addressSeed(fleet));
 }
 //# sourceMappingURL=fleet-crew-binding.js.map

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,oBAAoB,EACpB,0BAA0B,GAE3B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE1D,MAAM,iCAAiC,GAAG,GAAG,CAAC;AAU9C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iCAAiC;AAC5C,eAAe,CAAC,aAAa,CAC3B;IACE,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,kBAAkB;IACzB,cAAc,EAAE,oBAAoB;IACpC,aAAa,EAAE,gCAAgC;IAC/C,MAAM,EAAE,iCAAiC;IACzC,KAAK,EAAE,IAAI;CACZ,EACD,0BAA0B,EAC1B,CAAC,OAAyB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,YAAY,EAAE,OAAO,CAAC,YAAY;IAClC,qEAAqE;IACrE,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC,IAAI;SACpB,QAAQ,CAAC,gCAAgC,CAAC,MAAM,CAAC;SACjD,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC;CAC/B,CAAC,CACH,CAAC;AAEJ;;;;;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,OAAO,iBAAiB,CAAC,kBAAkB,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/internal/c4/fleet-disband-layout.d.ts

@@ -0,0 +1,7 @@
+/** Instruction index of the Character a disband frees a Fleet slot on. */
+export declare const DISBAND_CHARACTER_INDEX = 4;
+/** Instruction index of the Fleet a disband closes. */
+export declare const DISBAND_FLEET_INDEX = 5;
+/** Instruction index of the Starbase Player a disband grows. */
+export declare const DISBAND_STARBASE_PLAYER_INDEX = 8;
+//# sourceMappingURL=fleet-disband-layout.d.ts.map

package/dist/internal/c4/fleet-disband-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-disband-layout.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/fleet-disband-layout.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,gEAAgE;AAChE,eAAO,MAAM,6BAA6B,IAAI,CAAC"}

package/dist/internal/c4/fleet-disband-layout.js

@@ -0,0 +1,7 @@
+/** Instruction index of the Character a disband frees a Fleet slot on. */
+export const DISBAND_CHARACTER_INDEX = 4;
+/** Instruction index of the Fleet a disband closes. */
+export const DISBAND_FLEET_INDEX = 5;
+/** Instruction index of the Starbase Player a disband grows. */
+export const DISBAND_STARBASE_PLAYER_INDEX = 8;
+//# sourceMappingURL=fleet-disband-layout.js.map

package/dist/internal/c4/fleet-disband-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-disband-layout.js","sourceRoot":"","sources":["../../../src/internal/c4/fleet-disband-layout.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,gEAAgE;AAChE,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC"}

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

@@ -0,0 +1,41 @@
+import { type Address, type Instruction, type ReadonlyUint8Array } from '@solana/kit';
+import { type Fleet, type StarbasePlayer } from '@staratlas/dev-sage';
+import type { RawAccount } from '../../client/contracts.js';
+export type { StarbasePlayer };
+/** The accounts a player Fleet disband names, in instruction order. */
+export interface FleetDisbandAccounts {
+    readonly authority: Address;
+    readonly profile: Address;
+    readonly character: Address;
+    readonly fleet: Address;
+    readonly game: Address;
+    readonly system: Address;
+    readonly starbasePlayer: Address;
+    readonly keyIndex: number;
+}
+export { DISBAND_CHARACTER_INDEX, DISBAND_FLEET_INDEX, DISBAND_STARBASE_PLAYER_INDEX, } from './fleet-disband-layout.js';
+/** A player Fleet disband in the pinned bindings' layout, which the deployed
+ * program accepts. The Certificate and the two NPC-faction accounts are
+ * omitted; omitted accounts use the SAGE program address. */
+export declare function disbandFleetInstruction(input: FleetDisbandAccounts): Instruction;
+/** A disband instruction's key index. */
+export declare function decodeDisbandFleetData(data: ReadonlyUint8Array): number;
+/** Bytes the Starbase Player grows when the Fleet disbands into it, verified
+ * against the program's behaviour. Each Fleet ship id without a hangar entry
+ * adds one. Cargo merges into the Starbase Player's cargo pod with a line per
+ * cargo id it lacks: the ammo bank and fuel tank only when they hold cargo, and
+ * every cargo hold and component line, empty ones included. */
+export declare function starbasePlayerDisbandGrowth(fleetRaw: RawAccount, playerRaw: RawAccount): number;
+/** Decodes a StarbasePlayer whose decoding keeps every variable collection
+ * entry, so re-encoding sizes it exactly. */
+export declare function decodeCanonicalStarbasePlayer(raw: RawAccount, remedy: string): StarbasePlayer;
+/** Encoded size of a StarbasePlayer value. */
+export declare function starbasePlayerSize(player: StarbasePlayer): number;
+/** The StarbasePlayer with a hangar entry for the ship configuration, added
+ * empty when it has none. */
+export declare function withHangarEntry(player: StarbasePlayer, shipId: number): StarbasePlayer;
+/** The StarbasePlayer after a Fleet disbands into it: ships join the hangar
+ * and the ammo bank, fuel tank, cargo hold and components merge into its
+ * cargo pod. */
+export declare function withDisbandedFleet(fleet: Fleet, player: StarbasePlayer): StarbasePlayer;
+//# sourceMappingURL=fleet-disband.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-disband.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/fleet-disband.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAML,KAAK,KAAK,EACV,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAI5D,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AAEnC;;6DAE6D;AAC7D,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,oBAAoB,GAC1B,WAAW,CAoBb;AAED,yCAAyC;AACzC,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAEvE;AAED;;;;+DAI+D;AAC/D,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,UAAU,EACpB,SAAS,EAAE,UAAU,GACpB,MAAM,CAUR;AAED;6CAC6C;AAC7C,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,GACb,cAAc,CAYhB;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEjE;AAED;6BAC6B;AAC7B,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,GACb,cAAc,CAKhB;AAED;;gBAEgB;AAChB,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,cAAc,GACrB,cAAc,CAgBhB"}

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

@@ -0,0 +1,86 @@
+import { AccountRole, } from '@solana/kit';
+import { SAGE_PROGRAM_ADDRESS, getDisbandFleetInstructionDataDecoder, getDisbandFleetInstructionDataEncoder, getStarbasePlayerDecoder, getStarbasePlayerEncoder, } from '@staratlas/dev-sage';
+import { PLAYER_PROFILE_PROGRAM_ADDRESS } from '@staratlas/dev-player-profile';
+import { AccountDecodeError } from '../../client/errors.js';
+import { decodeCanonicalFleet } from './fleet-storage.js';
+export { DISBAND_CHARACTER_INDEX, DISBAND_FLEET_INDEX, DISBAND_STARBASE_PLAYER_INDEX, } from './fleet-disband-layout.js';
+/** A player Fleet disband in the pinned bindings' layout, which the deployed
+ * program accepts. The Certificate and the two NPC-faction accounts are
+ * omitted; omitted accounts use the SAGE program address. */
+export function disbandFleetInstruction(input) {
+    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: input.character, role: AccountRole.WRITABLE },
+            { address: input.fleet, role: AccountRole.WRITABLE },
+            { address: input.game, role: AccountRole.READONLY },
+            { address: input.system, role: AccountRole.READONLY },
+            { address: input.starbasePlayer, role: AccountRole.WRITABLE },
+            { address: SAGE_PROGRAM_ADDRESS, role: AccountRole.READONLY },
+            { address: SAGE_PROGRAM_ADDRESS, role: AccountRole.READONLY },
+        ],
+        data: getDisbandFleetInstructionDataEncoder().encode({
+            keyIndex: input.keyIndex,
+        }),
+    };
+}
+/** A disband instruction's key index. */
+export function decodeDisbandFleetData(data) {
+    return getDisbandFleetInstructionDataDecoder().decode(data).keyIndex;
+}
+/** Bytes the Starbase Player grows when the Fleet disbands into it, verified
+ * against the program's behaviour. Each Fleet ship id without a hangar entry
+ * adds one. Cargo merges into the Starbase Player's cargo pod with a line per
+ * cargo id it lacks: the ammo bank and fuel tank only when they hold cargo, and
+ * every cargo hold and component line, empty ones included. */
+export function starbasePlayerDisbandGrowth(fleetRaw, playerRaw) {
+    const player = decodeCanonicalStarbasePlayer(playerRaw, 'Refresh a valid StarbasePlayer before estimating Fleet disband rent.');
+    return (getStarbasePlayerEncoder().encode(withDisbandedFleet(decodeCanonicalFleet(fleetRaw), player)).length - playerRaw.data.length);
+}
+/** Decodes a StarbasePlayer whose decoding keeps every variable collection
+ * entry, so re-encoding sizes it exactly. */
+export function decodeCanonicalStarbasePlayer(raw, remedy) {
+    const player = getStarbasePlayerDecoder().decode(raw.data);
+    if (getStarbasePlayerEncoder().encode(player).length !== raw.data.length)
+        throw new AccountDecodeError('starbasePlayer', raw.address, new RangeError('StarbasePlayer decoding lost variable collection entries.'), `The StarbasePlayer contains noncanonical variable collections. ${remedy}`);
+    return player;
+}
+/** Encoded size of a StarbasePlayer value. */
+export function starbasePlayerSize(player) {
+    return getStarbasePlayerEncoder().encode(player).length;
+}
+/** The StarbasePlayer with a hangar entry for the ship configuration, added
+ * empty when it has none. */
+export function withHangarEntry(player, shipId) {
+    if (player.shipsInEscrow.has(shipId))
+        return player;
+    const shipsInEscrow = new Map(player.shipsInEscrow);
+    shipsInEscrow.set(shipId, 0n);
+    return { ...player, shipsInEscrow };
+}
+/** The StarbasePlayer after a Fleet disbands into it: ships join the hangar
+ * and the ammo bank, fuel tank, cargo hold and components merge into its
+ * cargo pod. */
+export function withDisbandedFleet(fleet, player) {
+    const add = (target, id, amount) => target.set(id, (target.get(id) ?? 0n) + amount);
+    const shipsInEscrow = new Map(player.shipsInEscrow);
+    for (const [shipId, amount] of fleet.fleetShips)
+        add(shipsInEscrow, shipId, amount);
+    const amounts = new Map(player.cargoPod.amounts);
+    for (const single of [fleet.ammoBank, fleet.fuelTank])
+        if (single.amount > 0n)
+            add(amounts, single.cargoId, single.amount);
+    for (const pod of [fleet.cargoHold, fleet.components])
+        for (const [cargoId, amount] of pod.amounts)
+            add(amounts, cargoId, amount);
+    return {
+        ...player,
+        shipsInEscrow,
+        cargoPod: { ...player.cargoPod, amounts },
+    };
+}
+//# sourceMappingURL=fleet-disband.js.map

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

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

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

@@ -0,0 +1,3 @@
+/** Fleet points a set of per-class counts uses. */
+export declare function fleetCapacityPoints(classes: readonly number[]): number;
+//# sourceMappingURL=fleet-points.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-points.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/fleet-points.ts"],"names":[],"mappings":"AAIA,mDAAmD;AACnD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKtE"}

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

@@ -0,0 +1,8 @@
+/** Fleet points each ship class uses, by size-class ordinal. Verified against
+ * the program's behaviour; a Titan uses 128, not its 81-point combat size. */
+const FLEET_CAPACITY_POINTS = [1, 4, 9, 16, 25, 36, 49, 128];
+/** Fleet points a set of per-class counts uses. */
+export function fleetCapacityPoints(classes) {
+    return classes.reduce((total, count, index) => total + count * FLEET_CAPACITY_POINTS[index], 0);
+}
+//# sourceMappingURL=fleet-points.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-points.js","sourceRoot":"","sources":["../../../src/internal/c4/fleet-points.ts"],"names":[],"mappings":"AAAA;8EAC8E;AAC9E,MAAM,qBAAqB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAU,CAAC;AAEtE,mDAAmD;AACnD,MAAM,UAAU,mBAAmB,CAAC,OAA0B;IAC5D,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAE,EACtE,CAAC,CACF,CAAC;AACJ,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"}