open-index/open-npm huggingface dataset:
npm package: @gardenfi/hyperliquid-swaps
Description: Bridge tokens between Hyperliquid and EVM chains
Author: Mani
Latest version: 1.0.4

# @gardenfi/hyperliquid-swaps

A TypeScript SDK for bridging tokens to and from Hyperliquid trading accounts to Arbitrum or HyperEVM, leveraging Hyperliquid APIs.

## Overview

This package provides seamless integration between EVM chains and Hyperliquid's trading infrastructure:

- **Spot Trading**: Connect any EVM token to Hyperliquid's spot account via hyperEVM
- **Perpetual Trading**: Bridge USDC from Arbitrum to Hyperliquid's perpetual trading account

## Key Features

### Spot Account (HyperEVM ↔ HyperCore)

- **Multi-Token Support**: Seamlessly bridge any supported EVM token from HyperEVM to Hyperliquid's spot account
- **Real-time Balances**: Monitor account balances across all supported tokens

### Perpetual Account (Arbitrum ↔ Hyperliquid)

- **USDC Bridge**: Dedicated pathway for USDC transfers between Arbitrum and Hyperliquid's perp's account
- **Balance Management**: Real-time USDC balance tracking in your perpetual account

## Quick Start

```typescript
import {
  createHyperliquid,
  HyperliquidSpot,
  HyperliquidPerp,
} from "@gardenfi/hyperliquid-swaps";
import { createWalletClient } from "viem";

// Option 1: Create separate account classes
const spotAccount = new HyperliquidSpot(walletClient, Network.MAINNET);
const perpAccount = new HyperliquidPerp(walletClient, Network.MAINNET);

// Option 2: Create both accounts together
const { spot, perp } = createHyperliquid({
  network: Network.MAINNET,
  wallet: walletClient,
});

// Get available tokens
const tokens = await spot.getTokens();

// Spot: Deposit any token to hyperEVM
await spot.deposit("USDC", "1000000000"); // 1000 USDC (6 decimals)

// Spot: Withdraw any token from hyperEVM
await spot.withdraw("HYPE", "0.001"); // 0.001 HYPE

// Perp: Deposit USDC from Arbitrum
await perp.deposit("1000000000"); // 1000 USDC (6 decimals)

// Perp: Withdraw USDC to Arbitrum
await perp.withdraw("1000"); // 1000 USDC

// Spot: Transfer USDC to perp account
await spot.transfer("5"); // 5 USDC

// Perp: Transfer USDC to spot account
await perp.transfer("5"); // 5 USDC
```

## Network Architecture

```
Arbitrum <──> Hyperliquid Perp (USDC Only)
hyperEVM <──> Hyperliquid Spot (Any Token)
```

## Installation

```bash
npm install @gardenfi/hyperliquid-swaps
```
npm package: @gardenhq/component-factory
Description: CF
Author: GardenHQ
Latest version: 1.4.0

# component-factory

Just incase, please don't use as yet unless part of o. This is so under-development it doesn't even have a name yet. It will be deprecated/unpublished as soon as we have a name and has better api/coverage and then republished.

## Getting Started

```
javascript

```

## License

ISC License

Copyright (c) 2017-present, GardenHQ <gardener@gardenhq.io>

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.## License