@rhinestone/sdk 2.0.0-beta.4 → 2.0.0-beta.41

package/dist/src/index.js

@@ -1,16 +1,16 @@
 import { checkAddress, deploy as deployInternal, FactoryArgsNotAvailableError, getAccountProvider, getAddress as getAddressInternal, getInitCode, isDeployed as isDeployedInternal, OwnersFieldRequiredError, setup as setupInternal, signEip7702InitData as signEip7702InitDataInternal, } from './accounts/index.js';
 import { createAuthProvider } from './auth/provider.js';
-import { getIntentStatus as getIntentStatusInternal, getPortfolio as getPortfolioInternal, sendUserOperation as sendUserOperationInternal, splitIntents as splitIntentsInternal, waitForExecution as waitForExecutionInternal, } from './execution/index.js';
-import { getTransactionMessages as getTransactionMessagesInternal, prepareTransaction as prepareTransactionInternal, prepareUserOperation as prepareUserOperationInternal, signAuthorizations as signAuthorizationsInternal, signMessage as signMessageInternal, signTransaction as signTransactionInternal, signTypedData as signTypedDataInternal, signUserOperation as signUserOperationInternal, submitTransaction as submitTransactionInternal, submitUserOperation as submitUserOperationInternal, } from './execution/utils.js';
+import { getAppFeeBalances as getAppFeeBalancesInternal, getIntentStatus as getIntentStatusInternal, getPortfolio as getPortfolioInternal, sendUserOperation as sendUserOperationInternal, splitIntents as splitIntentsInternal, waitForExecution as waitForExecutionInternal, } from './execution/index.js';
+import { assembleTransaction as assembleTransactionInternal, getTargetExecutionSignature as getTargetExecutionSignatureInternal, getTransactionMessages as getTransactionMessagesInternal, prepareTransaction as prepareTransactionInternal, prepareUserOperation as prepareUserOperationInternal, signAuthorizations as signAuthorizationsInternal, signIntent as signIntentInternal, signMessage as signMessageInternal, signTransaction as signTransactionInternal, signTypedData as signTypedDataInternal, signUserOperation as signUserOperationInternal, submitTransaction as submitTransactionInternal, submitUserOperation as submitUserOperationInternal, } from './execution/utils.js';
 import { getExecutors as getExecutorsInternal, getOwners as getOwnersInternal, getSessionDetails as getSessionDetailsInternal, getValidators as getValidatorsInternal, MULTI_FACTOR_VALIDATOR_ADDRESS, OWNABLE_VALIDATOR_ADDRESS, SMART_SESSION_EMISSARY_ADDRESS, signEnableSession as signEnableSessionInternal, WEBAUTHN_VALIDATOR_ADDRESS, } from './modules/index.js';
 import { isSessionEnabled as isSessionEnabledInternal, } from './modules/validators/smart-sessions.js';
+import { hyperCoreMainnet, solanaMainnet, tronMainnet } from './orchestrator/index.js';
 /**
- * Initialize a Rhinestone account
+ * Initialize a Rhinestone account from a fully-resolved config.
  * Note: accounts are deployed onchain only when the first transaction is sent.
- * @param config Account config (e.g. implementation vendor, owner signers, smart sessions)
- * @returns account
+ * @internal Use {@link RhinestoneSDK.createAccount} instead.
  */
-async function createRhinestoneAccount(config) {
+async function createAccountInternal(config) {
     // Sanity check for existing (externally created) accounts
     // Ensures we decode the initdata correctly
     checkAddress(config);
@@ -21,31 +21,17 @@ async function createRhinestoneAccount(config) {
     /**
      * Deploys the account on a given chain
      * @param chain Chain to deploy the account on
-     * @param session Session to deploy the account on (optional)
+     * @param params Optional deployment params (e.g. `sponsored`)
      */
     function deploy(chain, params) {
         return deployInternal(config, chain, params);
     }
-    /**
-     * Checks if the account is deployed on a given chain
-     * @param chain Chain to check if the account is deployed on
-     * @returns true if the account is deployed, false otherwise
-     */
     function isDeployed(chain) {
         return isDeployedInternal(config, chain);
     }
-    /**
-     * Sets up the existing account on a given chain
-     * by installing the missing modules (if any).
-     * @param chain Chain to set up the account on
-     */
     function setup(chain) {
         return setupInternal(config, chain);
     }
-    /**
-     * Get the account initialization data. Used for deploying the account onchain.
-     * @returns factory address and factory data
-     */
     function getInitData() {
         const initData = getInitCode(config);
         if (!initData) {
@@ -59,147 +45,80 @@ async function createRhinestoneAccount(config) {
             factoryData: initData.factoryData,
         };
     }
-    /**
-     * Prepare and sign the EIP-7702 account initialization data
-     * @returns init data signature
-     */
     function signEip7702InitData() {
         return signEip7702InitDataInternal(config);
     }
-    /**
-     * Prepare a transaction data
-     * @param transaction Transaction to prepare
-     * @returns prepared transaction data
-     */
     function prepareTransaction(transaction) {
         return prepareTransactionInternal(config, transaction);
     }
-    /**
-     * Get the transaction typed data message to sign
-     * @param preparedTransaction Prepared transaction data
-     * @param options Optional override; pass `{ intentId }` to inspect a specific quote from `preparedTransaction.quotes.all`
-     * @see {@link prepareTransaction} to prepare the transaction data for signing
-     */
     function getTransactionMessages(preparedTransaction, options) {
         return getTransactionMessagesInternal(config, preparedTransaction, options);
     }
-    /**
-     * Sign a transaction
-     * @param preparedTransaction Prepared transaction data
-     * @param options Optional override; pass `{ intentId }` to sign a specific quote from `preparedTransaction.quotes.all`
-     * @returns signed transaction data
-     * @see {@link prepareTransaction} to prepare the transaction data for signing
-     */
     function signTransaction(preparedTransaction, options) {
+        if (options && 'owner' in options) {
+            return signTransactionInternal(config, preparedTransaction, options);
+        }
         return signTransactionInternal(config, preparedTransaction, options);
     }
-    /**
-     * Sign the required EIP-7702 authorizations for a transaction
-     * @param preparedTransaction Prepared transaction data
-     * @returns signed authorizations
-     * @see {@link prepareTransaction} to prepare the transaction data for signing
-     */
+    function assembleTransaction(preparedTransaction, signatures) {
+        return assembleTransactionInternal(config, preparedTransaction, signatures);
+    }
     function signAuthorizations(preparedTransaction) {
         return signAuthorizationsInternal(config, preparedTransaction);
     }
-    /**
-     * Sign a message (EIP-191)
-     * @param message Message to sign
-     * @param chain Chain to sign the message on
-     * @param signers Signers to use for signing
-     * @returns signature
-     */
     function signMessage(message, chain, signers) {
         return signMessageInternal(config, message, chain, signers);
     }
-    /**
-     * Sign a typed data (EIP-712)
-     * @param parameters Typed data parameters
-     * @param chain Chain to sign the typed data on
-     * @param signers Signers to use for signing
-     * @returns signature
-     */
     function signTypedData(parameters, chain, signers) {
         return signTypedDataInternal(config, parameters, chain, signers);
     }
-    /**
-     * Submit a transaction
-     * @param signedTransaction Signed transaction data
-     * @param options Optional submission options
-     * @param options.authorizations EIP-7702 authorizations to submit
-     * @returns transaction result object (a UserOp hash)
-     * @see {@link signTransaction} to sign the transaction data
-     * @see {@link signAuthorizations} to sign the required EIP-7702 authorizations
-     */
+    async function signIntent(signData, targetChain, signers) {
+        const { originSignatures, destinationSignature } = await signIntentInternal(config, signData, targetChain, signers, false);
+        const targetExecutionSignature = await getTargetExecutionSignatureInternal(config, signData, targetChain, signers);
+        return {
+            originSignatures,
+            destinationSignature,
+            targetExecutionSignature,
+        };
+    }
     function submitTransaction(signedTransaction, options) {
         return submitTransactionInternal(config, signedTransaction, options?.authorizations ?? [], options?.internal_dryRun ?? false);
     }
-    /**
-     * Prepare a user operation data
-     * @param transaction User operation to prepare
-     * @returns prepared user operation data
-     */
     function prepareUserOperation(transaction) {
         return prepareUserOperationInternal(config, transaction);
     }
-    /**
-     * Sign a user operation
-     * @param preparedUserOperation Prepared user operation data
-     * @returns signed user operation data
-     * @see {@link prepareUserOperation} to prepare the user operation data for signing
-     */
     function signUserOperation(preparedUserOperation) {
         return signUserOperationInternal(config, preparedUserOperation);
     }
-    /**
-     * Submit a transaction
-     * @param signedTransaction Signed transaction data
-     * @returns transaction result object (a UserOp hash)
-     * @see {@link signUserOperation} to sign the user operation data
-     */
     function submitUserOperation(signedUserOperation) {
         return submitUserOperationInternal(config, signedUserOperation);
     }
-    /**
-     * Sign and send a user operation
-     * @param transaction User operation to send
-     * @returns user operation result object (a UserOp hash)
-     */
     function sendUserOperation(transaction) {
         return sendUserOperationInternal(config, transaction);
     }
     function waitForExecution(result) {
         return waitForExecutionInternal(config, result);
     }
-    /**
-     * Get account address
-     * @returns Address of the smart account
-     */
     function getAddress() {
         return getAddressInternal(config);
     }
-    /**
-     * Get account portfolio
-     * @param onTestnets Whether to query the testnet balances (default is `false`)
-     * @returns Account balances
-     */
     function getPortfolio(onTestnets = false) {
         return getPortfolioInternal(config, onTestnets);
     }
-    /**
-     * Get account owners (ECDSA)
-     * @param chain Chain to get the owners on
-     * @returns Account owners
-     */
     function getOwners(chain) {
+        const accountType = getAccountProvider(config).type;
         const account = getAddress();
-        return getOwnersInternal(account, chain, config.provider);
+        // For HCA, the module lives behind the factory (custom factories define
+        // their own). Resolve from the configured or initData factory so reads hit
+        // the right module.
+        const hcaFactory = config.account?.type === 'hca'
+            ? (config.account.factory ??
+                (config.initData && 'factory' in config.initData
+                    ? config.initData.factory
+                    : undefined))
+            : undefined;
+        return getOwnersInternal(accountType, account, chain, config.provider, hcaFactory);
     }
-    /**
-     * Get account validator modules
-     * @param chain Chain to get the validators on
-     * @returns List of account validators
-     */
     function getValidators(chain) {
         const accountType = getAccountProvider(config).type;
         const account = getAddress();
@@ -230,9 +149,11 @@ async function createRhinestoneAccount(config) {
         prepareTransaction,
         getTransactionMessages,
         signTransaction,
+        assembleTransaction,
         signAuthorizations,
         signMessage,
         signTypedData,
+        signIntent,
         submitTransaction,
         prepareUserOperation,
         signUserOperation,
@@ -250,6 +171,10 @@ async function createRhinestoneAccount(config) {
         getInitData,
     };
 }
+/**
+ * Stateful entry point that holds shared configuration (auth, provider, bundler,
+ * paymaster) and creates accounts from it.
+ */
 class RhinestoneSDK {
     authProvider;
     endpointUrl;
@@ -258,6 +183,10 @@ class RhinestoneSDK {
     paymaster;
     useDevContracts;
     headers;
+    /**
+     * Create a Rhinestone SDK instance.
+     * @param options Shared configuration applied to every account created by this instance
+     */
     constructor(options) {
         this.authProvider = createAuthProvider(options);
         this.endpointUrl = options.endpointUrl;
@@ -267,6 +196,26 @@ class RhinestoneSDK {
         this.useDevContracts = options.useDevContracts;
         this.headers = options.headers;
     }
+    /**
+     * Create an account using this instance's shared configuration.
+     * @param config Per-account configuration (owners, account type, modules, sessions)
+     * @returns The account instance
+     * @example
+     * ```ts
+     * import { RhinestoneSDK } from '@rhinestone/sdk'
+     * import { privateKeyToAccount } from 'viem/accounts'
+     *
+     * const owner = privateKeyToAccount('0x...')
+     *
+     * const sdk = new RhinestoneSDK({
+     *   auth: { mode: 'apiKey', apiKey: process.env.RHINESTONE_API_KEY! },
+     * })
+     *
+     * const account = await sdk.createAccount({
+     *   owners: { type: 'ecdsa', accounts: [owner] },
+     * })
+     * ```
+     */
     createAccount(config) {
         const rhinestoneConfig = {
             ...config,
@@ -278,15 +227,39 @@ class RhinestoneSDK {
             useDevContracts: this.useDevContracts,
             headers: this.headers,
         };
-        return createRhinestoneAccount(rhinestoneConfig);
+        return createAccountInternal(rhinestoneConfig);
     }
+    /**
+     * Get the current status of a submitted intent.
+     * @param intentId The intent ID returned when the transaction was submitted
+     * @returns The intent status
+     */
     getIntentStatus(intentId) {
         return getIntentStatusInternal(this.authProvider, this.endpointUrl, intentId, this.headers);
     }
+    /**
+     * Split a transaction into multiple intents across chains.
+     * @param input The intents to split
+     * @returns The split-intents result
+     */
     splitIntents(input) {
         return splitIntentsInternal(this.authProvider, this.endpointUrl, input, this.headers);
     }
+    /**
+     * Get the integrator's accrued app-fee balance, as USD totals.
+     *
+     * App fees are earned by the integrator identified by this instance's API key
+     * (project-scoped, not tied to any account) and valued in USD at the moment
+     * each fee is collected, so the balance is not affected by later price
+     * movements of the collected tokens.
+     * @returns The withdrawable and pending app-fee balances in USD
+     */
+    getAppFeeBalances() {
+        return getAppFeeBalancesInternal(this.authProvider, this.endpointUrl, this.headers);
+    }
 }
-export { RhinestoneSDK, createRhinestoneAccount, 
+export { RhinestoneSDK, 
+// Non-viem destination chain descriptors (Solana, Tron, HyperCore)
+hyperCoreMainnet, solanaMainnet, tronMainnet, 
 // Validator addresses
 OWNABLE_VALIDATOR_ADDRESS, WEBAUTHN_VALIDATOR_ADDRESS, MULTI_FACTOR_VALIDATOR_ADDRESS, SMART_SESSION_EMISSARY_ADDRESS, };

package/dist/src/jwt-server/jcs.d.ts

@@ -2,7 +2,7 @@
  * RFC 8785 JSON Canonicalization Scheme (JCS).
  *
  * Produces a deterministic JSON serialization by:
- * 1. Sorting object keys lexicographically (Unicode code-point order)
+ * 1. Sorting object keys lexicographically (UTF-16 code-unit order, per RFC 8785 §3.2.3)
  * 2. Using ES2015+ `JSON.stringify` number serialization (IEEE 754 → shortest round-trip)
  * 3. No whitespace
  *

package/dist/src/jwt-server/jcs.js

@@ -2,7 +2,7 @@
  * RFC 8785 JSON Canonicalization Scheme (JCS).
  *
  * Produces a deterministic JSON serialization by:
- * 1. Sorting object keys lexicographically (Unicode code-point order)
+ * 1. Sorting object keys lexicographically (UTF-16 code-unit order, per RFC 8785 §3.2.3)
  * 2. Using ES2015+ `JSON.stringify` number serialization (IEEE 754 → shortest round-trip)
  * 3. No whitespace
  *
@@ -43,7 +43,9 @@ function serialize(value) {
         const items = value.map((item) => serialize(item));
         return `[${items.join(',')}]`;
     }
-    // Object — sort keys by Unicode code-point order
+    // Object — sort keys by UTF-16 code-unit order (RFC 8785 §3.2.3).
+    // Native String comparison already orders by UTF-16 code unit, which is
+    // exactly what JCS mandates — do not replace with a code-point comparator.
     const obj = value;
     const keys = Object.keys(obj).sort();
     const members = [];

package/dist/src/modules/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,KAAK,EAAuB,MAAM,MAAM,CAAA;AAcpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAKhD,OAAO,EAQL,KAAK,WAAW,EAChB,KAAK,MAAM,EACZ,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AAC/D,OAAO,EACL,iBAAiB,EAEjB,8BAA8B,EAC9B,yBAAyB,EACzB,8BAA8B,EAC9B,0BAA0B,EAC3B,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACV,MAAM,6BAA6B,CAAA;AAKpC,iBAAS,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CA0EvD;AAED,iBAAS,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAY3D;AAED,iBAAS,yBAAyB,CAAC,KAAK,EAAE,KAAK,WAc9C;AAED,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,8BAA8B,EAC9B,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,GACV,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,KAAK,EAAuB,MAAM,MAAM,CAAA;AAcpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAKhD,OAAO,EAQL,KAAK,WAAW,EAChB,KAAK,MAAM,EACZ,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AAC/D,OAAO,EACL,iBAAiB,EAEjB,8BAA8B,EAC9B,yBAAyB,EACzB,8BAA8B,EAC9B,0BAA0B,EAC3B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACV,MAAM,6BAA6B,CAAA;AAKpC,iBAAS,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAmEvD;AAED,iBAAS,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAY3D;AAED,iBAAS,yBAAyB,CAAC,KAAK,EAAE,KAAK,WAc9C;AAED,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,8BAA8B,EAC9B,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,GACV,CAAA"}

package/dist/src/modules/index.js

@@ -4,7 +4,6 @@ import { INTENT_EXECUTOR_ADDRESS, INTENT_EXECUTOR_ADDRESS_DEV, } from './chain-a
 import { getModule, MODULE_TYPE_EXECUTOR, MODULE_TYPE_FALLBACK, MODULE_TYPE_HOOK, MODULE_TYPE_ID_EXECUTOR, MODULE_TYPE_ID_FALLBACK, MODULE_TYPE_VALIDATOR, } from './common.js';
 import { getExecutors, getOwners, getValidators } from './read.js';
 import { getOwnerValidator, getSmartSessionValidator, MULTI_FACTOR_VALIDATOR_ADDRESS, OWNABLE_VALIDATOR_ADDRESS, SMART_SESSION_EMISSARY_ADDRESS, WEBAUTHN_VALIDATOR_ADDRESS, } from './validators/index.js';
-import { getSocialRecoveryValidator } from './validators/core.js';
 import { getSessionDetails, signEnableSession, toSession, } from './validators/smart-sessions.js';
 const SMART_SESSION_COMPATIBILITY_FALLBACK_ADDRESS = '0x000000000052e9685932845660777DF43C2dC496';
 function getSetup(config) {
@@ -14,10 +13,6 @@ function getSetup(config) {
     if (smartSessionValidator) {
         validators.push(smartSessionValidator);
     }
-    if (config.recovery) {
-        const socialRecoveryValidator = getSocialRecoveryValidator(config.recovery.guardians, config.recovery.threshold);
-        validators.push(socialRecoveryValidator);
-    }
     const intentExecutor = getIntentExecutor(config);
     const executors = [intentExecutor];
     const fallbacks = [];

package/dist/src/modules/read.d.ts

@@ -1,10 +1,11 @@
 import { type Address, type Chain } from 'viem';
 import type { AccountType, ProviderConfig } from '../types.js';
 declare function getValidators(accountType: AccountType, account: Address, chain: Chain, provider?: ProviderConfig): Promise<Address[]>;
-declare function getOwners(account: Address, chain: Chain, provider?: ProviderConfig): Promise<{
+declare function getOwners(accountType: AccountType, account: Address, chain: Chain, provider?: ProviderConfig, hcaFactory?: Address): Promise<{
     accounts: Address[];
     threshold: number;
 } | null>;
 declare function getExecutors(accountType: AccountType, account: Address, chain: Chain, provider?: ProviderConfig): Promise<Address[]>;
-export { getValidators, getExecutors, getOwners };
+declare function isValidatorInitialized(account: Address, chain: Chain, validatorAddress: Address, provider?: ProviderConfig): Promise<boolean>;
+export { getValidators, getExecutors, getOwners, isValidatorInitialized };
 //# sourceMappingURL=read.d.ts.map

package/dist/src/modules/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../modules/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAsB,MAAM,MAAM,CAAA;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAG3D,iBAAe,aAAa,CAC1B,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,OAAO,EAAE,CAAC,CAiDpB;AAED,iBAAe,SAAS,CACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC;IACT,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,IAAI,CAAC,CAkER;AAED,iBAAe,YAAY,CACzB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,OAAO,EAAE,CAAC,CAiDpB;AAED,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,CAAA"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../modules/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAsB,MAAM,MAAM,CAAA;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAG3D,iBAAe,aAAa,CAC1B,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,OAAO,EAAE,CAAC,CAkDpB;AAED,iBAAe,SAAS,CACtB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,QAAQ,CAAC,EAAE,cAAc,EACzB,UAAU,CAAC,EAAE,OAAO,GACnB,OAAO,CAAC;IACT,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,IAAI,CAAC,CAuFR;AAED,iBAAe,YAAY,CACzB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,OAAO,EAAE,CAAC,CAkDpB;AAED,iBAAe,sBAAsB,CACnC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,gBAAgB,EAAE,OAAO,EACzB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,OAAO,CAAC,CAwBlB;AAED,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,CAAA"}

package/dist/src/modules/read.js

@@ -1,6 +1,6 @@
 import { createPublicClient } from 'viem';
 import { createTransport } from '../accounts/utils.js';
-import { OWNABLE_VALIDATOR_ADDRESS } from './validators/core.js';
+import { ENS_HCA_MODULE, OWNABLE_VALIDATOR_ADDRESS } from './validators/core.js';
 async function getValidators(accountType, account, chain, provider) {
     const publicClient = createPublicClient({
         chain,
@@ -9,6 +9,7 @@ async function getValidators(accountType, account, chain, provider) {
     switch (accountType) {
         case 'safe':
         case 'startale':
+        case 'hca':
         case 'nexus': {
             const validators = await publicClient.readContract({
                 abi: [
@@ -51,12 +52,33 @@ async function getValidators(accountType, account, chain, provider) {
         }
     }
 }
-async function getOwners(account, chain, provider) {
+async function getOwners(accountType, account, chain, provider, hcaFactory) {
     const publicClient = createPublicClient({
         chain,
         transport: createTransport(chain, provider),
     });
-    const moduleAddress = OWNABLE_VALIDATOR_ADDRESS;
+    // HCA accounts hold owner state under the HCA module (the factory's init-data
+    // parser), which is OwnableValidator-based, so the getOwners/threshold reads
+    // are identical. A custom factory defines its own module, so resolve it from
+    // the factory; otherwise fall back to the canonical module.
+    let moduleAddress = OWNABLE_VALIDATOR_ADDRESS;
+    if (accountType === 'hca') {
+        moduleAddress = hcaFactory
+            ? await publicClient.readContract({
+                abi: [
+                    {
+                        name: 'initDataParser',
+                        type: 'function',
+                        stateMutability: 'view',
+                        inputs: [],
+                        outputs: [{ name: '', type: 'address' }],
+                    },
+                ],
+                functionName: 'initDataParser',
+                address: hcaFactory,
+            })
+            : ENS_HCA_MODULE;
+    }
     const [ownerResult, thresholdResult] = await publicClient.multicall({
         contracts: [
             {
@@ -126,6 +148,7 @@ async function getExecutors(accountType, account, chain, provider) {
     switch (accountType) {
         case 'safe':
         case 'startale':
+        case 'hca':
         case 'nexus': {
             const executors = await publicClient.readContract({
                 abi: [
@@ -168,4 +191,29 @@ async function getExecutors(accountType, account, chain, provider) {
         }
     }
 }
-export { getValidators, getExecutors, getOwners };
+async function isValidatorInitialized(account, chain, validatorAddress, provider) {
+    const publicClient = createPublicClient({
+        chain,
+        transport: createTransport(chain, provider),
+    });
+    // `isInitialized` is a plain storage read on the validator singleton and
+    // returns `false` for an uninitialized (or undeployed) account without
+    // reverting. We deliberately let real read failures (provider/ABI errors)
+    // propagate rather than coercing them to `false`, which could otherwise
+    // produce an `onInstall` call for an already-initialized account.
+    return publicClient.readContract({
+        abi: [
+            {
+                name: 'isInitialized',
+                type: 'function',
+                stateMutability: 'view',
+                inputs: [{ name: 'smartAccount', type: 'address' }],
+                outputs: [{ name: '', type: 'bool' }],
+            },
+        ],
+        functionName: 'isInitialized',
+        address: validatorAddress,
+        args: [account],
+    });
+}
+export { getValidators, getExecutors, getOwners, isValidatorInitialized };

package/dist/src/modules/validators/core.d.ts

@@ -1,4 +1,4 @@
-import { type Account, type Address, type Hex } from 'viem';
+import { type Address, type Hex } from 'viem';
 import type { ENSValidatorConfig, OwnableValidatorConfig, OwnerSet, RhinestoneAccountConfig, WebauthnValidatorConfig } from '../../types.js';
 import { type Module } from '../common.js';
 declare const SMART_SESSION_EMISSARY_ADDRESS_DEV: Address;
@@ -13,19 +13,19 @@ interface WebauthnCredential {
     authenticatorId: string;
 }
 declare const OWNABLE_VALIDATOR_ADDRESS: Address;
-declare const ENS_VALIDATOR_ADDRESS: Address;
+declare const ENS_HCA_MODULE: Address;
 declare const WEBAUTHN_VALIDATOR_ADDRESS: Address;
 declare const MULTI_FACTOR_VALIDATOR_ADDRESS: Address;
 declare const WEBAUTHN_V0_VALIDATOR_ADDRESS: Address;
+declare function ownerSetUsesEns(owners: OwnerSet): boolean;
 declare function getOwnerValidator(config: RhinestoneAccountConfig): Module;
 declare function getMockSignature(ownerSet: OwnerSet): Hex;
 declare function getValidator(owners: OwnerSet): Module;
 declare function getOwnableValidator(threshold: number, owners: Address[], address?: Address): Module;
-declare function getENSValidator(threshold: number, owners: Address[], ownerExpirations: number[], address?: Address): Module;
+declare function getENSValidator(threshold: number, owners: Address[], expirations: (Date | undefined)[]): Module;
 declare function getWebAuthnValidator(threshold: number, webAuthnCredentials: WebauthnCredential[], address?: Address): Module;
-declare function getMultiFactorValidator(threshold: number, validators: (OwnableValidatorConfig | ENSValidatorConfig | WebauthnValidatorConfig | null)[]): Module;
-declare function getSocialRecoveryValidator(guardians: Account[], threshold?: number): Module;
+declare function getMultiFactorValidator(threshold: number, validators: (OwnableValidatorConfig | ENSValidatorConfig | WebauthnValidatorConfig | null)[], address?: Address): Module;
 declare function supportsEip712(validator: Module): boolean;
-export { OWNABLE_VALIDATOR_ADDRESS, ENS_VALIDATOR_ADDRESS, WEBAUTHN_VALIDATOR_ADDRESS, MULTI_FACTOR_VALIDATOR_ADDRESS, WEBAUTHN_V0_VALIDATOR_ADDRESS, SMART_SESSION_EMISSARY_ADDRESS, SMART_SESSION_EMISSARY_ADDRESS_DEV, getOwnerValidator, getOwnableValidator, getENSValidator, getWebAuthnValidator, getMultiFactorValidator, getSocialRecoveryValidator, getValidator, getMockSignature, supportsEip712, };
+export { OWNABLE_VALIDATOR_ADDRESS, ENS_HCA_MODULE, WEBAUTHN_VALIDATOR_ADDRESS, MULTI_FACTOR_VALIDATOR_ADDRESS, WEBAUTHN_V0_VALIDATOR_ADDRESS, SMART_SESSION_EMISSARY_ADDRESS, SMART_SESSION_EMISSARY_ADDRESS_DEV, getOwnerValidator, getOwnableValidator, getENSValidator, getWebAuthnValidator, getMultiFactorValidator, getValidator, getMockSignature, supportsEip712, ownerSetUsesEns, };
 export type { WebauthnCredential };
 //# sourceMappingURL=core.d.ts.map

package/dist/src/modules/validators/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../modules/validators/core.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EAKZ,KAAK,GAAG,EAKT,MAAM,MAAM,CAAA;AAGb,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,QAAQ,EACR,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAA4B,KAAK,MAAM,EAAE,MAAM,WAAW,CAAA;AAEjE,QAAA,MAAM,kCAAkC,EAAE,OACI,CAAA;AAC9C,QAAA,MAAM,8BAA8B,EAAE,OACQ,CAAA;AAE9C,UAAU,SAAS;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,UAAU,kBAAkB;IAC1B,MAAM,EAAE,SAAS,GAAG,GAAG,GAAG,UAAU,CAAA;IACpC,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,QAAA,MAAM,yBAAyB,EAAE,OACa,CAAA;AAC9C,QAAA,MAAM,qBAAqB,EAAE,OACiB,CAAA;AAC9C,QAAA,MAAM,0BAA0B,EAAE,OACY,CAAA;AAG9C,QAAA,MAAM,8BAA8B,EAAE,OACQ,CAAA;AAO9C,QAAA,MAAM,6BAA6B,EAAE,OACS,CAAA;AAO9C,iBAAS,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,UAKzD;AAED,iBAAS,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,GAAG,CAmDjD;AAED,iBAAS,YAAY,CAAC,MAAM,EAAE,QAAQ,UA2BrC;AAED,iBAAS,mBAAmB,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,CAiBR;AAED,iBAAS,eAAe,CACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EAAE,EACjB,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,CAsCR;AAED,iBAAS,oBAAoB,CAC3B,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,kBAAkB,EAAE,EACzC,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,CA4DR;AAED,iBAAS,uBAAuB,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CACR,sBAAsB,GACtB,kBAAkB,GAClB,uBAAuB,GACvB,IAAI,CACP,EAAE,GACF,MAAM,CAgDR;AAED,iBAAS,0BAA0B,CACjC,SAAS,EAAE,OAAO,EAAE,EACpB,SAAS,SAAI,GACZ,MAAM,CAsBR;AAeD,iBAAS,cAAc,CAAC,SAAS,EAAE,MAAM,WAUxC;AAED,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,EAC1B,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,kCAAkC,EAClC,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,CAAA;AACD,YAAY,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../modules/validators/core.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAKZ,KAAK,GAAG,EAKT,MAAM,MAAM,CAAA;AAMb,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,QAAQ,EACR,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAA4B,KAAK,MAAM,EAAE,MAAM,WAAW,CAAA;AAEjE,QAAA,MAAM,kCAAkC,EAAE,OACI,CAAA;AAC9C,QAAA,MAAM,8BAA8B,EAAE,OACQ,CAAA;AAE9C,UAAU,SAAS;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,UAAU,kBAAkB;IAC1B,MAAM,EAAE,SAAS,GAAG,GAAG,GAAG,UAAU,CAAA;IACpC,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,QAAA,MAAM,yBAAyB,EAAE,OACa,CAAA;AAC9C,QAAA,MAAM,cAAc,EAAE,OAAsD,CAAA;AAC5E,QAAA,MAAM,0BAA0B,EAAE,OACY,CAAA;AAC9C,QAAA,MAAM,8BAA8B,EAAE,OACQ,CAAA;AAO9C,QAAA,MAAM,6BAA6B,EAAE,OACS,CAAA;AAU9C,iBAAS,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAMlD;AAED,iBAAS,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,UAazD;AAED,iBAAS,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,GAAG,CAsDjD;AAED,iBAAS,YAAY,CAAC,MAAM,EAAE,QAAQ,UAiCrC;AAED,iBAAS,mBAAmB,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,CAiBR;AAED,iBAAS,eAAe,CACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EAAE,EACjB,WAAW,EAAE,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,GAChC,MAAM,CA4CR;AAED,iBAAS,oBAAoB,CAC3B,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,kBAAkB,EAAE,EACzC,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,CA4DR;AAED,iBAAS,uBAAuB,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CACR,sBAAsB,GACtB,kBAAkB,GAClB,uBAAuB,GACvB,IAAI,CACP,EAAE,EACH,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,CAgDR;AAeD,iBAAS,cAAc,CAAC,SAAS,EAAE,MAAM,WAUxC;AAED,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,0BAA0B,EAC1B,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,kCAAkC,EAClC,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,CAAA;AACD,YAAY,EAAE,kBAAkB,EAAE,CAAA"}