About this project
SwapPulse is an open, community-focused Pokémon TCG platform that combines collection management, trading, social discovery, federation through the AT Protocol, and an optional privacy-preserving Web3 layer implemented in Cairo on Starknet. The README stresses that ordinary collectors can use it as a normal card-community site, while advanced users can opt into self-custodial identity, on-chain proofs, staking and chain exploration.
Core collector features described include a collection tracker, card and set discovery built on TCGDex data, market and pricing views, trade listings with trade threads and status workflows, binders, wishlists, profiles, follows, feeds, posts, comments and reactions, Circles, Meetups, live spaces, notifications, private messages and starter packs. The site map covers Home, Explore, Collection, Wallet, Binders, Trade Board, Circles, Meetups, Live Now, Notifications, Messages and a read-only Chain Explorer, with UI dictionaries for nine languages.
Data enrichment is layered: TCGDex is the canonical catalogue and card-ID source; PokéWallet provides cached TCGPlayer/CardMarket price enrichment; PokemonPriceTracker adds optional graded and recent-market data where licensing permits; TCGplayer direct API use is approval-gated and dormant; PokéAPI supplies species enrichment linked by National Pokédex IDs. These server-side calls are cached, budgeted and fail soft.
The architecture is split into four layers: a React frontend, the Base44 application/orchestration layer (auth, entities, row-level access control, workflows, moderation), an AT Protocol/PDS layer for DIDs, handles, app passwords, custom lexicons, follow-graph import/bridging and firehose ingestion, and the Cairo/Starknet layer. Deployed contracts listed include IdentityRegistry, SwapPulseAccount, an SWPX token, CardNft, ProofOfUsership, StakingPool and BridgeAdapter. The README states that only opaque trust material such as identifiers, wallet bindings, hashes, assurance levels, timestamps, revocation state and replay protection is stored on-chain, and that personal data must never be written on-chain.
The documented V2 regression baseline reports 63 of 64 Starknet Foundry tests passing with one intentionally ignored, alongside relay policy, expiry and recovery regression results. Wallet features include SWPX balance, smart-account address, testnet funding, chain explorer links, identity assurance state, recovery protection, card possession attestations and staking and bridge controls. Community staking supports operator registration, self-stake increases, delegation, undelegation, timed withdrawal and exit. The README explicitly notes the current Starknet Devnet runtime is not yet a decentralised multi-validator network and that full/lite/validator/archive node roles, including Raspberry Pi-class targets, remain a roadmap to be verified by benchmarks.
Development covers a Node/npm frontend, Base44 tooling, and a chain toolchain pinned to Scarb 2.13.1, Starknet Foundry 0.51.2 and universal-sierra-compiler 2.8.0. The repository map spans src/ React pages, base44 entities, functions and workflows, chain contracts/tests/infra/scripts, and extensive docs on user guide, architecture, forking and rebranding, change protocol, operator guide, OpenAPI and deployment.
Licensing is Mozilla Public License 2.0 for project-owned code and documentation, without relicensing Pokémon material, third-party APIs or Base44's platform; third-party notices are included. The README also discloses that ChatGPT and Base44 were used as core development tools across the stack, with human direction, review and testing, and states AI-assisted code is not exempt from review. Release history is tracked through versioned GitHub releases from v0.1.0 to v0.9.0.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.