Rafiki is a collection of three services that are run together; each one can be scaled horizontally. These services are
backend: The main service, handling business logic and external communication.
auth: The service used for Grant Authorization and authentication. Rafiki provides this as a reference implementation, with the understanding that Rafiki operators can use and deploy their own service for authorization and authentication.
frontend: An internal admin interface for Rafiki operators to manage their Rafiki instance.
These services rely on four databases:
- A postgres database used by the
- A separate postgres database used by
- TigerBeetle used by
backendfor accounting balances at the ILP layer.
- Redis used by
backendas a cache to share STREAM connection details across processes.
backend service has four responsibilities:
- Expose REST Open Payments API endpoints for public clients to perform account management tasks.
- Expose an internal GraphQL Admin API for service operators to manage accounts and application settings like peering relationships.
- Expose an ILP connector to send and receive STREAM packets with peers.
- Business logic to manage accounts and track balances.
backend’s ILP functionality includes:
- Accepting ILP packets over an HTTP interface and authenticating them against ILP account credentials
- Routing ILP packets to the correct destination account
- Converting currencies
- Sending out ILP packets over HTTP for destinations that are not local
- Fulfilling packets with an internal STREAM server
auth service performs authorization and authentication of incoming requests. For requests from entities that have accounts within the local instance of Rafiki, the
auth service uses data stored in the auth postgres database. For requests from clients registered with other instances of Rafiki, the auth service resolves the client’s public key from its source and uses it to authenticate and authorize the request. Additionally, it also exposes an GraphQL Admin API to manage auth related resources (such as grants).
frontend project is a web app through which Rafiki administrators can manage their Rafiki instance though a UI.
frontend communicates with the
backend Admin API to manage payment pointers, peering relationships, and assets, among other settings.
token-introspection package is a client library for making GNAP token introspection requests to the auth server.