@aephia/atlas-kit 0.6.0-next.11 → 0.6.0-next.110

package/dist/internal/planning/scan-detect.js

@@ -0,0 +1,245 @@
+import { isAddress } from '@solana/kit';
+import { getDetectSignalInstructionDataEncoder, getFleetDecoder, getScanPatternPolicyDecoder, getScanSignalDecoder, getRegionTrackerDecoder, } from '../c4/scan-detection-codecs.js';
+import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { fleetAccountDefinition, deriveFleetAddress } from '../c4/fleet.js';
+import { profileAccountDefinition } from '../c4/identity.js';
+import { characterAccountDefinition, findCharacterPda, } from '../c4/character.js';
+import { deriveRegionTrackerAddress, regionTrackerAccountDefinition, } from '../c4/factions.js';
+import { scanPatternAccountDefinition, deriveScanPatternAddress, } from '../c4/scanning.js';
+import { scanSignalAccountDefinition, scanPatternPolicyAccountDefinition, scanLootProfileAccountDefinition, deriveScanLifecycleAddress, } from '../c4/scan-lifecycle.js';
+import { PROFILE_SCOPE, SAGE_SCOPE } from '../c4/profile-permissions.js';
+import { requireGameAddress } from '../game-context.js';
+import { readFreshGameScanningConfiguration } from '../../registry/scanning.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+import { hashAccountState } from './account-state.js';
+import { regionContainsCoordinate } from '../c4/region-geometry.js';
+import { detectInstruction, } from './scan-detect-guard.js';
+const focuses = [
+    'any',
+    'industrial',
+    'technology',
+    'tactical',
+    'exotic',
+];
+function invalid(field, value) {
+    throw new InvalidActionInputError(field, value, 'the documented direct-owner detection inputs', 'Provide a Fleet address, explicit u16 pattern ID, supported focus and direct Profile authorization; no certificate or automatic setup.');
+}
+function fail(reason) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Signal detection ${reason}. Refresh the Fleet, signal and configuration; complete setup, cargo loading or movement separately before recreating the Plan.`);
+}
+export function validateDetectInput(fleet, options) {
+    if (!isAddress(fleet))
+        invalid('fleet', fleet);
+    if (!options ||
+        typeof options !== 'object' ||
+        Object.keys(options).some((k) => !['patternId', 'focus', 'authorization'].includes(k)))
+        invalid('options', options);
+    if (!Number.isInteger(options.patternId) ||
+        options.patternId < 0 ||
+        options.patternId > 65535)
+        invalid('patternId', options.patternId);
+    if (!focuses.includes(options.focus))
+        invalid('focus', options.focus);
+    const a = options.authorization;
+    if (!a ||
+        typeof a !== 'object' ||
+        Object.keys(a).some((k) => !['profile', 'authority', 'keyIndex'].includes(k)) ||
+        !isAddress(a.profile) ||
+        !isAddress(a.authority) ||
+        !Number.isInteger(a.keyIndex) ||
+        a.keyIndex < 0 ||
+        a.keyIndex > 65535)
+        invalid('authorization', a);
+}
+function required(raw, address) {
+    if (!raw || raw.address !== address || raw.executable)
+        fail(`requires existing non-executable account ${address}`);
+    return raw;
+}
+export async function resolveDetect(ctx, address, options, commitment) {
+    validateDetectInput(address, options);
+    const game = requireGameAddress(ctx);
+    const auth = options.authorization;
+    const read = (addresses) => readContextRawAccounts(ctx, addresses, commitment === undefined ? undefined : { commitment });
+    const [fleetRaw, clockRaw] = await read([address, CLOCK_ADDRESS]);
+    const raw = required(fleetRaw, address);
+    const fleet = fleetAccountDefinition.decode(raw);
+    if (fleet.game !== game ||
+        (await deriveFleetAddress(fleet)) !== address ||
+        fleet.ownerProfile !== auth.profile ||
+        fleet.subProfile !== '11111111111111111111111111111111')
+        fail('requires the canonical directly owned Fleet without delegation');
+    const exact = getFleetDecoder().decode(raw.data);
+    if (exact.state.__kind !== 'Idle')
+        fail('requires a currently Idle Fleet');
+    const now = readClock(required(clockRaw, CLOCK_ADDRESS));
+    if (exact.scanCooldownExpiresAt > now)
+        fail('requires the Fleet scan cooldown to have elapsed');
+    const character = await findCharacterPda(auth.profile, game);
+    const tracker = await deriveRegionTrackerAddress(game);
+    const [signal, signalBump] = await deriveScanLifecycleAddress('scanSignal', game, address);
+    const [policy, policyBump] = await deriveScanLifecycleAddress('scanPatternPolicy', game, options.patternId);
+    const pattern = await deriveScanPatternAddress(game, options.patternId);
+    const keys = [auth.profile, character, tracker, signal, policy, pattern];
+    const raws = await read(keys);
+    const accounts = raws.map((r, i) => required(r, keys[i]));
+    const profile = profileAccountDefinition.decode(accounts[0]);
+    const key = profile.keys[auth.keyIndex];
+    if (!key ||
+        key.address !== auth.authority ||
+        (key.expiresAtRaw >= 0n && key.expiresAtRaw < now) ||
+        ![PROFILE_SCOPE, SAGE_SCOPE].includes(key.scope))
+        fail('requires a current unexpired direct key scoped to Player Profile or SAGE; instruction permission acceptance remains chain-authoritative');
+    const owner = characterAccountDefinition.decode(accounts[1]);
+    if (owner.game !== game || owner.playerProfile !== auth.profile)
+        fail('requires the canonical owning Character');
+    const regionData = regionTrackerAccountDefinition.decode(accounts[2]);
+    if (regionData.game !== game)
+        fail('requires this Game’s RegionTracker');
+    const location = { x: exact.location[0].raw, y: exact.location[1].raw };
+    const region = getRegionTrackerDecoder()
+        .decode(accounts[2].data)
+        .regions.unsizedList.find((r) => regionContainsCoordinate(r, location));
+    if (!region)
+        fail('cannot map the current position to a configured Region');
+    const signalData = scanSignalAccountDefinition.decode(accounts[3]);
+    const rawSignal = getScanSignalDecoder().decode(accounts[3].data);
+    if (signalData.game !== game ||
+        signalData.fleet !== address ||
+        signalData.bump !== signalBump ||
+        rawSignal.ownerProfile !== auth.profile ||
+        rawSignal.ownerCharacter !== character ||
+        rawSignal.controllerProfile !== auth.profile ||
+        rawSignal.controllerCharacter !== character)
+        fail('requires a canonical signal owned and controlled by this Profile and Character');
+    if (signalData.status !== 'empty')
+        fail('requires an existing Empty signal; finish and acknowledge the previous result separately');
+    if (signalData.cooldownEndsAtUnixSeconds > now)
+        fail('requires the signal cooldown to have elapsed');
+    const p = scanPatternPolicyAccountDefinition.decode(accounts[4]);
+    const policyExact = getScanPatternPolicyDecoder().decode(accounts[4].data);
+    const patternData = scanPatternAccountDefinition.decode(accounts[5]);
+    if (p.game !== game ||
+        p.patternId !== options.patternId ||
+        p.bump !== policyBump ||
+        p.status !== 'active' ||
+        patternData.game !== game ||
+        patternData.id !== options.patternId ||
+        patternData.status !== 'active')
+        fail('requires the active selected pattern and canonical policy');
+    const focus = focuses.indexOf(options.focus);
+    if (focus !== 0 &&
+        (policyExact.allowedFocusCategoryMask & (1 << focus)) === 0)
+        fail('does not support the selected focus under this policy');
+    const tags = [
+        ...region.scanningResearchRequirements,
+        ...p.requiredResearchTagIds,
+    ];
+    if (tags.some((t) => !owner.modifiers.values.researchTags.includes(t)))
+        fail('requires the selected Region and policy research tags');
+    const [loot, lootBump] = await deriveScanLifecycleAddress('scanLootProfile', game, region.id);
+    const [lootRaw] = await read([loot]);
+    const l = scanLootProfileAccountDefinition.decode(required(lootRaw, loot));
+    if (l.game !== game ||
+        l.regionId !== region.id ||
+        l.bump !== lootBump ||
+        l.status !== 'active')
+        fail('requires the active canonical loot profile for the current Region');
+    const gameConfig = await readFreshGameScanningConfiguration(ctx, commitment === undefined ? undefined : { commitment });
+    if (fleet.shipDefinitionsSeqId !== gameConfig.shipSequenceId)
+        fail('supports current Fleet ship definitions only; synchronize the Fleet through a supported game client first');
+    const costs = new Map();
+    for (const row of patternData.costs) {
+        const amount = (BigInt(exact.stats.miscStats.scanCost) * row.multiplier.raw + 65535n) /
+            65536n;
+        costs.set(row.cargoId, (costs.get(row.cargoId) ?? 0n) + amount);
+    }
+    const descriptions = [];
+    for (const [id, amount] of costs) {
+        const definition = gameConfig.cargo.definitions.find((row) => row.id === id);
+        if (!definition)
+            fail(`cannot resolve required cargo ${id} from current Game definitions`);
+        const held = exact.cargoHold.amounts.get(id) ?? 0n;
+        if (held < amount)
+            fail(`needs ${amount} raw ${definition.name}; only ${held} aboard`);
+        descriptions.push(`${amount} raw ${definition.name}`);
+    }
+    const selected = {
+        authority: {
+            profileVersion: profile.version,
+            scope: key.scope,
+            permissions: key.permissionsRaw,
+            expires: key.expiresAtRaw,
+        },
+        shipSequence: gameConfig.shipSequenceId,
+        location,
+        region: region.id,
+        regionTags: region.scanningResearchRequirements,
+        pattern: {
+            version: patternData.version,
+            costs: patternData.costs.map((c) => [c.cargoId, c.multiplier.raw]),
+            cooldown: patternData.cooldownMultiplier.raw,
+        },
+        policy: {
+            version: p.version,
+            revision: p.revision,
+            focusMask: policyExact.allowedFocusCategoryMask,
+            tags: p.requiredResearchTagIds,
+        },
+        loot: { version: l.version, revision: l.revision },
+        scanCost: exact.stats.miscStats.scanCost,
+    };
+    const configHash = await hashAccountState(game, new TextEncoder().encode(JSON.stringify(selected, (_, v) => typeof v === 'bigint' ? String(v) : v)));
+    const guard = {
+        kind: 'scan-detect',
+        address,
+        game,
+        profile: auth.profile,
+        authority: auth.authority,
+        character,
+        signal,
+        pattern,
+        policy,
+        loot,
+        tracker,
+        keyIndex: auth.keyIndex,
+        patternId: options.patternId,
+        focus,
+        expectedSequence: signalData.sequence,
+        policyRevision: p.revision,
+        profileRevision: l.revision,
+        configHash,
+        describes: 'The direct owner, Idle Fleet, Empty signal, sequence, selected region/configuration, elapsed cooldown and required cargo remain valid. Refresh and recreate detection if any prerequisite changes.',
+    };
+    return {
+        guard,
+        instruction: {
+            ...detectInstruction(guard),
+            data: getDetectSignalInstructionDataEncoder().encode({
+                keyIndex: auth.keyIndex,
+                expectedSequence: guard.expectedSequence,
+                scanPatternId: options.patternId,
+                expectedPolicyRevision: guard.policyRevision,
+                expectedProfileRevision: guard.profileRevision,
+                focus,
+            }),
+        },
+        costDescription: descriptions.join(', ') || 'no cargo',
+    };
+}
+export async function revalidateDetect(ctx, guard, commitment) {
+    const current = await resolveDetect(ctx, guard.address, {
+        authorization: {
+            profile: guard.profile,
+            authority: guard.authority,
+            keyIndex: guard.keyIndex,
+        },
+        patternId: guard.patternId,
+        focus: focuses[guard.focus],
+    }, commitment);
+    if (Object.entries(guard).some(([key, value]) => key !== 'describes' &&
+        current.guard[key] !== value))
+        fail('intent changed since planning');
+}
+//# sourceMappingURL=scan-detect.js.map

package/dist/internal/planning/scan-detect.js.map

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

package/dist/internal/planning/scan-input.d.ts

@@ -0,0 +1,9 @@
+import { type Address } from '@solana/kit';
+import { type PlanAuthorization } from './authorization-adapter.js';
+/** Rejects anything but one base58 Fleet account address. */
+export declare function validateScanFleetAddress(fleet: unknown): asserts fleet is Address;
+/** Rejects every options shape except exactly
+ *  `{ authorization: { profile, authority, keyIndex } }`, with each field set
+ *  on its own object rather than reached through a prototype. */
+export declare function validateScanAuthorizationOptions(options: unknown): PlanAuthorization;
+//# sourceMappingURL=scan-input.d.ts.map

package/dist/internal/planning/scan-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-input.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/scan-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAyBpC,6DAA6D;AAC7D,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,OAAO,CAQ1B;AAED;;iEAEiE;AACjE,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,OAAO,GACf,iBAAiB,CA2EnB"}

package/dist/internal/planning/scan-input.js

@@ -0,0 +1,58 @@
+import { isAddress } from '@solana/kit';
+import { InvalidActionInputError } from '../../client/errors.js';
+import { validatePlanAuthorization, } from './authorization-adapter.js';
+// Caller-input validation shared by the scanning planners. Every rejection
+// names the failing field and its offending value before any account read.
+const AUTHORIZATION_FIELDS = [
+    'profile',
+    'authority',
+    'keyIndex',
+];
+const SHAPE = 'Pass { authorization: { profile, authority, keyIndex } } with the Profile that owns the Fleet, the address of one of its direct keys and that key index, then plan again.';
+function invalid(field, value, acceptedRange, remedy) {
+    throw new InvalidActionInputError(field, value, acceptedRange, remedy);
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** Rejects anything but one base58 Fleet account address. */
+export function validateScanFleetAddress(fleet) {
+    if (typeof fleet !== 'string' || !isAddress(fleet))
+        invalid('fleet', fleet, 'one base58 Fleet account address', 'Pass the address of the directly owned Fleet, for example from a Fleet snapshot or finder, then plan again.');
+}
+/** Rejects every options shape except exactly
+ *  `{ authorization: { profile, authority, keyIndex } }`, with each field set
+ *  on its own object rather than reached through a prototype. */
+export function validateScanAuthorizationOptions(options) {
+    if (!isRecord(options))
+        invalid('options', options, 'an object with exactly one authorization field', SHAPE);
+    const option = Object.keys(options).find((key) => key !== 'authorization');
+    if (option !== undefined)
+        invalid(`options.${option}`, options[option], 'no option other than authorization', `Remove ${option}. ${SHAPE}`);
+    const authorization = options.authorization;
+    if (!isRecord(authorization))
+        invalid('options.authorization', authorization, 'direct address-only Profile authorization', SHAPE);
+    // Explicit authorization is a field of the options object itself; a value
+    // reached through its prototype never supplies it.
+    if (!Object.hasOwn(options, 'authorization'))
+        invalid('options.authorization', authorization, 'authorization set on the options object itself rather than inherited from its prototype', `Set authorization directly on the options object. ${SHAPE}`);
+    const extra = Object.keys(authorization).find((key) => !AUTHORIZATION_FIELDS.includes(key));
+    if (extra !== undefined)
+        invalid(`options.authorization.${extra}`, authorization[extra], 'no authorization field other than profile, authority and keyIndex', `Remove ${extra}: certificates, substitute accounts and instruction metas are unsupported for signal actions. ${SHAPE}`);
+    const { profile, authority, keyIndex } = authorization;
+    if (typeof profile !== 'string' || !isAddress(profile))
+        invalid('options.authorization.profile', profile, 'the base58 address of the Profile that owns the Fleet', SHAPE);
+    if (typeof authority !== 'string' || !isAddress(authority))
+        invalid('options.authorization.authority', authority, 'the base58 address of one direct key on that Profile', SHAPE);
+    const validated = {
+        profile,
+        authority,
+        keyIndex: keyIndex,
+    };
+    validatePlanAuthorization(validated);
+    const inherited = AUTHORIZATION_FIELDS.find((field) => !Object.hasOwn(authorization, field));
+    if (inherited !== undefined)
+        invalid(`options.authorization.${inherited}`, authorization[inherited], `${inherited} set on the authorization object itself rather than inherited from its prototype`, `Set ${inherited} directly on the authorization object. ${SHAPE}`);
+    return validated;
+}
+//# sourceMappingURL=scan-input.js.map

package/dist/internal/planning/scan-input.js.map

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

package/dist/internal/planning/ship-import-funding.d.ts

@@ -0,0 +1,22 @@
+import type { Address, RawAccount } from '../../client/contracts.js';
+export interface ShipImportFundingIntent {
+    readonly address: Address;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly system: Address;
+    readonly shipId: number;
+}
+export interface ShipImportFundingAccounts {
+    readonly profile: Address;
+    readonly character: Address;
+    readonly starbasePlayer: Address;
+    readonly rent: Address;
+}
+/** Resolves only the finite funding prerequisites; no implicit Game account read. */
+export declare function resolveShipImportFunding(intent: ShipImportFundingIntent): Promise<ShipImportFundingAccounts>;
+/** Shared preparation/execution funding calculation; existing action guards retain permissions and inventory intent. */
+export declare function validateShipImportFunding(intent: ShipImportFundingIntent, resolved: ShipImportFundingAccounts, accounts: ReadonlyMap<Address, RawAccount | undefined>, maximumProfileDebit?: bigint): {
+    profileDebit: bigint;
+    profileReserve: bigint;
+};
+//# sourceMappingURL=ship-import-funding.d.ts.map

package/dist/internal/planning/ship-import-funding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship-import-funding.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/ship-import-funding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAcrE,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,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAID,qFAAqF;AACrF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CAiBpC;AACD,wHAAwH;AACxH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,EAAE,yBAAyB,EACnC,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,EACtD,mBAAmB,CAAC,EAAE,MAAM,GAC3B;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAkDlD"}

package/dist/internal/planning/ship-import-funding.js

@@ -0,0 +1,53 @@
+import { SageSdkError } from '../../client/errors.js';
+import { profileAccountDefinition } from '../c4/identity.js';
+import { characterAccountDefinition, findCharacterPda, } from '../c4/character.js';
+import { starbasePlayerAccountDefinition, deriveStarbasePlayerAddress, } from '../c4/starbase.js';
+import { shipImportStorageSize } from '../c4/ship-import.js';
+import { RENT_ADDRESS, readRent } from './rent.js';
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+/** Resolves only the finite funding prerequisites; no implicit Game account read. */
+export async function resolveShipImportFunding(intent) {
+    const character = await findCharacterPda(intent.profile, intent.game);
+    const starbasePlayer = await deriveStarbasePlayerAddress(intent.system, character);
+    if (starbasePlayer !== intent.address)
+        fail(intent.address, 'Ship import funding requires the canonical StarbasePlayer for this Game, Profile and System. Refresh that registration and prepare a new import.');
+    return {
+        profile: intent.profile,
+        character,
+        starbasePlayer,
+        rent: RENT_ADDRESS,
+    };
+}
+/** Shared preparation/execution funding calculation; existing action guards retain permissions and inventory intent. */
+export function validateShipImportFunding(intent, resolved, accounts, maximumProfileDebit) {
+    const required = (address, role) => {
+        const raw = accounts.get(address);
+        if (!raw || raw.address !== address || raw.executable)
+            fail(address, `${role} is missing or invalid for ship import funding. Refresh the canonical account and replan.`);
+        return raw;
+    };
+    const profile = required(resolved.profile, 'Profile');
+    profileAccountDefinition.decode(profile);
+    const character = characterAccountDefinition.decode(required(resolved.character, 'Character'));
+    if (character.game !== intent.game ||
+        character.playerProfile !== intent.profile)
+        fail(resolved.character, 'The Character has a different Game or Profile. Refresh the canonical Character and replan ship import.');
+    const target = required(resolved.starbasePlayer, 'StarbasePlayer');
+    const player = starbasePlayerAccountDefinition.decode(target);
+    if (player.playerProfile !== intent.profile ||
+        player.character !== resolved.character ||
+        player.system !== intent.system)
+        fail(target.address, 'The StarbasePlayer has a different Profile, Character or System. Refresh the canonical registration and replan ship import.');
+    const rent = readRent(required(resolved.rent, 'Rent sysvar'));
+    const storageRent = rent(shipImportStorageSize(target, intent.shipId));
+    const profileDebit = storageRent > target.lamports ? storageRent - target.lamports : 0n;
+    if (maximumProfileDebit !== undefined && profileDebit > maximumProfileDebit)
+        fail(intent.profile, 'Ship import now requires a larger Profile debit than this Plan approved. Refresh and replan the current StarbasePlayer storage shortfall before signing.');
+    const profileReserve = rent(profile.data.length);
+    if (profile.lamports < profileReserve + profileDebit)
+        fail(intent.profile, `Profile vault needs ${profileReserve + profileDebit - profile.lamports} more native lamports to fund StarbasePlayer storage while retaining its own reserve. Fund the Profile separately and replan ship import.`);
+    return { profileDebit, profileReserve };
+}
+//# sourceMappingURL=ship-import-funding.js.map

package/dist/internal/planning/ship-import-funding.js.map

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

package/dist/internal/planning/ship-token.d.ts

@@ -1,10 +1,5 @@
-import { type Address } from '@solana/kit';
+import type { Address } from '@solana/kit';
 import type { RawAccount } from '../../client/contracts.js';
-export declare const ORIGINAL_TOKEN_PROGRAM: Address;
-export declare const ATA_PROGRAM: Address;
-export declare const SYSTEM_PROGRAM: Address;
 export declare function failShipImport(message: string, address: Address): never;
-export declare function deriveShipTokenAddress(owner: Address, mint: Address): Promise<Address>;
 export declare function validateShipMint(account: RawAccount): void;
-export declare function validateShipToken(account: RawAccount, mint: Address, owner: Address): bigint;
 //# sourceMappingURL=ship-token.d.ts.map

package/dist/internal/planning/ship-token.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ship-token.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/ship-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,eAAO,MAAM,sBAAsB,EACgB,OAAO,CAAC;AAC3D,eAAO,MAAM,WAAW,EAC4B,OAAO,CAAC;AAC5D,eAAO,MAAM,cAAc,EAAyC,OAAO,CAAC;AAC5E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,KAAK,CAMvE;AACD,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAYlB;AAwBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAS1D;AACD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,OAAO,GACb,MAAM,CAcR"}
+{"version":3,"file":"ship-token.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/ship-token.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,KAAK,CAMvE;AACD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAM1D"}

package/dist/internal/planning/ship-token.js

@@ -1,49 +1,10 @@
-import { getAddressDecoder, getAddressEncoder, getProgramDerivedAddress, } from '@solana/kit';
+import { validateTokenMint } from './token-mint.js';
 import { SageSdkError } from '../../client/errors.js';
-export const ORIGINAL_TOKEN_PROGRAM = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';
-export const ATA_PROGRAM = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';
-export const SYSTEM_PROGRAM = '11111111111111111111111111111111';
 export function failShipImport(message, address) {
     throw new SageSdkError('ACTION_PRECONDITION_FAILED', `${message} Refresh the relevant accounts and prepare a new ship import Plan.`, { address });
 }
-export async function deriveShipTokenAddress(owner, mint) {
-    const encoder = getAddressEncoder();
-    return (await getProgramDerivedAddress({
-        programAddress: ATA_PROGRAM,
-        seeds: [
-            encoder.encode(owner),
-            encoder.encode(ORIGINAL_TOKEN_PROGRAM),
-            encoder.encode(mint),
-        ],
-    }))[0];
-}
-function bytes(account, length) {
-    if (account.executable ||
-        account.owner !== ORIGINAL_TOKEN_PROGRAM ||
-        account.data.length !== length)
-        failShipImport(`Account ${account.address} must be an original Token account with exactly ${length} bytes; Token-2022 is unsupported.`, account.address);
-    return new DataView(account.data.buffer, account.data.byteOffset, account.data.byteLength);
-}
-function option(view, offset, account) {
-    if (view.getUint32(offset, true) > 1)
-        failShipImport('The Token account has malformed optional fields.', account.address);
-}
 export function validateShipMint(account) {
-    const view = bytes(account, 82);
-    option(view, 0, account);
-    option(view, 46, account);
-    if (view.getUint8(45) !== 1 || view.getUint8(44) !== 0)
+    if (validateTokenMint(account) !== 0)
         failShipImport('Ship import requires an initialized zero-decimal mint so each token is one ship.', account.address);
 }
-export function validateShipToken(account, mint, owner) {
-    const view = bytes(account, 165);
-    for (const offset of [72, 109, 129])
-        option(view, offset, account);
-    const decoder = getAddressDecoder();
-    if (view.getUint8(108) !== 1 ||
-        decoder.decode(account.data.subarray(0, 32)) !== mint ||
-        decoder.decode(account.data.subarray(32, 64)) !== owner)
-        failShipImport(`The token account must be initialized, unfrozen and hold ship mint ${mint} under authority ${owner}. Delegated token spending is unsupported.`, account.address);
-    return view.getBigUint64(64, true);
-}
 //# sourceMappingURL=ship-token.js.map

package/dist/internal/planning/ship-token.js.map

@@ -1 +1 @@
-{"version":3,"file":"ship-token.js","sourceRoot":"","sources":["../../../src/internal/planning/ship-token.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ship-token.js","sourceRoot":"","sources":["../../../src/internal/planning/ship-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,OAAgB;IAC9D,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,GAAG,OAAO,oEAAoE,EAC9E,EAAE,OAAO,EAAE,CACZ,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IAClD,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC;QAClC,cAAc,CACZ,kFAAkF,EAClF,OAAO,CAAC,OAAO,CAChB,CAAC;AACN,CAAC"}

package/dist/internal/planning/starbase-player-owner.d.ts

@@ -0,0 +1,21 @@
+import type { Address } from '@solana/kit';
+/** The identity fields of a loaded Starbase Player snapshot. */
+interface StarbasePlayerIdentity {
+    readonly address: Address;
+    readonly playerProfile: {
+        readonly address: Address;
+    };
+    readonly character: {
+        readonly address: Address;
+    };
+    readonly system: {
+        readonly address: Address;
+    };
+}
+/** Requires a loaded Starbase Player to belong to the authorization Profile,
+ * reference that Profile's canonical Character in the configured Game, and sit
+ * at its canonical address; returns the Character. Fresh-state checks remain
+ * the caller's. */
+export declare function requireProfileStarbasePlayer(player: StarbasePlayerIdentity, profile: Address, game: Address): Promise<Address>;
+export {};
+//# sourceMappingURL=starbase-player-owner.d.ts.map

package/dist/internal/planning/starbase-player-owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starbase-player-owner.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/starbase-player-owner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,gEAAgE;AAChE,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAChD;AAED;;;mBAGmB;AACnB,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/internal/planning/starbase-player-owner.js

@@ -0,0 +1,17 @@
+import { SageSdkError } from '../../client/errors.js';
+import { findCharacterPda } from '../c4/character.js';
+import { deriveStarbasePlayerAddress } from '../c4/starbase.js';
+/** Requires a loaded Starbase Player to belong to the authorization Profile,
+ * reference that Profile's canonical Character in the configured Game, and sit
+ * at its canonical address; returns the Character. Fresh-state checks remain
+ * the caller's. */
+export async function requireProfileStarbasePlayer(player, profile, game) {
+    const character = await findCharacterPda(profile, game);
+    if (player.playerProfile.address !== profile ||
+        player.character.address !== character ||
+        (await deriveStarbasePlayerAddress(player.system.address, character)) !==
+            player.address)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Starbase Player ${player.address} is not the canonical registration of authorization Profile ${profile} with its canonical Character ${character} in Star System ${player.system.address}. Load that Profile's Starbase Player through this context and retry.`, { address: player.address });
+    return character;
+}
+//# sourceMappingURL=starbase-player-owner.js.map

package/dist/internal/planning/starbase-player-owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starbase-player-owner.js","sourceRoot":"","sources":["../../../src/internal/planning/starbase-player-owner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAUhE;;;mBAGmB;AACnB,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAA8B,EAC9B,OAAgB,EAChB,IAAa;IAEb,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxD,IACE,MAAM,CAAC,aAAa,CAAC,OAAO,KAAK,OAAO;QACxC,MAAM,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS;QACtC,CAAC,MAAM,2BAA2B,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACnE,MAAM,CAAC,OAAO;QAEhB,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,mBAAmB,MAAM,CAAC,OAAO,+DAA+D,OAAO,iCAAiC,SAAS,mBAAmB,MAAM,CAAC,MAAM,CAAC,OAAO,uEAAuE,EAChQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAC5B,CAAC;IACJ,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/internal/planning/starbase-system-guard.d.ts

@@ -0,0 +1,6 @@
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+/** Binds required guards to actual instruction accounts without pulling byte decoders into every action entry. */
+export declare function validateStarbaseSystemGuards(steps: readonly PlanStep[], preconditions: readonly PlanPrecondition[]): void;
+/** Hydration and assembly additionally verify exact bytes with the pinned generated decoders. */
+export declare function validateStarbaseSystemInstructions(steps: readonly PlanStep[], preconditions: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=starbase-system-guard.d.ts.map

package/dist/internal/planning/starbase-system-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starbase-system-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/starbase-system-guard.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAuD1E,kHAAkH;AAClH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,aAAa,EAAE,SAAS,gBAAgB,EAAE,GACzC,IAAI,CAmBN;AAED,iGAAiG;AACjG,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,aAAa,EAAE,SAAS,gBAAgB,EAAE,GACzC,IAAI,CAoBN"}