feat(orm): add module db (#10991)

## Description

This PR adds a `ModuleDB` interface which can be used directly by Cosmos SDK modules. A simplified bank example with Mint/Send/Burn functionality against Balance and Supply tables is included in the tests.

This PR also:
* adds simplified `Get` and `Has` methods to `Table` which use the primary key values in the message instead of `...interface{}`
* adds a stable deterministic proto JSON marshaler and updates the `Entry.String` methods to use it because the golden tests are not deterministic without this. This code is currently internal but can be extracted to a public `codec` or `cosmos-proto` package eventually.

---

### Author Checklist

*All items are required. Please add a note to the item if the item is not applicable and
please add links to any relevant follow up issues.*

I have...

- [ ] included the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title
- [ ] added `!` to the type prefix if API or client breaking change
- [ ] targeted the correct branch (see [PR Targeting](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#pr-targeting))
- [ ] provided a link to the relevant issue or specification
- [ ] followed the guidelines for [building modules](https://github.com/cosmos/cosmos-sdk/blob/master/docs/building-modules)
- [ ] included the necessary unit and integration [tests](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#testing)
- [ ] added a changelog entry to `CHANGELOG.md`
- [ ] included comments for [documenting Go code](https://blog.golang.org/godoc)
- [ ] updated the relevant documentation or specification
- [ ] reviewed "Files changed" and left comments if necessary
- [ ] confirmed all CI checks have passed

### Reviewers Checklist

*All items are required. Please add a note if the item is not applicable and please add
your handle next to the items reviewed if you only reviewed selected items.*

I have...

- [ ] confirmed the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title
- [ ] confirmed `!` in the type prefix if API or client breaking change
- [ ] confirmed all author checklist items have been addressed 
- [ ] reviewed state machine logic
- [ ] reviewed API design and naming
- [ ] reviewed documentation is accurate
- [ ] reviewed tests and test coverage
- [ ] manually tested (if applicable)

orm/encoding/ormkv/entry.go

@@ -4,10 +4,10 @@ import (
 	"fmt"
 	"strings"
 
-	"google.golang.org/protobuf/encoding/protojson"
+	"github.com/cosmos/cosmos-sdk/orm/internal/stablejson"
+
 	"google.golang.org/protobuf/proto"
 	"google.golang.org/protobuf/reflect/protoreflect"
-	"google.golang.org/protobuf/types/known/structpb"
 )
 
 // Entry defines a logical representation of a kv-store entry for ORM instances.
@@ -45,7 +45,12 @@ func (p *PrimaryKeyEntry) String() string {
 	if p.Value == nil {
 		return fmt.Sprintf("PK %s %s -> _", p.TableName, fmtValues(p.Key))
 	} else {
-		return fmt.Sprintf("PK %s %s -> %s", p.TableName, fmtValues(p.Key), p.Value)
+		valBz, err := stablejson.Marshal(p.Value)
+		valStr := string(valBz)
+		if err != nil {
+			valStr = fmt.Sprintf("ERR %v", err)
+		}
+		return fmt.Sprintf("PK %s %s -> %s", p.TableName, fmtValues(p.Key), valStr)
 	}
 }
 
@@ -56,19 +61,7 @@ func fmtValues(values []protoreflect.Value) string {
 
 	parts := make([]string, len(values))
 	for i, v := range values {
-		val, err := structpb.NewValue(v.Interface())
-		if err != nil {
-			parts[i] = "ERR"
-			continue
-		}
-
-		bz, err := protojson.Marshal(val)
-		if err != nil {
-			parts[i] = "ERR"
-			continue
-		}
-
-		parts[i] = string(bz)
+		parts[i] = fmt.Sprintf("%v", v.Interface())
 	}
 
 	return strings.Join(parts, "/")

orm/encoding/ormkv/entry_test.go

@@ -19,7 +19,7 @@ func TestPrimaryKeyEntry(t *testing.T) {
 		Key:       encodeutil.ValuesOf(uint32(1), "abc"),
 		Value:     &testpb.ExampleTable{I32: -1},
 	}
-	assert.Equal(t, `PK testpb.ExampleTable 1/"abc" -> i32:-1`, entry.String())
+	assert.Equal(t, `PK testpb.ExampleTable 1/abc -> {"i32":-1}`, entry.String())
 	assert.Equal(t, aFullName, entry.GetTableName())
 
 	// prefix key
@@ -28,7 +28,7 @@ func TestPrimaryKeyEntry(t *testing.T) {
 		Key:       encodeutil.ValuesOf(uint32(1), "abc"),
 		Value:     nil,
 	}
-	assert.Equal(t, `PK testpb.ExampleTable 1/"abc" -> _`, entry.String())
+	assert.Equal(t, `PK testpb.ExampleTable 1/abc -> _`, entry.String())
 	assert.Equal(t, aFullName, entry.GetTableName())
 }
 
@@ -40,7 +40,7 @@ func TestIndexKeyEntry(t *testing.T) {
 		IndexValues: encodeutil.ValuesOf(uint32(10), int32(-1), "abc"),
 		PrimaryKey:  encodeutil.ValuesOf("abc", int32(-1)),
 	}
-	assert.Equal(t, `IDX testpb.ExampleTable u32/i32/str : 10/-1/"abc" -> "abc"/-1`, entry.String())
+	assert.Equal(t, `IDX testpb.ExampleTable u32/i32/str : 10/-1/abc -> abc/-1`, entry.String())
 	assert.Equal(t, aFullName, entry.GetTableName())
 
 	entry = &ormkv.IndexKeyEntry{
@@ -50,7 +50,7 @@ func TestIndexKeyEntry(t *testing.T) {
 		IndexValues: encodeutil.ValuesOf(uint32(10)),
 		PrimaryKey:  encodeutil.ValuesOf("abc", int32(-1)),
 	}
-	assert.Equal(t, `UNIQ testpb.ExampleTable u32 : 10 -> "abc"/-1`, entry.String())
+	assert.Equal(t, `UNIQ testpb.ExampleTable u32 : 10 -> abc/-1`, entry.String())
 	assert.Equal(t, aFullName, entry.GetTableName())
 
 	// prefix key
@@ -70,6 +70,6 @@ func TestIndexKeyEntry(t *testing.T) {
 		IsUnique:    true,
 		IndexValues: encodeutil.ValuesOf("abc", int32(1)),
 	}
-	assert.Equal(t, `UNIQ testpb.ExampleTable str/i32 : "abc"/1 -> _`, entry.String())
+	assert.Equal(t, `UNIQ testpb.ExampleTable str/i32 : abc/1 -> _`, entry.String())
 	assert.Equal(t, aFullName, entry.GetTableName())
 }