relaycorp / awala-endpoint-internet

Middleware for server-side apps to communicate over Awala without implementing any of the networking or cryptography from the protocol suite.
https://docs.relaycorp.tech/awala-endpoint-internet/
GNU Affero General Public License v3.0
0 stars 0 forks source link
awala awala-endpoint

Awala Internet Endpoint

This is a Message-Oriented Middleware (MOM) for server-side apps to communicate over Awala without implementing any of the networking or cryptography from the protocol suite.

In concrete terms, as an Awala Internet Endpoint, this middleware implements the Awala protocol PoHTTP as a server and a client, thus acting as a bridge between the app and its users' Awala gateways.

Installation and usage

Documentation for operators and app developers is available on docs.relaycorp.tech.

Development

This app requires the following system dependencies:

To start the app, simply get Skaffold to deploy the relevant Kubernetes resources by running npm start.

Automated testing

The unit test suite can be run with the standard npm test.

If you'd like to run some tests against the real instance of the app managed by Skaffold, the simplest way to do that is to add/modify functional tests and then run npm run test:integration (alternatively, you can use your IDE to only run the test you're interested in).

Manual testing

If for whatever reason you want to manually test the app, you first need to get the local URLs to the services by running:

kn service list

Contributions

We love contributions! If you haven't contributed to a Relaycorp project before, please take a minute to read our guidelines first.