SDKs & Packages
This site mirrors the npm registry for 44 packages across the three scopes that publish for The Root Network. Each per-package page carries a hand-written why-use / when-to-skip / alternatives block, the status of the publisher, an example, gotchas, and the upstream README verbatim.
Futureverse winddown — read this first
Futureverse, the publisher of @futureverse/*, is winding down. Hosted services in the dependency path of these packages — auth.futureverse.app, ar-api.futureverse.app, pass-api.futureverse.app — may go offline. For new projects prefer the @gen3labs/* community forks (by markibanez) or self-host the protocol against TRN directly using @therootnetwork/api + @therootnetwork/evm. See the Migration playbook for what each fv package depends on and how to replace it.
Status legend
trn-active- Vendor-neutral. Talks to TRN nodes only — safest dependency to take long-term.
fv-active- Still functional but routes through Futureverse-hosted services that may go away.
fv-winddown- Same as
fv-active, plus the package itself is unlikely to receive updates. Migrate. fv-archived- Old, unmaintained, last published before 2025.
fork-active- Community fork of an fv package — typically
@gen3labs/*. Use these as drop-in replacements. scaffold- Project scaffolder — runs once at
create-…time, not a runtime dep.
@therootnetwork — chain-direct, vendor-neutral
| Package | Version | Status | Summary |
|---|---|---|---|
@therootnetwork/api | 1.1.0 | trn-active | Polkadot.js helpers that bundle TRN-specific types and a one-call connect helper. |
@therootnetwork/api-types | 1.2.0 | trn-active | TRN-specific Substrate type bundle (typesBundle, definitions) for use with @polkadot/api. |
@therootnetwork/extrinsic | 2.0.0 | trn-active | Sugar over api.tx.X.Y(...).signAndSend(...): builds, signs, optionally fee-proxies, and waits for finalisation. |
@therootnetwork/evm | 1.0.5 | trn-active | EVM helpers: chain definitions, precompile address derivation, ABIs. |
@therootnetwork/doughnut-nodejs | 0.1.2 | trn-active | Node bindings (Wasm) for the Doughnut capability-token codec. |
@therootnetwork/doughnut-web | 0.1.2 | trn-active | Browser-Wasm bindings for the Doughnut capability-token codec. |
@therootnetwork/pact-nodejs | 0.0.3 | trn-active | Node bindings (Wasm) for the TRN-Pact capability codec — Pact is the smart-contract-side capability language used by Centrality. |
@therootnetwork/pact-web | 0.0.3 | trn-active | Browser-Wasm bindings for the TRN-Pact capability codec. |
@gen3labs — community forks (post-fv-winddown)
| Package | Version | Status | Summary |
|---|---|---|---|
@gen3labs/futurepass-wagmi-connectors | 4.0.4 | fork-active | Community fork of @futureverse/wagmi-connectors. |
@gen3labs/futurepass-auth-react | 5.0.4 | fork-active | Community fork of @futureverse/auth-react. |
@gen3labs/futurepass-signer | 1.8.0 | fork-active | Community fork of @futureverse/signer. |
@gen3labs/futurepass-signer-core | 0.3.0 | fork-active | Community fork of @futureverse/signer-core. |
@gen3labs/futurepass-transact | 0.8.0 | fork-active | Community fork of @futureverse/transact. |
@gen3labs/futurepass-auth-core | 1.0.2 | fork-active | Community fork of @futureverse/auth-core. |
@gen3labs/futurepass-auth-ui | 1.0.7 | fork-active | Community fork of @futureverse/auth-ui. |
@gen3labs/futurepass-auth | 5.0.3 | fork-active | Community fork of @futureverse/auth (v5.0.3). Same OIDC client surface. |
@futureverse — Auth / FuturePass
| Package | Version | Status | Summary |
|---|---|---|---|
@futureverse/auth | 5.0.3 | fv-winddown | OIDC client for FuturePass — handles the OAuth2-style flow against auth.futureverse.app. |
@futureverse/auth-react | 5.0.4 | fv-winddown | React provider + hooks (<FutureverseAuthProvider>, useAuth()) on top of @futureverse/auth. |
@futureverse/auth-react-native | 1.1.2 | fv-winddown | React Native + Expo provider that wraps the OIDC flow with platform-native session storage. |
@futureverse/auth-core | 1.0.2 | fv-winddown | Shared internals (token refresh, storage shim, PKCE helpers) used by other auth packages. |
@futureverse/auth-ui | 1.0.7 | fv-winddown | Pre-styled React components for FuturePass sign-in modals + the “connect wallet” shelf. |
@futureverse/next-auth | 1.0.6 | fv-winddown | Auth.js (Next-Auth) provider for FuturePass — pure server-side OAuth handler. |
@futureverse/oidc-client | 0.1.3 | fv-archived | Older low-level OIDC client. Superseded by @futureverse/auth. |
@futureverse/wagmi-connectors | 4.0.4 | fv-winddown | wagmi Connector implementations that surface a FuturePass session as an EVM wallet to wagmi/viem. |
@futureverse/signer | 1.8.0 | fv-winddown | Common signer interface (signMessage, signTransaction, signExtrinsic) abstracting over EOA / Pass / EthersJS. |
@futureverse/signer-core | 0.3.0 | fv-winddown | Shared base interface used by @futureverse/signer and adapters. |
@futureverse/wallet-signer-etherjs | 1.0.1 | fv-archived | Adapter exposing a Futureverse wallet as an ethers.js Signer. |
@futureverse — Transactions
| Package | Version | Status | Summary |
|---|---|---|---|
@futureverse/transact | 0.8.0 | fv-winddown | Higher-level API for building, sponsoring, and submitting transactions on TRN — handles fee proxying, futurepass proxy wrapping, and gasless flows. |
@futureverse/transact-react | 0.4.0 | fv-winddown | React wrapper around @futureverse/transact (useTransact(), <TransactProvider>). |
@futureverse/evm | 1.1.0 | fv-winddown | Same surface as @therootnetwork/evm but published under fv. Chain definitions + precompile helpers. |
@futureverse — Asset Register
| Package | Version | Status | Summary |
|---|---|---|---|
@futureverse/asset-register | 2.82.0 | fv-winddown | Core SDK for the Asset Register GraphQL API (read + write asset relationships). |
@futureverse/asset-register-react | 2.71.3 | fv-winddown | React provider + hooks: useAssets(), useAssetTree(), useEquippedAccessories(). |
@futureverse/swappable-viewer-react | 1.5.8 | fv-winddown | Hooks/components for "swappable" parents — e.g. an avatar collection where you swap which child is currently equipped. |
@futureverse/artm | 2.3.2 | fv-winddown | Asset Register Transaction Message codec — encodes batched link operations as a single signed Ethereum message. |
@futureverse — Sylo
| Package | Version | Status | Summary |
|---|---|---|---|
@futureverse/sylo-protocol-sdk | 0.0.0-pre-SM-337.1 | fv-winddown | Client for the Sylo Seekers Node Network — decentralised messaging and data services. |
@futureverse/sylo-protocol-abi | 1.0.4-pre-1 | fv-winddown | Compiled ABIs for the Sylo protocol Ethereum contracts. |
@futureverse/sylo-notifications-sdk | 0.0.0-pre-SM-337.5 | fv-winddown | Broadcast / subscribe to Futureverse notifications over Sylo nodes. |
@futureverse/sylo-data-protocol | 0.3.0 | fv-winddown | Sylo data-access protocol primitives (granted/revoked data permissions, encrypted blobs). |
@futureverse — Mint, UI, build tooling
| Package | Version | Status | Summary |
|---|---|---|---|
@futureverse/mint-sdk | 2.0.0 | fv-archived | Mint NFT/SFT collections via Futureverse-hosted endpoints. |
@futureverse/mint-sdk-react | 2.0.0 | fv-archived | React wrapper around the Mint SDK. |
@futureverse/component-library | 0.2.4 | fv-archived | Shared React UI primitives (buttons, inputs, layout). |
@futureverse/react-unity-viewer | 0.1.2 | fv-archived | Embed Unity WebGL builds inside React with two-way message bridging. |
@futureverse/nx-semantic-release-sync | 0.12.1 | fv-archived | Nx plugin for coordinated semantic-release across monorepo packages. |
Third-party
| Package | Version | Status | Summary |
|---|---|---|---|
@richie-rich/create-fv-app | 0.0.15 | scaffold | Project scaffolder — npm create @richie-rich/fv-app to bootstrap a Futureverse-style React app. |