Repository navigation
Conversation
Add an opt-in external MCP specification for public reads and user-approved EVM plans. Preserve ordered exact calls and the current wallet approval boundary. No signer, executor, key, paid service or product distribution is added.
🟡 Heimdall Review Status
|
Handle unfunded OTC creation and explicit transaction-level chain IDs for agreement actions. Reject inconsistent actors, mixed chains and failed simulations. No signing or submission logic.
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Add an opt-in QHooks external-MCP plugin at
skills/wallet-mcp/plugins/qhooks.md. Public market and stored-QProof reads stay read-only; unsigned spot preparations are checked locally against the original tool request and Wallet MCP account before they can be mapped tosend_callsfor approval.The executable helper now requires the original
{tool, arguments}, explicit plan/per-transaction chain IDs and the shared unsigned integrity metadata. It pins the fee router, Permit2 and five supported pool managers; decodes the current single-hop swap; checks exact input approvals to the fee router, token/side/amount, quote-derived output minimum/slippage, trader, fee, referrer, expiry and native value; and rejects unknown selectors, extra operations and wallet-authorization fields. The SHA-256 digest is not a signature or a trusted price source, and recomputing it cannot bypass those independent constraints. Server responses without the new metadata fail closed until the matching QHooks server release.Only the original trusted tool name selects this spot branch, so a changed server response cannot downgrade a trade to the staged contract mapper. The prior OTC/agreement approval and selected-action flow remains, with its own review/simulation requirements; this spot decoder does not claim to validate those separate ABIs. No dependent call is appended to a staged approval. Launch links, perps plans, unsupported chains and uncertain outcomes stop the EVM path. Submission still requires the currently connected wallet's chain support and per-action approval; unknown requests keep their original ID.
Five transaction chains remain Base, Ethereum, Arbitrum, BNB and Robinhood Chain. Runtime QHooks tool discovery remains authoritative; the spec does not automatically register every remote tool. Source-only plugin version 0.1.1. No signer, key, shell, direct HTTP workaround, paid API, router registry, endpoint, OAuth, or generated-distribution activation is added.
Change type
Validation
python3 -m unittest discover -s tests: 39 passed, including the executable-mapper regression wrapper.node --test tests/qhooks_plan.test.mjs: 7 passed on Node26 and Node22.23.1. Tests execute the actual Markdown code: 20 supported chain/currency/direction combinations, unlimited approval plus 5 ETH attacker transfer, rehashed changes to approvals/chains/senders/swap fields/value, response downgrade attempts, missing integrity/chain, staged OTC/agreement approval and selected actions, and denied perps/launch/unknown outcomes.python3 scripts/build-distributions.py dist: passed. Four generated distributions preserve current source selection; Wallet MCP/QHooks remains source-only and generated output is not committed.git diff --check: passed. Signed GitHub commit bytes read back exactly and signature verified.The referenced
.claude/skills/plugin-review/is absent from this public checkout. Its dedicated skill was not run; the canonical frontmatter/section/routing checklist was reviewed manually and the actual fenced mapper is fixture-tested. Native connector OAuth/onboarding, real wallet approval,send_callsand financial execution were not exercised. No live service calls, feedback, posts, signing or funds were used by the tests.README/changelog and maintainer registry/tables remain unchanged under the more specific plugin-spec Contribution Scope. This update changes only the plugin document and two focused regression test files; no distribution package version changes are needed. There is no deprecated
base-mcpsource tree to duplicate.Release considerations
Draft for maintainer review; this does not claim endorsement or hosted allowlisting. The matching server metadata release is required before spot preparation succeeds. The user selects QHooks, reviews each plan and approves the wallet action; no unknown outcome causes a new batch. Contract-specific OTC/agreement review and simulation remain mandatory.