Relay / 錢包 KV開啟 V1 網站 ↗
V1 · 錢包操作手冊

自己的資料,
自己核對與授權。

從一筆公開資料開始。需要保密時,再設定私密資料;每次寫入都由你的錢包確認。

手冊另開分頁。讀完請切回原分頁,保留正在填寫的內容。

01 連接並登入確認這次使用的錢包帳戶。
02 填寫與核對選操作,核對名稱和內容。
03 簽署並等候最終確認後,再查詢結果。

1. 連接與登入

  1. 按「連接錢包」,在錢包選擇要使用的帳戶。
  2. 依畫面核對登入內容,再簽署登入。這次簽署用來驗證身分。
  3. 確認網站上方「已登入」的地址。切换帳戶後,重新登入對應帳戶。

登入有到期時間;到期會返回登入畫面。資料仍在,但私密功能可能需要重新匯入復原套件。測試網路請使用本次提供的 RPC;相同鏈 ID 的兩個本機環境也可能是完全不同的鏈。

2. 新增、修改或刪除公開資料

公開資料任何人都可能讀到;刪除目前資料不會抹去鏈上歷史。請勿填入密碼或其他秘密。

  1. 從「我的資料」開始,選擇新增,或從已有資料選擇修改/刪除。
  2. Key 使用可讀名稱,例如 note1。大小寫不同就是不同名稱。
  3. 填寫內容。一般文字選 UTF-8;hex 是進階輸入格式,每個 byte 用兩位十六進位數字。
  4. 核對授權中的操作、帳戶、Key 與內容,確認後在錢包簽署。
  5. 看到「已最終確認,操作完成」後,回到資料列表查詢。

內容最多 32 bytes;中文與 emoji 可能佔多個 bytes,請以輸入提示為準。空文字是有效的空內容,與刪除不同;刪除必須選「刪除」,不使用內容欄位。

3. 第一次使用私密資料

展開:備份與綁定步驟

進入「私密資料與分享」。第一次需建立本機加密身分:依序產生復原套件、下載保存、重新選取下載的檔案驗證備份,再核對並簽署公鑰綁定。

復原套件含有解密所需的秘密,請自行安全保存,不要傳給他人。網站不要求錢包私鑰,也無法替你找回遺失的加密秘密。

已有套件時選匯入,不要重新產生。套件必須符合目前錢包、網路與合約;新的隔離測試部署可能需要新的套件。建議檔名標示帳戶和測試環境,避免混用。

4. 使用私密資料

  1. 「我要」選「新增/修改/刪除」,接著先選操作。
  2. 選可讀名稱並輸入 Key,例如 secret1。新增用未存在名稱;修改/刪除用已存在名稱。
  3. 新增或修改時填明文,需要比對時使用明文顯示切換;刪除不需要明文。
  4. 按「本機加密並檢視操作授權」,核對可讀名稱、帳戶與明文,再簽署。
  5. 完成後選「讀取並解密」,輸入同一個可讀名稱,按「讀取並在本機解密」。確認解密內容與版本。

名稱會轉為鏈上 Key 雜湊,不能從雜湊反推名稱。目前頁面只保留已知名稱,重新登入後可能需自行輸入。私密明文同樣最多 32 bytes;本機加密後才傳送,密文、owner、Key 雜湊、更新時間和分享對象仍會公開。

5. 分享給另一個錢包

  1. 接收方先登入自己的帳戶,完成私密加密身分設定與公鑰綁定。
  2. 資料擁有者登入,在「我要」選「分享指定版本」,填寫資料 Key、接收方完整錢包地址與到期時間,核對版本後簽署。
  3. 接收方登入,選「讀取別人分享的資料」,輸入資料擁有者地址與完整 bytes32 Key。這裡的 owner 是分享者,不是接收者。

分享只涵蓋授權的指定版本。你更新資料後,對方不會自動取得新版;需要另行分享。要停止提供該分享,擁有者選「撤銷分享」,填對應對象與版本,核對後簽署。

撤銷或到期會阻止重新取得分享,但不能收回對方已保存的明文或金鑰。

6. 匯出、進度與額度

一般資料匯出中的私密內容是密文。「匯出明文」會在本機解密後下載,請像秘密文件一樣保存。NDJSON 每行是一筆 JSON;plaintextUtf8 是可解碼的文字,plaintextHex 是原始內容的十六進位表示。匯出是當時快照,不會隨後續修改更新。

送出後先查看交易進度。只有最終確認才表示操作完成;逾時或狀態不明時先「重新查詢進度」或查看「操作紀錄」,避免反覆簽署。

「額度」分別計算儲存筆數、寫入次數與 Gas 預算。修改不增加儲存筆數,但修改、刪除及取消仍可能消耗代送額度。多錢包不代表多個人。

7. 遇到問題時

按鈕不能按、資料找不到,或登入過期?
  • 按鈕是灰色:查看欄位旁的提示,補上 Key 或縮短內容。超長內容不會進入授權步驟。
  • 此 Key 不存在:核對網站登入地址、可讀名稱大小寫及 Key 編碼;若確實要建立資料,改選新增。
  • 無法取得分享:核對資料 owner、Key、接收帳戶與指定版本;分享也可能已撤銷或到期。
  • 復原套件屬於其他錢包/網路或合約:選取符合目前環境的原套件,不要修改套件內容繞過檢查。
  • 錢包查不到合約資料:核對這次測試的 RPC,不能只看網路名稱或鏈 ID。
  • 取消錢包簽署:這次簽署未完成,回到表單檢查後再決定是否重試。
  • 登入已過期:重新登入。完成過的資料操作不需重做。

需要回報時提供當時操作、錯誤訊息及查詢代碼即可;不要附復原套件、私鑰或私密明文。