Skip to content

docs: wallet_account derivation-path fields for export policies - #768

Draft
andrewkmin wants to merge 2 commits into
mainfrom
andrew/export-path-policy-docs
Draft

docs: wallet_account derivation-path fields for export policies#768
andrewkmin wants to merge 2 commits into
mainfrom
andrew/export-path-policy-docs

Conversation

@andrewkmin

Copy link
Copy Markdown
Contributor

Documents six new wallet_account policy-language fields being added in a companion tkhq/mono PR (attested derivation-path fields for EXPORT_WALLET_ACCOUNT):

  • path (string) — the account's BIP32 derivation path as stored
  • path_indexes (list) — child indexes with the hardened bit stripped
  • path_hardened (list) — positionally paired hardened flags
  • wallet_id (string) — ID of the wallet the account belongs to
  • curve (string) — curve enum name
  • address_format (string) — address format enum name

Changes:

  • features/policies/language.mdx: six new rows in the Wallet Account struct table, plus a note explaining that single-quoted policy literals cannot contain ' (why paths are exposed structurally) and that these fields are currently populated only for EXPORT_WALLET_ACCOUNT activities.
  • features/policies/examples/access-control.mdx: example policy restricting exports to a fully-hardened 4-segment subtree (Spark-purpose example), with an ed25519 caveat.

Companion mono PR: policy: expose attested derivation-path fields on wallet_account for EXPORT_WALLET_ACCOUNT (link TBD).

Do not merge before the mono PR ships.

Document six new wallet_account policy-language fields (path,
path_indexes, path_hardened, wallet_id, curve, address_format)
added for EXPORT_WALLET_ACCOUNT activities, plus a hardened
derivation-subtree export policy example.
@mintlify

mintlify Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
turnkey-docs 🟢 Ready View Preview Aug 10, 2026, 11:58 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Adversarial-review follow-ups:
- Clarify that referencing the new wallet_account derivation-path fields
  on activities other than EXPORT_WALLET_ACCOUNT produces a MissingField
  evaluation error (policy outcome is an error), not empty values.
- Add version-skew rollout guidance: an erroring EFFECT_DENY is skipped
  while a broad EFFECT_ALLOW still matches (fails open during the skew
  window) - recommend narrow-allow patterns over broad-allow + path-deny.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant