@aephia/atlas-kit 0.6.0-next.14 → 0.6.0-next.141

package/dist/internal/planning/plan-fields.js

@@ -0,0 +1,159 @@
+import { isAddress } from '@solana/kit';
+import { InvalidActionInputError } from '../../client/errors.js';
+export const MAX_U64 = 0xffffffffffffffffn;
+const DATA_HASH_PATTERN = /^[\da-f]{64}$/u;
+const UNSIGNED_DECIMAL = /^(0|[1-9][0-9]*)$/u;
+const SIGNED_DECIMAL = /^(0|-?[1-9][0-9]*)$/u;
+/** Rejects one Plan field with the shared recreate-or-hydrate remedy. */
+export function invalid(field, value, acceptedRange) {
+    throw new InvalidActionInputError(field, value, acceptedRange, 'Correct this Plan field and recreate or hydrate the Plan before retrying.');
+}
+export function readRecord(value, field) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        return invalid(field, value, 'a plain object');
+    }
+    return value;
+}
+export function assertKeys(value, field, required, optional = []) {
+    const accepted = new Set([...required, ...optional]);
+    const missing = required.find((key) => !Object.hasOwn(value, key));
+    const unexpected = Object.keys(value).find((key) => !accepted.has(key));
+    if (missing !== undefined || unexpected !== undefined) {
+        invalid(field, missing === undefined ? unexpected : `missing ${missing}`, `exactly the fields ${[...required, ...optional].join(', ')}`);
+    }
+}
+export function readString(value, field) {
+    return typeof value === 'string' ? value : invalid(field, value, 'a string');
+}
+export function readAddress(value, field) {
+    return typeof value === 'string' && isAddress(value)
+        ? value
+        : invalid(field, value, 'a valid base58 Solana address');
+}
+const LABEL_ACCEPTED = 'a nonblank, NUL-free Unicode label of at most 64 UTF-8 bytes';
+function readLabel(value, field, fail) {
+    if (typeof value !== 'string')
+        return fail(field, value, 'a string');
+    const bytes = new TextEncoder().encode(value);
+    if (value.trim().length === 0 ||
+        value.includes('\0') ||
+        bytes.length > 64 ||
+        new TextDecoder('utf-8', { ignoreBOM: true }).decode(bytes) !== value)
+        fail(field, value, LABEL_ACCEPTED);
+    return value;
+}
+function readField(type, value, field, wire, fail) {
+    if (type === 'address')
+        return typeof value === 'string' && isAddress(value)
+            ? value
+            : fail(field, value, 'a valid base58 Solana address');
+    if (type === 'hash')
+        return typeof value === 'string' && DATA_HASH_PATTERN.test(value)
+            ? value
+            : fail(field, value, 'a lowercase 64-character SHA-256 hex digest');
+    if (type === 'string')
+        return typeof value === 'string' ? value : fail(field, value, 'a string');
+    if (type === 'text')
+        return typeof value === 'string' && value.trim().length > 0
+            ? value
+            : fail(field, value, 'a nonblank string');
+    if (type === 'label')
+        return readLabel(value, field, fail);
+    if ('values' in type)
+        return type.values.includes(value)
+            ? value
+            : fail(field, value, type.accepted);
+    if (typeof type.min === 'bigint') {
+        let parsed = value;
+        if (wire) {
+            const signed = type.min < 0n;
+            if (typeof value !== 'string' ||
+                !(signed ? SIGNED_DECIMAL : UNSIGNED_DECIMAL).test(value))
+                fail(field, value, signed
+                    ? 'a canonical decimal string'
+                    : 'a canonical unsigned decimal string');
+            parsed = BigInt(value);
+        }
+        return typeof parsed === 'bigint' &&
+            parsed >= type.min &&
+            parsed <= type.max
+            ? parsed
+            : fail(field, parsed, type.accepted);
+    }
+    const range = type;
+    return typeof value === 'number' &&
+        (range.finite ? Number.isFinite(value) : Number.isInteger(value)) &&
+        value >= range.min &&
+        value <= range.max
+        ? value
+        : fail(field, value, range.accepted);
+}
+/** Fields for the guard's `status` variant. The status is validated against
+ * its `status` field type before the exact-key check, and only own `byStatus`
+ * entries are used, so an inherited name such as `__proto__` is a typed status
+ * error, never a prototype lookup. A missing status is left to the exact-key
+ * check.
+ */
+function variantFields(guard, field, schema, wire, fail) {
+    const variants = schema.byStatus;
+    if (variants === undefined || !Object.hasOwn(guard, 'status'))
+        return [];
+    const [, type] = schema.fields.find(([key]) => key === 'status');
+    const status = readField(type, guard.status, `${field}.status`, wire, fail);
+    return typeof status === 'string' && Object.hasOwn(variants, status)
+        ? variants[status]
+        : [];
+}
+/** Validates one flat guard against its schema; `wire` decodes Plan JSON values.
+ * The result is frozen, with `kind` first, fields in schema order and
+ * `describes` last.
+ */
+export function normalizeSchemaGuard(guard, field, schema, wire) {
+    const fail = schema.error === undefined
+        ? invalid
+        : () => {
+            throw new InvalidActionInputError(String(guard.kind), guard, schema.error.accepted, schema.error.remedy);
+        };
+    const fields = [
+        ...schema.fields,
+        ...variantFields(guard, field, schema, wire, fail),
+    ];
+    // `describes` closes every guard, after any status-specific fields.
+    const entries = [
+        ...fields.filter(([key]) => key !== 'describes'),
+        ...fields.filter(([key]) => key === 'describes'),
+    ];
+    const keys = (optional) => entries.filter((entry) => (entry[2] === true) === optional).map(([k]) => k);
+    try {
+        assertKeys(guard, field, ['kind', ...keys(false)], keys(true));
+    }
+    catch (error) {
+        if (schema.error === undefined)
+            throw error;
+        fail(field, guard, 'exact guard fields');
+    }
+    const normalized = { kind: guard.kind };
+    for (const [key, type, optional] of entries) {
+        if (optional === true && guard[key] === undefined)
+            continue;
+        normalized[key] = readField(type, guard[key], `${field}.${key}`, wire, fail);
+    }
+    if (schema.check !== undefined && !schema.check(normalized))
+        fail(field, guard, 'internally consistent guard fields');
+    return Object.freeze(normalized);
+}
+/** Converts a guard to Plan JSON: bigint values become decimal strings and
+ * undefined members are omitted, at every depth, preserving key order.
+ */
+export function guardToWire(value) {
+    if (typeof value === 'bigint')
+        return String(value);
+    if (Array.isArray(value))
+        return value.map(guardToWire);
+    if (value === null || typeof value !== 'object')
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .filter(([, member]) => member !== undefined)
+        .map(([key, member]) => [key, guardToWire(member)]));
+}
+//# sourceMappingURL=plan-fields.js.map

package/dist/internal/planning/plan-fields.js.map

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

package/dist/internal/planning/plan-guards.d.ts

@@ -0,0 +1,4 @@
+import type { PlanPrecondition } from '../../planning/index.js';
+/** Validates one Plan guard; `wire` decodes its Plan JSON form. */
+export declare function normalizePrecondition(value: unknown, field: string, wire?: boolean): PlanPrecondition;
+//# sourceMappingURL=plan-guards.d.ts.map

package/dist/internal/planning/plan-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-guards.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/plan-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAqVhE,mEAAmE;AACnE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,IAAI,UAAQ,GACX,gBAAgB,CAkBlB"}

package/dist/internal/planning/plan-guards.js

@@ -0,0 +1,177 @@
+import { normalizeArrivalGuard } from './arrival-guards.js';
+import { FLEET_DOCK_FUNDING_SCHEMA } from './fleet-dock-funding-guard.js';
+import { LOCAL_MARKET_ORDER_SCHEMA } from './local-market-order.js';
+import { PROFILE_STORAGE_FUNDING_SCHEMA } from './profile-storage-funding-guard.js';
+import { MAX_U64, invalid, normalizeSchemaGuard, readRecord, } from './plan-fields.js';
+import { isRuntimeGuard, normalizeRuntimeGuard } from './runtime-guards.js';
+import { scanCompletionDiscriminators } from './scan-completion-guard.js';
+const U8 = {
+    min: 0,
+    max: 255,
+    accepted: 'an unsigned u8 integer',
+};
+const U16 = {
+    min: 0,
+    max: 65535,
+    accepted: 'an unsigned u16 integer',
+};
+const U32 = {
+    min: 0,
+    max: 4294967295,
+    accepted: 'an unsigned u32 integer',
+};
+const KEY_INDEX = { ...U16, accepted: 'a u16 Profile key index' };
+const SHIP_ID = {
+    ...U16,
+    accepted: 'a u16 ship configuration ID',
+};
+const CARGO_ID = { ...U16, accepted: 'a u16 cargo ID' };
+const U64 = {
+    min: 0n,
+    max: MAX_U64,
+    accepted: 'an unsigned u64 bigint',
+};
+const SEQUENCE = { ...U64, accepted: 'an unsigned u64 sequence' };
+const STARBASE_SEQUENCE = {
+    ...U64,
+    accepted: 'an unsigned u64 Starbase sequence',
+};
+const SYSTEM_GENERATION = {
+    ...U64,
+    accepted: 'an unsigned u64 System generation',
+};
+const CEILING = {
+    ...U64,
+    accepted: 'a nonnegative u64 funding ceiling',
+};
+const LAMPORTS = {
+    ...U64,
+    accepted: 'a nonnegative u64 lamport amount',
+};
+const address = (key) => [key, 'address'];
+const DESCRIBES = ['describes', 'string'];
+const AUTHORIZED = [
+    address('address'),
+    address('game'),
+    address('profile'),
+    address('authority'),
+    address('system'),
+    ['keyIndex', KEY_INDEX],
+];
+const FACTION_TRADE = [
+    address('address'),
+    address('game'),
+    ['factionId', U16],
+    ['schemaVersion', U8],
+    DESCRIBES,
+];
+const schema = (...fields) => ({
+    fields,
+});
+/** Every flat Plan guard kind; nested arrival and runtime guards keep their own readers. */
+const GUARD_SCHEMAS = {
+    'character-registration': schema(address('address'), address('game'), address('profile'), ['profileDataHash', 'hash'], address('funder'), address('xpBudget'), address('xpBudgetConfig'), ['maximumFunderDebit', CEILING], ['characterLamports', LAMPORTS], ['budgetLamports', LAMPORTS], [
+        'characterSize',
+        {
+            min: 423,
+            max: Number.MAX_SAFE_INTEGER,
+            accepted: 'a qualified Character allocation of at least 423 bytes',
+        },
+    ], ['initializationHash', 'hash'], DESCRIBES),
+    'ship-import-funding': schema(address('address'), address('game'), address('profile'), address('system'), ['shipId', SHIP_ID], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'fleet-attack': schema(address('address'), address('defender'), address('game'), address('profile'), address('defenderProfile'), ['instructionKey', 'string'], DESCRIBES),
+    'currency-cache': schema(address('address'), address('game'), DESCRIBES),
+    'movement-character': schema(address('address'), address('game'), address('profile'), ['stateHash', 'hash'], DESCRIBES),
+    'fleet-docking-policy': schema(address('address'), address('game'), address('system'), address('ownership'), address('starbasePlayer'), DESCRIBES),
+    'starbase-system': schema(address('address'), address('game'), ['starbaseSequenceId', STARBASE_SEQUENCE], [
+        'requireCss',
+        {
+            values: [true],
+            accepted: 'true when CSS access is required, otherwise omitted',
+        },
+        true,
+    ], DESCRIBES),
+    'fleet-mining': schema(address('address'), address('game'), address('profile'), address('asteroid'), DESCRIBES),
+    'faction-treasury-buy-versioned': schema(...FACTION_TRADE, ['cargoId', CARGO_ID], ['floorRaw', U64]),
+    'faction-treasury-sell-versioned': schema(...FACTION_TRADE, ['atlasOutCapPerEpochRaw', U64], [
+        'epochLengthSeconds',
+        { min: -(1n << 63n), max: (1n << 63n) - 1n, accepted: 'an i64 bigint' },
+    ]),
+    'faction-epoch-meter-versioned': schema(...FACTION_TRADE),
+    'fleet-add-ship': schema(...AUTHORIZED, ['shipId', SHIP_ID], [
+        'amount',
+        {
+            min: 1n,
+            max: 255n,
+            accepted: 'a whole ship quantity from 1n through 255n',
+        },
+    ], ['maximumProfileDebit', CEILING], ['configHash', 'hash'], DESCRIBES),
+    'research-unlock': schema(...AUTHORIZED, address('starbasePlayer'), address('currencyCache'), ['nodeId', { ...U16, accepted: 'a u16 research node ID' }], [
+        'level',
+        { ...U32, min: 1, accepted: 'a u32 research node level of at least 1' },
+    ], [
+        'researchSequenceId',
+        { ...U32, accepted: 'a u32 research definition sequence' },
+    ], ['xpSequenceId', { ...U32, accepted: 'a u32 XP definition sequence' }], ['maximumAtlasDebit', CEILING], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'scan-completion': schema([
+        'operation',
+        {
+            values: Object.keys(scanCompletionDiscriminators),
+            accepted: 'a supported scan lifecycle operation',
+        },
+    ], ...[
+        'address',
+        'game',
+        'signal',
+        'profile',
+        'character',
+        'authority',
+        'policy',
+        'loot',
+        'xpBudget',
+        'xpConfig',
+    ].map(address), ['keyIndex', KEY_INDEX], ['status', { min: 1, max: 6, accepted: 'a current nonempty signal state' }], ['expectedSequence', SEQUENCE], ['configHash', 'hash'], DESCRIBES),
+    'scan-detect': schema(...[
+        'address',
+        'game',
+        'profile',
+        'authority',
+        'character',
+        'signal',
+        'pattern',
+        'policy',
+        'loot',
+        'tracker',
+    ].map(address), ['keyIndex', KEY_INDEX], ['patternId', U16], ['focus', { min: 0, max: 4, accepted: 'a scan focus from 0 through 4' }], ['policyRevision', U32], ['profileRevision', U32], ['expectedSequence', SEQUENCE], ['configHash', 'hash'], DESCRIBES),
+    'fleet-crew-transfer': schema(['direction', { values: ['load', 'unload'], accepted: 'load or unload' }], ...AUTHORIZED.slice(0, 5), address('starbasePlayer'), ['count', { min: 1, max: 65535, accepted: 'a positive u16 crew count' }], ['keyIndex', KEY_INDEX], ['systemSequenceId', SYSTEM_GENERATION], DESCRIBES),
+    'fleet-respawn': schema(...AUTHORIZED, ['phase', { values: ['start', 'complete'], accepted: 'start or complete' }], ['fleetHash', 'hash'], ['maximumRecoveryFee', CEILING], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'scan-signal-open': schema(['authorityHash', 'hash'], ...['address', 'game', 'fleet', 'profile', 'authority', 'character'].map(address), ['keyIndex', KEY_INDEX], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'fleet-create': schema(...AUTHORIZED, ['label', 'label'], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'system-account-or-absent': schema(address('address'), DESCRIBES),
+    'recipe-state': schema(address('address'), ['configHash', 'hash'], ['requiredUses', U64], DESCRIBES),
+    'token-mint': schema(address('address'), ['decimals', { ...U8, accepted: 'an unsigned u8 mint decimals value' }], DESCRIBES),
+    'game-ship-config': schema(address('address'), ['shipId', SHIP_ID], ['configHash', 'hash'], DESCRIBES),
+    'game-account': schema(address('address'), DESCRIBES),
+    'token-account': schema(address('address'), address('mint'), address('owner'), ['minimumBalance', U64], DESCRIBES),
+    'game-cargo-bytes-config': schema(address('address'), ['cargoId', CARGO_ID], ['configHash', 'hash'], DESCRIBES),
+    'cargo-cache': schema(address('address'), address('game'), ['bump', { ...U8, accepted: 'a u8 PDA bump' }], DESCRIBES),
+    'token-account-or-absent': schema(address('address'), address('mint'), address('owner'), DESCRIBES),
+    'account-absent': schema(address('address'), DESCRIBES),
+    'account-state': schema(address('address'), ['dataHash', 'hash'], DESCRIBES),
+    'fleet-dock-funding': FLEET_DOCK_FUNDING_SCHEMA,
+    'local-market-order': LOCAL_MARKET_ORDER_SCHEMA,
+    'profile-storage-funding': PROFILE_STORAGE_FUNDING_SCHEMA,
+};
+/** Validates one Plan guard; `wire` decodes its Plan JSON form. */
+export function normalizePrecondition(value, field, wire = false) {
+    const guard = readRecord(value, field);
+    if (guard.kind === 'fleet-arrival')
+        return normalizeArrivalGuard(guard, field, wire);
+    if (isRuntimeGuard(guard))
+        return normalizeRuntimeGuard(guard, field, wire);
+    const kind = guard.kind;
+    if (typeof kind !== 'string' || !Object.hasOwn(GUARD_SCHEMAS, kind))
+        return invalid(`${field}.kind`, kind, 'a supported current Plan guard; recreate the Plan using the current capability planner');
+    return normalizeSchemaGuard(guard, field, GUARD_SCHEMAS[kind], wire);
+}
+//# sourceMappingURL=plan-guards.js.map

package/dist/internal/planning/plan-guards.js.map

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

package/dist/internal/planning/profile-key.d.ts

@@ -0,0 +1,13 @@
+import type { Address } from '@solana/kit';
+import type { ProfileKeyData } from '../c4/identity.js';
+/** The Profile key at `keyIndex` when it belongs to `authority`. Each planner
+ * keeps its own permission predicate and remedy; these helpers share only the
+ * key identity, expiry and scope mechanics. */
+export declare function directProfileKey(keys: readonly ProfileKeyData[], keyIndex: number, authority: Address): ProfileKeyData | undefined;
+/** Whether the key expired before `now`; a negative expiry never expires. */
+export declare function profileKeyExpired(key: ProfileKeyData, now: bigint): boolean;
+/** Whether the key's permission mask holds `bit`, whatever its scope. */
+export declare function hasPermissionBit(key: ProfileKeyData, bit: bigint): boolean;
+/** Whether the key is scoped to `scope` and holds permission `bit` there. */
+export declare function grantsPermission(key: ProfileKeyData, scope: Address, bit: bigint): boolean;
+//# sourceMappingURL=profile-key.d.ts.map

package/dist/internal/planning/profile-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-key.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/profile-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;+CAE+C;AAC/C,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,cAAc,EAAE,EAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,GACjB,cAAc,GAAG,SAAS,CAG5B;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAET"}

package/dist/internal/planning/profile-key.js

@@ -0,0 +1,20 @@
+/** The Profile key at `keyIndex` when it belongs to `authority`. Each planner
+ * keeps its own permission predicate and remedy; these helpers share only the
+ * key identity, expiry and scope mechanics. */
+export function directProfileKey(keys, keyIndex, authority) {
+    const key = keys[keyIndex];
+    return key?.address === authority ? key : undefined;
+}
+/** Whether the key expired before `now`; a negative expiry never expires. */
+export function profileKeyExpired(key, now) {
+    return key.expiresAtRaw >= 0n && key.expiresAtRaw < now;
+}
+/** Whether the key's permission mask holds `bit`, whatever its scope. */
+export function hasPermissionBit(key, bit) {
+    return (key.permissionsRaw & (1n << bit)) !== 0n;
+}
+/** Whether the key is scoped to `scope` and holds permission `bit` there. */
+export function grantsPermission(key, scope, bit) {
+    return key.scope === scope && hasPermissionBit(key, bit);
+}
+//# sourceMappingURL=profile-key.js.map

package/dist/internal/planning/profile-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-key.js","sourceRoot":"","sources":["../../../src/internal/planning/profile-key.ts"],"names":[],"mappings":"AAIA;;+CAE+C;AAC/C,MAAM,UAAU,gBAAgB,CAC9B,IAA+B,EAC/B,QAAgB,EAChB,SAAkB;IAElB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,GAAmB,EAAE,GAAW;IAChE,OAAO,GAAG,CAAC,YAAY,IAAI,EAAE,IAAI,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC;AAC1D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,GAAmB,EAAE,GAAW;IAC/D,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;AACnD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAC9B,GAAmB,EACnB,KAAc,EACd,GAAW;IAEX,OAAO,GAAG,CAAC,KAAK,KAAK,KAAK,IAAI,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { Instruction } from '@solana/kit';
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+import { type GuardSchema } from './plan-fields.js';
+/** Bytes one new cargo line (u16 cargo id, u64 amount) adds to a cargo pod. */
+export declare const CARGO_LINE_BYTES = 10;
+/** Instructions whose account storage the Profile funds. Each is evaluated in
+ * Plan order; all but a subwarp stop also carry a funding guard. */
+export type StorageInstruction = 'deposit' | 'starbase-transfer' | 'within-fleet-transfer' | 'start-mining' | 'stop-mining' | 'stop-subwarp' | 'cancel-market-orders' | 'faction-trade' | 'start-subwarp' | 'warp-to-coordinate' | 'warp-lane' | 'start-crafting' | 'cancel-crafting' | 'apply-stimulant' | 'retrieve-loot';
+/** Which Profile-funded instruction this is, if any, the index of the account
+ * its guard names, and whether it carries a guard. */
+export declare function storageInstruction(instruction: Instruction): {
+    readonly kind: StorageInstruction;
+    readonly primary: number;
+    readonly guarded: boolean;
+} | undefined;
+/** Persisted Profile storage funding of one action: the Profile, signer and
+ * first resized account that bind it to its instruction, and the planned
+ * debit ceiling. Everything else is rederived from the instruction. */
+export type ProfileStorageFundingGuard = Extract<PlanPrecondition, {
+    readonly kind: 'profile-storage-funding';
+}>;
+export declare const PROFILE_STORAGE_FUNDING_SCHEMA: GuardSchema;
+/** Binds every guarded Profile-funded instruction to exactly one storage funding guard
+ * for its Profile, signer and first resized account, so a saved Plan cannot
+ * drop or retarget its funding check; a guard without its instruction is
+ * refused too. */
+export declare function validateProfileStorageFundingGuards(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=profile-storage-funding-guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile-storage-funding-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/profile-storage-funding-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAmB1E,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAE1B,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;oEACoE;AACpE,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,mBAAmB,GACnB,uBAAuB,GACvB,cAAc,GACd,aAAa,GACb,cAAc,GACd,sBAAsB,GACtB,eAAe,GACf,eAAe,GACf,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,CAAC;AA0BpB;sDACsD;AACtD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GACvD;IACE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,GACD,SAAS,CAMZ;AAED;;uEAEuE;AACvE,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,gBAAgB,EAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAA;CAAE,CAC7C,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,WAe5C,CAAC;AAEF;;;kBAGkB;AAClB,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CA2BN"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile-storage-funding-guard.js","sourceRoot":"","sources":["../../../src/internal/planning/profile-storage-funding-guard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EACL,oCAAoC,EACpC,qCAAqC,EACrC,wCAAwC,EACxC,mCAAmC,EACnC,2BAA2B,EAC3B,oCAAoC,EACpC,mCAAmC,EACnC,2BAA2B,EAC3B,kCAAkC,EAClC,0BAA0B,EAC1B,kCAAkC,EAClC,qCAAqC,EACrC,yCAAyC,EACzC,uBAAuB,EACvB,gCAAgC,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACL,OAAO,GAGR,MAAM,kBAAkB,CAAC;AAE1B,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAqBnC;;;;;oBAKoB;AACpB,MAAM,oBAAoB,GAAG;IAC3B,CAAC,SAAS,EAAE,mCAAmC,EAAE,CAAC,EAAE,IAAI,CAAC;IACzD,CAAC,mBAAmB,EAAE,qCAAqC,EAAE,CAAC,EAAE,IAAI,CAAC;IACrE,CAAC,uBAAuB,EAAE,yCAAyC,EAAE,CAAC,EAAE,IAAI,CAAC;IAC7E,CAAC,cAAc,EAAE,mCAAmC,EAAE,CAAC,EAAE,IAAI,CAAC;IAC9D,CAAC,aAAa,EAAE,kCAAkC,EAAE,CAAC,EAAE,IAAI,CAAC;IAC5D,CAAC,cAAc,EAAE,0BAA0B,EAAE,CAAC,EAAE,KAAK,CAAC;IACtD,CAAC,sBAAsB,EAAE,wCAAwC,EAAE,CAAC,EAAE,IAAI,CAAC;IAC3E,CAAC,eAAe,EAAE,kCAAkC,EAAE,CAAC,EAAE,IAAI,CAAC;IAC9D,CAAC,eAAe,EAAE,2BAA2B,EAAE,CAAC,EAAE,IAAI,CAAC;IACvD,CAAC,oBAAoB,EAAE,gCAAgC,EAAE,CAAC,EAAE,IAAI,CAAC;IACjE,CAAC,WAAW,EAAE,uBAAuB,EAAE,CAAC,EAAE,IAAI,CAAC;IAC/C,CAAC,gBAAgB,EAAE,oCAAoC,EAAE,CAAC,EAAE,IAAI,CAAC;IACjE,CAAC,iBAAiB,EAAE,qCAAqC,EAAE,CAAC,EAAE,IAAI,CAAC;IACnE,CAAC,iBAAiB,EAAE,oCAAoC,EAAE,CAAC,EAAE,IAAI,CAAC;IAClE,CAAC,eAAe,EAAE,2BAA2B,EAAE,CAAC,EAAE,IAAI,CAAC;CAC/C,CAAC;AAEX;sDACsD;AACtD,MAAM,UAAU,kBAAkB,CAAC,WAAwB;IAOzD,IAAI,WAAW,CAAC,cAAc,KAAK,oBAAoB;QAAE,OAAO,SAAS,CAAC;IAC1E,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,EAAE,CAC5D,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CACzE,CAAC;IACF,OAAO,KAAK,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC;AAUD,MAAM,CAAC,MAAM,8BAA8B,GAAgB;IACzD,MAAM,EAAE;QACN,CAAC,SAAS,EAAE,SAAS,CAAC;QACtB,CAAC,SAAS,EAAE,SAAS,CAAC;QACtB,CAAC,WAAW,EAAE,SAAS,CAAC;QACxB;YACE,qBAAqB;YACrB;gBACE,GAAG,EAAE,EAAE;gBACP,GAAG,EAAE,OAAO;gBACZ,QAAQ,EAAE,mCAAmC;aAC9C;SACF;QACD,CAAC,WAAW,EAAE,QAAQ,CAAC;KACsB;CAChD,CAAC;AAEF;;;kBAGkB;AAClB,MAAM,UAAU,mCAAmC,CACjD,KAA0B,EAC1B,MAAmC;IAEnC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAC7B,CAAC,KAAK,EAAuC,EAAE,CAC7C,KAAK,CAAC,IAAI,KAAK,yBAAyB,CAC3C,CAAC;IACF,KAAK,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,EAAE,OAAO;YAAE,SAAS;QAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC;QACnC,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAC/B,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO;YACvC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO;YACnC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAClD,CAAC;QACF,IAAI,KAAK,GAAG,CAAC;YACX,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,2KAA2K,CAC5K,CAAC;QACJ,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QACtB,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,kGAAkG,CACnG,CAAC;AACN,CAAC"}

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

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

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

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