@aephia/atlas-kit 0.6.0-next.10 → 0.6.0-next.100

package/dist/internal/planning/fleet-ship-assembly.js

@@ -0,0 +1,137 @@
+import { fleetAccountDefinition, deriveFleetAddress } from '../c4/fleet.js';
+import { fleetShipAssemblySize, isBasicFleetAssemblyShip, } from '../c4/fleet-ship-assembly.js';
+import { decodeGameShipAssemblyCatalog, hashShipAssemblyConfiguration, } from '../../registry/ships.js';
+import { isOffCurveAddress } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { profileAccountDefinition, characterAccountDefinition, findCharacterPda, } from '../c4/identity.js';
+import { profileFactionAccountDefinition, deriveProfileFactionAddress, } from '../c4/profile-faction.js';
+import { starbasePlayerAccountDefinition, deriveStarbasePlayerAddress, } from '../c4/starbase.js';
+import { starSystemAccountDefinition, deriveStarSystemAddress, } from '../c4/world.js';
+import { PROFILE_SCOPE, SAGE_SCOPE } from '../c4/profile-permissions.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+import { RENT_ADDRESS, readRent } from './rent.js';
+export async function resolveFleetShipAssembly(input) {
+    const intent = { ...input };
+    const [character, profileFaction] = await Promise.all([
+        findCharacterPda(intent.profile, intent.game),
+        deriveProfileFactionAddress(intent.profile),
+    ]);
+    return {
+        game: intent.game,
+        profile: intent.profile,
+        authority: intent.authority,
+        system: intent.system,
+        character,
+        profileFaction,
+        fleet: intent.address,
+        starbasePlayer: await deriveStarbasePlayerAddress(intent.system, character),
+        rent: RENT_ADDRESS,
+        clock: CLOCK_ADDRESS,
+    };
+}
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+export async function validateFleetShipAssembly(input, resolved, accounts, expected, catalog) {
+    const intent = { ...input };
+    if (isOffCurveAddress(intent.authority))
+        fail(intent.profile, 'Ship assembly requires an on-curve direct Profile authority. Select a current direct key and replan.');
+    const required = (address, name) => {
+        const raw = accounts.get(address);
+        if (!raw)
+            fail(address, `${name} ${address} is missing. Create or select the required account, then replan ship assembly.`);
+        if (raw.address !== address || raw.executable)
+            fail(address, `${name} ${address} has a contradictory address or is executable. Refresh valid account state before assembling ships.`);
+        return raw;
+    };
+    const profileRaw = required(resolved.profile, 'Profile');
+    const profile = profileAccountDefinition.decode(profileRaw);
+    const character = characterAccountDefinition.decode(required(resolved.character, 'Character'));
+    const faction = profileFactionAccountDefinition.decode(required(resolved.profileFaction, 'ProfileFaction'));
+    const system = starSystemAccountDefinition.decode(required(resolved.system, 'Star System'));
+    const player = starbasePlayerAccountDefinition.decode(required(resolved.starbasePlayer, 'StarbasePlayer'));
+    if (character.game !== intent.game ||
+        character.playerProfile !== intent.profile)
+        fail(resolved.character, 'The Character belongs to a different Game or Profile. Refresh the canonical Character and replan ship assembly.');
+    if (faction.profile !== intent.profile)
+        fail(resolved.profileFaction, 'The faction membership belongs to a different Profile. Refresh the canonical membership before assembling ships.');
+    if (system.game !== intent.game ||
+        (await deriveStarSystemAddress(system.game, system.systemId)) !==
+            intent.system ||
+        !system.starbase)
+        fail(resolved.system, 'The selected System is not canonical for this Game or has no Starbase. Choose a valid Starbase System and replan.');
+    if (player.playerProfile !== intent.profile ||
+        player.character !== resolved.character ||
+        player.system !== intent.system ||
+        player.faction !== faction.faction)
+        fail(resolved.starbasePlayer, 'The StarbasePlayer has a different Profile, Character, System or faction relationship. Refresh the canonical StarbasePlayer and replan.');
+    if (faction.faction === 'unaligned' ||
+        system.starbase.owner !== faction.faction)
+        fail(resolved.system, 'This planner supports an existing own-faction StarbasePlayer only. Select an own-faction Starbase; other diplomacy or access routes require separate supported planning.');
+    if (system.starbase.level !== 'css')
+        fail(resolved.system, 'Ship assembly currently supports own-faction CSS Starbases only. Dock at an own-faction CSS Starbase and replan; other access routes need separate support.');
+    const fleetRaw = required(resolved.fleet, 'Fleet');
+    const fleet = fleetAccountDefinition.decode(fleetRaw);
+    if ((await deriveFleetAddress(fleet)) !== intent.address ||
+        fleet.game !== intent.game ||
+        fleet.ownerProfile !== intent.profile ||
+        fleet.faction !== faction.faction ||
+        fleet.npcFactionId !== 0)
+        fail(resolved.fleet, 'The Fleet has a noncanonical address or different Game, Profile, faction or NPC affiliation. Select a canonical owned player Fleet and replan ship assembly.');
+    if (fleet.state.kind !== 'docked' || fleet.state.system !== intent.system)
+        fail(resolved.fleet, 'Ship assembly requires the Fleet to remain Docked at the selected System. Dock at an own-faction CSS Starbase and replan.');
+    const gameRaw = required(resolved.game, 'Game');
+    const definitions = catalog ?? decodeGameShipAssemblyCatalog(gameRaw);
+    if (fleet.shipDefinitionsSeqId !== definitions.sequenceId)
+        fail(resolved.fleet, 'This SDK route supports current ship-definition sequences only. Refresh the Fleet definitions through a supported game client, then replan; stale-sequence refresh behavior remains chain-authoritative.');
+    const selected = definitions.rows.find((row) => row.id === intent.shipId);
+    if (!isBasicFleetAssemblyShip(selected))
+        fail(resolved.game, 'The selected ship ID is unresolved or is not a requirements-free XXS configuration. Select a defined requirements-free XXS configuration; research, component and other size routes need separate support.');
+    // Every validated stored maxShipSize enum permits XXS, the smallest pinned size.
+    let quantity = 0n;
+    for (const entry of fleet.fleetShips) {
+        if (entry.quantity === 0n)
+            continue;
+        if (!isBasicFleetAssemblyShip(definitions.rows.find((row) => row.id === entry.shipId)))
+            fail(resolved.fleet, 'The Fleet already contains a positive unresolved or unsupported ship configuration. Use a Fleet containing only resolved requirements-free XXS ships; mixed-size capacity needs separate support.');
+        quantity += entry.quantity;
+    }
+    const current = fleet.fleetShips.find((entry) => entry.shipId === intent.shipId)
+        ?.quantity ?? 0n;
+    if (current + intent.amount > 18446744073709551615n)
+        fail(resolved.fleet, 'The resulting Fleet ship quantity exceeds the stored u64 limit. Select a smaller valid quantity and replan.');
+    if (quantity + intent.amount > BigInt(character.modifiers.values.fleetSize))
+        fail(resolved.character, 'The requested ships exceed the Character stored Fleet-size capacity. Reduce the amount or refresh changed Character modifiers, then replan.');
+    if (quantity + intent.amount > BigInt(definitions.maxFleetSize))
+        fail(resolved.game, 'The requested ships exceed the Game ship-assembly capacity. Reduce the resulting Fleet composition to fit the current Game limit, then replan; a larger Character allowance does not override it.');
+    const entitlement = player.shipsInEscrow.find((entry) => entry.shipId === intent.shipId)
+        ?.quantityRaw ?? 0n;
+    if (entitlement < intent.amount)
+        fail(resolved.starbasePlayer, 'The StarbasePlayer has insufficient entitlement for this exact ship configuration. Explicitly import that configuration or reduce the amount, then replan.');
+    const configHash = await hashShipAssemblyConfiguration(definitions, selected);
+    if (expected && expected.configHash !== configHash)
+        fail(resolved.game, 'The selected ship configuration has changed. Replan and inspect its current configuration before signing.');
+    const rent = readRent(required(resolved.rent, 'Rent sysvar'));
+    const now = readClock(required(resolved.clock, 'Clock sysvar'));
+    const fleetRent = rent(fleetShipAssemblySize(fleetRaw, intent.shipId, intent.amount));
+    const balance = fleetRaw.lamports;
+    const profileDebit = balance < fleetRent ? fleetRent - balance : 0n;
+    if (expected !== undefined && profileDebit > expected.maximumProfileDebit)
+        fail(resolved.profile, 'Ship assembly now requires a larger Profile debit than this Plan approved. Replan and inspect the updated rent shortfall before signing.');
+    const profileReserve = rent(profileRaw.data.length);
+    if (profileRaw.lamports < profileReserve + profileDebit)
+        fail(resolved.profile, 'The Profile lacks the Fleet rent shortfall while preserving its own rent reserve. Fund the Profile or Fleet target explicitly, then replan.');
+    const key = profile.keys[intent.keyIndex];
+    if (!key || key.address !== intent.authority)
+        fail(resolved.profile, 'The selected direct Profile key is absent or belongs to another authority. Select the current key index for this authority and replan.');
+    if (key.expiresAtRaw >= 0n && key.expiresAtRaw < now)
+        fail(resolved.profile, 'The selected Profile key has expired. Renew it or select a current direct key and replan ship assembly.');
+    const auth = key.scope === PROFILE_SCOPE && (key.permissionsRaw & 1n) !== 0n;
+    const manages = key.scope === SAGE_SCOPE && (key.permissionsRaw & (1n << 18n)) !== 0n;
+    if (!auth && !manages)
+        fail(resolved.profile, 'The selected key cannot manage Fleets. Use a direct Profile AUTH key or a SAGE manageFleet key and replan.');
+    if (profileDebit > 0n && !auth && (key.permissionsRaw & (1n << 63n)) === 0n)
+        fail(resolved.profile, 'The selected manageFleet key cannot fund the Fleet from the Profile vault. Explicitly prefund the target or choose an authorized vault-funding key, then replan; drainSolVault grants vault withdrawal authority.');
+    return { profileDebit, profileReserve, fleetRent, configHash };
+}
+//# sourceMappingURL=fleet-ship-assembly.js.map

package/dist/internal/planning/fleet-ship-assembly.js.map

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

package/dist/internal/planning/governance-fees.d.ts

@@ -0,0 +1,64 @@
+import type { Address, SageContext } from '../../client/contracts.js';
+import { type CraftingProcessAccountData } from '../c4/crafting.js';
+import type { ResolvedDemocracyHistory } from './democracy-history.js';
+export interface FeeRequest {
+    readonly game: Address;
+    readonly system: Address;
+    readonly starbaseSeqId: bigint;
+    readonly mode: 'market' | 'crafting-start' | 'crafting-complete';
+    readonly hasHab?: boolean;
+    readonly process?: Address;
+}
+export interface FeeParams {
+    readonly craftingFeeBps: number;
+    readonly localMarketFeeBps: number;
+    readonly localTreasuryShareBps: number;
+    readonly treasuryDistributionBps?: number;
+}
+export interface FeeIntent {
+    readonly request: FeeRequest;
+    readonly governance?: {
+        readonly address: Address;
+        readonly state: 'absent' | 'initialized';
+        readonly version?: number;
+        readonly enabled?: number;
+        readonly controllerFaction?: number;
+        readonly starbaseSeqId?: bigint;
+        readonly activeParams?: FeeParams;
+    };
+    readonly currencyCache?: {
+        readonly address: Address;
+        readonly version: number;
+    };
+    readonly treasury?: {
+        readonly address: Address;
+        readonly state: 'absent' | 'initialized';
+        readonly version?: number;
+        readonly governance?: Address;
+    };
+    readonly process?: {
+        readonly address: Address;
+        readonly version: number;
+        readonly feeRecipient?: 'atlas' | 'dao-atlas';
+        readonly feeGovernance?: Address;
+        readonly feeSnapshot?: CraftingProcessAccountData['feeSnapshot'];
+    };
+    readonly quote: {
+        readonly source: 'default' | 'governance' | 'history-policy' | 'history-generation' | 'history-disabled' | 'process-snapshot' | 'legacy-process';
+        readonly params?: FeeParams;
+    };
+}
+export interface ResolvedGovernanceFees {
+    readonly intent: FeeIntent;
+    readonly accounts: {
+        readonly starbaseGovernance?: Address;
+        readonly currencyCache?: Address;
+        readonly starbaseTreasury?: Address;
+    };
+    readonly description: string;
+}
+/** Resolve current fee accounts and a finite quote without creating or funding anything. */
+export declare function resolveGovernanceFees(ctx: SageContext, request: FeeRequest, history: ResolvedDemocracyHistory): Promise<ResolvedGovernanceFees>;
+/** Compare finite serialized fields; mutable shared balances are deliberately absent. */
+export declare function matchGovernanceFeesIntent(expected: FeeIntent, actual: FeeIntent): boolean;
+//# sourceMappingURL=governance-fees.d.ts.map

package/dist/internal/planning/governance-fees.d.ts.map

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

package/dist/internal/planning/governance-fees.js

@@ -0,0 +1,239 @@
+import { getAddressEncoder, getProgramDerivedAddress, getU64Encoder, } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { CURRENCY_CONFIG_CACHE_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, STARBASE_GOVERNANCE_DISCRIMINATOR, STARBASE_TREASURY_DISCRIMINATOR, getCurrencyConfigCacheDecoder, getStarbaseGovernanceDecoder, getStarbaseTreasuryDecoder, } from '../c4/runtime-bindings.js';
+import { deriveStarSystemAddress, starSystemAccountDefinition, } from '../c4/world.js';
+import { craftingProcessAccountDefinition, } from '../c4/crafting.js';
+function requireFee(condition, reason) {
+    if (!condition)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `${reason} Refresh the Starbase fee configuration and recreate this action; ask its operator to initialize missing fee-routing accounts.`);
+}
+async function derive(literal, scope, sequence) {
+    return getProgramDerivedAddress({
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        seeds: [
+            new TextEncoder().encode(literal),
+            getAddressEncoder().encode(scope),
+            ...(sequence === undefined ? [] : [getU64Encoder().encode(sequence)]),
+        ],
+    });
+}
+function decode(raw, address, discriminator, decoder) {
+    requireFee(raw &&
+        raw.address === address &&
+        raw.owner === SAGE_PROGRAM_ADDRESS &&
+        !raw.executable, `Fee-routing account ${address} is missing or has an unexpected owner or address.`);
+    requireFee(discriminator.every((byte, index) => raw.data[index] === byte), `Fee-routing account ${address} has the wrong discriminator.`);
+    try {
+        const [value, consumed] = decoder.read(raw.data, 0);
+        requireFee(consumed === raw.data.length, `Fee-routing account ${address} has trailing bytes.`);
+        return value;
+    }
+    catch (cause) {
+        if (cause instanceof SageSdkError)
+            throw cause;
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Fee-routing account ${address} cannot be decoded. Refresh the deployment and recreate this action with supported account data.`);
+    }
+}
+function params(value) {
+    return {
+        craftingFeeBps: value.craftingFeeBps,
+        localMarketFeeBps: value.localMarketFeeBps,
+        localTreasuryShareBps: value.localTreasuryShareBps,
+        treasuryDistributionBps: value.treasuryDistributionBps,
+    };
+}
+function description(intent) {
+    const quote = intent.quote;
+    if (!quote.params)
+        return 'Legacy Crafting Process has no captured governance fee snapshot. No governed fee amount or recipient is inferred from synthetic defaults.';
+    const value = quote.params;
+    return `Fee policy source: ${quote.source}. Recipe fee multiplier: ${value.craftingFeeBps} basis points (10,000 = 1×); Local Market fee: ${value.localMarketFeeBps} basis points of executed ATLAS value; local Treasury share: ${value.localTreasuryShareBps} basis points of governed fees.${intent.process?.feeRecipient ? ` Captured original recipe recipient: ${intent.process.feeRecipient}.` : ''}${intent.treasury?.state === 'initialized' ? ` Treasury: ${intent.treasury.address}.` : ''} These rates do not predict an executed debit and can race a policy change after validation.`;
+}
+/** Resolve current fee accounts and a finite quote without creating or funding anything. */
+export async function resolveGovernanceFees(ctx, request, history) {
+    requireFee(history.intent.game === request.game &&
+        history.intent.system === request.system, 'Fee and history scopes do not match.');
+    requireFee(request.mode === 'crafting-complete'
+        ? request.process !== undefined
+        : request.process === undefined, 'The fee route has an invalid Crafting Process selection.');
+    const [governanceAddress, governanceBump] = await derive('StarbaseGovernance', request.system, request.starbaseSeqId);
+    const [cacheAddress, cacheBump] = await derive('CurrencyConfig', request.game);
+    const needsCache = request.mode !== 'crafting-start' || request.hasHab === true;
+    const firstAddresses = request.mode === 'crafting-complete'
+        ? [request.process, cacheAddress, request.system]
+        : [
+            governanceAddress,
+            ...(needsCache ? [cacheAddress] : []),
+            request.system,
+        ];
+    const read = async (addresses) => {
+        const rows = await readContextRawAccounts(ctx, addresses, {
+            commitment: 'confirmed',
+        });
+        requireFee(rows.length === addresses.length &&
+            rows.every((raw, index) => !raw ||
+                (raw.address === addresses[index] && raw.slot >= history.slot)), 'Fee-routing reads are incomplete or older than their history context.');
+        return rows;
+    };
+    const rows = await read(firstAddresses);
+    {
+        const raw = rows[rows.length - 1];
+        requireFee(raw && !raw.executable, 'The fee route System account is missing or invalid.');
+        const system = starSystemAccountDefinition.decode(raw);
+        const canonical = await deriveStarSystemAddress(request.game, system.systemId);
+        requireFee(raw.address === request.system &&
+            canonical === request.system &&
+            system.game === request.game &&
+            system.sequenceId === request.starbaseSeqId &&
+            system.starbase !== undefined, 'The fee route System does not match its canonical address, Game or active Starbase sequence.');
+    }
+    let currencyCache;
+    if (needsCache) {
+        const value = decode(rows[1], cacheAddress, CURRENCY_CONFIG_CACHE_DISCRIMINATOR, getCurrencyConfigCacheDecoder());
+        requireFee(value.gameId === request.game && value.bump === cacheBump, 'CurrencyCache does not match the configured Game or canonical PDA bump.');
+        currencyCache = { address: cacheAddress, version: value.version };
+    }
+    let governance;
+    let process;
+    let quote;
+    let treasuryGovernance;
+    let treasuryRequired = false;
+    if (request.mode === 'crafting-complete') {
+        const raw = rows[0];
+        requireFee(raw && raw.address === request.process && !raw.executable, 'The selected Crafting Process is missing or invalid.');
+        const value = craftingProcessAccountDefinition.decode(raw);
+        requireFee(value.system === request.system &&
+            value.starbaseSequenceId === request.starbaseSeqId, 'The Crafting Process belongs to a different System or Starbase generation.');
+        process = {
+            address: request.process,
+            version: value.version,
+            ...(value.feeRecipient === undefined
+                ? {}
+                : { feeRecipient: value.feeRecipient }),
+            ...(value.feeGovernance === undefined
+                ? {}
+                : { feeGovernance: value.feeGovernance }),
+            ...(value.feeSnapshot === undefined
+                ? {}
+                : { feeSnapshot: value.feeSnapshot }),
+        };
+        quote = value.feeSnapshot
+            ? {
+                source: 'process-snapshot',
+                params: {
+                    craftingFeeBps: value.feeSnapshot.craftingFeeBasisPoints,
+                    localMarketFeeBps: value.feeSnapshot.localMarketFeeBasisPoints,
+                    localTreasuryShareBps: value.feeSnapshot.localTreasuryShareBasisPoints,
+                },
+            }
+            : { source: 'legacy-process' };
+        treasuryGovernance = value.feeGovernance;
+        treasuryRequired = treasuryGovernance !== undefined;
+    }
+    else {
+        const raw = rows[0];
+        const value = raw
+            ? decode(raw, governanceAddress, STARBASE_GOVERNANCE_DISCRIMINATOR, getStarbaseGovernanceDecoder())
+            : undefined;
+        if (value) {
+            requireFee(value.version === 2 || value.version === 3, 'Starbase governance has an unsupported schema version.');
+            requireFee(value.gameId === request.game &&
+                value.system === request.system &&
+                value.starbaseSeqId === request.starbaseSeqId &&
+                value.bump === governanceBump &&
+                value.enabled <= 1, 'Starbase governance has invalid scope, sequence, bump or enabled state.');
+            requireFee(!(value.version === 3 && history.intent.state === 'absent'), 'This Starbase governance requires initialized daily Democracy history.');
+            governance = {
+                address: governanceAddress,
+                state: 'initialized',
+                version: value.version,
+                enabled: value.enabled,
+                controllerFaction: value.controllerFaction,
+                starbaseSeqId: value.starbaseSeqId,
+                ...(history.intent.state === 'absent' && value.enabled === 1
+                    ? { activeParams: params(value.activeParams) }
+                    : {}),
+            };
+        }
+        else
+            governance = { address: governanceAddress, state: 'absent' };
+        if (history.intent.state === 'initialized')
+            quote = {
+                source: history.intent.enabled === 0
+                    ? 'history-disabled'
+                    : history.intent.generation
+                        ? 'history-generation'
+                        : 'history-policy',
+                params: params(history.intent.effectiveParams),
+            };
+        else if (value?.enabled)
+            quote = { source: 'governance', params: params(value.activeParams) };
+        else
+            quote = {
+                source: 'default',
+                params: {
+                    craftingFeeBps: 10000,
+                    localMarketFeeBps: 0,
+                    localTreasuryShareBps: 0,
+                    treasuryDistributionBps: 0,
+                },
+            };
+        if (request.mode === 'market') {
+            treasuryGovernance = governanceAddress;
+            treasuryRequired = quote.params.localTreasuryShareBps > 0;
+        }
+    }
+    let treasury;
+    if (treasuryGovernance) {
+        const [treasuryAddress, treasuryBump] = await derive('StarbaseTreasury', treasuryGovernance);
+        const [raw] = await read([treasuryAddress]);
+        if (raw) {
+            const value = decode(raw, treasuryAddress, STARBASE_TREASURY_DISCRIMINATOR, getStarbaseTreasuryDecoder());
+            requireFee(value.governance === treasuryGovernance &&
+                value.bump === treasuryBump &&
+                (request.mode !== 'market' || governance?.state === 'initialized'), 'Starbase Treasury does not match its governance or canonical PDA.');
+            treasury = {
+                address: treasuryAddress,
+                state: 'initialized',
+                version: value.version,
+                governance: value.governance,
+            };
+        }
+        else {
+            requireFee(!treasuryRequired, 'This fee route requires a Starbase Treasury that has not been initialized.');
+            treasury = { address: treasuryAddress, state: 'absent' };
+        }
+    }
+    const intent = {
+        request: { ...request },
+        ...(governance ? { governance } : {}),
+        ...(currencyCache ? { currencyCache } : {}),
+        ...(treasury ? { treasury } : {}),
+        ...(process ? { process } : {}),
+        quote,
+    };
+    return {
+        intent,
+        accounts: {
+            ...(request.mode === 'crafting-complete'
+                ? {}
+                : { starbaseGovernance: governanceAddress }),
+            ...(currencyCache ? { currencyCache: cacheAddress } : {}),
+            ...(treasury?.state === 'initialized'
+                ? { starbaseTreasury: treasury.address }
+                : {}),
+        },
+        description: description(intent),
+    };
+}
+/** Compare finite serialized fields; mutable shared balances are deliberately absent. */
+export function matchGovernanceFeesIntent(expected, actual) {
+    const canonical = (value) => JSON.stringify(value, (_key, field) => typeof field === 'bigint'
+        ? field.toString()
+        : field && typeof field === 'object' && !Array.isArray(field)
+            ? Object.fromEntries(Object.entries(field).sort(([left], [right]) => left.localeCompare(right)))
+            : field);
+    return canonical(expected) === canonical(actual);
+}
+//# sourceMappingURL=governance-fees.js.map

package/dist/internal/planning/governance-fees.js.map

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

package/dist/internal/planning/local-market-order-funding.d.ts

@@ -0,0 +1,8 @@
+import type { Address } from '@solana/kit';
+import type { RawAccount, SageContext } from '../../client/contracts.js';
+import type { PlanPrecondition } from '../../planning/index.js';
+import { type MarketOrderAmounts, type MarketOrderIntent, type LocalMarketOrderGuard } from './local-market-order.js';
+export declare function marketOrderFundingAddresses(profile: Address, guards: readonly PlanPrecondition[]): readonly Address[];
+export declare function resolveMarketOrderAmounts(ctx: SageContext, intent: MarketOrderIntent, marketRaw: RawAccount, playerRaw: RawAccount, characterRaw: RawAccount, guards: readonly PlanPrecondition[]): Promise<MarketOrderAmounts>;
+export declare function revalidateMarketOrder(guard: LocalMarketOrderGuard, accounts: ReadonlyMap<Address, RawAccount | undefined>, guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=local-market-order-funding.d.ts.map

package/dist/internal/planning/local-market-order-funding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-market-order-funding.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/local-market-order-funding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAO3C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQhE,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AAUjC,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,SAAS,OAAO,EAAE,CAIpB;AA0GD,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,UAAU,EACrB,YAAY,EAAE,UAAU,EACxB,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,OAAO,CAAC,kBAAkB,CAAC,CAgB7B;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,EACtD,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAmBN"}

package/dist/internal/planning/local-market-order-funding.js

@@ -0,0 +1,126 @@
+import { SAGE_PROGRAM_ADDRESS, LOCAL_MARKET_MAXIMUM_GROWTH_BYTES, CURRENCY_CONFIG_CACHE_DISCRIMINATOR, getCurrencyConfigCacheDecoder, } from '../c4/local-market-order.js';
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { validateProfileAccountShape, characterAccountDefinition, } from '../c4/identity.js';
+import { localMarketAccountDefinition } from '../c4/market.js';
+import { starbasePlayerAccountDefinition } from '../c4/starbase.js';
+import { RENT_ADDRESS, readRent } from './rent.js';
+import { hasQualifiedMarketFees, } from './local-market-order.js';
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+function unavailable(reason) {
+    return { status: 'unavailable', reason };
+}
+export function marketOrderFundingAddresses(profile, guards) {
+    // The normalized market fee guard requires this canonical cache.
+    const fees = guards.find((g) => g.kind === 'governance-fees');
+    return [profile, RENT_ADDRESS, fees.intent.currencyCache.address];
+}
+function calculateMarketOrderAmounts(intent, accounts, guards, approvedProfileCeiling) {
+    const marketRaw = accounts.get(intent.address);
+    const playerRaw = accounts.get(intent.starbasePlayer);
+    const characterRaw = accounts.get(intent.character);
+    if (!marketRaw || !playerRaw || !characterRaw)
+        fail(intent.address, 'A Local Market order prerequisite is missing. Refresh the Market, Character and Starbase Player before recreating the Plan.');
+    const market = localMarketAccountDefinition.decode(marketRaw);
+    const player = starbasePlayerAccountDefinition.decode(playerRaw);
+    const character = characterAccountDefinition.decode(characterRaw);
+    if (characterRaw.address !== intent.character ||
+        character.playerProfile !== intent.profile ||
+        character.game !== intent.game ||
+        marketRaw.address !== intent.address ||
+        playerRaw.address !== intent.starbasePlayer ||
+        market.cargo.cargoId !== intent.cargoId ||
+        market.system !== intent.system ||
+        market.starbaseSequenceId !== intent.starbaseSequenceId ||
+        player.playerProfile !== intent.profile ||
+        player.character !== intent.character ||
+        player.system !== intent.system)
+        fail(intent.address, 'The Local Market debit intent no longer matches its Profile, cargo or Starbase Player. Refresh the accounts and recreate the order Plan.');
+    if (market.version !== 0)
+        return unavailable('unsupported-market-layout');
+    if (character.version !== 0 || player.version !== 0)
+        return unavailable('unsupported-account-layout');
+    if (!hasQualifiedMarketFees(guards))
+        return unavailable('unsupported-fee-policy');
+    const fees = guards.find((g) => g.kind === 'governance-fees');
+    const cache = fees.intent.currencyCache;
+    if (cache.version !== 0)
+        return unavailable('unsupported-account-layout');
+    if (!player.cargo.amounts.some((row) => row.cargoId === intent.cargoId))
+        return unavailable('missing-cargo-row');
+    const cacheRaw = accounts.get(cache.address);
+    const profileRaw = accounts.get(intent.profile);
+    const rentRaw = accounts.get(RENT_ADDRESS);
+    if (!profileRaw ||
+        !rentRaw ||
+        !cacheRaw ||
+        cacheRaw.address !== cache.address ||
+        cacheRaw.executable ||
+        profileRaw.address !== intent.profile ||
+        rentRaw.address !== RENT_ADDRESS ||
+        profileRaw.executable ||
+        characterRaw.executable ||
+        marketRaw.executable ||
+        playerRaw.executable)
+        return unavailable('funding-state-unavailable');
+    validateProfileAccountShape(profileRaw);
+    if (cacheRaw.data.length !== getCurrencyConfigCacheDecoder().fixedSize ||
+        cacheRaw.owner !== SAGE_PROGRAM_ADDRESS ||
+        !CURRENCY_CONFIG_CACHE_DISCRIMINATOR.every((v, n) => cacheRaw.data[n] === v))
+        return unavailable('funding-state-unavailable');
+    const cacheData = getCurrencyConfigCacheDecoder().decode(cacheRaw.data);
+    if (cacheData.version !== 0 || cacheData.gameId !== intent.game)
+        return unavailable('unsupported-account-layout');
+    const rent = readRent(rentRaw);
+    if (cacheRaw.lamports < rent(cacheRaw.data.length) ||
+        characterRaw.lamports < rent(characterRaw.data.length) ||
+        marketRaw.lamports < rent(marketRaw.data.length) ||
+        playerRaw.lamports < rent(playerRaw.data.length))
+        return unavailable('accounts-below-rent-reserve');
+    // Existing surplus may be another maker's refundable rent. Never credit it.
+    const maximumProfileDebit = rent(marketRaw.data.length + LOCAL_MARKET_MAXIMUM_GROWTH_BYTES) -
+        rent(marketRaw.data.length);
+    if (profileRaw.lamports <
+        rent(profileRaw.data.length) +
+            (approvedProfileCeiling ?? maximumProfileDebit)) {
+        if (approvedProfileCeiling === undefined)
+            return unavailable('profile-below-storage-ceiling');
+        fail(intent.profile, 'The Profile cannot fund the conservative Local Market storage ceiling while preserving its own rent reserve. Fund the Profile explicitly and recreate the Plan; transaction fees are separate.');
+    }
+    return {
+        status: 'available',
+        maximumCargoDebitRaw: intent.side === 'ask' ? intent.quantity : 0n,
+        maximumAtlasDebitRaw: intent.side === 'bid' ? intent.priceRaw * intent.quantity : 0n,
+        maximumGovernanceFeeRaw: 0n,
+        maximumProfileDebit,
+    };
+}
+export async function resolveMarketOrderAmounts(ctx, intent, marketRaw, playerRaw, characterRaw, guards) {
+    const accounts = new Map([
+        [marketRaw.address, marketRaw],
+        [playerRaw.address, playerRaw],
+        [characterRaw.address, characterRaw],
+    ]);
+    const initial = calculateMarketOrderAmounts(intent, accounts, guards);
+    if (initial.status !== 'unavailable' ||
+        initial.reason !== 'funding-state-unavailable')
+        return initial;
+    const addresses = marketOrderFundingAddresses(intent.profile, guards);
+    const rows = await readContextRawAccounts(ctx, addresses);
+    addresses.forEach((address, index) => accounts.set(address, rows[index]));
+    return calculateMarketOrderAmounts(intent, accounts, guards);
+}
+export function revalidateMarketOrder(guard, accounts, guards) {
+    if (guard.status === 'unavailable')
+        return;
+    const current = calculateMarketOrderAmounts(guard, accounts, guards, guard.maximumProfileDebit);
+    if (current.status !== 'available' ||
+        current.maximumProfileDebit > guard.maximumProfileDebit ||
+        current.maximumAtlasDebitRaw > guard.maximumAtlasDebitRaw ||
+        current.maximumCargoDebitRaw > guard.maximumCargoDebitRaw ||
+        current.maximumGovernanceFeeRaw > guard.maximumGovernanceFeeRaw)
+        fail(guard.profile, 'The Local Market order no longer has qualified debits within its approved ceilings. Refresh the Market, fee policy and Rent, then recreate and inspect the Plan before signing.');
+}
+//# sourceMappingURL=local-market-order-funding.js.map