@stellar-broker/client 0.1.0

package/README.md

@@ -0,0 +1,92 @@
+# @stellar-broker/client
+
+## Installation
+
+```
+npm i @stellar-broker/client
+```
+
+## Usage
+
+### Example - Connect and trade in DirectFlow mode
+
+```js
+import StellarBrokerClient from '@stellar-broker/client'
+
+//create client instance
+const client = new StellarBrokerClient({partnerKey: '<your_partner_key>'})
+
+//subscribe to the quote notifications
+client.on('quote', e => {
+    console.log('Received quote from the server', e.quote)
+    /*
+    {
+      "status": "success",
+      "sellingAsset": "USDC-GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
+      "buyingAsset": "XLM",
+      "slippageTolerance": 0.5,
+      "direction": "strict_send",
+      "directTrade": {
+          "selling": "10",
+          "buying": "100.23505",
+          "path": []
+      },
+      "sellingAmount": "10",
+      "estimatedBuyingAmount": "100.688121",
+      "ts": "2024-08-13T23:13:21.275Z"
+    }
+    */
+})
+
+client.on('finished', e => {
+    console.log('Trade finished', e.result)
+    /*
+    {
+      "status": "success",
+      "sold": "10",
+      "bought": "100.6704597"
+    }    
+    */
+})
+
+client.on('progress', e => {
+    console.log('Progress', e.status)
+    /*
+    {
+      "sold": "10",
+      "bought": "100.6704597"
+    }
+    */
+})
+
+client.on('error', e => {
+    console.warn('StellarBroker error', e.error)
+})
+
+//connect
+client.connect() //only once
+    .then(() => console.log('StellarBroker connected'))
+    .catch(e => console.error(e))
+
+//request a price quote
+client.quote({
+    destination: '<account_pubkey>', //trader account pubkey
+    sellingAsset: 'xlm',
+    buyingAsset: 'USD-GDK2GNB4Q6FKNW2GNJIQFARI4RMSHV5DN5G4BBXX2F24RT5I4QT7TWZ7',
+    sellingAmount: '1000', //1000.0000000
+    slippageTolerance: 0.02 //2%
+})
+
+//once the quote received from the server, we can confirm the quote
+client.confirmQuote(async (tx) => { //async signing callback - implement custom logic here
+    const kp = Keypair.fromSecret('<account_secret>')
+    tx.sign(kp)
+    return tx
+})
+
+//trade can be interrupted from the client by calling
+client.stop()
+
+//cleanup resources and close connection once the trading has been finished
+client.close()
+```

package/lib/stellarbroker.js

@@ -0,0 +1,2 @@
+!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e(require("@stellar/stellar-base")):"function"==typeof define&&define.amd?define(["@stellar/stellar-base"],e):"object"==typeof exports?exports.stellarbroker=e(require("@stellar/stellar-base")):t.stellarbroker=e(t["@stellar/stellar-base"])}(this,(t=>(()=>{"use strict";var e={755:e=>{e.exports=t}},s={};function i(t){var o=s[t];if(void 0!==o)return o.exports;var r=s[t]={exports:{}};return e[t](r,r.exports,i),r.exports}i.d=(t,e)=>{for(var s in e)i.o(e,s)&&!i.o(t,s)&&Object.defineProperty(t,s,{enumerable:!0,get:e[s]})},i.o=(t,e)=>Object.prototype.hasOwnProperty.call(t,e);var o={};i.d(o,{default:()=>f});var r=i(755);class n extends Error{constructor(t,e){super(e),this.code=t}code=0}const a={invalidInitParam:t=>new n(1,`Invalid parameter value: "${t}"`),invalidAuthorizationParam:()=>new n(2,"Invalid authorization secret key or callback provided"),quoteNotSet:()=>new n(11,"Price quote not available"),quoteExpired:()=>new n(12,"Price quote expired"),quoteError:t=>new n(13,"Price quotation error: "+t),invalidQuoteParam:(t,e)=>new n(14,`Invalid quote request parameter: "${t}". ${e}`),tradeInProgress:()=>new n(20,"Cannot change quote while trade is in progress"),invalidSwapTx:()=>new n(21,"Invalid swap transaction received"),failedToSignTx:()=>new n(22,"Failed to sign received transaction"),unsupportedEventType:t=>new n(31,"Unknown event type: "+t),serverError:t=>new n(101,"Server error: "+t)};function u(t,e,s){const i=new CustomEvent(t,{detail:e});return i[s||t]=e,i}function l(t,e){if("string"==typeof t){if("XLM"===t||"xlm"===t||"native"===t)return"XLM";if(t.includes(":")){const[s,i]=t.split(":");return c(s),h(i,e),s+"-"+i}if(t.includes("-")){const[s,i]=t.split("-");return c(s),h(i,e),t}}throw a.invalidQuoteParam(e,"Invalid asset")}function c(t,e){if(!/^[a-zA-Z0-9]{1,12}$/.test(t))throw a.invalidQuoteParam(e,"Invalid asset code: "+(void 0===t?"missing":t));return t}function h(t,e,s=!1){if(void 0!==t||!s){if(!r.StrKey.isValidEd25519PublicKey(t))throw a.invalidQuoteParam(e,"Invalid account address: "+(void 0===t?"missing":t));return t}}function d(t,e){if(void 0===t)return;const s=parseFloat(t);if(isNaN(s)||s<=0)throw a.invalidQuoteParam(e,"Invalid asset amount: "+t);return t}function p(t,e){const s=parseFloat(t);if(isNaN(s))throw a.invalidQuoteParam(e,"Invalid slippage tolerance, number expected");if(s<0)throw a.invalidQuoteParam(e,"Slippage tolerance is too small, expected value >= 0");if(s>.5)throw a.invalidQuoteParam(e,"Slippage tolerance is too large, expected value < 0.5 (50%)");return s}const g=["quote","finished","progress","error"];function v(t){return!t instanceof Promise?t?Promise.resolve(t):Promise.reject():t}const f=class{constructor(t){if(!t.network)throw a.invalidInitParam("network");this.partnerKey=t.partnerKey,this.emitter=new EventTarget,this.network=r.Networks[t.network.toUpperCase()]||t.network,this.flow=t.flow||"direct"}status="disconnected";socket;emitter;origin="https://api.stellar.broker";network="";quoteRequest;lastQuote;tradeQuote;partnerKey;authorization;get source(){return this.quoteRequest?.destination}connect(){return this.socket?.readyState===WebSocket.OPEN?Promise.resolve(this):(this.socket=new WebSocket(this.origin+"/ws?partner="+encodeURIComponent(this.partnerKey)),this.socket.onmessage=this.processMessage.bind(this),this.socket.onclose=()=>{console.log("Connection closed"),this.status="disconnected"},this.socket.onerror=t=>console.error(t),new Promise(((t,e)=>{const s=setTimeout((()=>e(this)),2e3);this.onSocketOpen=()=>{this.status="ready",this.heartbeat(),this.onSocketOpen=void 0,clearTimeout(s),t(this)}})))}processMessage(t){const e=JSON.parse(t.data);switch(e.type){case"connected":this.onSocketOpen&&this.onSocketOpen();break;case"quote":this.lastQuote=e.quote,this.lastQuote.ts=new Date,this.emitter.dispatchEvent(u("quote",this.lastQuote));break;case"tx":if("trade"!==this.status)return void console.log("Received tx in non-trading state",this.status,e);this.processTxRequest(e);break;case"stop":this.emitter.dispatchEvent(u("finished",{status:e.status,sold:e.sold,bought:e.bought},"result")),this.status="ready";break;case"progress":this.emitter.dispatchEvent(u("progress",{sold:e.sold,bought:e.bought},"status"));break;case"ping":this.heartbeat(),this.send({type:"pong"});break;case"error":this.stop(),this.emitter.dispatchEvent(u("error","Server error: "+e.error));break;default:console.log("Unknown message type: "+e.type)}}quote(t){if("trade"===this.status)throw a.tradeInProgress();this.quoteRequest=function(t){const{destination:e,sellingAsset:s,selling_asset:i,buyingAsset:o,buying_asset:r,sellingAmount:n,selling_amount:u,buyingAmount:c,buying_amount:g,slippageTolerance:v,slippage_tolerance:f,...m}=t,w={sellingAsset:l(s||i,"sellingAsset"),buyingAsset:l(o||r,"buyingAsset"),sellingAmount:d(n||u,"sellingAmount"),buyingAmount:d(c||g,"buyingAmount"),slippageTolerance:p(v||f||.02,"slippageTolerance"),flow:"direct"};if(e&&(w.destination=h(e,"destination",!0)),w.buyingAsset===w.sellingAsset)throw a.invalidQuoteParam("buyingAsset","Buying asset can't be the same as selling asset");if(void 0===w.buyingAmount&&void 0===w.sellingAmount)throw a.invalidQuoteParam("sellingAmount",'Either "buyingAmount" or "sellingAmount" parameter is required');if(void 0!==w.buyingAmount&&void 0!==w.sellingAmount)throw a.invalidQuoteParam("sellingAmount",'Parameters "buyingAmount" and "sellingAmount" are mutually exclusive');return Object.assign(w,m),w}(t),this.status="quote",this.connect().then((()=>{this.send({type:"quote",...this.quoteRequest})}))}stop(){"trade"!==this.status&&"quote"!==this.status||(this.send({type:"stop"}),this.tradeQuote=void 0,this.status="ready")}confirmQuote(t){if("quote"!==this.status)throw a.tradeInProgress();if(!this.lastQuote)throw a.quoteNotSet();if(new Date-this.lastQuote.ts>7e3)throw a.quoteExpired();if("success"!==this.lastQuote.status)throw a.quoteError(this.lastQuote.error||"quote not available");if("string"==typeof t)try{this.authorization=r.Keypair.fromSecret(t)}catch(t){throw a.invalidAuthorizationParam()}else"function"==typeof t&&(this.authorization=t);this.tradeQuote=this.lastQuote,this.send({type:"trade"}),this.status="trade"}processTxRequest(t){let e;try{e=r.TransactionBuilder.fromXDR(t.xdr,this.network)}catch(t){throw a.invalidSwapTx()}if(!this.validateTransaction(e))throw a.invalidSwapTx();this.authorizeTx(e,t.networkFee).then((e=>{if(!e||e.signatures.length<1)return console.error(`Transaction ${t.hash} not signed`);this.send({type:"tx",hash:t.hash,xdr:e.toXDR()})})).catch((t=>{throw console.error(t),a.failedToSignTx()}))}async authorizeTx(t,e){this.authorization instanceof r.Keypair?t.sign(this.authorization):t=await v(this.authorization(t));let s=r.TransactionBuilder.buildFeeBumpTransaction(this.source,e,t,this.network);return this.authorization instanceof r.Keypair?s.sign(this.authorization):s=await v(this.authorization(s)),s}validateTransaction(t){for(let e of t.operations){if("pathPaymentStrictSend"!==e.type&&"pathPaymentStrictReceive"!==e.type)return!1;if(e.destination!==this.source){if("pathPaymentStrictSend"!==e.type)return!1;if(e.source&&e.source!==this.source)return!1}else if(e.source&&e.source!==e.destination||e.destination!==this.source)return!1}return!0}send(t){this.socket.send(JSON.stringify(t))}heartbeat(){clearTimeout(this.pingHandler),this.pingHandler=setTimeout((()=>{console.warn("Lost connection with the server"),this.socket.close()}),11e3)}on(t,e){if(!g.includes(t))throw a.unsupportedEventType(t);this.emitter.addEventListener(t,e)}once(t,e){if(!g.includes(t))throw a.unsupportedEventType(t);this.emitter.addEventListener(t,e,{once:!0})}off(t,e){if(!g.includes(t))throw a.unsupportedEventType(t);this.emitter.removeEventListener(t,e)}close(){try{this.socket.close()}catch(t){}}};return o.default})()));
+//# sourceMappingURL=stellarbroker.js.map

package/lib/stellarbroker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellarbroker.js","mappings":"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","sources":["webpack://stellarbroker/webpack/universalModuleDefinition","webpack://stellarbroker/external umd \"@stellar/stellar-base\"","webpack://stellarbroker/webpack/bootstrap","webpack://stellarbroker/webpack/runtime/define property getters","webpack://stellarbroker/webpack/runtime/hasOwnProperty shorthand","webpack://stellarbroker/./src/errors.js","webpack://stellarbroker/./src/events.js","webpack://stellarbroker/./src/quote-request.js","webpack://stellarbroker/./src/client.js","webpack://stellarbroker/./src/index.js"],"sourcesContent":["(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory(require(\"@stellar/stellar-base\"));\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([\"@stellar/stellar-base\"], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"stellarbroker\"] = factory(require(\"@stellar/stellar-base\"));\n\telse\n\t\troot[\"stellarbroker\"] = factory(root[\"@stellar/stellar-base\"]);\n})(this, (__WEBPACK_EXTERNAL_MODULE__755__) => {\nreturn ","module.exports = __WEBPACK_EXTERNAL_MODULE__755__;","// The module cache\nvar __webpack_module_cache__ = {};\n\n// The require function\nfunction __webpack_require__(moduleId) {\n\t// Check if module is in cache\n\tvar cachedModule = __webpack_module_cache__[moduleId];\n\tif (cachedModule !== undefined) {\n\t\treturn cachedModule.exports;\n\t}\n\t// Create a new module (and put it into the cache)\n\tvar module = __webpack_module_cache__[moduleId] = {\n\t\t// no module.id needed\n\t\t// no module.loaded needed\n\t\texports: {}\n\t};\n\n\t// Execute the module function\n\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n\n\t// Return the exports of the module\n\treturn module.exports;\n}\n\n","// define getter functions for harmony exports\n__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n\t\t}\n\t}\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","export class StellarBrokerError extends Error {\r\n    constructor(code, message) {\r\n        super(message)\r\n        this.code = code\r\n    }\r\n\r\n    /**\r\n     * Numeric error code\r\n     * @type {number}\r\n     * @readonly\r\n     */\r\n    code = 0\r\n}\r\n\r\nconst errors = {\r\n    invalidInitParam(param) {\r\n        return new StellarBrokerError(1, `Invalid parameter value: \"${param}\"`)\r\n    },\r\n    invalidAuthorizationParam() {\r\n        return new StellarBrokerError(2, 'Invalid authorization secret key or callback provided')\r\n    },\r\n    quoteNotSet() {\r\n        return new StellarBrokerError(11, 'Price quote not available')\r\n    },\r\n    quoteExpired() {\r\n        return new StellarBrokerError(12, 'Price quote expired')\r\n    },\r\n    quoteError(message) {\r\n        return new StellarBrokerError(13, 'Price quotation error: ' + message)\r\n    },\r\n    invalidQuoteParam(invalidParamName, details) {\r\n        return new StellarBrokerError(14, `Invalid quote request parameter: \"${invalidParamName}\". ${details}`)\r\n    },\r\n    tradeInProgress() {\r\n        return new StellarBrokerError(20, 'Cannot change quote while trade is in progress')\r\n    },\r\n    invalidSwapTx() {\r\n        return new StellarBrokerError(21, 'Invalid swap transaction received')\r\n    },\r\n    failedToSignTx() {\r\n        return new StellarBrokerError(22, 'Failed to sign received transaction')\r\n    },\r\n    unsupportedEventType(type) {\r\n        return new StellarBrokerError(31, 'Unknown event type: ' + type)\r\n    },\r\n    serverError(message) {\r\n        return new StellarBrokerError(101, 'Server error: ' + message)\r\n    }\r\n}\r\n\r\nexport default errors","/**\r\n * @param {string} type\r\n * @param {{}} data\r\n * @param {string} [key]\r\n * @return {CustomEvent}\r\n */\r\nexport function buildEvent(type, data, key) {\r\n    const evt = new CustomEvent(type, {detail: data})\r\n    evt[key || type] = data\r\n    return evt\r\n}","import {StrKey} from '@stellar/stellar-base'\r\nimport errors from './errors.js'\r\n\r\n/**\r\n * @typedef {object} SwapQuoteParams\r\n * @property {string} sellingAsset - Asset to sell\r\n * @property {string} buyingAsset - Asset to buy\r\n * @property {string} [sellingAmount] - Amount of selling asset\r\n * @property {string} [buyingAmount] - Amount of buying asset\r\n * @property {number} [slippageTolerance] - Swap slippage tolerance (0.02 by default - 2%)\r\n * @property {string} [destination] - Trader account address\r\n */\r\n\r\n/**\r\n * @param {SwapQuoteParams} params\r\n * @return {SwapQuoteParams}\r\n */\r\nexport function validateQuoteRequest(params) {\r\n    const {\r\n        destination, sellingAsset, selling_asset, buyingAsset, buying_asset, sellingAmount, selling_amount,\r\n        buyingAmount, buying_amount, slippageTolerance, slippage_tolerance, ...other\r\n    } = params\r\n    const res = {\r\n        sellingAsset: parseAsset(sellingAsset || selling_asset, 'sellingAsset'),\r\n        buyingAsset: parseAsset(buyingAsset || buying_asset, 'buyingAsset'),\r\n        sellingAmount: parseAmount(sellingAmount || selling_amount, 'sellingAmount'),\r\n        buyingAmount: parseAmount(buyingAmount || buying_amount, 'buyingAmount'),\r\n        slippageTolerance: parseSlippageTolerance(slippageTolerance || slippage_tolerance || 0.02, 'slippageTolerance'),\r\n        flow: 'direct'\r\n    }\r\n    if (destination) {\r\n        res.destination = validateAccount(destination, 'destination', true)\r\n    }\r\n    if (res.buyingAsset === res.sellingAsset)\r\n        throw errors.invalidQuoteParam('buyingAsset', 'Buying asset can\\'t be the same as selling asset')\r\n    if (res.buyingAmount === undefined && res.sellingAmount === undefined)\r\n        throw errors.invalidQuoteParam('sellingAmount', 'Either \"buyingAmount\" or \"sellingAmount\" parameter is required')\r\n    if (res.buyingAmount !== undefined && res.sellingAmount !== undefined)\r\n        throw errors.invalidQuoteParam('sellingAmount', 'Parameters \"buyingAmount\" and \"sellingAmount\" are mutually exclusive')\r\n    Object.assign(res, other) //add remaining optional params\r\n    return res\r\n}\r\n\r\nfunction parseAsset(asset, parameter) {\r\n    if (typeof asset === 'string') {\r\n        if (asset === 'XLM' || asset === 'xlm' || asset === 'native')\r\n            return 'XLM'\r\n        if (asset.includes(':')) {\r\n            const [code, issuer] = asset.split(':')\r\n            validateCode(code)\r\n            validateAccount(issuer, parameter)\r\n            return code + '-' + issuer\r\n        }\r\n        if (asset.includes('-')) {\r\n            const [code, issuer] = asset.split('-')\r\n            validateCode(code)\r\n            validateAccount(issuer, parameter)\r\n            return asset\r\n        }\r\n    }\r\n    throw errors.invalidQuoteParam(parameter, 'Invalid asset')\r\n}\r\n\r\nfunction validateCode(code, parameter) {\r\n    if (!/^[a-zA-Z0-9]{1,12}$/.test(code))\r\n        throw errors.invalidQuoteParam(parameter, 'Invalid asset code: ' + (code === undefined ? 'missing' : code))\r\n    return code\r\n}\r\n\r\nfunction validateAccount(account, param, optional = false) {\r\n    if (account === undefined && optional)\r\n        return undefined\r\n    if (!StrKey.isValidEd25519PublicKey(account))\r\n        throw errors.invalidQuoteParam(param, 'Invalid account address: ' + (account === undefined ? 'missing' : account))\r\n    return account\r\n}\r\n\r\nfunction parseAmount(amount, parameter) {\r\n    if (amount === undefined)\r\n        return undefined\r\n    const parsed = parseFloat(amount)\r\n    if (isNaN(parsed) || parsed <= 0)\r\n        throw errors.invalidQuoteParam(parameter, 'Invalid asset amount: ' + amount)\r\n    return amount\r\n}\r\n\r\nfunction parseSlippageTolerance(src, parameter) {\r\n    const tolerance = parseFloat(src)\r\n    if (isNaN(tolerance))\r\n        throw errors.invalidQuoteParam(parameter, 'Invalid slippage tolerance, number expected')\r\n    if (tolerance < 0)\r\n        throw errors.invalidQuoteParam(parameter, 'Slippage tolerance is too small, expected value >= 0')\r\n    if (tolerance > 0.5)\r\n        throw errors.invalidQuoteParam(parameter, 'Slippage tolerance is too large, expected value < 0.5 (50%)')\r\n    return tolerance\r\n}","import {Networks, TransactionBuilder, Keypair, FeeBumpTransaction} from '@stellar/stellar-base'\r\nimport errors from './errors.js'\r\nimport {buildEvent} from './events.js'\r\nimport {validateQuoteRequest} from './quote-request.js'\r\n\r\nexport default class StellarBrokerClient {\r\n    /**\r\n     * @param {ClientInitializationParams} params\r\n     */\r\n    constructor(params) {\r\n        if (!params.network)\r\n            throw errors.invalidInitParam('network')\r\n        this.partnerKey = params.partnerKey\r\n        this.emitter = new EventTarget()\r\n        this.network = Networks[params.network.toUpperCase()] || params.network\r\n        this.flow = params.flow || 'direct'\r\n    }\r\n\r\n    /**\r\n     * @type {ClientStatus}\r\n     * @readonly\r\n     */\r\n    status = 'disconnected'\r\n    /**\r\n     * @type {WebSocket}\r\n     * @private\r\n     */\r\n    socket\r\n    /**\r\n     * @type {EventTarget}\r\n     * @private\r\n     */\r\n    emitter\r\n    /**\r\n     * @type {string}\r\n     * @private\r\n     */\r\n    origin = 'https://api.stellar.broker'\r\n    /**\r\n     * Stellar network passphrase\r\n     * @type {string}\r\n     * @readonly\r\n     */\r\n    network = ''\r\n    /**\r\n     * Last quote request submitted by the client\r\n     * @type {SwapQuoteParams}\r\n     * @private\r\n     */\r\n    quoteRequest\r\n    /**\r\n     * Last quote received from the sever\r\n     * @type {SwapQuoteResult}\r\n     * @readonly\r\n     */\r\n    lastQuote\r\n    /**\r\n     * Current quote accepted for the trading\r\n     * @private\r\n     */\r\n    tradeQuote\r\n    /**\r\n     * API key of the partner\r\n     * @type {string}\r\n     * @private\r\n     */\r\n    partnerKey\r\n    /**\r\n     * Account secret key (for direct swap flow)\r\n     * @type {Keypair|ClientAuthorizationCallback}\r\n     * @private\r\n     */\r\n    authorization\r\n\r\n    /**\r\n     * Trader account public key\r\n     * @type {string}\r\n     */\r\n    get source() {\r\n        return this.quoteRequest?.destination\r\n    }\r\n\r\n    /**\r\n     * Connect to the StellarBroker server\r\n     * @return {Promise<StellarBrokerClient>}\r\n     */\r\n    connect() {\r\n        if (this.socket?.readyState === WebSocket.OPEN)\r\n            return Promise.resolve(this) //already opened\r\n\r\n        this.socket = new WebSocket(this.origin + '/ws?partner=' + encodeURIComponent(this.partnerKey))\r\n        this.socket.onmessage = this.processMessage.bind(this)\r\n        this.socket.onclose = () => {\r\n            console.log('Connection closed')\r\n            this.status = 'disconnected'\r\n        }\r\n\r\n        this.socket.onerror = e => console.error(e)\r\n\r\n        return new Promise((confirm, reject) => { //TODO: use 'once'\r\n            const expirationTimeout = setTimeout(() => reject(this), 2000) // 2s timeout\r\n            this.onSocketOpen = () => {\r\n                this.status = 'ready'\r\n                this.heartbeat()\r\n                this.onSocketOpen = undefined\r\n                clearTimeout(expirationTimeout)\r\n                confirm(this)\r\n            }\r\n        })\r\n    }\r\n\r\n    /**\r\n     * Process incoming message\r\n     * @param message\r\n     * @private\r\n     */\r\n    processMessage(message) {\r\n        const raw = JSON.parse(message.data)\r\n        switch (raw.type) {\r\n            case 'connected':\r\n                if (this.onSocketOpen) {\r\n                    this.onSocketOpen()\r\n                }\r\n                break\r\n            case 'quote':\r\n                this.lastQuote = raw.quote\r\n                this.lastQuote.ts = new Date()\r\n                //send event to the client app\r\n                this.emitter.dispatchEvent(buildEvent('quote', this.lastQuote))\r\n                break\r\n            case 'tx':\r\n                if (this.status !== 'trade') {\r\n                    console.log('Received tx in non-trading state', this.status, raw)\r\n                    return //skip unless trading is in progress\r\n                }\r\n                this.processTxRequest(raw)\r\n                break\r\n            case 'stop':\r\n                this.emitter.dispatchEvent(buildEvent('finished', {\r\n                    status: raw.status,\r\n                    sold: raw.sold,\r\n                    bought: raw.bought\r\n                }, 'result'))\r\n                this.status = 'ready'\r\n                break\r\n            case 'progress':\r\n                this.emitter.dispatchEvent(buildEvent('progress', {\r\n                    sold: raw.sold,\r\n                    bought: raw.bought\r\n                }, 'status'))\r\n                break\r\n            case 'ping':\r\n                this.heartbeat()\r\n                this.send({type: 'pong'})\r\n                break\r\n            case 'error':\r\n                this.stop()\r\n                this.emitter.dispatchEvent(buildEvent('error', 'Server error: ' + raw.error))\r\n                break\r\n            default:\r\n                console.log('Unknown message type: ' + raw.type)\r\n                break\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Request swap quote\r\n     * @param {SwapQuoteParams} params - Quote parameters\r\n     */\r\n    quote(params) {\r\n        if (this.status === 'trade')\r\n            throw errors.tradeInProgress()\r\n        this.quoteRequest = validateQuoteRequest(params)\r\n        this.status = 'quote'\r\n        this.connect()\r\n            .then(() => {\r\n                this.send({\r\n                    type: 'quote',\r\n                    ...this.quoteRequest\r\n                })\r\n            })\r\n    }\r\n\r\n    /**\r\n     * Stop quotation/trading\r\n     */\r\n    stop() {\r\n        if (this.status !== 'trade' && this.status !== 'quote')\r\n            return\r\n        this.send({\r\n            type: 'stop'\r\n        })\r\n        this.tradeQuote = undefined\r\n        this.status = 'ready'\r\n    }\r\n\r\n    /**\r\n     * Confirm current quote and start trading\r\n     * @param {string|ClientAuthorizationCallback} authorization - Authorization method, either account secret key or an authorization callback\r\n     */\r\n    confirmQuote(authorization) {\r\n        if (this.status !== 'quote')\r\n            throw errors.tradeInProgress()\r\n        if (!this.lastQuote)\r\n            throw errors.quoteNotSet()\r\n        if ((new Date() - this.lastQuote.ts) > 7000) //do not allow stale quotes quoted more than 7s ago\r\n            throw errors.quoteExpired()\r\n        if (this.lastQuote.status !== 'success')\r\n            throw errors.quoteError(this.lastQuote.error || 'quote not available')\r\n        if (typeof authorization === 'string') {\r\n            try {\r\n                this.authorization = Keypair.fromSecret(authorization)\r\n            } catch (e) {\r\n                throw errors.invalidAuthorizationParam()\r\n            }\r\n        } else if (typeof authorization === 'function') {\r\n            this.authorization = authorization\r\n        }\r\n        this.tradeQuote = this.lastQuote\r\n        this.send({\r\n            type: 'trade'\r\n        })\r\n        this.status = 'trade'\r\n    }\r\n\r\n    /**\r\n     * @param {{xdr: string, hash: string}} raw\r\n     * @private\r\n     */\r\n    processTxRequest(raw) {\r\n        //parse incoming transaction\r\n        let tx\r\n        try {\r\n            tx = TransactionBuilder.fromXDR(raw.xdr, this.network)\r\n        } catch (e) {\r\n            throw errors.invalidSwapTx()\r\n        }\r\n        //check that transaction is correct\r\n        if (!this.validateTransaction(tx))\r\n            throw errors.invalidSwapTx()\r\n        //sign transaction\r\n        this.authorizeTx(tx, raw.networkFee)\r\n            .then(tx => {\r\n                if (!tx || tx.signatures.length < 1)\r\n                    return console.error(`Transaction ${raw.hash} not signed`)\r\n                //respond with signed transaction\r\n                this.send({\r\n                    type: 'tx',\r\n                    hash: raw.hash,\r\n                    xdr: tx.toXDR()\r\n                })\r\n            })\r\n            .catch(e => {\r\n                console.error(e)\r\n                throw errors.failedToSignTx()\r\n            })\r\n    }\r\n\r\n    /**\r\n     * @param {Transaction} tx\r\n     * @param {string} networkFee\r\n     * @return {Promise<FeeBumpTransaction>}\r\n     * @private\r\n     */\r\n    async authorizeTx(tx, networkFee) {\r\n        //sign tx\r\n        if (this.authorization instanceof Keypair) {\r\n            tx.sign(this.authorization)\r\n        } else {\r\n            tx = await ensurePromise(this.authorization(tx))\r\n        }\r\n        //wrap with fee bump\r\n        let wrapped = TransactionBuilder.buildFeeBumpTransaction(this.source, networkFee, tx, this.network)\r\n        //sign fee bump wrapper tx\r\n        if (this.authorization instanceof Keypair) {\r\n            wrapped.sign(this.authorization)\r\n        } else {\r\n            wrapped = await ensurePromise(this.authorization(wrapped))\r\n        }\r\n        return wrapped\r\n    }\r\n\r\n    /**\r\n     * @param {Transaction} tx\r\n     * @throws {StellarBrokerError} Invalid swap transaction received\r\n     */\r\n    validateTransaction(tx) {\r\n        /*if (!(tx instanceof FeeBumpTransaction))\r\n            return false\r\n        const {innerTransaction} = tx\r\n        if (tx.feeSource !== this.source)\r\n            return false*/\r\n        for (let swap of tx.operations) {\r\n            if (swap.type !== 'pathPaymentStrictSend' && swap.type !== 'pathPaymentStrictReceive')\r\n                return false\r\n            const isFee = swap.destination !== this.source\r\n            if (isFee) {\r\n                if (swap.type !== 'pathPaymentStrictSend')\r\n                    return false\r\n                if ((swap.source && swap.source !== this.source))\r\n                    return false\r\n            } else {\r\n                if ((swap.source && swap.source !== swap.destination) || swap.destination !== this.source)\r\n                    return false\r\n            }\r\n        }\r\n        //TODO: check assets and amounts\r\n        return true\r\n    }\r\n\r\n    /**\r\n     * @param {{}} data\r\n     * @private\r\n     */\r\n    send(data) {\r\n        this.socket.send(JSON.stringify(data))\r\n    }\r\n\r\n    heartbeat() {\r\n        clearTimeout(this.pingHandler)\r\n        this.pingHandler = setTimeout(() => {\r\n            console.warn('Lost connection with the server')\r\n            this.socket.close()\r\n        }, 11_000) // 11 seconds heartbeat timeout\r\n    }\r\n\r\n    /**\r\n     * Add event listener\r\n     * @param {StellarBrokerClientEvent} type\r\n     * @param {function} callback\r\n     */\r\n    on(type, callback) {\r\n        if (!StellarBrokerEvents.includes(type))\r\n            throw errors.unsupportedEventType(type)\r\n        this.emitter.addEventListener(type, callback)\r\n    }\r\n\r\n    /**\r\n     * Add event listener that will be executed once\r\n     * @param {StellarBrokerClientEvent} type\r\n     * @param {function} callback\r\n     */\r\n    once(type, callback) {\r\n        if (!StellarBrokerEvents.includes(type))\r\n            throw errors.unsupportedEventType(type)\r\n        this.emitter.addEventListener(type, callback, {once: true})\r\n    }\r\n\r\n    /**\r\n     * Remove event listener\r\n     * @param {StellarBrokerClientEvent} type\r\n     * @param {function} callback\r\n     */\r\n    off(type, callback) {\r\n        if (!StellarBrokerEvents.includes(type))\r\n            throw errors.unsupportedEventType(type)\r\n        this.emitter.removeEventListener(type, callback)\r\n    }\r\n\r\n    /**\r\n     * Close underlying connection and finalize the client\r\n     */\r\n    close() {\r\n        try {\r\n            this.socket.close()\r\n        } catch (e) {\r\n        }\r\n    }\r\n}\r\n\r\nexport const StellarBrokerEvents = ['quote', 'finished', 'progress', 'error']\r\n\r\nfunction ensurePromise(callResult) {\r\n    if (!callResult instanceof Promise) {\r\n        if (callResult)\r\n            return Promise.resolve(callResult)\r\n        return Promise.reject()\r\n    }\r\n    return callResult\r\n}\r\n\r\n/**\r\n * @typedef {object} ClientInitializationParams\r\n * @property {string} [network] - Stellar network identifier or passphrase\r\n * @property {string} [partnerKey] - Partner key\r\n * @property {SwapFlowMode} [flow] - Swap flow mode\r\n */\r\n\r\n/**\r\n * @typedef {'disconnected'|'ready'|'quote'|'trade'} ClientStatus\r\n */\r\n\r\n/**\r\n * @typedef {'quote'|'finished'|'progress'|'error'} StellarBrokerClientEvent\r\n */\r\n\r\n/**\r\n * @typedef {'direct'} SwapFlowMode\r\n */\r\n\r\n/**\r\n * @typedef {object} SwapQuoteResult\r\n * @property {string} sellingAsset\r\n * @property {string} buyingAsset\r\n * @property {number} slippageTolerance\r\n * @property {string} destination\r\n * @property {number} ledger\r\n * @property {string} [sellingAmount]\r\n * @property {string} [estimatedBuyingAmount]\r\n * @property {string} [buyingAmount]\r\n * @property {string} [estimatedSellingAmount]\r\n * @property {{selling: string, buying: string, path: string[]}} [directTrade]\r\n */\r\n\r\n/**\r\n * @typedef {function(FeeBumpTransaction):Promise<FeeBumpTransaction>} ClientAuthorizationCallback\r\n */","import StellarBrokerClient from './client.js'\r\n\r\nexport default StellarBrokerClient"],"names":["root","factory","exports","module","require","define","amd","this","__WEBPACK_EXTERNAL_MODULE__755__","__webpack_module_cache__","__webpack_require__","moduleId","cachedModule","undefined","__webpack_modules__","d","definition","key","o","Object","defineProperty","enumerable","get","obj","prop","prototype","hasOwnProperty","call","StellarBrokerError","Error","constructor","code","message","super","invalidInitParam","param","invalidAuthorizationParam","quoteNotSet","quoteExpired","quoteError","invalidQuoteParam","invalidParamName","details","tradeInProgress","invalidSwapTx","failedToSignTx","unsupportedEventType","type","serverError","buildEvent","data","evt","CustomEvent","detail","parseAsset","asset","parameter","includes","issuer","split","validateCode","validateAccount","errors","test","account","optional","StrKey","isValidEd25519PublicKey","parseAmount","amount","parsed","parseFloat","isNaN","parseSlippageTolerance","src","tolerance","StellarBrokerEvents","ensurePromise","callResult","Promise","resolve","reject","params","network","partnerKey","emitter","EventTarget","Networks","toUpperCase","flow","status","socket","origin","quoteRequest","lastQuote","tradeQuote","authorization","source","destination","connect","readyState","WebSocket","OPEN","encodeURIComponent","onmessage","processMessage","bind","onclose","console","log","onerror","e","error","confirm","expirationTimeout","setTimeout","onSocketOpen","heartbeat","clearTimeout","raw","JSON","parse","quote","ts","Date","dispatchEvent","processTxRequest","sold","bought","send","stop","sellingAsset","selling_asset","buyingAsset","buying_asset","sellingAmount","selling_amount","buyingAmount","buying_amount","slippageTolerance","slippage_tolerance","other","res","assign","validateQuoteRequest","then","confirmQuote","Keypair","fromSecret","tx","TransactionBuilder","fromXDR","xdr","validateTransaction","authorizeTx","networkFee","signatures","length","hash","toXDR","catch","sign","wrapped","buildFeeBumpTransaction","swap","operations","stringify","pingHandler","warn","close","on","callback","addEventListener","once","off","removeEventListener"],"sourceRoot":""}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@stellar-broker/client",
+  "version": "0.1.0",
+  "description": "Browser client library for StellarBroker",
+  "type": "module",
+  "main": "lib/index.js",
+  "module": "src/index.js",
+  "types": "src/index.d.ts",
+  "scripts": {
+    "build": "webpack --mode=production --config webpack.config.cjs",
+    "test": "jest"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stellar-broker/client"
+  },
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {
+    "@stellar/stellar-base": ">=11"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.24.8",
+    "@babel/preset-env": "^7.24.8",
+    "babel-loader": "^9.1.3",
+    "jest": "^29.7.0",
+    "typescript": "^5.5.4",
+    "webpack": "^5.93.0",
+    "webpack-cli": "^5.1.4",
+    "ws": "^8.17.1"
+  }
+}

package/src/client.js

@@ -0,0 +1,417 @@
+import {Networks, TransactionBuilder, Keypair, FeeBumpTransaction} from '@stellar/stellar-base'
+import errors from './errors.js'
+import {buildEvent} from './events.js'
+import {validateQuoteRequest} from './quote-request.js'
+
+export default class StellarBrokerClient {
+    /**
+     * @param {ClientInitializationParams} params
+     */
+    constructor(params) {
+        if (!params.network)
+            throw errors.invalidInitParam('network')
+        this.partnerKey = params.partnerKey
+        this.emitter = new EventTarget()
+        this.network = Networks[params.network.toUpperCase()] || params.network
+        this.flow = params.flow || 'direct'
+    }
+
+    /**
+     * @type {ClientStatus}
+     * @readonly
+     */
+    status = 'disconnected'
+    /**
+     * @type {WebSocket}
+     * @private
+     */
+    socket
+    /**
+     * @type {EventTarget}
+     * @private
+     */
+    emitter
+    /**
+     * @type {string}
+     * @private
+     */
+    origin = 'https://api.stellar.broker'
+    /**
+     * Stellar network passphrase
+     * @type {string}
+     * @readonly
+     */
+    network = ''
+    /**
+     * Last quote request submitted by the client
+     * @type {SwapQuoteParams}
+     * @private
+     */
+    quoteRequest
+    /**
+     * Last quote received from the sever
+     * @type {SwapQuoteResult}
+     * @readonly
+     */
+    lastQuote
+    /**
+     * Current quote accepted for the trading
+     * @private
+     */
+    tradeQuote
+    /**
+     * API key of the partner
+     * @type {string}
+     * @private
+     */
+    partnerKey
+    /**
+     * Account secret key (for direct swap flow)
+     * @type {Keypair|ClientAuthorizationCallback}
+     * @private
+     */
+    authorization
+
+    /**
+     * Trader account public key
+     * @type {string}
+     */
+    get source() {
+        return this.quoteRequest?.destination
+    }
+
+    /**
+     * Connect to the StellarBroker server
+     * @return {Promise<StellarBrokerClient>}
+     */
+    connect() {
+        if (this.socket?.readyState === WebSocket.OPEN)
+            return Promise.resolve(this) //already opened
+
+        this.socket = new WebSocket(this.origin + '/ws?partner=' + encodeURIComponent(this.partnerKey))
+        this.socket.onmessage = this.processMessage.bind(this)
+        this.socket.onclose = () => {
+            console.log('Connection closed')
+            this.status = 'disconnected'
+        }
+
+        this.socket.onerror = e => console.error(e)
+
+        return new Promise((confirm, reject) => { //TODO: use 'once'
+            const expirationTimeout = setTimeout(() => reject(this), 2000) // 2s timeout
+            this.onSocketOpen = () => {
+                this.status = 'ready'
+                this.heartbeat()
+                this.onSocketOpen = undefined
+                clearTimeout(expirationTimeout)
+                confirm(this)
+            }
+        })
+    }
+
+    /**
+     * Process incoming message
+     * @param message
+     * @private
+     */
+    processMessage(message) {
+        const raw = JSON.parse(message.data)
+        switch (raw.type) {
+            case 'connected':
+                if (this.onSocketOpen) {
+                    this.onSocketOpen()
+                }
+                break
+            case 'quote':
+                this.lastQuote = raw.quote
+                this.lastQuote.ts = new Date()
+                //send event to the client app
+                this.emitter.dispatchEvent(buildEvent('quote', this.lastQuote))
+                break
+            case 'tx':
+                if (this.status !== 'trade') {
+                    console.log('Received tx in non-trading state', this.status, raw)
+                    return //skip unless trading is in progress
+                }
+                this.processTxRequest(raw)
+                break
+            case 'stop':
+                this.emitter.dispatchEvent(buildEvent('finished', {
+                    status: raw.status,
+                    sold: raw.sold,
+                    bought: raw.bought
+                }, 'result'))
+                this.status = 'ready'
+                break
+            case 'progress':
+                this.emitter.dispatchEvent(buildEvent('progress', {
+                    sold: raw.sold,
+                    bought: raw.bought
+                }, 'status'))
+                break
+            case 'ping':
+                this.heartbeat()
+                this.send({type: 'pong'})
+                break
+            case 'error':
+                this.stop()
+                this.emitter.dispatchEvent(buildEvent('error', 'Server error: ' + raw.error))
+                break
+            default:
+                console.log('Unknown message type: ' + raw.type)
+                break
+        }
+    }
+
+    /**
+     * Request swap quote
+     * @param {SwapQuoteParams} params - Quote parameters
+     */
+    quote(params) {
+        if (this.status === 'trade')
+            throw errors.tradeInProgress()
+        this.quoteRequest = validateQuoteRequest(params)
+        this.status = 'quote'
+        this.connect()
+            .then(() => {
+                this.send({
+                    type: 'quote',
+                    ...this.quoteRequest
+                })
+            })
+    }
+
+    /**
+     * Stop quotation/trading
+     */
+    stop() {
+        if (this.status !== 'trade' && this.status !== 'quote')
+            return
+        this.send({
+            type: 'stop'
+        })
+        this.tradeQuote = undefined
+        this.status = 'ready'
+    }
+
+    /**
+     * Confirm current quote and start trading
+     * @param {string|ClientAuthorizationCallback} authorization - Authorization method, either account secret key or an authorization callback
+     */
+    confirmQuote(authorization) {
+        if (this.status !== 'quote')
+            throw errors.tradeInProgress()
+        if (!this.lastQuote)
+            throw errors.quoteNotSet()
+        if ((new Date() - this.lastQuote.ts) > 7000) //do not allow stale quotes quoted more than 7s ago
+            throw errors.quoteExpired()
+        if (this.lastQuote.status !== 'success')
+            throw errors.quoteError(this.lastQuote.error || 'quote not available')
+        if (typeof authorization === 'string') {
+            try {
+                this.authorization = Keypair.fromSecret(authorization)
+            } catch (e) {
+                throw errors.invalidAuthorizationParam()
+            }
+        } else if (typeof authorization === 'function') {
+            this.authorization = authorization
+        }
+        this.tradeQuote = this.lastQuote
+        this.send({
+            type: 'trade'
+        })
+        this.status = 'trade'
+    }
+
+    /**
+     * @param {{xdr: string, hash: string}} raw
+     * @private
+     */
+    processTxRequest(raw) {
+        //parse incoming transaction
+        let tx
+        try {
+            tx = TransactionBuilder.fromXDR(raw.xdr, this.network)
+        } catch (e) {
+            throw errors.invalidSwapTx()
+        }
+        //check that transaction is correct
+        if (!this.validateTransaction(tx))
+            throw errors.invalidSwapTx()
+        //sign transaction
+        this.authorizeTx(tx, raw.networkFee)
+            .then(tx => {
+                if (!tx || tx.signatures.length < 1)
+                    return console.error(`Transaction ${raw.hash} not signed`)
+                //respond with signed transaction
+                this.send({
+                    type: 'tx',
+                    hash: raw.hash,
+                    xdr: tx.toXDR()
+                })
+            })
+            .catch(e => {
+                console.error(e)
+                throw errors.failedToSignTx()
+            })
+    }
+
+    /**
+     * @param {Transaction} tx
+     * @param {string} networkFee
+     * @return {Promise<FeeBumpTransaction>}
+     * @private
+     */
+    async authorizeTx(tx, networkFee) {
+        //sign tx
+        if (this.authorization instanceof Keypair) {
+            tx.sign(this.authorization)
+        } else {
+            tx = await ensurePromise(this.authorization(tx))
+        }
+        //wrap with fee bump
+        let wrapped = TransactionBuilder.buildFeeBumpTransaction(this.source, networkFee, tx, this.network)
+        //sign fee bump wrapper tx
+        if (this.authorization instanceof Keypair) {
+            wrapped.sign(this.authorization)
+        } else {
+            wrapped = await ensurePromise(this.authorization(wrapped))
+        }
+        return wrapped
+    }
+
+    /**
+     * @param {Transaction} tx
+     * @throws {StellarBrokerError} Invalid swap transaction received
+     */
+    validateTransaction(tx) {
+        /*if (!(tx instanceof FeeBumpTransaction))
+            return false
+        const {innerTransaction} = tx
+        if (tx.feeSource !== this.source)
+            return false*/
+        for (let swap of tx.operations) {
+            if (swap.type !== 'pathPaymentStrictSend' && swap.type !== 'pathPaymentStrictReceive')
+                return false
+            const isFee = swap.destination !== this.source
+            if (isFee) {
+                if (swap.type !== 'pathPaymentStrictSend')
+                    return false
+                if ((swap.source && swap.source !== this.source))
+                    return false
+            } else {
+                if ((swap.source && swap.source !== swap.destination) || swap.destination !== this.source)
+                    return false
+            }
+        }
+        //TODO: check assets and amounts
+        return true
+    }
+
+    /**
+     * @param {{}} data
+     * @private
+     */
+    send(data) {
+        this.socket.send(JSON.stringify(data))
+    }
+
+    heartbeat() {
+        clearTimeout(this.pingHandler)
+        this.pingHandler = setTimeout(() => {
+            console.warn('Lost connection with the server')
+            this.socket.close()
+        }, 11_000) // 11 seconds heartbeat timeout
+    }
+
+    /**
+     * Add event listener
+     * @param {StellarBrokerClientEvent} type
+     * @param {function} callback
+     */
+    on(type, callback) {
+        if (!StellarBrokerEvents.includes(type))
+            throw errors.unsupportedEventType(type)
+        this.emitter.addEventListener(type, callback)
+    }
+
+    /**
+     * Add event listener that will be executed once
+     * @param {StellarBrokerClientEvent} type
+     * @param {function} callback
+     */
+    once(type, callback) {
+        if (!StellarBrokerEvents.includes(type))
+            throw errors.unsupportedEventType(type)
+        this.emitter.addEventListener(type, callback, {once: true})
+    }
+
+    /**
+     * Remove event listener
+     * @param {StellarBrokerClientEvent} type
+     * @param {function} callback
+     */
+    off(type, callback) {
+        if (!StellarBrokerEvents.includes(type))
+            throw errors.unsupportedEventType(type)
+        this.emitter.removeEventListener(type, callback)
+    }
+
+    /**
+     * Close underlying connection and finalize the client
+     */
+    close() {
+        try {
+            this.socket.close()
+        } catch (e) {
+        }
+    }
+}
+
+export const StellarBrokerEvents = ['quote', 'finished', 'progress', 'error']
+
+function ensurePromise(callResult) {
+    if (!callResult instanceof Promise) {
+        if (callResult)
+            return Promise.resolve(callResult)
+        return Promise.reject()
+    }
+    return callResult
+}
+
+/**
+ * @typedef {object} ClientInitializationParams
+ * @property {string} [network] - Stellar network identifier or passphrase
+ * @property {string} [partnerKey] - Partner key
+ * @property {SwapFlowMode} [flow] - Swap flow mode
+ */
+
+/**
+ * @typedef {'disconnected'|'ready'|'quote'|'trade'} ClientStatus
+ */
+
+/**
+ * @typedef {'quote'|'finished'|'progress'|'error'} StellarBrokerClientEvent
+ */
+
+/**
+ * @typedef {'direct'} SwapFlowMode
+ */
+
+/**
+ * @typedef {object} SwapQuoteResult
+ * @property {string} sellingAsset
+ * @property {string} buyingAsset
+ * @property {number} slippageTolerance
+ * @property {string} destination
+ * @property {number} ledger
+ * @property {string} [sellingAmount]
+ * @property {string} [estimatedBuyingAmount]
+ * @property {string} [buyingAmount]
+ * @property {string} [estimatedSellingAmount]
+ * @property {{selling: string, buying: string, path: string[]}} [directTrade]
+ */
+
+/**
+ * @typedef {function(FeeBumpTransaction):Promise<FeeBumpTransaction>} ClientAuthorizationCallback
+ */

package/src/errors.js

@@ -0,0 +1,51 @@
+export class StellarBrokerError extends Error {
+    constructor(code, message) {
+        super(message)
+        this.code = code
+    }
+
+    /**
+     * Numeric error code
+     * @type {number}
+     * @readonly
+     */
+    code = 0
+}
+
+const errors = {
+    invalidInitParam(param) {
+        return new StellarBrokerError(1, `Invalid parameter value: "${param}"`)
+    },
+    invalidAuthorizationParam() {
+        return new StellarBrokerError(2, 'Invalid authorization secret key or callback provided')
+    },
+    quoteNotSet() {
+        return new StellarBrokerError(11, 'Price quote not available')
+    },
+    quoteExpired() {
+        return new StellarBrokerError(12, 'Price quote expired')
+    },
+    quoteError(message) {
+        return new StellarBrokerError(13, 'Price quotation error: ' + message)
+    },
+    invalidQuoteParam(invalidParamName, details) {
+        return new StellarBrokerError(14, `Invalid quote request parameter: "${invalidParamName}". ${details}`)
+    },
+    tradeInProgress() {
+        return new StellarBrokerError(20, 'Cannot change quote while trade is in progress')
+    },
+    invalidSwapTx() {
+        return new StellarBrokerError(21, 'Invalid swap transaction received')
+    },
+    failedToSignTx() {
+        return new StellarBrokerError(22, 'Failed to sign received transaction')
+    },
+    unsupportedEventType(type) {
+        return new StellarBrokerError(31, 'Unknown event type: ' + type)
+    },
+    serverError(message) {
+        return new StellarBrokerError(101, 'Server error: ' + message)
+    }
+}
+
+export default errors

package/src/estimate.js

@@ -0,0 +1,20 @@
+import errors, {StellarBrokerError} from './errors.js'
+import {validateQuoteRequest} from './quote-request.js'
+
+/**
+ * Estimate price swap without trading.
+ * @param {SwapQuoteParams} params
+ */
+export async function estimateSwap(params) {
+    const query = Object.entries(validateQuoteRequest(params)).map(([param, value]) => encodeURIComponent(param) + '=' + encodeURIComponent(value))
+    const url = (params.origin || 'https://api.stellar.broker') + '/quote?' + query.join('&')
+    try {
+        const res = await fetch(url).then(r => r.json())
+        if (res.status !== 'success')
+            throw errors.quoteError(res.error || 'Quote not available')
+    } catch (e) {
+        if (e instanceof StellarBrokerError)
+            throw e
+        throw errors.quoteError('Failed to fetch quote')
+    }
+}

package/src/events.js

@@ -0,0 +1,11 @@
+/**
+ * @param {string} type
+ * @param {{}} data
+ * @param {string} [key]
+ * @return {CustomEvent}
+ */
+export function buildEvent(type, data, key) {
+    const evt = new CustomEvent(type, {detail: data})
+    evt[key || type] = data
+    return evt
+}

package/src/index.d.ts

@@ -0,0 +1,142 @@
+export default class StellarBrokerClient {
+    /**
+     * @param {ClientInitializationParams} params
+     */
+    constructor(params: ClientInitializationParams);
+
+    /**
+     * Trader account public key
+     * @type {string}
+     */
+    readonly source: string;
+    /**
+     * Stellar network passphrase
+     * @type {string}
+     */
+    readonly network: string;
+    /**
+     * @type {ClientStatus}
+     */
+    readonly status: ClientStatus;
+
+    /**
+     * Connect to the StellarBroker server
+     * @return {Promise<StellarBrokerClient>}
+     */
+    connect(): Promise<StellarBrokerClient>;
+
+    /**
+     * Request swap quote
+     * @param {SwapQuoteParams} params - Quote parameters
+     */
+    quote(params: SwapQuoteParams): void;
+
+    /**
+     * Stop quotation/trading
+     */
+    stop(): void;
+
+    /**
+     * Confirm current quote and start trading
+     * @param {string|ClientAuthorizationCallback} authorization - Authorization method, either account secret key or an authorization callback
+     */
+    confirmQuote(authorization: string | ClientAuthorizationCallback): void;
+
+    /**
+     * Add event listener
+     * @param {StellarBrokerClientEvent} type
+     * @param {function} callback
+     */
+    on(type: StellarBrokerClientEvent, callback: Function): void;
+
+    /**
+     * Add event listener that will be executed once
+     * @param {StellarBrokerClientEvent} type
+     * @param {function} callback
+     */
+    once(type: StellarBrokerClientEvent, callback: Function): void;
+
+    /**
+     * Remove event listener
+     * @param {StellarBrokerClientEvent} type
+     * @param {function} callback
+     */
+    off(type: StellarBrokerClientEvent, callback: Function): void;
+    /**
+     * Close underlying connection and finalize the client
+     */
+    close(): void;
+}
+
+export interface SwapQuoteParams {
+    /**
+     * Asset to sell
+     */
+    sellingAsset: string
+    /**
+     * Asset to buy
+     */
+    buyingAsset: string
+    /**
+     * Amount of selling asset
+     */
+    sellingAmount?: string
+    /**
+     * Amount of buying asset
+     */
+    buyingAmount?: string
+    /**
+     * Swap slippage tolerance (2% by default)
+     */
+    slippageTolerance?: number
+}
+
+
+export interface ClientInitializationParams {
+    /**
+     * Trader account public key
+     */
+    account: string;
+    /**
+     * Stellar network identifier or passphrase (pubnet by default)
+     */
+    network?: string;
+    /**
+     * Partner key
+     */
+    partnerKey?: string;
+    /**
+     * Swap flow mode
+     */
+    flow?: SwapFlowMode;
+}
+
+export type ClientStatus = "disconnected" | "ready" | "quote" | "trade";
+
+export type StellarBrokerClientEvent = "quote" | "finished" | "progress";
+
+export type SwapFlowMode = "direct";
+
+export interface SwapQuoteResult {
+    sellingAsset: string;
+    buyingAsset: string;
+    slippageTolerance: number;
+    destination: string;
+    ledger: number;
+    sellingAmount?: string;
+    estimatedBuyingAmount?: string;
+    buyingAmount?: string;
+    estimatedSellingAmount?: string;
+}
+
+export class StellarBrokerError extends Error {
+    /**
+     * Numeric error code
+     * @type {number}
+     * @readonly
+     */
+    readonly code: number;
+}
+
+export type ClientAuthorizationCallback = (arg0: FeeBumpTransaction) => Promise<FeeBumpTransaction>;
+import {FeeBumpTransaction} from "@stellar/stellar-base";

package/src/index.js

@@ -0,0 +1,3 @@
+import StellarBrokerClient from './client.js'
+
+export default StellarBrokerClient

package/src/quote-request.js

@@ -0,0 +1,96 @@
+import {StrKey} from '@stellar/stellar-base'
+import errors from './errors.js'
+
+/**
+ * @typedef {object} SwapQuoteParams
+ * @property {string} sellingAsset - Asset to sell
+ * @property {string} buyingAsset - Asset to buy
+ * @property {string} [sellingAmount] - Amount of selling asset
+ * @property {string} [buyingAmount] - Amount of buying asset
+ * @property {number} [slippageTolerance] - Swap slippage tolerance (0.02 by default - 2%)
+ * @property {string} [destination] - Trader account address
+ */
+
+/**
+ * @param {SwapQuoteParams} params
+ * @return {SwapQuoteParams}
+ */
+export function validateQuoteRequest(params) {
+    const {
+        destination, sellingAsset, selling_asset, buyingAsset, buying_asset, sellingAmount, selling_amount,
+        buyingAmount, buying_amount, slippageTolerance, slippage_tolerance, ...other
+    } = params
+    const res = {
+        sellingAsset: parseAsset(sellingAsset || selling_asset, 'sellingAsset'),
+        buyingAsset: parseAsset(buyingAsset || buying_asset, 'buyingAsset'),
+        sellingAmount: parseAmount(sellingAmount || selling_amount, 'sellingAmount'),
+        buyingAmount: parseAmount(buyingAmount || buying_amount, 'buyingAmount'),
+        slippageTolerance: parseSlippageTolerance(slippageTolerance || slippage_tolerance || 0.02, 'slippageTolerance'),
+        flow: 'direct'
+    }
+    if (destination) {
+        res.destination = validateAccount(destination, 'destination', true)
+    }
+    if (res.buyingAsset === res.sellingAsset)
+        throw errors.invalidQuoteParam('buyingAsset', 'Buying asset can\'t be the same as selling asset')
+    if (res.buyingAmount === undefined && res.sellingAmount === undefined)
+        throw errors.invalidQuoteParam('sellingAmount', 'Either "buyingAmount" or "sellingAmount" parameter is required')
+    if (res.buyingAmount !== undefined && res.sellingAmount !== undefined)
+        throw errors.invalidQuoteParam('sellingAmount', 'Parameters "buyingAmount" and "sellingAmount" are mutually exclusive')
+    Object.assign(res, other) //add remaining optional params
+    return res
+}
+
+function parseAsset(asset, parameter) {
+    if (typeof asset === 'string') {
+        if (asset === 'XLM' || asset === 'xlm' || asset === 'native')
+            return 'XLM'
+        if (asset.includes(':')) {
+            const [code, issuer] = asset.split(':')
+            validateCode(code)
+            validateAccount(issuer, parameter)
+            return code + '-' + issuer
+        }
+        if (asset.includes('-')) {
+            const [code, issuer] = asset.split('-')
+            validateCode(code)
+            validateAccount(issuer, parameter)
+            return asset
+        }
+    }
+    throw errors.invalidQuoteParam(parameter, 'Invalid asset')
+}
+
+function validateCode(code, parameter) {
+    if (!/^[a-zA-Z0-9]{1,12}$/.test(code))
+        throw errors.invalidQuoteParam(parameter, 'Invalid asset code: ' + (code === undefined ? 'missing' : code))
+    return code
+}
+
+function validateAccount(account, param, optional = false) {
+    if (account === undefined && optional)
+        return undefined
+    if (!StrKey.isValidEd25519PublicKey(account))
+        throw errors.invalidQuoteParam(param, 'Invalid account address: ' + (account === undefined ? 'missing' : account))
+    return account
+}
+
+function parseAmount(amount, parameter) {
+    if (amount === undefined)
+        return undefined
+    const parsed = parseFloat(amount)
+    if (isNaN(parsed) || parsed <= 0)
+        throw errors.invalidQuoteParam(parameter, 'Invalid asset amount: ' + amount)
+    return amount
+}
+
+function parseSlippageTolerance(src, parameter) {
+    const tolerance = parseFloat(src)
+    if (isNaN(tolerance))
+        throw errors.invalidQuoteParam(parameter, 'Invalid slippage tolerance, number expected')
+    if (tolerance < 0)
+        throw errors.invalidQuoteParam(parameter, 'Slippage tolerance is too small, expected value >= 0')
+    if (tolerance > 0.5)
+        throw errors.invalidQuoteParam(parameter, 'Slippage tolerance is too large, expected value < 0.5 (50%)')
+    return tolerance
+}

package/webpack.config.cjs

@@ -0,0 +1,43 @@
+const path = require('path')
+const webpack = require('webpack')
+
+module.exports = function () {
+    return {
+        mode: 'production',
+        devtool: 'source-map',
+        entry: {
+            stellarbroker: [path.join(__dirname, '/src/index.js')]
+        },
+        output: {
+            path: path.join(__dirname, './lib'),
+            filename: '[name].js',
+            library: {
+                name: 'stellarbroker',
+                type: 'umd',
+                export: 'default'
+            },
+            libraryTarget: 'umd',
+            globalObject: 'this'
+        },
+        module: {
+            rules: [
+                {
+                    test: /\.js?$/,
+                    loader: 'babel-loader',
+                    exclude: /node_modules/
+                }
+            ]
+        },
+        externals: {
+            '@stellar/stellar-base': '@stellar/stellar-base'
+        },
+        plugins: [
+            new webpack.DefinePlugin({
+                'process.env.NODE_ENV': JSON.stringify('production')
+            })
+        ],
+        optimization: {
+            minimize: true
+        }
+    }
+}