Registry / data / space-data-server

space-data-server

library23.3.3-0.1.2-1.40.2jsnpmunverified

An open-source waypoint for ingestion and data services based on SpaceDataStandards.org. Current stable version 23.3.3-0.1.2-1.40.2. It helps integrators include space data standards into workflows, ingest from sources like Celestrak OMM, and publish to IPFS. Under heavy development; provides local API, server key management, and data formatting options.

data web-framework http-networking aws

npm install space-data-server

package ↗

INSTALL

IMPORT

SIG · SPACE-DATA-SERVER

space-data-server

datajavascriptv23.3.3-0.1.2-1.40.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import SpaceDataServer from 'space-data-server'

✗ const SpaceDataServer = require('space-data-server')

ESM-only; CommonJS require not supported.

startServer

✓ import { startServer } from 'space-data-server'

Named export for initializing the server.

IngestService

✓ import { IngestService } from 'space-data-server'

✗ import IngestService from 'space-data-server'

Named export, not default.

ServerConfig

✓ import type { ServerConfig } from 'space-data-server'

✗ import { ServerConfig } from 'space-data-server'

TypeScript type import; not a runtime value.

Initialize the server with an Ethereum wallet and IPFS client, then ingest OMM data from Celestrak.

import { startServer, IngestService } from 'space-data-server'; import { ethers } from 'ethers'; import { create } from 'ipfs-http-client'; const ipfs = create({ url: process.env.IPFS_URL ?? 'http://localhost:5001' }); const wallet = new ethers.Wallet(process.env.ETHEREUM_PRIVATE_KEY ?? ''); const server = await startServer({ port: 3000, dataDir: './data', ipfs, wallet, }); console.log('Space Data Server running on port', server.port); const ingest = new IngestService({ server }); await ingest.ingestFromCelestrak(); console.log('Ingested OMM data from Celestrak');

Debug

Known issues

breakingMajor version 23 changed the default export from an object to a named export pattern.

fix

Use named imports: import { startServer } from 'space-data-server' instead of const SDS = require('space-data-server')

affects: >=23.0.0

deprecatedThe 'localspacedata' API path is deprecated and will be removed.

fix

Use the updated API path as documented in the current README.

affects: >=22.0.0

gotchaServer key must be an Ethereum key; loading from file requires a .json keystore or private key.

fix

Ensure the wallet file is in standard Ethereum keystore format or provide a private key.

affects: >=20.0.0

gotchaIPFS node must be running locally or accessible via URL; server will fail to start otherwise.

fix

Start an IPFS daemon or provide a valid IPFS HTTP API URL.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'space-data-server'

Package not installed or ESM-only module imported with require()

fix

Ensure you have run 'npm install space-data-server' and use ES import syntax: import { startServer } from 'space-data-server'

TypeError: SDS.startServer is not a function

Using default import incorrectly; startServer is a named export

fix

Use named import: import { startServer } from 'space-data-server'

Error: IPFS node is not reachable

IPFS daemon not running or URL misconfigured

fix

Start IPFS daemon (ipfs daemon) or set IPFS_URL environment variable to the correct API address.

Error: Invalid private key

Provided Ethereum private key is not a valid hex string

fix

Provide a valid 64-character hex private key (without 0x).

Upgrade

Version history

23.3.3-0.1.2-1.40.2latest on npm

Audit

Dependencies

ethersrequiredUsed for Ethereum key management and server key updates

ipfs-http-clientrequiredRequired for IPFS folder publishing and file pinning/unpinning

expressrequiredHTTP server framework for the local API

Agent activity

25 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://www.npmjs.com/package/space-data-server ↗