@moon-x/core

Shared foundation for the MoonX platform SDKs. This package is consumed by @moon-x/react-sdk and @moon-x/react-native-sdk — you almost certainly want one of those instead of installing this directly.

npm install @moon-x/react-sdk          # web
npm install @moon-x/react-native-sdk   # mobile

What's here

This package owns everything that's identical between web and mobile:

• Wire types and protocol (@moon-x/core/types, @moon-x/core/utils) — PublicWallet, Chain, AuthAppearance, plus the PostMessageType / PostMessageMethod enums and the PostMessageClient / PostMessageServer classes used by every iframe ↔ SDK channel.
• Headless SDK factories (@moon-x/core/sdk) — platform-agnostic implementations of signMessage, signTransaction, sendTransaction, etc. that take a Transport + PasskeyAssertor + KvStorage via DI. Web and RN both wire their platform impls into these factories.
• Web platform impls (@moon-x/core/web) — createIframeTransport, createWebAuthnPasskey, createLocalStorageKv. React-native has its own equivalents inside @moon-x/react-native-sdk/platform/*.
• Shared React hooks (@moon-x/core/react) — platform-agnostic primitives (useUser, useWallets, useLogout, useLoginWithEmail, usePasskeyStatus, useAddPasskey, useRemovePasskey, useCreateWallet, useImportKey, plus per-chain hooks under @moon-x/core/react/ethereum, @moon-x/core/react/solana, and @moon-x/core/react/tron). Platform SDKs compose the subset they support so consumers don't import from core directly.
• Pure utilities (@moon-x/core/lib) — EVM chain/gas helpers (getEvmGasPrice, estimateEvmGas, getEvmNonce, chains), prepareEvmSignTransaction / prepareEvmSendTransaction (chain + RPC + nonce/gas/fee auto-fill), SIWE/SIWS message builders, Tron chain/address/transaction helpers, passkey codec + generatePasskeyUserId, AAGUID registry, Solana transaction log parser, etc. (The parent-side passkey-assertion cache was removed in Phase 4 of the presence-token gating work — every sensitive op now mints scope-bound single-use tokens via getInternalPresenceTokens.)

Subpath exports

@moon-x/core              — core types barrel (rarely used directly)
@moon-x/core/types        — Chain, PublicWallet, AuthAppearance, all wire shapes
@moon-x/core/utils        — PostMessageClient/Server + protocol enums
@moon-x/core/lib          — pure utilities (auth state, passkey, ethereum/*, solana/*, tron/*)
@moon-x/core/sdk          — DI interfaces + headless SDK factories
@moon-x/core/web          — web platform implementations (iframe transport, WebAuthn)
@moon-x/core/react        — shared React hooks
@moon-x/core/react/ethereum — chain-specific Ethereum hooks
@moon-x/core/react/solana   — chain-specific Solana hooks
@moon-x/core/react/tron     — chain-specific Tron hooks

License

UNLICENSED. All rights reserved.