@aephia/atlas-kit 0.0.0

package/dist/internal/c4/market.js

@@ -0,0 +1,247 @@
+import { FACTION_MARKET_DISCRIMINATOR, LOCAL_MARKET_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, ScanPatternStatus, getFactionMarketDecoder, getLocalMarketDecoder, } from '@staratlas/dev-sage';
+import { getAddressEncoder, getBytesEncoder, getProgramDerivedAddress, getU16Encoder, getU64Encoder, } from '@solana/kit';
+import { AccountDecodeError, InvalidAccountOwnerError, InvalidDerivationInputError, InvalidDiscriminatorError, InvalidEntityIdError, } from '../../client/errors.js';
+const FLOYDS_PER_ATLAS = 100_000_000;
+const LOCAL_MARKET_MINIMUM_DATA_LENGTH = 132;
+const FACTION_MARKET_MINIMUM_DATA_LENGTH = 132;
+const MAX_U64 = 18446744073709551615n;
+const LOCAL_DISCRIMINATOR = Object.freeze(Array.from(LOCAL_MARKET_DISCRIMINATOR));
+const FACTION_DISCRIMINATOR = Object.freeze(Array.from(FACTION_MARKET_DISCRIMINATOR));
+export const LOCAL_MARKET_FILTER_OFFSETS = Object.freeze({
+    discriminator: 0,
+    system: 9,
+});
+export const MARKET_RELATIONSHIPS = Object.freeze([
+    {
+        from: 'starSystem + cargoId + starbaseSeqId',
+        kind: 'derived',
+        mechanism: 'LocalMarket PDA seeds: literal, System, cargo id, sequence id',
+        to: 'localMarket',
+    },
+    {
+        from: 'game + starSystem + starbaseSeqId',
+        kind: 'derived',
+        mechanism: 'FactionMarket PDA seeds: literal, Game, System, sequence id',
+        to: 'factionMarket',
+    },
+    {
+        from: 'starSystem',
+        kind: 'discovered',
+        mechanism: 'targeted LocalMarket discriminator and System filters',
+        to: 'localMarket[]',
+    },
+    {
+        from: 'localMarket',
+        kind: 'stored',
+        mechanism: 'System, initializer Profile, and maker Character fields',
+        to: 'starSystem | profile | character[]',
+    },
+    {
+        from: 'factionMarket',
+        kind: 'stored',
+        mechanism: 'Game, System, and cargo offer fields',
+        to: 'game | starSystem | cargoDefinition[]',
+    },
+    {
+        from: 'localMarket',
+        kind: 'nested',
+        mechanism: 'bid/ask order books and maker state maps',
+        to: 'orders | makerState',
+    },
+    {
+        from: 'market',
+        kind: 'instruction-only',
+        mechanism: 'trade instructions reference placement and settlement accounts',
+        to: 'order placement | cancellation | settlement',
+    },
+]);
+function validateCargoId(cargoId) {
+    if (!Number.isInteger(cargoId) || cargoId < 0 || cargoId > 65_535) {
+        throw new InvalidEntityIdError('market', cargoId);
+    }
+}
+function validateStarbaseSequenceId(starbaseSequenceId) {
+    if (typeof starbaseSequenceId !== 'bigint' ||
+        starbaseSequenceId < 0n ||
+        starbaseSequenceId > MAX_U64) {
+        throw new InvalidDerivationInputError('Starbase sequence id', starbaseSequenceId, `Use a bigint from 0 through ${String(MAX_U64)} before deriving or reading the Market account.`);
+    }
+}
+function makers(values) {
+    return [...values].map(([character, maker]) => ({
+        cargoRaw: maker.totals.cargo,
+        character,
+        escrowedOrReleasedAtlas: Number(maker.totals.atlas) / FLOYDS_PER_ATLAS,
+        escrowedOrReleasedAtlasRaw: maker.totals.atlas,
+        openOrderCount: maker.orderCount,
+        rentBytesOwnedRaw: maker.rentBytesOwned,
+    }));
+}
+function side(value, kind) {
+    return {
+        makers: makers(value.makers),
+        nextOrderIdRaw: value.idCounter,
+        orders: value.orders.map((order) => ({
+            maker: order.maker,
+            orderId: order.orderId,
+            priceAtlas: Number(order.price) / FLOYDS_PER_ATLAS,
+            priceRaw: order.price,
+            quantityRaw: order.quantity,
+            side: kind,
+        })),
+    };
+}
+function translateLocal(value) {
+    return {
+        asks: side(value.asks, 'ask'),
+        bids: side(value.bids, 'bid'),
+        bump: value.bump,
+        cargo: { amountRaw: value.cargo.amount, cargoId: value.cargo.cargoId },
+        initializerProfile: value.marketInitializer,
+        starbaseSequenceId: value.starbaseSeqId,
+        system: value.system,
+        vaultAtlas: Number(value.vault) / FLOYDS_PER_ATLAS,
+        vaultRaw: value.vault,
+        version: value.version,
+    };
+}
+function status(value) {
+    switch (value) {
+        case ScanPatternStatus.Draft:
+            return 'draft';
+        case ScanPatternStatus.Active:
+            return 'active';
+        /* v8 ignore next -- the generated enum decoder rejects unknown values. */
+        default:
+            throw new RangeError(`Unsupported Faction Market status ${String(value)}.`);
+    }
+}
+function translateFaction(value) {
+    return {
+        atlasBurnBasisPoints: value.atlasBurnBps,
+        authoredTargetQuantityRaw: value.authoredTargetQty,
+        bump: value.bump,
+        factionId: value.factionId,
+        faucetEnabled: value.faucetEnabled !== 0,
+        game: value.gameId,
+        lastRestockedAtUnixSeconds: value.lastRestockAt,
+        minimumStandingToBuy: value.minStandingBuy,
+        minimumStandingToSell: value.minStandingSell,
+        offers: value.offers.map((offer) => ({
+            canBuyFromFaction: (offer.sideFlags & 1) !== 0,
+            canSellToFaction: (offer.sideFlags & 2) !== 0,
+            cargoId: offer.cargoId,
+            priceAtlas: Number(offer.price) / FLOYDS_PER_ATLAS,
+            priceRaw: offer.price,
+            remainingQuantityRaw: offer.remainingQty,
+        })),
+        priceTierBasisPoints: [...value.priceTierBps],
+        restockPeriodSeconds: value.restockPeriodSecs,
+        standingBasisPoints: value.standingBps,
+        starbaseSequenceId: value.starbaseSeqId,
+        status: status(value.status),
+        system: value.system,
+        version: value.version,
+    };
+}
+function validate(account, discriminator, label, minimumDataLength) {
+    if (account.owner !== SAGE_PROGRAM_ADDRESS) {
+        throw new InvalidAccountOwnerError('market', account.address, SAGE_PROGRAM_ADDRESS, account.owner);
+    }
+    if (!discriminator.every((byte, index) => account.data[index] === byte)) {
+        throw new InvalidDiscriminatorError('market', account.address);
+    }
+    if (account.data.length < minimumDataLength) {
+        throw new AccountDecodeError('market', account.address, new RangeError(`Expected at least ${minimumDataLength} ${label} bytes, received ${account.data.length}.`));
+    }
+}
+function decodeExactly(account, label, read) {
+    try {
+        const [value, offset] = read(account.data, 0);
+        if (offset !== account.data.length) {
+            throw new RangeError(`Trailing bytes are not accepted for ${label}.`);
+        }
+        return value;
+    }
+    catch (cause) {
+        throw new AccountDecodeError('market', account.address, cause);
+    }
+}
+export const localMarketAccountDefinition = Object.freeze({
+    decode(account) {
+        validate(account, LOCAL_DISCRIMINATOR, 'Local Market account', LOCAL_MARKET_MINIMUM_DATA_LENGTH);
+        return translateLocal(decodeExactly(account, 'Local Market', (bytes, offset) => getLocalMarketDecoder().read(bytes, offset)));
+    },
+    discriminator: LOCAL_DISCRIMINATOR,
+    minimumDataLength: LOCAL_MARKET_MINIMUM_DATA_LENGTH,
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    type: 'market',
+    validate(account) {
+        validate(account, LOCAL_DISCRIMINATOR, 'Local Market account', LOCAL_MARKET_MINIMUM_DATA_LENGTH);
+    },
+});
+export const factionMarketAccountDefinition = Object.freeze({
+    decode(account) {
+        validate(account, FACTION_DISCRIMINATOR, 'Faction Market account', FACTION_MARKET_MINIMUM_DATA_LENGTH);
+        return translateFaction(decodeExactly(account, 'Faction Market', (bytes, offset) => getFactionMarketDecoder().read(bytes, offset)));
+    },
+    discriminator: FACTION_DISCRIMINATOR,
+    minimumDataLength: FACTION_MARKET_MINIMUM_DATA_LENGTH,
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    type: 'market',
+    validate(account) {
+        validate(account, FACTION_DISCRIMINATOR, 'Faction Market account', FACTION_MARKET_MINIMUM_DATA_LENGTH);
+    },
+});
+export async function deriveLocalMarketAddress(system, cargoId, starbaseSequenceId) {
+    validateCargoId(cargoId);
+    validateStarbaseSequenceId(starbaseSequenceId);
+    const [address] = await getProgramDerivedAddress({
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        seeds: [
+            getBytesEncoder().encode(new Uint8Array([76, 111, 99, 97, 108, 77, 97, 114, 107, 101, 116])),
+            getAddressEncoder().encode(system),
+            getU16Encoder().encode(cargoId),
+            getU64Encoder().encode(starbaseSequenceId),
+        ],
+    });
+    return address;
+}
+export async function deriveFactionMarketAddress(game, system, starbaseSequenceId) {
+    validateStarbaseSequenceId(starbaseSequenceId);
+    const [address] = await getProgramDerivedAddress({
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        seeds: [
+            getBytesEncoder().encode(new Uint8Array([
+                70, 97, 99, 116, 105, 111, 110, 77, 97, 114, 107, 101, 116,
+            ])),
+            getAddressEncoder().encode(game),
+            getAddressEncoder().encode(system),
+            getU64Encoder().encode(starbaseSequenceId),
+        ],
+    });
+    return address;
+}
+export function buildLocalMarketSystemDiscoveryFilters(system) {
+    return Object.freeze([
+        { bytes: new Uint8Array(LOCAL_MARKET_DISCRIMINATOR), offset: 0 },
+        {
+            bytes: new Uint8Array(getAddressEncoder().encode(system)),
+            offset: LOCAL_MARKET_FILTER_OFFSETS.system,
+        },
+    ]);
+}
+export async function discoverLocalMarketsBySystem(context, system, options = {}) {
+    const values = await context.data.discover(localMarketAccountDefinition, {
+        ...options,
+        filters: buildLocalMarketSystemDiscoveryFilters(system),
+        strategy: 'targeted-program-accounts',
+    });
+    for (const value of values) {
+        if (value.data.system !== system) {
+            throw new AccountDecodeError('market', value.address, new RangeError('The decoded Local Market contradicted its System filter.'), `Local Market ${value.address} does not belong to requested Star System ${system}. Verify the provider and LocalMarket system offset before retrying.`);
+        }
+    }
+    return values;
+}
+//# sourceMappingURL=market.js.map

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

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

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

@@ -0,0 +1,6 @@
+import type { Address } from '../../client/contracts.js';
+export declare function validateUnsignedU16EntityId(entityType: 'starSystem' | 'recipe' | 'faction', id: number): void;
+export declare function validateUnsignedU64(field: string, value: bigint, remedy: string): void;
+export declare function deriveFactionAccountAddress(game: Address, factionId: number): Promise<Address>;
+export declare function deriveAtlasRewardConfigAddress(game: Address, configVersion: number): Promise<Address>;
+//# sourceMappingURL=pda.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pda.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/pda.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAwBzD,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,YAAY,GAAG,QAAQ,GAAG,SAAS,EAC/C,EAAE,EAAE,MAAM,GACT,IAAI,CAKN;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAIN;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/internal/c4/pda.js

@@ -0,0 +1,45 @@
+import { SAGE_PROGRAM_ADDRESS } from '@staratlas/dev-sage';
+import { getAddressEncoder, getBytesEncoder, getProgramDerivedAddress, getU16Encoder, getU32Encoder, } from '@solana/kit';
+import { InvalidDerivationInputError, InvalidEntityIdError, } from '../../client/errors.js';
+const U64_MAX = 0xffffffffffffffffn;
+const textEncoder = new TextEncoder();
+function literalSeed(value) {
+    return getBytesEncoder().encode(textEncoder.encode(value));
+}
+async function deriveAddress(literal, remainingSeeds) {
+    const [address] = await getProgramDerivedAddress({
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        seeds: [literalSeed(literal), ...remainingSeeds],
+    });
+    return address;
+}
+export function validateUnsignedU16EntityId(entityType, id) {
+    const minimumId = entityType === 'faction' ? 1 : 0;
+    if (!Number.isInteger(id) || id < minimumId || id > 65_535) {
+        throw new InvalidEntityIdError(entityType, id);
+    }
+}
+export function validateUnsignedU64(field, value, remedy) {
+    if (typeof value !== 'bigint' || value < 0n || value > U64_MAX) {
+        throw new InvalidDerivationInputError(field, value, remedy);
+    }
+}
+export async function deriveFactionAccountAddress(game, factionId) {
+    validateUnsignedU16EntityId('faction', factionId);
+    return deriveAddress('FactionAccount', [
+        getAddressEncoder().encode(game),
+        getU16Encoder().encode(factionId),
+    ]);
+}
+export async function deriveAtlasRewardConfigAddress(game, configVersion) {
+    if (!Number.isInteger(configVersion) ||
+        configVersion < 0 ||
+        configVersion > 0xffff_ffff) {
+        throw new RangeError('AtlasRewardConfig version must be an unsigned 32-bit integer.');
+    }
+    return deriveAddress('AtlasRewardConfig', [
+        getAddressEncoder().encode(game),
+        getU32Encoder().encode(configVersion),
+    ]);
+}
+//# sourceMappingURL=pda.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pda.js","sourceRoot":"","sources":["../../../src/internal/c4/pda.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,aAAa,GAEd,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,OAAO,GAAG,mBAAsB,CAAC;AACvC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAEtC,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,OAAe,EACf,cAA6C;IAE7C,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,wBAAwB,CAAC;QAC/C,cAAc,EAAE,oBAAoB;QACpC,KAAK,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG,cAAc,CAAC;KACjD,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,UAA+C,EAC/C,EAAU;IAEV,MAAM,SAAS,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,SAAS,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;QAC3D,MAAM,IAAI,oBAAoB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,KAAa,EACb,MAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,EAAE,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QAC/D,MAAM,IAAI,2BAA2B,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,IAAa,EACb,SAAiB;IAEjB,2BAA2B,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAClD,OAAO,aAAa,CAAC,gBAAgB,EAAE;QACrC,iBAAiB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QAChC,aAAa,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,IAAa,EACb,aAAqB;IAErB,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC;QAChC,aAAa,GAAG,CAAC;QACjB,aAAa,GAAG,WAAW,EAC3B,CAAC;QACD,MAAM,IAAI,UAAU,CAClB,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC,mBAAmB,EAAE;QACxC,iBAAiB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QAChC,aAAa,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC;KACtC,CAAC,CAAC;AACL,CAAC"}

package/dist/internal/c4/profile-faction.d.ts

@@ -0,0 +1,14 @@
+import type { Address } from '../../client/contracts.js';
+import type { C4AccountAdapter } from './adapter.js';
+export type ProfileFactionAlignment = 'unaligned' | 'mud' | 'oni' | 'ustur';
+export interface ProfileFactionAccountData {
+    readonly version: number;
+    readonly profile: Address;
+    readonly faction: ProfileFactionAlignment;
+    readonly factionId: number;
+    readonly bump: number;
+}
+export declare const profileFactionAccountDefinition: C4AccountAdapter<ProfileFactionAccountData>;
+/** Derives ProfileFaction from its pinned Profile-only seed recipe. */
+export declare function deriveProfileFactionAddress(profile: Address): Promise<Address>;
+//# sourceMappingURL=profile-faction.d.ts.map

package/dist/internal/c4/profile-faction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-faction.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/profile-faction.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,2BAA2B,CAAC;AAMrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAOrD,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAE5E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AA4CD,eAAO,MAAM,+BAA+B,EAAE,gBAAgB,CAAC,yBAAyB,CAyBpF,CAAC;AAEL,uEAAuE;AACvE,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/internal/c4/profile-faction.js

@@ -0,0 +1,69 @@
+import { PROFILE_FACTION_ACCOUNT_DISCRIMINATOR, PROFILE_FACTION_PROGRAM_ADDRESS, Faction, getProfileFactionAccountDecoder, } from '@staratlas/dev-profile-faction';
+import { getAddressEncoder, getBytesEncoder, getProgramDerivedAddress, } from '@solana/kit';
+import { AccountDecodeError, InvalidAccountOwnerError, InvalidDiscriminatorError, } from '../../client/errors.js';
+const PROFILE_FACTION_ACCOUNT_LENGTH = 43;
+const DISCRIMINATOR = Object.freeze(Array.from(PROFILE_FACTION_ACCOUNT_DISCRIMINATOR));
+function validate(account) {
+    if (account.owner !== PROFILE_FACTION_PROGRAM_ADDRESS) {
+        throw new InvalidAccountOwnerError('profileFaction', account.address, PROFILE_FACTION_PROGRAM_ADDRESS, account.owner);
+    }
+    if (account.data.length < DISCRIMINATOR.length ||
+        DISCRIMINATOR.some((byte, index) => account.data[index] !== byte)) {
+        throw new InvalidDiscriminatorError('profileFaction', account.address);
+    }
+    if (account.data.length !== PROFILE_FACTION_ACCOUNT_LENGTH) {
+        throw new AccountDecodeError('profileFaction', account.address, new RangeError(`Expected exactly ${String(PROFILE_FACTION_ACCOUNT_LENGTH)} ProfileFaction account bytes, received ${String(account.data.length)}.`));
+    }
+}
+function alignment(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 ProfileFaction ${String(value)}.`);
+    }
+}
+export const profileFactionAccountDefinition = Object.freeze({
+    decode(account) {
+        validate(account);
+        try {
+            const [decoded] = getProfileFactionAccountDecoder().read(account.data, 0);
+            return Object.freeze({
+                bump: decoded.bump,
+                faction: alignment(decoded.faction),
+                factionId: decoded.faction,
+                profile: decoded.profile,
+                version: decoded.version,
+            });
+        }
+        catch (cause) {
+            throw new AccountDecodeError('profileFaction', account.address, cause);
+        }
+    },
+    discriminator: DISCRIMINATOR,
+    minimumDataLength: PROFILE_FACTION_ACCOUNT_LENGTH,
+    programAddress: PROFILE_FACTION_PROGRAM_ADDRESS,
+    type: 'profileFaction',
+    validate,
+});
+/** Derives ProfileFaction from its pinned Profile-only seed recipe. */
+export async function deriveProfileFactionAddress(profile) {
+    const [address] = await getProgramDerivedAddress({
+        programAddress: PROFILE_FACTION_PROGRAM_ADDRESS,
+        seeds: [
+            getBytesEncoder().encode(new Uint8Array([
+                112, 108, 97, 121, 101, 114, 95, 102, 97, 99, 116, 105, 111, 110,
+            ])),
+            getAddressEncoder().encode(profile),
+        ],
+    });
+    return address;
+}
+//# sourceMappingURL=profile-faction.js.map

package/dist/internal/c4/profile-faction.js.map

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

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

@@ -0,0 +1,135 @@
+import type { Address, DiscoveryRequest, ProgramAccountFilter, SageContext, SnapshotEnvelope } from '../../client/contracts.js';
+import type { C4AccountAdapter } from './adapter.js';
+import { deriveAtlasRewardConfigAddress } from './pda.js';
+export { LOOT_FILTER_OFFSETS as REWARD_LOOT_FILTER_OFFSETS } from './loot-layout.js';
+/** Audited read and deferred-action relationships for ATLAS rewards. */
+export declare const REWARD_RELATIONSHIPS: readonly [{
+    readonly from: "game | game + config version";
+    readonly kind: "derived";
+    readonly mechanism: "AtlasRewardRegistry, AtlasRewardConfig, and AtlasRewardTreasury PDA seeds";
+    readonly to: "reward registry | config | treasury";
+}, {
+    readonly from: "registry | loot";
+    readonly kind: "stored";
+    readonly mechanism: "registry config/epoch selectors and Loot reward commitment fields";
+    readonly to: "config | epoch | reward commitment";
+}, {
+    readonly from: "config | treasury | loot";
+    readonly kind: "nested";
+    readonly mechanism: "reward rates, curves, cargo reserves, and commitment legs";
+    readonly to: "reward values";
+}, {
+    readonly from: "rewards";
+    readonly kind: "instruction-only";
+    readonly mechanism: "funding, advancement, settlement, and sweeping co-accounts are not durable relations";
+    readonly to: "actions";
+}, {
+    readonly from: "profile";
+    readonly kind: "discovered";
+    readonly mechanism: "validated Loot discovery exposes only reward-bearing Loot references";
+    readonly to: "loot[]";
+}];
+export interface AtlasRewardRegistryAccountData {
+    readonly version: number;
+    readonly bump: number;
+    readonly game: Address;
+    readonly currentEpoch: bigint;
+    readonly currentEpochStartedAtUnixSeconds: bigint;
+    readonly currentEpochEndsAtUnixSeconds: bigint;
+    readonly initialEpochOffsetSeconds: bigint;
+    readonly activeConfigVersion: number;
+    readonly pendingConfig: {
+        readonly kind: 'none';
+    } | {
+        readonly kind: 'pending';
+        readonly configVersion: number;
+        readonly effectiveEpoch: bigint;
+    };
+    readonly latestConfigVersion: number;
+}
+export interface AtlasRewardConfigAccountData {
+    readonly version: number;
+    readonly bump: number;
+    readonly enabled: boolean;
+    readonly game: Address;
+    readonly configVersion: number;
+    readonly effectiveEpoch: bigint;
+    readonly createdAtUnixSeconds: bigint;
+    readonly sourceFlags: number;
+    readonly epochLengthSeconds: number;
+    readonly claimSettlementWindowSeconds: number;
+    readonly atlasBankInactivityExpirySeconds: bigint;
+    readonly rewardLootReclaimSeconds: bigint;
+    readonly factionPoolLeverRaw: bigint;
+    readonly kingSystemCurveRaw: readonly (readonly bigint[])[];
+    readonly pveLpRateBps: number;
+    readonly pvpMedallionRateBps: number;
+    readonly salvageEvRateBps: number;
+    readonly repairKitLpRateRaw: bigint;
+    readonly lossModelTargetBps: readonly number[];
+    readonly starbaseDestructionMedallionsRaw: readonly bigint[];
+    readonly activeMedallion: {
+        readonly cargoId: number;
+        readonly generation: number;
+        readonly buyerPriceAtlasRaw: bigint;
+    };
+    readonly medallionBuybackCapPerEpochRaw: bigint;
+    readonly rewardReserveLowBalanceThresholdRaw: bigint;
+    readonly upgradeLpRates: readonly {
+        readonly cargoId: number;
+        readonly lpPerRawUnit: bigint;
+    }[];
+    readonly salvageEntries: readonly {
+        readonly cargoId: number;
+        readonly weight: number;
+        readonly referenceValueAtlasRaw: bigint;
+    }[];
+}
+export interface AtlasRewardTreasuryAccountData {
+    readonly version: number;
+    readonly bump: number;
+    readonly game: Address;
+    readonly reserves: readonly {
+        readonly cargoId: number;
+        readonly quantityRaw: bigint;
+    }[];
+}
+export interface RewardLootAccountData {
+    readonly version: number;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly reward: {
+        readonly kind: 'none';
+    } | {
+        readonly kind: 'committed' | 'resolved';
+        readonly configVersion: number;
+        readonly slot: bigint;
+        readonly committedAtUnixSeconds: bigint;
+        readonly legs: readonly {
+            readonly recipient: Address;
+            readonly medallionsRaw: bigint;
+            readonly salvageTargetValueAtlasRaw: bigint;
+        }[];
+    } | {
+        readonly kind: 'unknown';
+        readonly rawStatus: number;
+        readonly configVersion: number;
+        readonly slot: bigint;
+        readonly committedAtUnixSeconds: bigint;
+        readonly legs: readonly {
+            readonly recipient: Address;
+            readonly medallionsRaw: bigint;
+            readonly salvageTargetValueAtlasRaw: bigint;
+        }[];
+    };
+}
+export declare const atlasRewardRegistryAccountDefinition: C4AccountAdapter<AtlasRewardRegistryAccountData>;
+export declare const atlasRewardConfigAccountDefinition: C4AccountAdapter<AtlasRewardConfigAccountData>;
+export declare const atlasRewardTreasuryAccountDefinition: C4AccountAdapter<AtlasRewardTreasuryAccountData>;
+export declare const rewardLootAccountDefinition: C4AccountAdapter<RewardLootAccountData>;
+export declare function buildRewardLootDiscoveryFilters(game: Address, profile: Address): readonly ProgramAccountFilter[];
+export declare function discoverRewardLootAccounts(context: SageContext, profile: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<RewardLootAccountData>[]>;
+export declare function deriveAtlasRewardRegistryAddress(game: Address): Promise<Address>;
+export { deriveAtlasRewardConfigAddress };
+export declare function deriveAtlasRewardTreasuryAddress(game: Address): Promise<Address>;
+//# sourceMappingURL=rewards.d.ts.map

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

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