@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., including Bitcoin BIP322 message proofs and P2TR/BIP341, P2WPKH/BIP143, and P2PKH transaction signing, 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, /solana, /tron, and /bitcoin). 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, SIWE/SIWS builders, Tron helpers, Bitcoin P2TR/P2WPKH/P2PKH address, tweak and Blockbook RPC helpers, passkey codec, AAGUID registry, and Solana transaction parsing. (Every sensitive op 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
@moon-x/core/react/bitcoin  — chain-specific Bitcoin hooks

License

UNLICENSED. All rights reserved.