Skip to content

docs: update architecture docs 2026-06-29#98

Open
JamesLawton wants to merge 1 commit into
mainfrom
docs/update-architecture-2026-06-29
Open

docs: update architecture docs 2026-06-29#98
JamesLawton wants to merge 1 commit into
mainfrom
docs/update-architecture-2026-06-29

Conversation

@JamesLawton

Copy link
Copy Markdown
Collaborator

What changed

architecture/smart-contracts.mdx: extended the Key Contracts list with the contracts that have shipped to trails-contracts master but are not yet documented.

  • TrailsUtils — convenience contract that bundles MalleableSapient, HydrateProxy, and RequireUtils under one deployed address. Its address is also now returned by the API as trailsUtilsAddress on the TrailsContracts payload.
  • TimedRefundSapient — sapient signer that authorizes a refund payload after a per-intent unlock timestamp. Pairs with the new PrepareIntentRecovery / BuildIntentRecoveryTransaction API endpoints documented separately.
  • PausableSapient / Pausable — sapient signer wrapping any inner signer with a circuit breaker; designated operators can pause signature acceptance to halt new intent commitments.
  • MalleableSapient and RequireUtils — already deployed and used by v1.5 flows; previously only HydrateProxy (which depends on them) was mentioned.

Source of truth

Verification

  • Compare the bullet list against ls trails-contracts/src/**/*.sol — every contract in src/ plus the modules used by TrailsUtils is now mentioned.
  • Cross-reference the trailsUtilsAddress field against TrailsContracts in trails-api/proto/trails-types.ridl.

Generated by the Trails Docs weekly agent.


Generated by Claude Code

Document smart contracts that have shipped to trails-contracts/master but
were missing from the architecture overview:

- TrailsUtils (bundles MalleableSapient, HydrateProxy, RequireUtils)
- TimedRefundSapient (timed self-recovery)
- PausableSapient / Pausable (circuit-breaker on signature acceptance)
- MalleableSapient and RequireUtils (already deployed; previously only
  HydrateProxy was mentioned)

Generated by the Trails Docs weekly agent.
@mintlify

mintlify Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
trails 🟢 Ready View Preview Jun 29, 2026, 9:28 AM

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

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.

2 participants