@soltracer/nft-staking 0.3.1 → 0.5.0

package/dist/idl.json

@@ -1565,7 +1565,7 @@
                 {
                     "name": "stake_config",
                     "docs": [
-                        "Global stake config \u2014 holds the platform's default trait authority."
+                        "Global stake config — holds the platform's default trait authority."
                     ],
                     "pda": {
                         "seeds": [
@@ -2638,7 +2638,7 @@
                 {
                     "name": "reward_vault",
                     "docs": [
-                        "Reward vault \u2014 required for token-reward pools. Must be drained before closure.",
+                        "Reward vault — required for token-reward pools. Must be drained before closure.",
                         "Pass the pool_authority ATA for the reward mint. Omit for SOL-reward pools."
                     ],
                     "optional": true
@@ -2851,14 +2851,14 @@
                 {
                     "name": "reward_mint",
                     "docs": [
-                        "Reward mint \u2014 the token paid out as rewards (can be any SPL token).",
+                        "Reward mint — the token paid out as rewards (can be any SPL token).",
                         "Ignored if reward_type == Points."
                     ]
                 },
                 {
                     "name": "reward_vault",
                     "docs": [
-                        "Reward vault ATA owned by pool_authority \u2014 created for token rewards."
+                        "Reward vault ATA owned by pool_authority — created for token rewards."
                     ],
                     "writable": true,
                     "pda": {
@@ -3070,6 +3070,10 @@
                 {
                     "name": "allow_unlocked_staking",
                     "type": "bool"
+                },
+                {
+                    "name": "name",
+                    "type": "string"
                 }
             ]
         },
@@ -6193,7 +6197,7 @@
         {
             "name": "sync_stake_entry_secondary",
             "docs": [
-                "re-sync one StakeEntry's contribution to",
+                "STAKE-FRESH-2026-05-11 (F-H4): re-sync one StakeEntry's contribution to",
                 "`pool_secondary.rewards[secondary_index]`. Permissionless. Lets",
                 "existing stakers begin accruing on a secondary that was added",
                 "post-stake (or pick up a rate-update) without unstaking."
@@ -6383,7 +6387,7 @@
                 {
                     "name": "payer",
                     "docs": [
-                        "Permissionless \u2014 anyone may invoke. Pays no tx fee beyond signer",
+                        "Permissionless — anyone may invoke. Pays no tx fee beyond signer",
                         "requirement and does not need to match the staker."
                     ],
                     "signer": true
@@ -7310,7 +7314,7 @@
                 {
                     "name": "staker_nft_account",
                     "docs": [
-                        "User's NFT token account \u2014 destination for unstaked NFT."
+                        "User's NFT token account — destination for unstaked NFT."
                     ],
                     "writable": true
                 },
@@ -7806,6 +7810,12 @@
                     "type": {
                         "option": "bool"
                     }
+                },
+                {
+                    "name": "name",
+                    "type": {
+                        "option": "string"
+                    }
                 }
             ]
         },
@@ -8602,7 +8612,7 @@
         {
             "code": 6038,
             "name": "UtilityNotActive",
-            "msg": "Utility is not active for this project \u2014 check subscription status"
+            "msg": "Utility is not active for this project — check subscription status"
         },
         {
             "code": 6039,
@@ -8636,56 +8646,66 @@
         },
         {
             "code": 6045,
+            "name": "PoolStillActive",
+            "msg": "Pool must be deactivated (is_active = false) before it can be closed"
+        },
+        {
+            "code": 6046,
+            "name": "PoolNameTooLong",
+            "msg": "Pool name exceeds MAX_POOL_NAME_LEN bytes"
+        },
+        {
+            "code": 6047,
             "name": "SecondaryRewardRetired",
             "msg": "Secondary reward is retired and cannot be modified"
         },
         {
-            "code": 6046,
+            "code": 6048,
             "name": "SecondaryRewardAlreadyRetired",
             "msg": "Secondary reward is already retired"
         },
         {
-            "code": 6047,
+            "code": 6049,
             "name": "SecondaryRewardMintImmutable",
-            "msg": "Secondary reward mint is immutable \u2014 retire and add a new slot instead"
+            "msg": "Secondary reward mint is immutable — retire and add a new slot instead"
         },
         {
-            "code": 6048,
+            "code": 6050,
             "name": "ClaimLockedUntilExpiry",
-            "msg": "Mid-lock claims are disabled for this tier \u2014 rewards are paid out at unstake"
+            "msg": "Mid-lock claims are disabled for this tier — rewards are paid out at unstake"
         },
         {
-            "code": 6049,
+            "code": 6051,
             "name": "StakerMismatch",
             "msg": "Caller is not the staker for this entry"
         },
         {
-            "code": 6050,
+            "code": 6052,
             "name": "LockTierConfigMissing",
             "msg": "Lock tier config missing - pool was reconfigured with active entries"
         },
         {
-            "code": 6051,
+            "code": 6053,
             "name": "NftAlreadyStaked",
             "msg": "NFT is already staked"
         },
         {
-            "code": 6052,
+            "code": 6054,
             "name": "UserBanned",
             "msg": "User profile is banned"
         },
         {
-            "code": 6053,
+            "code": 6055,
             "name": "UserProfileMismatch",
             "msg": "User profile does not match staker"
         },
         {
-            "code": 6054,
+            "code": 6056,
             "name": "InvalidQuantityBonus",
             "msg": "Invalid quantity bonus configuration"
         },
         {
-            "code": 6055,
+            "code": 6057,
             "name": "BaseStakingDisabled",
             "msg": "Unlocked/base staking is disabled for this pool"
         }
@@ -8758,7 +8778,7 @@
                     {
                         "name": "claim_only_at_end",
                         "docs": [
-                            "If true, mid-lock claims are blocked \u2014 rewards are only accessible at unstake.",
+                            "If true, mid-lock claims are blocked — rewards are only accessible at unstake.",
                             "Ensures the early-unstake penalty cannot be bypassed by claiming before unstaking."
                         ],
                         "type": "bool"
@@ -8854,7 +8874,7 @@
             "name": "PoolSecondaryRewards",
             "docs": [
                 "Separate PDA holding secondary reward configs for a pool.",
-                "Exists only when the pool has secondary rewards \u2014 zero migration needed."
+                "Exists only when the pool has secondary rewards — zero migration needed."
             ],
             "type": {
                 "kind": "struct",
@@ -8876,7 +8896,7 @@
                     {
                         "name": "is_initialized",
                         "docs": [
-                            "Explicit init sentinel \u2014 avoids ambiguous pool_id == 0 check for pool 0 (STAKE-H1)"
+                            "Explicit init sentinel — avoids ambiguous pool_id == 0 check for pool 0 (STAKE-H1)"
                         ],
                         "type": "bool"
                     },
@@ -8937,12 +8957,16 @@
                         "type": "i64"
                     },
                     {
-                        "name": "trait_bonus_mode",
+                        "name": "trait_bonus_enabled",
                         "docs": [
-                            "How trait bonuses are applied at claim time (None / FixedExtra / BaseMultiplier).",
-                            "Trait config is stored off-chain; only the mode is on-chain."
+                            "When `true`, the pool accepts a signed `trait_bonus_rate` from the",
+                            "configured trait authority on every claim. The signed `u64` is added",
+                            "directly to the staker's effective rate for the accrual window —",
+                            "projects compute per-trait math (including any per-NFT multipliers)",
+                            "off-chain and sign the final absolute extra rate. When `false`, any",
+                            "non-zero `trait_bonus_rate` is rejected on-chain."
                         ],
-                        "type": "u8"
+                        "type": "bool"
                     },
                     {
                         "name": "quantity_thresholds",
@@ -9025,7 +9049,7 @@
                     {
                         "name": "retired_at",
                         "docs": [
-                            "unix timestamp at which the slot was",
+                            "STAKE-FRESH-2026-05-11 (F-H3): unix timestamp at which the slot was",
                             "retired. `0` while active. Used by `accrue_secondary` /",
                             "`accrue_and_sub_secondary` to cap per-staker accrual at the moment of",
                             "retirement so the time window between a staker's last interaction and",
@@ -9068,7 +9092,7 @@
         {
             "name": "StakeEntry",
             "docs": [
-                "Per-NFT custody and lock tracking. No reward fields \u2014 rewards are",
+                "Per-NFT custody and lock tracking. No reward fields — rewards are",
                 "accumulated on the parent StakerAccount via `effective_rate`."
             ],
             "type": {
@@ -9131,7 +9155,7 @@
                     {
                         "name": "early_unstake_penalty_bps",
                         "docs": [
-                            "early-unstake penalty (bps) captured at",
+                            "STAKE2-M3 (audit 2026-05-05): early-unstake penalty (bps) captured at",
                             "stake time. Read at unstake instead of `pool.lock_configs[tier].early_unstake_penalty_bps`",
                             "so the authority cannot retroactively raise the penalty after the",
                             "staker has committed. Zero when the entry has no lock."
@@ -9144,7 +9168,7 @@
         {
             "name": "StakeEntrySecondarySynced",
             "docs": [
-                "emitted when a StakeEntry's",
+                "STAKE-FRESH-2026-05-11 (F-H4): emitted when a StakeEntry's",
                 "secondary_rate_contributions[index] is re-synced to the pool's current",
                 "config (e.g. after an admin added a new secondary slot post-stake)."
             ],
@@ -9241,6 +9265,14 @@
                         "name": "created_at",
                         "type": "i64"
                     },
+                    {
+                        "name": "name",
+                        "docs": [
+                            "Human-readable pool name. UTF-8, capped at `MAX_POOL_NAME_LEN`",
+                            "bytes (not characters). Empty string is allowed."
+                        ],
+                        "type": "string"
+                    },
                     {
                         "name": "trait_authority",
                         "docs": [
@@ -9309,7 +9341,7 @@
                     {
                         "name": "total_effective_rate",
                         "docs": [
-                            "aggregate of every active staker's",
+                            "STAKE-FRESH-2026-05-11 (F-H1): aggregate of every active staker's",
                             "`effective_rate`. Maintained at every stake/unstake/burn site.",
                             "Used by [`pool_settle`] to advance obligation for stakers who have",
                             "not yet visited the pool since `last_pool_accrual_ts`."
@@ -9319,7 +9351,7 @@
                     {
                         "name": "last_pool_accrual_ts",
                         "docs": [
-                            "unix timestamp at which the pool's",
+                            "STAKE-FRESH-2026-05-11 (F-H1): unix timestamp at which the pool's",
                             "total obligation was last advanced. Bumped by every handler that",
                             "touches the pool (via [`pool_settle`])."
                         ],

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 export { NftStakingClient, type FeeParams, type NftRewardAmount, type NftRewardSummary, type NftRewardSummaryOptions, } from "./client";
-export { NFT_STAKING_PROGRAM_ID, getStakeConfigPda, getStakePoolPda, getStakeEntryPda, getStakerAccountPda, getCollectionPda, getPoolAuthorityPda, getPoolSecondaryRewardsPda, getStakerSecondaryRewardsPda, StakingMode, NftStandard, RewardType, TraitBonusMode, } from "@soltracer/core";
+export { NFT_STAKING_PROGRAM_ID, getStakeConfigPda, getStakePoolPda, getStakeEntryPda, getStakerAccountPda, getCollectionPda, getPoolAuthorityPda, getPoolSecondaryRewardsPda, getStakerSecondaryRewardsPda, StakingMode, NftStandard, RewardType, } from "@soltracer/core";
 export { type NftStaking as NftStakingIDLType } from "./idl";
 export { default as NftStakingIDL } from "./idl.json";
 export * from "./errors";
 export * from "./helpers";
-export { buildTraitProofMessage, TRAIT_PROOF_MSG_LEN, aggregateTraitBonusRate, computeTraitBonusRate, prepareTraitProof, ownershipFromClient, type TraitBonusCatalogEntry, type NftTraitInput, type ComputeTraitBonusResult, type TraitBonusStore, type NftTraitResolver, type StakedOwnershipResolver, type PreparedTraitProof, } from "./traitProof";
+export { buildTraitProofMessage, TRAIT_PROOF_MSG_LEN, computeTraitBonusRate, prepareTraitProof, ownershipFromClient, InMemoryTraitBonusStore, type TraitBonusCatalogEntry, type NftTraitInput, type PerNftBonus, type TraitBonusComputation, type TraitBonusStore, type NftTraitResolver, type StakedOwnershipResolver, type PrepareTraitProofInput, type PrepareTraitProofResult, } from "./traitProof";
 export { GATE_TYPE_NONE, GATE_TYPE_WALLET, GATE_TYPE_TOKEN_MINT, type GateType, type MerkleTree, hashLeaf, hashPair, buildMerkleTree, getMerkleProof, proofToAnchorArg, rootToAnchorArg, } from "./merkle";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,WAAW,EACX,WAAW,EACX,UAAU,EACV,cAAc,GACf,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,KAAK,UAAU,IAAI,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAC5D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,YAAY,CAAA;AACrD,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,KAAK,UAAU,IAAI,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAC5D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,YAAY,CAAA;AACrD,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -1,8 +1,8 @@
 export { NftStakingClient, } from "./client";
-export { NFT_STAKING_PROGRAM_ID, getStakeConfigPda, getStakePoolPda, getStakeEntryPda, getStakerAccountPda, getCollectionPda, getPoolAuthorityPda, getPoolSecondaryRewardsPda, getStakerSecondaryRewardsPda, StakingMode, NftStandard, RewardType, TraitBonusMode, } from "@soltracer/core";
+export { NFT_STAKING_PROGRAM_ID, getStakeConfigPda, getStakePoolPda, getStakeEntryPda, getStakerAccountPda, getCollectionPda, getPoolAuthorityPda, getPoolSecondaryRewardsPda, getStakerSecondaryRewardsPda, StakingMode, NftStandard, RewardType, } from "@soltracer/core";
 export { default as NftStakingIDL } from "./idl.json";
 export * from "./errors";
 export * from "./helpers";
-export { buildTraitProofMessage, TRAIT_PROOF_MSG_LEN, aggregateTraitBonusRate, computeTraitBonusRate, prepareTraitProof, ownershipFromClient, } from "./traitProof";
+export { buildTraitProofMessage, TRAIT_PROOF_MSG_LEN, computeTraitBonusRate, prepareTraitProof, ownershipFromClient, InMemoryTraitBonusStore, } from "./traitProof";
 export { GATE_TYPE_NONE, GATE_TYPE_WALLET, GATE_TYPE_TOKEN_MINT, hashLeaf, hashPair, buildMerkleTree, getMerkleProof, proofToAnchorArg, rootToAnchorArg, } from "./merkle";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAKjB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,WAAW,EACX,WAAW,EACX,UAAU,EACV,cAAc,GACf,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,YAAY,CAAA;AACrD,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,GAQpB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EAGpB,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAKjB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,YAAY,CAAA;AACrD,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,GAUxB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EAGpB,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAA"}