@aephia/atlas-kit 0.6.0-next.107 → 0.6.0-next.108

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

@@ -0,0 +1,98 @@
+import { AccountRole, getAddressDecoder, getAddressEncoder, getProgramDerivedAddress, } from '@solana/kit';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { SYSTEM_PROGRAM } from '../system-program.js';
+import { RENT_ADDRESS, readRent } from './rent.js';
+export const ORIGINAL_TOKEN_PROGRAM = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';
+export const ATA_PROGRAM = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';
+const TOKEN_2022_PROGRAM = 'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb';
+/** What a wallet token transfer Plan rechecks and leaves to the chain. */
+export const TOKEN_TRANSFER_DISCLOSURE = '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.';
+/** The canonical associated token account of `owner` for an original Token `mint`. */
+export async function deriveAssociatedTokenAddress(owner, mint) {
+    const encoder = getAddressEncoder();
+    const [address] = await getProgramDerivedAddress({
+        programAddress: ATA_PROGRAM,
+        seeds: [
+            encoder.encode(owner),
+            encoder.encode(ORIGINAL_TOKEN_PROGRAM),
+            encoder.encode(mint),
+        ],
+    });
+    return address;
+}
+/** Whether a wallet is an original or Token-2022 multisig authority, which
+ * needs signer semantics outside the single-owner wallet planners. */
+export function isTokenMultisig(account) {
+    return (account !== undefined &&
+        account.data.length === 355 &&
+        (account.owner === ORIGINAL_TOKEN_PROGRAM ||
+            account.owner === TOKEN_2022_PROGRAM));
+}
+/** Requires an initialized, unfrozen original Token account of `mint` owned
+ * by `owner` and returns its raw balance. A recorded delegate does not prevent
+ * the owner from transferring, so it is accepted. */
+export function readTokenAccount(account, mint, owner, fail) {
+    const { address, data } = account;
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    if (account.executable ||
+        account.owner !== ORIGINAL_TOKEN_PROGRAM ||
+        data.length !== 165 ||
+        [72, 109, 129].some((offset) => view.getUint32(offset, true) > 1))
+        fail(`Account ${address} must be a well-formed original Token account of exactly 165 bytes; Token-2022 and multisig layouts are unsupported.`, address);
+    const decoder = getAddressDecoder();
+    if (view.getUint8(108) !== 1 ||
+        decoder.decode(data.subarray(0, 32)) !== mint ||
+        decoder.decode(data.subarray(32, 64)) !== owner)
+        fail(`Token account ${address} must be initialized, unfrozen and hold mint ${mint} under owner ${owner}; delegated spending is unsupported.`, address);
+    return view.getBigUint64(64, true);
+}
+/** Validates an explicit payer for idempotent canonical ATA creation and
+ * returns the creation instruction, its storage funding, and the payer, Rent
+ * and program observations. Reads Rent unless the caller already holds it. */
+export async function resolveAssociatedTokenCreation(ctx, request, fail, observe) {
+    const addresses = [
+        request.payer,
+        ATA_PROGRAM,
+        SYSTEM_PROGRAM,
+        ORIGINAL_TOKEN_PROGRAM,
+        ...(request.rent === undefined ? [RENT_ADDRESS] : []),
+    ];
+    const accounts = (await readContextRawAccounts(ctx, addresses)).map((account, index) => account ??
+        fail(`ATA creation prerequisite ${addresses[index]} is missing. Create or fund it separately.`, addresses[index]));
+    const [payer, ...programs] = accounts.slice(0, 4);
+    const rent = request.rent ?? accounts[4];
+    if (programs.some((program) => !program.executable))
+        fail('ATA creation requires executable associated-token, System and original Token programs in this deployment.', ATA_PROGRAM);
+    // Original Token accounts occupy 165 bytes; the shared Rent reader includes
+    // the 128-byte account overhead and validates the full sysvar.
+    const storageFunding = readRent(rent)(165);
+    if (payer.owner !== SYSTEM_PROGRAM ||
+        payer.executable ||
+        payer.data.length !== 0 ||
+        payer.lamports < storageFunding)
+        fail(`ATA payer must be a System wallet with at least ${storageFunding} lamports for storage, in addition to transaction fees.`, request.payer);
+    const roles = [
+        'ATA payer identity',
+        'Associated-token program',
+        'System program',
+        'Token program',
+        'Rent configuration',
+    ];
+    return {
+        instruction: {
+            programAddress: ATA_PROGRAM,
+            accounts: [
+                { address: request.payer, role: AccountRole.WRITABLE_SIGNER },
+                { address: request.address, role: AccountRole.WRITABLE },
+                { address: request.owner, role: AccountRole.READONLY },
+                { address: request.mint, role: AccountRole.READONLY },
+                { address: SYSTEM_PROGRAM, role: AccountRole.READONLY },
+                { address: ORIGINAL_TOKEN_PROGRAM, role: AccountRole.READONLY },
+            ],
+            data: Uint8Array.of(1),
+        },
+        preconditions: await Promise.all(accounts.map((account, index) => observe(account, roles[index]))),
+        storageFunding,
+    };
+}
+//# sourceMappingURL=original-token.js.map

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

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

package/dist/internal/planning/ship-token.d.ts

@@ -1,9 +1,5 @@
-import { type Address } from '@solana/kit';
+import type { Address } from '@solana/kit';
 import type { RawAccount } from '../../client/contracts.js';
-export declare const ORIGINAL_TOKEN_PROGRAM: Address;
-export declare const ATA_PROGRAM: Address;
 export declare function failShipImport(message: string, address: Address): never;
-export declare function deriveShipTokenAddress(owner: Address, mint: Address): Promise<Address>;
 export declare function validateShipMint(account: RawAccount): void;
-export declare function validateShipToken(account: RawAccount, mint: Address, owner: Address): bigint;
 //# sourceMappingURL=ship-token.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ship-token.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/ship-token.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,eAAO,MAAM,sBAAsB,EACgB,OAAO,CAAC;AAC3D,eAAO,MAAM,WAAW,EAC4B,OAAO,CAAC;AAC5D,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,KAAK,CAMvE;AACD,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAYlB;AAwBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAM1D;AACD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,OAAO,GACb,MAAM,CAcR"}
+{"version":3,"file":"ship-token.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/ship-token.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,KAAK,CAMvE;AACD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAM1D"}

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

@@ -1,46 +1,10 @@
 import { validateTokenMint } from './token-mint.js';
-import { getAddressDecoder, getAddressEncoder, getProgramDerivedAddress, } from '@solana/kit';
 import { SageSdkError } from '../../client/errors.js';
-export const ORIGINAL_TOKEN_PROGRAM = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';
-export const ATA_PROGRAM = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';
 export function failShipImport(message, address) {
     throw new SageSdkError('ACTION_PRECONDITION_FAILED', `${message} Refresh the relevant accounts and prepare a new ship import Plan.`, { address });
 }
-export async function deriveShipTokenAddress(owner, mint) {
-    const encoder = getAddressEncoder();
-    return (await getProgramDerivedAddress({
-        programAddress: ATA_PROGRAM,
-        seeds: [
-            encoder.encode(owner),
-            encoder.encode(ORIGINAL_TOKEN_PROGRAM),
-            encoder.encode(mint),
-        ],
-    }))[0];
-}
-function bytes(account, length) {
-    if (account.executable ||
-        account.owner !== ORIGINAL_TOKEN_PROGRAM ||
-        account.data.length !== length)
-        failShipImport(`Account ${account.address} must be an original Token account with exactly ${length} bytes; Token-2022 is unsupported.`, account.address);
-    return new DataView(account.data.buffer, account.data.byteOffset, account.data.byteLength);
-}
-function option(view, offset, account) {
-    if (view.getUint32(offset, true) > 1)
-        failShipImport('The Token account has malformed optional fields.', account.address);
-}
 export function validateShipMint(account) {
     if (validateTokenMint(account) !== 0)
         failShipImport('Ship import requires an initialized zero-decimal mint so each token is one ship.', account.address);
 }
-export function validateShipToken(account, mint, owner) {
-    const view = bytes(account, 165);
-    for (const offset of [72, 109, 129])
-        option(view, offset, account);
-    const decoder = getAddressDecoder();
-    if (view.getUint8(108) !== 1 ||
-        decoder.decode(account.data.subarray(0, 32)) !== mint ||
-        decoder.decode(account.data.subarray(32, 64)) !== owner)
-        failShipImport(`The token account must be initialized, unfrozen and hold ship mint ${mint} under authority ${owner}. Delegated token spending is unsupported.`, account.address);
-    return view.getBigUint64(64, true);
-}
 //# sourceMappingURL=ship-token.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ship-token.js","sourceRoot":"","sources":["../../../src/internal/planning/ship-token.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ship-token.js","sourceRoot":"","sources":["../../../src/internal/planning/ship-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,OAAgB;IAC9D,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,GAAG,OAAO,oEAAoE,EAC9E,EAAE,OAAO,EAAE,CACZ,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IAClD,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC;QAClC,cAAc,CACZ,kFAAkF,EAClF,OAAO,CAAC,OAAO,CAChB,CAAC;AACN,CAAC"}

package/dist/internal/planning/starbase-player-owner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"starbase-player-owner.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/starbase-player-owner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,gEAAgE;AAChE,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAChD;AAMD;;;mBAGmB;AACnB,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAwBlB"}
+{"version":3,"file":"starbase-player-owner.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/starbase-player-owner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,gEAAgE;AAChE,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAChD;AAED;;;mBAGmB;AACnB,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAclB"}

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

@@ -1,25 +1,17 @@
 import { SageSdkError } from '../../client/errors.js';
 import { findCharacterPda } from '../c4/character.js';
 import { deriveStarbasePlayerAddress } from '../c4/starbase.js';
-function fail(message, address) {
-    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
-}
 /** 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) {
-    if (player.playerProfile.address !== profile) {
-        fail(`Starbase Player ${player.address} does not belong to authorization Profile ${profile}. Refresh the Starbase Player for that Profile and retry.`, player.address);
-    }
     const character = await findCharacterPda(profile, game);
-    if (player.character.address !== character) {
-        fail(`Starbase Player ${player.address} does not reference the canonical Character ${character} for authorization Profile ${profile}. Refresh the Starbase Player and retry.`, player.address);
-    }
-    if ((await deriveStarbasePlayerAddress(player.system.address, character)) !==
-        player.address) {
-        fail(`Starbase Player ${player.address} is not canonical for its Character and System. Refresh the Starbase Player through this context and retry.`, player.address);
-    }
+    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

@@ -1 +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,SAAS,IAAI,CAAC,OAAe,EAAE,OAAgB;IAC7C,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED;;;mBAGmB;AACnB,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAA8B,EAC9B,OAAgB,EAChB,IAAa;IAEb,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC7C,IAAI,CACF,mBAAmB,MAAM,CAAC,OAAO,6CAA6C,OAAO,2DAA2D,EAChJ,MAAM,CAAC,OAAO,CACf,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC3C,IAAI,CACF,mBAAmB,MAAM,CAAC,OAAO,+CAA+C,SAAS,8BAA8B,OAAO,0CAA0C,EACxK,MAAM,CAAC,OAAO,CACf,CAAC;IACJ,CAAC;IACD,IACE,CAAC,MAAM,2BAA2B,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACrE,MAAM,CAAC,OAAO,EACd,CAAC;QACD,IAAI,CACF,mBAAmB,MAAM,CAAC,OAAO,6GAA6G,EAC9I,MAAM,CAAC,OAAO,CACf,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"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/wallet-starbase.d.ts

@@ -0,0 +1,34 @@
+import type { Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+/** Rejects with the calling planner's wording and remedy. */
+type Fail = (message: string, address: Address) => never;
+/** Requires the fresh Profile, Character, Starbase Player and System of a
+ * wallet transfer to be decodable account state of the configured Game and
+ * authorization Profile, and the System to be canonical with an active
+ * Starbase (a Central Space Station when `requireCss`). Returns the decoded
+ * Profile and Starbase Player and the matching System guard. */
+export declare function validateWalletStarbase(accounts: {
+    readonly profile: RawAccount;
+    readonly character: RawAccount;
+    readonly player: RawAccount;
+    readonly system: RawAccount;
+}, facts: {
+    readonly game: Address;
+    readonly profile: Address;
+    readonly character: Address;
+    readonly system: Address;
+    readonly requireCss: boolean;
+}, fail: Fail): Promise<{
+    playerData: Readonly<import("../c4/starbase.js").StarbasePlayerAccountData>;
+    profileData: Readonly<import("../c4/identity.js").ProfileAccountData>;
+    systemGuard: {
+        describes: string;
+        requireCss?: true;
+        kind: "starbase-system";
+        address: import("../../client/contracts.js").Address;
+        game: Address;
+        starbaseSequenceId: bigint;
+    };
+}>;
+export {};
+//# sourceMappingURL=wallet-starbase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-starbase.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/wallet-starbase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAU5D,6DAA6D;AAC7D,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC;AAEzD;;;;gEAIgE;AAChE,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE;IACR,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B,EACD,KAAK,EAAE;IACL,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B,EACD,IAAI,EAAE,IAAI;;;;;;;;;;;GAoCX"}

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

@@ -0,0 +1,39 @@
+import { characterAccountDefinition } from '../c4/character.js';
+import { profileAccountDefinition } from '../c4/identity.js';
+import { starbasePlayerAccountDefinition } from '../c4/starbase.js';
+import { deriveStarSystemAddress, starSystemAccountDefinition, } from '../c4/world.js';
+import { validateStarbaseSystem } from './starbase-system.js';
+/** Requires the fresh Profile, Character, Starbase Player and System of a
+ * wallet transfer to be decodable account state of the configured Game and
+ * authorization Profile, and the System to be canonical with an active
+ * Starbase (a Central Space Station when `requireCss`). Returns the decoded
+ * Profile and Starbase Player and the matching System guard. */
+export async function validateWalletStarbase(accounts, facts, fail) {
+    for (const account of Object.values(accounts))
+        if (account.executable)
+            fail('A gameplay prerequisite is executable rather than account state.', account.address);
+    const profileData = profileAccountDefinition.decode(accounts.profile);
+    const characterData = characterAccountDefinition.decode(accounts.character);
+    const playerData = starbasePlayerAccountDefinition.decode(accounts.player);
+    const systemData = starSystemAccountDefinition.decode(accounts.system);
+    if (characterData.game !== facts.game ||
+        characterData.playerProfile !== facts.profile ||
+        playerData.playerProfile !== facts.profile ||
+        playerData.character !== facts.character ||
+        playerData.system !== facts.system ||
+        systemData.game !== facts.game ||
+        (await deriveStarSystemAddress(facts.game, systemData.systemId)) !==
+            facts.system)
+        fail('Fresh Character, Starbase Player and System must belong to the configured Game and authorized Profile.', accounts.player.address);
+    const systemGuard = {
+        kind: 'starbase-system',
+        address: accounts.system.address,
+        game: facts.game,
+        starbaseSequenceId: systemData.sequenceId,
+        ...(facts.requireCss ? { requireCss: true } : {}),
+        describes: `The canonical Star System retains its active Starbase and generation${facts.requireCss ? ' as a Central Space Station' : ''}; unrelated shared activity may change.`,
+    };
+    await validateStarbaseSystem(accounts.system, systemGuard);
+    return { playerData, profileData, systemGuard };
+}
+//# sourceMappingURL=wallet-starbase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-starbase.js","sourceRoot":"","sources":["../../../src/internal/planning/wallet-starbase.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAK9D;;;;gEAIgE;AAChE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAKC,EACD,KAMC,EACD,IAAU;IAEV,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC3C,IAAI,OAAO,CAAC,UAAU;YACpB,IAAI,CACF,kEAAkE,EAClE,OAAO,CAAC,OAAO,CAChB,CAAC;IACN,MAAM,WAAW,GAAG,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,0BAA0B,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,+BAA+B,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,2BAA2B,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvE,IACE,aAAa,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;QACjC,aAAa,CAAC,aAAa,KAAK,KAAK,CAAC,OAAO;QAC7C,UAAU,CAAC,aAAa,KAAK,KAAK,CAAC,OAAO;QAC1C,UAAU,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QACxC,UAAU,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAClC,UAAU,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;QAC9B,CAAC,MAAM,uBAAuB,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC9D,KAAK,CAAC,MAAM;QAEd,IAAI,CACF,wGAAwG,EACxG,QAAQ,CAAC,MAAM,CAAC,OAAO,CACxB,CAAC;IACJ,MAAM,WAAW,GAAG;QAClB,IAAI,EAAE,iBAA0B;QAChC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;QAChC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,kBAAkB,EAAE,UAAU,CAAC,UAAU;QACzC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,SAAS,EAAE,uEAAuE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,EAAE,yCAAyC;KACjL,CAAC;IACF,MAAM,sBAAsB,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAClD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aephia/atlas-kit",
-  "version": "0.6.0-next.107",
+  "version": "0.6.0-next.108",
   "description": "Community-maintained non-custodial TypeScript SDK for Star Atlas SAGE C4.",
   "license": "Apache-2.0",
   "author": "Aephia contributors",