near-api-js icon indicating copy to clipboard operation
near-api-js copied to clipboard

JavaScript library to interact with NEAR Protocol via RPC API

NEAR JavaScript API

Build Status Gitpod Ready-to-Code

NEAR JavaScript API is a complete library to interact with the NEAR blockchain. You can use it in the browser, or in Node.js runtime.

Documentation

Contribute to this library

  1. Install dependencies

    yarn
    
  2. Run continuous build with:

    yarn build -- -w
    

Publish

Prepare dist version by running:

yarn dist

When publishing to npm use np.

Integration Test

Start the node by following instructions from nearcore, then

yarn test

Tests use sample contract from near-hello npm package, see https://github.com/nearprotocol/near-hello

Update error schema

Follow next steps:

  1. Change hash for the commit with errors in the nearcore
  2. Fetch new schema: node fetch_error_schema.js
  3. yarn build to update lib/**.js files

License

This repository is distributed under the terms of both the MIT license and the Apache License (Version 2.0). See LICENSE and LICENSE-APACHE for details.