| 套件 | 干什么 | 链上程序 | 状态 |
|---|---|---|---|
| .claw 身份 | 给 AI 代理发链上身份证 | 域名 NFT(Metaplex) | 已上线 |
| 商户收单 | 客户消费 90/10 分账 | BfxjHT4k…ydyEw(底池) |
已上线(试点) |
| 商品上链 | 商户卖的东西变成独立 NFT 卡 | 2488A99p…aGbZ(Smart Pass) |
已上线(主网) |
Smart Pass 不碰前两套:不升级底池程序、不动 CLAW、不共用金库、不改任何现有页面。
| 页面 | 地址 | 谁用 | 需要钱包 |
|---|---|---|---|
| 总入口(一页看懂) | hub.html | 所有人 | ❌ |
| 上手指南(本页) | guide.html | 商户 / 买家 / 推荐人 | ❌ |
| 演示 | smartpass/ | 推荐人给商户演示 | ❌ |
| 商户版落地页 | business.html | 发给潜在商户 | ❌ |
| 发卡 | issue.html | 商户(建活动) | ✅ |
| 看板 | dashboard.html | 商户看数据 | ✅(或填地址) |
| 收款 | pay.html | 买家付款 | ✅ |
| 核销 | redeem.html | 商户在柜台 | ✅ |
两个域名都可用:clawpassport.cc/smartpass/… 与 mymxt78.com/smartpass/…
给商户一律用 mymxt78.com——Phantom 对主域名还挂着红条,签名会被拦。
| 角色 | 一句话职责 |
|---|---|
| 平台(你) | 出卡(铸 NFT)、配活动、盯链上、处理异常 |
| 商户 | 建活动、看数据、收款、核销 |
| 买家 | 付款、拿到卡、消费 |
| 推荐人 | 演示、讲清楚、带商户进来 |
不是注册就能发卡。 一个钱包必须同时满足两条,发卡页才会解锁:
| 门槛 | 怎么判定 | 能豁免吗 |
|---|---|---|
| ① 持有 .claw NFT | 链上查该钱包名下的 Core 资产,铸造方必须是官方 .claw 发行地址 2rWyL1B1…tXJZ |
不能。白名单也不豁免这一条 |
| ② 已入驻商户(任意档位) | 查底池程序的入驻仓位(类型 3),T1/T2/T3 都算 | 试点期例外:首批免费商户登记在 whitelist.json |
为什么这样设计:发卡权不能买卖,只能挣来——先有身份(.claw),再有店面(入驻)。
发卡页会实时显示两项状态: - 通过 → 绿条写明"持有 1 个 .claw / 链上仓位 1 个(1.5 SOL)" - 不通过 → 红条 + 直接给出下一步链接(去铸域名 / 去申请入驻)
平台脚本同样会拦(mint_pass.mjs 铸造前先核验,不合格直接退出)。只有加 --force 才能强行放行,且日志留痕。
⚠️ 当前的实现边界(对外要如实说):这一层是应用层校验。链上程序层面的强制要等下一次合约升级——那时任何绕过页面的尝试都会被程序直接拒绝。现在还不能。
发卡不是"填个名字就行"。每张卡在客人钱包里显示成什么样,全由这三样决定:
| 素材 | 硬要求 | 为什么 |
|---|---|---|
| ① 商品名 | 链上名称 ≤ 32 字节(中文约 10 个字);更长的完整名称单独给 | Metaplex Core 的链上 name 有 32 字节上限,超了铸不进去 |
| ② 主图 | 1:1 正方形、≥1000×1000、PNG 或 JPG、< 2MB、文字离边缘留 10% | 钱包一律按正方形裁切,圆角/圆形头像框会切掉边缘 |
| ③ 权益说明 | 可核销几次、有效期多少天、适用门店/范围 | 这些会写成卡的属性,客人钱包里看得见 |
可选(不做也能发):档位图(如 S / A / 未中奖)、商户 logo 角标。
商品名:(≤10 个汉字)
主图:(1:1 正方形,1000×1000 以上)
权益:(几次 / 多久 / 有效期几天)
① 钱包
- 装 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)。
打开 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,需要平台执行(下一步会做商户自助)。
售出前后规则差异(务必知道) - 卖出第一张之前:可以重新提交并覆盖奖励分配表(改错了能救) - 卖出第一张之后:奖励表永久锁死,任何人(包括平台)都改不了 - 要改就只能发新批次
打开 mymxt78.com/smartpass/dashboard.html,点「连接钱包」或直接粘地址。
| 看到什么 | 含义 |
|---|---|
| 发行活动 / 总发行量 | 你建了几个活动、一共印了多少张 |
| 已售出 | 已经登记出卡的张数(不是付款次数) |
| 核销完成度 | 已用次数 ÷ 总次数,反映真实履约进度 |
| 刮开进度条 | 已刮开 ÷ 已售出 |
| 应收 | 标价 × 已售(CLAW),链上未托管,不是已收款 |
| 收款链接 | 点开就是买家付款页,直接发顾客 |
| 核对 | 跳到 explorer,用链上原始账户自证 |
数据从哪来:直接读链上账户,不是平台数据库。谁也改不了,包括平台。
一张卡 = 铸一枚独立 NFT(资产)+ 在链上登记(凭证)。这两步要花 SOL、要签名, 所以现阶段由平台执行,商户不用自己跑任何命令,只要给三样东西:
| 你要提供 | 例子 |
|---|---|
| 持卡人钱包地址 | 9xQ…(顾客的 Phantom 地址) |
| 这张卡几次 | 3 次 |
| 商品名(≤10 个汉字) | 招牌拿铁 · 10 杯卡 |
发完你会拿到三样,都要存好:
下一版做商户自助出卡(页面里点一下就铸一张),届时这步也不用等人。
在看板里点「收款链接」,或在地址后面加参数:
https://mymxt78.com/smartpass/pay.html?campaign=<活动PDA>&sol=0.01
sol=0.01 是这一单的 SOL 价格,由商户自己定smartpass:<活动>:<序号>,便于对账对账方法:在 Phantom 交易记录里看到这笔转入 + 备注里的活动地址,就能对上。
⚠️ 这是直付模式:顾客付了钱、商户不交付,平台无法强制退款。所以先小额试、建立信任后再放量。
打开 mymxt78.com/smartpass/redeem.html?pass=<卡片地址>
核销不了怎么办
| 现象 | 原因 | 解法 |
|---|---|---|
| 按钮灰掉 | 次数用完 / 已过期 | 正常,不能核销 |
报 NotHolder / 6004 |
用错了钱包 | 换回发卡时的商户钱包 |
报 Unauthorized |
同上 | 同上 |
| 找不到卡片 | 地址粘贴不全 | 重新复制完整 44 位地址 |
sol= 价格是否要调整pay.html?campaign=…&sol=…)redeem.html?pass=… 链接(商户给的)或钱包里的卡出示给商户买家要确认的三件事 - 付款对象是商户地址(页面有显示),不是平台 - 交易能在 explorer 上查到 - 拿到卡后,卡的剩余次数能在核销页看到
"你卖的东西——课程、门票、年卡、套餐——都能变成一张链上卡。 顾客拿到的是他自己的资产,不是你家后台的一条记录。 卖多少、用了多少,你后台一眼看到,谁也改不了。"
| 步 | 动作 | 说什么 |
|---|---|---|
| 1 | 打开 /smartpass/ → 点「用户视角」→ 点「刮开」 |
"这就是你顾客看到的。结果在他浏览器里算,和链上同一套算法,商户改不了。" |
| 2 | 切「商户开通」→ 只改商品名和次数 → 点「生成上链参数」 | "你的工作就是填这几格。" |
| 3 | 打开 dashboard.html 填他地址(或我们的演示活动) |
"这是你的后台:卖了多少、核销到什么程度。" |
收尾拿 explorer 链接:
"这条记录在公链上,任何人都能查。我不会跑,因为跑不掉。"
Q:和发券软件有什么区别? 券在商户自己系统里,想改就改;这张卡在链上,规则售前锁死,顾客自己能验。
Q:刮奖算赌博吗? 不算。每张卡里有什么在卖之前就固定并上链,顾客只是不知道自己那张是哪一种——跟球星卡、盲盒手办同类。真随机抽奖是另一回事,需要前置法律意见,首期不做。
Q:没中奖的顾客会不会闹? 不会。基础权益(12 次课)百分之百保留,刮开只影响额外奖励。这条写在合约里。
Q:能联合别的商家一起卖吗? 能。一张卡可以挂多个商家权益,各自独立核销。(分账结算随下一版)
Q:AI 能操作吗? 能查不能付。我们给 AI 开了只读接口(卡、权益、剩余次数)。付款和核销必须本人授权。
问一个问题就筛掉 80%:"你的客人在用钱包吗?"
| 项 | 地址 |
|---|---|
| Smart Pass 程序 | 2488A99p…aGbZ |
| 演示活动(10 张) | H2kSeY7krp5KTm96zX6zaAHrzPpEhwaeDucXJUYYrMtF |
| 演示卡片 | 2jeAjKGGh65z1iFcTEoJBbaVsPve8QwD3VMNvDQB2DNP |
| 底池程序(既有,未改) | BfxjHT4ktrZTTmifbxbJz92LCWxwqNqX7bRSpiRydyEw |
| Metaplex Core | CoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d |
| 动作 | 成本 | 谁付 |
|---|---|---|
| 建活动 | ≈ 0.003 SOL(锁定) | 商户 |
| 出一张卡 | ≈ 0.003 SOL(锁定) | 商户 / 平台垫付 |
| 买家付款 | ≈ 0.000005 SOL | 买家 |
| 核销 | ≈ 0.000005 SOL | 商户 |
| 程序升级 | 临时 ≈ 1.2 SOL(退回大半),永久为差额 | 平台 |