• STATUS
  • FAILURE
  • RETRY
  • HUMAN

How to debug UserOperations with your AI

Connect Particle Network to your agent to turn cryptic transaction errors into clear technical explanations. Once connected, you can troubleshoot specific hashes instantly.

Ask AI about this page

Short answer

How do I debug UserOperations with my AI?

Give your agent a transaction hash, and it will pull the specific UserOp data or receipts to find the error. You'll get a breakdown of the failure reason and the exact state of the operation.

Troubleshooting outcomes

Where your debugging data lands.

Your agent categorizes every investigation based on the transaction state.

STATUS

Live operation checks

The AI pulls real-time data to see if a UserOp is still pending or has already been processed.

FAILURE

Error root cause

When a hash fails, your agent inspects the receipt to tell you exactly which part of the execution went wrong.

RETRY

New operation drafts

If a transaction failed due to a gas or nonce issue, your agent can prepare a corrected version for you to send.

HUMAN

Manual intervention

If the error is a logic flaw in your smart contract, the AI identifies the issue and hands the technical details back to you.

The workflow

What your AI does when a hash is provided.

The agent moves from raw data retrieval to technical diagnosis.

  1. Fetch operation data

    The agent looks up the specific UserOp details using the provided hash.

    eth_get_user_operation_by_hash

  2. Inspect execution results

    It pulls the transaction receipt to check for revert reasons or success status.

    eth_get_user_operation_receipt

  3. Analyze error logs

    The AI compares the receipt data against expected outcomes to pinpoint the failure.

    eth_get_user_operation_receipt

  4. Submit corrected ops

    Once the fix is identified, the agent can push a new operation to the network.

    eth_send_user_operation

Try it

Copy these to start.

Use these lines to kick off a debugging session.

Starting points

Replace the hash in these prompts with your actual transaction hash.

Particle Network Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_JDD6YP9zDx0PG711KqPE5TABa0Q9e2gDz4mWBi9m/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Particle Network capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "particle-network-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_JDD6YP9zDx0PG711KqPE5TABa0Q9e2gDz4mWBi9m/mcp"
    }
  }
}
Copy into chat04

  • Check the status of UserOp 0x123... and tell me if it succeeded.

  • Why did this UserOp fail: 0xabc...?

  • Fetch the receipt for hash 0xdef... and summarize the error.

  • Can you send a new UserOp with these updated parameters?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Particle Network once, then ask.

One click connects the MCP to your client. Your credentials stay encrypted and secure while your agent gains access to the network tools.

Connect Particle Network to your AI

FAQ

How this task behaves.

  • 01

    Can my AI fix a failed transaction automatically?

    No. The AI can identify the error and draft a new operation, but you must manually approve and send it.

  • 02

    Can the AI change the data in a transaction that is already pending?

    No. Once a UserOp is submitted, it cannot be modified. The AI can only help you send a new, corrected one.

  • 03

    What information does the AI need to start?

    You just need to provide a specific UserOp hash.

  • 04

    Can the AI execute transactions on its own?

    No. The AI uses the tools to prepare and send operations, but the final execution authority remains with you.

  • 05

    Does the AI see my private keys?

    No. The connection is handled through the MCP, and your sensitive keys are never exposed to the AI.

  • More questions about Particle Network? The Connector page answers them. See everything the Particle Network Connector can do

Connect Particle Network to Claude, Cursor, ChatGPT & more