Skip to content

docs: clarify transaction policies

Viet Tan Tran requested to merge github/fork/ihsraham/docs/transaction-policies-priority into develop

Created by: ihsraham

Summary

  • Expand the transaction policy guide with core concepts for scope, wallet bindings, rules, action, operations, and conditions.
  • Document the policy evaluation order in the guide and API reference.
  • Clarify policy state behavior: WDK does not manage durable state or run onSuccess, while condition functions can use app-owned closure or external state.
  • Add simulation result types and runtime caveats for engine-managed state, default deny, and simulate mirrors.
  • Absorb #195 by updating the stale MCP SDK tools documentation link that was failing the external link checker.

To do before ready

  • Follow up with Ricardo for the canonical EVM allowlist plus max ETH policy snippet. The current docs publish the conceptual policy details without waiting on that blocked snippet.
  • Confirm the ongoing type issue around runtime simulate helpers before replacing the temporary cast guidance.

Validation

  • Source check: @tetherto/wdk v1.0.0-beta.12 tests/wdk-policy.test.js passed locally (88 tests)
  • Node v22.22.2 / npm 10.9.7
  • git diff --check
  • npm run quality

Note: build still reports existing docType SEO warnings on unrelated pages.

Merge request reports