@aephia/atlas-kit 0.6.0-next.6 → 0.6.0-next.61

package/dist/fleets/actions/respawn.js

@@ -0,0 +1,122 @@
+import { isAddress, isOffCurveAddress } from '@solana/kit';
+import { InvalidActionInputError } from '../../client/errors.js';
+import { requireGameAddress } from '../../internal/game-context.js';
+import { resolveFleetRespawn } from '../../internal/planning/fleet-respawn.js';
+import { createPlan } from '../../planning/index.js';
+function options(input) {
+    const bad = () => {
+        throw new InvalidActionInputError('options', input, 'authorization and system only; direct authority, Profile and u16 keyIndex', 'Pass address-only Fleet recovery options. Certificates and other access routes are unsupported; use a direct Profile key and an existing own-faction StarbasePlayer.');
+    };
+    if (input === null || typeof input !== 'object' || Array.isArray(input))
+        bad();
+    const value = input;
+    if (Object.keys(value).length !== 2 ||
+        !Object.hasOwn(value, 'authorization') ||
+        !Object.hasOwn(value, 'system'))
+        bad();
+    const authorization = value.authorization;
+    if (authorization === null ||
+        typeof authorization !== 'object' ||
+        Array.isArray(authorization))
+        bad();
+    const a = authorization;
+    if (Object.keys(a).length !== 3 ||
+        !Object.hasOwn(a, 'profile') ||
+        !Object.hasOwn(a, 'authority') ||
+        !Object.hasOwn(a, 'keyIndex') ||
+        typeof a.profile !== 'string' ||
+        !isAddress(a.profile) ||
+        typeof a.authority !== 'string' ||
+        !isAddress(a.authority) ||
+        isOffCurveAddress(a.authority) ||
+        !Number.isInteger(a.keyIndex) ||
+        typeof a.keyIndex !== 'number' ||
+        a.keyIndex < 0 ||
+        a.keyIndex > 65535 ||
+        typeof value.system !== 'string' ||
+        !isAddress(value.system))
+        bad();
+    return {
+        authorization: {
+            profile: a.profile,
+            authority: a.authority,
+            keyIndex: a.keyIndex,
+        },
+        system: value.system,
+    };
+}
+async function planRecovery(ctx, fleet, input, phase) {
+    const captured = options(input);
+    if (typeof fleet !== 'string' || !isAddress(fleet))
+        throw new InvalidActionInputError('fleet', fleet, 'a Fleet address', 'Pass the owned Fleet address to prepare recovery.');
+    const intent = {
+        phase,
+        fleet,
+        game: requireGameAddress(ctx),
+        ...captured.authorization,
+        system: captured.system,
+    };
+    const current = await resolveFleetRespawn(ctx, intent);
+    const inventory = current.inventory;
+    const cargo = inventory.cargo
+        .map((item) => `cargo ID ${item.cargoId}: ${item.amount} raw units`)
+        .join(', ') || 'empty';
+    const inventoryDisclosure = phase === 'start'
+        ? ` Inventory exposed to recovery: cargo hold [${cargo}]; ammunition (cargo ID ${inventory.ammunition.cargoId}): ${inventory.ammunition.amount} raw units; Fuel (cargo ID ${inventory.fuel.cargoId}): ${inventory.fuel.amount} raw units.`
+        : '';
+    const summary = `${phase === 'start' ? 'Start timed recovery for Idle' : 'Complete elapsed recovery for'} Fleet ${fleet} at faction CSS ${intent.system}. Observed recovery fee: ${current.recoveryFee} ATLAS Floyds (100,000,000 Floyds per ATLAS); Profile storage debit: ${current.profileDebit} lamports. These amounts are rechecked before signing, not atomic spending caps. Transaction fees are separate.${inventoryDisclosure} Recovery can destroy cargo or other assets; preservation of ships, crew and HP is not guaranteed. Simulate and inspect before signing. Refresh the Fleet after confirmation; completion is established only by Docked state at this CSS. Start and completion must be separate transactions.`;
+    return createPlan({
+        kind: `fleets.${phase}-respawn`,
+        summary,
+        preconditions: [
+            {
+                kind: 'fleet-respawn',
+                address: fleet,
+                game: intent.game,
+                profile: intent.profile,
+                authority: intent.authority,
+                keyIndex: intent.keyIndex,
+                system: intent.system,
+                phase,
+                fleetHash: current.fleetHash,
+                maximumRecoveryFee: current.recoveryFee,
+                maximumProfileDebit: current.profileDebit,
+                describes: 'Selected Fleet state and assets remain unchanged since planning; canonical faction CSS, direct permission, chain timer and funding remain valid within the reviewed amounts.',
+            },
+        ],
+        steps: [
+            {
+                instruction: current.instruction,
+                signers: [intent.authority],
+                describes: summary,
+            },
+        ],
+    });
+}
+/** Prepares explicit timed recovery for an owned Idle Fleet, including a zero-Fuel Fleet.
+ * Requires Character ATLAS for the current hull recovery fees. Never deposits funds,
+ * signs, submits, waits or automatically falls back from movement. Recovery may lose assets.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, options: PlanFleetRespawnOptions;
+ * const plan = await planFleetStartRespawn(ctx, fleet, options);
+ * console.log(plan.describe());
+ * ```
+ */
+export function planFleetStartRespawn(ctx, fleet, options) {
+    return planRecovery(ctx, fleet, options, 'start');
+}
+/** Prepares timed completion only after the stored Respawn end time according to chain Clock.
+ * Uses the explicit Respawn-to-Docked route; never pays to bypass the timer.
+ * Refresh confirmed state to establish arrival at the faction CSS; simulation is not confirmation.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, options: PlanFleetRespawnOptions;
+ * const plan = await planFleetCompleteRespawn(ctx, fleet, options);
+ * console.log(plan.describe());
+ * ```
+ */
+export function planFleetCompleteRespawn(ctx, fleet, options) {
+    return planRecovery(ctx, fleet, options, 'complete');
+}
+//# sourceMappingURL=respawn.js.map

package/dist/fleets/actions/respawn.js.map

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

package/dist/fleets/actions/ship-import.d.ts

@@ -0,0 +1,48 @@
+import { type Address } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+import type { EntityRef } from '../../client/refs.js';
+import { type PlanAuthorization } from '../../internal/planning/authorization-adapter.js';
+import { type Plan } from '../../planning/index.js';
+interface ShipImportStarbaseIntent {
+    readonly kind: 'starbasePlayer';
+    readonly address: Address;
+    readonly playerProfile: EntityRef<'profile'>;
+    readonly character: EntityRef<'character'>;
+    readonly system: EntityRef<'starSystem'>;
+}
+/** Exact whole ships to import under one explicit configuration ID.
+ * Optional escrow creation requires an explicit payer; it never registers onboarding accounts.
+ * @example
+ * ```ts
+ * declare const owner: Address;
+ * declare const authorization: PlanAuthorization;
+ * const options: PlanDepositShipsToGameOptions = { shipId: 1, amount: 2n, owner, authorization };
+ * ```
+ */
+export interface PlanDepositShipsToGameOptions {
+    readonly shipId: number;
+    readonly amount: bigint;
+    readonly owner: Address;
+    readonly authorization: PlanAuthorization;
+    readonly source?: Address;
+    readonly escrowAccount?: {
+        readonly mode: 'create-if-missing';
+        readonly payer: Address;
+    };
+}
+/** Plans importing whole ship tokens into a registered player's CSS ship escrow.
+ * Requires direct Profile AUTH and token-owner authorization. The Profile vault
+ * funds any StarbasePlayer storage shortfall; an explicit ATA payer funds optional
+ * escrow creation. Fees are separate. No Fleet is created and no signer is retained.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const starbase: import('@aephia/atlas-kit/starbases').StarbasePlayerSnapshot;
+ * declare const options: PlanDepositShipsToGameOptions;
+ * const plan = await planDepositShipsToGame(ctx, starbase, options);
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planDepositShipsToGame(ctx: SageContext, starbase: ShipImportStarbaseIntent, options: PlanDepositShipsToGameOptions): Promise<Plan>;
+export {};
+//# sourceMappingURL=ship-import.d.ts.map

package/dist/fleets/actions/ship-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship-import.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/ship-import.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAkBtD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAkB1D,OAAO,EAEL,KAAK,IAAI,EAGV,MAAM,yBAAyB,CAAC;AAEjC,UAAU,wBAAwB;IAChC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;CAC1C;AACD;;;;;;;;GAQG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE;QACvB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;QACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;KACzB,CAAC;CACH;AA2GD;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAyUf"}

package/dist/fleets/actions/ship-import.js

@@ -0,0 +1,330 @@
+import { validateStarbaseSystem } from '../../internal/planning/starbase-system.js';
+import { resolveShipImportFunding, validateShipImportFunding, } from '../../internal/planning/ship-import-funding.js';
+import { isAddress, isOffCurveAddress } from '@solana/kit';
+import { InvalidActionInputError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { characterAccountDefinition, profileAccountDefinition, findCharacterPda, } from '../../internal/c4/identity.js';
+import { deriveStarbasePlayerAddress, starbasePlayerAccountDefinition, } from '../../internal/c4/starbase.js';
+import { deriveStarSystemAddress, starSystemAccountDefinition, } from '../../internal/c4/world.js';
+import { PLAYER_PROFILE_PROGRAM_ADDRESS } from '../../internal/c4/faction-enrollment.js';
+import { requireGameAddress } from '../../internal/game-context.js';
+import { adaptAddShipEscrowInstruction, validatePlanAuthorization, } from '../../internal/planning/authorization-adapter.js';
+import { hashAccountState } from '../../internal/planning/account-state.js';
+import { readRent, readClock, RENT_ADDRESS, CLOCK_ADDRESS, } from '../../internal/planning/faction-enrollment.js';
+import { deriveShipTokenAddress, validateShipMint, validateShipToken, failShipImport, ORIGINAL_TOKEN_PROGRAM, ATA_PROGRAM, SYSTEM_PROGRAM, } from '../../internal/planning/ship-token.js';
+import { readFreshGameShipConfiguration } from '../../registry/ships.js';
+import { createPlan, } from '../../planning/index.js';
+function address(value) {
+    return typeof value === 'string' && isAddress(value);
+}
+function invalid(field, value, expected) {
+    throw new InvalidActionInputError(field, value, expected, 'Select an explicit ship configuration, positive bigint amount and address-only authorization before planning again.');
+}
+function validate(options) {
+    if (!options ||
+        typeof options !== 'object' ||
+        Array.isArray(options) ||
+        Object.keys(options).some((k) => ![
+            'shipId',
+            'amount',
+            'owner',
+            'authorization',
+            'source',
+            'escrowAccount',
+        ].includes(k)))
+        invalid('options', options, 'ship import options only');
+    if (typeof options.amount !== 'bigint' ||
+        options.amount <= 0n ||
+        options.amount > (1n << 64n) - 1n)
+        invalid('amount', options.amount, 'a positive u64 bigint');
+    if (typeof options.shipId !== 'number' ||
+        !Number.isInteger(options.shipId) ||
+        options.shipId < 0 ||
+        options.shipId > 65535)
+        invalid('shipId', options.shipId, 'an explicit u16 ship configuration ID');
+    if (!address(options.owner) || isOffCurveAddress(options.owner))
+        invalid('owner', options.owner, 'a directly signing token owner address');
+    if (options.source !== undefined && !address(options.source))
+        invalid('source', options.source, 'an existing token account address');
+    const a = options.authorization;
+    if (!a ||
+        typeof a !== 'object' ||
+        Array.isArray(a) ||
+        Object.keys(a).some((k) => !['profile', 'authority', 'keyIndex', 'certificate'].includes(k)) ||
+        !address(a.profile) ||
+        !address(a.authority) ||
+        isOffCurveAddress(a.authority) ||
+        (a.certificate !== undefined && !address(a.certificate)))
+        invalid('authorization', a, 'valid Profile, direct authority, keyIndex and optional certificate addresses');
+    validatePlanAuthorization(a);
+    const e = options.escrowAccount;
+    if (e !== undefined &&
+        (!e ||
+            typeof e !== 'object' ||
+            Array.isArray(e) ||
+            Object.keys(e).some((k) => !['mode', 'payer'].includes(k)) ||
+            e.mode !== 'create-if-missing' ||
+            !address(e.payer) ||
+            isOffCurveAddress(e.payer)))
+        invalid('escrowAccount', e, '{ mode: create-if-missing, payer: a directly signing address }');
+}
+function required(raw, account, role) {
+    return (raw ??
+        failShipImport(`${role} ${account} is missing. Complete onboarding or create the required account separately.`, account));
+}
+async function observe(raw, role) {
+    return {
+        kind: 'account-state',
+        address: raw.address,
+        dataHash: await hashAccountState(raw.owner, raw.data),
+        describes: `${role} ${raw.address} retains its observed owner and data; native balance is an observation, not reserved. Refresh and replan if it changes.`,
+    };
+}
+/** Plans importing whole ship tokens into a registered player's CSS ship escrow.
+ * Requires direct Profile AUTH and token-owner authorization. The Profile vault
+ * funds any StarbasePlayer storage shortfall; an explicit ATA payer funds optional
+ * escrow creation. Fees are separate. No Fleet is created and no signer is retained.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const starbase: import('@aephia/atlas-kit/starbases').StarbasePlayerSnapshot;
+ * declare const options: PlanDepositShipsToGameOptions;
+ * const plan = await planDepositShipsToGame(ctx, starbase, options);
+ * console.log(plan.describe());
+ * ```
+ */
+export async function planDepositShipsToGame(ctx, starbase, options) {
+    validate(options);
+    if (!starbase ||
+        starbase.kind !== 'starbasePlayer' ||
+        !address(starbase.address) ||
+        !address(starbase.system?.address) ||
+        !address(starbase.playerProfile?.address) ||
+        !address(starbase.character?.address))
+        invalid('starbase', starbase, 'a loaded StarbasePlayer snapshot');
+    // Capture caller-owned input before PDA derivation or the first asynchronous read.
+    // Plans must retain the validated intent even if the application edits its form.
+    options = {
+        ...options,
+        authorization: { ...options.authorization },
+        ...(options.escrowAccount
+            ? { escrowAccount: { ...options.escrowAccount } }
+            : {}),
+    };
+    starbase = {
+        kind: 'starbasePlayer',
+        address: starbase.address,
+        system: { ...starbase.system },
+        character: { ...starbase.character },
+        playerProfile: { ...starbase.playerProfile },
+    };
+    const { authorization, owner, shipId, amount } = options;
+    const game = requireGameAddress(ctx), character = await findCharacterPda(authorization.profile, game), player = await deriveStarbasePlayerAddress(starbase.system.address, character);
+    if (starbase.address !== player ||
+        starbase.character.address !== character ||
+        starbase.playerProfile.address !== authorization.profile)
+        failShipImport('The loaded StarbasePlayer must be the canonical registration for the authorized Profile and Character.', starbase.address);
+    const config = await readFreshGameShipConfiguration(ctx, shipId), mint = config.ship.mint;
+    const source = options.source ?? (await deriveShipTokenAddress(owner, mint)), escrow = await deriveShipTokenAddress(character, mint);
+    if (source === escrow)
+        failShipImport('Source and Character escrow must be different token accounts.', source);
+    const addresses = [
+        authorization.profile,
+        character,
+        player,
+        starbase.system.address,
+        mint,
+        source,
+        RENT_ADDRESS,
+        CLOCK_ADDRESS,
+        escrow,
+        owner,
+    ];
+    const values = await readContextRawAccounts(ctx, addresses);
+    const profileRaw = required(values[0], addresses[0], 'Profile'), characterRaw = required(values[1], character, 'Character'), playerRaw = required(values[2], player, 'StarbasePlayer'), systemRaw = required(values[3], addresses[3], 'System'), mintRaw = required(values[4], mint, 'Ship mint'), sourceRaw = required(values[5], source, 'Ship source'), rentRaw = required(values[6], RENT_ADDRESS, 'Rent sysvar'), clockRaw = required(values[7], CLOCK_ADDRESS, 'Clock sysvar');
+    const escrowRaw = values[8], ownerRaw = values[9];
+    for (const raw of [profileRaw, characterRaw, playerRaw, systemRaw])
+        if (raw.executable)
+            failShipImport('A gameplay prerequisite is executable rather than account state.', raw.address);
+    const p = profileAccountDefinition.decode(profileRaw), c = characterAccountDefinition.decode(characterRaw), s = starbasePlayerAccountDefinition.decode(playerRaw), w = starSystemAccountDefinition.decode(systemRaw);
+    if (c.playerProfile !== authorization.profile ||
+        c.game !== game ||
+        s.playerProfile !== authorization.profile ||
+        s.character !== character ||
+        s.system !== starbase.system.address ||
+        w.game !== game ||
+        (await deriveStarSystemAddress(game, w.systemId)) !==
+            starbase.system.address)
+        failShipImport('Fresh Character, StarbasePlayer and System relationships must match the configured Game and authorized Profile.', player);
+    const systemGuard = {
+        kind: 'starbase-system',
+        address: systemRaw.address,
+        game,
+        starbaseSequenceId: w.sequenceId,
+        requireCss: true,
+        describes: 'The canonical Star System retains its active Starbase and generation as a Central Space Station; unrelated shared activity may change.',
+    };
+    await validateStarbaseSystem(systemRaw, systemGuard);
+    const key = p.keys[authorization.keyIndex], now = readClock(clockRaw);
+    if (!key ||
+        key.address !== authorization.authority ||
+        key.scope !== PLAYER_PROFILE_PROGRAM_ADDRESS ||
+        (key.permissionsRaw & 1n) === 0n)
+        failShipImport('Ship import supports a direct Profile AUTH key. Select a matching authorized Profile key; delegated certificates and other permission scopes are not yet verified.', profileRaw.address);
+    if (key.expiresAtRaw >= 0n && key.expiresAtRaw < now)
+        failShipImport('The selected Profile key has expired. Choose a current AUTH key.', profileRaw.address);
+    if (ownerRaw &&
+        ownerRaw.data.length === 355 &&
+        (ownerRaw.owner === ORIGINAL_TOKEN_PROGRAM ||
+            ownerRaw.owner === 'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb'))
+        failShipImport('Token multisig owners are unsupported. Use a directly signing token owner.', owner);
+    validateShipMint(mintRaw);
+    const sourceAmount = validateShipToken(sourceRaw, mint, owner);
+    if (sourceAmount < amount)
+        failShipImport(`Source has ${sourceAmount} ships but import requests ${amount}. Reduce the amount.`, source);
+    const existingCredit = s.shipsInEscrow.find((item) => item.shipId === shipId);
+    if ((existingCredit?.quantityRaw ?? 0n) + amount > (1n << 64n) - 1n)
+        failShipImport('The selected ship inventory would exceed u64 capacity. Reduce the amount.', player);
+    const fundingIntent = {
+        address: player,
+        game,
+        profile: authorization.profile,
+        system: starbase.system.address,
+        shipId,
+    };
+    const resolvedFunding = await resolveShipImportFunding(fundingIntent);
+    const { profileDebit: growthFunding } = validateShipImportFunding(fundingIntent, resolvedFunding, new Map(addresses.map((address, index) => [address, values[index]])));
+    const minimum = readRent(rentRaw);
+    const preconditions = [
+        systemGuard,
+        {
+            kind: 'ship-import-funding',
+            ...fundingIntent,
+            maximumProfileDebit: growthFunding,
+            describes: 'Profile reserve and actual StarbasePlayer storage shortfall remain affordable within the approved debit ceiling; target prefunding may reduce the debit.',
+        },
+        {
+            kind: 'token-mint',
+            address: mintRaw.address,
+            decimals: 0,
+            describes: `Mint ${mintRaw.address} remains a valid initialized original Token Mint with unchanged decimals; supply and authorities may change.`,
+        },
+        {
+            kind: 'game-ship-config',
+            address: game,
+            shipId,
+            configHash: config.configHash,
+            describes: 'The selected ship configuration remains unchanged; unrelated Game definitions may change.',
+        },
+        {
+            kind: 'token-account',
+            address: source,
+            mint,
+            owner,
+            minimumBalance: amount,
+            describes: 'Source remains an initialized unfrozen original Token account with sufficient whole ships.',
+        },
+        ...(await Promise.all([
+            [profileRaw, 'Profile authorization'],
+            [characterRaw, 'Character identity'],
+            [playerRaw, 'Player ship inventory'],
+            [rentRaw, 'Rent pricing'],
+            ...(ownerRaw ? [[ownerRaw, 'Token owner identity']] : []),
+        ].map(([raw, role]) => observe(raw, role)))),
+    ];
+    if (!ownerRaw)
+        preconditions.push({
+            kind: 'system-account-or-absent',
+            address: owner,
+            describes: 'The token owner wallet may remain absent or receive native funding as an empty, non-executable System account.',
+        });
+    const steps = [];
+    let ataFunding = 0n;
+    if (escrowRaw) {
+        const balance = validateShipToken(escrowRaw, mint, character);
+        if (balance + amount > (1n << 64n) - 1n)
+            failShipImport('Escrow token balance would exceed u64 capacity. Reduce the amount.', escrow);
+        preconditions.push({
+            kind: 'token-account',
+            address: escrow,
+            mint,
+            owner: character,
+            minimumBalance: 0n,
+            describes: 'Existing Character escrow remains initialized and unfrozen with the selected mint and Character owner; incoming tokens are allowed.',
+        });
+    }
+    else {
+        const creation = options.escrowAccount;
+        if (!creation)
+            failShipImport('Character ship escrow is missing. Explicitly select escrowAccount create-if-missing with a payer or create it separately.', escrow);
+        const extraAddresses = [
+            creation.payer,
+            ATA_PROGRAM,
+            SYSTEM_PROGRAM,
+            ORIGINAL_TOKEN_PROGRAM,
+        ];
+        const extraValues = await readContextRawAccounts(ctx, extraAddresses);
+        const extras = extraAddresses.map((a, i) => required(extraValues[i], a, 'ATA prerequisite'));
+        const payer = extras[0];
+        ataFunding = minimum(165);
+        if (payer.owner !== SYSTEM_PROGRAM ||
+            payer.executable ||
+            payer.data.length !== 0 ||
+            payer.lamports < ataFunding)
+            failShipImport(`ATA payer must be a System wallet with at least ${ataFunding} native lamports for escrow storage plus separate fees.`, creation.payer);
+        if (extras.slice(1).some((a) => !a.executable))
+            failShipImport('ATA creation requires executable associated-token, System and original Token programs.', ATA_PROGRAM);
+        preconditions.push(...(await Promise.all(extras.map((raw, i) => observe(raw, [
+            'ATA payer identity',
+            'Associated-token program',
+            'System program',
+            'Token program',
+        ][i])))), {
+            kind: 'token-account-or-absent',
+            address: escrow,
+            mint,
+            owner: character,
+            describes: 'Explicit idempotent creation permits an absent or already valid canonical Character ATA.',
+        });
+        steps.push({
+            instruction: {
+                programAddress: ATA_PROGRAM,
+                accounts: [
+                    { address: creation.payer, role: 3 },
+                    { address: escrow, role: 1 },
+                    { address: character, role: 0 },
+                    { address: mint, role: 0 },
+                    { address: SYSTEM_PROGRAM, role: 0 },
+                    { address: ORIGINAL_TOKEN_PROGRAM, role: 0 },
+                ],
+                data: Uint8Array.of(1),
+            },
+            signers: [creation.payer],
+            describes: `Create the canonical Character ship ATA idempotently; payer ${creation.payer} provides observed storage funding ${ataFunding} native lamports, separate from transaction fees.`,
+        });
+    }
+    const describes = `Import ${amount} whole ships for configuration ${shipId} (mint ${mint}): source ${source} decreases by ${amount}, Character escrow ${escrow} increases by ${amount}, and StarbasePlayer ${player} shipsInEscrow[${shipId}] increases by ${amount}. Profile authority ${authorization.authority} and token owner ${owner} authorize import. Profile ${authorization.profile} provides observed StarbasePlayer storage funding ${growthFunding} native lamports; ATA storage funding ${ataFunding} and execution fees are separate. The actual Profile debit and its rent reserve are rechecked before signing within the approved storage ceiling; compatible creation/assembly debits are combined per Profile. Different ship configurations for one StarbasePlayer require separate confirmed imports. Funding is not reserved; permissions, current access and outcomes remain chain-authoritative. Simulate before signing and verify all three balances after confirmation; never automatically retry an unknown outcome. Import does not create a Fleet. System identity, active Starbase generation and applicable CSS requirements are rechecked before signing; unrelated System combat, shield, health and hab activity is not equality-bound. Execution access checks remain chain-authoritative, not a client-side atomicity guarantee. Mint supply and authorities may change; initialized original Token mint layout and decimals are rechecked before signing.${ownerRaw ? '' : ' An absent token owner wallet may receive native funding as an empty, non-executable System account.'}`;
+    steps.push({
+        instruction: adaptAddShipEscrowInstruction({
+            authorization,
+            owner,
+            character,
+            source,
+            escrow,
+            system: starbase.system.address,
+            starbasePlayer: player,
+            game,
+            amount,
+            shipId,
+        }),
+        signers: [...new Set([authorization.authority, owner])],
+        describes,
+    });
+    return createPlan({
+        kind: 'fleet.ship-import',
+        summary: describes,
+        preconditions,
+        steps,
+    });
+}
+//# sourceMappingURL=ship-import.js.map

package/dist/fleets/actions/ship-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship-import.js","sourceRoot":"","sources":["../../../src/fleets/actions/ship-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAgB,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,gBAAgB,GACjB,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,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,GAE1B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EACL,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,aAAa,GACd,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,cAAc,GACf,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EACL,UAAU,GAIX,MAAM,yBAAyB,CAAC;AA6BjC,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AACD,SAAS,OAAO,CAAC,KAAa,EAAE,KAAc,EAAE,QAAgB;IAC9D,MAAM,IAAI,uBAAuB,CAC/B,KAAK,EACL,KAAK,EACL,QAAQ,EACR,qHAAqH,CACtH,CAAC;AACJ,CAAC;AACD,SAAS,QAAQ,CAAC,OAAsC;IACtD,IACE,CAAC,OAAO;QACR,OAAO,OAAO,KAAK,QAAQ;QAC3B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CACvB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC;YACC,QAAQ;YACR,QAAQ;YACR,OAAO;YACP,eAAe;YACf,QAAQ;YACR,eAAe;SAChB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAChB;QAED,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,0BAA0B,CAAC,CAAC;IAC1D,IACE,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;QAClC,OAAO,CAAC,MAAM,IAAI,EAAE;QACpB,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE;QAEjC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAC7D,IACE,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;QAClC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;QACjC,OAAO,CAAC,MAAM,GAAG,CAAC;QAClB,OAAO,CAAC,MAAM,GAAG,KAAK;QAEtB,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,uCAAuC,CAAC,CAAC;IAC7E,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7D,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,wCAAwC,CAAC,CAAC;IAC5E,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1D,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAAC;IACzE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAChC,IACE,CAAC,CAAC;QACF,OAAO,CAAC,KAAK,QAAQ;QACrB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CACjB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CACxE;QACD,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACnB,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACrB,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9B,CAAC,CAAC,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAExD,OAAO,CACL,eAAe,EACf,CAAC,EACD,8EAA8E,CAC/E,CAAC;IACJ,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAChC,IACE,CAAC,KAAK,SAAS;QACf,CAAC,CAAC,CAAC;YACD,OAAO,CAAC,KAAK,QAAQ;YACrB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1D,CAAC,CAAC,IAAI,KAAK,mBAAmB;YAC9B,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;YACjB,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAE7B,OAAO,CACL,eAAe,EACf,CAAC,EACD,gEAAgE,CACjE,CAAC;AACN,CAAC;AACD,SAAS,QAAQ,CACf,GAA2B,EAC3B,OAAgB,EAChB,IAAY;IAEZ,OAAO,CACL,GAAG;QACH,cAAc,CACZ,GAAG,IAAI,IAAI,OAAO,6EAA6E,EAC/F,OAAO,CACR,CACF,CAAC;AACJ,CAAC;AACD,KAAK,UAAU,OAAO,CACpB,GAAe,EACf,IAAY;IAEZ,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,MAAM,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC;QACrD,SAAS,EAAE,GAAG,IAAI,IAAI,GAAG,CAAC,OAAO,yHAAyH;KAC3J,CAAC;AACJ,CAAC;AACD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAgB,EAChB,QAAkC,EAClC,OAAsC;IAEtC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClB,IACE,CAAC,QAAQ;QACT,QAAQ,CAAC,IAAI,KAAK,gBAAgB;QAClC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC1B,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAClC,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;QACzC,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAErC,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,kCAAkC,CAAC,CAAC;IACpE,mFAAmF;IACnF,iFAAiF;IACjF,OAAO,GAAG;QACR,GAAG,OAAO;QACV,aAAa,EAAE,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE;QAC3C,GAAG,CAAC,OAAO,CAAC,aAAa;YACvB,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,EAAE;YACjD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,QAAQ,GAAG;QACT,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,MAAM,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE;QAC9B,SAAS,EAAE,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE;QACpC,aAAa,EAAE,EAAE,GAAG,QAAQ,CAAC,aAAa,EAAE;KAC7C,CAAC;IACF,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACzD,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,EAClC,SAAS,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,EAC/D,MAAM,GAAG,MAAM,2BAA2B,CACxC,QAAQ,CAAC,MAAM,CAAC,OAAO,EACvB,SAAS,CACV,CAAC;IACJ,IACE,QAAQ,CAAC,OAAO,KAAK,MAAM;QAC3B,QAAQ,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS;QACxC,QAAQ,CAAC,aAAa,CAAC,OAAO,KAAK,aAAa,CAAC,OAAO;QAExD,cAAc,CACZ,wGAAwG,EACxG,QAAQ,CAAC,OAAO,CACjB,CAAC;IACJ,MAAM,MAAM,GAAG,MAAM,8BAA8B,CAAC,GAAG,EAAE,MAAM,CAAC,EAC9D,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;IAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,EAC1E,MAAM,GAAG,MAAM,sBAAsB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACzD,IAAI,MAAM,KAAK,MAAM;QACnB,cAAc,CACZ,+DAA+D,EAC/D,MAAM,CACP,CAAC;IACJ,MAAM,SAAS,GAAG;QAChB,aAAa,CAAC,OAAO;QACrB,SAAS;QACT,MAAM;QACN,QAAQ,CAAC,MAAM,CAAC,OAAO;QACvB,IAAI;QACJ,MAAM;QACN,YAAY;QACZ,aAAa;QACb,MAAM;QACN,KAAK;KACG,CAAC;IACX,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAC7D,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,EAC1D,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EACzD,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EACvD,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,EAChD,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EACtD,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,aAAa,CAAC,EAC1D,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,EACzB,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,CAAC;QAChE,IAAI,GAAG,CAAC,UAAU;YAChB,cAAc,CACZ,kEAAkE,EAClE,GAAG,CAAC,OAAO,CACZ,CAAC;IACN,MAAM,CAAC,GAAG,wBAAwB,CAAC,MAAM,CAAC,UAAU,CAAC,EACnD,CAAC,GAAG,0BAA0B,CAAC,MAAM,CAAC,YAAY,CAAC,EACnD,CAAC,GAAG,+BAA+B,CAAC,MAAM,CAAC,SAAS,CAAC,EACrD,CAAC,GAAG,2BAA2B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,IACE,CAAC,CAAC,aAAa,KAAK,aAAa,CAAC,OAAO;QACzC,CAAC,CAAC,IAAI,KAAK,IAAI;QACf,CAAC,CAAC,aAAa,KAAK,aAAa,CAAC,OAAO;QACzC,CAAC,CAAC,SAAS,KAAK,SAAS;QACzB,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,OAAO;QACpC,CAAC,CAAC,IAAI,KAAK,IAAI;QACf,CAAC,MAAM,uBAAuB,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC/C,QAAQ,CAAC,MAAM,CAAC,OAAO;QAEzB,cAAc,CACZ,iHAAiH,EACjH,MAAM,CACP,CAAC;IACJ,MAAM,WAAW,GAAG;QAClB,IAAI,EAAE,iBAA0B;QAChC,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,IAAI;QACJ,kBAAkB,EAAE,CAAC,CAAC,UAAU;QAChC,UAAU,EAAE,IAAa;QACzB,SAAS,EACP,wIAAwI;KAC3I,CAAC;IACF,MAAM,sBAAsB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EACxC,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5B,IACE,CAAC,GAAG;QACJ,GAAG,CAAC,OAAO,KAAK,aAAa,CAAC,SAAS;QACvC,GAAG,CAAC,KAAK,KAAK,8BAA8B;QAC5C,CAAC,GAAG,CAAC,cAAc,GAAG,EAAE,CAAC,KAAK,EAAE;QAEhC,cAAc,CACZ,oKAAoK,EACpK,UAAU,CAAC,OAAO,CACnB,CAAC;IACJ,IAAI,GAAG,CAAC,YAAY,IAAI,EAAE,IAAI,GAAG,CAAC,YAAY,GAAG,GAAG;QAClD,cAAc,CACZ,kEAAkE,EAClE,UAAU,CAAC,OAAO,CACnB,CAAC;IACJ,IACE,QAAQ;QACR,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,GAAG;QAC5B,CAAC,QAAQ,CAAC,KAAK,KAAK,sBAAsB;YACxC,QAAQ,CAAC,KAAK,KAAK,6CAA6C,CAAC;QAEnE,cAAc,CACZ,4EAA4E,EAC5E,KAAK,CACN,CAAC;IACJ,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1B,MAAM,YAAY,GAAG,iBAAiB,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/D,IAAI,YAAY,GAAG,MAAM;QACvB,cAAc,CACZ,cAAc,YAAY,8BAA8B,MAAM,sBAAsB,EACpF,MAAM,CACP,CAAC;IACJ,MAAM,cAAc,GAAG,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,cAAc,EAAE,WAAW,IAAI,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE;QACjE,cAAc,CACZ,2EAA2E,EAC3E,MAAM,CACP,CAAC;IACJ,MAAM,aAAa,GAAG;QACpB,OAAO,EAAE,MAAM;QACf,IAAI;QACJ,OAAO,EAAE,aAAa,CAAC,OAAO;QAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;QAC/B,MAAM;KACP,CAAC;IACF,MAAM,eAAe,GAAG,MAAM,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACtE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,yBAAyB,CAC/D,aAAa,EACb,eAAe,EACf,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACrE,CAAC;IACF,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,aAAa,GAAuB;QACxC,WAAW;QACX;YACE,IAAI,EAAE,qBAAqB;YAC3B,GAAG,aAAa;YAChB,mBAAmB,EAAE,aAAa;YAClC,SAAS,EACP,0JAA0J;SAC7J;QACD;YACE,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,QAAQ,OAAO,CAAC,OAAO,8GAA8G;SACjJ;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,IAAI;YACb,MAAM;YACN,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EACP,2FAA2F;SAC9F;QACD;YACE,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,MAAM;YACf,IAAI;YACJ,KAAK;YACL,cAAc,EAAE,MAAM;YACtB,SAAS,EACP,4FAA4F;SAC/F;QACD,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAEjB;YACE,CAAC,UAAU,EAAE,uBAAuB,CAAC;YACrC,CAAC,YAAY,EAAE,oBAAoB,CAAC;YACpC,CAAC,SAAS,EAAE,uBAAuB,CAAC;YACpC,CAAC,OAAO,EAAE,cAAc,CAAC;YACzB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,sBAAsB,CAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAErE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAC3C,CAAC;KACH,CAAC;IACF,IAAI,CAAC,QAAQ;QACX,aAAa,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,KAAK;YACd,SAAS,EACP,gHAAgH;SACnH,CAAC,CAAC;IACL,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,OAAO,GAAG,MAAM,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE;YACrC,cAAc,CACZ,oEAAoE,EACpE,MAAM,CACP,CAAC;QACJ,aAAa,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,MAAM;YACf,IAAI;YACJ,KAAK,EAAE,SAAS;YAChB,cAAc,EAAE,EAAE;YAClB,SAAS,EACP,qIAAqI;SACxI,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;QACvC,IAAI,CAAC,QAAQ;YACX,cAAc,CACZ,2HAA2H,EAC3H,MAAM,CACP,CAAC;QACJ,MAAM,cAAc,GAAG;YACrB,QAAQ,CAAC,KAAK;YACd,WAAW;YACX,cAAc;YACd,sBAAsB;SACvB,CAAC;QACF,MAAM,WAAW,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACzC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAChD,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACzB,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1B,IACE,KAAK,CAAC,KAAK,KAAK,cAAc;YAC9B,KAAK,CAAC,UAAU;YAChB,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YACvB,KAAK,CAAC,QAAQ,GAAG,UAAU;YAE3B,cAAc,CACZ,mDAAmD,UAAU,yDAAyD,EACtH,QAAQ,CAAC,KAAK,CACf,CAAC;QACJ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YAC5C,cAAc,CACZ,wFAAwF,EACxF,WAAW,CACZ,CAAC;QACJ,aAAa,CAAC,IAAI,CAChB,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CACnB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CACpB,OAAO,CACL,GAAG,EACH;YACE,oBAAoB;YACpB,0BAA0B;YAC1B,gBAAgB;YAChB,eAAe;SAChB,CAAC,CAAC,CAAE,CACN,CACF,CACF,CAAC,EACF;YACE,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,MAAM;YACf,IAAI;YACJ,KAAK,EAAE,SAAS;YAChB,SAAS,EACP,0FAA0F;SAC7F,CACF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC;YACT,WAAW,EAAE;gBACX,cAAc,EAAE,WAAW;gBAC3B,QAAQ,EAAE;oBACR,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE;oBACpC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE;oBAC5B,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE;oBAC/B,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE;oBAC1B,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,EAAE;oBACpC,EAAE,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC,EAAE;iBAC7C;gBACD,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;aACvB;YACD,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;YACzB,SAAS,EAAE,+DAA+D,QAAQ,CAAC,KAAK,sCAAsC,UAAU,mDAAmD;SAC5L,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,UAAU,MAAM,kCAAkC,MAAM,UAAU,IAAI,aAAa,MAAM,iBAAiB,MAAM,sBAAsB,MAAM,iBAAiB,MAAM,wBAAwB,MAAM,kBAAkB,MAAM,kBAAkB,MAAM,uBAAuB,aAAa,CAAC,SAAS,oBAAoB,KAAK,8BAA8B,aAAa,CAAC,OAAO,qDAAqD,aAAa,yCAAyC,UAAU,g7BAAg7B,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,sGAAsG,EAAE,CAAC;IAC3hD,KAAK,CAAC,IAAI,CAAC;QACT,WAAW,EAAE,6BAA6B,CAAC;YACzC,aAAa;YACb,KAAK;YACL,SAAS;YACT,MAAM;YACN,MAAM;YACN,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;YAC/B,cAAc,EAAE,MAAM;YACtB,IAAI;YACJ,MAAM;YACN,MAAM;SACP,CAAC;QACF,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QACvD,SAAS;KACV,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,SAAS;QAClB,aAAa;QACb,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/identity/actions/create-profile.d.ts

@@ -0,0 +1,56 @@
+import { type Address } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+import { type Plan } from '../../planning/index.js';
+/** One explicitly scoped key and its exact unsigned 64-bit permission mask.
+ * `expiresAt` is a nonnegative Unix timestamp in seconds; omission means no expiry.
+ * Profile AUTH keys must omit expiry and must be directly signing addresses.
+ * @example
+ * ```ts
+ * declare const authority: Address;
+ * declare const playerProfileProgram: Address;
+ * const key: ProfileCreationKeyInput = {address: authority, scope: playerProfileProgram, permissionsRaw: 1n};
+ * ```
+ */
+export interface ProfileCreationKeyInput {
+    readonly address: Address;
+    readonly scope: Address;
+    readonly permissionsRaw: bigint;
+    readonly expiresAt?: bigint;
+}
+/** Explicit storage funder, ordered keys, and protected Profile update threshold.
+ * No permissions or threshold are selected automatically.
+ * @example
+ * ```ts
+ * declare const funder: Address;
+ * declare const keys: readonly ProfileCreationKeyInput[];
+ * const options: PlanCreateProfileOptions = {funder, keys, keyThreshold: 1};
+ * ```
+ */
+export interface PlanCreateProfileOptions {
+    readonly funder: Address;
+    readonly keys: readonly ProfileCreationKeyInput[];
+    readonly keyThreshold: number;
+}
+/** Plans a new signer-created Profile with explicit scoped permissions.
+ * The new Profile, storage funder, and every Player Profile AUTH key sign creation,
+ * even when the editing threshold is lower. Other keys remain readonly.
+ * The new Profile signer is needed only for creation unless explicitly listed
+ * among the initial authority keys; creating the account does not grant it AUTH.
+ * The threshold governs protected Profile updates; it is not a gameplay-wide multisig policy.
+ * Existing target accounts and a Profile address equal to its funder are rejected.
+ * No Game load, onboarding, funding top-up, key generation or signing is implicit.
+ * Storage rent, balances and final creation remain chain-authoritative. Simulate
+ * before requesting signatures; after confirmed execution, read `getProfile` and
+ * verify the exact keys, scopes, permission masks and threshold.
+ * @example
+ * ```ts
+ * import {planCreateProfile} from '@aephia/atlas-kit/identity/actions';
+ * declare const ctx: SageContext;
+ * declare const profileAddress: Address;
+ * declare const options: PlanCreateProfileOptions;
+ * const plan = await planCreateProfile(ctx, profileAddress, options);
+ * console.log(plan.summary, plan.requiredSigners);
+ * ```
+ */
+export declare function planCreateProfile(ctx: SageContext, profileAddress: Address, input: PlanCreateProfileOptions): Promise<Plan>;
+//# sourceMappingURL=create-profile.d.ts.map

package/dist/identity/actions/create-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-profile.d.ts","sourceRoot":"","sources":["../../../src/identity/actions/create-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAO7D,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAyID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,OAAO,EACvB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Cf"}