// 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-types.h" namespace stellar { typedef PublicKey AccountID; typedef opaque Thresholds[4]; typedef string string32<32>; typedef uint64 SequenceNumber; enum AssetType { ASSET_TYPE_NATIVE = 0, ASSET_TYPE_CREDIT_ALPHANUM4 = 1, ASSET_TYPE_CREDIT_ALPHANUM12 = 2 }; union Asset switch (AssetType type) { case ASSET_TYPE_NATIVE: // Not credit void; case ASSET_TYPE_CREDIT_ALPHANUM4: struct { opaque assetCode[4]; AccountID issuer; } alphaNum4; case ASSET_TYPE_CREDIT_ALPHANUM12: struct { opaque assetCode[12]; AccountID issuer; } alphaNum12; // add other asset types here in the future }; // price in fractional representation struct Price { int32 n; // numerator int32 d; // denominator }; // the 'Thresholds' type is packed uint8_t values // defined by these indexes enum ThresholdIndexes { THRESHOLD_MASTER_WEIGHT = 0, THRESHOLD_LOW = 1, THRESHOLD_MED = 2, THRESHOLD_HIGH = 3 }; enum LedgerEntryType { ACCOUNT = 0, TRUSTLINE = 1, OFFER = 2 }; struct Signer { AccountID pubKey; uint32 weight; // really only need 1byte }; enum AccountFlags { // masks for each flag // if set, TrustLines are created with authorized set to "false" // requiring the issuer to set it for each TrustLine AUTH_REQUIRED_FLAG = 0x1, // if set, the authorized flag in TrustLines can be cleared // otherwise, authorization cannot be revoked AUTH_REVOCABLE_FLAG = 0x2 }; /* AccountEntry Main entry representing a user in Stellar. All transactions are performed using an account. Other ledger entries created require an account. */ struct AccountEntry { AccountID accountID; // master public key for this account int64 balance; // in stroops SequenceNumber seqNum; // last sequence number used for this account uint32 numSubEntries; // number of sub-entries this account has // drives the reserve AccountID* inflationDest; // Account to vote during inflation uint32 flags; // see AccountFlags string32 homeDomain; // can be used for reverse federation and memo lookup // fields used for signatures // thresholds stores unsigned bytes: [weight of master|low|medium|high] Thresholds thresholds; Signer signers<20>; // possible signers for this account // reserved for future use union switch (int v) { case 0: void; } ext; }; /* TrustLineEntry A trust line represents a specific trust relationship with a credit/issuer (limit, authorization) as well as the balance. */ enum TrustLineFlags { // issuer has authorized account to perform transactions with its credit AUTHORIZED_FLAG = 1 }; struct TrustLineEntry { AccountID accountID; // account this trustline belongs to Asset asset; // type of asset (with issuer) int64 balance; // how much of this asset the user has. // Asset defines the unit for this; int64 limit; // balance cannot be above this uint32 flags; // see TrustLineFlags // reserved for future use union switch (int v) { case 0: void; } ext; }; enum OfferEntryFlags { // issuer has authorized account to perform transactions with its credit PASSIVE_FLAG = 1 }; /* OfferEntry An offer is the building block of the offer book, they are automatically claimed by payments when the price set by the owner is met. For example an Offer is selling 10A where 1A is priced at 1.5B */ struct OfferEntry { AccountID sellerID; uint64 offerID; Asset selling; // A Asset buying; // B int64 amount; // amount of A /* price for this offer: price of A in terms of B price=AmountB/AmountA=priceNumerator/priceDenominator price is after fees */ Price price; uint32 flags; // see OfferEntryFlags // reserved for future use union switch (int v) { case 0: void; } ext; }; union LedgerEntry switch (LedgerEntryType type) { case ACCOUNT: AccountEntry account; case TRUSTLINE: TrustLineEntry trustLine; case OFFER: OfferEntry offer; }; // list of all envelope types used in the application // those are prefixes used when building signatures for // the respective envelopes enum EnvelopeType { ENVELOPE_TYPE_SCP = 1, ENVELOPE_TYPE_TX = 2 }; }