code.vegaprotocol.io/vega@v0.79.0/protos/sources/vega/api/v1/corestate.proto

syntax = "proto3";

package vega.api.v1;

import "protoc-gen-openapiv2/options/annotations.proto";
import "vega/assets.proto";
import "vega/events/v1/events.proto";
import "vega/governance.proto";
import "vega/markets.proto";
import "vega/vega.proto";

option go_package = "code.vegaprotocol.io/vega/protos/vega/api/v1";
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_swagger) = {
  info: {
    title: "Vega core state APIs";
    version: "v0.79.0";
  }
  schemes: [
    HTTP,
    HTTPS
  ]
  host: "lb.testnet.vega.xyz"
};

service CoreStateService {
  // Accounts list
  //
  // Get a list of accounts. This endpoint may not be exposed by mainnet nodes.
  rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse);

  // Assets list
  //
  // Get a list of assets. This endpoint may not be exposed by mainnet nodes.
  rpc ListAssets(ListAssetsRequest) returns (ListAssetsResponse);

  // Network parameters list
  //
  // Get a list of network parameters. This endpoint may not be exposed by mainnet nodes.
  rpc ListNetworkParameters(ListNetworkParametersRequest) returns (ListNetworkParametersResponse);

  // Network limits list
  //
  // Get a list of network limits. This endpoint may not be exposed by mainnet nodes.
  rpc ListNetworkLimits(ListNetworkLimitsRequest) returns (ListNetworkLimitsResponse);

  // Parties list
  //
  // Get a list of parties. This endpoint may not be exposed by mainnet nodes.
  rpc ListParties(ListPartiesRequest) returns (ListPartiesResponse);

  // Validators list
  //
  // Get a list of validators. This endpoint may not be exposed by mainnet nodes.
  rpc ListValidators(ListValidatorsRequest) returns (ListValidatorsResponse);

  // Markets list
  //
  // Get a list of markets. This endpoint may not be exposed by mainnet nodes.
  rpc ListMarkets(ListMarketsRequest) returns (ListMarketsResponse);

  // Proposals list
  //
  // Get a list of proposals. This endpoint may not be exposed by mainnet nodes.
  rpc ListProposals(ListProposalsRequest) returns (ListProposalsResponse);

  // Markets data list
  //
  // Get a list of markets' data. This endpoint may not be exposed by mainnet nodes.
  rpc ListMarketsData(ListMarketsDataRequest) returns (ListMarketsDataResponse);

  // Votes list
  //
  // Get a list of votes. This endpoint may not be exposed by mainnet nodes.
  rpc ListVotes(ListVotesRequest) returns (ListVotesResponse);

  // Parties stake list
  //
  // Get a list of parties' stake. This endpoint may not be exposed by mainnet nodes.
  rpc ListPartiesStake(ListPartiesStakeRequest) returns (ListPartiesStakeResponse);

  // Delegations list
  //
  // Get a list of delegations. This endpoint may not be exposed by mainnet nodes.
  rpc ListDelegations(ListDelegationsRequest) returns (ListDelegationsResponse);
}

message Account {
  string party = 1;
  string market = 2;
  string balance = 3;
  string asset = 5;
  string type = 6;
}

message ListAccountsRequest {
  string party = 1;
  string market = 2;
}

message ListAccountsResponse {
  repeated Account accounts = 1;
}

message ListAssetsRequest {
  string asset = 1; // optional ID
}

message ListAssetsResponse {
  repeated vega.Asset assets = 1;
}

message ListNetworkParametersRequest {
  string network_parameter_key = 1; // optional parameter key
}

message ListNetworkParametersResponse {
  repeated vega.NetworkParameter network_parameters = 1;
}

message ListNetworkLimitsRequest {}

message ListNetworkLimitsResponse {
  vega.NetworkLimits network_limits = 1;
}

message ListPartiesRequest {}

message ListPartiesResponse {
  repeated vega.Party parties = 1;
}

message ListValidatorsRequest {}

message ListValidatorsResponse {
  repeated vega.events.v1.ValidatorUpdate validators = 1;
}

message ListMarketsRequest {
  string market = 1;
}

message ListMarketsResponse {
  repeated vega.Market markets = 1;
}

message ListProposalsRequest {
  string proposal = 1; // optional ID
  string proposer = 2; // optional party
}

message ListProposalsResponse {
  repeated vega.Proposal proposals = 1;
}

message ListMarketsDataRequest {
  string market = 1;
}

message ListMarketsDataResponse {
  repeated vega.MarketData markets_data = 1;
}

message ListVotesRequest {
  string proposal = 1;
  string party = 2;
}

message ListVotesResponse {
  repeated vega.Vote votes = 1;
}

message PartyStake {
  string party = 1;
  string current_stake_available = 2;
  repeated vega.events.v1.StakeLinking stake_linkings = 3;
}

message ListPartiesStakeRequest {
  string party = 1;
}

message ListPartiesStakeResponse {
  repeated PartyStake parties_stake = 1;
}

message ListDelegationsRequest {
  string party = 1;
  string node = 2;
  string epoch_seq = 3;
}

message ListDelegationsResponse {
  repeated vega.Delegation delegations = 1;
}