polymarket

Anchor.toml

@@ -0,0 +1,19 @@
+[toolchain]
+anchor_version = "0.30.1"
+
+[features]
+seeds = false
+skip-lint = false
+
+[programs.devnet]
+polyield_vault = "FWGiD7WhXu8k7eDtEwr3ZbXbvqwL7kdJgNfugrSVJ7F3"
+
+[registry]
+url = "https://api.apr.dev"
+
+[provider]
+cluster = "devnet"
+wallet = "~/.config/solana/id.json"
+
+[scripts]
+test = "yarn run ts-mocha -p ./tsconfig.json -t 1000000 tests/**/*.ts"

BRANCH_SUMMARY.md

@@ -0,0 +1,134 @@
+# Database Branch - Implementation Summary
+
+## What Was Changed
+
+This branch replaces the localStorage-based position tracking system with a persistent Supabase database solution. Users can now access their positions and market history from any browser or device by simply connecting their wallet.
+
+## Files Created
+
+### Database Infrastructure
+- **`lib/database/supabase.ts`** - Supabase client initialization with environment variable validation
+- **`lib/database/types.ts`** - TypeScript type definitions for the `user_positions` table
+- **`lib/database/positions-service.ts`** - Service layer with functions for CRUD operations
+- **`lib/database/migrations/001_initial_schema.sql`** - SQL migration to create tables and indexes
+
+### Documentation
+- **`SUPABASE_SETUP.md`** - Quick setup guide for configuring Supabase
+- **`DATABASE_IMPLEMENTATION.md`** - Comprehensive implementation documentation
+- **`BRANCH_SUMMARY.md`** - This file
+
+## Files Modified
+
+### Hooks
+- **`hooks/use-positions.ts`**
+  - Added Supabase database integration
+  - Implemented automatic fallback to localStorage if Supabase not configured
+  - Added `isLoading`, `error`, and `refreshPositions` to return values
+  - Updated `addPosition` to be async and accept `transactionSignature` parameter
+
+- **`hooks/use-deposit.ts`**
+  - Updated `deposit` function signature to accept `marketQuestion` and `expiryTimestamp`
+  - Added automatic position saving to database after successful transactions
+  - Graceful error handling if database save fails (transaction still succeeds)
+
+### Components
+- **`components/deposit-modal.tsx`**
+  - Updated `handleDeposit` to pass new required parameters
+  - Ensures positions are saved to database with transaction signatures
+
+### Dependencies
+- **`package.json`** / **`pnpm-lock.yaml`**
+  - Added `@supabase/supabase-js` v2.90.1
+
+## Key Features
+
+✅ **Cross-Device Persistence** - Positions stored by wallet address, accessible from any browser/device  
+✅ **Transaction Tracking** - Each position includes the Solana transaction signature  
+✅ **Automatic Fallback** - Gracefully falls back to localStorage if Supabase not configured  
+✅ **No Hardcoded Secrets** - All credentials in `.env.local` (not committed to repo)  
+✅ **Type Safety** - Full TypeScript types for database operations  
+✅ **Optimized Queries** - Database indexes for fast lookups by wallet, market, and status  
+
+## Environment Variables Required
+
+Create a `.env.local` file with:
+
+```bash
+NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
+```
+
+**Note:** `.env.local` is already in `.gitignore` and will not be committed.
+
+## Setup Steps
+
+1. **Create Supabase Project** at [supabase.com](https://supabase.com)
+2. **Run Migration**: Execute `lib/database/migrations/001_initial_schema.sql` in Supabase SQL Editor
+3. **Configure Environment**: Create `.env.local` with your Supabase credentials
+4. **Restart Dev Server**: `pnpm dev`
+
+For detailed instructions, see `SUPABASE_SETUP.md`
+
+## Database Schema
+
+### `user_positions` Table
+```sql
+- id (UUID, primary key)
+- wallet_address (TEXT, indexed)
+- market_id (TEXT, indexed)
+- market_question (TEXT)
+- position (TEXT: 'YES' or 'NO')
+- amount (DECIMAL)
+- transaction_signature (TEXT)
+- timestamp (TIMESTAMPTZ)
+- expiry_timestamp (TIMESTAMPTZ)
+- status (TEXT: 'active', 'claimed', or 'refunded')
+- created_at (TIMESTAMPTZ)
+- updated_at (TIMESTAMPTZ, auto-updated)
+```
+
+## Backward Compatibility
+
+- ✅ Works without Supabase (falls back to localStorage)
+- ✅ No breaking changes to existing functionality
+- ⚠️ Existing localStorage positions won't auto-migrate (manual migration possible)
+
+## Testing Checklist
+
+- [ ] Create Supabase project and run migration
+- [ ] Configure `.env.local` with Supabase credentials
+- [ ] Connect wallet and make a test deposit
+- [ ] Verify position appears in Supabase dashboard
+- [ ] Disconnect wallet, reconnect, verify positions load
+- [ ] Test on different browser/device with same wallet
+- [ ] Test without `.env.local` (should fallback to localStorage)
+
+## Next Steps / Future Enhancements
+
+- [ ] Implement position status updates (claimed/refunded)
+- [ ] Add real-time subscriptions for live position updates
+- [ ] Implement wallet-based RLS policies for production
+- [ ] Create admin interface for market resolution
+- [ ] Add position migration tool from localStorage to Supabase
+- [ ] Implement analytics dashboard for position tracking
+
+## Commit Message Suggestion
+
+```
+feat: Replace localStorage with Supabase database for position tracking
+
+- Add Supabase client and database service layer
+- Create user_positions table with wallet address indexing
+- Update hooks to save/fetch positions from database
+- Implement automatic fallback to localStorage if not configured
+- Store transaction signatures with each position
+- Enable cross-device position access via wallet connection
+
+All API keys configured via .env.local (not hardcoded)
+```
+
+## Questions or Issues?
+
+Refer to:
+- `SUPABASE_SETUP.md` - Setup instructions
+- `DATABASE_IMPLEMENTATION.md` - Technical details and troubleshooting