nakazanie-ton/myrocket

xRocket Exchange

使用語義化的 xRocket MCP 工具。保持公開分析的速度，並確保所有私人或金融操作在失敗時安全關閉。

安全啟動

1. 識別要求的環境與操作。環境在 MCP 伺服器啟動時即固定：當使用者未指定時，要求使用測試網配置的伺服器，並在任何寫入操作前驗證工具回傳的 environment。
2. 使用 public 取得市場資料。僅在需要帳戶狀態時使用 private-read。僅在使用者明確要求支援的金融操作時使用 full。
3. 絕不要在聊天中請求 API 令牌或將其作為工具參數傳遞。如果私人工具不可用，請說明所需的環境配置，不要索取密鑰。
4. 閱讀 references/api-map.md 以選擇工具。在進行任何寫入操作前，閱讀 references/safety.md；遇到錯誤時閱讀 references/errors.md；進行多步驟操作時閱讀 references/advanced-workflows.md。

公開市場工作流程

1. 在分析之前，使用 xrocket_market_symbols 或 xrocket_asset_info 解析資產/交易對。
2. 只獲取所需的證據：報價、訂單簿快照、交易、K 線、匯率或交易費用。
3. 保留時間戳記與十進位字串。標記過時或遺失的欄位；不要合成資金費率、未平倉量、倉位、槓桿或衍生性商品資料，因為經審計的 API 並未提供這些資料。
4. 將結果描述為 xRocket REST 快照，而非即時 WebSocket 串流。

私人資料讀取工作流程

1. 確認使用者想要查看其帳戶資料，且已在本機配置 private-read 或 full 環境。
2. 使用 xrocket_account_balances、xrocket_orders、xrocket_transfers、xrocket_withdrawals 或 xrocket_withdrawal_quotas。
3. 在回答中最小化資訊揭露。不要顯示 Bearer 令牌、完整的提現地址或不相關的帳戶資料。
4. 區分交易與資金餘額。僅將 Exchange 內部轉帳描述為 funding ↔ trading 的內部移轉。

金融寫入工作流程

絕不要直接跳至執行工具。

1. 讀取當前的交易對/資產規則、相關餘額，以及（如果適用的話）提現配額。
2. 每個新訂單、內部轉帳或提現都需要一個唯一的客戶端識別碼。取消訂單則可透過 orderId 來識別現有訂單。
3. 呼叫對應的 *_prepare 工具並檢查其準確的預覽。
4. 呈現環境、操作、資產/交易對/網路、方向/買賣方、十進位數量/金額/資金、價格/停損價、費用/預估值、目的地/帳戶以及客戶端識別碼。要求使用者明確核准該預覽。
5. 僅在使用者目前核准後才執行，並僅傳入回傳的短期有效 approvalReceipt。伺服器會擷取確切的儲存意圖；不要重新提交或重建請求內容。
6. 透過客戶端識別碼回讀狀態。若遇到超時/斷線/上游回應不明確的情況，請報告結果未知，並在提出再次嘗試前先進行調和。絕不要自動重試寫入操作。

主網需要使用者另外做出明確決定，並設定 XROCKET_ALLOW_MAINNET_WRITES=true。先前的測試網核准並不能授權主網操作。

存款與入門引導

經審計的 Exchange API 沒有存款地址端點。請不要發明或接受未經驗證的地址。請使用 xrocket_onboarding_links 取得 UI 操作說明，揭露其號召性按鈕包含推薦碼 kaban，且可能使維護者受益，然後在使用者完成存款後重新整理資金餘額。

切勿將推薦碼附加到 API、WebSocket、文件、程式碼儲存庫、支援或 MCP URL 中。由專案管理的生產環境及測試網機器人號召性按鈕（由該工具回傳）均使用 start=kaban 負載；請不要發明其他形式的推薦 URL。

硬性界限

• 不要將 Exchange 內部轉帳視為使用者對使用者的付款。xRocket Pay 是一個獨立的產品，無法透過這些工具使用。
• 不要將金融十進位字串強制轉換為二進位浮點數。
• 不要聲稱支援訂單簿差值重建、重播或私人事件完整性；0.1.0 版本僅提供 REST 快照。
• 不要將不支援的報價/交易行為從教學文件複製到 API 呼叫中。
• 如果目前的 Exchange 中繼資料要求使用 TONCOIN，則不要使用 TON 作為資產識別碼；網路 TON 與資產 TONCOIN 是不同的欄位。
• 不要在公開、未經身份驗證的 MCP 端點後部署私人/寫入設定檔。