@aephia/atlas-kit 0.6.0-next.3 → 0.6.0-next.31

package/dist/markets/actions/trade-faction-market.js

@@ -0,0 +1,288 @@
+import { deriveTradeEpochMeterAddress } from '../../internal/c4/faction-epoch-meter.js';
+import { readTradeTreasury, validateTradeEpochMeter, } from '../../internal/planning/faction-trade-state.js';
+import { adaptTradeFactionMarketInstruction } from '../../internal/planning/trade-faction-market.js';
+import { isAddress } from '@solana/kit';
+import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { deriveFleetAddress, fleetAccountDefinition, } from '../../internal/c4/fleet.js';
+import { characterAccountDefinition, findCharacterPda, } from '../../internal/c4/identity.js';
+import { deriveFactionMarketAddress, factionMarketAccountDefinition, } from '../../internal/c4/market.js';
+import { deriveFactionStandingAddress, deriveFactionConfigAddress, deriveFactionTreasuryAddress, factionStandingAccountDefinition, factionConfigAccountDefinition, } from '../../internal/c4/factions.js';
+import { deriveStarbasePlayerAddress, starbasePlayerAccountDefinition, } from '../../internal/c4/starbase.js';
+import { deriveStarSystemAddress, starSystemAccountDefinition, } from '../../internal/c4/world.js';
+import { requireGameAddress } from '../../internal/game-context.js';
+import { hashAccountState } from '../../internal/planning/account-state.js';
+import { validatePlanAuthorization, } from '../../internal/planning/authorization-adapter.js';
+import { createPlan, } from '../../planning/index.js';
+function invalid(field) {
+    throw new InvalidActionInputError(field, undefined, 'the exact documented address-only trade input', `Provide ${field} without extra fields, accessors, coercion or signer objects; use direction buy/sell, an existing u16 offerIndex and bigint quantityRaw from 1 through 18446744073709551615.`);
+}
+function record(value, required, optional, field) {
+    if (value === null ||
+        typeof value !== 'object' ||
+        (Object.getPrototypeOf(value) !== Object.prototype &&
+            Object.getPrototypeOf(value) !== null))
+        invalid(field);
+    const descriptors = Object.getOwnPropertyDescriptors(value);
+    if (required.some((key) => !Object.hasOwn(descriptors, key)) ||
+        Reflect.ownKeys(value).some((key) => typeof key !== 'string' ||
+            ![...required, ...optional].includes(key) ||
+            !Object.hasOwn(descriptors[key], 'value')))
+        invalid(field);
+    return value;
+}
+function optionsFrom(value) {
+    const o = record(value, ['authorization', 'direction', 'offerIndex', 'quantityRaw'], [], 'options');
+    const a = record(o.authorization, ['profile', 'authority', 'keyIndex'], ['certificate'], 'authorization');
+    for (const key of ['profile', 'authority', 'certificate']) {
+        if (key === 'certificate' && a[key] === undefined)
+            continue;
+        if (typeof a[key] !== 'string' || !isAddress(a[key]))
+            invalid(`authorization.${key}`);
+    }
+    const authorization = { ...a };
+    validatePlanAuthorization(authorization);
+    if (o.direction !== 'buy' && o.direction !== 'sell')
+        invalid('direction');
+    if (typeof o.offerIndex !== 'number' ||
+        !Number.isInteger(o.offerIndex) ||
+        o.offerIndex < 0 ||
+        o.offerIndex > 65535)
+        invalid('offerIndex');
+    if (typeof o.quantityRaw !== 'bigint' ||
+        o.quantityRaw < 1n ||
+        o.quantityRaw > (1n << 64n) - 1n)
+        invalid('quantityRaw');
+    return {
+        authorization,
+        direction: o.direction,
+        offerIndex: o.offerIndex,
+        quantityRaw: o.quantityRaw,
+    };
+}
+function fail(message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', `${message} Refresh the Fleet, Faction Market and required canonical accounts through this context, repair missing prerequisites, and retry.`);
+}
+function requireCrew(crewCount) {
+    if (!Number.isSafeInteger(crewCount) || crewCount <= 0)
+        fail('Fleet has no valid normalized crew. Crew the Fleet, refresh it, and retry.');
+}
+function required(raw, address) {
+    if (raw === undefined)
+        fail(`Required trade account ${address} is missing.`);
+    return raw;
+}
+/** Plans one explicit buy or sell using fresh canonical prerequisites, without simulation or writes.
+ * Buy moves cargo Treasury→Fleet and ATLAS Character→Treasury; sell reverses both.
+ * Partial fills, stock, floors, faucet caps/burn, fees, restock and final arithmetic
+ * remain chain-authoritative. Standing gates access and is credited on selling;
+ * it is not a local price adjustment. Offline construction is not live trade evidence.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const fleet: FleetSnapshot;
+ * declare const market: FactionMarketSnapshot;
+ * declare const authorization: PlanAuthorization;
+ * const plan = await planTradeFactionMarket(ctx, fleet, market, { authorization, direction: 'sell', offerIndex: 0, quantityRaw: 5n });
+ * console.log(plan.describe());
+ * ```
+ */
+export async function planTradeFactionMarket(ctx, fleet, market, input) {
+    const options = optionsFrom(input);
+    const game = requireGameAddress(ctx);
+    const { authorization, direction, offerIndex, quantityRaw } = options;
+    if (fleet.kind !== 'fleet' ||
+        market.kind !== 'factionMarket' ||
+        fleet.game !== game ||
+        market.game.address !== game ||
+        fleet.ownerProfile.address !== authorization.profile)
+        fail('Fleet/Market snapshots must belong to the configured Game and authorized Profile.');
+    requireCrew(fleet.crewCount);
+    const character = await findCharacterPda(authorization.profile, game);
+    const system = market.system.address;
+    const player = await deriveStarbasePlayerAddress(system, character);
+    const treasury = await deriveFactionTreasuryAddress(game, market.factionId);
+    const standing = await deriveFactionStandingAddress(game, authorization.profile, market.factionId);
+    const addresses = [
+        fleet.address,
+        character,
+        system,
+        player,
+        market.address,
+        treasury,
+    ];
+    const reads = await readContextRawAccounts(ctx, [...addresses, standing]);
+    const accounts = addresses.map((address, index) => required(reads[index], address));
+    const [fleetRaw, characterRaw, systemRaw, playerRaw, marketRaw, treasuryRaw] = accounts;
+    const f = fleetAccountDefinition.decode(fleetRaw);
+    requireCrew(f.crewCount);
+    if (f.game !== game ||
+        f.ownerProfile !== authorization.profile ||
+        (await deriveFleetAddress(f)) !== fleet.address)
+        fail('Fresh Fleet does not match its canonical Game/Profile identity.');
+    if (fleet.state.kind !== 'docked' ||
+        f.state.kind !== 'docked' ||
+        fleet.state.system.address !== system ||
+        f.state.system !== system ||
+        fleet.state.systemSeqId !== f.state.systemSeqId)
+        fail('Fleet must retain its selected Docked System and sequence.');
+    const c = characterAccountDefinition.decode(characterRaw);
+    if (c.game !== game || c.playerProfile !== authorization.profile)
+        fail('Canonical Character must match the configured Game and Profile.');
+    const s = starSystemAccountDefinition.decode(systemRaw);
+    if (s.game !== game ||
+        (await deriveStarSystemAddress(game, s.systemId)) !== system)
+        fail('Star System must match its canonical Game identity.');
+    if (s.starbase === undefined ||
+        s.starbase.hp <= 0 ||
+        s.sequenceId !== market.starbaseSequenceId ||
+        s.sequenceId !== f.state.systemSeqId)
+        fail('Trading requires an undestroyed local Starbase and current Starbase sequence.');
+    const p = starbasePlayerAccountDefinition.decode(playerRaw);
+    if (p.playerProfile !== authorization.profile ||
+        p.character !== character ||
+        p.system !== system ||
+        p.sequenceId !== s.sequenceId)
+        fail('Starbase Player must match the Profile, Character, System and current undestroyed Starbase sequence.');
+    const m = factionMarketAccountDefinition.decode(marketRaw);
+    if (m.game !== game ||
+        m.system !== system ||
+        m.factionId !== market.factionId ||
+        m.starbaseSequenceId !== s.sequenceId ||
+        (await deriveFactionMarketAddress(game, system, m.starbaseSequenceId)) !==
+            market.address)
+        fail('Faction Market must match its canonical Game, faction, System and Starbase sequence.');
+    if (m.status !== 'active' || market.status !== 'active')
+        fail('Faction Market must be active.');
+    const offer = m.offers[offerIndex];
+    const selected = market.offers[offerIndex];
+    if (offer === undefined || selected === undefined)
+        fail('offerIndex must identify an existing ordered offer in both the selected and fresh Faction Market.');
+    if (offer.cargoId !== selected.id ||
+        offer.priceRaw !== selected.priceRaw ||
+        offer.remainingQuantityRaw !== selected.remainingQuantityRaw ||
+        offer.canBuyFromFaction !== selected.canBuyFromFaction ||
+        offer.canSellToFaction !== selected.canSellToFaction ||
+        m.minimumStandingToBuy !== market.minimumStandingToBuy ||
+        m.minimumStandingToSell !== market.minimumStandingToSell)
+        fail('Selected Faction Market trade intent changed; select the refreshed offer explicitly.');
+    if (!(direction === 'buy' ? offer.canBuyFromFaction : offer.canSellToFaction))
+        fail('Selected offer does not support this trade direction.');
+    const identity = { game, factionId: m.factionId };
+    const t = await readTradeTreasury(treasuryRaw, identity);
+    const finite = [
+        direction === 'buy'
+            ? {
+                kind: 'faction-treasury-buy',
+                address: treasury,
+                ...identity,
+                cargoId: offer.cargoId,
+                floorRaw: t.reserves.find((row) => row.cargoId === offer.cargoId)?.floorRaw ??
+                    0n,
+                describes: `Faction Treasury ${treasury} retains its canonical identity and cargo ${offer.cargoId} reserve floor; live stock and balances may change.`,
+            }
+            : {
+                kind: 'faction-treasury-sell',
+                address: treasury,
+                ...identity,
+                atlasOutCapPerEpochRaw: t.atlasOutCapPerEpochRaw,
+                epochLengthSeconds: t.epochLengthSeconds,
+                describes: `Faction Treasury ${treasury} retains its canonical identity, ATLAS payout cap and epoch length; live balances and epoch counters may change.`,
+            },
+    ];
+    // The System is a freshly validated read-only anchor, not trade intent.
+    // Fleet/Market/StarbasePlayer bind the incarnation; the chain rechecks the System.
+    const bound = [
+        ['Fleet cargo and trade state', fleetRaw],
+        ['Character ATLAS and identity', characterRaw],
+        ['Starbase Player dock incarnation', playerRaw],
+        ['Faction Market ordered offers', marketRaw],
+    ];
+    let cohort;
+    const absent = [];
+    if (reads[6] === undefined) {
+        if ((direction === 'buy' ? m.minimumStandingToBuy : m.minimumStandingToSell) >
+            -1000)
+            fail('Canonical Standing is absent and the selected direction is not open; initialize Faction Standing before trading.');
+        absent.push({
+            kind: 'account-absent',
+            address: standing,
+            describes: 'Canonical Faction Standing remains strictly absent for this open-direction trade.',
+        });
+    }
+    else {
+        const standingRaw = required(reads[6], standing);
+        const st = factionStandingAccountDefinition.decode(standingRaw);
+        if (st.game !== game ||
+            st.profile !== authorization.profile ||
+            st.factionId !== m.factionId)
+            fail('Faction Standing must match the Game, Profile and Market faction.');
+        const config = await deriveFactionConfigAddress(game);
+        const meter = await deriveTradeEpochMeterAddress(identity);
+        const extra = await readContextRawAccounts(ctx, [config, meter]);
+        const configRaw = required(extra[0], config);
+        const meterRaw = required(extra[1], meter);
+        factionConfigAccountDefinition.decode(configRaw);
+        await validateTradeEpochMeter(meterRaw, identity);
+        finite.push({
+            kind: 'faction-epoch-meter',
+            address: meter,
+            ...identity,
+            describes: `Faction Epoch Meter ${meter} retains its canonical identity and layout; epoch and accrual counters may change.`,
+        });
+        bound.push(['Faction Standing access and accrual', standingRaw], ['Faction Config reputation rules', configRaw]);
+        cohort = {
+            factionStanding: standing,
+            factionConfig: config,
+            factionEpochMeter: meter,
+        };
+    }
+    const summary = `${direction === 'buy' ? 'Buy' : 'Sell'} up to ${String(quantityRaw)} raw units of ${selected.name} at Faction Market offer ${String(offerIndex)}. ${direction === 'buy' ? 'Cargo Treasury→Fleet; ATLAS Character→Treasury.' : 'Cargo Fleet→Treasury; ATLAS Treasury→Character.'} Partial fills, stock, treasury floors, faucet caps/burn, standing/epoch/decay, fees, restock and final arithmetic remain chain-authoritative. Standing gates access and is credited on selling, not a price adjustment.`;
+    return createPlan({
+        kind: 'markets.trade-faction-market',
+        summary,
+        preconditions: [
+            ...(await Promise.all(bound.map(async ([role, account]) => ({
+                kind: 'account-state',
+                address: account.address,
+                dataHash: await hashAccountState(account.owner, account.data),
+                describes: `${role} at ${account.address} remains unchanged. Refresh the Fleet and Market and prepare a new trade if this state changes.`,
+            })))),
+            ...finite,
+            ...absent,
+        ],
+        steps: [
+            {
+                describes: summary,
+                signers: [authorization.authority],
+                semantics: [
+                    {
+                        kind: 'requires',
+                        resource: `faction-market:${market.address}`,
+                        fact: 'ordered-offers',
+                    },
+                    {
+                        kind: 'invalidates',
+                        resource: `faction-market:${market.address}`,
+                        fact: 'ordered-offers',
+                    },
+                ],
+                instruction: adaptTradeFactionMarketInstruction({
+                    authorization,
+                    character,
+                    game,
+                    system,
+                    starbasePlayer: player,
+                    fleet: fleet.address,
+                    factionMarket: market.address,
+                    treasury,
+                    offerIndex,
+                    quantity: quantityRaw,
+                    playerBuys: direction === 'buy',
+                    ...cohort,
+                }),
+            },
+        ],
+    });
+}
+//# sourceMappingURL=trade-faction-market.js.map

package/dist/markets/actions/trade-faction-market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-faction-market.js","sourceRoot":"","sources":["../../../src/markets/actions/trade-faction-market.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,kCAAkC,EAAE,MAAM,iDAAiD,CAAC;AACrG,OAAO,EAAE,SAAS,EAAgB,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,gCAAgC,EAChC,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EACL,yBAAyB,GAE1B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,UAAU,GAGX,MAAM,yBAAyB,CAAC;AAuBjC,SAAS,OAAO,CAAC,KAAa;IAC5B,MAAM,IAAI,uBAAuB,CAC/B,KAAK,EACL,SAAS,EACT,+CAA+C,EAC/C,WAAW,KAAK,8KAA8K,CAC/L,CAAC;AACJ,CAAC;AACD,SAAS,MAAM,CACb,KAAc,EACd,QAA2B,EAC3B,QAA2B,EAC3B,KAAa;IAEb,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS;YAChD,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;QAExC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,MAAM,WAAW,GAAG,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAC5D,IACE,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CACzB,CAAC,GAAG,EAAE,EAAE,CACN,OAAO,GAAG,KAAK,QAAQ;YACvB,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YACzC,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAE,EAAE,OAAO,CAAC,CAC7C;QAED,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,KAAgC,CAAC;AAC1C,CAAC;AACD,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,CAAC,GAAG,MAAM,CACd,KAAK,EACL,CAAC,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,EAC3D,EAAE,EACF,SAAS,CACV,CAAC;IACF,MAAM,CAAC,GAAG,MAAM,CACd,CAAC,CAAC,aAAa,EACf,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,EACpC,CAAC,aAAa,CAAC,EACf,eAAe,CAChB,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,aAAa,CAAU,EAAE,CAAC;QACnE,IAAI,GAAG,KAAK,aAAa,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,SAAS;QAC5D,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAClD,OAAO,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,MAAM,aAAa,GAAG,EAAE,GAAG,CAAC,EAAkC,CAAC;IAC/D,yBAAyB,CAAC,aAAa,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC,SAAS,KAAK,KAAK,IAAI,CAAC,CAAC,SAAS,KAAK,MAAM;QAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1E,IACE,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;QAChC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QAC/B,CAAC,CAAC,UAAU,GAAG,CAAC;QAChB,CAAC,CAAC,UAAU,GAAG,KAAK;QAEpB,OAAO,CAAC,YAAY,CAAC,CAAC;IACxB,IACE,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,CAAC,CAAC,WAAW,GAAG,EAAE;QAClB,CAAC,CAAC,WAAW,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE;QAEhC,OAAO,CAAC,aAAa,CAAC,CAAC;IACzB,OAAO;QACL,aAAa;QACb,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC;AACJ,CAAC;AACD,SAAS,IAAI,CAAC,OAAe;IAC3B,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,GAAG,OAAO,mIAAmI,CAC9I,CAAC;AACJ,CAAC;AACD,SAAS,WAAW,CAAC,SAAiB;IACpC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC;QACpD,IAAI,CACF,4EAA4E,CAC7E,CAAC;AACN,CAAC;AACD,SAAS,QAAQ,CAAC,GAA2B,EAAE,OAAgB;IAC7D,IAAI,GAAG,KAAK,SAAS;QAAE,IAAI,CAAC,0BAA0B,OAAO,cAAc,CAAC,CAAC;IAC7E,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAgB,EAChB,KAAoB,EACpB,MAA6B,EAC7B,KAAoC;IAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IACtE,IACE,KAAK,CAAC,IAAI,KAAK,OAAO;QACtB,MAAM,CAAC,IAAI,KAAK,eAAe;QAC/B,KAAK,CAAC,IAAI,KAAK,IAAI;QACnB,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI;QAC5B,KAAK,CAAC,YAAY,CAAC,OAAO,KAAK,aAAa,CAAC,OAAO;QAEpD,IAAI,CACF,mFAAmF,CACpF,CAAC;IACJ,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CACjD,IAAI,EACJ,aAAa,CAAC,OAAO,EACrB,MAAM,CAAC,SAAS,CACjB,CAAC;IACF,MAAM,SAAS,GAAG;QAChB,KAAK,CAAC,OAAO;QACb,SAAS;QACT,MAAM;QACN,MAAM;QACN,MAAM,CAAC,OAAO;QACd,QAAQ;KACT,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,CAAC,GAAG,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAChD,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAChC,CAAC;IACF,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,GAC1E,QAOC,CAAC;IACJ,MAAM,CAAC,GAAG,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClD,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACzB,IACE,CAAC,CAAC,IAAI,KAAK,IAAI;QACf,CAAC,CAAC,YAAY,KAAK,aAAa,CAAC,OAAO;QACxC,CAAC,MAAM,kBAAkB,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO;QAE/C,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC1E,IACE,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC7B,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;QACzB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM;QACrC,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM;QACzB,KAAK,CAAC,KAAK,CAAC,WAAW,KAAK,CAAC,CAAC,KAAK,CAAC,WAAW;QAE/C,IAAI,CAAC,4DAA4D,CAAC,CAAC;IACrE,MAAM,CAAC,GAAG,0BAA0B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,aAAa,KAAK,aAAa,CAAC,OAAO;QAC9D,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC1E,MAAM,CAAC,GAAG,2BAA2B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxD,IACE,CAAC,CAAC,IAAI,KAAK,IAAI;QACf,CAAC,MAAM,uBAAuB,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,MAAM;QAE5D,IAAI,CAAC,qDAAqD,CAAC,CAAC;IAC9D,IACE,CAAC,CAAC,QAAQ,KAAK,SAAS;QACxB,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;QAClB,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,kBAAkB;QAC1C,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,KAAK,CAAC,WAAW;QAEpC,IAAI,CACF,+EAA+E,CAChF,CAAC;IACJ,MAAM,CAAC,GAAG,+BAA+B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5D,IACE,CAAC,CAAC,aAAa,KAAK,aAAa,CAAC,OAAO;QACzC,CAAC,CAAC,SAAS,KAAK,SAAS;QACzB,CAAC,CAAC,MAAM,KAAK,MAAM;QACnB,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU;QAE7B,IAAI,CACF,sGAAsG,CACvG,CAAC;IACJ,MAAM,CAAC,GAAG,8BAA8B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3D,IACE,CAAC,CAAC,IAAI,KAAK,IAAI;QACf,CAAC,CAAC,MAAM,KAAK,MAAM;QACnB,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;QAChC,CAAC,CAAC,kBAAkB,KAAK,CAAC,CAAC,UAAU;QACrC,CAAC,MAAM,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC;YACpE,MAAM,CAAC,OAAO;QAEhB,IAAI,CACF,sFAAsF,CACvF,CAAC;IACJ,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ;QACrD,IAAI,CAAC,gCAAgC,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS;QAC/C,IAAI,CACF,mGAAmG,CACpG,CAAC;IACJ,IACE,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,EAAE;QAC7B,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;QACpC,KAAK,CAAC,oBAAoB,KAAK,QAAQ,CAAC,oBAAoB;QAC5D,KAAK,CAAC,iBAAiB,KAAK,QAAQ,CAAC,iBAAiB;QACtD,KAAK,CAAC,gBAAgB,KAAK,QAAQ,CAAC,gBAAgB;QACpD,CAAC,CAAC,oBAAoB,KAAK,MAAM,CAAC,oBAAoB;QACtD,CAAC,CAAC,qBAAqB,KAAK,MAAM,CAAC,qBAAqB;QAExD,IAAI,CACF,sFAAsF,CACvF,CAAC;IACJ,IAAI,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;QAC3E,IAAI,CAAC,uDAAuD,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;IAClD,MAAM,CAAC,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAuB;QACjC,SAAS,KAAK,KAAK;YACjB,CAAC,CAAC;gBACE,IAAI,EAAE,sBAAsB;gBAC5B,OAAO,EAAE,QAAQ;gBACjB,GAAG,QAAQ;gBACX,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,QAAQ,EACN,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ;oBACjE,EAAE;gBACJ,SAAS,EAAE,oBAAoB,QAAQ,6CAA6C,KAAK,CAAC,OAAO,qDAAqD;aACvJ;YACH,CAAC,CAAC;gBACE,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,QAAQ;gBACjB,GAAG,QAAQ;gBACX,sBAAsB,EAAE,CAAC,CAAC,sBAAsB;gBAChD,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;gBACxC,SAAS,EAAE,oBAAoB,QAAQ,kHAAkH;aAC1J;KACN,CAAC;IACF,wEAAwE;IACxE,mFAAmF;IACnF,MAAM,KAAK,GAA2B;QACpC,CAAC,6BAA6B,EAAE,QAAQ,CAAC;QACzC,CAAC,8BAA8B,EAAE,YAAY,CAAC;QAC9C,CAAC,kCAAkC,EAAE,SAAS,CAAC;QAC/C,CAAC,+BAA+B,EAAE,SAAS,CAAC;KAC7C,CAAC;IACF,IAAI,MAMS,CAAC;IACd,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC3B,IACE,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC;YACxE,CAAC,IAAI;YAEL,IAAI,CACF,kHAAkH,CACnH,CAAC;QACJ,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,QAAQ;YACjB,SAAS,EACP,mFAAmF;SACtF,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,EAAE,GAAG,gCAAgC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAChE,IACE,EAAE,CAAC,IAAI,KAAK,IAAI;YAChB,EAAE,CAAC,OAAO,KAAK,aAAa,CAAC,OAAO;YACpC,EAAE,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;YAE5B,IAAI,CAAC,mEAAmE,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3C,8BAA8B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,KAAK;YACd,GAAG,QAAQ;YACX,SAAS,EAAE,uBAAuB,KAAK,oFAAoF;SAC5H,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CACR,CAAC,qCAAqC,EAAE,WAAW,CAAC,EACpD,CAAC,iCAAiC,EAAE,SAAS,CAAC,CAC/C,CAAC;QACF,MAAM,GAAG;YACP,eAAe,EAAE,QAAQ;YACzB,aAAa,EAAE,MAAM;YACrB,iBAAiB,EAAE,KAAK;SACzB,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,UAAU,MAAM,CAAC,WAAW,CAAC,iBAAiB,QAAQ,CAAC,IAAI,4BAA4B,MAAM,CAAC,UAAU,CAAC,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,iDAAiD,CAAC,CAAC,CAAC,iDAAiD,0NAA0N,CAAC;IAC3f,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,8BAA8B;QACpC,OAAO;QACP,aAAa,EAAE;YACb,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CACnB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,IAAI,EAAE,eAAwB;gBAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,MAAM,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC;gBAC7D,SAAS,EAAE,GAAG,IAAI,OAAO,OAAO,CAAC,OAAO,iGAAiG;aAC1I,CAAC,CAAC,CACJ,CAAC;YACF,GAAG,MAAM;YACT,GAAG,MAAM;SACV;QACD,KAAK,EAAE;YACL;gBACE,SAAS,EAAE,OAAO;gBAClB,OAAO,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC;gBAClC,SAAS,EAAE;oBACT;wBACE,IAAI,EAAE,UAAU;wBAChB,QAAQ,EAAE,kBAAkB,MAAM,CAAC,OAAO,EAAE;wBAC5C,IAAI,EAAE,gBAAgB;qBACvB;oBACD;wBACE,IAAI,EAAE,aAAa;wBACnB,QAAQ,EAAE,kBAAkB,MAAM,CAAC,OAAO,EAAE;wBAC5C,IAAI,EAAE,gBAAgB;qBACvB;iBACF;gBACD,WAAW,EAAE,kCAAkC,CAAC;oBAC9C,aAAa;oBACb,SAAS;oBACT,IAAI;oBACJ,MAAM;oBACN,cAAc,EAAE,MAAM;oBACtB,KAAK,EAAE,KAAK,CAAC,OAAO;oBACpB,aAAa,EAAE,MAAM,CAAC,OAAO;oBAC7B,QAAQ;oBACR,UAAU;oBACV,QAAQ,EAAE,WAAW;oBACrB,UAAU,EAAE,SAAS,KAAK,KAAK;oBAC/B,GAAG,MAAM;iBACV,CAAC;aACH;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,86 @@
+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 { ResourceDepositSnapshot } from '../index.js';
+export type { PlanAuthorization };
+interface FleetSnapshot extends Omit<ResolvedFleetAccountData, 'ownerProfile'> {
+    readonly kind: 'fleet';
+    readonly address: Address;
+    readonly ownerProfile: EntityRef<'profile'>;
+    toJSON(): unknown;
+}
+/** Select resources from one Asteroid deposit for an owned Fleet.
+ * @example
+ * ```ts
+ * declare const authorization: PlanAuthorization;
+ * declare const asteroid: ResourceDepositSnapshot;
+ * const options: PlanFleetStartMiningOptions = { authorization, asteroid, resourceIds: [8] };
+ * ```
+ */
+export interface PlanFleetStartMiningOptions {
+    readonly authorization: PlanAuthorization;
+    readonly asteroid: ResourceDepositSnapshot;
+    /** Dense, non-empty, unique cargo ids in ascending order, selected from the deposit. */
+    readonly resourceIds: readonly number[];
+}
+/** 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.
+ * 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
+ * in the pinned ten-account instruction.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const fleet: FleetSnapshot;
+ * declare const authorization: PlanAuthorization;
+ * declare const asteroid: ResourceDepositSnapshot;
+ * const plan = await planFleetStartMining(ctx, fleet, { authorization, asteroid, resourceIds: [8] });
+ * ```
+ */
+export declare function planFleetStartMining(ctx: SageContext, fleet: FleetSnapshot, options: PlanFleetStartMiningOptions): Promise<Plan>;
+/** Address-only authorization to stop an owned Fleet's current mining operation.
+ * @example
+ * ```ts
+ * declare const authorization: PlanAuthorization;
+ * const options: PlanFleetStopMiningOptions = { authorization };
+ * ```
+ */
+export interface PlanFleetStopMiningOptions {
+    readonly authorization: PlanAuthorization;
+}
+/** 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 instruction can still consume
+ * planet-exit fuel, as observed on PTR, or fail cargo/upkeep checks. Refresh
+ * before planning and simulate before execution; Idle is not a free no-op.
+ * No yield, cargo amount, or execution success is promised. DO_MINING
+ * permission remains chain-authoritative. Only validated canonical optional
+ * 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
+ * declare const ctx: SageContext;
+ * declare const fleet: FleetSnapshot;
+ * declare const authorization: PlanAuthorization;
+ * const plan = await planFleetStopMining(ctx, fleet, { authorization });
+ * ```
+ */
+export declare function planFleetStopMining(ctx: SageContext, fleet: FleetSnapshot, options: PlanFleetStopMiningOptions): Promise<Plan>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAiFf"}