← 返回官网 clawpassport.cc 上一页

上手指南 · CLAW Smart Pass

商户怎么发卡、买家怎么用、推荐人怎么讲 · 更新于 2026-11-15

0. 一页速查

0.1 现在有三套东西,互不干扰

套件 干什么 链上程序 状态
.claw 身份 给 AI 代理发链上身份证 域名 NFT(Metaplex) 已上线
商户收单 客户消费 90/10 分账 BfxjHT4k…ydyEw(底池) 已上线(试点)
商品上链 商户卖的东西变成独立 NFT 卡 2488A99p…aGbZ(Smart Pass) 已上线(主网)

Smart Pass 不碰前两套:不升级底池程序、不动 CLAW、不共用金库、不改任何现有页面。

0.2 八个页面,各给谁用

页面 地址 谁用 需要钱包
总入口(一页看懂) hub.html 所有人 ❌
上手指南(本页) guide.html 商户 / 买家 / 推荐人 ❌
演示 smartpass/ 推荐人给商户演示 ❌
商户版落地页 business.html 发给潜在商户 ❌
发卡 issue.html 商户(建活动) ✅
看板 dashboard.html 商户看数据 ✅(或填地址)
收款 pay.html 买家付款 ✅
核销 redeem.html 商户在柜台 ✅

两个域名都可用:clawpassport.cc/smartpass/… 与 mymxt78.com/smartpass/… 给商户一律用 mymxt78.com——Phantom 对主域名还挂着红条,签名会被拦。

0.3 四个角色分别做什么

角色 一句话职责
平台(你) 出卡(铸 NFT)、配活动、盯链上、处理异常
商户 建活动、看数据、收款、核销
买家 付款、拿到卡、消费
推荐人 演示、讲清楚、带商户进来

1. 商户操作手册

1.0 谁能发卡:两道硬门槛(2026-11-15 起生效)

不是注册就能发卡。 一个钱包必须同时满足两条,发卡页才会解锁:

门槛 怎么判定 能豁免吗
① 持有 .claw NFT 链上查该钱包名下的 Core 资产,铸造方必须是官方 .claw 发行地址 2rWyL1B1…tXJZ 不能。白名单也不豁免这一条
② 已入驻商户(任意档位) 查底池程序的入驻仓位(类型 3),T1/T2/T3 都算 试点期例外:首批免费商户登记在 whitelist.json

为什么这样设计:发卡权不能买卖,只能挣来——先有身份(.claw),再有店面(入驻)。

发卡页会实时显示两项状态: - 通过 → 绿条写明"持有 1 个 .claw / 链上仓位 1 个(1.5 SOL)" - 不通过 → 红条 + 直接给出下一步链接(去铸域名 / 去申请入驻)

平台脚本同样会拦(mint_pass.mjs 铸造前先核验,不合格直接退出)。只有加 --force 才能强行放行,且日志留痕。

⚠️ 当前的实现边界(对外要如实说):这一层是应用层校验。链上程序层面的强制要等下一次合约升级——那时任何绕过页面的尝试都会被程序直接拒绝。现在还不能。


1.0.2 发卡前要准备的素材(商户必读 · 硬要求)

发卡不是"填个名字就行"。每张卡在客人钱包里显示成什么样,全由这三样决定:

素材 硬要求 为什么
① 商品名 链上名称 ≤ 32 字节(中文约 10 个字);更长的完整名称单独给 Metaplex Core 的链上 name 有 32 字节上限,超了铸不进去
② 主图 1:1 正方形、≥1000×1000、PNG 或 JPG、< 2MB、文字离边缘留 10% 钱包一律按正方形裁切,圆角/圆形头像框会切掉边缘
③ 权益说明 可核销几次、有效期多少天、适用门店/范围 这些会写成卡的属性,客人钱包里看得见

可选(不做也能发):档位图(如 S / A / 未中奖)、商户 logo 角标。

不接受的图

我们拿到素材后自动做的事

  1. 生成符合 Metaplex 标准的元数据 JSON(图片地址 + 名称 + 属性)
  2. 校验图片:正方形 / 分辨率 / 体积 / 格式,不合格当场退回,不带病上链
  3. 铸成 Metaplex Core NFT,uri 指向这份 JSON
  4. 客人钱包里显示:你的图 + 商品名 + 次数 / 有效期属性

商户只需回三条消息

商品名:(≤10 个汉字)
主图:(1:1 正方形,1000×1000 以上)
权益:(几次 / 多久 / 有效期几天)

1.1 开工前准备(10 分钟)

① 钱包 - 装 Phantom 或 Solflare 浏览器插件(手机用 App) - 记下钱包地址(以 1–9/A–H 等 base58 字符组成的 44 位串) - 这个地址就是他以后收款、核销、看数据的唯一身份,不要换

② 一点 SOL 付链上费用

用途 数量 说明
建一个活动 ≈ 0.003 SOL 活动账户租金(永久锁定)
出一张卡 ≈ 0.003 SOL Core NFT 租金 + 卡片账户租金
核销一次 ≈ 0.000005 SOL 只是手续费

建议商户钱包里留 0.05 SOL(约 ¥25),够发十几张卡。 第一批三个商户的钱由平台出——你只要把他的钱包地址给我。

③ 确认一件事

"你的客人在用钱包吗?"

答"有"或"一部分有" → 继续。答"没有" → 停止,现在这套不适合他(见 §3.4)。

1.2 建一个活动(发卡页,5 分钟)

打开 mymxt78.com/smartpass/issue.html

步骤 操作 注意
1 点「连接 Phantom」 用商户自己的钱包,不是平台的
2 填商品名 会显示在后台,链上不存名字(名字/图片在链下)
3 填标价(CLAW,可填 0) 仅作展示;实际收款见 §1.5
4 填发行量 这批最多卖几张
5 填每张可核销次数 12 次课填 12;一次性门票填 1
6 填有效期(天) 365 = 一年
7 勾玩法 刮开 / 核销 / 兑奖 / 可转赠(转赠当前只有开关,不能真转)
8 若勾了刮开,填奖励数量 S 级、B 级各几张;剩余名额自动补成"未中奖"
9 点「签发这张卡」 钱包弹窗 → 确认

成功后你会得到:活动地址(Campaign PDA),形如 H2kSeY7k…。

⚠️ 重要:这一步只创建了「活动」,还没有真正「出卡」。 出卡见 §1.4,需要平台执行(下一步会做商户自助)。

售出前后规则差异(务必知道) - 卖出第一张之前:可以重新提交并覆盖奖励分配表(改错了能救) - 卖出第一张之后:奖励表永久锁死,任何人(包括平台)都改不了 - 要改就只能发新批次

1.3 看板怎么用

打开 mymxt78.com/smartpass/dashboard.html,点「连接钱包」或直接粘地址。

看到什么 含义
发行活动 / 总发行量 你建了几个活动、一共印了多少张
已售出 已经登记出卡的张数(不是付款次数)
核销完成度 已用次数 ÷ 总次数,反映真实履约进度
刮开进度条 已刮开 ÷ 已售出
应收 标价 × 已售(CLAW),链上未托管,不是已收款
收款链接 点开就是买家付款页,直接发顾客
核对 跳到 explorer,用链上原始账户自证

数据从哪来:直接读链上账户,不是平台数据库。谁也改不了,包括平台。

1.4 出卡(当前由平台执行)

一张卡 = 铸一枚独立 NFT(资产)+ 在链上登记(凭证)。这两步要花 SOL、要签名, 所以现阶段由平台执行,商户不用自己跑任何命令,只要给三样东西:

你要提供 例子
持卡人钱包地址 9xQ…(顾客的 Phantom 地址)
这张卡几次 3 次
商品名(≤10 个汉字) 招牌拿铁 · 10 杯卡

发完你会拿到三样,都要存好:

  1. 卡片地址(Pass)——看板、核销都靠它
  2. NFT 地址——顾客钱包里看到的那枚资产
  3. 核销链接——柜台入口,直接发到手机收藏

下一版做商户自助出卡(页面里点一下就铸一张),届时这步也不用等人。

1.5 收款(把链接发给顾客)

在看板里点「收款链接」,或在地址后面加参数:

https://mymxt78.com/smartpass/pay.html?campaign=<活动PDA>&sol=0.01

对账方法:在 Phantom 交易记录里看到这笔转入 + 备注里的活动地址,就能对上。

⚠️ 这是直付模式:顾客付了钱、商户不交付,平台无法强制退款。所以先小额试、建立信任后再放量。

1.6 核销(柜台动作,15 秒)

打开 mymxt78.com/smartpass/redeem.html?pass=<卡片地址>

  1. 页面自动读出这张卡:剩余次数、有效期、刮开状态
  2. 点「核销一次」
  3. 第一次要点「连接钱包」(必须是发卡的那个商户钱包)
  4. 再点一次 → 钱包确认 → 完成
  5. 剩余次数立刻减 1,链上留记录

核销不了怎么办

现象 原因 解法
按钮灰掉 次数用完 / 已过期 正常,不能核销
报 NotHolder / 6004 用错了钱包 换回发卡时的商户钱包
报 Unauthorized 同上 同上
找不到卡片 地址粘贴不全 重新复制完整 44 位地址

1.7 商户日常检查清单


2. 买家操作手册

  1. 打开商户发的收款链接(pay.html?campaign=…&sol=…)
  2. 页面显示:价格、活动编号、商户地址、剩余张数
  3. 点「连接钱包付款」→ 第一次连钱包
  4. 再点「确认付款 X SOL」→ 钱包确认
  5. 看到"付款成功"+ 交易链接 = 钱已到商户
  6. 等商户出卡:卡是商户铸给你的,出来后会在你的钱包里看到一枚 NFT
  7. 消费时把 redeem.html?pass=… 链接(商户给的)或钱包里的卡出示给商户

买家要确认的三件事 - 付款对象是商户地址(页面有显示),不是平台 - 交易能在 explorer 上查到 - 拿到卡后,卡的剩余次数能在核销页看到


3. 推荐人手册

3.1 30 秒开场(照读)

"你卖的东西——课程、门票、年卡、套餐——都能变成一张链上卡。 顾客拿到的是他自己的资产,不是你家后台的一条记录。 卖多少、用了多少,你后台一眼看到,谁也改不了。"

3.2 三步演示(全程手机,5 分钟)

步 动作 说什么
1 打开 /smartpass/ → 点「用户视角」→ 点「刮开」 "这就是你顾客看到的。结果在他浏览器里算,和链上同一套算法,商户改不了。"
2 切「商户开通」→ 只改商品名和次数 → 点「生成上链参数」 "你的工作就是填这几格。"
3 打开 dashboard.html 填他地址(或我们的演示活动) "这是你的后台:卖了多少、核销到什么程度。"

收尾拿 explorer 链接:

"这条记录在公链上,任何人都能查。我不会跑,因为跑不掉。"

3.3 五个必答问题

Q:和发券软件有什么区别? 券在商户自己系统里,想改就改;这张卡在链上,规则售前锁死,顾客自己能验。

Q:刮奖算赌博吗? 不算。每张卡里有什么在卖之前就固定并上链,顾客只是不知道自己那张是哪一种——跟球星卡、盲盒手办同类。真随机抽奖是另一回事,需要前置法律意见,首期不做。

Q:没中奖的顾客会不会闹? 不会。基础权益(12 次课)百分之百保留,刮开只影响额外奖励。这条写在合约里。

Q:能联合别的商家一起卖吗? 能。一张卡可以挂多个商家权益,各自独立核销。(分账结算随下一版)

Q:AI 能操作吗? 能查不能付。我们给 AI 开了只读接口(卡、权益、剩余次数)。付款和核销必须本人授权。

3.4 什么商户现在不该做(关键)

问一个问题就筛掉 80%:"你的客人在用钱包吗?"


6. 附录

6.1 链上地址

项 地址
Smart Pass 程序 2488A99p…aGbZ
演示活动(10 张) H2kSeY7krp5KTm96zX6zaAHrzPpEhwaeDucXJUYYrMtF
演示卡片 2jeAjKGGh65z1iFcTEoJBbaVsPve8QwD3VMNvDQB2DNP
底池程序(既有,未改) BfxjHT4ktrZTTmifbxbJz92LCWxwqNqX7bRSpiRydyEw
Metaplex Core CoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d

6.3 费用速查

动作 成本 谁付
建活动 ≈ 0.003 SOL(锁定) 商户
出一张卡 ≈ 0.003 SOL(锁定) 商户 / 平台垫付
买家付款 ≈ 0.000005 SOL 买家
核销 ≈ 0.000005 SOL 商户
程序升级 临时 ≈ 1.2 SOL(退回大半),永久为差额 平台

6.4 现在的边界(对外必须照这个说)


想先在自己的生意上试一张?
首批只接 3 个商户,链上费用我们出。直接说"我想试"就行。 看商户版介绍 →

← 返回官网 clawpassport.cc