Skip to main content

Installation

npm

npm install shadowfeed-agent

yarn

yarn add shadowfeed-agent

pnpm

pnpm add shadowfeed-agent

Requirements

  • Node.js 18 or later
  • TypeScript 5.0+ (optional but recommended)

Dependencies

The SDK automatically installs these dependencies:
PackagePurpose
axiosHTTP client for API requests
x402-stacksx402 payment protocol for Stacks blockchain

Verify Installation

import { ShadowFeed } from 'shadowfeed-agent';

const sf = new ShadowFeed({
  privateKey: 'your-private-key-hex',
  network: 'mainnet',
});

// Should log your SP... address
console.log(sf.address);

TypeScript Support

The SDK ships with full TypeScript declarations. All types are exported:
import type {
  ShadowFeedConfig,
  FeedId,
  FeedInfo,
  PurchaseResult,
  ChainResult,
  DiscoverOptions,
} from 'shadowfeed-agent';