@aephia/atlas-kit 0.6.0-next.11 → 0.6.0-next.110

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

@@ -0,0 +1,127 @@
+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 } from '../c4/identity.js';
+import { characterAccountDefinition } from '../c4/character.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

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-market-order-funding.js","sourceRoot":"","sources":["../../../src/internal/planning/local-market-order-funding.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,iCAAiC,EACjC,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EACL,sBAAsB,GAKvB,MAAM,yBAAyB,CAAC;AAEjC,SAAS,IAAI,CAAC,OAAgB,EAAE,OAAe;IAC7C,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7E,CAAC;AACD,SAAS,WAAW,CAClB,MAAqC;IAErC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;AAC3C,CAAC;AACD,MAAM,UAAU,2BAA2B,CACzC,OAAgB,EAChB,MAAmC;IAEnC,iEAAiE;IACjE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAE,CAAC;IAC/D,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,aAAc,CAAC,OAAO,CAAC,CAAC;AACrE,CAAC;AACD,SAAS,2BAA2B,CAClC,MAAyB,EACzB,QAAsD,EACtD,MAAmC,EACnC,sBAA+B;IAE/B,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC,YAAY;QAC3C,IAAI,CACF,MAAM,CAAC,OAAO,EACd,6HAA6H,CAC9H,CAAC;IACJ,MAAM,MAAM,GAAG,4BAA4B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,+BAA+B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,0BAA0B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAClE,IACE,YAAY,CAAC,OAAO,KAAK,MAAM,CAAC,SAAS;QACzC,SAAS,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO;QAC1C,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAC9B,SAAS,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO;QACpC,SAAS,CAAC,OAAO,KAAK,MAAM,CAAC,cAAc;QAC3C,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO;QACvC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAC/B,MAAM,CAAC,kBAAkB,KAAK,MAAM,CAAC,kBAAkB;QACvD,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO;QACvC,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;QACrC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAE/B,IAAI,CACF,MAAM,CAAC,OAAO,EACd,0IAA0I,CAC3I,CAAC;IACJ,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAC1E,IAAI,SAAS,CAAC,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC;QACjD,OAAO,WAAW,CAAC,4BAA4B,CAAC,CAAC;IACnD,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC;QACjC,OAAO,WAAW,CAAC,wBAAwB,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,IAAK,CAAC,MAAM,CAAC,aAAc,CAAC;IAC1C,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC,4BAA4B,CAAC,CAAC;IAC1E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC;QACrE,OAAO,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC3C,IACE,CAAC,UAAU;QACX,CAAC,OAAO;QACR,CAAC,QAAQ;QACT,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;QAClC,QAAQ,CAAC,UAAU;QACnB,UAAU,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO;QACrC,OAAO,CAAC,OAAO,KAAK,YAAY;QAChC,UAAU,CAAC,UAAU;QACrB,YAAY,CAAC,UAAU;QACvB,SAAS,CAAC,UAAU;QACpB,SAAS,CAAC,UAAU;QAEpB,OAAO,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAClD,2BAA2B,CAAC,UAAU,CAAC,CAAC;IACxC,IACE,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,6BAA6B,EAAE,CAAC,SAAS;QAClE,QAAQ,CAAC,KAAK,KAAK,oBAAoB;QACvC,CAAC,mCAAmC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAE5E,OAAO,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,6BAA6B,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxE,IAAI,SAAS,CAAC,OAAO,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI;QAC7D,OAAO,WAAW,CAAC,4BAA4B,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,IACE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAC9C,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;QACtD,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;QAChD,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;QAEhD,OAAO,WAAW,CAAC,6BAA6B,CAAC,CAAC;IACpD,4EAA4E;IAC5E,MAAM,mBAAmB,GACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,iCAAiC,CAAC;QAC/D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,IACE,UAAU,CAAC,QAAQ;QACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;YAC1B,CAAC,sBAAsB,IAAI,mBAAmB,CAAC,EACjD,CAAC;QACD,IAAI,sBAAsB,KAAK,SAAS;YACtC,OAAO,WAAW,CAAC,+BAA+B,CAAC,CAAC;QACtD,IAAI,CACF,MAAM,CAAC,OAAO,EACd,gMAAgM,CACjM,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,oBAAoB,EAAE,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAClE,oBAAoB,EAClB,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAChE,uBAAuB,EAAE,EAAE;QAC3B,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,GAAgB,EAChB,MAAyB,EACzB,SAAqB,EACrB,SAAqB,EACrB,YAAwB,EACxB,MAAmC;IAEnC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAkC;QACxD,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;QAC9B,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;QAC9B,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC;KACrC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,2BAA2B,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtE,IACE,OAAO,CAAC,MAAM,KAAK,aAAa;QAChC,OAAO,CAAC,MAAM,KAAK,2BAA2B;QAE9C,OAAO,OAAO,CAAC;IACjB,MAAM,SAAS,GAAG,2BAA2B,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC1D,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1E,OAAO,2BAA2B,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAA4B,EAC5B,QAAsD,EACtD,MAAmC;IAEnC,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO;IAC3C,MAAM,OAAO,GAAG,2BAA2B,CACzC,KAAK,EACL,QAAQ,EACR,MAAM,EACN,KAAK,CAAC,mBAAmB,CAC1B,CAAC;IACF,IACE,OAAO,CAAC,MAAM,KAAK,WAAW;QAC9B,OAAO,CAAC,mBAAmB,GAAG,KAAK,CAAC,mBAAmB;QACvD,OAAO,CAAC,oBAAoB,GAAG,KAAK,CAAC,oBAAoB;QACzD,OAAO,CAAC,oBAAoB,GAAG,KAAK,CAAC,oBAAoB;QACzD,OAAO,CAAC,uBAAuB,GAAG,KAAK,CAAC,uBAAuB;QAE/D,IAAI,CACF,KAAK,CAAC,OAAO,EACb,iLAAiL,CAClL,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,40 @@
+import type { Address } from '@solana/kit';
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+import { type GuardSchema } from './plan-fields.js';
+export type MarketBoundsUnavailableReason = 'unsupported-market-layout' | 'unsupported-account-layout' | 'unsupported-fee-policy' | 'missing-cargo-row' | 'funding-state-unavailable' | 'accounts-below-rent-reserve' | 'profile-below-storage-ceiling';
+export type MarketOrderAmounts = {
+    readonly status: 'unavailable';
+    readonly reason: MarketBoundsUnavailableReason;
+} | {
+    readonly status: 'available';
+    readonly maximumCargoDebitRaw: bigint;
+    readonly maximumAtlasDebitRaw: bigint;
+    readonly maximumGovernanceFeeRaw: bigint;
+    readonly maximumProfileDebit: bigint;
+};
+export interface MarketOrderIntent {
+    readonly address: Address;
+    readonly game: Address;
+    readonly system: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly certificate?: Address;
+    readonly keyIndex: number;
+    readonly character: Address;
+    readonly starbasePlayer: Address;
+    readonly starbaseSequenceId: bigint;
+    readonly cargoId: number;
+    readonly side: 'bid' | 'ask';
+    readonly priceRaw: bigint;
+    readonly quantity: bigint;
+}
+export type LocalMarketOrderGuard = MarketOrderIntent & MarketOrderAmounts & {
+    readonly kind: 'local-market-order';
+    readonly describes: string;
+    readonly dataHash?: never;
+};
+export declare function hasQualifiedMarketFees(guards: readonly PlanPrecondition[]): boolean;
+export declare function validateLocalMarketOrderInstructions(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+/** Plan guard schema: exact current Local Market intent and debit safeguard. */
+export declare const LOCAL_MARKET_ORDER_SCHEMA: GuardSchema;
+//# sourceMappingURL=local-market-order.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-market-order.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/local-market-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAO3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAIL,KAAK,WAAW,EAEjB,MAAM,kBAAkB,CAAC;AAC1B,MAAM,MAAM,6BAA6B,GACrC,2BAA2B,GAC3B,4BAA4B,GAC5B,wBAAwB,GACxB,mBAAmB,GACnB,2BAA2B,GAC3B,6BAA6B,GAC7B,+BAA+B,CAAC;AACpC,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;CAChD,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC,CAAC;AACN,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AACD,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GACnD,kBAAkB,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AAEJ,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,OAAO,CAWT;AACD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CA6DN;AAsBD,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,EAAE,WA4DvC,CAAC"}

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

@@ -0,0 +1,138 @@
+import { SAGE_PROGRAM_ADDRESS, PLACE_LOCAL_MARKET_ORDER_DISCRIMINATOR, matchesLocalMarketPlacement, } from '../c4/local-market-order.js';
+import { SageSdkError } from '../../client/errors.js';
+import { MAX_U64, } from './plan-fields.js';
+export function hasQualifiedMarketFees(guards) {
+    // Callers have resolved or normalized the mandatory market runtime guards.
+    const fees = guards.find((g) => g.kind === 'governance-fees');
+    const history = guards.find((g) => g.kind === 'democracy-history');
+    return (fees.intent.quote.source === 'default' &&
+        fees.intent.quote.params?.localMarketFeeBps === 0 &&
+        fees.intent.governance?.state === 'absent' &&
+        fees.intent.treasury?.state === 'absent' &&
+        history.intent.state === 'absent');
+}
+export function validateLocalMarketOrderInstructions(steps, guards) {
+    const selected = guards.filter((g) => g.kind === 'local-market-order');
+    const placements = steps.filter(({ instruction: i }) => i.programAddress === SAGE_PROGRAM_ADDRESS &&
+        PLACE_LOCAL_MARKET_ORDER_DISCRIMINATOR.every((v, n) => i.data?.[n] === v));
+    if (!selected.length && !placements.length)
+        return;
+    const bad = () => {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'A Local Market order requires one standalone placement with its exact debit safeguard and unchanged account-state guards. Recreate the Plan with planPlaceLocalMarketOrder; do not combine it with other actions or edit its saved intent.');
+    };
+    if (steps.length !== 1 || placements.length !== 1 || selected.length !== 1)
+        bad();
+    const guard = selected[0];
+    const step = placements[0];
+    const fees = guards.find((g) => g.kind === 'governance-fees');
+    const history = guards.find((g) => g.kind === 'democracy-history');
+    if (!fees ||
+        fees.kind !== 'governance-fees' ||
+        !history ||
+        history.kind !== 'democracy-history')
+        return bad();
+    if (history.intent.game !== guard.game ||
+        history.intent.system !== guard.system ||
+        fees.intent.request.mode !== 'market' ||
+        fees.intent.request.game !== guard.game ||
+        fees.intent.request.system !== guard.system ||
+        fees.intent.request.starbaseSeqId !== guard.starbaseSequenceId)
+        bad();
+    if (guard.status === 'available' &&
+        (!hasQualifiedMarketFees(guards) ||
+            fees.intent.currencyCache?.version !== 0))
+        bad();
+    if (step.signers.length !== 1 ||
+        step.signers[0] !== guard.authority ||
+        !matchesLocalMarketPlacement(step.instruction, {
+            ...guard,
+            ...history.accounts,
+            ...fees.accounts,
+            starbaseGovernance: fees.accounts.starbaseGovernance,
+            currencyCache: fees.accounts.currencyCache,
+        }))
+        bad();
+    for (const address of [guard.character, guard.starbasePlayer, guard.address])
+        if (!guards.some((g) => g.kind === 'account-state' && g.address === address))
+            bad();
+}
+const U64 = {
+    min: 0n,
+    max: MAX_U64,
+    accepted: 'an unsigned u64 bigint',
+};
+const U16 = {
+    min: 0,
+    max: 65535,
+    accepted: 'an unsigned u16 integer',
+};
+const MARKET_UNAVAILABLE_REASONS = [
+    'unsupported-market-layout',
+    'unsupported-account-layout',
+    'unsupported-fee-policy',
+    'missing-cargo-row',
+    'funding-state-unavailable',
+    'accounts-below-rent-reserve',
+    'profile-below-storage-ceiling',
+];
+const address = (key) => [key, 'address'];
+/** Plan guard schema: exact current Local Market intent and debit safeguard. */
+export const LOCAL_MARKET_ORDER_SCHEMA = {
+    fields: [
+        address('address'),
+        address('game'),
+        address('system'),
+        address('profile'),
+        address('authority'),
+        ['certificate', 'address', true],
+        ['keyIndex', U16],
+        address('character'),
+        address('starbasePlayer'),
+        ['starbaseSequenceId', U64],
+        ['cargoId', U16],
+        ['side', { values: ['bid', 'ask'], accepted: 'bid or ask' }],
+        ['priceRaw', U64],
+        ['quantity', U64],
+        [
+            'status',
+            {
+                values: ['available', 'unavailable'],
+                accepted: 'available or unavailable',
+            },
+        ],
+        ['describes', 'text'],
+    ],
+    byStatus: {
+        available: [
+            ['maximumCargoDebitRaw', U64],
+            ['maximumAtlasDebitRaw', U64],
+            ['maximumGovernanceFeeRaw', U64],
+            ['maximumProfileDebit', U64],
+        ],
+        unavailable: [
+            [
+                'reason',
+                {
+                    values: MARKET_UNAVAILABLE_REASONS,
+                    accepted: 'a supported unavailable reason',
+                },
+            ],
+        ],
+    },
+    check(guard) {
+        const price = guard.priceRaw;
+        const quantity = guard.quantity;
+        const bid = guard.side === 'bid';
+        if (price === 0n || quantity === 0n || (bid && price * quantity > MAX_U64))
+            return false;
+        return (guard.status !== 'available' ||
+            (guard.maximumGovernanceFeeRaw === 0n &&
+                guard.maximumCargoDebitRaw === (bid ? 0n : quantity) &&
+                guard.maximumAtlasDebitRaw === (bid ? price * quantity : 0n)));
+    },
+    error: {
+        accepted: 'the exact current Local Market intent and debit safeguard',
+        remedy: 'Recreate the order Plan; do not alter its saved intent, qualification or debit fields.',
+    },
+};
+//# sourceMappingURL=local-market-order.js.map

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

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

package/dist/internal/planning/mining-stop.d.ts

@@ -0,0 +1,14 @@
+import type { Address, RawAccount } from '../../client/contracts.js';
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+type MiningIntent = Readonly<{
+    address: Address;
+    game: Address;
+    profile: Address;
+    asteroid: Address;
+}>;
+/** Finite identity/state validation shared by preparation and execution. */
+export declare function matchesFleetMiningState(account: RawAccount | undefined, intent: MiningIntent): Promise<boolean>;
+/** Detects actual pinned stop instructions, independent of labels or wire age. */
+export declare function validateMiningStopInstructions(steps: readonly PlanStep[], preconditions: readonly PlanPrecondition[]): void;
+export {};
+//# sourceMappingURL=mining-stop.d.ts.map

package/dist/internal/planning/mining-stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mining-stop.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/mining-stop.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAG1E,KAAK,YAAY,GAAG,QAAQ,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAEH,4EAA4E;AAC5E,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED,kFAAkF;AAClF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,aAAa,EAAE,SAAS,gBAAgB,EAAE,GACzC,IAAI,CA6CN"}

package/dist/internal/planning/mining-stop.js

@@ -0,0 +1,41 @@
+import { SAGE_PROGRAM_ADDRESS, STOP_MINING_ASTEROID_DISCRIMINATOR, } from '../c4/mining-instructions.js';
+import { SageSdkError } from '../../client/errors.js';
+import { deriveFleetAddress, fleetAccountDefinition } from '../c4/fleet.js';
+/** Finite identity/state validation shared by preparation and execution. */
+export async function matchesFleetMiningState(account, intent) {
+    if (!account || account.address !== intent.address || account.executable)
+        return false;
+    const fleet = fleetAccountDefinition.decode(account);
+    return (fleet.game === intent.game &&
+        fleet.ownerProfile === intent.profile &&
+        fleet.state.kind === 'mining' &&
+        fleet.state.asteroid === intent.asteroid &&
+        (await deriveFleetAddress(fleet)) === intent.address);
+}
+/** Detects actual pinned stop instructions, independent of labels or wire age. */
+export function validateMiningStopInstructions(steps, preconditions) {
+    for (let index = 0; index < steps.length; index += 1) {
+        const instruction = steps[index].instruction;
+        if (instruction.programAddress !== SAGE_PROGRAM_ADDRESS ||
+            !STOP_MINING_ASTEROID_DISCRIMINATOR.every((byte, offset) => instruction.data?.[offset] === byte))
+            continue;
+        // Pinned StopMiningAsteroid: Profile 1, Fleet 5, Game 6, Asteroid 7.
+        const accounts = instruction.accounts;
+        const fleet = accounts?.[5]?.address;
+        if (instruction.data?.length !== 10 ||
+            (accounts?.length ?? 0) < 10 ||
+            !preconditions.some((guard) => guard.kind === 'fleet-mining' &&
+                guard.address === fleet &&
+                guard.game === accounts?.[6]?.address &&
+                guard.profile === accounts?.[1]?.address &&
+                guard.asteroid === accounts?.[7]?.address)) {
+            throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'This stop-mining instruction has no matching Fleet mining-state safeguard or has an unsupported layout. Refresh the Fleet and recreate this Plan with planFleetStopMining before signing; an idle stop can still consume exit fuel.');
+        }
+        if (steps
+            .slice(0, index)
+            .some((step) => step.instruction.accounts?.some((account) => account.address === fleet))) {
+            throw new SageSdkError('INCOMPATIBLE_PLAN_COMPOSITION', `An earlier instruction references Fleet ${fleet} before its guarded mining stop. Account write privileges are transaction-wide, so the fresh pre-sign check cannot establish the intermediate mining state. Use separate confirmed transactions and recreate the stop Plan from a fresh mining Fleet.`);
+        }
+    }
+}
+//# sourceMappingURL=mining-stop.js.map

package/dist/internal/planning/mining-stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mining-stop.js","sourceRoot":"","sources":["../../../src/internal/planning/mining-stop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,kCAAkC,GACnC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAS5E,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAA+B,EAC/B,MAAoB;IAEpB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU;QACtE,OAAO,KAAK,CAAC;IACf,MAAM,KAAK,GAAG,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrD,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAC1B,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC,OAAO;QACrC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC7B,KAAK,CAAC,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;QACxC,CAAC,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,CACrD,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,8BAA8B,CAC5C,KAA0B,EAC1B,aAA0C;IAE1C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC,WAAW,CAAC;QAC9C,IACE,WAAW,CAAC,cAAc,KAAK,oBAAoB;YACnD,CAAC,kCAAkC,CAAC,KAAK,CACvC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,CACtD;YAED,SAAS;QACX,qEAAqE;QACrE,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;QACtC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;QACrC,IACE,WAAW,CAAC,IAAI,EAAE,MAAM,KAAK,EAAE;YAC/B,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE;YAC5B,CAAC,aAAa,CAAC,IAAI,CACjB,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,IAAI,KAAK,cAAc;gBAC7B,KAAK,CAAC,OAAO,KAAK,KAAK;gBACvB,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO;gBACrC,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO;gBACxC,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,CAC5C,EACD,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,qOAAqO,CACtO,CAAC;QACJ,CAAC;QACD,IACE,KAAK;aACF,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAC7B,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK,CACvC,CACF,EACH,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,+BAA+B,EAC/B,2CAA2C,KAAK,uPAAuP,CACxS,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { Address, RawAccount } from '../../client/contracts.js';
+/** Retain movement-relevant Character state while permitting earned XP accrual. */
+export declare function hashMovementCharacter(account: RawAccount, intent: {
+    readonly game: Address;
+    readonly profile: Address;
+}): Promise<string>;
+//# sourceMappingURL=movement-character.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"movement-character.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/movement-character.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAYrE,mFAAmF;AACnF,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC5D,OAAO,CAAC,MAAM,CAAC,CA4CjB"}

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

@@ -0,0 +1,41 @@
+import { SageSdkError } from '../../client/errors.js';
+import { characterAccountDefinition, findCharacterPda, } from '../c4/character.js';
+import { getCharacterDecoder, getCharacterEncoder, } from '../c4/runtime-bindings.js';
+import { hashAccountState } from './account-state.js';
+/** Retain movement-relevant Character state while permitting earned XP accrual. */
+export async function hashMovementCharacter(account, intent) {
+    characterAccountDefinition.validate(account);
+    const [value, end] = getCharacterDecoder().read(account.data, 0);
+    if (account.executable ||
+        end !== account.data.length ||
+        value.gameId !== intent.game ||
+        value.playerProfile !== intent.profile ||
+        account.address !== (await findCharacterPda(intent.profile, intent.game)))
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'The movement Character no longer matches its canonical Profile, Game or supported account layout. Refresh the Character and recreate the movement Plan.');
+    const category = (xp) => ({
+        ...xp,
+        earned: 0n,
+        level: 0,
+    });
+    return hashAccountState(account.owner, new Uint8Array(getCharacterEncoder().encode({
+        ...value,
+        xpInfo: {
+            ...value.xpInfo,
+            councilRank: category(value.xpInfo.councilRank),
+            dailyXp: category(value.xpInfo.dailyXp),
+            pilot: category(value.xpInfo.pilot),
+            dataRunner: category(value.xpInfo.dataRunner),
+            mining: category(value.xpInfo.mining),
+            building: category(value.xpInfo.building),
+            crafting: category(value.xpInfo.crafting),
+            combat: category(value.xpInfo.combat),
+            councilRankLevelCarry: 0,
+        },
+        pilotXpBudget: {
+            available: 0,
+            fractionalCarry: [0, 0, 0, 0, 0, 0],
+            lastAccrualTime: 0n,
+        },
+    })));
+}
+//# sourceMappingURL=movement-character.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"movement-character.js","sourceRoot":"","sources":["../../../src/internal/planning/movement-character.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAmB,EACnB,MAA6D;IAE7D,0BAA0B,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,mBAAmB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACjE,IACE,OAAO,CAAC,UAAU;QAClB,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM;QAC3B,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI;QAC5B,KAAK,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO;QACtC,OAAO,CAAC,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAEzE,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,yJAAyJ,CAC1J,CAAC;IACJ,MAAM,QAAQ,GAAG,CAAC,EAAoD,EAAE,EAAE,CAAC,CAAC;QAC1E,GAAG,EAAE;QACL,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,CAAC;KACT,CAAC,CAAC;IACH,OAAO,gBAAgB,CACrB,OAAO,CAAC,KAAK,EACb,IAAI,UAAU,CACZ,mBAAmB,EAAE,CAAC,MAAM,CAAC;QAC3B,GAAG,KAAK;QACR,MAAM,EAAE;YACN,GAAG,KAAK,CAAC,MAAM;YACf,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;YAC/C,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;YACvC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;YACnC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;YAC7C,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YACrC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;YACzC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;YACzC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YACrC,qBAAqB,EAAE,CAAC;SACzB;QACD,aAAa,EAAE;YACb,SAAS,EAAE,CAAC;YACZ,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACnC,eAAe,EAAE,EAAE;SACpB;KACF,CAAC,CACH,CACF,CAAC;AACJ,CAAC"}

package/dist/internal/planning/movement-xp-guard.d.ts

@@ -0,0 +1,4 @@
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+/** Bind current XP tails to the actual instructions, independently of Plan kind. */
+export declare function validateMovementXpInstructions(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=movement-xp-guard.d.ts.map

package/dist/internal/planning/movement-xp-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"movement-xp-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/movement-xp-guard.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAsB1E,oFAAoF;AACpF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAgHN"}

package/dist/internal/planning/movement-xp-guard.js

@@ -0,0 +1,103 @@
+import { AccountRole } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { SAGE_PROGRAM_ADDRESS, START_SUBWARP_DISCRIMINATOR, WARP_TO_COORDINATE_DISCRIMINATOR, WARP_LANE_DISCRIMINATOR, STOP_SUBWARP_DISCRIMINATOR, STOP_MINING_ASTEROID_DISCRIMINATOR, getStartSubwarpInstructionDataDecoder, getWarpToCoordinateInstructionDataDecoder, getWarpLaneInstructionDataDecoder, getStopSubwarpInstructionDataDecoder, getStopMiningAsteroidInstructionDataDecoder, } from '../c4/runtime-bindings.js';
+function fail() {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Movement or mining-stop XP accounts, Character, Profile, Game or account roles mismatch. Refresh the Fleet and recreate the Plan.');
+}
+/** Bind current XP tails to the actual instructions, independently of Plan kind. */
+export function validateMovementXpInstructions(steps, guards) {
+    const layouts = [
+        {
+            discriminator: START_SUBWARP_DISCRIMINATOR,
+            decoder: getStartSubwarpInstructionDataDecoder,
+            budget: 9,
+            count: 12,
+            start: true,
+        },
+        {
+            discriminator: WARP_TO_COORDINATE_DISCRIMINATOR,
+            decoder: getWarpToCoordinateInstructionDataDecoder,
+            budget: 9,
+            count: 12,
+            start: true,
+        },
+        {
+            discriminator: WARP_LANE_DISCRIMINATOR,
+            decoder: getWarpLaneInstructionDataDecoder,
+            budget: 12,
+            count: 15,
+            start: true,
+        },
+        {
+            discriminator: STOP_SUBWARP_DISCRIMINATOR,
+            decoder: getStopSubwarpInstructionDataDecoder,
+            budget: 8,
+            count: 10,
+            start: false,
+        },
+        {
+            discriminator: STOP_MINING_ASTEROID_DISCRIMINATOR,
+            decoder: getStopMiningAsteroidInstructionDataDecoder,
+            budget: 10,
+            count: 12,
+            start: false,
+        },
+    ];
+    for (const { instruction } of steps) {
+        if (instruction.programAddress !== SAGE_PROGRAM_ADDRESS)
+            continue;
+        const layout = layouts.find((l) => l.discriminator.every((b, i) => instruction.data?.[i] === b));
+        if (!layout)
+            continue;
+        const { accounts, data } = instruction;
+        if (!accounts || accounts.length !== layout.count || !data)
+            fail();
+        try {
+            if (layout.decoder().read(data, 0)[1] !== data.length)
+                fail();
+        }
+        catch {
+            fail();
+        }
+        const game = accounts[6].address;
+        const character = accounts[4].address;
+        const profile = accounts[1].address;
+        const arrival = layout.budget === 8 &&
+            guards.some((g) => g.kind === 'fleet-arrival' &&
+                g.character === character &&
+                g.intent.profile === profile &&
+                g.intent.game === game &&
+                g.address === accounts[5].address);
+        const xp = guards.find((g) => g.kind === 'xp-runtime' &&
+            g.intent.game === game &&
+            g.intent.character === character &&
+            g.intent.structure === undefined &&
+            (g.intent.profile === profile ||
+                (arrival && g.intent.profile === undefined)));
+        if (!xp || xp.kind !== 'xp-runtime')
+            fail();
+        for (const [index, expected, role] of [
+            [1, profile, AccountRole.WRITABLE],
+            [4, character, AccountRole.WRITABLE],
+            [5, accounts[5].address, AccountRole.WRITABLE],
+            [6, game, AccountRole.READONLY],
+            [layout.budget, xp.accounts.xpBudget, AccountRole.WRITABLE],
+            [layout.budget + 1, xp.accounts.xpBudgetConfig, AccountRole.READONLY],
+        ])
+            if (expected === undefined ||
+                accounts[index].address !== expected ||
+                accounts[index].role !== role)
+                fail();
+        if (layout.start &&
+            (accounts.at(-1).address !== '11111111111111111111111111111111' ||
+                accounts.at(-1).role !== AccountRole.READONLY))
+            fail();
+        if (layout.start &&
+            !guards.some((g) => g.kind === 'movement-character' &&
+                g.address === character &&
+                g.profile === profile &&
+                g.game === game))
+            fail();
+    }
+}
+//# sourceMappingURL=movement-xp-guard.js.map

package/dist/internal/planning/movement-xp-guard.js.map

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

package/dist/internal/planning/open-signal-guard.d.ts

@@ -0,0 +1,3 @@
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+export declare function validateOpenSignalInstructions(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=open-signal-guard.d.ts.map

package/dist/internal/planning/open-signal-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-signal-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/open-signal-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAO1E,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CA2CN"}

package/dist/internal/planning/open-signal-guard.js

@@ -0,0 +1,31 @@
+import { SageSdkError } from '../../client/errors.js';
+import { openSignalAccounts, OPEN_SCAN_SIGNAL_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, } from '../c4/open-signal.js';
+export function validateOpenSignalInstructions(steps, guards) {
+    const selected = guards.filter((g) => g.kind === 'scan-signal-open');
+    const instructions = steps.filter(({ instruction: i }) => i.programAddress === SAGE_PROGRAM_ADDRESS &&
+        OPEN_SCAN_SIGNAL_DISCRIMINATOR.every((v, n) => i.data?.[n] === v));
+    if (!selected.length && !instructions.length)
+        return;
+    const bad = () => {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Signal setup instructions and safeguards do not match. Recreate the Plan with planOpenScanSignal; do not alter saved intent, accounts or instructions.');
+    };
+    if (selected.length !== instructions.length ||
+        new Set(selected.map((g) => g.address)).size !== selected.length)
+        bad();
+    for (const guard of selected) {
+        const expected = openSignalAccounts(guard);
+        if (!guards.some((g) => g.kind === 'game-account' && g.address === guard.game))
+            bad();
+        const matches = instructions.filter((step) => step.signers.length === 1 &&
+            step.signers[0] === guard.authority &&
+            step.instruction.data?.length === 10 &&
+            step.instruction.data[8] + step.instruction.data[9] * 256 ===
+                guard.keyIndex &&
+            step.instruction.accounts?.length === expected.length &&
+            expected.every((a, n) => step.instruction.accounts?.[n]?.address === a.address &&
+                step.instruction.accounts[n]?.role === a.role));
+        if (matches.length !== 1)
+            bad();
+    }
+}
+//# sourceMappingURL=open-signal-guard.js.map