@aephia/atlas-kit 0.6.0-next.13 → 0.6.0-next.130

package/dist/internal/planning/fleet-crew-transfer.js.map

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

package/dist/internal/planning/fleet-dock-funding-guard.d.ts

@@ -0,0 +1,42 @@
+import { type Address } from '@solana/kit';
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+import { type GuardSchema } from './plan-fields.js';
+export declare const MAXIMUM_DOCK_GROWTH_BYTES = 40;
+declare const REASONS: readonly ["unsupported-account-layout", "unsupported-fleet-state", "noncanonical-account-encoding", "stale-definition-sequences", "stale-starbase-sequence", "pending-recovery", "active-stimulants", "funding-state-unavailable", "accounts-below-rent-reserve", "profile-below-storage-ceiling"];
+export type DockBoundsUnavailableReason = (typeof REASONS)[number];
+export type DockFundingAmounts = {
+    readonly status: 'unavailable';
+    readonly reason: DockBoundsUnavailableReason;
+} | {
+    readonly status: 'available';
+    readonly maximumProfileDebit: bigint;
+    readonly fleetDataLengthBytes: number;
+    readonly rentLamportsPerByteYear: bigint;
+    readonly rentExemptionThreshold: number;
+    readonly shipSequenceId: number;
+    readonly cargoSequenceId: number;
+    readonly starbaseSequenceId: bigint;
+};
+export interface DockFundingIntent {
+    readonly address: Address;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly certificate: Address;
+    readonly keyIndex: number;
+    readonly character: Address;
+    readonly system: Address;
+    readonly starbasePlayer: Address;
+}
+export type FleetDockFundingGuard = DockFundingIntent & DockFundingAmounts & {
+    readonly kind: 'fleet-dock-funding';
+    readonly describes: string;
+    readonly dataHash?: never;
+};
+export declare function dockGrowthDebit(rate: bigint, threshold: number, length: number): bigint;
+/** Plan guard schema: exact docking intent, Rent quote and gross storage ceiling. */
+export declare const FLEET_DOCK_FUNDING_SCHEMA: GuardSchema;
+/** Requires one exact funding assertion for each current docking instruction. */
+export declare function validateFleetDockFundingGuards(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+export {};
+//# sourceMappingURL=fleet-dock-funding-guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-dock-funding-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-dock-funding-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,EAIL,KAAK,WAAW,EAEjB,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,QAAA,MAAM,OAAO,oSAWH,CAAC;AACX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;CAC9C,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC,CAAC;AACN,MAAM,WAAW,iBAAiB;IAChC,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,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AACD,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GACnD,kBAAkB,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AACJ,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAKR;AAWD,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,EAAE,WAuEvC,CAAC;AAqBF,iFAAiF;AACjF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAgFN"}

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

@@ -0,0 +1,209 @@
+import { isSignerRole, isWritableRole } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { SAGE_PROGRAM_ADDRESS } from '../c4/runtime-bindings.js';
+import { rentMinimumBalance } from './rent.js';
+import { MAX_U64, } from './plan-fields.js';
+import { IDLE_TO_DOCKED_DISCRIMINATOR } from '../c4/discriminators.js';
+export const MAXIMUM_DOCK_GROWTH_BYTES = 40;
+const REASONS = [
+    'unsupported-account-layout',
+    'unsupported-fleet-state',
+    'noncanonical-account-encoding',
+    'stale-definition-sequences',
+    'stale-starbase-sequence',
+    'pending-recovery',
+    'active-stimulants',
+    'funding-state-unavailable',
+    'accounts-below-rent-reserve',
+    'profile-below-storage-ceiling',
+];
+export function dockGrowthDebit(rate, threshold, length) {
+    return (rentMinimumBalance(rate, threshold, length + MAXIMUM_DOCK_GROWTH_BYTES) -
+        rentMinimumBalance(rate, threshold, length));
+}
+const U64 = {
+    min: 0n,
+    max: MAX_U64,
+    accepted: 'an unsigned u64 bigint',
+};
+const U32 = {
+    min: 0,
+    max: 0xffffffff,
+    accepted: 'an unsigned u32 integer',
+};
+/** Plan guard schema: exact docking intent, Rent quote and gross storage ceiling. */
+export const FLEET_DOCK_FUNDING_SCHEMA = {
+    fields: [
+        ...[
+            'address',
+            'game',
+            'profile',
+            'authority',
+            'certificate',
+            'character',
+            'system',
+            'starbasePlayer',
+        ].map((key) => [key, 'address']),
+        ['keyIndex', { min: 0, max: 65535, accepted: 'a u16 Profile key index' }],
+        [
+            'status',
+            {
+                values: ['available', 'unavailable'],
+                accepted: 'available or unavailable',
+            },
+        ],
+        ['describes', 'text'],
+    ],
+    byStatus: {
+        available: [
+            ['maximumProfileDebit', U64],
+            [
+                'fleetDataLengthBytes',
+                { min: 685, max: 0xffffffff, accepted: 'a qualified Fleet length' },
+            ],
+            ['rentLamportsPerByteYear', U64],
+            [
+                'rentExemptionThreshold',
+                {
+                    min: 0,
+                    max: Number.POSITIVE_INFINITY,
+                    finite: true,
+                    accepted: 'a nonnegative finite threshold',
+                },
+            ],
+            ['shipSequenceId', U32],
+            ['cargoSequenceId', U32],
+            ['starbaseSequenceId', U64],
+        ],
+        unavailable: [
+            [
+                'reason',
+                { values: REASONS, accepted: 'a supported unavailable reason' },
+            ],
+        ],
+    },
+    check(guard) {
+        if (guard.status !== 'available')
+            return true;
+        try {
+            return (guard.maximumProfileDebit ===
+                dockGrowthDebit(guard.rentLamportsPerByteYear, guard.rentExemptionThreshold, guard.fleetDataLengthBytes));
+        }
+        catch {
+            return false;
+        }
+    },
+    error: {
+        accepted: 'the exact current docking intent, Rent quote and gross storage ceiling',
+        remedy: 'Recreate the docking Plan; do not alter its saved qualification or debit fields.',
+    },
+};
+/** Pinned generated IdleToDocked account order, for diagnostics. */
+const DOCK_ACCOUNT_LABELS = [
+    'authority',
+    'Profile',
+    'key certificate',
+    'Profile program',
+    'Fleet',
+    'Star System',
+    'StarbasePlayer',
+    'Game',
+    'faction relation tracker',
+    'faction standing slot',
+    'faction config slot',
+    'System ownership',
+    'owner faction slot',
+];
+const SEQUENCE_REMEDY = 'Run the steps as separate confirmed transactions, for example with createPlanSequence and executePlanSequence, and refresh the docking Plan after the other step confirms.';
+const PROFILE_REMEDY = 'Refresh funding and recreate a qualified docking Plan, or run the steps as separate confirmed transactions with createPlanSequence and executePlanSequence.';
+/** Requires one exact funding assertion for each current docking instruction. */
+export function validateFleetDockFundingGuards(steps, guards) {
+    const selected = guards.filter((g) => g.kind === 'fleet-dock-funding');
+    const docks = steps.flatMap((step, index) => step.instruction.programAddress === SAGE_PROGRAM_ADDRESS &&
+        IDLE_TO_DOCKED_DISCRIMINATOR.every((v, n) => step.instruction.data?.[n] === v)
+        ? [{ step, index }]
+        : []);
+    const fail = () => {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Docking requires its exact instruction-bound Profile storage safeguard. Refresh the Fleet and recreate the docking Plan before signing.');
+    };
+    if (selected.length !== docks.length)
+        fail();
+    for (const { step, index: requiringStepIndex } of docks) {
+        const a = step.instruction.accounts;
+        const matches = selected.filter((g) => g.address === a[4].address);
+        if (matches.length !== 1)
+            fail();
+        const g = matches[0];
+        const data = step.instruction.data;
+        if (g.profile !== a[1].address ||
+            g.authority !== a[0].address ||
+            g.certificate !== a[2].address ||
+            g.system !== a[5].address ||
+            g.starbasePlayer !== a[6].address ||
+            g.game !== a[7].address ||
+            g.keyIndex !== (data[8] | (data[9] << 8)) ||
+            step.signers.length !== 1 ||
+            step.signers[0] !== g.authority)
+            fail();
+        for (const address of [g.address, g.character, g.system, g.starbasePlayer])
+            if (!guards.some((v) => v.kind === 'account-state' && v.address === address))
+                fail();
+        // Transaction compilation merges privileges across instructions, so the
+        // qualified quote holds only if no other step can change what docking
+        // reads or writes. Protection follows the dock's own account roles: its
+        // writable accounts admit no other reference, and its readonly inputs admit
+        // no other writer. The signing authority is not a qualification input, and
+        // an available quote shares its Profile through the per-Profile funding
+        // check, so only an unavailable quote isolates the Profile.
+        a.forEach((meta, position) => {
+            if (isSignerRole(meta.role))
+                return;
+            const profile = position === 1;
+            if (profile && g.status === 'available')
+                return;
+            const exclusive = isWritableRole(meta.role);
+            const conflictingStepIndex = steps.findIndex((other, index) => index !== requiringStepIndex &&
+                other.instruction.accounts?.some((candidate) => candidate.address === meta.address &&
+                    (exclusive || isWritableRole(candidate.role))));
+            if (conflictingStepIndex < 0)
+                return;
+            throw new DockAccountReferenceConflictError({
+                resource: meta.address,
+                // validateFleetDockingGuards pins the 13-account layout.
+                accountLabel: DOCK_ACCOUNT_LABELS[position],
+                verb: exclusive ? 'referencing' : 'writing',
+                condition: profile
+                    ? ' while docking storage bounds are unavailable'
+                    : '',
+                remedy: profile ? PROFILE_REMEDY : SEQUENCE_REMEDY,
+                requiringStepIndex,
+                conflictingStepIndex,
+                requiringStepDescription: step.describes,
+                conflictingStepDescription: steps[conflictingStepIndex].describes,
+            });
+        });
+    }
+}
+/** Account-reference conflicts do not assert a declared semantic invalidation. */
+class DockAccountReferenceConflictError extends SageSdkError {
+    conflictKind = 'references';
+    resource;
+    accountLabel;
+    requiringStepIndex;
+    conflictingStepIndex;
+    requiringStepDescription;
+    conflictingStepDescription;
+    remedy;
+    constructor(options) {
+        const { resource, accountLabel, requiringStepIndex, conflictingStepIndex, requiringStepDescription, conflictingStepDescription, remedy, condition, verb, } = options;
+        super('INCOMPATIBLE_PLAN_COMPOSITION', `Plan step ${String(requiringStepIndex)} ("${requiringStepDescription}") cannot share a transaction with step ${String(conflictingStepIndex)} ("${conflictingStepDescription}") ${verb} the same ${accountLabel} (${resource})${condition}. ${remedy}`);
+        this.resource = resource;
+        this.accountLabel = accountLabel;
+        this.requiringStepIndex = requiringStepIndex;
+        this.conflictingStepIndex = conflictingStepIndex;
+        this.requiringStepDescription = requiringStepDescription;
+        this.conflictingStepDescription = conflictingStepDescription;
+        this.remedy = remedy;
+    }
+}
+//# sourceMappingURL=fleet-dock-funding-guard.js.map

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

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

package/dist/internal/planning/fleet-dock-funding.d.ts

@@ -0,0 +1,9 @@
+import type { Address, RawAccount, SageContext } from '../../client/contracts.js';
+import { type DockingSequences } from '../../registry/docking.js';
+import { type DockFundingAmounts, type DockFundingIntent, type FleetDockFundingGuard } from './fleet-dock-funding-guard.js';
+export declare function resolveDockFunding(ctx: SageContext, intent: DockFundingIntent, raw: readonly RawAccount[]): Promise<DockFundingAmounts>;
+export declare function revalidateDockFunding(guard: FleetDockFundingGuard, accounts: ReadonlyMap<Address, RawAccount | undefined>, sequences: DockingSequences | undefined): {
+    profileDebit: bigint;
+    profileReserve: bigint;
+} | undefined;
+//# sourceMappingURL=fleet-dock-funding.d.ts.map

package/dist/internal/planning/fleet-dock-funding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-dock-funding.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-dock-funding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAQnC,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,+BAA+B,CAAC;AA+IvC,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,SAAS,UAAU,EAAE,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAqC7B;AACD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,EACtD,SAAS,EAAE,gBAAgB,GAAG,SAAS,GACtC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAoB9D"}

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":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAG1E,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,43 @@
+import { AccountRole } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { SAGE_PROGRAM_ADDRESS, PLAYER_PROFILE_PROGRAM_ADDRESS, } from '../c4/runtime-bindings.js';
+import { IDLE_TO_DOCKED_DISCRIMINATOR } from '../c4/discriminators.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,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAEvE,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,EAAqB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAO9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAmC5D,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,CAyFf"}

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

@@ -0,0 +1,71 @@
+import { getAddressEncoder } from '@solana/kit';
+import { SAGE_PROGRAM_ADDRESS, getFactionOwnershipDecoder, getFactionRelationTrackerDecoder, } from '../c4/runtime-bindings.js';
+import { defineAccount } from '../c4/account-decoding.js';
+import { SageSdkError } from '../../client/errors.js';
+import { FACTION_OWNERSHIP_DISCRIMINATOR, FACTION_RELATION_TRACKER_DISCRIMINATOR, } from '../c4/discriminators.js';
+import { deriveFactionRelationTrackerPda, deriveStarbaseOwnershipPda, } from '../c4/factions.js';
+// Reuse the exact generated codecs and shared raw-account validation without
+// bringing unrelated faction gameplay projections into the Plan execution bundle.
+const trackerDefinition = /* @__PURE__ */ defineAccount({
+    type: 'factionRelationTracker',
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    discriminator: FACTION_RELATION_TRACKER_DISCRIMINATOR,
+    length: 78,
+}, getFactionRelationTrackerDecoder, (value) => value);
+const ownershipDefinition = /* @__PURE__ */ defineAccount({
+    type: 'factionOwnership',
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    discriminator: FACTION_OWNERSHIP_DISCRIMINATOR,
+    length: 145,
+    exact: true,
+}, getFactionOwnershipDecoder, (value) => value);
+/** 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([
+        deriveFactionRelationTrackerPda(scope.game),
+        deriveStarbaseOwnershipPda(scope.game, 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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"}