AMMBid

[ソース]

(AMM amendmentにより追加されました。)

自動マーケットメーカーのオークションスロットに入札することができます。落札されると、競り落とされるか24時間が経過するまで、割引料金でAMMと取引することができます。24時間が経過する前に競り落とされた場合、残り時間に応じて落札価格の一部が払い戻されます。

AMMのLPトークンを使って落札すると、落札に利用したLPトークンはAMMに返され、LPトークンの残高が減ります。

AMMBid JSONの例

{
    "Account" : "rJVUeRqDFNs2xqA7ncVE6ZoAhPUoaJJSQm",
    "Asset" : {
        "currency" : "XRP"
    },
    "Asset2" : {
        "currency" : "TST",
        "issuer" : "rP9jPyP5kyvFRb6ZiRghAGw5u8SGAmU4bd"
    },
    "AuthAccounts" : [
        {
          "AuthAccount" : {
              "Account" : "rMKXGCbJ5d8LbrqthdG46q3f969MVK2Qeg"
          }
        },
        {
          "AuthAccount" : {
              "Account" : "rBepJuTLFJt3WmtLXYAxSjtBWAeQxVbncv"
          }
        }
    ],
    "BidMax" : {
        "currency" : "039C99CD9AB0B70B32ECDA51EAAE471625608EA2",
        "issuer" : "rE54zDvgnghAoPopCgvtiqWNq3dU5y836S",
        "value" : "100"
    },
    "Fee" : "10",
    "Flags" : 2147483648,
    "Sequence" : 9,
    "TransactionType" : "AMMBid"
}

AMMBid フィールド

共通フィールドに加えて、AMMBidトランザクションは以下のフィールドを使用します。

| フィールド | JSONの型 | 内部の型 | 必須? | 説明 | |:---------------|:-----------|:- ----------|:----- |:------------| | Asset | オブジェクト | STIssue | はい | AMMのプールにある資産の一つを定義します。JSONでは、currencyとissuerフィールドを持つオブジェクトになります（XRPの場合はissuerを省略します）。 | | Asset2 | オブジェクト | STIssue | はい | AMMのプールにあるもう一つのアセットの定義です。JSONでは、currencyとissuerフィールドを持つオブジェクトになります（XRPの場合はissuerを省略します）。 | | BidMin | 通貨額 | Amount | いいえ | スロットに支払う最小の金額。この値を高く設定すると、他の人から競り落とされにくくなります。省略された場合は、落札に必要な最低額を支払います。 | | BidMax | 通貨額 | Amount | いいえ | スロットに支払う最大の金額。落札するためのコストがこの金額より高い場合、取引は失敗します。省略された場合は、落札に必要な金額を支払います。 | | AuthAccounts | 配列 | STArray | いいえ | 割引料金で取引を許可する最大4つの追加のアカウントのリスト。これには、トランザクション送信者のアドレスは含めることはできません。これらのオブジェクトはそれぞれAuth Accountオブジェクトである必要があります。. |

BidMin と BidMax の両方を指定することはできません。

Auth Accountオブジェクト

AuthAccounts 配列の各メンバーは、以下のフィールドを持つオブジェクトである必要があります。

配列に現れる他の「内部オブジェクト」と同様に、これらのオブジェクトのJSON表現は、オブジェクトタイプAuthAccountのみをキーとするオブジェクトにラップされています。

オークションスロットの価格

落札された場合、トランザクションは自動的に前のスロット所有者を競り落とし、送信者のLPトークンから落札価格が引き落とされます。落札価格は、72分ずつ20回に区切られた時間経過とともに減少します。もし送信者が落札するのに十分なLPトークンを持っていなかったり、入札価格がトランザクションのBidMax値より高い場合、トランザクションはtecAMM_FAILED_BIDという結果で失敗します。

• オークションスロットが現在空であったり、期限切れ、または最後のインターバルである場合、最低入札価格は**AMMの総LPトークン残高の0.001%**です。

  注意

  この最小値は暫定値であり、AMM機能が最終的に完成する前に変更される可能性があります。

• それ以外の場合、現在の保有者に落札価格は、以下の式で計算されます。

  P = B × 1.05 × (1 - t⁶⁰) + M
  

  • P: 落札価格。単位はLPトークン。
  • B: 現在の入札価格。単位はLPトークン。
  • t: 現在の24時間枠で経過した時間の割合。0.05の倍数に切り捨てられる。
  • M: Mは上記で定義された最低入札価格。

  落札コストには、2つの特殊なケースがあります。誰かが落札してから最初の時間枠では、その落札価格は、最低入札価格+既存の入札価格の5%アップとなります。

  P = B × 1.05 + M
  

  スロットの最後の時間枠では、落札コストは最低入札額のみです。

  P = M
  

払い戻し

有効なオークションスロットを落札した場合、AMMは以下の計算式で前ホルダーに価格の一部を払い戻します。

R = B × (1 - t)

• R: は返金する金額。単位はLPトークン。
• B: 払い戻しの対象となる前回の入札の価格。単位はLPトークン。
• t: 現在の24時間枠で経過した時間の割合。0.05の倍数に切り捨てられる。

特殊なケースとして、オークションスロットの最終（20番目）区間では、払い戻し額は0となる。

エラーケース

すべてのトランザクションで発生する可能性のあるエラーに加えて、AMMBidトランザクションでは、次のトランザクション結果コードが発生する可能性があります。