AMMCreate implements Automatic Market Maker(AMM) creation Transactor. More...

Inheritance diagram for ripple::AMMCreate:

Collaboration diagram for ripple::AMMCreate:

[legend]

Public Types
enum	ConsequencesFactoryType { Normal, Blocker, Custom }

Public Member Functions
	AMMCreate (ApplyContext &ctx)

TER	doApply () override
	Attempt to create the AMM instance. More...

std::pair< TER, bool >	operator() ()
	Process the transaction. More...

ApplyView &	view ()

ApplyView const &	view () const

Static Public Member Functions
static NotTEC	preflight (PreflightContext const &ctx)

static XRPAmount	calculateBaseFee (ReadView const &view, STTx const &tx)

static TER	preclaim (PreclaimContext const &ctx)

static NotTEC	checkSeqProxy (ReadView const &view, STTx const &tx, beast::Journal j)

static NotTEC	checkPriorTxAndLastLedger (PreclaimContext const &ctx)

static TER	checkFee (PreclaimContext const &ctx, XRPAmount baseFee)

static NotTEC	checkSign (PreclaimContext const &ctx)

static TER	ticketDelete (ApplyView &view, AccountID const &account, uint256 const &ticketIndex, beast::Journal j)

Static Public Attributes
static constexpr ConsequencesFactoryType	ConsequencesFactory {Normal}

Protected Member Functions
TER	apply ()

virtual void	preCompute ()

Static Protected Member Functions
static XRPAmount	minimumFee (Application &app, XRPAmount baseFee, Fees const &fees, ApplyFlags flags)
	Compute the minimum fee required to process a transaction with a given baseFee based on the current server load. More...

Protected Attributes
ApplyContext &	ctx_

const beast::Journal	j_

const AccountID	account_

XRPAmount	mPriorBalance

XRPAmount	mSourceBalance

Private Member Functions
std::pair< TER, XRPAmount >	reset (XRPAmount fee)
	Reset the context, discarding any changes made and adjust the fee. More...

TER	consumeSeqProxy (SLE::pointer const &sleAccount)

TER	payFee ()

Static Private Member Functions
static NotTEC	checkSingleSign (PreclaimContext const &ctx)

static NotTEC	checkMultiSign (PreclaimContext const &ctx)

Detailed Description

AMMCreate implements Automatic Market Maker(AMM) creation Transactor.

It creates a new AMM instance with two tokens. Any trader, or Liquidity Provider (LP), can create the AMM instance and receive in return shares of the AMM pool in the form on LPTokens. The number of tokens that LP gets are determined by LPTokens = sqrt(A * B), where A and B is the current composition of the AMM pool. LP can add (AMMDeposit) or withdraw (AMMWithdraw) tokens from AMM and AMM can be used transparently in the payment or offer crossing transactions. Trading fee is charged to the traders for the trades executed against AMM instance. The fee is added to the AMM pool and distributed to the LPs in proportion to the LPTokens upon liquidity removal. The fee can be voted on by LP's (AMMVote). LP's can continuously bid (AMMBid) for the 24 hour auction slot, which enables LP's to trade at zero trading fee. AMM instance creates AccountRoot object with disabled master key for book-keeping of XRP balance if one of the tokens is XRP, a trustline for each IOU token, a trustline to keep track of LPTokens, and ltAMM ledger object. AccountRoot ID is generated internally from the parent's hash. ltAMM's object ID is hash{token1.currency, token1.issuer, token2.currency, token2.issuer}, where issue1 < issue2. ltAMM object provides mapping from the hash to AccountRoot ID and contains: AMMAccount - AMM AccountRoot ID. TradingFee - AMM voted TradingFee. VoteSlots - Array of VoteEntry, contains fee vote information. AuctionSlot - Auction slot, contains discounted fee bid information. LPTokenBalance - LPTokens outstanding balance. AMMToken - currency/issuer information for AMM tokens. AMMDeposit, AMMWithdraw, AMMVote, and AMMBid transactions use the hash to access AMM instance.

See also: XLS30d:Creating AMM instance on XRPL

Definition at line 57 of file AMMCreate.h.

Member Enumeration Documentation

◆ ConsequencesFactoryType

enum ripple::Transactor::ConsequencesFactoryType

inherited

Enumerator
Normal
Blocker
Custom

Definition at line 101 of file Transactor.h.

Constructor & Destructor Documentation

◆ AMMCreate()

ripple::AMMCreate::AMMCreate ( ApplyContext & ctx )

explicit

Definition at line 62 of file AMMCreate.h.

Member Function Documentation

◆ preflight()

NotTEC ripple::AMMCreate::preflight ( PreflightContext const & ctx )

static

Definition at line 36 of file AMMCreate.cpp.

◆ calculateBaseFee()

XRPAmount ripple::AMMCreate::calculateBaseFee	(	ReadView const &	view,
		STTx const &	tx
	)

static

Definition at line 82 of file AMMCreate.cpp.

◆ preclaim()

TER ripple::AMMCreate::preclaim ( PreclaimContext const & ctx )

static

Definition at line 89 of file AMMCreate.cpp.

◆ doApply()

TER ripple::AMMCreate::doApply ( )

overridevirtual

Attempt to create the AMM instance.

Implements ripple::Transactor.

Definition at line 366 of file AMMCreate.cpp.

◆ operator()()

std::pair< TER, bool > ripple::Transactor::operator() ( )

inherited

Process the transaction.

Definition at line 827 of file Transactor.cpp.

◆ view() [1/2]

ApplyView& ripple::Transactor::view ( )

inherited

Definition at line 107 of file Transactor.h.

◆ view() [2/2]

ApplyView const& ripple::Transactor::view ( ) const

inherited

Definition at line 113 of file Transactor.h.

◆ checkSeqProxy()

NotTEC ripple::Transactor::checkSeqProxy	(	ReadView const &	view,
		STTx const &	tx,
		beast::Journal	j
	)

staticinherited

Definition at line 263 of file Transactor.cpp.

◆ checkPriorTxAndLastLedger()

NotTEC ripple::Transactor::checkPriorTxAndLastLedger ( PreclaimContext const & ctx )

staticinherited

Definition at line 335 of file Transactor.cpp.

◆ checkFee()

TER ripple::Transactor::checkFee	(	PreclaimContext const &	ctx,
		XRPAmount	baseFee
	)

staticinherited

Definition at line 190 of file Transactor.cpp.

◆ checkSign()

NotTEC ripple::Transactor::checkSign ( PreclaimContext const & ctx )

staticinherited

Definition at line 478 of file Transactor.cpp.

◆ ticketDelete()

TER ripple::Transactor::ticketDelete	(	ApplyView &	view,
		AccountID const &	account,
		uint256 const &	ticketIndex,
		beast::Journal	j
	)

staticinherited

Definition at line 383 of file Transactor.cpp.

◆ apply()

TER ripple::Transactor::apply ( )

protectedinherited

Definition at line 443 of file Transactor.cpp.

◆ preCompute()

void ripple::Transactor::preCompute ( )

protectedvirtualinherited

Reimplemented in ripple::SetSignerList, ripple::CreateOffer, and ripple::Change.

Definition at line 437 of file Transactor.cpp.

◆ minimumFee()

XRPAmount ripple::Transactor::minimumFee	(	Application &	app,
		XRPAmount	baseFee,
		Fees const &	fees,
		ApplyFlags	flags
	)

staticprotectedinherited

Compute the minimum fee required to process a transaction with a given baseFee based on the current server load.

Parameters

app	The application hosting the server
baseFee	The base fee of a candidate transaction

See also: ripple::calculateBaseFee

Parameters

fees	Fee settings from the current ledger
flags	Transaction processing fees

Definition at line 180 of file Transactor.cpp.

◆ reset()

std::pair< TER, XRPAmount > ripple::Transactor::reset ( XRPAmount fee )

privateinherited

Reset the context, discarding any changes made and adjust the fee.

Definition at line 788 of file Transactor.cpp.

◆ consumeSeqProxy()

TER ripple::Transactor::consumeSeqProxy ( SLE::pointer const & sleAccount )

privateinherited

Definition at line 365 of file Transactor.cpp.

◆ payFee()

TER ripple::Transactor::payFee ( )

privateinherited

Definition at line 243 of file Transactor.cpp.

◆ checkSingleSign()

NotTEC ripple::Transactor::checkSingleSign ( PreclaimContext const & ctx )

staticprivateinherited

Definition at line 488 of file Transactor.cpp.

◆ checkMultiSign()

NotTEC ripple::Transactor::checkMultiSign ( PreclaimContext const & ctx )

staticprivateinherited

Definition at line 562 of file Transactor.cpp.

Member Data Documentation

◆ ConsequencesFactory

constexpr ConsequencesFactoryType ripple::AMMCreate::ConsequencesFactory {Normal}

staticconstexpr

Definition at line 60 of file AMMCreate.h.

◆ ctx_

ApplyContext& ripple::Transactor::ctx_

protectedinherited

Definition at line 88 of file Transactor.h.

◆ j_

const beast::Journal ripple::Transactor::j_

protectedinherited

Definition at line 89 of file Transactor.h.

◆ account_

const AccountID ripple::Transactor::account_

protectedinherited

Definition at line 91 of file Transactor.h.

◆ mPriorBalance

XRPAmount ripple::Transactor::mPriorBalance

protectedinherited

Definition at line 92 of file Transactor.h.

◆ mSourceBalance

XRPAmount ripple::Transactor::mSourceBalance

protectedinherited

Definition at line 93 of file Transactor.h.

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Member Functions

Static Private Member Functions

Detailed Description

Member Enumeration Documentation

◆ ConsequencesFactoryType

Constructor & Destructor Documentation

◆ AMMCreate()

Member Function Documentation

◆ preflight()

◆ calculateBaseFee()

◆ preclaim()

◆ doApply()

◆ operator()()

◆ view() [1/2]

◆ view() [2/2]

◆ checkSeqProxy()

◆ checkPriorTxAndLastLedger()

◆ checkFee()

◆ checkSign()

◆ ticketDelete()

◆ apply()

◆ preCompute()

◆ minimumFee()

◆ reset()

◆ consumeSeqProxy()

◆ payFee()

◆ checkSingleSign()

◆ checkMultiSign()

Member Data Documentation

◆ ConsequencesFactory

◆ ctx_

◆ j_

◆ account_

◆ mPriorBalance

◆ mSourceBalance