@blinklabs/dingo 0.6.0

package/.dockerignore

@@ -0,0 +1,5 @@
+.dingo/
+.github/
+dingo
+Dockerfile
+README.md

package/.github/CODEOWNERS

@@ -0,0 +1,5 @@
+# Blink Labs
+#
+* @blinklabs-io/core
+*.md @blinklabs-io/core @blinklabs-io/docs @blinklabs-io/pms
+LICENSE @blinklabs-io/core @blinklabs-io/pms

package/.github/dependabot.yml

@@ -0,0 +1,19 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "docker"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "gomod"
+    directory: "/"
+    schedule:
+      interval: "weekly"

package/.github/dingo.md

@@ -0,0 +1,56 @@
+```
+                                                                                                                                                      
+                                                                                                                                                      
+                                                                                                                 ==                                   
+                                                                                                           ===*******+==+                             
+                                                                                                        ==+*************+==                           
+                                                                                               ====   ==*******++++*******+==                         
+                                                                                          ===++****+++=+****===    ==+******==                        
+                  @%@@                                                                 ==+**************+++=         =+******+=                       
+                @#-----*#%@@                                                         ==+******************+=          =*******==                      
+              @#--=%%%+=-----*#%@                                                  ==+*********************+==        =********==                     
+            @%=-=%%%%%%%%%%%+=--+                                                 ==************************+=#      =+**##%%%#+=                     
+           %*--#%%%%%%%%%%%%--=-=@                             -===             -=+**************************+=      =#@@@@@@@@%=                     
+         %*--=%%%%%%%%%%%%=--%%+-%@    ======                 ==*#+=           ==*****************************==   ==#@@@@@@@@@%=                     
+        %---+%%%%%%%%%%%#--*%%%*--@   =+%%#*===             -=*#@@#*=         =+******************************+=   =*@@@@@@@@@@%=                     
+        @-------==#%%%%=-=%%%%%%--#   =+%@@#**+=           ==*%@@@@*==      +=+*******************************+=  =+@@@@@@@@@@@+=                     
+        @%-+%%%%#=-----=%%%%%%%%+-#   =+#%%@%***===       ==#%@@%@%#*=     ==*********************************+= ==@@@@@@@@@@@#==                     
+         %=-%%%%%%%%%--#%%%%%%%%#--@   =#==%+%#***+=     =+#@@%%=%##*+=   =+**********************************+= =#@@@@@@@@@@@+=                      
+         @=-+%%%%%%%%#-*%%%%%%%%%--#   =*=#=#+@#****=====+%%@+#=*-#%**= ==+***********************************== =@@@@@@@@@@%+=                       
+         @%+##%=-=%%%%--%%%%%%%+--*@   =+%-----#%********%@%=-=-#-#%**===*************************************= =#@@@@@@@@#+==                        
+         @*--+--+@%%%%=-*%%%%*--+@     ==#=---=***********#=------%#**=+*************************************+= =#@@@@%*===                           
+        @*-*++%-+%%%%%#-+%%#--+%        =*+-+****************+----@***++*************************************=  =%@%#===                              
+       @+-#%++=-*-+##%%--%=-=@@         ==%********************+-=%***++**************************+*********==  =%#==                                 
+       +-%*%%--#%++--------*@            =*##********************%#***++*************************=+*********=   =+=        @@%###=-=%@                
+       %---+-=%     @@@+=+@             ==#%%#*********#%%%%%%#*******++************************==*********=    == @@%%##=------===--*@               
+        @--=%@                          ==+  +#*******%=   -%%#*******++**********************+===***###**+=      @+----==+%%%%%%%%%=--%@             
+       %*--%@                    @%%%@@ =*  # ******#    #* .%********++*********************+= +=#%-----%= @%*-%%%----%%%%%%%%%%%%%%%---%            
+     @%-----+@                  #------=++     ****-        .#********++********************+= @%---+%%----==-+%--*-*%--=%%%%%%%%%%%%%%#--#           
+     @=-%%%*-+@           @*==%@---=@@%=****+**#%#***+     +**%@%%#***++*******************+=  #-#%%**%#-------+@%--%%%*--#%%%%%%%%%%%%%%=-=%         
+      @==@ @%#*@@@      %*-=#------#@ =*****#%@@%#*********#%@@@@@@%**++******************==   #---+*=---%@@%-=+@+-+%%%%%=-+%%%%%%%%%%%%%%*--#@       
+       %-=@@=-------=++%=-#@#---@%#--=***%%@@@@%*********%%@@@*===#@%*=*******##%#******==-#+-==----=###==   @#-%--%%%%%%%+--#%%%%%%%%%%%#+=--+       
+       @#=#=-*-=%%%##+#-=#-#%--#    ++%@@%@@@@@%%*****%%@@@@@*:%# =@@++*****%*-----++%#=  *-++--=%=*****==     @+-*%%%%%%%%%--=%%#++=------+=-*       
+        @+--%%=-+%%%%%*-#%=*-=%     =**        *@@@@@@@@@@@@*=%  -*@%=****#+--+%%%*+----=+*#@#+=-%=*****==     %--%%%%%%%%%%%#-----+**%%%%%%-=@       
+       %=-+%%%%--%%%%%#-----#@      ==%        *@%@@@%@@@@@*+ -.=*@#=***#*--*%%%%%%%%%%#*=--=@*-#@=*****==    @*-*%%%%%%%%%%%+-=%%%%%%%%%%%=-#        
+     @#--*%%%%%*-=%%%%--#@%+-@       ==#.  -%@@%@@@@@@@@%#=- :=#@#++**##--+%%%%%%%%%%%%%*----%-+@ =+****==    @=-+%%%%%%%%%%%=-%%%%%%%%%%%#--@        
+    @+-=%%%%%%%%=-%%%%@%%%%*-=@       #=+%**#@@@@@@@@%#==+-+%@%*==**##--+%%%%%%%%%%%%%#--+%#-#+@  =+****==     @*--#%%%%%%%%*-+%%%%%%%%%%%+-%@        
+    @+-*%%%%%%%%#--%%%%%%%%%=-#         ===*#%*++++++=-%@@%=-#+ ==**#=----=##%%%%%%%#--=%%%#--%   =+****==       @=--%%%%%%%--%%%%%%%%%%%%-=%         
+     %=-%%%%%%%%%------+#%%%#--@            =========%=-#++@+-#==*####-+%%==----*%%--=%%%%%%--*   =+****==        @#--*%%%%#-*%%%%%%%%%%%+-*@         
+     @*-+%%%%%%*--%%%#===------*             ==*******#*-=%---*%*----%--%%%%%%%==---%%%%%%%%%-*@  =+****==          @+-=%%%--%%%%%%%%%%%%-=@          
+      @+-%%%%%=-=%%%%%%%%%%%+--@           ==+*******+=+%=-------=%#**+-+%%%%%%%%%-=%%%%%%%%%=-#==*%@%*===            #--**-=%%%%%#=------*           
+       %-=%%#--*%%%%%%%%%%%--+@           ==********==   @@@@=+-=-#*%%%-=%%%%%%%%%+-%%%%%%%%%=-+@@@@@@@%+=             %=-----------*%%%%@@           
+       @*-**--%%%%%%%%%%%#--%@          ==+*******==        =+#*------#--%%%%%%%%%+-=%%%%%%#--+%@@@@@@@@%+=             @%--*%%%@@@                   
+        %---+%%%%%%%%%%%=-=% ==+******+=+*******+==        =+***####+=+*-=%%%%%%%%%--%%%%#=-=#@@@%@@@@@@%+=                                           
+        @#------=++*%%%=-#@=+%@@@@@%#*********==:  ====  ==*******+==  %---=+#%%%%%+-%%#--=%%==++****++===                                            
+           @@@%##*=-----# =+@@@@@@@@@%******=====*#*****+=*******==     @%#*=----+*#--=-=%@      ===                                                  
+                    @@@@  =#@@@@@@@@@@#**+== =+%@@@@@@%********+==           @@%*+----=#@                       
+                          =+#@@%@@@@%#+===  ==%@@@@@@@@%*****+==                  @@%%@                                                               
+                            ==========      =#@@@@@@@@@@%**+==                                                                                        
+                                            ==+##%%%###+===                                                                                           
+                                                =====                                                                                                 
+                                                                                                                                                      
+                                                                                                                                                      
+
+```
+
+Created using https://itoa.hex.dance/

package/.github/workflows/ci-docker.yml

@@ -0,0 +1,36 @@
+name: Docker CI
+
+on:
+  pull_request:
+    branches: ['main']
+    paths: ['Dockerfile','cmd/**','docs/**','internal/**','go.*','.github/workflows/ci-docker.yml']
+
+env:
+  GHCR_IMAGE_NAME: ghcr.io/blinklabs-io/dingo
+
+permissions:
+  contents: read
+
+jobs:
+  docker:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: '0'
+      - name: qemu
+        uses: docker/setup-qemu-action@v3
+      - uses: docker/setup-buildx-action@v3
+      - id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.GHCR_IMAGE_NAME }}
+      - name: build
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: false
+          ### TODO: test multiple platforms
+          # platforms: linux/amd64,linux/arm64
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

package/.github/workflows/conventional-commits.yml

@@ -0,0 +1,17 @@
+# The below is pulled from upstream and slightly modified
+# https://github.com/webiny/action-conventional-commits/blob/master/README.md#usage
+
+name: Conventional Commits
+
+on:
+  pull_request:
+
+jobs:
+  build:
+    name: Conventional Commits
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: webiny/action-conventional-commits@v1.3.0

package/.github/workflows/go-test.yml

@@ -0,0 +1,29 @@
+name: go-test
+
+on:
+  push:
+    tags:
+      - v*
+    branches:
+      - main
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  go-test:
+    name: go-test
+    strategy:
+      matrix:
+        go-version: [1.23.x, 1.24.x]
+        # We want to make sure that this builds on Linux and Darwin
+        platform: [ubuntu-latest, macos-latest]
+    runs-on: ${{ matrix.platform }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version: ${{ matrix.go-version }}
+      - name: go-test
+        run: go test ./...

package/.github/workflows/golangci-lint.yml

@@ -0,0 +1,23 @@
+name: golangci-lint
+on:
+  push:
+    tags:
+      - v*
+    branches:
+      - main
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  golangci:
+    name: lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version: 1.23.x
+      - name: golangci-lint
+        uses: golangci/golangci-lint-action@v7

package/.github/workflows/publish.yml

@@ -0,0 +1,207 @@
+name: publish
+
+on:
+  push:
+    branches: ['main']
+    tags:
+      - 'v*.*.*'
+
+concurrency: ${{ github.ref }}
+
+env:
+  APPLICATION_NAME: 'dingo'
+
+jobs:
+  create-draft-release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      RELEASE_ID: ${{ steps.create-release.outputs.result }}
+    steps:
+      - run: "echo \"RELEASE_TAG=${GITHUB_REF#refs/tags/}\" >> $GITHUB_ENV"
+      - uses: actions/github-script@v7
+        id: create-release
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          result-encoding: string
+          script: |
+            try {
+              const response = await github.rest.repos.createRelease({
+                draft: true,
+                generate_release_notes: true,
+                name: process.env.RELEASE_TAG,
+                owner: context.repo.owner,
+                prerelease: false,
+                repo: context.repo.repo,
+                tag_name: process.env.RELEASE_TAG,
+              });
+
+              return response.data.id;
+            } catch (error) {
+              core.setFailed(error.message);
+            }
+
+  build-binaries:
+    strategy:
+      matrix:
+        include:
+          - runner: macos-latest
+            os: darwin
+            arch: arm64
+          - runner: ubuntu-latest
+            os: freebsd
+            arch: amd64
+          - runner: ubuntu-latest
+            os: freebsd
+            arch: arm64
+          - runner: ubuntu-latest
+            os: linux
+            arch: amd64
+          - runner: ubuntu-latest
+            os: linux
+            arch: arm64
+    runs-on: ${{ matrix.runner }}
+    needs: [create-draft-release]
+    permissions:
+      actions: write
+      attestations: write
+      checks: write
+      contents: write
+      id-token: write
+      packages: write
+      statuses: write
+    steps:
+      - name: Set RELEASE_TAG
+        run: "echo \"RELEASE_TAG=${GITHUB_REF#refs/tags/}\" >> $GITHUB_ENV"
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: '0'
+      - uses: actions/setup-go@v5
+        with:
+          go-version: 1.23.x
+      - name: Build binary
+        run: GOOS=${{ matrix.os }} GOARCH=${{ matrix.arch }} make build
+      - name: Upload release asset
+        if: startsWith(github.ref, 'refs/tags/')
+        run: |
+          _filename=${{ env.APPLICATION_NAME }}-${{ env.RELEASE_TAG }}-${{ matrix.os }}-${{ matrix.arch }}.tar.gz
+          if [[ "${{ matrix.os }}" != "darwin" ]]; then
+            tar czf ${_filename} ${{ env.APPLICATION_NAME }}
+          fi
+          if [[ "${{ matrix.os }}" == "darwin" ]]; then
+            _filename=${{ env.APPLICATION_NAME }}-${{ env.RELEASE_TAG }}-${{ matrix.os }}-${{ matrix.arch }}.zip
+            zip -r ${_filename} ${{ env.APPLICATION_NAME }}
+          fi
+          curl \
+            -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+            -H "Content-Type: application/octet-stream" \
+            --data-binary @${_filename} \
+            https://uploads.github.com/repos/${{ github.repository_owner }}/${{ env.APPLICATION_NAME }}/releases/${{ needs.create-draft-release.outputs.RELEASE_ID }}/assets?name=${_filename}
+      - name: Attest binary
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-path: '${{ env.APPLICATION_NAME }}'
+
+  build-images:
+    runs-on: ubuntu-latest
+    needs: [create-draft-release]
+    permissions:
+      actions: write
+      attestations: write
+      checks: write
+      contents: write
+      id-token: write
+      packages: write
+      statuses: write
+    steps:
+      - run: "echo \"RELEASE_TAG=${GITHUB_REF#refs/tags/}\" >> $GITHUB_ENV"
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: '0'
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: blinklabs
+          password: ${{ secrets.DOCKER_PASSWORD }} # uses token
+      - name: Login to GHCR
+        uses: docker/login-action@v3
+        with:
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+          registry: ghcr.io
+      - id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            blinklabs/dingo
+            ghcr.io/${{ github.repository }}
+          tags: |
+            # Only version, no revision
+            type=match,pattern=v(.*)-(.*),group=1
+            # branch
+            type=ref,event=branch
+            # semver
+            type=semver,pattern={{version}}
+      - name: Build images
+        id: push
+        uses: docker/build-push-action@v6
+        with:
+          outputs: "type=registry,push=true"
+          platforms: linux/amd64,linux/arm64
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+      - name: Attest Docker Hub image
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-name: index.docker.io/blinklabs/dingo
+          subject-digest: ${{ steps.push.outputs.digest }}
+          push-to-registry: true
+      - name: Attest GHCR image
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-name: ghcr.io/${{ github.repository }}
+          subject-digest: ${{ steps.push.outputs.digest }}
+          push-to-registry: true
+      # Update Docker Hub from README
+      - name: Docker Hub Description
+        uses: peter-evans/dockerhub-description@v4
+        with:
+          username: blinklabs
+          password: ${{ secrets.DOCKER_PASSWORD }}
+          repository: blinklabs/${{ env.APPLICATION_NAME }}
+          readme-filepath: ./README.md
+          short-description: "Dingo is a Cardano blockchain data node"
+
+  finalize-release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    needs: [create-draft-release, build-binaries, build-images]
+    steps:
+      - uses: actions/github-script@v7
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            try {
+              await github.rest.repos.updateRelease({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                release_id: ${{ needs.create-draft-release.outputs.RELEASE_ID }},
+                draft: false,
+              });
+            } catch (error) {
+              core.setFailed(error.message);
+            }
+
+      # This updates the documentation on pkg.go.dev and the latest version available via the Go module proxy
+      - name: Pull new module version
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: andrewslotin/go-proxy-pull-action@v1.3.0

package/.golangci.yml

@@ -0,0 +1,71 @@
+version: "2"
+run:
+  issues-exit-code: 1
+  tests: false
+linters:
+  enable:
+    - asasalint
+    - asciicheck
+    - bidichk
+    - bodyclose
+    - contextcheck
+    - copyloopvar
+    - durationcheck
+    - errchkjson
+    - errorlint
+    - exhaustive
+    - fatcontext
+    - gocheckcompilerdirectives
+    - gochecksumtype
+    - gomodguard
+    - gosec
+    - gosmopolitan
+    - loggercheck
+    - makezero
+    - musttag
+    - nilerr
+    - nilnesserr
+    - noctx
+    - perfsprint
+    - prealloc
+    - protogetter
+    - reassign
+    - recvcheck
+    - rowserrcheck
+    - spancheck
+    - sqlclosecheck
+    - testifylint
+    - unparam
+    - usestdlibvars
+    - whitespace
+    - zerologlint
+  disable:
+    - depguard
+  exclusions:
+    generated: lax
+    presets:
+      - comments
+      - common-false-positives
+      - legacy
+      - std-error-handling
+    paths:
+      - docs
+      - third_party$
+      - builtin$
+      - examples$
+issues:
+  max-issues-per-linter: 0
+  max-same-issues: 0
+formatters:
+  enable:
+    - gci
+    - gofmt
+    - gofumpt
+    - goimports
+  exclusions:
+    generated: lax
+    paths:
+      - docs
+      - third_party$
+      - builtin$
+      - examples$

package/Dockerfile

@@ -0,0 +1,25 @@
+FROM ghcr.io/blinklabs-io/go:1.24.2-1 AS build
+
+WORKDIR /code
+COPY go.* .
+RUN go mod download
+COPY . .
+RUN make build
+
+FROM ghcr.io/blinklabs-io/cardano-configs:20250213-1 AS cardano-configs
+FROM ghcr.io/blinklabs-io/txtop:0.12.3 AS txtop
+
+FROM debian:bookworm-slim AS dingo
+COPY --from=build /code/dingo /bin/
+COPY --from=cardano-configs /config/ /opt/cardano/config/
+COPY --from=txtop /bin/txtop /usr/local/bin/
+ENV CARDANO_CONFIG=/opt/cardano/config/preview/config.json
+ENV CARDANO_NETWORK=preview
+# Create database dir owned by container user
+VOLUME /data/db
+ENV CARDANO_DATABASE_PATH=/data/db
+# Create socket dir owned by container user
+VOLUME /ipc
+ENV CARDANO_NODE_SOCKET_PATH=/ipc/dingo.socket
+ENV CARDANO_SOCKET_PATH=/ipc/dingo.socket
+ENTRYPOINT ["dingo"]