saber-hq / sail

⛵️ A React library for Solana account management and transaction processing.

sail ⛵️

A React library for Solana account management and transaction handling.

Setup

Run:

yarn add @saberhq/sail react-query

Usage

You will need to first set up React Query.

Then:

import { SailProvider } from "@saberhq/sail";
import { QueryClient, QueryClientProvider } from "react-query";

const queryClient = new QueryClient();

const MyApp: React.FC = () => (
  <QueryClientProvider client={queryClient}>
    <SailProvider initialState={{ onTxSend, onSailError }}>
      {/* stuff */}
    </SailProvider>
  </QueryClientProvider>
);

Examples

The most prominent open source example is the Friktion frontend.

You can view a list of open source GitHub projects that use Sail here.

License

Sail is licensed under the Apache License, Version 2.0.

sail's Issues

data should always return in the same order of keys specified in same tick

https://github.com/saber-hq/sail/blob/master/src/useAccountsData.ts#L45

useAccountsData([key1, key2]); -> useAccountsData([key2, key1]); may confuse user with previous data that exists for key1

Remove getAccountInfo call in handleTX

This call is unnecessary since the simulation will return an error code about the SOL account having insufficient funds.

This should reduce load a bit

Case with a request for user tokens

It is interesting to consider the case of using the library when you need to load user tokens (for example, for future display, etc.)

How can this be done using this library?

Refactor to use react-query

React-query solves a lot of the performance issues that Sail faces. We should try to switch to it.

Add examples