@aephia/atlas-kit 0.6.0-next.8 → 0.6.0-next.81

package/dist/internal/planning/character-registration-guard.js

@@ -0,0 +1,58 @@
+import { SageSdkError } from '../../client/errors.js';
+import { createRegisterCharacterInstruction } from '../c4/character-registration.js';
+import { REGISTER_CHARACTER_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, } from '../c4/runtime-bindings.js';
+function sameInstruction(actual, expected) {
+    return (actual.programAddress === expected.programAddress &&
+        actual.data?.length === expected.data?.length &&
+        expected.data?.every((byte, index) => actual.data?.[index] === byte) ===
+            true &&
+        actual.accounts?.length === expected.accounts?.length &&
+        expected.accounts?.every((account, index) => actual.accounts?.[index]?.address === account.address &&
+            actual.accounts[index]?.role === account.role) === true);
+}
+/** Bind every current register-character instruction to its finite persisted guard. */
+export function validateCharacterRegistrationInstructions(steps, preconditions) {
+    const guards = preconditions.filter((guard) => guard.kind === 'character-registration');
+    const characterTargets = new Set();
+    const xpBudgetTargets = new Set();
+    for (const guard of guards) {
+        if (characterTargets.has(guard.address) ||
+            xpBudgetTargets.has(guard.xpBudget))
+            throw new SageSdkError('INCOMPATIBLE_PLAN_COMPOSITION', 'A combined Plan cannot register the same Character or Career XP budget more than once. Keep exactly one creation instruction for each target.');
+        characterTargets.add(guard.address);
+        xpBudgetTargets.add(guard.xpBudget);
+    }
+    const registrations = steps.filter(({ instruction }) => instruction.programAddress === SAGE_PROGRAM_ADDRESS &&
+        REGISTER_CHARACTER_DISCRIMINATOR.every((byte, index) => instruction.data?.[index] === byte));
+    if (registrations.length !== guards.length)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Every Character registration instruction requires exactly one matching finite current-runtime registration guard. Recreate the Plan with planRegisterCharacter.');
+    // Unqualified instructions may change transaction-wide writable funders or targets.
+    // Only other validated registrations may share these accounts in this slice.
+    for (const guard of guards)
+        for (const step of steps) {
+            if (registrations.includes(step))
+                continue;
+            if (step.instruction.accounts?.some((account) => [guard.funder, guard.address, guard.xpBudget].includes(account.address)))
+                throw new SageSdkError('INCOMPATIBLE_PLAN_COMPOSITION', 'A Character registration cannot share funding or creation targets with an unqualified instruction. Execute and confirm that instruction separately, then recreate registration.');
+        }
+    const remaining = [...guards];
+    for (const step of registrations) {
+        const matchIndex = remaining.findIndex((guard) => {
+            const expected = createRegisterCharacterInstruction({
+                profile: guard.profile,
+                funder: guard.funder,
+                character: guard.address,
+                game: guard.game,
+                xpBudget: guard.xpBudget,
+                xpBudgetConfig: guard.xpBudgetConfig,
+            });
+            return (step.signers.length === 1 &&
+                step.signers[0] === guard.funder &&
+                sameInstruction(step.instruction, expected));
+        });
+        if (matchIndex < 0)
+            throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'A Character registration instruction does not match its persisted Profile, Game, funder, Character, or Career XP accounts and roles. Recreate the Plan with planRegisterCharacter.');
+        remaining.splice(matchIndex, 1);
+    }
+}
+//# sourceMappingURL=character-registration-guard.js.map

package/dist/internal/planning/character-registration-guard.js.map

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

package/dist/internal/planning/character-registration.d.ts

@@ -0,0 +1,23 @@
+import type { Address, Commitment } from '@solana/kit';
+import type { RawAccount, SageContext } from '../../client/contracts.js';
+import type { PlanPrecondition } from '../../planning/index.js';
+import { type CharacterInitialization } from '../../registry/onboarding.js';
+export interface CharacterRegistrationFunding {
+    readonly funder: Address;
+    readonly requiredLamports: bigint;
+    readonly observedLamports: bigint;
+    readonly netDebit: bigint;
+    readonly minimumBalance: bigint;
+}
+/** Revalidate one finite current-runtime Character creation intent before signing. */
+export declare function revalidateCharacterRegistration(ctx: SageContext, guard: Extract<PlanPrecondition, {
+    readonly kind: 'character-registration';
+}>, commitment: Commitment, freshGameVersions?: Map<Address, number>, initializations?: Map<Address, CharacterInitialization>): Promise<CharacterRegistrationFunding>;
+export declare function isEmptySystemAccount(account: RawAccount): boolean;
+/** #621: budget funding precedes any excess Character refund. */
+export declare function calculateRegistrationFunding(minimum: (size: number) => bigint, characterSize: number, characterBalance: bigint, budgetBalance: bigint): {
+    requiredLamports: bigint;
+    netDebit: bigint;
+    refund: bigint;
+};
+//# sourceMappingURL=character-registration.d.ts.map

package/dist/internal/planning/character-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-registration.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/character-registration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,8BAA8B,CAAC;AAOtC,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,sFAAsF;AACtF,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAA;CAAE,CAAC,EAC7E,UAAU,EAAE,UAAU,EACtB,iBAAiB,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,EACxC,eAAe,wCAA8C,GAC5D,OAAO,CAAC,4BAA4B,CAAC,CAoHvC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAMjE;AACD,iEAAiE;AACjE,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACjC,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM;;;;EAUtB"}

package/dist/internal/planning/character-registration.js

@@ -0,0 +1,86 @@
+import { requireGameAddress } from '../game-context.js';
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { findCharacterPda, profileAccountDefinition } from '../c4/identity.js';
+import { getCareerXpBudgetDecoder } from '../c4/runtime-bindings.js';
+import { hashAccountState } from './account-state.js';
+import { RENT_ADDRESS, readRent } from './faction-enrollment.js';
+import { readCharacterInitialization, } from '../../registry/onboarding.js';
+import { resolveCharacterRegistrationXpRuntime } from './xp-runtime.js';
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+/** Revalidate one finite current-runtime Character creation intent before signing. */
+export async function revalidateCharacterRegistration(ctx, guard, commitment, freshGameVersions, initializations = new Map()) {
+    if (guard.game !== requireGameAddress(ctx))
+        fail(guard.game, 'Registration Game differs from the configured deployment. Recreate the Plan in the intended Game context.');
+    const character = await findCharacterPda(guard.profile, guard.game);
+    if (character !== guard.address)
+        fail(guard.address, 'The Character address no longer matches the canonical Profile and Game derivation. Recreate the registration Plan.');
+    const [profileRaw, characterRaw, rentRaw, funderRaw] = await readContextRawAccounts(ctx, [guard.profile, character, RENT_ADDRESS, guard.funder], { commitment });
+    if (!profileRaw)
+        fail(guard.profile, 'The Player Profile is missing. Create or select it before registering its Character.');
+    if (profileRaw.executable)
+        fail(guard.profile, 'The Profile is executable. Select a valid Profile and recreate the Plan.');
+    profileAccountDefinition.decode(profileRaw);
+    if ((await hashAccountState(profileRaw.owner, profileRaw.data)) !==
+        guard.profileDataHash)
+        fail(guard.profile, 'The Player Profile state changed after planning. Refresh it and recreate the Character registration Plan.');
+    if (characterRaw && !isEmptySystemAccount(characterRaw))
+        fail(character, 'The canonical Character now exists. Read and reuse it instead of signing this creation Plan.');
+    let initialization = initializations.get(guard.game);
+    if (!initialization) {
+        initialization = await readCharacterInitialization(ctx, { commitment });
+        initializations.set(guard.game, initialization);
+    }
+    if (initialization.characterSize !== guard.characterSize ||
+        initialization.initializationHash !== guard.initializationHash)
+        fail(guard.game, 'Character initialization shape changed. Refresh the Game and recreate the registration Plan.');
+    freshGameVersions?.set(guard.game, 2);
+    const xp = await resolveCharacterRegistrationXpRuntime(ctx, {
+        game: guard.game,
+        character,
+    }, { commitment });
+    if (xp.xpBudget !== guard.xpBudget ||
+        xp.xpBudgetConfig !== guard.xpBudgetConfig)
+        fail(guard.address, 'The Career XP accounts no longer match this exact Character registration intent. Recreate the registration Plan.');
+    if (!rentRaw)
+        fail(RENT_ADDRESS, 'The Rent sysvar is missing. Refresh the configured deployment before registering a Character.');
+    if (!funderRaw ||
+        funderRaw.executable ||
+        funderRaw.owner !== '11111111111111111111111111111111' ||
+        funderRaw.data.length !== 0)
+        fail(guard.funder, 'The Character funder must remain an existing non-executable System wallet. Select and fund that signer separately, then recreate the Plan.');
+    if ((characterRaw?.lamports ?? 0n) !== guard.characterLamports ||
+        xp.budgetLamports !== guard.budgetLamports)
+        fail(guard.address, 'Creation target pre-funding changed, including the approved Character refund. Refresh the targets and recreate the registration Plan.');
+    const minimum = readRent(rentRaw);
+    const storage = calculateRegistrationFunding(minimum, guard.characterSize, characterRaw?.lamports ?? 0n, xp.budgetLamports);
+    const funding = storage.requiredLamports;
+    if (funding > guard.maximumFunderDebit)
+        fail(guard.funder, 'Character and Career XP storage now require more native funding than this Plan approved. Recreate and review the Plan before signing.');
+    return {
+        funder: guard.funder,
+        requiredLamports: funding,
+        observedLamports: funderRaw.lamports,
+        netDebit: storage.netDebit,
+        minimumBalance: minimum(0),
+    };
+}
+export function isEmptySystemAccount(account) {
+    return (!account.executable &&
+        account.owner === '11111111111111111111111111111111' &&
+        account.data.length === 0);
+}
+/** #621: budget funding precedes any excess Character refund. */
+export function calculateRegistrationFunding(minimum, characterSize, characterBalance, budgetBalance) {
+    const character = minimum(characterSize) - characterBalance;
+    const budget = minimum(getCareerXpBudgetDecoder().fixedSize) - budgetBalance;
+    const budgetDebit = budget > 0n ? budget : 0n;
+    return {
+        requiredLamports: (character > 0n ? character : 0n) + budgetDebit,
+        netDebit: character + budgetDebit,
+        refund: character < 0n ? -character : 0n,
+    };
+}
+//# sourceMappingURL=character-registration.js.map

package/dist/internal/planning/character-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-registration.js","sourceRoot":"","sources":["../../../src/internal/planning/character-registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,2BAA2B,GAE5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,qCAAqC,EAAE,MAAM,iBAAiB,CAAC;AAExE,SAAS,IAAI,CAAC,OAAgB,EAAE,OAAe;IAC7C,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7E,CAAC;AAUD,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,GAAgB,EAChB,KAA6E,EAC7E,UAAsB,EACtB,iBAAwC,EACxC,kBAAkB,IAAI,GAAG,EAAoC;IAE7D,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,CAAC,GAAG,CAAC;QACxC,IAAI,CACF,KAAK,CAAC,IAAI,EACV,2GAA2G,CAC5G,CAAC;IACJ,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACpE,IAAI,SAAS,KAAK,KAAK,CAAC,OAAO;QAC7B,IAAI,CACF,KAAK,CAAC,OAAO,EACb,oHAAoH,CACrH,CAAC;IACJ,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,GAClD,MAAM,sBAAsB,CAC1B,GAAG,EACH,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,EACtD,EAAE,UAAU,EAAE,CACf,CAAC;IACJ,IAAI,CAAC,UAAU;QACb,IAAI,CACF,KAAK,CAAC,OAAO,EACb,sFAAsF,CACvF,CAAC;IACJ,IAAI,UAAU,CAAC,UAAU;QACvB,IAAI,CACF,KAAK,CAAC,OAAO,EACb,0EAA0E,CAC3E,CAAC;IACJ,wBAAwB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5C,IACE,CAAC,MAAM,gBAAgB,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAC3D,KAAK,CAAC,eAAe;QAErB,IAAI,CACF,KAAK,CAAC,OAAO,EACb,2GAA2G,CAC5G,CAAC;IACJ,IAAI,YAAY,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC;QACrD,IAAI,CACF,SAAS,EACT,8FAA8F,CAC/F,CAAC;IAEJ,IAAI,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,MAAM,2BAA2B,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACxE,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAClD,CAAC;IACD,IACE,cAAc,CAAC,aAAa,KAAK,KAAK,CAAC,aAAa;QACpD,cAAc,CAAC,kBAAkB,KAAK,KAAK,CAAC,kBAAkB;QAE9D,IAAI,CACF,KAAK,CAAC,IAAI,EACV,8FAA8F,CAC/F,CAAC;IACJ,iBAAiB,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,MAAM,qCAAqC,CACpD,GAAG,EACH;QACE,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS;KACV,EACD,EAAE,UAAU,EAAE,CACf,CAAC;IACF,IACE,EAAE,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;QAC9B,EAAE,CAAC,cAAc,KAAK,KAAK,CAAC,cAAc;QAE1C,IAAI,CACF,KAAK,CAAC,OAAO,EACb,kHAAkH,CACnH,CAAC;IACJ,IAAI,CAAC,OAAO;QACV,IAAI,CACF,YAAY,EACZ,+FAA+F,CAChG,CAAC;IACJ,IACE,CAAC,SAAS;QACV,SAAS,CAAC,UAAU;QACpB,SAAS,CAAC,KAAK,KAAK,kCAAkC;QACtD,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAE3B,IAAI,CACF,KAAK,CAAC,MAAM,EACZ,4IAA4I,CAC7I,CAAC;IACJ,IACE,CAAC,YAAY,EAAE,QAAQ,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,iBAAiB;QAC1D,EAAE,CAAC,cAAc,KAAK,KAAK,CAAC,cAAc;QAE1C,IAAI,CACF,KAAK,CAAC,OAAO,EACb,uIAAuI,CACxI,CAAC;IACJ,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,4BAA4B,CAC1C,OAAO,EACP,KAAK,CAAC,aAAa,EACnB,YAAY,EAAE,QAAQ,IAAI,EAAE,EAC5B,EAAE,CAAC,cAAc,CAClB,CAAC;IACF,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IACzC,IAAI,OAAO,GAAG,KAAK,CAAC,kBAAkB;QACpC,IAAI,CACF,KAAK,CAAC,MAAM,EACZ,uIAAuI,CACxI,CAAC;IACJ,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,gBAAgB,EAAE,OAAO;QACzB,gBAAgB,EAAE,SAAS,CAAC,QAAQ;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAmB;IACtD,OAAO,CACL,CAAC,OAAO,CAAC,UAAU;QACnB,OAAO,CAAC,KAAK,KAAK,kCAAkC;QACpD,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAC1B,CAAC;AACJ,CAAC;AACD,iEAAiE;AACjE,MAAM,UAAU,4BAA4B,CAC1C,OAAiC,EACjC,aAAqB,EACrB,gBAAwB,EACxB,aAAqB;IAErB,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,gBAAgB,CAAC;IAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC;IAC7E,MAAM,WAAW,GAAG,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,OAAO;QACL,gBAAgB,EAAE,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW;QACjE,QAAQ,EAAE,SAAS,GAAG,WAAW;QACjC,MAAM,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;KACzC,CAAC;AACJ,CAAC"}

package/dist/internal/planning/democracy-history.d.ts

@@ -0,0 +1,50 @@
+import type { Address, SageContext } from '../../client/contracts.js';
+export interface HistoryFeeParams {
+    readonly craftingFeeBps: number;
+    readonly localMarketFeeBps: number;
+    readonly localTreasuryShareBps: number;
+    readonly treasuryDistributionBps: number;
+}
+interface HistoryScope {
+    readonly game: Address;
+    readonly system: Address;
+    readonly address: Address;
+}
+export type HistoryIntent = HistoryScope & ({
+    readonly state: 'absent';
+} | {
+    readonly state: 'initialized';
+    readonly openDay: bigint;
+    readonly enabled: 0 | 1;
+    readonly controller: number;
+    readonly generation?: Address;
+    readonly generationNumber: bigint;
+    readonly governance: Address;
+    readonly starbaseSeqId: bigint;
+    readonly policy: Address;
+    readonly policyFlags: {
+        readonly noControllerRevenue: number;
+        readonly zeroPowerRevenue: number;
+        readonly successorBaseline: number;
+        readonly captureIncomingEligibility: number;
+    };
+    readonly effectiveParams: HistoryFeeParams;
+});
+export interface ResolvedDemocracyHistory {
+    readonly intent: HistoryIntent;
+    readonly accounts: {
+        readonly democracyHistoryHistory: Address;
+        readonly democracyHistoryPolicy?: Address;
+        readonly democracyHistoryGeneration?: Address;
+    };
+    readonly slot: bigint;
+}
+/** Resolve a fresh, canonical history context without initializing or repairing it. */
+export declare function resolveDemocracyHistory(ctx: SageContext, scope: {
+    readonly game: Address;
+    readonly system: Address;
+}): Promise<ResolvedDemocracyHistory>;
+/** Compare only eligibility and consumed fee policy, never shared financial counters. */
+export declare function matchDemocracyHistoryIntent(expected: HistoryIntent, actual: HistoryIntent): boolean;
+export {};
+//# sourceMappingURL=democracy-history.d.ts.map

package/dist/internal/planning/democracy-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"democracy-history.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/democracy-history.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,OAAO,EAEP,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAgBnC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C;AACD,UAAU,YAAY;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AACD,MAAM,MAAM,aAAa,GAAG,YAAY,GACtC,CACI;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC5B;IACE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;QACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;KAC7C,CAAC;IACF,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;CAC5C,CACJ,CAAC;AACJ,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;QAC1C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;QAC1C,QAAQ,CAAC,0BAA0B,CAAC,EAAE,OAAO,CAAC;KAC/C,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AA6ED,uFAAuF;AACvF,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC1D,OAAO,CAAC,wBAAwB,CAAC,CAyLnC;AACD,yFAAyF;AACzF,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,aAAa,GACpB,OAAO,CA2BT"}

package/dist/internal/planning/democracy-history.js

@@ -0,0 +1,198 @@
+import { getAddressEncoder, getProgramDerivedAddress, getU64Encoder, } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { DEMOCRACY_GENERATION_HISTORY_DISCRIMINATOR, DEMOCRACY_HISTORY_POLICY_DISCRIMINATOR, DEMOCRACY_SYSTEM_HISTORY_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, getDemocracyGenerationHistoryDecoder, getDemocracyHistoryPolicyDecoder, getDemocracySystemHistoryDecoder, } from '../c4/runtime-bindings.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+const NONE = '11111111111111111111111111111111';
+const DOMAIN = new TextEncoder().encode('DEMHST01');
+function requireHistory(condition, reason) {
+    if (!condition)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `${reason} Refresh the Starbase's Democracy history before recreating this action; ask its operator to initialize or close pending daily checkpoints when needed.`);
+}
+async function derive(literal, scope, generation) {
+    return getProgramDerivedAddress({
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        seeds: [
+            new TextEncoder().encode(literal),
+            getAddressEncoder().encode(scope),
+            ...(generation === undefined ? [] : [getU64Encoder().encode(generation)]),
+        ],
+    });
+}
+function decode(raw, address, bump, discriminator, decoder) {
+    requireHistory(raw &&
+        raw.address === address &&
+        raw.owner === SAGE_PROGRAM_ADDRESS &&
+        !raw.executable, 'A required Democracy account is missing or has an unexpected owner or address.');
+    requireHistory(discriminator.every((byte, index) => raw.data[index] === byte), 'A Democracy account has the wrong discriminator.');
+    let value;
+    let consumed;
+    try {
+        [value, consumed] = decoder.read(raw.data, 0);
+    }
+    catch {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'A Democracy account cannot be decoded. Refresh the deployment and recreate this action with supported account data.');
+    }
+    requireHistory(consumed === raw.data.length, 'A Democracy account has an unexpected data length.');
+    requireHistory(value.version === 1 &&
+        value.bump === bump &&
+        value.domain.length === 8 &&
+        value.domain.every((byte, index) => byte === DOMAIN[index]) &&
+        value.reserved.every((byte) => byte === 0), 'A Democracy account has an unsupported version, domain, bump or reserved field.');
+    return value;
+}
+function equalBytes(a, b) {
+    return a.length === b.length && a.every((byte, index) => byte === b[index]);
+}
+function params(value) {
+    return {
+        craftingFeeBps: value.craftingFeeBps,
+        localMarketFeeBps: value.localMarketFeeBps,
+        localTreasuryShareBps: value.localTreasuryShareBps,
+        treasuryDistributionBps: value.treasuryDistributionBps,
+    };
+}
+/** Resolve a fresh, canonical history context without initializing or repairing it. */
+export async function resolveDemocracyHistory(ctx, scope) {
+    const [historyAddress, historyBump] = await derive('DemocracySystemHistory', scope.system);
+    const [policyAddress, policyBump] = await derive('DemocracyHistoryPolicy', scope.game);
+    let floor = 0n;
+    const read = async (addresses) => {
+        // Absence has no slot in this transport; Clock supplies batch provenance. We
+        // cannot request minContextSlot, so reject inconsistent/regressing responses.
+        const rows = await readContextRawAccounts(ctx, [...addresses, CLOCK_ADDRESS], { commitment: 'confirmed' });
+        requireHistory(rows.length === addresses.length + 1, 'The Democracy history read was incomplete.');
+        const clock = rows[rows.length - 1];
+        requireHistory(clock?.address === CLOCK_ADDRESS, 'The chain Clock is missing from the Democracy history read.');
+        const now = readClock(clock);
+        requireHistory(clock.slot >= floor &&
+            rows.every((row) => row === undefined || row.slot === clock.slot), 'The Democracy history response has inconsistent or regressing slots.');
+        floor = clock.slot;
+        return { rows, now };
+    };
+    const history = (raw) => {
+        const value = decode(raw, historyAddress, historyBump, DEMOCRACY_SYSTEM_HISTORY_DISCRIMINATOR, getDemocracySystemHistoryDecoder());
+        requireHistory(value.gameId === scope.game &&
+            value.system === scope.system &&
+            value.policy === policyAddress &&
+            value.enabled <= 1 &&
+            value.cutoverDay <= value.openDay &&
+            value.generationStartedDay <= value.openDay, 'The Democracy history scope or calendar is invalid.');
+        return value;
+    };
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const first = (await read([historyAddress])).rows[0];
+        if (!first)
+            return {
+                intent: {
+                    game: scope.game,
+                    system: scope.system,
+                    address: historyAddress,
+                    state: 'absent',
+                },
+                accounts: { democracyHistoryHistory: historyAddress },
+                slot: floor,
+            };
+        const initial = history(first);
+        const generationPda = initial.generation === NONE
+            ? undefined
+            : await derive('DemocracyGenerationHistory', scope.system, initial.generationNumber);
+        requireHistory(!generationPda || generationPda[0] === initial.generation, 'The Democracy history references a noncanonical generation.');
+        const batch = await read([
+            historyAddress,
+            policyAddress,
+            ...(generationPda ? [generationPda[0]] : []),
+        ]);
+        const second = batch.rows[0];
+        if (!second || !equalBytes(first.data, second.data))
+            continue;
+        const current = history(second);
+        const policy = decode(batch.rows[1], policyAddress, policyBump, DEMOCRACY_HISTORY_POLICY_DISCRIMINATOR, getDemocracyHistoryPolicyDecoder());
+        requireHistory(policy.gameId === scope.game &&
+            [
+                policy.noControllerRevenue,
+                policy.zeroPowerRevenue,
+                policy.successorBaseline,
+                policy.captureIncomingEligibility,
+            ].every((value) => value === 1 || value === 2), 'The Democracy policy scope or explicit policy flags are invalid.');
+        const generation = generationPda
+            ? decode(batch.rows[2], generationPda[0], generationPda[1], DEMOCRACY_GENERATION_HISTORY_DISCRIMINATOR, getDemocracyGenerationHistoryDecoder())
+            : undefined;
+        if (generation)
+            requireHistory(generation.gameId === scope.game &&
+                generation.system === scope.system &&
+                generation.generation === current.generationNumber &&
+                generation.starbaseSeqId === current.starbaseSeqId &&
+                generation.governance === current.governance &&
+                generation.controller === current.controller &&
+                generation.enabled === current.enabled &&
+                generation.openDay === current.openDay &&
+                generation.retired === 0 &&
+                generation.fundedAtlas >= generation.claimedAtlas &&
+                generation.rewardVault ===
+                    generation.fundedAtlas - generation.claimedAtlas, 'The Democracy generation scope, eligibility or reward funding does not match its history.');
+        requireHistory(current.controller === 0 || generation, 'The current Democracy controller has no initialized generation.');
+        requireHistory(batch.now >= 0n && batch.now / 86400n === current.openDay, 'The Democracy history has pending daily checkpoints or the chain day changed.');
+        const intent = {
+            game: scope.game,
+            system: scope.system,
+            address: historyAddress,
+            state: 'initialized',
+            openDay: current.openDay,
+            enabled: current.enabled,
+            controller: current.controller,
+            ...(generationPda ? { generation: generationPda[0] } : {}),
+            generationNumber: current.generationNumber,
+            governance: current.governance,
+            starbaseSeqId: current.starbaseSeqId,
+            policy: policyAddress,
+            policyFlags: {
+                noControllerRevenue: policy.noControllerRevenue,
+                zeroPowerRevenue: policy.zeroPowerRevenue,
+                successorBaseline: policy.successorBaseline,
+                captureIncomingEligibility: policy.captureIncomingEligibility,
+            },
+            effectiveParams: params(current.enabled === 0
+                ? {
+                    craftingFeeBps: 10000,
+                    localMarketFeeBps: 0,
+                    localTreasuryShareBps: 0,
+                    treasuryDistributionBps: 0,
+                }
+                : (generation?.activeParams ?? policy.defaultParams)),
+        };
+        return {
+            intent,
+            accounts: {
+                democracyHistoryHistory: historyAddress,
+                democracyHistoryPolicy: policyAddress,
+                ...(generationPda
+                    ? { democracyHistoryGeneration: generationPda[0] }
+                    : {}),
+            },
+            slot: floor,
+        };
+    }
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Democracy history changed during both preparation attempts. Refresh the Starbase and recreate this action.');
+}
+/** Compare only eligibility and consumed fee policy, never shared financial counters. */
+export function matchDemocracyHistoryIntent(expected, actual) {
+    if (expected.game !== actual.game ||
+        expected.system !== actual.system ||
+        expected.address !== actual.address ||
+        expected.state !== actual.state)
+        return false;
+    if (expected.state === 'absent' || actual.state === 'absent')
+        return true;
+    return (expected.openDay === actual.openDay &&
+        expected.enabled === actual.enabled &&
+        expected.controller === actual.controller &&
+        expected.generation === actual.generation &&
+        expected.generationNumber === actual.generationNumber &&
+        expected.governance === actual.governance &&
+        expected.starbaseSeqId === actual.starbaseSeqId &&
+        expected.policy === actual.policy &&
+        Object.entries(expected.policyFlags).every(([key, value]) => actual.policyFlags[key] === value) &&
+        Object.entries(expected.effectiveParams).every(([key, value]) => actual.effectiveParams[key] === value));
+}
+//# sourceMappingURL=democracy-history.js.map

package/dist/internal/planning/democracy-history.js.map

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

package/dist/internal/planning/faction-trade-guards.d.ts

@@ -0,0 +1,30 @@
+import type { PlanPrecondition } from '../../planning/index.js';
+/** Recognizes schema-bound buy guards. */
+export declare function isTradeBuyGuard(guard: PlanPrecondition): guard is Extract<PlanPrecondition, {
+    kind: 'faction-treasury-buy-versioned';
+}>;
+export declare function isTradeBuyGuard(guard: {
+    readonly kind?: unknown;
+}): boolean;
+/** Recognizes schema-bound sell guards. */
+export declare function isTradeSellGuard(guard: PlanPrecondition): guard is Extract<PlanPrecondition, {
+    kind: 'faction-treasury-sell-versioned';
+}>;
+export declare function isTradeSellGuard(guard: {
+    readonly kind?: unknown;
+}): boolean;
+/** Recognizes schema-bound meter guards. */
+export declare function isTradeMeterGuard(guard: PlanPrecondition): guard is Extract<PlanPrecondition, {
+    kind: 'faction-epoch-meter-versioned';
+}>;
+export declare function isTradeMeterGuard(guard: {
+    readonly kind?: unknown;
+}): boolean;
+/** Finite trade guards share validation without importing account decoders. */
+export declare function isFactionTradeGuard(guard: PlanPrecondition): guard is Extract<PlanPrecondition, {
+    kind: 'faction-treasury-buy-versioned' | 'faction-treasury-sell-versioned' | 'faction-epoch-meter-versioned';
+}>;
+export declare function isFactionTradeGuard(guard: {
+    readonly kind?: unknown;
+}): boolean;
+//# sourceMappingURL=faction-trade-guards.d.ts.map

package/dist/internal/planning/faction-trade-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faction-trade-guards.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/faction-trade-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,0CAA0C;AAC1C,wBAAgB,eAAe,CAC7B,KAAK,EAAE,gBAAgB,GACtB,KAAK,IAAI,OAAO,CACjB,gBAAgB,EAChB;IAAE,IAAI,EAAE,gCAAgC,CAAA;CAAE,CAC3C,CAAC;AACF,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC;AAK7E,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,gBAAgB,GACtB,KAAK,IAAI,OAAO,CACjB,gBAAgB,EAChB;IAAE,IAAI,EAAE,iCAAiC,CAAA;CAAE,CAC5C,CAAC;AACF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC;AAK9E,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,GACtB,KAAK,IAAI,OAAO,CACjB,gBAAgB,EAChB;IAAE,IAAI,EAAE,+BAA+B,CAAA;CAAE,CAC1C,CAAC;AACF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC;AAK/E,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK,IAAI,OAAO,CAC5E,gBAAgB,EAChB;IACE,IAAI,EACA,gCAAgC,GAChC,iCAAiC,GACjC,+BAA+B,CAAC;CACrC,CACF,CAAC;AACF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC"}

package/dist/internal/planning/faction-trade-guards.js

@@ -0,0 +1,15 @@
+export function isTradeBuyGuard(guard) {
+    return guard.kind === 'faction-treasury-buy-versioned';
+}
+export function isTradeSellGuard(guard) {
+    return guard.kind === 'faction-treasury-sell-versioned';
+}
+export function isTradeMeterGuard(guard) {
+    return guard.kind === 'faction-epoch-meter-versioned';
+}
+export function isFactionTradeGuard(guard) {
+    return (isTradeBuyGuard(guard) ||
+        isTradeSellGuard(guard) ||
+        isTradeMeterGuard(guard));
+}
+//# sourceMappingURL=faction-trade-guards.js.map

package/dist/internal/planning/faction-trade-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faction-trade-guards.js","sourceRoot":"","sources":["../../../src/internal/planning/faction-trade-guards.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,eAAe,CAAC,KAAkC;IAChE,OAAO,KAAK,CAAC,IAAI,KAAK,gCAAgC,CAAC;AACzD,CAAC;AAUD,MAAM,UAAU,gBAAgB,CAAC,KAAkC;IACjE,OAAO,KAAK,CAAC,IAAI,KAAK,iCAAiC,CAAC;AAC1D,CAAC;AAUD,MAAM,UAAU,iBAAiB,CAAC,KAAkC;IAClE,OAAO,KAAK,CAAC,IAAI,KAAK,+BAA+B,CAAC;AACxD,CAAC;AAeD,MAAM,UAAU,mBAAmB,CAAC,KAEnC;IACC,OAAO,CACL,eAAe,CAAC,KAAK,CAAC;QACtB,gBAAgB,CAAC,KAAK,CAAC;QACvB,iBAAiB,CAAC,KAAK,CAAC,CACzB,CAAC;AACJ,CAAC"}

package/dist/internal/planning/faction-trade-state.d.ts

@@ -0,0 +1,16 @@
+import type { Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import type { PlanPrecondition } from '../../planning/index.js';
+type Identity = {
+    readonly game: Address;
+    readonly factionId: number;
+};
+/** Shared preparation/execution validation; no balances or fill assumptions. */
+export declare function readTradeTreasury(account: RawAccount, identity: Identity): Promise<Readonly<import("../c4/faction-treasury.js").FactionTreasuryAccountData>>;
+export declare function validateTradeEpochMeter(account: RawAccount, identity: Identity): Promise<import("@staratlas/dev-sage").FactionEpochMeter>;
+/** D053 finite comparison binds the account schema and selected trade settings. */
+export declare function matchesFactionTradeState(account: RawAccount, guard: Extract<PlanPrecondition, {
+    kind: 'faction-treasury-buy-versioned' | 'faction-treasury-sell-versioned' | 'faction-epoch-meter-versioned';
+}>): Promise<boolean>;
+export {};
+//# sourceMappingURL=faction-trade-state.d.ts.map

package/dist/internal/planning/faction-trade-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faction-trade-state.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/faction-trade-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAUhE,KAAK,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAUvE,gFAAgF;AAChF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,QAAQ,qFAYnB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,QAAQ,4DAWnB;AAED,mFAAmF;AACnF,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,OAAO,CACZ,gBAAgB,EAChB;IACE,IAAI,EACA,gCAAgC,GAChC,iCAAiC,GACjC,+BAA+B,CAAC;CACrC,CACF,GACA,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/internal/planning/faction-trade-state.js

@@ -0,0 +1,43 @@
+import { isTradeBuyGuard, isTradeMeterGuard } from './faction-trade-guards.js';
+import { SageSdkError } from '../../client/errors.js';
+import { deriveFactionTreasuryAddress, factionTreasuryAccountDefinition, } from '../c4/faction-treasury.js';
+import { decodeTradeEpochMeter, deriveTradeEpochMeterAddress, } from '../c4/faction-epoch-meter.js';
+function invalid(account, role) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', `${role} must match its canonical Game/faction identity and supported account layout. Refresh the Market and canonical faction accounts, then prepare a new trade.`, { address: account.address });
+}
+/** Shared preparation/execution validation; no balances or fill assumptions. */
+export async function readTradeTreasury(account, identity) {
+    const treasury = factionTreasuryAccountDefinition.decode(account);
+    if (account.executable ||
+        treasury.game !== identity.game ||
+        treasury.factionId !== identity.factionId ||
+        account.address !==
+            (await deriveFactionTreasuryAddress(identity.game, identity.factionId)))
+        invalid(account, 'Faction Treasury');
+    return treasury;
+}
+export async function validateTradeEpochMeter(account, identity) {
+    const meter = decodeTradeEpochMeter(account);
+    if (account.executable ||
+        meter.gameId !== identity.game ||
+        meter.factionId !== identity.factionId ||
+        account.address !== (await deriveTradeEpochMeterAddress(identity)))
+        invalid(account, 'Faction Epoch Meter');
+    return meter;
+}
+/** D053 finite comparison binds the account schema and selected trade settings. */
+export async function matchesFactionTradeState(account, guard) {
+    if (isTradeMeterGuard(guard)) {
+        const meter = await validateTradeEpochMeter(account, guard);
+        return meter.version === guard.schemaVersion;
+    }
+    const treasury = await readTradeTreasury(account, guard);
+    if (treasury.version !== guard.schemaVersion)
+        return false;
+    return isTradeBuyGuard(guard)
+        ? (treasury.reserves.find((row) => row.cargoId === guard.cargoId)
+            ?.floorRaw ?? 0n) === guard.floorRaw
+        : treasury.atlasOutCapPerEpochRaw === guard.atlasOutCapPerEpochRaw &&
+            treasury.epochLengthSeconds === guard.epochLengthSeconds;
+}
+//# sourceMappingURL=faction-trade-state.js.map

package/dist/internal/planning/faction-trade-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faction-trade-state.js","sourceRoot":"","sources":["../../../src/internal/planning/faction-trade-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG/E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AAItC,SAAS,OAAO,CAAC,OAAmB,EAAE,IAAY;IAChD,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,GAAG,IAAI,4JAA4J,EACnK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAmB,EACnB,QAAkB;IAElB,MAAM,QAAQ,GAAG,gCAAgC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClE,IACE,OAAO,CAAC,UAAU;QAClB,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;QAC/B,QAAQ,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS;QACzC,OAAO,CAAC,OAAO;YACb,CAAC,MAAM,4BAA4B,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEzE,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IACvC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAmB,EACnB,QAAkB;IAElB,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC7C,IACE,OAAO,CAAC,UAAU;QAClB,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI;QAC9B,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS;QACtC,OAAO,CAAC,OAAO,KAAK,CAAC,MAAM,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QAElE,OAAO,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAmB,EACnB,KAQC;IAED,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5D,OAAO,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,aAAa,CAAC;IAC/C,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzD,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IAC3D,OAAO,eAAe,CAAC,KAAK,CAAC;QAC3B,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC;YAC7D,EAAE,QAAQ,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,QAAQ;QACxC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,KAAK,KAAK,CAAC,sBAAsB;YAC9D,QAAQ,CAAC,kBAAkB,KAAK,KAAK,CAAC,kBAAkB,CAAC;AACjE,CAAC"}