ReferralGateway — Web3 白标推荐/联盟方案
成品交付：智能合约、Go API、Next.js 界面与可观测性。2–4 周上线，而非从零开发 6–9 个月。
产品概述
ReferralGateway 是一套可集成组件，用于在任意 EVM 链上启动推荐（联盟 / CPA）计划。包含防欺诈加固的智能合约、带 REST API 与链上索引器的 Go 后端、面向推荐人/卖家/管理员的 Next.js 控制台，以及 Prometheus + Grafana 与 CI/CD。默认支持 BNB Chain、Polygon、zkSync Era 及其他 EVM 网络。
适用对象
与商业方案一致：从市场到集成商。
Web3 市场与 DeFi
链上透明结算的推荐奖励——无需 Excel 或对账表；计提与领取通过智能合约完成。
交易所、钱包、Web3 金融科技
含 holdTime、争议仲裁与任意 ERC-20（USDT、USDC 等）的联盟机制。
代理与集成商
白标整包：品牌定制、文档、runbooks 与 CI/CD，便于向客户二次销售。
商业价值
与从零自研对比——基于实际交付的参考区间。
| 维度 | 从零开发 | ReferralGateway |
|---|---|---|
| 上线周期 | 6–9 个月 | 2–4 周 |
| 预算参考 | $150,000–350,000 | $25,000–50,000（实施）/ 买断自 $50,000 起 |
| 反欺诈 | 需自行设计 | 内置 holdTime + 仲裁 |
| 合约审计 | 单独合同与周期 | 经加固代码；外部审计可选 |
| 监控与测试 | 取决于团队 | Prometheus/Grafana；合约覆盖、E2E、k6 |
交付方式
许可 + 实施
$25,000 – $50,000
在贵方环境部署（Docker Compose / Kubernetes）
多链合约部署、UI 品牌化、监控与告警
DEPLOYMENT.md、runbooks；含 3 个月 Standard 支持
完整源码买断（IP）
$50,000 – $100,000
完整源码：合约 / 后端 / 前端
可修改与再销售的无限制权利
交接期 1 个月支持
买断 + 贵侧上线
$65,000 – $120,000
包含方案 B 全部内容
生产发布与团队入职辅导
降低接手运维风险
实施阶段
第 1 周：评估、fit/no-fit、NDA、选定交付方案
第 2–3 周：测试网部署、场景演练、验收
第 4–6 周：生产发布、监控、域名与 TLS
第 7 周：冒烟测试、runbook 交接、正式上线
典型生产周期 4–7 周，视链数量与 UI 定制而定。
上线后支持
实施后可选择 Standard / Business 级别，细则以合同为准。
- Standard（DeFi/NFT）：8×5，P1 1 小时内响应，恢复目标 8 小时内 — 约 $1,500–$2,500 / 月
- Business（交易所/金融科技）：12×7，P1 1 小时内响应，恢复目标 12 小时内 — 约 $3,000–$5,000 / 月
24×7 on-call 与第三方智能合约审计另议。SLA 除外条款（链、RPC、钱包）与商业方案一致。
优势
全栈：智能合约、支持 SIWE/JWT 的 Go REST API、Next.js UI、iframe 小组件、Discord/Slack 通知。
链上流程：定价清晰的 offer、自动卖家/推荐人/协议分成、任意 ERC-20。
安全：ReentrancyGuard、SafeERC20、费率（24h）与仲裁人轮换（48h）时间锁、CI 集成 Slither。
性能：约 3s 索引节奏、Redis 缓存、SingleFlight、RPC 信号量，目标 1000+ 并发；仓库内含 k6 SLO 场景。
质量与就绪度
合约：Hardhat 100% 覆盖、Foundry 模糊测试、solvency 不变量 seller + referrer + protocol == price。
后端：E2E 全流程 createOffer → buy → dispute → vote → claim；auth、API、storage 单元测试。
前端：Playwright 冒烟（登录、offer、元数据）；WalletConnect + MetaMask（Wagmi/Viem）。
基础设施：Docker Compose、Nginx、GitLab CI；Prometheus /metrics 与公网隔离。
团队本地环境（约 10–15 分钟）
交付后工程师可本地拉起：合约 → compose 后端 → Next.js。
合约：安装依赖，启动本地链并部署合约（Hardhat/Makefile）。
后端：进入 backend 执行 `make docker-up`，检查 `GET http://localhost:8096/health`。
后端：必要时执行迁移（`make install-migrate && make migrate-up`）。
前端：进入 frontend `npm i`，复制 `.env.example` → `.env.local`，运行 `npm run dev`（端口 3200）。
可选：配置前端代理到后端（`NEXT_PUBLIC_API_PROXY_TARGET=http://localhost:8096`）。
解决方案架构
智能合约 (Solidity)
Solidity 0.8.x：offer、buy/claim、仲裁、分页领取、Multicall；Foundry + Hardhat Ignition。
后端 API (Go)
Gin、GORM、PostgreSQL 15、Redis 7、go-ethereum；事件索引、限流、zerolog、OpenTelemetry。
多链设计
默认 BNB Chain、Polygon、zkSync Era；新增 EVM 链通过配置（RPC、合约地址、限额）。
关键特性
Hold time 与仲裁
奖励归属、卖家争议、仲裁人投票；暂停仅影响仲裁——购买与领取仍可用。
分成与协议费
自动卖家/推荐人/协议分成；费率变更受时间锁保护。
Gas 与吞吐
领取分页与上限、防 gas 耗尽；缓存、SingleFlight、仓库内 k6 SLO 场景。
BNB Chain、Polygon、zkSync Era 及任意 EVM（配置驱动）
合约优化；文档含各操作 Gas 参考表
holdTime、仲裁、ReentrancyGuard、SafeERC20