Wish

Wish – A peer-to-peer identity based application development stack. Built to enable applications to communicate securely without unncessary third-parties.

While Wish is inspired by social networking it is also applicable in areas not commonly associated with social media, such as providing an identity layer for physical devices, providing trust management tools for companies, or publishing scientific research. Wish provides a generic social network stack for building any application utilizing these features.

Wish key features and APIs

• Create/manage identities
• Manage trust-relationships between identities
• Sign/verify signatures by identities
• Create peers (register protocol handler)
• Discover available peers
• Send and receive data to/from other peers
• Manage and provide access control
• Manage connectivity

This is a C-language implementation based on the Wish (wish-core) reference implementation by André Kaustell.

Build

mkdir build
cd build 
cmake ..
make

Install

This binary can be executed wherever, make sure the executable permissions are set chmod u+x. It will also require write access to the same folder, it will store config files and a keystore.

Usage

The wish core takes the following arguments
    -b don't broadcast own uid over local discovery
    -l don't listen to local discovery broadcasts
    -i Starts the core in claimable mode, which means the first remote wish identity who 
       accesses this core can claim the admin role
    -h for displaying help

    -s start accepting incoming connections ("server" mode)
    -p <port> listen for incoming connections at this TCP port
    -r connect to a relay server, for accepting incoming connections via the relay.

    -a <port> start "App TCP" interface server at port

    Direct client connection:
    -c <ip_addr> open a direct client connection to this IP addr
    -C <port> use specified TCP destination port when connecting as direct client
    -R <alias> The remote party's alias name (in local contact DB)

Applications

wish-cli: A node.js command line interface for accessing and managing a Wish Core. See: https://www.npmjs.com/package/wish-cli

wish-core-api: A native node.js addon to quickly build node.js applications using Wish. See https://www.npmjs.com/package/wish-core-api.

mist examples: https://github.com/ControlThings/mist-examples-nodejs

Getting started

1. Once you've launched the wish daemon for the first time, you'll need to create an identity. This can be made using the wish-cli command line tool.

wish-cli
identity.create('My Identity')

2. Run an app or service which uses the daemon, for instance one of the mist-examples from the previous section

Acknowledgements

Part of this work has been carried out in the scope of the project Industrial Internet Standardized Interoperability (II-SI), co-funded by Tekes (Finnish Funding Agency for Innovation) contract number 5409/31/2014.

Part of this work has been carried out in the scope of the project Mist App/Wi-Fi, co-funded by Tekes (Finnish Funding Agency for Innovation) contract number 4524/31/2015.

Part of this work has been carried out in the scope of the project bIoTope which is co-funded by the European Commission under Horizon 2020 program, contract number H2020-ICT-2015/688203.