@clonegod/ttd-sui-common 1.0.93 → 1.0.95

package/dist/grpc/protos/sui/rpc/v2/move_package.proto

@@ -0,0 +1,238 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2;
+
+// A Move Package
+message Package {
+  // The PackageId of this package
+  //
+  // A package's `storage_id` is the Sui ObjectId of the package on-chain.
+  // Outside of system packages the `storage_id` for every package version is
+  // different.
+  optional string storage_id = 1;
+
+  // The PackageId of the first published version of this package.
+  //
+  // A package's `original_id` (sometimes also called its `runtime_id`) is the
+  // `storage_id` of the first version of this package that has been published.
+  // The `original_id`/`runtime_id` is stable across all versions of the
+  // package and does not ever change.
+  optional string original_id = 2;
+
+  // The version of this package
+  optional uint64 version = 3;
+
+  // The modules defined by this package
+  repeated Module modules = 4;
+
+  // List of datatype origins for mapping datatypes to a package version where
+  // it was first defined
+  repeated TypeOrigin type_origins = 5;
+
+  // The package's transitive dependencies as a mapping from the package's
+  // runtime Id (the Id it is referred to by in other packages) to its
+  // storage Id (the Id it is loaded from on chain).
+  repeated Linkage linkage = 6;
+}
+
+// A Move Module.
+message Module {
+  // Name of this module.
+  optional string name = 1;
+
+  // Serialized bytecode of the module.
+  optional bytes contents = 2;
+
+  // List of DataTypes defined by this module.
+  repeated DatatypeDescriptor datatypes = 3;
+
+  // List of Functions defined by this module.
+  repeated FunctionDescriptor functions = 4;
+
+  // List of Constants defined by this module.
+  // repeated Constant constants = 5;
+}
+
+// Describes a Move Datatype.
+message DatatypeDescriptor {
+  // Fully qualified name of this Datatype.
+  //
+  // This is `<defining_id>::<module>::<name>`
+  optional string type_name = 1;
+
+  // PackageId of the package where this Datatype is defined.
+  //
+  // A type's `defining_id` is the `storage_id` of the package version that first introduced or added that type.
+  optional string defining_id = 2;
+
+  // Name of the module where this Datatype is defined
+  optional string module = 3;
+
+  // Name of this Datatype
+  optional string name = 4;
+
+  // This type's abilities
+  repeated Ability abilities = 5;
+
+  // Ability constraints and phantom status for this type's generic type parameters
+  repeated TypeParameter type_parameters = 6;
+
+  enum DatatypeKind {
+    DATATYPE_KIND_UNKNOWN = 0;
+    STRUCT = 1;
+    ENUM = 2;
+  }
+
+  // Indicates whether this datatype is a 'STRUCT' or an 'ENUM'
+  optional DatatypeKind kind = 7;
+
+  // Set of fields if this Datatype is a struct.
+  //
+  // The order of the entries is the order of how the fields are defined.
+  repeated FieldDescriptor fields = 8;
+
+  // Set of variants if this Datatype is an enum.
+  //
+  // The order of the entries is the order of how the variants are defined.
+  repeated VariantDescriptor variants = 9;
+}
+
+// An `Ability` classifies what operations are permitted for a given type
+enum Ability {
+  ABILITY_UNKNOWN = 0;
+
+  // Allows values of types with this ability to be copied
+  COPY = 1;
+
+  // Allows values of types with this ability to be dropped.
+  DROP = 2;
+
+  // Allows values of types with this ability to exist inside a struct in global storage
+  STORE = 3;
+
+  // Allows the type to serve as a key for global storage operations
+  KEY = 4;
+}
+
+// A generic type parameter used in the declaration of a struct or enum.
+message TypeParameter {
+  // The type parameter constraints
+  repeated Ability constraints = 1;
+
+  // Whether the parameter is declared as phantom
+  optional bool is_phantom = 2;
+}
+
+// Descriptor of a field that belongs to a struct or enum variant
+message FieldDescriptor {
+  // Name of the field
+  optional string name = 1;
+
+  // Order or position of the field in the struct or enum variant definition.
+  optional uint32 position = 2;
+
+  // The type of the field
+  optional OpenSignatureBody type = 3;
+}
+
+// Descriptor of an enum variant
+message VariantDescriptor {
+  // Name of the variant
+  optional string name = 1;
+
+  // Order or position of the variant in the enum definition.
+  optional uint32 position = 2;
+
+  // Set of fields defined by this variant.
+  repeated FieldDescriptor fields = 3;
+}
+
+// Representation of a type signature that could appear as a field type for a struct or enum
+message OpenSignatureBody {
+  enum Type {
+    TYPE_UNKNOWN = 0;
+    ADDRESS = 1;
+    BOOL = 2;
+    U8 = 3;
+    U16 = 4;
+    U32 = 5;
+    U64 = 6;
+    U128 = 7;
+    U256 = 8;
+    VECTOR = 9;
+    DATATYPE = 10;
+    TYPE_PARAMETER = 11;
+  }
+
+  // Type of this signature
+  optional Type type = 1;
+
+  // Fully qualified name of the datatype when `type` is `DATATYPE`
+  optional string type_name = 2;
+
+  // Set when `type` is `VECTOR` or `DATATYPE`
+  repeated OpenSignatureBody type_parameter_instantiation = 3;
+
+  // Position of the type parameter as defined in the containing data type descriptor when `type` is `TYPE_PARAMETER`
+  optional uint32 type_parameter = 4;
+}
+
+// Descriptor of a Move function
+message FunctionDescriptor {
+  // Name of the function
+  optional string name = 1;
+
+  enum Visibility {
+    VISIBILITY_UNKNOWN = 0;
+    PRIVATE = 1;
+    PUBLIC = 2;
+    FRIEND = 3;
+  }
+
+  // Whether the function is `public`, `private` or `public(friend)`
+  optional Visibility visibility = 5;
+
+  // Whether the function is marked `entry` or not.
+  optional bool is_entry = 6;
+
+  // Ability constraints for type parameters
+  repeated TypeParameter type_parameters = 7;
+
+  // Formal parameter types.
+  repeated OpenSignature parameters = 8;
+
+  // Return types.
+  repeated OpenSignature returns = 9;
+}
+
+// Representation of a type signature that could appear as a function parameter or return value.
+message OpenSignature {
+  enum Reference {
+    REFERENCE_UNKNOWN = 0;
+    IMMUTABLE = 1;
+    MUTABLE = 2;
+  }
+
+  optional Reference reference = 1;
+  optional OpenSignatureBody body = 2;
+}
+
+// Identifies a struct and the module it was defined in.
+message TypeOrigin {
+  optional string module_name = 1;
+  optional string datatype_name = 2;
+  optional string package_id = 3;
+}
+
+// Upgraded package info for the linkage table.
+message Linkage {
+  // Id of the original package.
+  optional string original_id = 1;
+  // Id of the upgraded package.
+  optional string upgraded_id = 2;
+  // Version of the upgraded package.
+  optional uint64 upgraded_version = 3;
+}

package/dist/grpc/protos/sui/rpc/v2/move_package_service.proto

@@ -0,0 +1,91 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2;
+
+import "sui/rpc/v2/move_package.proto";
+
+service MovePackageService {
+  rpc GetPackage(GetPackageRequest) returns (GetPackageResponse);
+  rpc GetDatatype(GetDatatypeRequest) returns (GetDatatypeResponse);
+  rpc GetFunction(GetFunctionRequest) returns (GetFunctionResponse);
+  rpc ListPackageVersions(ListPackageVersionsRequest) returns (ListPackageVersionsResponse);
+}
+
+message GetPackageRequest {
+  // Required. The `storage_id` of the requested package.
+  optional string package_id = 1;
+}
+
+message GetPackageResponse {
+  // The package.
+  optional Package package = 1;
+}
+
+message GetDatatypeRequest {
+  // Required. The `storage_id` of the requested package.
+  optional string package_id = 1;
+
+  // Required. The name of the requested module.
+  optional string module_name = 2;
+
+  // Required. The name of the requested datatype.
+  optional string name = 3;
+}
+
+message GetDatatypeResponse {
+  // The datatype.
+  optional DatatypeDescriptor datatype = 1;
+}
+
+message GetFunctionRequest {
+  // Required. The `storage_id` of the requested package.
+  optional string package_id = 1;
+
+  // Required. The name of the requested module.
+  optional string module_name = 2;
+
+  // Required. The name of the requested function.
+  optional string name = 3;
+}
+
+message GetFunctionResponse {
+  // The function.
+  optional FunctionDescriptor function = 1;
+}
+
+message ListPackageVersionsRequest {
+  // Required. The `storage_id` of any version of the package.
+  optional string package_id = 1;
+
+  // The maximum number of versions to return. The service may return fewer than this value.
+  // If unspecified, at most `1000` entries will be returned.
+  // The maximum value is `10000`; values above `10000` will be coerced to `10000`.
+  optional uint32 page_size = 2;
+
+  // A page token, received from a previous `ListPackageVersions` call.
+  // Provide this to retrieve the subsequent page.
+  //
+  // When paginating, all other parameters provided to `ListPackageVersions` must
+  // match the call that provided the page token.
+  optional bytes page_token = 3;
+}
+
+message ListPackageVersionsResponse {
+  // List of all package versions, ordered by version.
+  repeated PackageVersion versions = 1;
+
+  // A token, which can be sent as `page_token` to retrieve the next page.
+  // If this field is omitted, there are no subsequent pages.
+  optional bytes next_page_token = 2;
+}
+
+// A simplified representation of a package version
+message PackageVersion {
+  // The storage ID of this package version
+  optional string package_id = 1;
+  // The version number
+  optional uint64 version = 2;
+}

package/dist/grpc/protos/sui/rpc/v2/name_service.proto

@@ -0,0 +1,67 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2;
+
+import "google/protobuf/timestamp.proto";
+
+service NameService {
+  rpc LookupName(LookupNameRequest) returns (LookupNameResponse);
+  rpc ReverseLookupName(ReverseLookupNameRequest) returns (ReverseLookupNameResponse);
+}
+
+message LookupNameRequest {
+  // Required. The SuiNS name to lookup.
+  //
+  // Supports both `@name` as well as `name.sui` formats.
+  optional string name = 1;
+}
+
+message LookupNameResponse {
+  // The record for the requested name
+  optional NameRecord record = 1;
+}
+
+message ReverseLookupNameRequest {
+  // Required. The address to perform a reverse lookup for.
+  optional string address = 1;
+}
+
+message ReverseLookupNameResponse {
+  // The record for the SuiNS name linked to the requested address
+  optional NameRecord record = 1;
+}
+
+message NameRecord {
+  // Id of this record.
+  //
+  // Note that records are stored on chain as dynamic fields of the type
+  // `Field<Domain,NameRecord>`.
+  optional string id = 1;
+
+  // The SuiNS name of this record
+  optional string name = 2;
+
+  // The ID of the `RegistrationNFT` assigned to this record.
+  //
+  // The owner of the corresponding `RegistrationNFT` has the rights to
+  // be able to change and adjust the `target_address` of this domain.
+  //
+  // It is possible that the ID changes if the record expires and is
+  // purchased by someone else.
+  optional string registration_nft_id = 3;
+
+  // Timestamp when the record expires.
+  //
+  // This is either the expiration of the record itself or the expiration of
+  // this record's parent if this is a leaf record.
+  optional google.protobuf.Timestamp expiration_timestamp = 4;
+
+  // The target address that this name points to
+  optional string target_address = 5;
+
+  // Additional data which may be stored in a record
+  map<string, string> data = 6;
+}

package/dist/grpc/protos/sui/rpc/v2/object.proto

@@ -0,0 +1,68 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2;
+
+import "google/protobuf/struct.proto";
+import "sui/rpc/v2/bcs.proto";
+import "sui/rpc/v2/move_package.proto";
+import "sui/rpc/v2/owner.proto";
+
+// An object on the Sui blockchain.
+message Object {
+  // This Object serialized as BCS.
+  optional Bcs bcs = 1;
+
+  // `ObjectId` for this object.
+  optional string object_id = 2;
+
+  // Version of the object.
+  optional uint64 version = 3;
+
+  // The digest of this Object.
+  optional string digest = 4;
+
+  // Owner of the object.
+  optional Owner owner = 5;
+
+  // The type of this object.
+  //
+  // This will be 'package' for packages and a StructTag for move structs.
+  optional string object_type = 6;
+
+  // DEPRECATED this field is no longer used to determine whether a tx can transfer this
+  // object. Instead, it is always calculated from the objects type when loaded in execution.
+  //
+  // Only set for Move structs
+  optional bool has_public_transfer = 7;
+
+  // BCS bytes of a Move struct value.
+  //
+  // Only set for Move structs
+  optional Bcs contents = 8;
+
+  // Package information for Move Packages
+  optional Package package = 9;
+
+  // The digest of the transaction that created or last mutated this object
+  optional string previous_transaction = 10;
+
+  // The amount of SUI to rebate if this object gets deleted.
+  // This number is re-calculated each time the object is mutated based on
+  // the present storage gas price.
+  optional uint64 storage_rebate = 11;
+
+  // JSON rendering of the object.
+  optional google.protobuf.Value json = 100;
+
+  // Current balance if this object is a `0x2::coin::Coin<T>`
+  optional uint64 balance = 101;
+}
+
+// Set of Objects
+message ObjectSet {
+  // Objects are sorted by the key `(object_id, version)`.
+  repeated Object objects = 1;
+}

package/dist/grpc/protos/sui/rpc/v2/object_reference.proto

@@ -0,0 +1,16 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2;
+
+// Reference to an object.
+message ObjectReference {
+  // The object id of this object.
+  optional string object_id = 1;
+  // The version of this object.
+  optional uint64 version = 2;
+  // The digest of this object.
+  optional string digest = 3;
+}

package/dist/grpc/protos/sui/rpc/v2/owner.proto

@@ -0,0 +1,25 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2;
+
+// Enum of different types of ownership for an object.
+message Owner {
+  enum OwnerKind {
+    OWNER_KIND_UNKNOWN = 0;
+    ADDRESS = 1;
+    OBJECT = 2;
+    SHARED = 3;
+    IMMUTABLE = 4;
+    CONSENSUS_ADDRESS = 5;
+  }
+  optional OwnerKind kind = 1;
+
+  // Address or ObjectId of the owner
+  optional string address = 2;
+
+  // The `initial_shared_version` if kind is `SHARED` or `start_version` if kind `CONSENSUS_ADDRESS`.
+  optional uint64 version = 3;
+}

package/dist/grpc/protos/sui/rpc/v2/protocol_config.proto

@@ -0,0 +1,12 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2;
+
+message ProtocolConfig {
+  optional uint64 protocol_version = 1;
+  map<string, bool> feature_flags = 2;
+  map<string, string> attributes = 3;
+}