@aephia/atlas-kit 0.0.0

package/dist/internal/c4/starbase.d.ts

@@ -0,0 +1,186 @@
+import type { Address, DiscoveryRequest, ProgramAccountFilter, SageContext, SnapshotEnvelope } from '../../client/contracts.js';
+import type { C4AccountAdapter } from './adapter.js';
+/** Stable StarbasePlayer offsets verified against the pinned generated codec. */
+export declare const STARBASE_PLAYER_FILTER_OFFSETS: Readonly<{
+    character: 74;
+    discriminator: 0;
+    profile: 9;
+    system: 42;
+}>;
+/** Stable StarbaseUpgradeProcess offsets verified against the pinned codec. */
+export declare const STARBASE_UPGRADE_FILTER_OFFSETS: Readonly<{
+    discriminator: 0;
+    player: 73;
+    profile: 9;
+    system: 41;
+}>;
+/** Audited player-local Starbase relationships. */
+export declare const STARBASE_RELATIONSHIPS: readonly [{
+    readonly from: "starSystem + character";
+    readonly kind: "derived";
+    readonly mechanism: "StarbasePlayer PDA seeds: literal, System, Character";
+    readonly to: "starbasePlayer";
+}, {
+    readonly from: "character | starSystem";
+    readonly kind: "discovered";
+    readonly mechanism: "targeted discriminator and stored-field filters";
+    readonly to: "starbasePlayer[]";
+}, {
+    readonly from: "starbasePlayer";
+    readonly kind: "stored";
+    readonly mechanism: "Profile, System, and Character account fields";
+    readonly to: "profile | starSystem | character";
+}, {
+    readonly from: "starbasePlayer";
+    readonly kind: "nested";
+    readonly mechanism: "CargoPod, respawn queue, facility, and escrow values";
+    readonly to: "cargoPod";
+}, {
+    readonly from: "starbasePlayer";
+    readonly kind: "stored";
+    readonly mechanism: "StarbaseUpgradeProcess.starbasePlayer field discovery";
+    readonly to: "starbaseUpgradeProcess[]";
+}, {
+    readonly from: "starbasePlayer";
+    readonly kind: "instruction-only";
+    readonly mechanism: "repair, registration, and contribution co-accounts";
+    readonly to: "sharedStarbase | currencyCache";
+}];
+/** Stable translated Starbase faction.
+ * @example
+ * ```ts
+ * const faction: StarbasePlayerFaction = 'mud';
+ * ```
+ */
+export type StarbasePlayerFaction = 'unaligned' | 'mud' | 'oni' | 'ustur';
+/** One translated respawn queue.
+ * @example
+ * ```ts
+ * declare const queue: StarbaseRespawnQueueData;
+ * console.log(queue.quantityRaw);
+ * ```
+ */
+export interface StarbaseRespawnQueueData {
+    readonly quantityRaw: bigint;
+    readonly completesAtUnixSeconds: bigint;
+}
+/** One unresolved ship respawn queue.
+ * @example
+ * ```ts
+ * declare const queue: StarbaseShipRespawnData;
+ * console.log(queue.shipId);
+ * ```
+ */
+export interface StarbaseShipRespawnData extends StarbaseRespawnQueueData {
+    readonly shipId: number;
+}
+/** One unresolved facility respawn queue.
+ * @example
+ * ```ts
+ * declare const queue: StarbaseFacilityRespawnData;
+ * console.log(queue.definitionId);
+ * ```
+ */
+export interface StarbaseFacilityRespawnData extends StarbaseRespawnQueueData {
+    readonly definitionId: number;
+}
+/** One unresolved cargo quantity.
+ * @example
+ * ```ts
+ * declare const amount: StarbaseCargoAmountData;
+ * console.log(amount.cargoId, amount.amount);
+ * ```
+ */
+export interface StarbaseCargoAmountData {
+    readonly cargoId: number;
+    readonly amount: bigint;
+}
+/** One translated nested CargoPod before definition resolution.
+ * @example
+ * ```ts
+ * declare const cargo: StarbaseCargoPodData;
+ * console.log(cargo.amounts);
+ * ```
+ */
+export interface StarbaseCargoPodData {
+    readonly sequenceId: number;
+    readonly usedStorageUnitsRaw: bigint;
+    readonly amounts: readonly StarbaseCargoAmountData[];
+}
+/** One unresolved escrowed ship quantity.
+ * @example
+ * ```ts
+ * declare const ship: StarbaseEscrowedShipData;
+ * console.log(ship.shipId, ship.quantityRaw);
+ * ```
+ */
+export interface StarbaseEscrowedShipData {
+    readonly shipId: number;
+    readonly quantityRaw: bigint;
+}
+/** Fully translated StarbasePlayer account data before registry joins.
+ * @example
+ * ```ts
+ * declare const data: StarbasePlayerAccountData;
+ * console.log(data.character, data.respawning.craftingHabs);
+ * ```
+ */
+export interface StarbasePlayerAccountData {
+    readonly version: number;
+    readonly playerProfile: Address;
+    readonly faction: StarbasePlayerFaction;
+    readonly system: Address;
+    readonly character: Address;
+    readonly totalCrew: number;
+    readonly busyCrew: number;
+    readonly respawning: {
+        readonly crew: StarbaseRespawnQueueData;
+        readonly ships: readonly StarbaseShipRespawnData[];
+        readonly claimStakes: readonly StarbaseFacilityRespawnData[];
+        readonly craftingHabs: readonly StarbaseFacilityRespawnData[];
+        readonly cargo: StarbaseCargoPodData;
+    };
+    readonly sequenceId: bigint;
+    readonly cargoRespawnEndsAtUnixSeconds: bigint;
+    readonly bump: number;
+    readonly shipsInEscrow: readonly StarbaseEscrowedShipData[];
+    readonly cargo: StarbaseCargoPodData;
+}
+/** Fully translated StarbaseUpgradeProcess account data before registry joins.
+ * @example
+ * ```ts
+ * declare const data: StarbaseUpgradeProcessAccountData;
+ * console.log(data.resourceId, data.quantityRaw);
+ * ```
+ */
+export interface StarbaseUpgradeProcessAccountData {
+    readonly version: number;
+    readonly playerProfile: Address;
+    readonly system: Address;
+    readonly starbasePlayer: Address;
+    readonly starbaseSequenceId: bigint;
+    readonly resourceId: number;
+    readonly quantityRaw: bigint;
+    readonly numCrew: number;
+    readonly startsAtUnixSeconds: bigint;
+    readonly endsAtUnixSeconds: bigint;
+}
+/** Stable StarbasePlayer account definition for the pinned C4 bindings. */
+export declare const starbasePlayerAccountDefinition: C4AccountAdapter<StarbasePlayerAccountData>;
+/** Stable StarbaseUpgradeProcess account definition for the pinned bindings. */
+export declare const starbaseUpgradeProcessAccountDefinition: C4AccountAdapter<StarbaseUpgradeProcessAccountData>;
+/** Derives StarbasePlayer from its generated System + Character seed recipe.
+ *
+ * This uses Kit directly because calling the generated bundle selects its
+ * browser-only crypto assertion under Node, while Kit's conditional export
+ * works in both supported environments. The generated helper equivalence is
+ * pinned by the adapter contract tests.
+ */
+export declare function deriveStarbasePlayerAddress(system: Address, character: Address): Promise<Address>;
+export declare function buildStarbasePlayerCharacterDiscoveryFilters(character: Address): readonly ProgramAccountFilter[];
+export declare function buildStarbasePlayerSystemDiscoveryFilters(system: Address): readonly ProgramAccountFilter[];
+export declare function buildStarbaseUpgradePlayerDiscoveryFilters(player: Address): readonly ProgramAccountFilter[];
+export declare function discoverStarbasePlayersByCharacter(context: SageContext, character: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<StarbasePlayerAccountData>[]>;
+export declare function discoverStarbasePlayersBySystem(context: SageContext, system: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<StarbasePlayerAccountData>[]>;
+export declare function discoverStarbaseUpgradeProcessesByPlayer(context: SageContext, player: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<StarbaseUpgradeProcessAccountData>[]>;
+//# sourceMappingURL=starbase.d.ts.map

package/dist/internal/c4/starbase.d.ts.map

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

package/dist/internal/c4/starbase.js

@@ -0,0 +1,259 @@
+import { SAGE_PROGRAM_ADDRESS, STARBASE_PLAYER_DISCRIMINATOR, STARBASE_UPGRADE_PROCESS_DISCRIMINATOR, getStarbasePlayerDecoder, getStarbaseUpgradeProcessDecoder, } from '@staratlas/dev-sage';
+import { Faction } from '@staratlas/dev-profile-faction';
+import { getAddressEncoder, getBytesEncoder, getProgramDerivedAddress, } from '@solana/kit';
+import { AccountDecodeError, InvalidAccountOwnerError, InvalidDiscriminatorError, } from '../../client/errors.js';
+const STARBASE_PLAYER_MINIMUM_DATA_LENGTH = 191;
+const STARBASE_UPGRADE_MINIMUM_DATA_LENGTH = 141;
+const PLAYER_DISCRIMINATOR = Object.freeze(Array.from(STARBASE_PLAYER_DISCRIMINATOR));
+const UPGRADE_DISCRIMINATOR = Object.freeze(Array.from(STARBASE_UPGRADE_PROCESS_DISCRIMINATOR));
+/** Stable StarbasePlayer offsets verified against the pinned generated codec. */
+export const STARBASE_PLAYER_FILTER_OFFSETS = Object.freeze({
+    character: 74,
+    discriminator: 0,
+    profile: 9,
+    system: 42,
+});
+/** Stable StarbaseUpgradeProcess offsets verified against the pinned codec. */
+export const STARBASE_UPGRADE_FILTER_OFFSETS = Object.freeze({
+    discriminator: 0,
+    player: 73,
+    profile: 9,
+    system: 41,
+});
+/** Audited player-local Starbase relationships. */
+export const STARBASE_RELATIONSHIPS = Object.freeze([
+    {
+        from: 'starSystem + character',
+        kind: 'derived',
+        mechanism: 'StarbasePlayer PDA seeds: literal, System, Character',
+        to: 'starbasePlayer',
+    },
+    {
+        from: 'character | starSystem',
+        kind: 'discovered',
+        mechanism: 'targeted discriminator and stored-field filters',
+        to: 'starbasePlayer[]',
+    },
+    {
+        from: 'starbasePlayer',
+        kind: 'stored',
+        mechanism: 'Profile, System, and Character account fields',
+        to: 'profile | starSystem | character',
+    },
+    {
+        from: 'starbasePlayer',
+        kind: 'nested',
+        mechanism: 'CargoPod, respawn queue, facility, and escrow values',
+        to: 'cargoPod',
+    },
+    {
+        from: 'starbasePlayer',
+        kind: 'stored',
+        mechanism: 'StarbaseUpgradeProcess.starbasePlayer field discovery',
+        to: 'starbaseUpgradeProcess[]',
+    },
+    {
+        from: 'starbasePlayer',
+        kind: 'instruction-only',
+        mechanism: 'repair, registration, and contribution co-accounts',
+        to: 'sharedStarbase | currencyCache',
+    },
+]);
+function faction(value) {
+    switch (value) {
+        case Faction.Unaligned:
+            return 'unaligned';
+        case Faction.Mud:
+            return 'mud';
+        case Faction.Oni:
+            return 'oni';
+        case Faction.Ustur:
+            return 'ustur';
+        /* v8 ignore next -- the generated enum decoder rejects unknown values. */
+        default:
+            throw new RangeError(`Unsupported StarbasePlayer faction ${String(value)}.`);
+    }
+}
+function queue(value) {
+    return {
+        completesAtUnixSeconds: value.completeAt,
+        quantityRaw: value.quantity,
+    };
+}
+function cargoPod(value) {
+    return {
+        amounts: [...value.amounts].map(([cargoId, amount]) => ({
+            amount,
+            cargoId,
+        })),
+        sequenceId: value.seqId,
+        usedStorageUnitsRaw: value.storageCost,
+    };
+}
+function translatePlayer(value) {
+    return {
+        bump: value.bump,
+        busyCrew: value.busyCrew,
+        cargo: cargoPod(value.cargoPod),
+        cargoRespawnEndsAtUnixSeconds: value.cargoRespawnEndsAt,
+        character: value.character,
+        faction: faction(value.faction),
+        playerProfile: value.playerProfile,
+        respawning: {
+            cargo: cargoPod(value.respawningCargo),
+            claimStakes: [...value.respawningClaimStakes].map(([definitionId, value]) => ({ definitionId, ...queue(value) })),
+            craftingHabs: [...value.respawningCraftingHabs].map(([definitionId, value]) => ({ definitionId, ...queue(value) })),
+            crew: queue(value.respawningCrew),
+            ships: [...value.respawningShips].map(([shipId, value]) => ({
+                shipId,
+                ...queue(value),
+            })),
+        },
+        sequenceId: value.seqId,
+        shipsInEscrow: [...value.shipsInEscrow].map(([shipId, quantityRaw]) => ({
+            quantityRaw,
+            shipId,
+        })),
+        system: value.system,
+        totalCrew: value.totalCrew,
+        version: value.version,
+    };
+}
+function translateUpgrade(value) {
+    return {
+        endsAtUnixSeconds: value.endTime,
+        numCrew: value.numCrew,
+        playerProfile: value.profile,
+        quantityRaw: value.quantity,
+        resourceId: value.resourceId,
+        starbasePlayer: value.starbasePlayer,
+        starbaseSequenceId: value.starbaseSeqId,
+        startsAtUnixSeconds: value.startTime,
+        system: value.system,
+        version: value.version,
+    };
+}
+function validate(account, type, discriminator, minimumDataLength) {
+    if (account.owner !== SAGE_PROGRAM_ADDRESS) {
+        throw new InvalidAccountOwnerError(type, account.address, SAGE_PROGRAM_ADDRESS, account.owner);
+    }
+    if (account.data.length < discriminator.length ||
+        !discriminator.every((byte, index) => account.data[index] === byte)) {
+        throw new InvalidDiscriminatorError(type, account.address);
+    }
+    if (account.data.length < minimumDataLength) {
+        throw new AccountDecodeError(type, account.address, new RangeError(`Expected at least ${minimumDataLength} ${type} account bytes, received ${account.data.length}.`));
+    }
+}
+function decodeExactly(account, type, read) {
+    try {
+        const [decoded, offset] = read(account.data, 0);
+        if (offset !== account.data.length) {
+            throw new RangeError(`Decoded ${offset} of ${account.data.length} ${type} account bytes; trailing bytes are not accepted.`);
+        }
+        return decoded;
+    }
+    catch (cause) {
+        throw new AccountDecodeError(type, account.address, cause);
+    }
+}
+function validatePlayer(account) {
+    validate(account, 'starbasePlayer', PLAYER_DISCRIMINATOR, STARBASE_PLAYER_MINIMUM_DATA_LENGTH);
+}
+function validateUpgrade(account) {
+    validate(account, 'starbaseUpgradeProcess', UPGRADE_DISCRIMINATOR, STARBASE_UPGRADE_MINIMUM_DATA_LENGTH);
+}
+/** Stable StarbasePlayer account definition for the pinned C4 bindings. */
+export const starbasePlayerAccountDefinition = Object.freeze({
+    decode(account) {
+        validatePlayer(account);
+        return translatePlayer(decodeExactly(account, 'starbasePlayer', (bytes, offset) => getStarbasePlayerDecoder().read(bytes, offset)));
+    },
+    discriminator: PLAYER_DISCRIMINATOR,
+    minimumDataLength: STARBASE_PLAYER_MINIMUM_DATA_LENGTH,
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    type: 'starbasePlayer',
+    validate: validatePlayer,
+});
+/** Stable StarbaseUpgradeProcess account definition for the pinned bindings. */
+export const starbaseUpgradeProcessAccountDefinition = Object.freeze({
+    decode(account) {
+        validateUpgrade(account);
+        return translateUpgrade(decodeExactly(account, 'starbaseUpgradeProcess', (bytes, offset) => getStarbaseUpgradeProcessDecoder().read(bytes, offset)));
+    },
+    discriminator: UPGRADE_DISCRIMINATOR,
+    minimumDataLength: STARBASE_UPGRADE_MINIMUM_DATA_LENGTH,
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    type: 'starbaseUpgradeProcess',
+    validate: validateUpgrade,
+});
+/** Derives StarbasePlayer from its generated System + Character seed recipe.
+ *
+ * This uses Kit directly because calling the generated bundle selects its
+ * browser-only crypto assertion under Node, while Kit's conditional export
+ * works in both supported environments. The generated helper equivalence is
+ * pinned by the adapter contract tests.
+ */
+export async function deriveStarbasePlayerAddress(system, character) {
+    const [address] = await getProgramDerivedAddress({
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        seeds: [
+            getBytesEncoder().encode(new Uint8Array([
+                83, 116, 97, 114, 98, 97, 115, 101, 80, 108, 97, 121, 101, 114,
+            ])),
+            getAddressEncoder().encode(system),
+            getAddressEncoder().encode(character),
+        ],
+    });
+    return address;
+}
+function filters(discriminator, offset, address) {
+    return Object.freeze([
+        { bytes: new Uint8Array(discriminator), offset: 0 },
+        { bytes: new Uint8Array(getAddressEncoder().encode(address)), offset },
+    ]);
+}
+export function buildStarbasePlayerCharacterDiscoveryFilters(character) {
+    return filters(STARBASE_PLAYER_DISCRIMINATOR, STARBASE_PLAYER_FILTER_OFFSETS.character, character);
+}
+export function buildStarbasePlayerSystemDiscoveryFilters(system) {
+    return filters(STARBASE_PLAYER_DISCRIMINATOR, STARBASE_PLAYER_FILTER_OFFSETS.system, system);
+}
+export function buildStarbaseUpgradePlayerDiscoveryFilters(player) {
+    return filters(STARBASE_UPGRADE_PROCESS_DISCRIMINATOR, STARBASE_UPGRADE_FILTER_OFFSETS.player, player);
+}
+async function discoverPlayers(context, relatedAddress, relation, options = {}) {
+    const players = await context.data.discover(starbasePlayerAccountDefinition, {
+        ...options,
+        filters: relation === 'character'
+            ? buildStarbasePlayerCharacterDiscoveryFilters(relatedAddress)
+            : buildStarbasePlayerSystemDiscoveryFilters(relatedAddress),
+        strategy: 'targeted-program-accounts',
+    });
+    for (const player of players) {
+        if (player.data[relation] !== relatedAddress) {
+            throw new AccountDecodeError('starbasePlayer', player.address, new RangeError('The decoded StarbasePlayer contradicted its discovery filter.'), `A discovered Starbase Player candidate did not match the requested ${relation}. Verify the provider and pinned StarbasePlayer filter offsets before retrying.`);
+        }
+    }
+    return players;
+}
+export function discoverStarbasePlayersByCharacter(context, character, options) {
+    return discoverPlayers(context, character, 'character', options);
+}
+export function discoverStarbasePlayersBySystem(context, system, options) {
+    return discoverPlayers(context, system, 'system', options);
+}
+export async function discoverStarbaseUpgradeProcessesByPlayer(context, player, options = {}) {
+    const upgrades = await context.data.discover(starbaseUpgradeProcessAccountDefinition, {
+        ...options,
+        filters: buildStarbaseUpgradePlayerDiscoveryFilters(player),
+        strategy: 'targeted-program-accounts',
+    });
+    for (const upgrade of upgrades) {
+        if (upgrade.data.starbasePlayer !== player) {
+            throw new AccountDecodeError('starbaseUpgradeProcess', upgrade.address, new RangeError('The decoded StarbaseUpgradeProcess contradicted its discovery filter.'), 'A discovered Starbase upgrade candidate did not match the requested Starbase Player. Verify the provider and pinned StarbaseUpgradeProcess filter offsets before retrying.');
+        }
+    }
+    return upgrades;
+}
+//# sourceMappingURL=starbase.js.map

package/dist/internal/c4/starbase.js.map

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