@rhinestone/sdk 2.0.0-beta.9 → 2.1.0

package/dist/src/transactions/intents/types.d.ts

@@ -0,0 +1,136 @@
+import type { Address, Hex, SignedAuthorization } from 'viem';
+import type { AccountRuntimePort } from '../../accounts/adapter.js';
+import type { UnresolvedCall } from '../../calls/types.js';
+import type { ChainReference, EvmChainReference } from '../../chains/types.js';
+import type { IntentQuotePort, IntentStatusPort, IntentSubmissionPort } from '../../clients/orchestrator/port.js';
+import type { IntentOpStatus, OriginSignature, Quote } from '../../clients/orchestrator/public.js';
+import type { OrchestratorAccount, OrchestratorAccountAccessList, OrchestratorIntentOptions, OrchestratorIntentRequest, OrchestratorOriginSignature, OrchestratorQuote } from '../../clients/orchestrator/types.js';
+import type { Transaction } from '../../config/account.js';
+import type { ResolvedSessionSignerSet, Session, SessionEnableData } from '../../modules/validators/smart-sessions/types.js';
+import type { IntentSigningInput } from '../../signing/intent-plans/types.js';
+import type { OwnerSignerSelection, SignerInvocationPort, SigningCheckpointPort, SigningTranscript } from '../../signing/types.js';
+export interface IntentTokenRequest {
+    readonly token: Address | string;
+    readonly amount?: bigint;
+}
+export interface IntentSourceCall<CompatibilityConfig> {
+    readonly call: UnresolvedCall<CompatibilityConfig>;
+    readonly provides?: readonly {
+        readonly token: Address;
+        readonly amount: bigint;
+    }[];
+}
+export interface IntentSessionSelection {
+    readonly kind: 'smart-session';
+    readonly byChain: Readonly<Record<number, {
+        readonly session: Session;
+        readonly enableData?: SessionEnableData;
+    }>>;
+}
+export interface IntentInput<CompatibilityConfig = unknown> {
+    readonly destination: ChainReference;
+    readonly sourceChains?: readonly EvmChainReference[];
+    readonly calls: readonly UnresolvedCall<CompatibilityConfig>[];
+    readonly tokenRequests: readonly IntentTokenRequest[];
+    readonly recipient?: OrchestratorAccount;
+    readonly gasLimit?: bigint;
+    readonly eip7702InitSignature?: Hex;
+    readonly accountAccessList?: OrchestratorAccountAccessList;
+    readonly options?: Omit<OrchestratorIntentOptions, 'signatureMode'>;
+    readonly signatureMode?: number;
+    readonly sourceCalls?: Readonly<Record<number, readonly IntentSourceCall<CompatibilityConfig>[]>>;
+    readonly accountSetupOverride?: readonly {
+        readonly to: Address;
+        readonly data: Hex;
+    }[];
+    readonly signers?: OwnerSignerSelection | IntentSessionSelection;
+}
+export interface PreparedIntent<CompatibilityConfig = unknown> {
+    readonly traceId: string;
+    readonly input: IntentInput<CompatibilityConfig>;
+    readonly request: OrchestratorIntentRequest;
+    readonly quote: OrchestratorQuote;
+    readonly quotes: readonly OrchestratorQuote[];
+    readonly signing: IntentSigningInput;
+    readonly accountChain: EvmChainReference;
+    readonly resolvedSessions?: Readonly<Record<number, ResolvedSessionSignerSet>>;
+    readonly sessionEnvironment?: 'production' | 'development';
+}
+export interface SignedIntent<CompatibilityConfig = unknown> {
+    readonly prepared: PreparedIntent<CompatibilityConfig>;
+    readonly originSignatures: readonly OrchestratorOriginSignature[];
+    readonly destinationSignature: Hex;
+    readonly targetSignature?: Hex;
+    readonly transcript: SigningTranscript;
+    readonly authorizations?: readonly SignedAuthorization[];
+    readonly dryRun?: boolean;
+}
+export interface SubmittedIntent {
+    readonly type: 'intent';
+    readonly traceId: string;
+    readonly intentId: string;
+    readonly sourceChains?: readonly number[];
+    readonly targetChain: number;
+}
+export interface IntentStatus {
+    readonly traceId: string;
+    readonly intentId: string;
+    readonly status: IntentOpStatus['status'];
+    readonly account: Address;
+    readonly operations: readonly IntentOpStatus['operations'][number][];
+    readonly terminal: boolean;
+}
+export interface IntentWorkflowContext<CompatibilityConfig = unknown> {
+    readonly compatibilityConfig: CompatibilityConfig;
+    readonly account: AccountRuntimePort;
+    readonly quoteClient: IntentQuotePort;
+    readonly submissionClient: IntentSubmissionPort;
+    readonly statusClient: IntentStatusPort;
+    readonly signerInvoker: SignerInvocationPort;
+    readonly checkpoints: SigningCheckpointPort;
+    readonly signAuthorizations: (input: {
+        readonly chains: readonly ChainReference[];
+        readonly eip7702InitSignature: Hex;
+    }) => Promise<readonly SignedAuthorization[]>;
+    readonly clock: {
+        readonly now: () => number;
+        readonly sleep: (milliseconds: number) => Promise<void>;
+    };
+}
+export interface TransactionResult {
+    type: 'intent';
+    id: string;
+    traceId: string;
+    sourceChains?: number[];
+    targetChain: number;
+}
+export interface PreparedQuotes {
+    traceId: string;
+    best: Quote;
+    all: Quote[];
+}
+export interface PreparedTransactionData {
+    quotes: PreparedQuotes;
+    intentInput: unknown;
+    transaction: Transaction;
+}
+export interface QuoteSelection {
+    intentId: string;
+}
+export interface SignedTransactionData extends PreparedTransactionData {
+    quote: Quote;
+    originSignatures: OriginSignature[];
+    destinationSignature: Hex;
+    targetExecutionSignature: Hex | undefined;
+}
+export interface TransactionStatus {
+    /** OpenTelemetry trace ID for correlating the status response. */
+    traceId: IntentOpStatus['traceId'];
+    /** High-level intent status. */
+    status: IntentOpStatus['status'];
+    /** The account address that owns this intent. */
+    accountAddress: Address;
+    /** Per-chain operation status. One entry per chain. */
+    operations: IntentOpStatus['operations'];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/transactions/intents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../transactions/intents/types.ts"],"names":[],"mappings":"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"}

package/dist/src/transactions/intents/types.js

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

package/dist/src/transactions/user-operations/hash.d.ts

@@ -0,0 +1,5 @@
+import type { Hex } from 'viem';
+import type { EvmChainReference } from '../../chains/types.js';
+import type { BundlerUserOperation } from '../../clients/bundler/port.js';
+export declare function hashUserOperation(chain: EvmChainReference, operation: BundlerUserOperation): Hex;
+//# sourceMappingURL=hash.d.ts.map

package/dist/src/transactions/user-operations/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../transactions/user-operations/hash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAK/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEtE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,EACxB,SAAS,EAAE,oBAAoB,GAC9B,GAAG,CAOL"}

package/dist/src/transactions/user-operations/hash.js

@@ -0,0 +1,9 @@
+import { entryPoint07Address, getUserOperationHash, } from 'viem/account-abstraction';
+export function hashUserOperation(chain, operation) {
+    return getUserOperationHash({
+        userOperation: operation,
+        chainId: chain.id,
+        entryPointAddress: entryPoint07Address,
+        entryPointVersion: '0.7',
+    });
+}

package/dist/src/transactions/user-operations/nonce.d.ts

@@ -0,0 +1,18 @@
+import { type Address } from 'viem';
+import type { AccountKind } from '../../accounts/types.js';
+import type { EvmChainReference } from '../../chains/types.js';
+import type { RpcReadPort } from '../../clients/rpc/port.js';
+export declare function getUserOperationNonceKey(input: {
+    readonly accountKind: AccountKind;
+    readonly validator: Address;
+    readonly defaultValidator?: Address;
+    readonly lane?: bigint;
+    readonly requested?: bigint;
+}): bigint;
+export declare function readUserOperationNonce(input: {
+    readonly rpc: RpcReadPort;
+    readonly chain: EvmChainReference;
+    readonly sender: Address;
+    readonly key: bigint;
+}): Promise<bigint>;
+//# sourceMappingURL=nonce.d.ts.map

package/dist/src/transactions/user-operations/nonce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce.d.ts","sourceRoot":"","sources":["../../../../transactions/user-operations/nonce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAA8B,MAAM,MAAM,CAAA;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAezD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B,GAAG,MAAM,CAoBT;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlB"}

package/dist/src/transactions/user-operations/nonce.js

@@ -0,0 +1,43 @@
+import { concat, toHex, zeroAddress } from 'viem';
+import { entryPoint07Address } from 'viem/account-abstraction';
+const getNonceAbi = [
+    {
+        type: 'function',
+        name: 'getNonce',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'sender', type: 'address' },
+            { name: 'key', type: 'uint192' },
+        ],
+        outputs: [{ name: 'nonce', type: 'uint256' }],
+    },
+];
+export function getUserOperationNonceKey(input) {
+    if (input.requested !== undefined)
+        return input.requested;
+    switch (input.accountKind) {
+        case 'safe':
+            return BigInt(concat([input.validator, '0x00000000']));
+        case 'kernel':
+            return BigInt(concat(['0x0000', input.validator, '0x0000']));
+        case 'nexus':
+        case 'startale':
+        case 'hca': {
+            const validator = input.defaultValidator?.toLowerCase() === input.validator.toLowerCase()
+                ? zeroAddress
+                : input.validator;
+            const lane = (input.lane ?? 0n) % 16777215n;
+            return BigInt(concat([toHex(lane, { size: 3 }), '0x00', validator]));
+        }
+        case 'eoa':
+            throw new Error('EOA accounts do not support UserOperations');
+    }
+}
+export async function readUserOperationNonce(input) {
+    return input.rpc.readContract({ chain: input.chain }, {
+        address: entryPoint07Address,
+        abi: getNonceAbi,
+        functionName: 'getNonce',
+        args: [input.sender, input.key],
+    });
+}

package/dist/src/transactions/user-operations/prepare.d.ts

@@ -0,0 +1,12 @@
+import type { Hex } from 'viem';
+import type { EvmChainReference } from '../../chains/types.js';
+import { type SigningContext } from '../../signing/context.js';
+import type { UserOperationSigningPlanInput } from '../../signing/user-operation.js';
+import type { PreparedUserOperation, UserOperationInput, UserOperationWorkflowContext } from './types.js';
+export declare function prepareUserOperation<CompatibilityConfig>(context: UserOperationWorkflowContext<CompatibilityConfig>, input: UserOperationInput<CompatibilityConfig>): Promise<PreparedUserOperation<CompatibilityConfig>>;
+/**
+ * Builds the validator signing-plan input for a UserOperation hash. Shared by
+ * preparation and reconstruction so both derive an identical signing plan.
+ */
+export declare function buildUserOperationSigningPlanInput(signingContext: SigningContext, chain: EvmChainReference, hash: Hex): UserOperationSigningPlanInput;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/src/transactions/user-operations/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../../transactions/user-operations/prepare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAI/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAI3D,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAA;AAK9B,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAA;AAGjF,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,4BAA4B,EAC7B,MAAM,SAAS,CAAA;AAGhB,wBAAsB,oBAAoB,CAAC,mBAAmB,EAC5D,OAAO,EAAE,4BAA4B,CAAC,mBAAmB,CAAC,EAC1D,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,GAC7C,OAAO,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,CAAC,CAgGrD;AAiBD;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,GAAG,GACR,6BAA6B,CAoB/B"}

package/dist/src/transactions/user-operations/prepare.js

@@ -0,0 +1,136 @@
+import { K1_DEFAULT_VALIDATOR_ADDRESS } from '../../accounts/adapters/startale.js';
+import { resolveCalls } from '../../calls/resolve.js';
+import { ENS_HCA_MODULE } from '../../modules/validators/ens.js';
+import { OWNABLE_VALIDATOR_ADDRESS } from '../../modules/validators/ownable.js';
+import { createAccountSigningContext, getSigningValidatorCodec, getSigningValidatorFactors, } from '../../signing/context.js';
+import { createValidatorSigningTasks, signingTopology, } from '../../signing/plan.js';
+import { hashUserOperation } from './hash.js';
+import { getUserOperationNonceKey, readUserOperationNonce } from './nonce.js';
+import { getUserOperationStubSignature } from './validator-account.js';
+export async function prepareUserOperation(context, input) {
+    const runtime = await context.account.forChain(input.chain);
+    const signingContext = createAccountSigningContext({
+        runtime,
+        purpose: 'user-operation',
+        signerInvoker: context.signerInvoker,
+        ...(input.signers ? { selection: input.signers } : {}),
+    });
+    const calls = await resolveCalls(input.calls, {
+        account: runtime.identity.address,
+        chain: input.chain,
+        config: context.compatibilityConfig,
+    });
+    const nonce = await readUserOperationNonce({
+        rpc: context.rpc.forChain(input.chain),
+        chain: input.chain,
+        sender: runtime.identity.address,
+        key: getUserOperationNonceKey({
+            accountKind: runtime.construction.account.kind,
+            validator: signingContext.validatorCapabilities.compatibilityKey.moduleAddress,
+            defaultValidator: defaultUserOperationValidator(runtime.construction),
+            lane: BigInt(context.clock.now()),
+            ...(input.nonceKey === undefined ? {} : { requested: input.nonceKey }),
+        }),
+    });
+    const deployment = runtime.adapter.getDeploymentPlan(runtime.construction);
+    const gasPrice = await context.bundler.getGasPrice(input.chain);
+    let operation = {
+        sender: runtime.identity.address,
+        nonce,
+        ...(deployment.deployed || !deployment.factory || !deployment.factoryData
+            ? {}
+            : {
+                factory: deployment.factory,
+                factoryData: deployment.factoryData,
+            }),
+        callData: runtime.adapter.encodeCalls({
+            chain: input.chain,
+            calls,
+            mode: calls.length > 1 ? 'batch' : 'single',
+        }),
+        callGasLimit: input.gasLimit ?? 0n,
+        verificationGasLimit: 0n,
+        preVerificationGas: 0n,
+        maxFeePerGas: gasPrice.maxFeePerGas,
+        maxPriorityFeePerGas: gasPrice.maxPriorityFeePerGas,
+        signature: getUserOperationStubSignature(runtime, signingContext),
+    };
+    let paymasterIsFinal = false;
+    if (context.paymaster) {
+        const { isFinal, ...stub } = await context.paymaster.getStubData(input.chain, operation);
+        paymasterIsFinal = isFinal;
+        operation = {
+            ...operation,
+            ...stub,
+        };
+    }
+    const gas = await context.bundler.estimateGas(input.chain, operation);
+    const paymasterGas = {
+        ...(operation.paymasterVerificationGasLimit === undefined
+            ? {}
+            : {
+                paymasterVerificationGasLimit: operation.paymasterVerificationGasLimit,
+            }),
+        ...(operation.paymasterPostOpGasLimit === undefined
+            ? {}
+            : { paymasterPostOpGasLimit: operation.paymasterPostOpGasLimit }),
+    };
+    operation = {
+        ...operation,
+        ...gas,
+        ...paymasterGas,
+        ...(input.gasLimit === undefined ? {} : { callGasLimit: input.gasLimit }),
+    };
+    if (context.paymaster && !paymasterIsFinal) {
+        operation = {
+            ...operation,
+            ...(await context.paymaster.getData(input.chain, operation)),
+        };
+    }
+    const hash = hashUserOperation(input.chain, operation);
+    return {
+        input,
+        operation,
+        hash,
+        signing: buildUserOperationSigningPlanInput(signingContext, input.chain, hash),
+    };
+}
+function defaultUserOperationValidator(construction) {
+    switch (construction.account.kind) {
+        case 'nexus':
+            return OWNABLE_VALIDATOR_ADDRESS;
+        case 'startale':
+            return K1_DEFAULT_VALIDATOR_ADDRESS;
+        case 'hca':
+            return ENS_HCA_MODULE;
+        case 'safe':
+        case 'kernel':
+        case 'eoa':
+            return undefined;
+    }
+}
+/**
+ * Builds the validator signing-plan input for a UserOperation hash. Shared by
+ * preparation and reconstruction so both derive an identical signing plan.
+ */
+export function buildUserOperationSigningPlanInput(signingContext, chain, hash) {
+    const tasks = createValidatorSigningTasks({
+        validator: signingContext.validator,
+        signerReferences: signingContext.signerReferences,
+        taskPrefix: 'user-operation',
+        ecdsaInvocation: 'ecdsa-sign-message',
+        webauthnInvocation: 'webauthn-sign-hash',
+    });
+    const topology = signingTopology(signingContext.validator);
+    return {
+        hash,
+        chain,
+        configuredTopology: topology.configuredTopology,
+        effectiveSelection: topology.effectiveSelection,
+        tasks,
+        validatorCodec: getSigningValidatorCodec(signingContext),
+        ...(signingContext.validator.kind === 'multi-factor'
+            ? { validatorFactors: getSigningValidatorFactors(signingContext) }
+            : {}),
+    };
+}

package/dist/src/transactions/user-operations/reconstruct.d.ts

@@ -0,0 +1,28 @@
+import type { Hex } from 'viem';
+import type { EvmChainReference } from '../../chains/types.js';
+import type { BundlerUserOperation } from '../../clients/bundler/port.js';
+import type { OwnerSignerSelection } from '../../signing/types.js';
+import type { PreparedUserOperation, SignedUserOperation, UserOperationWorkflowContext } from './types.js';
+interface ReconstructPreparedInput {
+    readonly chain: EvmChainReference;
+    readonly operation: BundlerUserOperation;
+    readonly signers?: OwnerSignerSelection;
+}
+interface ReconstructSignedInput extends ReconstructPreparedInput {
+    readonly signature: Hex;
+}
+/**
+ * Rebuilds the internal PreparedUserOperation from a public prepared shape that
+ * did not originate from this SDK instance (e.g. externally rebuilt, mutated to
+ * add a paymaster, or replayed across instances). The signing plan is derived
+ * from the account's static configuration, so this performs no RPC reads.
+ */
+export declare function reconstructPreparedUserOperation<CompatibilityConfig>(context: UserOperationWorkflowContext<CompatibilityConfig>, input: ReconstructPreparedInput): Promise<PreparedUserOperation<CompatibilityConfig>>;
+/**
+ * Rebuilds the internal SignedUserOperation from a public signed shape that did
+ * not originate from this SDK instance, so submission works with a rebuilt or
+ * externally supplied signed UserOperation. Performs no RPC reads.
+ */
+export declare function reconstructSignedUserOperation<CompatibilityConfig>(context: UserOperationWorkflowContext<CompatibilityConfig>, input: ReconstructSignedInput): Promise<SignedUserOperation<CompatibilityConfig>>;
+export {};
+//# sourceMappingURL=reconstruct.d.ts.map

package/dist/src/transactions/user-operations/reconstruct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconstruct.d.ts","sourceRoot":"","sources":["../../../../transactions/user-operations/reconstruct.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAG/D,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC7B,MAAM,SAAS,CAAA;AAEhB,UAAU,wBAAwB;IAChC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAA;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAA;CACxC;AAED,UAAU,sBAAuB,SAAQ,wBAAwB;IAC/D,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,gCAAgC,CAAC,mBAAmB,EACxE,OAAO,EAAE,4BAA4B,CAAC,mBAAmB,CAAC,EAC1D,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,CAAC,CAuBrD;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,mBAAmB,EACtE,OAAO,EAAE,4BAA4B,CAAC,mBAAmB,CAAC,EAC1D,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,CAAC,CAiBnD"}

package/dist/src/transactions/user-operations/reconstruct.js

@@ -0,0 +1,52 @@
+import { createAccountSigningContext } from '../../signing/context.js';
+import { hashUserOperation } from './hash.js';
+import { buildUserOperationSigningPlanInput } from './prepare.js';
+/**
+ * Rebuilds the internal PreparedUserOperation from a public prepared shape that
+ * did not originate from this SDK instance (e.g. externally rebuilt, mutated to
+ * add a paymaster, or replayed across instances). The signing plan is derived
+ * from the account's static configuration, so this performs no RPC reads.
+ */
+export async function reconstructPreparedUserOperation(context, input) {
+    const runtime = await context.account.forChain(input.chain);
+    const signingContext = createAccountSigningContext({
+        runtime,
+        purpose: 'user-operation',
+        signerInvoker: context.signerInvoker,
+        ...(input.signers ? { selection: input.signers } : {}),
+    });
+    const hash = hashUserOperation(input.chain, input.operation);
+    return {
+        input: {
+            chain: input.chain,
+            calls: [],
+            ...(input.signers ? { signers: input.signers } : {}),
+        },
+        operation: input.operation,
+        hash,
+        signing: buildUserOperationSigningPlanInput(signingContext, input.chain, hash),
+    };
+}
+/**
+ * Rebuilds the internal SignedUserOperation from a public signed shape that did
+ * not originate from this SDK instance, so submission works with a rebuilt or
+ * externally supplied signed UserOperation. Performs no RPC reads.
+ */
+export async function reconstructSignedUserOperation(context, input) {
+    const operation = { ...input.operation, signature: input.signature };
+    const prepared = await reconstructPreparedUserOperation(context, {
+        chain: input.chain,
+        operation,
+        ...(input.signers ? { signers: input.signers } : {}),
+    });
+    return {
+        prepared,
+        operation,
+        signature: input.signature,
+        transcript: {
+            planKind: 'user-operation',
+            payloadId: prepared.hash,
+            stages: [],
+        },
+    };
+}

package/dist/src/transactions/user-operations/send.d.ts

@@ -0,0 +1,3 @@
+import type { SubmittedUserOperation, UserOperationInput, UserOperationWorkflowContext } from './types.js';
+export declare function sendUserOperation<CompatibilityConfig>(context: UserOperationWorkflowContext<CompatibilityConfig>, input: UserOperationInput<CompatibilityConfig>): Promise<SubmittedUserOperation>;
+//# sourceMappingURL=send.d.ts.map

package/dist/src/transactions/user-operations/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../../transactions/user-operations/send.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAClB,4BAA4B,EAC7B,MAAM,SAAS,CAAA;AAEhB,wBAAsB,iBAAiB,CAAC,mBAAmB,EACzD,OAAO,EAAE,4BAA4B,CAAC,mBAAmB,CAAC,EAC1D,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,GAC7C,OAAO,CAAC,sBAAsB,CAAC,CAIjC"}

package/dist/src/transactions/user-operations/send.js

@@ -0,0 +1,8 @@
+import { prepareUserOperation } from './prepare.js';
+import { signUserOperation } from './sign.js';
+import { submitUserOperation } from './submit.js';
+export async function sendUserOperation(context, input) {
+    const prepared = await prepareUserOperation(context, input);
+    const signed = await signUserOperation(context, prepared);
+    return submitUserOperation(context, signed);
+}

package/dist/src/transactions/user-operations/sign.d.ts

@@ -0,0 +1,3 @@
+import type { PreparedUserOperation, SignedUserOperation, UserOperationWorkflowContext } from './types.js';
+export declare function signUserOperation<CompatibilityConfig>(context: UserOperationWorkflowContext<CompatibilityConfig>, prepared: PreparedUserOperation<CompatibilityConfig>): Promise<SignedUserOperation<CompatibilityConfig>>;
+//# sourceMappingURL=sign.d.ts.map

package/dist/src/transactions/user-operations/sign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign.d.ts","sourceRoot":"","sources":["../../../../transactions/user-operations/sign.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC7B,MAAM,SAAS,CAAA;AAEhB,wBAAsB,iBAAiB,CAAC,mBAAmB,EACzD,OAAO,EAAE,4BAA4B,CAAC,mBAAmB,CAAC,EAC1D,QAAQ,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,GACnD,OAAO,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,CAAC,CAYnD"}

package/dist/src/transactions/user-operations/sign.js

@@ -0,0 +1,14 @@
+import { signUserOperationPayload } from '../../signing/user-operation.js';
+export async function signUserOperation(context, prepared) {
+    const { signature, transcript } = await signUserOperationPayload({
+        planInput: prepared.signing,
+        signerInvoker: context.signerInvoker,
+        checkpoints: context.checkpoints,
+    });
+    return {
+        prepared,
+        operation: { ...prepared.operation, signature },
+        signature,
+        transcript,
+    };
+}

package/dist/src/transactions/user-operations/status.d.ts

@@ -0,0 +1,4 @@
+import type { SubmittedUserOperation, UserOperationStatus, UserOperationWorkflowContext } from './types.js';
+export declare function getUserOperationStatus<CompatibilityConfig>(context: Pick<UserOperationWorkflowContext<CompatibilityConfig>, 'bundler'>, submitted: SubmittedUserOperation): Promise<UserOperationStatus>;
+export declare function waitForUserOperationStatus<CompatibilityConfig>(context: Pick<UserOperationWorkflowContext<CompatibilityConfig>, 'bundler' | 'clock'>, submitted: SubmittedUserOperation): Promise<UserOperationStatus>;
+//# sourceMappingURL=status.d.ts.map

package/dist/src/transactions/user-operations/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../transactions/user-operations/status.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,4BAA4B,EAC7B,MAAM,SAAS,CAAA;AAIhB,wBAAsB,sBAAsB,CAAC,mBAAmB,EAC9D,OAAO,EAAE,IAAI,CAAC,4BAA4B,CAAC,mBAAmB,CAAC,EAAE,SAAS,CAAC,EAC3E,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAU9B;AAED,wBAAsB,0BAA0B,CAAC,mBAAmB,EAClE,OAAO,EAAE,IAAI,CACX,4BAA4B,CAAC,mBAAmB,CAAC,EACjD,SAAS,GAAG,OAAO,CACpB,EACD,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAQ9B"}

package/dist/src/transactions/user-operations/status.js

@@ -0,0 +1,37 @@
+import { WaitForUserOperationReceiptTimeoutError } from 'viem/account-abstraction';
+import { getChainById } from '../../chains/catalog.js';
+const receiptTimeoutMs = 120_000;
+export async function getUserOperationStatus(context, submitted) {
+    const receipt = await context.bundler.getReceipt(submitted.chain, submitted.hash);
+    return {
+        hash: submitted.hash,
+        ...(receipt ? { receipt } : {}),
+        terminal: receipt !== undefined,
+    };
+}
+export async function waitForUserOperationStatus(context, submitted) {
+    const timeoutError = () => new WaitForUserOperationReceiptTimeoutError({ hash: submitted.hash });
+    return context.clock.timeout(pollForUserOperationStatus(context, submitted, timeoutError), receiptTimeoutMs, timeoutError);
+}
+async function pollForUserOperationStatus(context, submitted, timeoutError) {
+    const startedAt = context.clock.now();
+    const blockTime = getChainById(submitted.chain.id).blockTime ?? 12_000;
+    const pollIntervalMs = Math.min(Math.max(Math.floor(blockTime / 2), 500), 4_000);
+    let waitedMs = 0;
+    for (;;) {
+        const status = await getUserOperationStatus(context, submitted);
+        if (status.terminal)
+            return status;
+        const elapsed = Math.max(context.clock.now() - startedAt, waitedMs);
+        const remaining = receiptTimeoutMs - elapsed;
+        if (remaining <= 0) {
+            throw timeoutError();
+        }
+        const delay = Math.min(pollIntervalMs, remaining);
+        await context.clock.sleep(delay);
+        waitedMs += delay;
+        if (Math.max(context.clock.now() - startedAt, waitedMs) >= receiptTimeoutMs) {
+            throw timeoutError();
+        }
+    }
+}

package/dist/src/transactions/user-operations/submit.d.ts

@@ -0,0 +1,3 @@
+import type { SignedUserOperation, SubmittedUserOperation, UserOperationWorkflowContext } from './types.js';
+export declare function submitUserOperation<CompatibilityConfig>(context: UserOperationWorkflowContext<CompatibilityConfig>, signed: SignedUserOperation<CompatibilityConfig>): Promise<SubmittedUserOperation>;
+//# sourceMappingURL=submit.d.ts.map

package/dist/src/transactions/user-operations/submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../../../transactions/user-operations/submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,SAAS,CAAA;AAEhB,wBAAsB,mBAAmB,CAAC,mBAAmB,EAC3D,OAAO,EAAE,4BAA4B,CAAC,mBAAmB,CAAC,EAC1D,MAAM,EAAE,mBAAmB,CAAC,mBAAmB,CAAC,GAC/C,OAAO,CAAC,sBAAsB,CAAC,CAOjC"}

package/dist/src/transactions/user-operations/submit.js

@@ -0,0 +1,8 @@
+export async function submitUserOperation(context, signed) {
+    const operation = { ...signed.operation, signature: signed.signature };
+    return {
+        type: 'userop',
+        chain: signed.prepared.input.chain,
+        hash: await context.bundler.send(signed.prepared.input.chain, operation),
+    };
+}