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

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

@@ -0,0 +1,149 @@
+import { encodeAbiParameters } from 'viem';
+import { moduleTypeId } from './erc7579-abi.js';
+import { ENS_HCA_MODULE } from './validators/ens.js';
+import { OWNABLE_VALIDATOR_ADDRESS } from './validators/ownable.js';
+const sentinel = '0x0000000000000000000000000000000000000001';
+const paginationAbi = (name) => [
+    {
+        name,
+        type: 'function',
+        inputs: [
+            { name: 'cursor', type: 'address' },
+            { name: 'size', type: 'uint256' },
+        ],
+        outputs: [
+            { name: 'array', type: 'address[]' },
+            { name: 'next', type: 'address' },
+        ],
+        stateMutability: 'view',
+    },
+];
+export async function readInstalledModules(input) {
+    if (input.accountKind === 'eoa')
+        return [];
+    if (input.accountKind === 'kernel')
+        throw new Error('Kernel not supported');
+    const functionName = input.kind === 'validator'
+        ? 'getValidatorsPaginated'
+        : 'getExecutorsPaginated';
+    const result = await input.rpc.readContract({ chain: input.chain }, {
+        address: input.account,
+        abi: paginationAbi(functionName),
+        functionName,
+        args: [sentinel, 100n],
+    });
+    return result[0];
+}
+export async function readValidatorInitialized(input) {
+    return input.rpc.readContract({ chain: input.chain }, {
+        address: input.validator,
+        abi: [
+            {
+                name: 'isInitialized',
+                type: 'function',
+                stateMutability: 'view',
+                inputs: [{ name: 'smartAccount', type: 'address' }],
+                outputs: [{ name: '', type: 'bool' }],
+            },
+        ],
+        functionName: 'isInitialized',
+        args: [input.account],
+    });
+}
+const moduleInstalledAbi = [
+    {
+        type: 'function',
+        name: 'isModuleInstalled',
+        inputs: [
+            { type: 'uint256', name: 'moduleTypeId' },
+            { type: 'address', name: 'module' },
+            { type: 'bytes', name: 'additionalContext' },
+        ],
+        outputs: [{ type: 'bool', name: 'isInstalled' }],
+        stateMutability: 'view',
+    },
+];
+export async function readModuleInstallations(input) {
+    const results = await input.rpc.multicall({ chain: input.chain }, input.modules.map((module) => ({
+        address: input.account,
+        abi: moduleInstalledAbi,
+        functionName: 'isModuleInstalled',
+        args: [
+            moduleTypeId(module.kind),
+            module.address,
+            module.additionalContext,
+        ],
+    })));
+    return results.map(({ result }) => result === true);
+}
+export async function readOwners(input) {
+    let validator = OWNABLE_VALIDATOR_ADDRESS;
+    if (input.accountKind === 'hca') {
+        validator = input.hcaFactory
+            ? await input.rpc.readContract({ chain: input.chain }, {
+                address: input.hcaFactory,
+                abi: [
+                    {
+                        name: 'initDataParser',
+                        type: 'function',
+                        stateMutability: 'view',
+                        inputs: [],
+                        outputs: [{ name: '', type: 'address' }],
+                    },
+                ],
+                functionName: 'initDataParser',
+            })
+            : ENS_HCA_MODULE;
+    }
+    const results = await input.rpc.multicall({ chain: input.chain }, [
+        {
+            address: validator,
+            abi: [
+                {
+                    name: 'getOwners',
+                    type: 'function',
+                    inputs: [{ name: 'account', type: 'address' }],
+                    outputs: [{ name: '', type: 'address[]' }],
+                    stateMutability: 'view',
+                },
+            ],
+            functionName: 'getOwners',
+            args: [input.account],
+        },
+        {
+            address: validator,
+            abi: [
+                {
+                    name: 'threshold',
+                    type: 'function',
+                    inputs: [{ name: 'module', type: 'address' }],
+                    outputs: [{ name: '', type: 'uint256' }],
+                    stateMutability: 'view',
+                },
+            ],
+            functionName: 'threshold',
+            args: [input.account],
+        },
+    ]);
+    const [owners, threshold] = results;
+    if (owners.error ||
+        threshold.error ||
+        !owners.result ||
+        threshold.result === undefined) {
+        return null;
+    }
+    return { accounts: owners.result, threshold: Number(threshold.result) };
+}
+export function encodeAccountModuleDeInitData(input) {
+    if (input.module.kind !== 'validator' ||
+        !['nexus', 'safe', 'startale'].includes(input.accountKind)) {
+        return input.module.deInitData;
+    }
+    const index = input.installed.findIndex((address) => address.toLowerCase() === input.module.address.toLowerCase());
+    if (index < 0)
+        return input.module.deInitData;
+    return encodeAbiParameters([{ type: 'address' }, { type: 'bytes' }], [
+        index === 0 ? sentinel : input.installed[index - 1],
+        input.module.deInitData,
+    ]);
+}

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

@@ -0,0 +1,46 @@
+import type { Address, Hex } from 'viem';
+export type ModuleKind = 'validator' | 'executor' | 'fallback' | 'hook';
+export interface ModuleInput {
+    type: ModuleKind;
+    address: Address;
+    initData?: Hex;
+    deInitData?: Hex;
+    additionalContext?: Hex;
+}
+export type ModuleDataSelection = {
+    readonly source: 'explicit';
+    readonly value: Hex;
+} | {
+    readonly source: 'omitted';
+};
+export interface ConfiguredModule extends ModuleId {
+    readonly initData: ModuleDataSelection;
+    readonly deInitData: ModuleDataSelection;
+    readonly additionalContext: ModuleDataSelection;
+}
+export interface ModuleId {
+    readonly kind: ModuleKind;
+    readonly address: Address;
+}
+export interface ResolvedModule extends ModuleId {
+    readonly initData: Hex;
+    readonly deInitData: Hex;
+    readonly additionalContext: Hex;
+}
+export interface ModuleCapabilities {
+    readonly installable: boolean;
+    readonly uninstallable: boolean;
+    readonly supportsInitializationRead: boolean;
+}
+export interface ModuleInstallationPlan {
+    readonly module: ResolvedModule;
+    readonly operation: 'install' | 'uninstall';
+    readonly accountCallData: Hex;
+}
+export interface ModuleSetup {
+    readonly validators: readonly ResolvedModule[];
+    readonly executors: readonly ResolvedModule[];
+    readonly hooks: readonly ResolvedModule[];
+    readonly fallbacks: readonly ResolvedModule[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../modules/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAExC,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAA;AAEvE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,UAAU,CAAC,EAAE,GAAG,CAAA;IAChB,iBAAiB,CAAC,EAAE,GAAG,CAAA;CACxB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAA;AAElC,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAA;IACtC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,iBAAiB,EAAE,mBAAmB,CAAA;CAChD;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAA;IACxB,QAAQ,CAAC,iBAAiB,EAAE,GAAG,CAAA;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAA;CAC7C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,CAAA;IAC3C,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAA;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAA;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;CAC9C"}

package/dist/src/modules/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,4 @@
+import type { ResolvedModule } from '../types.js';
+import type { ResolvedValidatorDefinition, ValidatorCapabilities, ValidatorSigningPurpose } from './types.js';
+export declare function getValidatorCapabilities(definition: ResolvedValidatorDefinition, module: ResolvedModule, accountProfile: string, purpose: ValidatorSigningPurpose, supportsOriginReuse: boolean): ValidatorCapabilities;
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../../modules/validators/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAQ9C,OAAO,KAAK,EACV,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,SAAS,CAAA;AAEhB,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,2BAA2B,EACvC,MAAM,EAAE,cAAc,EACtB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,uBAAuB,EAChC,mBAAmB,EAAE,OAAO,GAC3B,qBAAqB,CAwDvB"}

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

@@ -0,0 +1,58 @@
+import { ENS_HCA_MODULE } from './ens.js';
+import { K1_DEFAULT_VALIDATOR_ADDRESS } from './k1.js';
+import { OWNABLE_BETA_VALIDATOR_ADDRESS, OWNABLE_V0_VALIDATOR_ADDRESS, OWNABLE_VALIDATOR_ADDRESS, } from './ownable.js';
+export function getValidatorCapabilities(definition, module, accountProfile, purpose, supportsOriginReuse) {
+    const nested = definition.kind === 'multi-factor';
+    const legacyOwnable = [
+        OWNABLE_V0_VALIDATOR_ADDRESS.toLowerCase(),
+        OWNABLE_BETA_VALIDATOR_ADDRESS.toLowerCase(),
+    ].includes(module.address.toLowerCase());
+    const validatorRecovery = purpose !== 'user-operation' &&
+        [OWNABLE_VALIDATOR_ADDRESS, ENS_HCA_MODULE]
+            .map((address) => address.toLowerCase())
+            .includes(module.address.toLowerCase())
+        ? 'validator-offset-4'
+        : 'ethereum';
+    return {
+        compatibilityKey: {
+            validatorKind: definition.kind,
+            moduleAddress: module.address,
+            accountProfile,
+            purpose,
+        },
+        payloadKinds: [
+            'message',
+            'typed-data',
+            'intent',
+            'user-operation',
+            'session-enable',
+        ],
+        signatureModes: ['owner'],
+        signerTopology: nested
+            ? 'nested-threshold'
+            : definition.owners.length === 1
+                ? 'single'
+                : 'threshold',
+        supportsIndependentSigning: definition.kind !== 'smart-session' &&
+            module.address.toLowerCase() !==
+                K1_DEFAULT_VALIDATOR_ADDRESS.toLowerCase(),
+        supportsOriginReuse,
+        supportsMockSignature: true,
+        supportsEip712: !legacyOwnable,
+        recoveryEncoding: validatorRecovery,
+        contributionCodec: nested
+            ? {
+                kind: 'nested-threshold',
+                validator: module,
+                factorOrder: definition.validators.map((factor) => factor.id),
+                threshold: definition.threshold,
+            }
+            : {
+                kind: 'ordered-threshold',
+                validator: module,
+                ownerOrder: definition.owners.map((owner) => owner.id),
+                threshold: definition.threshold,
+                recoveryEncoding: validatorRecovery,
+            },
+    };
+}

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

@@ -0,0 +1,4 @@
+import type { Hex } from 'viem';
+import type { ValidatorContributionCodec, ValidatorContributionInput } from './types.js';
+export declare function encodeValidatorContribution(codec: ValidatorContributionCodec, contributions: readonly ValidatorContributionInput[]): Hex;
+//# sourceMappingURL=contribution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contribution.d.ts","sourceRoot":"","sources":["../../../../modules/validators/contribution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAI/B,OAAO,KAAK,EACV,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,SAAS,CAAA;AAGhB,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,EACjC,aAAa,EAAE,SAAS,0BAA0B,EAAE,GACnD,GAAG,CAgEL"}

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

@@ -0,0 +1,64 @@
+import { encodeMultiFactorContribution } from './multi-factor.js';
+import { encodeEcdsaValidatorContribution } from './ownable.js';
+import { encodeSmartSessionContribution } from './smart-sessions/signature.js';
+import { encodeWebauthnValidatorContribution } from './webauthn.js';
+export function encodeValidatorContribution(codec, contributions) {
+    switch (codec.kind) {
+        case 'ordered-threshold': {
+            const ecdsa = contributions.filter((contribution) => contribution.kind === 'ecdsa');
+            const webauthn = contributions.filter((contribution) => contribution.kind === 'webauthn');
+            if (ecdsa.length > 0 && webauthn.length > 0) {
+                throw new Error('Atomic validators cannot mix signer result kinds');
+            }
+            if (webauthn.length > 0) {
+                if (!codec.webauthn) {
+                    throw new Error('WebAuthn contribution codec context is missing');
+                }
+                return encodeWebauthnValidatorContribution({
+                    ownerOrder: codec.ownerOrder,
+                    threshold: codec.threshold,
+                    ...codec.webauthn,
+                    contributions: webauthn,
+                });
+            }
+            if (ecdsa.length !== contributions.length) {
+                throw new Error('Ordered validator received an incompatible result');
+            }
+            return encodeEcdsaValidatorContribution({
+                ownerOrder: codec.ownerOrder,
+                threshold: codec.threshold,
+                recoveryEncoding: codec.recoveryEncoding,
+                contributions: ecdsa,
+            });
+        }
+        case 'nested-threshold': {
+            const factors = contributions.filter((contribution) => contribution.kind === 'factor');
+            if (factors.length !== contributions.length) {
+                throw new Error('Nested validator received a non-factor contribution');
+            }
+            return encodeMultiFactorContribution({
+                factorOrder: codec.factorOrder,
+                threshold: codec.threshold,
+                contributions: factors,
+            });
+        }
+        case 'smart-session': {
+            const signature = codec.signerCodec
+                ? encodeValidatorContribution(codec.signerCodec, contributions)
+                : contributions.length === 1 && contributions[0]?.kind === 'session'
+                    ? contributions[0].signature
+                    : undefined;
+            if (!signature)
+                throw new Error('Smart Session signer result is missing');
+            return encodeSmartSessionContribution({
+                mode: codec.mode,
+                permissionId: codec.permissionId,
+                signature,
+                ...(codec.claimPolicyData
+                    ? { claimPolicyData: codec.claimPolicyData }
+                    : {}),
+                ...(codec.enableData ? { enableData: codec.enableData } : {}),
+            });
+        }
+    }
+}

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

@@ -0,0 +1,3 @@
+import type { ResolvedValidatorDefinition, ValidatorInput } from './types.js';
+export declare function defineValidator(input: ValidatorInput, id?: string, publicId?: number | `0x${string}`): ResolvedValidatorDefinition;
+//# sourceMappingURL=definition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../modules/validators/definition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,2BAA2B,EAC3B,cAAc,EAGf,MAAM,SAAS,CAAA;AAsEhB,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,EAAE,SAAoB,EACtB,QAAQ,GAAE,MAAM,GAAG,KAAK,MAAM,EAAM,GACnC,2BAA2B,CAe7B"}

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

@@ -0,0 +1,68 @@
+import { ecdsaSignerId, webauthnSignerId } from './signer-id.js';
+function moduleSelection(address, profile) {
+    return address === undefined
+        ? { source: 'default', profile }
+        : { source: 'explicit', address };
+}
+function defineAtomicValidator(input, id, publicId) {
+    const ownerId = (index) => `${id}/owner/${index}`;
+    switch (input.type) {
+        case 'ecdsa':
+            return {
+                kind: 'ecdsa',
+                id,
+                publicId,
+                module: moduleSelection(input.module, 'ownable'),
+                owners: input.accounts.map((account, index) => ({
+                    kind: 'ecdsa',
+                    id: ownerId(index),
+                    signerId: ecdsaSignerId(account),
+                    account,
+                })),
+                threshold: input.threshold ?? 1,
+            };
+        case 'ens':
+            return {
+                kind: 'ens',
+                id,
+                publicId,
+                module: moduleSelection(undefined, 'ens'),
+                owners: input.owners.map((owner, index) => ({
+                    kind: 'ens',
+                    id: ownerId(index),
+                    signerId: ecdsaSignerId(owner.account),
+                    account: owner.account,
+                    ...(owner.expiration ? { expiration: owner.expiration } : {}),
+                })),
+                threshold: input.threshold ?? 1,
+            };
+        case 'passkey':
+            return {
+                kind: 'passkey',
+                id,
+                publicId,
+                module: moduleSelection(input.module, 'webauthn'),
+                owners: input.accounts.map((account, index) => ({
+                    kind: 'webauthn',
+                    id: ownerId(index),
+                    signerId: webauthnSignerId(account),
+                    account,
+                })),
+                threshold: input.threshold ?? 1,
+            };
+    }
+}
+export function defineValidator(input, id = 'owner-validator', publicId = 0) {
+    if (input.type !== 'multi-factor') {
+        return defineAtomicValidator(input, id, Number(publicId));
+    }
+    const definition = {
+        kind: 'multi-factor',
+        id,
+        publicId,
+        module: moduleSelection(input.module, 'multi-factor'),
+        validators: input.validators.map((validator, index) => defineAtomicValidator(validator, `${id}/factor/${index}`, index)),
+        threshold: input.threshold ?? 1,
+    };
+    return definition;
+}

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

@@ -0,0 +1,5 @@
+import type { ResolvedModule } from '../types.js';
+import type { AtomicValidatorDefinition } from './types.js';
+export declare const ENS_HCA_MODULE: "0x5049ecBd4d961aE6DFEED9b7ccCe7f026454970E";
+export declare function resolveEnsValidator(definition: AtomicValidatorDefinition): ResolvedModule;
+//# sourceMappingURL=ens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ens.d.ts","sourceRoot":"","sources":["../../../../modules/validators/ens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAExD,eAAO,MAAM,cAAc,EACzB,4CAAqD,CAAA;AAEvD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,yBAAyB,GACpC,cAAc,CAkChB"}

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

@@ -0,0 +1,34 @@
+import { encodeAbiParameters, maxUint48 } from 'viem';
+export const ENS_HCA_MODULE = '0x5049ecBd4d961aE6DFEED9b7ccCe7f026454970E';
+export function resolveEnsValidator(definition) {
+    const owners = definition.owners
+        .map((owner) => {
+        if (owner.kind !== 'ens') {
+            throw new Error('ENS validator contains a non-ENS owner');
+        }
+        return {
+            addr: owner.account.address.toLowerCase(),
+            expiration: owner.expiration
+                ? Math.floor(owner.expiration.getTime() / 1000)
+                : Number(maxUint48),
+        };
+    })
+        .sort((left, right) => left.addr.localeCompare(right.addr));
+    return {
+        kind: 'validator',
+        address: ENS_HCA_MODULE,
+        initData: encodeAbiParameters([
+            { name: 'threshold', type: 'uint256' },
+            {
+                name: 'owners',
+                type: 'tuple[]',
+                components: [
+                    { name: 'addr', type: 'address' },
+                    { name: 'expiration', type: 'uint48' },
+                ],
+            },
+        ], [BigInt(definition.threshold), owners]),
+        deInitData: '0x',
+        additionalContext: '0x',
+    };
+}

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

@@ -0,0 +1,2 @@
+export declare const K1_DEFAULT_VALIDATOR_ADDRESS: "0x00000072f286204bb934ed49d8969e86f7dec7b1";
+//# sourceMappingURL=k1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"k1.d.ts","sourceRoot":"","sources":["../../../../modules/validators/k1.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,EACvC,4CAAqD,CAAA"}

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

@@ -0,0 +1 @@
+export const K1_DEFAULT_VALIDATOR_ADDRESS = '0x00000072f286204bb934ed49d8969e86f7dec7b1';

package/dist/src/modules/validators/multi-factor.d.ts

@@ -0,0 +1,18 @@
+import { type Address, type Hex } from 'viem';
+import type { ResolvedModule } from '../types.js';
+import type { MultiFactorValidatorDefinition } from './types.js';
+export declare const MULTI_FACTOR_VALIDATOR_ADDRESS: Address;
+export type AtomicValidatorResolver = (definition: MultiFactorValidatorDefinition['validators'][number]) => ResolvedModule;
+export declare function encodeValidatorId(id: number | Hex): Hex;
+export declare function resolveMultiFactorValidator(definition: MultiFactorValidatorDefinition, resolveAtomic: AtomicValidatorResolver): ResolvedModule;
+export declare function encodeMultiFactorContribution(input: {
+    readonly factorOrder: readonly string[];
+    readonly threshold: number;
+    readonly contributions: readonly {
+        readonly factorId: string;
+        readonly publicId: number | Hex;
+        readonly validator: `0x${string}`;
+        readonly contribution: Hex;
+    }[];
+}): Hex;
+//# sourceMappingURL=multi-factor.d.ts.map

package/dist/src/modules/validators/multi-factor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-factor.d.ts","sourceRoot":"","sources":["../../../../modules/validators/multi-factor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAIZ,KAAK,GAAG,EAGT,MAAM,MAAM,CAAA;AACb,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAA;AAE7D,eAAO,MAAM,8BAA8B,EAAE,OACC,CAAA;AAE9C,MAAM,MAAM,uBAAuB,GAAG,CACpC,UAAU,EAAE,8BAA8B,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAC7D,cAAc,CAAA;AAEnB,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,CAEvD;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,8BAA8B,EAC1C,aAAa,EAAE,uBAAuB,GACrC,cAAc,CAuChB;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,SAAS;QAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAA;QAC/B,QAAQ,CAAC,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;QACjC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAA;KAC3B,EAAE,CAAA;CACJ,GAAG,GAAG,CA6CN"}

package/dist/src/modules/validators/multi-factor.js

@@ -0,0 +1,79 @@
+import { concat, encodeAbiParameters, encodePacked, pad, toHex, } from 'viem';
+export const MULTI_FACTOR_VALIDATOR_ADDRESS = '0xf6bdf42c9be18ceca5c06c42a43daf7fbbe7896b';
+export function encodeValidatorId(id) {
+    return pad(typeof id === 'number' ? toHex(id) : id, { size: 12 });
+}
+export function resolveMultiFactorValidator(definition, resolveAtomic) {
+    const validators = definition.validators.map((validator) => {
+        const module = resolveAtomic(validator);
+        return {
+            packedValidatorAndId: concat([
+                encodeValidatorId(validator.publicId),
+                module.address,
+            ]),
+            data: module.initData,
+        };
+    });
+    return {
+        kind: 'validator',
+        address: definition.module.source === 'explicit'
+            ? definition.module.address
+            : MULTI_FACTOR_VALIDATOR_ADDRESS,
+        initData: encodePacked(['uint8', 'bytes'], [
+            definition.threshold,
+            encodeAbiParameters([
+                {
+                    name: 'validators',
+                    type: 'tuple[]',
+                    components: [
+                        { name: 'packedValidatorAndId', type: 'bytes32' },
+                        { name: 'data', type: 'bytes' },
+                    ],
+                },
+            ], [validators]),
+        ]),
+        deInitData: '0x',
+        additionalContext: '0x',
+    };
+}
+export function encodeMultiFactorContribution(input) {
+    if (input.threshold < 1 || input.threshold > input.factorOrder.length) {
+        throw new Error('Validator threshold is outside the configured factor set');
+    }
+    const configured = new Set(input.factorOrder);
+    const contributions = new Map();
+    for (const contribution of input.contributions) {
+        if (!configured.has(contribution.factorId)) {
+            throw new Error(`Unknown validator factor ${contribution.factorId}`);
+        }
+        if (contributions.has(contribution.factorId)) {
+            throw new Error(`Duplicate validator factor ${contribution.factorId}`);
+        }
+        contributions.set(contribution.factorId, contribution);
+    }
+    const ordered = input.factorOrder.flatMap((factorId) => {
+        const contribution = contributions.get(factorId);
+        return contribution ? [contribution] : [];
+    });
+    if (ordered.length < input.threshold) {
+        throw new Error(`Insufficient validator contributions: required ${input.threshold}, received ${ordered.length}`);
+    }
+    return encodeAbiParameters([
+        {
+            name: 'validators',
+            type: 'tuple[]',
+            components: [
+                { name: 'packedValidatorAndId', type: 'bytes32' },
+                { name: 'data', type: 'bytes' },
+            ],
+        },
+    ], [
+        ordered.map((contribution) => ({
+            packedValidatorAndId: concat([
+                encodeValidatorId(contribution.publicId),
+                contribution.validator,
+            ]),
+            data: contribution.contribution,
+        })),
+    ]);
+}

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

@@ -0,0 +1,26 @@
+import { type Address, type Hex } from 'viem';
+import type { ResolvedModule } from '../types.js';
+import type { AtomicValidatorDefinition } from './types.js';
+export declare const OWNABLE_VALIDATOR_ADDRESS: Address;
+export declare const OWNABLE_V0_VALIDATOR_ADDRESS: "0x2483da3a338895199e5e538530213157e931bf06";
+export declare const OWNABLE_BETA_VALIDATOR_ADDRESS: "0x0000000000e9e6e96bcaa3c113187cdb7e38aed9";
+export declare const ECDSA_MOCK_SIGNATURE: "0x81d4b4981670cb18f99f0b4a66446df1bf5b204d24cfcb659bf38ba27a4359b5711649ec2423c5e1247245eba2964679b6a1dbb85c992ae40b9b00c6935b02ff1b";
+export declare function resolveOwnableAddresses(input: {
+    readonly owners: readonly `0x${string}`[];
+    readonly threshold: number;
+    readonly address?: `0x${string}`;
+}): ResolvedModule;
+export declare function resolveOwnableValidator(definition: AtomicValidatorDefinition): ResolvedModule;
+export declare function encodeOwnableMockSignature(ownerCount: number): Hex;
+export declare function encodeEcdsaValidatorContribution(input: {
+    readonly ownerOrder: readonly string[];
+    readonly threshold: number;
+    readonly recoveryEncoding: 'ethereum' | 'validator-offset-4';
+    readonly contributions: readonly {
+        readonly ownerId: string;
+        readonly signature: Hex;
+        readonly encoding: 'raw-signer' | 'validator-contribution';
+    }[];
+}): Hex;
+export declare function encodeEcdsaRecoveryValue(signature: Hex, encoding: 'ethereum' | 'validator-offset-4'): Hex;
+//# sourceMappingURL=ownable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ownable.d.ts","sourceRoot":"","sources":["../../../../modules/validators/ownable.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAGZ,KAAK,GAAG,EAGT,MAAM,MAAM,CAAA;AACb,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAExD,eAAO,MAAM,yBAAyB,EAAE,OACM,CAAA;AAC9C,eAAO,MAAM,4BAA4B,EACvC,4CAAqD,CAAA;AACvD,eAAO,MAAM,8BAA8B,EACzC,4CAAqD,CAAA;AAEvD,eAAO,MAAM,oBAAoB,EAC/B,sIAA+I,CAAA;AAQjJ,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,EAAE,EAAE,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;CACjC,GAAG,cAAc,CAmBjB;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,yBAAyB,GACpC,cAAc,CAchB;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAElE;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,UAAU,GAAG,oBAAoB,CAAA;IAC5D,QAAQ,CAAC,aAAa,EAAE,SAAS;QAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAA;QACvB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,wBAAwB,CAAA;KAC3D,EAAE,CAAA;CACJ,GAAG,GAAG,CAiCN;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,GAAG,EACd,QAAQ,EAAE,UAAU,GAAG,oBAAoB,GAC1C,GAAG,CAaL"}