@aephia/atlas-kit 0.0.0

package/dist/internal/c4/combat.js

@@ -0,0 +1,232 @@
+import { LOOT_DISCRIMINATOR, OUTLAW_FLAG_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, getLootDecoder, getOutlawFlagDecoder, } from '@staratlas/dev-sage';
+import { getAddressEncoder, getBytesEncoder, getProgramDerivedAddress, getU8Encoder, } from '@solana/kit';
+import { AccountDecodeError, InvalidAccountOwnerError, InvalidDiscriminatorError, MissingGameContextError, } from '../../client/errors.js';
+import { assertLootLayout, LOOT_FILTER_OFFSETS, LOOT_MINIMUM_DATA_LENGTH, } from './loot-layout.js';
+const OUTLAW_FLAG_DATA_LENGTH = 60;
+const LOOT_ACCOUNT_DISCRIMINATOR = Object.freeze(Array.from(LOOT_DISCRIMINATOR));
+const OUTLAW_FLAG_ACCOUNT_DISCRIMINATOR = Object.freeze(Array.from(OUTLAW_FLAG_DISCRIMINATOR));
+export { LOOT_FILTER_OFFSETS } from './loot-layout.js';
+/** Audited read and deferred-action relationships for the combat capability. */
+export const COMBAT_RELATIONSHIPS = Object.freeze([
+    {
+        from: 'profile + faction',
+        kind: 'derived',
+        mechanism: 'OutlawFlag PDA seeds',
+        to: 'outlawFlag?',
+    },
+    {
+        from: 'loot',
+        kind: 'stored',
+        mechanism: 'Game, Profile, coordinates, and destroyer account fields',
+        to: 'game | profile | fleet',
+    },
+    {
+        from: 'combat',
+        kind: 'nested',
+        mechanism: 'Game config, Fleet combat state, and Loot items/reward legs',
+        to: 'configuration | fleetCombatStatus | lootInventory',
+    },
+    {
+        from: 'combat',
+        kind: 'instruction-only',
+        mechanism: 'attack, repair, stimulant, reward resolution, and sweep co-accounts are not durable relations',
+        to: 'actions',
+    },
+    {
+        from: 'game | profile',
+        kind: 'discovered',
+        mechanism: 'targeted Loot discriminator, Game, and Profile filters',
+        to: 'loot[]',
+    },
+]);
+function hasDiscriminator(data, discriminator) {
+    return discriminator.every((byte, index) => data[index] === byte);
+}
+function validateOwnerAndDiscriminator(account, type, discriminator) {
+    if (account.owner !== SAGE_PROGRAM_ADDRESS) {
+        throw new InvalidAccountOwnerError(type, account.address, SAGE_PROGRAM_ADDRESS, account.owner);
+    }
+    if (account.data.length < discriminator.length ||
+        !hasDiscriminator(account.data, discriminator)) {
+        throw new InvalidDiscriminatorError(type, account.address);
+    }
+}
+function validateLootAccount(account) {
+    validateOwnerAndDiscriminator(account, 'loot', LOOT_ACCOUNT_DISCRIMINATOR);
+    if (account.data.length < LOOT_MINIMUM_DATA_LENGTH) {
+        throw new AccountDecodeError('loot', account.address, new RangeError(`Expected at least ${LOOT_MINIMUM_DATA_LENGTH} Loot account bytes, received ${account.data.length}.`));
+    }
+}
+function validateOutlawFlagAccount(account) {
+    validateOwnerAndDiscriminator(account, 'outlawFlag', OUTLAW_FLAG_ACCOUNT_DISCRIMINATOR);
+    if (account.data.length !== OUTLAW_FLAG_DATA_LENGTH) {
+        throw new AccountDecodeError('outlawFlag', account.address, new RangeError(`Expected exactly ${OUTLAW_FLAG_DATA_LENGTH} OutlawFlag 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 cargoPod(value) {
+    return {
+        amounts: [...value.amounts].map(([cargoId, amount]) => ({
+            amount,
+            cargoId,
+        })),
+        sequenceId: value.seqId,
+        storageCostRaw: value.storageCost,
+    };
+}
+function reward(value) {
+    if (value.rewardStatus === 0)
+        return { kind: 'none' };
+    return {
+        committedAtUnixSeconds: value.rewardCommittedAt,
+        configVersion: value.rewardConfigVersion,
+        ...(value.rewardStatus === 1
+            ? { kind: 'committed' }
+            : value.rewardStatus === 2
+                ? { kind: 'resolved' }
+                : { kind: 'unknown', rawStatus: value.rewardStatus }),
+        legs: value.rewardLegs.slice(0, value.rewardLegCount).map((leg) => ({
+            medallionsRaw: leg.medallions,
+            recipient: leg.recipient,
+            salvageTargetValueRaw: leg.salvageTargetValue,
+        })),
+        slot: value.rewardCommitSlot,
+    };
+}
+function translateLoot(value) {
+    return {
+        coordinates: {
+            x: value.coordinates[0].toNumber(),
+            y: value.coordinates[1].toNumber(),
+        },
+        game: value.gameId,
+        items: value.items.unsizedList.map((item) => ({
+            destroyer: item.destroyer,
+            exclusivityUnlockAtUnixSeconds: item.exclusivityUnlockTime,
+            inventory: cargoPod(item.loot),
+            rewardReclaimAtUnixSeconds: item.rewardReclaimAt,
+        })),
+        profile: value.profile,
+        reward: reward(value),
+        version: value.version,
+    };
+}
+function faction(value) {
+    switch (value) {
+        case 0:
+            return 'unaligned';
+        case 1:
+            return 'mud';
+        case 2:
+            return 'oni';
+        case 3:
+            return 'ustur';
+        default:
+            throw new RangeError(`Unsupported OutlawFlag faction ${String(value)}.`);
+    }
+}
+function translateOutlawFlag(value) {
+    if (value.outlaw !== 0 && value.outlaw !== 1) {
+        throw new RangeError(`Unsupported OutlawFlag status ${String(value.outlaw)}.`);
+    }
+    return {
+        bump: value.bump,
+        declaredAtUnixSeconds: value.declaredAt,
+        faction: faction(value.faction),
+        isOutlaw: value.outlaw === 1,
+        profile: value.profile,
+        pvpUntilUnixSeconds: value.pvpUntil,
+        version: value.version,
+    };
+}
+export const lootAccountDefinition = Object.freeze({
+    decode(account) {
+        validateLootAccount(account);
+        const decoded = decodeExactly(account, 'loot', (bytes, offset) => getLootDecoder().read(bytes, offset));
+        assertLootLayout(account, decoded);
+        return translateLoot(decoded);
+    },
+    discriminator: LOOT_ACCOUNT_DISCRIMINATOR,
+    minimumDataLength: LOOT_MINIMUM_DATA_LENGTH,
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    type: 'loot',
+    validate: validateLootAccount,
+});
+export const outlawFlagAccountDefinition = Object.freeze({
+    decode(account) {
+        validateOutlawFlagAccount(account);
+        const decoded = decodeExactly(account, 'outlawFlag', (bytes, offset) => getOutlawFlagDecoder().read(bytes, offset));
+        try {
+            return translateOutlawFlag(decoded);
+        }
+        catch (cause) {
+            throw new AccountDecodeError('outlawFlag', account.address, cause);
+        }
+    },
+    discriminator: OUTLAW_FLAG_ACCOUNT_DISCRIMINATOR,
+    minimumDataLength: OUTLAW_FLAG_DATA_LENGTH,
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    type: 'outlawFlag',
+    validate: validateOutlawFlagAccount,
+});
+function factionValue(value) {
+    return ['unaligned', 'mud', 'oni', 'ustur'].indexOf(value);
+}
+/** Derives the optional OutlawFlag address for one Profile/faction pair. */
+export async function deriveOutlawFlagAddress(profile, againstFaction) {
+    const [address] = await getProgramDerivedAddress({
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        seeds: [
+            getBytesEncoder().encode(new Uint8Array([111, 117, 116, 108, 97, 119, 95, 102, 108, 97, 103])),
+            getAddressEncoder().encode(profile),
+            getU8Encoder().encode(factionValue(againstFaction)),
+        ],
+    });
+    return address;
+}
+/** Builds stable targeted filters for Loot by Game and creator Profile. */
+export function buildLootDiscoveryFilters(game, profile) {
+    return Object.freeze([
+        {
+            bytes: new Uint8Array(LOOT_DISCRIMINATOR),
+            offset: LOOT_FILTER_OFFSETS.discriminator,
+        },
+        {
+            bytes: new Uint8Array(getAddressEncoder().encode(game)),
+            offset: LOOT_FILTER_OFFSETS.game,
+        },
+        {
+            bytes: new Uint8Array(getAddressEncoder().encode(profile)),
+            offset: LOOT_FILTER_OFFSETS.profile,
+        },
+    ]);
+}
+/** Discovers Loot by stable Game/Profile fields and revalidates every decoded hint. */
+export async function discoverLootAccounts(context, profile, options = {}) {
+    const game = context.game;
+    if (game === undefined)
+        throw new MissingGameContextError();
+    const loot = await context.data.discover(lootAccountDefinition, {
+        ...options,
+        filters: buildLootDiscoveryFilters(game, profile),
+        strategy: 'targeted-program-accounts',
+    });
+    for (const candidate of loot) {
+        if (candidate.data.game !== game || candidate.data.profile !== profile) {
+            throw new AccountDecodeError('loot', candidate.address, new RangeError('Decoded Loot fields contradicted discovery filters.'), `A discovered Loot candidate did not match the requested Game and Profile after decoding. Verify the provider, configured cluster, and pinned Loot filter offsets before retrying.`);
+        }
+    }
+    return loot;
+}
+//# sourceMappingURL=combat.js.map

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

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

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

@@ -0,0 +1,170 @@
+import type { Address, DiscoveryRequest, ProgramAccountFilter, SageContext, SnapshotEnvelope } from '../../client/contracts.js';
+import type { C4AccountAdapter } from './adapter.js';
+export declare const CRAFTING_HAB_FILTER_OFFSETS: Readonly<{
+    discriminator: 0;
+    game: 41;
+    owner: 9;
+    system: 73;
+}>;
+export declare const CRAFTING_PROCESS_FILTER_OFFSETS: Readonly<{
+    craftingHab: 145;
+    discriminator: 0;
+    profile: 41;
+    recipe: 9;
+    starbasePlayer: 105;
+    system: 73;
+}>;
+export declare const CRAFTING_RELATIONSHIPS: readonly [{
+    readonly from: "game + recipeId";
+    readonly kind: "derived";
+    readonly mechanism: "Recipe PDA seeds: literal, Game, and recipe id";
+    readonly to: "recipe";
+}, {
+    readonly from: "profile | starSystem";
+    readonly kind: "discovered";
+    readonly mechanism: "targeted CraftingHabInstance stored-field filters";
+    readonly to: "craftingHabInstance[]";
+}, {
+    readonly from: "profile | starbasePlayer";
+    readonly kind: "discovered";
+    readonly mechanism: "targeted CraftingProcess stored-field filters";
+    readonly to: "craftingProcess[]";
+}, {
+    readonly from: "craftingProcess";
+    readonly kind: "stored";
+    readonly mechanism: "Recipe, Profile, System, StarbasePlayer, and Crafting Hab fields";
+    readonly to: "recipe | profile | starSystem | starbasePlayer | craftingHabInstance";
+}, {
+    readonly from: "craftingHabInstance | craftingProcess";
+    readonly kind: "nested";
+    readonly mechanism: "ProductionCore and committed-input CargoPod values";
+    readonly to: "cargoPod";
+}, {
+    readonly from: "craftingProcess";
+    readonly kind: "instruction-only";
+    readonly mechanism: "currency cache and output CargoPod co-accounts are not stored";
+    readonly to: "currencyCache | outputCargoPod";
+}];
+export interface CraftingFixedValueData {
+    readonly raw: bigint;
+    readonly value: number;
+}
+export interface CraftingModifierData {
+    readonly efficiency: CraftingFixedValueData;
+    readonly fee: CraftingFixedValueData;
+    readonly speed: CraftingFixedValueData;
+    readonly crewCount: CraftingFixedValueData;
+}
+export interface CraftingModifierBoundsData {
+    readonly minimum: CraftingFixedValueData;
+    readonly maximum: CraftingFixedValueData;
+}
+export interface CraftingCargoAmountData {
+    readonly cargoId: number;
+    readonly quantityRaw: bigint;
+}
+export interface CraftingCargoPodData {
+    readonly amounts: readonly CraftingCargoAmountData[];
+    readonly sequenceId: number;
+    readonly storageCostRaw: bigint;
+}
+export interface RecipeAccountData {
+    readonly version: number;
+    readonly id: number;
+    readonly game: Address;
+    readonly craftingDurationSeconds: bigint;
+    readonly minimumDurationSeconds: bigint;
+    readonly name: string;
+    readonly status: 'active' | 'deactivated';
+    readonly fee: {
+        readonly amountRaw: bigint;
+        readonly amountAtlas: number;
+        readonly recipient: 'atlas' | 'dao-atlas';
+    };
+    readonly habRequired: boolean;
+    readonly usageCountRaw: bigint;
+    readonly usageLimitRaw: bigint;
+    readonly xpValueRaw: bigint;
+    readonly minimumStarbaseLevel: 'level-0' | 'level-1' | 'level-2' | 'level-3' | 'level-4' | 'level-5' | 'css';
+    readonly modifierBounds: {
+        readonly efficiency: CraftingModifierBoundsData;
+        readonly speed: CraftingModifierBoundsData;
+        readonly crewCount: CraftingModifierBoundsData;
+        readonly fee: CraftingModifierBoundsData;
+    };
+    readonly researchRequirementIds: readonly number[];
+    readonly inputs: readonly CraftingCargoAmountData[];
+    readonly outputs: readonly CraftingCargoAmountData[];
+}
+export interface CraftingBuildingQuantityData {
+    readonly buildingId: number;
+    readonly quantity: number;
+}
+export type CraftingHabStateData = {
+    readonly kind: 'active';
+} | {
+    readonly kind: 'design';
+    readonly sequenceId: number;
+    readonly buildings: readonly CraftingBuildingQuantityData[];
+} | {
+    readonly kind: 'deactivated';
+    readonly deactivatedAtUnixSeconds: bigint;
+};
+export interface CraftingProductionRateData {
+    readonly cargoId: number;
+    readonly unitsPerSecond: number;
+    readonly unitsPerSecondRaw: bigint;
+}
+export interface CraftingHabAccountData {
+    readonly version: number;
+    readonly ownerProfile: Address;
+    readonly game: Address;
+    readonly system: Address;
+    readonly definitionId: number;
+    readonly definitionSequenceId: number;
+    readonly buildingDefinitionSequenceId: number;
+    readonly systemSequenceId: bigint;
+    readonly lastRentAtUnixSeconds: bigint;
+    readonly constructionRemainingSeconds: bigint;
+    readonly constructionProgressAtUnixSeconds: bigint;
+    readonly rentBalanceRaw: bigint;
+    readonly neededCrew: number;
+    readonly jobCapacity: number;
+    readonly jobsRunning: number;
+    readonly modifiers: CraftingModifierData;
+    readonly buildings: readonly CraftingBuildingQuantityData[];
+    readonly unlockedRecipeIds: readonly number[];
+    readonly state: CraftingHabStateData;
+    readonly production: {
+        readonly lastTickAtUnixSeconds: bigint;
+        readonly resourceCapacityRaw: bigint;
+        readonly netRates: readonly CraftingProductionRateData[];
+        readonly inventory: CraftingCargoPodData;
+    };
+}
+export interface CraftingProcessAccountData {
+    readonly version: number;
+    readonly recipe: Address;
+    readonly profile: Address;
+    readonly system: Address;
+    readonly starbasePlayer: Address;
+    readonly starbaseSequenceId: bigint;
+    readonly craftingHab: Address;
+    readonly quantityRaw: bigint;
+    readonly numCrew: number;
+    readonly startsAtUnixSeconds: bigint;
+    readonly endsAtUnixSeconds: bigint;
+    readonly feeEscrowRaw: bigint;
+    readonly inputs: CraftingCargoPodData;
+}
+export declare const recipeAccountDefinition: C4AccountAdapter<RecipeAccountData>;
+export declare const craftingHabAccountDefinition: C4AccountAdapter<CraftingHabAccountData>;
+export declare const craftingProcessAccountDefinition: C4AccountAdapter<CraftingProcessAccountData>;
+export declare function deriveRecipeAddress(game: Address, recipeId: number): Promise<Address>;
+export declare function buildCraftingHabOwnerDiscoveryFilters(game: Address, owner: Address, system?: Address): readonly ProgramAccountFilter[];
+export declare function buildCraftingProcessProfileDiscoveryFilters(profile: Address): readonly ProgramAccountFilter[];
+export declare function buildCraftingProcessStarbaseDiscoveryFilters(starbasePlayer: Address): readonly ProgramAccountFilter[];
+export declare function discoverCraftingHabsByOwner(context: SageContext, game: Address, owner: Address, system: Address | undefined, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<CraftingHabAccountData>[]>;
+export declare function discoverCraftingProcessesByProfile(context: SageContext, profile: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<CraftingProcessAccountData>[]>;
+export declare function discoverCraftingProcessesByStarbasePlayer(context: SageContext, player: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<CraftingProcessAccountData>[]>;
+//# sourceMappingURL=crafting.d.ts.map

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

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