ILP virtual ledger plugin for directly transacting connectors
The current version of
ilp-plugin-virtual is designed to be used in ILP
Kit. An HTTP server is required in
order to pass RPC calls to the plugin, and to perform authorization on RPC calls.
npm install --save ilp-plugin-virtual
You can test out the ledger plugin by running
npm test on your machine. To
include debug information during the test, run
DEBUG=ilp* npm test.
When instantiating the plugin, make sure to pass in an object with the right fields:
"maxBalance": "highest balance allowed""prefix": "prefix for ilp address""secret": "your secret. your peer must know the corresponding public key.""peerPublicKey": "base64url encoded public key of your peer""rpcUri": "" // this is used to communicate with your peer (see below)"_store": /* this object will be created by the connector */"info": /* the object to be returned by getInfo */
Receiving RPC calls
In order to use plugin virtual, you need an HTTP endpoint that passes calls to the plugin.
The url must take one query parameter (
method), as well as a JSON body. The method parameter
and parsed body must be passed to the plugin like so:
Generate a trustline prefix
If you want to generate a trustline prefix from a secret key, peer's public key, and currency, you can access the method through the token class:
const Token =const prefix = TokenprefixsecretKey: 'o9Lt0oZFek1ArM_A0HUAq8M8edRuoSeLjX8i10sVUiY'peerPublicKey: 'KRixgcBCBdyQln7IBYiopjuNO78QSFtXgOwP1sbsCSk'currency: 'USD'