@aephia/atlas-kit 0.6.0-next.16 → 0.6.0-next.160

package/dist/internal/planning/starbase-player-owner.js

@@ -0,0 +1,17 @@
+import { SageSdkError } from '../../client/errors.js';
+import { findCharacterPda } from '../c4/character.js';
+import { deriveStarbasePlayerAddress } from '../c4/starbase.js';
+/** Requires a loaded Starbase Player to belong to the authorization Profile,
+ * reference that Profile's canonical Character in the configured Game, and sit
+ * at its canonical address; returns the Character. Fresh-state checks remain
+ * the caller's. */
+export async function requireProfileStarbasePlayer(player, profile, game) {
+    const character = await findCharacterPda(profile, game);
+    if (player.playerProfile.address !== profile ||
+        player.character.address !== character ||
+        (await deriveStarbasePlayerAddress(player.system.address, character)) !==
+            player.address)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Starbase Player ${player.address} is not the canonical registration of authorization Profile ${profile} with its canonical Character ${character} in Star System ${player.system.address}. Load that Profile's Starbase Player through this context and retry.`, { address: player.address });
+    return character;
+}
+//# sourceMappingURL=starbase-player-owner.js.map

package/dist/internal/planning/starbase-player-owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starbase-player-owner.js","sourceRoot":"","sources":["../../../src/internal/planning/starbase-player-owner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAUhE;;;mBAGmB;AACnB,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAA8B,EAC9B,OAAgB,EAChB,IAAa;IAEb,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxD,IACE,MAAM,CAAC,aAAa,CAAC,OAAO,KAAK,OAAO;QACxC,MAAM,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS;QACtC,CAAC,MAAM,2BAA2B,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACnE,MAAM,CAAC,OAAO;QAEhB,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,mBAAmB,MAAM,CAAC,OAAO,+DAA+D,OAAO,iCAAiC,SAAS,mBAAmB,MAAM,CAAC,MAAM,CAAC,OAAO,uEAAuE,EAChQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAC5B,CAAC;IACJ,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/internal/planning/starbase-system-guard.d.ts

@@ -0,0 +1,6 @@
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+/** Binds required guards to actual instruction accounts without pulling byte decoders into every action entry. */
+export declare function validateStarbaseSystemGuards(steps: readonly PlanStep[], preconditions: readonly PlanPrecondition[]): void;
+/** Hydration and assembly additionally verify exact bytes with the pinned generated decoders. */
+export declare function validateStarbaseSystemInstructions(steps: readonly PlanStep[], preconditions: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=starbase-system-guard.d.ts.map

package/dist/internal/planning/starbase-system-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starbase-system-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/starbase-system-guard.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AA6D1E,kHAAkH;AAClH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,aAAa,EAAE,SAAS,gBAAgB,EAAE,GACzC,IAAI,CAmBN;AAED,iGAAiG;AACjG,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,aAAa,EAAE,SAAS,gBAAgB,EAAE,GACzC,IAAI,CAoBN"}

package/dist/internal/planning/starbase-system-guard.js

@@ -0,0 +1,94 @@
+import { AccountRole } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { getDepositCargoToGameInstructionDataDecoder, getWithdrawCargoFromGameInstructionDataDecoder, getAddShipEscrowInstructionDataDecoder, getCancelCraftingProcessInstructionDataDecoder, SAGE_PROGRAM_ADDRESS, } from '../c4/runtime-bindings.js';
+import { ADD_SHIP_ESCROW_DISCRIMINATOR, CANCEL_CRAFTING_PROCESS_DISCRIMINATOR, DEPOSIT_CARGO_TO_GAME_DISCRIMINATOR, WITHDRAW_CARGO_FROM_GAME_DISCRIMINATOR, } from '../c4/discriminators.js';
+// Pure instruction metadata keeps the Plan factory independent of generated data decoders.
+function routeFor(instruction) {
+    if (instruction.programAddress !== SAGE_PROGRAM_ADDRESS)
+        return undefined;
+    const routes = [
+        {
+            discriminator: CANCEL_CRAFTING_PROCESS_DISCRIMINATOR,
+            decoder: 0,
+            count: 11,
+            game: 5,
+            system: 6,
+            css: false,
+            planner: 'planCancelCraftingProcess',
+        },
+        {
+            discriminator: DEPOSIT_CARGO_TO_GAME_DISCRIMINATOR,
+            decoder: 1,
+            count: 13,
+            game: 8,
+            system: 4,
+            css: true,
+            planner: 'planDepositCargoToGame',
+        },
+        {
+            discriminator: WITHDRAW_CARGO_FROM_GAME_DISCRIMINATOR,
+            decoder: 2,
+            count: 11,
+            game: 6,
+            system: 4,
+            css: false,
+            planner: 'planWithdrawCargoFromGame',
+        },
+        {
+            discriminator: ADD_SHIP_ESCROW_DISCRIMINATOR,
+            decoder: 3,
+            count: 14,
+            game: 11,
+            system: 7,
+            css: true,
+            planner: 'planDepositShipsToGame',
+        },
+    ];
+    return routes.find(({ discriminator }) => discriminator.every((byte, index) => instruction.data?.[index] === byte));
+}
+function fail(planner) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', `This Starbase action has an unsupported instruction layout or lacks its matching finite Starbase System safeguard. Recreate it with ${planner}; an exact account hash does not replace this safeguard.`);
+}
+/** Binds required guards to actual instruction accounts without pulling byte decoders into every action entry. */
+export function validateStarbaseSystemGuards(steps, preconditions) {
+    for (const { instruction } of steps) {
+        const route = routeFor(instruction);
+        if (!route)
+            continue;
+        const accounts = instruction.accounts;
+        if (accounts?.length !== route.count ||
+            accounts[route.game].role !== AccountRole.READONLY ||
+            accounts[route.system].role !== AccountRole.READONLY ||
+            !preconditions.some((guard) => guard.kind === 'starbase-system' &&
+                guard.address === accounts[route.system].address &&
+                guard.game === accounts[route.game].address &&
+                (!route.css || guard.requireCss === true)))
+            fail(route.planner);
+    }
+}
+/** Hydration and assembly additionally verify exact bytes with the pinned generated decoders. */
+export function validateStarbaseSystemInstructions(steps, preconditions) {
+    validateStarbaseSystemGuards(steps, preconditions);
+    const decoders = [
+        getCancelCraftingProcessInstructionDataDecoder,
+        getDepositCargoToGameInstructionDataDecoder,
+        getWithdrawCargoFromGameInstructionDataDecoder,
+        getAddShipEscrowInstructionDataDecoder,
+    ];
+    for (const { instruction } of steps) {
+        const route = routeFor(instruction);
+        if (!route)
+            continue;
+        let exactData = false;
+        try {
+            const [, size] = decoders[route.decoder]().read(instruction.data, 0);
+            exactData = size === instruction.data.length;
+        }
+        catch {
+            // Truncated instruction arguments are not a supported route.
+        }
+        if (!exactData)
+            fail(route.planner);
+    }
+}
+//# sourceMappingURL=starbase-system-guard.js.map

package/dist/internal/planning/starbase-system-guard.js.map

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

package/dist/internal/planning/starbase-system.d.ts

@@ -0,0 +1,15 @@
+import type { Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+type StarbaseSystemIntent = {
+    readonly address: Address;
+    readonly game: Address;
+    readonly starbaseSequenceId: bigint;
+    readonly requireCss?: boolean;
+};
+/** Checks finite System/Starbase identity and the action's station policy.
+ * `staleStarbaseGuidance` lets a planner add action-specific advice for a
+ * replaced Starbase; execution and other actions use the neutral default.
+ */
+export declare function validateStarbaseSystem(account: RawAccount, intent: StarbaseSystemIntent, staleStarbaseGuidance?: string): Promise<void>;
+export {};
+//# sourceMappingURL=starbase-system.d.ts.map

package/dist/internal/planning/starbase-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starbase-system.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/starbase-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAO5D,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAUF;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,oBAAoB,EAC5B,qBAAqB,SAA0E,GAC9F,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/internal/planning/starbase-system.js

@@ -0,0 +1,25 @@
+import { SageSdkError } from '../../client/errors.js';
+import { deriveStarSystemAddress, starSystemAccountDefinition, } from '../c4/world.js';
+function fail(address, reason) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', `${reason} Refresh the Star System and recreate the action Plan for its current Starbase.`, { address });
+}
+/** Checks finite System/Starbase identity and the action's station policy.
+ * `staleStarbaseGuidance` lets a planner add action-specific advice for a
+ * replaced Starbase; execution and other actions use the neutral default.
+ */
+export async function validateStarbaseSystem(account, intent, staleStarbaseGuidance = 'The Starbase was destroyed or replaced after this action was planned.') {
+    if (account.address !== intent.address || account.executable)
+        fail(intent.address, 'The Star System has an unexpected address or is executable instead of account state.');
+    const system = starSystemAccountDefinition.decode(account);
+    if (system.game !== intent.game ||
+        (await deriveStarSystemAddress(intent.game, system.systemId)) !==
+            intent.address)
+        fail(intent.address, `Star System ${intent.address} does not match the configured Game or canonical system-id PDA.`);
+    if (system.sequenceId !== intent.starbaseSequenceId)
+        fail(intent.address, `The Starbase sequence is stale at ${intent.starbaseSequenceId}, while Star System ${intent.address} is at sequence ${system.sequenceId}. ${staleStarbaseGuidance}`);
+    if (system.starbase === undefined)
+        fail(intent.address, `Star System ${intent.address} does not have an active Starbase.`);
+    if (intent.requireCss && system.starbase.maxLevel.kind !== 'css')
+        fail(intent.address, 'This wallet deposit requires a Central Space Station.');
+}
+//# sourceMappingURL=starbase-system.js.map

package/dist/internal/planning/starbase-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starbase-system.js","sourceRoot":"","sources":["../../../src/internal/planning/starbase-system.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AASxB,SAAS,IAAI,CAAC,OAAgB,EAAE,MAAc;IAC5C,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,GAAG,MAAM,iFAAiF,EAC1F,EAAE,OAAO,EAAE,CACZ,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAmB,EACnB,MAA4B,EAC5B,qBAAqB,GAAG,uEAAuE;IAE/F,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU;QAC1D,IAAI,CACF,MAAM,CAAC,OAAO,EACd,sFAAsF,CACvF,CAAC;IACJ,MAAM,MAAM,GAAG,2BAA2B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,IACE,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAC3B,CAAC,MAAM,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3D,MAAM,CAAC,OAAO;QAEhB,IAAI,CACF,MAAM,CAAC,OAAO,EACd,eAAe,MAAM,CAAC,OAAO,iEAAiE,CAC/F,CAAC;IACJ,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,kBAAkB;QACjD,IAAI,CACF,MAAM,CAAC,OAAO,EACd,qCAAqC,MAAM,CAAC,kBAAkB,uBAAuB,MAAM,CAAC,OAAO,mBAAmB,MAAM,CAAC,UAAU,KAAK,qBAAqB,EAAE,CACpK,CAAC;IACJ,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAC/B,IAAI,CACF,MAAM,CAAC,OAAO,EACd,eAAe,MAAM,CAAC,OAAO,oCAAoC,CAClE,CAAC;IACJ,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK;QAC9D,IAAI,CACF,MAAM,CAAC,OAAO,EACd,uDAAuD,CACxD,CAAC;AACN,CAAC"}

package/dist/internal/planning/storage-action-readers.d.ts

@@ -0,0 +1,10 @@
+import type { Address, Instruction } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import { type StorageInstruction } from './profile-storage-funding-guard.js';
+import type { StorageAction } from './storage-actions.js';
+/** Fresh accounts an instruction's storage reads, besides the Profile, Rent
+ * sysvar and Game. */
+export declare function storageActionAccounts(kind: StorageInstruction, instruction: Instruction): readonly Address[];
+/** Reads any Profile-funded instruction's storage effect, for execution. */
+export declare function readStorageAction(instruction: Instruction, accounts: ReadonlyMap<Address, RawAccount | undefined>, cargoIdForMint: (mint: Address) => number | undefined): StorageAction;
+//# sourceMappingURL=storage-action-readers.d.ts.map

package/dist/internal/planning/storage-action-readers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-action-readers.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/storage-action-readers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAU5D,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAsD1D;sBACsB;AACtB,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,WAAW,EAAE,WAAW,GACvB,SAAS,OAAO,EAAE,CAIpB;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,EACtD,cAAc,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,GACpD,aAAa,CAMf"}

package/dist/internal/planning/storage-action-readers.js

@@ -0,0 +1,58 @@
+import { readCargoStorageAction } from './cargo-storage-actions.js';
+import { readClaimStakeStorageAction } from './claim-stake-storage-actions.js';
+import { readCombatStorageAction } from './combat-storage-actions.js';
+import { readCraftingStorageAction } from './crafting-storage-actions.js';
+import { readDisbandStorageAction } from './disband-storage-actions.js';
+import { readMarketStorageAction } from './market-storage-actions.js';
+import { readMiningStorageAction } from './mining-storage-actions.js';
+import { readMovementStorageAction } from './movement-storage-actions.js';
+import { readScanStorageAction } from './scan-storage-actions.js';
+import { storageInstruction, } from './profile-storage-funding-guard.js';
+// Execution reads stimulant stats from the Game, never from the caller.
+const readCombat = (instruction, accounts) => readCombatStorageAction(instruction, accounts);
+/** Each kind's reader and the instruction accounts it reads fresh, besides the
+ * Profile, Rent sysvar and Game. */
+const READERS = {
+    deposit: { accounts: [5, 10], read: readCargoStorageAction },
+    'starbase-transfer': { accounts: [4, 8], read: readCargoStorageAction },
+    'within-fleet-transfer': { accounts: [4], read: readCargoStorageAction },
+    'start-mining': { accounts: [4], read: readMiningStorageAction },
+    'stop-mining': { accounts: [5], read: readMiningStorageAction },
+    'stop-subwarp': { accounts: [5], read: readMovementStorageAction },
+    'start-subwarp': { accounts: [5], read: readMovementStorageAction },
+    'warp-to-coordinate': { accounts: [5], read: readMovementStorageAction },
+    'warp-lane': { accounts: [5], read: readMovementStorageAction },
+    'cancel-market-orders': { accounts: [8, 7], read: readMarketStorageAction },
+    'faction-trade': {
+        accounts: [8, 9, 10, 7],
+        read: readMarketStorageAction,
+    },
+    'start-crafting': { accounts: [8, 7], read: readCraftingStorageAction },
+    'cancel-crafting': { accounts: [7, 8], read: readCraftingStorageAction },
+    'apply-stimulant': { accounts: [4, 5], read: readCombat },
+    'retrieve-loot': { accounts: [4], read: readCombat },
+    'recover-signal': { accounts: [5, 9], read: readScanStorageAction },
+    'place-claim-stake': {
+        accounts: [0, 9, 7],
+        read: readClaimStakeStorageAction,
+    },
+    'claim-stake-building-changes': {
+        accounts: [6],
+        read: readClaimStakeStorageAction,
+    },
+    'start-claim-stake-transfer': {
+        accounts: [4, 5],
+        read: readClaimStakeStorageAction,
+    },
+    disband: { accounts: [5, 8], read: readDisbandStorageAction },
+};
+/** Fresh accounts an instruction's storage reads, besides the Profile, Rent
+ * sysvar and Game. */
+export function storageActionAccounts(kind, instruction) {
+    return READERS[kind].accounts.map((index) => instruction.accounts[index].address);
+}
+/** Reads any Profile-funded instruction's storage effect, for execution. */
+export function readStorageAction(instruction, accounts, cargoIdForMint) {
+    return READERS[storageInstruction(instruction).kind].read(instruction, accounts, cargoIdForMint);
+}
+//# sourceMappingURL=storage-action-readers.js.map

package/dist/internal/planning/storage-action-readers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-action-readers.js","sourceRoot":"","sources":["../../../src/internal/planning/storage-action-readers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,kBAAkB,GAEnB,MAAM,oCAAoC,CAAC;AAS5C,wEAAwE;AACxE,MAAM,UAAU,GAAW,CAAC,WAAW,EAAE,QAAQ,EAAE,EAAE,CACnD,uBAAuB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAEjD;oCACoC;AACpC,MAAM,OAAO,GAKT;IACF,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE;IAC5D,mBAAmB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE;IACvE,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE;IACxE,cAAc,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE;IAChE,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE;IAC/D,cAAc,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE;IAClE,eAAe,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE;IACnE,oBAAoB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE;IACxE,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE;IAC/D,sBAAsB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE;IAC3E,eAAe,EAAE;QACf,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,EAAE,uBAAuB;KAC9B;IACD,gBAAgB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE;IACvE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE;IACxE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE;IACzD,eAAe,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE;IACpD,gBAAgB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE;IACnE,mBAAmB,EAAE;QACnB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,EAAE,2BAA2B;KAClC;IACD,8BAA8B,EAAE;QAC9B,QAAQ,EAAE,CAAC,CAAC,CAAC;QACb,IAAI,EAAE,2BAA2B;KAClC;IACD,4BAA4B,EAAE;QAC5B,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAChB,IAAI,EAAE,2BAA2B;KAClC;IACD,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE;CAC9D,CAAC;AAEF;sBACsB;AACtB,MAAM,UAAU,qBAAqB,CACnC,IAAwB,EACxB,WAAwB;IAExB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAC/B,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,QAAS,CAAC,KAAK,CAAE,CAAC,OAAO,CACjD,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAC/B,WAAwB,EACxB,QAAsD,EACtD,cAAqD;IAErD,OAAO,OAAO,CAAC,kBAAkB,CAAC,WAAW,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CACxD,WAAW,EACX,QAAQ,EACR,cAAc,CACf,CAAC;AACJ,CAAC"}

package/dist/internal/planning/storage-actions.d.ts

@@ -0,0 +1,89 @@
+import { type Address, type Instruction } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import type { PlanStep } from '../../planning/index.js';
+import { type ProfileStorageFundingGuard, type StorageInstruction } from './profile-storage-funding-guard.js';
+import { type ProfileStorageFunding } from './profile-storage-funding.js';
+export type CargoLines = ReadonlyMap<number, bigint>;
+/** The encoded size of a Fleet's state in the fresh account and after the
+ * action. A Plan tracks each Fleet's state across its actions, so a change is
+ * measured from the state the earlier actions left, not the fresh one. */
+export interface StateChange {
+    readonly fresh: number;
+    readonly after: number;
+}
+/** One account an action resizes or creates: a fixed byte change (such as the
+ * orders a Local Market drops, or the whole size of a new account), a Fleet
+ * state change, and, when it changes a cargo pod, the lines the fresh pod
+ * holds and those the action adds to and consumes from. */
+export type StorageAccount = {
+    readonly address: Address;
+    /** The action creates the account, so it starts empty and unfunded. */
+    readonly created?: true;
+    readonly growthBytes?: number;
+    /** Bytes the program funds beyond the account's size, such as the growth a
+     * Claim Stake's rent floor reserves. */
+    readonly reservedBytes?: number;
+    readonly state?: StateChange;
+} & ({
+    readonly held?: undefined;
+} | {
+    readonly held: CargoLines;
+    readonly added: CargoLines;
+    readonly removed?: CargoLines;
+});
+/** How the program settles the resized accounts: each normalized on its own,
+ * or one net shortfall across them, where one account's surplus funds another. */
+export type StorageSettlement = 'each' | 'net';
+/** What one instruction does to Profile-funded storage, read from its bytes. */
+export interface StorageAction {
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly keyIndex: number;
+    readonly settlement: StorageSettlement;
+    readonly accounts: readonly [StorageAccount, ...StorageAccount[]];
+}
+/** One evaluated action's Profile debit. */
+export interface StorageEvaluation {
+    readonly profileDebit: bigint;
+}
+export declare const NONE: CargoLines;
+export declare function totals(entries: readonly (readonly [number, bigint | undefined])[]): CargoLines;
+export declare function present(accounts: ReadonlyMap<Address, RawAccount | undefined>, address: Address): RawAccount;
+/** Evaluates actions in order, as the program runs them: each resized account
+ * changes by its state change plus a line per cargo id a pod gains and minus a
+ * line its consumption empties, and after each action every resized account
+ * holds exactly the rent minimum of its new size. Later actions therefore see
+ * the state, storage and surplus earlier ones left. */
+export declare function evaluateStorage(actions: readonly StorageAction[], accounts: ReadonlyMap<Address, RawAccount | undefined>): readonly StorageEvaluation[];
+/** The Profile-funded steps of a Plan, in order. */
+export declare function storageSteps(steps: readonly PlanStep[]): readonly (PlanStep & {
+    readonly kind: StorageInstruction;
+    readonly signer: number;
+})[];
+/** One guard's rechecked funding, or the failure to report for it. */
+export type StorageResult = {
+    readonly funding: ProfileStorageFunding;
+} | {
+    readonly error: unknown;
+};
+/** Rechecks every Profile-funded action's storage before signing. Each
+ * action's effect is rederived from its instruction bytes and the fresh
+ * accounts, never taken from its guard, and the actions are evaluated in order
+ * so each meets the state, storage and surplus the earlier ones left. Each
+ * debit must stay within its guard's ceiling and pass the key and balance
+ * checks. A Fleet whose state an earlier, unevaluated action writes is refused,
+ * since its state change could not be measured. */
+export declare function validateStorageFunding(steps: readonly PlanStep[], guards: readonly ProfileStorageFundingGuard[], accounts: ReadonlyMap<Address, RawAccount | undefined>, readAction: (instruction: Instruction) => StorageAction): ReadonlyMap<ProfileStorageFundingGuard, StorageResult>;
+/** Plans one action's storage funding from the same derivation execution
+ * repeats: its guard and the Plan summary sentence. */
+export declare function planStorageFunding(input: {
+    readonly action: StorageAction;
+    readonly accounts: ReadonlyMap<Address, RawAccount | undefined>;
+    readonly label: string;
+    /** Actions the Plan is meant to run first, such as a subwarp settlement. */
+    readonly preceding?: readonly StorageAction[];
+}): {
+    readonly guard: ProfileStorageFundingGuard;
+    readonly disclosure: string;
+};
+//# sourceMappingURL=storage-actions.d.ts.map

package/dist/internal/planning/storage-actions.d.ts.map

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

package/dist/internal/planning/storage-actions.js

@@ -0,0 +1,183 @@
+import { isWritableRole } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { CARGO_LINE_BYTES, storageInstruction, } from './profile-storage-funding-guard.js';
+import { checkProfileStorageFunding, profileStorageFundingGuard, } from './profile-storage-funding.js';
+import { RENT_ADDRESS, readRent } from './rent.js';
+export const NONE = new Map();
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+export function totals(entries) {
+    const sums = new Map();
+    for (const [cargoId, amount] of entries)
+        if (amount !== undefined && amount > 0n)
+            sums.set(cargoId, (sums.get(cargoId) ?? 0n) + amount);
+    return sums;
+}
+export function present(accounts, address) {
+    const raw = accounts.get(address);
+    if (!raw || raw.executable)
+        fail(address, `Account ${address} is missing or executable, so the action's storage funding cannot be checked. Refresh it and replan the action.`);
+    return raw;
+}
+/** Evaluates actions in order, as the program runs them: each resized account
+ * changes by its state change plus a line per cargo id a pod gains and minus a
+ * line its consumption empties, and after each action every resized account
+ * holds exactly the rent minimum of its new size. Later actions therefore see
+ * the state, storage and surplus earlier ones left. */
+export function evaluateStorage(actions, accounts) {
+    const rent = readRent(present(accounts, RENT_ADDRESS));
+    const state = new Map();
+    return actions.map((action) => {
+        let deficit = 0n;
+        let excess = 0n;
+        for (const account of action.accounts) {
+            let current = state.get(account.address);
+            if (!current) {
+                const raw = account.created
+                    ? undefined
+                    : present(accounts, account.address);
+                current = {
+                    lamports: raw?.lamports ?? 0n,
+                    length: raw?.data.length ?? 0,
+                };
+                state.set(account.address, current);
+            }
+            if (account.state) {
+                current.length +=
+                    account.state.after - (current.state ?? account.state.fresh);
+                current.state = account.state.after;
+            }
+            let lines = 0;
+            if (account.held !== undefined) {
+                current.lines ??= new Map(account.held);
+                const { added } = account;
+                const removed = account.removed ?? NONE;
+                for (const cargoId of new Set([...added.keys(), ...removed.keys()])) {
+                    const held = current.lines.get(cargoId);
+                    const after = (held ?? 0n) +
+                        (added.get(cargoId) ?? 0n) -
+                        (removed.get(cargoId) ?? 0n);
+                    if (held === undefined && after > 0n)
+                        lines += 1;
+                    else if (held !== undefined && after <= 0n)
+                        lines -= 1;
+                    // Only consumption can empty a line; an added line stays positive.
+                    if (after > 0n)
+                        current.lines.set(cargoId, after);
+                    else
+                        current.lines.delete(cargoId);
+                }
+            }
+            current.length += (account.growthBytes ?? 0) + lines * CARGO_LINE_BYTES;
+            // The program leaves a zero-lamport account unchanged, unless the action
+            // creates it and funds its rent.
+            if (current.lamports === 0n && !account.created)
+                continue;
+            const minimum = rent(current.length + (account.reservedBytes ?? 0));
+            if (current.lamports < minimum)
+                deficit += minimum - current.lamports;
+            else
+                excess += current.lamports - minimum;
+            current.lamports = minimum;
+        }
+        const profileDebit = action.settlement === 'each'
+            ? deficit
+            : deficit > excess
+                ? deficit - excess
+                : 0n;
+        return { profileDebit };
+    });
+}
+/** The Profile-funded steps of a Plan, in order. */
+export function storageSteps(steps) {
+    return steps.flatMap((step) => {
+        const known = storageInstruction(step.instruction);
+        return known ? [{ ...step, kind: known.kind, signer: known.signer }] : [];
+    });
+}
+/** Rechecks every Profile-funded action's storage before signing. Each
+ * action's effect is rederived from its instruction bytes and the fresh
+ * accounts, never taken from its guard, and the actions are evaluated in order
+ * so each meets the state, storage and surplus the earlier ones left. Each
+ * debit must stay within its guard's ceiling and pass the key and balance
+ * checks. A Fleet whose state an earlier, unevaluated action writes is refused,
+ * since its state change could not be measured. */
+export function validateStorageFunding(steps, guards, accounts, readAction) {
+    const results = new Map();
+    const remaining = [...guards];
+    const unevaluated = new Set();
+    const bound = [];
+    for (const { instruction } of steps) {
+        const known = storageInstruction(instruction);
+        if (!known) {
+            for (const meta of instruction.accounts ?? [])
+                if (isWritableRole(meta.role))
+                    unevaluated.add(meta.address);
+            continue;
+        }
+        const action = readAction(instruction);
+        for (const account of action.accounts)
+            if (account.state && unevaluated.has(account.address))
+                fail(account.address, `An earlier action in this Plan changes Fleet ${account.address} before an action whose storage depends on the Fleet's state, so that storage cannot be bounded. Execute the earlier action as its own Plan, refresh the Fleet and replan.`);
+        if (!known.guarded) {
+            bound.push({ guard: undefined, action });
+            continue;
+        }
+        // Plan validation already bound each guarded instruction to exactly one
+        // guard.
+        const index = remaining.findIndex((guard) => guard.profile === action.profile &&
+            guard.authority === action.authority &&
+            guard.address === action.accounts[0].address);
+        const [guard] = remaining.splice(index, 1);
+        bound.push({ guard: guard, action });
+    }
+    const ordered = evaluateStorage(bound.map(({ action }) => action), accounts);
+    bound.forEach(({ guard, action }, index) => {
+        const { profileDebit } = ordered[index];
+        if (!guard) {
+            // A subwarp stop only shrinks a rent-exact Fleet. Anything else
+            // would be a draw no guard bounds.
+            if (profileDebit > 0n)
+                fail(action.accounts[0].address, `Stopping Fleet ${action.accounts[0].address}'s subwarp now needs ${profileDebit} Profile lamports for storage, which this Plan does not bound. Settle the subwarp as its own Plan, refresh the Fleet and replan.`);
+            return;
+        }
+        try {
+            results.set(guard, {
+                funding: checkProfileStorageFunding({
+                    profileRaw: present(accounts, guard.profile),
+                    rentRaw: present(accounts, RENT_ADDRESS),
+                    authority: action.authority,
+                    keyIndex: action.keyIndex,
+                    profileDebit,
+                    action: 'action',
+                    maximumProfileDebit: guard.maximumProfileDebit,
+                }),
+            });
+        }
+        catch (error) {
+            results.set(guard, { error });
+        }
+    });
+    return results;
+}
+/** Plans one action's storage funding from the same derivation execution
+ * repeats: its guard and the Plan summary sentence. */
+export function planStorageFunding(input) {
+    const { action } = input;
+    const evaluated = evaluateStorage([...(input.preceding ?? []), action], input.accounts).at(-1);
+    return profileStorageFundingGuard({
+        address: action.accounts[0].address,
+        profile: action.profile,
+        authority: action.authority,
+        funding: checkProfileStorageFunding({
+            profileRaw: present(input.accounts, action.profile),
+            rentRaw: present(input.accounts, RENT_ADDRESS),
+            authority: action.authority,
+            keyIndex: action.keyIndex,
+            profileDebit: evaluated.profileDebit,
+            action: input.label,
+        }),
+    });
+}
+//# sourceMappingURL=storage-actions.js.map

package/dist/internal/planning/storage-actions.js.map

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

package/dist/internal/planning/token-mint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-mint.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/token-mint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CA2B7D"}
+{"version":3,"file":"token-mint.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/token-mint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAI5D,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CA2B7D"}

package/dist/internal/planning/token-mint.js

@@ -1,8 +1,9 @@
 import { SageSdkError } from '../../client/errors.js';
+import { ORIGINAL_TOKEN_PROGRAM } from './original-token.js';
 /** Validate the finite original Token Mint facts used by wallet transfers. */
 export function validateTokenMint(account) {
     if (account.executable ||
-        account.owner !== 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA' ||
+        account.owner !== ORIGINAL_TOKEN_PROGRAM ||
         account.data.length !== 82)
         throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Mint ${account.address} must be a non-executable original Token Mint with exactly 82 bytes. Refresh the mint or select a supported original Token mint; Token-2022 is unsupported.`, { address: account.address });
     const view = new DataView(account.data.buffer, account.data.byteOffset, account.data.byteLength);

package/dist/internal/planning/token-mint.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-mint.js","sourceRoot":"","sources":["../../../src/internal/planning/token-mint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,OAAmB;IACnD,IACE,OAAO,CAAC,UAAU;QAClB,OAAO,CAAC,KAAK,KAAK,6CAA6C;QAC/D,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE;QAE1B,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,QAAQ,OAAO,CAAC,OAAO,6JAA6J,EACpL,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;IACJ,MAAM,IAAI,GAAG,IAAI,QAAQ,CACvB,OAAO,CAAC,IAAI,CAAC,MAAM,EACnB,OAAO,CAAC,IAAI,CAAC,UAAU,EACvB,OAAO,CAAC,IAAI,CAAC,UAAU,CACxB,CAAC;IACF,IACE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC;QAC3B,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC;QAEvB,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,QAAQ,OAAO,CAAC,OAAO,qGAAqG,EAC5H,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;IACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"token-mint.js","sourceRoot":"","sources":["../../../src/internal/planning/token-mint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,OAAmB;IACnD,IACE,OAAO,CAAC,UAAU;QAClB,OAAO,CAAC,KAAK,KAAK,sBAAsB;QACxC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE;QAE1B,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,QAAQ,OAAO,CAAC,OAAO,6JAA6J,EACpL,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;IACJ,MAAM,IAAI,GAAG,IAAI,QAAQ,CACvB,OAAO,CAAC,IAAI,CAAC,MAAM,EACnB,OAAO,CAAC,IAAI,CAAC,UAAU,EACvB,OAAO,CAAC,IAAI,CAAC,UAAU,CACxB,CAAC;IACF,IACE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC;QAC3B,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC;QAEvB,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,QAAQ,OAAO,CAAC,OAAO,qGAAqG,EAC5H,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;IACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC"}

package/dist/internal/planning/trade-faction-market.d.ts

@@ -0,0 +1,20 @@
+import { type Address } from '@solana/kit';
+import { type PlanAuthorization, type AddressOnlyInstruction } from './authorization-adapter.js';
+/** Address-only adapter for one directional Faction Market trade. */
+export declare function adaptTradeFactionMarketInstruction(input: {
+    readonly authorization: PlanAuthorization;
+    readonly character: Address;
+    readonly game: Address;
+    readonly system: Address;
+    readonly starbasePlayer: Address;
+    readonly fleet: Address;
+    readonly factionMarket: Address;
+    readonly treasury: Address;
+    readonly factionStanding?: Address;
+    readonly factionConfig?: Address;
+    readonly factionEpochMeter?: Address;
+    readonly offerIndex: number;
+    readonly quantity: bigint;
+    readonly playerBuys: boolean;
+}): AddressOnlyInstruction;
+//# sourceMappingURL=trade-faction-market.d.ts.map

package/dist/internal/planning/trade-faction-market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-faction-market.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/trade-faction-market.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EAGb,MAAM,aAAa,CAAC;AAMrB,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC5B,MAAM,4BAA4B,CAAC;AA8CpC,qEAAqE;AACrE,wBAAgB,kCAAkC,CAAC,KAAK,EAAE;IACxD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B,GAAG,sBAAsB,CAyBzB"}