New boarding protocol (#279)

* [domain] add reverse boarding inputs in Payment struct

* [tx-builder] support reverse boarding script

* [wallet] add GetTransaction

* [api-spec][application] add reverse boarding support in covenantless

* [config] add reverse boarding config

* [api-spec] add ReverseBoardingAddress RPC

* [domain][application] support empty forfeits txs in EndFinalization events

* [tx-builder] optional connector output in round tx

* [btc-embedded] fix getTx and taproot finalizer

* whitelist ReverseBoardingAddress RPC

* [test] add reverse boarding integration test

* [client] support reverse boarding

* [sdk] support reverse boarding

* [e2e] add sleep time after faucet

* [test] run using bitcoin-core RPC

* [tx-builder] fix GetSweepInput

* [application][tx-builder] support reverse onboarding in covenant

* [cli] support reverse onboarding in covenant CLI

* [test] rework integration tests

* [sdk] remove onchain wallet, replace by onboarding address

* remove old onboarding protocols

* [sdk] Fix RegisterPayment

* [e2e] add more funds to covenant ASP

* [e2e] add sleeping time

* several fixes

* descriptor boarding

* remove boarding delay from info

* [sdk] implement descriptor boarding

* go mod tidy

* fixes and revert error msgs

* move descriptor pkg to common

* add replace in go.mod

* [sdk] fix unit tests

* rename DescriptorInput --> BoardingInput

* genrest in SDK

* remove boarding input from domain

* remove all "reverse boarding"

* rename "onboarding" ==> "boarding"

* remove outdate payment unit test

* use tmpfs docker volument for compose testing files

* several fixes

api-spec/openapi/swagger/ark/v1/service.swagger.json

@@ -16,6 +16,38 @@
     "application/json"
   ],
   "paths": {
+    "/v1/boarding": {
+      "post": {
+        "operationId": "ArkService_GetBoardingAddress",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1GetBoardingAddressResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/v1GetBoardingAddressRequest"
+            }
+          }
+        ],
+        "tags": [
+          "ArkService"
+        ]
+      }
+    },
     "/v1/events": {
       "get": {
         "operationId": "ArkService_GetEventStream",
@@ -69,38 +101,6 @@
         ]
       }
     },
-    "/v1/onboard": {
-      "post": {
-        "operationId": "ArkService_Onboard",
-        "responses": {
-          "200": {
-            "description": "A successful response.",
-            "schema": {
-              "$ref": "#/definitions/v1OnboardResponse"
-            }
-          },
-          "default": {
-            "description": "An unexpected error response.",
-            "schema": {
-              "$ref": "#/definitions/rpcStatus"
-            }
-          }
-        },
-        "parameters": [
-          {
-            "name": "body",
-            "in": "body",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/v1OnboardRequest"
-            }
-          }
-        ],
-        "tags": [
-          "ArkService"
-        ]
-      }
-    },
     "/v1/payment": {
       "post": {
         "operationId": "ArkService_CreatePayment",
@@ -475,6 +475,21 @@
         }
       }
     },
+    "v1BoardingInput": {
+      "type": "object",
+      "properties": {
+        "txid": {
+          "type": "string"
+        },
+        "vout": {
+          "type": "integer",
+          "format": "int64"
+        },
+        "descriptor": {
+          "type": "string"
+        }
+      }
+    },
     "v1ClaimPaymentRequest": {
       "type": "object",
       "properties": {
@@ -555,12 +570,35 @@
             "type": "string"
           },
           "description": "Forfeit txs signed by the user."
+        },
+        "signedRoundTx": {
+          "type": "string",
+          "description": "If payment has boarding input, the user must sign the associated inputs."
         }
       }
     },
     "v1FinalizePaymentResponse": {
       "type": "object"
     },
+    "v1GetBoardingAddressRequest": {
+      "type": "object",
+      "properties": {
+        "pubkey": {
+          "type": "string"
+        }
+      }
+    },
+    "v1GetBoardingAddressResponse": {
+      "type": "object",
+      "properties": {
+        "address": {
+          "type": "string"
+        },
+        "descriptor": {
+          "type": "string"
+        }
+      }
+    },
     "v1GetEventStreamResponse": {
       "type": "object",
       "properties": {
@@ -605,6 +643,9 @@
         "minRelayFee": {
           "type": "string",
           "format": "int64"
+        },
+        "boardingDescriptorTemplate": {
+          "type": "string"
         }
       }
     },
@@ -627,12 +668,11 @@
     "v1Input": {
       "type": "object",
       "properties": {
-        "txid": {
-          "type": "string"
+        "vtxoInput": {
+          "$ref": "#/definitions/v1VtxoInput"
         },
-        "vout": {
-          "type": "integer",
-          "format": "int64"
+        "boardingInput": {
+          "$ref": "#/definitions/v1BoardingInput"
         }
       }
     },
@@ -669,23 +709,6 @@
         }
       }
     },
-    "v1OnboardRequest": {
-      "type": "object",
-      "properties": {
-        "boardingTx": {
-          "type": "string"
-        },
-        "congestionTree": {
-          "$ref": "#/definitions/v1Tree"
-        },
-        "userPubkey": {
-          "type": "string"
-        }
-      }
-    },
-    "v1OnboardResponse": {
-      "type": "object"
-    },
     "v1Output": {
       "type": "object",
       "properties": {
@@ -972,6 +995,18 @@
           "$ref": "#/definitions/v1PendingPayment"
         }
       }
+    },
+    "v1VtxoInput": {
+      "type": "object",
+      "properties": {
+        "txid": {
+          "type": "string"
+        },
+        "vout": {
+          "type": "integer",
+          "format": "int64"
+        }
+      }
     }
   }
 }