Merge branch 'main' into nervos_ckb

Author: NhoxxKienn

.github/workflows/ci.yml

@@ -7,7 +7,7 @@ on:
   release:
 
 env:
-  go-version: 1.17
+  go-version: 1.18
 
 jobs:
   check-copyright:
@@ -39,7 +39,7 @@ jobs:
       - name: golangci-lint
         uses: golangci/golangci-lint-action@v3
         with:
-          version: v1.43
+          version: v1.45
 
       - name: Lint proto files
         uses: plexsystems/protolint-action@v0.6.0

.golangci.yml

@@ -54,7 +54,8 @@ linters-settings:
       # Default values:
       - ^print.*$
       - 'fmt\.Print.*'
-
+    exclude-rules:
+      - path: ".*\\.pb\\.go$" # Exclude protobuf generated files.
 issues:
   # Re-enable default excludes.
   include:

CHANGELOG.md

@@ -4,6 +4,38 @@ 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.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:
+
+* 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
+
+* Updade action cache [#409]
+
+* Update workflow go version to 1.18 [#410]
+
+* Global Backend map in wire and wallet module [#410]
+
+* Global Randomizer map in wallet and channel tests [#410]
+
+* Participant map to allow multiple addresses per participant [#410] :boom:
+
+* Code refactoring from channel ID map to singular channel ID [#413]
+
+[#409]: https://github.com/hyperledger-labs/go-perun/pull/409
+[#410]: https://github.com/hyperledger-labs/go-perun/pull/410
+[#413]: https://github.com/hyperledger-labs/go-perun/pull/413
+
+## 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.
 

apps/payment/app_internal_test.go

@@ -1,4 +1,4 @@
-// Copyright 2019 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -27,7 +27,7 @@ import (
 
 func TestApp_Def(t *testing.T) {
 	rng := pkgtest.Prng(t)
-	def := test.NewRandomAppID(rng)
+	def := test.NewRandomAppID(rng, channel.TestBackendID)
 	app := &App{def}
 	assert.True(t, app.Def().Equal(app.Def()))
 }

apps/payment/randomizer.go

@@ -1,4 +1,4 @@
-// Copyright 2019 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,8 @@ package payment
 import (
 	"math/rand"
 
+	"perun.network/go-perun/wallet"
+
 	"perun.network/go-perun/channel"
 	"perun.network/go-perun/channel/test"
 )
@@ -27,8 +29,8 @@ type Randomizer struct{}
 var _ test.AppRandomizer = (*Randomizer)(nil)
 
 // NewRandomApp always returns a payment app with a different address.
-func (*Randomizer) NewRandomApp(rng *rand.Rand) channel.App {
-	return &App{test.NewRandomAppID(rng)}
+func (*Randomizer) NewRandomApp(rng *rand.Rand, bID wallet.BackendID) channel.App {
+	return &App{test.NewRandomAppID(rng, bID)}
 }
 
 // NewRandomData returns NoData because a PaymentApp does not have data.

apps/payment/randomizer_internal_test.go

@@ -1,4 +1,4 @@
-// Copyright 2019 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -28,7 +28,7 @@ func TestRandomizer(t *testing.T) {
 	rng := pkgtest.Prng(t)
 
 	r := new(Randomizer)
-	app := r.NewRandomApp(rng)
+	app := r.NewRandomApp(rng, channel.TestBackendID)
 	channel.RegisterApp(app)
 	regApp, err := channel.Resolve(app.Def())
 	assert.NoError(t, err)

apps/payment/resolver_internal_test.go

@@ -1,4 +1,4 @@
-// Copyright 2019 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -32,7 +32,7 @@ func TestResolver(t *testing.T) {
 	rng := pkgtest.Prng(t)
 	assert, require := assert.New(t), require.New(t)
 
-	def := ctest.NewRandomAppID(rng)
+	def := ctest.NewRandomAppID(rng, channel.TestBackendID)
 	channel.RegisterAppResolver(def.Equal, &Resolver{})
 
 	app, err := channel.Resolve(def)

backend/sim/channel/app.go

@@ -1,4 +1,4 @@
-// Copyright 2022 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -48,5 +48,5 @@ func (id AppID) Key() channel.AppIDKey {
 // NewRandomAppID generates a new random app identifier.
 func NewRandomAppID(rng *rand.Rand) AppID {
 	addr := wallet.NewRandomAddress(rng)
-	return AppID{addr}
+	return AppID{Address: addr}
 }

backend/sim/channel/asset.go

@@ -1,4 +1,4 @@
-// Copyright 2019 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -65,3 +65,9 @@ func (a Asset) Equal(b channel.Asset) bool {
 	}
 	return a.ID == simAsset.ID
 }
+
+// Address returns the address of the asset.
+func (a Asset) Address() []byte {
+	data, _ := a.MarshalBinary()
+	return data
+}

backend/sim/channel/backend.go

@@ -1,4 +1,4 @@
-// Copyright 2019 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -33,23 +33,22 @@ type backend struct{}
 var _ channel.Backend = new(backend)
 
 // CalcID calculates a channel's ID by hashing all fields of its parameters.
-func (*backend) CalcID(p *channel.Params) (id channel.ID) {
+func (*backend) CalcID(p *channel.Params) (id channel.ID, err error) {
 	w := sha256.New()
 
 	// Write Parts
-	for _, addr := range p.Parts {
-		if err := perunio.Encode(w, addr); err != nil {
-			log.Panic("Could not write to sha256 hasher")
-		}
+	if err := perunio.Encode(w, wallet.AddressMapArray{Addr: p.Parts}); err != nil {
+		log.Panic("Could not write to sha256 hasher")
 	}
 
-	err := perunio.Encode(w, p.Nonce, p.ChallengeDuration, channel.OptAppEnc{App: p.App}, p.LedgerChannel, p.VirtualChannel)
+	err = perunio.Encode(w, p.Nonce, p.ChallengeDuration, channel.OptAppEnc{App: p.App}, p.LedgerChannel, p.VirtualChannel)
 	if err != nil {
-		log.Panic("Could not write to sha256 hasher")
+		return
 	}
 
 	if copy(id[:], w.Sum(nil)) != channel.IDLen {
-		log.Panic("Could not copy id")
+		err = errors.New("Could not copy id")
+		return
 	}
 	return
 }
@@ -83,7 +82,7 @@ func (b *backend) NewAsset() channel.Asset {
 
 // NewAppID returns an object of type AppID, which can be used for
 // unmarshalling an app identifier from its binary representation.
-func (b *backend) NewAppID() channel.AppID {
+func (b *backend) NewAppID() (channel.AppID, error) {
 	addr := &simwallet.Address{}
-	return AppID{addr}
+	return AppID{addr}, nil
 }

backend/sim/channel/channel_internal_test.go

@@ -1,4 +1,4 @@
-// Copyright 2019 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,8 @@ package channel
 import (
 	"testing"
 
+	"perun.network/go-perun/channel"
+
 	chtest "perun.network/go-perun/channel/test"
 	"perun.network/go-perun/wallet"
 	wtest "perun.network/go-perun/wallet/test"
@@ -36,11 +38,13 @@ func newChannelSetup(t *testing.T) *chtest.Setup {
 	params2, state2 := chtest.NewRandomParamsAndState(rng, chtest.WithIsFinal(!state.IsFinal), chtest.WithNumLocked(int(rng.Int31n(4)+1)))
 
 	return &chtest.Setup{
-		Params:        params,
-		Params2:       params2,
-		State:         state,
-		State2:        state2,
-		Account:       wtest.NewRandomAccount(rng),
-		RandomAddress: func() wallet.Address { return wtest.NewRandomAddress(rng) },
+		Params:  params,
+		Params2: params2,
+		State:   state,
+		State2:  state2,
+		Account: wtest.NewRandomAccount(rng, channel.TestBackendID),
+		RandomAddress: func() map[wallet.BackendID]wallet.Address {
+			return wtest.NewRandomAddresses(rng, channel.TestBackendID)
+		},
 	}
 }

backend/sim/channel/init.go

@@ -1,4 +1,4 @@
-// Copyright 2019 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -22,9 +22,9 @@ import (
 )
 
 func init() {
-	channel.SetBackend(new(backend))
-	test.SetRandomizer(new(randomizer))
+	channel.SetBackend(new(backend), channel.TestBackendID)
+	test.SetRandomizer(new(randomizer), channel.TestBackendID)
 	test.SetNewRandomAppID(func(r *rand.Rand) channel.AppID {
 		return NewRandomAppID(r)
-	})
+	}, channel.TestBackendID)
 }

backend/sim/wallet/account.go

@@ -1,4 +1,4 @@
-// Copyright 2019 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -57,7 +57,7 @@ func NewRandomAccount(rng io.Reader) *Account {
 
 // Address returns the address of this account.
 func (a *Account) Address() wallet.Address {
-	return wallet.Address((*Address)(&a.privKey.PublicKey))
+	return (*Address)(&a.privKey.PublicKey)
 }
 
 // SignData is used to sign data with this account. If the account is locked,

backend/sim/wallet/address.go

@@ -1,4 +1,4 @@
-// Copyright 2019 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -20,13 +20,20 @@ import (
 	"io"
 	"math/big"
 
+	"perun.network/go-perun/channel"
+
 	"perun.network/go-perun/log"
 	"perun.network/go-perun/wallet"
 )
 
 // Address represents a simulated address.
 type Address ecdsa.PublicKey
 
+// BackendID returns the backend id of the address.
+func (a Address) BackendID() wallet.BackendID {
+	return channel.TestBackendID
+}
+
 const (
 	// elemLen is the length of the binary representation of a single element
 	// of the address in bytes.
@@ -54,6 +61,21 @@ func NewRandomAddress(rng io.Reader) *Address {
 	}
 }
 
+// NewRandomAddresses creates a new address using the randomness
+// provided by rng.
+func NewRandomAddresses(rng io.Reader) map[wallet.BackendID]wallet.Address {
+	privateKey, err := ecdsa.GenerateKey(curve, rng)
+	if err != nil {
+		log.Panicf("Creation of account failed with error", err)
+	}
+
+	return map[wallet.BackendID]wallet.Address{channel.TestBackendID: &Address{
+		Curve: privateKey.Curve,
+		X:     privateKey.X,
+		Y:     privateKey.Y,
+	}}
+}
+
 // Bytes converts this address to bytes.
 func (a *Address) Bytes() []byte {
 	data := a.byteArray()
@@ -90,9 +112,11 @@ func (a *Address) Equal(addr wallet.Address) bool {
 }
 
 // Cmp checks the ordering of two addresses according to following definition:
-//   -1 if (a.X <  addr.X) || ((a.X == addr.X) && (a.Y < addr.Y))
-//    0 if (a.X == addr.X) && (a.Y == addr.Y)
-//   +1 if (a.X >  addr.X) || ((a.X == addr.X) && (a.Y > addr.Y))
+//
+//	-1 if (a.X <  addr.X) || ((a.X == addr.X) && (a.Y < addr.Y))
+//	 0 if (a.X == addr.X) && (a.Y == addr.Y)
+//	+1 if (a.X >  addr.X) || ((a.X == addr.X) && (a.Y > addr.Y))
+//
 // So the X coordinate is weighted higher.
 // Pancis if the passed address is of the wrong type.
 func (a *Address) Cmp(addr wallet.Address) int {

backend/sim/wallet/init.go

@@ -1,4 +1,4 @@
-// Copyright 2019 - See NOTICE file for copyright holders.
+// Copyright 2025 - See NOTICE file for copyright holders.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -15,11 +15,12 @@
 package wallet
 
 import (
+	"perun.network/go-perun/channel"
 	"perun.network/go-perun/wallet"
 	"perun.network/go-perun/wallet/test"
 )
 
 func init() {
-	wallet.SetBackend(new(Backend))
-	test.SetRandomizer(newRandomizer())
+	wallet.SetBackend(new(Backend), channel.TestBackendID)
+	test.SetRandomizer(newRandomizer(), channel.TestBackendID)
 }