@dubsdotapp/expo 0.1.0

package/README.md

@@ -0,0 +1,158 @@
+# @dubs/expo
+
+React Native SDK for the [Dubs](https://dubs.fun) betting platform. Pure TypeScript — no native code.
+
+## Install
+
+```bash
+npx expo install @dubs/expo @solana/web3.js
+```
+
+For the built-in Mobile Wallet Adapter (optional):
+
+```bash
+npx expo install @solana-mobile/mobile-wallet-adapter-protocol-web3js
+```
+
+## Quick Start
+
+### 1. Set up the provider
+
+```tsx
+import { DubsProvider, MwaWalletAdapter } from '@dubs/expo';
+
+const wallet = new MwaWalletAdapter({
+  appIdentity: { name: 'My App' },
+});
+
+export default function App() {
+  return (
+    <DubsProvider
+      apiKey="dubs_live_your_key_here"
+      rpcUrl="https://api.mainnet-beta.solana.com"
+      wallet={wallet}
+    >
+      <HomeScreen />
+    </DubsProvider>
+  );
+}
+```
+
+### 2. Browse events
+
+```tsx
+import { useEvents } from '@dubs/expo';
+
+function EventsList() {
+  const { data, loading, error, refetch } = useEvents({ type: 'sports' });
+
+  if (loading) return <Text>Loading...</Text>;
+  if (error) return <Text>Error: {error.message}</Text>;
+
+  return (
+    <FlatList
+      data={data?.events}
+      renderItem={({ item }) => (
+        <Text>{item.title} — {item.startTime}</Text>
+      )}
+    />
+  );
+}
+```
+
+### 3. Create a bet
+
+```tsx
+import { useCreateGame } from '@dubs/expo';
+
+function CreateBet({ eventId }: { eventId: string }) {
+  const { execute, status, error } = useCreateGame();
+
+  const handleCreate = async () => {
+    const result = await execute({
+      id: eventId,                // e.g. "sports:NBA:espn-nba-401..."
+      playerWallet: 'YOUR_WALLET',
+      teamChoice: 'home',
+      wagerAmount: 0.1,           // SOL
+    });
+
+    console.log('Bet placed!', result.explorerUrl);
+  };
+
+  return (
+    <View>
+      <Button title="Place Bet" onPress={handleCreate} disabled={status !== 'idle'} />
+      {status !== 'idle' && <Text>Status: {status}</Text>}
+      {error && <Text>Error: {error.message}</Text>}
+    </View>
+  );
+}
+```
+
+## Custom Wallet Adapter
+
+If you're using Privy, Dynamic, or another wallet provider, implement the `WalletAdapter` interface:
+
+```tsx
+import { DubsProvider } from '@dubs/expo';
+import type { WalletAdapter } from '@dubs/expo';
+import { Transaction, PublicKey } from '@solana/web3.js';
+
+const myAdapter: WalletAdapter = {
+  publicKey: new PublicKey('...'),
+  connected: true,
+  signTransaction: async (tx: Transaction) => {
+    // Sign using your wallet provider
+    return signedTx;
+  },
+};
+
+<DubsProvider apiKey="..." wallet={myAdapter}>
+  <App />
+</DubsProvider>
+```
+
+## API Reference
+
+### Hooks
+
+| Hook | Type | Description |
+|------|------|-------------|
+| `useEvents(params?)` | Query | Fetch upcoming events (sports + esports) |
+| `useGame(gameId)` | Query | Single game detail |
+| `useGames(params?)` | Query | List games with filters |
+| `useCreateGame()` | Mutation | Full create lifecycle (build → sign → send → confirm) |
+| `useJoinGame()` | Mutation | Full join lifecycle |
+| `useClaim()` | Mutation | Full claim lifecycle |
+
+### Mutation Status
+
+Mutation hooks expose granular status:
+
+```
+'idle' → 'building' → 'signing' → 'confirming' → 'saving' → 'success'
+                                                              ↘ 'error'
+```
+
+### DubsClient (headless)
+
+For use outside React or for custom integrations:
+
+```ts
+import { DubsClient } from '@dubs/expo';
+
+const client = new DubsClient({ apiKey: 'dubs_live_...' });
+
+const { events } = await client.getUpcomingEvents({ type: 'sports', game: 'nba' });
+const game = await client.getGame('sport-123...');
+const codes = client.getErrorCodesLocal();
+```
+
+## Event ID Format
+
+- Sports: `sports:{LEAGUE}:{EVENT_ID}` (e.g. `sports:NBA:espn-nba-401...`)
+- Esports: `esports:{MATCH_ID}` (e.g. `esports:1353988`)
+
+## License
+
+MIT