On this page

# @nina-protocol/js-sdk

A Javascript client for interacting with the Nina Protocol via the Nina API.

Nina Protocol is a digitally-native ecosystem for music built on Solana and Arweave.

`@nina-protocol/js-sdk` provides a convenient way to fetch and query both cached and on-chain data relevant to activity on the Nina Protocol. This includes:

- Accounts (any Solana wallet that interacts with the Nina Program including Artists and Collectors)
- Releases
- Hubs
- Exchanges
- Posts

## Installation

    yarn add @nina-protocol/js-sdk

or

    npm install @nina-protocol/js-sdk

## Usage

    import Nina from '@nina-protocol/js-sdk';
    Nina.client.init();

    //Fetch All Nina Releases
    const { releases } = await Nina.Release.fetchAll()

    //Fetch a single Release and its Account Data
    const { release } = await Nina.Release.fetch('BgVfERhoGVrRPJqGbDxhRbrxRhK3buTcbrrsZYEcwbNw', true)

    //Fetch Collectors for a Release and include their collections
    const { release } = await Nina.Release.fetchCollectors('BgVfERhoGVrRPJqGbDxhRbrxRhK3buTcbrrsZYEcwbNw', true)

    //Fetch a Hub by Handle
    const { hub, releases, collaborators, posts } = await Nina.Hub.fetch('ninas-picks')

    //Search
    const { artists, releases, hubs } = await Nina.Search.withQuery('techno')

## Demo

Visit the Api Explorer for an example of the `@nina-protocol/js-sdk` in use.

## Documentation

Full documentation is available here

## Future

Currently the SDK only provides interfaces for fetching data. In the future we will add support for interacting with the Nina Program (purchase Releases, publish Releases, repost Releases to Hub, etc).

## Developing

    git clone git@github.com:nina-protocol/js-sdk.git
    yarn
    yarn watch

## Contributors welcome!

Need help? Ask a question in our Discord or open an issue.

Type anything to view search result