@aephia/atlas-kit 0.6.0-next.12 → 0.6.0-next.120

package/dist/planning/plan-sequence.js

@@ -39,7 +39,14 @@ function readDataRecord(value, field, acceptedRange = 'a plain object with data
             if (descriptor === undefined || !('value' in descriptor)) {
                 return invalid(`${field}.${key}`, 'accessor property', 'a data property');
             }
-            copy[key] = descriptor.value;
+            // Define, never assign: assigning an own "__proto__" key would invoke
+            // the prototype setter and hide it from the exact-field check.
+            Object.defineProperty(copy, key, {
+                configurable: true,
+                enumerable: true,
+                value: descriptor.value,
+                writable: true,
+            });
         }
         return copy;
     }

package/dist/planning/plan-sequence.js.map

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

package/dist/planning/plan-validation.d.ts

@@ -0,0 +1,17 @@
+import type { PlanPrecondition, PlanStep } from './index.js';
+/** Guard bindings public `createPlan` checks for every Plan it creates (D085).
+ * Capability planners build through `buildPlannerPlan` instead and rely on the
+ * canonical list at combination and assembly.
+ */
+export declare function validateCreationBindings(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+/** Bindings checked once when a saved Plan is hydrated: every creation check
+ * plus the exact instruction bytes and XP bindings of complete Plans.
+ */
+export declare function validateHydrationBindings(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+/** The canonical bindings, checked once each when Plans are combined or
+ * assembled for simulation and signing: every hydration check plus
+ * composition, arrival, runtime and mining-stop bindings. Order follows the
+ * established assembly order; checks new to assembly precede instruction checks.
+ */
+export declare function validatePlanBindings(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=plan-validation.d.ts.map

package/dist/planning/plan-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-validation.d.ts","sourceRoot":"","sources":["../../src/planning/plan-validation.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAyD7D;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAgBN;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAqBN"}

package/dist/planning/plan-validation.js

@@ -0,0 +1,127 @@
+import { SageSdkError } from '../client/errors.js';
+import { validateArrivalInstructions } from '../internal/planning/arrival-guards.js';
+import { validateCharacterRegistrationInstructions } from '../internal/planning/character-registration-guard.js';
+import { validateCurrencyInstructions } from '../internal/planning/currency-cache-guard.js';
+import { isFactionTradeGuard, isTradeBuyGuard, isTradeMeterGuard, } from '../internal/planning/faction-trade-guards.js';
+import { validateFleetAttackInstructions } from '../internal/planning/fleet-attack-xp.js';
+import { validateCrewTransferInstructions } from '../internal/planning/fleet-crew-guard.js';
+import { validateFleetDockFundingGuards } from '../internal/planning/fleet-dock-funding-guard.js';
+import { validateFleetDockingGuards } from '../internal/planning/fleet-docking-guard.js';
+import { validateLocalMarketOrderInstructions } from '../internal/planning/local-market-order.js';
+import { validateMiningStopInstructions } from '../internal/planning/mining-stop.js';
+import { validateMovementXpInstructions } from '../internal/planning/movement-xp-guard.js';
+import { validateOpenSignalInstructions } from '../internal/planning/open-signal-guard.js';
+import { validateRespawnInstructions } from '../internal/planning/respawn-guards.js';
+import { validateRuntimeInstructions } from '../internal/planning/runtime-guards.js';
+import { validateCompletionInstructions } from '../internal/planning/scan-completion-guard.js';
+import { validateDetectInstructions } from '../internal/planning/scan-detect-guard.js';
+import { validateStarbaseSystemGuards, validateStarbaseSystemInstructions, } from '../internal/planning/starbase-system-guard.js';
+import { validatePlanComposition } from './composition.js';
+function validateShipImportFundingComposition(guards) {
+    const targets = new Map();
+    for (const guard of guards) {
+        if (guard.kind !== 'ship-import-funding')
+            continue;
+        const identity = `${guard.game}:${guard.profile}:${guard.system}:${String(guard.shipId)}`;
+        const previous = targets.get(guard.address);
+        if (previous !== undefined && previous !== identity)
+            throw new SageSdkError('INCOMPATIBLE_PLAN_COMPOSITION', 'Ship imports retain conflicting identities or different configurations for one StarbasePlayer. Use separate confirmed imports, then refresh inventory and replan; prefunding cannot be shared across independently estimated storage growth.');
+        targets.set(guard.address, identity);
+    }
+}
+function validateFactionGuardComposition(guards) {
+    const retained = new Map();
+    for (const guard of guards) {
+        if (!isFactionTradeGuard(guard))
+            continue;
+        const constraints = [
+            [
+                `${isTradeMeterGuard(guard) ? 'meter' : 'treasury'}:${guard.address}:identity`,
+                `${guard.game}:${String(guard.factionId)}`,
+            ],
+        ];
+        if (!isTradeMeterGuard(guard)) {
+            constraints.push(isTradeBuyGuard(guard)
+                ? [
+                    `${guard.address}:buy:${String(guard.cargoId)}`,
+                    String(guard.floorRaw),
+                ]
+                : [
+                    `${guard.address}:sell`,
+                    `${String(guard.atlasOutCapPerEpochRaw)}:${String(guard.epochLengthSeconds)}`,
+                ]);
+        }
+        constraints.push([`${guard.address}:schema`, String(guard.schemaVersion)]);
+        for (const [key, value] of constraints) {
+            const previous = retained.get(key);
+            if (previous !== undefined && previous !== value)
+                throw new SageSdkError('INCOMPATIBLE_PLAN_COMPOSITION', 'Faction Market Plans retain incompatible Treasury policy or shared account identity. Refresh the affected Markets and prepare compatible Plans, or use separate confirmed transactions.');
+            retained.set(key, value);
+        }
+    }
+}
+/** Guard bindings public `createPlan` checks for every Plan it creates (D085).
+ * Capability planners build through `buildPlannerPlan` instead and rely on the
+ * canonical list at combination and assembly.
+ */
+export function validateCreationBindings(steps, guards) {
+    validateCurrencyInstructions(steps, guards);
+    validateShipImportFundingComposition(guards);
+    validateStarbaseSystemGuards(steps, guards);
+    validateFleetDockingGuards(steps, guards);
+    validateFleetDockFundingGuards(steps, guards);
+    validateDetectInstructions(steps, guards);
+    validateCompletionInstructions(steps, guards);
+    validateRespawnInstructions(steps, guards);
+    validateCrewTransferInstructions(steps, guards);
+    validateOpenSignalInstructions(steps, guards);
+    validateLocalMarketOrderInstructions(steps, guards);
+}
+/** Bindings checked once when a saved Plan is hydrated: every creation check
+ * plus the exact instruction bytes and XP bindings of complete Plans.
+ */
+export function validateHydrationBindings(steps, guards) {
+    validateCurrencyInstructions(steps, guards);
+    validateShipImportFundingComposition(guards);
+    // Includes validateStarbaseSystemGuards.
+    validateStarbaseSystemInstructions(steps, guards);
+    validateFleetDockingGuards(steps, guards);
+    validateFleetDockFundingGuards(steps, guards);
+    validateDetectInstructions(steps, guards);
+    validateCompletionInstructions(steps, guards);
+    validateRespawnInstructions(steps, guards);
+    validateCrewTransferInstructions(steps, guards);
+    validateOpenSignalInstructions(steps, guards);
+    validateLocalMarketOrderInstructions(steps, guards);
+    validateMovementXpInstructions(steps, guards);
+    validateFleetAttackInstructions(steps, guards);
+    validateCharacterRegistrationInstructions(steps, guards);
+}
+/** The canonical bindings, checked once each when Plans are combined or
+ * assembled for simulation and signing: every hydration check plus
+ * composition, arrival, runtime and mining-stop bindings. Order follows the
+ * established assembly order; checks new to assembly precede instruction checks.
+ */
+export function validatePlanBindings(steps, guards) {
+    validateLocalMarketOrderInstructions(steps, guards);
+    validatePlanComposition(steps);
+    validateFactionGuardComposition(guards);
+    validateShipImportFundingComposition(guards);
+    validateDetectInstructions(steps, guards);
+    validateCompletionInstructions(steps, guards);
+    validateCrewTransferInstructions(steps, guards);
+    validateOpenSignalInstructions(steps, guards);
+    validateFleetDockingGuards(steps, guards);
+    validateFleetDockFundingGuards(steps, guards);
+    // Includes validateStarbaseSystemGuards.
+    validateStarbaseSystemInstructions(steps, guards);
+    validateCharacterRegistrationInstructions(steps, guards);
+    // Includes validateCurrencyInstructions.
+    validateRuntimeInstructions(steps, guards);
+    validateFleetAttackInstructions(steps, guards);
+    validateArrivalInstructions(steps, guards);
+    validateRespawnInstructions(steps, guards);
+    validateMovementXpInstructions(steps, guards);
+    validateMiningStopInstructions(steps, guards);
+}
+//# sourceMappingURL=plan-validation.js.map

package/dist/planning/plan-validation.js.map

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

package/dist/planning/simulation.d.ts

@@ -2,6 +2,21 @@ import { type Address } from '@solana/kit';
 import type { SageContext } from '../client/contracts.js';
 import type { Plan } from './index.js';
 import { type AssemblyPolicy } from './assembly.js';
+/** Optional RPC constraints for one unsigned simulation, not assembly overrides.
+ *
+ * The SDK accepts the full u64 range. Kit's default RPC transport only encodes
+ * integers through 9007199254740991; larger floors require a capable custom
+ * transport. Never round or lower a required floor merely to encode it.
+ *
+ * @example
+ * ```ts
+ * const options: SimulationOptions = { minContextSlot: 53_000_000n };
+ * ```
+ */
+export interface SimulationOptions {
+    /** Inclusive node context floor, from zero through the unsigned 64-bit maximum. */
+    readonly minContextSlot?: bigint | undefined;
+}
 /** Return data emitted by the last program to set it during simulation.
  *
  * @example
@@ -36,6 +51,12 @@ export interface SimulationResult {
  *
  * The same assembly policy used for execution produces the unsigned transaction.
  * The node replaces its recent blockhash and verifies no signatures.
+ * Optional minContextSlot constrains only this simulation RPC. An unavailable
+ * floor rejects once without retry or fallback. The returned slot remains the
+ * node's value; callers may separately enforce a defensive returned-slot check
+ * on successful results only. Simulation failures do not expose a context slot.
+ * The SDK accepts full-u64 floors, but Kit's default transport encodes only
+ * through 9007199254740991; larger floors need a capable custom transport.
  *
  * @example
  * ```ts
@@ -44,7 +65,10 @@ export interface SimulationResult {
  * declare const feePayer: Address;
  * const result = await simulatePlan(ctx, plan, { feePayer });
  * console.log(result.logs, result.unitsConsumed);
+ * const minimum = 53_000_000n;
+ * const fresh = await simulatePlan(ctx, plan, { feePayer }, { minContextSlot: minimum });
+ * if (fresh.slot < minimum) throw new Error('Simulation returned an older context.');
  * ```
  */
-export declare function simulatePlan(context: SageContext, plan: Plan, policy: AssemblyPolicy): Promise<SimulationResult>;
+export declare function simulatePlan(context: SageContext, plan: Plan, policy: AssemblyPolicy, options?: SimulationOptions): Promise<SimulationResult>;
 //# sourceMappingURL=simulation.d.ts.map

package/dist/planning/simulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simulation.d.ts","sourceRoot":"","sources":["../../src/planning/simulation.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EAEb,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAEL,KAAK,cAAc,EAKpB,MAAM,eAAe,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,EAAE,QAAQ,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC;QAClB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC,CAAC;CACJ;AAsBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAgD3B"}
+{"version":3,"file":"simulation.d.ts","sourceRoot":"","sources":["../../src/planning/simulation.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EAEb,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAM1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAEL,KAAK,cAAc,EAKpB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9C;AAgHD;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,EAAE,QAAQ,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC;QAClB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC,CAAC;CACJ;AAsBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAmE3B"}

package/dist/planning/simulation.js

@@ -1,6 +1,84 @@
-import { getBase64EncodedWireTransaction, } from '@solana/kit';
-import { SageSdkError } from '../client/errors.js';
+import { getBase64EncodedWireTransaction, SOLANA_ERROR__RPC__INTEGER_OVERFLOW, } from '@solana/kit';
+import { InvalidActionInputError, ProviderError, SageSdkError, } from '../client/errors.js';
 import { assembleValidatedPlan, requireWriteRpc, validateAssemblyPolicy, validatePlanAssemblyPolicy, validatePlan, } from './assembly.js';
+function validateSimulationOptions(options) {
+    if (options === undefined)
+        return undefined;
+    let minContextSlot;
+    try {
+        if (options === null ||
+            typeof options !== 'object' ||
+            Array.isArray(options) ||
+            (Object.getPrototypeOf(options) !== Object.prototype &&
+                Object.getPrototypeOf(options) !== null) ||
+            Reflect.ownKeys(options).some((key) => key !== 'minContextSlot')) {
+            throw new Error();
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(options, 'minContextSlot');
+        if (descriptor !== undefined && !('value' in descriptor)) {
+            throw new Error();
+        }
+        minContextSlot = descriptor?.value;
+    }
+    catch {
+        // Reflection can invoke Proxy traps; never retain their errors or read accessors.
+        throw new InvalidActionInputError('options', undefined, 'an object containing only minContextSlot as a data property', 'Pass only the optional bigint simulation slot floor; keep assembly policy in the third argument.');
+    }
+    if (minContextSlot !== undefined &&
+        (typeof minContextSlot !== 'bigint' ||
+            minContextSlot < 0n ||
+            minContextSlot > 18446744073709551615n)) {
+        throw new InvalidActionInputError('minContextSlot', typeof minContextSlot === 'bigint' || typeof minContextSlot === 'number'
+            ? minContextSlot
+            : typeof minContextSlot, 'a bigint from 0 through 18446744073709551615', 'Pass an exact unsigned 64-bit bigint slot floor before retrying simulation.');
+    }
+    return minContextSlot;
+}
+// Check only the misplaced field, not an exact set of shared policy keys.
+function rejectMisplacedSlot(policy) {
+    let misplaced;
+    try {
+        misplaced =
+            policy !== null &&
+                typeof policy === 'object' &&
+                Reflect.has(policy, 'minContextSlot');
+    }
+    catch {
+        // Hostile Proxy traps must not escape or retain their contents.
+        misplaced = true;
+    }
+    if (misplaced) {
+        throw new InvalidActionInputError('policy.minContextSlot', undefined, 'minContextSlot in the simulation options, not the assembly policy', 'Pass { minContextSlot } as the fourth argument to simulatePlan.');
+    }
+}
+function isLocalIntegerEncodingFailure(error, minContextSlot) {
+    if (minContextSlot === undefined ||
+        minContextSlot <= BigInt(Number.MAX_SAFE_INTEGER))
+        return false;
+    try {
+        // Do not use property reads or Kit's guard: both can invoke error getters.
+        if (Object.getOwnPropertyDescriptor(error, 'name')?.value !== 'SolanaError')
+            return false;
+        const context = Object.getOwnPropertyDescriptor(error, 'context')?.value;
+        if (Object.getOwnPropertyDescriptor(context, '__code')?.value !==
+            SOLANA_ERROR__RPC__INTEGER_OVERFLOW ||
+            Object.getOwnPropertyDescriptor(context, 'methodName')?.value !==
+                'simulateTransaction' ||
+            Object.getOwnPropertyDescriptor(context, 'path')?.value !==
+                'minContextSlot' ||
+            Object.getOwnPropertyDescriptor(context, 'value')?.value !==
+                minContextSlot)
+            return false;
+        const keyPath = Object.getOwnPropertyDescriptor(context, 'keyPath')?.value;
+        return (Array.isArray(keyPath) &&
+            Object.getOwnPropertyDescriptor(keyPath, 'length').value === 2 &&
+            Object.getOwnPropertyDescriptor(keyPath, '0')?.value === 1 &&
+            Object.getOwnPropertyDescriptor(keyPath, '1')?.value === 'minContextSlot');
+    }
+    catch {
+        return false;
+    }
+}
 class SimulationFailedError extends SageSdkError {
     transactionError;
     logs;
@@ -17,6 +95,12 @@ class SimulationFailedError extends SageSdkError {
  *
  * The same assembly policy used for execution produces the unsigned transaction.
  * The node replaces its recent blockhash and verifies no signatures.
+ * Optional minContextSlot constrains only this simulation RPC. An unavailable
+ * floor rejects once without retry or fallback. The returned slot remains the
+ * node's value; callers may separately enforce a defensive returned-slot check
+ * on successful results only. Simulation failures do not expose a context slot.
+ * The SDK accepts full-u64 floors, but Kit's default transport encodes only
+ * through 9007199254740991; larger floors need a capable custom transport.
  *
  * @example
  * ```ts
@@ -25,22 +109,38 @@ class SimulationFailedError extends SageSdkError {
  * declare const feePayer: Address;
  * const result = await simulatePlan(ctx, plan, { feePayer });
  * console.log(result.logs, result.unitsConsumed);
+ * const minimum = 53_000_000n;
+ * const fresh = await simulatePlan(ctx, plan, { feePayer }, { minContextSlot: minimum });
+ * if (fresh.slot < minimum) throw new Error('Simulation returned an older context.');
  * ```
  */
-export async function simulatePlan(context, plan, policy) {
+export async function simulatePlan(context, plan, policy, options) {
     validatePlan(plan);
+    rejectMisplacedSlot(policy);
     const validatedPolicy = validateAssemblyPolicy(policy);
     validatePlanAssemblyPolicy(plan, validatedPolicy);
+    const minContextSlot = validateSimulationOptions(options);
     const writeRpc = requireWriteRpc(context);
     const transaction = await assembleValidatedPlan(writeRpc, plan, validatedPolicy);
-    const response = await writeRpc
-        .simulateTransaction(getBase64EncodedWireTransaction(transaction), {
-        commitment: validatedPolicy.commitment,
-        encoding: 'base64',
-        replaceRecentBlockhash: true,
-        sigVerify: false,
-    })
-        .send();
+    const encodedTransaction = getBase64EncodedWireTransaction(transaction);
+    let response;
+    try {
+        response = await writeRpc
+            .simulateTransaction(encodedTransaction, {
+            commitment: validatedPolicy.commitment,
+            encoding: 'base64',
+            replaceRecentBlockhash: true,
+            sigVerify: false,
+            ...(minContextSlot === undefined ? {} : { minContextSlot }),
+        })
+            .send();
+    }
+    catch (error) {
+        if (isLocalIntegerEncodingFailure(error, minContextSlot)) {
+            throw new InvalidActionInputError('minContextSlot', minContextSlot, 'an exact slot floor supported by the configured RPC transport', 'The local Kit transport cannot encode this integer. Its default limit is 9007199254740991; use a capable custom transport for larger u64 floors, or correct an unintended input. Do not round or lower a required floor.');
+        }
+        throw new ProviderError('The unsigned Plan simulation provider could not satisfy the request. Check provider availability and any minimum context slot, then explicitly retry when the node can serve that context.');
+    }
     const logs = Object.freeze([...(response.value.logs ?? [])]);
     const unitsConsumed = response.value.unitsConsumed === undefined
         ? undefined

package/dist/planning/simulation.js.map

@@ -1 +1 @@
-{"version":3,"file":"simulation.js","sourceRoot":"","sources":["../../src/planning/simulation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,GAGhC,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EACL,qBAAqB,EAErB,eAAe,EACf,sBAAsB,EACtB,0BAA0B,EAC1B,YAAY,GACb,MAAM,eAAe,CAAC;AAkCvB,MAAM,qBAAsB,SAAQ,YAAY;IACrC,gBAAgB,CAAmB;IACnC,IAAI,CAAoB;IACxB,aAAa,CAAU;IAEhC,YACE,gBAAkC,EAClC,IAAuB,EACvB,aAAiC;QAEjC,KAAK,CACH,mBAAmB,EACnB,+JAA+J,CAChK,CAAC;QACF,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,aAAa,KAAK,SAAS;YAAE,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACtE,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAoB,EACpB,IAAU,EACV,MAAsB;IAEtB,YAAY,CAAC,IAAI,CAAC,CAAC;IACnB,MAAM,eAAe,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACvD,0BAA0B,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,MAAM,qBAAqB,CAC7C,QAAQ,EACR,IAAI,EACJ,eAAe,CAChB,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,QAAQ;SAC5B,mBAAmB,CAAC,+BAA+B,CAAC,WAAW,CAAC,EAAE;QACjE,UAAU,EAAE,eAAe,CAAC,UAAU;QACtC,QAAQ,EAAE,QAAQ;QAClB,sBAAsB,EAAE,IAAI;QAC5B,SAAS,EAAE,KAAK;KACjB,CAAC;SACD,IAAI,EAAE,CAAC;IACV,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,aAAa,GACjB,QAAQ,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS;QACxC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAE3C,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC;YAClC,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,SAAS;YACxD,oBAAoB,EAAE,MAAM,CAC1B,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,oBAAoB,CACzD;SACF,CAAC;QACF,GAAG,CAAC,UAAU,KAAK,IAAI;YACrB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;oBACxB,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;oBACxB,cAAc,EAAE,UAAU,CAAC,SAAS;iBACrC,CAAC;aACH,CAAC;QACN,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;QACnC,aAAa;KACd,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"simulation.js","sourceRoot":"","sources":["../../src/planning/simulation.ts"],"names":[],"mappings":"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"}

package/dist/registry/cargo.d.ts

@@ -1,5 +1,5 @@
 import type { RawAccount, SageContext } from '../client/contracts.js';
-import { type GameCargoDefinitionsSectionData } from '../internal/c4/game.js';
+import { type GameCargoDefinitionsSectionData, type GameDecodeScope } from '../internal/c4/game.js';
 /** One fresh registry-owned cargo section and its exact source bytes. */
 export interface FreshGameCargoDefinitions {
     readonly account: RawAccount;
@@ -7,19 +7,14 @@ export interface FreshGameCargoDefinitions {
 }
 /** Reads and decodes the configured Game cargo section without consulting its cache. */
 export declare function readFreshGameCargoDefinitions(context: SageContext): Promise<FreshGameCargoDefinitions | undefined>;
-/** Resolves one wallet cargo and its configured cache from one fresh registry-owned Game read. */
-export declare function readFreshGameCargoConfiguration(context: SageContext, cargoId: number): Promise<Readonly<{
+/** Wallet Plans hash the full decoded row's pinned encoding and cache identity. */
+export declare function readFreshGameCargoBytesConfiguration(context: SageContext, cargoId: number): Promise<Readonly<{
+    configHash: string;
     rawAccount: RawAccount;
-    cargo: import("../internal/c4/game.js").GameCargoDefinitionData & {
-        readonly withdrawEpochDuration: number;
-        readonly xpModifier: number;
-        readonly flags: number;
-        readonly circuitBreaker: bigint;
-    };
+    cargo: import("@staratlas/dev-sage").CargoType;
     cache: import("../client/contracts.js").Address;
     sequenceId: number;
-    configHash: string;
 }>>;
-/** Validates one fresh Game once, hashing only requested cargo definitions and their configured cache. */
-export declare function hashGameCargoConfigurations(account: RawAccount, cargoIds: readonly number[]): Promise<ReadonlyMap<number, string>>;
+/** One validated decode per Game supplies selected digests, local to this check. */
+export declare function hashGameCargoConfigurationGuards(account: RawAccount, cargoIds: readonly number[], scope?: GameDecodeScope): Promise<ReadonlyMap<number, string>>;
 //# sourceMappingURL=cargo.d.ts.map

package/dist/registry/cargo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cargo.d.ts","sourceRoot":"","sources":["../../src/registry/cargo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,wBAAwB,CAAC;AAIhC,yEAAyE;AACzE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;CAChD;AAED,wFAAwF;AACxF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAQhD;AAED,kGAAkG;AAClG,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM;;;;;;;;;;;IA+BhB;AAED,0GAA0G;AAC1G,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAUtC"}
+{"version":3,"file":"cargo.d.ts","sourceRoot":"","sources":["../../src/registry/cargo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAGL,KAAK,+BAA+B,EACpC,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAIhC,yEAAyE;AACzE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;CAChD;AAED,wFAAwF;AACxF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAQhD;AAmCD,mFAAmF;AACnF,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM;;;;;;IAUhB;AAED,oFAAoF;AACpF,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,KAAK,CAAC,EAAE,eAAe,GACtB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAatC"}

package/dist/registry/cargo.js

@@ -1,5 +1,6 @@
+import { hashCargoBytesConfiguration } from '../internal/c4/cargo-bytes-config.js';
 import { readContextRawAccounts } from '../client/reconciliation.js';
-import { decodeGameCargoConfiguration, decodeGameRegistrySections, } from '../internal/c4/game.js';
+import { decodeGameCargoConfigurationRows, decodeGameRegistrySections, } from '../internal/c4/game.js';
 import { requireGameAddress } from '../internal/game-context.js';
 import { InvalidActionInputError } from '../client/errors.js';
 /** Reads and decodes the configured Game cargo section without consulting its cache. */
@@ -14,14 +15,14 @@ export async function readFreshGameCargoDefinitions(context) {
     });
 }
 /** Resolves one wallet cargo and its configured cache from one fresh registry-owned Game read. */
-export async function readFreshGameCargoConfiguration(context, cargoId) {
+async function readFreshSelectedCargoConfiguration(context, cargoId) {
     const game = requireGameAddress(context);
     const [rawAccount] = await readContextRawAccounts(context, [game]);
     if (rawAccount === undefined) {
         throw new InvalidActionInputError('game', game, 'an existing Game in the configured deployment', 'Verify the deployment and refresh its Game before transferring wallet cargo.');
     }
-    const data = decodeGameCargoConfiguration(rawAccount);
-    const cargo = data.definitions.find((definition) => definition.id === cargoId);
+    const data = decodeGameCargoConfigurationRows(rawAccount);
+    const cargo = data.rows.find((definition) => definition.id === cargoId);
     if (cargo === undefined) {
         throw new InvalidActionInputError('cargoId', cargoId, 'a cargo ID defined in the configured Game', 'Select a cargo ID from this deployment before transferring wallet cargo.');
     }
@@ -30,27 +31,26 @@ export async function readFreshGameCargoConfiguration(context, cargoId) {
         cargo,
         cache: data.cache,
         sequenceId: data.sequenceId,
-        configHash: await hashSelectedCargo(data.cache, cargo),
     });
 }
-/** Validates one fresh Game once, hashing only requested cargo definitions and their configured cache. */
-export async function hashGameCargoConfigurations(account, cargoIds) {
-    const data = decodeGameCargoConfiguration(account);
+/** Wallet Plans hash the full decoded row's pinned encoding and cache identity. */
+export async function readFreshGameCargoBytesConfiguration(context, cargoId) {
+    const selected = await readFreshSelectedCargoConfiguration(context, cargoId);
+    return Object.freeze({
+        ...selected,
+        configHash: await hashCargoBytesConfiguration(selected.cache, selected.cargo),
+    });
+}
+/** One validated decode per Game supplies selected digests, local to this check. */
+export async function hashGameCargoConfigurationGuards(account, cargoIds, scope) {
+    const data = decodeGameCargoConfigurationRows(account, scope);
     const selected = new Set(cargoIds);
     const hashes = new Map();
-    for (const cargo of data.definitions) {
+    for (const cargo of data.rows) {
         if (selected.has(cargo.id))
-            hashes.set(cargo.id, await hashSelectedCargo(data.cache, cargo));
+            hashes.set(cargo.id, await hashCargoBytesConfiguration(data.cache, cargo));
     }
-    // Missing selected IDs deliberately have no hash and fail their own guard.
+    // Missing IDs deliberately have no digest, so their corresponding guard fails.
     return hashes;
 }
-async function hashSelectedCargo(cache, cargo) {
-    const bytes = new TextEncoder().encode(JSON.stringify({ cache, cargo }, (_, value) => typeof value === 'bigint' ? value.toString() : value));
-    return [
-        ...new Uint8Array(await globalThis.crypto.subtle.digest('SHA-256', bytes)),
-    ]
-        .map((value) => value.toString(16).padStart(2, '0'))
-        .join('');
-}
 //# sourceMappingURL=cargo.js.map

package/dist/registry/cargo.js.map

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

package/dist/registry/docking.d.ts

@@ -0,0 +1,10 @@
+import type { RawAccount } from '../client/contracts.js';
+import { decodeGameDockingSequences, type GameDecodeScope } from '../internal/c4/game.js';
+export type DockingSequences = ReturnType<typeof decodeGameDockingSequences>;
+/**
+ * Registry boundary for docking generations from a fresh batch row. Callers own
+ * the read so planning and execution can batch the Game with other inputs; an
+ * absent or executable row yields no sequences, and layout drift throws.
+ */
+export declare function decodeDockingSequences(raw: RawAccount | undefined, scope?: GameDecodeScope): DockingSequences | undefined;
+//# sourceMappingURL=docking.d.ts.map

package/dist/registry/docking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docking.d.ts","sourceRoot":"","sources":["../../src/registry/docking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,0BAA0B,EAC1B,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE7E;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,UAAU,GAAG,SAAS,EAC3B,KAAK,CAAC,EAAE,eAAe,GACtB,gBAAgB,GAAG,SAAS,CAG9B"}

package/dist/registry/docking.js

@@ -0,0 +1,12 @@
+import { decodeGameDockingSequences, } from '../internal/c4/game.js';
+/**
+ * Registry boundary for docking generations from a fresh batch row. Callers own
+ * the read so planning and execution can batch the Game with other inputs; an
+ * absent or executable row yields no sequences, and layout drift throws.
+ */
+export function decodeDockingSequences(raw, scope) {
+    if (!raw || raw.executable)
+        return undefined;
+    return decodeGameDockingSequences(raw, scope);
+}
+//# sourceMappingURL=docking.js.map

package/dist/registry/docking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docking.js","sourceRoot":"","sources":["../../src/registry/docking.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,GAE3B,MAAM,wBAAwB,CAAC;AAIhC;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAA2B,EAC3B,KAAuB;IAEvB,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,0BAA0B,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/dist/registry/index.d.ts

@@ -48,6 +48,10 @@ export interface CargoDefinitionSummary {
     readonly id: number;
     readonly mint: Address;
     readonly name: string;
+    /** Encoded storage cost with 8 fractional bits: 256 means one whole storage unit.
+     * For a nonnegative bigint quantity, use `(quantity * BigInt(storageCost) + 255n) / 256n`.
+     * Round each transfer row up before summing; Fleet capacities and pod usage are whole units.
+     */
     readonly storageCost: number;
 }
 /** Serializable cold-start snapshot for one Game definitions section.