sign_userop

Instructions

Implementation Reference

• packages/mcp/src/tools/sign-userop.ts:44-70 (handler)

  The handler function that executes the sign_userop tool logic. It constructs a UserOperation object from the input args, makes a POST request to /v1/wallets/:id/userop/sign, and returns the result.

      async (args) => {
        const userOperation: Record<string, unknown> = {
          sender: args.sender,
          nonce: args.nonce,
          callData: args.call_data,
          callGasLimit: args.call_gas_limit,
          verificationGasLimit: args.verification_gas_limit,
          preVerificationGas: args.pre_verification_gas,
          maxFeePerGas: args.max_fee_per_gas,
          maxPriorityFeePerGas: args.max_priority_fee_per_gas,
          signature: args.signature ?? '0x',
        };
        if (args.factory) userOperation.factory = args.factory;
        if (args.factory_data) userOperation.factoryData = args.factory_data;
        if (args.paymaster) userOperation.paymaster = args.paymaster;
        if (args.paymaster_data) userOperation.paymasterData = args.paymaster_data;
        if (args.paymaster_verification_gas_limit) userOperation.paymasterVerificationGasLimit = args.paymaster_verification_gas_limit;
        if (args.paymaster_post_op_gas_limit) userOperation.paymasterPostOpGasLimit = args.paymaster_post_op_gas_limit;
        const body = { buildId: args.build_id, userOperation };
        const result = await apiClient.post(
          `/v1/wallets/${args.wallet_id}/userop/sign`,
          body,
        );
        return toToolResult(result);
      },
    );
  }

• packages/mcp/src/tools/sign-userop.ts:25-43 (schema)

  Zod schema defining the input parameters for sign_userop: wallet_id, build_id, sender, nonce, call_data, gas fields, signature, factory, factory_data, and optional paymaster fields.

  {
    wallet_id: z.string().describe('Smart Account wallet ID (UUID).'),
    build_id: z.string().describe('Build ID from build_userop response.'),
    sender: z.string().describe('Smart Account address (0x hex).'),
    nonce: z.string().describe('Account nonce (0x hex).'),
    call_data: z.string().describe('Encoded call data (0x hex).'),
    call_gas_limit: z.string().describe('Gas limit for call execution (0x hex).'),
    verification_gas_limit: z.string().describe('Gas limit for verification (0x hex).'),
    pre_verification_gas: z.string().describe('Pre-verification gas (0x hex).'),
    max_fee_per_gas: z.string().describe('Max fee per gas (0x hex).'),
    max_priority_fee_per_gas: z.string().describe('Max priority fee per gas (0x hex).'),
    signature: z.string().optional().describe('Placeholder signature (0x hex). Default: 0x.'),
    factory: z.string().optional().describe('Factory address for undeployed accounts.'),
    factory_data: z.string().optional().describe('Factory data for undeployed accounts.'),
    paymaster: z.string().optional().describe('Paymaster address.'),
    paymaster_data: z.string().optional().describe('Paymaster data.'),
    paymaster_verification_gas_limit: z.string().optional().describe('Paymaster verification gas limit.'),
    paymaster_post_op_gas_limit: z.string().optional().describe('Paymaster post-op gas limit.'),
  },

• packages/mcp/src/server.ts:126-126 (registration)

  Registration of the sign_userop tool via registerSignUserop(server, apiClient, walletContext) in the MCP server setup.

  registerSignUserop(server, apiClient, walletContext);

• packages/sdk/src/types.ts:606-614 (schema)

  TypeScript interfaces defining the SignUserOpParams (buildId + userOperation) and SignUserOpResponse (signedUserOperation + txId) types used in the SDK.

  export interface SignUserOpParams {
    buildId: string;
    userOperation: Record<string, unknown>;
  }
  
  export interface SignUserOpResponse {
    signedUserOperation: Record<string, unknown>;
    txId: string;
  }