Skip to content

feat(docs): add Smart Accounts and Authenticators integration page#316

Draft
JohnnyWyles wants to merge 1 commit into
mainfrom
feat/smart-account-authenticators-docs
Draft

feat(docs): add Smart Accounts and Authenticators integration page#316
JohnnyWyles wants to merge 1 commit into
mainfrom
feat/smart-account-authenticators-docs

Conversation

@JohnnyWyles
Copy link
Copy Markdown
Collaborator

New page at docs/overview/integrate/smart-accounts.md documenting the x/smart-account module on Osmosis.

Verified content:

  • Module params and circuit-breaker state queried live against mainnet (is_smart_account_active, maximum_unauthenticated_gas, circuit_breaker_controllers).
  • Seven registered authenticator types with exact Type() strings sourced from x/smart-account/authenticator/*.go and the InitializeAuthenticators call in app/keepers/keepers.go: SignatureVerification, MessageFilter, AllOf, AnyOf, PartitionedAllOf, PartitionedAnyOf, CosmwasmAuthenticatorV1.
  • Three execute messages from proto/osmosis/smartaccount/v1beta1/ tx.proto: MsgAddAuthenticator, MsgRemoveAuthenticator, MsgSetActiveState.
  • The data shape for each authenticator type's config bytes, confirmed against the composite config of authenticators currently on chain.
  • Both REST query endpoints (account-wide and single-id) with response shapes shown as generic placeholders.
  • Authentication lifecycle (Authenticate, Track, ConfirmExecution) sourced from the chain's own x/smart-account/README.md.
  • Common composition patterns section describing the session-key + policy contract + msg-type allowlist template.
  • One Click Trading worked example sourced from osmosis-frontend/packages/web/hooks/mutations/one-click-trading/ use-create-one-click-trading-session.tsx: the AllOf composite, the six allowlisted msg types, the session lifecycle.
  • The live spend-limit policy contract address (osmo10xqv8rlpkflywm92k5wdmplzy7khtasl9c2c08psmvlu543k724sy94k74, code id 852, cw2 spend-limit v1.0.0) and the observation that the same DAODAO subDAO holds both the contract's admin and the module's circuit-breaker controller slot.

New page at docs/overview/integrate/smart-accounts.md documenting
the x/smart-account module on Osmosis.

Verified content:

- Module params and circuit-breaker state queried live against
  mainnet (is_smart_account_active, maximum_unauthenticated_gas,
  circuit_breaker_controllers).
- Seven registered authenticator types with exact Type() strings
  sourced from x/smart-account/authenticator/*.go and the
  InitializeAuthenticators call in app/keepers/keepers.go:
  SignatureVerification, MessageFilter, AllOf, AnyOf,
  PartitionedAllOf, PartitionedAnyOf, CosmwasmAuthenticatorV1.
- Three execute messages from proto/osmosis/smartaccount/v1beta1/
  tx.proto: MsgAddAuthenticator, MsgRemoveAuthenticator,
  MsgSetActiveState.
- The data shape for each authenticator type's config bytes,
  confirmed against the composite config of authenticators currently
  on chain.
- Both REST query endpoints (account-wide and single-id) with
  response shapes shown as generic placeholders.
- Authentication lifecycle (Authenticate, Track, ConfirmExecution)
  sourced from the chain's own x/smart-account/README.md.
- Common composition patterns section describing the session-key +
  policy contract + msg-type allowlist template.
- One Click Trading worked example sourced from
  osmosis-frontend/packages/web/hooks/mutations/one-click-trading/
  use-create-one-click-trading-session.tsx: the AllOf composite,
  the six allowlisted msg types, the session lifecycle.
- The live spend-limit policy contract address
  (osmo10xqv8rlpkflywm92k5wdmplzy7khtasl9c2c08psmvlu543k724sy94k74,
  code id 852, cw2 spend-limit v1.0.0) and the observation that the
  same DAODAO subDAO holds both the contract's admin and the
  module's circuit-breaker controller slot.

sidebar_position: 16, slotting after transmuter.md (15) and
orderbook.md (14) in the integration cluster.
@vercel
Copy link
Copy Markdown

vercel Bot commented May 13, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 13, 2026 3:38pm
stage-docs Ready Ready Preview, Comment May 13, 2026 3:38pm

Request Review

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