Hiro Docs

This reference refers to the next release of Stacks.js, it's the recommended version to use, but might see some changes in the near future. Read the migration guide to learn how to update to the latest version.

The @stacks/network package contains default network configurations for Stacks.

Installation

Before you install: most of the time you don't need to use or even install this library directly. For example, instead of STACKS_MAINNET, simply use the string "mainnet" as the network parameter.

npm install @stacks/network@next

Usage

The network object

A network in Stacks.js is an object defining several properties.

import { STACKS_MAINNET, STACKS_TESTNET, STACKS_DEVNET } from '@stacks/network';

console.log(STACKS_MAINNET);
// {
//   chainId: 1,
//   transactionVersion: 0,
//   peerNetworkId: 385875968,
//   magicBytes: 'X2',
//   bootAddress: 'SP000000000000000000002Q6VF78',
//   addressVersion: { singleSig: 22, multiSig: 20 }
// }

Network usage in transaction building

import { STACKS_MAINNET } from '@stacks/network';
import { makeSTXTokenTransfer } from '@stacks/transactions';

const txOptions = {
  recipient: 'SP2BS6HD7TN34V8Z5BNF8Q2AW3K8K2DPV4264CF26',
  amount: 100,
  // ...
  network: 'mainnet', // 'mainnet', 'testnet', or 'devnet', (defaults to mainnet)
  // OR
  network: STACKS_MAINNET, // any compatible network object
};

const transaction = await makeSTXTokenTransfer(txOptions);