@streamr/trackerless-network 0.0.1-tatum.0

package/.eslintignore

@@ -0,0 +1,7 @@
+node_modules/**
+coverage/**
+dist/**
+streamr-docker-dev/**
+docs/**
+.idea/**
+src/proto/**

package/.eslintrc

@@ -0,0 +1,3 @@
+{
+    "extends": "../../.eslintrc.js"
+}

package/README.md

@@ -0,0 +1,6 @@
+# Trackerless Network
+
+The Trackerless Network package is a reimplementation of the old (Corea-Brubeck) network package. 
+The package is reimplemented to use the network and transport stacks of the proto-rpc and DHT packages.
+The main change to the network is that the `d-regular random graph` stream topologies are now generated 
+using a decentralized algorithm based on peer discovery from the DHT.

package/bin/bootstrap-node.ts

@@ -0,0 +1,73 @@
+import { ConnectionManager, DhtNode, PeerDescriptor, NodeType, PeerID } from '@streamr/dht'
+import { StreamrNode, Event as StreamrNodeEvent } from '../src/logic/StreamrNode'
+import {
+    ContentMessage,
+    MessageRef,
+    StreamMessage,
+    StreamMessageType
+} from '../src/proto/packages/trackerless-network/protos/NetworkRpc'
+import { program } from 'commander'
+
+program
+    .option('--id <id>', 'Ethereum address / node id', 'bootstrap')
+    .option('--name <name>', 'Name in published messages', 'bootstrap')
+    .option('--streamIds <streamIds>', 'streamId to publish', (value: string) => value.split(','), ['stream-0'])
+    .option('--ip <ip>', 'Ip address to use', '0.0.0.0')
+    .option('--port <port>', 'Name in published messages', '23123')
+    .description('Run bootstrap node')
+    .parse(process.argv)
+
+async function run(): Promise<void> {
+
+    const streamPartId = 'stream#0'
+    const ip = program.opts().ip
+    const port = parseInt(program.opts().port)
+
+    const epPeerDescriptor: PeerDescriptor = {
+        kademliaId: PeerID.fromString(program.opts().id).value,
+        type: NodeType.NODEJS,
+        websocket: { ip, port }
+    }
+
+    const layer0 = new DhtNode({ peerDescriptor: epPeerDescriptor, numberOfNodesPerKBucket: 8 })
+    await layer0.start()
+    await layer0.joinDht([epPeerDescriptor])
+
+    const connectionManager = layer0.getTransport() as ConnectionManager
+    const streamrNode = new StreamrNode({})
+    await streamrNode.start(layer0, connectionManager, connectionManager)
+
+    await streamrNode.joinStream(streamPartId)
+    streamrNode.subscribeToStream(streamPartId)
+
+    streamrNode.on(StreamrNodeEvent.NEW_MESSAGE, (msg: StreamMessage) => {
+        // eslint-disable-next-line no-console
+        console.log(`new message received: ${JSON.parse(ContentMessage.fromBinary(msg.content).body).hello}`)
+    })
+
+    let sequenceNumber = 0
+    setInterval(() => {
+        const messageRef: MessageRef = {
+            sequenceNumber,
+            timestamp: BigInt(Date.now()),
+            publisherId: PeerID.fromValue(layer0.getPeerDescriptor().kademliaId).toString(),
+            streamPartition: 0,
+            streamId: streamPartId,
+            messageChainId: 'network'
+        }
+
+        const content: ContentMessage = {
+            body: JSON.stringify({ hello: `from ${program.opts().name }` })
+        }
+        const message: StreamMessage = {
+            content: ContentMessage.toBinary(content),
+            messageRef,
+            messageType: StreamMessageType.MESSAGE,
+            signature: 'signature'
+        }
+        streamrNode.publishToStream(streamPartId, epPeerDescriptor, message)
+        sequenceNumber++
+    }, 10000)
+}
+
+run()

package/bin/full-node-webrtc.ts

@@ -0,0 +1,102 @@
+import { ConnectionManager, DhtNode, PeerDescriptor, NodeType, PeerID } from '@streamr/dht'
+import { Event as StreamrNodeEvent, StreamrNode } from '../src/logic/StreamrNode'
+import {
+    ContentMessage,
+    MessageRef,
+    StreamMessage,
+    StreamMessageType
+} from '../src/proto/packages/trackerless-network/protos/NetworkRpc'
+import { program } from 'commander'
+
+program
+    .option('--id <id>', 'Ethereum address / node id', 'full-node')
+    .option('--name <name>', 'Name in published messages', 'full-node')
+    .option('--wsPort <wsPort>', 'port for ws server', '23124')
+    .option('--entrypointId <entrypointId>', 'Entrypoints stringId', 'bootstrap')
+    .option('--entrypointIp <entrypointIp>', 'Entrypoints IP address', '0.0.0.0')
+    .option('--streamIds <streamIds>', 'streamId to publish', (value: string) => value.split(','), ['stream-0'])
+    .description('Run full node')
+    .parse(process.argv)
+
+async function run(): Promise<void> {
+
+    const streamPartId = 'stream#0'
+
+    const epPeerDescriptor: PeerDescriptor = {
+        kademliaId: PeerID.fromString(program.opts().entrypointId).value,
+        type: NodeType.NODEJS,
+        websocket: { ip: program.opts().entrypointIp, port: 23123 }
+    }
+
+    const peerDescriptor: PeerDescriptor = {
+        kademliaId: PeerID.fromString(program.opts().id).value,
+        type: NodeType.NODEJS
+    }
+    const layer0 = new DhtNode({
+        peerDescriptor,
+        numberOfNodesPerKBucket: 2,
+        rpcRequestTimeout: 15000,
+        stunUrls: ['stun:stun.l.google.com:19302', 'turn:BrubeckTurn1:MIlbgtMw4nhpmbgqRrht1Q==@turn.streamr.network:5349'],
+        entryPoints: [epPeerDescriptor]
+    })
+    await layer0.start()
+
+    await layer0.joinDht([epPeerDescriptor])
+
+    const connectionManager = layer0.getTransport() as ConnectionManager
+    const streamrNode = new StreamrNode({})
+    await streamrNode.start(layer0, connectionManager, connectionManager)
+
+    streamrNode.subscribeToStream(streamPartId)
+
+    streamrNode.on(StreamrNodeEvent.NEW_MESSAGE, (msg: StreamMessage) => {
+        // eslint-disable-next-line no-console
+        console.log(`new message received: ${JSON.parse(ContentMessage.fromBinary(msg.content).body).hello}`)
+    })
+
+    let sequenceNumber = 0
+    setInterval(() => {
+        // eslint-disable-next-line no-console
+        console.log(
+            `Number of connected stream neighbors ${streamrNode.getStream(streamPartId)?.layer2.getTargetNeighborStringIds().length || 0}, `
+            + `targets: ${streamrNode.getStream(streamPartId)?.layer2.getTargetNeighborStringIds() || []}`
+        )
+        // eslint-disable-next-line no-console
+        console.log(
+            `Layer2: Nearby Contacts ${streamrNode.getStream(streamPartId)?.layer2.getNearbyContactPoolIds().length || 0}, `,
+            `Random Contacts ${streamrNode.getStream(streamPartId)?.layer2.getRandomContactPoolIds().length || 0}, `
+        )
+        // eslint-disable-next-line no-console
+        console.log(
+            `Layer1: Kbucket size ${streamrNode.getStream(streamPartId)?.layer1.getBucketSize() || 0} `,
+            `DHT contacts ${streamrNode.getStream(streamPartId)?.layer1.getNeighborList().getSize() || 0} `,
+        )
+        // eslint-disable-next-line no-console
+        console.log(
+            `Layer0: Kbucket size ${layer0.getBucketSize() || 0} `,
+            `DHT contacts ${layer0.getNeighborList().getSize() || 0}`
+        )
+        const messageRef: MessageRef = {
+            sequenceNumber,
+            timestamp: BigInt(Date.now()),
+            publisherId: PeerID.fromValue(layer0.getPeerDescriptor().kademliaId).toString(),
+            streamPartition: 0,
+            streamId: streamPartId,
+            messageChainId: 'network'
+        }
+
+        const content: ContentMessage = {
+            body: JSON.stringify({ hello: `from ${program.opts().name }` })
+        }
+        const message: StreamMessage = {
+            content: ContentMessage.toBinary(content),
+            messageRef,
+            messageType: StreamMessageType.MESSAGE,
+            signature: 'signature'
+        }
+        streamrNode.publishToStream(streamPartId, epPeerDescriptor, message)
+        sequenceNumber++
+    }, 10000)
+}
+
+run()

package/bin/full-node-websocket.ts

@@ -0,0 +1,102 @@
+import { ConnectionManager, DhtNode, NodeType, PeerDescriptor, PeerID } from '@streamr/dht'
+import { Event as StreamrNodeEvent, StreamrNode } from '../src/logic/StreamrNode'
+import {
+    ContentMessage,
+    MessageRef,
+    StreamMessage,
+    StreamMessageType
+} from '../src/proto/packages/trackerless-network/protos/NetworkRpc'
+import { program } from 'commander'
+
+program
+    .option('--id <id>', 'Ethereum address / node id', 'full-node')
+    .option('--name <name>', 'Name in published messages', 'full-node')
+    .option('--ip <ip>', 'Ip address to use', '0.0.0.0')
+    .option('--wsPort <port>', 'Name in published messages', '23124')
+    .option('--entrypointId <entrypointId>', 'Entrypoints stringId', 'bootstrap')
+    .option('--entrypointIp <entrypointIp>', 'Entrypoints IP address', '0.0.0.0')
+    .option('--streamIds <streamIds>', 'streamId to publish', (value: string) => value.split(','), ['stream-0'])
+    .description('Run full node')
+    .parse(process.argv)
+
+async function run(): Promise<void> {
+
+    const streamPartId = 'stream#0'
+    const port = parseInt(program.opts().wsPort, 10)
+    const ip = program.opts().ip
+
+    const epPeerDescriptor: PeerDescriptor = {
+        kademliaId: PeerID.fromString(program.opts().entrypointId).value,
+        type: NodeType.NODEJS,
+        websocket: { ip: program.opts().entrypointIp, port: 23123 }
+    }
+
+    const layer0 = new DhtNode({
+        webSocketPort: port,
+        webSocketHost: ip,
+        peerIdString: program.opts().id,
+        numberOfNodesPerKBucket: 2,
+        entryPoints: [epPeerDescriptor]
+    })
+
+    await layer0.start()
+
+    await layer0.joinDht([epPeerDescriptor])
+
+    const connectionManager = layer0.getTransport() as ConnectionManager
+    const streamrNode = new StreamrNode({})
+    await streamrNode.start(layer0, connectionManager, connectionManager)
+
+    streamrNode.subscribeToStream(streamPartId)
+
+    streamrNode.on(StreamrNodeEvent.NEW_MESSAGE, (msg: StreamMessage) => {
+        // eslint-disable-next-line no-console
+        console.log(`new message received: ${JSON.parse(ContentMessage.fromBinary(msg.content).body).hello}`)
+    })
+
+    let sequenceNumber = 0
+    setInterval(() => {
+        // eslint-disable-next-line no-console
+        console.log(
+            `Number of connected stream neighbors ${streamrNode.getStream(streamPartId)?.layer2.getTargetNeighborStringIds().length || 0}, `
+            + `targets: ${streamrNode.getStream(streamPartId)?.layer2.getTargetNeighborStringIds() || []}`
+        )
+        // eslint-disable-next-line no-console
+        console.log(
+            `Layer2: Nearby Contacts ${streamrNode.getStream(streamPartId)?.layer2.getNearbyContactPoolIds().length || 0}, `,
+            `Random Contacts ${streamrNode.getStream(streamPartId)?.layer2.getRandomContactPoolIds().length || 0}, `
+        )
+        // eslint-disable-next-line no-console
+        console.log(
+            `Layer1: Kbucket size ${streamrNode.getStream(streamPartId)?.layer1.getBucketSize() || 0} `,
+            `DHT contacts ${streamrNode.getStream(streamPartId)?.layer1.getNeighborList().getSize() || 0} `,
+        )
+        // eslint-disable-next-line no-console
+        console.log(
+            `Layer0: Kbucket size ${layer0.getBucketSize() || 0} `,
+            `DHT contacts ${layer0.getNeighborList().getSize() || 0}`
+        )
+        const messageRef: MessageRef = {
+            sequenceNumber,
+            timestamp: BigInt(Date.now()),
+            publisherId: PeerID.fromValue(layer0.getPeerDescriptor().kademliaId).toString(),
+            streamPartition: 0,
+            streamId: streamPartId,
+            messageChainId: 'network'
+        }
+
+        const content: ContentMessage = {
+            body: JSON.stringify({ hello: `from ${program.opts().name }` })
+        }
+        const message: StreamMessage = {
+            content: ContentMessage.toBinary(content),
+            messageRef,
+            messageType: StreamMessageType.MESSAGE,
+            signature: 'signature'
+        }
+        streamrNode.publishToStream(streamPartId, epPeerDescriptor, message)
+        sequenceNumber++
+    }, 10000)
+}
+
+run()

package/bin/network.ts

@@ -0,0 +1,43 @@
+import { spawn } from 'child_process'
+import { program } from 'commander'
+import * as path from 'path'
+
+program
+    .option('--numOfNodes <id>', 'Number of nodes in the network', '10')
+    .option('--streamIds <streamIds>', 'streamId to publish', (value: string) => value.split(','), ['stream-0'])
+    .option('--entrypointIp <entrypointIp>', 'public IP of nodes to run', '0.0.0.0')
+    .description('Run bootstrap node')
+    .parse(process.argv)
+
+async function run(): Promise<void> {
+
+    const numOfNodes = parseInt(program.opts().numOfNodes, 10)
+
+    const args = [
+        path.resolve('./bin/bootstrap-node.ts'),
+        '--ip=' + program.opts().entrypointIp
+    ]
+
+    spawn('ts-node', args, {
+        stdio: [process.stdin, process.stdout, process.stderr]
+    })
+
+    setTimeout(async () => {
+        for (let i = 0; i < numOfNodes; i++) {
+            const args = [
+                path.resolve('./bin/full-node-webrtc.ts'),
+                '--id=full-node' + i,
+                '--name=full-node' + i,
+                '--wsPort=540' + i,
+                '--entrypointIp=' + program.opts().entrypointIp
+            ]
+
+            spawn('ts-node', args, {
+                stdio: [process.stdin, process.stdout, process.stderr]
+            })
+        }
+    }, 2000)
+
+}
+
+run()

package/dist/package.json

@@ -0,0 +1,53 @@
+{
+    "name": "@streamr/trackerless-network",
+    "version": "0.0.1-tatum.0",
+    "description": "Minimal and extendable implementation of the Streamr Network node.",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/streamr-dev/network-monorepo.git",
+        "directory": "packages/trackerless-network"
+    },
+    "main": "dist/src/exports.js",
+    "types": "dist/src/exports.d.ts",
+    "license": "STREAMR NETWORK OPEN SOURCE LICENSE",
+    "author": "Streamr Network AG <contact@streamr.network>",
+    "scripts": {
+        "build": "tsc -b tsconfig.node.json",
+        "build-browser": "webpack --mode=development --progress",
+        "generate-protoc-code": "./proto.sh",
+        "check": "tsc -p ./tsconfig.jest.json --noEmit",
+        "clean": "jest --clearCache || true; rm -rf dist *.tsbuildinfo node_modules/.cache || true",
+        "coverage": "jest --coverage",
+        "eslint": "eslint --cache --cache-location=node_modules/.cache/.eslintcache/ '*/**/*.{js,ts}'",
+        "test": "jest",
+        "test-browser": "karma start karma.config.js",
+        "test-unit": "jest test/unit",
+        "test-integration": "jest test/integration",
+        "test-e2e": "jest test/end-to-end",
+        "network": "ts-node bin/network",
+        "run-joining-benchmark": "node --max-old-space-size=24288 dist/test/benchmark/first-message.js"
+    },
+    "dependencies": {
+        "@protobuf-ts/runtime": "^2.8.2",
+        "@protobuf-ts/runtime-rpc": "^2.8.2",
+        "@streamr/dht": "0.0.1-tatum.0",
+        "@streamr/proto-rpc": "0.0.1-tatum.0",
+        "@streamr/protocol": "0.0.1-tatum.0",
+        "@streamr/test-utils": "0.0.1-tatum.0",
+        "@streamr/utils": "0.0.1-tatum.0",
+        "eventemitter3": "^5.0.0",
+        "lodash": "^4.17.21",
+        "yallist": "^4.0.0"
+    },
+    "devDependencies": {
+        "@streamr/browser-test-runner": "^0.0.1",
+        "@types/lodash": "^4.14.197",
+        "@types/yallist": "^4.0.1",
+        "commander": "^11.0.0",
+        "expect": "^29.6.2",
+        "express": "^4.17.1",
+        "ts-essentials": "^9.3.0",
+        "ts-loader": "^9.4.4",
+        "ts-node": "^10.9.1"
+    }
+}

package/dist/src/NameDirectory.d.ts

@@ -0,0 +1,5 @@
+import { EthereumAddress } from '@streamr/utils';
+export declare class NameDirectory {
+    static MAX_FALLBACK_NAME_LENGTH: number;
+    static getName(address: EthereumAddress | string | undefined): string | undefined;
+}

package/dist/src/NameDirectory.js

@@ -0,0 +1,44 @@
+"use strict";
+/*
+ * Get human-readable names for some Ethereum addresses in Streamr test environment
+ * The list doesn't contain all known contract addresses or nodes, but we can add more
+ * addresses if needed.
+ *
+ * Currently contains hardcoded names for all streamr-docker-dev Broker/Tracker entities
+ * -> in the future each node receives the peer names from Tracker
+ *    and we can remove the hardcoded values
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NameDirectory = void 0;
+const NAMES = {
+    '0xb9e7cebf7b03ae26458e32a059488386b05798e8': 'T1',
+    '0x0540a3e144cdd81f402e7772c76a5808b71d2d30': 'T2',
+    '0xf2c195be194a2c91e93eacb1d6d55a00552a85e2': 'T3',
+    '0xde1112f631486cfc759a50196853011528bc5fa0': 'S1',
+    '0xde222e8603fcf641f928e5f66a0cbf4de70d5352': 'B1',
+    '0xde3331ca6b8b636e0b82bf08e941f727b8927442': 'B2',
+    '0x6ccdd5d866ea766f6df5965aa98deccd629ff222': 'DOCKER_DEV_STREAM_REGISTRY',
+    '0xd04af489677001444280366dd0885b03daade71d': 'DOCKER_DEV_STREAM_STORAGE_REGISTRY',
+    '0x231b810d98702782963472e1d60a25496999e75d': 'DOCKER_DEV_STORAGE_NODE_REGISTRY'
+};
+// eslint-disable-next-line @typescript-eslint/no-extraneous-class
+class NameDirectory {
+    // if name is not known, creates a short name from the address
+    static getName(address) {
+        if (address === undefined) {
+            return undefined;
+        }
+        const name = NAMES[address.toLowerCase()];
+        if (name !== undefined) {
+            return name;
+        }
+        else {
+            return (address.length > NameDirectory.MAX_FALLBACK_NAME_LENGTH)
+                ? address.substring(0, this.MAX_FALLBACK_NAME_LENGTH)
+                : address;
+        }
+    }
+}
+exports.NameDirectory = NameDirectory;
+NameDirectory.MAX_FALLBACK_NAME_LENGTH = 8;
+//# sourceMappingURL=NameDirectory.js.map

package/dist/src/NameDirectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NameDirectory.js","sourceRoot":"","sources":["../../src/NameDirectory.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAIH,MAAM,KAAK,GAA2B;IAClC,4CAA4C,EAAE,IAAI;IAClD,4CAA4C,EAAE,IAAI;IAClD,4CAA4C,EAAE,IAAI;IAClD,4CAA4C,EAAE,IAAI;IAClD,4CAA4C,EAAE,IAAI;IAClD,4CAA4C,EAAE,IAAI;IAClD,4CAA4C,EAAE,4BAA4B;IAC1E,4CAA4C,EAAE,oCAAoC;IAClF,4CAA4C,EAAE,kCAAkC;CACnF,CAAA;AAED,kEAAkE;AAClE,MAAa,aAAa;IAItB,8DAA8D;IAC9D,MAAM,CAAC,OAAO,CAAC,OAA6C;QACxD,IAAI,OAAO,KAAK,SAAS,EAAE;YACvB,OAAO,SAAS,CAAA;SACnB;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;QACzC,IAAI,IAAI,KAAK,SAAS,EAAE;YACpB,OAAO,IAAI,CAAA;SACd;aAAM;YACH,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC,wBAAwB,CAAC;gBAC5D,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,wBAAwB,CAAC;gBACrD,CAAC,CAAC,OAAO,CAAA;SAChB;IACL,CAAC;;AAjBL,sCAkBC;AAhBU,sCAAwB,GAAG,CAAC,CAAA"}

package/dist/src/NetworkNode.d.ts

@@ -0,0 +1,35 @@
+import { StreamMessage, StreamPartID } from '@streamr/protocol';
+import { PeerDescriptor } from '@streamr/dht';
+import { NetworkOptions, NetworkStack } from './NetworkStack';
+import { MetricsContext } from '@streamr/utils';
+import { ProxyDirection } from './proto/packages/trackerless-network/protos/NetworkRpc';
+export declare class NetworkNode {
+    readonly stack: NetworkStack;
+    private readonly options;
+    private stopped;
+    constructor(opts: NetworkOptions);
+    start(doJoin?: boolean): Promise<void>;
+    setExtraMetadata(metadata: Record<string, unknown>): void;
+    inspect(node: PeerDescriptor, streamPartId: StreamPartID): Promise<boolean>;
+    publish(streamMessage: StreamMessage): Promise<void>;
+    subscribe(streamPartId: StreamPartID): Promise<void>;
+    setProxies(streamPartId: StreamPartID, contactPeerDescriptors: PeerDescriptor[], direction: ProxyDirection, getUserId: () => Promise<string>, connectionCount?: number): Promise<void>;
+    addMessageListener<T>(cb: (msg: StreamMessage<T>) => void): void;
+    setStreamPartEntryPoints(streamPartId: StreamPartID, contactPeerDescriptors: PeerDescriptor[]): void;
+    removeMessageListener<T>(cb: (msg: StreamMessage<T>) => void): void;
+    subscribeAndWaitForJoin(streamPartId: StreamPartID, timeout?: number, expectedNeighbors?: number): Promise<number>;
+    waitForJoinAndPublish(streamMessage: StreamMessage, timeout?: number): Promise<number>;
+    unsubscribe(streamPartId: StreamPartID): void;
+    getNeighborsForStreamPart(streamPartId: StreamPartID): ReadonlyArray<string>;
+    hasStreamPart(streamPartId: StreamPartID): boolean;
+    hasProxyConnection(streamPartId: StreamPartID, contactNodeId: string, direction: ProxyDirection): boolean;
+    getRtt(_nodeId: string): number | undefined;
+    stop(): Promise<void>;
+    getPeerDescriptor(): PeerDescriptor;
+    getMetricsContext(): MetricsContext;
+    getNodeId(): string;
+    getNodeStringId(): string;
+    getStreamParts(): StreamPartID[];
+    getNeighbors(): string[];
+    getDiagnosticInfo(): Record<string, unknown>;
+}

package/dist/src/NetworkNode.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkNode = void 0;
+const protocol_1 = require("@streamr/protocol");
+const StreamMessageTranslator_1 = require("./logic/protocol-integration/stream-message/StreamMessageTranslator");
+const NetworkStack_1 = require("./NetworkStack");
+const NetworkRpc_1 = require("./proto/packages/trackerless-network/protos/NetworkRpc");
+/*
+Convenience wrapper for building client-facing functionality. Used by client.
+*/
+class NetworkNode {
+    constructor(opts) {
+        this.stopped = false;
+        this.options = opts;
+        this.stack = new NetworkStack_1.NetworkStack(opts);
+    }
+    async start(doJoin) {
+        await this.stack.start(doJoin);
+    }
+    setExtraMetadata(metadata) {
+        this.stack.getStreamrNode().setExtraMetadata(metadata);
+    }
+    async inspect(node, streamPartId) {
+        return this.stack.getStreamrNode().inspect(node, streamPartId);
+    }
+    async publish(streamMessage) {
+        const streamPartId = streamMessage.getStreamPartID();
+        if (this.stack.getStreamrNode().isProxiedStreamPart(streamPartId, NetworkRpc_1.ProxyDirection.SUBSCRIBE)
+            && streamMessage.messageType === protocol_1.StreamMessageType.MESSAGE) {
+            throw new Error(`Cannot publish content data to ${streamPartId} as proxy subscribe connections have been set`);
+        }
+        await this.stack.joinLayer0IfRequired(streamPartId);
+        const msg = StreamMessageTranslator_1.StreamMessageTranslator.toProtobuf(streamMessage);
+        this.stack.getStreamrNode().publishToStream(streamPartId, msg);
+    }
+    async subscribe(streamPartId) {
+        if (this.stack.getStreamrNode().isProxiedStreamPart(streamPartId, NetworkRpc_1.ProxyDirection.PUBLISH)) {
+            throw new Error(`Cannot subscribe to ${streamPartId} as proxy publish connections have been set`);
+        }
+        await this.stack.joinLayer0IfRequired(streamPartId);
+        this.stack.getStreamrNode().subscribeToStream(streamPartId);
+    }
+    async setProxies(streamPartId, contactPeerDescriptors, direction, getUserId, connectionCount) {
+        if (this.options.networkNode.acceptProxyConnections) {
+            throw new Error('cannot set proxies when acceptProxyConnections=true');
+        }
+        await this.stack.getStreamrNode().setProxies(streamPartId, contactPeerDescriptors, direction, getUserId, connectionCount);
+    }
+    addMessageListener(cb) {
+        this.stack.getStreamrNode().on('newMessage', (msg) => {
+            const translated = StreamMessageTranslator_1.StreamMessageTranslator.toClientProtocol(msg);
+            return cb(translated);
+        });
+    }
+    setStreamPartEntryPoints(streamPartId, contactPeerDescriptors) {
+        this.stack.getStreamrNode().setStreamPartEntryPoints(streamPartId, contactPeerDescriptors);
+    }
+    removeMessageListener(cb) {
+        if (this.stopped) {
+            return;
+        }
+        this.stack.getStreamrNode().off('newMessage', (msg) => {
+            const translated = StreamMessageTranslator_1.StreamMessageTranslator.toClientProtocol(msg);
+            return cb(translated);
+        });
+    }
+    async subscribeAndWaitForJoin(streamPartId, timeout, expectedNeighbors) {
+        if (this.stack.getStreamrNode().isProxiedStreamPart(streamPartId, NetworkRpc_1.ProxyDirection.PUBLISH)) {
+            throw new Error(`Cannot subscribe to ${streamPartId} as proxy publish connections have been set`);
+        }
+        return this.stack.getStreamrNode().waitForJoinAndSubscribe(streamPartId, timeout, expectedNeighbors);
+    }
+    async waitForJoinAndPublish(streamMessage, timeout) {
+        const streamPartId = streamMessage.getStreamPartID();
+        const msg = StreamMessageTranslator_1.StreamMessageTranslator.toProtobuf(streamMessage);
+        if (this.stack.getStreamrNode().isProxiedStreamPart(streamPartId, NetworkRpc_1.ProxyDirection.SUBSCRIBE)) {
+            throw new Error(`Cannot publish to ${streamPartId} as proxy subscribe connections have been set`);
+        }
+        return this.stack.getStreamrNode().waitForJoinAndPublish(streamPartId, msg, timeout);
+    }
+    unsubscribe(streamPartId) {
+        if (this.stopped) {
+            return;
+        }
+        this.stack.getStreamrNode().unsubscribeFromStream(streamPartId);
+    }
+    getNeighborsForStreamPart(streamPartId) {
+        return this.hasStreamPart(streamPartId)
+            ? this.stack.getStreamrNode().getStream(streamPartId).layer2.getTargetNeighborStringIds()
+            : [];
+    }
+    hasStreamPart(streamPartId) {
+        return this.stack.getStreamrNode().hasStream(streamPartId);
+    }
+    hasProxyConnection(streamPartId, contactNodeId, direction) {
+        return this.stack.getStreamrNode().hasProxyConnection(streamPartId, contactNodeId, direction);
+    }
+    // eslint-disable-next-line class-methods-use-this
+    getRtt(_nodeId) {
+        throw new Error('Not implemented');
+    }
+    async stop() {
+        this.stopped = true;
+        await this.stack.stop();
+    }
+    getPeerDescriptor() {
+        return this.stack.getLayer0DhtNode().getPeerDescriptor();
+    }
+    getMetricsContext() {
+        return this.stack.getMetricsContext();
+    }
+    getNodeId() {
+        return this.stack.getStreamrNode().getNodeId();
+    }
+    getNodeStringId() {
+        return this.stack.getStreamrNode().getNodeStringId();
+    }
+    getStreamParts() {
+        return this.stack.getStreamrNode().getStreamParts();
+    }
+    getNeighbors() {
+        return this.stack.getStreamrNode().getNeighbors();
+    }
+    // eslint-disable-next-line class-methods-use-this
+    getDiagnosticInfo() {
+        return {};
+    }
+}
+exports.NetworkNode = NetworkNode;
+//# sourceMappingURL=NetworkNode.js.map

package/dist/src/NetworkNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkNode.js","sourceRoot":"","sources":["../../src/NetworkNode.ts"],"names":[],"mappings":"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"}

package/dist/src/NetworkStack.d.ts

@@ -0,0 +1,32 @@
+import { DhtNode, DhtNodeOptions } from '@streamr/dht';
+import { StreamrNode, StreamrNodeConfig } from './logic/StreamrNode';
+import { MetricsContext } from '@streamr/utils';
+import { EventEmitter } from 'eventemitter3';
+import { StreamPartID } from '@streamr/protocol';
+export interface NetworkOptions {
+    layer0: DhtNodeOptions;
+    networkNode: StreamrNodeConfig;
+    metricsContext?: MetricsContext;
+}
+export interface NetworkStackEvents {
+    stopped: () => void;
+}
+export declare class NetworkStack extends EventEmitter<NetworkStackEvents> {
+    private connectionManager?;
+    private layer0DhtNode?;
+    private streamrNode?;
+    private readonly metricsContext;
+    private readonly options;
+    private readonly firstConnectionTimeout;
+    private dhtJoinRequired;
+    constructor(options: NetworkOptions);
+    start(doJoin?: boolean): Promise<void>;
+    private joinDht;
+    private waitForFirstConnection;
+    joinLayer0IfRequired(streamPartId: StreamPartID): Promise<void>;
+    private isJoinRequired;
+    getStreamrNode(): StreamrNode;
+    getLayer0DhtNode(): DhtNode;
+    getMetricsContext(): MetricsContext;
+    stop(): Promise<void>;
+}