torchsdk 4.0.1 → 4.1.1

package/readme.md

@@ -1,370 +1,174 @@
 # Torch SDK
 
-TypeScript SDK for [Torch Market](https://torch.market) — the fair-launch token protocol on Solana.
+TypeScript SDK for [Torch Market](https://torch.market).
 
-Read on-chain state, build transactions, and interact with bonding curves, vaults, governance, lending, and the SAID Protocol — all directly via Solana RPC. No API middleman.
+Every token launched on Torch gets a bonding curve for price discovery, a community treasury funded by trading, and a lending market that activates after migration to Raydium. The SDK is the primary way to interact with the protocol — it builds transactions locally from the on-chain Anchor IDL, reads all state directly from Solana RPC, and handles routing between bonding curves and DEX pools automatically. No API server. No middleman.
 
-## Design
-
-for in depth sdk design, refer to [design.md](./design.md).
-
-## Audit
-
-for sdk audit, refer to [audit.md](./audit.md).
-
-## Versioning
-
-SDK version tracks the on-chain program IDL version.
-
-## v4.0.0 + v4.0.1
-
-- **V4.0 Simplified Tiers & Reduced Fees** — Removed 50 SOL (Spark) tier from token creation (existing tokens unaffected). Treasury SOL rate reduced from 20%→5% to 12.5%→4%. Protocol fee reduced from 1% to 0.5%. Constants-only change — no new instructions, no state migration. IDL updated to v4.0.0. 48 Kani proofs all passing.
-
-## v3.7.35
-
-- **`getBorrowQuote`** — New quote function computes maximum borrowable SOL for a given collateral amount on a migrated token. Returns the binding constraint across LTV cap, pool available liquidity, and per-user cap — plus full breakdown of all three limits. Accounts for Token-2022 transfer fee (4 bps). New type: `BorrowQuoteResult`.
-- **`getMessages` post-migration support** — Now fetches memos from both bonding curve transactions and Raydium pool transactions. Also checks inner instructions (for vault swap memos). Results merged, deduped by signature, and sorted newest-first. No signature or return type changes.
-- **E2E test updates** — Borrow sections in `test_e2e.ts` and `test_devnet_e2e.ts` now use `getBorrowQuote` instead of inline constraint calculations.
-
-## v3.7.32
-
-- **Post Migration Accounts** export helper.
-
-## v3.7.31
-
-- **Vault Swap Messages** add token memos to vault swaps post migration.
-
-### v3.7.30
-
-- **V35 Community Token Option** — Token creators can now choose between **community token** (default: 0% creator fees, entire 0.04% transfer fee proceeds go to treasury) or **creator token** (opt-in: 0.2%→1% bonding SOL share + 15% post-migration fee swap share). Choice is permanent and set at creation via `community_token` parameter on `buildCreateTokenTransaction`. New tokens default to community mode. No new instructions, no new accounts, no state layout changes. Stars unaffected — community token creators can still receive star payouts. IDL updated to v3.7.10. 46 Kani proofs (2 new: community token buy conservation, community token swap fees conservation).
-
-### v3.7.29
-
-- **V36 Lending Cap** new lending cap on token treasuries per user based on collateral size.
-
-### v3.7.24 + v3.7.25
-
-- **V35 Optional Account Param On Sells** on bond non-voting accounts can sell.
-
-### v3.7.23
-
-- **V34 Creator Fee Structure** creator rewards have been introduced, with pre and post migration rewards designed to reward good creators.
-
-### v3.7.22
+## Install
 
-- **V33 Buyback Removal + Lending Cap Increase** — `buildAutoBuybackTransaction` removed (~180 lines of SDK code). The on-chain `execute_auto_buyback` instruction was removed in V33 (program v3.7.7, 27 instructions). Treasury simplified to: fee harvest → sell high → SOL → lending yield + epoch rewards. Lending utilization cap increased from 50% to 70%. `AutoBuybackParams` type removed. IDL updated to v3.7.7. 39 Kani proofs all passing. Binary size reduced ~6% (850 KB → 804 KB).
-- **V32 Protocol Fee Change**
+```bash
+pnpm add torchsdk
+```
 
-### v3.7.20
+Peer dependency: `@solana/web3.js ^1.98.0`
 
-- **Legacy Tokens** - blacklisted tokens now marked legacy and withdraw only.
+## How It Works
 
-### v3.7.18
+```
+1. Get a quote     →  getBuyQuote / getSellQuote
+2. Build a tx      →  buildBuyTransaction / buildSellTransaction
+3. Sign and send   →  your wallet / keypair
+```
 
-- **V31 Zero-Burn Migration** — IDL updated to v3.7.5 (program v3.7.5). CURVE_SUPPLY 750M → 700M, TREASURY_LOCK_TOKENS 250M → 300M. Zero tokens burned at migration — vault remainder exactly equals price-matched pool allocation. Transfer fee 0.1% → 0.25% for new tokens. Vote return now redirects to treasury lock (community reserve) instead of Raydium LP. `buildMigrateTransaction` passes `treasuryLock` PDA and `treasuryLockTokenAccount` to the new on-chain context. 38 Kani proofs all passing (including 3 new zero-excess-burn proofs and Flame price-match proof). All three tiers (Spark/Flame/Torch) preserved.
+The SDK is VersionedTransaction-native. All transaction builders return v0 transactions compressed with Address Lookup Tables for smaller tx sizes and more headroom.
 
-### v3.7.17
+| Network | ALT Address |
+|---------|-------------|
+| Mainnet | `GQzbU32oN3znZa3uWFKGc9cBukpQbYYJSirKstMuFF3i` |
+| Devnet | `3umSStZSLJNk5QstxeQB12a2MSDh4o8RgSzT76gigJ8P` |
 
-- **`getAllLoanPositions`** — New SDK function scans all on-chain LoanPosition accounts for a given mint. Returns active positions with computed health status (collateral value, LTV, health), sorted liquidatable-first. Fetches Raydium pool price once (not per-position) for efficient valuation. New types: `LoanPositionWithKey` (extends `LoanPositionInfo` with `borrower` address), `AllLoanPositionsResult`.
+Quotes work across both bonding curve and DEX — the `source` field tells you which. Pass the quote into the transaction builder and the SDK handles routing and slippage protection automatically.
 
-### v3.7.16
+```typescript
+import { Connection } from "@solana/web3.js";
+import { getBuyQuote, buildBuyTransaction } from "torchsdk";
 
-- **V29 On-Chain Metadata** — Metaplex `buildAddMetadataTransaction` removed (temporary backfill complete — all active tokens now use Token-2022 metadata extensions). New `getTokenMetadata(connection, mint)` read-only function returns `{ name, symbol, uri, mint }` from on-chain Token-2022 metadata. Transfer fee updated from 1% to 0.1% on-chain. IDL updated to v3.7.4 (28 instructions).
+const connection = new Connection("https://api.mainnet-beta.solana.com");
 
-### v3.7.10
+// Works on any token — bonding or migrated
+const quote = await getBuyQuote(connection, mint, 100_000_000); // 0.1 SOL
+console.log(`${quote.tokens_to_user / 1e6} tokens, source: ${quote.source}`);
 
-- **V20 Swap Fees to SOL** — New `buildSwapFeesToSolTransaction` bundles `create_idempotent(treasury_wsol)` + `harvest_fees` + `swap_fees_to_sol` in one atomic transaction. Sells harvested Token-2022 transfer fee tokens back to SOL via Raydium CPMM. Treasury PDA signs the swap, WSOL unwrapped to SOL, proceeds added to `treasury.sol_balance` and tracked in `treasury.harvested_fees`. Set `harvest=false` to skip harvest if already done separately. New type: `SwapFeesToSolParams`.
-- **Vault ordering bug fix** — Fixed `validate_pool_accounts` vault ordering in `swap_fees_to_sol` handler. Vaults are now passed in pool order (by mint pubkey) instead of swap direction, preventing false validation failures for tokens where `mint < WSOL` (~2.6% of tokens).
-- **28 instructions** — IDL updated to v3.7.10 (28 instructions, up from 27). *(27 instructions as of v3.7.22 — buyback removed in V33)*
+const { transaction } = await buildBuyTransaction(connection, {
+  mint,
+  buyer: agentWallet,
+  amount_sol: 100_000_000,
+  slippage_bps: 500, // 5%
+  vault: vaultCreator,
+  quote, // drives routing + slippage protection
+});
+// sign and send — VersionedTransaction, ALT-compressed
+```
 
+## Torch Vault
 
-<details>
-<summary>Older versions (v3.2.0 – v3.7.4)</summary>
+The vault is a full-custody on-chain escrow for AI agents. It holds all SOL and tokens. The agent wallet is a disposable controller that signs transactions but holds nothing of value.
 
-See git history for full changelog. Key milestones: v3.2.0 (full custody vault), v3.3.0 (tiered bonding curves), v3.6.8 (permissionless DEX migration), v3.7.0 (treasury lock + PDA pool validation).
+```
+Human (hardware wallet)           Agent (disposable, ~0.01 SOL for gas)
+  ├── createVault()                 ├── buy(vault=creator)    → vault pays
+  ├── depositVault(5 SOL)           ├── sell(vault=creator)   → SOL returns to vault
+  ├── linkWallet(agentPubkey)       ├── borrow(vault=creator) → SOL to vault
+  ├── withdrawVault()               ├── repay(vault=creator)  → collateral returns
+  └── unlinkWallet(agent)           └── star(vault=creator)   → vault pays
+```
 
-</details>
+Seven guarantees: full custody, closed economic loop, authority separation, one link per wallet, permissionless deposits, instant revocation, authority-only withdrawals.
 
-## API Reference
+## Operations
 
-### Token Data
+### Queries (no signing)
 
 | Function | Description |
 |----------|-------------|
 | `getTokens(connection, params?)` | List tokens with filtering and sorting |
-| `getToken(connection, mint)` | Get full token details (metadata, treasury, votes, stars) |
-| `getHolders(connection, mint)` | Get token holder list (excludes pools/vaults) |
-| `getMessages(connection, mint, limit?)` | Get trade-bundled memos (bonding curve + post-migration DEX) |
-| `getLendingInfo(connection, mint)` | Get lending parameters for a migrated token |
-| `getTokenMetadata(connection, mint)` | Get on-chain Token-2022 metadata (name, symbol, uri) |
-| `getLoanPosition(connection, mint, wallet)` | Get a wallet's loan position |
-| `getAllLoanPositions(connection, mint)` | Get all active loan positions for a token (sorted by health) |
-
-### Vault Queries
-
-| Function | Description |
-|----------|-------------|
-| `getVault(connection, creator)` | Get vault state by creator pubkey |
-| `getVaultForWallet(connection, wallet)` | Find vault by any linked wallet (reverse lookup) |
-| `getVaultWalletLink(connection, wallet)` | Get link state (which vault, when linked) |
+| `getToken(connection, mint)` | Full token details (price, treasury, votes, status) |
+| `getTokenMetadata(connection, mint)` | On-chain Token-2022 metadata |
+| `getHolders(connection, mint)` | Token holder list |
+| `getMessages(connection, mint, limit?, opts?)` | Trade-bundled memos. `{ enrich: true }` adds SAID verification |
+| `getLendingInfo(connection, mint)` | Lending parameters for migrated tokens |
+| `getLoanPosition(connection, mint, wallet)` | Single loan position |
+| `getAllLoanPositions(connection, mint)` | All positions sorted by liquidation risk |
+| `getVault(connection, creator)` | Vault state |
+| `getVaultForWallet(connection, wallet)` | Reverse lookup — find vault by linked wallet |
+| `getVaultWalletLink(connection, wallet)` | Link state for a wallet |
 
 ### Quotes
 
 | Function | Description |
 |----------|-------------|
-| `getBuyQuote(connection, mint, solAmount)` | Simulate a buy — expected tokens, fees, price impact |
-| `getSellQuote(connection, mint, tokenAmount)` | Simulate a sell — expected SOL, price impact |
-| `getBorrowQuote(connection, mint, collateralAmount)` | Max borrowable SOL for given collateral — LTV, pool, and per-user caps |
+| `getBuyQuote(connection, mint, solAmount)` | Expected tokens, fees, price impact. Returns `source: 'bonding' \| 'dex'` |
+| `getSellQuote(connection, mint, tokenAmount)` | Expected SOL, price impact. Returns `source: 'bonding' \| 'dex'` |
+| `getBorrowQuote(connection, mint, collateralAmount)` | Max borrowable SOL with breakdown of constraints |
 
-### Transaction Builders
+### Trading
 
-All builders return `{ transaction: Transaction, message: string }`. You sign and send.
-
-#### Trading
+All builders return `{ transaction: VersionedTransaction, message: string }`.
 
 | Function | Description |
 |----------|-------------|
-| `buildBuyTransaction(connection, params)` | Buy tokens on bonding curve (vault-funded) |
-| `buildDirectBuyTransaction(connection, params)` | Buy tokens (buyer pays directly, no vault) |
-| `buildSellTransaction(connection, params)` | Sell tokens back to the bonding curve (vault-routed) |
-| `buildVaultSwapTransaction(connection, params)` | Buy/sell migrated tokens on Raydium DEX (vault-routed) |
-| `buildMigrateTransaction(connection, params)` | Migrate bonding-complete token to Raydium DEX (permissionless, payer reimbursed by treasury) |
-| `buildCreateTokenTransaction(connection, params)` | Launch a new token |
-| `buildStarTransaction(connection, params)` | Star a token (0.05 SOL, vault-routed) |
+| `buildBuyTransaction(connection, params)` | Buy tokens via vault. Auto-routes bonding curve or DEX based on quote |
+| `buildDirectBuyTransaction(connection, params)` | Buy without vault (human wallets only) |
+| `buildSellTransaction(connection, params)` | Sell tokens via vault. Auto-routes bonding curve or DEX based on quote |
+| `buildCreateTokenTransaction(connection, params)` | Launch a new token with bonding curve + treasury |
+| `buildStarTransaction(connection, params)` | Star a token (0.02 SOL, sybil-resistant) |
+| `buildMigrateTransaction(connection, params)` | Migrate bonding-complete token to Raydium (permissionless) |
 
-#### Vault Management
+### Vault Management
 
 | Function | Signer | Description |
 |----------|--------|-------------|
 | `buildCreateVaultTransaction` | creator | Create vault + auto-link creator |
-| `buildDepositVaultTransaction` | depositor | Deposit SOL (permissionless) |
+| `buildDepositVaultTransaction` | anyone | Deposit SOL (permissionless) |
 | `buildWithdrawVaultTransaction` | authority | Withdraw SOL |
-| `buildWithdrawTokensTransaction` | authority | Withdraw tokens from vault ATA |
-| `buildLinkWalletTransaction` | authority | Link a wallet to the vault |
-| `buildUnlinkWalletTransaction` | authority | Unlink a wallet |
+| `buildWithdrawTokensTransaction` | authority | Withdraw tokens from vault |
+| `buildLinkWalletTransaction` | authority | Link a controller wallet |
+| `buildUnlinkWalletTransaction` | authority | Revoke controller access |
 | `buildTransferAuthorityTransaction` | authority | Transfer admin control |
 
-#### Lending (Post-Migration)
+### Lending (post-migration)
 
 | Function | Description |
 |----------|-------------|
 | `buildBorrowTransaction(connection, params)` | Borrow SOL against token collateral (vault-routed) |
-| `buildRepayTransaction(connection, params)` | Repay SOL debt (vault-routed) |
-| `buildLiquidateTransaction(connection, params)` | Liquidate underwater position (vault-routed) |
-| `buildClaimProtocolRewardsTransaction(connection, params)` | Claim protocol trading rewards (vault-routed) |
+| `buildRepayTransaction(connection, params)` | Repay debt (vault-routed) |
+| `buildLiquidateTransaction(connection, params)` | Liquidate underwater position (>65% LTV) |
+| `buildClaimProtocolRewardsTransaction(connection, params)` | Claim epoch trading rewards (vault-routed) |
 
-#### Treasury Cranks (Permissionless)
+### Treasury Cranks (permissionless)
 
 | Function | Description |
 |----------|-------------|
-| `buildHarvestFeesTransaction(connection, params)` | Harvest Token-2022 transfer fees into treasury. Auto-discovers source accounts or accepts explicit list. |
-| `buildSwapFeesToSolTransaction(connection, params)` | Swap harvested transfer fee tokens to SOL via Raydium. Bundles harvest + swap in one atomic tx. |
+| `buildHarvestFeesTransaction(connection, params)` | Harvest Token-2022 transfer fees into treasury |
+| `buildSwapFeesToSolTransaction(connection, params)` | Swap harvested tokens to SOL via Raydium |
+| `buildReclaimFailedTokenTransaction(connection, params)` | Reclaim tokens inactive 7+ days |
 
 ### SAID Protocol
 
 | Function | Description |
 |----------|-------------|
-| `verifySaid(wallet)` | Check SAID verification status and trust tier |
-| `confirmTransaction(connection, signature, wallet)` | Confirm tx on-chain for reputation tracking |
-
-## Install
-
-```bash
-pnpm add torchsdk
-```
-
-Peer dependency: `@solana/web3.js ^1.98.0`
-
-## Quick Start
-
-```typescript
-import { Connection } from "@solana/web3.js";
-import {
-  getTokens,
-  getToken,
-  buildBuyTransaction,
-  buildDirectBuyTransaction,
-  buildSellTransaction,
-  buildCreateVaultTransaction,
-  buildDepositVaultTransaction,
-  buildLinkWalletTransaction,
-  getVault,
-  confirmTransaction,
-} from "torchsdk";
-
-const connection = new Connection("https://api.mainnet-beta.solana.com");
-```
-
-### Set Up a Vault
-
-```typescript
-// 1. Create vault (user wallet)
-const { transaction: createTx } = await buildCreateVaultTransaction(connection, {
-  creator: userWallet,
-});
-// sign and send createTx...
-
-// 2. Deposit SOL
-const { transaction: depositTx } = await buildDepositVaultTransaction(connection, {
-  depositor: userWallet,
-  vault_creator: userWallet,
-  amount_sol: 5_000_000_000, // 5 SOL
-});
-// sign and send depositTx...
-
-// 3. Link an agent wallet
-const { transaction: linkTx } = await buildLinkWalletTransaction(connection, {
-  authority: userWallet,
-  vault_creator: userWallet,
-  wallet_to_link: agentWallet,
-});
-// sign and send linkTx...
-```
-
-### Trade with Vault
-
-```typescript
-// Agent buys tokens — vault pays
-const { transaction, message } = await buildBuyTransaction(connection, {
-  mint: "TOKEN_MINT_ADDRESS",
-  buyer: agentWallet,
-  amount_sol: 100_000_000,     // 0.1 SOL (in lamports)
-  slippage_bps: 500,           // 5% slippage
-  vote: "burn",                // governance vote on first buy
-  vault: userWallet,           // vault creator key → vault pays
-});
-// agent signs and sends...
-
-// Check vault balance
-const vault = await getVault(connection, userWallet);
-console.log(`Vault: ${vault.sol_balance} SOL, ${vault.linked_wallets} wallets`);
-```
-
-### Direct Buy (No Vault — Human Use Only)
-
-```typescript
-// Buyer pays directly from their wallet — no vault safety
-const { transaction } = await buildDirectBuyTransaction(connection, {
-  mint: "TOKEN_MINT_ADDRESS",
-  buyer: walletAddress,
-  amount_sol: 100_000_000,
-  slippage_bps: 500,
-  vote: "burn",
-});
-```
-
-## Transaction Params
-
-```typescript
-// Buy (vault-funded — recommended for agents)
-{
-  mint: string,
-  buyer: string,
-  amount_sol: number,          // lamports
-  slippage_bps?: number,       // default 100 (1%)
-  vote?: "burn" | "return",    // required on first buy
-  message?: string,            // optional SPL Memo (max 500 chars)
-  vault: string,               // vault creator pubkey (required)
-}
-
-// Direct Buy (no vault — human use only)
-{
-  mint: string,
-  buyer: string,
-  amount_sol: number,          // lamports
-  slippage_bps?: number,       // default 100 (1%)
-  vote?: "burn" | "return",    // required on first buy
-  message?: string,            // optional SPL Memo (max 500 chars)
-}
-
-// Sell
-{
-  mint: string,
-  seller: string,
-  amount_tokens: number,       // raw units (with decimals)
-  slippage_bps?: number,
-  message?: string,
-}
-
-// Create Token
-{ creator: string, name: string, symbol: string, metadata_uri: string, sol_target?: number, community_token?: boolean }
-// sol_target: 100_000_000_000 (Flame), 200_000_000_000 (Torch, default). Spark (50 SOL) removed in V4.0.
-// community_token: true (default) = 0% creator fees, false = creator gets 0.2%→1% bonding + 15% fee swap
-
-// Star
-{ mint: string, user: string }
-
-// Vault
-{ creator: string }                                                    // create
-{ depositor: string, vault_creator: string, amount_sol: number }       // deposit
-{ authority: string, vault_creator: string, amount_sol: number }       // withdraw
-{ authority: string, vault_creator: string, wallet_to_link: string }   // link
-{ authority: string, vault_creator: string, wallet_to_unlink: string } // unlink
-{ authority: string, vault_creator: string, new_authority: string }    // transfer
-
-// Vault Swap (DEX trading for migrated tokens)
-{ mint: string, signer: string, vault_creator: string, amount_in: number, minimum_amount_out: number, is_buy: boolean }
-
-// Lending (all support optional vault?: string for vault routing)
-{ mint: string, borrower: string, collateral_amount: number, sol_to_borrow: number, vault?: string }
-{ mint: string, borrower: string, sol_amount: number, vault?: string }
-{ mint: string, liquidator: string, borrower: string, vault?: string }
-
-// Migrate (permissionless — anyone can trigger for bonding-complete tokens, treasury reimburses payer)
-{ mint: string, payer: string }
-
-// Swap Fees to SOL (permissionless — bundles harvest + swap, treasury reimburses)
-{ mint: string, payer: string, minimum_amount_out?: number, harvest?: boolean, sources?: string[] }
-
-// Rewards (optional vault routing)
-{ user: string, vault?: string }                                       // claim protocol rewards
-```
+| `verifySaid(wallet)` | Check verification status and trust tier |
+| `confirmTransaction(connection, sig, wallet)` | Report tx for reputation tracking |
 
 ## Network Configuration
 
-The SDK detects the network at runtime. No rebuild needed to switch between mainnet and devnet.
-
 ```typescript
-// Browser: set before SDK calls (e.g., in a network switcher)
+// Browser
 (globalThis as any).__TORCH_NETWORK__ = 'devnet'
 
-// Node.js: set via environment variable
+// Node.js
 // TORCH_NETWORK=devnet npx tsx your-script.ts
 ```
 
-The SDK checks `globalThis.__TORCH_NETWORK__` first (for browser runtime switching), then falls back to `process.env.TORCH_NETWORK`. When set to `'devnet'`, all Raydium addresses automatically switch to devnet versions.
-
-## Vault Safety Model
-
-The Torch Vault provides protocol-level full custody for AI agent interaction:
-
-| Property | Guarantee |
-|----------|-----------|
-| **Full custody** | Vault holds all SOL and all tokens. Controller wallet holds nothing. |
-| **Closed loop** | All operations return value to the vault. No leakage to controller. |
-| **Authority separation** | Creator (immutable PDA seed) vs Authority (transferable admin). Agent wallets get *usage* rights, not ownership. |
-| **One link per wallet** | A wallet can only belong to one vault. PDA uniqueness enforces this. |
-| **Permissionless deposits** | Anyone can top up any vault. Hardware wallet deposits, agent spends. |
-| **Instant revocation** | Authority can unlink a wallet at any time. |
-| **Authority-only withdrawals** | Only the vault authority can withdraw SOL or tokens. Controllers cannot extract value. |
-
-## Running the E2E Test
-
-The test runs the full lifecycle against a [Surfpool](https://github.com/txtx/surfpool) mainnet fork.
+## Testing
 
 ```bash
-# Start a local Solana fork
+# Mainnet fork (Surfpool)
 surfpool start --network mainnet --no-tui
-
-# Run the test
 npx tsx tests/test_e2e.ts
-```
 
-Expected output: `RESULTS: 35 passed, 0 failed`
+# Devnet
+TORCH_NETWORK=devnet npx tsx tests/test_devnet_e2e.ts
+```
 
-Test coverage: create token, vault lifecycle (create/deposit/query/withdraw/withdraw tokens), buy (direct + vault), link/unlink wallet, sell, star, messages, confirm, full bonding to graduation (100/200 SOL tiers), permissionless Raydium migration (V26 two-step), harvest transfer fees (auto-discovery), swap fees to SOL (harvest + Raydium swap in one tx), borrow, repay, vault swap (buy + sell on Raydium DEX), vault-routed liquidation, protocol reward claims (epoch volume + vault-routed claim).
+## Links
 
-A separate devnet E2E test (`tests/test_devnet_e2e.ts`) validates the full lifecycle against Solana devnet with `TORCH_NETWORK=devnet`. A tiers test (`tests/test_tiers.ts`) validates the full lifecycle across graduation tiers (Flame/Torch) including harvest and lending.
+- [torch.market](https://torch.market)
+- [SDK source](https://github.com/mrsirg97-rgb/torchsdk)
+- [npm](https://www.npmjs.com/package/torchsdk)
+- [Design doc](./design.md)
+- [SDK audit](./audit.md)
+- Program ID: `8hbUkonssSEEtkqzwM7ZcZrD9evacM92TcWSooVF4BeT`
 
 ## License