@aephia/atlas-kit 0.6.0-next.99 → 0.6.0

package/dist/internal/planning/profile-storage-funding-guard.js

@@ -0,0 +1,115 @@
+import { SageSdkError } from '../../client/errors.js';
+import { APPLY_COMBAT_STIMULANT_DISCRIMINATOR, CANCEL_CRAFTING_PROCESS_DISCRIMINATOR, CANCEL_LOCAL_MARKET_ORDERS_DISCRIMINATOR, DEPOSIT_CARGO_TO_GAME_DISCRIMINATOR, DISBAND_FLEET_DISCRIMINATOR, PLACE_CLAIM_STAKE_BUILDINGS_DISCRIMINATOR, PLACE_CLAIM_STAKE_INSTANCE_WITH_HUB_DISCRIMINATOR, RECOVER_SIGNAL_DISCRIMINATOR, RETRIEVE_LOOT_DISCRIMINATOR, START_CLAIM_STAKES_FLEET_TRANSFER_DISCRIMINATOR, START_CRAFTING_PROCESS_DISCRIMINATOR, START_MINING_ASTEROID_DISCRIMINATOR, START_SUBWARP_DISCRIMINATOR, STOP_MINING_ASTEROID_DISCRIMINATOR, STOP_SUBWARP_DISCRIMINATOR, TRADE_FACTION_MARKET_DISCRIMINATOR, TRANSFER_CARGO_TO_FLEET_DISCRIMINATOR, TRANSFER_CARGO_WITHIN_FLEET_DISCRIMINATOR, WARP_LANE_DISCRIMINATOR, WARP_TO_COORDINATE_DISCRIMINATOR, } from '../c4/discriminators.js';
+import { SAGE_PROGRAM_ADDRESS } from '../c4/runtime-bindings.js';
+import { MAX_U64, } from './plan-fields.js';
+/** Bytes one new cargo line (u16 cargo id, u64 amount) adds to a cargo pod. */
+export const CARGO_LINE_BYTES = 10;
+/** Each kind's discriminator, the instruction account index of the first
+ * account it resizes, which names the guard, whether it carries one, and the
+ * index of its signing key, with the Profile at the next account. A subwarp
+ * stop only returns the Fleet to Idle, which releases storage and refunds the
+ * Profile, so it has no guard; it is evaluated so later actions see the
+ * settled Fleet. */
+const STORAGE_INSTRUCTIONS = [
+    ['deposit', DEPOSIT_CARGO_TO_GAME_DISCRIMINATOR, 5, true, 0],
+    ['starbase-transfer', TRANSFER_CARGO_TO_FLEET_DISCRIMINATOR, 4, true, 0],
+    [
+        'within-fleet-transfer',
+        TRANSFER_CARGO_WITHIN_FLEET_DISCRIMINATOR,
+        4,
+        true,
+        0,
+    ],
+    ['start-mining', START_MINING_ASTEROID_DISCRIMINATOR, 4, true, 0],
+    ['stop-mining', STOP_MINING_ASTEROID_DISCRIMINATOR, 5, true, 0],
+    ['stop-subwarp', STOP_SUBWARP_DISCRIMINATOR, 5, false, 0],
+    [
+        'cancel-market-orders',
+        CANCEL_LOCAL_MARKET_ORDERS_DISCRIMINATOR,
+        8,
+        true,
+        0,
+    ],
+    ['faction-trade', TRADE_FACTION_MARKET_DISCRIMINATOR, 8, true, 0],
+    ['start-subwarp', START_SUBWARP_DISCRIMINATOR, 5, true, 0],
+    ['warp-to-coordinate', WARP_TO_COORDINATE_DISCRIMINATOR, 5, true, 0],
+    ['warp-lane', WARP_LANE_DISCRIMINATOR, 5, true, 0],
+    ['start-crafting', START_CRAFTING_PROCESS_DISCRIMINATOR, 9, true, 0],
+    ['cancel-crafting', CANCEL_CRAFTING_PROCESS_DISCRIMINATOR, 7, true, 0],
+    ['apply-stimulant', APPLY_COMBAT_STIMULANT_DISCRIMINATOR, 4, true, 0],
+    ['retrieve-loot', RETRIEVE_LOOT_DISCRIMINATOR, 4, true, 0],
+    ['recover-signal', RECOVER_SIGNAL_DISCRIMINATOR, 5, true, 0],
+    [
+        'place-claim-stake',
+        PLACE_CLAIM_STAKE_INSTANCE_WITH_HUB_DISCRIMINATOR,
+        6,
+        true,
+        1,
+    ],
+    [
+        'claim-stake-building-changes',
+        PLACE_CLAIM_STAKE_BUILDINGS_DISCRIMINATOR,
+        6,
+        true,
+        1,
+    ],
+    [
+        'start-claim-stake-transfer',
+        START_CLAIM_STAKES_FLEET_TRANSFER_DISCRIMINATOR,
+        4,
+        true,
+        0,
+    ],
+    ['disband', DISBAND_FLEET_DISCRIMINATOR, 8, true, 0],
+];
+/** Which Profile-funded instruction this is, if any, the index of the account
+ * its guard names, whether it carries a guard, and its signing key's index. */
+export function storageInstruction(instruction) {
+    if (instruction.programAddress !== SAGE_PROGRAM_ADDRESS)
+        return undefined;
+    const entry = STORAGE_INSTRUCTIONS.find(([, discriminator]) => discriminator.every((byte, index) => instruction.data?.[index] === byte));
+    return (entry && {
+        kind: entry[0],
+        primary: entry[2],
+        guarded: entry[3],
+        signer: entry[4],
+    });
+}
+export const PROFILE_STORAGE_FUNDING_SCHEMA = {
+    fields: [
+        ['address', 'address'],
+        ['profile', 'address'],
+        ['authority', 'address'],
+        [
+            'maximumProfileDebit',
+            {
+                min: 0n,
+                max: MAX_U64,
+                accepted: 'a nonnegative u64 funding ceiling',
+            },
+        ],
+        ['describes', 'string'],
+    ],
+};
+/** Binds every guarded Profile-funded instruction to exactly one storage funding guard
+ * for its Profile, signer and first resized account, so a saved Plan cannot
+ * drop or retarget its funding check; a guard without its instruction is
+ * refused too. */
+export function validateProfileStorageFundingGuards(steps, guards) {
+    const remaining = guards.filter((guard) => guard.kind === 'profile-storage-funding');
+    for (const { instruction } of steps) {
+        const known = storageInstruction(instruction);
+        if (!known?.guarded)
+            continue;
+        const metas = instruction.accounts;
+        const index = remaining.findIndex((guard) => guard.authority === metas?.[known.signer]?.address &&
+            guard.profile === metas[known.signer + 1]?.address &&
+            guard.address === metas[known.primary]?.address);
+        if (index < 0)
+            throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'An instruction that resizes Profile-funded storage has no matching Profile storage funding guard for its Profile, signer and account. Recreate the Plan with its planner.');
+        remaining.splice(index, 1);
+    }
+    if (remaining.length > 0)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'A Profile storage funding guard has no matching instruction. Recreate the Plan with its planner.');
+}
+//# sourceMappingURL=profile-storage-funding-guard.js.map

package/dist/internal/planning/profile-storage-funding-guard.js.map

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

package/dist/internal/planning/profile-storage-funding.d.ts

@@ -0,0 +1,46 @@
+import type { Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import type { ProfileStorageFundingGuard } from './profile-storage-funding-guard.js';
+export interface ProfileStorageFunding {
+    readonly profileDebit: bigint;
+    readonly profileReserve: bigint;
+}
+/** Refuses a direct Profile key that can fund none of an action's positive
+ * storage debit: the program withdraws it from the Profile vault with the
+ * signing key, which must be Profile AUTH or also hold `drainSolVault` (any
+ * scope). A delegated or certificate key is left to the program. Returns
+ * whether the key is a direct Profile key. */
+export declare function requireStorageFundingKey(input: {
+    readonly profileRaw: RawAccount;
+    readonly authority: Address;
+    readonly keyIndex: number;
+    readonly profileDebit: bigint;
+    readonly action: string;
+}): boolean;
+/** Checks that the signing key and the Profile can fund one action's storage
+ * debit. A zero debit withdraws nothing, so it needs neither `drainSolVault`
+ * nor Profile excess lamports. */
+export declare function checkProfileStorageFunding(input: {
+    readonly profileRaw: RawAccount;
+    readonly rentRaw: RawAccount;
+    readonly authority: Address;
+    readonly keyIndex: number;
+    readonly profileDebit: bigint;
+    readonly action: string;
+    readonly maximumProfileDebit?: bigint;
+}): ProfileStorageFunding & {
+    readonly direct: boolean;
+};
+/** Builds the guard and the summary sentence for one action's storage funding. */
+export declare function profileStorageFundingGuard(input: {
+    readonly address: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly funding: ProfileStorageFunding & {
+        readonly direct: boolean;
+    };
+}): {
+    readonly guard: ProfileStorageFundingGuard;
+    readonly disclosure: string;
+};
+//# sourceMappingURL=profile-storage-funding.d.ts.map

package/dist/internal/planning/profile-storage-funding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-storage-funding.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/profile-storage-funding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAS5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAMrF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAMD;;;;8CAI8C;AAC9C,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAiBV;AAED;;kCAEkC;AAClC,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC,GAAG,qBAAqB,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAmBvD;AAED,kFAAkF;AAClF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CACxE,GAAG;IACF,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAiBA"}

package/dist/internal/planning/profile-storage-funding.js

@@ -0,0 +1,58 @@
+import { SageSdkError } from '../../client/errors.js';
+import { profileAccountDefinition } from '../c4/identity.js';
+import { PROFILE_SCOPE } from '../c4/profile-permissions.js';
+import { directProfileKey, grantsPermission, hasPermissionBit, } from './profile-key.js';
+import { readRent } from './rent.js';
+// Profile drainSolVault permission bit, any scope.
+const DRAIN_SOL_VAULT = 63n;
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+/** Refuses a direct Profile key that can fund none of an action's positive
+ * storage debit: the program withdraws it from the Profile vault with the
+ * signing key, which must be Profile AUTH or also hold `drainSolVault` (any
+ * scope). A delegated or certificate key is left to the program. Returns
+ * whether the key is a direct Profile key. */
+export function requireStorageFundingKey(input) {
+    const key = directProfileKey(profileAccountDefinition.decode(input.profileRaw).keys, input.keyIndex, input.authority);
+    if (input.profileDebit > 0n &&
+        key &&
+        !grantsPermission(key, PROFILE_SCOPE, 0n) &&
+        !hasPermissionBit(key, DRAIN_SOL_VAULT))
+        fail(input.profileRaw.address, `The ${input.action} needs ${input.profileDebit} Profile lamports for account storage, which the program withdraws from the Profile vault with the signing key; this key lacks drainSolVault. Use a direct Profile AUTH key or a key that also holds drainSolVault, then replan.`);
+    return key !== undefined;
+}
+/** Checks that the signing key and the Profile can fund one action's storage
+ * debit. A zero debit withdraws nothing, so it needs neither `drainSolVault`
+ * nor Profile excess lamports. */
+export function checkProfileStorageFunding(input) {
+    const { profileRaw, action, profileDebit } = input;
+    const rent = readRent(input.rentRaw);
+    if (input.maximumProfileDebit !== undefined &&
+        profileDebit > input.maximumProfileDebit)
+        fail(profileRaw.address, `The ${action} now needs ${profileDebit} Profile lamports for account storage, above the ${input.maximumProfileDebit} this Plan approved. An earlier action in the same Plan may use storage it was planned against: execute the actions as separate Plans, or refresh the accounts and replan, then review the storage funding before signing.`);
+    const profileReserve = rent(profileRaw.data.length);
+    const direct = requireStorageFundingKey(input);
+    if (profileDebit > 0n && profileRaw.lamports < profileReserve + profileDebit)
+        fail(profileRaw.address, `The ${action} needs ${profileDebit} Profile lamports for account storage above the Profile's own ${profileReserve}-lamport rent reserve; the Profile holds ${profileRaw.lamports}. Add ${profileReserve + profileDebit - profileRaw.lamports} lamports to the Profile, then replan.`);
+    return { profileDebit, profileReserve, direct };
+}
+/** Builds the guard and the summary sentence for one action's storage funding. */
+export function profileStorageFundingGuard(input) {
+    const { profileDebit } = input.funding;
+    const disclosure = profileDebit > 0n
+        ? `The program funds ${profileDebit} lamports of account storage from Profile ${input.profile}'s vault with the signing key (a locked rent deposit, separate from transaction fees).${input.funding.direct ? '' : ' The selected key is not a direct Profile key, so its drainSolVault permission is checked by the program, not locally.'}`
+        : `This action needs no Profile storage funding at the observed account sizes and balances.`;
+    return {
+        disclosure,
+        guard: {
+            kind: 'profile-storage-funding',
+            address: input.address,
+            profile: input.profile,
+            authority: input.authority,
+            maximumProfileDebit: profileDebit,
+            describes: `Account storage funding from the Profile vault stays at most ${profileDebit} lamports, and the signing key and Profile balance can fund it.`,
+        },
+    };
+}
+//# sourceMappingURL=profile-storage-funding.js.map

package/dist/internal/planning/profile-storage-funding.js.map

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

package/dist/internal/planning/recipe-state.d.ts

@@ -1,6 +1,9 @@
 import type { RawAccount } from '../../client/contracts.js';
 /** Preserve the complete pinned Recipe encoding except its shared usage counter. */
 export declare function hashRecipeConfiguration(account: RawAccount): Promise<string>;
-/** Start consumes new uses; completing/cancelling an existing job does not. */
+/** Each Crafting Process start consumes exactly one Recipe use, whatever its
+ * quantity; completing or cancelling an existing job reserves none. A Recipe is
+ * usable only while its usage count is below its limit, so a stored limit of
+ * `0` is never usable. */
 export declare function validateRecipeUsage(account: RawAccount, requiredUses: bigint): void;
 //# sourceMappingURL=recipe-state.d.ts.map

package/dist/internal/planning/recipe-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipe-state.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/recipe-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAS5D,oFAAoF;AACpF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GACnB,IAAI,CAWN"}
+{"version":3,"file":"recipe-state.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/recipe-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAS5D,oFAAoF;AACpF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;;0BAG0B;AAC1B,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GACnB,IAAI,CAWN"}

package/dist/internal/planning/recipe-state.js

@@ -8,13 +8,16 @@ export async function hashRecipeConfiguration(account) {
     data.fill(0, RECIPE_USAGE_COUNT_OFFSET, RECIPE_USAGE_COUNT_OFFSET + 8);
     return hashAccountState(account.owner, data);
 }
-/** Start consumes new uses; completing/cancelling an existing job does not. */
+/** Each Crafting Process start consumes exactly one Recipe use, whatever its
+ * quantity; completing or cancelling an existing job reserves none. A Recipe is
+ * usable only while its usage count is below its limit, so a stored limit of
+ * `0` is never usable. */
 export function validateRecipeUsage(account, requiredUses) {
-    const recipe = readRecipeUsage(account);
-    if (requiredUses === 0n || recipe.limit === 0n)
+    if (requiredUses === 0n)
         return;
+    const recipe = readRecipeUsage(account);
     const remaining = recipe.limit > recipe.count ? recipe.limit - recipe.count : 0n;
     if (requiredUses > remaining)
-        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Recipe ${readRecipeName(account) || account.address} usage limit has remaining ${remaining}, but requested ${requiredUses}. Reduce quantity or choose another active Recipe, then recreate the Plan before retrying.`, { address: account.address });
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Recipe ${readRecipeName(account) || account.address} usage limit has remaining ${remaining}, but a Crafting Process start requested ${requiredUses}. The Recipe's uses are exhausted; choose another active Recipe, then recreate the Plan before retrying.`, { address: account.address });
 }
 //# sourceMappingURL=recipe-state.js.map

package/dist/internal/planning/recipe-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"recipe-state.js","sourceRoot":"","sources":["../../../src/internal/planning/recipe-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,cAAc,EACd,eAAe,EACf,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAmB;IAEnB,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,yBAAyB,EAAE,yBAAyB,GAAG,CAAC,CAAC,CAAC;IACvE,OAAO,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CACjC,OAAmB,EACnB,YAAoB;IAEpB,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,YAAY,KAAK,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE;QAAE,OAAO;IACvD,MAAM,SAAS,GACb,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,IAAI,YAAY,GAAG,SAAS;QAC1B,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,UAAU,cAAc,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,8BAA8B,SAAS,mBAAmB,YAAY,4FAA4F,EACtN,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;AACN,CAAC"}
+{"version":3,"file":"recipe-state.js","sourceRoot":"","sources":["../../../src/internal/planning/recipe-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,cAAc,EACd,eAAe,EACf,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAmB;IAEnB,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,yBAAyB,EAAE,yBAAyB,GAAG,CAAC,CAAC,CAAC;IACvE,OAAO,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;;0BAG0B;AAC1B,MAAM,UAAU,mBAAmB,CACjC,OAAmB,EACnB,YAAoB;IAEpB,IAAI,YAAY,KAAK,EAAE;QAAE,OAAO;IAChC,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,SAAS,GACb,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,IAAI,YAAY,GAAG,SAAS;QAC1B,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,UAAU,cAAc,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,8BAA8B,SAAS,4CAA4C,YAAY,0GAA0G,EAC7P,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;AACN,CAAC"}

package/dist/internal/planning/region-access.d.ts

@@ -0,0 +1,30 @@
+import type { Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import { type RegionTracker } from '../c4/runtime-bindings.js';
+type ExactCoordinate = {
+    readonly x: bigint;
+    readonly y: bigint;
+};
+/** The Regions containing a Star System's coordinate, in tracker order; an
+ * empty list is deep space. The tracker must be the canonical version 0
+ * account. */
+export declare function regionsContainingSystem(tracker: RawAccount, system: RawAccount | undefined, game: Address): Promise<RegionTracker['regions']['unsizedList']>;
+/** Digest of the access data of every Region containing a Star System's
+ * coordinate: id, owner, safety status and risk zone, in tracker order. An
+ * empty list is deep space. Other Regions and their systems may change.
+ */
+export declare function hashRegionAccess(tracker: RawAccount, system: RawAccount | undefined, game: Address): Promise<string>;
+/** A Fleet's exact action coordinate in `game`: its Idle location, or the end
+ * of the warp or subwarp a movement start settles first; `undefined` for any
+ * other state, another Game or a missing Fleet.
+ */
+export declare function fleetActionCoordinate(fleet: RawAccount | undefined, game: Address): ExactCoordinate | undefined;
+/** Digest of the Regions a straight path can touch: the Region count, then the
+ * id, border, bounding box, owner, safety status and risk zone of every Region
+ * whose bounding box overlaps the path's, in tracker order. The tracker must
+ * be the canonical version 0 account; Regions away from the path, and every
+ * Region's systems, may change.
+ */
+export declare function hashRegionPath(tracker: RawAccount, game: Address, from: ExactCoordinate, to: ExactCoordinate): Promise<string>;
+export {};
+//# sourceMappingURL=region-access.d.ts.map

package/dist/internal/planning/region-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-access.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/region-access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAQ5D,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAInC,KAAK,eAAe,GAAG;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAgClE;;cAEc;AACd,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC,CAalD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,IAAI,EAAE,OAAO,GACZ,eAAe,GAAG,SAAS,CAa7B;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,MAAM,CAAC,CA+BjB"}

package/dist/internal/planning/region-access.js

@@ -0,0 +1,94 @@
+import { SageSdkError } from '../../client/errors.js';
+import { deriveRegionTrackerAddress, regionTrackerAccountDefinition, } from '../c4/factions.js';
+import { fleetAccountDefinition } from '../c4/fleet.js';
+import { regionContainsCoordinate } from '../c4/region-geometry.js';
+import { getFleetDecoder, getRegionTrackerDecoder, getStarSystemDecoder, } from '../c4/runtime-bindings.js';
+import { starSystemAccountDefinition } from '../c4/world.js';
+import { hashAccountState } from './account-state.js';
+/** Decodes the canonical version 0 RegionTracker, or refuses with `message`. */
+async function decodeTracker(tracker, game, valid, message) {
+    const decoded = !tracker.executable &&
+        tracker.address === (await deriveRegionTrackerAddress(game))
+        ? regionTrackerAccountDefinition.decode(tracker)
+        : undefined;
+    if (!valid || decoded?.game !== game || decoded.version !== 0)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, {
+            address: tracker.address,
+        });
+    return getRegionTrackerDecoder().decode(tracker.data);
+}
+function hashRegions(tracker, value) {
+    return hashAccountState(tracker.owner, new TextEncoder().encode(JSON.stringify(value, (_key, item) => typeof item === 'bigint' ? String(item) : item)));
+}
+/** The Regions containing a Star System's coordinate, in tracker order; an
+ * empty list is deep space. The tracker must be the canonical version 0
+ * account. */
+export async function regionsContainingSystem(tracker, system, game) {
+    const data = await decodeTracker(tracker, game, system !== undefined, 'The Star System is missing, or the RegionTracker is not the canonical version 0 account for this Game. Refresh world region data and recreate the Plan.');
+    starSystemAccountDefinition.validate(system);
+    const [x, y] = getStarSystemDecoder().decode(system.data).coordinates;
+    const coordinate = { x: x.raw, y: y.raw };
+    return data.regions.unsizedList.filter((region) => regionContainsCoordinate(region, coordinate));
+}
+/** Digest of the access data of every Region containing a Star System's
+ * coordinate: id, owner, safety status and risk zone, in tracker order. An
+ * empty list is deep space. Other Regions and their systems may change.
+ */
+export async function hashRegionAccess(tracker, system, game) {
+    const regions = await regionsContainingSystem(tracker, system, game);
+    return hashRegions(tracker, regions.map(({ id, owner, safetyStatus, riskZone }) => [
+        id,
+        owner,
+        safetyStatus,
+        riskZone,
+    ]));
+}
+/** A Fleet's exact action coordinate in `game`: its Idle location, or the end
+ * of the warp or subwarp a movement start settles first; `undefined` for any
+ * other state, another Game or a missing Fleet.
+ */
+export function fleetActionCoordinate(fleet, game) {
+    if (!fleet)
+        return undefined;
+    fleetAccountDefinition.validate(fleet);
+    const { gameId, location, state } = getFleetDecoder().decode(fleet.data);
+    const at = state.__kind === 'Idle'
+        ? location
+        : state.__kind === 'MoveWarp'
+            ? state.fields[0].to
+            : state.__kind === 'MoveSubwarp'
+                ? state.fields[0].journey.to
+                : undefined;
+    return gameId === game && at ? { x: at[0].raw, y: at[1].raw } : undefined;
+}
+/** Digest of the Regions a straight path can touch: the Region count, then the
+ * id, border, bounding box, owner, safety status and risk zone of every Region
+ * whose bounding box overlaps the path's, in tracker order. The tracker must
+ * be the canonical version 0 account; Regions away from the path, and every
+ * Region's systems, may change.
+ */
+export async function hashRegionPath(tracker, game, from, to) {
+    const data = await decodeTracker(tracker, game, true, 'The RegionTracker is not the canonical version 0 account for this Game. Refresh world region data and recreate the coordinate movement Plan.');
+    const [minX, maxX] = from.x < to.x ? [from.x, to.x] : [to.x, from.x];
+    const [minY, maxY] = from.y < to.y ? [from.y, to.y] : [to.y, from.y];
+    const regions = data.regions.unsizedList
+        .filter(({ boundingBox: box }) => box.minX.raw <= maxX &&
+        box.maxX.raw >= minX &&
+        box.minY.raw <= maxY &&
+        box.maxY.raw >= minY)
+        .map(({ id, border, boundingBox, owner, safetyStatus, riskZone }) => [
+        id,
+        border.map((point) => point.map(({ raw }) => raw)),
+        [
+            boundingBox.minX,
+            boundingBox.maxX,
+            boundingBox.minY,
+            boundingBox.maxY,
+        ].map(({ raw }) => raw),
+        owner,
+        safetyStatus,
+        riskZone,
+    ]);
+    return hashRegions(tracker, [data.regions.unsizedList.length, regions]);
+}
+//# sourceMappingURL=region-access.js.map

package/dist/internal/planning/region-access.js.map

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

package/dist/internal/planning/rent-catalog.d.ts

@@ -0,0 +1,37 @@
+import { type Address } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+/** Baseline-record hints; the program reads them only under an Active catalog. */
+export declare const DISABLED_RENT_HINTS: readonly number[];
+export interface DisabledStakeRent {
+    readonly rentCatalog: Address;
+    readonly rentAuthority: Address;
+}
+export interface DisabledLevelRent {
+    readonly rentCatalog: Address;
+    readonly rentHead: Address;
+}
+/** Requires Disabled rent for an existing Claim Stake: neither the Game's rent
+ * catalog nor the stake's settlement authority exists. */
+export declare function requireDisabledStakeRent(ctx: SageContext, game: Address, stake: Address, action: string): Promise<{
+    readonly accounts: DisabledStakeRent;
+    readonly guards: readonly PlanPrecondition[];
+}>;
+/** Requires that a new Claim Stake address has no rent settlement authority. */
+export declare function requireNewStakeRent(ctx: SageContext, stake: Address): Promise<{
+    readonly rentAuthority: Address;
+    readonly guards: readonly PlanPrecondition[];
+}>;
+/** Requires Disabled rent for a Starbase-level change in `system`: neither the
+ * Game's rent catalog nor the System's level history head exists. */
+export declare function requireDisabledLevelRent(ctx: SageContext, game: Address, system: {
+    readonly address: Address;
+    readonly systemId: number;
+}, action: string): Promise<{
+    readonly accounts: DisabledLevelRent;
+    readonly guards: readonly PlanPrecondition[];
+}>;
+/** Binds every rent account of a recognized instruction to an absence guard
+ * and rejects rent pages, supplied optional rent accounts and nonzero hints. */
+export declare function validateRentInstructions(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=rent-catalog.d.ts.map

package/dist/internal/planning/rent-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rent-catalog.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/rent-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAmB1E,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAA6B,CAAC;AAI/E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAuCD;0DAC0D;AAC1D,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C,CAAC,CAcD;AAED,gFAAgF;AAChF,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC;IACT,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C,CAAC,CAUD;AAED;qEACqE;AACrE,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAChE,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C,CAAC,CAcD;AA+ED;gFACgF;AAChF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAoCN"}