フック
useGetSwapQuote
スワップの見積もりを取得するためのフック
インポート
使い方
返り値の型: UseQueryResult<LifiSwapQuote>
このフックは、React Query の UseQueryResult
すべてのプロパティとスワップ見積もりデータを返します。swapQuote の詳細な構造は以下の通りです。
プロパティ
data
SwapQuote | undefined
スワップ見積もりオブジェクト(以下を含む):
currencyAddress
: スワップ対象通貨のアドレスcurrencyBalance
: ユーザーのウォレット内の通貨残高price
: 現在のスワップ価格maxPrice
: スリッページを含むスワップの最大許容価格to
: スワップを処理する対象コントラクトのアドレスtransactionData
: スワップ実行用のエンコード済みトランザクションデータtransactionValue
: トランザクションと一緒に送信される値(ネイティブトークンの場合)approveData
: 承認トランザクションのエンコード済みデータ(includeApprove が true かつ必要な場合)amount
: 受け取る通貨の数量amountMin
: スリッページ後に受け取る最小数量
isLoading
boolean
データ取得時のローディング状態。
isError
boolean
クエリが失敗した場合のエラー状態。
エラー
Error | null
データ取得中に発生したエラー内容。
パラメータ
このフックは2つのパラメータを受け取ります:
引数: GetLifiSwapQuoteArgs
パラメータ | 型 | 説明 |
---|---|---|
params.chainId | number | スワップが行われるチェーンID |
params.walletAddress | string | ユーザーのウォレットアドレス |
params.fromTokenAddress | string | 売却するトークンのアドレス |
params.toTokenAddress | string | 購入するトークンのアドレス |
params.fromTokenAmount | string | (オプション)売却するトークンの数量(wei単位) |
params.toTokenAmount | string | (オプション)購入するトークンの数量(wei単位) |
params.includeApprove | boolean | 承認トランザクションデータを含めるかどうか |
params.slippageBps | number | 許容される最大スリッページ(ベーシスポイント単位、100 = 1%) |
注意: fromTokenAmount
または toTokenAmount
のいずれか一方を必ず指定してください。両方同時には指定できません。
options: HooksOptions
パラメータ | 型 | 説明 |
---|---|---|
disabled | boolean | (オプション)クエリの自動実行を無効にします |
retry | boolean | (オプション)失敗したクエリを再試行するかどうか(デフォルトは true) |