@liquid-af/sdk 0.5.9 → 0.6.0

package/src/idl/liquid_swap.ts

@@ -1051,6 +1051,988 @@ export type LiquidSwap = {
         }
       ]
     },
+    {
+      "name": "buyExact",
+      "docs": [
+        "Buys base tokens by providing an exact amount of quote tokens (exact input).",
+        "",
+        "# Arguments",
+        "* `amount_in` - Exact quote tokens to spend.",
+        "* `minimum_amount_out` - Minimum base tokens to receive (slippage protection)."
+      ],
+      "discriminator": [
+        2,
+        162,
+        8,
+        52,
+        139,
+        46,
+        160,
+        13
+      ],
+      "accounts": [
+        {
+          "name": "payer",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "pool",
+          "docs": [
+            "The program account of the pool in which the swap will be performed."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  112,
+                  111,
+                  111,
+                  108
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "baseMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
+              }
+            ]
+          }
+        },
+        {
+          "name": "baseTokenAccount",
+          "docs": [
+            "The user token account for input token."
+          ],
+          "writable": true
+        },
+        {
+          "name": "quoteTokenAccount",
+          "docs": [
+            "The user token account for output token."
+          ],
+          "writable": true
+        },
+        {
+          "name": "baseVault",
+          "docs": [
+            "The vault token account for input token."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  112,
+                  111,
+                  111,
+                  108,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "pool"
+              },
+              {
+                "kind": "account",
+                "path": "baseMint"
+              }
+            ]
+          }
+        },
+        {
+          "name": "quoteVault",
+          "docs": [
+            "The vault token account for output token."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  112,
+                  111,
+                  111,
+                  108,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "pool"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
+              }
+            ]
+          }
+        },
+        {
+          "name": "observationState",
+          "docs": [
+            "The program account for the most recent oracle observation."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  111,
+                  98,
+                  115,
+                  101,
+                  114,
+                  118,
+                  97,
+                  116,
+                  105,
+                  111,
+                  110
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "pool"
+              }
+            ]
+          }
+        },
+        {
+          "name": "feeRecipient",
+          "docs": [
+            "The protocol fee recipient. Must be one of the allowed recipients in Config.",
+            "",
+            "NOTE: Validation happens in handler by checking against global_config.fee_recipients.",
+            "Fee recipients are admin-controlled pubkeys stored in AmmConfig, so an attacker",
+            "cannot pass an arbitrary account - it must match one of the configured recipients."
+          ],
+          "writable": true
+        },
+        {
+          "name": "protocolFeeVault",
+          "docs": [
+            "The protocol fee vault."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  103,
+                  108,
+                  111,
+                  98,
+                  97,
+                  108,
+                  95,
+                  102,
+                  101,
+                  101
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "feeRecipient"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
+              }
+            ]
+          }
+        },
+        {
+          "name": "feeVault",
+          "docs": [
+            "Fee vault PDA from liquid-fees (authority for fee_vault_token_account)."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  102,
+                  101,
+                  101,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "feeConfig"
+              }
+            ],
+            "program": {
+              "kind": "const",
+              "value": [
+                217,
+                168,
+                237,
+                183,
+                0,
+                44,
+                187,
+                171,
+                53,
+                87,
+                202,
+                162,
+                64,
+                131,
+                189,
+                106,
+                187,
+                249,
+                130,
+                171,
+                56,
+                202,
+                127,
+                190,
+                143,
+                121,
+                30,
+                195,
+                25,
+                86,
+                241,
+                242
+              ]
+            }
+          }
+        },
+        {
+          "name": "feeVaultTokenAccount",
+          "docs": [
+            "Fee vault token account for Recipients mode — accumulates quote tokens."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "account",
+                "path": "feeVault"
+              },
+              {
+                "kind": "account",
+                "path": "quoteTokenProgram"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
+              }
+            ],
+            "program": {
+              "kind": "const",
+              "value": [
+                140,
+                151,
+                37,
+                143,
+                78,
+                36,
+                137,
+                241,
+                187,
+                61,
+                16,
+                41,
+                20,
+                142,
+                13,
+                131,
+                11,
+                90,
+                19,
+                153,
+                218,
+                255,
+                16,
+                132,
+                4,
+                142,
+                123,
+                216,
+                219,
+                233,
+                248,
+                89
+              ]
+            }
+          }
+        },
+        {
+          "name": "buybackVault",
+          "docs": [
+            "Buyback vault (for Revoked mode) — accumulates quote tokens for buy-and-burn.",
+            "Initialized during pool creation."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  98,
+                  117,
+                  121,
+                  98,
+                  97,
+                  99,
+                  107,
+                  95,
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "pool"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
+              }
+            ]
+          }
+        },
+        {
+          "name": "authority",
+          "docs": [
+            "Pool vault and LP mint authority."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  118,
+                  97,
+                  117,
+                  108,
+                  116,
+                  95,
+                  97,
+                  110,
+                  100,
+                  95,
+                  108,
+                  112,
+                  95,
+                  109,
+                  105,
+                  110,
+                  116,
+                  95,
+                  97,
+                  117,
+                  116,
+                  104,
+                  95,
+                  115,
+                  101,
+                  101,
+                  100
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "globalConfig",
+          "docs": [
+            "Global configuration for the protocol."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  103,
+                  108,
+                  111,
+                  98,
+                  97,
+                  108,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "creator",
+          "docs": [
+            "Pool creator (needed for fee vault derivation).",
+            "",
+            "NOTE: Validation relies on `has_one = creator` constraint on pool state.",
+            "The creator is whoever signed the original pool creation transaction,",
+            "stored immutably in PoolState. No separate ownership check is needed",
+            "as the pool state is the source of truth for creator identity."
+          ],
+          "relations": [
+            "pool"
+          ]
+        },
+        {
+          "name": "baseMint",
+          "docs": [
+            "The mint of input token."
+          ]
+        },
+        {
+          "name": "quoteMint",
+          "docs": [
+            "The mint of output token."
+          ]
+        },
+        {
+          "name": "feeConfig",
+          "docs": [
+            "The fee configuration for this token (from liquid-fees program).",
+            "base_mint is typically the token that was launched on the bonding curve."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  102,
+                  101,
+                  101,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "baseMint"
+              }
+            ],
+            "program": {
+              "kind": "const",
+              "value": [
+                217,
+                168,
+                237,
+                183,
+                0,
+                44,
+                187,
+                171,
+                53,
+                87,
+                202,
+                162,
+                64,
+                131,
+                189,
+                106,
+                187,
+                249,
+                130,
+                171,
+                56,
+                202,
+                127,
+                190,
+                143,
+                121,
+                30,
+                195,
+                25,
+                86,
+                241,
+                242
+              ]
+            }
+          }
+        },
+        {
+          "name": "liquidState",
+          "accounts": [
+            {
+              "name": "userProperties",
+              "docs": [
+                "User properties from liquid-state."
+              ],
+              "writable": true,
+              "pda": {
+                "seeds": [
+                  {
+                    "kind": "const",
+                    "value": [
+                      117,
+                      115,
+                      101,
+                      114,
+                      95,
+                      112,
+                      114,
+                      111,
+                      112,
+                      101,
+                      114,
+                      116,
+                      105,
+                      101,
+                      115
+                    ]
+                  },
+                  {
+                    "kind": "account",
+                    "path": "user"
+                  }
+                ],
+                "program": {
+                  "kind": "const",
+                  "value": [
+                    6,
+                    161,
+                    216,
+                    199,
+                    206,
+                    40,
+                    40,
+                    163,
+                    177,
+                    19,
+                    1,
+                    21,
+                    164,
+                    67,
+                    81,
+                    132,
+                    164,
+                    22,
+                    81,
+                    177,
+                    201,
+                    45,
+                    170,
+                    138,
+                    70,
+                    214,
+                    218,
+                    76,
+                    85,
+                    222,
+                    216,
+                    214
+                  ]
+                }
+              }
+            },
+            {
+              "name": "globalAmmVolume",
+              "docs": [
+                "Global AMM volume accumulator from liquid-state."
+              ],
+              "writable": true,
+              "pda": {
+                "seeds": [
+                  {
+                    "kind": "const",
+                    "value": [
+                      103,
+                      108,
+                      111,
+                      98,
+                      97,
+                      108,
+                      95,
+                      97,
+                      109,
+                      109,
+                      95,
+                      118,
+                      111,
+                      108,
+                      117,
+                      109,
+                      101
+                    ]
+                  }
+                ],
+                "program": {
+                  "kind": "const",
+                  "value": [
+                    6,
+                    161,
+                    216,
+                    199,
+                    206,
+                    40,
+                    40,
+                    163,
+                    177,
+                    19,
+                    1,
+                    21,
+                    164,
+                    67,
+                    81,
+                    132,
+                    164,
+                    22,
+                    81,
+                    177,
+                    201,
+                    45,
+                    170,
+                    138,
+                    70,
+                    214,
+                    218,
+                    76,
+                    85,
+                    222,
+                    216,
+                    214
+                  ]
+                }
+              }
+            },
+            {
+              "name": "tokenVolume",
+              "docs": [
+                "Token volume accumulator from liquid-state (for base_mint)."
+              ],
+              "writable": true,
+              "pda": {
+                "seeds": [
+                  {
+                    "kind": "const",
+                    "value": [
+                      116,
+                      111,
+                      107,
+                      101,
+                      110,
+                      95,
+                      118,
+                      111,
+                      108,
+                      117,
+                      109,
+                      101
+                    ]
+                  },
+                  {
+                    "kind": "account",
+                    "path": "tokenMint"
+                  }
+                ],
+                "program": {
+                  "kind": "const",
+                  "value": [
+                    6,
+                    161,
+                    216,
+                    199,
+                    206,
+                    40,
+                    40,
+                    163,
+                    177,
+                    19,
+                    1,
+                    21,
+                    164,
+                    67,
+                    81,
+                    132,
+                    164,
+                    22,
+                    81,
+                    177,
+                    201,
+                    45,
+                    170,
+                    138,
+                    70,
+                    214,
+                    218,
+                    76,
+                    85,
+                    222,
+                    216,
+                    214
+                  ]
+                }
+              }
+            },
+            {
+              "name": "user",
+              "docs": [
+                "The user performing the trade."
+              ]
+            },
+            {
+              "name": "tokenMint",
+              "docs": [
+                "The token mint, used for token_volume PDA derivation."
+              ]
+            },
+            {
+              "name": "cashbackConfig",
+              "docs": [
+                "Cashback configuration from liquid-state."
+              ],
+              "pda": {
+                "seeds": [
+                  {
+                    "kind": "const",
+                    "value": [
+                      99,
+                      97,
+                      115,
+                      104,
+                      98,
+                      97,
+                      99,
+                      107,
+                      95,
+                      99,
+                      111,
+                      110,
+                      102,
+                      105,
+                      103
+                    ]
+                  }
+                ],
+                "program": {
+                  "kind": "const",
+                  "value": [
+                    6,
+                    161,
+                    216,
+                    199,
+                    206,
+                    40,
+                    40,
+                    163,
+                    177,
+                    19,
+                    1,
+                    21,
+                    164,
+                    67,
+                    81,
+                    132,
+                    164,
+                    22,
+                    81,
+                    177,
+                    201,
+                    45,
+                    170,
+                    138,
+                    70,
+                    214,
+                    218,
+                    76,
+                    85,
+                    222,
+                    216,
+                    214
+                  ]
+                }
+              }
+            },
+            {
+              "name": "liquidStateProgram",
+              "docs": [
+                "liquid-state program for unified state management."
+              ],
+              "address": "State3HtEfi7cXdsTpAtRoBvrij8zSFCiGTAVWmYH2d"
+            },
+            {
+              "name": "stateEventsCpiAuthority",
+              "docs": [
+                "CPI authority PDA owned by liquid-state for emitting events via liquid-events."
+              ],
+              "pda": {
+                "seeds": [
+                  {
+                    "kind": "const",
+                    "value": [
+                      99,
+                      112,
+                      105,
+                      95,
+                      97,
+                      117,
+                      116,
+                      104,
+                      111,
+                      114,
+                      105,
+                      116,
+                      121
+                    ]
+                  }
+                ],
+                "program": {
+                  "kind": "const",
+                  "value": [
+                    6,
+                    161,
+                    216,
+                    199,
+                    206,
+                    40,
+                    40,
+                    163,
+                    177,
+                    19,
+                    1,
+                    21,
+                    164,
+                    67,
+                    81,
+                    132,
+                    164,
+                    22,
+                    81,
+                    177,
+                    201,
+                    45,
+                    170,
+                    138,
+                    70,
+                    214,
+                    218,
+                    76,
+                    85,
+                    222,
+                    216,
+                    214
+                  ]
+                }
+              }
+            }
+          ]
+        },
+        {
+          "name": "baseTokenProgram",
+          "docs": [
+            "SPL program for input token transfers."
+          ]
+        },
+        {
+          "name": "quoteTokenProgram",
+          "docs": [
+            "SPL program for output token transfers."
+          ]
+        },
+        {
+          "name": "systemProgram",
+          "address": "11111111111111111111111111111111"
+        },
+        {
+          "name": "tokenProgram",
+          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+        },
+        {
+          "name": "associatedTokenProgram",
+          "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
+        },
+        {
+          "name": "cpiAuthority",
+          "docs": [
+            "CPI authority PDA — proves this program's identity in cross-program calls."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  112,
+                  105,
+                  95,
+                  97,
+                  117,
+                  116,
+                  104,
+                  111,
+                  114,
+                  105,
+                  116,
+                  121
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "liquidEventsProgram",
+          "docs": [
+            "Liquid events program for CPI event emission."
+          ],
+          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
+        },
+        {
+          "name": "oraclePriceFeed",
+          "docs": [
+            "Pyth SOL/USD price feed (required for tiered fees)."
+          ],
+          "optional": true
+        }
+      ],
+      "args": [
+        {
+          "name": "amountIn",
+          "type": "u64"
+        },
+        {
+          "name": "minimumAmountOut",
+          "type": "u64"
+        }
+      ]
+    },
     {
       "name": "cancelAdminTransfer",
       "docs": [