grenache-nodejs-link

grenache-nodejs-link

In Grenache, grenache-nodejs-link communicates with the DHT.

Requirements

Install Grenache Grape: https://github.com/bitfinexcom/grenache-grape:

npm i -g grenache-grape

// Start 2 Grapes
grape --dp 20001 --aph 30001 --bn '127.0.0.1:20002'
grape --dp 20002 --aph 40001 --bn '127.0.0.1:20001'

Class: Link

new Link(options)

• options <Object> Options for the link
  • grape <String> Address of the Grenache Grape instance. Communication is done via WebSocket or HTTP.
  • requestTimeout <Number> Default timeout for requests to Grape,
  • pingTimeout <Number> Ping connection timeout to Grape (triggers reconnect attempt),
  • lruMaxSizeLookup <Number> Maximum size of the cache, checked by applying the length function to all values in the cache
  • lruMaxAgeLookup <Number> Maximum cache age in ms.

link.start()

Sets up a connection to the DHT. Emits a connect event on successful connection.

link.stop()

Stops the connection to the DHT. Emits a disconnect event on successful disconnection.

link.announce(name)

• name <String> Name of the service, used to find the service from other peers

Used to announce a service, e.g. a RPC Server.

link.startAnnouncing(name, port, [otions])

Keep announcing a service every ~2min (default) or specify interval in opts.interval

link.stopAnnouncing(name, port)

Stop announcing a service

link.put(data, callback)

• data
  • v: <String> value to store
• callback <function>

Puts a value into the DHT. Example.

link.putMutable(data, opts, callback)

• data
  • v: <String> value to store
  • s: <Number> sequence number
• opts
  • keys: <Object> contains ed25519-supercop private and public key
    • publicKey: <Buffer> public key
    • secretKey: <Buffer> private key
• callback <function>

Provides sugar for storing mutable, signed data in the DHT.

Example raw put
Example with putMutable

link.get(hash, callback)

• hash <String> Hash used for lookup
• callback <function>

Retrieves a stored value from the DHT via a hash <String>. Callback returns err <Object> and data <Object>. Example.