stellarcore

Documentation

Index

• Constants
• type GetLedgerEntryResponse
• type InfoResponse
  • func (resp *InfoResponse) IsSynced() bool
• type LedgerInfo
• type PreflightResponse
• type TXResponse
  • func (resp *TXResponse) IsException() bool

Constants

const (
	// LiveState represents the state value returned by stellar-core when a
	// ledger entry is live
	LiveState = "live"

	// DeadState represents the state value returned by stellar-core when a
	// ledger entry is dead
	DeadState = "dead"
)

const (
	// PreflightStatusError represents the status value returned by stellar-core when an error occurred from
	// processing a preflight request
	PreflightStatusError = "ERROR"

	// PreflightStatusOk represents the status value returned by stellar-core when a preflight request
	// succeeded
	PreflightStatusOk = "OK"
)

const (
	// TXStatusError represents the status value returned by stellar-core when an error occurred from
	// submitting a transaction
	TXStatusError = "ERROR"

	// TXStatusPending represents the status value returned by stellar-core when a transaction has
	// been accepted for processing
	TXStatusPending = "PENDING"

	// TXStatusDuplicate represents the status value returned by stellar-core when a submitted
	// transaction is a duplicate
	TXStatusDuplicate = "DUPLICATE"

	// TXStatusTryAgainLater represents the status value returned by stellar-core when a submitted
	// transaction was not included in the previous 4 ledgers and get banned for being added in the
	// next few ledgers.
	TXStatusTryAgainLater = "TRY_AGAIN_LATER"
)

Types

type GetLedgerEntryResponse

type GetLedgerEntryResponse struct {
	State  string `json:"state"`
	Entry  string `json:"entry"`
	Ledger int64  `json:"ledger"`
}

GetLedgerEntryResponse is the response from Stellar Core for the getLedgerEntry endpoint

type InfoResponse

type InfoResponse struct {
	Info struct {
		Build           string     `json:"build"`
		Network         string     `json:"network"`
		ProtocolVersion int        `json:"protocol_version"`
		State           string     `json:"state"`
		Ledger          LedgerInfo `json:"ledger"`
	}
}

InfoResponse is the json response returned from stellar-core's /info endpoint.

func (*InfoResponse) IsSynced

func (resp *InfoResponse) IsSynced() bool

IsSynced returns a boolean indicating whether stellarcore is synced with the network.

type LedgerInfo

type LedgerInfo struct {
	Age          int    `json:"age"`
	BaseFee      int    `json:"baseFee"`
	BaseReserve  int    `json:"baseReserve"`
	CloseTime    int    `json:"closeTime"`
	Hash         string `json:"hash"`
	MaxTxSetSize int    `json:"maxTxSetSize"`
	Num          int    `json:"num"`
	Version      int    `json:"version"`
}

LedgerInfo is the part of the stellar-core's info json response. It's returned under `ledger` key

type PreflightResponse

type PreflightResponse struct {
	Status          string `json:"status"`
	Detail          string `json:"detail"`
	Result          string `json:"result"`
	Footprint       string `json:"footprint"`
	CPUInstructions uint64 `json:"cpu_insns"`
	MemoryBytes     uint64 `json:"mem_bytes"`
	Ledger          int64  `json:"ledger"`
}

PreflightResponse is the response from Stellar Core for the preflight endpoint

type TXResponse

type TXResponse struct {
	Exception string `json:"exception"`
	Error     string `json:"error"`
	Status    string `json:"status"`
}

TXResponse represents the response returned from a submission request sent to stellar-core's /tx endpoint

func (*TXResponse) IsException

func (resp *TXResponse) IsException() bool

IsException returns true if the response represents an exception response from stellar-core