@aephia/atlas-kit 0.0.0

package/dist/internal/c4/identity.js

@@ -0,0 +1,180 @@
+import { PLAYER_PROFILE_PROGRAM_ADDRESS, PROFILE_DISCRIMINATOR, PROFILE_FLAGS, getProfileDecoder, } from '@staratlas/dev-player-profile';
+import { CHARACTER_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, getCharacterDecoder, } from '@staratlas/dev-sage';
+import { getAddressEncoder, getBytesEncoder, getProgramDerivedAddress, } from '@solana/kit';
+import { AccountDecodeError, InvalidAccountOwnerError, InvalidDiscriminatorError, } from '../../client/errors.js';
+import { translateCharacterModifier } from './character-modifier.js';
+const FLOYDS_PER_ATLAS = 100_000_000;
+const PROFILE_MINIMUM_DATA_LENGTH = 30;
+const PROFILE_KEY_DATA_LENGTH = 80;
+const CHARACTER_MINIMUM_DATA_LENGTH = 415;
+function immutableBytes(bytes) {
+    return Object.freeze(Array.from(bytes));
+}
+const PROFILE_ACCOUNT_DISCRIMINATOR = immutableBytes(PROFILE_DISCRIMINATOR);
+const CHARACTER_ACCOUNT_DISCRIMINATOR = immutableBytes(CHARACTER_DISCRIMINATOR);
+const PROFILE_PERMISSION_BITS = [
+    [PROFILE_FLAGS.AUTH, 'authenticate'],
+    [PROFILE_FLAGS.ADD_KEYS, 'addKeys'],
+    [PROFILE_FLAGS.REMOVE_KEYS, 'removeKeys'],
+    [PROFILE_FLAGS.CHANGE_NAME, 'changeName'],
+    [PROFILE_FLAGS.CREATE_ROLE, 'createRole'],
+    [PROFILE_FLAGS.REMOVE_ROLE, 'removeRole'],
+    [PROFILE_FLAGS.SET_AUTHORIZER, 'setAuthorizer'],
+    [PROFILE_FLAGS.JOIN_ROLE, 'joinRole'],
+    [PROFILE_FLAGS.LEAVE_ROLE, 'leaveRole'],
+    [PROFILE_FLAGS.TOGGLE_ACCEPTING_NEW_MEMBERS, 'toggleAcceptingNewMembers'],
+    [PROFILE_FLAGS.ADD_MEMBER, 'addMember'],
+    [PROFILE_FLAGS.REMOVE_MEMBER, 'removeMember'],
+    [PROFILE_FLAGS.DRAIN_SOL_VAULT, 'drainSolVault'],
+];
+function littleEndianBytesToBigInt(bytes) {
+    return bytes.reduceRight((value, byte) => (value << 8n) | BigInt(byte), 0n);
+}
+function translatePermissions(raw, scope) {
+    const isPlayerProfileScope = scope === PLAYER_PROFILE_PROGRAM_ADDRESS;
+    return PROFILE_PERMISSION_BITS.flatMap(([flag, permission]) => (raw & flag) !== 0n &&
+        (isPlayerProfileScope || permission === 'drainSolVault')
+        ? [permission]
+        : []);
+}
+function validateAccount(account, type, owner, discriminator, minimumDataLength) {
+    if (account.owner !== owner) {
+        throw new InvalidAccountOwnerError(type, account.address, owner, account.owner);
+    }
+    if (account.data.length < discriminator.length ||
+        discriminator.some((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} account bytes, received ${account.data.length}.`));
+    }
+}
+function decodeExactly(account, type, decoder) {
+    try {
+        const [decoded, offset] = decoder.read(account.data, 0);
+        if (offset !== account.data.length) {
+            throw new RangeError(`Decoded ${offset} of ${account.data.length} account bytes; trailing bytes are not accepted.`);
+        }
+        return decoded;
+    }
+    catch (cause) {
+        throw new AccountDecodeError(type, account.address, cause);
+    }
+}
+function validateProfileShape(account) {
+    const keyCount = account.data[28] | (account.data[29] << 8);
+    const expectedLength = PROFILE_MINIMUM_DATA_LENGTH + keyCount * PROFILE_KEY_DATA_LENGTH;
+    if (account.data.length !== expectedLength) {
+        throw new AccountDecodeError('profile', account.address, new RangeError(`Profile declares ${keyCount} keys and requires ${expectedLength} bytes, received ${account.data.length}.`));
+    }
+}
+function translateProfile(profile) {
+    return {
+        authKeyCount: profile.authKeyCount,
+        createdAt: profile.createdAt,
+        keyThreshold: profile.keyThreshold,
+        keys: profile.profileKeys.map((key) => {
+            const permissionsRaw = littleEndianBytesToBigInt(key.permissions);
+            return {
+                address: key.key,
+                ...(key.expireTime < 0n ? {} : { expiresAt: key.expireTime }),
+                expiresAtRaw: key.expireTime,
+                permissions: translatePermissions(permissionsRaw, key.scope),
+                permissionsRaw,
+                scope: key.scope,
+            };
+        }),
+        nextSeqId: profile.nextSeqId,
+        version: profile.version,
+    };
+}
+function translateCharacter(character) {
+    const carryRaw = littleEndianBytesToBigInt(character.pilotXpBudget.fractionalCarry);
+    return {
+        atlas: Number(character.atlas) / FLOYDS_PER_ATLAS,
+        atlasRaw: character.atlas,
+        bump: character.bump,
+        checkIn: {
+            lastCheckInTime: character.checkInInfo.lastCheckInTime,
+            streak: character.checkInInfo.checkInStreak,
+        },
+        counts: { ...character.counts },
+        game: character.gameId,
+        modifiers: {
+            nodeLevels: [...character.characterModifiers.nodeLevels].map(([nodeId, level]) => ({ level, nodeId })),
+            seqId: character.characterModifiers.seqId,
+            unlockedNodes: [...character.characterModifiers.unlockedNodes],
+            unupdatedCount: character.characterModifiers.unupdatedCount,
+            values: translateCharacterModifier(character.characterModifiers.modifiers),
+        },
+        pilotXpBudget: {
+            available: character.pilotXpBudget.available,
+            fractionalCarry: Number(carryRaw) / 2 ** 48,
+            fractionalCarryRaw: carryRaw,
+            lastAccrualTime: character.pilotXpBudget.lastAccrualTime,
+        },
+        playerProfile: character.playerProfile,
+        version: character.version,
+        xp: {
+            ...character.xpInfo,
+            building: { ...character.xpInfo.building },
+            combat: { ...character.xpInfo.combat },
+            councilRank: { ...character.xpInfo.councilRank },
+            crafting: { ...character.xpInfo.crafting },
+            dailyXp: { ...character.xpInfo.dailyXp },
+            dataRunner: { ...character.xpInfo.dataRunner },
+            mining: { ...character.xpInfo.mining },
+            pilot: { ...character.xpInfo.pilot },
+        },
+    };
+}
+function validateProfileAccount(account) {
+    validateAccount(account, 'profile', PLAYER_PROFILE_PROGRAM_ADDRESS, PROFILE_ACCOUNT_DISCRIMINATOR, PROFILE_MINIMUM_DATA_LENGTH);
+}
+function validateCharacterAccount(account) {
+    validateAccount(account, 'character', SAGE_PROGRAM_ADDRESS, CHARACTER_ACCOUNT_DISCRIMINATOR, CHARACTER_MINIMUM_DATA_LENGTH);
+}
+function validateProfileAccountShape(account) {
+    validateProfileAccount(account);
+    validateProfileShape(account);
+}
+/** Stable Player Profile account definition for the pinned C4 bindings. */
+export const profileAccountDefinition = Object.freeze({
+    decode(account) {
+        validateProfileAccountShape(account);
+        return translateProfile(decodeExactly(account, 'profile', getProfileDecoder()));
+    },
+    discriminator: PROFILE_ACCOUNT_DISCRIMINATOR,
+    minimumDataLength: PROFILE_MINIMUM_DATA_LENGTH,
+    programAddress: PLAYER_PROFILE_PROGRAM_ADDRESS,
+    type: 'profile',
+    validate: validateProfileAccountShape,
+});
+/** Stable Character account definition for the pinned C4 bindings. */
+export const characterAccountDefinition = Object.freeze({
+    decode(account) {
+        validateCharacterAccount(account);
+        return translateCharacter(decodeExactly(account, 'character', getCharacterDecoder()));
+    },
+    discriminator: CHARACTER_ACCOUNT_DISCRIMINATOR,
+    minimumDataLength: CHARACTER_MINIMUM_DATA_LENGTH,
+    programAddress: SAGE_PROGRAM_ADDRESS,
+    type: 'character',
+    validate: validateCharacterAccount,
+});
+/** Derives the C4 Character address for a Player Profile and Game. */
+export async function findCharacterPda(playerProfile, game) {
+    // Mirrors the pinned generated `findCharacterPda` seed recipe. Calling the
+    // generated bundle directly selects its browser-only crypto assertion under
+    // Node, while Kit's conditional export works in both supported environments.
+    const [address] = await getProgramDerivedAddress({
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        seeds: [
+            getBytesEncoder().encode(new Uint8Array([67, 104, 97, 114, 97, 99, 116, 101, 114])),
+            getAddressEncoder().encode(playerProfile),
+            getAddressEncoder().encode(game),
+        ],
+    });
+    return address;
+}
+//# sourceMappingURL=identity.js.map

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

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

package/dist/internal/c4/loot-layout.d.ts

@@ -0,0 +1,20 @@
+import type { Loot } from '@staratlas/dev-sage';
+import type { RawAccount } from '../../client/contracts.js';
+/** Minimum byte length shared by every validated C4 Loot adapter. */
+export declare const LOOT_MINIMUM_DATA_LENGTH = 221;
+/** Stable Loot filter offsets verified against the pinned generated codec. */
+export declare const LOOT_FILTER_OFFSETS: Readonly<{
+    discriminator: 0;
+    game: 9;
+    profile: 41;
+}>;
+/**
+ * Enforces structural Loot invariants shared by combat and rewards reads.
+ *
+ * The generated codec fixes two reward-leg slots and describes `offsetList`
+ * entries as byte offsets to variable items. Status `NONE` therefore has no
+ * active reward legs, but inactive commitment metadata is deliberately ignored:
+ * the binding does not require those storage fields to be cleared.
+ */
+export declare function assertLootLayout(account: RawAccount, value: Loot): void;
+//# sourceMappingURL=loot-layout.d.ts.map

package/dist/internal/c4/loot-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loot-layout.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/loot-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB;;;;EAI9B,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CA2BvE"}

package/dist/internal/c4/loot-layout.js

@@ -0,0 +1,29 @@
+import { AccountDecodeError } from '../../client/errors.js';
+/** Minimum byte length shared by every validated C4 Loot adapter. */
+export const LOOT_MINIMUM_DATA_LENGTH = 221;
+/** Stable Loot filter offsets verified against the pinned generated codec. */
+export const LOOT_FILTER_OFFSETS = Object.freeze({
+    discriminator: 0,
+    game: 9,
+    profile: 41,
+});
+/**
+ * Enforces structural Loot invariants shared by combat and rewards reads.
+ *
+ * The generated codec fixes two reward-leg slots and describes `offsetList`
+ * entries as byte offsets to variable items. Status `NONE` therefore has no
+ * active reward legs, but inactive commitment metadata is deliberately ignored:
+ * the binding does not require those storage fields to be cleared.
+ */
+export function assertLootLayout(account, value) {
+    const offsetsAreOrdered = value.items.offsetList.every((offset, index) => index === 0 || offset > value.items.offsetList[index - 1]);
+    if (value.rewardLegCount > value.rewardLegs.length ||
+        value.items.offsetList.length !== value.items.unsizedList.length ||
+        !offsetsAreOrdered) {
+        throw new AccountDecodeError('loot', account.address, new RangeError('Loot reward or variable-item shape is inconsistent.'), `Loot ${account.address} contains inconsistent reward legs or item offsets. Refresh the account and verify the pinned binding version before retrying.`);
+    }
+    if (value.rewardStatus === 0 && value.rewardLegCount !== 0) {
+        throw new AccountDecodeError('loot', account.address, new RangeError('Loot with reward status NONE exposes active reward legs.'), `Loot ${account.address} has reward status NONE but exposes active reward legs. Refresh the account and retry after its reward status and leg count agree.`);
+    }
+}
+//# sourceMappingURL=loot-layout.js.map

package/dist/internal/c4/loot-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loot-layout.js","sourceRoot":"","sources":["../../../src/internal/c4/loot-layout.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,qEAAqE;AACrE,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,aAAa,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,EAAE;CACZ,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAmB,EAAE,KAAW;IAC/D,MAAM,iBAAiB,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CACpD,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAChB,KAAK,KAAK,CAAC,IAAI,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAE,CAC7D,CAAC;IACF,IACE,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM;QAC9C,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM;QAChE,CAAC,iBAAiB,EAClB,CAAC;QACD,MAAM,IAAI,kBAAkB,CAC1B,MAAM,EACN,OAAO,CAAC,OAAO,EACf,IAAI,UAAU,CAAC,qDAAqD,CAAC,EACrE,QAAQ,OAAO,CAAC,OAAO,gIAAgI,CACxJ,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,IAAI,KAAK,CAAC,cAAc,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,kBAAkB,CAC1B,MAAM,EACN,OAAO,CAAC,OAAO,EACf,IAAI,UAAU,CACZ,0DAA0D,CAC3D,EACD,QAAQ,OAAO,CAAC,OAAO,oIAAoI,CAC5J,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,102 @@
+import { type Address } from '@solana/kit';
+import type { DiscoveryRequest, ProgramAccountFilter, SageContext, SnapshotEnvelope } from '../../client/contracts.js';
+import type { C4AccountAdapter } from './adapter.js';
+import { deriveAtlasRewardConfigAddress, deriveFactionAccountAddress } from './pda.js';
+export declare const LOYALTY_EPOCH_FILTER_OFFSETS: Readonly<{
+    discriminator: 0;
+    game: 12;
+    faction: 44;
+}>;
+export declare const LOYALTY_CONTRIBUTION_FILTER_OFFSETS: Readonly<{
+    discriminator: 0;
+    game: 12;
+    profile: 44;
+}>;
+export declare const LOYALTY_ATLAS_BANK_FILTER_OFFSETS: Readonly<{
+    discriminator: 0;
+    game: 10;
+    profile: 42;
+}>;
+/** Audited read and deferred-action relationships for loyalty state. */
+export declare const LOYALTY_RELATIONSHIPS: readonly [{
+    readonly from: "game + faction + epoch | game + profile + faction";
+    readonly kind: "derived";
+    readonly mechanism: "generated LoyaltyEpoch, LoyaltyContribution, and LoyaltyAtlasBank PDA seeds";
+    readonly to: "loyalty state";
+}, {
+    readonly from: "loyalty account";
+    readonly kind: "stored";
+    readonly mechanism: "repeated Game, Profile, faction, epoch, and reward config identity fields";
+    readonly to: "game | profile | faction | epoch | reward config";
+}, {
+    readonly from: "epoch | contribution | bank";
+    readonly kind: "nested";
+    readonly mechanism: "lifecycle timestamps and exact LP/ATLAS values";
+    readonly to: "loyalty lifecycle and balances";
+}, {
+    readonly from: "loyalty";
+    readonly kind: "instruction-only";
+    readonly mechanism: "initialization, settlement, sweeping, and claiming co-accounts are not durable relations";
+    readonly to: "actions";
+}, {
+    readonly from: "faction | profile";
+    readonly kind: "discovered";
+    readonly mechanism: "verified discriminator and Game plus faction (epochs) or Profile (contributions and banks) offsets";
+    readonly to: "epochs | contributions | banks";
+}];
+export type LoyaltyEpochStatus = 'open' | 'closed' | 'swept';
+export interface LoyaltyEpochAccountData {
+    readonly version: number;
+    readonly bump: number;
+    readonly status: LoyaltyEpochStatus;
+    readonly kingSystems: number;
+    readonly game: Address;
+    readonly factionId: number;
+    readonly configVersion: number;
+    readonly epochIndex: bigint;
+    readonly startsAtUnixSeconds: bigint;
+    readonly endsAtUnixSeconds: bigint;
+    readonly settlementDeadlineUnixSeconds: bigint;
+    readonly totalLpRaw: bigint;
+    readonly poolAtlasRaw: bigint;
+    readonly unsettledAtlasRaw: bigint;
+    readonly settledAtlasRaw: bigint;
+}
+export interface LoyaltyContributionAccountData {
+    readonly version: number;
+    readonly bump: number;
+    readonly settled: boolean;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly factionId: number;
+    readonly epochIndex: bigint;
+    readonly lpRaw: bigint;
+    readonly atlasEntitlementRaw: bigint;
+    readonly settledAtUnixSeconds: bigint;
+}
+export interface LoyaltyAtlasBankAccountData {
+    readonly version: number;
+    readonly bump: number;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly factionId: number;
+    readonly claimableAtlasRaw: bigint;
+    readonly lifetimeLpRaw: bigint;
+    readonly lifetimeAtlasRaw: bigint;
+    readonly lastCreditedAtUnixSeconds: bigint;
+    readonly expiresAtUnixSeconds: bigint;
+}
+export declare const loyaltyEpochAccountDefinition: C4AccountAdapter<LoyaltyEpochAccountData>;
+export declare const loyaltyContributionAccountDefinition: C4AccountAdapter<LoyaltyContributionAccountData>;
+export declare const loyaltyAtlasBankAccountDefinition: C4AccountAdapter<LoyaltyAtlasBankAccountData>;
+export declare function deriveLoyaltyEpochAddress(game: Address, factionId: number, epochIndex: bigint): Promise<Address>;
+export declare function deriveLoyaltyContributionAddress(game: Address, profile: Address, factionId: number, epochIndex: bigint): Promise<Address>;
+export declare function deriveLoyaltyAtlasBankAddress(game: Address, profile: Address, factionId: number): Promise<Address>;
+export { deriveFactionAccountAddress as deriveLoyaltyFactionAddress, deriveAtlasRewardConfigAddress as deriveLoyaltyRewardConfigAddress, };
+export declare function buildLoyaltyEpochDiscoveryFilters(game: Address, factionId: number): readonly ProgramAccountFilter[];
+export declare function buildLoyaltyContributionDiscoveryFilters(game: Address, profile: Address): readonly ProgramAccountFilter[];
+export declare function buildLoyaltyAtlasBankDiscoveryFilters(game: Address, profile: Address): readonly ProgramAccountFilter[];
+export declare function discoverLoyaltyEpochsByFaction(context: SageContext, factionId: number, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<LoyaltyEpochAccountData>[]>;
+export declare function discoverLoyaltyContributionsByProfile(context: SageContext, profile: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<LoyaltyContributionAccountData>[]>;
+export declare function discoverLoyaltyAtlasBanksByProfile(context: SageContext, profile: Address, options?: Omit<DiscoveryRequest, 'filters' | 'strategy'>): Promise<readonly SnapshotEnvelope<LoyaltyAtlasBankAccountData>[]>;
+//# sourceMappingURL=loyalty.d.ts.map

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

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