refactor: cleanup and refactor permission builder errors

[Zer0dot]

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?

Also includes a minor fix where the permission builder was not adding the permission to the array with the ACCOUNT_FUNCTIONS permission, leading to potentially duplicating this + root permissions.

---

PR-Codex overview

This PR focuses on enhancing the PermissionBuilder functionality by introducing error handling for various permission-related issues and adding a new utility function, buildDeferredActionDigest, to facilitate action digest creation.

Detailed summary

• Added buildDeferredActionDigest function to utils.ts for digest creation.
• Introduced error classes in permissionBuilderErrors.ts for better error handling.
• Replaced error messages in PermissionBuilder with specific error classes.
• Exported new error classes from permissionBuilderErrors.js.
• Updated tests to use buildDeferredActionDigest instead of provider.buildDeferredActionDigest.
• Added unit tests for new error handling scenarios in deferralActions.test.ts.

✨ 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 Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
aa-sdk-site	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 9, 2025 0:47am
aa-sdk-ui-demo	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 9, 2025 0:47am

[graphite-app]

How to use the Graphite Merge Queue

Add the label graphite-merge-queue to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

[github-actions]

🌿 Documentation Preview

Name	Status	Preview	Updated (UTC)
Alchemy Docs	✅ Ready	🔗 Visit Preview	Apr 9, 2025, 12:31 AM

[howydev]

lgtm