@sly-rentals/core 4.0.0 → 5.1.0

package/dist/types/utils/clock.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @purpose Read the on-chain Clock sysvar to get `unix_timestamp`.
+ *
+ * Use this instead of `Date.now()` whenever the SDK quotes a value the
+ * on-chain program would compute against `Clock::get()` — wall-clock skew
+ * between the client and the cluster can otherwise produce a stale or
+ * future-dated answer (matters for `rate_after_stale_decay` and any time
+ * projection that crosses the `stale_since` sentinel).
+ *
+ * Layout (offsets, little-endian):
+ *   0   slot                   u64
+ *   8   epoch_start_timestamp  i64
+ *   16  epoch                  u64
+ *   24  leader_schedule_epoch  u64
+ *   32  unix_timestamp         i64   ← this is what callers want
+ */
+/**
+ * Fetch the cluster's `Clock::unix_timestamp` as a JS `number` (seconds).
+ *
+ * One RPC round-trip (`getAccountInfo` on the sysvar). Safe to call in
+ * parallel with other fetches.
+ */
+export declare function fetchChainNowSeconds(rpcUrl?: string): Promise<number>;
+//# sourceMappingURL=clock.d.ts.map

package/dist/types/utils/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../../src/utils/clock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW3E"}

package/dist/types/utils/contractSnapshot.d.ts

@@ -34,6 +34,17 @@ export type ContractSnapshot = {
      *  time-projected floors (`delaySeconds`, custom `nowSeconds`), call
      *  `computeMinimumBidFromSnapshot(snap, opts)` — no extra RPC needed. */
     minimumBid: MinimumBid;
+    /** Chain `Clock::unix_timestamp` at fetch time. Used as the default
+     *  evaluation moment for `effectiveRate` and any time-projected
+     *  derivations. Fetched from the Sysvar Clock account, not `Date.now()`. */
+    nowSeconds: number;
+    /** Rate `rental_accept` would write back if called at `nowSeconds` —
+     *  i.e. `contract.rate` with any pending stale-decay applied. Equals
+     *  `contract.rate` exactly when decay short-circuits (active rental,
+     *  `staleSince == 0`, `staleDiscountMaxBps == 0`, or protocol-wide
+     *  `staleDiscountPerDayBps == 0`). UIs quoting an accept-time cost
+     *  should use this rather than `contract.rate`. */
+    effectiveRate: bigint;
 };
 /**
  * Fetch a contract and every account directly attached to it in one shot,
@@ -91,8 +102,20 @@ export declare function resolveContractSnapshot(args: {
  * projection (`delaySeconds` / `nowSeconds`) or with an overridden
  * `atlasPerPoint` ratio. For the at-fetch-time floor, read
  * `snap.minimumBid` directly.
+ *
+ * Both `.atlas` and `.points` are on-chain-ready bid values — callers
+ * can feed them straight into `reserveRental(...)` without further
+ * conversion or threshold-clamping:
+ *
+ * - First-reservation contracts (`current === null`): both fields are
+ *   clamped up to `config.min_capture_threshold` (and its atlas
+ *   equivalent) so a bid built from either field clears the
+ *   `bid_threshold` check.
+ * - Contested contracts (`current !== null`): `.atlas` is the
+ *   rate-derived ramp floor only; `.points` additionally clamps to
+ *   `min_capture_threshold` (the ramp dominates atlas by design).
  */
-export declare function computeMinimumBidFromSnapshot(snap: Omit<ContractSnapshot, 'minimumBid'>, opts?: {
+export declare function computeMinimumBidFromSnapshot(snap: Omit<ContractSnapshot, 'minimumBid' | 'effectiveRate'>, opts?: {
     delaySeconds?: number;
     nowSeconds?: number;
     atlasPerPoint?: bigint;

package/dist/types/utils/contractSnapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contractSnapshot.d.ts","sourceRoot":"","sources":["../../../src/utils/contractSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAM5E,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAI/D,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IACxC;8EAC0E;IAC1E,YAAY,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACjD;8EAC0E;IAC1E,YAAY,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACjD;;6EAEyE;IACzE,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,eAAe,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8B5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,eAAe,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+B5B;AAUD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,EAC1C,IAAI,GAAE;IACJ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,GACL,UAAU,CAqEZ;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,eAAe,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC;oDACgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;+BAC2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;wDACoD;IACpD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,GAAG,OAAO,CAAC,UAAU,CAAC,CA2BtB"}
+{"version":3,"file":"contractSnapshot.d.ts","sourceRoot":"","sources":["../../../src/utils/contractSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAM5E,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAM/D,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IACxC;8EAC0E;IAC1E,YAAY,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACjD;8EAC0E;IAC1E,YAAY,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACjD;;6EAEyE;IACzE,UAAU,EAAE,UAAU,CAAC;IACvB;;gFAE4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;uDAKmD;IACnD,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,eAAe,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,eAAe,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+B5B;AAUD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,eAAe,CAAC,EAC5D,IAAI,GAAE;IACJ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,GACL,UAAU,CAkGZ;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,eAAe,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC;oDACgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;+BAC2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;wDACoD;IACpD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,GAAG,OAAO,CAAC,UAAU,CAAC,CA2BtB"}

package/dist/types/utils/index.d.ts

@@ -14,6 +14,8 @@ export { hasActiveRental, hasQueuedRental } from './rental';
 export { computeMinimumBid, type MinimumBid } from './bidMath';
 export { computeContestChain, stardustToDisplay, distributeEven, distributeSnipeHeavy, nextKnobId, type ContestChain, type ContestChainConfig, type ContestKnob, type ContestRow, type ContestSegment, type EventSource, type Cur, } from './contestChain';
 export { getContractSnapshot, resolveContractSnapshot, computeMinimumBidFromSnapshot, getMinimumBid, type ContractSnapshot, type FetchedAccount, } from './contractSnapshot';
+export { fetchChainNowSeconds } from './clock';
+export { rateAfterStaleDecay } from './staleDecay';
 export { createDiscount, deserializeDiscountAuth, type CreateDiscountParams, type SerializedDiscountAuth, type MessageSigner, } from './discountAuth';
 export { resolveReferrer, requireValidReferrer } from './referrer';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,GACrC,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAGtF,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGhF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAGlE,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG5D,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAG/D,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,GAAG,GACT,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,EAC7B,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,GACrC,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAGtF,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGhF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAGlE,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG5D,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAG/D,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,GAAG,GACT,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,EAC7B,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/utils/staleDecay.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @purpose TS mirror of `ContractState::rate_after_stale_decay` (rust).
+ *
+ * Computes the rate a future `rental_accept` would write back, given the
+ * contract + config state at a specific moment in chain time. Pure — no
+ * RPC, no `Date.now()`. Caller supplies `nowSeconds` from the Clock
+ * sysvar (`fetchChainNowSeconds`) or any other authoritative source.
+ *
+ * Returns `contract.rate` unchanged when any of the on-chain short-circuits
+ * fire: active rental present, `stale_since == 0` sentinel,
+ * `stale_discount_max_bps == 0` (per-contract opt-out), or
+ * `stale_discount_per_day_bps == 0` (protocol-wide opt-out).
+ */
+import type { ContractState } from '../generated/codama/accounts/contractState';
+import type { ConfigState } from '../generated/codama/accounts/configState';
+/**
+ * Mirrors `rust/programs/srsly/src/state/contract.rs::rate_after_stale_decay`
+ * byte-for-byte. Any change there must be reflected here.
+ */
+export declare function rateAfterStaleDecay(contract: ContractState, config: ConfigState, nowSeconds: number | bigint): bigint;
+//# sourceMappingURL=staleDecay.d.ts.map

package/dist/types/utils/staleDecay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleDecay.d.ts","sourceRoot":"","sources":["../../../src/utils/staleDecay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAM5E;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GAAG,MAAM,GAC1B,MAAM,CAwBR"}

package/dist/types/utils/staleDecay.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=staleDecay.test.d.ts.map

package/dist/types/utils/staleDecay.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleDecay.test.d.ts","sourceRoot":"","sources":["../../../src/utils/staleDecay.test.ts"],"names":[],"mappings":""}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.0.0";
+export declare const VERSION = "5.1.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sly-rentals/core",
-  "version": "4.0.0",
+  "version": "5.1.0",
   "description": "TypeScript SDK for SRSLY",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -100,7 +100,7 @@
     "@codama/renderers-js": "^1.4.2",
     "@solana/kit": "^2.1.1",
     "uplot": "^1.6.32",
-    "@sly-rentals/vault": "1.0.1"
+    "@sly-rentals/vault": "2.0.1"
   },
   "devDependencies": {
     "@types/node": "^24.0.3",
@@ -109,8 +109,7 @@
     "react": "^18.2.0",
     "tsconfig-to-dual-package": "^1.2.0",
     "typescript": "^5.9.2",
-    "vitest": "^3.2.4",
-    "@sly-rentals/programs": "0.1.0"
+    "vitest": "^3.2.4"
   },
   "peerDependencies": {
     "@solana/web3.js": "^1.95.0",