package protocol

Get desktop application:
View/edit binary Protocol Buffers messages

Unused numbers in the list below may have been used previously. Please don't reassign them for reuse unless you are 100% certain that there won't be a conflict. Even if you're sure, it's probably best to assign a new type.

• mtMANIFESTS = 2

• mtPING = 3

• mtCLUSTER = 5

• mtENDPOINTS = 15

• mtTRANSACTION = 30

• mtGET_LEDGER = 31

• mtLEDGER_DATA = 32

• mtSTATUS_CHANGE = 34

  mtPROPOSE_LEDGER = 33;

• mtHAVE_SET = 35

• mtGET_TABLE = 36

• mtTABLE_DATA = 37

• mtGET_OBJECTS = 42

  mtVIEW_CHANGE = 38; mtVALIDATION = 41;

• mtGET_SHARD_INFO = 50

• mtSHARD_INFO = 51

• mtGET_PEER_SHARD_INFO = 52

• mtPEER_SHARD_INFO = 53

• mtVALIDATORLIST = 54

• mtCONSENSUS = 55

• mtSYNC_SCHEMA = 56

• mtTRANSACTIONS = 57

Used in: TMStatusChange

• neCLOSING_LEDGER = 1

  closing a ledger because its close time has come

• neACCEPTED_LEDGER = 2

  accepting a closed ledger, we have finished computing it

• neSWITCHED_LEDGER = 3

  changing due to network consensus

• neLOST_SYNC = 4

• neVALID_LEDGER = 5

Used in: TMStatusChange

• nsCONNECTING = 1

  acquiring connections

• nsCONNECTED = 2

  convinced we are connected to the real network

• nsMONITORING = 3

  we know what the previous ledger is

• nsVALIDATING = 4

  we have the full ledger contents

• nsSHUTTING = 5

  node is shutting down

The status of all nodes in the cluster

• repeated TMClusterNode clusterNodes = 1

• repeated TMLoadSource loadSources = 2

The status of a node in our cluster

Used in: TMCluster

• required string publicKey = 1

• required uint32 reportTime = 2

• required uint32 nodeLoad = 3

• optional string nodeName = 4

• optional string address = 5

• required bytes msg = 1

• required uint32 msgType = 2

• required bytes signerPubKey = 3

• required bytes signature = 4

• optional uint32 signFlags = 5

• optional uint32 hops = 6

• required bytes schemaId = 7

An Endpoint describes a network peer that can accept incoming connections

Used in: TMEndpoints

• required TMIPv4Endpoint ipv4 = 1

• required uint32 hops = 2

An array of Endpoint messages

• required uint32 version = 1

  This field is used to allow the TMEndpoints message format to be modified as necessary in the future.

• repeated TMEndpoint endpoints = 2

• repeated TMEndpoints.TMEndpointv2 endpoints_v2 = 3

An update to the Endpoint type that uses a string to represent endpoints, thus allowing ipv6 or ipv4 addresses

Used in: TMEndpoints

• required string endpoint = 1

• required uint32 hops = 2

• required TMLedgerInfoType itype = 1

• optional TMLedgerType ltype = 2

• optional bytes ledgerHash = 3

  Can also be the transaction set hash if liTS_CANDIDATE

• optional uint32 ledgerSeq = 4

• repeated bytes nodeIDs = 5

• optional uint64 requestCookie = 6

• optional TMQueryType queryType = 7

• optional uint32 queryDepth = 8

  How deep to go, number of extra levels

• required bytes schemaId = 9

• optional bytes rootHash = 10

  For contract storage map,need to specify which map we are requesting for.

• required TMGetObjectByHash.ObjectType type = 1

• required bool query = 2

  is this a query or a reply?

• optional uint32 seq = 3

  used to match replies to queries

• optional bytes ledgerHash = 4

  the hash of the ledger these queries are for

• optional bool fat = 5

  return related nodes

• repeated TMIndexedObject objects = 6

  the specific objects requested

• required bytes schemaId = 7

Used in: TMGetObjectByHash

• otUNKNOWN = 0

• otLEDGER = 1

• otTRANSACTION = 2

• otTRANSACTION_NODE = 3

• otSTATE_NODE = 4

• otCAS_OBJECT = 5

• otFETCH_PACK = 6

• otCONTRACT_NODE = 7

Request info on shards held

• required uint32 hops = 1

  number of hops to travel

• optional bool lastLink = 2

  true if last link in the peer chain

• repeated TMLink peerChain = 3

  public keys used to route messages

• required bytes schemaId = 4

Request info on shards held

• required uint32 hops = 1

  number of hops to travel

• optional bool lastLink = 2

  true if last link in the peer chain

• repeated uint32 peerchain = 3

  IDs used to route messages

• required uint32 ledgerSeq = 1

• optional bytes ledgerHash = 2

• required uint32 ledgerCheckSeq = 3

• optional bytes ledgerCheckHash = 4

• required bytes nameInDB = 5

• required bytes account = 6

• optional uint32 ledgerStopSeq = 7

• required bool getLost = 8

• required uint32 eTargetType = 9

  0 for table sync , 1 for dump table operation

• optional bytes nickName = 10

  identity task

• required bytes schemaId = 11

• required TxSetStatus status = 1

• required bytes hash = 2

• required bytes schemaId = 3

Used in: TMEndpoint

• required uint32 ipv4 = 1

• required uint32 ipv4Port = 2

  VFALCO NOTE There is no uint16 in google protocol buffers, so we use a uint32 to represent the port.

Used in: TMGetObjectByHash

• optional bytes hash = 1

• optional bytes nodeID = 2

• optional bytes index = 3

• optional bytes data = 4

• optional uint32 ledgerSeq = 5

• required bytes ledgerHash = 1

• required uint32 ledgerSeq = 2

• required TMLedgerInfoType type = 3

• repeated TMLedgerNode nodes = 4

• optional uint32 requestCookie = 5

• optional TMReplyError error = 6

• required bytes schemaId = 7

• optional bytes rootHash = 8

  For contract storage map,need to specify which map we are replying for.

Used in: TMGetLedger, TMLedgerData

• liBASE = 0

  basic ledger info

• liTX_NODE = 1

  transaction node

• liAS_NODE = 2

  account state node

• liTS_CANDIDATE = 3

  candidate transaction set

• liSKIP_NODE = 4

• liCONTRACT_NODE = 5

  contract storage node

Used in: TMLedgerData, TMTableData

• required bytes nodedata = 1

• optional bytes nodeid = 2

  missing for ledger base data

Used in: TMGetLedger

• ltACCEPTED = 0

• ltCURRENT = 1

  no longer supported

• ltCLOSED = 2

Node public key

Used in: TMGetPeerShardInfo, TMPeerShardInfo

• required bytes nodePubKey = 1

  node public key

Sources that are placing load on the server

Used in: TMCluster

• required string name = 1

• required uint32 cost = 2

• optional uint32 count = 3

  number of connections

Provides the current ephemeral key for a validator.

Used in: TMManifests

• required bytes stobject = 1

  A Manifest object in the Ripple serialization format.

• repeated TMManifest list = 1

• optional bool history = 2

  The manifests sent when a peer first connects to another peer are `history`.

• required bytes schemaId = 3

Info about shards held

• required string shardIndexes = 1

  rangeSet of shard indexes

• optional bytes nodePubKey = 2

  node public key

• optional string endpoint = 3

  ipv6 or ipv4 address

• optional bool lastLink = 4

  true if last link in the peer chain

• repeated TMLink peerChain = 5

  public keys used to route messages

• required bytes schemaId = 6

• required TMPing.pingType type = 1

• optional uint32 seq = 2

  detect stale replies, ensure other side is reading

• optional uint64 pingTime = 3

  know when we think we sent the ping

• optional uint64 netTime = 4

Used in: TMPing

• ptPING = 0

  we want a reply

• ptPONG = 1

  this is a reply

Used in: TMGetLedger

• qtINDIRECT = 0

Used in: TMLedgerData

• reNO_LEDGER = 1

  We don't have the ledger you are asking about

• reNO_NODE = 2

  We don't have any of the nodes you are asking for

• repeated TMSHAMapProof.Level level = 1

• required bytes rootID = 2

Used in: TMSHAMapProof

• required uint32 branch = 1

• repeated bytes nodeID = 2

Info about shards held

• required string shardIndexes = 1

  rangeSet of shard indexes

• optional bytes nodePubKey = 2

  The node's public key

• optional string endpoint = 3

  ipv6 or ipv4 address

• optional bool lastLink = 4

  true if last link in the peer chain

• repeated uint32 peerchain = 5

  IDs used to route messages

• optional NodeStatus newStatus = 1

• optional NodeEvent newEvent = 2

• optional uint32 ledgerSeq = 3

• optional bytes ledgerHash = 4

• optional bytes ledgerHashPrevious = 5

• optional uint64 networkTime = 6

• optional uint32 firstSeq = 7

• optional uint32 lastSeq = 8

• required bytes schemaId = 9

• required TMSyncSchema.SyncSchemaType type = 1

• required uint32 ledgerSeq = 2

• required uint32 txIndex = 3

• required bytes txHash = 4

• optional uint64 updateTurn = 5

• optional uint32 updateSeq = 6

• required bytes schemaId = 7

Used in: TMSyncSchema

• ssApplyValidators = 1

• ssUpdateValidators = 2

• required uint32 ledgerSeq = 1

• required bytes ledgerHash = 2

• required bytes ledgerCheckHash = 3

• required uint32 lastLedgerSeq = 4

• required bytes lastLedgerHash = 5

• required bytes nameInDB = 6

• required bytes account = 7

• repeated TMLedgerNode txNodes = 8

• required bool seekStop = 9

• optional uint32 closetime = 10

• required uint32 eTargetType = 11

  0 for table sync , 1 for dump table operation

• optional bytes nickName = 12

  identity task

• required bytes schemaId = 13

• required bytes rawTransaction = 1

• required TransactionStatus status = 2

• optional uint64 receiveTimestamp = 3

• optional bool deferred = 4

  not applied to open ledger

• required bytes schemaId = 5

Used in: TMTransactions

• required bytes rawTransaction = 1

• optional bytes txid = 2

• repeated TMTransactionSingle transactions = 1

• required bytes schemaId = 2

Validator list

• required bytes manifest = 1

• required bytes blob = 2

• required bytes signature = 3

• required uint32 version = 4

• required bytes schemaId = 5

Used in: TMTransaction

• tsNEW = 1

  origin node did/could not validate

• tsCURRENT = 2

  scheduled to go in this ledger

• tsCOMMITED = 3

  in a closed ledger

• tsREJECT_CONFLICT = 4

• tsREJECT_INVALID = 5

• tsREJECT_FUNDS = 6

• tsHELD_SEQ = 7

• tsHELD_LEDGER = 8

  held for future ledger

Used in: TMHaveTransactionSet

• tsHAVE = 1

  We have this set locally

• tsCAN_GET = 2

  We have a peer with this set

• tsNEED = 3

  We need this set and can't get it