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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-profile.d.ts","sourceRoot":"","sources":["../../../src/identity/actions/create-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAO7D,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAkID;;;;;;;;;;;;;;;;;;GAkBG;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

@@ -0,0 +1,134 @@
+import { isAddress, isOffCurveAddress } from '@solana/kit';
+import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { createProfileInstruction, isProfileCreationAuthority, } from '../../internal/c4/profile-creation.js';
+import { createPlan } from '../../planning/index.js';
+function invalid(field, value, remedy) {
+    throw new InvalidActionInputError(field, value, 'explicit valid Profile creation input', remedy);
+}
+function record(value, field, allowed) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        invalid(field, value, 'Pass an address-only options object for Profile creation.');
+    const result = value;
+    if (Object.keys(result).some((key) => !allowed.includes(key)))
+        invalid(field, value, 'Remove unrecognized fields and signer objects; specify only the documented Profile creation fields.');
+    return result;
+}
+function validAddress(value, field, signer) {
+    if (typeof value !== 'string' ||
+        !isAddress(value) ||
+        (signer && isOffCurveAddress(value)))
+        invalid(field, value, signer
+            ? 'Supply the address of a directly signing external z.ink/Solana account.'
+            : 'Supply a valid z.ink/Solana account address.');
+    return value;
+}
+function options(input) {
+    const raw = record(input, 'options', ['funder', 'keys', 'keyThreshold']);
+    const funder = validAddress(raw.funder, 'options.funder', true);
+    if (!Array.isArray(raw.keys) || raw.keys.length === 0)
+        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[]', [
+            'address',
+            'scope',
+            'permissionsRaw',
+            'expiresAt',
+        ]);
+        const address = validAddress(key.address, 'key.address', false);
+        const scope = validAddress(key.scope, 'key.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.');
+        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.');
+        const captured = {
+            address,
+            scope,
+            permissionsRaw,
+            ...(expiresAt === undefined ? {} : { expiresAt }),
+        };
+        if (isProfileCreationAuthority(captured)) {
+            validAddress(address, 'AUTH key.address', true);
+            if (expiresAt !== undefined)
+                invalid('AUTH key.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.');
+        seen.add(identity);
+        keys.push(captured);
+    }
+    const authCount = keys.filter(isProfileCreationAuthority).length;
+    const keyThreshold = raw.keyThreshold;
+    if (typeof keyThreshold !== 'number' ||
+        !Number.isInteger(keyThreshold) ||
+        keyThreshold < 1 ||
+        keyThreshold > 255 ||
+        keyThreshold > authCount)
+        invalid('options.keyThreshold', keyThreshold, 'Set an explicit integer threshold from 1 through the number of distinct Player Profile AUTH keys, no greater than 255.');
+    return { funder, keys, keyThreshold };
+}
+/** 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 threshold governs protected Profile updates; it is not a gameplay-wide multisig policy.
+ * Existing target accounts and a Profile address equal to its funder are rejected.
+ * No Game load, onboarding, funding top-up, key generation or signing is implicit.
+ * Storage rent, balances and final creation remain chain-authoritative. Simulate
+ * before requesting signatures; after confirmed execution, read `getProfile` and
+ * verify the exact keys, scopes, permission masks and threshold.
+ * @example
+ * ```ts
+ * import {planCreateProfile} from '@aephia/atlas-kit/identity/actions';
+ * declare const ctx: SageContext;
+ * declare const profileAddress: Address;
+ * declare const options: PlanCreateProfileOptions;
+ * const plan = await planCreateProfile(ctx, profileAddress, options);
+ * console.log(plan.summary, plan.requiredSigners);
+ * ```
+ */
+export async function planCreateProfile(ctx, profileAddress, input) {
+    const profile = validAddress(profileAddress, 'profileAddress', true);
+    // Capture every nested scalar before the first await; caller edits cannot change authority.
+    const captured = options(input);
+    if (profile === captured.funder)
+        invalid('profileAddress', profile, 'Use a fresh Profile signer address distinct from the storage funder; do not convert the funding wallet into a Profile.');
+    const [existing] = await readContextRawAccounts(ctx, [profile]);
+    if (existing)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Profile target ${profile} already exists. Read an existing Profile with getProfile, or select a fresh signer address; creation is not idempotent.`, { address: profile });
+    const summary = `Create Profile ${profile} with ${captured.keys.length} explicitly scoped keys and protected Profile update threshold ${captured.keyThreshold}. ${captured.keys.map((key, index) => `Key ${index}: address ${key.address}, scope ${key.scope}, permissionsRaw ${key.permissionsRaw} (0x${key.permissionsRaw.toString(16)}), expiresAt ${key.expiresAt === undefined ? 'never' : key.expiresAt}, role ${isProfileCreationAuthority(key) ? 'Profile AUTH signer' : 'readonly key'}.`).join(' ')} Review these exact scoped permission masks; the threshold does not establish gameplay-wide multisig. Funder ${captured.funder} pays storage rent; transaction fees are separate. The Profile, funder and every Profile AUTH key sign creation. Rent, balances and final creation remain chain-authoritative: simulate before signing, then use getProfile after confirmed execution to verify keys, scopes, permissionsRaw and keyThreshold. No other onboarding or balance top-up is included.`;
+    return createPlan({
+        kind: 'identity.create-profile',
+        summary,
+        preconditions: [
+            {
+                kind: 'account-absent',
+                address: profile,
+                describes: `New Profile ${profile} remains absent; if another transaction creates it, read and inspect it before proceeding.`,
+            },
+        ],
+        steps: [
+            {
+                describes: summary,
+                signers: [
+                    captured.funder,
+                    profile,
+                    ...captured.keys
+                        .filter(isProfileCreationAuthority)
+                        .map((key) => key.address),
+                ],
+                instruction: createProfileInstruction({ profile, ...captured }),
+            },
+        ],
+    });
+}
+//# sourceMappingURL=create-profile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-profile.js","sourceRoot":"","sources":["../../../src/identity/actions/create-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAgB,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EACL,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAa,MAAM,yBAAyB,CAAC;AAkChE,SAAS,OAAO,CAAC,KAAa,EAAE,KAAc,EAAE,MAAc;IAC5D,MAAM,IAAI,uBAAuB,CAC/B,KAAK,EACL,KAAK,EACL,uCAAuC,EACvC,MAAM,CACP,CAAC;AACJ,CAAC;AACD,SAAS,MAAM,CACb,KAAc,EACd,KAAa,EACb,OAA0B;IAE1B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrE,OAAO,CACL,KAAK,EACL,KAAK,EACL,2DAA2D,CAC5D,CAAC;IACJ,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC3D,OAAO,CACL,KAAK,EACL,KAAK,EACL,qGAAqG,CACtG,CAAC;IACJ,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,SAAS,YAAY,CAAC,KAAc,EAAE,KAAa,EAAE,MAAe;IAClE,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,SAAS,CAAC,KAAK,CAAC;QACjB,CAAC,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAEpC,OAAO,CACL,KAAK,EACL,KAAK,EACL,MAAM;YACJ,CAAC,CAAC,yEAAyE;YAC3E,CAAC,CAAC,8CAA8C,CACnD,CAAC;IACJ,OAAO,KAAK,CAAC;AACf,CAAC;AACD,SAAS,OAAO,CAAC,KAAc;IAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QACnD,OAAO,CACL,cAAc,EACd,GAAG,CAAC,IAAI,EACR,4DAA4D,CAC7D,CAAC;IACJ,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAA8B,EAAE,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAAE;YAC1C,SAAS;YACT,OAAO;YACP,gBAAgB;YAChB,WAAW;SACZ,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,GAAG,CAAC,cAAc,CAAC;QAC1C,IACE,OAAO,cAAc,KAAK,QAAQ;YAClC,cAAc,GAAG,EAAE;YACnB,cAAc,GAAG,mBAAmB;YAEpC,OAAO,CACL,oBAAoB,EACpB,cAAc,EACd,kFAAkF,CACnF,CAAC;QACJ,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;QAChC,IACE,SAAS,KAAK,SAAS;YACvB,CAAC,OAAO,SAAS,KAAK,QAAQ;gBAC5B,SAAS,GAAG,EAAE;gBACd,SAAS,GAAG,mBAAmB,CAAC;YAElC,OAAO,CACL,eAAe,EACf,SAAS,EACT,4GAA4G,CAC7G,CAAC;QACJ,MAAM,QAAQ,GAAG;YACf,OAAO;YACP,KAAK;YACL,cAAc;YACd,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;SAClD,CAAC;QACF,IAAI,0BAA0B,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,YAAY,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;YAChD,IAAI,SAAS,KAAK,SAAS;gBACzB,OAAO,CACL,oBAAoB,EACpB,SAAS,EACT,gDAAgD,CACjD,CAAC;QACN,CAAC;QACD,MAAM,QAAQ,GAAG,GAAG,OAAO,IAAI,KAAK,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YACpB,OAAO,CACL,cAAc,EACd,OAAO,EACP,kFAAkF,CACnF,CAAC;QACJ,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,MAAM,CAAC;IACjE,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IACtC,IACE,OAAO,YAAY,KAAK,QAAQ;QAChC,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;QAC/B,YAAY,GAAG,CAAC;QAChB,YAAY,GAAG,GAAG;QAClB,YAAY,GAAG,SAAS;QAExB,OAAO,CACL,sBAAsB,EACtB,YAAY,EACZ,wHAAwH,CACzH,CAAC;IACJ,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAgB,EAChB,cAAuB,EACvB,KAA+B;IAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;IACrE,4FAA4F;IAC5F,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,OAAO,KAAK,QAAQ,CAAC,MAAM;QAC7B,OAAO,CACL,gBAAgB,EAChB,OAAO,EACP,wHAAwH,CACzH,CAAC;IACJ,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,QAAQ;QACV,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,kBAAkB,OAAO,0HAA0H,EACnJ,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;IACJ,MAAM,OAAO,GAAG,kBAAkB,OAAO,SAAS,QAAQ,CAAC,IAAI,CAAC,MAAM,kEAAkE,QAAQ,CAAC,YAAY,KAAK,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,aAAa,GAAG,CAAC,OAAO,WAAW,GAAG,CAAC,KAAK,oBAAoB,GAAG,CAAC,cAAc,OAAO,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,gBAAgB,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,UAAU,0BAA0B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,gHAAgH,QAAQ,CAAC,MAAM,mWAAmW,CAAC;IACh9B,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,yBAAyB;QAC/B,OAAO;QACP,aAAa,EAAE;YACb;gBACE,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,OAAO;gBAChB,SAAS,EAAE,eAAe,OAAO,4FAA4F;aAC9H;SACF;QACD,KAAK,EAAE;YACL;gBACE,SAAS,EAAE,OAAO;gBAClB,OAAO,EAAE;oBACP,QAAQ,CAAC,MAAM;oBACf,OAAO;oBACP,GAAG,QAAQ,CAAC,IAAI;yBACb,MAAM,CAAC,0BAA0B,CAAC;yBAClC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;iBAC7B;gBACD,WAAW,EAAE,wBAAwB,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;aAChE;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -34,4 +34,5 @@ export interface PlanRegisterCharacterOptions {
  * ```
  */
 export declare function planRegisterCharacter(ctx: SageContext, profileAddress: Address, input: PlanRegisterCharacterOptions): Promise<Plan>;
+export { planCreateProfile, type PlanCreateProfileOptions, type ProfileCreationKeyInput, } from './create-profile.js';
 //# sourceMappingURL=index.d.ts.map

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"}
+{"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"}

package/dist/identity/actions/index.js

@@ -105,4 +105,5 @@ export async function planRegisterCharacter(ctx, profileAddress, input) {
         ],
     });
 }
+export { planCreateProfile, } from './create-profile.js';
 //# sourceMappingURL=index.js.map

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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"}

package/dist/internal/c4/profile-creation.d.ts

@@ -0,0 +1,17 @@
+import { type Address, type Instruction } from '@solana/kit';
+export interface ProfileCreationKey {
+    readonly address: Address;
+    readonly scope: Address;
+    readonly permissionsRaw: bigint;
+    readonly expiresAt?: bigint;
+}
+/** AUTH belongs to the Player Profile scope, not to gameplay permission bit zero. */
+export declare function isProfileCreationAuthority(key: ProfileCreationKey): boolean;
+/** Encode audited remaining-account roles without constructing signer objects. */
+export declare function createProfileInstruction(input: {
+    readonly profile: Address;
+    readonly funder: Address;
+    readonly keys: readonly ProfileCreationKey[];
+    readonly keyThreshold: number;
+}): Instruction;
+//# sourceMappingURL=profile-creation.d.ts.map

package/dist/internal/c4/profile-creation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-creation.d.ts","sourceRoot":"","sources":["../../../src/internal/c4/profile-creation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAM1E,MAAM,WAAW,kBAAkB;IACjC,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,qFAAqF;AACrF,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAK3E;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,GAAG,WAAW,CA4Bd"}

package/dist/internal/c4/profile-creation.js

@@ -0,0 +1,36 @@
+import { AccountRole } from '@solana/kit';
+import { PLAYER_PROFILE_PROGRAM_ADDRESS, getCreateProfileInstructionDataEncoder, } from '@staratlas/dev-player-profile';
+/** AUTH belongs to the Player Profile scope, not to gameplay permission bit zero. */
+export function isProfileCreationAuthority(key) {
+    return (key.scope === PLAYER_PROFILE_PROGRAM_ADDRESS &&
+        (key.permissionsRaw & 1n) !== 0n);
+}
+/** Encode audited remaining-account roles without constructing signer objects. */
+export function createProfileInstruction(input) {
+    return {
+        programAddress: PLAYER_PROFILE_PROGRAM_ADDRESS,
+        accounts: [
+            { address: input.funder, role: AccountRole.WRITABLE_SIGNER },
+            { address: input.profile, role: AccountRole.WRITABLE_SIGNER },
+            {
+                address: '11111111111111111111111111111111',
+                role: AccountRole.READONLY,
+            },
+            ...input.keys.map((key) => ({
+                address: key.address,
+                role: isProfileCreationAuthority(key)
+                    ? AccountRole.READONLY_SIGNER
+                    : AccountRole.READONLY,
+            })),
+        ],
+        data: getCreateProfileInstructionDataEncoder().encode({
+            keyThreshold: input.keyThreshold,
+            keyPermissions: input.keys.map((key) => ({
+                scope: key.scope,
+                expireTime: key.expiresAt ?? -1n,
+                permissions: Array.from({ length: 8 }, (_, index) => Number((key.permissionsRaw >> BigInt(index * 8)) & 255n)),
+            })),
+        }),
+    };
+}
+//# sourceMappingURL=profile-creation.js.map

package/dist/internal/c4/profile-creation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-creation.js","sourceRoot":"","sources":["../../../src/internal/c4/profile-creation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkC,MAAM,aAAa,CAAC;AAC1E,OAAO,EACL,8BAA8B,EAC9B,sCAAsC,GACvC,MAAM,+BAA+B,CAAC;AASvC,qFAAqF;AACrF,MAAM,UAAU,0BAA0B,CAAC,GAAuB;IAChE,OAAO,CACL,GAAG,CAAC,KAAK,KAAK,8BAA8B;QAC5C,CAAC,GAAG,CAAC,cAAc,GAAG,EAAE,CAAC,KAAK,EAAE,CACjC,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,wBAAwB,CAAC,KAKxC;IACC,OAAO;QACL,cAAc,EAAE,8BAA8B;QAC9C,QAAQ,EAAE;YACR,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,eAAe,EAAE;YAC5D,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,eAAe,EAAE;YAC7D;gBACE,OAAO,EAAE,kCAA6C;gBACtD,IAAI,EAAE,WAAW,CAAC,QAAQ;aAC3B;YACD,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC1B,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,IAAI,EAAE,0BAA0B,CAAC,GAAG,CAAC;oBACnC,CAAC,CAAC,WAAW,CAAC,eAAe;oBAC7B,CAAC,CAAC,WAAW,CAAC,QAAQ;aACzB,CAAC,CAAC;SACJ;QACD,IAAI,EAAE,sCAAsC,EAAE,CAAC,MAAM,CAAC;YACpD,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACvC,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,UAAU,EAAE,GAAG,CAAC,SAAS,IAAI,CAAC,EAAE;gBAChC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAClD,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CACzD;aACF,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;AACJ,CAAC"}

package/package.json

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