@soltracer/nft-staking 0.3.1 → 0.4.0

package/INTEGRATION.md

@@ -131,7 +131,7 @@ const ix = await client.createStakePool(
     rewardMint: mintPubkey,
     baseRate: 100,
     rateInterval: 86400,
-    traitBonusMode: 0,
+    traitBonusEnabled: false,
     quantityThresholds: [],
   },
   [{ lockDuration: 30 * 86400, rewardRate: 150, earlyUnstakePenaltyBps: 500, claimOnlyAtEnd: false }],
@@ -196,10 +196,29 @@ const fund = await client.fundRewardVault(poolId, amount, { rewardMint: mintPk }
 
 ### Close Pool
 
+Permanently deletes the pool account and refunds rent to the project authority. This is a hard delete — the account
+ceases to exist on-chain. The on-chain guard requires **all four** of the following before it will close:
+
+1. `is_active == false` — flip it off first via `updateStakePool({ isActive: false })`.
+2. `total_staked == 0` — every staker must have unstaked.
+3. `total_obligation_pending == 0` — every staker must have claimed (settled inside the ix via `pool_settle`).
+4. Token-reward pools only: the reward vault ATA must hold zero — drain via `withdrawRewardVault(poolId, amount)`.
+
 ```ts
+// Step 1 — deactivate so no new stakes can land while you wind down.
+await client.updateStakePool(poolId, { isActive: false })
+
+// Step 2 — (off-chain) wait for or coordinate all unstakes + claims.
+//          Optionally drain leftover rewards back to the project treasury:
+await client.withdrawRewardVault(poolId, remainingBalance)
+
+// Step 3 — permanent close. The SDK auto-resolves the reward vault for token pools.
 const ix = await client.closeStakePool(poolId)
 ```
 
+If any precondition fails the program returns `PoolStillActive`, `PoolHasActiveStakes`,
+`PoolHasOutstandingObligations`, or `VaultNotEmpty` so you can surface the exact blocker in the admin UI.
+
 ### Secondary Rewards Management
 
 ```ts
@@ -269,117 +288,155 @@ Early-unstake penalties apply on exit when configured.
 
 ### Trait Bonus Claims
 
-`RewardConfig.traitBonusMode` controls how a signed `traitBonusRate` is interpreted:
+`RewardConfig.traitBonusEnabled` is a single boolean. When `false`, claims that include a non-zero `traitBonusRate`
+are rejected on-chain. When `true`, the pool accepts a signed `u64` `traitBonusRate` and **adds it directly** to the
+staker's effective rate for the accrual window. There are no modes, no on-chain multipliers, no per-claim cross-NFT
+math — the chain only ever sees one absolute number.
+
+All bonus aggregation (per-trait lookups, per-NFT multipliers, caps, edge cases) lives off-chain in the trait-authority
+server. The server is the only party that can produce a signature the pool will accept, so reward rules are fully
+enforced even though the chain knows nothing about traits.
 
-- `0` / `None`: trait bonus proofs are disabled; nonzero `traitBonusRate` is rejected.
-- `1` / `FixedExtra`: `traitBonusRate` is a raw extra reward rate per interval, added temporarily for the claim accrual
-  window.
-- `2` / `BaseMultiplier`: `traitBonusRate` is bonus basis points over the staker's current base effective rate. `10_000`
-  means +100%, so total accrual for that window is 2x base.
+#### Why per-NFT (not per-staker) multipliers
 
-#### Aggregating per-trait bonuses
+If you want rare NFTs to earn more, multiply the rare NFT's **own** bonus contribution and leave every other staked
+NFT's contribution alone. A staker-wide multiplier (e.g. "Mythic NFT = 2× everything") cross-contaminates: every plain
+NFT they own also doubles its rewards inside the same claim window. The SDK's `computeTraitBonusRate` helper applies
+`multiplierBps` per NFT and sums the results, so one NFT's multiplier can never inflate another's reward.
 
-The on-chain instruction accepts a **single** `u64` `traitBonusRate` per claim — it has no notion of per-trait or
-per-NFT granularity, and it cannot read NFT metadata. Aggregation lives entirely off-chain in the trait-authority
-server. The intended flow:
+#### Backend flow
 
-1. **Client request.** The wallet calls your API with `{ wallet, poolId, mints }` (the mints it wants to claim against).
+1. **Client request.** The wallet calls your API with `{ wallet, poolId, mints }`.
 2. **Ownership / stake validation.** The API resolves the wallet's active stake entries
-   (`client.fetchStakeEntriesByOwner(poolId, wallet)`) and **drops** any mint not present — never trust the client's
+   (`client.fetchStakeEntriesByOwner(wallet, poolId)`) and **drops** any mint not present — never trust the client's
    list. Anything that survives is provably staked by `wallet` in `pool`.
 3. **Trait resolution.** For each surviving mint, fetch its trait list from your own source of truth (collection JSON,
    Metaplex on-chain metadata, indexer, internal DB). The chain stores no trait data.
-4. **Catalog lookup.** Each `(traitType, value)` pair is checked against your project's bonus catalog. Traits without
-   an entry contribute nothing.
-5. **Mode-aware sum.** Bonuses are summed according to the pool's `rewardConfig.traitBonusMode`:
-   - `FixedExtra`: catalog uses `fixedExtra` (raw reward per `rateInterval`); each matched trait adds its value.
-   - `BaseMultiplier`: catalog uses `bonusBps` (10_000 = +100%); each matched trait adds its BPS to a single boost that
-     scales the staker's current `effective_rate` for the accrual window.
-6. **Sign and return.** Sign the resulting `u64` with the pool's `traitAuthority` keypair; return signature + rate to
-   the client.
-
-The SDK ships `computeTraitBonusRate` for steps 4–5 (mode-aware aggregation only) and `prepareTraitProof` for the full
-pipeline (steps 2–5 plus the 80-byte signable message). Pick whichever fits how much of the flow your stack already
-owns.
+4. **Catalog lookup.** Each `(traitType, value)` pair is checked against your project's bonus catalog. Each match
+   adds its `bonus` (absolute raw reward units per `rateInterval`) to that NFT's running total.
+5. **Per-NFT multiplier (optional).** If the NFT carries a project-defined `multiplierBps`, multiply its bonus sum by
+   `multiplierBps / 10_000`. The multiplier never escapes that NFT.
+6. **Aggregate.** Sum every NFT's post-multiplier bonus into one `u64` — that is the `traitBonusRate`.
+7. **Sign and return.** Sign the 80-byte message with the pool's `traitAuthority` keypair (or the global stake-config
+   authority); return `{ signature, traitBonusRate }` to the client.
+
+`computeTraitBonusRate` performs steps 4–6 in one call; `prepareTraitProof` performs steps 2–6 plus the signable
+message (step 7's payload). Pick whichever fits how much of the flow your stack already owns.
 
 #### Managing the bonus catalog (any DB)
 
-The admin UI (Trait Bonuses card) writes a row per `(projectId, poolId, traitType, traitValue)` to your DB. Sample
-Prisma schema used by the reference app:
+The catalog is keyed by **NFT collection mint**, not by pool id. The same set of trait bonuses applies to every
+pool that stakes a given collection — if you run a 30-day and a 90-day pool over the same NFTs, they share one
+catalog and you only manage it in one place. (Pools toggle whether the bonus is *used* via
+`rewardConfig.traitBonusEnabled` and supply the signing authority; the bonus values themselves live with the
+collection.)
+
+Each row stores one absolute `bonus` amount in raw reward units per `rateInterval`. Sample Prisma schema:
 
 ```prisma
 model TraitBonusConfig {
-  id          String   @id @default(cuid())
-  projectId   String   @map("project_id")
-  poolId      Int      @map("pool_id")
-  traitType   String   @map("trait_type") @db.VarChar(64)
-  traitValue  String   @map("trait_value") @db.VarChar(64)
-  bonusAmount Int      @map("bonus_amount")   // bonusBps (mode 2) or fixedExtra (mode 1)
-  imageUrl    String?  @map("image_url")
-  createdAt   DateTime @default(now())
-  updatedAt   DateTime @updatedAt
-
-  @@unique([projectId, poolId, traitType, traitValue])
+  id              String   @id @default(cuid())
+  projectId       String   @map("project_id")
+  collectionMint  String   @map("collection_mint") @db.VarChar(44) // base58 pubkey
+  traitType       String   @map("trait_type")      @db.VarChar(64)
+  traitValue      String   @map("trait_value")     @db.VarChar(64)
+  bonus           BigInt   @map("bonus")           // raw reward units per rateInterval
+  imageUrl        String?  @map("image_url")
+  createdAt       DateTime @default(now())
+  updatedAt       DateTime @updatedAt
+
+  @@unique([collectionMint, traitType, traitValue])
+  @@index([projectId])
   @@map("trait_bonus_configs")
 }
 ```
 
-You can model this however you like — Drizzle, raw Postgres, Mongo, KV, Firestore, an in-memory map for testing. The
-SDK only needs a `TraitBonusStore` adapter:
+Model it however you like — Drizzle, raw Postgres, Mongo, KV, Firestore, an in-memory map for testing. The SDK only
+needs a `TraitBonusStore` adapter that resolves a collection mint to its catalog rows:
 
 ```ts
 import type { TraitBonusStore } from "@soltracer/nft-staking"
 
 // Prisma example
 export const prismaTraitBonusStore: TraitBonusStore = {
-  async list({ poolId, projectId }) {
-    const rows = await prisma.traitBonusConfig.findMany({
-      where: { poolId, ...(projectId ? { projectId: String(projectId) } : {}) },
-    })
+  async listForCollection(collectionMint) {
+    const rows = await prisma.traitBonusConfig.findMany({ where: { collectionMint } })
     return rows.map((r) => ({
       traitType: r.traitType,
       value: r.traitValue,
-      // Pool in BaseMultiplier mode? use bonusBps. FixedExtra? use fixedExtra.
-      bonusBps: r.bonusAmount,
+      bonus: BigInt(r.bonus),
     }))
   },
 }
 
 // Drizzle example (drop-in replacement)
 export const drizzleTraitBonusStore: TraitBonusStore = {
-  async list({ poolId, projectId }) {
+  async listForCollection(collectionMint) {
     const rows = await db
       .select()
       .from(traitBonusConfig)
-      .where(and(eq(traitBonusConfig.poolId, poolId), projectId ? eq(traitBonusConfig.projectId, String(projectId)) : undefined))
-    return rows.map((r) => ({ traitType: r.traitType, value: r.traitValue, bonusBps: r.bonusAmount }))
+      .where(eq(traitBonusConfig.collectionMint, collectionMint))
+    return rows.map((r) => ({ traitType: r.traitType, value: r.traitValue, bonus: BigInt(r.bonus) }))
   },
 }
 
-// In-memory (for tests / examples)
-export function makeMemoryStore(seed: TraitBonusCatalogEntry[]): TraitBonusStore {
-  return { async list() { return seed } }
+// Firebase / Firestore example
+// Collection layout: traitBonusConfigs/{autoId} with fields
+//   { projectId: string, collectionMint: string, traitType: string, traitValue: string, bonus: string }
+// `bonus` is stored as a decimal string so values > 2^53 survive JSON round-trips.
+import { collection, getDocs, query, where } from "firebase/firestore"
+import { db as firestore } from "./firebase" // your initialised Firestore instance
+
+export const firestoreTraitBonusStore: TraitBonusStore = {
+  async listForCollection(collectionMint) {
+    const snap = await getDocs(
+      query(collection(firestore, "traitBonusConfigs"), where("collectionMint", "==", collectionMint)),
+    )
+    return snap.docs.map((d) => {
+      const r = d.data() as { traitType: string; traitValue: string; bonus: string }
+      return { traitType: r.traitType, value: r.traitValue, bonus: BigInt(r.bonus) }
+    })
+  },
 }
+
+// Realtime Database variant (admin SDK)
+//   /traitBonusConfigs/{collectionMint}/{autoId} = { traitType, traitValue, bonus }
+import { getDatabase } from "firebase-admin/database"
+
+export const firebaseRtdbTraitBonusStore: TraitBonusStore = {
+  async listForCollection(collectionMint) {
+    const snap = await getDatabase().ref(`traitBonusConfigs/${collectionMint}`).get()
+    const val = (snap.val() ?? {}) as Record<string, { traitType: string; traitValue: string; bonus: string }>
+    return Object.values(val).map((r) => ({
+      traitType: r.traitType,
+      value: r.traitValue,
+      bonus: BigInt(r.bonus),
+    }))
+  },
+}
+
+// In-memory (for tests / examples)
+import { InMemoryTraitBonusStore } from "@soltracer/nft-staking"
+const memStore = InMemoryTraitBonusStore.from({
+  // key by collection mint (base58)
+  "5XyZ...AaBb": [{ traitType: "Rarity", value: "Mythic", bonus: 1_000_000n }],
+})
 ```
 
 Recommended CRUD endpoints (the reference app exposes these as tRPC; HTTP/GraphQL works identically):
 
 | Operation | Inputs | Behavior |
 | --- | --- | --- |
-| `list` | `{ projectId, poolId }` | Returns all catalog rows for the pool. Used by the admin UI and by `TraitBonusStore.list`. |
-| `create` | `{ projectId, poolId, traitType, traitValue, bonusAmount, imageUrl? }` | Inserts one row. |
-| `update` | `{ id, bonusAmount?, imageUrl? }` | Updates a single row. |
+| `list` | `{ projectId, collectionMint }` | Returns all catalog rows for the collection. |
+| `create` | `{ projectId, collectionMint, traitType, traitValue, bonus, imageUrl? }` | Inserts one row. |
+| `update` | `{ id, bonus?, imageUrl? }` | Updates a single row. |
 | `delete` | `{ id }` | Deletes a row. |
-| `upsert` (bulk) | `{ projectId, poolId, bonuses: [...] }` | Idempotent bulk replace via the unique `(projectId, poolId, traitType, traitValue)` index. |
+| `upsert` (bulk) | `{ projectId, collectionMint, bonuses: [...] }` | Idempotent bulk replace via the unique `(collectionMint, traitType, traitValue)` index. |
 
-Treat all five as admin-only. Gate them behind a project-authority check (e.g. signed-message session for the
-project's `authority` wallet) so non-admins can't rewrite reward rules.
+Treat all five as admin-only. Gate them behind a project-authority check so non-admins can't rewrite reward rules.
 
 #### Full backend flow with `prepareTraitProof`
 
-`prepareTraitProof` wires together ownership validation, trait resolution, the store, and the 80-byte message into a
-single async call. You only supply the four pieces that depend on your infrastructure:
-
 ```ts
 import {
   prepareTraitProof,
@@ -388,50 +445,56 @@ import {
 } from "@soltracer/nft-staking"
 import nacl from "tweetnacl"
 
-// One-time wiring:
-const traitBonusStore = prismaTraitBonusStore                  // from §"Managing the bonus catalog"
+const traitBonusStore = prismaTraitBonusStore
 const resolveTraits: NftTraitResolver = async (mint) => {
-  // Your trait source: Metaplex metadata, indexer, internal DB, collection JSON, etc.
   const nft = await metadataIndex.getByMint(mint)
-  return nft.attributes.map((a) => ({ traitType: a.trait_type, value: a.value }))
+  return {
+    traits: nft.attributes.map((a) => ({ traitType: a.trait_type, value: a.value })),
+    // Optional — only set for NFTs that earn a per-NFT multiplier (e.g. 1-of-1s).
+    // Affects ONLY this NFT's own bonus sum. 10_000 = 1x, 20_000 = 2x.
+    multiplierBps: nft.rarityTier === "mythic" ? 20_000 : undefined,
+  }
 }
-const validateOwnership = ownershipFromClient(client)          // or your own stake-state index
+const isStakedBy = ownershipFromClient(client) // verifies via fetchStakeEntriesByOwner
 
 // ── POST /api/staking/trait-proof
-async function handleProofRequest(req: { wallet: PublicKey; projectId: string; poolId: number; mints: string[] }) {
+async function handleProofRequest(req: { wallet: PublicKey; poolId: number; mints: string[] }) {
   const pool = await client.fetchStakePool(undefined, req.poolId)
   const staker = await client.fetchStakerAccount(req.poolId, req.wallet)
 
-  const prepared = await prepareTraitProof({
-    pool: { address: pool.address, rewardConfig: pool.rewardConfig },
-    projectId: req.projectId,
-    poolId: req.poolId,
+  const { message, traitBonusRate, perNft, rejectedMints } = await prepareTraitProof({
+    pool: pool.address,
     wallet: req.wallet,
-    requestedMints: req.mints,
+    totalClaimed: staker.totalClaimed,
+    poolId: req.poolId,
+    // Catalog is keyed by collection mint — read it straight off the pool so
+    // every pool over the same collection shares one set of trait bonuses.
+    collectionMint: pool.collectionMint.toBase58(),
+    mints: req.mints,
     store: traitBonusStore,
     resolveTraits,
-    validateOwnership,
-    totalClaimed: staker.totalClaimed,
+    isStakedBy,
   })
 
-  const signature = nacl.sign.detached(prepared.message, traitAuthority.secretKey)
+  const signature = nacl.sign.detached(message, traitAuthority.secretKey)
 
   return {
-    traitBonusRate: prepared.traitBonusRate.toString(),
+    traitBonusRate: traitBonusRate.toString(),
     signature: Buffer.from(signature).toString("base64"),
     traitAuthority: traitAuthority.publicKey.toBase58(),
-    validatedMints: prepared.validatedMints,
-    rejectedMints: prepared.rejectedMints,
-    perNft: prepared.perNft, // [{ mint, bonus, matchedTraits }] — display in the claim UI
+    perNft: perNft.map((p) => ({ mint: p.mint, bonus: p.bonus.toString() })),
+    rejectedMints,
   }
 }
 ```
 
-Client side, pass the returned `signature` and `traitBonusRate` (as `BN`) into `client.claimRewards(poolId, { traitBonusRate, fee })`
+Client side, pass the returned `signature` and `traitBonusRate` into `client.claimRewards(poolId, { traitBonusRate, fee })`
 and prepend the `Ed25519Program.createInstructionWithPublicKey({ publicKey: traitAuthority, message, signature })`
 instruction to the same transaction.
 
-The original lower-level helpers remain available if you want to compose the pipeline yourself:
+#### Composing the pipeline manually
+
+If you already own ownership validation or trait resolution, use the lower-level helpers directly:
 
 ```ts
 import {
@@ -442,74 +505,82 @@ import {
 } from "@soltracer/nft-staking"
 import nacl from "tweetnacl"
 
-// ── Server: POST /claim/trait-proof  body: { wallet, poolId, mints }
 async function buildProof(req: { wallet: PublicKey; poolId: number; mints: string[] }) {
   // 2. Validate ownership / current stake state.
-  const entries = await client.fetchStakeEntriesByOwner(req.poolId, req.wallet)
+  const entries = await client.fetchStakeEntriesByOwner(req.wallet, req.poolId)
   const stakedSet = new Set(entries.map((e) => e.nftMint.toBase58()))
   const ownedMints = req.mints.filter((m) => stakedSet.has(m))
 
-  // 3. Resolve traits from your collection catalog.
+  // 3. Resolve traits + optional per-NFT multiplier.
   const nfts: NftTraitInput[] = await Promise.all(
-    ownedMints.map(async (mint) => ({
-      mint,
-      traits: await catalog.getTraits(mint), // [{ traitType, value }, ..]
-    })),
+    ownedMints.map(async (mint) => {
+      const meta = await catalog.getMint(mint)
+      return {
+        mint,
+        traits: meta.traits, // [{ traitType, value }, ..]
+        multiplierBps: meta.multiplierBps, // optional, per-NFT only
+      }
+    }),
   )
 
-  // 4 + 5. Mode-aware aggregation against the project's bonus catalog.
-  const pool = await client.fetchStakePool(undefined, req.poolId)
+  // 4–6. Per-NFT lookup → optional per-NFT multiply → global sum.
   const bonusCatalog: TraitBonusCatalogEntry[] = [
-    { traitType: "Background", value: "Mythic",     bonusBps: 2500 }, // +25%
-    { traitType: "Eyes",       value: "Laser",      bonusBps: 1000 }, // +10%
-    { traitType: "Head",       value: "Gold Crown", bonusBps:  500 }, //  +5%
+    { traitType: "Background", value: "Mythic",     bonus: 25_000_000n },
+    { traitType: "Eyes",       value: "Laser",      bonus: 10_000_000n },
+    { traitType: "Head",       value: "Gold Crown", bonus:  5_000_000n },
   ]
   const { traitBonusRate, perNft } = computeTraitBonusRate({
-    traitBonusMode: pool.rewardConfig.traitBonusMode as 0 | 1 | 2,
     catalog: bonusCatalog,
     nfts,
   })
 
-  // 6. Sign the aggregated rate.
-  const stakerAccount = await client.fetchStakerAccount(req.poolId, req.wallet)
+  // 7. Sign the aggregated rate.
+  const staker = await client.fetchStakerAccount(req.poolId, req.wallet)
+  const pool = await client.fetchStakePool(undefined, req.poolId)
   const message = buildTraitProofMessage({
     pool: pool.address,
     wallet: req.wallet,
     traitBonusRate,
-    totalClaimed: stakerAccount.totalClaimed,
+    totalClaimed: staker.totalClaimed,
   })
   const signature = nacl.sign.detached(message, traitAuthority.secretKey)
   return { traitBonusRate: traitBonusRate.toString(), signature, perNft }
 }
 ```
 
-> ⚠️ Re-run the entire pipeline on every claim. The staked set, NFT traits, and the staker's `totalClaimed` nonce can
-> all change between claims; a stale proof is rejected on-chain.
+> ⚠️ Re-run the entire pipeline on every claim. The staked set, NFT traits, and `staker.totalClaimed` can all change
+> between claims; a stale proof is rejected on-chain.
 
-Examples per mode:
+#### Per-NFT multiplier example
 
-| Mode | Catalog field | What 1 matched trait contributes | Final `traitBonusRate` |
-| --- | --- | --- | --- |
-| `FixedExtra` | `fixedExtra: 100` | +100 reward tokens per `rateInterval` | Sum across every matched trait on every validated NFT. |
-| `BaseMultiplier` | `bonusBps: 500` | +5% over the staker's current effective rate | Sum across every matched trait on every validated NFT. `10_000` ⇒ 2x base for that claim window. |
+Catalog row: `{ traitType: "Rarity", value: "Mythic", bonus: 1_000_000n }`.
+Staker has two staked NFTs:
+
+| NFT  | Traits matched | Pre-multiplier sum | `multiplierBps` | Post-multiplier sum |
+| ---- | -------------- | ------------------ | --------------- | ------------------- |
+| A    | Rarity = Mythic | 1_000_000n         | 20_000 (2×)     | 2_000_000n          |
+| B    | (none)          | 0n                 | (n/a)           | 0n                  |
+
+`traitBonusRate = 2_000_000n + 0n = 2_000_000n`. The mythic multiplier doubles A's contribution; B is unaffected.
+Compare to the old `BaseMultiplier` model, which would have doubled the rewards from B as well — that bug is why the
+on-chain enum was replaced with a boolean.
 
-Trait proof messages bind the pool, wallet, signed rate, and the staker account's strictly-monotonic `totalClaimed`
-counter. A new proof is required after every successful claim because `totalClaimed` advances.
+#### Trait proof message format
 
-Use the SDK's `buildTraitProofMessage` helper to assemble the exact 80-byte payload the on-chain verifier rebuilds
-(`pool ‖ wallet ‖ rate u64 LE ‖ totalClaimed u64 LE`):
+The Ed25519 verifier rebuilds an 80-byte payload: `pool ‖ wallet ‖ traitBonusRate u64 LE ‖ totalClaimed u64 LE`. Use
+`buildTraitProofMessage` to construct it identically.
 
 ```ts
 import nacl from "tweetnacl"
 import { Ed25519Program, Transaction } from "@solana/web3.js"
 import { buildTraitProofMessage } from "@soltracer/nft-staking"
 
-const stakerAccount = await client.fetchStakerAccount(poolId, wallet)
+const staker = await client.fetchStakerAccount(poolId, wallet)
 const message = buildTraitProofMessage({
   pool,
   wallet,
-  traitBonusRate, // BN
-  totalClaimed: stakerAccount.totalClaimed,
+  traitBonusRate,
+  totalClaimed: staker.totalClaimed,
 })
 const signature = nacl.sign.detached(message, traitAuthority.secretKey)
 const ed25519Ix = Ed25519Program.createInstructionWithPublicKey({
@@ -522,7 +593,27 @@ await provider.sendAndConfirm(new Transaction().add(ed25519Ix, claimIx))
 ```
 
 The Ed25519 verifier instruction MUST be in the same transaction as `claimRewards` and the signing pubkey MUST match
-`pool.traitAuthority` (or the global trait authority if configured).
+`pool.traitAuthority` (or the global `stakeConfig.authority` if the pool has no override). The pool also rejects any
+non-zero `traitBonusRate` when `rewardConfig.traitBonusEnabled` is `false`.
+
+#### Trait authority scope — per-project, not platform-global
+
+There is **no platform-wide trait authority**. The on-chain hierarchy is:
+
+| Account | Field | Scope | How to set |
+| --- | --- | --- | --- |
+| `StakePool` | `traitAuthority` | **Per pool** (overrides the project default when non-zero) | `updateStakePool(poolId, { traitAuthority: <pubkey> })` |
+| `StakeConfig` | `authority` | **Per project** (used as fallback when `pool.traitAuthority == Pubkey::default()`) | Set when the project's `StakeConfig` is initialised; rotated via your project-management flow. |
+
+In practice each project has its own `StakeConfig` PDA — the same wallet that authorises pool admin actions also acts
+as the default trait signer for that project. To use a separate, dedicated trait-signing wallet (recommended so you
+can rotate it without touching the admin key), call `updateStakePool` with `traitAuthority` set to the dedicated
+keypair's pubkey. Pass `Pubkey::default()` (32 zero bytes) to clear the override and fall back to
+`stakeConfig.authority`.
+
+Because the authority is scoped to one project's pools, multi-project deployments must run one signing service (or one
+keypair) **per project**. Do not share a single signer across projects unless you also re-use the same `StakeConfig`
+authority across them.
 
 ### Merkle Gate Proofs
 

package/dist/client.d.ts

@@ -217,7 +217,7 @@ export declare class NftStakingClient {
         rewardMint: PkInput;
         baseRate: number;
         rateInterval: number;
-        traitBonusMode: number;
+        traitBonusEnabled: boolean;
         quantityThresholds: QuantityBonusInput[];
     }, lockConfigs: {
         lockDuration: number;
@@ -236,7 +236,7 @@ export declare class NftStakingClient {
             rewardMint: PkInput;
             baseRate: number;
             rateInterval: number;
-            traitBonusMode: number;
+            traitBonusEnabled: boolean;
             quantityThresholds: QuantityBonusInput[];
         } | null;
         lockConfigs?: {
@@ -267,6 +267,19 @@ export declare class NftStakingClient {
         destinationTokenAccount?: PkInput;
         projectId?: number;
     }): Promise<TransactionInstruction>;
+    /**
+     * Permanently close (delete) a stake pool. The pool account is closed and
+     * rent is refunded to `authority`. The on-chain handler requires:
+     *
+     *   - `is_active == false` — call `updateStakePool({ isActive: false })` first.
+     *   - `total_staked == 0` — every NFT must be unstaked.
+     *   - `total_obligation_pending == 0` — every staker must have claimed.
+     *   - For token-reward pools, the `reward_vault` ATA must hold zero —
+     *     drain via `withdrawRewardVault` before closing.
+     *
+     * The reward vault and its token program are auto-resolved from the pool
+     * for token-reward pools. Points/SOL pools pass `null` automatically.
+     */
     closeStakePool(poolId: number, projectId?: number): Promise<TransactionInstruction>;
     /** Stake a legacy/pNFT. Auto-resolves stakingMode from pool. */
     stakeNft(poolId: number, nftMint: PkInput, opts?: {

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -731,7 +731,7 @@ export class NftStakingClient {
             rewardMint: _rewardMint,
             baseRate: new BN(Math.round(rewardConfig.baseRate * multiplier)),
             rateInterval: new BN(rewardConfig.rateInterval),
-            traitBonusMode: rewardConfig.traitBonusMode,
+            traitBonusEnabled: rewardConfig.traitBonusEnabled,
             quantityThresholds: rewardConfig.quantityThresholds.map(normalizeQuantityBonus),
         };
         const rawLockConfigs = lockConfigs.map((lc) => ({
@@ -790,7 +790,7 @@ export class NftStakingClient {
                 rewardMint: _rMint,
                 baseRate: new BN(Math.round(rewardConfig.baseRate * multiplier)),
                 rateInterval: new BN(rewardConfig.rateInterval),
-                traitBonusMode: rewardConfig.traitBonusMode,
+                traitBonusEnabled: rewardConfig.traitBonusEnabled,
                 quantityThresholds: rewardConfig.quantityThresholds.map(normalizeQuantityBonus),
             };
         }
@@ -884,18 +884,42 @@ export class NftStakingClient {
         })
             .instruction();
     }
+    /**
+     * Permanently close (delete) a stake pool. The pool account is closed and
+     * rent is refunded to `authority`. The on-chain handler requires:
+     *
+     *   - `is_active == false` — call `updateStakePool({ isActive: false })` first.
+     *   - `total_staked == 0` — every NFT must be unstaked.
+     *   - `total_obligation_pending == 0` — every staker must have claimed.
+     *   - For token-reward pools, the `reward_vault` ATA must hold zero —
+     *     drain via `withdrawRewardVault` before closing.
+     *
+     * The reward vault and its token program are auto-resolved from the pool
+     * for token-reward pools. Points/SOL pools pass `null` automatically.
+     */
     async closeStakePool(poolId, projectId) {
         const pid = this.resolveProjectId(projectId);
         const [poolPda] = getStakePoolPda(pid, poolId);
         const [project] = getProjectPda(pid);
+        // Token-reward pools must pass the (empty) reward vault so the program
+        // can assert it. Points pools omit it.
+        const pool = await this.fetchStakePool(pid, poolId);
+        let rewardVault = null;
+        let tokenProgram = null;
+        if (pool && pool.rewardConfig.rewardType === 0 /* Token */) {
+            const rewardMint = toPk(pool.rewardConfig.rewardMint);
+            tokenProgram = await this.resolveTokenProgram(rewardMint);
+            const [poolAuthority] = getPoolAuthorityPda(pid, poolId);
+            rewardVault = getAta(poolAuthority, rewardMint, tokenProgram);
+        }
         return this.program.methods
             .closeStakePool(new BN(pid), new BN(poolId))
             .accountsStrict({
             pool: poolPda,
             project,
             projectManagementProgram: PROJECT_MANAGEMENT_PROGRAM_ID,
-            rewardVault: null,
-            tokenProgram: null,
+            rewardVault,
+            tokenProgram,
             authority: this.provider.wallet.publicKey,
         })
             .instruction();