Tooling: add a merchant guide from one tested spec (live payment, verbatim doc check, video)
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 35/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- blockchain, node.js, typescript
- 领域
- tooling
调研方向
Start by inspecting the existing merchant guides in docs/integrations/ and how the site publishes them; the issue says the current scripts are outside the repository. Define the spec.json format and add scripts/merchant-guide/run.mjs, gen.mjs, and verify.mjs for the stated payment, generation, and verification steps. Done means regenerating an existing guide such as Pinata produces the same file and verification fails when a snippet does not run.
由索引模型根据 Issue 内容生成。
描述
Why
On 2026-10-07 we published 12 merchant guides (docs/integrations/*.md). Each was produced from one spec: a live payment with the SDK, the same 402 refused for another payee with zero signatures, the guide's code run verbatim from npm, and the MCP entry loaded by the real MCP server. The scripts live outside the repo, so contributors can't add a merchant the same way.
What
scripts/merchant-guide/:
spec.jsonformat (origin, payTo, url, method, body, maxPerTx, pricePin, optional timeoutMax);run.mjs: payment + injection check (needsPAYER_KEYwith a few cents on Base);gen.mjs: writesdocs/integrations/<NAME>.md;verify.mjs: runs the guide's ts blocks from published npm packages and loads the MCP entry over stdio.
The site already publishes every docs/integrations/*.md automatically.
Acceptance
Re-generating an existing guide (e.g. Pinata) from its spec produces the same file; the verify step fails if a snippet doesn't run.
- 主要语言
- TypeScript
- 星标
- 0
- 派生
- 0
- 平均合并
- 3 小时 51 分钟
- 30 天内合并 PR
- 3
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
DeepFirstHQ/deepfirstsearch 的其他 Issue
-
documentation good first issue
难度 1/5 1-3 小时 新手友好度 85/100
-
help wanted integration
难度 4/5 3-5 天 新手友好度 45/100
-
enhancement good first issue
难度 3/5 1-2 天 新手友好度 69/100
-
documentation good first issue
难度 3/5 1-2 天 新手友好度 54/100
-
help wanted integration
难度 5/5 一周以上 新手友好度 25/100
查看 DeepFirstHQ/deepfirstsearch 的全部 Issue
相似的 Issue
-
area: backend bug priority: low
难度 2/5 1-3 小时 新手友好度 78/100
snapotter-hq/SnapOtter#2254 ·
维护者通常 1 天内回复
-
bug ticket
难度 2/5 1-3 小时 新手友好度 72/100
cratestack/cratestack#1154 ·
维护者通常 1 天内回复
-
server 消息处理器 cmd 分支补显式错误回报——竞态非法命令现走未处理拒绝可能已有人在做 @openaddr 今天认领。 未关闭ready-for-agent refactor wayfinder:task
难度 2/5 1-3 小时 新手友好度 72/100
openaddr/dafung-web#428 ·
维护者通常 1 天内回复
-
Flaky: mongodb-memory-server 'Port already in use' when another process starts a mongod concurrently未关闭area:testing bug effort:S priority:P2
难度 2/5 1-3 小时 新手友好度 70/100
维护者通常 1 天内回复
-
lens:agent lens:process process
难度 2/5 1-3 小时 新手友好度 82/100
thebristolsound/birdbrain#1772 ·
维护者通常 1 天内回复