docs: swagger specs for API V2 endpoints

lib/service/Errors.ts

@@ -141,4 +141,8 @@ export default {
     message: 'incorrect preimage',
     code: concatErrorCode(ErrorCodePrefix.Service, 36),
   }),
+  INVALID_VIN: (): Error => ({
+    message: 'input index is out of range',
+    code: concatErrorCode(ErrorCodePrefix.Service, 37),
+  }),
 };

lib/service/MusigSigner.ts

@@ -144,6 +144,11 @@ class MusigSigner {
     rawTransaction: Buffer | string,
     vin: number,
   ): Promise<PartialSignature> => {
+    const tx = parseTransaction(currency.type, rawTransaction);
+    if (vin < 0 || tx.ins.length <= vin) {
+      throw Errors.INVALID_VIN();
+    }
+
     const wallet = this.walletManager.wallets.get(currency.symbol)!;
 
     const ourKeys = wallet.getKeysByIndex(keyIndex);
@@ -153,7 +158,6 @@ class MusigSigner {
 
     musig.aggregateNonces([[theirPublicKey, theirNonce]]);
 
-    const tx = parseTransaction(currency.type, rawTransaction);
     const hash = await hashForWitnessV1(currency, tx, vin);
     musig.initializeSession(hash);
 

lib/service/Service.ts

@@ -218,6 +218,34 @@ class Service {
     await this.nodeInfo.init();
   };
 
+  public convertToPairAndSide = (
+    from: string,
+    to: string,
+    isReverse: boolean,
+  ): { pairId: string; orderSide: string } => {
+    const pair = (
+      [
+        [getPairId({ base: from, quote: to }), false],
+        [getPairId({ base: to, quote: from }), true],
+      ] as [string, boolean][]
+    ).find(([val]) => this.rateProvider.pairs.has(val));
+
+    if (pair === undefined) {
+      throw Errors.PAIR_NOT_FOUND(getPairId({ base: from, quote: to }));
+    }
+
+    return {
+      pairId: pair[0],
+      orderSide: isReverse
+        ? pair[1]
+          ? 'sell'
+          : 'buy'
+        : pair[1]
+          ? 'buy'
+          : 'sell',
+    };
+  };
+
   /**
    * Gets general information about this Boltz instance and the nodes it is connected to
    */

package.json

@@ -9,6 +9,7 @@
     "precompile": "node parseGitCommit.js",
     "compile": "npm run swagger && tsc && cross-os postcompile",
     "swagger": "node swagger.js",
+    "swagger-ui": "docker run --rm -p 8082:8080 -e SWAGGER_JSON=/boltz-backend/swagger-spec.json -v .:/boltz-backend swaggerapi/swagger-ui",
     "compile:watch": "tsc -w",
     "start": "node bin/boltzd",
     "dev": "npm run compile && npm run start",