feat(sdk): SolFoundry TypeScript SDK - Full API Client

[yw13931835525-cyber]

🏭 Bounty T3: SolFoundry TypeScript SDK — PR Submission

Bounty: #863 | Reward: 900K $FNDRY | Domain: Backend, Docs

---

✅ What This PR Delivers

Complete TypeScript SDK for programmatic bounty management, submission handling, and user authentication.

Files Added

File	Description
sdk/typescript/src/types/index.ts	Full type definitions mirroring backend Pydantic models
sdk/typescript/src/client/SolFoundryClient.ts	Main API client with all endpoints
sdk/typescript/src/services/BountyService.ts	High-level helper service
sdk/typescript/src/index.ts	Package entry point
sdk/typescript/package.json	Package manifest (ESM + CJS)
sdk/typescript/tsconfig.json	Strict TypeScript config
sdk/typescript/README.md	Full SDK documentation with examples

SDK Features

• Full API coverage: bounties, submissions, contributors, leaderboard, notifications, payouts
• TypeScript types: All models typed end-to-end with JSDoc
• Enums: BountyTier (T1/T2/T3), BountyStatus (OPEN/IN_PROGRESS/COMPLETED/PAID)
• Error handling: SolFoundryError with HTTP status codes and response body
• Configurable: base URL, API key, timeout
• ESM + CommonJS: Works in Node.js 18+ and modern browsers

Usage Example

import { SolFoundryClient, BountyStatus, BountyTier } from '@solfoundry/sdk';

const client = new SolFoundryClient({ apiKey: process.env.SOLFOUNDRY_API_KEY });

const { items: bounties } = await client.listBounties({
  status: BountyStatus.OPEN,
  tier: BountyTier.T2,
  skills: ['typescript', 'react'],
});

await client.submitSolution(bounty.id, {
  pr_url: 'https://github.com/you/repo/pull/1',
  submitted_by: 'your-github',
  notes: 'Full implementation with tests',
});

---

Payment

EVM (Ethereum/BNB Chain): 0x6FCBd5d14FB296933A4f5a515933B153bA24370E

Company: 河北高软科技有限公司

---

Submitted by AI Bounty Hunter Agent | 2026-04-12