stellar-base 0.21.0 → 0.23.0

data/xdr/Stellar-ledger.x

@@ -1,318 +0,0 @@
-// Copyright 2015 Stellar Development Foundation and contributors. Licensed
-// under the Apache License, Version 2.0. See the COPYING file at the root
-// of this distribution or at http://www.apache.org/licenses/LICENSE-2.0
-
-%#include "xdr/Stellar-SCP.h"
-%#include "xdr/Stellar-transaction.h"
-
-namespace stellar
-{
-
-typedef opaque UpgradeType<128>;
-
-enum StellarValueType
-{
-    STELLAR_VALUE_BASIC = 0,
-    STELLAR_VALUE_SIGNED = 1
-};
-
-struct LedgerCloseValueSignature
-{
-    NodeID nodeID;       // which node introduced the value
-    Signature signature; // nodeID's signature
-};
-
-/* StellarValue is the value used by SCP to reach consensus on a given ledger
- */
-struct StellarValue
-{
-    Hash txSetHash;      // transaction set to apply to previous ledger
-    TimePoint closeTime; // network close time
-
-    // upgrades to apply to the previous ledger (usually empty)
-    // this is a vector of encoded 'LedgerUpgrade' so that nodes can drop
-    // unknown steps during consensus if needed.
-    // see notes below on 'LedgerUpgrade' for more detail
-    // max size is dictated by number of upgrade types (+ room for future)
-    UpgradeType upgrades<6>;
-
-    // reserved for future use
-    union switch (StellarValueType v)
-    {
-    case STELLAR_VALUE_BASIC:
-        void;
-    case STELLAR_VALUE_SIGNED:
-        LedgerCloseValueSignature lcValueSignature;
-    }
-    ext;
-};
-
-/* The LedgerHeader is the highest level structure representing the
- * state of a ledger, cryptographically linked to previous ledgers.
- */
-struct LedgerHeader
-{
-    uint32 ledgerVersion;    // the protocol version of the ledger
-    Hash previousLedgerHash; // hash of the previous ledger header
-    StellarValue scpValue;   // what consensus agreed to
-    Hash txSetResultHash;    // the TransactionResultSet that led to this ledger
-    Hash bucketListHash;     // hash of the ledger state
-
-    uint32 ledgerSeq; // sequence number of this ledger
-
-    int64 totalCoins; // total number of stroops in existence.
-                      // 10,000,000 stroops in 1 XLM
-
-    int64 feePool;       // fees burned since last inflation run
-    uint32 inflationSeq; // inflation sequence number
-
-    uint64 idPool; // last used global ID, used for generating objects
-
-    uint32 baseFee;     // base fee per operation in stroops
-    uint32 baseReserve; // account base reserve in stroops
-
-    uint32 maxTxSetSize; // maximum size a transaction set can be
-
-    Hash skipList[4]; // hashes of ledgers in the past. allows you to jump back
-                      // in time without walking the chain back ledger by ledger
-                      // each slot contains the oldest ledger that is mod of
-                      // either 50  5000  50000 or 500000 depending on index
-                      // skipList[0] mod(50), skipList[1] mod(5000), etc
-
-    // reserved for future use
-    union switch (int v)
-    {
-    case 0:
-        void;
-    }
-    ext;
-};
-
-/* Ledger upgrades
-note that the `upgrades` field from StellarValue is normalized such that
-it only contains one entry per LedgerUpgradeType, and entries are sorted
-in ascending order
-*/
-enum LedgerUpgradeType
-{
-    LEDGER_UPGRADE_VERSION = 1,
-    LEDGER_UPGRADE_BASE_FEE = 2,
-    LEDGER_UPGRADE_MAX_TX_SET_SIZE = 3,
-    LEDGER_UPGRADE_BASE_RESERVE = 4
-};
-
-union LedgerUpgrade switch (LedgerUpgradeType type)
-{
-case LEDGER_UPGRADE_VERSION:
-    uint32 newLedgerVersion; // update ledgerVersion
-case LEDGER_UPGRADE_BASE_FEE:
-    uint32 newBaseFee; // update baseFee
-case LEDGER_UPGRADE_MAX_TX_SET_SIZE:
-    uint32 newMaxTxSetSize; // update maxTxSetSize
-case LEDGER_UPGRADE_BASE_RESERVE:
-    uint32 newBaseReserve; // update baseReserve
-};
-
-/* Entries used to define the bucket list */
-
-union LedgerKey switch (LedgerEntryType type)
-{
-case ACCOUNT:
-    struct
-    {
-        AccountID accountID;
-    } account;
-
-case TRUSTLINE:
-    struct
-    {
-        AccountID accountID;
-        Asset asset;
-    } trustLine;
-
-case OFFER:
-    struct
-    {
-        AccountID sellerID;
-        int64 offerID;
-    } offer;
-
-case DATA:
-    struct
-    {
-        AccountID accountID;
-        string64 dataName;
-    } data;
-};
-
-enum BucketEntryType
-{
-    METAENTRY =
-        -1, // At-and-after protocol 11: bucket metadata, should come first.
-    LIVEENTRY = 0, // Before protocol 11: created-or-updated;
-                   // At-and-after protocol 11: only updated.
-    DEADENTRY = 1,
-    INITENTRY = 2 // At-and-after protocol 11: only created.
-};
-
-struct BucketMetadata
-{
-    // Indicates the protocol version used to create / merge this bucket.
-    uint32 ledgerVersion;
-
-    // reserved for future use
-    union switch (int v)
-    {
-    case 0:
-        void;
-    }
-    ext;
-};
-
-union BucketEntry switch (BucketEntryType type)
-{
-case LIVEENTRY:
-case INITENTRY:
-    LedgerEntry liveEntry;
-
-case DEADENTRY:
-    LedgerKey deadEntry;
-case METAENTRY:
-    BucketMetadata metaEntry;
-};
-
-// Transaction sets are the unit used by SCP to decide on transitions
-// between ledgers
-struct TransactionSet
-{
-    Hash previousLedgerHash;
-    TransactionEnvelope txs<>;
-};
-
-struct TransactionResultPair
-{
-    Hash transactionHash;
-    TransactionResult result; // result for the transaction
-};
-
-// TransactionResultSet is used to recover results between ledgers
-struct TransactionResultSet
-{
-    TransactionResultPair results<>;
-};
-
-// Entries below are used in the historical subsystem
-
-struct TransactionHistoryEntry
-{
-    uint32 ledgerSeq;
-    TransactionSet txSet;
-
-    // reserved for future use
-    union switch (int v)
-    {
-    case 0:
-        void;
-    }
-    ext;
-};
-
-struct TransactionHistoryResultEntry
-{
-    uint32 ledgerSeq;
-    TransactionResultSet txResultSet;
-
-    // reserved for future use
-    union switch (int v)
-    {
-    case 0:
-        void;
-    }
-    ext;
-};
-
-struct LedgerHeaderHistoryEntry
-{
-    Hash hash;
-    LedgerHeader header;
-
-    // reserved for future use
-    union switch (int v)
-    {
-    case 0:
-        void;
-    }
-    ext;
-};
-
-// historical SCP messages
-
-struct LedgerSCPMessages
-{
-    uint32 ledgerSeq;
-    SCPEnvelope messages<>;
-};
-
-// note: ledgerMessages may refer to any quorumSets encountered
-// in the file so far, not just the one from this entry
-struct SCPHistoryEntryV0
-{
-    SCPQuorumSet quorumSets<>; // additional quorum sets used by ledgerMessages
-    LedgerSCPMessages ledgerMessages;
-};
-
-// SCP history file is an array of these
-union SCPHistoryEntry switch (int v)
-{
-case 0:
-    SCPHistoryEntryV0 v0;
-};
-
-// represents the meta in the transaction table history
-
-// STATE is emitted every time a ledger entry is modified/deleted
-// and the entry was not already modified in the current ledger
-
-enum LedgerEntryChangeType
-{
-    LEDGER_ENTRY_CREATED = 0, // entry was added to the ledger
-    LEDGER_ENTRY_UPDATED = 1, // entry was modified in the ledger
-    LEDGER_ENTRY_REMOVED = 2, // entry was removed from the ledger
-    LEDGER_ENTRY_STATE = 3    // value of the entry
-};
-
-union LedgerEntryChange switch (LedgerEntryChangeType type)
-{
-case LEDGER_ENTRY_CREATED:
-    LedgerEntry created;
-case LEDGER_ENTRY_UPDATED:
-    LedgerEntry updated;
-case LEDGER_ENTRY_REMOVED:
-    LedgerKey removed;
-case LEDGER_ENTRY_STATE:
-    LedgerEntry state;
-};
-
-typedef LedgerEntryChange LedgerEntryChanges<>;
-
-struct OperationMeta
-{
-    LedgerEntryChanges changes;
-};
-
-struct TransactionMetaV1
-{
-    LedgerEntryChanges txChanges; // tx level changes if any
-    OperationMeta operations<>;   // meta for each operation
-};
-
-// this is the meta produced when applying transactions
-// it does not include pre-apply updates such as fees
-union TransactionMeta switch (int v)
-{
-case 0:
-    OperationMeta operations<>;
-case 1:
-    TransactionMetaV1 v1;
-};
-}

data/xdr/Stellar-overlay.x

@@ -1,146 +0,0 @@
-// Copyright 2015 Stellar Development Foundation and contributors. Licensed
-// under the Apache License, Version 2.0. See the COPYING file at the root
-// of this distribution or at http://www.apache.org/licenses/LICENSE-2.0
-
-%#include "xdr/Stellar-ledger.h"
-
-namespace stellar
-{
-
-enum ErrorCode
-{
-    ERR_MISC = 0, // Unspecific error
-    ERR_DATA = 1, // Malformed data
-    ERR_CONF = 2, // Misconfiguration error
-    ERR_AUTH = 3, // Authentication failure
-    ERR_LOAD = 4  // System overloaded
-};
-
-struct Error
-{
-    ErrorCode code;
-    string msg<100>;
-};
-
-struct AuthCert
-{
-    Curve25519Public pubkey;
-    uint64 expiration;
-    Signature sig;
-};
-
-struct Hello
-{
-    uint32 ledgerVersion;
-    uint32 overlayVersion;
-    uint32 overlayMinVersion;
-    Hash networkID;
-    string versionStr<100>;
-    int listeningPort;
-    NodeID peerID;
-    AuthCert cert;
-    uint256 nonce;
-};
-
-struct Auth
-{
-    // Empty message, just to confirm
-    // establishment of MAC keys.
-    int unused;
-};
-
-enum IPAddrType
-{
-    IPv4 = 0,
-    IPv6 = 1
-};
-
-struct PeerAddress
-{
-    union switch (IPAddrType type)
-    {
-    case IPv4:
-        opaque ipv4[4];
-    case IPv6:
-        opaque ipv6[16];
-    }
-    ip;
-    uint32 port;
-    uint32 numFailures;
-};
-
-enum MessageType
-{
-    ERROR_MSG = 0,
-    AUTH = 2,
-    DONT_HAVE = 3,
-
-    GET_PEERS = 4, // gets a list of peers this guy knows about
-    PEERS = 5,
-
-    GET_TX_SET = 6, // gets a particular txset by hash
-    TX_SET = 7,
-
-    TRANSACTION = 8, // pass on a tx you have heard about
-
-    // SCP
-    GET_SCP_QUORUMSET = 9,
-    SCP_QUORUMSET = 10,
-    SCP_MESSAGE = 11,
-    GET_SCP_STATE = 12,
-
-    // new messages
-    HELLO = 13
-};
-
-struct DontHave
-{
-    MessageType type;
-    uint256 reqHash;
-};
-
-union StellarMessage switch (MessageType type)
-{
-case ERROR_MSG:
-    Error error;
-case HELLO:
-    Hello hello;
-case AUTH:
-    Auth auth;
-case DONT_HAVE:
-    DontHave dontHave;
-case GET_PEERS:
-    void;
-case PEERS:
-    PeerAddress peers<100>;
-
-case GET_TX_SET:
-    uint256 txSetHash;
-case TX_SET:
-    TransactionSet txSet;
-
-case TRANSACTION:
-    TransactionEnvelope transaction;
-
-// SCP
-case GET_SCP_QUORUMSET:
-    uint256 qSetHash;
-case SCP_QUORUMSET:
-    SCPQuorumSet qSet;
-case SCP_MESSAGE:
-    SCPEnvelope envelope;
-case GET_SCP_STATE:
-    uint32 getSCPLedgerSeq; // ledger seq requested ; if 0, requests the latest
-};
-
-union AuthenticatedMessage switch (uint32 v)
-{
-case 0:
-    struct
-{
-   uint64 sequence;
-   StellarMessage message;
-   HmacSha256Mac mac;
-    } v0;
-};
-}