已有品牌網站?讓 AI 替你串接
如果你的店已經有自己的官網或 App,不需要換掉它——把下面這段 prompt 貼給 Claude Code、Codex、Cursor 等 AI 開發工具,讓它直接在你的程式碼裡加上 「🎙 嘴付下單」。我們也提供 llms.txt 給 AI 工具自動讀取協議摘要。
事前準備(2 分鐘)
- 到 chuiprotocol.com「我要開店」完成開店(用
Slush 錢包簽名——還沒裝?Chrome 擴充功能/
iOS App),
記下你的
merchant_id(也可事後從 GET /v1/merchants 查到)。 - 在你的品牌網站 repo 裡開啟 AI 開發工具(如
claude或codex)。 - 複製下方 prompt、把第一行的
merchant_id換成你的,貼上送出。
複製這段 prompt
我的 merchant_id 是:__在此填入你的 merchant_id__(嘴付開店後取得)
請在我這個網站專案裡加入「嘴付(Chui Protocol)語音點餐」整合,讓顧客在我的
品牌網站上就能語音下單、以 Sui Testnet USDC 付款給我。要求如下:
## 背景
- 嘴付協議是「語音點餐+鏈上支付」協議。API 文件:
https://chuiprotocol.com/developers/ (機器可讀摘要:https://chuiprotocol.com/llms.txt)
- Hub Base URL:https://hub.chuiprotocol.com(免金鑰、CORS 全開、全部 JSON)
- 參考實作(真實店家串接範例,MIT 開源):
https://github.com/chuiprotocol/chui-app 的 apps/merchant-a(品牌官網串 Hub API)
與 packages/chui-web(語音循環/錢包結帳的可重用核心)
## 要做的事
1. 在網站顯眼處加一顆「🎙 嘴付下單」按鈕與簡單的對話面板。
2. 點餐流程(全部呼叫 Hub API,不需要自建後端):
a. GET /v1/merchants/{merchant_id}/menu 取得菜單(顯示品項與價格)。
b. 顧客輸入或語音說出餐點後,POST /v1/orders/parse
(multipart/form-data:text=顧客的話、merchant_id=我的 id;
若做語音就錄音後改傳 audio 欄位)。
- 200:顯示 readback.text(覆誦)與 quote.total,請顧客確認。
- 422 CLARIFICATION_NEEDED:把 question 顯示給顧客重新回答,絕不擅自猜測。
c. 顧客確認後 POST /v1/orders/confirm(body: {"order_id": ...}),
拿到 checkout 參數(package_id/module/function/coin_type/
amount_units/merchant_address/order_digest_hex)。
d. 用 @mysten/dapp-kit(或 @mysten/sui + Slush 錢包)組交易:
呼叫 Move 函式 {package_id}::{module}::{function},型別參數=coin_type,
引數=[coinWithBalance(amount_units), merchant_address,
bytes(order_digest_hex)],請顧客的錢包簽名送出。
e. 送出後 POST /v1/orders/{order_id}/settlement(body: {"tx_digest": ...})
讓 Hub 做鏈上驗證;輪詢 GET /v1/orders/{order_id} 直到 status=paid,
顯示取餐單號(merchant_ref)。
3. 錯誤處理採「誠實失敗」:任何 API 錯誤都把 detail.message 誠實顯示給顧客,
不偽造成功、不無聲重試超過 1 次。
## 限制與紀律
- 只用 Sui **Testnet**(checkout.network 會是 "testnet";若不是,中止並警告)。
- 金額一律用 API 回傳的整數 amount_units,不自行計算或四捨五入。
- 不要引入後端伺服器;純前端即可完成(Hub CORS 全開)。
- 不要動我網站既有功能與樣式系統;新增程式碼放獨立模組/元件。
- 完成後給我一份測試步驟:如何用測試 USDC(https://faucet.circle.com 領)
在本機跑通「說一句話 → 錢包簽名 → 顯示取餐單號」全流程。
AI 做完後,怎麼驗收
- 網站能列出你的菜單(來自
GET /v1/merchants/{id}/menu)。 - 輸入「珍奶無糖少冰」能得到覆誦與總價;輸入模糊句子會被反問而不是亂猜。
- 確認後跳出 Slush 錢包簽名,金額與報價一致(Testnet USDC)。
- 付款後顯示取餐單號,且你的 嘴付店家後台同步跳出這筆訂單。
- 關掉網路或亂填資料時,畫面顯示的是誠實的錯誤訊息,不是假成功。
💡 有舊 POS 系統?另一條路是 adapter 模式——舊系統一行不改,
由 adapter 翻譯協議訊息。把
快樂鹽酥雞
adapter 範例丟給你的 AI 工具照抄即可,詳見
API 文件的 adapter 章節。