@polyester/sdk 0.26.0 → 0.27.0

package/dist/services/auth/account-signer-auth.d.ts

@@ -1,9 +1,10 @@
-import { AccountSigner, AccountSignerConfig } from "../../account-signer/types.js";
+import { AccountSigner, AccountSignerConfig, HexAddress } from "../../account-signer/types.js";
 import { PolyesterEnvironment } from "../../environment.js";
 import { AuthAndPublicApiTransports } from "../../shared/transports.js";
 import { PolyesterRealtime } from "../../realtime/types.js";
 import "../../realtime/index.js";
 import { AuthService } from "./auth.js";
+import { SubaccountChallenge } from "../subaccounts/subaccounts.schemas.js";
 import { SubaccountsService } from "../subaccounts/subaccounts.js";
 import "../subaccounts/index.js";
 import { AuthTokenStorage } from "./token-storage.js";
@@ -39,12 +40,18 @@ interface LoginOptions {
   loginMethod?: AuthLoginMethod | null;
 }
 interface CreateSubaccountParams {
-  /** The account signer for the new subaccount (caller derives this, e.g. via Turnkey saltNonce) */
-  accountSigner: AccountSigner;
+  /**
+   * Signer for the new subaccount, or a factory that derives it from the server challenge
+   * (for example via Turnkey with `challenge.smartAccountSaltNonce`). Its accountAddress must
+   * equal `challenge.smartAccountAddress`.
+   */
+  accountSigner: AccountSigner | ((challenge: SubaccountChallenge) => AccountSigner | Promise<AccountSigner>);
   /** Optional human-readable label for this subaccount */
   label?: string;
   /** Browser origin requesting the signature; defaults to location.origin in browsers. Required outside browsers. */
   uri?: string;
+  /** Root owner EOA bound to the authenticated account; defaults to the configured signer's owner. */
+  ownerAddress?: HexAddress;
 }
 interface CreateSubaccountResult {
   subaccountId: string;

package/dist/services/auth/account-signer-auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"account-signer-auth.d.ts","names":[],"sources":["../../../src/services/auth/account-signer-auth.ts"],"mappings":";;;;;;;;;;;;;UAyBiB;EACb;IAAiB;IAAmB;;EACpC;EACA;IAAS;IAAc;;EACvB;EACA,aAAa;;UAGA;EACb;EACA;EACA,WAAW;;UAGE;;;;EAIb;;EAEA;EACA,cAAc;;UAGD;;EAEb,eAAe;;EAEf;;EAEA;;UAGa;EACb;EACA;EACA;;;;;cAWS,iCAAiC;;WACjC,QAAM,aAAA;EAoBH,cACR,YACA,qBACA,aACA,aACA,UACA,cACA;IAEA,YAAY;IACZ,sBAAsB;IACtB,aAAa;IACb,aAAa;IACb,UAAU;IACV,cAAc;IACd,eAAe;;;;;EAmBnB,sBAAsB,aAAa;;;;EAOnC,iBAAiB,eAAe;;;;EAWhC,oBAAoB;;;;EAOd,MAAM,SAAS,eAAe,QAAQ;;;;EA0F5C,iBAAiB,OAAO;;;;EAyBlB,kBAAkB;IAAU;IAAmB;;;;;EA0E/C,UAAU;;;;EAqChB;;;;EASM,eAAe;;IAEjB;IACA;IACA,cAAc;MACd,QAAQ;;;;EAmBZ,cACI,mBACA;IAAY;IAA8B;;IACzC;IAAmB;;;EAuBxB,oBAAoB;;;;EASd,iBAAiB,QAAQ,yBAAyB,QAAQ;;;;EAuChE,YAAY"}
+{"version":3,"file":"account-signer-auth.d.ts","names":[],"sources":["../../../src/services/auth/account-signer-auth.ts"],"mappings":";;;;;;;;;;;;;;UAyBiB;EACb;IAAiB;IAAmB;;EACpC;EACA;IAAS;IAAc;;EACvB;EACA,aAAa;;UAGA;EACb;EACA;EACA,WAAW;;UAGE;;;;EAIb;;EAEA;EACA,cAAc;;UAGD;;;;;;EAMb,eACM,kBACE,WAAW,wBAAwB,gBAAgB,QAAQ;;EAEnE;;EAEA;;EAEA,eAAe;;UAGF;EACb;EACA;EACA;;;;;cAWS,iCAAiC;;WACjC,QAAM,aAAA;EAoBH,cACR,YACA,qBACA,aACA,aACA,UACA,cACA;IAEA,YAAY;IACZ,sBAAsB;IACtB,aAAa;IACb,aAAa;IACb,UAAU;IACV,cAAc;IACd,eAAe;;;;;EAmBnB,sBAAsB,aAAa;;;;EAOnC,iBAAiB,eAAe;;;;EAWhC,oBAAoB;;;;EAOd,MAAM,SAAS,eAAe,QAAQ;;;;EAyF5C,iBAAiB,OAAO;;;;EAyBlB,kBAAkB;IAAU;IAAmB;;;;;EA0E/C,UAAU;;;;EAqChB;;;;EASM,eAAe;;IAEjB;IACA;IACA,cAAc;MACd,QAAQ;;;;EAmBZ,cACI,mBACA;IAAY;IAA8B;;IACzC;IAAmB;;;EAuBxB,oBAAoB;;;;EASd,iBAAiB,QAAQ,yBAAyB,QAAQ;;;;EAyDhE,YAAY"}

package/dist/services/auth/account-signer-auth.js

@@ -76,8 +76,7 @@ var AccountSignerAuthService = class extends AuthService {
 		const { message } = await this.createWalletChallenge({
 			smartAccountAddress,
 			signerAddress: ownerAddress,
-			uri,
-			purpose: "login"
+			uri
 		});
 		const signature = await accountSigner.signMessage(message);
 		const response = await this.loginWithWallet({
@@ -281,19 +280,22 @@ var AccountSignerAuthService = class extends AuthService {
 	async createSubaccount(params) {
 		if (!this.#isAuthenticated) throw new AuthenticationError("Must be authenticated to create subaccounts");
 		if (!this.#subaccounts) throw new ConfigurationError("SubaccountsService not configured. Pass it to constructor or call setSubaccountsService().");
-		const { accountSigner, label = "" } = params;
-		this.#assertAccountSignerEnvironment(accountSigner);
-		const { message } = await this.createWalletChallenge({
-			smartAccountAddress: accountSigner.accountAddress,
-			signerAddress: accountSigner.accountAddress,
-			uri: resolveChallengeUri(params.uri ?? this.#challengeUri),
-			purpose: "create_subaccount"
+		const identity = this.#accountSigner ?? this.#accountIdentity;
+		const ownerAddress = params.ownerAddress ?? identity?.ownerAddress ?? identity?.accountAddress;
+		if (!ownerAddress) throw new ConfigurationError("No root owner address available. Pass ownerAddress or configure an account signer.");
+		const { label = "" } = params;
+		const challenge = await this.#subaccounts.createChallenge({
+			ownerAddress,
+			uri: resolveChallengeUri(params.uri ?? this.#challengeUri)
 		});
-		const signature = await accountSigner.signMessage(message);
+		const accountSigner = typeof params.accountSigner === "function" ? await params.accountSigner(challenge) : params.accountSigner;
+		this.#assertAccountSignerEnvironment(accountSigner);
+		if (accountSigner.accountAddress.toLowerCase() !== challenge.smartAccountAddress.toLowerCase()) throw new ConfigurationError(`Subaccount signer address ${accountSigner.accountAddress} does not match the server-derived smart account ${challenge.smartAccountAddress}.`);
+		const signature = await accountSigner.signMessage(challenge.message);
 		const response = await this.#subaccounts.create({
 			label,
-			smartAccountAddress: accountSigner.accountAddress,
-			message,
+			smartAccountAddress: challenge.smartAccountAddress,
+			message: challenge.message,
 			signature
 		});
 		return {

package/dist/services/auth/account-signer-auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"account-signer-auth.js","names":["#accountSignerConfig","#environmentFingerprint","#subaccounts","#tokenStorage","#realtime","#sessionStore","#assertAccountSignerEnvironment","#beginAuthOperation","#accountSigner","#accountIdentity","#identityFromSigner","#notifyStateChange","#login","#resolveAccountSigner","#challengeUri","#isCurrentAuthOperation","#getEnvironmentSession","#loginMethod","#isAuthenticated","#mainAccountId","#activeAccountId","#walletProvider","#loginResult","#getEnvironmentBoundToken","#clearExpiredSessionState","#getCurrentTokenStorageOptions","#resolveRefreshProvider","#authOperationGeneration"],"sources":["../../../src/services/auth/account-signer-auth.ts"],"sourcesContent":["import { AuthService, type LoginWithWalletResponse } from \"./auth.js\";\nimport { AuthenticationError, ConfigurationError } from \"../../shared/errors.js\";\nimport { toPolyesterError } from \"../../shared/connect-error-mapping.js\";\nimport { AuthSessionStore } from \"./session.js\";\nimport type { AccountSigner, AccountSignerConfig, HexAddress } from \"../../account-signer/types.js\";\nimport { assertAccountSigner, resolveAccountSigner } from \"../../account-signer/types.js\";\nimport { EventEmitter } from \"../../utils/event-emitter.js\";\nimport { isJwtValid, getJwtTimeToExpiry } from \"../../utils/jwt.js\";\nimport type { SubaccountsService } from \"../subaccounts/index.js\";\nimport type {\n    AuthState,\n    AuthHydrationData,\n    AuthLoginMethod,\n    SessionData,\n    ActiveAccountInfo,\n} from \"./session.types.js\";\nimport type { PolyesterRealtime } from \"../../realtime/index.js\";\nimport type { PolyesterEnvironment } from \"../../environment.js\";\nimport type { AuthAndPublicApiTransports } from \"../../shared/transports.js\";\nimport {\n    createAuthTokenStorageSetOptions,\n    type AuthTokenStorage,\n    type AuthTokenStorageSetOptions,\n} from \"./token-storage.js\";\n\nexport interface AccountSignerAuthEvents {\n    authenticated: { accountId: string; username: string };\n    loggedOut: void;\n    error: { code: string; message: string };\n    servicesReady: void;\n    stateChange: AuthState;\n}\n\nexport interface LoginResult {\n    accountId: string;\n    username: string;\n    expiresAt: Date;\n}\n\nexport interface LoginOptions {\n    /**\n     * The wallet provider to use for login.\n     */\n    provider: \"metamask\" | \"turnkey\" | \"other\";\n    /** Browser origin requesting the signature; defaults to location.origin in browsers. Required outside browsers. */\n    uri?: string;\n    loginMethod?: AuthLoginMethod | null;\n}\n\nexport interface CreateSubaccountParams {\n    /** The account signer for the new subaccount (caller derives this, e.g. via Turnkey saltNonce) */\n    accountSigner: AccountSigner;\n    /** Optional human-readable label for this subaccount */\n    label?: string;\n    /** Browser origin requesting the signature; defaults to location.origin in browsers. Required outside browsers. */\n    uri?: string;\n}\n\nexport interface CreateSubaccountResult {\n    subaccountId: string;\n    smartAccountSaltNonce: number;\n    revision: string;\n}\n\ninterface AccountIdentity {\n    accountAddress: HexAddress;\n    ownerAddress?: HexAddress;\n}\n\n/**\n * Coordinates wallet/account-signer authentication, session storage, subaccount selection, and session refresh.\n */\nexport class AccountSignerAuthService extends AuthService {\n    readonly events = new EventEmitter<AccountSignerAuthEvents>();\n\n    #accountSignerConfig: AccountSignerConfig | undefined;\n    #accountSigner: AccountSigner | null = null;\n    #accountIdentity: AccountIdentity | null = null;\n    #isAuthenticated = false;\n    #mainAccountId: string | null = null;\n    #activeAccountId: string | null = null;\n    #subaccounts: SubaccountsService;\n    #walletProvider: \"metamask\" | \"turnkey\" | \"other\" | undefined = undefined;\n    #loginMethod: AuthLoginMethod | null = null;\n    #challengeUri: string | undefined = undefined;\n    #environmentFingerprint: string;\n    #tokenStorage: AuthTokenStorage;\n    #sessionStore: AuthSessionStore;\n    #realtime: PolyesterRealtime;\n    // Every asynchronous auth transition captures this generation. A later login,\n    // logout, signer change, or restore makes older work observational only.\n    #authOperationGeneration = 0;\n\n    constructor({\n        transports,\n        accountSignerConfig,\n        environment,\n        subaccounts,\n        realtime,\n        tokenStorage,\n        sessionStore,\n    }: {\n        transports: AuthAndPublicApiTransports;\n        accountSignerConfig?: AccountSignerConfig;\n        environment: PolyesterEnvironment;\n        subaccounts: SubaccountsService;\n        realtime: PolyesterRealtime;\n        tokenStorage: AuthTokenStorage;\n        sessionStore?: AuthSessionStore;\n    }) {\n        super(transports, realtime);\n\n        this.#accountSignerConfig = accountSignerConfig;\n        this.#environmentFingerprint = environment.fingerprint;\n        this.#subaccounts = subaccounts;\n        this.#tokenStorage = tokenStorage;\n        this.#realtime = realtime;\n        this.#sessionStore =\n            sessionStore ??\n            new AuthSessionStore({\n                environmentFingerprint: environment.fingerprint,\n            });\n    }\n\n    /**\n     * Attaches the subaccounts service used when creating a subaccount during authenticated flows.\n     */\n    setSubaccountsService(subaccounts: SubaccountsService): void {\n        this.#subaccounts = subaccounts;\n    }\n\n    /**\n     * Sets the account signer used to sign login and account-switch challenges.\n     */\n    setAccountSigner(accountSigner: AccountSigner | null): void {\n        if (accountSigner) this.#assertAccountSignerEnvironment(accountSigner);\n        this.#beginAuthOperation();\n        this.#accountSigner = accountSigner;\n        this.#accountIdentity = accountSigner ? this.#identityFromSigner(accountSigner) : null;\n        this.#notifyStateChange();\n    }\n\n    /**\n     * Returns the active account signer, throwing if one has not been configured.\n     */\n    getAccountSigner(): AccountSigner | null {\n        return this.#accountSigner;\n    }\n\n    /**\n     * Signs a server-issued SIWE message with the configured account signer, exchanges it for a session token, and stores the hydrated account/subaccount session state.\n     */\n    async login(options: LoginOptions): Promise<LoginResult> {\n        return this.#login(options);\n    }\n\n    async #login(\n        options: LoginOptions,\n        previousActiveAccount?: ActiveAccountInfo,\n    ): Promise<LoginResult> {\n        const generation = this.#beginAuthOperation();\n        const startingToken = this.#tokenStorage.get();\n        const { provider, loginMethod } = options;\n\n        const accountSigner = await this.#resolveAccountSigner();\n\n        if (!accountSigner) {\n            throw new ConfigurationError(\n                \"No account signer configured. Call setAccountSigner() or pass accountSigner in config.\",\n            );\n        }\n\n        const smartAccountAddress = accountSigner.accountAddress;\n        const ownerAddress = accountSigner.ownerAddress ?? accountSigner.accountAddress;\n\n        const uri = resolveChallengeUri(options.uri ?? this.#challengeUri);\n        const { message } = await this.createWalletChallenge({\n            smartAccountAddress,\n            signerAddress: ownerAddress,\n            uri,\n            purpose: \"login\",\n        });\n        const signature = await accountSigner.signMessage(message);\n\n        const response = await this.loginWithWallet({\n            smartAccountAddress,\n            message,\n            signature,\n            walletProvider: provider,\n        });\n\n        if (!this.#isCurrentAuthOperation(generation, startingToken)) {\n            throw new DOMException(\"Authentication operation superseded\", \"AbortError\");\n        }\n        const environmentSession = this.#getEnvironmentSession();\n        const resolvedLoginMethod =\n            loginMethod ??\n            this.#loginMethod ??\n            environmentSession?.loginMethod ??\n            (provider === \"metamask\" ? \"metamask\" : null);\n\n        const tokenOptions = createAuthTokenStorageSetOptions(response.accessToken);\n        const activeAccount =\n            previousActiveAccount?.mainAccountId === response.accountId\n                ? previousActiveAccount\n                : undefined;\n        this.#sessionStore.commitLogin(\n            {\n                accessToken: response.accessToken,\n                tokenOptions,\n                provider,\n                loginMethod: resolvedLoginMethod,\n                primaryWallet: ownerAddress,\n                smartAccount: smartAccountAddress,\n                accountId: response.accountId,\n                activeAccount,\n                username: response.username ?? undefined,\n            },\n            this.#tokenStorage,\n        );\n        this.#isAuthenticated = true;\n        this.#mainAccountId = response.accountId;\n        this.#activeAccountId = activeAccount?.accountId ?? response.accountId;\n        this.#walletProvider = provider;\n        this.#loginMethod = resolvedLoginMethod;\n        this.#challengeUri = uri;\n        this.#accountSigner = accountSigner;\n        this.#accountIdentity = this.#identityFromSigner(accountSigner);\n\n        this.#notifyStateChange();\n\n        this.events.emit(\"authenticated\", {\n            accountId: response.accountId,\n            username: response.username,\n        });\n\n        return this.#loginResult(response);\n    }\n\n    /**\n     * Builds auth state from a session token and optional active account override.\n     */\n    hydrateAuthState(state: AuthHydrationData): void {\n        this.#beginAuthOperation();\n        const existingToken = this.#getEnvironmentBoundToken();\n        if (!existingToken || !isJwtValid(existingToken)) return;\n\n        const existingSession = this.#getEnvironmentSession();\n        this.#walletProvider = existingSession?.provider ?? this.#walletProvider;\n        this.#loginMethod = existingSession?.loginMethod ?? this.#loginMethod;\n\n        this.#isAuthenticated = true;\n        this.#mainAccountId = state.mainAccountId;\n        this.#activeAccountId = state.activeAccountId ?? state.mainAccountId;\n        this.#accountIdentity = state.smartAccountAddress\n            ? {\n                  accountAddress: state.smartAccountAddress,\n                  ownerAddress: state.ownerAddress,\n              }\n            : null;\n\n        this.#notifyStateChange();\n    }\n\n    /**\n     * Loads the stored token, validates that it still belongs to this environment, and restores auth state when possible.\n     */\n    async restoreSession(): Promise<{ accountId: string; username: string } | null> {\n        const generation = this.#beginAuthOperation();\n        const existingToken = this.#getEnvironmentBoundToken();\n\n        if (!existingToken || !isJwtValid(existingToken)) {\n            if (this.#isCurrentAuthOperation(generation)) this.#clearExpiredSessionState();\n            return null;\n        }\n\n        let me: Awaited<ReturnType<AuthService[\"me\"]>>;\n        try {\n            me = await this.me();\n        } catch (error) {\n            if (!this.#isCurrentAuthOperation(generation, existingToken)) return null;\n            const mappedError = toPolyesterError(error);\n            if (mappedError instanceof AuthenticationError) {\n                this.#clearExpiredSessionState();\n                return null;\n            }\n            throw mappedError;\n        }\n        if (!this.#isCurrentAuthOperation(generation, existingToken)) return null;\n\n        let accountSigner = this.#accountSigner;\n        if (!accountSigner) {\n            try {\n                accountSigner = await resolveAccountSigner(this.#accountSignerConfig);\n            } catch (error) {\n                if (!this.#isCurrentAuthOperation(generation, existingToken)) return null;\n                throw error;\n            }\n            if (!this.#isCurrentAuthOperation(generation, existingToken)) return null;\n            if (accountSigner) this.#assertAccountSignerEnvironment(accountSigner);\n        }\n\n        if (!isJwtValid(existingToken) || this.#getEnvironmentBoundToken() !== existingToken) {\n            this.#clearExpiredSessionState();\n            return null;\n        }\n\n        const existingSession = this.#getEnvironmentSession();\n        const walletProvider = existingSession?.provider ?? this.#walletProvider;\n        const loginMethod = existingSession?.loginMethod ?? this.#loginMethod;\n        const activeAccountId =\n            this.#activeAccountId ?? existingSession?.activeAccount?.accountId ?? me.accountId;\n\n        // Publish runtime state only after asynchronous restoration has completed.\n        if (accountSigner) {\n            this.#sessionStore.ensureSession(\n                {\n                    provider: walletProvider ?? \"other\",\n                    loginMethod: loginMethod ?? (walletProvider === \"metamask\" ? \"metamask\" : null),\n                    primaryWallet: accountSigner.ownerAddress ?? accountSigner.accountAddress,\n                    smartAccount: accountSigner.accountAddress,\n                    accountId: me.accountId,\n                    username: me.username ?? undefined,\n                },\n                { maxAgeSeconds: this.#getCurrentTokenStorageOptions().maxAgeSeconds },\n            );\n            this.#accountSigner = accountSigner;\n            this.#accountIdentity = this.#identityFromSigner(accountSigner);\n        }\n        this.#isAuthenticated = true;\n        this.#mainAccountId = me.accountId;\n        this.#activeAccountId = activeAccountId;\n        this.#walletProvider = walletProvider ?? (accountSigner ? \"other\" : undefined);\n        this.#loginMethod = loginMethod;\n        this.#notifyStateChange();\n        return { accountId: me.accountId, username: me.username };\n    }\n\n    /**\n     * Clears stored auth state and removes the persisted auth token.\n     */\n    async logout(): Promise<void> {\n        this.#beginAuthOperation();\n        this.#realtime.disconnectPrivate();\n        this.#tokenStorage.clear();\n        this.#isAuthenticated = false;\n        this.#mainAccountId = null;\n        this.#activeAccountId = null;\n        this.#loginMethod = null;\n        this.#challengeUri = undefined;\n        this.#accountIdentity = null;\n\n        this.#sessionStore.clear();\n\n        this.#notifyStateChange();\n        this.events.emit(\"loggedOut\", undefined);\n    }\n\n    #clearExpiredSessionState(): void {\n        const shouldEmitLoggedOut = this.#isAuthenticated;\n        this.#realtime.disconnectPrivate();\n        this.#tokenStorage.clear();\n        this.#sessionStore.clear();\n        this.#isAuthenticated = false;\n        this.#mainAccountId = null;\n        this.#activeAccountId = null;\n        this.#loginMethod = null;\n        this.#challengeUri = undefined;\n        this.#accountIdentity = null;\n        this.#notifyStateChange();\n        if (shouldEmitLoggedOut) {\n            this.events.emit(\"loggedOut\", undefined);\n        }\n    }\n\n    /**\n     * Returns the remaining lifetime of the stored session token in milliseconds.\n     */\n    getSessionTimeToExpiry(): number {\n        const token = this.#getEnvironmentBoundToken();\n        if (!token || !isJwtValid(token)) return 0;\n        return getJwtTimeToExpiry(token);\n    }\n\n    /**\n     * Refreshes the active account-signer session and updates persisted auth state.\n     */\n    async refreshSession(params?: {\n        /** Overrides the origin remembered from login. */\n        uri?: string;\n        provider?: \"metamask\" | \"turnkey\" | \"other\";\n        loginMethod?: AuthLoginMethod | null;\n    }): Promise<LoginResult> {\n        if (!this.#isAuthenticated) {\n            throw new AuthenticationError(\"Must be authenticated to refresh session\");\n        }\n\n        const currentSession = this.#getEnvironmentSession();\n        return this.#login(\n            {\n                provider: this.#resolveRefreshProvider(params?.provider),\n                uri: params?.uri,\n                loginMethod: params?.loginMethod ?? this.#loginMethod,\n            },\n            currentSession?.activeAccount,\n        );\n    }\n\n    /**\n     * Switches the active account/subaccount by signing the required account switch flow.\n     */\n    switchAccount(\n        accountId: string,\n        options?: { smartAccountAddress?: string; label?: string },\n    ): { accountId: string; isMain: boolean } {\n        if (!this.#isAuthenticated || !this.#mainAccountId) {\n            throw new AuthenticationError(\"Must be authenticated to switch accounts\");\n        }\n\n        this.#activeAccountId = accountId;\n        const isMain = accountId === this.#mainAccountId;\n\n        this.#sessionStore.setActiveAccount(\n            {\n                accountId,\n                isMain,\n                smartAccountAddress: options?.smartAccountAddress,\n                label: options?.label,\n            },\n            { maxAgeSeconds: this.#getCurrentTokenStorageOptions().maxAgeSeconds },\n        );\n        this.#notifyStateChange();\n\n        return { accountId, isMain };\n    }\n\n    /** Keeps the display-session identity current for the next server render. */\n    syncSessionUsername(username: string | null): void {\n        this.#sessionStore.setUsername(username, {\n            maxAgeSeconds: this.#getCurrentTokenStorageOptions().maxAgeSeconds,\n        });\n    }\n\n    /**\n     * Creates a subaccount for the authenticated account and makes it available to the session state.\n     */\n    async createSubaccount(params: CreateSubaccountParams): Promise<CreateSubaccountResult> {\n        if (!this.#isAuthenticated) {\n            throw new AuthenticationError(\"Must be authenticated to create subaccounts\");\n        }\n\n        if (!this.#subaccounts) {\n            throw new ConfigurationError(\n                \"SubaccountsService not configured. Pass it to constructor or call setSubaccountsService().\",\n            );\n        }\n\n        const { accountSigner, label = \"\" } = params;\n        this.#assertAccountSignerEnvironment(accountSigner);\n\n        const { message } = await this.createWalletChallenge({\n            smartAccountAddress: accountSigner.accountAddress,\n            signerAddress: accountSigner.accountAddress,\n            uri: resolveChallengeUri(params.uri ?? this.#challengeUri),\n            purpose: \"create_subaccount\",\n        });\n        const signature = await accountSigner.signMessage(message);\n\n        const response = await this.#subaccounts.create({\n            label,\n            smartAccountAddress: accountSigner.accountAddress,\n            message,\n            signature,\n        });\n\n        return {\n            subaccountId: response.subaccountId,\n            smartAccountSaltNonce: response.smartAccountSaltNonce,\n            revision: response.revision,\n        };\n    }\n\n    /**\n     * Returns the current account-signer auth state snapshot.\n     */\n    getState(): AuthState {\n        const accountIdentity = this.#accountSigner ?? this.#accountIdentity;\n\n        return {\n            isAuthenticated: this.#isAuthenticated,\n            accountAddress: accountIdentity?.accountAddress ?? null,\n            ownerAddress: accountIdentity?.ownerAddress ?? null,\n            mainAccountId: this.#mainAccountId,\n            activeAccount:\n                this.#activeAccountId && this.#mainAccountId\n                    ? {\n                          accountId: this.#activeAccountId,\n                          isMain: this.#activeAccountId === this.#mainAccountId,\n                          mainAccountId: this.#mainAccountId,\n                          smartAccountAddress: accountIdentity?.accountAddress,\n                      }\n                    : null,\n        };\n    }\n\n    async #resolveAccountSigner(): Promise<AccountSigner | null> {\n        if (this.#accountSigner) {\n            this.#assertAccountSignerEnvironment(this.#accountSigner);\n            return this.#accountSigner;\n        }\n\n        const resolved = await resolveAccountSigner(this.#accountSignerConfig);\n        if (resolved) {\n            this.#assertAccountSignerEnvironment(resolved);\n        }\n        return resolved;\n    }\n\n    #notifyStateChange(): void {\n        this.events.emit(\"stateChange\", this.getState());\n    }\n\n    #beginAuthOperation(): number {\n        this.#authOperationGeneration += 1;\n        return this.#authOperationGeneration;\n    }\n\n    #isCurrentAuthOperation(generation: number, token?: string | null): boolean {\n        return (\n            generation === this.#authOperationGeneration &&\n            (token === undefined || this.#tokenStorage.get() === token)\n        );\n    }\n\n    #loginResult(response: LoginWithWalletResponse): LoginResult {\n        const expiresAt = response.expiresAt\n            ? new Date(\n                  Number(response.expiresAt.seconds) * 1000 +\n                      (response.expiresAt.nanos ?? 0) / 1_000_000,\n              )\n            : new Date();\n        return { accountId: response.accountId, username: response.username, expiresAt };\n    }\n\n    #getEnvironmentBoundToken(): string | null {\n        return this.#sessionStore.getEnvironmentBoundToken(this.#tokenStorage);\n    }\n\n    #getCurrentTokenStorageOptions(): AuthTokenStorageSetOptions {\n        const token = this.#tokenStorage.get();\n        if (!token) return { expiresAt: null, maxAgeSeconds: null };\n        return createAuthTokenStorageSetOptions(token);\n    }\n\n    #resolveRefreshProvider(\n        provider?: \"metamask\" | \"turnkey\" | \"other\",\n    ): \"metamask\" | \"turnkey\" | \"other\" {\n        return (\n            provider ?? this.#walletProvider ?? this.#getEnvironmentSession()?.provider ?? \"other\"\n        );\n    }\n\n    #assertAccountSignerEnvironment(accountSigner: AccountSigner): void {\n        assertAccountSigner(accountSigner);\n        if (accountSigner.environmentFingerprint !== this.#environmentFingerprint) {\n            throw new ConfigurationError(\n                \"Account signer environment does not match client environment.\",\n            );\n        }\n    }\n\n    #identityFromSigner(accountSigner: AccountSigner): AccountIdentity {\n        return {\n            accountAddress: accountSigner.accountAddress,\n            ownerAddress: accountSigner.ownerAddress,\n        };\n    }\n\n    #getEnvironmentSession(): SessionData | null {\n        return this.#sessionStore.get();\n    }\n}\n\nfunction resolveChallengeUri(uri: string | undefined): string {\n    const resolved = uri ?? (typeof location === \"undefined\" ? undefined : location.origin);\n    if (!resolved)\n        throw new ConfigurationError(\n            \"Wallet authentication requires a browser origin URI. Pass uri outside a browser.\",\n        );\n    return resolved;\n}\n"],"mappings":"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"}
+{"version":3,"file":"account-signer-auth.js","names":["#accountSignerConfig","#environmentFingerprint","#subaccounts","#tokenStorage","#realtime","#sessionStore","#assertAccountSignerEnvironment","#beginAuthOperation","#accountSigner","#accountIdentity","#identityFromSigner","#notifyStateChange","#login","#resolveAccountSigner","#challengeUri","#isCurrentAuthOperation","#getEnvironmentSession","#loginMethod","#isAuthenticated","#mainAccountId","#activeAccountId","#walletProvider","#loginResult","#getEnvironmentBoundToken","#clearExpiredSessionState","#getCurrentTokenStorageOptions","#resolveRefreshProvider","#authOperationGeneration"],"sources":["../../../src/services/auth/account-signer-auth.ts"],"sourcesContent":["import { AuthService, type LoginWithWalletResponse } from \"./auth.js\";\nimport { AuthenticationError, ConfigurationError } from \"../../shared/errors.js\";\nimport { toPolyesterError } from \"../../shared/connect-error-mapping.js\";\nimport { AuthSessionStore } from \"./session.js\";\nimport type { AccountSigner, AccountSignerConfig, HexAddress } from \"../../account-signer/types.js\";\nimport { assertAccountSigner, resolveAccountSigner } from \"../../account-signer/types.js\";\nimport { EventEmitter } from \"../../utils/event-emitter.js\";\nimport { isJwtValid, getJwtTimeToExpiry } from \"../../utils/jwt.js\";\nimport type { SubaccountChallenge, SubaccountsService } from \"../subaccounts/index.js\";\nimport type {\n    AuthState,\n    AuthHydrationData,\n    AuthLoginMethod,\n    SessionData,\n    ActiveAccountInfo,\n} from \"./session.types.js\";\nimport type { PolyesterRealtime } from \"../../realtime/index.js\";\nimport type { PolyesterEnvironment } from \"../../environment.js\";\nimport type { AuthAndPublicApiTransports } from \"../../shared/transports.js\";\nimport {\n    createAuthTokenStorageSetOptions,\n    type AuthTokenStorage,\n    type AuthTokenStorageSetOptions,\n} from \"./token-storage.js\";\n\nexport interface AccountSignerAuthEvents {\n    authenticated: { accountId: string; username: string };\n    loggedOut: void;\n    error: { code: string; message: string };\n    servicesReady: void;\n    stateChange: AuthState;\n}\n\nexport interface LoginResult {\n    accountId: string;\n    username: string;\n    expiresAt: Date;\n}\n\nexport interface LoginOptions {\n    /**\n     * The wallet provider to use for login.\n     */\n    provider: \"metamask\" | \"turnkey\" | \"other\";\n    /** Browser origin requesting the signature; defaults to location.origin in browsers. Required outside browsers. */\n    uri?: string;\n    loginMethod?: AuthLoginMethod | null;\n}\n\nexport interface CreateSubaccountParams {\n    /**\n     * Signer for the new subaccount, or a factory that derives it from the server challenge\n     * (for example via Turnkey with `challenge.smartAccountSaltNonce`). Its accountAddress must\n     * equal `challenge.smartAccountAddress`.\n     */\n    accountSigner:\n        | AccountSigner\n        | ((challenge: SubaccountChallenge) => AccountSigner | Promise<AccountSigner>);\n    /** Optional human-readable label for this subaccount */\n    label?: string;\n    /** Browser origin requesting the signature; defaults to location.origin in browsers. Required outside browsers. */\n    uri?: string;\n    /** Root owner EOA bound to the authenticated account; defaults to the configured signer's owner. */\n    ownerAddress?: HexAddress;\n}\n\nexport interface CreateSubaccountResult {\n    subaccountId: string;\n    smartAccountSaltNonce: number;\n    revision: string;\n}\n\ninterface AccountIdentity {\n    accountAddress: HexAddress;\n    ownerAddress?: HexAddress;\n}\n\n/**\n * Coordinates wallet/account-signer authentication, session storage, subaccount selection, and session refresh.\n */\nexport class AccountSignerAuthService extends AuthService {\n    readonly events = new EventEmitter<AccountSignerAuthEvents>();\n\n    #accountSignerConfig: AccountSignerConfig | undefined;\n    #accountSigner: AccountSigner | null = null;\n    #accountIdentity: AccountIdentity | null = null;\n    #isAuthenticated = false;\n    #mainAccountId: string | null = null;\n    #activeAccountId: string | null = null;\n    #subaccounts: SubaccountsService;\n    #walletProvider: \"metamask\" | \"turnkey\" | \"other\" | undefined = undefined;\n    #loginMethod: AuthLoginMethod | null = null;\n    #challengeUri: string | undefined = undefined;\n    #environmentFingerprint: string;\n    #tokenStorage: AuthTokenStorage;\n    #sessionStore: AuthSessionStore;\n    #realtime: PolyesterRealtime;\n    // Every asynchronous auth transition captures this generation. A later login,\n    // logout, signer change, or restore makes older work observational only.\n    #authOperationGeneration = 0;\n\n    constructor({\n        transports,\n        accountSignerConfig,\n        environment,\n        subaccounts,\n        realtime,\n        tokenStorage,\n        sessionStore,\n    }: {\n        transports: AuthAndPublicApiTransports;\n        accountSignerConfig?: AccountSignerConfig;\n        environment: PolyesterEnvironment;\n        subaccounts: SubaccountsService;\n        realtime: PolyesterRealtime;\n        tokenStorage: AuthTokenStorage;\n        sessionStore?: AuthSessionStore;\n    }) {\n        super(transports, realtime);\n\n        this.#accountSignerConfig = accountSignerConfig;\n        this.#environmentFingerprint = environment.fingerprint;\n        this.#subaccounts = subaccounts;\n        this.#tokenStorage = tokenStorage;\n        this.#realtime = realtime;\n        this.#sessionStore =\n            sessionStore ??\n            new AuthSessionStore({\n                environmentFingerprint: environment.fingerprint,\n            });\n    }\n\n    /**\n     * Attaches the subaccounts service used when creating a subaccount during authenticated flows.\n     */\n    setSubaccountsService(subaccounts: SubaccountsService): void {\n        this.#subaccounts = subaccounts;\n    }\n\n    /**\n     * Sets the account signer used to sign login and account-switch challenges.\n     */\n    setAccountSigner(accountSigner: AccountSigner | null): void {\n        if (accountSigner) this.#assertAccountSignerEnvironment(accountSigner);\n        this.#beginAuthOperation();\n        this.#accountSigner = accountSigner;\n        this.#accountIdentity = accountSigner ? this.#identityFromSigner(accountSigner) : null;\n        this.#notifyStateChange();\n    }\n\n    /**\n     * Returns the active account signer, throwing if one has not been configured.\n     */\n    getAccountSigner(): AccountSigner | null {\n        return this.#accountSigner;\n    }\n\n    /**\n     * Signs a server-issued SIWE message with the configured account signer, exchanges it for a session token, and stores the hydrated account/subaccount session state.\n     */\n    async login(options: LoginOptions): Promise<LoginResult> {\n        return this.#login(options);\n    }\n\n    async #login(\n        options: LoginOptions,\n        previousActiveAccount?: ActiveAccountInfo,\n    ): Promise<LoginResult> {\n        const generation = this.#beginAuthOperation();\n        const startingToken = this.#tokenStorage.get();\n        const { provider, loginMethod } = options;\n\n        const accountSigner = await this.#resolveAccountSigner();\n\n        if (!accountSigner) {\n            throw new ConfigurationError(\n                \"No account signer configured. Call setAccountSigner() or pass accountSigner in config.\",\n            );\n        }\n\n        const smartAccountAddress = accountSigner.accountAddress;\n        const ownerAddress = accountSigner.ownerAddress ?? accountSigner.accountAddress;\n\n        const uri = resolveChallengeUri(options.uri ?? this.#challengeUri);\n        const { message } = await this.createWalletChallenge({\n            smartAccountAddress,\n            signerAddress: ownerAddress,\n            uri,\n        });\n        const signature = await accountSigner.signMessage(message);\n\n        const response = await this.loginWithWallet({\n            smartAccountAddress,\n            message,\n            signature,\n            walletProvider: provider,\n        });\n\n        if (!this.#isCurrentAuthOperation(generation, startingToken)) {\n            throw new DOMException(\"Authentication operation superseded\", \"AbortError\");\n        }\n        const environmentSession = this.#getEnvironmentSession();\n        const resolvedLoginMethod =\n            loginMethod ??\n            this.#loginMethod ??\n            environmentSession?.loginMethod ??\n            (provider === \"metamask\" ? \"metamask\" : null);\n\n        const tokenOptions = createAuthTokenStorageSetOptions(response.accessToken);\n        const activeAccount =\n            previousActiveAccount?.mainAccountId === response.accountId\n                ? previousActiveAccount\n                : undefined;\n        this.#sessionStore.commitLogin(\n            {\n                accessToken: response.accessToken,\n                tokenOptions,\n                provider,\n                loginMethod: resolvedLoginMethod,\n                primaryWallet: ownerAddress,\n                smartAccount: smartAccountAddress,\n                accountId: response.accountId,\n                activeAccount,\n                username: response.username ?? undefined,\n            },\n            this.#tokenStorage,\n        );\n        this.#isAuthenticated = true;\n        this.#mainAccountId = response.accountId;\n        this.#activeAccountId = activeAccount?.accountId ?? response.accountId;\n        this.#walletProvider = provider;\n        this.#loginMethod = resolvedLoginMethod;\n        this.#challengeUri = uri;\n        this.#accountSigner = accountSigner;\n        this.#accountIdentity = this.#identityFromSigner(accountSigner);\n\n        this.#notifyStateChange();\n\n        this.events.emit(\"authenticated\", {\n            accountId: response.accountId,\n            username: response.username,\n        });\n\n        return this.#loginResult(response);\n    }\n\n    /**\n     * Builds auth state from a session token and optional active account override.\n     */\n    hydrateAuthState(state: AuthHydrationData): void {\n        this.#beginAuthOperation();\n        const existingToken = this.#getEnvironmentBoundToken();\n        if (!existingToken || !isJwtValid(existingToken)) return;\n\n        const existingSession = this.#getEnvironmentSession();\n        this.#walletProvider = existingSession?.provider ?? this.#walletProvider;\n        this.#loginMethod = existingSession?.loginMethod ?? this.#loginMethod;\n\n        this.#isAuthenticated = true;\n        this.#mainAccountId = state.mainAccountId;\n        this.#activeAccountId = state.activeAccountId ?? state.mainAccountId;\n        this.#accountIdentity = state.smartAccountAddress\n            ? {\n                  accountAddress: state.smartAccountAddress,\n                  ownerAddress: state.ownerAddress,\n              }\n            : null;\n\n        this.#notifyStateChange();\n    }\n\n    /**\n     * Loads the stored token, validates that it still belongs to this environment, and restores auth state when possible.\n     */\n    async restoreSession(): Promise<{ accountId: string; username: string } | null> {\n        const generation = this.#beginAuthOperation();\n        const existingToken = this.#getEnvironmentBoundToken();\n\n        if (!existingToken || !isJwtValid(existingToken)) {\n            if (this.#isCurrentAuthOperation(generation)) this.#clearExpiredSessionState();\n            return null;\n        }\n\n        let me: Awaited<ReturnType<AuthService[\"me\"]>>;\n        try {\n            me = await this.me();\n        } catch (error) {\n            if (!this.#isCurrentAuthOperation(generation, existingToken)) return null;\n            const mappedError = toPolyesterError(error);\n            if (mappedError instanceof AuthenticationError) {\n                this.#clearExpiredSessionState();\n                return null;\n            }\n            throw mappedError;\n        }\n        if (!this.#isCurrentAuthOperation(generation, existingToken)) return null;\n\n        let accountSigner = this.#accountSigner;\n        if (!accountSigner) {\n            try {\n                accountSigner = await resolveAccountSigner(this.#accountSignerConfig);\n            } catch (error) {\n                if (!this.#isCurrentAuthOperation(generation, existingToken)) return null;\n                throw error;\n            }\n            if (!this.#isCurrentAuthOperation(generation, existingToken)) return null;\n            if (accountSigner) this.#assertAccountSignerEnvironment(accountSigner);\n        }\n\n        if (!isJwtValid(existingToken) || this.#getEnvironmentBoundToken() !== existingToken) {\n            this.#clearExpiredSessionState();\n            return null;\n        }\n\n        const existingSession = this.#getEnvironmentSession();\n        const walletProvider = existingSession?.provider ?? this.#walletProvider;\n        const loginMethod = existingSession?.loginMethod ?? this.#loginMethod;\n        const activeAccountId =\n            this.#activeAccountId ?? existingSession?.activeAccount?.accountId ?? me.accountId;\n\n        // Publish runtime state only after asynchronous restoration has completed.\n        if (accountSigner) {\n            this.#sessionStore.ensureSession(\n                {\n                    provider: walletProvider ?? \"other\",\n                    loginMethod: loginMethod ?? (walletProvider === \"metamask\" ? \"metamask\" : null),\n                    primaryWallet: accountSigner.ownerAddress ?? accountSigner.accountAddress,\n                    smartAccount: accountSigner.accountAddress,\n                    accountId: me.accountId,\n                    username: me.username ?? undefined,\n                },\n                { maxAgeSeconds: this.#getCurrentTokenStorageOptions().maxAgeSeconds },\n            );\n            this.#accountSigner = accountSigner;\n            this.#accountIdentity = this.#identityFromSigner(accountSigner);\n        }\n        this.#isAuthenticated = true;\n        this.#mainAccountId = me.accountId;\n        this.#activeAccountId = activeAccountId;\n        this.#walletProvider = walletProvider ?? (accountSigner ? \"other\" : undefined);\n        this.#loginMethod = loginMethod;\n        this.#notifyStateChange();\n        return { accountId: me.accountId, username: me.username };\n    }\n\n    /**\n     * Clears stored auth state and removes the persisted auth token.\n     */\n    async logout(): Promise<void> {\n        this.#beginAuthOperation();\n        this.#realtime.disconnectPrivate();\n        this.#tokenStorage.clear();\n        this.#isAuthenticated = false;\n        this.#mainAccountId = null;\n        this.#activeAccountId = null;\n        this.#loginMethod = null;\n        this.#challengeUri = undefined;\n        this.#accountIdentity = null;\n\n        this.#sessionStore.clear();\n\n        this.#notifyStateChange();\n        this.events.emit(\"loggedOut\", undefined);\n    }\n\n    #clearExpiredSessionState(): void {\n        const shouldEmitLoggedOut = this.#isAuthenticated;\n        this.#realtime.disconnectPrivate();\n        this.#tokenStorage.clear();\n        this.#sessionStore.clear();\n        this.#isAuthenticated = false;\n        this.#mainAccountId = null;\n        this.#activeAccountId = null;\n        this.#loginMethod = null;\n        this.#challengeUri = undefined;\n        this.#accountIdentity = null;\n        this.#notifyStateChange();\n        if (shouldEmitLoggedOut) {\n            this.events.emit(\"loggedOut\", undefined);\n        }\n    }\n\n    /**\n     * Returns the remaining lifetime of the stored session token in milliseconds.\n     */\n    getSessionTimeToExpiry(): number {\n        const token = this.#getEnvironmentBoundToken();\n        if (!token || !isJwtValid(token)) return 0;\n        return getJwtTimeToExpiry(token);\n    }\n\n    /**\n     * Refreshes the active account-signer session and updates persisted auth state.\n     */\n    async refreshSession(params?: {\n        /** Overrides the origin remembered from login. */\n        uri?: string;\n        provider?: \"metamask\" | \"turnkey\" | \"other\";\n        loginMethod?: AuthLoginMethod | null;\n    }): Promise<LoginResult> {\n        if (!this.#isAuthenticated) {\n            throw new AuthenticationError(\"Must be authenticated to refresh session\");\n        }\n\n        const currentSession = this.#getEnvironmentSession();\n        return this.#login(\n            {\n                provider: this.#resolveRefreshProvider(params?.provider),\n                uri: params?.uri,\n                loginMethod: params?.loginMethod ?? this.#loginMethod,\n            },\n            currentSession?.activeAccount,\n        );\n    }\n\n    /**\n     * Switches the active account/subaccount by signing the required account switch flow.\n     */\n    switchAccount(\n        accountId: string,\n        options?: { smartAccountAddress?: string; label?: string },\n    ): { accountId: string; isMain: boolean } {\n        if (!this.#isAuthenticated || !this.#mainAccountId) {\n            throw new AuthenticationError(\"Must be authenticated to switch accounts\");\n        }\n\n        this.#activeAccountId = accountId;\n        const isMain = accountId === this.#mainAccountId;\n\n        this.#sessionStore.setActiveAccount(\n            {\n                accountId,\n                isMain,\n                smartAccountAddress: options?.smartAccountAddress,\n                label: options?.label,\n            },\n            { maxAgeSeconds: this.#getCurrentTokenStorageOptions().maxAgeSeconds },\n        );\n        this.#notifyStateChange();\n\n        return { accountId, isMain };\n    }\n\n    /** Keeps the display-session identity current for the next server render. */\n    syncSessionUsername(username: string | null): void {\n        this.#sessionStore.setUsername(username, {\n            maxAgeSeconds: this.#getCurrentTokenStorageOptions().maxAgeSeconds,\n        });\n    }\n\n    /**\n     * Creates a subaccount for the authenticated account and makes it available to the session state.\n     */\n    async createSubaccount(params: CreateSubaccountParams): Promise<CreateSubaccountResult> {\n        if (!this.#isAuthenticated) {\n            throw new AuthenticationError(\"Must be authenticated to create subaccounts\");\n        }\n\n        if (!this.#subaccounts) {\n            throw new ConfigurationError(\n                \"SubaccountsService not configured. Pass it to constructor or call setSubaccountsService().\",\n            );\n        }\n\n        const identity = this.#accountSigner ?? this.#accountIdentity;\n        const ownerAddress =\n            params.ownerAddress ?? identity?.ownerAddress ?? identity?.accountAddress;\n        if (!ownerAddress) {\n            throw new ConfigurationError(\n                \"No root owner address available. Pass ownerAddress or configure an account signer.\",\n            );\n        }\n\n        const { label = \"\" } = params;\n        const challenge = await this.#subaccounts.createChallenge({\n            ownerAddress,\n            uri: resolveChallengeUri(params.uri ?? this.#challengeUri),\n        });\n        const accountSigner =\n            typeof params.accountSigner === \"function\"\n                ? await params.accountSigner(challenge)\n                : params.accountSigner;\n        this.#assertAccountSignerEnvironment(accountSigner);\n        if (\n            accountSigner.accountAddress.toLowerCase() !==\n            challenge.smartAccountAddress.toLowerCase()\n        ) {\n            throw new ConfigurationError(\n                `Subaccount signer address ${accountSigner.accountAddress} does not match the server-derived smart account ${challenge.smartAccountAddress}.`,\n            );\n        }\n        const signature = await accountSigner.signMessage(challenge.message);\n\n        const response = await this.#subaccounts.create({\n            label,\n            smartAccountAddress: challenge.smartAccountAddress,\n            message: challenge.message,\n            signature,\n        });\n\n        return {\n            subaccountId: response.subaccountId,\n            smartAccountSaltNonce: response.smartAccountSaltNonce,\n            revision: response.revision,\n        };\n    }\n\n    /**\n     * Returns the current account-signer auth state snapshot.\n     */\n    getState(): AuthState {\n        const accountIdentity = this.#accountSigner ?? this.#accountIdentity;\n\n        return {\n            isAuthenticated: this.#isAuthenticated,\n            accountAddress: accountIdentity?.accountAddress ?? null,\n            ownerAddress: accountIdentity?.ownerAddress ?? null,\n            mainAccountId: this.#mainAccountId,\n            activeAccount:\n                this.#activeAccountId && this.#mainAccountId\n                    ? {\n                          accountId: this.#activeAccountId,\n                          isMain: this.#activeAccountId === this.#mainAccountId,\n                          mainAccountId: this.#mainAccountId,\n                          smartAccountAddress: accountIdentity?.accountAddress,\n                      }\n                    : null,\n        };\n    }\n\n    async #resolveAccountSigner(): Promise<AccountSigner | null> {\n        if (this.#accountSigner) {\n            this.#assertAccountSignerEnvironment(this.#accountSigner);\n            return this.#accountSigner;\n        }\n\n        const resolved = await resolveAccountSigner(this.#accountSignerConfig);\n        if (resolved) {\n            this.#assertAccountSignerEnvironment(resolved);\n        }\n        return resolved;\n    }\n\n    #notifyStateChange(): void {\n        this.events.emit(\"stateChange\", this.getState());\n    }\n\n    #beginAuthOperation(): number {\n        this.#authOperationGeneration += 1;\n        return this.#authOperationGeneration;\n    }\n\n    #isCurrentAuthOperation(generation: number, token?: string | null): boolean {\n        return (\n            generation === this.#authOperationGeneration &&\n            (token === undefined || this.#tokenStorage.get() === token)\n        );\n    }\n\n    #loginResult(response: LoginWithWalletResponse): LoginResult {\n        const expiresAt = response.expiresAt\n            ? new Date(\n                  Number(response.expiresAt.seconds) * 1000 +\n                      (response.expiresAt.nanos ?? 0) / 1_000_000,\n              )\n            : new Date();\n        return { accountId: response.accountId, username: response.username, expiresAt };\n    }\n\n    #getEnvironmentBoundToken(): string | null {\n        return this.#sessionStore.getEnvironmentBoundToken(this.#tokenStorage);\n    }\n\n    #getCurrentTokenStorageOptions(): AuthTokenStorageSetOptions {\n        const token = this.#tokenStorage.get();\n        if (!token) return { expiresAt: null, maxAgeSeconds: null };\n        return createAuthTokenStorageSetOptions(token);\n    }\n\n    #resolveRefreshProvider(\n        provider?: \"metamask\" | \"turnkey\" | \"other\",\n    ): \"metamask\" | \"turnkey\" | \"other\" {\n        return (\n            provider ?? this.#walletProvider ?? this.#getEnvironmentSession()?.provider ?? \"other\"\n        );\n    }\n\n    #assertAccountSignerEnvironment(accountSigner: AccountSigner): void {\n        assertAccountSigner(accountSigner);\n        if (accountSigner.environmentFingerprint !== this.#environmentFingerprint) {\n            throw new ConfigurationError(\n                \"Account signer environment does not match client environment.\",\n            );\n        }\n    }\n\n    #identityFromSigner(accountSigner: AccountSigner): AccountIdentity {\n        return {\n            accountAddress: accountSigner.accountAddress,\n            ownerAddress: accountSigner.ownerAddress,\n        };\n    }\n\n    #getEnvironmentSession(): SessionData | null {\n        return this.#sessionStore.get();\n    }\n}\n\nfunction resolveChallengeUri(uri: string | undefined): string {\n    const resolved = uri ?? (typeof location === \"undefined\" ? undefined : location.origin);\n    if (!resolved)\n        throw new ConfigurationError(\n            \"Wallet authentication requires a browser origin URI. Pass uri outside a browser.\",\n        );\n    return resolved;\n}\n"],"mappings":"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"}

package/dist/services/auth/auth.d.ts

@@ -9,10 +9,8 @@ declare const CreateWalletChallengeInputSchema: v.StrictObjectSchema<{
   readonly smartAccountAddress: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "Invalid wallet address.">]>;
   readonly signerAddress: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "Invalid wallet address.">]>;
   readonly uri: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2048, undefined>, v.CheckAction<string, "Wallet challenge URI must be an HTTP(S) origin without a path, query, fragment, or user information.">]>;
-  readonly purpose: v.PicklistSchema<["login", "create_subaccount"], undefined>;
 }, undefined>;
 type CreateWalletChallengeInput = v.InferInput<typeof CreateWalletChallengeInputSchema>;
-type WalletChallengePurpose = CreateWalletChallengeInput["purpose"];
 declare const LoginWithWalletInputSchema: v.StrictObjectSchema<{
   readonly smartAccountAddress: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "Invalid wallet address.">]>;
   readonly message: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.CheckAction<string, "Wallet challenge message exceeds 4096 UTF-8 bytes.">]>;
@@ -90,8 +88,9 @@ declare class AuthService {
    */
   acceptTerms(options?: PolyesterMutationOptions): Promise<void>;
   /**
-   * Requests a server-issued SIWE message. Sign its exact UTF-8 bytes with
+   * Requests a server-issued SIWE login message. Sign its exact UTF-8 bytes with
    * personal_sign; do not hash or reconstruct it. Expiry is epoch milliseconds.
+   * Subaccount creation uses `subaccounts.createChallenge` instead.
    */
   createWalletChallenge(input: CreateWalletChallengeInput, options?: PolyesterRequestOptions): Promise<WalletChallenge>;
   /**
@@ -100,5 +99,5 @@ declare class AuthService {
   protected loginWithWallet(input: LoginWithWalletInput, options?: PolyesterMutationOptions): Promise<LoginWithWalletResponse>;
 }
 //#endregion
-export { AuthService, CreateWalletChallengeInput, CreateWalletChallengeInputSchema, LoginWithWalletInput, LoginWithWalletInputSchema, LoginWithWalletResponse, Me, WalletChallenge, WalletChallengePurpose };
+export { AuthService, CreateWalletChallengeInput, CreateWalletChallengeInputSchema, LoginWithWalletInput, LoginWithWalletInputSchema, LoginWithWalletResponse, Me, WalletChallenge };
 //# sourceMappingURL=auth.d.ts.map

package/dist/services/auth/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","names":[],"sources":["../../../src/services/auth/auth.ts"],"mappings":";;;;;;;cA0Ba,kCAAgC,EAAA;;;;;;KAMjC,6BAA6B,EAAE,kBAAkB;KACjD,yBAAyB;cAWxB,4BAA0B,EAAA;;;;;;;;KAS3B,uBAAuB,EAAE,kBAAkB;cAEjD,UAAQ,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;KAOF,KAAK,EAAE,mBAAmB;cAEhC,+BAA6B,EAAA;;;;;;;;;KAOvB,0BAA0B,EAAE,mBAAmB;cAErD,uBAAqB,EAAA;;;;;;;;;;KAKf,kBAAkB,EAAE,mBAAmB;;;;cAKtC;;EAGT,SAAS;EAEG,YAAA,YAAY,4BAA4B,UAAU;;;;EASxD,GAAG,UAAU,0BAA0B,QAAQ;;;;;;;EAW/C,YAAY,UAAU,2BAA2B;;;;;EAQjD,sBACF,OAAO,4BACP,UAAU,0BACX,QAAQ;;;;YA4BK,gBACZ,OAAO,sBACP,UAAU,2BACX,QAAQ"}
+{"version":3,"file":"auth.d.ts","names":[],"sources":["../../../src/services/auth/auth.ts"],"mappings":";;;;;;;cAyBa,kCAAgC,EAAA;;;;;KAKjC,6BAA6B,EAAE,kBAAkB;cAWhD,4BAA0B,EAAA;;;;;;;;KAS3B,uBAAuB,EAAE,kBAAkB;cAEjD,UAAQ,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;KAOF,KAAK,EAAE,mBAAmB;cAEhC,+BAA6B,EAAA;;;;;;;;;KAOvB,0BAA0B,EAAE,mBAAmB;cAErD,uBAAqB,EAAA;;;;;;;;;;KAKf,kBAAkB,EAAE,mBAAmB;;;;cAKtC;;EAGT,SAAS;EAEG,YAAA,YAAY,4BAA4B,UAAU;;;;EASxD,GAAG,UAAU,0BAA0B,QAAQ;;;;;;;EAW/C,YAAY,UAAU,2BAA2B;;;;;;EASjD,sBACF,OAAO,4BACP,UAAU,0BACX,QAAQ;;;;YAcK,gBACZ,OAAO,sBACP,UAAU,2BACX,QAAQ"}

package/dist/services/auth/auth.js

@@ -1,4 +1,3 @@
-import { ValidationError } from "../../shared/errors.js";
 import { AuthService as AuthService$1 } from "../../gen/auth/v1/auth_pb.js";
 import { OptionalTimestampMsSchema, PublicIdSchema, TimestampSchema } from "../../shared/schemas.js";
 import { parse } from "../../shared/validation.js";
@@ -12,8 +11,7 @@ import * as v from "valibot";
 const CreateWalletChallengeInputSchema = v.strictObject({
 	smartAccountAddress: WalletAddressSchema,
 	signerAddress: WalletAddressSchema,
-	uri: WalletChallengeUriSchema,
-	purpose: v.picklist(["login", "create_subaccount"])
+	uri: WalletChallengeUriSchema
 });
 /** An EIP-191 EOA signature: 65 hexadecimal bytes, with an optional 0x prefix. */
 const LoginEoaSignatureSchema = v.pipe(v.string(), v.regex(/^(?:0x)?[0-9a-fA-F]{130}$/, "Login signature must be a 65-byte hexadecimal EOA signature."));
@@ -70,15 +68,15 @@ var AuthService = class {
 		await this.#authClient.acceptTerms({}, toConnectCallOptions(options));
 	}
 	/**
-	* Requests a server-issued SIWE message. Sign its exact UTF-8 bytes with
+	* Requests a server-issued SIWE login message. Sign its exact UTF-8 bytes with
 	* personal_sign; do not hash or reconstruct it. Expiry is epoch milliseconds.
+	* Subaccount creation uses `subaccounts.createChallenge` instead.
 	*/
 	async createWalletChallenge(input, options) {
 		const validated = parse(CreateWalletChallengeInputSchema, input);
-		if (validated.purpose === "create_subaccount" && validated.signerAddress.toLowerCase() !== validated.smartAccountAddress.toLowerCase()) throw new ValidationError("Subaccount challenge signer must equal the smart account address.");
 		return parse(WalletChallengeSchema, await this.#publicClient.createWalletChallenge({
 			...validated,
-			purpose: validated.purpose === "login" ? 1 : 2
+			purpose: 1
 		}, toConnectCallOptions(options)));
 	}
 	/**

package/dist/services/auth/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","names":["#publicClient","Proto.AuthService","#authClient"],"sources":["../../../src/services/auth/auth.ts"],"sourcesContent":["import { createClient, type Client } from \"@connectrpc/connect\";\nimport * as Proto from \"../../gen/auth/v1/auth_pb.js\";\nimport * as v from \"valibot\";\nimport { ValidationError } from \"../../shared/errors.js\";\nimport { parse } from \"../../shared/validation.js\";\nimport { ProfileService } from \"./profile/profile.js\";\nimport {\n    OptionalTimestampMsSchema,\n    PublicIdSchema,\n    TimestampSchema,\n} from \"../../shared/schemas.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterMutationOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport { MfaSessionInfoSchema } from \"../mfa/mfa.schemas.js\";\nimport type { PolyesterRealtime } from \"../../realtime/index.js\";\nimport type { AuthAndPublicApiTransports } from \"../../shared/transports.js\";\n\nimport {\n    WalletAddressSchema,\n    WalletChallengeUriSchema,\n    WalletChallengeMessageSchema,\n} from \"./wallet-challenge.schemas.js\";\n\nexport const CreateWalletChallengeInputSchema = v.strictObject({\n    smartAccountAddress: WalletAddressSchema,\n    signerAddress: WalletAddressSchema,\n    uri: WalletChallengeUriSchema,\n    purpose: v.picklist([\"login\", \"create_subaccount\"]),\n});\nexport type CreateWalletChallengeInput = v.InferInput<typeof CreateWalletChallengeInputSchema>;\nexport type WalletChallengePurpose = CreateWalletChallengeInput[\"purpose\"];\n\n/** An EIP-191 EOA signature: 65 hexadecimal bytes, with an optional 0x prefix. */\nconst LoginEoaSignatureSchema = v.pipe(\n    v.string(),\n    v.regex(\n        /^(?:0x)?[0-9a-fA-F]{130}$/,\n        \"Login signature must be a 65-byte hexadecimal EOA signature.\",\n    ),\n);\n\nexport const LoginWithWalletInputSchema = v.strictObject({\n    smartAccountAddress: WalletAddressSchema,\n    message: WalletChallengeMessageSchema,\n    signature: LoginEoaSignatureSchema,\n    userAgent: v.optional(v.string(), \"\"),\n    ip: v.optional(v.string(), \"\"),\n    walletProvider: v.optional(v.string(), \"\"),\n});\n\nexport type LoginWithWalletInput = v.InferInput<typeof LoginWithWalletInputSchema>;\n\nconst MeSchema = v.object({\n    accountId: PublicIdSchema,\n    apiKeyId: v.optional(v.string()),\n    username: v.string(),\n    session: v.optional(MfaSessionInfoSchema),\n});\n\nexport type Me = v.InferOutput<typeof MeSchema>;\n\nconst LoginWithWalletResponseSchema = v.object({\n    accessToken: v.string(),\n    expiresAt: v.optional(TimestampSchema),\n    accountId: PublicIdSchema,\n    username: v.string(),\n});\n\nexport type LoginWithWalletResponse = v.InferOutput<typeof LoginWithWalletResponseSchema>;\n\nconst WalletChallengeSchema = v.object({\n    message: WalletChallengeMessageSchema,\n    expiresAt: OptionalTimestampMsSchema,\n});\n\nexport type WalletChallenge = v.InferOutput<typeof WalletChallengeSchema>;\n\n/**\n * Handles wallet-based authentication, caller introspection, and authenticated profile operations.\n */\nexport class AuthService {\n    #publicClient: Client<typeof Proto.AuthService>;\n    #authClient: Client<typeof Proto.AuthService>;\n    profile: ProfileService;\n\n    constructor(transports: AuthAndPublicApiTransports, realtime: PolyesterRealtime) {\n        this.#publicClient = createClient(Proto.AuthService, transports.publicApi);\n        this.#authClient = createClient(Proto.AuthService, transports.authApi);\n        this.profile = new ProfileService(transports, realtime);\n    }\n\n    /**\n     * Returns the authenticated caller's account context, including account ID, optional API key ID, username, and session assurance details from the presented token or API key.\n     */\n    async me(options?: PolyesterRequestOptions): Promise<Me> {\n        const res = await this.#authClient.me({}, toConnectCallOptions(options));\n        return parse(MeSchema, res);\n    }\n\n    /**\n     * Records explicit consent to the current terms for the caller's root account.\n     * Call only after the user consents. Requires an interactive JWT session;\n     * API keys are not allowed. Repeated acceptance succeeds without changing\n     * the first acceptance time. No MFA is required.\n     */\n    async acceptTerms(options?: PolyesterMutationOptions): Promise<void> {\n        await this.#authClient.acceptTerms({}, toConnectCallOptions(options));\n    }\n\n    /**\n     * Requests a server-issued SIWE message. Sign its exact UTF-8 bytes with\n     * personal_sign; do not hash or reconstruct it. Expiry is epoch milliseconds.\n     */\n    async createWalletChallenge(\n        input: CreateWalletChallengeInput,\n        options?: PolyesterRequestOptions,\n    ): Promise<WalletChallenge> {\n        const validated = parse(CreateWalletChallengeInputSchema, input);\n        if (\n            validated.purpose === \"create_subaccount\" &&\n            validated.signerAddress.toLowerCase() !== validated.smartAccountAddress.toLowerCase()\n        ) {\n            throw new ValidationError(\n                \"Subaccount challenge signer must equal the smart account address.\",\n            );\n        }\n        return parse(\n            WalletChallengeSchema,\n            await this.#publicClient.createWalletChallenge(\n                {\n                    ...validated,\n                    purpose:\n                        validated.purpose === \"login\"\n                            ? Proto.WalletChallengePurpose.LOGIN\n                            : Proto.WalletChallengePurpose.CREATE_SUBACCOUNT,\n                },\n                toConnectCallOptions(options),\n            ),\n        );\n    }\n\n    /**\n     * Exchanges a signed SIWE message for an authenticated session token and account identity returned by the auth API.\n     */\n    protected async loginWithWallet(\n        input: LoginWithWalletInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<LoginWithWalletResponse> {\n        const validatedInput = parse(LoginWithWalletInputSchema, input);\n        const res = await this.#publicClient.loginWithWallet(\n            validatedInput,\n            toConnectCallOptions(options),\n        );\n        return parse(LoginWithWalletResponseSchema, res);\n    }\n}\n"],"mappings":";;;;;;;;;;;AA0BA,MAAa,mCAAmC,EAAE,aAAa;CAC3D,qBAAqB;CACrB,eAAe;CACf,KAAK;CACL,SAAS,EAAE,SAAS,CAAC,SAAS,mBAAmB,CAAC;AACtD,CAAC;;AAKD,MAAM,0BAA0B,EAAE,KAC9B,EAAE,OAAO,GACT,EAAE,MACE,6BACA,8DACJ,CACJ;AAEA,MAAa,6BAA6B,EAAE,aAAa;CACrD,qBAAqB;CACrB,SAAS;CACT,WAAW;CACX,WAAW,EAAE,SAAS,EAAE,OAAO,GAAG,EAAE;CACpC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAG,EAAE;CAC7B,gBAAgB,EAAE,SAAS,EAAE,OAAO,GAAG,EAAE;AAC7C,CAAC;AAID,MAAM,WAAW,EAAE,OAAO;CACtB,WAAW;CACX,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC;CAC/B,UAAU,EAAE,OAAO;CACnB,SAAS,EAAE,SAAS,oBAAoB;AAC5C,CAAC;AAID,MAAM,gCAAgC,EAAE,OAAO;CAC3C,aAAa,EAAE,OAAO;CACtB,WAAW,EAAE,SAAS,eAAe;CACrC,WAAW;CACX,UAAU,EAAE,OAAO;AACvB,CAAC;AAID,MAAM,wBAAwB,EAAE,OAAO;CACnC,SAAS;CACT,WAAW;AACf,CAAC;;;;AAOD,IAAa,cAAb,MAAyB;CACrB;CACA;CACA;CAEA,YAAY,YAAwC,UAA6B;EAC7E,KAAKA,gBAAgB,aAAaC,eAAmB,WAAW,SAAS;EACzE,KAAKC,cAAc,aAAaD,eAAmB,WAAW,OAAO;EACrE,KAAK,UAAU,IAAI,eAAe,YAAY,QAAQ;CAC1D;;;;CAKA,MAAM,GAAG,SAAgD;EACrD,MAAM,MAAM,MAAM,KAAKC,YAAY,GAAG,CAAC,GAAG,qBAAqB,OAAO,CAAC;EACvE,OAAO,MAAM,UAAU,GAAG;CAC9B;;;;;;;CAQA,MAAM,YAAY,SAAmD;EACjE,MAAM,KAAKA,YAAY,YAAY,CAAC,GAAG,qBAAqB,OAAO,CAAC;CACxE;;;;;CAMA,MAAM,sBACF,OACA,SACwB;EACxB,MAAM,YAAY,MAAM,kCAAkC,KAAK;EAC/D,IACI,UAAU,YAAY,uBACtB,UAAU,cAAc,YAAY,MAAM,UAAU,oBAAoB,YAAY,GAEpF,MAAM,IAAI,gBACN,mEACJ;EAEJ,OAAO,MACH,uBACA,MAAM,KAAKF,cAAc,sBACrB;GACI,GAAG;GACH,SACI,UAAU,YAAY,UAAA,IAAA;EAG9B,GACA,qBAAqB,OAAO,CAChC,CACJ;CACJ;;;;CAKA,MAAgB,gBACZ,OACA,SACgC;EAChC,MAAM,iBAAiB,MAAM,4BAA4B,KAAK;EAC9D,MAAM,MAAM,MAAM,KAAKA,cAAc,gBACjC,gBACA,qBAAqB,OAAO,CAChC;EACA,OAAO,MAAM,+BAA+B,GAAG;CACnD;AACJ"}
+{"version":3,"file":"auth.js","names":["#publicClient","Proto.AuthService","#authClient"],"sources":["../../../src/services/auth/auth.ts"],"sourcesContent":["import { createClient, type Client } from \"@connectrpc/connect\";\nimport * as Proto from \"../../gen/auth/v1/auth_pb.js\";\nimport * as v from \"valibot\";\nimport { parse } from \"../../shared/validation.js\";\nimport { ProfileService } from \"./profile/profile.js\";\nimport {\n    OptionalTimestampMsSchema,\n    PublicIdSchema,\n    TimestampSchema,\n} from \"../../shared/schemas.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterMutationOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport { MfaSessionInfoSchema } from \"../mfa/mfa.schemas.js\";\nimport type { PolyesterRealtime } from \"../../realtime/index.js\";\nimport type { AuthAndPublicApiTransports } from \"../../shared/transports.js\";\n\nimport {\n    WalletAddressSchema,\n    WalletChallengeUriSchema,\n    WalletChallengeMessageSchema,\n} from \"./wallet-challenge.schemas.js\";\n\nexport const CreateWalletChallengeInputSchema = v.strictObject({\n    smartAccountAddress: WalletAddressSchema,\n    signerAddress: WalletAddressSchema,\n    uri: WalletChallengeUriSchema,\n});\nexport type CreateWalletChallengeInput = v.InferInput<typeof CreateWalletChallengeInputSchema>;\n\n/** An EIP-191 EOA signature: 65 hexadecimal bytes, with an optional 0x prefix. */\nconst LoginEoaSignatureSchema = v.pipe(\n    v.string(),\n    v.regex(\n        /^(?:0x)?[0-9a-fA-F]{130}$/,\n        \"Login signature must be a 65-byte hexadecimal EOA signature.\",\n    ),\n);\n\nexport const LoginWithWalletInputSchema = v.strictObject({\n    smartAccountAddress: WalletAddressSchema,\n    message: WalletChallengeMessageSchema,\n    signature: LoginEoaSignatureSchema,\n    userAgent: v.optional(v.string(), \"\"),\n    ip: v.optional(v.string(), \"\"),\n    walletProvider: v.optional(v.string(), \"\"),\n});\n\nexport type LoginWithWalletInput = v.InferInput<typeof LoginWithWalletInputSchema>;\n\nconst MeSchema = v.object({\n    accountId: PublicIdSchema,\n    apiKeyId: v.optional(v.string()),\n    username: v.string(),\n    session: v.optional(MfaSessionInfoSchema),\n});\n\nexport type Me = v.InferOutput<typeof MeSchema>;\n\nconst LoginWithWalletResponseSchema = v.object({\n    accessToken: v.string(),\n    expiresAt: v.optional(TimestampSchema),\n    accountId: PublicIdSchema,\n    username: v.string(),\n});\n\nexport type LoginWithWalletResponse = v.InferOutput<typeof LoginWithWalletResponseSchema>;\n\nconst WalletChallengeSchema = v.object({\n    message: WalletChallengeMessageSchema,\n    expiresAt: OptionalTimestampMsSchema,\n});\n\nexport type WalletChallenge = v.InferOutput<typeof WalletChallengeSchema>;\n\n/**\n * Handles wallet-based authentication, caller introspection, and authenticated profile operations.\n */\nexport class AuthService {\n    #publicClient: Client<typeof Proto.AuthService>;\n    #authClient: Client<typeof Proto.AuthService>;\n    profile: ProfileService;\n\n    constructor(transports: AuthAndPublicApiTransports, realtime: PolyesterRealtime) {\n        this.#publicClient = createClient(Proto.AuthService, transports.publicApi);\n        this.#authClient = createClient(Proto.AuthService, transports.authApi);\n        this.profile = new ProfileService(transports, realtime);\n    }\n\n    /**\n     * Returns the authenticated caller's account context, including account ID, optional API key ID, username, and session assurance details from the presented token or API key.\n     */\n    async me(options?: PolyesterRequestOptions): Promise<Me> {\n        const res = await this.#authClient.me({}, toConnectCallOptions(options));\n        return parse(MeSchema, res);\n    }\n\n    /**\n     * Records explicit consent to the current terms for the caller's root account.\n     * Call only after the user consents. Requires an interactive JWT session;\n     * API keys are not allowed. Repeated acceptance succeeds without changing\n     * the first acceptance time. No MFA is required.\n     */\n    async acceptTerms(options?: PolyesterMutationOptions): Promise<void> {\n        await this.#authClient.acceptTerms({}, toConnectCallOptions(options));\n    }\n\n    /**\n     * Requests a server-issued SIWE login message. Sign its exact UTF-8 bytes with\n     * personal_sign; do not hash or reconstruct it. Expiry is epoch milliseconds.\n     * Subaccount creation uses `subaccounts.createChallenge` instead.\n     */\n    async createWalletChallenge(\n        input: CreateWalletChallengeInput,\n        options?: PolyesterRequestOptions,\n    ): Promise<WalletChallenge> {\n        const validated = parse(CreateWalletChallengeInputSchema, input);\n        return parse(\n            WalletChallengeSchema,\n            await this.#publicClient.createWalletChallenge(\n                { ...validated, purpose: Proto.WalletChallengePurpose.LOGIN },\n                toConnectCallOptions(options),\n            ),\n        );\n    }\n\n    /**\n     * Exchanges a signed SIWE message for an authenticated session token and account identity returned by the auth API.\n     */\n    protected async loginWithWallet(\n        input: LoginWithWalletInput,\n        options?: PolyesterMutationOptions,\n    ): Promise<LoginWithWalletResponse> {\n        const validatedInput = parse(LoginWithWalletInputSchema, input);\n        const res = await this.#publicClient.loginWithWallet(\n            validatedInput,\n            toConnectCallOptions(options),\n        );\n        return parse(LoginWithWalletResponseSchema, res);\n    }\n}\n"],"mappings":";;;;;;;;;;AAyBA,MAAa,mCAAmC,EAAE,aAAa;CAC3D,qBAAqB;CACrB,eAAe;CACf,KAAK;AACT,CAAC;;AAID,MAAM,0BAA0B,EAAE,KAC9B,EAAE,OAAO,GACT,EAAE,MACE,6BACA,8DACJ,CACJ;AAEA,MAAa,6BAA6B,EAAE,aAAa;CACrD,qBAAqB;CACrB,SAAS;CACT,WAAW;CACX,WAAW,EAAE,SAAS,EAAE,OAAO,GAAG,EAAE;CACpC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAG,EAAE;CAC7B,gBAAgB,EAAE,SAAS,EAAE,OAAO,GAAG,EAAE;AAC7C,CAAC;AAID,MAAM,WAAW,EAAE,OAAO;CACtB,WAAW;CACX,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC;CAC/B,UAAU,EAAE,OAAO;CACnB,SAAS,EAAE,SAAS,oBAAoB;AAC5C,CAAC;AAID,MAAM,gCAAgC,EAAE,OAAO;CAC3C,aAAa,EAAE,OAAO;CACtB,WAAW,EAAE,SAAS,eAAe;CACrC,WAAW;CACX,UAAU,EAAE,OAAO;AACvB,CAAC;AAID,MAAM,wBAAwB,EAAE,OAAO;CACnC,SAAS;CACT,WAAW;AACf,CAAC;;;;AAOD,IAAa,cAAb,MAAyB;CACrB;CACA;CACA;CAEA,YAAY,YAAwC,UAA6B;EAC7E,KAAKA,gBAAgB,aAAaC,eAAmB,WAAW,SAAS;EACzE,KAAKC,cAAc,aAAaD,eAAmB,WAAW,OAAO;EACrE,KAAK,UAAU,IAAI,eAAe,YAAY,QAAQ;CAC1D;;;;CAKA,MAAM,GAAG,SAAgD;EACrD,MAAM,MAAM,MAAM,KAAKC,YAAY,GAAG,CAAC,GAAG,qBAAqB,OAAO,CAAC;EACvE,OAAO,MAAM,UAAU,GAAG;CAC9B;;;;;;;CAQA,MAAM,YAAY,SAAmD;EACjE,MAAM,KAAKA,YAAY,YAAY,CAAC,GAAG,qBAAqB,OAAO,CAAC;CACxE;;;;;;CAOA,MAAM,sBACF,OACA,SACwB;EACxB,MAAM,YAAY,MAAM,kCAAkC,KAAK;EAC/D,OAAO,MACH,uBACA,MAAM,KAAKF,cAAc,sBACrB;GAAE,GAAG;GAAW,SAAA;EAA4C,GAC5D,qBAAqB,OAAO,CAChC,CACJ;CACJ;;;;CAKA,MAAgB,gBACZ,OACA,SACgC;EAChC,MAAM,iBAAiB,MAAM,4BAA4B,KAAK;EAC9D,MAAM,MAAM,MAAM,KAAKA,cAAc,gBACjC,gBACA,qBAAqB,OAAO,CAChC;EACA,OAAO,MAAM,+BAA+B,GAAG;CACnD;AACJ"}

package/dist/services/auth/auth.types.d.ts

@@ -1,3 +1,3 @@
-import { CreateWalletChallengeInput, LoginWithWalletInput, LoginWithWalletResponse, Me, WalletChallenge, WalletChallengePurpose } from "./auth.js";
+import { CreateWalletChallengeInput, LoginWithWalletInput, LoginWithWalletResponse, Me, WalletChallenge } from "./auth.js";
 import { AccountSignerAuthEvents, CreateSubaccountParams, CreateSubaccountResult, LoginOptions, LoginResult } from "./account-signer-auth.js";
-export type { AccountSignerAuthEvents, CreateSubaccountResult as AccountSignerCreateSubaccountResult, CreateSubaccountParams, CreateWalletChallengeInput, LoginOptions, LoginResult, LoginWithWalletInput, LoginWithWalletResponse, Me, WalletChallenge, WalletChallengePurpose };
+export type { AccountSignerAuthEvents, CreateSubaccountResult as AccountSignerCreateSubaccountResult, CreateSubaccountParams, CreateWalletChallengeInput, LoginOptions, LoginResult, LoginWithWalletInput, LoginWithWalletResponse, Me, WalletChallenge };

package/dist/services/claims/claims.js

@@ -1,6 +1,6 @@
+import { ClaimsService as ClaimsService$1 } from "../../gen/claims/v1/claims_pb.js";
 import { parse } from "../../shared/validation.js";
 import { toConnectCallOptions } from "../../shared/request-options.js";
-import { ClaimsService as ClaimsService$1 } from "../../gen/claims/v1/claims_pb.js";
 import { ClaimDailyRewardResultSchema, DailyClaimStatusSchema } from "./claims.schemas.js";
 import { createClient } from "@connectrpc/connect";
 //#region src/services/claims/claims.ts

package/dist/services/heatmap/heatmap.schemas.d.ts

@@ -14,7 +14,7 @@ type TimestampInit = {
 declare const GetOrderbookHeatmapInputSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly symbolId: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.GtValueAction<number, 0, undefined>, v.MaxValueAction<number, 4294967295, undefined>]>;
   readonly interval: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<readonly ["1s", "1m", "5m", "1h"], undefined>, "1s">, v.TransformAction<"1h" | "1m" | "1s" | "5m", HeatmapInterval>]>;
-  readonly depth: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<readonly [1, 5, 10, 20, 50, 100, 200, 500, 1000], undefined>, 50>, v.TransformAction<1 | 10 | 5 | 20 | 200 | 500 | 100 | 1000 | 50, HeatmapDepth>]>;
+  readonly depth: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<readonly [1, 5, 10, 20, 50, 100, 200, 500, 1000], undefined>, 50>, v.TransformAction<1 | 10 | 5 | 20 | 200 | 500 | 1000 | 100 | 50, HeatmapDepth>]>;
   readonly quantityMode: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<readonly ["close", "peak"], undefined>, "close">, v.TransformAction<"close" | "peak", HeatmapQuantityMode>]>;
   readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.GtValueAction<number, 0, undefined>, v.MaxValueAction<number, 20000, undefined>]>;
   readonly startTsSec: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, number, undefined>, v.TransformAction<number, bigint>]>, undefined>;
@@ -227,7 +227,7 @@ type OrderbookHeatmapDeltaChain = ReturnType<typeof convertHeatmapDeltaChain>;
 declare function createOrderbookHeatmapResponseSchema(scales: SdkScales): v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly symbolId: v.NumberSchema<undefined>;
   readonly interval: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.TransformAction<number, DecodedEnum<"1h" | "1m" | "1s" | "5m">>]>;
-  readonly depth: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.TransformAction<number, 1 | "unspecified" | 10 | 5 | 20 | 200 | 500 | 100 | 1000 | 50>]>;
+  readonly depth: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.TransformAction<number, 1 | "unspecified" | 10 | 5 | 20 | 200 | 500 | 1000 | 100 | 50>]>;
   readonly chain: v.OptionalSchema<v.ObjectSchema<{
     readonly baseKeyframe: v.OptionalSchema<v.ObjectSchema<{
       readonly tsSec: v.SchemaWithPipe<readonly [v.BigintSchema<undefined>, v.TransformAction<bigint, number>]>;
@@ -287,7 +287,7 @@ declare function createOrderbookHeatmapResponseSchema(scales: SdkScales): v.Sche
 }, undefined>, v.TransformAction<{
   symbolId: number;
   interval: DecodedEnum<"1h" | "1m" | "1s" | "5m">;
-  depth: 1 | "unspecified" | 10 | 5 | 20 | 200 | 500 | 100 | 1000 | 50;
+  depth: 1 | "unspecified" | 10 | 5 | 20 | 200 | 500 | 1000 | 100 | 50;
   chain?: {
     baseKeyframe?: {
       tsSec: number;
@@ -347,7 +347,7 @@ declare function createOrderbookHeatmapResponseSchema(scales: SdkScales): v.Sche
 }, {
   symbolId: number;
   interval: DecodedEnum<"1h" | "1m" | "1s" | "5m">;
-  depth: 1 | "unspecified" | 10 | 5 | 20 | 200 | 500 | 100 | 1000 | 50;
+  depth: 1 | "unspecified" | 10 | 5 | 20 | 200 | 500 | 1000 | 100 | 50;
   chain: {
     baseKeyframe: {
       tsSec: number;

package/dist/services/orderbook/orderbook.schemas.d.ts

@@ -10,7 +10,7 @@ declare const GetOrderbookInputSchema: v.SchemaWithPipe<readonly [v.ObjectSchema
   depth: number;
 }, {
   symbolId: number;
-  depth: 1 | 10 | 5 | 20 | 200 | 500 | 100 | 1000 | 50;
+  depth: 1 | 10 | 5 | 20 | 200 | 500 | 1000 | 100 | 50;
   protoDepth: Depth;
 }>]>;
 type GetOrderbookInput = v.InferInput<typeof GetOrderbookInputSchema>;

package/dist/services/orders/orders-output.schemas.d.ts

@@ -19,6 +19,7 @@ declare function createOrderSchema(scales: SdkScales): v.SchemaWithPipe<readonly
   readonly postOnly: v.BooleanSchema<undefined>;
   readonly origQtyScaled: v.BigintSchema<undefined>;
   readonly cumQtyScaled: v.BigintSchema<undefined>;
+  readonly inheritedCumQtyScaled: v.OptionalSchema<v.BigintSchema<undefined>, 0n>;
   readonly leavesQtyScaled: v.BigintSchema<undefined>;
   readonly avgPriceTicks: v.BigintSchema<undefined>;
   readonly priceTicks: v.BigintSchema<undefined>;
@@ -132,6 +133,7 @@ declare function createOrderSchema(scales: SdkScales): v.SchemaWithPipe<readonly
   postOnly: boolean;
   origQtyScaled: bigint;
   cumQtyScaled: bigint;
+  inheritedCumQtyScaled: bigint;
   leavesQtyScaled: bigint;
   avgPriceTicks: bigint;
   priceTicks: bigint;
@@ -247,6 +249,7 @@ declare function createOrderSchema(scales: SdkScales): v.SchemaWithPipe<readonly
   postOnly: boolean;
   totalQty: string;
   cumQty: string;
+  inheritedCumQty: string;
   leavesQty: string;
   avgPx: string;
   price: string;
@@ -387,6 +390,7 @@ declare function createOrderDetailsSchema(scales: SdkScales): v.ObjectSchema<{
     readonly postOnly: v.BooleanSchema<undefined>;
     readonly origQtyScaled: v.BigintSchema<undefined>;
     readonly cumQtyScaled: v.BigintSchema<undefined>;
+    readonly inheritedCumQtyScaled: v.OptionalSchema<v.BigintSchema<undefined>, 0n>;
     readonly leavesQtyScaled: v.BigintSchema<undefined>;
     readonly avgPriceTicks: v.BigintSchema<undefined>;
     readonly priceTicks: v.BigintSchema<undefined>;
@@ -500,6 +504,7 @@ declare function createOrderDetailsSchema(scales: SdkScales): v.ObjectSchema<{
     postOnly: boolean;
     origQtyScaled: bigint;
     cumQtyScaled: bigint;
+    inheritedCumQtyScaled: bigint;
     leavesQtyScaled: bigint;
     avgPriceTicks: bigint;
     priceTicks: bigint;
@@ -615,6 +620,7 @@ declare function createOrderDetailsSchema(scales: SdkScales): v.ObjectSchema<{
     postOnly: boolean;
     totalQty: string;
     cumQty: string;
+    inheritedCumQty: string;
     leavesQty: string;
     avgPx: string;
     price: string;

package/dist/services/orders/orders-output.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orders-output.schemas.d.ts","names":[],"sources":["../../../src/services/orders/orders-output.schemas.ts"],"mappings":";;;;iBAoCgB,kBAAkB,QAAQ,YAAS,EAAA,yBAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAyGvC,QAAQ,EAAE,YAAY,kBAAkB;iBAEpC,6BAAyB,EAAA,yBAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmC7B,gBAAgB,EAAE,YAAY,kBAAkB;iBAE5C,yBAAyB,QAAQ,YAAS,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAS9C,eAAe,EAAE,YAAY,kBAAkB"}
+{"version":3,"file":"orders-output.schemas.d.ts","names":[],"sources":["../../../src/services/orders/orders-output.schemas.ts"],"mappings":";;;;iBAoCgB,kBAAkB,QAAQ,YAAS,EAAA,yBAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2GvC,QAAQ,EAAE,YAAY,kBAAkB;iBAEpC,6BAAyB,EAAA,yBAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmC7B,gBAAgB,EAAE,YAAY,kBAAkB;iBAE5C,yBAAyB,QAAQ,YAAS,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAS9C,eAAe,EAAE,YAAY,kBAAkB"}

package/dist/services/orders/orders-output.schemas.js

@@ -35,6 +35,7 @@ function createOrderSchema(scales) {
 		postOnly: v.boolean(),
 		origQtyScaled: v.bigint(),
 		cumQtyScaled: v.bigint(),
+		inheritedCumQtyScaled: v.optional(v.bigint(), 0n),
 		leavesQtyScaled: v.bigint(),
 		avgPriceTicks: v.bigint(),
 		priceTicks: v.bigint(),
@@ -70,6 +71,7 @@ function createOrderSchema(scales) {
 			postOnly: o.postOnly,
 			totalQty: scaledToDecimalOutput(o.origQtyScaled, baseQtyScale),
 			cumQty: scaledToDecimalOutput(o.cumQtyScaled, baseQtyScale),
+			inheritedCumQty: scaledToDecimalOutput(o.inheritedCumQtyScaled, baseQtyScale),
 			leavesQty: scaledToDecimalOutput(o.leavesQtyScaled, baseQtyScale),
 			avgPx: scaledToDecimalOutput(o.avgPriceTicks, scales.price()),
 			price: scaledToDecimalOutput(o.priceTicks, scales.price()),

package/dist/services/orders/orders-output.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"orders-output.schemas.js","names":[],"sources":["../../../src/services/orders/orders-output.schemas.ts"],"sourcesContent":["import { OrderLineageSchema } from \"./order-lineage.schemas.js\";\nimport * as v from \"valibot\";\nimport { tsNsToMs } from \"../../utils/time.js\";\nimport { formatId } from \"../../utils/base58-id.js\";\nimport { OptionalPublicIdSchema, OptionalTimestampMsSchema } from \"../../shared/schemas.js\";\nimport { enumLabel, enumLabelSchema } from \"../../shared/proto-enum-codec.js\";\nimport { E18_SCALE, scaledToDecimalOutput, type SdkScales } from \"../../shared/decimal-surface.js\";\nimport { createUserTradeSchema } from \"../trades/trades.schemas.js\";\nimport { fromU128 } from \"../../utils/u128.js\";\nimport { AccountCodeCodec, TransferCodeCodec } from \"../../shared/ledger-codes.js\";\nimport {\n    FeeAssetCodec,\n    OrderOriginScopeCodec,\n    OrderSideCodec,\n    OrderStatusCodec,\n    OrderTriggerTypeCodec,\n    OrderTypeCodec,\n    SelfTradePreventionModeCodec,\n    TimeInForceCodec,\n} from \"./orders.codecs.js\";\nimport {\n    ReadAttachedRiskSchema,\n    formatAttachedRisk,\n    formatMarketMaxSlippage,\n} from \"./orders-risk.schemas.js\";\n\nconst OrderStatusOutputSchema = enumLabelSchema(OrderStatusCodec.protoToOutput);\n\nconst ReadOrderOriginSchema = v.object({\n    scope: enumLabelSchema(OrderOriginScopeCodec.protoToOutput),\n    triggerType: enumLabelSchema(OrderTriggerTypeCodec.protoToOutput),\n    triggerId: OptionalPublicIdSchema,\n    parentOrderId: OptionalPublicIdSchema,\n    childSeq: v.number(),\n});\n\nexport function createOrderSchema(scales: SdkScales) {\n    return v.pipe(\n        v.object({\n            orderId: v.bigint(),\n            lineage: v.optional(OrderLineageSchema),\n            symbolId: v.number(),\n            clientOrderId: v.string(),\n            side: v.number(),\n            status: OrderStatusOutputSchema,\n            orderType: v.number(),\n            timeInForce: v.number(),\n            selfTradePreventionMode: v.number(),\n            feeAsset: v.number(),\n            postOnly: v.boolean(),\n            origQtyScaled: v.bigint(),\n            cumQtyScaled: v.bigint(),\n            leavesQtyScaled: v.bigint(),\n            avgPriceTicks: v.bigint(),\n            priceTicks: v.bigint(),\n            createdTsNs: v.bigint(),\n            terminalTsNs: v.bigint(),\n            terminalReason: v.optional(v.string(), \"\"),\n            terminalReasonCode: v.number(),\n            attachedRisk: v.optional(ReadAttachedRiskSchema),\n            origin: v.optional(ReadOrderOriginSchema),\n            marketClientRefPriceTicks: v.bigint(),\n            marketMaxSlippageTicks: v.number(),\n            marketMaxSlippageBps: v.number(),\n            version: v.pipe(v.number(), v.integer(), v.minValue(0)),\n            batchRequestId: v.bigint(),\n            submittedMaxQuoteDebitScaled: v.optional(v.bigint()),\n            expireAt: OptionalTimestampMsSchema,\n        }),\n        v.transform((o) => {\n            const isPartial = o.status === \"working\" && o.cumQtyScaled > 0n;\n            const baseQtyScale = scales.baseQty(o.symbolId);\n            const marketClientRefPrice =\n                o.marketClientRefPriceTicks > 0n\n                    ? scaledToDecimalOutput(o.marketClientRefPriceTicks, scales.price())\n                    : undefined;\n            const marketMaxSlippage = formatMarketMaxSlippage(\n                scales,\n                o.marketMaxSlippageTicks,\n                o.marketMaxSlippageBps,\n            );\n            return {\n                orderId: formatId(o.orderId),\n                ...(o.lineage === undefined ? {} : { lineage: o.lineage }),\n                symbolId: o.symbolId,\n                clientOrderId: o.clientOrderId,\n                status: isPartial ? (\"partial\" as const) : o.status,\n                side: enumLabel(OrderSideCodec.protoToOutput, o.side),\n                orderType: enumLabel(OrderTypeCodec.protoToOutput, o.orderType),\n                timeInForce: enumLabel(TimeInForceCodec.protoToOutput, o.timeInForce),\n                selfTradePreventionMode: enumLabel(\n                    SelfTradePreventionModeCodec.protoToOutput,\n                    o.selfTradePreventionMode,\n                ),\n                feeAsset: enumLabel(FeeAssetCodec.protoToOutput, o.feeAsset),\n                postOnly: o.postOnly,\n                totalQty: scaledToDecimalOutput(o.origQtyScaled, baseQtyScale),\n                cumQty: scaledToDecimalOutput(o.cumQtyScaled, baseQtyScale),\n                leavesQty: scaledToDecimalOutput(o.leavesQtyScaled, baseQtyScale),\n                avgPx: scaledToDecimalOutput(o.avgPriceTicks, scales.price()),\n                price: scaledToDecimalOutput(o.priceTicks, scales.price()),\n                createdTs: tsNsToMs(o.createdTsNs),\n                terminalTs: tsNsToMs(o.terminalTsNs),\n                terminalReason: humanizeTerminalReason(o.terminalReason),\n                terminalReasonCode: o.terminalReasonCode,\n                attachedRisk: formatAttachedRisk(scales, o.attachedRisk),\n                ...(o.origin ? { origin: o.origin } : {}),\n                ...(marketClientRefPrice ? { marketClientRefPrice } : {}),\n                ...(marketMaxSlippage ? { marketMaxSlippage } : {}),\n                ...(o.batchRequestId > 0n ? { batchRequestId: formatId(o.batchRequestId) } : {}),\n                ...(o.submittedMaxQuoteDebitScaled === undefined\n                    ? {}\n                    : {\n                          submittedMaxQuoteDebit: scaledToDecimalOutput(\n                              o.submittedMaxQuoteDebitScaled,\n                              scales.quoteAmount(o.symbolId),\n                          ),\n                      }),\n                ...(o.expireAt === undefined ? {} : { expireAt: o.expireAt }),\n                version: o.version,\n            };\n        }),\n    );\n}\n\nfunction humanizeTerminalReason(raw: string | null | undefined): string {\n    const key = (raw ?? \"\").trim();\n    if (!key) return \"\";\n    const uppercaseAcronyms = [\"GTC\", \"IOC\", \"FOK\", \"DAY\", \"GTD\", \"STP\"];\n    return key\n        .split(\"_\")\n        .filter(Boolean)\n        .map((part) => {\n            const upper = part.toUpperCase();\n            if (uppercaseAcronyms.includes(upper)) return upper;\n            return upper[0] ? upper[0] + upper.slice(1).toLowerCase() : \"\";\n        })\n        .filter(Boolean)\n        .join(\" \");\n}\n\nexport type Order = v.InferOutput<ReturnType<typeof createOrderSchema>>;\n\nexport function createOrderTransferSchema() {\n    return v.pipe(\n        v.object({\n            txId: v.string(),\n            matchId: v.pipe(\n                v.bigint(),\n                v.transform((value) => value.toString()),\n            ),\n            symbolId: v.number(),\n            assetId: v.number(),\n            amountE18: v.optional(\n                v.object({\n                    hi: v.bigint(),\n                    lo: v.bigint(),\n                }),\n            ),\n            isDebit: v.boolean(),\n            transferCode: v.number(),\n            accountCode: v.number(),\n            tsNs: v.bigint(),\n        }),\n        v.transform((tr) => ({\n            txId: tr.txId,\n            matchId: tr.matchId,\n            symbolId: tr.symbolId,\n            assetId: tr.assetId,\n            isDebit: tr.isDebit,\n            timestamp: tsNsToMs(tr.tsNs),\n            amount: scaledToDecimalOutput(fromU128(tr.amountE18), E18_SCALE),\n            type: enumLabel(TransferCodeCodec.protoToOutput, tr.transferCode),\n            accountCode: enumLabel(AccountCodeCodec.protoToOutput, tr.accountCode),\n        })),\n    );\n}\n\nexport type OrderTransfer = v.InferOutput<ReturnType<typeof createOrderTransferSchema>>;\n\nexport function createOrderDetailsSchema(scales: SdkScales) {\n    return v.object({\n        nextPageToken: v.optional(v.string(), \"\"),\n        order: createOrderSchema(scales),\n        trades: v.optional(v.array(createUserTradeSchema(scales)), []),\n        transfers: v.optional(v.array(createOrderTransferSchema()), []),\n    });\n}\n\nexport type OrderDetails = v.InferOutput<ReturnType<typeof createOrderDetailsSchema>>;\n"],"mappings":"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"}
+{"version":3,"file":"orders-output.schemas.js","names":[],"sources":["../../../src/services/orders/orders-output.schemas.ts"],"sourcesContent":["import { OrderLineageSchema } from \"./order-lineage.schemas.js\";\nimport * as v from \"valibot\";\nimport { tsNsToMs } from \"../../utils/time.js\";\nimport { formatId } from \"../../utils/base58-id.js\";\nimport { OptionalPublicIdSchema, OptionalTimestampMsSchema } from \"../../shared/schemas.js\";\nimport { enumLabel, enumLabelSchema } from \"../../shared/proto-enum-codec.js\";\nimport { E18_SCALE, scaledToDecimalOutput, type SdkScales } from \"../../shared/decimal-surface.js\";\nimport { createUserTradeSchema } from \"../trades/trades.schemas.js\";\nimport { fromU128 } from \"../../utils/u128.js\";\nimport { AccountCodeCodec, TransferCodeCodec } from \"../../shared/ledger-codes.js\";\nimport {\n    FeeAssetCodec,\n    OrderOriginScopeCodec,\n    OrderSideCodec,\n    OrderStatusCodec,\n    OrderTriggerTypeCodec,\n    OrderTypeCodec,\n    SelfTradePreventionModeCodec,\n    TimeInForceCodec,\n} from \"./orders.codecs.js\";\nimport {\n    ReadAttachedRiskSchema,\n    formatAttachedRisk,\n    formatMarketMaxSlippage,\n} from \"./orders-risk.schemas.js\";\n\nconst OrderStatusOutputSchema = enumLabelSchema(OrderStatusCodec.protoToOutput);\n\nconst ReadOrderOriginSchema = v.object({\n    scope: enumLabelSchema(OrderOriginScopeCodec.protoToOutput),\n    triggerType: enumLabelSchema(OrderTriggerTypeCodec.protoToOutput),\n    triggerId: OptionalPublicIdSchema,\n    parentOrderId: OptionalPublicIdSchema,\n    childSeq: v.number(),\n});\n\nexport function createOrderSchema(scales: SdkScales) {\n    return v.pipe(\n        v.object({\n            orderId: v.bigint(),\n            lineage: v.optional(OrderLineageSchema),\n            symbolId: v.number(),\n            clientOrderId: v.string(),\n            side: v.number(),\n            status: OrderStatusOutputSchema,\n            orderType: v.number(),\n            timeInForce: v.number(),\n            selfTradePreventionMode: v.number(),\n            feeAsset: v.number(),\n            postOnly: v.boolean(),\n            origQtyScaled: v.bigint(),\n            cumQtyScaled: v.bigint(),\n            inheritedCumQtyScaled: v.optional(v.bigint(), 0n),\n            leavesQtyScaled: v.bigint(),\n            avgPriceTicks: v.bigint(),\n            priceTicks: v.bigint(),\n            createdTsNs: v.bigint(),\n            terminalTsNs: v.bigint(),\n            terminalReason: v.optional(v.string(), \"\"),\n            terminalReasonCode: v.number(),\n            attachedRisk: v.optional(ReadAttachedRiskSchema),\n            origin: v.optional(ReadOrderOriginSchema),\n            marketClientRefPriceTicks: v.bigint(),\n            marketMaxSlippageTicks: v.number(),\n            marketMaxSlippageBps: v.number(),\n            version: v.pipe(v.number(), v.integer(), v.minValue(0)),\n            batchRequestId: v.bigint(),\n            submittedMaxQuoteDebitScaled: v.optional(v.bigint()),\n            expireAt: OptionalTimestampMsSchema,\n        }),\n        v.transform((o) => {\n            const isPartial = o.status === \"working\" && o.cumQtyScaled > 0n;\n            const baseQtyScale = scales.baseQty(o.symbolId);\n            const marketClientRefPrice =\n                o.marketClientRefPriceTicks > 0n\n                    ? scaledToDecimalOutput(o.marketClientRefPriceTicks, scales.price())\n                    : undefined;\n            const marketMaxSlippage = formatMarketMaxSlippage(\n                scales,\n                o.marketMaxSlippageTicks,\n                o.marketMaxSlippageBps,\n            );\n            return {\n                orderId: formatId(o.orderId),\n                ...(o.lineage === undefined ? {} : { lineage: o.lineage }),\n                symbolId: o.symbolId,\n                clientOrderId: o.clientOrderId,\n                status: isPartial ? (\"partial\" as const) : o.status,\n                side: enumLabel(OrderSideCodec.protoToOutput, o.side),\n                orderType: enumLabel(OrderTypeCodec.protoToOutput, o.orderType),\n                timeInForce: enumLabel(TimeInForceCodec.protoToOutput, o.timeInForce),\n                selfTradePreventionMode: enumLabel(\n                    SelfTradePreventionModeCodec.protoToOutput,\n                    o.selfTradePreventionMode,\n                ),\n                feeAsset: enumLabel(FeeAssetCodec.protoToOutput, o.feeAsset),\n                postOnly: o.postOnly,\n                totalQty: scaledToDecimalOutput(o.origQtyScaled, baseQtyScale),\n                cumQty: scaledToDecimalOutput(o.cumQtyScaled, baseQtyScale),\n                inheritedCumQty: scaledToDecimalOutput(o.inheritedCumQtyScaled, baseQtyScale),\n                leavesQty: scaledToDecimalOutput(o.leavesQtyScaled, baseQtyScale),\n                avgPx: scaledToDecimalOutput(o.avgPriceTicks, scales.price()),\n                price: scaledToDecimalOutput(o.priceTicks, scales.price()),\n                createdTs: tsNsToMs(o.createdTsNs),\n                terminalTs: tsNsToMs(o.terminalTsNs),\n                terminalReason: humanizeTerminalReason(o.terminalReason),\n                terminalReasonCode: o.terminalReasonCode,\n                attachedRisk: formatAttachedRisk(scales, o.attachedRisk),\n                ...(o.origin ? { origin: o.origin } : {}),\n                ...(marketClientRefPrice ? { marketClientRefPrice } : {}),\n                ...(marketMaxSlippage ? { marketMaxSlippage } : {}),\n                ...(o.batchRequestId > 0n ? { batchRequestId: formatId(o.batchRequestId) } : {}),\n                ...(o.submittedMaxQuoteDebitScaled === undefined\n                    ? {}\n                    : {\n                          submittedMaxQuoteDebit: scaledToDecimalOutput(\n                              o.submittedMaxQuoteDebitScaled,\n                              scales.quoteAmount(o.symbolId),\n                          ),\n                      }),\n                ...(o.expireAt === undefined ? {} : { expireAt: o.expireAt }),\n                version: o.version,\n            };\n        }),\n    );\n}\n\nfunction humanizeTerminalReason(raw: string | null | undefined): string {\n    const key = (raw ?? \"\").trim();\n    if (!key) return \"\";\n    const uppercaseAcronyms = [\"GTC\", \"IOC\", \"FOK\", \"DAY\", \"GTD\", \"STP\"];\n    return key\n        .split(\"_\")\n        .filter(Boolean)\n        .map((part) => {\n            const upper = part.toUpperCase();\n            if (uppercaseAcronyms.includes(upper)) return upper;\n            return upper[0] ? upper[0] + upper.slice(1).toLowerCase() : \"\";\n        })\n        .filter(Boolean)\n        .join(\" \");\n}\n\nexport type Order = v.InferOutput<ReturnType<typeof createOrderSchema>>;\n\nexport function createOrderTransferSchema() {\n    return v.pipe(\n        v.object({\n            txId: v.string(),\n            matchId: v.pipe(\n                v.bigint(),\n                v.transform((value) => value.toString()),\n            ),\n            symbolId: v.number(),\n            assetId: v.number(),\n            amountE18: v.optional(\n                v.object({\n                    hi: v.bigint(),\n                    lo: v.bigint(),\n                }),\n            ),\n            isDebit: v.boolean(),\n            transferCode: v.number(),\n            accountCode: v.number(),\n            tsNs: v.bigint(),\n        }),\n        v.transform((tr) => ({\n            txId: tr.txId,\n            matchId: tr.matchId,\n            symbolId: tr.symbolId,\n            assetId: tr.assetId,\n            isDebit: tr.isDebit,\n            timestamp: tsNsToMs(tr.tsNs),\n            amount: scaledToDecimalOutput(fromU128(tr.amountE18), E18_SCALE),\n            type: enumLabel(TransferCodeCodec.protoToOutput, tr.transferCode),\n            accountCode: enumLabel(AccountCodeCodec.protoToOutput, tr.accountCode),\n        })),\n    );\n}\n\nexport type OrderTransfer = v.InferOutput<ReturnType<typeof createOrderTransferSchema>>;\n\nexport function createOrderDetailsSchema(scales: SdkScales) {\n    return v.object({\n        nextPageToken: v.optional(v.string(), \"\"),\n        order: createOrderSchema(scales),\n        trades: v.optional(v.array(createUserTradeSchema(scales)), []),\n        transfers: v.optional(v.array(createOrderTransferSchema()), []),\n    });\n}\n\nexport type OrderDetails = v.InferOutput<ReturnType<typeof createOrderDetailsSchema>>;\n"],"mappings":"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"}

package/dist/services/subaccounts/index.d.ts

@@ -1,3 +1,3 @@
-import { CreateSubaccountInput, CreateSubaccountInputSchema, CreateSubaccountResult, CreateSubaccountResultSchema, EffectiveSubaccountPermissions, EffectiveSubaccountPermissionsSchema, InviteSubaccountMemberInput, InviteSubaccountMemberInputSchema, ListSubaccountInvitesInput, ListSubaccountInvitesInputSchema, RemoveSubaccountMemberInput, RemoveSubaccountMemberInputSchema, RespondSubaccountInviteInput, RespondSubaccountInviteInputSchema, SetSubaccountMemberMfaRequirementInput, SetSubaccountMemberMfaRequirementInputSchema, Subaccount, SubaccountActivityEventSchema, SubaccountActivityInput, SubaccountActivityInputSchema, SubaccountEvent, SubaccountIdInput, SubaccountIdInputSchema, SubaccountInvite, SubaccountInviteSchema, SubaccountInviteStatus, SubaccountMember, SubaccountMemberSchema, SubaccountMutationResult, SubaccountMutationResultSchema, SubaccountPermission, SubaccountPermissionDefinition, SubaccountPermissionDefinitionSchema, SubaccountRole, SubaccountRoleCatalog, SubaccountRoleCatalogSchema, SubaccountRoleDefinition, SubaccountRoleDefinitionSchema, SubaccountRoleSchema, SubaccountSchema, SubaccountStatus, UpdateSubaccountInput, UpdateSubaccountInputSchema, UpdateSubaccountMemberRoleInput, UpdateSubaccountMemberRoleInputSchema } from "./subaccounts.schemas.js";
+import { CreateSubaccountChallengeInput, CreateSubaccountChallengeInputSchema, CreateSubaccountInput, CreateSubaccountInputSchema, CreateSubaccountResult, CreateSubaccountResultSchema, EffectiveSubaccountPermissions, EffectiveSubaccountPermissionsSchema, InviteSubaccountMemberInput, InviteSubaccountMemberInputSchema, ListSubaccountInvitesInput, ListSubaccountInvitesInputSchema, RemoveSubaccountMemberInput, RemoveSubaccountMemberInputSchema, RespondSubaccountInviteInput, RespondSubaccountInviteInputSchema, SetSubaccountMemberMfaRequirementInput, SetSubaccountMemberMfaRequirementInputSchema, Subaccount, SubaccountActivityEventSchema, SubaccountActivityInput, SubaccountActivityInputSchema, SubaccountChallenge, SubaccountChallengeSchema, SubaccountEvent, SubaccountIdInput, SubaccountIdInputSchema, SubaccountInvite, SubaccountInviteSchema, SubaccountInviteStatus, SubaccountMember, SubaccountMemberSchema, SubaccountMutationResult, SubaccountMutationResultSchema, SubaccountPermission, SubaccountPermissionDefinition, SubaccountPermissionDefinitionSchema, SubaccountRole, SubaccountRoleCatalog, SubaccountRoleCatalogSchema, SubaccountRoleDefinition, SubaccountRoleDefinitionSchema, SubaccountRoleSchema, SubaccountSchema, SubaccountStatus, UpdateSubaccountInput, UpdateSubaccountInputSchema, UpdateSubaccountMemberRoleInput, UpdateSubaccountMemberRoleInputSchema } from "./subaccounts.schemas.js";
 import { SubaccountsService } from "./subaccounts.js";
-export { CreateSubaccountInput, CreateSubaccountInputSchema, CreateSubaccountResult, CreateSubaccountResultSchema, EffectiveSubaccountPermissions, EffectiveSubaccountPermissionsSchema, InviteSubaccountMemberInput, InviteSubaccountMemberInputSchema, ListSubaccountInvitesInput, ListSubaccountInvitesInputSchema, RemoveSubaccountMemberInput, RemoveSubaccountMemberInputSchema, RespondSubaccountInviteInput, RespondSubaccountInviteInputSchema, SetSubaccountMemberMfaRequirementInput, SetSubaccountMemberMfaRequirementInputSchema, Subaccount, SubaccountActivityEventSchema, SubaccountActivityInput, SubaccountActivityInputSchema, SubaccountEvent, SubaccountIdInput, SubaccountIdInputSchema, SubaccountInvite, SubaccountInviteSchema, SubaccountInviteStatus, SubaccountMember, SubaccountMemberSchema, SubaccountMutationResult, SubaccountMutationResultSchema, SubaccountPermission, SubaccountPermissionDefinition, SubaccountPermissionDefinitionSchema, SubaccountRole, SubaccountRoleCatalog, SubaccountRoleCatalogSchema, SubaccountRoleDefinition, SubaccountRoleDefinitionSchema, SubaccountRoleSchema, SubaccountSchema, SubaccountStatus, SubaccountsService, UpdateSubaccountInput, UpdateSubaccountInputSchema, UpdateSubaccountMemberRoleInput, UpdateSubaccountMemberRoleInputSchema };
+export { CreateSubaccountChallengeInput, CreateSubaccountChallengeInputSchema, CreateSubaccountInput, CreateSubaccountInputSchema, CreateSubaccountResult, CreateSubaccountResultSchema, EffectiveSubaccountPermissions, EffectiveSubaccountPermissionsSchema, InviteSubaccountMemberInput, InviteSubaccountMemberInputSchema, ListSubaccountInvitesInput, ListSubaccountInvitesInputSchema, RemoveSubaccountMemberInput, RemoveSubaccountMemberInputSchema, RespondSubaccountInviteInput, RespondSubaccountInviteInputSchema, SetSubaccountMemberMfaRequirementInput, SetSubaccountMemberMfaRequirementInputSchema, Subaccount, SubaccountActivityEventSchema, SubaccountActivityInput, SubaccountActivityInputSchema, SubaccountChallenge, SubaccountChallengeSchema, SubaccountEvent, SubaccountIdInput, SubaccountIdInputSchema, SubaccountInvite, SubaccountInviteSchema, SubaccountInviteStatus, SubaccountMember, SubaccountMemberSchema, SubaccountMutationResult, SubaccountMutationResultSchema, SubaccountPermission, SubaccountPermissionDefinition, SubaccountPermissionDefinitionSchema, SubaccountRole, SubaccountRoleCatalog, SubaccountRoleCatalogSchema, SubaccountRoleDefinition, SubaccountRoleDefinitionSchema, SubaccountRoleSchema, SubaccountSchema, SubaccountStatus, SubaccountsService, UpdateSubaccountInput, UpdateSubaccountInputSchema, UpdateSubaccountMemberRoleInput, UpdateSubaccountMemberRoleInputSchema };

package/dist/services/subaccounts/subaccounts.d.ts

@@ -9,7 +9,7 @@ import "../api-keys/index.js";
 import { SubaccountPolicy } from "../policies/subaccount-policies/subaccount-policies.schemas.js";
 import { SubaccountPoliciesService } from "../policies/subaccount-policies/subaccount-policies.js";
 import "../policies/subaccount-policies/index.js";
-import { CreateSubaccountInputSchema, CreateSubaccountResult, EffectiveSubaccountPermissions, InviteSubaccountMemberInputSchema, ListSubaccountInvitesInputSchema, RemoveSubaccountMemberInputSchema, RespondSubaccountInviteInputSchema, SetSubaccountMemberMfaRequirementInputSchema, Subaccount, SubaccountActivityInputSchema, SubaccountEvent, SubaccountIdInputSchema, SubaccountInvite, SubaccountMember, SubaccountMutationResult, SubaccountRoleCatalog, SubaccountSchema, UpdateSubaccountInputSchema, UpdateSubaccountMemberRoleInputSchema } from "./subaccounts.schemas.js";
+import { CreateSubaccountChallengeInputSchema, CreateSubaccountInputSchema, CreateSubaccountResult, EffectiveSubaccountPermissions, InviteSubaccountMemberInputSchema, ListSubaccountInvitesInputSchema, RemoveSubaccountMemberInputSchema, RespondSubaccountInviteInputSchema, SetSubaccountMemberMfaRequirementInputSchema, Subaccount, SubaccountActivityInputSchema, SubaccountChallenge, SubaccountEvent, SubaccountIdInputSchema, SubaccountInvite, SubaccountMember, SubaccountMutationResult, SubaccountRoleCatalog, SubaccountSchema, UpdateSubaccountInputSchema, UpdateSubaccountMemberRoleInputSchema } from "./subaccounts.schemas.js";
 import * as v from "valibot";
 //#region src/services/subaccounts/subaccounts.d.ts
 interface SubscribeSubaccountsInput extends BaseSubscribeInput<Subaccount> {
@@ -26,7 +26,7 @@ declare class SubaccountsService {
   readonly policies: SubaccountPoliciesService;
   constructor(transports: AuthAndPublicApiTransports, realtime: PolyesterRealtime, resolver?: SubaccountResolver);
   /**
-   * Returns subaccounts owned by or shared with the caller plus totalCreated, including soft-deleted count metadata useful for deriving future smart-account salts.
+   * Returns subaccounts owned by or shared with the caller plus totalCreated, including soft-deleted ones. Use `createChallenge` for the canonical next smart-account address and salt.
    */
   list(options?: PolyesterRequestOptions): Promise<{
     totalCreated: number;
@@ -42,7 +42,13 @@ declare class SubaccountsService {
     invites: SubaccountInvite[];
   }>;
   /**
-   * Creates a new subaccount under the caller's root account using a smart-account address, server-issued SIWE message, and signature proof.
+   * Requests the canonical next smart account and a short-lived EIP-191 authorization message
+   * bound to the authenticated root and the selected owner EOA. Sign the exact message through
+   * the returned smart account, then pass it to `create`. A new challenge replaces the previous one.
+   */
+  createChallenge(input: v.InferInput<typeof CreateSubaccountChallengeInputSchema>, options?: PolyesterRequestOptions): Promise<SubaccountChallenge>;
+  /**
+   * Creates a new subaccount under the caller's root account using the smart-account address, message, and smart-account signature from `createChallenge`.
    */
   create(input: v.InferInput<typeof CreateSubaccountInputSchema>, options?: PolyesterMutationOptions): Promise<CreateSubaccountResult>;
   /**