# @moon-x/core

Shared foundation for the [MoonX](https://moonx.com) platform SDKs. This package is consumed by
[`@moon-x/react-sdk`](https://www.npmjs.com/package/@moon-x/react-sdk) and
[`@moon-x/react-native-sdk`](https://www.npmjs.com/package/@moon-x/react-native-sdk) —
**you almost certainly want one of those instead of installing this directly.**

```sh
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.
