Bridge SDK

Components

Bridge SDK provides two main components:

• Server
• Processor

Server

Server implements two-phase protocol for the ledger. Incoming requests are persisted in the bridge database as entries, intents and commands. When processing is requred, job is created which will be assigned to an available processor for processing.

Server provides proxy to the ledger in order for 3rd party system to be able to communicate with the ledger. Proxy will establish secure communication when calling the ledger and sign payload with the bridge key when needed.

Effects can also be registered in the server. Effects are used to extend the ledger core functionalities by observing and reacting on events raised when a change occurs with ledger data.

Exposed two-phase commit endpoints:

| Method | Path | Description | | ------ | ----------------------------- | ----------------------------- | | POST | /v2/credits | prepares credit transaction | | POST | /v2/credits/<handle>/abort | aborts credit transaction | | POST | /v2/credits/<handle>/commit | commits credit transaction | | POST | /v2/debits | prepares debit transaction | | POST | /v2/debits/<handle>/abort | aborts debit transaction | | POST | /v2/debits/<handle>/commit | commits debit transaction | | PUT | /v2/intents/<handle> | updates intent record |

Exposed job endpoints:

| Method | Path | Description | | ------ | ---------------------------- | ---------------------------------------- | | POST | /v2/jobs/<handle>/continue | schedules suspended job for processing |

Exposed proxy endpoints:

| Method | Path | Description | | ------ | ------------------------------------- | ----------------------- | | POST | /v2/proxy/intents | create an intent | | GET |  /v2/proxy/intents |  fetch intents | | GET | /v2/proxy/intents/<handle> | fetch an intent | | POST | /v2/proxy/signers | create a signer | | PUT | /v2/proxy/signers/<handle> | update a signer | | GET |  /v2/proxy/signers | fetch signers | | GET | /v2/proxy/signers/<handle> | fetch a signer | | POST | /v2/proxy/wallets | create a wallet | | PUT | /v2/proxy/wallets/<handle> | update a wallet | | GET |  /v2/proxy/wallets | fetch wallets | | GET | /v2/proxy/wallets/<handle> | fetch a wallet | | GET | /v2/proxy/wallets/<handle>/balances | fetch wallet balances |

Exposed effects endpoints: | Method | Path | Description | | ------ | ------------------------------------- | ------------------------------- | | POST | /v2/effects/<handle> | executes a registered effect |

Processor

Processor listens for pending jobs in the system and executes them. Each processor must have unique handle in the system which is used for job balancing across processors. Processing of a job can be suspended for predefined time (e.g. 5 minutes, waiting for banking core) or indefinitely which requires manual job continuation.

Running unit tests

Run nx test bridge-sdk to execute the unit tests via Jest.

Running lint

Run nx lint bridge-sdk to execute the lint via ESLint.