这个项目能做什么

SwapPulse 是一个开放、以社区为中心的宝可梦 TCG 平台,结合了收藏管理、交易、社交发现、通过 AT Protocol 实现的联邦化,以及在 Starknet 上使用 Cairo 实现的可选隐私保护 Web3 层。README 强调,普通收藏者可以将其作为普通的卡牌社区网站使用,而高级用户则可以选择加入自托管身份、链上证明、质押和链上探索。 描述的核心收藏功能包括收藏追踪器、基于 TCGDex 数据的卡牌和系列发现、市场和价格视图、带有交易线程和状态工作流的交易列表、卡册、愿望单、个人资料、关注、动态、帖子、评论和反应、圈子(Circles)、聚会(Meetups)、直播空间、通知、私信和启动包。站点地图涵盖首页、探索、收藏、钱包、卡册、交易板、圈子、聚会、正在直播、通知、消息和只读的链上浏览器,并提供九种语言的 UI 字典。 数据增强是分层的:TCGDex 是规范的目录和卡牌 ID 来源;PokéWallet 提供缓存的 TCGPlayer/CardMarket 价格增强;PokemonPriceTracker 在许可允许的情况下添加可选的评级和近期市场数据;TCGplayer 直接 API 的使用受审批限制且目前处于休眠状态;PokéAPI 提供通过全国图鉴 ID 链接的物种增强。这些服务器端调用经过缓存、预算控制并支持软失败。 架构分为四层:React 前端、Base44 应用/编排层(身份验证、实体、行级访问控制、工作流、审核)、用于 DID、句柄、应用密码、自定义词典、关注图谱导入/桥接和 Firehose 摄取的 AT Protocol/PDS 层,以及 Cairo/Starknet 层。列出的已部署合约包括 IdentityRegistry、SwapPulseAccount、SWPX 代币、CardNft、ProofOfUsership、StakingPool 和 BridgeAdapter。README 指出,链上仅存储不透明的信任材料,如标识符、钱包绑定、哈希、保证级别、时间戳、撤销状态和重放保护,且绝不能将个人数据写入链上。 文档记录的 V2 回归基准报告显示,64 个 Starknet Foundry 测试中有 63 个通过(其中一个为故意忽略),以及中继策略、过期和恢复的回归结果。钱包功能包括 SWPX 余额、智能账户地址、测试网资金、链上浏览器链接、身份保证状态、恢复保护、卡牌持有证明以及质押和桥接控制。社区质押支持运营商注册、增加自质押、委托、取消委托、定时提取和退出。README 明确指出,当前的 Starknet Devnet 运行时尚未成为去中心化的多验证者网络,包括树莓派级别目标在内的全节点/轻节点/验证者/归档节点角色仍处于路线图中,有待基准测试验证。 开发涵盖 Node/npm 前端、Base44 工具,以及固定在 Scarb 2.13.1、Starknet Foundry 0.51.2 和 universal-sierra-compiler 2.8.0 的链上工具链。代码库地图涵盖 src/ React 页面、base44 实体、函数和工作流、链上合约/测试/基础设施/脚本,以及关于用户指南、架构、分叉与品牌重塑、变更协议、运营商指南、OpenAPI 和部署的详尽文档。 许可协议方面,项目拥有的代码和文档采用 Mozilla Public License 2.0,不包括宝可梦素材、第三方 API 或 Base44 平台的重新授权;包含第三方声明。README 还披露 ChatGPT 和 Base44 被用作整个技术栈的核心开发工具,并经过人工指导、审查和测试,同时声明 AI 辅助代码不能免于审查。发布历史通过从 v0.1.0 到 v0.9.0 的版本化 GitHub 发布进行追踪。