feat: adds waitForUserOperationReceipt to SDKv4

[linnall]

Pull Request Checklist

• Did you add new tests and confirm existing tests pass? (yarn test)
• Did you update relevant docs? (docs are found in the site folder, and guidelines for updating/adding docs can be found in the contribution guide)
• Do your commits follow the Conventional Commits standard?
• Does your PR title also follow the Conventional Commits standard?
• If you have a breaking change, is it correctly reflected in your commit message? (e.g. feat!: breaking change)
• Did you run lint (yarn lint:check) and fix any issues? (yarn lint:write)
• Did you follow the contribution guidelines?

---

PR-Codex overview

This PR introduces the waitForUserOperationReceipt function to the aa-sdk, allowing users to wait for the confirmation of user operation transactions by checking the receipt periodically. It also includes documentation for this new function.

Detailed summary

• Added export for waitForUserOperationReceipt in index.ts.
• Implemented waitForUserOperationReceipt function in waitForUserOperationReceipt.ts.
• Added JSDoc comments detailing function usage, parameters, and return types.
• Included example usage in documentation.
• Defined type parameters and arguments for the function.

✨ Ask PR-Codex anything about this PR by commenting with /codex {your question}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
aa-sdk-ui-demo	Ready	Preview	Comment	Oct 2, 2025 0:04am

[Copilot]

Pull Request Overview

This PR adds a new function waitForUserOperationReceipt to the aa-sdk core library that waits for a user operation transaction to be confirmed by periodically checking for its receipt with configurable retry parameters.

Key changes:

• Introduces a new utility function for polling transaction receipts with exponential backoff and jitter
• Exports the new function from the core module's public API
• Adds comprehensive documentation for the new function

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
aa-sdk/core/src/actions/smartAccount/waitForUserOperationReceipt.ts	Implements the core polling logic with retry mechanism and error handling
aa-sdk/core/src/index.ts	Exports the new function from the public API
docs/pages/reference/aa-sdk/core/src/variables/waitForUserOperationReceipt.mdx	Auto-generated documentation for the new function

[Copilot]

The term 'user operation transaction' should be replaced with 'transaction' according to the documentation guidelines. The phrase should read: 'Waits for a transaction to be confirmed by checking the receipt periodically until it is found or a maximum number of retries is reached.'

[Copilot]

The term 'user operation transaction' in the description should be replaced with 'transaction' to align with the documentation terminology standards.

[github-actions]

🌿 Documentation Preview

Name	Status	Preview	Updated (UTC)
Alchemy Docs	✅ Ready	🔗 Visit Preview	Oct 1, 2025, 11:58 PM