# SDK

Software Development Kits for integrating Omniston liquidity aggregation.

## Available SDKs

### [Node.js SDK](https://docs.ston.fi/developer-section/omniston/sdk/nodejs)

Full-featured SDK for backend integration:

* TypeScript support
* RxJS Observable-based API
* Comprehensive error handling
* WebSocket subscriptions

### [React SDK](https://docs.ston.fi/developer-section/omniston/sdk/react)

React hooks for frontend integration:

* Ready-to-use React hooks
* TanStack Query integration
* Real-time price updates
* Transaction building and sending
* Wallet connection support

## Installation

### Node.js

```bash
npm install @ston-fi/omniston-sdk
```

### React

```bash
npm install @ston-fi/omniston-sdk-react
```

## Quick Start

### Node.js

```typescript
import { Omniston } from '@ston-fi/omniston-sdk';

const omniston = new Omniston({
  apiUrl: 'wss://omni-ws.ston.fi'
});

omniston.requestForQuote({
  // quote parameters
}).subscribe((quoteEvent) => {
  // handle quote updates
});
```

### React

```tsx
import { useRfq } from '@ston-fi/omniston-sdk-react';

function SwapComponent() {
  const { data: quote, isLoading, error } = useRfq({
    // quote parameters
  });
  // ... component logic
}
```

## Features

* **Best Price Discovery**: Automatically finds optimal swap routes
* **Multi-source Aggregation**: Combines liquidity from multiple DEXs
* **Real-time Quotes**: Live price updates via WebSocket
* **Transaction Building**: Ready-to-send transaction objects
* **Error Handling**: Comprehensive error types and recovery

## Documentation

See individual SDK documentation for detailed usage:

* [Node.js SDK Documentation](https://docs.ston.fi/developer-section/omniston/sdk/nodejs)
* [React SDK Documentation](https://docs.ston.fi/developer-section/omniston/sdk/react)