Sync libp2p PR with upstream

.github/workflows/ci.yml

@@ -7,15 +7,15 @@ on:
   release:
 
 env:
-  go-version: 1.18
+  go-version: 1.23
 
 jobs:
   check-copyright:
     name: Copyright
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: Authors
@@ -26,20 +26,20 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Check vanity import
         run: .scripts/check-vanity-imports.sh $GITHUB_WORKSPACE
 
       - name: Setup Go
-        uses: actions/setup-go@v2
+        uses: actions/setup-go@v4
         with:
           go-version: ${{ env.go-version }}
 
       - name: golangci-lint
-        uses: golangci/golangci-lint-action@v3
+        uses: golangci/golangci-lint-action@v7
         with:
-          version: v1.45
+          version: v2.1
 
       - name: Lint proto files
         uses: plexsystems/protolint-action@v0.6.0

.golangci.json

@@ -0,0 +1,103 @@
+{
+  "formatters": {
+    "enable": [
+      "gofmt",
+      "gofumpt",
+      "goimports"
+    ],
+    "exclusions": {
+      "generated": "lax",
+      "paths": [
+        "third_party$",
+        "builtin$",
+        "examples$"
+      ]
+    }
+  },
+  "linters": {
+    "default": "all",
+    "disable": [
+      "err113",
+      "errorlint",
+      "gochecknoglobals",
+      "gochecknoinits",
+      "ireturn",
+      "lll",
+      "nlreturn",
+      "paralleltest",
+      "promlinter",
+      "tparallel",
+      "varnamelen",
+      "wrapcheck",
+      "wsl",
+      "testifylint",
+      "revive",
+      "recvcheck",
+      "prealloc",
+      "depguard",
+      "nonamedreturns",
+      "inamedparam",
+      "exhaustruct"
+    ],
+    "exclusions": {
+      "generated": "lax",
+      "paths": [
+        "third_party$",
+        "builtin$",
+        "examples$"
+      ],
+      "presets": [
+        "common-false-positives",
+        "legacy",
+        "std-error-handling"
+      ],
+      "rules": [
+        {
+          "linters": [
+            "err113",
+            "forcetypeassert",
+            "funlen"
+          ],
+          "path": "test"
+        },
+        {
+          "linters": [
+            "revive"
+          ],
+          "path": "test",
+          "text": "context-as-argument"
+        }
+      ]
+    },
+    "settings": {
+      "cyclop": {
+        "max-complexity": 15
+      },
+      "forbidigo": {
+        "forbid": [
+          {
+            "pattern": "^[Ee]quals$"
+          },
+          {
+            "pattern": "^print.*$"
+          },
+          {
+            "pattern": "fmt\\.Print.*"
+          }
+        ]
+      },
+      "goheader": {
+        "template-path": ".scripts/copyright-notice",
+        "values": {
+          "regexp": {
+            "ANY_YEAR": "20(19|2\\d)"
+          }
+        }
+      }
+    }
+  },
+  "run": {
+    "modules-download-mode": "readonly"
+  },
+  "version": "2"
+}

CHANGELOG.md

@@ -4,16 +4,53 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.14.1] Narvi - 2025-10-02
+Extended the testing framework with more robust tests for payment and virtual channels.  
+Added documentation for cross-chain backend integration and backend ID mapping.
+
+
+### Added
+
+* Documentation section describing supported backends and their IDs.
+
+### Changed
+
+* Extended Perun testing framework with improved payment and virtual channel tests. [#423]
+
+[#423]: https://github.com/hyperledger-labs/go-perun/pull/423
+
+## [0.14.0] Narvi - 2025-07-29 [:boom:]
+Added [Libp2p](https://libp2p.io/) wire for go-perun. This enables seamless and secure P2P connection between clients.
+
+### Added :boom:
+
+* Wire implementation with libp2p [#420]
+
+### Fixed
+* Removed test backend signature from `authMsg` of exchange address protocol [#422] 
+
+### Changed
+
+* Updade action cache [#420]
+
+* Update workflow go version to 1.23 [#420]
+
+* Update workflow go linter to 2.1 [#420]
+
+[#420]: https://github.com/hyperledger-labs/go-perun/pull/420
+[#422]: https://github.com/hyperledger-labs/go-perun/pull/422
+
+
 ## [0.13.0] Metis - 2025-01-19 [:boom:]
 Support for multiple backends, allowing multiple address implementations per client. This enables the simultaneous use of several smaller backends, enhancing modularization.
 
-## Added :boom:
+### Added :boom:
 
 * Backend field in Allocation [#410]
 
 * Added interface restrictions to ensure cross-contract compatibility, including new functions and fields in interfaces such as Asset and Address [#410]
 
-## Changed
+### Changed
 
 * Updade action cache [#409]
 
@@ -31,53 +68,53 @@ Support for multiple backends, allowing multiple address implementations per cli
 [#410]: https://github.com/hyperledger-labs/go-perun/pull/410
 [#413]: https://github.com/hyperledger-labs/go-perun/pull/413
 
-## Legend
+### Legend
 - <span id="breaking">:boom:</span> This is a breaking change, e.g., it changes the external API.
 
 [:boom:]: #breaking
 
 ## [0.12.0] Leda - 2024-11-19 [:boom:]
 Flexibility in funding for payment channels and basic Layer-2 security.
 
-## Added :boom:
+### Added :boom:
 
 * Egoistic funding allows users to wait for their peers to fund before they fund themselves. This change has to be adopted by the Perun backends to be usable ([in case of Ethereum](https://github.com/hyperledger-labs/perun-eth-backend/pull/45)): [#397 ]
 
 * Wire authentication for Layer2 communication between Perun clients, using TLS: [#402] :boom:
 
 * Support for Stellar backend in README: [#408]
 
-## Changed
+### Changed
 * Update go to 1.22: [#406 ]
 
 [#397]: https://github.com/hyperledger-labs/go-perun/pull/397
 [#406]: https://github.com/hyperledger-labs/go-perun/pull/406
 [#402]: https://github.com/hyperledger-labs/go-perun/pull/402
 [#408]: https://github.com/hyperledger-labs/go-perun/pull/408
 
-## Legend
+### Legend
 - <span id="breaking">:boom:</span> This is a breaking change, e.g., it changes the external API.
 
 [:boom:]: #breaking
 
 ## [0.11.0] Kiviuq - 2024-02-21 [:boom:]
 Exposure of protobuf converters & `SignedState`, abstraction of tests and bug fixes.
 
-## Added
+### Added
 - Add Fabric to backend list in README: [#377]
 - Create new type `TransparentChannel` to expose `SignedState`: [#389]
 - Update backend compatibility list in README: [#392]
 - Add MAINTAINERS.md file, Update NOTICE: [#394]
 
-## Fixed 
+### Fixed 
 - Fix sub-channel test: [#359]
 - Fix Multi-Adjudicator Subscription: [#366]
 - Use correct identity for client tests: [#376]
 - Fix link to white paper in README: [#379]
 - Fix linter copyright year checking in CI: [#389]
 - Fix failing unit tests: [#399]
 
-## Changed [:boom:]
+### Changed [:boom:]
 - Abstract multiledger test, making it usable by backends: [#355]
 - Abstract fund recovery test, making it usable by backends: [#370]
 - Abstract virtual channel test, making it usable by backends: [#375]
@@ -488,6 +525,9 @@ Initial release.
 [:boom:]: #breaking
 
 [Unreleased]: https://github.com/hyperledger-labs/go-perun/compare/v0.11.0...HEAD
+[0.14.0]: https://github.com/hyperledger-labs/go-perun/compare/v0.13.0...v0.14.0
+[0.13.0]: https://github.com/hyperledger-labs/go-perun/compare/v0.12.0...v0.13.0
+[0.12.0]: https://github.com/hyperledger-labs/go-perun/compare/v0.11.0...v0.12.0
 [0.11.0]: https://github.com/hyperledger-labs/go-perun/compare/v0.10.0...v0.11.0
 [0.10.0]: https://github.com/hyperledger-labs/go-perun/compare/v0.9.1...v0.10.0
 [0.9.1]: https://github.com/hyperledger-labs/go-perun/compare/v0.9.0...v0.9.1

README.md

@@ -70,16 +70,26 @@ The following features are planned for future releases:
 
 ### Backends
 
-There are multiple **blockchain backends** available. A backend is automatically initialized when its top-level package `backend/<name>` is imported.
-- **Ethereum.** The Ethereum backend is available at [perun-eth-backend](https://github.com/perun-network/perun-eth-backend/).
-- **Polkadot.** The Polkadot backend is available at [perun-polkadot-backend](https://github.com/perun-network/perun-polkadot-backend).
-- **Cosmos.** The Cosmos backend is available at [perun-cosmwasm-backend](https://github.com/hyperledger-labs/perun-cosmwasm-backend).
-- **Cardano.** The Cardano backend is available at [perun-cardano-backend](https://github.com/perun-network/perun-cardano-backend).
-- **NERVOS.** The NERVOS backend is available at [perun-ckb-backend](https://github.com/perun-network/perun-ckb-backend).
-- **Dfinity.** The Dfinity Internet Computer backend is available at [perun-icp-backend](https://github.com/perun-network/perun-icp-backend).
-- **Stellar.** The Stellar backend is available at [perun-stellar-backend](https://github.com/perun-network/perun-stellar-backend).
-- **Fabric.** The Hyperledger Fabric backend is available at [perun-fabric](https://github.com/perun-network/perun-fabric).
-- **SimBackend.** The SimBackend represents an ideal blockchain backend (`backend/sim`) implementation that can be used for testing.
+ _go-perun_ supports multiple **blockchain backends**. A backend is automatically initialized when its top-level package `backend/<name>` is imported.#### Backend Map
+
+| ID  | Backend    | Payment Channel Status | Cross-Chain Status | Repository                                                                           |
+| --- | ---------- | ---------------------- | ------------------ | ------------------------------------------------------------------------------------ |
+| 0   | SimBackend | 🧪 Testing only         | 🧪 Testing only     | Built-in (`backend/sim`) – represents an ideal blockchain backend for simulation     |
+| 1   | Ethereum   | ✅ Supported            | ✅ Supported        | [perun-eth-backend](https://github.com/perun-network/perun-eth-backend/)             |
+| 2   | Stellar    | ✅ Supported            | ✅ Supported        | [perun-stellar-backend](https://github.com/perun-network/perun-stellar-backend)      |
+| 3   | Nervos     | ✅ Supported            | 🚧 In development   | [perun-ckb-backend](https://github.com/perun-network/perun-ckb-backend)              |
+| 4   | Polkadot   | ✅ Supported            | 🚧 In development   | [perun-polkadot-backend](https://github.com/perun-network/perun-polkadot-backend)    |
+| 5   | Dfinity    | ✅ Supported            | 🚧 In development   | [perun-icp-backend](https://github.com/perun-network/perun-icp-backend)              |
+| 6   | Solana     | 🚧 In development       | 🚧 In development   | [perun-solana-backend](https://github.com/perun-network/perun-solana-backend)        |
+| -   | Cosmos     | ✅ Supported            | 🟡 Single-chain     | [perun-cosmwasm-backend](https://github.com/hyperledger-labs/perun-cosmwasm-backend) |
+| -   | Cardano    | ✅ Supported            | 🟡 Single-chain     | [perun-cardano-backend](https://github.com/perun-network/perun-cardano-backend)      |
+| -   | Fabric     | ✅ Supported            | 🟡 Single-chain     | [perun-fabric](https://github.com/perun-network/perun-fabric)                        |
+
+#### Legend
+- ✅ **Supported** – stable and available.  
+- 🚧 **In development** – actively worked on, not fully stable.  
+- 🟡 **Single-chain** – supports only local (non-cross-chain) payment/state channels.  
+- 🧪 **Testing only** – simulation backend, no real blockchain. 
 
 **Logging and networking** capabilities can also be injected by the user.
 A default [logrus](https://github.com/sirupsen/logrus) implementation of the `log.Logger` interface can be set using `log/logrus.Set`.