ワンクリック取引

ワンクリック取引では、ウォレットで一度だけサインインします。その後は、取引ごとにウォレットで承認しなくても、Saiが取引を送信します。これらの取引にガス代はかかりません。

取引にはSai残高のUSDCを使います。入金、出金、ブリッジでは、引き続きウォレットで通常のトランザクションを承認します。

仕組み

1. 一度サインインします。ウォレットで Enable Sai trading という名前のメッセージに署名します。これはウォレットを管理していることの証明です。トランザクションではないため、資金は移動せず、ガス代もかからず、トークンの使用許可も与えません。
2. 取引します。取引ボタンを押すと、アプリはリクエストをSaiトレーディングエンジンに送ります。Saiトレーディングエンジンは、Saiの取引を動かすサービス群です。開発者向けのデータAPIはSai Keeperとして公開されています。
3. Saiがリクエストを確認します。トレーディングエンジンは、サインイン済みであることとリクエストの内容が正しいことを確認し、コントラクトに対して取引を事前にテストします。
4. Saiがトランザクションを送信します。Sai専用のアカウントがPerpコントラクトに取引を送信し、ガス代を支払います。コントラクトは、あなたのアカウントとしてSai残高を使って取引を実行します。
5. アプリが結果を確認します。取引履歴に取引が表示されると、ポジションが更新されます。

資金は常にSaiのコントラクト内にあります。取引を送信するアカウントは、資金を出金することも、別のアドレスに送ることもできません。

始める前に

• EVMウォレット。ワンクリック取引にはEVMウォレットが必要です。MetaMask、Rabby、Coinbase Wallet、WalletConnect対応ウォレットのほか、Saiアプリでメールやソーシャルログインで作成したウォレットも使えます。Keplr、Leap、CosmostationなどのCosmosウォレットは入金、出金、ブリッジはできますが、取引はできません。ウォレットの設定を参照してください。
• Sai残高のUSDC。ワンクリック取引の担保はUSDCのみです。ウォレット残高ではなく、On Sai の残高と USDC Trading Credits から支払われます。先にUSDCをSaiに入金してください。入金していない場合、アプリに “Deposit funds into Sai before opening this trade.” と表示されます。
• ブラウザのストレージを有効にする。アプリは保留中の取引をブラウザに記録します。一部のプライベートブラウズモードなどでストレージが使えない場合、取引を送信できません。

サインイン

サインインの方法は2つあります。

• 最初の取引時。サインインしていない場合、最初の取引でウォレットが Enable Sai trading メッセージへの署名を求めます。署名すると取引が送信されます。
• 事前にサインイン。ウォレットメニューを開き、Connect trading を選びます。

署名するメッセージには次の内容が含まれます。

• ウォレットアドレス
• 操作名：Enable Sai trading
• 1回限りのコードとその有効期限
• アプリ名 Sai、バージョン1、Nibiru EVMのチェーンID

取引、金額、トークンの使用許可は含まれません。署名リクエストがトークンの承認やトランザクションの送信を求めている場合は、署名しないでください。

メールやソーシャルログインのウォレットを使っている場合、Saiが代わりに署名する前に、Sai独自の確認ダイアログが表示されます。

セッションの有効期間

セッションは、サインイン時にSaiが設定する有効期限まで有効です。期限が切れると、次の取引時に再度署名を求められます。

セッションは、1つのネットワーク上の1つのウォレットアドレスごとに作られます。ウォレットやネットワークを切り替えた場合は、そのウォレットやネットワークで別にサインインします。セッションはこのブラウザに保存されるため、ページを再読み込みしてもサインアウトされません。

注意：現在、セッションを途中で終了するボタンはありません。アプリからのサインアウトやウォレットの切断ではセッションは無効になりません。セッションは有効期限まで有効なままです。このサイトのデータを削除しても、このブラウザからセッションが削除されるだけで、セッション自体は無効になりません。

ワンクリック取引の対象

操作	承認方法
成行、指値、逆指値注文を出す	ワンクリック
ポジションを決済する	ワンクリック
ポジションを一部決済する	ワンクリック
未約定の指値・逆指値注文を取り消す	ワンクリック
利確・損切りを設定、変更、解除する	ワンクリック
保有ポジションのレバレッジを変更する	ワンクリック
保有ポジションの証拠金を追加・削減する	ワンクリック
ワンクリック取引にサインインする	ウォレット署名（ガス代なし）
Saiに入金する	ウォレットのトランザクション
Saiから出金する	ウォレットのトランザクション
ブリッジする	ウォレットのトランザクション

アプリでは、保有ポジションの買い増しや未約定注文の変更はできません。未約定の指値・逆指値注文を変更するには、取り消してから新しい注文を出してください。

利確・損切りの変更、レバレッジの変更、証拠金の変更は、別々に送信してください。アプリはこれらを1つのリクエストにまとめません。

取引の処理中に表示される内容

取引を送信すると、送信内容と時刻が通知に表示されます。

• “Order submitted … Awaiting onchain execution.”：Saiがリクエストを受け付け、送信します。
• “Order submission unconfirmed … Checking status.”：通信の切断などで、アプリが応答を受け取れませんでした。リクエストは受け付けられている可能性があります。アプリは確認を続けますが、再送信はしません。

ポジション一覧にも、Opening…、Closing…、Reducing…、Updating…、Checking status… などで各リクエストの進行状況が表示されます。最近のリクエストとその結果は Activity パネルに表示されます。

保留中のリクエストは、ページを再読み込みしても残ります。自分で再確認するには、ウォレットメニューを開いて Check requests を選びます。

同じ注文が保留中のときに同一の注文を出そうとすると、アプリは “An identical order is still pending. Submit another?” と確認します。これにより、誤って重複注文を出すのを防ぎます。一部決済は、1つのポジションにつき同時に1件までです。

各取引は最大1回だけ実行されます

すべてのリクエストには固有のIDがあります。Perpコントラクトは実行した各IDを記録し、同じIDの再実行を拒否します。結果が不明な場合でも、アプリがリクエストを自動で再送信することはありません。失敗したリクエストは実行されていないため、新しいリクエストとして取引を再送信できます。

問題が起きたとき

表示	意味	対処方法
”Trading sign-in canceled. No order was submitted.”	ウォレットでサインインのリクエストを拒否しました。	もう一度取引し、Enable Sai trading メッセージに署名してください。
“Trading sign-in failed. Please try again.”	ウォレットまたはネットワークの問題でサインインを完了できませんでした。	再試行してください。失敗が続く場合は、ウォレットを接続し直してください。
“Connect an EVM wallet to trade. Cosmos wallets can still deposit, withdraw, and bridge funds.”	Cosmosウォレットで接続しています。	取引するにはEVMウォレットを接続してください。Cosmosウォレットでも入金、出金、ブリッジはできます。
“Deposit funds into Sai before opening this trade.”	Sai残高がこの取引に足りません。	USDCをSaiに入金してから再試行してください。
“One-click trading is unavailable on this deployment” または “trading execution is disabled”	このネットワークでは現在ワンクリック取引が停止しています。	時間をおいて再試行してください。
“The connected wallet or network changed. Review the action again.”	送信中にウォレットまたはネットワークを切り替えました。	取引内容を確認して再送信してください。
“This position changed. Review the reduction again.”	サインイン中にポジションが変わりました。	新しいポジションを確認して再送信してください。
リクエストが “Trade request failed” として失敗と表示され、ほかに詳細がない	Saiは取引を送信しませんでした。多くの場合、Saiが受信後2分以内に取引を送信できず、リクエストが期限切れになっています。何も実行されていません。	現在の価格を確認し、取引を再送信してください。
リクエストがコントラクトのエラーとともに失敗と表示される	Saiは送信前にすべての取引をコントラクトに対してテストします。現在の価格と残高またはポジションでは取引がチェックを通らなかったか、ネットワークに拒否されました。取引は実行されていません。	取引内容、残高、市場の状況を確認し、再送信してください。
“rate limit exceeded” で始まるエラー	短時間にリクエストが多すぎました。	1分ほど待ってから再試行してください。
ポジションに Checking status… が長く表示される	アプリがまだ最終結果を確認できていません。送信時にSaiから明確な応答を受け取れなかった場合（通信の切断や一部のレート制限エラーなど）にも表示されます。	次の取引の前に、ウォレットメニューで Check requests を選んでください。

失敗したリクエストは、エラーメッセージとともに Activity パネルに表示されます。失敗したリクエストによって、ポジションや残高が変わることはありません。

手数料とガス代

ワンクリック取引にガス代はかかりません。Sai専用のアカウントがトランザクションを送信します。新規・決済手数料などの通常の取引手数料はかかります。手数料を参照してください。

セキュリティ

セッションで許可されること。サインインすると、Saiトレーディングエンジンは上の表の取引操作を、あなたのSai残高を使ってあなたのアカウントで送信できます。トレーディングエンジンは、あなたがアプリでリクエストした取引だけを送信します。各取引は、他の取引と同じくPerpコントラクトによって担保やレバレッジの上限などがチェックされます。

許可されないこと。ワンクリック取引を送信するアカウントには、資金の出金、別のアドレスへの残高の送金、コントラクト設定の変更を行う権限がありません。ポジションを決済または縮小すると、その代金はSai残高に戻ります。Saiから資金を移すには、必ずウォレットでトランザクションを承認する必要があります。

信頼する対象。ワンクリック取引では、ウォレットが取引ごとに署名することはありません。コントラクトは、トレーディングエンジンがあなたのリクエストした取引だけを送信することを前提としています。トレーディングエンジンはリクエストのたびにセッションを確認します。

セッションを安全に保つには

• Enable Sai trading メッセージには、公式のSaiアプリでのみ署名してください。
• 共有パソコンや公共のパソコンではサインインしないでください。サインインした場合は、使い終わったらそのブラウザでこのサイトのデータを削除してください。これでそのブラウザからセッションは削除されますが、セッション自体は有効期限まで有効です。
• 秘密鍵やシードフレーズは絶対に共有しないでください。サインインメッセージがそれらを求めることはありません。

よくある質問

取引のたびにサインインし直す必要がありますか？ いいえ。1回の署名で、そのウォレットとネットワークでの取引がセッションの有効期限まで有効です。

サインインに費用はかかりますか？ いいえ。メッセージへの署名は無料で、トランザクションではありません。

取引ごとにウォレットで承認することはできますか？ いいえ。Saiアプリでの取引はワンクリック取引で行われます。入金、出金、ブリッジには引き続きウォレットを使います。

“Order submitted” と表示されたら取引は完了していますか？ まだです。Saiがリクエストを受け付けたという意味です。取引履歴に取引が表示されると、ポジションが更新されます。

取引の処理中にタブを閉じたらどうなりますか？ Saiは受け付けたリクエストを引き続き処理します。戻ると、アプリが保留中のリクエストの状態を確認し、ポジションを更新します。

複数の端末で取引できますか？ はい。ブラウザや端末ごとに一度サインインしてください。

取引リクエストは非公開ですか？ いいえ。ブロックチェーン上の取引と同じく、取引リクエストの状態はウォレットアドレスで誰でも確認できます。