@aephia/atlas-kit 0.6.0-next.9 → 0.6.0-next.90

package/dist/fleets/warp-lane-policy.d.ts

@@ -0,0 +1,68 @@
+import type { FactionRegionData } from '../internal/c4/factions.js';
+import type { RiskZoneAccess } from '../internal/c4/identity.js';
+import type { WorldFaction, WorldStarbaseLevel } from '../internal/c4/world.js';
+/** Explicit lane policy inputs; destinationRegion must contain the destination coordinates.
+ * A System's stored region id alone does not establish this spatial relationship.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLanePolicyInput;
+ * console.log(input.destinationRegion.risk, input.securityZoneAccess);
+ * ```
+ */
+export interface FleetWarpLanePolicyInput {
+    readonly fleetFaction: WorldFaction;
+    readonly sourceOwner: WorldFaction;
+    readonly destinationOwner: WorldFaction;
+    readonly sourceLevel: WorldStarbaseLevel;
+    readonly destinationLevel: WorldStarbaseLevel;
+    readonly crossFactionEconomicsEnabled: boolean;
+    readonly destinationRegion: Pick<FactionRegionData, 'owner' | 'safety' | 'risk'>;
+    readonly securityZoneAccess: RiskZoneAccess;
+}
+/** A bounded policy failure, not a simulation or transaction error.
+ * @example
+ * ```ts
+ * const reason: FleetWarpLanePolicyFailure = 'foreign-low-risk';
+ * ```
+ */
+export type FleetWarpLanePolicyFailure = 'source-level-zero' | 'destination-level-zero' | 'cross-faction-disabled' | 'foreign-low-risk' | 'security-zone-access';
+/** Policy result only: passing never proves travel eligibility or affordability.
+ * @example
+ * ```ts
+ * declare const assessment: FleetWarpLanePolicy;
+ * console.log(assessment.passesPolicy, assessment.failures);
+ * ```
+ */
+export interface FleetWarpLanePolicy {
+    readonly passesPolicy: boolean;
+    readonly failures: readonly FleetWarpLanePolicyFailure[];
+    readonly effectiveRisk: FactionRegionData['risk'];
+    toJSON(): unknown;
+}
+/** Assesses qualified lane policy independently of Plan validation or execution.
+ * Both endpoint owners must equal Fleet faction when cross-faction economics is
+ * disabled. Both endpoint Starbases need nonzero levels. Stored low risk keeps
+ * its embedded faction; Safe medium/high becomes low risk of the region owner,
+ * while Border retains its tier. Foreign low risk rejects; higher tiers require
+ * sufficient Character access. Relationships and combat/territory gates do not
+ * block the tested lane policy.
+ *
+ * Only playable factions and known levels/tiers are supported. Resolve the
+ * region containing the destination coordinates before calling: this pure
+ * helper does not perform spatial lookup and does not trust a System region id
+ * on your behalf. It checks no connection, Fleet state, cooldown, crew, XP,
+ * permission, toll or available balance. Deployment 54356023 is the empirical
+ * scope; requalify on relevant game changes and simulate before signing.
+ * @example
+ * ```ts
+ * const result = deriveFleetWarpLanePolicy({
+ *   fleetFaction: 'oni', sourceOwner: 'oni', destinationOwner: 'oni',
+ *   sourceLevel: 'css', destinationLevel: 'level-1',
+ *   crossFactionEconomicsEnabled: false, securityZoneAccess: 'low',
+ *   destinationRegion: { owner: 'oni', safety: 'safe',
+ *     risk: { kind: 'low', faction: 'oni' } },
+ * }); // passesPolicy: true; still simulate the actual Plan
+ * ```
+ */
+export declare function deriveFleetWarpLanePolicy(input: FleetWarpLanePolicyInput): FleetWarpLanePolicy;
+//# sourceMappingURL=warp-lane-policy.d.ts.map

package/dist/fleets/warp-lane-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-lane-policy.d.ts","sourceRoot":"","sources":["../../src/fleets/warp-lane-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGhF;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;IAC9C,QAAQ,CAAC,4BAA4B,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,IAAI,CAC9B,iBAAiB,EACjB,OAAO,GAAG,QAAQ,GAAG,MAAM,CAC5B,CAAC;IACF,QAAQ,CAAC,kBAAkB,EAAE,cAAc,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAClC,mBAAmB,GACnB,wBAAwB,GACxB,wBAAwB,GACxB,kBAAkB,GAClB,sBAAsB,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACzD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,mBAAmB,CA2ErB"}

package/dist/fleets/warp-lane-policy.js

@@ -0,0 +1,91 @@
+import { InvalidDerivationInputError } from '../client/index.js';
+import { attachJsonSerialization } from '../internal/json.js';
+/** Assesses qualified lane policy independently of Plan validation or execution.
+ * Both endpoint owners must equal Fleet faction when cross-faction economics is
+ * disabled. Both endpoint Starbases need nonzero levels. Stored low risk keeps
+ * its embedded faction; Safe medium/high becomes low risk of the region owner,
+ * while Border retains its tier. Foreign low risk rejects; higher tiers require
+ * sufficient Character access. Relationships and combat/territory gates do not
+ * block the tested lane policy.
+ *
+ * Only playable factions and known levels/tiers are supported. Resolve the
+ * region containing the destination coordinates before calling: this pure
+ * helper does not perform spatial lookup and does not trust a System region id
+ * on your behalf. It checks no connection, Fleet state, cooldown, crew, XP,
+ * permission, toll or available balance. Deployment 54356023 is the empirical
+ * scope; requalify on relevant game changes and simulate before signing.
+ * @example
+ * ```ts
+ * const result = deriveFleetWarpLanePolicy({
+ *   fleetFaction: 'oni', sourceOwner: 'oni', destinationOwner: 'oni',
+ *   sourceLevel: 'css', destinationLevel: 'level-1',
+ *   crossFactionEconomicsEnabled: false, securityZoneAccess: 'low',
+ *   destinationRegion: { owner: 'oni', safety: 'safe',
+ *     risk: { kind: 'low', faction: 'oni' } },
+ * }); // passesPolicy: true; still simulate the actual Plan
+ * ```
+ */
+export function deriveFleetWarpLanePolicy(input) {
+    const invalid = (field, value) => {
+        throw new InvalidDerivationInputError(field, value, 'Use current playable-faction ownership, known Starbase levels and the region containing the destination coordinates, with current Character access. Unknown or NPC policy is not qualified; refresh and simulate the lane Plan.');
+    };
+    const playable = (field, faction) => {
+        if (faction !== 'mud' && faction !== 'oni' && faction !== 'ustur')
+            invalid(field, faction);
+    };
+    playable('Fleet faction', input.fleetFaction);
+    playable('Source owner', input.sourceOwner);
+    playable('Destination owner', input.destinationOwner);
+    playable('Destination region owner', input.destinationRegion.owner);
+    const levels = [
+        'level-0',
+        'level-1',
+        'level-2',
+        'level-3',
+        'level-4',
+        'level-5',
+        'css',
+    ];
+    if (!levels.includes(input.sourceLevel))
+        invalid('Source Starbase level', input.sourceLevel);
+    if (!levels.includes(input.destinationLevel))
+        invalid('Destination Starbase level', input.destinationLevel);
+    if (typeof input.crossFactionEconomicsEnabled !== 'boolean')
+        invalid('Cross-faction flag type', typeof input.crossFactionEconomicsEnabled);
+    const { risk, safety, owner } = input.destinationRegion;
+    if (safety !== 'safe' && safety !== 'border')
+        invalid('Region safety', safety);
+    const kind = risk.kind;
+    if (kind !== 'low' && kind !== 'medium' && kind !== 'high')
+        invalid('Region risk', kind);
+    if (risk.kind === 'low')
+        playable('Low-risk faction', risk.faction);
+    const tiers = { low: 0, medium: 1, high: 2 };
+    if (!Object.hasOwn(tiers, input.securityZoneAccess))
+        invalid('Character security-zone access', input.securityZoneAccess);
+    const effectiveRisk = Object.freeze(risk.kind === 'low'
+        ? { ...risk }
+        : safety === 'safe'
+            ? { kind: 'low', faction: owner }
+            : { ...risk });
+    const failures = [];
+    if (input.sourceLevel === 'level-0')
+        failures.push('source-level-zero');
+    if (input.destinationLevel === 'level-0')
+        failures.push('destination-level-zero');
+    if (!input.crossFactionEconomicsEnabled &&
+        (input.sourceOwner !== input.fleetFaction ||
+            input.destinationOwner !== input.fleetFaction))
+        failures.push('cross-faction-disabled');
+    if (effectiveRisk.kind === 'low' &&
+        effectiveRisk.faction !== input.fleetFaction)
+        failures.push('foreign-low-risk');
+    if (tiers[effectiveRisk.kind] > tiers[input.securityZoneAccess])
+        failures.push('security-zone-access');
+    return Object.freeze(attachJsonSerialization({
+        passesPolicy: failures.length === 0,
+        failures: Object.freeze(failures),
+        effectiveRisk,
+    }));
+}
+//# sourceMappingURL=warp-lane-policy.js.map

package/dist/fleets/warp-lane-policy.js.map

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

package/dist/fleets/warp-lane-toll.d.ts

@@ -0,0 +1,55 @@
+import type { FactionRelationship } from '../internal/c4/factions.js';
+import type { WorldConnectionCosts, WorldFaction, WorldStarbaseLevel } from '../internal/c4/world.js';
+/** Current source connection costs, ownership and Character fee modifier.
+ * destinationRelationship is Fleet-to-destination-owner, not endpoint-to-endpoint.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLaneTollInput;
+ * console.log(input.sourceLevel, input.feeModifierRaw);
+ * ```
+ */
+export interface FleetWarpLaneTollInput {
+    readonly costs: Pick<WorldConnectionCosts, 'level1Raw' | 'level2Raw' | 'level3Raw' | 'level4Raw' | 'level5Raw' | 'cssRaw'>;
+    readonly sourceLevel: WorldStarbaseLevel;
+    readonly fleetFaction: WorldFaction;
+    readonly sourceOwner: WorldFaction;
+    readonly destinationOwner: WorldFaction;
+    readonly destinationRelationship: FactionRelationship;
+    readonly feeModifierRaw: bigint;
+    readonly alliedTollBps: number;
+    readonly neutralTollBps: number;
+}
+/** Character's prospective ATLAS debit, entirely in raw ATLAS units (Floyds).
+ * @example
+ * ```ts
+ * declare const toll: FleetWarpLaneToll;
+ * console.log(toll.modifiedBaseRaw, toll.surchargeRaw, toll.totalRaw);
+ * ```
+ */
+export interface FleetWarpLaneToll {
+    readonly baseRaw: bigint;
+    readonly modifiedBaseRaw: bigint;
+    readonly surchargeRaw: bigint;
+    readonly totalRaw: bigint;
+    toJSON(): unknown;
+}
+/** Estimates the Character ATLAS toll using deployment-54356023 lane rules.
+ * Selects cost by departure level. Ceils the Character-modified base, then adds
+ * a separately floored surcharge on the unmodified base if either endpoint is
+ * foreign. Allied uses allied bps; neutral/hostile/ceasefire use neutral bps.
+ * A foreign source with own destination uses neutral bps. Modifier zero waives
+ * only the modified base. Relationship expiry does not alter the measured toll.
+ *
+ * Accepts playable factions only, usable source levels, u64 raw base cost,
+ * nonnegative i64 raw I32F32 modifier, and u16 bps. Rejects a result beyond u64.
+ * No RPC, balance, connection, region, permission or execution checks occur.
+ * ATLAS is paid from Character, not wallet. Requalify after program changes.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLaneTollInput;
+ * const toll = deriveFleetWarpLaneToll(input);
+ * console.log(toll.totalRaw);
+ * ```
+ */
+export declare function deriveFleetWarpLaneToll(input: FleetWarpLaneTollInput): FleetWarpLaneToll;
+//# sourceMappingURL=warp-lane-toll.d.ts.map

package/dist/fleets/warp-lane-toll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-lane-toll.d.ts","sourceRoot":"","sources":["../../src/fleets/warp-lane-toll.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAClB,oBAAoB,EAClB,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,QAAQ,CACX,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,QAAQ,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,MAAM,IAAI,OAAO,CAAC;CACnB;AAUD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,iBAAiB,CAyDnB"}

package/dist/fleets/warp-lane-toll.js

@@ -0,0 +1,79 @@
+import { InvalidDerivationInputError } from '../client/index.js';
+import { attachJsonSerialization } from '../internal/json.js';
+const amountMax = (1n << 64n) - 1n;
+const modifierScale = 1n << 32n;
+const remedy = 'Refresh the source connection, source Starbase level, playable Fleet/Starbase factions, Fleet-to-destination relationship, fee modifier and toll basis points. Only qualified nonnegative values and a u64 ATLAS debit are supported; simulate the lane Plan before signing.';
+function invalid(field, value) {
+    throw new InvalidDerivationInputError(field, value, remedy);
+}
+/** Estimates the Character ATLAS toll using deployment-54356023 lane rules.
+ * Selects cost by departure level. Ceils the Character-modified base, then adds
+ * a separately floored surcharge on the unmodified base if either endpoint is
+ * foreign. Allied uses allied bps; neutral/hostile/ceasefire use neutral bps.
+ * A foreign source with own destination uses neutral bps. Modifier zero waives
+ * only the modified base. Relationship expiry does not alter the measured toll.
+ *
+ * Accepts playable factions only, usable source levels, u64 raw base cost,
+ * nonnegative i64 raw I32F32 modifier, and u16 bps. Rejects a result beyond u64.
+ * No RPC, balance, connection, region, permission or execution checks occur.
+ * ATLAS is paid from Character, not wallet. Requalify after program changes.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLaneTollInput;
+ * const toll = deriveFleetWarpLaneToll(input);
+ * console.log(toll.totalRaw);
+ * ```
+ */
+export function deriveFleetWarpLaneToll(input) {
+    for (const [field, faction] of [
+        ['Fleet faction', input.fleetFaction],
+        ['Source owner', input.sourceOwner],
+        ['Destination owner', input.destinationOwner],
+    ])
+        if (faction !== 'mud' && faction !== 'oni' && faction !== 'ustur')
+            invalid(field, faction);
+    const levelKeys = {
+        'level-1': 'level1Raw',
+        'level-2': 'level2Raw',
+        'level-3': 'level3Raw',
+        'level-4': 'level4Raw',
+        'level-5': 'level5Raw',
+        css: 'cssRaw',
+    };
+    if (!Object.hasOwn(levelKeys, input.sourceLevel))
+        invalid('Source Starbase level', input.sourceLevel);
+    const baseRaw = input.costs[levelKeys[input.sourceLevel]];
+    if (baseRaw < 0n || baseRaw > amountMax)
+        invalid('Base ATLAS toll raw', baseRaw);
+    if (input.feeModifierRaw < 0n || input.feeModifierRaw > (1n << 63n) - 1n)
+        invalid('Character lane fee modifier raw', input.feeModifierRaw);
+    for (const [field, bps] of [
+        ['Allied toll bps', input.alliedTollBps],
+        ['Neutral toll bps', input.neutralTollBps],
+    ])
+        if (!Number.isInteger(bps) || bps < 0 || bps > 65535)
+            invalid(field, bps);
+    const relation = input.destinationRelationship;
+    if (relation !== 'allied' &&
+        relation !== 'neutral' &&
+        relation !== 'hostile' &&
+        relation !== 'ceasefire')
+        invalid('Destination relationship', relation);
+    const crossFaction = input.sourceOwner !== input.fleetFaction ||
+        input.destinationOwner !== input.fleetFaction;
+    const bps = input.destinationOwner !== input.fleetFaction && relation === 'allied'
+        ? input.alliedTollBps
+        : input.neutralTollBps;
+    const modifiedBaseRaw = (baseRaw * input.feeModifierRaw + modifierScale - 1n) / modifierScale;
+    const surchargeRaw = crossFaction ? (baseRaw * BigInt(bps)) / 10000n : 0n;
+    const totalRaw = modifiedBaseRaw + surchargeRaw;
+    if (totalRaw > amountMax)
+        invalid('Total ATLAS toll raw', totalRaw);
+    return Object.freeze(attachJsonSerialization({
+        baseRaw,
+        modifiedBaseRaw,
+        surchargeRaw,
+        totalRaw,
+    }));
+}
+//# sourceMappingURL=warp-lane-toll.js.map

package/dist/fleets/warp-lane-toll.js.map

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

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

@@ -34,6 +34,8 @@ export interface PlanCreateProfileOptions {
 /** Plans a new signer-created Profile with explicit scoped permissions.
  * The new Profile, storage funder, and every Player Profile AUTH key sign creation,
  * even when the editing threshold is lower. Other keys remain readonly.
+ * The new Profile signer is needed only for creation unless explicitly listed
+ * among the initial authority keys; creating the account does not grant it AUTH.
  * The threshold governs protected Profile updates; it is not a gameplay-wide multisig policy.
  * Existing target accounts and a Profile address equal to its funder are rejected.
  * No Game load, onboarding, funding top-up, key generation or signing is implicit.

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

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

package/dist/identity/actions/create-profile.js

@@ -30,26 +30,27 @@ function options(input) {
         invalid('options.keys', raw.keys, 'Specify at least one non-expiring Player Profile AUTH key.');
     const seen = new Set();
     const keys = [];
-    for (const value of raw.keys) {
-        const key = record(value, 'options.keys[]', [
+    for (const [index, value] of raw.keys.entries()) {
+        const path = `options.keys[${index}]`;
+        const key = record(value, path, [
             'address',
             'scope',
             'permissionsRaw',
             'expiresAt',
         ]);
-        const address = validAddress(key.address, 'key.address', false);
-        const scope = validAddress(key.scope, 'key.scope', false);
+        const address = validAddress(key.address, `${path}.address`, false);
+        const scope = validAddress(key.scope, `${path}.scope`, false);
         const permissionsRaw = key.permissionsRaw;
         if (typeof permissionsRaw !== 'bigint' ||
             permissionsRaw < 0n ||
             permissionsRaw > 0xffffffffffffffffn)
-            invalid('key.permissionsRaw', permissionsRaw, 'Supply an explicit bigint permission mask from 0n through 18446744073709551615n.');
+            invalid(`${path}.permissionsRaw`, permissionsRaw, 'Supply an explicit bigint permission mask from 0n through 18446744073709551615n.');
         const expiresAt = key.expiresAt;
         if (expiresAt !== undefined &&
             (typeof expiresAt !== 'bigint' ||
                 expiresAt < 0n ||
                 expiresAt > 0x7fffffffffffffffn))
-            invalid('key.expiresAt', expiresAt, 'Omit expiry for a permanent key, or supply nonnegative bigint Unix seconds within the signed 64-bit range.');
+            invalid(`${path}.expiresAt`, expiresAt, 'Omit expiry for a permanent key, or supply nonnegative bigint Unix seconds within the signed 64-bit range.');
         const captured = {
             address,
             scope,
@@ -57,17 +58,19 @@ function options(input) {
             ...(expiresAt === undefined ? {} : { expiresAt }),
         };
         if (isProfileCreationAuthority(captured)) {
-            validAddress(address, 'AUTH key.address', true);
+            validAddress(address, `${path}.address`, true);
             if (expiresAt !== undefined)
-                invalid('AUTH key.expiresAt', expiresAt, 'Omit expiry for every Player Profile AUTH key.');
+                invalid(`${path}.expiresAt`, expiresAt, 'Omit expiry for every Player Profile AUTH key.');
         }
         const identity = `${address}:${scope}`;
         if (seen.has(identity))
-            invalid('options.keys', address, 'Remove duplicate address/scope pairs; distinct scopes may reuse one key address.');
+            invalid(path, address, 'Remove duplicate address/scope pairs; distinct scopes may reuse one key address.');
         seen.add(identity);
         keys.push(captured);
     }
     const authCount = keys.filter(isProfileCreationAuthority).length;
+    if (authCount === 0)
+        invalid('options.keys', raw.keys, 'Specify at least one non-expiring Player Profile AUTH key.');
     const keyThreshold = raw.keyThreshold;
     if (typeof keyThreshold !== 'number' ||
         !Number.isInteger(keyThreshold) ||
@@ -80,6 +83,8 @@ function options(input) {
 /** Plans a new signer-created Profile with explicit scoped permissions.
  * The new Profile, storage funder, and every Player Profile AUTH key sign creation,
  * even when the editing threshold is lower. Other keys remain readonly.
+ * The new Profile signer is needed only for creation unless explicitly listed
+ * among the initial authority keys; creating the account does not grant it AUTH.
  * The threshold governs protected Profile updates; it is not a gameplay-wide multisig policy.
  * Existing target accounts and a Profile address equal to its funder are rejected.
  * No Game load, onboarding, funding top-up, key generation or signing is implicit.

package/dist/identity/actions/create-profile.js.map

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

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

@@ -17,9 +17,9 @@ export interface PlanRegisterCharacterOptions {
  * enrollment are not prerequisites for this instruction. Planning never creates
  * an account, signs, submits, or retains a signer. Existing Characters are rejected;
  * reuse them through `getCharacterForProfile` or `maybeGetCharacterForProfile`.
- * New Plans tolerate unrelated Game definition changes while requiring a valid
- * C4 Game, unchanged Profile state, and an absent canonical Character.
- * Rent, funder balance, and final creation remain chain-authoritative. Simulate
+ * New Plans bind the current Game-2 Character and Career XP creation intent.
+ * The canonical accounts, absence, storage pricing, and funder balance are
+ * revalidated before signing. Final creation remains chain-authoritative. Simulate
  * before signing and read the Character after confirmed execution to verify its
  * exact Profile/Game identity. Submission alone does not prove creation.
  * @example

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/identity/actions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAUzE,OAAO,EAEL,KAAK,IAAI,EAEV,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AA2CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,OAAO,EACvB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,IAAI,CAAC,CA4Ef;AAED,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/identity/actions/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAY7D,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AA+BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,OAAO,EACvB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,IAAI,CAAC,CAsHf;AAED,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC"}

package/dist/identity/actions/index.js

@@ -1,12 +1,15 @@
-import { hashAccountState } from '../../internal/planning/account-state.js';
+import { readCharacterInitialization } from '../../registry/onboarding.js';
+import { calculateRegistrationFunding, isEmptySystemAccount, } from '../../internal/planning/character-registration.js';
 import { isAddress, isOffCurveAddress } from '@solana/kit';
+import { hashAccountState } from '../../internal/planning/account-state.js';
 import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
 import { readContextRawAccounts } from '../../client/reconciliation.js';
 import { createRegisterCharacterInstruction } from '../../internal/c4/character-registration.js';
 import { characterAccountDefinition, profileAccountDefinition, findCharacterPda, } from '../../internal/c4/identity.js';
 import { requireGameAddress } from '../../internal/game-context.js';
-import { createPlan, } from '../../planning/index.js';
-import { readFreshGameForCharacterRegistration } from '../../registry/onboarding.js';
+import { RENT_ADDRESS, readRent } from '../../internal/planning/rent.js';
+import { resolveCharacterRegistrationXpRuntime } from '../../internal/planning/xp-runtime.js';
+import { createPlan } from '../../planning/index.js';
 function validateOptions(input) {
     if (input === null || typeof input !== 'object' || Array.isArray(input))
         throw new InvalidActionInputError('options', input, 'an object containing only funder', 'Pass { funder } with the address that will pay for Character account storage.');
@@ -22,22 +25,14 @@ function validateOptions(input) {
 function fail(message, address) {
     throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
 }
-async function observe(account, describes) {
-    return {
-        kind: 'account-state',
-        address: account.address,
-        dataHash: await hashAccountState(account.owner, account.data),
-        describes,
-    };
-}
 /** Plans creation of an existing Profile's canonical Character in the configured Game.
  * Only the explicit storage funder signs. The Profile's authority and faction
  * enrollment are not prerequisites for this instruction. Planning never creates
  * an account, signs, submits, or retains a signer. Existing Characters are rejected;
  * reuse them through `getCharacterForProfile` or `maybeGetCharacterForProfile`.
- * New Plans tolerate unrelated Game definition changes while requiring a valid
- * C4 Game, unchanged Profile state, and an absent canonical Character.
- * Rent, funder balance, and final creation remain chain-authoritative. Simulate
+ * New Plans bind the current Game-2 Character and Career XP creation intent.
+ * The canonical accounts, absence, storage pricing, and funder balance are
+ * revalidated before signing. Final creation remains chain-authoritative. Simulate
  * before signing and read the Character after confirmed execution to verify its
  * exact Profile/Game identity. Submission alone does not prove creation.
  * @example
@@ -57,16 +52,19 @@ export async function planRegisterCharacter(ctx, profileAddress, input) {
         throw new InvalidActionInputError('profileAddress', profileAddress, 'an existing Profile account address', 'Pass the Profile address, not a wallet address or loaded signer.');
     const game = requireGameAddress(ctx);
     const character = await findCharacterPda(profileAddress, game);
-    const [gameAccount, [profileAccount, characterAccount]] = await Promise.all([
-        readFreshGameForCharacterRegistration(ctx),
-        readContextRawAccounts(ctx, [profileAddress, character]),
+    const raw = await readContextRawAccounts(ctx, [
+        profileAddress,
+        character,
+        RENT_ADDRESS,
+        funder,
     ]);
+    const [profileAccount, characterAccount, rentAccount, funderAccount] = raw;
     if (!profileAccount)
         fail(`Profile ${profileAddress} does not exist. Create or select an existing Profile before registering its Character.`, profileAddress);
     if (profileAccount.executable)
         fail(`Profile ${profileAddress} is executable instead of Profile state. Select a valid Player Profile account and retry.`, profileAddress);
     profileAccountDefinition.decode(profileAccount);
-    if (characterAccount) {
+    if (characterAccount && !isEmptySystemAccount(characterAccount)) {
         if (characterAccount.executable)
             fail(`Canonical Character ${character} is executable instead of Character state. Verify the configured Game and account data before retrying.`, character);
         const existing = characterAccountDefinition.decode(characterAccount);
@@ -74,21 +72,42 @@ export async function planRegisterCharacter(ctx, profileAddress, input) {
             fail(`Canonical Character ${character} contains a different Profile or Game relationship. Verify the deployment and refresh the account; do not treat it as a missing Character.`, character);
         fail(`Character ${character} is already registered for Profile ${profileAddress} in Game ${game}. Read and reuse it with getCharacterForProfile or maybeGetCharacterForProfile; registration is not idempotent.`, character);
     }
-    const summary = `Register canonical Character ${character} for existing Profile ${profileAddress} in Game ${game}. Funder ${funder} is the sole instruction signer and pays Character account storage; transaction fees are separate. No Profile-authority or faction signature is required. Storage rent, funder balance and final creation remain chain-authoritative: simulate before signing, then use getCharacterForProfile after confirmed execution to verify the Profile/Game identity.`;
+    const initialization = await readCharacterInitialization(ctx);
+    const xp = await resolveCharacterRegistrationXpRuntime(ctx, {
+        game,
+        character,
+    });
+    if (!rentAccount)
+        fail(`Rent sysvar ${RENT_ADDRESS} is missing. Refresh the configured deployment before calculating Character storage funding.`, RENT_ADDRESS);
+    if (!funderAccount ||
+        funderAccount.executable ||
+        funderAccount.owner !== '11111111111111111111111111111111' ||
+        funderAccount.data.length !== 0)
+        fail(`Character storage funder ${funder} must be an existing non-executable System wallet. Select and fund that signer separately, then prepare registration again.`, funder);
+    const minimum = readRent(rentAccount);
+    const storage = calculateRegistrationFunding(minimum, initialization.characterSize, characterAccount?.lamports ?? 0n, xp.budgetLamports);
+    const funding = storage.requiredLamports;
+    if (funderAccount.lamports < funding)
+        fail(`Character storage funder ${funder} needs ${funding - funderAccount.lamports} more native lamports. Fund it separately and recreate registration.`, funder);
+    const summary = `Register canonical Character ${character} and Career XP budget ${xp.xpBudget} for existing Profile ${profileAddress} in Game ${game}. Funder ${funder} is the sole instruction signer and provides the observed ${funding} lamports of account storage funding; transaction fees are separate. Character v0 allocates ${initialization.characterSize} bytes, Career XP budget v1 allocates 280 bytes with reconciliation marker 1. Net storage debit is ${storage.netDebit} lamports, including a ${storage.refund} lamport Character refund after budget funding; excess budget funding is retained. Valid empty System pre-funded targets are supported. XP budget configuration ${xp.xpBudgetConfig} remains Game-owned and is not created. No Profile-authority or faction signature is required. Funding is revalidated before signing; fees, intervening changes and final creation remain chain-authoritative. Simulate before signing, then use getCharacterForProfile after confirmed execution to verify the Profile/Game identity.`;
     return createPlan({
         kind: 'identity.register-character',
         summary,
         preconditions: [
-            await observe(profileAccount, `Profile ${profileAddress} retains its validated Player Profile state.`),
-            {
-                kind: 'game-account',
-                address: gameAccount.address,
-                describes: `Game ${game} remains a valid non-executable C4 Game; unrelated definition changes do not invalidate Character registration.`,
-            },
             {
-                kind: 'account-absent',
+                kind: 'character-registration',
                 address: character,
-                describes: `Canonical Character ${character} remains absent; if another transaction registers it, read and reuse it instead.`,
+                game,
+                profile: profileAddress,
+                profileDataHash: await hashAccountState(profileAccount.owner, profileAccount.data),
+                funder,
+                xpBudget: xp.xpBudget,
+                xpBudgetConfig: xp.xpBudgetConfig,
+                maximumFunderDebit: funding,
+                ...initialization,
+                characterLamports: characterAccount?.lamports ?? 0n,
+                budgetLamports: xp.budgetLamports,
+                describes: `Create canonical Character ${character} and Career XP budget ${xp.xpBudget} with at most ${funding} lamports of storage funding from System wallet ${funder}; require current Game 2, valid Profile and XP configuration, and both targets to remain absent or valid empty System accounts. Initial allocation, refunds and final funder rent status are rechecked before signing.`,
             },
         ],
         steps: [
@@ -100,6 +119,8 @@ export async function planRegisterCharacter(ctx, profileAddress, input) {
                     funder,
                     character,
                     game,
+                    xpBudget: xp.xpBudget,
+                    xpBudgetConfig: xp.xpBudgetConfig,
                 }),
             },
         ],

package/dist/identity/actions/index.js.map

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