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

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":"AAAA,OAAO,EAAE,cAAc,EAAkC,MAAM,aAAa,CAAC;AAG7E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GAGnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAE3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAoDnD,MAAM,CAAC,MAAM,IAAI,GAAe,IAAI,GAAG,EAAE,CAAC;AAE1C,SAAS,IAAI,CAAC,OAAgB,EAAE,OAAe;IAC7C,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,OAA2D;IAE3D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,OAAO;QACrC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,EAAE;YACrC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,QAAsD,EACtD,OAAgB;IAEhB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU;QACxB,IAAI,CACF,OAAO,EACP,WAAW,OAAO,iHAAiH,CACpI,CAAC;IACJ,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;uDAIuD;AACvD,MAAM,UAAU,eAAe,CAC7B,OAAiC,EACjC,QAAsD;IAEtD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAQlB,CAAC;IACJ,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO;oBACzB,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;gBACvC,OAAO,GAAG;oBACR,QAAQ,EAAE,GAAG,EAAE,QAAQ,IAAI,EAAE;oBAC7B,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;iBAC9B,CAAC;gBACF,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YACD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,OAAO,CAAC,MAAM;oBACZ,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC/D,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;YACtC,CAAC;YACD,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC/B,OAAO,CAAC,KAAK,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;gBAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;gBACxC,KAAK,MAAM,OAAO,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;oBACpE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACxC,MAAM,KAAK,GACT,CAAC,IAAI,IAAI,EAAE,CAAC;wBACZ,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;wBAC1B,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC/B,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,GAAG,EAAE;wBAAE,KAAK,IAAI,CAAC,CAAC;yBAC5C,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,IAAI,EAAE;wBAAE,KAAK,IAAI,CAAC,CAAC;oBACvD,mEAAmE;oBACnE,IAAI,KAAK,GAAG,EAAE;wBAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;;wBAC7C,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;YACD,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,gBAAgB,CAAC;YACxE,yEAAyE;YACzE,iCAAiC;YACjC,IAAI,OAAO,CAAC,QAAQ,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;gBAAE,SAAS;YAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC;YACpE,IAAI,OAAO,CAAC,QAAQ,GAAG,OAAO;gBAAE,OAAO,IAAI,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;;gBACjE,MAAM,IAAI,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC;YAC1C,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC7B,CAAC;QACD,MAAM,YAAY,GAChB,MAAM,CAAC,UAAU,KAAK,MAAM;YAC1B,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,OAAO,GAAG,MAAM;gBAChB,CAAC,CAAC,OAAO,GAAG,MAAM;gBAClB,CAAC,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,YAAY,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,YAAY,CAAC,KAA0B;IAIrD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC;AAMD;;;;;;mDAMmD;AACnD,MAAM,UAAU,sBAAsB,CACpC,KAA0B,EAC1B,MAA6C,EAC7C,QAAsD,EACtD,UAAuD;IAEvD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6C,CAAC;IACrE,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAC9B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAW,CAAC;IACvC,MAAM,KAAK,GAGL,EAAE,CAAC;IACT,KAAK,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,QAAQ,IAAI,EAAE;gBAC3C,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC/D,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;QACvC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ;YACnC,IAAI,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;gBACnD,IAAI,CACF,OAAO,CAAC,OAAO,EACf,gDAAgD,OAAO,CAAC,OAAO,4KAA4K,CAC5O,CAAC;QACN,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QACD,wEAAwE;QACxE,SAAS;QACT,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAC/B,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO;YAChC,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;YACpC,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAC/C,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,OAAO,GAAG,eAAe,CAC7B,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EACjC,QAAQ,CACT,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE;QACzC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,KAAK,CAAE,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,gEAAgE;YAChE,mCAAmC;YACnC,IAAI,YAAY,GAAG,EAAE;gBACnB,IAAI,CACF,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,EAC1B,kBAAkB,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,wBAAwB,YAAY,kIAAkI,CACnN,CAAC;YACJ,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE;gBACjB,OAAO,EAAE,0BAA0B,CAAC;oBAClC,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;oBAC5C,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC;oBACxC,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,YAAY;oBACZ,MAAM,EAAE,QAAQ;oBAChB,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;iBAC/C,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;uDACuD;AACvD,MAAM,UAAU,kBAAkB,CAAC,KAMlC;IACC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACzB,MAAM,SAAS,GAAG,eAAe,CAC/B,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EACpC,KAAK,CAAC,QAAQ,CACf,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACT,OAAO,0BAA0B,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO;QACnC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,0BAA0B,CAAC;YAClC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC;YACnD,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC;YAC9C,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,SAAU,CAAC,YAAY;YACrC,MAAM,EAAE,KAAK,CAAC,KAAK;SACpB,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

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/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/dist/internal/planning/xp-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xp-runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/xp-runtime.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,8EAA8E;AAC9E,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAoED,kGAAkG;AAClG,wBAAsB,qCAAqC,CACzD,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAE,EAC9D,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,GACrD,OAAO,CAAC,8BAA8B,CAAC,CAiCzC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,EAC3C,iBAAiB,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,EACxC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,GACrD,OAAO,CAAC;IACT,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC,CAAC,CAgGD"}
+{"version":3,"file":"xp-runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/xp-runtime.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAaxE,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,8EAA8E;AAC9E,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AA4DD,kGAAkG;AAClG,wBAAsB,qCAAqC,CACzD,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAE,EAC9D,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,GACrD,OAAO,CAAC,8BAA8B,CAAC,CAiCzC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,EAC3C,iBAAiB,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,EACxC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,GACrD,OAAO,CAAC;IACT,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC,CAAC,CAkGD"}

package/dist/internal/planning/xp-runtime.js

@@ -1,9 +1,10 @@
-import { findCharacterPda } from '../c4/identity.js';
-import { getAddressEncoder, getProgramDerivedAddress, } from '@solana/kit';
-import { CAREER_XP_BUDGET_DISCRIMINATOR, XP_BUDGET_CONFIG_DISCRIMINATOR, STRUCTURE_XP_ACCRUAL_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, getCareerXpBudgetDecoder, getXpBudgetConfigDecoder, getStructureXpAccrualDecoder, } from '../c4/runtime-bindings.js';
+import { findCharacterPda } from '../c4/character.js';
+import { SAGE_PROGRAM_ADDRESS, getCareerXpBudgetDecoder, getXpBudgetConfigDecoder, getStructureXpAccrualDecoder, } from '../c4/runtime-bindings.js';
 import { SageSdkError } from '../../client/errors.js';
 import { readContextRawAccounts } from '../../client/reconciliation.js';
 import { readFreshGameRuntimeVersion } from '../../registry/xp-runtime.js';
+import { CAREER_XP_BUDGET_DISCRIMINATOR, STRUCTURE_XP_ACCRUAL_DISCRIMINATOR, XP_BUDGET_CONFIG_DISCRIMINATOR, } from '../c4/discriminators.js';
+import { deriveCareerXpBudgetAddress, deriveStructureXpAccrualAddress, deriveXpBudgetConfigAddress, } from '../c4/pda.js';
 function fail(address, reason) {
     throw new SageSdkError('ACTION_PRECONDITION_FAILED', `XP runtime account ${address} ${reason}. Refresh the account and prepare a new Plan; use the game client or operator's supported migration flow if XP is not initialized.`, { address });
 }
@@ -20,27 +21,20 @@ function decode(account, address, decoder, discriminator) {
     return decoder.decode(account.data);
 }
 function validateBinding(value, address, game, bump, version) {
+    // SDK pin, not a game rule: the game does not check reserved bytes, and
+    // newer layouts carve fields from their front, so nonzero bytes mean a layout
+    // this release was not qualified against.
     if (value.version !== version ||
         value.bump !== bump ||
         value.gameId !== game ||
         value.reserved.some((byte) => byte !== 0))
-        fail(address, 'has an unsupported schema or does not match its canonical Game binding');
-}
-function derive(seed, addresses) {
-    return getProgramDerivedAddress({
-        programAddress: SAGE_PROGRAM_ADDRESS,
-        // Literal seeds match dev-sage 0.53.0 generated source; no trailing NUL.
-        seeds: [
-            new TextEncoder().encode(seed),
-            ...addresses.map((address) => getAddressEncoder().encode(address)),
-        ],
-    });
+        fail(address, 'has a newer layout (update Atlas Kit) or mismatched Game binding');
 }
 /** Resolve creation targets after the caller has freshly validated Game 2 and its initializer. */
 export async function resolveCharacterRegistrationXpRuntime(ctx, input, options) {
     const [config, budget] = await Promise.all([
-        derive('XpBudgetConfig', [input.game]),
-        derive('CareerXpBudget', [input.game, input.character]),
+        deriveXpBudgetConfigAddress(input.game),
+        deriveCareerXpBudgetAddress(input.game, input.character),
     ]);
     const [configAccount, budgetAccount] = await readContextRawAccounts(ctx, [config[0], budget[0]], options);
     const configValue = decode(configAccount, config[0], getXpBudgetConfigDecoder(), XP_BUDGET_CONFIG_DISCRIMINATOR);
@@ -68,10 +62,12 @@ export async function resolveXpRuntime(ctx, input, freshGameVersions, options) {
     const gameVersion = freshGameVersions?.get(game) ??
         (await readFreshGameRuntimeVersion(ctx, game, options));
     freshGameVersions?.set(game, gameVersion);
+    // SDK pin, not a game rule: the game treats unknown versions as current,
+    // but this release is qualified only against version 2.
     if (gameVersion !== 2)
         fail(game, gameVersion === 1
             ? 'belongs to a migration-sealed Game'
-            : `uses unsupported Game runtime version ${gameVersion}`);
+            : `uses Game version ${gameVersion} (update Atlas Kit)`);
     const intent = {
         game,
         gameVersion,
@@ -81,13 +77,13 @@ export async function resolveXpRuntime(ctx, input, freshGameVersions, options) {
     };
     const config = character === undefined
         ? undefined
-        : await derive('XpBudgetConfig', [game]);
+        : await deriveXpBudgetConfigAddress(game);
     const budget = character === undefined
         ? undefined
-        : await derive('CareerXpBudget', [game, character]);
+        : await deriveCareerXpBudgetAddress(game, character);
     const accrual = structure === undefined
         ? undefined
-        : await derive('StructureXpAccrual', [structure]);
+        : await deriveStructureXpAccrualAddress(structure);
     const addresses = [
         ...(config ? [config[0]] : []),
         ...(budget ? [budget[0]] : []),

package/dist/internal/planning/xp-runtime.js.map

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

package/dist/internal/read-meta.d.ts

@@ -80,6 +80,18 @@ type ReadMetaInput = Omit<ReadMeta, 'toJSON'>;
  * ```
  */
 export declare function readMeta<T extends object>(result: T): (unknown extends T ? ReadMeta | DefinitionPreloadMeta : T extends PreloadedDefinitions ? DefinitionPreloadMeta : PreloadedDefinitions extends T ? ReadMeta | DefinitionPreloadMeta : ReadMeta) | undefined;
+/** Projects one snapshot envelope's provenance under the strategy that read
+ * it. */
+export declare function envelopeMeta<TStrategy extends DiscoveryStrategy>(envelope: {
+    readonly commitment: Commitment;
+    readonly slot: bigint;
+    readonly source: DataSourceIdentity;
+}, strategy: TStrategy): {
+    readonly commitment: Commitment;
+    readonly slot: bigint;
+    readonly source: DataSourceIdentity;
+    readonly strategy: TStrategy;
+};
 export declare function attachReadMeta<T extends object>(result: T, meta: ReadMeta | ReadMetaInput | DefinitionPreloadMeta | Omit<DefinitionPreloadMeta, 'toJSON'>): T;
 declare const PRELOADED_DEFINITIONS: unique symbol;
 /** The immutable section names satisfied by one preload call.

package/dist/internal/read-meta.d.ts.map

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

package/dist/internal/read-meta.js

@@ -3,6 +3,16 @@ const READ_META = Symbol('aephia.sage.readMeta');
 export function readMeta(result) {
     return result[READ_META];
 }
+/** Projects one snapshot envelope's provenance under the strategy that read
+ * it. */
+export function envelopeMeta(envelope, strategy) {
+    return {
+        commitment: envelope.commitment,
+        slot: envelope.slot,
+        source: envelope.source,
+        strategy,
+    };
+}
 export function attachReadMeta(result, meta) {
     const serializedMeta = Object.freeze(attachJsonSerialization({
         ...meta,

package/dist/internal/read-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-meta.js","sourceRoot":"","sources":["../../src/internal/read-meta.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,SAAS,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAqGjD,MAAM,UAAU,QAAQ,CACtB,MAAc;IAEd,OAAQ,MAA0B,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAS,EACT,IAIyC;IAEzC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAClC,uBAAuB,CAAC;QACtB,GAAG,IAAI;KACR,CAAC,CACH,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE;QACvC,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"read-meta.js","sourceRoot":"","sources":["../../src/internal/read-meta.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,SAAS,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAqGjD,MAAM,UAAU,QAAQ,CACtB,MAAc;IAEd,OAAQ,MAA0B,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC;AAED;SACS;AACT,MAAM,UAAU,YAAY,CAC1B,QAIC,EACD,QAAmB;IAOnB,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAS,EACT,IAIyC;IAEzC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAClC,uBAAuB,CAAC;QACtB,GAAG,IAAI;KACR,CAAC,CACH,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE;QACvC,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -1,6 +1,6 @@
 import type { SageContext } from '../../client/contracts.js';
 import { type PlanAuthorization } from '../../internal/planning/authorization-adapter.js';
-import { type Plan } from '../../planning/index.js';
+import type { Plan } from '../../planning/index.js';
 import type { LoyaltyAtlasBankSnapshot } from '../index.js';
 export type { PlanAuthorization };
 /** Exact inputs for claiming one Loyalty ATLAS Bank's full raw balance.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/loyalty/actions/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAczE,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAEL,KAAK,IAAI,EAEV,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,4BAA4B;IAC3C,yEAAyE;IACzE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAuHD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,wBAAwB,EAC9B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,IAAI,CAAC,CA4Hf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/loyalty/actions/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAczE,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAG5D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,4BAA4B;IAC3C,yEAAyE;IACzE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAuED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,wBAAwB,EAC9B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,IAAI,CAAC,CA0Hf"}