@biconomy/abstractjs
Version:
SDK for Biconomy integration with support for account abstraction, smart accounts, ERC-4337.
111 lines • 4.01 kB
JavaScript
import { encodeFunctionData, getAddress } from "viem";
import { sendUserOperation } from "viem/account-abstraction";
import { getAction, parseAccount } from "viem/utils";
import { AccountNotFoundError } from "../../../account/utils/AccountNotFound.js";
import { addressEquals } from "../../../account/utils/Utils.js";
import { SMART_SESSIONS_ADDRESS } from "../../../constants/index.js";
import { parseModuleTypeId } from "./supportsModule.js";
/**
* Installs a module on a given smart account.
*
* @param client - The client instance.
* @param parameters - Parameters including the smart account, module to install, and optional gas settings.
* @returns The hash of the user operation as a hexadecimal string.
* @throws {AccountNotFoundError} If the account is not found.
*
* @example
* import { installModule } from '@biconomy/abstractjs'
*
* const userOpHash = await installModule(nexusClient, {
* module: {
* type: 'executor',
* address: '0x...',
* context: '0x'
* }
* })
* console.log(userOpHash) // '0x...'
*/
export async function installModule(client, parameters) {
const { account: account_ = client.account, maxFeePerGas, maxPriorityFeePerGas, nonce, module, module: { address, initData, type }, ...rest } = parameters;
if (!account_) {
throw new AccountNotFoundError({
docsPath: "/nexus-client/methods#sendtransaction"
});
}
const account = parseAccount(account_);
const calls = await toInstallWithSafeSenderCalls(account, {
address,
initData,
type
});
const sendUserOperationParams = {
calls,
maxFeePerGas,
maxPriorityFeePerGas,
nonce,
account,
...rest
};
return getAction(client, sendUserOperation, "sendUserOperation")(sendUserOperationParams);
}
export const toSafeSenderCalls = async (smartAccount, { address }) => {
const meeValidatorAddress = smartAccount.version.validatorAddress;
return addressEquals(address, SMART_SESSIONS_ADDRESS)
? [
{
to: meeValidatorAddress,
value: BigInt(0),
data: encodeFunctionData({
abi: [
{
name: "addSafeSender",
type: "function",
stateMutability: "nonpayable",
inputs: [{ type: "address", name: "sender" }],
outputs: []
}
],
functionName: "addSafeSender",
args: [address]
})
}
]
: [];
};
export const toInstallModuleCalls = async (account, { address, initData, type }) => [
{
to: account.address,
value: BigInt(0),
data: encodeFunctionData({
abi: [
{
name: "installModule",
type: "function",
stateMutability: "nonpayable",
inputs: [
{
type: "uint256",
name: "moduleTypeId"
},
{
type: "address",
name: "module"
},
{
type: "bytes",
name: "initData"
}
],
outputs: []
}
],
functionName: "installModule",
args: [parseModuleTypeId(type), getAddress(address), initData ?? "0x"]
})
}
];
export const toInstallWithSafeSenderCalls = async (account, { address, initData, type }) => [
...(await toInstallModuleCalls(account, { address, initData, type })),
...(await toSafeSenderCalls(account, { address, type }))
];
//# sourceMappingURL=installModule.js.map