> For the complete documentation index, see [llms.txt](https://elacity.gitbook.io/elacity-sdks/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://elacity.gitbook.io/elacity-sdks/documentation/common/summary.md).

# Overview

This section documents `@elacity-js/common`, the shared foundation package used across Elacity SDKs. It contains small, reusable primitives (chains, auth types/storage interfaces, and pagination shapes) that other packages depend on.

## What it contains

### Chains

* `ChainId`: an enum of supported chain IDs used consistently across SDKs (API + contracts).
* See: [Chains](https://github.com/Elacity/wiki/blob/main/common/Chains.md)

### Authentication primitives

* `AuthUser`: shape of an authenticated session (address, token, expiry, optional smart-account address).
* `AuthTokenStorage`: storage interface to persist/load/clear a session.
* `MemoryTokenStorage`: in-memory `AuthTokenStorage` implementation.
* `AuthSigner`: minimal interface required for “sign-in with wallet” style flows.
* See: [Authentication](https://github.com/Elacity/wiki/blob/main/common/Authentication.md)

### Pagination primitives

* `FilterPaginationInput`: common query options (offset/limit/sort/search).
* `PaginatedResponse<T>`: common paginated response shape.
* See: [Pagination](https://github.com/Elacity/wiki/blob/main/common/Pagination.md)

### Token Management

* `TokenID`: For robust token ID handling (hex vs number, BigInt support).
* See: [TokenID](https://github.com/Elacity/wiki/blob/main/common/TokenID.md)

### Waitable Pattern

* `Waitable`/`Waiter`: Promise wrappers for event-based async management.
* See: [Waitable](https://github.com/Elacity/wiki/blob/main/common/Waitable.md)

### Utilities

* A collection of helper functions for Async, String, URL/IPFS, Date, and more.
* See: [Utilities](https://github.com/Elacity/wiki/blob/main/common/Utilities.md)

## References

* [Authentication](https://github.com/Elacity/wiki/blob/main/common/Authentication.md)
* [Pagination](https://github.com/Elacity/wiki/blob/main/common/Pagination.md)
* [Chains](https://github.com/Elacity/wiki/blob/main/common/Chains.md)
* [TokenID](https://github.com/Elacity/wiki/blob/main/common/TokenID.md)
* [Waitable](https://github.com/Elacity/wiki/blob/main/common/Waitable.md)
* [Utilities](https://github.com/Elacity/wiki/blob/main/common/Utilities.md)
