mirror of
https://github.com/aljazceru/ark.git
synced 2025-12-17 04:04:21 +01:00
f0a90c06ee
* api-spec: move the api-spec to root and init go.mod * go mod tidy * move buf files in the root as well * gh action for api-spec changes only * gh action for api-spec on push and pr
821 lines
18 KiB
JSON
821 lines
18 KiB
JSON
{
|
|
"swagger": "2.0",
|
|
"info": {
|
|
"title": "clark/v1/service.proto",
|
|
"version": "version not set"
|
|
},
|
|
"tags": [
|
|
{
|
|
"name": "ArkService"
|
|
}
|
|
],
|
|
"consumes": [
|
|
"application/json"
|
|
],
|
|
"produces": [
|
|
"application/json"
|
|
],
|
|
"paths": {
|
|
"/v1/events": {
|
|
"get": {
|
|
"operationId": "ArkService_GetEventStream",
|
|
"responses": {
|
|
"200": {
|
|
"description": "A successful response.(streaming responses)",
|
|
"schema": {
|
|
"type": "object",
|
|
"properties": {
|
|
"result": {
|
|
"$ref": "#/definitions/v1GetEventStreamResponse"
|
|
},
|
|
"error": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
},
|
|
"title": "Stream result of v1GetEventStreamResponse"
|
|
}
|
|
},
|
|
"default": {
|
|
"description": "An unexpected error response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
}
|
|
},
|
|
"tags": [
|
|
"ArkService"
|
|
]
|
|
}
|
|
},
|
|
"/v1/info": {
|
|
"get": {
|
|
"operationId": "ArkService_GetInfo",
|
|
"responses": {
|
|
"200": {
|
|
"description": "A successful response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/v1GetInfoResponse"
|
|
}
|
|
},
|
|
"default": {
|
|
"description": "An unexpected error response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
}
|
|
},
|
|
"tags": [
|
|
"ArkService"
|
|
]
|
|
}
|
|
},
|
|
"/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/async": {
|
|
"post": {
|
|
"operationId": "ArkService_CreateAsyncPayment",
|
|
"responses": {
|
|
"200": {
|
|
"description": "A successful response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/v1CreateAsyncPaymentResponse"
|
|
}
|
|
},
|
|
"default": {
|
|
"description": "An unexpected error response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
}
|
|
},
|
|
"parameters": [
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/v1CreateAsyncPaymentRequest"
|
|
}
|
|
}
|
|
],
|
|
"tags": [
|
|
"ArkService"
|
|
]
|
|
}
|
|
},
|
|
"/v1/payment/async/complete": {
|
|
"post": {
|
|
"operationId": "ArkService_CompleteAsyncPayment",
|
|
"responses": {
|
|
"200": {
|
|
"description": "A successful response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/v1CompleteAsyncPaymentResponse"
|
|
}
|
|
},
|
|
"default": {
|
|
"description": "An unexpected error response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
}
|
|
},
|
|
"parameters": [
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/v1CompleteAsyncPaymentRequest"
|
|
}
|
|
}
|
|
],
|
|
"tags": [
|
|
"ArkService"
|
|
]
|
|
}
|
|
},
|
|
"/v1/payment/claim": {
|
|
"post": {
|
|
"operationId": "ArkService_ClaimPayment",
|
|
"responses": {
|
|
"200": {
|
|
"description": "A successful response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/v1ClaimPaymentResponse"
|
|
}
|
|
},
|
|
"default": {
|
|
"description": "An unexpected error response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
}
|
|
},
|
|
"parameters": [
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/v1ClaimPaymentRequest"
|
|
}
|
|
}
|
|
],
|
|
"tags": [
|
|
"ArkService"
|
|
]
|
|
}
|
|
},
|
|
"/v1/payment/finalize": {
|
|
"post": {
|
|
"operationId": "ArkService_FinalizePayment",
|
|
"responses": {
|
|
"200": {
|
|
"description": "A successful response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/v1FinalizePaymentResponse"
|
|
}
|
|
},
|
|
"default": {
|
|
"description": "An unexpected error response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
}
|
|
},
|
|
"parameters": [
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/v1FinalizePaymentRequest"
|
|
}
|
|
}
|
|
],
|
|
"tags": [
|
|
"ArkService"
|
|
]
|
|
}
|
|
},
|
|
"/v1/payment/register": {
|
|
"post": {
|
|
"operationId": "ArkService_RegisterPayment",
|
|
"responses": {
|
|
"200": {
|
|
"description": "A successful response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/v1RegisterPaymentResponse"
|
|
}
|
|
},
|
|
"default": {
|
|
"description": "An unexpected error response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
}
|
|
},
|
|
"parameters": [
|
|
{
|
|
"name": "body",
|
|
"in": "body",
|
|
"required": true,
|
|
"schema": {
|
|
"$ref": "#/definitions/v1RegisterPaymentRequest"
|
|
}
|
|
}
|
|
],
|
|
"tags": [
|
|
"ArkService"
|
|
]
|
|
}
|
|
},
|
|
"/v1/ping/{paymentId}": {
|
|
"get": {
|
|
"operationId": "ArkService_Ping",
|
|
"responses": {
|
|
"200": {
|
|
"description": "A successful response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/v1PingResponse"
|
|
}
|
|
},
|
|
"default": {
|
|
"description": "An unexpected error response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
}
|
|
},
|
|
"parameters": [
|
|
{
|
|
"name": "paymentId",
|
|
"in": "path",
|
|
"required": true,
|
|
"type": "string"
|
|
}
|
|
],
|
|
"tags": [
|
|
"ArkService"
|
|
]
|
|
}
|
|
},
|
|
"/v1/round/id/{id}": {
|
|
"get": {
|
|
"operationId": "ArkService_GetRoundById",
|
|
"responses": {
|
|
"200": {
|
|
"description": "A successful response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/v1GetRoundByIdResponse"
|
|
}
|
|
},
|
|
"default": {
|
|
"description": "An unexpected error response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
}
|
|
},
|
|
"parameters": [
|
|
{
|
|
"name": "id",
|
|
"in": "path",
|
|
"required": true,
|
|
"type": "string"
|
|
}
|
|
],
|
|
"tags": [
|
|
"ArkService"
|
|
]
|
|
}
|
|
},
|
|
"/v1/round/{txid}": {
|
|
"get": {
|
|
"summary": "TODO BTC: signTree rpc",
|
|
"operationId": "ArkService_GetRound",
|
|
"responses": {
|
|
"200": {
|
|
"description": "A successful response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/v1GetRoundResponse"
|
|
}
|
|
},
|
|
"default": {
|
|
"description": "An unexpected error response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
}
|
|
},
|
|
"parameters": [
|
|
{
|
|
"name": "txid",
|
|
"in": "path",
|
|
"required": true,
|
|
"type": "string"
|
|
}
|
|
],
|
|
"tags": [
|
|
"ArkService"
|
|
]
|
|
}
|
|
},
|
|
"/v1/vtxos/{address}": {
|
|
"get": {
|
|
"operationId": "ArkService_ListVtxos",
|
|
"responses": {
|
|
"200": {
|
|
"description": "A successful response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/v1ListVtxosResponse"
|
|
}
|
|
},
|
|
"default": {
|
|
"description": "An unexpected error response.",
|
|
"schema": {
|
|
"$ref": "#/definitions/rpcStatus"
|
|
}
|
|
}
|
|
},
|
|
"parameters": [
|
|
{
|
|
"name": "address",
|
|
"in": "path",
|
|
"required": true,
|
|
"type": "string"
|
|
}
|
|
],
|
|
"tags": [
|
|
"ArkService"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"definitions": {
|
|
"protobufAny": {
|
|
"type": "object",
|
|
"properties": {
|
|
"@type": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"additionalProperties": {}
|
|
},
|
|
"rpcStatus": {
|
|
"type": "object",
|
|
"properties": {
|
|
"code": {
|
|
"type": "integer",
|
|
"format": "int32"
|
|
},
|
|
"message": {
|
|
"type": "string"
|
|
},
|
|
"details": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"$ref": "#/definitions/protobufAny"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"v1ClaimPaymentRequest": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"description": "Mocks wabisabi's credentials."
|
|
},
|
|
"outputs": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"$ref": "#/definitions/v1Output"
|
|
},
|
|
"description": "List of receivers for a registered payment."
|
|
}
|
|
}
|
|
},
|
|
"v1ClaimPaymentResponse": {
|
|
"type": "object"
|
|
},
|
|
"v1CompleteAsyncPaymentRequest": {
|
|
"type": "object",
|
|
"properties": {
|
|
"signedSenderTx": {
|
|
"type": "string"
|
|
},
|
|
"signedReceiverTx": {
|
|
"type": "string"
|
|
},
|
|
"signedUnconditionalForfeitTx": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"v1CompleteAsyncPaymentResponse": {
|
|
"type": "object",
|
|
"properties": {
|
|
"senderTx": {
|
|
"type": "string"
|
|
},
|
|
"receiverTx": {
|
|
"type": "string"
|
|
},
|
|
"unconditionalForfeitTx": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"v1CreateAsyncPaymentRequest": {
|
|
"type": "object",
|
|
"properties": {
|
|
"input": {
|
|
"$ref": "#/definitions/v1Input"
|
|
},
|
|
"receiverPubkey": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"v1CreateAsyncPaymentResponse": {
|
|
"type": "object",
|
|
"properties": {
|
|
"unsignedSenderTx": {
|
|
"type": "string"
|
|
},
|
|
"unsignedReceiverTx": {
|
|
"type": "string"
|
|
},
|
|
"usignedUnconditionalForfeitTx": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"v1FinalizePaymentRequest": {
|
|
"type": "object",
|
|
"properties": {
|
|
"signedForfeitTxs": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"description": "Forfeit txs signed by the user."
|
|
}
|
|
}
|
|
},
|
|
"v1FinalizePaymentResponse": {
|
|
"type": "object"
|
|
},
|
|
"v1GetEventStreamResponse": {
|
|
"type": "object",
|
|
"properties": {
|
|
"roundFinalization": {
|
|
"$ref": "#/definitions/v1RoundFinalizationEvent",
|
|
"title": "TODO: BTC add \"signTree\" event"
|
|
},
|
|
"roundFinalized": {
|
|
"$ref": "#/definitions/v1RoundFinalizedEvent"
|
|
},
|
|
"roundFailed": {
|
|
"$ref": "#/definitions/v1RoundFailed"
|
|
}
|
|
}
|
|
},
|
|
"v1GetInfoResponse": {
|
|
"type": "object",
|
|
"properties": {
|
|
"pubkey": {
|
|
"type": "string"
|
|
},
|
|
"roundLifetime": {
|
|
"type": "string",
|
|
"format": "int64"
|
|
},
|
|
"unilateralExitDelay": {
|
|
"type": "string",
|
|
"format": "int64"
|
|
},
|
|
"roundInterval": {
|
|
"type": "string",
|
|
"format": "int64"
|
|
},
|
|
"network": {
|
|
"type": "string"
|
|
},
|
|
"minRelayFee": {
|
|
"type": "string",
|
|
"format": "int64"
|
|
}
|
|
}
|
|
},
|
|
"v1GetRoundByIdResponse": {
|
|
"type": "object",
|
|
"properties": {
|
|
"round": {
|
|
"$ref": "#/definitions/v1Round"
|
|
}
|
|
}
|
|
},
|
|
"v1GetRoundResponse": {
|
|
"type": "object",
|
|
"properties": {
|
|
"round": {
|
|
"$ref": "#/definitions/v1Round"
|
|
}
|
|
}
|
|
},
|
|
"v1Input": {
|
|
"type": "object",
|
|
"properties": {
|
|
"txid": {
|
|
"type": "string"
|
|
},
|
|
"vout": {
|
|
"type": "integer",
|
|
"format": "int64"
|
|
}
|
|
}
|
|
},
|
|
"v1ListVtxosResponse": {
|
|
"type": "object",
|
|
"properties": {
|
|
"spendableVtxos": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"$ref": "#/definitions/v1Vtxo"
|
|
}
|
|
},
|
|
"spentVtxos": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"$ref": "#/definitions/v1Vtxo"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"v1Node": {
|
|
"type": "object",
|
|
"properties": {
|
|
"txid": {
|
|
"type": "string"
|
|
},
|
|
"tx": {
|
|
"type": "string"
|
|
},
|
|
"parentTxid": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"v1OnboardRequest": {
|
|
"type": "object",
|
|
"properties": {
|
|
"boardingTx": {
|
|
"type": "string"
|
|
},
|
|
"congestionTree": {
|
|
"$ref": "#/definitions/v1Tree"
|
|
},
|
|
"userPubkey": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"v1OnboardResponse": {
|
|
"type": "object"
|
|
},
|
|
"v1Output": {
|
|
"type": "object",
|
|
"properties": {
|
|
"address": {
|
|
"type": "string",
|
|
"description": "Either the offchain or onchain address."
|
|
},
|
|
"amount": {
|
|
"type": "string",
|
|
"format": "uint64",
|
|
"description": "Amount to send in satoshis."
|
|
}
|
|
}
|
|
},
|
|
"v1PingResponse": {
|
|
"type": "object",
|
|
"properties": {
|
|
"forfeitTxs": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"event": {
|
|
"$ref": "#/definitions/v1RoundFinalizationEvent"
|
|
}
|
|
}
|
|
},
|
|
"v1RegisterPaymentRequest": {
|
|
"type": "object",
|
|
"properties": {
|
|
"inputs": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"$ref": "#/definitions/v1Input"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"v1RegisterPaymentResponse": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"description": "Mocks wabisabi's credentials."
|
|
}
|
|
}
|
|
},
|
|
"v1Round": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"start": {
|
|
"type": "string",
|
|
"format": "int64"
|
|
},
|
|
"end": {
|
|
"type": "string",
|
|
"format": "int64"
|
|
},
|
|
"poolTx": {
|
|
"type": "string"
|
|
},
|
|
"congestionTree": {
|
|
"$ref": "#/definitions/v1Tree"
|
|
},
|
|
"forfeitTxs": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"connectors": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"stage": {
|
|
"$ref": "#/definitions/v1RoundStage"
|
|
}
|
|
}
|
|
},
|
|
"v1RoundFailed": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"reason": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"v1RoundFinalizationEvent": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"poolTx": {
|
|
"type": "string"
|
|
},
|
|
"forfeitTxs": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"congestionTree": {
|
|
"$ref": "#/definitions/v1Tree"
|
|
},
|
|
"connectors": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"v1RoundFinalizedEvent": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"poolTxid": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"v1RoundStage": {
|
|
"type": "string",
|
|
"enum": [
|
|
"ROUND_STAGE_UNSPECIFIED",
|
|
"ROUND_STAGE_REGISTRATION",
|
|
"ROUND_STAGE_FINALIZATION",
|
|
"ROUND_STAGE_FINALIZED",
|
|
"ROUND_STAGE_FAILED"
|
|
],
|
|
"default": "ROUND_STAGE_UNSPECIFIED"
|
|
},
|
|
"v1Tree": {
|
|
"type": "object",
|
|
"properties": {
|
|
"levels": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"$ref": "#/definitions/v1TreeLevel"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"v1TreeLevel": {
|
|
"type": "object",
|
|
"properties": {
|
|
"nodes": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"$ref": "#/definitions/v1Node"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"v1Vtxo": {
|
|
"type": "object",
|
|
"properties": {
|
|
"outpoint": {
|
|
"$ref": "#/definitions/v1Input"
|
|
},
|
|
"receiver": {
|
|
"$ref": "#/definitions/v1Output"
|
|
},
|
|
"spent": {
|
|
"type": "boolean"
|
|
},
|
|
"poolTxid": {
|
|
"type": "string"
|
|
},
|
|
"spentBy": {
|
|
"type": "string"
|
|
},
|
|
"expireAt": {
|
|
"type": "string",
|
|
"format": "int64"
|
|
},
|
|
"swept": {
|
|
"type": "boolean"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|