> For the complete documentation index, see [llms.txt](https://docs.kumbaya.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kumbaya.xyz/developers/sdks/sdk-core.md).

# @kumbaya\_xyz/sdk-core

Core types, chain definitions, and shared primitives used by every other Kumbaya SDK.

```bash
npm install @kumbaya_xyz/sdk-core
```

## What's inside

* `Token`, `CurrencyAmount`, `Price`, `Percent` - basic value types
* `Ether`, `WETH9` - native and wrapped ETH helpers
* MegaETH chain definitions (`ChainId.MEGAETH = 4326`, `ChainId.MEGAETH_TESTNET = 6343`)
* Trade abstractions used by `router-sdk` and `smart-order-router`

## Use it when

* You need a `Token` instance to pass into the V3 SDK or router SDK.
* You need typed amounts, prices, or percentages.
* You're checking which chain you're on.

## Example

```ts
import { Token, ChainId } from '@kumbaya_xyz/sdk-core'

const USDC = new Token(
  ChainId.MEGAETH,
  '0x...USDC_ADDRESS_ON_MEGAETH...',
  6,
  'USDC',
  'USD Coin',
)
```

> *More reference coming soon.* For now, the upstream Uniswap [sdk-core docs](https://docs.uniswap.org/sdk/v3/overview) are 1:1 applicable except for chain IDs and addresses.