@rhinestone/sdk 2.0.0-beta.44 → 2.0.0-beta.46

package/dist/src/index.js

@@ -1,289 +1,9 @@
-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 { 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, toSession, } from './modules/validators/smart-sessions.js';
-import { getOrchestrator } from './orchestrator/index.js';
-import { hyperCoreMainnet, solanaMainnet, tronMainnet } from './orchestrator/index.js';
-/**
- * Initialize a Rhinestone account from a fully-resolved config.
- * Note: accounts are deployed onchain only when the first transaction is sent.
- * @internal Use {@link RhinestoneSDK.createAccount} instead.
- */
-async function createAccountInternal(config) {
-    // Sanity check for existing (externally created) accounts
-    // Ensures we decode the initdata correctly
-    checkAddress(config);
-    // Validate that owners field is provided for non-EOA accounts
-    if (config.account?.type !== 'eoa' && !config.owners) {
-        throw new OwnersFieldRequiredError();
-    }
-    /**
-     * Deploys the account on a given chain
-     * @param chain Chain to deploy the account on
-     * @param params Optional deployment params (e.g. `sponsored`)
-     */
-    function deploy(chain, params) {
-        return deployInternal(config, chain, params);
-    }
-    function isDeployed(chain) {
-        return isDeployedInternal(config, chain);
-    }
-    function setup(chain) {
-        return setupInternal(config, chain);
-    }
-    function getInitData() {
-        const initData = getInitCode(config);
-        if (!initData) {
-            throw new FactoryArgsNotAvailableError();
-        }
-        if (!('factory' in initData)) {
-            throw new FactoryArgsNotAvailableError();
-        }
-        return {
-            factory: initData.factory,
-            factoryData: initData.factoryData,
-        };
-    }
-    function signEip7702InitData() {
-        return signEip7702InitDataInternal(config);
-    }
-    function prepareTransaction(transaction) {
-        return prepareTransactionInternal(config, transaction);
-    }
-    function getTransactionMessages(preparedTransaction, options) {
-        return getTransactionMessagesInternal(config, preparedTransaction, options);
-    }
-    function signTransaction(preparedTransaction, options) {
-        if (options && 'owner' in options) {
-            return signTransactionInternal(config, preparedTransaction, options);
-        }
-        return signTransactionInternal(config, preparedTransaction, options);
-    }
-    function assembleTransaction(preparedTransaction, signatures) {
-        return assembleTransactionInternal(config, preparedTransaction, signatures);
-    }
-    function signAuthorizations(preparedTransaction) {
-        return signAuthorizationsInternal(config, preparedTransaction);
-    }
-    function signMessage(message, chain, signers) {
-        return signMessageInternal(config, message, chain, signers);
-    }
-    function signTypedData(parameters, chain, signers) {
-        return signTypedDataInternal(config, parameters, chain, signers);
-    }
-    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);
-    }
-    function prepareUserOperation(transaction) {
-        return prepareUserOperationInternal(config, transaction);
-    }
-    function signUserOperation(preparedUserOperation) {
-        return signUserOperationInternal(config, preparedUserOperation);
-    }
-    function submitUserOperation(signedUserOperation) {
-        return submitUserOperationInternal(config, signedUserOperation);
-    }
-    function sendUserOperation(transaction) {
-        return sendUserOperationInternal(config, transaction);
-    }
-    function waitForExecution(result) {
-        return waitForExecutionInternal(config, result);
-    }
-    function getAddress() {
-        return getAddressInternal(config);
-    }
-    function getPortfolio(onTestnets = false) {
-        return getPortfolioInternal(config, onTestnets);
-    }
-    function getOwners(chain) {
-        const accountType = getAccountProvider(config).type;
-        const account = getAddress();
-        // 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);
-    }
-    function getValidators(chain) {
-        const accountType = getAccountProvider(config).type;
-        const account = getAddress();
-        return getValidatorsInternal(accountType, account, chain, config.provider);
-    }
-    function getExecutors(chain) {
-        const accountType = getAccountProvider(config).type;
-        const account = getAddress();
-        return getExecutorsInternal(accountType, account, chain, config.provider);
-    }
-    function experimental_getSessionDetails(sessions) {
-        const account = getAddress();
-        return getSessionDetailsInternal(account, sessions, config.provider, config.useDevContracts);
-    }
-    function experimental_isSessionEnabled(session) {
-        const account = getAddress();
-        return isSessionEnabledInternal(account, config.provider, session, config.useDevContracts);
-    }
-    function experimental_signEnableSession(details) {
-        return signEnableSessionInternal(config, details);
-    }
-    return {
-        config,
-        deploy,
-        isDeployed,
-        setup,
-        signEip7702InitData,
-        prepareTransaction,
-        getTransactionMessages,
-        signTransaction,
-        assembleTransaction,
-        signAuthorizations,
-        signMessage,
-        signTypedData,
-        signIntent,
-        submitTransaction,
-        prepareUserOperation,
-        signUserOperation,
-        submitUserOperation,
-        sendUserOperation,
-        waitForExecution,
-        getAddress,
-        getPortfolio,
-        getOwners,
-        getValidators,
-        getExecutors,
-        experimental_getSessionDetails,
-        experimental_isSessionEnabled,
-        experimental_signEnableSession,
-        getInitData,
-    };
-}
-async function createSessionInternal(authProvider, endpointUrl, headers, useDevContracts, definition) {
-    const orchestrator = getOrchestrator(authProvider, endpointUrl, headers);
-    const catalog = await orchestrator.getChainCatalog();
-    const wrappedNativeToken = catalog.getWrappedNativeToken(definition.chain.id)
-        ?.address;
-    // Fail fast: without the wrapped-native address we can't add the native-wrap
-    // `deposit()` permission, and a silently under-scoped session would
-    // sign/enable fine but break native-wrap intents later.
-    if (!wrappedNativeToken) {
-        throw new Error(`createSession: the orchestrator's /chains has no wrapped-native token for chain ${definition.chain.id}. The chain must be supported and advertise its wrappedNativeToken.`);
-    }
-    return toSession(definition, { wrappedNativeToken, useDevContracts });
-}
-/**
- * Stateful entry point that holds shared configuration (auth, provider, bundler,
- * paymaster) and creates accounts from it.
- */
-class RhinestoneSDK {
-    authProvider;
-    endpointUrl;
-    provider;
-    bundler;
-    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;
-        this.provider = options.provider;
-        this.bundler = options.bundler;
-        this.paymaster = options.paymaster;
-        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,
-            _authProvider: this.authProvider,
-            endpointUrl: this.endpointUrl,
-            provider: this.provider,
-            bundler: this.bundler,
-            paymaster: this.paymaster,
-            useDevContracts: this.useDevContracts,
-            headers: this.headers,
-        };
-        return createAccountInternal(rhinestoneConfig);
-    }
-    /**
-     * Create a smart session, resolving the chain's wrapped-native token from the
-     * orchestrator's chain catalog (`GET /chains`) so native-token wrapping is
-     * permitted automatically. Project-scoped — needs the API key but no account.
-     * For a fully offline build, use the standalone {@link toSession} and pass
-     * `wrappedNativeToken` yourself.
-     * @param definition The session definition
-     * @returns The resolved session
-     */
-    createSession(definition) {
-        return createSessionInternal(this.authProvider, this.endpointUrl, this.headers, this.useDevContracts, definition);
-    }
-    /**
-     * 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);
-    }
-}
+import { RhinestoneSDK } from './api/sdk.js';
+import { hyperCoreMainnet, solanaMainnet, tronMainnet } from './chains/non-evm.js';
+import { MULTI_FACTOR_VALIDATOR_ADDRESS } from './modules/validators/multi-factor.js';
+import { OWNABLE_VALIDATOR_ADDRESS } from './modules/validators/ownable.js';
+import { SMART_SESSION_EMISSARY_ADDRESS } from './modules/validators/smart-sessions/module.js';
+import { WEBAUTHN_VALIDATOR_ADDRESS } from './modules/validators/webauthn.js';
 export { RhinestoneSDK, 
 // Non-viem destination chain descriptors (Solana, Tron, HyperCore)
 hyperCoreMainnet, solanaMainnet, tronMainnet, 

package/dist/src/modules/erc7579-abi.d.ts

@@ -0,0 +1,4 @@
+import type { ModuleKind } from './types.js';
+export type ModuleTypeId = 1n | 2n | 3n | 4n;
+export declare function moduleTypeId(kind: ModuleKind): ModuleTypeId;
+//# sourceMappingURL=erc7579-abi.d.ts.map

package/dist/src/modules/erc7579-abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc7579-abi.d.ts","sourceRoot":"","sources":["../../../modules/erc7579-abi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,MAAM,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;AAE5C,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAW3D"}

package/dist/src/modules/erc7579-abi.js

@@ -0,0 +1,12 @@
+export function moduleTypeId(kind) {
+    switch (kind) {
+        case 'validator':
+            return 1n;
+        case 'executor':
+            return 2n;
+        case 'fallback':
+            return 3n;
+        case 'hook':
+            return 4n;
+    }
+}

package/dist/src/modules/intent-executor.d.ts

@@ -0,0 +1,6 @@
+import type { Address } from 'viem';
+import type { ResolvedModule } from './types.js';
+export declare const INTENT_EXECUTOR_ADDRESS: Address;
+export declare const INTENT_EXECUTOR_ADDRESS_DEV: Address;
+export declare function getIntentExecutorModule(environment: 'production' | 'development'): ResolvedModule;
+//# sourceMappingURL=intent-executor.d.ts.map

package/dist/src/modules/intent-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-executor.d.ts","sourceRoot":"","sources":["../../../modules/intent-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,eAAO,MAAM,uBAAuB,EAAE,OACQ,CAAA;AAC9C,eAAO,MAAM,2BAA2B,EAAE,OACI,CAAA;AAE9C,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,YAAY,GAAG,aAAa,GACxC,cAAc,CAWhB"}

package/dist/src/modules/intent-executor.js

@@ -0,0 +1,13 @@
+export const INTENT_EXECUTOR_ADDRESS = '0x00000000005aD9ce1f5035FD62CA96CEf16AdAAF';
+export const INTENT_EXECUTOR_ADDRESS_DEV = '0xbf9b5b917a83f8adac17b0752846d41d8d7b7e17';
+export function getIntentExecutorModule(environment) {
+    return {
+        kind: 'executor',
+        address: environment === 'development'
+            ? INTENT_EXECUTOR_ADDRESS_DEV
+            : INTENT_EXECUTOR_ADDRESS,
+        initData: '0x',
+        deInitData: '0x',
+        additionalContext: '0x',
+    };
+}

package/dist/src/modules/legacy-core.d.ts

@@ -0,0 +1,29 @@
+import { type Address, type Hex } from 'viem';
+import type { ModuleSetup, ResolvedModule } from './types.js';
+declare const MODULE_TYPE_ID_VALIDATOR = 1n;
+declare const MODULE_TYPE_ID_EXECUTOR = 2n;
+declare const MODULE_TYPE_ID_FALLBACK = 3n;
+declare const MODULE_TYPE_ID_HOOK = 4n;
+export type ModuleTypeId = typeof MODULE_TYPE_ID_VALIDATOR | typeof MODULE_TYPE_ID_EXECUTOR | typeof MODULE_TYPE_ID_FALLBACK | typeof MODULE_TYPE_ID_HOOK;
+export interface Module {
+    address: Address;
+    initData: Hex;
+    deInitData: Hex;
+    additionalContext: Hex;
+    type: ModuleTypeId;
+}
+export interface ModeleSetup {
+    validators: Module[];
+    executors: Module[];
+    fallbacks: Module[];
+    hooks: Module[];
+}
+export declare function toLegacyModule(module: ResolvedModule): Module;
+export declare function toLegacyModuleSetup(setup: ModuleSetup): ModeleSetup;
+export declare function getV0Attesters(): {
+    readonly addresses: readonly `0x${string}`[];
+    readonly threshold: number;
+};
+export declare function planV0ModuleSetup(setup: ModuleSetup): ModuleSetup;
+export {};
+//# sourceMappingURL=legacy-core.d.ts.map

package/dist/src/modules/legacy-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-core.d.ts","sourceRoot":"","sources":["../../../modules/legacy-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAuB,KAAK,GAAG,EAAE,MAAM,MAAM,CAAA;AAClE,OAAO,KAAK,EAAc,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAKtE,QAAA,MAAM,wBAAwB,KAAK,CAAA;AACnC,QAAA,MAAM,uBAAuB,KAAK,CAAA;AAClC,QAAA,MAAM,uBAAuB,KAAK,CAAA;AAClC,QAAA,MAAM,mBAAmB,KAAK,CAAA;AAE9B,MAAM,MAAM,YAAY,GACpB,OAAO,wBAAwB,GAC/B,OAAO,uBAAuB,GAC9B,OAAO,uBAAuB,GAC9B,OAAO,mBAAmB,CAAA;AAE9B,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,GAAG,CAAA;IACb,UAAU,EAAE,GAAG,CAAA;IACf,iBAAiB,EAAE,GAAG,CAAA;IACtB,IAAI,EAAE,YAAY,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAyBD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAQ7D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAOnE;AAED,wBAAgB,cAAc,IAAI;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,KAAK,MAAM,EAAE,EAAE,CAAA;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,CAQA;AAgBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CA0BjE"}

package/dist/src/modules/legacy-core.js

@@ -0,0 +1,80 @@
+import { encodeAbiParameters } from 'viem';
+// Legacy module-setup shapes preserved for the `experimental_getModuleSetup`
+// compatibility surface (note the historical `ModeleSetup` spelling, which is
+// part of the published type name).
+const MODULE_TYPE_ID_VALIDATOR = 1n;
+const MODULE_TYPE_ID_EXECUTOR = 2n;
+const MODULE_TYPE_ID_FALLBACK = 3n;
+const MODULE_TYPE_ID_HOOK = 4n;
+const RHINESTONE_ATTESTER_ADDRESS = '0x000000333034E9f539ce08819E12c1b8Cb29084d';
+const OMNI_ACCOUNT_MOCK_ATTESTER_ADDRESS = '0x6D0515e8E499468DCe9583626f0cA15b887f9d03';
+const HOOK_ADDRESS = '0x0000000000f6Ed8Be424d673c63eeFF8b9267420';
+const TARGET_MODULE_ADDRESS = '0x0000000000E5a37279A001301A837a91b5de1D5E';
+const SAME_CHAIN_MODULE_ADDRESS = '0x000000000043ff16d5776c7F0f65Ec485C17Ca04';
+const moduleType = (kind) => {
+    switch (kind) {
+        case 'validator':
+            return 1n;
+        case 'executor':
+            return 2n;
+        case 'fallback':
+            return 3n;
+        case 'hook':
+            return 4n;
+    }
+};
+export function toLegacyModule(module) {
+    return {
+        address: module.address,
+        initData: module.initData,
+        deInitData: module.deInitData,
+        additionalContext: module.additionalContext,
+        type: moduleType(module.kind),
+    };
+}
+export function toLegacyModuleSetup(setup) {
+    return {
+        validators: setup.validators.map(toLegacyModule),
+        executors: setup.executors.map(toLegacyModule),
+        fallbacks: setup.fallbacks.map(toLegacyModule),
+        hooks: setup.hooks.map(toLegacyModule),
+    };
+}
+export function getV0Attesters() {
+    return {
+        addresses: [
+            RHINESTONE_ATTESTER_ADDRESS,
+            OMNI_ACCOUNT_MOCK_ATTESTER_ADDRESS,
+        ],
+        threshold: 1,
+    };
+}
+function v0Module(kind, address, initData = '0x') {
+    return {
+        kind,
+        address,
+        initData,
+        deInitData: '0x',
+        additionalContext: '0x',
+    };
+}
+export function planV0ModuleSetup(setup) {
+    return {
+        validators: setup.validators,
+        executors: [
+            v0Module('executor', SAME_CHAIN_MODULE_ADDRESS),
+            v0Module('executor', TARGET_MODULE_ADDRESS),
+            v0Module('executor', HOOK_ADDRESS),
+            ...setup.executors,
+        ],
+        fallbacks: [
+            v0Module('fallback', TARGET_MODULE_ADDRESS, encodeAbiParameters([
+                { name: 'selector', type: 'bytes4' },
+                { name: 'flags', type: 'bytes1' },
+                { name: 'data', type: 'bytes' },
+            ], ['0x3a5be8cb', '0x00', '0x'])),
+            ...setup.fallbacks,
+        ],
+        hooks: setup.hooks,
+    };
+}

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

@@ -0,0 +1,4 @@
+import type { ConfiguredModule, ResolvedModule } from './types.js';
+export declare function normalizeModule(module: ConfiguredModule): ResolvedModule;
+export declare function normalizeModules(modules: readonly ConfiguredModule[]): readonly ResolvedModule[];
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../modules/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAQ/D,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAQxE;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,SAAS,cAAc,EAAE,CAE3B"}

package/dist/src/modules/normalize.js

@@ -0,0 +1,15 @@
+function materializeData(selection) {
+    return selection.source === 'explicit' ? selection.value : '0x';
+}
+export function normalizeModule(module) {
+    return {
+        kind: module.kind,
+        address: module.address,
+        initData: materializeData(module.initData),
+        deInitData: materializeData(module.deInitData),
+        additionalContext: materializeData(module.additionalContext),
+    };
+}
+export function normalizeModules(modules) {
+    return modules.map(normalizeModule);
+}

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

@@ -0,0 +1,16 @@
+import { type Hex } from 'viem';
+import type { ConfiguredModule, ModuleInstallationPlan, ModuleSetup, ResolvedModule } from './types.js';
+export type ModuleCallEncoder = (module: ResolvedModule, operation: ModuleInstallationPlan['operation']) => Hex;
+export declare function planModuleOperation(module: ResolvedModule, operation: ModuleInstallationPlan['operation'], encodeAccountCall: ModuleCallEncoder): ModuleInstallationPlan;
+export declare function planModuleSetup(input: {
+    readonly accountKind: string;
+    readonly owner: ResolvedModule;
+    readonly configured: readonly ConfiguredModule[];
+    readonly environment: 'production' | 'development';
+    readonly sessions: {
+        readonly enabled: boolean;
+        readonly module?: `0x${string}`;
+        readonly compatibilityFallback?: `0x${string}`;
+    };
+}): ModuleSetup;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../modules/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,GAAG,EAAE,MAAM,MAAM,CAAA;AAGpD,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,cAAc,EACf,MAAM,SAAS,CAAA;AAGhB,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,sBAAsB,CAAC,WAAW,CAAC,KAC3C,GAAG,CAAA;AAER,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,sBAAsB,CAAC,WAAW,CAAC,EAC9C,iBAAiB,EAAE,iBAAiB,GACnC,sBAAsB,CAMxB;AAKD,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAChD,QAAQ,CAAC,WAAW,EAAE,YAAY,GAAG,aAAa,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;QACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;QAC/B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;KAC/C,CAAA;CACF,GAAG,WAAW,CA0Cd"}

package/dist/src/modules/plan.js

@@ -0,0 +1,51 @@
+import { encodeAbiParameters } from 'viem';
+import { getIntentExecutorModule } from './intent-executor.js';
+import { normalizeModules } from './normalize.js';
+import { resolveSmartSessionModule } from './validators/smart-sessions/module.js';
+export function planModuleOperation(module, operation, encodeAccountCall) {
+    return {
+        module,
+        operation,
+        accountCallData: encodeAccountCall(module, operation),
+    };
+}
+const SAFE_SESSION_COMPATIBILITY_FALLBACK_ADDRESS = '0x000000000052e9685932845660777DF43C2dC496';
+export function planModuleSetup(input) {
+    const custom = normalizeModules(input.configured);
+    const session = resolveSmartSessionModule({
+        enabled: input.sessions.enabled,
+        address: input.sessions.module,
+        environment: input.environment,
+    });
+    const validators = [
+        input.owner,
+        ...(session ? [session] : []),
+        ...custom.filter((module) => module.kind === 'validator'),
+    ];
+    const executors = [
+        getIntentExecutorModule(input.environment),
+        ...custom.filter((module) => module.kind === 'executor'),
+    ];
+    const fallbacks = [];
+    if (input.sessions.enabled && input.accountKind === 'safe') {
+        fallbacks.push({
+            kind: 'fallback',
+            address: input.sessions.compatibilityFallback ??
+                SAFE_SESSION_COMPATIBILITY_FALLBACK_ADDRESS,
+            initData: encodeAbiParameters([
+                { name: 'selector', type: 'bytes4' },
+                { name: 'flags', type: 'bytes1' },
+                { name: 'data', type: 'bytes' },
+            ], ['0x84b0196e', '0xfe', '0x']),
+            deInitData: '0x',
+            additionalContext: '0x',
+        });
+    }
+    fallbacks.push(...custom.filter((module) => module.kind === 'fallback'));
+    return {
+        validators,
+        executors,
+        fallbacks,
+        hooks: custom.filter((module) => module.kind === 'hook'),
+    };
+}

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

@@ -0,0 +1,39 @@
+import { type Address, type Hex } from 'viem';
+import type { EvmChainReference } from '../chains/types.js';
+import type { RpcReadPort } from '../clients/rpc/port.js';
+import type { ModuleKind, ResolvedModule } from './types.js';
+export declare function readInstalledModules(input: {
+    readonly rpc: RpcReadPort;
+    readonly chain: EvmChainReference;
+    readonly accountKind: string;
+    readonly account: Address;
+    readonly kind: Extract<ModuleKind, 'validator' | 'executor'>;
+}): Promise<readonly Address[]>;
+export declare function readValidatorInitialized(input: {
+    readonly rpc: RpcReadPort;
+    readonly chain: EvmChainReference;
+    readonly account: Address;
+    readonly validator: Address;
+}): Promise<boolean>;
+export declare function readModuleInstallations(input: {
+    readonly rpc: RpcReadPort;
+    readonly chain: EvmChainReference;
+    readonly account: Address;
+    readonly modules: readonly ResolvedModule[];
+}): Promise<readonly boolean[]>;
+export declare function readOwners(input: {
+    readonly rpc: RpcReadPort;
+    readonly chain: EvmChainReference;
+    readonly accountKind: string;
+    readonly account: Address;
+    readonly hcaFactory?: Address;
+}): Promise<{
+    readonly accounts: readonly Address[];
+    readonly threshold: number;
+} | null>;
+export declare function encodeAccountModuleDeInitData(input: {
+    readonly accountKind: string;
+    readonly module: ResolvedModule;
+    readonly installed: readonly Address[];
+}): Hex;
+//# sourceMappingURL=read-core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-core.d.ts","sourceRoot":"","sources":["../../../modules/read-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAuB,KAAK,GAAG,EAAE,MAAM,MAAM,CAAA;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAyBzD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,WAAW,GAAG,UAAU,CAAC,CAAA;CAC7D,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAmB9B;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBnB;AAgBD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAA;CAC5C,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAiB9B;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE;IACtC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAC9B,GAAG,OAAO,CAAC;IACV,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,GAAG,IAAI,CAAC,CAmER;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,CAAA;CACvC,GAAG,GAAG,CAkBN"}