Artemis-SDK

Artemis SDK is a React library built with TypeScript, designed to simplify the integration of NEAR Blockchain functionality into React applications. It abstracts the usage of the NEAR-API-JS library and provides easy access to public APIs from the NEAR block explorer.

Installation

npm install artemis-sdk

or

yarn add artemis-sdk

Usage

Artemis-SDK makes it straightforward to interact with the NEAR Blockchain in your React applications. Here's a quick example using Next.js:

"use client"

import { useNearWallet } from "artemis-sdk"

export default function Home() {
  const { isLoading, wallet } = useNearWallet()

  if (isLoading) {
    return (
      <div>
        <span>LOADING...</span>
      </div>
    )
  }

  return (
    <div>
      <pre>{JSON.stringify(wallet, null, 2)}</pre>
    </div>
  )
}

Features

• Abstracts NEAR-API-JS for simplified integration.
• Provides easy access to public APIs from the NEAR block explorer.
• Written in TypeScript for enhanced development experience.

React Hooks

useNearWallet

The useNearWallet hook initializes a connection to the NEAR blockchain and provides access to the connected wallet instance.

Usage

const { isLoading, wallet } = useNearWallet();

API

• wallet: An instance of the NEAR WalletConnection.
• isLoading: A boolean indicating whether the wallet is still loading.

useSignin

The useSignin hook returns function that trigger a sign in event and redirect you to near wallet platform.

Usage

const { onSignin } = useSignin({
  contractId,
  failureUrl,
  methodNames,
  successUrl,
});

API

• onSignin: A function that trigger a sign in event and redirect you to near wallet platform.
• contractId: The Near Contract ID you wanna interact with.
• failureUrl: The URL user will be redirect if the sign in goes wrong. (optional)
• successUrl: The URL user will be redirect if the sign in works correctly. (optional)
• methodNames: The methods from the Near Contract. (optional - By default you will get access to all methods)

Utils Functions

Contributing

We welcome contributions! Feel free to open issues or pull requests. For major changes, please open an issue first to discuss what you would like to change on Github.