@charterlabs/rhinestone-sdk 0.0.3 → 0.0.4

package/dist/src/execution/utils.js

@@ -0,0 +1,355 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareTransaction = prepareTransaction;
+exports.signTransaction = signTransaction;
+exports.submitTransaction = submitTransaction;
+exports.getOrchestratorByChain = getOrchestratorByChain;
+exports.getUserOpOrderPath = getUserOpOrderPath;
+exports.getUserOp = getUserOp;
+exports.signIntent = signIntent;
+exports.signUserOp = signUserOp;
+exports.submitUserOp = submitUserOp;
+exports.prepareTransactionAsIntent = prepareTransactionAsIntent;
+exports.submitIntentInternal = submitIntentInternal;
+exports.getValidatorAccount = getValidatorAccount;
+const viem_1 = require("viem");
+const account_abstraction_1 = require("viem/account-abstraction");
+const accounts_1 = require("../accounts");
+const utils_1 = require("../accounts/utils");
+const validators_1 = require("../modules/validators");
+const core_1 = require("../modules/validators/core");
+const orchestrator_1 = require("../orchestrator");
+const consts_1 = require("../orchestrator/consts");
+const registry_1 = require("../orchestrator/registry");
+const smart_session_1 = require("./smart-session");
+async function prepareTransaction(config, transaction) {
+    const { sourceChain, targetChain, tokenRequests, signers } = getTransactionParams(transaction);
+    const accountAddress = (0, accounts_1.getAddress)(config);
+    let bundleData;
+    if (signers) {
+        if (!sourceChain) {
+            throw new Error(`Specifying source chain is required when using smart sessions or guardians`);
+        }
+        // Smart sessions require a UserOp flow
+        bundleData = await prepareTransactionAsUserOp(config, sourceChain, targetChain, transaction.calls, transaction.gasLimit, tokenRequests, accountAddress, signers);
+    }
+    else {
+        bundleData = await prepareTransactionAsIntent(config, sourceChain, targetChain, transaction.calls, transaction.gasLimit, tokenRequests, accountAddress);
+    }
+    return {
+        bundleData,
+        transaction,
+    };
+}
+async function signTransaction(config, preparedTransaction) {
+    const { sourceChain, targetChain, signers } = getTransactionParams(preparedTransaction.transaction);
+    const withSession = signers?.type === 'session' ? signers.session : null;
+    const bundleData = preparedTransaction.bundleData;
+    const accountAddress = (0, accounts_1.getAddress)(config);
+    let signature;
+    if (withSession) {
+        if (!sourceChain) {
+            throw new Error(`Specifying source chain is required when using smart sessions`);
+        }
+        const userOp = bundleData.userOp;
+        if (!userOp) {
+            throw new Error(`User operation is required when using smart sessions`);
+        }
+        // Smart sessions require a UserOp flow
+        signature = await signUserOp(config, sourceChain, targetChain, accountAddress, signers, userOp, bundleData.orderPath);
+    }
+    else {
+        signature = await signIntent(config, sourceChain, targetChain, bundleData.hash);
+    }
+    return {
+        bundleData,
+        transaction: preparedTransaction.transaction,
+        signature,
+    };
+}
+async function submitTransaction(config, signedTransaction) {
+    const { bundleData, transaction, signature } = signedTransaction;
+    const { sourceChain, targetChain, signers } = getTransactionParams(transaction);
+    const withSession = signers?.type === 'session' ? signers.session : null;
+    if (withSession) {
+        if (!sourceChain) {
+            throw new Error(`Specifying source chain is required when using smart sessions`);
+        }
+        const userOp = bundleData.userOp;
+        if (!userOp) {
+            throw new Error(`User operation is required when using smart sessions`);
+        }
+        // Smart sessions require a UserOp flow
+        return await submitUserOp(config, sourceChain, targetChain, userOp, bundleData.orderPath, signature);
+    }
+    else {
+        return await submitIntent(config, sourceChain, targetChain, bundleData.orderPath, signature);
+    }
+}
+function getTransactionParams(transaction) {
+    const sourceChain = 'chain' in transaction ? transaction.chain : transaction.sourceChain;
+    const targetChain = 'chain' in transaction ? transaction.chain : transaction.targetChain;
+    const initialTokenRequests = transaction.tokenRequests;
+    const signers = transaction.signers;
+    // Across requires passing some value to repay the solvers
+    const tokenRequests = initialTokenRequests.length === 0
+        ? [
+            {
+                address: viem_1.zeroAddress,
+                amount: 1n,
+            },
+        ]
+        : initialTokenRequests;
+    return {
+        sourceChain,
+        targetChain,
+        tokenRequests,
+        signers,
+    };
+}
+async function prepareTransactionAsUserOp(config, sourceChain, targetChain, calls, gasLimit, tokenRequests, accountAddress, signers) {
+    if (sourceChain.id === targetChain.id) {
+        throw new Error('Source and target chains cannot be the same when using user operations');
+    }
+    const orderPath = await getUserOpOrderPath(sourceChain, targetChain, tokenRequests, accountAddress, gasLimit, config.rhinestoneApiKey);
+    const userOp = await getUserOp(config, targetChain, signers, orderPath, calls, tokenRequests, accountAddress);
+    const hash = (0, account_abstraction_1.getUserOperationHash)({
+        userOperation: userOp,
+        entryPointAddress: account_abstraction_1.entryPoint07Address,
+        entryPointVersion: '0.7',
+        chainId: targetChain.id,
+    });
+    return {
+        orderPath,
+        userOp,
+        hash,
+    };
+}
+async function prepareTransactionAsIntent(config, sourceChain, targetChain, calls, gasLimit, tokenRequests, accountAddress) {
+    const accountAccessList = sourceChain
+        ? {
+            chainIds: [sourceChain.id],
+        }
+        : (0, registry_1.getDefaultAccountAccessList)();
+    const metaIntent = {
+        targetChainId: targetChain.id,
+        tokenTransfers: tokenRequests.map((tokenRequest) => ({
+            tokenAddress: tokenRequest.address,
+            amount: tokenRequest.amount,
+        })),
+        targetAccount: accountAddress,
+        targetExecutions: calls.map((call) => ({
+            value: call.value ?? 0n,
+            to: call.to,
+            data: call.data ?? '0x',
+        })),
+        targetGasUnits: gasLimit,
+        accountAccessList,
+    };
+    const orchestrator = getOrchestratorByChain(targetChain.id, config.rhinestoneApiKey);
+    const orderPath = await orchestrator.getOrderPath(metaIntent, accountAddress);
+    orderPath[0].orderBundle.segments[0].witness.execs = [
+        ...orderPath[0].injectedExecutions,
+        ...metaIntent.targetExecutions,
+    ];
+    const orderBundleHash = (0, orchestrator_1.getOrderBundleHash)(orderPath[0].orderBundle);
+    return {
+        orderPath,
+        hash: orderBundleHash,
+    };
+}
+async function signIntent(config, sourceChain, targetChain, bundleHash) {
+    const validatorModule = (0, validators_1.getOwnerValidator)(config);
+    const signature = await (0, accounts_1.getPackedSignature)(config, config.owners, sourceChain || targetChain, {
+        address: validatorModule.address,
+        isRoot: true,
+    }, bundleHash);
+    return signature;
+}
+async function signUserOp(config, sourceChain, targetChain, accountAddress, signers, userOp, orderPath) {
+    const validator = getValidator(config, signers);
+    if (!validator) {
+        throw new Error('Validator not available');
+    }
+    const targetPublicClient = (0, viem_1.createPublicClient)({
+        chain: targetChain,
+        transport: (0, viem_1.http)(),
+    });
+    const targetAccount = await getValidatorAccount(config, signers, targetPublicClient, targetChain);
+    if (!targetAccount) {
+        throw new Error('No account found');
+    }
+    userOp.signature = await targetAccount.signUserOperation(userOp);
+    const userOpHash = (0, account_abstraction_1.getUserOperationHash)({
+        userOperation: userOp,
+        chainId: targetChain.id,
+        entryPointAddress: account_abstraction_1.entryPoint07Address,
+        entryPointVersion: '0.7',
+    });
+    orderPath[0].orderBundle.segments[0].witness.userOpHash = userOpHash;
+    const { hash, appDomainSeparator, contentsType, structHash } = await (0, smart_session_1.hashErc7739)(sourceChain, orderPath, accountAddress);
+    const owners = getOwners(signers);
+    if (!owners) {
+        throw new Error('No owners found');
+    }
+    const signature = await (0, accounts_1.getPackedSignature)(config, owners, targetChain, {
+        address: validator.address,
+        isRoot: false,
+    }, hash, (signature) => {
+        const sessionData = signers?.type === 'session' ? signers.session : null;
+        return sessionData
+            ? (0, smart_session_1.getSessionSignature)(signature, appDomainSeparator, structHash, contentsType, sessionData)
+            : signature;
+    });
+    return signature;
+}
+async function submitUserOp(config, sourceChain, targetChain, userOp, orderPath, signature) {
+    const signedOrderBundle = {
+        ...orderPath[0].orderBundle,
+        originSignatures: Array(orderPath[0].orderBundle.segments.length).fill(signature),
+        targetSignature: signature,
+    };
+    const orchestrator = getOrchestratorByChain(targetChain.id, config.rhinestoneApiKey);
+    const bundleResults = await orchestrator.postSignedOrderBundle([
+        {
+            signedOrderBundle,
+            userOp,
+        },
+    ]);
+    return {
+        type: 'bundle',
+        id: bundleResults[0].bundleId,
+        sourceChain: sourceChain.id,
+        targetChain: targetChain.id,
+    };
+}
+async function submitIntent(config, sourceChain, targetChain, orderPath, signature) {
+    return submitIntentInternal(config, sourceChain, targetChain, orderPath, signature, false);
+}
+function getOrchestratorByChain(chainId, apiKey) {
+    const orchestratorUrl = (0, registry_1.isTestnet)(chainId)
+        ? consts_1.DEV_ORCHESTRATOR_URL
+        : consts_1.PROD_ORCHESTRATOR_URL;
+    return (0, orchestrator_1.getOrchestrator)(apiKey, orchestratorUrl);
+}
+async function getUserOpOrderPath(sourceChain, targetChain, tokenRequests, accountAddress, gasLimit, rhinestoneApiKey) {
+    const accountAccessList = sourceChain
+        ? {
+            chainIds: [sourceChain.id],
+        }
+        : (0, registry_1.getDefaultAccountAccessList)();
+    const metaIntent = {
+        targetChainId: targetChain.id,
+        tokenTransfers: tokenRequests.map((tokenRequest) => ({
+            tokenAddress: tokenRequest.address,
+            amount: tokenRequest.amount,
+        })),
+        targetAccount: accountAddress,
+        targetGasUnits: gasLimit,
+        userOp: (0, orchestrator_1.getEmptyUserOp)(),
+        accountAccessList,
+    };
+    const orchestrator = getOrchestratorByChain(targetChain.id, rhinestoneApiKey);
+    const orderPath = await orchestrator.getOrderPath(metaIntent, accountAddress);
+    return orderPath;
+}
+async function getUserOp(config, targetChain, signers, orderPath, calls, tokenRequests, accountAddress) {
+    const targetPublicClient = (0, viem_1.createPublicClient)({
+        chain: targetChain,
+        transport: (0, viem_1.http)(),
+    });
+    const targetAccount = await getValidatorAccount(config, signers, targetPublicClient, targetChain);
+    if (!targetAccount) {
+        throw new Error('No account found');
+    }
+    const targetBundlerClient = (0, utils_1.getBundlerClient)(config, targetPublicClient);
+    return await targetBundlerClient.prepareUserOperation({
+        account: targetAccount,
+        calls: [...orderPath[0].injectedExecutions, ...calls],
+        stateOverride: [
+            ...tokenRequests.map((request) => {
+                const rootBalanceSlot = (0, registry_1.getTokenRootBalanceSlot)(targetChain, request.address);
+                const balanceSlot = rootBalanceSlot
+                    ? (0, viem_1.keccak256)((0, viem_1.encodeAbiParameters)([{ type: 'address' }, { type: 'uint256' }], [accountAddress, rootBalanceSlot]))
+                    : '0x';
+                return {
+                    address: request.address,
+                    stateDiff: [
+                        {
+                            slot: balanceSlot,
+                            value: (0, viem_1.pad)((0, viem_1.toHex)(request.amount)),
+                        },
+                    ],
+                };
+            }),
+        ],
+    });
+}
+async function submitIntentInternal(config, sourceChain, targetChain, orderPath, signature, deploy) {
+    const signedOrderBundle = {
+        ...orderPath[0].orderBundle,
+        originSignatures: Array(orderPath[0].orderBundle.segments.length).fill(signature),
+        targetSignature: signature,
+    };
+    if (deploy) {
+        await (0, accounts_1.deployTarget)(targetChain, config, false);
+    }
+    const initCode = (0, accounts_1.getBundleInitCode)(config);
+    const orchestrator = getOrchestratorByChain(targetChain.id, config.rhinestoneApiKey);
+    const bundleResults = await orchestrator.postSignedOrderBundle([
+        {
+            signedOrderBundle,
+            initCode,
+        },
+    ]);
+    return {
+        type: 'bundle',
+        id: bundleResults[0].bundleId,
+        sourceChain: sourceChain?.id,
+        targetChain: targetChain.id,
+    };
+}
+async function getValidatorAccount(config, signers, publicClient, chain) {
+    if (!signers) {
+        return undefined;
+    }
+    const withSession = signers.type === 'session' ? signers.session : null;
+    const withGuardians = signers.type === 'guardians' ? signers : null;
+    return withSession
+        ? await (0, accounts_1.getSmartSessionSmartAccount)(config, publicClient, chain, withSession)
+        : withGuardians
+            ? await (0, accounts_1.getGuardianSmartAccount)(config, publicClient, chain, {
+                type: 'ecdsa',
+                accounts: withGuardians.guardians,
+            })
+            : null;
+}
+function getValidator(config, signers) {
+    if (!signers) {
+        return undefined;
+    }
+    const withSession = signers.type === 'session' ? signers.session : null;
+    const withGuardians = signers.type === 'guardians' ? signers : null;
+    return withSession
+        ? (0, validators_1.getSmartSessionValidator)(config)
+        : withGuardians
+            ? (0, core_1.getSocialRecoveryValidator)(withGuardians.guardians)
+            : undefined;
+}
+function getOwners(signers) {
+    if (!signers) {
+        return undefined;
+    }
+    const withSession = signers.type === 'session' ? signers.session : null;
+    const withGuardians = signers.type === 'guardians' ? signers : null;
+    return withSession
+        ? withSession.owners.type === 'ecdsa'
+            ? withSession.owners
+            : undefined
+        : withGuardians
+            ? {
+                type: 'ecdsa',
+                accounts: withGuardians.guardians,
+            }
+            : undefined;
+}

package/dist/src/index.d.ts

@@ -1,34 +1,30 @@
 import type { Address, Chain } from 'viem';
+import { UserOperationReceipt } from 'viem/account-abstraction';
+import { addOwner, recover, removeOwner, setThreshold, setUpRecovery } from './actions';
 import type { TransactionResult } from './execution';
-import type { BundleStatus, MetaIntent, MultiChainCompact, PostOrderBundleResult, SignedMultiChainCompact } from './orchestrator';
+import { BundleData, PreparedTransactionData, SignedTransactionData } from './execution/utils';
+import type { BundleResult, BundleStatus, MetaIntent, MultiChainCompact, PostOrderBundleResult, SignedMultiChainCompact, UserTokenBalance } from './orchestrator';
 import type { Call, Execution, RhinestoneAccountConfig, Session, Transaction } from './types';
+interface RhinestoneAccount {
+    config: RhinestoneAccountConfig;
+    deploy: (chain: Chain, session?: Session) => Promise<void>;
+    prepareTransaction: (transaction: Transaction) => Promise<PreparedTransactionData>;
+    signTransaction: (preparedTransaction: PreparedTransactionData) => Promise<SignedTransactionData>;
+    submitTransaction: (signedTransaction: SignedTransactionData) => Promise<TransactionResult>;
+    sendTransaction: (transaction: Transaction) => Promise<TransactionResult>;
+    waitForExecution: (result: TransactionResult, acceptsPreconfirmations?: boolean) => Promise<BundleResult | UserOperationReceipt>;
+    getAddress: () => Address;
+    getPortfolio: (onTestnets?: boolean) => Promise<UserTokenBalance[]>;
+    getMaxSpendableAmount: (chain: Chain, tokenAddress: Address, gasUnits: bigint) => Promise<bigint>;
+    deploySource: (chain: Chain) => Promise<void>;
+}
 /**
  * Initialize a Rhinestone account
  * 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
  */
-declare function createRhinestoneAccount(config: RhinestoneAccountConfig): Promise<{
-    config: RhinestoneAccountConfig;
-    sendTransaction: (transaction: Transaction) => Promise<TransactionResult>;
-    waitForExecution: (result: TransactionResult, acceptsPreconfirmations?: boolean) => Promise<import("./orchestrator").BundleResult | {
-        actualGasCost: bigint;
-        actualGasUsed: bigint;
-        entryPoint: Address;
-        logs: import("viem").Log<bigint, number, false>[];
-        nonce: bigint;
-        paymaster?: `0x${string}` | undefined;
-        reason?: string | undefined | undefined;
-        receipt: import("viem").TransactionReceipt<bigint, number, "success" | "reverted">;
-        sender: Address;
-        success: boolean;
-        userOpHash: import("viem").Hash;
-    }>;
-    getAddress: () => `0x${string}`;
-    getPortfolio: (onTestnets?: boolean) => Promise<import("./orchestrator").UserTokenBalance[]>;
-    getMaxSpendableAmount: (chain: Chain, tokenAddress: Address, gasUnits: bigint) => Promise<bigint>;
-    deploySource: (chain: Chain) => Promise<void>;
-}>;
-export { createRhinestoneAccount };
-export type { BundleStatus, Session, Call, Execution, MetaIntent, MultiChainCompact, PostOrderBundleResult, SignedMultiChainCompact, };
+declare function createRhinestoneAccount(config: RhinestoneAccountConfig): Promise<RhinestoneAccount>;
+export { createRhinestoneAccount, addOwner, recover, removeOwner, setThreshold, setUpRecovery, };
+export type { RhinestoneAccount, BundleStatus, Session, Call, Execution, MetaIntent, MultiChainCompact, PostOrderBundleResult, SignedMultiChainCompact, BundleData, PreparedTransactionData, SignedTransactionData, TransactionResult, };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAE1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAOpD,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,IAAI,EACJ,SAAS,EACT,uBAAuB,EACvB,OAAO,EACP,WAAW,EACZ,MAAM,SAAS,CAAA;AAEhB;;;;;GAKG;AACH,iBAAe,uBAAuB,CAAC,MAAM,EAAE,uBAAuB;;mCAM9B,WAAW;+BAWvC,iBAAiB;;;;;;;;;;;;;;;mCA+BlB,KAAK,gBACE,OAAO,YACX,MAAM;0BAKW,KAAK;GAanC;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAClC,YAAY,EACV,YAAY,EACZ,OAAO,EACP,IAAI,EACJ,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,GACxB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAM/D,OAAO,EACL,QAAQ,EACR,OAAO,EACP,WAAW,EACX,YAAY,EACZ,aAAa,EACd,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAOpD,OAAO,EACL,UAAU,EACV,uBAAuB,EAEvB,qBAAqB,EAGtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,IAAI,EACJ,SAAS,EACT,uBAAuB,EACvB,OAAO,EACP,WAAW,EACZ,MAAM,SAAS,CAAA;AAEhB,UAAU,iBAAiB;IACzB,MAAM,EAAE,uBAAuB,CAAA;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,kBAAkB,EAAE,CAClB,WAAW,EAAE,WAAW,KACrB,OAAO,CAAC,uBAAuB,CAAC,CAAA;IACrC,eAAe,EAAE,CACf,mBAAmB,EAAE,uBAAuB,KACzC,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACnC,iBAAiB,EAAE,CACjB,iBAAiB,EAAE,qBAAqB,KACrC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC/B,eAAe,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACzE,gBAAgB,EAAE,CAChB,MAAM,EAAE,iBAAiB,EACzB,uBAAuB,CAAC,EAAE,OAAO,KAC9B,OAAO,CAAC,YAAY,GAAG,oBAAoB,CAAC,CAAA;IACjD,UAAU,EAAE,MAAM,OAAO,CAAA;IACzB,YAAY,EAAE,CAAC,UAAU,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAA;IACnE,qBAAqB,EAAE,CACrB,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,OAAO,EACrB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,MAAM,CAAC,CAAA;IACpB,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C;AAED;;;;;GAKG;AACH,iBAAe,uBAAuB,CACpC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAwF5B;AAED,OAAO,EACL,uBAAuB,EACvB,QAAQ,EACR,OAAO,EACP,WAAW,EACX,YAAY,EACZ,aAAa,GACd,CAAA;AACD,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,IAAI,EACJ,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,EACV,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,GAClB,CAAA"}

package/dist/src/index.js

@@ -1,8 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.setUpRecovery = exports.setThreshold = exports.removeOwner = exports.recover = exports.addOwner = void 0;
 exports.createRhinestoneAccount = createRhinestoneAccount;
 const accounts_1 = require("./accounts");
+const actions_1 = require("./actions");
+Object.defineProperty(exports, "addOwner", { enumerable: true, get: function () { return actions_1.addOwner; } });
+Object.defineProperty(exports, "recover", { enumerable: true, get: function () { return actions_1.recover; } });
+Object.defineProperty(exports, "removeOwner", { enumerable: true, get: function () { return actions_1.removeOwner; } });
+Object.defineProperty(exports, "setThreshold", { enumerable: true, get: function () { return actions_1.setThreshold; } });
+Object.defineProperty(exports, "setUpRecovery", { enumerable: true, get: function () { return actions_1.setUpRecovery; } });
 const execution_1 = require("./execution");
+const utils_1 = require("./execution/utils");
 /**
  * Initialize a Rhinestone account
  * Note: accounts are deployed onchain only when the first transaction is sent.
@@ -10,6 +18,18 @@ const execution_1 = require("./execution");
  * @returns account
  */
 async function createRhinestoneAccount(config) {
+    function deploy(chain, session) {
+        return (0, accounts_1.deploy)(config, chain, session);
+    }
+    function prepareTransaction(transaction) {
+        return (0, utils_1.prepareTransaction)(config, transaction);
+    }
+    function signTransaction(preparedTransaction) {
+        return (0, utils_1.signTransaction)(config, preparedTransaction);
+    }
+    function submitTransaction(signedTransaction) {
+        return (0, utils_1.submitTransaction)(config, signedTransaction);
+    }
     /**
      * Sign and send a transaction
      * @param transaction Transaction to send
@@ -57,6 +77,10 @@ async function createRhinestoneAccount(config) {
     }
     return {
         config,
+        deploy,
+        prepareTransaction,
+        signTransaction,
+        submitTransaction,
         sendTransaction,
         waitForExecution,
         getAddress,

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

@@ -2,6 +2,7 @@ import { type Address, type Chain, type Hex } from 'viem';
 import type { RhinestoneAccountConfig } from '../types';
 import { type Module } from './common';
 import { HOOK_ADDRESS } from './omni-account';
+import { getTrustAttesterCall, getTrustedAttesters } from './registry';
 import { getOwnerValidator } from './validators';
 interface WebAuthnData {
     authenticatorData: Hex;
@@ -29,5 +30,5 @@ interface ModeleSetup {
 declare function getSetup(config: RhinestoneAccountConfig): ModeleSetup;
 declare function getWebauthnValidatorSignature({ webauthn, signature, usePrecompiled, }: WebauthnValidatorSignature): `0x${string}`;
 declare function isRip7212SupportedNetwork(chain: Chain): boolean;
-export { HOOK_ADDRESS, getSetup, getOwnerValidator, getWebauthnValidatorSignature, isRip7212SupportedNetwork, };
+export { HOOK_ADDRESS, getSetup, getTrustAttesterCall, getTrustedAttesters, getOwnerValidator, getWebauthnValidatorSignature, isRip7212SupportedNetwork, };
 //# sourceMappingURL=index.d.ts.map

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,EACL,KAAK,OAAO,EAEZ,KAAK,KAAK,EAEV,KAAK,GAAG,EAET,MAAM,MAAM,CAAA;AAYb,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAEvD,OAAO,EAGL,KAAK,MAAM,EACZ,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,YAAY,EAMb,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAA4B,MAAM,cAAc,CAAA;AAK1E,UAAU,YAAY;IACpB,iBAAiB,EAAE,GAAG,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAA;CAC3B;AAED,UAAU,0BAA0B;IAClC,QAAQ,EAAE,YAAY,CAAA;IACtB,SAAS,EAAE,iBAAiB,GAAG,GAAG,GAAG,UAAU,CAAA;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,UAAU,iBAAiB;IACzB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,UAAU,WAAW;IACnB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,OAAO,EAAE,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,iBAAS,QAAQ,CAAC,MAAM,EAAE,uBAAuB,GAAG,WAAW,CAoF9D;AAED,iBAAS,6BAA6B,CAAC,EACrC,QAAQ,EACR,SAAS,EACT,cAAsB,GACvB,EAAE,0BAA0B,iBA6C5B;AAED,iBAAS,yBAAyB,CAAC,KAAK,EAAE,KAAK,WAa9C;AAaD,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,6BAA6B,EAC7B,yBAAyB,GAC1B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,KAAK,EAEV,KAAK,GAAG,EAET,MAAM,MAAM,CAAA;AAYb,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAEvD,OAAO,EAGL,KAAK,MAAM,EACZ,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,YAAY,EAMb,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAA4B,MAAM,cAAc,CAAA;AAM1E,UAAU,YAAY;IACpB,iBAAiB,EAAE,GAAG,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAA;CAC3B;AAED,UAAU,0BAA0B;IAClC,QAAQ,EAAE,YAAY,CAAA;IACtB,SAAS,EAAE,iBAAiB,GAAG,GAAG,GAAG,UAAU,CAAA;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,UAAU,iBAAiB;IACzB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,UAAU,WAAW;IACnB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,OAAO,EAAE,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,iBAAS,QAAQ,CAAC,MAAM,EAAE,uBAAuB,GAAG,WAAW,CA2F9D;AAED,iBAAS,6BAA6B,CAAC,EACrC,QAAQ,EACR,SAAS,EACT,cAAsB,GACvB,EAAE,0BAA0B,iBA6C5B;AAED,iBAAS,yBAAyB,CAAC,KAAK,EAAE,KAAK,WAa9C;AAaD,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,6BAA6B,EAC7B,yBAAyB,GAC1B,CAAA"}

package/dist/src/modules/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOwnerValidator = exports.HOOK_ADDRESS = void 0;
+exports.getOwnerValidator = exports.getTrustedAttesters = exports.getTrustAttesterCall = exports.HOOK_ADDRESS = void 0;
 exports.getSetup = getSetup;
 exports.getWebauthnValidatorSignature = getWebauthnValidatorSignature;
 exports.isRip7212SupportedNetwork = isRip7212SupportedNetwork;
@@ -9,8 +9,12 @@ const chains_1 = require("viem/chains");
 const common_1 = require("./common");
 const omni_account_1 = require("./omni-account");
 Object.defineProperty(exports, "HOOK_ADDRESS", { enumerable: true, get: function () { return omni_account_1.HOOK_ADDRESS; } });
+const registry_1 = require("./registry");
+Object.defineProperty(exports, "getTrustAttesterCall", { enumerable: true, get: function () { return registry_1.getTrustAttesterCall; } });
+Object.defineProperty(exports, "getTrustedAttesters", { enumerable: true, get: function () { return registry_1.getTrustedAttesters; } });
 const validators_1 = require("./validators");
 Object.defineProperty(exports, "getOwnerValidator", { enumerable: true, get: function () { return validators_1.getOwnerValidator; } });
+const core_1 = require("./validators/core");
 const SMART_SESSION_COMPATIBILITY_FALLBACK_ADDRESS = '0x12cae64c42f362e7d5a847c2d33388373f629177';
 function getSetup(config) {
     const ownerValidator = (0, validators_1.getOwnerValidator)(config);
@@ -19,6 +23,10 @@ function getSetup(config) {
     if (smartSessionValidator) {
         validators.push(smartSessionValidator);
     }
+    if (config.recovery) {
+        const socialRecoveryValidator = (0, core_1.getSocialRecoveryValidator)(config.recovery.guardians, config.recovery.threshold);
+        validators.push(socialRecoveryValidator);
+    }
     const executors = [
         {
             address: omni_account_1.SAME_CHAIN_MODULE_ADDRESS,

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

@@ -0,0 +1,9 @@
+import { Address, PublicClient } from 'viem';
+import { RhinestoneAccountConfig } from '../types';
+declare function getTrustAttesterCall(config: RhinestoneAccountConfig): {
+    to: `0x${string}`;
+    data: `0x${string}`;
+};
+declare function getTrustedAttesters(client: PublicClient, account: Address): Promise<readonly Address[]>;
+export { getTrustAttesterCall, getTrustedAttesters };
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../modules/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsB,YAAY,EAAE,MAAM,MAAM,CAAA;AAEhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAIlD,iBAAS,oBAAoB,CAAC,MAAM,EAAE,uBAAuB;;;EA0B5D;AAED,iBAAe,mBAAmB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAyB7B;AAED,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,CAAA"}

package/dist/src/modules/registry.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTrustAttesterCall = getTrustAttesterCall;
+exports.getTrustedAttesters = getTrustedAttesters;
+const viem_1 = require("viem");
+const _1 = require(".");
+const omni_account_1 = require("./omni-account");
+function getTrustAttesterCall(config) {
+    const moduleSetup = (0, _1.getSetup)(config);
+    return {
+        to: omni_account_1.RHINESTONE_MODULE_REGISTRY_ADDRESS,
+        data: (0, viem_1.encodeFunctionData)({
+            abi: [
+                {
+                    name: 'trustAttesters',
+                    type: 'function',
+                    inputs: [
+                        {
+                            name: 'threshold',
+                            type: 'uint8',
+                        },
+                        {
+                            name: 'attesters',
+                            type: 'address[]',
+                        },
+                    ],
+                    outputs: [],
+                },
+            ],
+            functionName: 'trustAttesters',
+            args: [moduleSetup.threshold, moduleSetup.attesters],
+        }),
+    };
+}
+async function getTrustedAttesters(client, account) {
+    return await client.readContract({
+        address: omni_account_1.RHINESTONE_MODULE_REGISTRY_ADDRESS,
+        abi: [
+            {
+                type: 'function',
+                stateMutability: 'view',
+                name: 'findTrustedAttesters',
+                inputs: [
+                    {
+                        type: 'address',
+                        name: 'smartAccount',
+                    },
+                ],
+                outputs: [
+                    {
+                        type: 'address[]',
+                        name: 'attesters',
+                    },
+                ],
+            },
+        ],
+        functionName: 'findTrustedAttesters',
+        args: [account],
+    });
+}

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

@@ -1,8 +1,10 @@
-import { type Hex } from 'viem';
+import { Account, type Address, type Hex } from 'viem';
 import type { OwnerSet, RhinestoneAccountConfig } from '../../types';
 import { type Module } from '../common';
+declare const OWNABLE_VALIDATOR_ADDRESS: Address;
 declare function getOwnerValidator(config: RhinestoneAccountConfig): Module;
 declare function getMockSignature(ownerSet: OwnerSet): Hex;
 declare function getValidator(owners: OwnerSet): Module;
-export { getOwnerValidator, getValidator, getMockSignature };
+declare function getSocialRecoveryValidator(guardians: Account[], threshold?: number): Module;
+export { OWNABLE_VALIDATOR_ADDRESS, getOwnerValidator, getSocialRecoveryValidator, getValidator, getMockSignature, };
 //# 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,EAKL,KAAK,GAAG,EAIT,MAAM,MAAM,CAAA;AAEb,OAAO,KAAK,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAEpE,OAAO,EAA4B,KAAK,MAAM,EAAE,MAAM,WAAW,CAAA;AAwBjE,iBAAS,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,UAEzD;AAED,iBAAS,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,GAAG,CAUjD;AAED,iBAAS,YAAY,CAAC,MAAM,EAAE,QAAQ,UAarC;AAkGD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../modules/validators/core.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,OAAO,EAIZ,KAAK,GAAG,EAIT,MAAM,MAAM,CAAA;AAEb,OAAO,KAAK,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAEpE,OAAO,EAA4B,KAAK,MAAM,EAAE,MAAM,WAAW,CAAA;AAcjE,QAAA,MAAM,yBAAyB,EAAE,OACa,CAAA;AAY9C,iBAAS,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,UAEzD;AAED,iBAAS,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,GAAG,CAUjD;AAED,iBAAS,YAAY,CAAC,MAAM,EAAE,QAAQ,UAarC;AAqFD,iBAAS,0BAA0B,CACjC,SAAS,EAAE,OAAO,EAAE,EACpB,SAAS,SAAI,GACZ,MAAM,CAsBR;AAeD,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,EAC1B,YAAY,EACZ,gBAAgB,GACjB,CAAA"}

package/dist/src/modules/validators/core.js

@@ -1,12 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.OWNABLE_VALIDATOR_ADDRESS = void 0;
 exports.getOwnerValidator = getOwnerValidator;
+exports.getSocialRecoveryValidator = getSocialRecoveryValidator;
 exports.getValidator = getValidator;
 exports.getMockSignature = getMockSignature;
 const viem_1 = require("viem");
 const common_1 = require("../common");
 const OWNABLE_VALIDATOR_ADDRESS = '0x2483DA3A338895199E5e538530213157e931Bf06';
+exports.OWNABLE_VALIDATOR_ADDRESS = OWNABLE_VALIDATOR_ADDRESS;
 const WEBAUTHN_VALIDATOR_ADDRESS = '0xb9E9CcF81464482897c687Dc876606961C547A77';
+const SOCIAL_RECOVERY_VALIDATOR_ADDRESS = '0xA04D053b3C8021e8D5bF641816c42dAA75D8b597';
 const ECDSA_MOCK_SIGNATURE = '0x81d4b4981670cb18f99f0b4a66446df1bf5b204d24cfcb659bf38ba27a4359b5711649ec2423c5e1247245eba2964679b6a1dbb85c992ae40b9b00c6935b02ff1b';
 const WEBAUTHN_MOCK_SIGNATURE = '0x00000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000001635bc6d0f68ff895cae8a288ecf7542a6a9cd555df784b73e1e2ea7e9104b1db15e9015d280cb19527881c625fee43fd3a405d5b0d199a8c8e6589a7381209e40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002549960de5880e8c687434170f6476605b8fe4aeb9a28632c7995cf3ba831d97631d0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f47b2274797065223a22776562617574686e2e676574222c226368616c6c656e6765223a22746278584e465339585f3442797231634d77714b724947422d5f3330613051685a36793775634d30424f45222c226f726967696e223a22687474703a2f2f6c6f63616c686f73743a33303030222c2263726f73734f726967696e223a66616c73652c20226f746865725f6b6579735f63616e5f62655f61646465645f68657265223a22646f206e6f7420636f6d7061726520636c69656e74446174614a534f4e20616761696e737420612074656d706c6174652e205365652068747470733a2f2f676f6f2e676c2f796162506578227d000000000000000000000000';
 function getOwnerValidator(config) {
@@ -103,6 +107,26 @@ function getWebAuthnValidator(webAuthnCredential) {
         type: common_1.MODULE_TYPE_ID_VALIDATOR,
     };
 }
+function getSocialRecoveryValidator(guardians, threshold = 1) {
+    const guardianAddresses = guardians.map((guardian) => guardian.address);
+    guardianAddresses.sort();
+    return {
+        type: common_1.MODULE_TYPE_ID_VALIDATOR,
+        address: SOCIAL_RECOVERY_VALIDATOR_ADDRESS,
+        initData: (0, viem_1.encodeAbiParameters)([
+            {
+                type: 'uint256',
+                name: 'threshold',
+            },
+            {
+                type: 'address[]',
+                name: 'guardians',
+            },
+        ], [BigInt(threshold), guardianAddresses]),
+        deInitData: '0x',
+        additionalContext: '0x',
+    };
+}
 function parsePublicKey(publicKey) {
     const bytes = typeof publicKey === 'string' ? (0, viem_1.hexToBytes)(publicKey) : publicKey;
     const offset = bytes.length === 65 ? 1 : 0;