Puls

Mobile-first prediction market built on Arc Testnet.

Users sign in with Google → get a Circle MPC wallet instantly → trade real Polymarket predictions with USDC as gas. No ETH, no seed phrase, no friction.

---

Demo

Feed	Fast Buy	Portfolio
Live Polymarket odds	Swipe YES/NO instantly	Real USDC trades on-chain

---

Stack

Layer	Tech
Mobile	Flutter (Android)
Auth	Supabase + Google OAuth
Wallets	Circle Developer-Controlled Wallets (MPC)
Blockchain	Arc Testnet (Chain ID 5042002)
Gas token	USDC — no ETH needed
Market data	Polymarket Gamma API (public, no auth)
Backend	Node.js on VPS
Smart contract	Solidity 0.8.24 on Arc Testnet

---

Smart Contract

PulsMarket — binary prediction market with USDC settlement.

• Address: 0xca048d69BaA38C6364d3E107c2b389BB8D1320dB
• Explorer: testnet.arcscan.app
• Source: contracts/src/PulsMarket.sol

---

Features

• Google sign-in → Circle MPC wallet created automatically
• Live feed — 100 real Polymarket markets, shuffled, with images
• Fast Buy — swipe right/left to buy YES/NO instantly (no confirmation modal)
• TikTok Home — vertical video feed with prediction pills
• Real trades — USDC sent to smart contract on Arc Testnet
• Portfolio — real trade history with Arc explorer links
• Dark/light theme — Dynamic Island floating nav bar

---

Setup

Prerequisites

• Flutter SDK
• Node.js 20+
• Circle API key (console.circle.com)
• Supabase project (supabase.com)

1. Clone

git clone https://github.com/rdmbtc/puls.git
cd puls

2. Flutter app

# Copy secrets template
cp lib/core/secrets.dart.example lib/core/secrets.dart
# Fill in your Supabase URL and anon key in secrets.dart

flutter pub get
flutter run

3. Backend

cd backend
cp .env.example .env
# Fill in Circle API key, entity secret, Supabase service key

# Run Supabase schema (paste supabase-schema.sql in Supabase SQL Editor)

node server.js

4. Get testnet USDC

faucet.circle.com → Arc Testnet → paste your wallet address

---

Architecture

Flutter App
    ↓ Google OAuth
Supabase Auth
    ↓ userId
Node.js Backend (VPS)
    ↓ Circle SDK
Circle MPC Wallet (Arc Testnet)
    ↓ USDC
PulsMarket.sol (Arc Testnet)

---

Backend

Separate repo: github.com/rdmbtc/puls_backend

---

Built on Arc

Arc is Circle's stablecoin-native L1 where USDC is the gas token. Puls uses Arc because:

• Users pay gas in USDC — no ETH needed
• Sub-second finality for instant trade confirmation
• Circle's full-stack ecosystem (wallets, USDC, compliance)

arc.network · Arc Blueprint: Prediction Markets