@aephia/atlas-kit 0.0.0

package/dist/internal/c4/character-modifier.js

@@ -0,0 +1,100 @@
+import { OptionalTier, RiskZoneChecked, SizeClass, } from '@staratlas/dev-sage';
+function optionalTier(tier) {
+    switch (tier) {
+        case OptionalTier.None:
+            return undefined;
+        case OptionalTier.One:
+            return 1;
+        case OptionalTier.Two:
+            return 2;
+        case OptionalTier.Three:
+            return 3;
+        case OptionalTier.Four:
+            return 4;
+        case OptionalTier.Five:
+            return 5;
+        /* v8 ignore next -- the generated enum decoder rejects unknown values. */
+        default:
+            throw new RangeError(`Unsupported OptionalTier value ${String(tier)}.`);
+    }
+}
+function riskZone(zone) {
+    switch (zone) {
+        case RiskZoneChecked.LowRiskZone:
+            return 'low';
+        case RiskZoneChecked.MediumRiskZone:
+            return 'medium';
+        case RiskZoneChecked.HighRiskZone:
+            return 'high';
+        /* v8 ignore next -- the generated enum decoder rejects unknown values. */
+        default:
+            throw new RangeError(`Unsupported RiskZoneChecked value ${String(zone)}.`);
+    }
+}
+function shipSize(size) {
+    switch (size) {
+        case SizeClass.XxSmall:
+            return 'xx-small';
+        case SizeClass.Xsmall:
+            return 'x-small';
+        case SizeClass.Small:
+            return 'small';
+        case SizeClass.Medium:
+            return 'medium';
+        case SizeClass.Large:
+            return 'large';
+        case SizeClass.Capital:
+            return 'capital';
+        case SizeClass.Commander:
+            return 'commander';
+        case SizeClass.Titan:
+            return 'titan';
+        /* v8 ignore next -- the generated enum decoder rejects unknown values. */
+        default:
+            throw new RangeError(`Unsupported SizeClass value ${String(size)}.`);
+    }
+}
+/** Translates generated Character modifier values into SDK-owned data. */
+export function translateCharacterModifier(modifier) {
+    const maxResidentialPlotTier = optionalTier(modifier.maxResidentialPlotTier);
+    const maxProductivePlotTier = optionalTier(modifier.maxProductivePlotTier);
+    return {
+        cargoCategories: [...modifier.cargoCategories],
+        craftingJobConcurrencyBonus: modifier.craftingJobConcurrencyBonus,
+        craftingEfficiencyModifier: modifier.craftingEfficiencyModifier.toNumber(),
+        craftingEfficiencyModifierRaw: modifier.craftingEfficiencyModifier.raw,
+        craftingTimeModifier: modifier.craftingTimeModifier.toNumber(),
+        craftingTimeModifierRaw: modifier.craftingTimeModifier.raw,
+        enemyFactionZoneAccess: modifier.enemyFactionZoneAccess,
+        fleetConcurrency: modifier.fleetConcurrency,
+        fleetSize: modifier.fleetSize,
+        maxDailyStreakLength: modifier.maxDailyStreakLength,
+        ...(maxProductivePlotTier === undefined ? {} : { maxProductivePlotTier }),
+        maxProductivePlots: modifier.maxProductivePlots,
+        ...(maxResidentialPlotTier === undefined ? {} : { maxResidentialPlotTier }),
+        maxResidentialPlots: modifier.maxResidentialPlots,
+        maxShipSize: shipSize(modifier.maxShipSize),
+        rareMineralDiscovery: [...modifier.rareMineralDiscovery].map(([cargoId, multiplier]) => ({
+            cargoId,
+            multiplier: multiplier.toNumber(),
+            multiplierRaw: multiplier.raw,
+        })),
+        researchTags: [...modifier.researchTags],
+        respawnTimeModifier: modifier.respawnTimeModifier.toNumber(),
+        respawnTimeModifierRaw: modifier.respawnTimeModifier.raw,
+        scanCoolDownModifier: modifier.scanCoolDownModifier.toNumber(),
+        scanCoolDownModifierRaw: modifier.scanCoolDownModifier.raw,
+        scanPowerModifier: modifier.scanPowerModifier.toNumber(),
+        scanPowerModifierRaw: modifier.scanPowerModifier.raw,
+        securityZoneAccess: riskZone(modifier.securityZoneAccess),
+        subwarpSpeedModifier: modifier.subwarpSpeedModifier.toNumber(),
+        subwarpSpeedModifierRaw: modifier.subwarpSpeedModifier.raw,
+        warpCooldownModifier: modifier.warpCooldownModifier.toNumber(),
+        warpCooldownModifierRaw: modifier.warpCooldownModifier.raw,
+        warpLaneFeeModifier: modifier.warpLaneFeeModifier.toNumber(),
+        warpLaneFeeModifierRaw: modifier.warpLaneFeeModifier.raw,
+        warpSpeedModifier: modifier.warpSpeedModifier.toNumber(),
+        warpSpeedModifierRaw: modifier.warpSpeedModifier.raw,
+    };
+}
+//# sourceMappingURL=character-modifier.js.map

package/dist/internal/c4/character-modifier.js.map

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

package/dist/internal/c4/claim-stake.d.ts

@@ -0,0 +1,140 @@
+import type { Address, DiscoveryRequest, ProgramAccountFilter, SageContext, SnapshotEnvelope } from '../../client/contracts.js';
+import type { C4AccountAdapter } from './adapter.js';
+/** Stable ClaimStakeInstance filter offsets verified against the pinned codec. */
+export declare const CLAIM_STAKE_FILTER_OFFSETS: Readonly<{
+    body: 73;
+    discriminator: 0;
+    game: 41;
+    owner: 9;
+}>;
+/** Audited Claim Stake relationships; ClaimStakeInstance has no PDA. */
+export declare const CLAIM_STAKE_RELATIONSHIPS: readonly [{
+    readonly from: "character";
+    readonly kind: "discovered";
+    readonly mechanism: "targeted owner, Game, and discriminator filters";
+    readonly to: "claimStakeInstance[]";
+}, {
+    readonly from: "celestialBody";
+    readonly kind: "discovered";
+    readonly mechanism: "targeted celestialBodyId, Game, and discriminator filters";
+    readonly to: "claimStakeInstance[]";
+}, {
+    readonly from: "claimStakeInstance";
+    readonly kind: "stored";
+    readonly mechanism: "owner and celestialBodyId account fields";
+    readonly to: "character | celestialBody";
+}, {
+    readonly from: "claimStakeInstance";
+    readonly kind: "nested";
+    readonly mechanism: "ProductionCore CargoPod value";
+    readonly to: "cargoPod";
+}, {
+    readonly from: "claimStakeInstance";
+    readonly kind: "instruction-only";
+    readonly mechanism: "placement and harvesting co-accounts are not durable relations";
+    readonly to: "starbasePlayer | currencyCache";
+}];
+/** One translated building quantity on a Claim Stake.
+ * @example
+ * ```ts
+ * declare const building: ClaimStakeBuildingData;
+ * console.log(building.buildingId, building.quantity);
+ * ```
+ */
+export interface ClaimStakeBuildingData {
+    readonly buildingId: number;
+    readonly quantity: number;
+}
+/** One unresolved resource quantity in the nested production CargoPod.
+ * @example
+ * ```ts
+ * declare const amount: ClaimStakeCargoAmountData;
+ * console.log(amount.cargoId, amount.amount);
+ * ```
+ */
+export interface ClaimStakeCargoAmountData {
+    readonly cargoId: number;
+    readonly amount: bigint;
+}
+/** The translated nested production CargoPod.
+ * @example
+ * ```ts
+ * declare const pod: ClaimStakeCargoPodData;
+ * console.log(pod.storageCost, pod.amounts);
+ * ```
+ */
+export interface ClaimStakeCargoPodData {
+    readonly seqId: number;
+    readonly storageCost: bigint;
+    readonly amounts: readonly ClaimStakeCargoAmountData[];
+}
+/** One unresolved net resource production rate.
+ * @example
+ * ```ts
+ * declare const resource: ClaimStakeResourceRateData;
+ * console.log(resource.ratePerSecond);
+ * ```
+ */
+export interface ClaimStakeResourceRateData {
+    readonly cargoId: number;
+    readonly ratePerSecond: number;
+    readonly ratePerSecondRaw: bigint;
+}
+/** Stable translated Claim Stake lifecycle state.
+ * @example
+ * ```ts
+ * declare const state: ClaimStakeStateData;
+ * console.log(state.kind);
+ * ```
+ */
+export type ClaimStakeStateData = {
+    readonly kind: 'active';
+} | {
+    readonly kind: 'design';
+    readonly sequenceId: number;
+    readonly buildings: readonly ClaimStakeBuildingData[];
+} | {
+    readonly kind: 'deactivated';
+    readonly deactivatedAtUnixSeconds: bigint;
+};
+/** Fully translated ClaimStakeInstance account data before registry joins.
+ * @example
+ * ```ts
+ * declare const stake: ClaimStakeAccountData;
+ * console.log(stake.ownerCharacter, stake.body);
+ * ```
+ */
+export interface ClaimStakeAccountData {
+    readonly version: number;
+    readonly ownerCharacter: Address;
+    readonly game: Address;
+    readonly body: Address;
+    readonly claimStakeDefinitionId: number;
+    readonly claimStakeDefinitionSeqId: number;
+    readonly buildingDefinitionSeqId: number;
+    readonly systemSeqId: bigint;
+    readonly lastRentAtUnixSeconds: bigint;
+    readonly constructionRemainingSeconds: bigint;
+    readonly constructionProgressAtUnixSeconds: bigint;
+    readonly rentBalanceRaw: bigint;
+    readonly neededCrew: number;
+    readonly buildings: readonly ClaimStakeBuildingData[];
+    readonly state: ClaimStakeStateData;
+    readonly production: {
+        readonly lastTickAtUnixSeconds: bigint;
+        readonly resourceCapacityRaw: bigint;
+        readonly netResources: readonly ClaimStakeResourceRateData[];
+        readonly cargoPod: ClaimStakeCargoPodData;
+    };
+}
+/** Stable ClaimStakeInstance account definition for the pinned C4 bindings. */
+export declare const claimStakeAccountDefinition: C4AccountAdapter<ClaimStakeAccountData>;
+/** Builds stable Claim Stake filters for one owning Character. */
+export declare function buildClaimStakeCharacterDiscoveryFilters(game: Address, character: Address): readonly ProgramAccountFilter[];
+/** Builds stable Claim Stake filters for one Celestial Body. */
+export declare function buildClaimStakeBodyDiscoveryFilters(game: Address, body: Address): readonly ProgramAccountFilter[];
+/** Discovers Claim Stakes owned by one Character. */
+export declare function discoverClaimStakeAccountsByCharacter(context: SageContext, character: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<ClaimStakeAccountData>[]>;
+/** Discovers Claim Stakes placed on one Celestial Body. */
+export declare function discoverClaimStakeAccountsByBody(context: SageContext, body: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<ClaimStakeAccountData>[]>;
+//# sourceMappingURL=claim-stake.d.ts.map

package/dist/internal/c4/claim-stake.d.ts.map

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

package/dist/internal/c4/claim-stake.js

@@ -0,0 +1,205 @@
+import { CLAIM_STAKE_INSTANCE_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, getClaimStakeInstanceDecoder, } from '@staratlas/dev-sage';
+import { getAddressEncoder } from '@solana/kit';
+import { AccountDecodeError, InvalidAccountOwnerError, InvalidDiscriminatorError, MissingGameContextError, } from '../../client/errors.js';
+const CLAIM_STAKE_MINIMUM_DATA_LENGTH = 196;
+const CLAIM_STAKE_ACCOUNT_DISCRIMINATOR = Object.freeze(Array.from(CLAIM_STAKE_INSTANCE_DISCRIMINATOR));
+/** Stable ClaimStakeInstance filter offsets verified against the pinned codec. */
+export const CLAIM_STAKE_FILTER_OFFSETS = Object.freeze({
+    body: 73,
+    discriminator: 0,
+    game: 41,
+    owner: 9,
+});
+/** Audited Claim Stake relationships; ClaimStakeInstance has no PDA. */
+export const CLAIM_STAKE_RELATIONSHIPS = Object.freeze([
+    {
+        from: 'character',
+        kind: 'discovered',
+        mechanism: 'targeted owner, Game, and discriminator filters',
+        to: 'claimStakeInstance[]',
+    },
+    {
+        from: 'celestialBody',
+        kind: 'discovered',
+        mechanism: 'targeted celestialBodyId, Game, and discriminator filters',
+        to: 'claimStakeInstance[]',
+    },
+    {
+        from: 'claimStakeInstance',
+        kind: 'stored',
+        mechanism: 'owner and celestialBodyId account fields',
+        to: 'character | celestialBody',
+    },
+    {
+        from: 'claimStakeInstance',
+        kind: 'nested',
+        mechanism: 'ProductionCore CargoPod value',
+        to: 'cargoPod',
+    },
+    {
+        from: 'claimStakeInstance',
+        kind: 'instruction-only',
+        mechanism: 'placement and harvesting co-accounts are not durable relations',
+        to: 'starbasePlayer | currencyCache',
+    },
+]);
+function hasDiscriminator(data) {
+    return CLAIM_STAKE_ACCOUNT_DISCRIMINATOR.every((byte, index) => data[index] === byte);
+}
+function validateClaimStakeAccount(account) {
+    if (account.owner !== SAGE_PROGRAM_ADDRESS) {
+        throw new InvalidAccountOwnerError('claimStakeInstance', account.address, SAGE_PROGRAM_ADDRESS, account.owner);
+    }
+    if (account.data.length < CLAIM_STAKE_ACCOUNT_DISCRIMINATOR.length ||
+        !hasDiscriminator(account.data)) {
+        throw new InvalidDiscriminatorError('claimStakeInstance', account.address);
+    }
+    if (account.data.length < CLAIM_STAKE_MINIMUM_DATA_LENGTH) {
+        throw new AccountDecodeError('claimStakeInstance', account.address, new RangeError(`Expected at least ${CLAIM_STAKE_MINIMUM_DATA_LENGTH} ClaimStakeInstance account bytes, received ${account.data.length}.`));
+    }
+}
+function decodeExactly(account) {
+    try {
+        const [decoded, offset] = getClaimStakeInstanceDecoder().read(account.data, 0);
+        if (offset !== account.data.length) {
+            throw new RangeError(`Decoded ${offset} of ${account.data.length} ClaimStakeInstance account bytes; trailing bytes are not accepted.`);
+        }
+        return decoded;
+    }
+    catch (cause) {
+        throw new AccountDecodeError('claimStakeInstance', account.address, cause);
+    }
+}
+function buildings(values) {
+    return [...values].map(([buildingId, quantity]) => ({
+        buildingId,
+        quantity,
+    }));
+}
+function cargoPod(value) {
+    return {
+        amounts: [...value.amounts].map(([cargoId, amount]) => ({
+            amount,
+            cargoId,
+        })),
+        seqId: value.seqId,
+        storageCost: value.storageCost,
+    };
+}
+function state(value) {
+    switch (value.__kind) {
+        case 'Active':
+            return { kind: 'active' };
+        case 'Design':
+            return {
+                buildings: buildings(value.fields[0].buildings),
+                kind: 'design',
+                sequenceId: value.fields[0].sequenceId,
+            };
+        case 'Deactivated':
+            return {
+                deactivatedAtUnixSeconds: value.fields[0].deactivationTime,
+                kind: 'deactivated',
+            };
+        /* v8 ignore next -- assigning a new generated union variant fails compilation here. */
+        default: {
+            const exhaustive = value;
+            throw new RangeError(`Unsupported generated StructureInstanceState variant ${String(exhaustive)}.`);
+        }
+    }
+}
+function translateClaimStake(value) {
+    return {
+        body: value.celestialBodyId,
+        buildingDefinitionSeqId: value.buildingDefinitionSeqId,
+        buildings: buildings(value.buildings),
+        claimStakeDefinitionId: value.claimStakeDefinitionId,
+        claimStakeDefinitionSeqId: value.claimStakeDefinitionSeqId,
+        constructionProgressAtUnixSeconds: value.constructionProgressTimestamp,
+        constructionRemainingSeconds: value.constructionRemaining,
+        game: value.gameId,
+        lastRentAtUnixSeconds: value.lastRentClockTimestamp,
+        neededCrew: value.neededCrew,
+        ownerCharacter: value.owner,
+        production: {
+            cargoPod: cargoPod(value.productionCore.cargoPod),
+            lastTickAtUnixSeconds: value.productionCore.lastTickTimestamp,
+            netResources: [...value.productionCore.netResourceProduction].map(([cargoId, rate]) => ({
+                cargoId,
+                ratePerSecond: rate.toNumber(),
+                ratePerSecondRaw: rate.raw,
+            })),
+            resourceCapacityRaw: value.productionCore.resourceStorage,
+        },
+        rentBalanceRaw: value.rentBalance,
+        state: state(value.state),
+        systemSeqId: value.systemSeqId,
+        version: value.version,
+    };
+}
+/** Stable ClaimStakeInstance account definition for the pinned C4 bindings. */
+export const claimStakeAccountDefinition = Object.freeze({
+    decode(account) {
+        validateClaimStakeAccount(account);
+        return translateClaimStake(decodeExactly(account));
+    },
+    discriminator: CLAIM_STAKE_ACCOUNT_DISCRIMINATOR,
+    minimumDataLength: CLAIM_STAKE_MINIMUM_DATA_LENGTH,
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    type: 'claimStakeInstance',
+    validate: validateClaimStakeAccount,
+});
+function discoveryFilters(game, offset, address) {
+    return Object.freeze([
+        {
+            bytes: new Uint8Array(CLAIM_STAKE_INSTANCE_DISCRIMINATOR),
+            offset: CLAIM_STAKE_FILTER_OFFSETS.discriminator,
+        },
+        {
+            bytes: new Uint8Array(getAddressEncoder().encode(game)),
+            offset: CLAIM_STAKE_FILTER_OFFSETS.game,
+        },
+        {
+            bytes: new Uint8Array(getAddressEncoder().encode(address)),
+            offset,
+        },
+    ]);
+}
+/** Builds stable Claim Stake filters for one owning Character. */
+export function buildClaimStakeCharacterDiscoveryFilters(game, character) {
+    return discoveryFilters(game, CLAIM_STAKE_FILTER_OFFSETS.owner, character);
+}
+/** Builds stable Claim Stake filters for one Celestial Body. */
+export function buildClaimStakeBodyDiscoveryFilters(game, body) {
+    return discoveryFilters(game, CLAIM_STAKE_FILTER_OFFSETS.body, body);
+}
+async function discoverClaimStakeAccounts(context, relatedAddress, relation, options = {}) {
+    const game = context.game;
+    if (game === undefined)
+        throw new MissingGameContextError();
+    const stakes = await context.data.discover(claimStakeAccountDefinition, {
+        ...options,
+        filters: relation === 'character'
+            ? buildClaimStakeCharacterDiscoveryFilters(game, relatedAddress)
+            : buildClaimStakeBodyDiscoveryFilters(game, relatedAddress),
+        strategy: 'targeted-program-accounts',
+    });
+    for (const stake of stakes) {
+        const matchesRelation = relation === 'character'
+            ? stake.data.ownerCharacter === relatedAddress
+            : stake.data.body === relatedAddress;
+        if (stake.data.game !== game || !matchesRelation) {
+            throw new AccountDecodeError('claimStakeInstance', stake.address, new RangeError('The decoded ClaimStakeInstance fields contradicted its discovery filters.'), `A discovered Claim Stake candidate did not match the requested Game and ${relation} after decoding. Verify the provider, configured cluster, and pinned ClaimStakeInstance filter offsets before retrying.`);
+        }
+    }
+    return stakes;
+}
+/** Discovers Claim Stakes owned by one Character. */
+export function discoverClaimStakeAccountsByCharacter(context, character, options) {
+    return discoverClaimStakeAccounts(context, character, 'character', options);
+}
+/** Discovers Claim Stakes placed on one Celestial Body. */
+export function discoverClaimStakeAccountsByBody(context, body, options) {
+    return discoverClaimStakeAccounts(context, body, 'body', options);
+}
+//# sourceMappingURL=claim-stake.js.map

package/dist/internal/c4/claim-stake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-stake.js","sourceRoot":"","sources":["../../../src/internal/c4/claim-stake.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,oBAAoB,EACpB,4BAA4B,GAI7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAUhD,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAC5C,MAAM,iCAAiC,GAAG,MAAM,CAAC,MAAM,CACrD,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAC/C,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC;IACtD,IAAI,EAAE,EAAE;IACR,aAAa,EAAE,CAAC;IAChB,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,CAAC;CACT,CAAC,CAAC;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC;IACrD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,iDAAiD;QAC5D,EAAE,EAAE,sBAAsB;KAC3B;IACD;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,2DAA2D;QACtE,EAAE,EAAE,sBAAsB;KAC3B;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,0CAA0C;QACrD,EAAE,EAAE,2BAA2B;KAChC;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,+BAA+B;QAC1C,EAAE,EAAE,UAAU;KACf;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE,gEAAgE;QAC3E,EAAE,EAAE,gCAAgC;KACrC;CACO,CAAC,CAAC;AAsGZ,SAAS,gBAAgB,CAAC,IAAgB;IACxC,OAAO,iCAAiC,CAAC,KAAK,CAC5C,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CACtC,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,OAAmB;IACpD,IAAI,OAAO,CAAC,KAAK,KAAK,oBAAoB,EAAE,CAAC;QAC3C,MAAM,IAAI,wBAAwB,CAChC,oBAAoB,EACpB,OAAO,CAAC,OAAO,EACf,oBAAoB,EACpB,OAAO,CAAC,KAAK,CACd,CAAC;IACJ,CAAC;IACD,IACE,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,iCAAiC,CAAC,MAAM;QAC9D,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,EAC/B,CAAC;QACD,MAAM,IAAI,yBAAyB,CAAC,oBAAoB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,+BAA+B,EAAE,CAAC;QAC1D,MAAM,IAAI,kBAAkB,CAC1B,oBAAoB,EACpB,OAAO,CAAC,OAAO,EACf,IAAI,UAAU,CACZ,qBAAqB,+BAA+B,+CAA+C,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAC1H,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAmB;IACxC,IAAI,CAAC;QACH,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,4BAA4B,EAAE,CAAC,IAAI,CAC3D,OAAO,CAAC,IAAI,EACZ,CAAC,CACF,CAAC;QACF,IAAI,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,IAAI,UAAU,CAClB,WAAW,MAAM,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,qEAAqE,CACjH,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAAC,oBAAoB,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAChB,MAAmC;IAEnC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAClD,UAAU;QACV,QAAQ;KACT,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,QAAQ,CAAC,KAAe;IAC/B,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YACtD,MAAM;YACN,OAAO;SACR,CAAC,CAAC;QACH,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,KAA6B;IAC1C,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO;gBACL,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC/C,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU;aACvC,CAAC;QACJ,KAAK,aAAa;YAChB,OAAO;gBACL,wBAAwB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,gBAAgB;gBAC1D,IAAI,EAAE,aAAa;aACpB,CAAC;QACJ,uFAAuF;QACvF,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,KAAK,CAAC;YAChC,MAAM,IAAI,UAAU,CAClB,wDAAwD,MAAM,CAAC,UAAU,CAAC,GAAG,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAyB;IACpD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,eAAe;QAC3B,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;QACtD,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC;QACrC,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;QACpD,yBAAyB,EAAE,KAAK,CAAC,yBAAyB;QAC1D,iCAAiC,EAAE,KAAK,CAAC,6BAA6B;QACtE,4BAA4B,EAAE,KAAK,CAAC,qBAAqB;QACzD,IAAI,EAAE,KAAK,CAAC,MAAM;QAClB,qBAAqB,EAAE,KAAK,CAAC,sBAAsB;QACnD,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,cAAc,EAAE,KAAK,CAAC,KAAK;QAC3B,UAAU,EAAE;YACV,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC;YACjD,qBAAqB,EAAE,KAAK,CAAC,cAAc,CAAC,iBAAiB;YAC7D,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAC/D,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpB,OAAO;gBACP,aAAa,EAAE,IAAI,CAAC,QAAQ,EAAE;gBAC9B,gBAAgB,EAAE,IAAI,CAAC,GAAG;aAC3B,CAAC,CACH;YACD,mBAAmB,EAAE,KAAK,CAAC,cAAc,CAAC,eAAe;SAC1D;QACD,cAAc,EAAE,KAAK,CAAC,WAAW;QACjC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;QACzB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,2BAA2B,GACtC,MAAM,CAAC,MAAM,CAAC;IACZ,MAAM,CAAC,OAAmB;QACxB,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,mBAAmB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,aAAa,EAAE,iCAAiC;IAChD,iBAAiB,EAAE,+BAA+B;IAClD,cAAc,EAAE,oBAAoB;IACpC,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,yBAAyB;CACpC,CAAC,CAAC;AAEL,SAAS,gBAAgB,CACvB,IAAa,EACb,MAAc,EACd,OAAgB;IAEhB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB;YACE,KAAK,EAAE,IAAI,UAAU,CAAC,kCAAkC,CAAC;YACzD,MAAM,EAAE,0BAA0B,CAAC,aAAa;SACjD;QACD;YACE,KAAK,EAAE,IAAI,UAAU,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvD,MAAM,EAAE,0BAA0B,CAAC,IAAI;SACxC;QACD;YACE,KAAK,EAAE,IAAI,UAAU,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC1D,MAAM;SACP;KACF,CAAC,CAAC;AACL,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,wCAAwC,CACtD,IAAa,EACb,SAAkB;IAElB,OAAO,gBAAgB,CAAC,IAAI,EAAE,0BAA0B,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAC7E,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,mCAAmC,CACjD,IAAa,EACb,IAAa;IAEb,OAAO,gBAAgB,CAAC,IAAI,EAAE,0BAA0B,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,KAAK,UAAU,0BAA0B,CACvC,OAAoB,EACpB,cAAuB,EACvB,QAA8B,EAC9B,UAA0D,EAAE;IAE5D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,uBAAuB,EAAE,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,2BAA2B,EAAE;QACtE,GAAG,OAAO;QACV,OAAO,EACL,QAAQ,KAAK,WAAW;YACtB,CAAC,CAAC,wCAAwC,CAAC,IAAI,EAAE,cAAc,CAAC;YAChE,CAAC,CAAC,mCAAmC,CAAC,IAAI,EAAE,cAAc,CAAC;QAC/D,QAAQ,EAAE,2BAA2B;KACtC,CAAC,CAAC;IACH,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,eAAe,GACnB,QAAQ,KAAK,WAAW;YACtB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,cAAc;YAC9C,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC;QACzC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACjD,MAAM,IAAI,kBAAkB,CAC1B,oBAAoB,EACpB,KAAK,CAAC,OAAO,EACb,IAAI,UAAU,CACZ,2EAA2E,CAC5E,EACD,2EAA2E,QAAQ,yHAAyH,CAC7M,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,qCAAqC,CACnD,OAAoB,EACpB,SAAkB,EAClB,OAAwD;IAExD,OAAO,0BAA0B,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,gCAAgC,CAC9C,OAAoB,EACpB,IAAa,EACb,OAAwD;IAExD,OAAO,0BAA0B,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,98 @@
+import type { Address, DiscoveryRequest, ProgramAccountFilter, SageContext, SnapshotEnvelope } from '../../client/contracts.js';
+import type { C4AccountAdapter } from './adapter.js';
+export { LOOT_FILTER_OFFSETS } from './loot-layout.js';
+/** Audited read and deferred-action relationships for the combat capability. */
+export declare const COMBAT_RELATIONSHIPS: readonly [{
+    readonly from: "profile + faction";
+    readonly kind: "derived";
+    readonly mechanism: "OutlawFlag PDA seeds";
+    readonly to: "outlawFlag?";
+}, {
+    readonly from: "loot";
+    readonly kind: "stored";
+    readonly mechanism: "Game, Profile, coordinates, and destroyer account fields";
+    readonly to: "game | profile | fleet";
+}, {
+    readonly from: "combat";
+    readonly kind: "nested";
+    readonly mechanism: "Game config, Fleet combat state, and Loot items/reward legs";
+    readonly to: "configuration | fleetCombatStatus | lootInventory";
+}, {
+    readonly from: "combat";
+    readonly kind: "instruction-only";
+    readonly mechanism: "attack, repair, stimulant, reward resolution, and sweep co-accounts are not durable relations";
+    readonly to: "actions";
+}, {
+    readonly from: "game | profile";
+    readonly kind: "discovered";
+    readonly mechanism: "targeted Loot discriminator, Game, and Profile filters";
+    readonly to: "loot[]";
+}];
+export type CombatFaction = 'unaligned' | 'mud' | 'oni' | 'ustur';
+export interface LootCargoAmountData {
+    readonly cargoId: number;
+    readonly amount: bigint;
+}
+export interface LootInventoryData {
+    readonly sequenceId: number;
+    readonly storageCostRaw: bigint;
+    readonly amounts: readonly LootCargoAmountData[];
+}
+export interface LootItemData {
+    readonly destroyer: Address;
+    readonly exclusivityUnlockAtUnixSeconds: bigint;
+    readonly rewardReclaimAtUnixSeconds: bigint;
+    readonly inventory: LootInventoryData;
+}
+export interface LootRewardLegData {
+    readonly recipient: Address;
+    readonly medallionsRaw: bigint;
+    readonly salvageTargetValueRaw: bigint;
+}
+export type LootRewardData = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'committed' | 'resolved';
+    readonly configVersion: number;
+    readonly slot: bigint;
+    readonly committedAtUnixSeconds: bigint;
+    readonly legs: readonly LootRewardLegData[];
+} | {
+    readonly kind: 'unknown';
+    readonly rawStatus: number;
+    readonly configVersion: number;
+    readonly slot: bigint;
+    readonly committedAtUnixSeconds: bigint;
+    readonly legs: readonly LootRewardLegData[];
+};
+/** Fully translated Loot account data before cargo-definition resolution. */
+export interface LootAccountData {
+    readonly version: number;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly coordinates: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly reward: LootRewardData;
+    readonly items: readonly LootItemData[];
+}
+/** Fully translated OutlawFlag account data. */
+export interface OutlawFlagAccountData {
+    readonly version: number;
+    readonly profile: Address;
+    readonly faction: CombatFaction;
+    readonly isOutlaw: boolean;
+    readonly declaredAtUnixSeconds: bigint;
+    readonly pvpUntilUnixSeconds: bigint;
+    readonly bump: number;
+}
+export declare const lootAccountDefinition: C4AccountAdapter<LootAccountData>;
+export declare const outlawFlagAccountDefinition: C4AccountAdapter<OutlawFlagAccountData>;
+/** Derives the optional OutlawFlag address for one Profile/faction pair. */
+export declare function deriveOutlawFlagAddress(profile: Address, againstFaction: CombatFaction): Promise<Address>;
+/** Builds stable targeted filters for Loot by Game and creator Profile. */
+export declare function buildLootDiscoveryFilters(game: Address, profile: Address): readonly ProgramAccountFilter[];
+/** Discovers Loot by stable Game/Profile fields and revalidates every decoded hint. */
+export declare function discoverLootAccounts(context: SageContext, profile: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<LootAccountData>[]>;
+//# sourceMappingURL=combat.d.ts.map

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

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