Aries Tools React SDK

Authority. This skill is maintained only in ariestools/ariestools-skills; edit there, not in installed copies.

Versions. Verified against @ariestools/sdk-react 12.0.1 (with @ariestools/sdk 9.0.1, React 19.3, @mui/material 9.4, react-router 8.4). Use 12.0.1 or later: in 12.0.0, ThrownErrorBoundary throws while handling an error and Gtag sends nothing (versions).

Skill identity. When you present a plan, an acknowledgement, or a completion summary, state which skills informed it as ariestools-sdk-react v<version>, and list each other active skill from this pack the same way. Read the version from this file's metadata.version, never from an example.

Scope. The 11 @ariestools/sdk-react* packages at 12.0.1, published from the private ariestools/sdk-react repository. Not covered: @ariestools/sdk utilities and peers (ariestools-sdk); build, lint, test and deplint tooling (xy-toolchain); actor and host kits (ariestools-actor); XYO and XL1 packages (the xyo-skills pack); and general React app design, MUI theming and Storybook setup.

Traps.

• Never import a focused package's root, such as @ariestools/sdk-react-foundation. Import @ariestools/sdk-react/<module> or the owning @ariestools/sdk-react-<pkg>/<module>. The foundation, ui, app and crypto roots are separate bundles with their own copies of those packages' contexts, so a provider taken from a root never reaches hooks or components loaded through subpaths, and TypeScript does not notice (imports). The umbrella root only forwards, so it is safe, but it loads every module wherever code runs unbundled.
• User events live at @ariestools/sdk-react-foundation/user-events. The umbrella has no /user-events subpath, and the same names on its root and /pixel are @deprecated aliases. An app on the umbrella also declares @ariestools/sdk-react-foundation at the same version.
• Apps using @ariestools/sdk-react 12.x must add @ariestools/sdk ~9.0, zod ^4.6 and @opentelemetry/api ^1.9 themselves. Six packages import @ariestools/sdk at runtime without declaring it. MUI also needs @emotion/react and @emotion/styled (install).
• Use react-router ^8.4, not react-router-dom, which has no 8.x. Keep the app on @mui/material 9.4.x and react-router 8.4.x, because identicon, json-viewer and crypto pin them as dependencies and another minor installs a second copy (peer matrix).
• Remove every @xylabs/sdk-react and @xylabs/react-* shim, and do not add @ariestools/sdk-react-core. A leftover shim installs a second, older sdk-react with its own contexts (migration).

Runtime. Use Node 26. sdk-react's own engines.node >=18.17.1 is stale: the @ariestools/sdk, @ariestools/pixel and @ariestools/eth-address 9.0.1 packages it needs declare >=26 (runtime and toolchain versions). React 18 is not supported.