Add openAPI

build/Dockerfile-swagger

@@ -0,0 +1,14 @@
+FROM golang:1.17-alpine AS build
+
+WORKDIR /app
+
+ENV SWAGGER_VERSION=v0.29.0
+ENV REPO="github.com/go-swagger/go-swagger/cmd/swagger"
+
+COPY go.mod ./
+COPY go.sum ./
+RUN go mod download
+
+RUN go get -u "${REPO}@${SWAGGER_VERSION}"
+
+ENTRYPOINT ["swagger"]

build/docker-compose.yml

@@ -5,4 +5,13 @@ services:
       context: ../
       dockerfile: build/Dockerfile
     ports:
-      - "8080:3000"
+      - "8080:3000"
+  swagger-ui:
+    build:
+      context: ../
+      dockerfile: build/Dockerfile-swagger
+    ports:
+      - "8002:8080"
+    volumes:
+      - ../docs/swagger.yaml:/app/swagger.yaml
+    command: ["serve", "/app/swagger.yaml", "--no-open", "--port", "8080"]

cmd/main.go

@@ -3,16 +3,17 @@ package main
 import (
 	"context"
 	"expvar"
-	"github.com/ardanlabs/conf"
-	"github.com/pkg/errors"
-	"github.com/sirupsen/logrus"
-	"github.com/tbd54566975/ssi-service/config"
-	"github.com/tbd54566975/ssi-service/pkg/server"
 	"net/http"
 	"os"
 	"os/signal"
 	"syscall"
 	"time"
+
+	"github.com/ardanlabs/conf"
+	"github.com/pkg/errors"
+	"github.com/sirupsen/logrus"
+	"github.com/tbd54566975/ssi-service/config"
+	"github.com/tbd54566975/ssi-service/pkg/server"
 )
 
 const (
@@ -28,6 +29,19 @@ func init() {
 	logrus.SetOutput(os.Stdout)
 }
 
+// @title           Swagger Example API
+// @version         1.0
+// @description     This is a sample server celler server.
+// @termsOfService  http://swagger.io/terms/
+
+// @contact.name   API Support
+// @contact.url    http://www.swagger.io/support
+// @contact.email  [email protected]
+
+// @license.name  Apache 2.0
+// @license.url   http://www.apache.org/licenses/LICENSE-2.0.html
+
+// @host      localhost:8080
 func main() {
 	logrus.Info("Starting up...")
 

docs/.swaggo

@@ -0,0 +1,2 @@
+// TODO: read cryptosuite.LDKeyType from sdk properly
+skip github.com/TBD54566975/ssi-sdk/did.VerificationMethod