@stacks/blockchain-api-client

@stacks/blockchain-api-client

A JS Client for the Stacks Blockchain API

Features

This package provides the ability to:

• Execute REST API requests against the Stacks Blockchain API
• Subscribe to WebSockets for real-time Stacks updates (for addresses or transactions)
• Full type safety for WebSocket and API requests and responses

Installation

You can install this package using NPM:

npm install --save-dev @stacks/blockchain-api-client

Usage

Here is an example code that connects with the WebSocket server and subscribes to updates for a specific Stacks address:

import { connectWebSocketClient } from '@stacks/blockchain-api-client';

// for mainnet, replace with ws://stacks-node-api.testnet.stacks.co/
const client = await connectWebSocketClient('wss://stacks-node-api.mainnet.stacks.co/');

const sub = await client.subscribeAddressTransactions('ST3GQB6WGCWKDNFNPSQRV8DY93JN06XPZ2ZE9EVMA', event =>
  console.log(event);
  /*
    {
      address: 'ST3GQB6WGCWKDNFNPSQRV8DY93JN06XPZ2ZE9EVMA',
      tx_id: '0x8912000000000000000000000000000000000000000000000000000000000000',
      tx_status: 'success',
      tx_type: 'token_transfer',
    }
  */
);

await sub.unsubscribe();

Documentation

You can find full references here.

Known Issues

• The TypeScript definitions for several objects involving type unions, including transactions, are incorrectly specified as only object.

Changelog

0.51.0 (2021-03-04)

Bug Fixes

• dropped mempool tx list count property (58d0e31)
• improve conditions in which a dropped vs non-canonical tx result is returned (2a57fbc)
• update conditions for when a mined canonical vs non-canonical, vs mempool tx is returned (573f75c)

Features

• distinct tx status values for mempool txs vs mined tx responses (3236053)
• endpoint to query dropped mempool txs (4556cd7)
• implement dropped transaction event handling and API responses (9936c66)