@aephia/atlas-kit 0.6.0-next.17 → 0.6.0-next.171

package/dist/markets/index.js

@@ -1,9 +1,9 @@
-import { AccountDecodeError } from '../client/errors.js';
+import { AccountDecodeError, InvalidDerivationInputError, } from '../client/errors.js';
 import { entityRef } from '../client/refs.js';
 import { deriveFactionMarketAddress as deriveFactionMarketAddressInternal, deriveLocalMarketAddress as deriveLocalMarketAddressInternal, discoverLocalMarketsBySystem, factionMarketAccountDefinition, localMarketAccountDefinition, } from '../internal/c4/market.js';
 import { requireGameAddress } from '../internal/game-context.js';
 import { attachJsonSerialization } from '../internal/json.js';
-import { attachReadMeta, readMeta } from '../internal/read-meta.js';
+import { attachReadMeta, envelopeMeta, readMeta, } from '../internal/read-meta.js';
 import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
 import { resolveCargo, } from '../registry/index.js';
 /** Derives a Local Market PDA from its verified generated seeds.
@@ -27,19 +27,58 @@ export function deriveLocalMarketAddress(system, cargoId, starbaseSequenceId) {
 export function deriveFactionMarketAddress(game, system, starbaseSequenceId) {
     return deriveFactionMarketAddressInternal(game, system, starbaseSequenceId);
 }
-function directMetadata(envelope) {
-    return {
-        commitment: envelope.commitment,
-        slot: envelope.slot,
-        source: envelope.source,
-        strategy: 'direct',
-    };
+const MAX_U64 = 18446744073709551615n;
+function invalidMakerAssetValue(value) {
+    if (typeof value === 'number' ||
+        typeof value === 'bigint' ||
+        typeof value === 'string') {
+        return value;
+    }
+    if (value === undefined)
+        return 'missing';
+    if (value === null)
+        return 'null';
+    return `a value of type ${typeof value}`;
+}
+function requireMakerAssetAmount(field, value) {
+    if (typeof value !== 'bigint' || value < 0n || value > MAX_U64) {
+        throw new InvalidDerivationInputError(field, invalidMakerAssetValue(value), `Use the observed maker-row bigint from 0 through ${String(MAX_U64)}.`);
+    }
+    return value;
+}
+/** Projects one observed maker row into side-aware locked principal and released proceeds.
+ *
+ * The helper performs no network or signing work and does not infer fill state,
+ * fees, refunds, freshness, or whether released assets can be withdrawn.
+ *
+ * @example
+ * ```ts
+ * declare const maker: LocalMarketMakerStateSnapshot;
+ * const assets = deriveLocalMarketMakerAssets('bid', maker);
+ * console.log(assets.lockedAtlasRaw, assets.releasedCargoRaw);
+ * ```
+ */
+export function deriveLocalMarketMakerAssets(side, maker) {
+    if (side !== 'bid' && side !== 'ask') {
+        throw new InvalidDerivationInputError('Local Market maker side', invalidMakerAssetValue(side), 'Use the observed order-book side "bid" or "ask".');
+    }
+    if (maker === null || typeof maker !== 'object') {
+        throw new InvalidDerivationInputError('Local Market maker row', invalidMakerAssetValue(maker), 'Supply an observed maker row containing cargoRaw and escrowedOrReleasedAtlasRaw.');
+    }
+    const atlasRaw = requireMakerAssetAmount('Local Market maker escrowedOrReleasedAtlasRaw', maker.escrowedOrReleasedAtlasRaw);
+    const cargoRaw = requireMakerAssetAmount('Local Market maker cargoRaw', maker.cargoRaw);
+    return Object.freeze(attachJsonSerialization({
+        lockedAtlasRaw: side === 'bid' ? atlasRaw : 0n,
+        lockedCargoRaw: side === 'ask' ? cargoRaw : 0n,
+        releasedAtlasRaw: side === 'ask' ? atlasRaw : 0n,
+        releasedCargoRaw: side === 'bid' ? cargoRaw : 0n,
+    }));
 }
 function order(value) {
-    return { ...value, makerRef: entityRef('character', value.maker) };
+    return { ...value, makerRef: entityRef('profile', value.maker) };
 }
 function makerState(value) {
-    return { ...value, characterRef: entityRef('character', value.character) };
+    return { ...value, profileRef: entityRef('profile', value.profile) };
 }
 function book(value) {
     return {
@@ -68,7 +107,7 @@ async function createLocalSnapshot(context, envelope) {
         initializerProfile: entityRef('profile', initializerProfile),
         kind: 'localMarket',
         system: entityRef('starSystem', system),
-    }), directMetadata(envelope)));
+    }), envelopeMeta(envelope, 'direct')));
 }
 function toLocalSnapshot(context, envelope) {
     const existing = LOCAL_SNAPSHOTS.get(envelope);
@@ -100,7 +139,7 @@ async function createFactionSnapshot(context, envelope) {
         kind: 'factionMarket',
         offers: resolvedOffers,
         system: entityRef('starSystem', system),
-    }), directMetadata(envelope)));
+    }), envelopeMeta(envelope, 'direct')));
 }
 function toFactionSnapshot(context, envelope) {
     const existing = FACTION_SNAPSHOTS.get(envelope);
@@ -160,7 +199,7 @@ export async function getLocalMarketsBySystem(context, system, options) {
     const meta = readMeta(envelopes);
     return Object.freeze(attachReadMeta(await Promise.all(envelopes.map((envelope) => toLocalSnapshot(context, envelope))), meta));
 }
-/** Returns one Character's open orders with that side's maker state.
+/** Returns one Profile's open orders with that side's maker state.
  *
  * Bid-side ATLAS is escrowed for buy orders. Ask-side ATLAS was released from
  * completed sell orders. Neither interpretation promises withdrawability.
@@ -169,19 +208,19 @@ export async function getLocalMarketsBySystem(context, system, options) {
  * ```ts
  * declare const ctx: SageContext;
  * declare const market: Address;
- * declare const character: Address;
- * const orders = await getLocalMarketOrdersByCharacter(ctx, market, character);
+ * declare const profile: Address;
+ * const orders = await getLocalMarketOrdersByProfile(ctx, market, profile);
  * ```
  */
-export async function getLocalMarketOrdersByCharacter(context, market, character, options) {
+export async function getLocalMarketOrdersByProfile(context, market, profile, options) {
     const snapshot = await getLocalMarket(context, market, options);
     const matches = (side) => {
-        const orders = side.orders.filter((value) => value.maker === character);
+        const orders = side.orders.filter((value) => value.maker === profile);
         if (orders.length === 0)
             return [];
-        const maker = side.makers.find((value) => value.character === character);
+        const maker = side.makers.find((value) => value.profile === profile);
         if (maker === undefined) {
-            throw new AccountDecodeError('market', market, new RangeError('The decoded Local Market contains matching orders without their MakerInfo state entry.'), `Local Market ${market} contains orders for Character ${character} without that Character's maker state entry. Refresh the Market account and verify the provider and installed binding version before retrying.`);
+            throw new AccountDecodeError('market', market, new RangeError('The decoded Local Market contains matching orders without their MakerInfo state entry.'), `Local Market ${market} contains orders for Profile ${profile} without that Profile's maker state entry. Refresh the Market account and verify the provider and installed binding version before retrying.`);
         }
         return orders.map((value) => ({ ...value, makerState: maker }));
     };

package/dist/markets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/markets/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAkB,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EACL,0BAA0B,IAAI,kCAAkC,EAChE,wBAAwB,IAAI,gCAAgC,EAC5D,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,GAK7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EACL,YAAY,GAEb,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAe,EACf,OAAe,EACf,kBAA0B;IAE1B,OAAO,gCAAgC,CAAC,MAAM,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAa,EACb,MAAe,EACf,kBAA0B;IAE1B,OAAO,kCAAkC,CAAC,IAAI,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAC9E,CAAC;AA2GD,SAAS,cAAc,CACrB,QAA6B;IAE7B,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ,EAAE,QAAQ;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,KAA2B;IACxC,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,UAAU,CACjB,KAA2B;IAE3B,OAAO,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,IAAI,CACX,KAAqC;IAErC,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;QACpC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,eAAe,GAAG,IAAI,OAAO,EAGhC,CAAC;AACJ,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAGlC,CAAC;AAEJ,KAAK,UAAU,mBAAmB,CAChC,OAAoB,EACpB,QAAkD;IAElD,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAC7C,QAAQ,CAAC,IAAI,CAAC,MAAM,EACpB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAC3B,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CACjC,CAAC;IACF,IAAI,QAAQ,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,kBAAkB,CAC1B,QAAQ,EACR,QAAQ,CAAC,OAAO,EAChB,IAAI,UAAU,CAAC,sDAAsD,CAAC,EACtE,gBAAgB,QAAQ,CAAC,OAAO,wIAAwI,CACzK,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAC9D,QAAQ,CAAC,IAAI,CAAC;IAChB,OAAO,sBAAsB,CAC3B,cAAc,CACZ,uBAAuB,CAAC;QACtB,GAAG,IAAI;QACP,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;QAChB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;QAChB,KAAK,EAAE;YACL,GAAG,CAAC,MAAM,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/C,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B;QACD,kBAAkB,EAAE,SAAS,CAAC,SAAS,EAAE,kBAAkB,CAAC;QAC5D,IAAI,EAAE,aAAsB;QAC5B,MAAM,EAAE,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;KACxC,CAAC,EACF,cAAc,CAAC,QAAQ,CAAC,CACzB,CACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,OAAoB,EACpB,QAAkD;IAElD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvD,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,OAAoB,EACpB,QAAoD;IAEpD,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,kBAAkB,CAC1B,QAAQ,EACR,QAAQ,CAAC,OAAO,EAChB,IAAI,UAAU,CAAC,qDAAqD,CAAC,EACrE,kBAAkB,QAAQ,CAAC,OAAO,oBAAoB,QAAQ,CAAC,IAAI,CAAC,IAAI,yBAAyB,IAAI,mDAAmD,CACzJ,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAC/C,IAAI,EACJ,QAAQ,CAAC,IAAI,CAAC,MAAM,EACpB,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CACjC,CAAC;IACF,IAAI,QAAQ,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,kBAAkB,CAC1B,QAAQ,EACR,QAAQ,CAAC,OAAO,EAChB,IAAI,UAAU,CAAC,wDAAwD,CAAC,EACxE,kBAAkB,QAAQ,CAAC,OAAO,+IAA+I,CAClL,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC/D,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,CACtC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3C,GAAG,CAAC,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,GAAG,KAAK;KACT,CAAC,CAAC,CACJ,CAAC;IACF,OAAO,sBAAsB,CAC3B,cAAc,CACZ,uBAAuB,CAAC;QACtB,GAAG,IAAI;QACP,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC;QAC7B,IAAI,EAAE,eAAwB;QAC9B,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;KACxC,CAAC,EACF,cAAc,CAAC,QAAQ,CAAC,CACzB,CACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,OAAoB,EACpB,QAAoD;IAEpD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzD,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAoB,EACpB,OAAgB,EAChB,OAAqB;IAErB,OAAO,eAAe,CACpB,OAAO,EACP,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,EAAE,OAAO,EAAE,OAAO,CAAC,CACxE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAoB,EACpB,OAAgB,EAChB,OAAqB;IAErB,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAC5C,4BAA4B,EAC5B,CAAC,OAAO,CAAC,EACT,OAAO,CACR,CAAC;IACF,OAAO,QAAQ,KAAK,SAAS;QAC3B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAoB,EACpB,MAAe,EACf,OAAe,EACf,kBAA0B,EAC1B,OAAqB;IAErB,OAAO,cAAc,CACnB,OAAO,EACP,MAAM,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,kBAAkB,CAAC,EACnE,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAoB,EACpB,MAAe,EACf,OAAgC;IAEhC,MAAM,SAAS,GAAG,MAAM,4BAA4B,CAClD,OAAO,EACP,MAAM,EACN,OAAO,CACR,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAE,CAAC;IAClC,OAAO,MAAM,CAAC,MAAM,CAClB,cAAc,CACZ,MAAM,OAAO,CAAC,GAAG,CACf,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAChE,EACD,IAAI,CACL,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,OAAoB,EACpB,MAAe,EACf,SAAkB,EAClB,OAAqB;IAMrB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,CAAC,IAAkC,EAAE,EAAE;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;QACxE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;QACzE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,kBAAkB,CAC1B,QAAQ,EACR,MAAM,EACN,IAAI,UAAU,CACZ,wFAAwF,CACzF,EACD,gBAAgB,MAAM,kCAAkC,SAAS,gJAAgJ,CAClN,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC;IACF,OAAO,sBAAsB,CAAC;QAC5B,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QACzB,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;KAC1B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAoB,EACpB,OAAgB,EAChB,OAAqB;IAErB,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,iBAAiB,CACtB,OAAO,EACP,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,8BAA8B,EAAE,OAAO,EAAE,OAAO,CAAC,CAC1E,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAoB,EACpB,OAAgB,EAChB,OAAqB;IAErB,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAC5C,8BAA8B,EAC9B,CAAC,OAAO,CAAC,EACT,OAAO,CACR,CAAC;IACF,OAAO,QAAQ,KAAK,SAAS;QAC3B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAoB,EACpB,MAAe,EACf,kBAA0B,EAC1B,OAAqB;IAErB,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,gBAAgB,CACrB,OAAO,EACP,MAAM,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAClE,OAAO,CACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/markets/index.ts"],"names":[],"mappings":"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"}

package/dist/mining/actions/index.d.ts

@@ -2,7 +2,7 @@ import type { Address, SageContext } from '../../client/contracts.js';
 import type { EntityRef } from '../../client/refs.js';
 import type { ResolvedFleetAccountData } from '../../internal/fleet.js';
 import { type PlanAuthorization } from '../../internal/planning/authorization-adapter.js';
-import { type Plan } from '../../planning/index.js';
+import type { Plan } from '../../planning/index.js';
 import type { ResourceDepositSnapshot } from '../index.js';
 export type { PlanAuthorization };
 interface FleetSnapshot extends Omit<ResolvedFleetAccountData, 'ownerProfile'> {
@@ -28,15 +28,15 @@ export interface PlanFleetStartMiningOptions {
 /** Plans one inert Fleet mining start at an Asteroid, without signing or simulation.
  *
  * Idle Fleets use their current coordinate; warp/subwarp Fleets use their arrival
- * coordinate, never a local clock. Moving snapshots support explicit composition
- * with planFleetSettleArrival; this planner emits only the mining instruction and
- * adds neither settlement nor a funder. Direct mining needs Idle: mining-specific
- * PTR evidence rejected an elapsed warp despite its canonical Character account,
- * while explicit settlement followed by mining succeeded. An in-transit subwarp
- * also rejected; elapsed-subwarp mining composition remains unmeasured on chain.
- * These results do not inherit startSubwarp's automatic refresh behavior.
- * Explicitly prepend settlement with a visible funder, or settle and reload the
- * Fleet before planning mining. Idle Fleets do not need that extra step.
+ * coordinate, never a local clock. This planner emits only the mining instruction.
+ * Completed warp can refresh directly into mining; unfinished warp rejects.
+ * Completed subwarp needs explicit settlement first: use planFleetSettleArrival
+ * with Profile authorization, then combinePlans(settlement, mining), or settle
+ * and reload Idle. Unsigned PTR simulations on 2026-10-12 at SAGE deployment
+ * slot 58713616 qualified both routes for adequately fueled, canonical Fleets
+ * with supported XP accounts, not every future deployment. Settlement
+ * can stop short when Fuel is insufficient; confirm the destination and simulate
+ * the complete Plan. No settlement or authority is inserted automatically.
  * Simulate the complete Plan before execution; arrival, permissions, range, fuel,
  * and mining eligibility remain program-authoritative. This planner neither
  * estimates mining output nor stops mining. No FleetCrewBinding account exists
@@ -64,13 +64,16 @@ export interface PlanFleetStopMiningOptions {
 }
 /** Plans one inert stop-mining instruction using the Asteroid in Fleet state.
  *
- * The snapshot must be mining; refresh any non-mining snapshot before retrying.
- * If mining resolves to idle after planning, the generated instruction returns
- * after refresh and validation; an idle Fleet can still fail cargo/upkeep checks.
+ * The snapshot and a fresh canonical Fleet must be mining the same Asteroid.
+ * A finite persisted guard rechecks this state before signing; old unguarded
+ * stop Plans must be recreated. Exit fuel was observed on PTR even for Idle,
+ * so Idle is not a free no-op. The read-to-chain race remains: simulate before
+ * execution; a later state change can still consume fuel or fail upkeep checks.
  * No yield, cargo amount, or execution success is promised. DO_MINING
  * permission remains chain-authoritative. Only validated canonical optional
- * accounts are included; proven absence uses the generated omitted-account
- * sentinel. Planning does not sign, simulate, or submit a transaction.
+ * accounts are included, including the chain-created neutral CrewBinding at
+ * its canonical PDA; proven absence uses the generated omitted-account sentinel.
+ * Planning does not sign, simulate, or submit a transaction.
  *
  * @example
  * ```ts

package/dist/mining/actions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mining/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAEP,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAoBtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAMxE,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,UAAU,aAAc,SAAQ,IAAI,CAAC,wBAAwB,EAAE,cAAc,CAAC;IAC5E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,wFAAwF;IACxF,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAiFD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAiLf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAgFf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mining/actions/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,OAAO,EAEP,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAuBtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAOxE,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAQpD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,UAAU,aAAc,SAAQ,IAAI,CAAC,wBAAwB,EAAE,cAAc,CAAC;IAC5E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,wFAAwF;IACxF,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAwED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CA2Nf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAkJf"}

package/dist/mining/actions/index.js

@@ -1,31 +1,23 @@
+import { resolveXpRuntime } from '../../internal/planning/xp-runtime.js';
+import { matchesFleetMiningState } from '../../internal/planning/mining-stop.js';
+import { requireActionCoordinate } from '../../internal/planning/fleet-state.js';
 import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
 import { readContextRawAccounts } from '../../client/reconciliation.js';
-import { sage } from '../../internal/c4/bindings.js';
+import { getFleetDecoder, getStarSystemDecoder, } from '../../internal/c4/runtime-bindings.js';
 import { deriveFleetAddress, fleetAccountDefinition, } from '../../internal/c4/fleet.js';
-import { characterAccountDefinition, findCharacterPda, } from '../../internal/c4/identity.js';
+import { characterAccountDefinition, findCharacterPda, } from '../../internal/c4/character.js';
 import { deriveRegionTrackerAddress, regionTrackerAccountDefinition, } from '../../internal/c4/factions.js';
 import { celestialBodyAccountDefinition, deriveCelestialBodyAddress, deriveStarSystemAddress, starSystemAccountDefinition, } from '../../internal/c4/world.js';
-import { deriveFleetCrewBindingAddress, fleetCrewBindingAccountDefinition, } from '../../internal/c4/fleet-crew-binding.js';
+import { deriveFleetCrewBindingAddress, fleetCrewBindingAccountDefinition, matchesFleetCrewBindingIdentity, } from '../../internal/c4/fleet-crew-binding.js';
 import { requireGameAddress } from '../../internal/game-context.js';
 import { adaptStartMiningAsteroidInstruction, adaptStopMiningAsteroidInstruction, validatePlanAuthorization, } from '../../internal/planning/authorization-adapter.js';
-import { createPlan } from '../../planning/index.js';
+import { buildPlannerPlan } from '../../planning/plan-construction.js';
+import { planStorageFunding } from '../../internal/planning/storage-actions.js';
+import { readMiningStorageAction, subwarpSettlementAction, } from '../../internal/planning/mining-storage-actions.js';
+import { RENT_ADDRESS } from '../../internal/planning/rent.js';
 function fail(address, message) {
     throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
 }
-const remedies = {
-    docked: 'Undock the Fleet',
-    mining: 'Stop mining with planFleetStopMining',
-    respawn: 'Wait for the Fleet to recover',
-    destroyed: 'Respawn the Fleet through an appropriate game client',
-    claimStakeTransfer: 'Finish the Claim Stake transfer',
-};
-function actionCoordinate(fleet) {
-    if (fleet.state.kind === 'idle')
-        return fleet.location;
-    if (fleet.state.kind === 'warp' || fleet.state.kind === 'subwarp')
-        return fleet.state.to;
-    return fail(fleet.address, `Fleet ${fleet.name} is ${fleet.state.kind} and cannot start mining. ${remedies[fleet.state.kind]}, refresh the Fleet, and retry from idle or a warp/subwarp arrival at the Asteroid's Star System.`);
-}
 function validateOptionsObject(value, field) {
     if (typeof value !== 'object' || value === null || Array.isArray(value)) {
         throw new InvalidActionInputError(field, value, 'an object containing the mining action options or Profile authorization', `Supply ${field} with the documented mining action fields before retrying.`);
@@ -35,6 +27,10 @@ function validateResources(ids, available) {
     if (!Array.isArray(ids) || ids.length === 0) {
         throw new InvalidActionInputError('resourceIds', ids, 'a dense non-empty ascending list of deposit cargo ids', 'Supply at least one resource cargo id from the Asteroid deposit before retrying.');
     }
+    // The game mines at most eight resources per Fleet.
+    if (ids.length > 8) {
+        throw new InvalidActionInputError('resourceIds', ids, 'at most eight deposit cargo ids', 'A Fleet mines at most eight Asteroid resources at once. Select eight or fewer and retry.');
+    }
     for (let i = 0; i < ids.length; i += 1) {
         const id = ids[i];
         if (!Object.hasOwn(ids, i) ||
@@ -56,15 +52,15 @@ function required(account, address, label) {
 /** Plans one inert Fleet mining start at an Asteroid, without signing or simulation.
  *
  * Idle Fleets use their current coordinate; warp/subwarp Fleets use their arrival
- * coordinate, never a local clock. Moving snapshots support explicit composition
- * with planFleetSettleArrival; this planner emits only the mining instruction and
- * adds neither settlement nor a funder. Direct mining needs Idle: mining-specific
- * PTR evidence rejected an elapsed warp despite its canonical Character account,
- * while explicit settlement followed by mining succeeded. An in-transit subwarp
- * also rejected; elapsed-subwarp mining composition remains unmeasured on chain.
- * These results do not inherit startSubwarp's automatic refresh behavior.
- * Explicitly prepend settlement with a visible funder, or settle and reload the
- * Fleet before planning mining. Idle Fleets do not need that extra step.
+ * coordinate, never a local clock. This planner emits only the mining instruction.
+ * Completed warp can refresh directly into mining; unfinished warp rejects.
+ * Completed subwarp needs explicit settlement first: use planFleetSettleArrival
+ * with Profile authorization, then combinePlans(settlement, mining), or settle
+ * and reload Idle. Unsigned PTR simulations on 2026-10-12 at SAGE deployment
+ * slot 58713616 qualified both routes for adequately fueled, canonical Fleets
+ * with supported XP accounts, not every future deployment. Settlement
+ * can stop short when Fuel is insufficient; confirm the destination and simulate
+ * the complete Plan. No settlement or authority is inserted automatically.
  * Simulate the complete Plan before execution; arrival, permissions, range, fuel,
  * and mining eligibility remain program-authoritative. This planner neither
  * estimates mining output nor stops mining. No FleetCrewBinding account exists
@@ -93,8 +89,7 @@ export async function planFleetStartMining(ctx, fleet, options) {
             : { certificate: options.authorization.certificate }),
     };
     validatePlanAuthorization(authorization);
-    const coordinate = actionCoordinate(fleet);
-    const movingSnapshot = fleet.state.kind !== 'idle';
+    const coordinate = requireActionCoordinate(fleet, 'start mining', "it must be idle or arriving by warp or subwarp at the Asteroid's Star System");
     if (fleet.game !== game ||
         asteroid.game !== game ||
         fleet.ownerProfile.address !== authorization.profile) {
@@ -111,6 +106,8 @@ export async function planFleetStartMining(ctx, fleet, options) {
         asteroid.system.address,
         character,
         regionTracker,
+        authorization.profile,
+        RENT_ADDRESS,
     ];
     const values = await readContextRawAccounts(ctx, addresses);
     const labels = [
@@ -119,9 +116,11 @@ export async function planFleetStartMining(ctx, fleet, options) {
         'Star System',
         'Character',
         'RegionTracker',
+        'Profile',
+        'Rent sysvar',
     ];
     const accounts = addresses.map((address, index) => required(values[index], address, labels[index]));
-    const [fleetAccount, asteroidAccount, systemAccount, characterAccount, trackerAccount,] = accounts;
+    const [fleetAccount, asteroidAccount, systemAccount, characterAccount, trackerAccount, profileAccount, rentAccount,] = accounts;
     const current = fleetAccountDefinition.decode(fleetAccount);
     const currentCoordinate = current.state.kind === 'idle'
         ? current.location
@@ -154,13 +153,13 @@ export async function planFleetStartMining(ctx, fleet, options) {
         fail(systemAccount.address, 'Star System does not match its Game or canonical address. Refresh the Asteroid and Star System in the configured Game before retrying.');
     }
     // Compare stored fixed-point coordinates, not rounded display numbers.
-    const exactFleet = sage.getFleetDecoder().decode(fleetAccount.data);
+    const exactFleet = getFleetDecoder().decode(fleetAccount.data);
     const exactCoordinate = exactFleet.state.__kind === 'MoveWarp'
         ? exactFleet.state.fields[0].to
         : exactFleet.state.__kind === 'MoveSubwarp'
             ? exactFleet.state.fields[0].journey.to
             : exactFleet.location;
-    const exactSystem = sage.getStarSystemDecoder().decode(systemAccount.data);
+    const exactSystem = getStarSystemDecoder().decode(systemAccount.data);
     if (exactCoordinate[0].raw !== exactSystem.coordinates[0].raw ||
         exactCoordinate[1].raw !== exactSystem.coordinates[1].raw) {
         fail(asteroid.address, `Asteroid ${asteroid.name} is not in Fleet ${fleet.name}'s current or arrival Star System. Choose a deposit at the Fleet's mining coordinate or move the Fleet there, refresh, and retry.`);
@@ -181,40 +180,66 @@ export async function planFleetStartMining(ctx, fleet, options) {
     })
         .join(', ');
     const describes = `Start mining with Fleet ${fleet.name} at Asteroid ${asteroid.name}: ${resources}.`;
-    const settlementWarning = movingSnapshot
-        ? ' Direct mining needs Idle. Explicitly prepend planFleetSettleArrival with a visible funder, or settle and reload the Fleet before planning mining. Settlement plus mining is verified by unsigned PTR simulation for an elapsed warp only; elapsed-subwarp composition remains unmeasured.'
-        : '';
-    return createPlan({
+    const settlementWarning = fleet.state.kind === 'subwarp'
+        ? ' Completed subwarp needs explicit settlement before mining. Use planFleetSettleArrival with Profile authorization and combinePlans(settlement, mining), or settle and reload Idle. Ensure enough Fuel to reach the Asteroid System; settlement may stop short.'
+        : fleet.state.kind === 'warp'
+            ? ' Completed warp can refresh directly into mining; an unfinished warp still rejects.'
+            : '';
+    const instruction = adaptStartMiningAsteroidInstruction({
+        authorization,
+        fleet: fleet.address,
+        character,
+        starSystem: systemAccount.address,
+        regionTracker,
+        asteroid: asteroid.address,
+        game,
+        resources: resourceIds,
+    });
+    // Mining state grows the Fleet; the program funds that storage from the
+    // Profile vault with the signing key.
+    const storage = (() => {
+        const accounts = new Map([
+            [fleet.address, fleetAccount],
+            [authorization.profile, profileAccount],
+            [RENT_ADDRESS, rentAccount],
+        ]);
+        const action = readMiningStorageAction(instruction, accounts);
+        return planStorageFunding({
+            action,
+            accounts,
+            label: 'mining start',
+            // A subwarp-arrived Fleet is settled first, which returns it to Idle
+            // at its rent minimum before the mining state grows it.
+            preceding: fleet.state.kind === 'subwarp'
+                ? [subwarpSettlementAction(action, fleetAccount)]
+                : [],
+        });
+    })();
+    return buildPlannerPlan({
         kind: 'fleet.start-mining',
-        summary: describes,
+        summary: `${describes} ${storage.disclosure}`,
         steps: [
             {
                 describes: `${describes}${settlementWarning} Simulate before execution; arrival, permissions, range, fuel, and mining eligibility remain chain-authoritative.`,
                 signers: [authorization.authority],
-                instruction: adaptStartMiningAsteroidInstruction({
-                    authorization,
-                    fleet: fleet.address,
-                    character,
-                    starSystem: systemAccount.address,
-                    regionTracker,
-                    asteroid: asteroid.address,
-                    game,
-                    resources: resourceIds,
-                }),
+                instruction,
             },
         ],
-        preconditions: [],
+        preconditions: [storage.guard],
     });
 }
 /** Plans one inert stop-mining instruction using the Asteroid in Fleet state.
  *
- * The snapshot must be mining; refresh any non-mining snapshot before retrying.
- * If mining resolves to idle after planning, the generated instruction returns
- * after refresh and validation; an idle Fleet can still fail cargo/upkeep checks.
+ * The snapshot and a fresh canonical Fleet must be mining the same Asteroid.
+ * A finite persisted guard rechecks this state before signing; old unguarded
+ * stop Plans must be recreated. Exit fuel was observed on PTR even for Idle,
+ * so Idle is not a free no-op. The read-to-chain race remains: simulate before
+ * execution; a later state change can still consume fuel or fail upkeep checks.
  * No yield, cargo amount, or execution success is promised. DO_MINING
  * permission remains chain-authoritative. Only validated canonical optional
- * accounts are included; proven absence uses the generated omitted-account
- * sentinel. Planning does not sign, simulate, or submit a transaction.
+ * accounts are included, including the chain-created neutral CrewBinding at
+ * its canonical PDA; proven absence uses the generated omitted-account sentinel.
+ * Planning does not sign, simulate, or submit a transaction.
  *
  * @example
  * ```ts
@@ -245,20 +270,37 @@ export async function planFleetStopMining(ctx, fleet, options) {
         fail(fleet.address, `Fleet ${fleet.name} must belong to configured Game ${game} and authorized Profile ${authorization.profile}. Choose the owning Profile and matching Game, refresh the Fleet, and retry.`);
     }
     const asteroid = fleet.state.asteroid.address;
+    const intent = {
+        address: fleet.address,
+        game,
+        profile: authorization.profile,
+        asteroid,
+    };
     const [character, crewBinding, regionTracker] = await Promise.all([
         findCharacterPda(authorization.profile, game),
         deriveFleetCrewBindingAddress(fleet.address),
         deriveRegionTrackerAddress(game),
     ]);
-    const [crewAccount, regionAccount] = await readContextRawAccounts(ctx, [
+    const [currentFleet, crewAccount, regionAccount, profileAccount, rentAccount,] = await readContextRawAccounts(ctx, [
+        intent.address,
         crewBinding,
         regionTracker,
+        authorization.profile,
+        RENT_ADDRESS,
     ]);
+    let matches = false;
+    try {
+        matches = await matchesFleetMiningState(currentFleet, intent);
+    }
+    catch {
+        // Adapter errors must not hide the action-level remedy for a saved snapshot.
+    }
+    if (!matches)
+        fail(intent.address, 'The fresh Fleet is unavailable, invalid, or no longer owned by this Profile and mining the selected Asteroid in this Game. Refresh the Fleet and recreate the stop Plan only while it is mining; an idle stop can still consume exit fuel.');
     if (crewAccount !== undefined) {
         const crew = fleetCrewBindingAccountDefinition.decode(crewAccount);
         if (crewAccount.address !== crewBinding ||
-            crew.fleet !== fleet.address ||
-            crew.ownerProfile !== authorization.profile) {
+            !matchesFleetCrewBindingIdentity(crew, fleet.address, authorization.profile)) {
             fail(crewBinding, 'FleetCrewBinding does not match its canonical address, Fleet, or owning Profile. Refresh the Fleet crew registration and retry.');
         }
     }
@@ -268,25 +310,60 @@ export async function planFleetStopMining(ctx, fleet, options) {
             fail(regionTracker, 'RegionTracker does not match its canonical address or configured Game. Refresh world region data for this Game and retry.');
         }
     }
-    return createPlan({
+    const xp = await resolveXpRuntime(ctx, {
+        game,
+        character,
+        profile: options.authorization.profile,
+    });
+    const instruction = adaptStopMiningAsteroidInstruction({
+        ...xp.accounts,
+        authorization,
+        character,
+        fleet: intent.address,
+        game,
+        asteroid,
+        ...(crewAccount === undefined ? {} : { crewBinding }),
+        ...(regionAccount === undefined ? {} : { regionTracker }),
+    });
+    // Leaving mining shrinks the Fleet, but each mined resource can land a new
+    // cargo-hold line; the program funds any net growth from the Profile vault.
+    const storage = (() => {
+        const accounts = new Map([
+            [intent.address, currentFleet],
+            [authorization.profile, profileAccount],
+            [RENT_ADDRESS, rentAccount],
+        ]);
+        return planStorageFunding({
+            action: readMiningStorageAction(instruction, accounts),
+            accounts,
+            label: 'mining stop',
+        });
+    })();
+    return buildPlannerPlan({
         kind: 'fleet.stop-mining',
-        summary: `Stop mining for Fleet ${fleet.name}.`,
+        summary: `Stop mining for Fleet ${fleet.name}. ${storage.disclosure}`,
         steps: [
             {
-                describes: `Stop mining for Fleet ${fleet.name} at Asteroid ${asteroid}, returning it to idle; already idle Fleets are refreshed and can fail cargo/upkeep checks. Simulate before execution; permission and mining results remain chain-authoritative.`,
+                describes: `Stop mining for Fleet ${fleet.name} at Asteroid ${asteroid}, returning it to idle. Fresh mining state is checked before signing; exit fuel can still be consumed, including if the Fleet becomes idle in the read-to-chain race. Simulate before execution; permission and mining results remain chain-authoritative.`,
                 signers: [authorization.authority],
-                instruction: adaptStopMiningAsteroidInstruction({
-                    authorization,
-                    character,
-                    fleet: fleet.address,
-                    game,
-                    asteroid,
-                    ...(crewAccount === undefined ? {} : { crewBinding }),
-                    ...(regionAccount === undefined ? {} : { regionTracker }),
-                }),
+                instruction,
+            },
+        ],
+        preconditions: [
+            storage.guard,
+            {
+                kind: 'xp-runtime',
+                address: game,
+                intent: xp.intent,
+                accounts: xp.accounts,
+                describes: 'The configured Game and canonical Character XP accounts remain eligible for mining settlement.',
+            },
+            {
+                kind: 'fleet-mining',
+                ...intent,
+                describes: 'The canonical Fleet remains owned by the authorized Profile and mining the planned Asteroid in the configured Game.',
             },
         ],
-        preconditions: [],
     });
 }
 //# sourceMappingURL=index.js.map