在你的頁面上鑄造
從你自己的頁面銷售 KURV 系列有兩種方式。兩種都支援 Base 和 Solana,鏈上的每一項費用、價格和銷售規則依然適用:同一個合約或程式收取同樣的款項。
| 你想要 | 使用 |
|---|---|
| 貼上一行程式碼,就有一個「鑄造」按鈕 | 「鑄造」按鈕:買家在 KURV 視窗中核准 |
| 用你自己的錢包連接器,讓買家留在你的頁面上 | KURV 用戶端:買家在自己的錢包中核准 |
用 84532(Base Sepolia)或 solana:devnet(Solana Devnet)指定網路。系列地址可以在公開 API 中找到。
「鑄造」按鈕
「「鑄造」按鈕」段落<div id="mint" data-kurv-mint data-chain="84532" data-address="0x8354d02d8022f455db9acb235c6f6655c8adabd3"></div><script src="https://testnet.kurv.fun/sdk/mint-button/v1.js" async></script><script> document.getElementById('mint').addEventListener('kurv:mint', (event) => { if (event.detail.status === 'minted') console.log(event.detail.tx, event.detail.tokenIds); });</script>按一下就會開啟一個 KURV 視窗。買家在那裡用 KURV 帳戶或錢包簽署,你的頁面完全不會碰到錢包或金鑰。用 data-label、data-background 和 data-color 設定你自己的文字和顏色。如果你的網站有送出 Content-Security-Policy,請在 script-src 中允許 https://testnet.kurv.fun。
視窗會先向你的頁面打招呼,只有你的頁面從它自己的來源回應時,視窗裡才會顯示網站名稱。接著視窗會切斷和你頁面的連結,所以頁面上的任何東西都碰不到正在簽署的視窗。回覆來自 KURV 的來源,用那次按下時產生的隨機值來核對,而且只送給你頁面的來源,然後指令碼會在該元素上觸發 kurv:mint:
status | 意思 |
|---|---|
minted | 鑄造已完成:chain、collection、tx、tokenIds、quantity。如果買家花了很久才登入,它可能會出現在 closed 之後 |
closed | 視窗有一段時間沒有任何動靜,也沒有鑄造。KURV 從不說明原因 |
blocked | 瀏覽器拒絕開啟視窗。請買家允許開啟 |
對於沒有鑄造的買家,你的頁面什麼都不會知道:不知道他們的錢包,也不知道他們是否在白名單上。買家只能在 KURV 的頁面上看到這些答案。
送出 Cross-Origin-Opener-Policy: same-origin 的網站無法回應這聲招呼:鑄造和回覆仍然有效,但視窗裡不會顯示網站名稱。請改用 same-origin-allow-popups。在你自己的伺服器從鏈上讀到 tx 之前,請把它當作一個尚待確認的說法。
KURV 用戶端
「KURV 用戶端」段落一個沒有任何相依套件的 ES 模組,型別就放在旁邊的 v1.d.ts。它向公開 API 索取最新報價和給這位買家的確切呼叫(包含白名單證明),再交給買家的錢包。
import { createKurvClient, eip1193Wallet } from 'https://testnet.kurv.fun/sdk/client/v1.js';
const kurv = createKurvClient();const [account] = await window.ethereum.request({ method: 'eth_requestAccounts' });
const result = await kurv.mint({ chain: '84532', address: '0x8354d02d8022f455db9acb235c6f6655c8adabd3', wallet: eip1193Wallet(window.ethereum, account), quantity: 1, // Show the buyer the amounts, and answer false to sign nothing. review: (plan) => confirm(`Pay at most ${plan.quote.max_total_base_units} base units?`),});在 Solana 上,請使用 Wallet Standard 錢包。KURV 只為新藏品自己的帳戶簽署,錢包則以買家身分簽署並付款。網路手續費和帳戶租金以 SOL 計算。
import { createKurvClient, walletStandardWallet } from 'https://testnet.kurv.fun/sdk/client/v1.js';
const kurv = createKurvClient();const result = await kurv.mint({ chain: 'solana:devnet', address: collectionAddress, wallet: walletStandardWallet(wallet, account, 'solana:devnet'),});任何連接器都可以用:evmWallet 和 solanaWallet 只要幾行就能包裝你自己的連接器。用戶端永遠看不到金鑰。
kurv.prepareMint({ chain, address, wallet, quantity }) 會傳回方案,但不簽署任何東西,而這個方案就是報價:目前的 quote.total_base_units,以及 quote.max_total_base_units,也就是這位買家最多可能被收取的系列代幣金額,由合約或程式強制執行。帶有第二種代幣的銷售時段,還會用那種代幣另外收取 quote.additional_total_base_units,網路手續費另計。以漲價方式銷售的系列,會簽署比報價略高的金額,這樣即使別人的鑄造先完成,也不會讓這位買家的鑄造失敗。
同一個方案也能透過 HTTP 取得,不需要帳戶,也不需要金鑰:
curl -X POST https://testnet.kurv.fun/api/v1/collections/84532/0x8354d02d8022f455db9acb235c6f6655c8adabd3/mint-call \ -H 'content-type: application/json' \ -d '{"wallet":"0xYourBuyer","quantity":1}'error.code | 意思 | 怎麼處理 |
|---|---|---|
not_on_allowlist | 這個銷售時段只開放給它的白名單 | 告訴買家 |
not_open | 系列目前沒有在銷售 | 根據系列紀錄顯示它的下一個時段 |
use_window | 拍賣,或需要第二種代幣的後續時段 | 開啟 error.window_url |
rate_limited | 來自這個網路的請求太多 | 稍後再試 |
mint_paused | HTTP 410(MintPausedAfterTakedown):這次鑄造會發出的某件藏品因權利檢舉而被下架,所以鑄造已暫停,也沒有收取任何費用 | 告訴買家。持有者仍可在 KURV 上賣回、領取和取得退款 |
一個可以運作的頁面
「一個可以運作的頁面」段落把它存成任何 https 網站上的檔案,或從你自己的電腦提供,然後按下按鈕。需要一個在 Base Sepolia 上的瀏覽器錢包。
<!doctype html><meta charset="utf-8"><title>Mint</title><button id="mint">Mint</button><p id="said" role="status"></p><script type="module"> import { createKurvClient, eip1193Wallet } from 'https://testnet.kurv.fun/sdk/client/v1.js';
const kurv = createKurvClient(); const said = document.getElementById('said');
document.getElementById('mint').addEventListener('click', async () => { try { const [account] = await window.ethereum.request({ method: 'eth_requestAccounts' }); const result = await kurv.mint({ chain: '84532', address: '0x8354d02d8022f455db9acb235c6f6655c8adabd3', wallet: eip1193Wallet(window.ethereum, account), review: (plan) => confirm(`Pay at most ${plan.quote.max_total_base_units} base units?`), }); said.textContent = result.status === 'minted' ? `Minted: ${result.tx}` : 'Nothing was signed.'; } catch (error) { said.textContent = error.message; } });</script>尚未揭曉的作品在這整個過程中都保持封存:API 只回答呼叫和金額,絕不會給出封存系列的檔案。請參閱風險與免責聲明。
此處內容均不構成財務建議。在鑄造、購買或賣回之前,請先閱讀風險與免責聲明。返回 kurv.fun。隱私權政策。使用條款。 。