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

package/dist/internal/planning/fleet-dock-funding.js

@@ -0,0 +1,154 @@
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { fleetAccountDefinition } from '../c4/fleet.js';
+import { starbasePlayerAccountDefinition } from '../c4/starbase.js';
+import { starSystemAccountDefinition } from '../c4/world.js';
+import { validateProfileAccountShape } from '../c4/identity.js';
+import { hasCanonicalDockingEncoding } from '../c4/docking-funding.js';
+import { decodeDockingSequences, } from '../../registry/docking.js';
+import { RENT_ADDRESS, readRent, RentCalculationError } from './rent.js';
+import { dockGrowthDebit, } from './fleet-dock-funding-guard.js';
+function unavailable(reason) {
+    return { status: 'unavailable', reason };
+}
+/** Restrict optional estimates to validated account-format and Rent-value errors. */
+function estimateFailure(error) {
+    if (!(error instanceof SageSdkError) ||
+        !(error.code === 'ACCOUNT_DECODE_FAILED' ||
+            error.code === 'INVALID_ACCOUNT_OWNER' ||
+            error.code === 'INVALID_DISCRIMINATOR' ||
+            error instanceof RentCalculationError))
+        throw error;
+    return unavailable(error.code === 'ACCOUNT_DECODE_FAILED'
+        ? 'unsupported-account-layout'
+        : 'funding-state-unavailable');
+}
+function requiredFundingAccount(raw, address, label) {
+    if (!raw)
+        throw new SageSdkError('ACCOUNT_NOT_FOUND', `The ${label} account (${address}) was not returned while checking docking funding. Verify the deployment and provider, refresh the account, and recreate the Plan.`, { address });
+    return raw;
+}
+function qualifyDockAccounts(intent, accounts) {
+    const fleetRaw = accounts.get(intent.address), playerRaw = accounts.get(intent.starbasePlayer), systemRaw = accounts.get(intent.system);
+    if (!fleetRaw || !playerRaw || !systemRaw)
+        return unavailable('funding-state-unavailable');
+    const fleet = fleetAccountDefinition.decode(fleetRaw), player = starbasePlayerAccountDefinition.decode(playerRaw), system = starSystemAccountDefinition.decode(systemRaw);
+    if (fleetRaw.executable ||
+        playerRaw.executable ||
+        systemRaw.executable ||
+        fleet.game !== intent.game ||
+        fleet.ownerProfile !== intent.profile ||
+        player.playerProfile !== intent.profile ||
+        player.character !== intent.character ||
+        player.system !== intent.system ||
+        system.game !== intent.game)
+        return unavailable('funding-state-unavailable');
+    if (fleet.version !== 0 || player.version !== 0)
+        return unavailable('unsupported-account-layout');
+    if (fleet.state.kind !== 'idle')
+        return unavailable('unsupported-fleet-state');
+    if (!hasCanonicalDockingEncoding(fleetRaw, playerRaw))
+        return unavailable('noncanonical-account-encoding');
+    if (fleet.activeStimulants.length)
+        return unavailable('active-stimulants');
+    if (fleet.pendingHp !== 0 ||
+        fleet.respawningCargo.amounts.length ||
+        fleet.respawningCargo.storageCost !== 0n ||
+        player.respawning.cargo.amounts.length ||
+        player.respawning.cargo.usedStorageUnitsRaw !== 0n ||
+        player.respawning.ships.length ||
+        player.respawning.claimStakes.length ||
+        player.respawning.craftingHabs.length ||
+        player.respawning.crew.quantityRaw !== 0n ||
+        player.respawning.crew.completesAtUnixSeconds !== 0n ||
+        player.cargoRespawnEndsAtUnixSeconds !== 0n)
+        return unavailable('pending-recovery');
+    if (!system.starbase || player.sequenceId !== system.sequenceId)
+        return unavailable('stale-starbase-sequence');
+    return { status: 'qualified', fleetRaw, playerRaw, fleet, player };
+}
+function calculateDockFunding(intent, accounts, sequences, qualified = qualifyDockAccounts(intent, accounts)) {
+    if (qualified.status === 'unavailable')
+        return qualified;
+    const { fleetRaw, playerRaw, fleet, player } = qualified;
+    if (!sequences)
+        return unavailable('funding-state-unavailable');
+    if (fleet.shipDefinitionsSeqId !== sequences.shipSequenceId ||
+        [
+            fleet.cargoHold.seqId,
+            fleet.components.seqId,
+            fleet.respawningCargo.seqId,
+            player.cargo.sequenceId,
+            player.respawning.cargo.sequenceId,
+        ].some((seq) => seq !== sequences.cargoSequenceId))
+        return unavailable('stale-definition-sequences');
+    const profile = requiredFundingAccount(accounts.get(intent.profile), intent.profile, 'Profile'), rentRaw = requiredFundingAccount(accounts.get(RENT_ADDRESS), RENT_ADDRESS, 'Rent sysvar');
+    if (profile.executable)
+        return unavailable('funding-state-unavailable');
+    validateProfileAccountShape(profile);
+    const rent = readRent(rentRaw);
+    if ([fleetRaw, playerRaw].some((a) => a.lamports < rent(a.data.length)))
+        return unavailable('accounts-below-rent-reserve');
+    const { rentLamportsPerByteYear, rentExemptionThreshold } = rent;
+    const maximumProfileDebit = dockGrowthDebit(rentLamportsPerByteYear, rentExemptionThreshold, fleetRaw.data.length);
+    const profileReserve = rent(profile.data.length);
+    if (profile.lamports < profileReserve + maximumProfileDebit)
+        return unavailable('profile-below-storage-ceiling');
+    return {
+        status: 'available',
+        profileReserve,
+        maximumProfileDebit,
+        fleetDataLengthBytes: fleetRaw.data.length,
+        rentLamportsPerByteYear,
+        rentExemptionThreshold,
+        shipSequenceId: sequences.shipSequenceId,
+        cargoSequenceId: sequences.cargoSequenceId,
+        starbaseSequenceId: player.sequenceId,
+    };
+}
+export async function resolveDockFunding(ctx, intent, raw) {
+    const accounts = new Map(raw.map((a) => [a.address, a]));
+    // Core account decoding remains strict; only optional estimate inputs below
+    // may turn an otherwise supported dock into an unavailable quote.
+    const qualified = qualifyDockAccounts(intent, accounts);
+    if (qualified.status === 'unavailable')
+        return qualified;
+    // One fresh batch, as at execution. Transport, lifecycle and programming
+    // errors reject, and so does any missing required estimate account.
+    const inputs = [
+        [intent.game, 'Game'],
+        [intent.profile, 'Profile'],
+        [RENT_ADDRESS, 'Rent sysvar'],
+    ];
+    const rows = await readContextRawAccounts(ctx, inputs.map(([address]) => address));
+    inputs.forEach(([address, label], index) => accounts.set(address, requiredFundingAccount(rows[index], address, label)));
+    try {
+        // The Game is decoded behind the registry boundary; only typed
+        // account-format and Rent-value failures become an unavailable quote.
+        const current = calculateDockFunding(intent, accounts, decodeDockingSequences(accounts.get(intent.game)), qualified);
+        if (current.status === 'unavailable')
+            return current;
+        const { profileReserve: _profileReserve, ...amounts } = current;
+        return amounts;
+    }
+    catch (error) {
+        return estimateFailure(error);
+    }
+}
+export function revalidateDockFunding(guard, accounts, sequences) {
+    if (guard.status === 'unavailable')
+        return undefined;
+    const current = calculateDockFunding(guard, accounts, sequences);
+    if (current.status !== 'available' ||
+        current.maximumProfileDebit > guard.maximumProfileDebit ||
+        current.shipSequenceId !== guard.shipSequenceId ||
+        current.cargoSequenceId !== guard.cargoSequenceId ||
+        current.starbaseSequenceId !== guard.starbaseSequenceId ||
+        current.fleetDataLengthBytes !== guard.fleetDataLengthBytes)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Docking no longer has qualified storage funding within its approved Profile ceiling. Refresh the Fleet, Starbase Player, definitions and Rent; fund the Profile explicitly if needed, then recreate and inspect the Plan before signing.', { address: guard.profile });
+    return {
+        profileDebit: guard.maximumProfileDebit,
+        profileReserve: current.profileReserve,
+    };
+}
+//# sourceMappingURL=fleet-dock-funding.js.map

package/dist/internal/planning/fleet-dock-funding.js.map

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

package/dist/internal/planning/fleet-docking-guard.d.ts

@@ -0,0 +1,4 @@
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+/** Binds the qualified current docking route to its mandatory faction policy safeguard. */
+export declare function validateFleetDockingGuards(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=fleet-docking-guard.d.ts.map

package/dist/internal/planning/fleet-docking-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-docking-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-docking-guard.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE1E,2FAA2F;AAC3F,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAgDN"}

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

@@ -0,0 +1,42 @@
+import { AccountRole } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { IDLE_TO_DOCKED_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, PLAYER_PROFILE_PROGRAM_ADDRESS, } from '../c4/runtime-bindings.js';
+/** Binds the qualified current docking route to its mandatory faction policy safeguard. */
+export function validateFleetDockingGuards(steps, guards) {
+    for (const { instruction } of steps) {
+        if (instruction.programAddress !== SAGE_PROGRAM_ADDRESS ||
+            !IDLE_TO_DOCKED_DISCRIMINATOR.every((byte, index) => instruction.data?.[index] === byte))
+            continue;
+        const a = instruction.accounts;
+        const r = AccountRole.READONLY;
+        const w = AccountRole.WRITABLE;
+        const roles = [
+            AccountRole.READONLY_SIGNER,
+            w,
+            r,
+            r,
+            w,
+            r,
+            w,
+            r,
+            r,
+            r,
+            r,
+            r,
+            r,
+        ];
+        if (instruction.data?.length !== 10 ||
+            a?.length !== 13 ||
+            roles.some((role, i) => a[i].role !== role) ||
+            a[3].address !== PLAYER_PROFILE_PROGRAM_ADDRESS ||
+            [9, 10, 12].some((i) => a[i].address !== SAGE_PROGRAM_ADDRESS) ||
+            !guards.some((g) => g.kind === 'fleet-docking-policy' &&
+                g.address === a[8].address &&
+                g.game === a[7].address &&
+                g.system === a[5].address &&
+                g.ownership === a[11].address)) {
+            throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Docking requires the current thirteen-account instruction and its matching default faction-policy safeguard. Refresh the Fleet and recreate its docking Plan before signing.');
+        }
+    }
+}
+//# sourceMappingURL=fleet-docking-guard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-docking-guard.js","sourceRoot":"","sources":["../../../src/internal/planning/fleet-docking-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAGnC,2FAA2F;AAC3F,MAAM,UAAU,0BAA0B,CACxC,KAA0B,EAC1B,MAAmC;IAEnC,KAAK,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC;QACpC,IACE,WAAW,CAAC,cAAc,KAAK,oBAAoB;YACnD,CAAC,4BAA4B,CAAC,KAAK,CACjC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CACpD;YAED,SAAS;QACX,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC;QAC/B,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC;QAC/B,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC;QAC/B,MAAM,KAAK,GAAG;YACZ,WAAW,CAAC,eAAe;YAC3B,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;SACF,CAAC;QACF,IACE,WAAW,CAAC,IAAI,EAAE,MAAM,KAAK,EAAE;YAC/B,CAAC,EAAE,MAAM,KAAK,EAAE;YAChB,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,KAAK,IAAI,CAAC;YAC5C,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO,KAAK,8BAA8B;YAChD,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO,KAAK,oBAAoB,CAAC;YAC/D,CAAC,MAAM,CAAC,IAAI,CACV,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,sBAAsB;gBACjC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO;gBAC3B,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO;gBACxB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO;gBAC1B,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,EAAE,CAAE,CAAC,OAAO,CACjC,EACD,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,8KAA8K,CAC/K,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+import { type Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+/** Validates only the measured legacy-controller/default-gating docking route. */
+export declare function validateFleetDockingPolicy(tracker: RawAccount | undefined, ownership: RawAccount | undefined, scope: {
+    readonly game: Address;
+    readonly system: Address;
+    readonly address: Address;
+    readonly ownership: Address;
+}): Promise<void>;
+//# sourceMappingURL=fleet-docking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-docking.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-docking.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AASrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAoB5D,kFAAkF;AAClF,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,SAAS,EAAE,UAAU,GAAG,SAAS,EACjC,KAAK,EAAE;IACL,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,GACA,OAAO,CAAC,IAAI,CAAC,CAuGf"}

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

@@ -0,0 +1,85 @@
+import { getAddressEncoder, getProgramDerivedAddress, } from '@solana/kit';
+import { SAGE_PROGRAM_ADDRESS, FACTION_OWNERSHIP_DISCRIMINATOR, FACTION_RELATION_TRACKER_DISCRIMINATOR, getFactionOwnershipDecoder, getFactionRelationTrackerDecoder, } from '../c4/runtime-bindings.js';
+import { adapter } from '../c4/faction-adapter.js';
+import { SageSdkError } from '../../client/errors.js';
+// Reuse the exact generated codecs and shared raw-account validation without
+// bringing unrelated faction gameplay projections into the Plan execution bundle.
+const trackerDefinition = /* @__PURE__ */ adapter({
+    type: 'factionRelationTracker',
+    discriminator: FACTION_RELATION_TRACKER_DISCRIMINATOR,
+    minimumDataLength: 78,
+    decoder: /* @__PURE__ */ getFactionRelationTrackerDecoder(),
+    translate: (value) => value,
+});
+const ownershipDefinition = /* @__PURE__ */ adapter({
+    type: 'factionOwnership',
+    discriminator: FACTION_OWNERSHIP_DISCRIMINATOR,
+    minimumDataLength: 145,
+    exact: true,
+    decoder: /* @__PURE__ */ getFactionOwnershipDecoder(),
+    translate: (value) => value,
+});
+/** Validates only the measured legacy-controller/default-gating docking route. */
+export async function validateFleetDockingPolicy(tracker, ownership, scope) {
+    const invalid = (address, cause) => {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Docking at Star System ${scope.system}: ${cause}. Refresh the indicated faction account for the configured Game and System, verify its current binding version, and recreate the docking Plan.`, { address });
+    };
+    if (!tracker)
+        invalid(scope.address, `missing Game faction relation tracker ${scope.address}`);
+    if (!ownership)
+        invalid(scope.ownership, `missing System ownership ${scope.ownership}`);
+    if (tracker.executable)
+        invalid(scope.address, `Game faction relation tracker ${scope.address} is executable`);
+    if (ownership.executable)
+        invalid(scope.ownership, `System ownership ${scope.ownership} is executable`);
+    if (tracker.address !== scope.address)
+        invalid(scope.address, `Game faction relation tracker ${scope.address} returned account ${tracker.address}`);
+    if (ownership.address !== scope.ownership)
+        invalid(scope.ownership, `System ownership ${scope.ownership} returned account ${ownership.address}`);
+    const [trackerPda, ownershipPda] = await Promise.all([
+        getProgramDerivedAddress({
+            programAddress: SAGE_PROGRAM_ADDRESS,
+            seeds: [
+                new TextEncoder().encode('FactionRelations'),
+                getAddressEncoder().encode(scope.game),
+            ],
+        }),
+        getProgramDerivedAddress({
+            programAddress: SAGE_PROGRAM_ADDRESS,
+            seeds: [
+                new TextEncoder().encode('FactionOwnership'),
+                getAddressEncoder().encode(scope.game),
+                new Uint8Array([0]),
+                getAddressEncoder().encode(scope.system),
+            ],
+        }),
+    ]);
+    const relation = trackerDefinition.decode(tracker);
+    const owner = ownershipDefinition.decode(ownership);
+    if (relation.version !== 0)
+        invalid(scope.address, `Game faction relation tracker ${scope.address} has unsupported account version ${String(relation.version)}`);
+    if (owner.version !== 0)
+        invalid(scope.ownership, `System ownership ${scope.ownership} has unsupported account version ${String(owner.version)}`);
+    if (trackerPda[0] !== scope.address ||
+        relation.bump !== trackerPda[1] ||
+        relation.gameId !== scope.game)
+        invalid(scope.address, `Game faction relation tracker ${scope.address} does not match its canonical Game identity or PDA`);
+    if (ownershipPda[0] !== scope.ownership ||
+        owner.bump !== ownershipPda[1] ||
+        owner.gameId !== scope.game ||
+        owner.assetKind !== 0 ||
+        !getAddressEncoder()
+            .encode(scope.system)
+            .every((byte, index) => owner.assetKey[index] === byte))
+        invalid(scope.ownership, `System ownership ${scope.ownership} does not match its canonical Game/System identity or PDA`);
+    const unsupported = (address, cause) => {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Docking at Star System ${scope.system}: ${cause}; this policy is unsupported by the qualified docking route. Choose a System with controller 0–3 and disabled territory/economic gates, or use independently qualified SDK support for this policy. Refresh the faction accounts and recreate the Plan after the policy changes.`, { address });
+    };
+    if (relation.territoryAccessEnabled !== 0)
+        unsupported(scope.address, 'territory access gating is enabled');
+    if (relation.crossFactionEconomicsEnabled !== 0)
+        unsupported(scope.address, 'cross-faction economic gating is enabled');
+    if (owner.controllingFaction > 3)
+        unsupported(scope.ownership, `controller ${String(owner.controllingFaction)} governs this System`);
+}
+//# sourceMappingURL=fleet-docking.js.map

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

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

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

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

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

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

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

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

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

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

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

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

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

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