@aephia/atlas-kit 0.6.0-next.15 → 0.6.0-next.150

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

@@ -0,0 +1,171 @@
+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. */
+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":"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,27 @@
+import { type Address, type Instruction, type ReadonlyUint8Array } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+/** 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;
+//# 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;AAUrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAI5D,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,CA+BR"}

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

@@ -0,0 +1,63 @@
+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 fleet = decodeCanonicalFleet(fleetRaw);
+    const player = getStarbasePlayerDecoder().decode(playerRaw.data);
+    if (getStarbasePlayerEncoder().encode(player).length !== playerRaw.data.length)
+        throw new AccountDecodeError('starbasePlayer', playerRaw.address, new RangeError('StarbasePlayer decoding lost variable collection entries.'), 'The StarbasePlayer contains noncanonical variable collections. Refresh a valid StarbasePlayer before estimating Fleet disband rent.');
+    const shipsInEscrow = new Map(player.shipsInEscrow);
+    for (const [shipId] of fleet.fleetShips)
+        if (!shipsInEscrow.has(shipId))
+            shipsInEscrow.set(shipId, 0n);
+    const amounts = new Map(player.cargoPod.amounts);
+    for (const single of [fleet.ammoBank, fleet.fuelTank])
+        if (single.amount > 0n && !amounts.has(single.cargoId))
+            amounts.set(single.cargoId, 0n);
+    for (const pod of [fleet.cargoHold, fleet.components])
+        for (const [cargoId] of pod.amounts)
+            if (!amounts.has(cargoId))
+                amounts.set(cargoId, 0n);
+    return (getStarbasePlayerEncoder().encode({
+        ...player,
+        shipsInEscrow,
+        cargoPod: { ...player.cargoPod, amounts },
+    }).length - playerRaw.data.length);
+}
+//# 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"}

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,25 @@
+import { type Instruction } from '@solana/kit';
+import { type SizeClass } from '@staratlas/dev-sage';
+import type { RawAccount } from '../../client/contracts.js';
+import type { FleetShipCountsData } from './fleet.js';
+import type { FleetShipAssemblyIntent, FleetShipAssemblyAccounts } from '../planning/fleet-ship-assembly.js';
+export { fleetCapacityPoints } from './fleet-points.js';
+/** At most one Titan, and at most two Commanders and Titans together. */
+export declare const MAX_TITANS_PER_FLEET = 1;
+export declare const MAX_COMMANDERS_AND_TITANS_PER_FLEET = 2;
+declare const SIZE_ORDER: readonly ["xx-small", "x-small", "small", "medium", "large", "capital", "commander", "titan"];
+/** Size-class ordinal of a translated Character maximum ship size. */
+export declare function shipSizeRank(size: (typeof SIZE_ORDER)[number]): number;
+/** Display name of a ship size-class ordinal. */
+export declare function shipSizeName(sizeClass: SizeClass): string;
+/** Per-class ship counts with the selected ships added. */
+export declare function prospectiveShipCounts(counts: FleetShipCountsData, sizeClass: SizeClass, amount: number): readonly number[];
+/** 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;
+/** Bytes the Starbase Player grows when assembly re-tags hulls of other
+ * configurations: the program adds an escrow entry for the selected
+ * configuration when it has none, even a zero one. */
+export declare function starbasePlayerEscrowGrowth(raw: RawAccount, shipId: number): 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,EAEL,KAAK,SAAS,EAMf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD,QAAA,MAAM,UAAU,+FASN,CAAC;AAEX,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAEtE;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAEzD;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,GACb,SAAS,MAAM,EAAE,CAanB;AAED,6HAA6H;AAC7H,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAYR;AACD;;sDAEsD;AACtD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,GACb,MAAM,CAkBR;AACD,iFAAiF;AACjF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,EAAE,yBAAyB,GAClC,WAAW,CAqBb"}