chore: adding router v2

modules/core/api/api_test.go

@@ -0,0 +1,14 @@
+package api_test
+
+import (
+	testifysuite "github.com/stretchr/testify/suite"
+	"testing"
+)
+
+type ApiTestSuite struct {
+	testifysuite.Suite
+}
+
+func TestApiTestSuite(t *testing.T) {
+	testifysuite.Run(t, new(ApiTestSuite))
+}

modules/core/api/router.go

@@ -0,0 +1,68 @@
+package api
+
+import (
+	"errors"
+	"fmt"
+	sdk "github.com/cosmos/cosmos-sdk/types"
+	"strings"
+)
+
+// Router contains all the module-defined callbacks required by IBC Protocol V2.
+type Router struct {
+	routes map[string]IBCModule
+}
+
+// NewRouter creates a new Router instance.
+func NewRouter() *Router {
+	return &Router{
+		routes: make(map[string]IBCModule),
+	}
+}
+
+// AddRoute registers a route for a given module name.
+func (rtr *Router) AddRoute(module string, cbs IBCModule) *Router {
+	if !sdk.IsAlphaNumeric(module) {
+		panic(errors.New("route expressions can only contain alphanumeric characters"))
+	}
+
+	if rtr.HasRoute(module) {
+		panic(errors.New(fmt.Sprintf("route %s has already been registered", module)))
+	}
+
+	rtr.routes[module] = cbs
+
+	return rtr
+}
+
+// Route returns the IBCModule for a given module name.
+func (rtr *Router) Route(module string) IBCModule {
+	route, ok := rtr.routeOrPrefixedRoute(module)
+	if !ok {
+		panic(fmt.Sprintf("no route for %s", module))
+	}
+	return route
+}
+
+// HasRoute returns true if the Router has a module registered or false otherwise.
+func (rtr *Router) HasRoute(module string) bool {
+	_, ok := rtr.routeOrPrefixedRoute(module)
+	return ok
+}
+
+// routeOrPrefixedRoute returns the IBCModule for a given module name.
+// if an exact match is not found, a route with the provided prefix is searched for instead.
+func (rtr *Router) routeOrPrefixedRoute(module string) (IBCModule, bool) {
+	route, ok := rtr.routes[module]
+	if ok {
+		return route, true
+	}
+
+	// it's possible that some routes have been dynamically added e.g. with interchain accounts.
+	// in this case, we need to check if the module has the specified prefix.
+	for prefix := range rtr.routes {
+		if strings.HasPrefix(module, prefix) {
+			return rtr.routes[prefix], true
+		}
+	}
+	return nil, false
+}

modules/core/api/router_test.go

@@ -0,0 +1,81 @@
+package api_test
+
+import (
+	"github.com/cosmos/ibc-go/v9/modules/core/api"
+	mockv2 "github.com/cosmos/ibc-go/v9/testing/mock/v2"
+)
+
+func (suite *ApiTestSuite) TestRouteer() {
+	var router *api.Router
+
+	var testCases = []struct {
+		name        string
+		malleate    func()
+		assertionFn func()
+	}{
+		{
+			name: "success",
+			malleate: func() {
+				router.AddRoute("module01", &mockv2.IBCModule{})
+			},
+			assertionFn: func() {
+				suite.Require().True(router.HasRoute("module01"))
+			},
+		},
+		{
+			name: "success: multiple modules",
+			malleate: func() {
+				router.AddRoute("module01", &mockv2.IBCModule{})
+				router.AddRoute("module02", &mockv2.IBCModule{})
+				router.AddRoute("module03", &mockv2.IBCModule{})
+			},
+			assertionFn: func() {
+				suite.Require().True(router.HasRoute("module01"))
+				suite.Require().True(router.HasRoute("module02"))
+				suite.Require().True(router.HasRoute("module03"))
+			},
+		},
+		{
+			name: "success: find by prefix",
+			malleate: func() {
+				router.AddRoute("module01", &mockv2.IBCModule{})
+			},
+			assertionFn: func() {
+				suite.Require().True(router.HasRoute("module01-foo"))
+			},
+		},
+		{
+			name: "failure: panics on duplicate module",
+			malleate: func() {
+				router.AddRoute("module01", &mockv2.IBCModule{})
+			},
+			assertionFn: func() {
+				suite.Require().PanicsWithError("route module01 has already been registered", func() {
+					router.AddRoute("module01", &mockv2.IBCModule{})
+				})
+			},
+		},
+		{
+			name: "failure: panics invalid-name",
+			malleate: func() {
+				router.AddRoute("module01", &mockv2.IBCModule{})
+			},
+			assertionFn: func() {
+				suite.Require().PanicsWithError("route expressions can only contain alphanumeric characters", func() {
+					router.AddRoute("module-02", &mockv2.IBCModule{})
+				})
+			},
+		},
+	}
+	for _, tc := range testCases {
+		tc := tc
+
+		suite.Run(tc.name, func() {
+			router = api.NewRouter()
+
+			tc.malleate()
+
+			tc.assertionFn()
+		})
+	}
+}

testing/mock/v2/ibc_module.go

@@ -0,0 +1,16 @@
+package mock
+
+import (
+	"context"
+	sdk "github.com/cosmos/cosmos-sdk/types"
+	channeltypesv2 "github.com/cosmos/ibc-go/v9/modules/core/04-channel/v2/types"
+	"github.com/cosmos/ibc-go/v9/modules/core/api"
+)
+
+var _ api.IBCModule = (*IBCModule)(nil)
+
+type IBCModule struct{}
+
+func (I IBCModule) OnSendPacket(ctx context.Context, sourceID string, destinationID string, sequence uint64, data channeltypesv2.PacketData, signer sdk.AccAddress) error {
+	panic("implement me")
+}