convex.server — world.convex/net.clj 0.0.0-alpha2

Creating a peer which can either:

• Run alone for dev and test
• Run locally, synced with other local peers
• Run locally but synced with the test network on convex.world

Examples are provided in README.

controller clj

(controller server)

Returns the controller associated with server.

It was either explicitly specified in create or retrieved from the state.

create clj

(create keypair)

(create keypair option+)

Returns a new server that can be started using start when required.

A key pair is mandatory. See convex.sign namespace from :project/crypto.

An map of options may be provided:

Key	Value	Default
:convex.server/bind	Bind address (string)	"localhost"
:convex.server/state	See below	[:genesis]
:convex.server/controller	Controller account address	Retrieved from state
:convex.server/db	Database (see :project/db)	Default temp database created automatically
:convex.server/n-peer	Maximum number of other peers this one should broadcast to	20
:convex.server/persist-at-stop? | True if peer data should be persisted in DB when stopped |false`
:convex.server/port	Port	18888
`:convex.server/url	URL of this peer (string) that will be registered on chain	Not set

The URL, if given, is stored on-chain so that other peers can use it to broadcast beliefs and state updates. It is typically different from :convex.server/bind and :convex.server/port. For instance, convex.world has registered URL convex.world:18888 in on-chain peer data, it is publicly accessible to all peers which wants to broadcast data to it.

A peer needs initial state optionally specified in :convex.server/state which is a vector. Either:

Item 0	Item 1	Does
:genesis	/	Creates new genesis state from scratch
:db	/	Restores state from :convex.server/db
:sync	Option map	Performs peer syncing (see below)
:use	State cell	Advanced. Uses given convex.core.State cell

Peer syncing retrieves state from the given peer and connection will automatically be formed to that other peer at start, forming a network. The option map may specify:

Key	Value	Default
:convex.server/host	Address of the remote peer	"localhost"
:convex.server/port	Port of the remote peer	18888

db clj

(db server)

Returns the database used by the server.

host clj

(host server)

Returns bind address used by the server as a string.

peer clj

(peer server)

Advanced feature. Returns the peer object wrapped by the server. More precisely, the server provided network connectivity over this object.

persist clj

(persist server)

Persists peer data at the root of the server's database.

Persisted data can be recovered when creating a server with the same database (see :convex.server/state option in create).

Returns server.

port clj

(port server)

Returns the port used by the server.

start clj

(start server)

Starts server created in create.

If peer syncing was configured in create, also connects to remote peer.

Returns server.

stop clj

(stop server)

Stops server previously started with start.