Shogun SDK

A comprehensive TypeScript SDK for cross-chain DeFi operations, token swaps, and wallet management.

Quick Start

1. Install the SDK

Choose the installation method that works for your project:

npm

npm install shogun-sdk

pnpm

pnpm add shogun-sdk

yarn

yarn add shogun-sdk

2. Use the SDK

import { LegoClient, useShogunQuote, Button } from 'shogun-sdk';

// Initialize client
const client = new LegoClient({ apiKey: 'YOUR_API_KEY' });

// Use React hooks
function MyComponent() {
  const { quote, isLoading } = useShogunQuote();
  return <Button>Swap Tokens</Button>;
}

3. Explore the Documentation

Each package has detailed documentation and examples. See the links below for specific guides.

Packages Overview

The Shogun SDK is a monorepo containing multiple specialized packages:

Core Packages

React Integration

Authentication & Wallet

What Each Package Does

🔧 Core Functionality

• money-legos: The main engine for cross-chain swaps, price quotes, balance checking, and fee calculations
• intents-sdk: Advanced intent-based transactions for complex cross-chain operations
• shogun-sdk: Convenience package that includes everything in one install

⚛️ React Development

• one-shot: Hooks like useShogunQuote, useTokenBalances for building swap UIs
• ui-kit: Pre-built components like Button, Card, Modal for consistent design

🔐 Wallet & Auth

• turnkey: Server-side wallet creation and management
• turnkey-react: Client-side React components for login, passkeys, and authentication flows

Supported Chains

• EVM Chains: Ethereum, Arbitrum, Optimism, Base, BSC, Bera Chain, Sonic
• Solana: Native Solana support
• Sui: Native Sui blockchain support

Development

# Install dependencies
pnpm install

# Build all packages
pnpm run build

# Run tests
pnpm test

# Lint code
pnpm run lint

Examples

Check out the examples directory for complete working examples:

• Web App Example: React app showing token swaps with UI components

Support

• GitHub Issues
• Documentation

License

ISC