@agoric/cosmos 0.34.2-dev-7cc5def.0 → 0.35.0-u11.0

package/x/vstorage/types/query.pb.gw.go

@@ -87,78 +87,6 @@ func local_request_Query_Data_0(ctx context.Context, marshaler runtime.Marshaler
 
 }
 
-var (
-	filter_Query_CapData_0 = &utilities.DoubleArray{Encoding: map[string]int{"path": 0}, Base: []int{1, 1, 0}, Check: []int{0, 1, 2}}
-)
-
-func request_Query_CapData_0(ctx context.Context, marshaler runtime.Marshaler, client QueryClient, req *http.Request, pathParams map[string]string) (proto.Message, runtime.ServerMetadata, error) {
-	var protoReq QueryCapDataRequest
-	var metadata runtime.ServerMetadata
-
-	var (
-		val string
-		ok  bool
-		err error
-		_   = err
-	)
-
-	val, ok = pathParams["path"]
-	if !ok {
-		return nil, metadata, status.Errorf(codes.InvalidArgument, "missing parameter %s", "path")
-	}
-
-	protoReq.Path, err = runtime.String(val)
-
-	if err != nil {
-		return nil, metadata, status.Errorf(codes.InvalidArgument, "type mismatch, parameter: %s, error: %v", "path", err)
-	}
-
-	if err := req.ParseForm(); err != nil {
-		return nil, metadata, status.Errorf(codes.InvalidArgument, "%v", err)
-	}
-	if err := runtime.PopulateQueryParameters(&protoReq, req.Form, filter_Query_CapData_0); err != nil {
-		return nil, metadata, status.Errorf(codes.InvalidArgument, "%v", err)
-	}
-
-	msg, err := client.CapData(ctx, &protoReq, grpc.Header(&metadata.HeaderMD), grpc.Trailer(&metadata.TrailerMD))
-	return msg, metadata, err
-
-}
-
-func local_request_Query_CapData_0(ctx context.Context, marshaler runtime.Marshaler, server QueryServer, req *http.Request, pathParams map[string]string) (proto.Message, runtime.ServerMetadata, error) {
-	var protoReq QueryCapDataRequest
-	var metadata runtime.ServerMetadata
-
-	var (
-		val string
-		ok  bool
-		err error
-		_   = err
-	)
-
-	val, ok = pathParams["path"]
-	if !ok {
-		return nil, metadata, status.Errorf(codes.InvalidArgument, "missing parameter %s", "path")
-	}
-
-	protoReq.Path, err = runtime.String(val)
-
-	if err != nil {
-		return nil, metadata, status.Errorf(codes.InvalidArgument, "type mismatch, parameter: %s, error: %v", "path", err)
-	}
-
-	if err := req.ParseForm(); err != nil {
-		return nil, metadata, status.Errorf(codes.InvalidArgument, "%v", err)
-	}
-	if err := runtime.PopulateQueryParameters(&protoReq, req.Form, filter_Query_CapData_0); err != nil {
-		return nil, metadata, status.Errorf(codes.InvalidArgument, "%v", err)
-	}
-
-	msg, err := server.CapData(ctx, &protoReq)
-	return msg, metadata, err
-
-}
-
 var (
 	filter_Query_Children_0 = &utilities.DoubleArray{Encoding: map[string]int{"path": 0}, Base: []int{1, 1, 0}, Check: []int{0, 1, 2}}
 )
@@ -260,29 +188,6 @@ func RegisterQueryHandlerServer(ctx context.Context, mux *runtime.ServeMux, serv
 
 	})
 
-	mux.Handle("GET", pattern_Query_CapData_0, func(w http.ResponseWriter, req *http.Request, pathParams map[string]string) {
-		ctx, cancel := context.WithCancel(req.Context())
-		defer cancel()
-		var stream runtime.ServerTransportStream
-		ctx = grpc.NewContextWithServerTransportStream(ctx, &stream)
-		inboundMarshaler, outboundMarshaler := runtime.MarshalerForRequest(mux, req)
-		rctx, err := runtime.AnnotateIncomingContext(ctx, mux, req)
-		if err != nil {
-			runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
-			return
-		}
-		resp, md, err := local_request_Query_CapData_0(rctx, inboundMarshaler, server, req, pathParams)
-		md.HeaderMD, md.TrailerMD = metadata.Join(md.HeaderMD, stream.Header()), metadata.Join(md.TrailerMD, stream.Trailer())
-		ctx = runtime.NewServerMetadataContext(ctx, md)
-		if err != nil {
-			runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
-			return
-		}
-
-		forward_Query_CapData_0(ctx, mux, outboundMarshaler, w, req, resp, mux.GetForwardResponseOptions()...)
-
-	})
-
 	mux.Handle("GET", pattern_Query_Children_0, func(w http.ResponseWriter, req *http.Request, pathParams map[string]string) {
 		ctx, cancel := context.WithCancel(req.Context())
 		defer cancel()
@@ -367,26 +272,6 @@ func RegisterQueryHandlerClient(ctx context.Context, mux *runtime.ServeMux, clie
 
 	})
 
-	mux.Handle("GET", pattern_Query_CapData_0, func(w http.ResponseWriter, req *http.Request, pathParams map[string]string) {
-		ctx, cancel := context.WithCancel(req.Context())
-		defer cancel()
-		inboundMarshaler, outboundMarshaler := runtime.MarshalerForRequest(mux, req)
-		rctx, err := runtime.AnnotateContext(ctx, mux, req)
-		if err != nil {
-			runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
-			return
-		}
-		resp, md, err := request_Query_CapData_0(rctx, inboundMarshaler, client, req, pathParams)
-		ctx = runtime.NewServerMetadataContext(ctx, md)
-		if err != nil {
-			runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
-			return
-		}
-
-		forward_Query_CapData_0(ctx, mux, outboundMarshaler, w, req, resp, mux.GetForwardResponseOptions()...)
-
-	})
-
 	mux.Handle("GET", pattern_Query_Children_0, func(w http.ResponseWriter, req *http.Request, pathParams map[string]string) {
 		ctx, cancel := context.WithCancel(req.Context())
 		defer cancel()
@@ -413,15 +298,11 @@ func RegisterQueryHandlerClient(ctx context.Context, mux *runtime.ServeMux, clie
 var (
 	pattern_Query_Data_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 2, 2, 1, 0, 4, 1, 5, 3}, []string{"agoric", "vstorage", "data", "path"}, "", runtime.AssumeColonVerbOpt(false)))
 
-	pattern_Query_CapData_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 2, 2, 1, 0, 4, 1, 5, 3}, []string{"agoric", "vstorage", "capdata", "path"}, "", runtime.AssumeColonVerbOpt(false)))
-
 	pattern_Query_Children_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 2, 2, 1, 0, 4, 1, 5, 3}, []string{"agoric", "vstorage", "children", "path"}, "", runtime.AssumeColonVerbOpt(false)))
 )
 
 var (
 	forward_Query_Data_0 = runtime.ForwardResponseMessage
 
-	forward_Query_CapData_0 = runtime.ForwardResponseMessage
-
 	forward_Query_Children_0 = runtime.ForwardResponseMessage
 )

package/x/vstorage/README.md

@@ -1,95 +0,0 @@
-# Virtual Storage
-
-This module manages "[IAVL](https://github.com/cosmos/iavl)" chain storage data with a hierarchical keyspace in which each key is a "[path](./types/path_keys.go)" composed of zero or more dot-separated nonempty segments in a restricted alphabet. It exposes gRPC endpoints to arbitrary external clients for reading data, and internal read/write interfaces for use by SwingSet (which itself manages further subtree-scoped attenuation).
-
-## Internal Go interface
-
-[Keeper](./keeper/keeper.go)
-* generic
-  * GetChildren
-  * GetEntry
-  * HasEntry
-  * HasStorage
-  * SetStorage[AndNotify]
-* StreamCell-oriented (a StreamCell captures a block height and an array of values)
-  * AppendStorageValue[AndNotify]
-* queue-oriented (a queue stores items at paths like "$prefix.$n", documenting
-  the n for the next item to be consumed at "$prefix.head" and the n for the next
-  next item to be pushed at "$prefix.tail" such that the queue is empty when both
-  head and tail store the same n)
-  * GetQueueLength
-  * PushQueueItem
-
-## Internal JSON interface
-
-This is used by the SwingSet "bridge".
-
-[Receive](./vstorage.go) with input `{ "method": "...", "args": [...] }`
-* generic
-  * method "entries", args path
-  * method "get"/"has", args path
-  * method "set"/"setWithoutNotify", args [[path, value?], ...]
-  * method "children", args path
-  * method "values", args path (returns values for children in the same order as method "children")
-  * method "size", args path (returns the count of children)
-* StreamCell-oriented
-  * method "append", args [[path, value?], ...]
- 
-## CLI
-
-A blockchain node may be interrogated by RPC using `agd [--node $url] query vstorage $command` via [client/cli](./client/cli/query.go).
-* `children [--height $blockHeight] [-o {text,json}] [$path]`
-* `data [--height $blockHeight] [-o {text,json}] $path`
-
-Examples:
-```sh
-$ agd --node https://main.rpc.agoric.net:443/ query vstorage children published.reserve
-children:
-- governance
-- metrics
-pagination: null
-
-$ agd --node https://main.rpc.agoric.net:443/ query vstorage children -o json published.reserve
-{"children":["governance","metrics"],"pagination":null}
-
-$ agd --node https://main.rpc.agoric.net:443/ query vstorage data published.reserve.metrics
-value: '{"blockHeight":"11030240","values":["{\"body\":\"#{\\\"allocations\\\":{\\\"Fee\\\":{\\\"brand\\\":\\\"$0.Alleged:
-  IST brand\\\",\\\"value\\\":\\\"+20053582387\\\"}},\\\"shortfallBalance\\\":{\\\"brand\\\":\\\"$0\\\",\\\"value\\\":\\\"+0\\\"},\\\"totalFeeBurned\\\":{\\\"brand\\\":\\\"$0\\\",\\\"value\\\":\\\"+0\\\"},\\\"totalFeeMinted\\\":{\\\"brand\\\":\\\"$0\\\",\\\"value\\\":\\\"+0\\\"}}\",\"slots\":[\"board0257\"]}"]}'
-```
-
-## External protobuf interface
-
-RPC via [Querier](./keeper/grpc_query.go),
-and [CometBFT method "abci_query"](https://docs.cometbft.com/main/rpc/#/ABCI/abci_query)
-with params `path` "/agoric.vstorage.Query/..."
-and `data` \<serialized protobuf per [vstorage/query.proto](../../proto/agoric/vstorage/query.proto)>
-(also via [Querier](./keeper/grpc_query.go))
-* /agoric.vstorage.Query/CapData
-* /agoric.vstorage.Query/Children
-* /agoric.vstorage.Query/Data
-
-## External JSON interface
-
-As described at [Cosmos SDK: Using the REST Endpoints](https://docs.cosmos.network/main/run-node/interact-node#using-the-rest-endpoints), a blockchain node whose [`app.toml` configuration](https://docs.cosmos.network/main/run-node/run-node#configuring-the-node-using-apptoml-and-configtoml) enables the "REST" API server uses [gRPC-Gateway](https://grpc-ecosystem.github.io/grpc-gateway/) and `google.api.http` annotations in [vstorage/query.proto](../../proto/agoric/vstorage/query.proto) to automatically translate the protobuf-based RPC endpoints into URL paths that accept query parameters and emit JSON.
-* /agoric/vstorage/capdata/$path?remotableValueFormat={object,string}[&mediaType=JSON%20Lines][&itemFormat=flat]
-* /agoric/vstorage/children/$path
-* /agoric/vstorage/data/$path
-
-Example:
-```sh
-$ curl -sS 'https://main.api.agoric.net/agoric/vstorage/children/published.committees'
-{
-  "children": [
-    "Economic_Committee"
-  ],
-  "pagination": null
-}
-```
-
-## Arbitrary-response HTTP interface
-
-This depends upon appModule `LegacyQuerierHandler` functionality that is [removed from cosmos-sdk as of v0.47](https://github.com/cosmos/cosmos-sdk/blob/fa4d87ef7e6d87aaccc94c337ffd2fe90fcb7a9d/CHANGELOG.md#api-breaking-changes-3)
-
-[legacy querier](./keeper/querier.go)
-* /custom/vstorage/children/$path
-* /custom/vstorage/data/$path

package/x/vstorage/capdata/capdata.go

@@ -1,298 +0,0 @@
-package capdata
-
-import (
-	"bytes"
-	"encoding/json"
-	"fmt"
-	"regexp"
-	"strconv"
-	"strings"
-)
-
-// JsonMarshal returns JSON text representing its input,
-// without special replacement of "<", ">", "&", U+2028, or U+2029.
-func JsonMarshal(val any) ([]byte, error) {
-	buf := &bytes.Buffer{}
-	encoder := json.NewEncoder(buf)
-	encoder.SetEscapeHTML(false)
-	if err := encoder.Encode(val); err != nil {
-		return nil, err
-	}
-	// Return without a trailing line feed.
-	lineTerminatedJson := buf.Bytes()
-	return bytes.TrimSuffix(lineTerminatedJson, []byte("\n")), nil
-}
-
-// cf. https://github.com/endojs/endo/tree/master/packages/marshal
-
-type Capdata struct {
-	Body  string        `json:"body"`
-	Slots []interface{} `json:"slots"`
-}
-
-var validBigint = regexp.MustCompile(`^-?(?:0|[1-9][0-9]*)$`)
-
-type CapdataBigint struct {
-	Normalized string
-}
-
-type CapdataRemotable struct {
-	Id             interface{}
-	Iface          *string
-	Representation interface{}
-}
-
-func NewCapdataBigint(str string) *CapdataBigint {
-	if !validBigint.MatchString(str) {
-		return nil
-	}
-	bigint := CapdataBigint{str}
-	return &bigint
-}
-
-func (r *CapdataRemotable) MarshalJSON() ([]byte, error) {
-	return JsonMarshal(r.Representation)
-}
-
-type CapdataValueTransformations struct {
-	Bigint    func(*CapdataBigint) interface{}
-	Remotable func(*CapdataRemotable) interface{}
-}
-
-// upsertCapdataRemotable either adds a new CapdataRemotable to `remotables` at the specified
-// slot index or updates the iface of the value that is already there, ensuring lack of iface name
-// inconsistency (iteration order is not guaranteed to correspond with JSON text like it does in
-// JavaScript, so we must accept encountering the "first" reference to a slot late
-// and must therefore also defer transformations).
-func upsertCapdataRemotable(remotables map[uint64]*CapdataRemotable, slotIndex uint64, id interface{}, iface *string) (*CapdataRemotable, error) {
-	r := remotables[slotIndex]
-	if r == nil {
-		r = new(CapdataRemotable)
-		r.Id = id
-		r.Iface = iface
-		remotables[slotIndex] = r
-	} else if iface != nil {
-		if r.Iface != nil && *iface != *r.Iface {
-			return nil, fmt.Errorf("slot iface mismatch: %q", *iface)
-		}
-		r.Iface = iface
-	}
-	return r, nil
-}
-
-// decodeCapdataLegacyValue decodes the non-smallcaps encoding of
-// https://github.com/endojs/endo/blob/master/packages/marshal/src/encodeToCapData.js
-func decodeCapdataLegacyValue(
-	encoded interface{},
-	slots []interface{},
-	remotables map[uint64]*CapdataRemotable,
-	transformations CapdataValueTransformations,
-) (interface{}, error) {
-	if arr, ok := encoded.([]interface{}); ok {
-		for i, v := range arr {
-			decoded, err := decodeCapdataLegacyValue(v, slots, remotables, transformations)
-			if err != nil {
-				return nil, err
-			}
-			arr[i] = decoded
-		}
-		return arr, nil
-	} else if obj, ok := encoded.(map[string]interface{}); ok {
-		if qclassVal, ok := obj["@qclass"]; ok {
-			qclass, ok := qclassVal.(string)
-			if !ok {
-				return nil, fmt.Errorf("invalid @qclass: %q", qclassVal)
-			}
-			switch qclass {
-			case "bigint":
-				var bigint *CapdataBigint
-				digitsVal := obj["digits"]
-				if digitsStr, ok := digitsVal.(string); ok {
-					bigint = NewCapdataBigint(digitsStr)
-				}
-				if bigint == nil {
-					return nil, fmt.Errorf("invalid bigint: %q", digitsVal)
-				}
-				if transformations.Bigint == nil {
-					return nil, fmt.Errorf("untransformed bigint")
-				}
-				return transformations.Bigint(bigint), nil
-			case "slot":
-				var iface *string
-				slotIndexVal, ifaceVal := obj["index"], obj["iface"]
-				slotIndexNum, ok := slotIndexVal.(float64)
-				slotIndex := uint64(slotIndexNum)
-				if !ok || float64(slotIndex) != slotIndexNum || slotIndex >= uint64(len(slots)) {
-					return nil, fmt.Errorf("invalid slot index: %q", slotIndexVal)
-				}
-				if ifaceStr, ok := ifaceVal.(string); ok {
-					iface = &ifaceStr
-				} else if ifaceVal != nil {
-					return nil, fmt.Errorf("invalid slot iface: %q", ifaceVal)
-				}
-				return upsertCapdataRemotable(remotables, slotIndex, slots[slotIndex], iface)
-			case "hilbert":
-				fallthrough
-			case "undefined":
-				fallthrough
-			case "NaN":
-				fallthrough
-			case "Infinity":
-				fallthrough
-			case "symbol":
-				fallthrough
-			case "tagged":
-				fallthrough
-			case "error":
-				fallthrough
-			case "-Infinity":
-				return nil, fmt.Errorf("not implemented: @qclass %q", qclass)
-			default:
-				return nil, fmt.Errorf("unrecognized @qclass: %q", qclass)
-			}
-		}
-		for k, v := range obj {
-			decoded, err := decodeCapdataLegacyValue(v, slots, remotables, transformations)
-			if err != nil {
-				return nil, err
-			}
-			obj[k] = decoded
-		}
-		return obj, nil
-	} else {
-		return encoded, nil
-	}
-}
-
-// decodeCapdataSmallcapsValue decodes the "smallcaps" encoding from
-// https://github.com/endojs/endo/blob/master/packages/marshal/src/encodeToSmallcaps.js
-func decodeCapdataSmallcapsValue(
-	encoded interface{},
-	slots []interface{},
-	remotables map[uint64]*CapdataRemotable,
-	transformations CapdataValueTransformations,
-) (interface{}, error) {
-	if arr, ok := encoded.([]interface{}); ok {
-		for i, v := range arr {
-			decoded, err := decodeCapdataSmallcapsValue(v, slots, remotables, transformations)
-			if err != nil {
-				return nil, err
-			}
-			arr[i] = decoded
-		}
-		return arr, nil
-	} else if encodedObj, ok := encoded.(map[string]interface{}); ok {
-		if _, ok := encodedObj["#tag"]; ok {
-			return nil, fmt.Errorf("not implemented: #tag")
-		}
-		if _, ok := encodedObj["#error"]; ok {
-			return nil, fmt.Errorf("not implemented: #error")
-		}
-		// We need a distinct output map to avoid reprocessing already-decoded keys.
-		decodedObj := make(map[string]interface{}, len(encodedObj))
-		for encodedK, v := range encodedObj {
-			if strings.HasPrefix(encodedK, "#") {
-				return nil, fmt.Errorf("unrecognized record type: %q", encodedK)
-			}
-			decodedK, err := decodeCapdataSmallcapsValue(encodedK, slots, remotables, CapdataValueTransformations{})
-			k, ok := decodedK.(string)
-			if err != nil || !ok {
-				return nil, fmt.Errorf("invalid copyRecord key: %q", encodedK)
-			}
-			decoded, err := decodeCapdataSmallcapsValue(v, slots, remotables, transformations)
-			if err != nil {
-				return nil, err
-			}
-			decodedObj[k] = decoded
-		}
-		return decodedObj, nil
-	} else if str, ok := encoded.(string); ok {
-		if len(str) == 0 {
-			return str, nil
-		}
-		switch str[0] {
-		case '!':
-			return str[1:], nil
-		case '+':
-			// Normalize to no leading "+".
-			str = str[1:]
-			fallthrough
-		case '-':
-			bigint := NewCapdataBigint(str)
-			if bigint == nil {
-				return nil, fmt.Errorf("invalid bigint: %q", encoded.(string))
-			}
-			if transformations.Bigint == nil {
-				return nil, fmt.Errorf("untransformed bigint")
-			}
-			return transformations.Bigint(bigint), nil
-		case '$':
-			var slotIndexStr string
-			var iface *string
-			if dotIndex := strings.IndexByte(str, '.'); dotIndex >= 0 {
-				slotIndexStr = str[1:dotIndex]
-				ifaceStr := str[dotIndex+1:]
-				iface = &ifaceStr
-			} else {
-				slotIndexStr = str[1:]
-			}
-			slotIndex, err := strconv.ParseUint(slotIndexStr, 10, 0)
-			if err != nil || slotIndex >= uint64(len(slots)) {
-				return nil, fmt.Errorf("invalid slot index: %q", str)
-			}
-			r, err := upsertCapdataRemotable(remotables, slotIndex, slots[slotIndex], iface)
-			if err != nil {
-				return nil, fmt.Errorf("slot iface mismatch: %q", str)
-			}
-			return r, nil
-		case '#':
-			fallthrough
-		case '%':
-			fallthrough
-		case '&':
-			return nil, fmt.Errorf("not implemented: %q", str)
-		default:
-			if str[0] >= '!' && str[0] <= '-' {
-				return nil, fmt.Errorf("invalid smallcaps encoding prefix: %q", str[:1])
-			}
-		}
-		return str, nil
-	} else {
-		return encoded, nil
-	}
-}
-
-// DecodeSerializedCapdata accepts JSON text representing encoded CapData and
-// decodes it, applying specified transformations for values that otherwise
-// hinder interchange.
-func DecodeSerializedCapdata(
-	serializedCapdata string,
-	transformations CapdataValueTransformations,
-) (interface{}, error) {
-	var capdata Capdata
-	if err := json.Unmarshal([]byte(serializedCapdata), &capdata); err != nil {
-		return nil, err
-	}
-	if capdata.Body == "" || capdata.Slots == nil {
-		return nil, fmt.Errorf("invalid CapData")
-	}
-	serializedBody, decodeValue := capdata.Body, decodeCapdataLegacyValue
-	if strings.HasPrefix(serializedBody, "#") {
-		serializedBody, decodeValue = serializedBody[1:], decodeCapdataSmallcapsValue
-	}
-	var encoded interface{}
-	if err := json.Unmarshal([]byte(serializedBody), &encoded); err != nil {
-		return nil, err
-	}
-	remotables := map[uint64]*CapdataRemotable{}
-	decoded, err := decodeValue(encoded, capdata.Slots, remotables, transformations)
-	if err == nil && len(remotables) > 0 {
-		if transformations.Remotable == nil {
-			return nil, fmt.Errorf("untransformed remotable")
-		}
-		for _, r := range remotables {
-			r.Representation = transformations.Remotable(r)
-		}
-	}
-	return decoded, err
-}