SDK v2 (#450)

- Remove old SDK (`@metadaoproject/futarchy`) and replace with `@metadaoproject/programs`
- Move all tests and scripts to new SDK
- Upgrade typescript to latest
- Add a typecheck utility script to root

Author: pileks

CLAUDE.md

@@ -40,8 +40,10 @@ programs/                    # Solana programs (Anchor)
 ├── mint_governor/          # Delegated minting authority management
 └── damm_v2_cpi/            # Meteora AMM CPI wrapper
 
-sdk/                         # TypeScript client library
-├── src/v0.3/ - v0.7/       # Versioned SDKs (backward compatible)
+sdk/                         # TypeScript client library (@metadaoproject/programs)
+├── src/<program>/          # One module per program (futarchy, launchpad, conditional_vault, ...)
+│   ├── v0.X/               #   Each program is independently versioned
+│   └── index.ts            #   Re-exports the latest version
 └── package.json
 
 tests/                       # TypeScript tests (bankrun + mocha)
@@ -180,7 +182,7 @@ Always append new error variants to the **end** of `#[error_code]` enums. Anchor
 
 ### Adding New Instructions
 1. Add instruction to Rust program in `programs/[program]/src/instructions/`
-2. Update client methods in SDK (`sdk/src/v0.7/`)
+2. Update client methods in the corresponding SDK module at the program's current version (e.g. `sdk/src/futarchy/v0.6/`, `sdk/src/launchpad/v0.7/`)
 3. Add unit tests in `tests/[program]/unit/`
 
 ### Testing with Bankrun
@@ -249,17 +251,29 @@ When designing instructions that involve Squads CPIs, check whether either patte
 
 ## SDK Usage
 
-```typescript
-// Import versioned clients
-import { FutarchyClient, ConditionalVaultClient } from "@metadaoproject/futarchy/v0.7";
+The SDK is published as `@metadaoproject/programs` and is organized **per program**, with each program independently versioned. There is no single SDK-wide version anymore — futarchy is at v0.6, launchpad is at v0.7, conditional_vault is at v0.4, etc.
 
-// Key utilities in sdk/src/v0.7/
-// - constants.ts: Program IDs, MAINNET_USDC, SQUADS_PROGRAM_ID
-// - PDA derivation: getDaoAddr, getProposalAddr, etc.
-// - PriceMath.getAmmPrice for price calculations
+```typescript
+// Top-level imports resolve to the latest version of each program (preferred)
+import {
+  FutarchyClient,
+  LaunchpadClient,
+  ConditionalVaultClient,
+  MAINNET_USDC,
+} from "@metadaoproject/programs";
+
+// Or import from a specific program module
+import { FutarchyClient } from "@metadaoproject/programs/futarchy";
+import { LaunchpadClient } from "@metadaoproject/programs/launchpad";
+
+// Or pin to a specific version (only when reading historical accounts or
+// interacting with an older deployed program)
+import { FutarchyClient } from "@metadaoproject/programs/futarchy/v0.6";
 ```
 
-**Important:** Always use SDK v0.7 imports (`@metadaoproject/futarchy/v0.7`) for new code. Do not use older SDK versions (v0.3-v0.6).
+Each program module exports a `Client` class (constructed via `Client.createClient({ provider })`), PDA helpers, and generated Anchor types. Shared utilities (`constants.ts`, top-level `pda.ts`, `AmmMath`) are exported from the package root.
+
+**Important:** Always use top-level or per-program imports for new code. Only reach for a versioned subpath (e.g. `@metadaoproject/programs/futarchy/v0.6`) when you specifically need an older program version. See `sdk/README.md` for the full layout.
 
 ## Key External Dependencies
 

package.json

@@ -4,6 +4,7 @@
   "scripts": {
     "lint:fix": "prettier */*{.js,.ts} \"*/**/*{.js,.ts}\" -w",
     "lint": "prettier */*.js \"*/**/*{.js,.ts}\" --check",
+    "typecheck": "tsc --noEmit",
     "setup-metric-market": "tsx --tsconfig tsconfig.json scripts/setupMetricMarket.ts",
     "launch-init": "NODE_OPTIONS=\"--no-deprecation\" tsx --tsconfig tsconfig.json scripts/launchInit.ts",
     "launch-start": "NODE_OPTIONS=\"--no-deprecation\" tsx --tsconfig tsconfig.json scripts/launchStart.ts",
@@ -24,7 +25,7 @@
   "dependencies": {
     "@coral-xyz/anchor": "=0.29.0",
     "@inquirer/prompts": "^7.3.3",
-    "@metadaoproject/futarchy": "./sdk",
+    "@metadaoproject/programs": "./sdk",
     "@metaplex-foundation/mpl-token-metadata": "^3.2.0",
     "@metaplex-foundation/umi": "^0.9.1",
     "@metaplex-foundation/umi-bundle-defaults": "^0.9.1",
@@ -68,7 +69,7 @@
     "ts-mocha": "^10.0.0",
     "ts-node": "^10.9.2",
     "tsx": "^4.7.1",
-    "typescript": "^4.3.5",
+    "typescript": "5.9.3",
     "typescript-eslint": "^8.43.0"
   },
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e",

rebuild.sh

@@ -3,8 +3,9 @@
 set -e
 anchor build
 cd sdk
+yarn install
 yarn build-local
 cd ..
 yarn install --force
 yarn lint:fix
-echo "✅ SDK types synced successfully"
+echo "✅ rebuild complete"

scripts/setupFutarchyAmm.ts

@@ -1,5 +1,7 @@
+// @ts-nocheck
+// Legacy script
 import * as anchor from "@coral-xyz/anchor";
-import { AutocratClient, getDaoAddr } from "@metadaoproject/futarchy/v0.6";
+import { AutocratClient, getDaoAddr } from "@metadaoproject/programs/v0.6";
 import { Keypair, PublicKey } from "@solana/web3.js";
 import BN from "bn.js";
 import * as token from "@solana/spl-token";

scripts/v0.3/crankTwap.ts

@@ -1,5 +1,6 @@
 import * as anchor from "@coral-xyz/anchor";
-import { AmmClient, AutocratClient } from "@metadaoproject/futarchy/v0.3";
+import { AmmClient } from "@metadaoproject/programs/amm/v0.3";
+import { AutocratClient } from "@metadaoproject/programs/autocrat/v0.3";
 import { PublicKey } from "@solana/web3.js";
 
 const proposal1 = new PublicKey("Dssb1oTTqKjWJTe8QVrStFXxcMZfd7LTSpTRbuHuNdnW");

scripts/v0.3/finalizeProposal.ts

@@ -1,5 +1,5 @@
 import * as anchor from "@coral-xyz/anchor";
-import { AutocratClient } from "@metadaoproject/futarchy/v0.3";
+import { AutocratClient } from "@metadaoproject/programs/autocrat/v0.3";
 
 const { PublicKey } = anchor.web3;
 

scripts/v0.3/initializeDao.ts

@@ -1,5 +1,5 @@
 import * as anchor from "@coral-xyz/anchor";
-import { AutocratClient } from "@metadaoproject/futarchy/v0.3";
+import { AutocratClient } from "@metadaoproject/programs/autocrat/v0.3";
 import {
   DEAN_DEVNET,
   DEVNET_DARK,

scripts/v0.3/initializeProposal.ts

@@ -2,7 +2,7 @@ import * as anchor from "@coral-xyz/anchor";
 import { MEMO_PROGRAM_ID } from "@solana/spl-memo";
 import * as token from "@solana/spl-token";
 import { LAMPORTS_PER_SOL } from "@solana/web3.js";
-import { AutocratClient } from "@metadaoproject/futarchy/v0.3";
+import { AutocratClient } from "@metadaoproject/programs/autocrat/v0.3";
 
 const { PublicKey } = anchor.web3;
 

scripts/v0.3/initializeVault.ts

@@ -8,7 +8,7 @@ import {
   getVaultAddr,
   getVaultFinalizeMintAddr,
   getVaultRevertMintAddr,
-} from "@metadaoproject/futarchy/v0.3";
+} from "@metadaoproject/programs/conditional_vault/v0.3";
 
 const CONDITIONAL_VAULT_PROGRAM_ID = new PublicKey(
   "4nCk4qKJSJf8pzJadMnr9LubA6Y7Zw3EacsVqH1TwVXH",

scripts/v0.3/main.ts

@@ -1,3 +1,5 @@
+// @ts-nocheck
+// Legacy script
 import * as anchor from "@coral-xyz/anchor";
 import * as token from "@solana/spl-token";
 const { BN, Program } = anchor;