@wuwei-labs/srsly 2.0.0-beta.4 → 2.0.0-beta.41

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

@@ -0,0 +1,120 @@
+/**
+ * # PDA Derivation Utilities for Multi-Program Architecture
+ *
+ * The SRSLY rental system integrates with multiple Solana programs, each requiring
+ * PDAs to be derived using their specific program IDs for proper cross-program
+ * invocation (CPI) and account ownership.
+ *
+ * ## Program Responsibilities:
+ * - **SRSLY Program**: Contract, Rental State, Rental Authority PDAs
+ * - **Antegen Program**: Automated payment threads via Clockwork scheduling
+ * - **Profile Program**: Star Atlas SAGE profiles and starbase management
+ * - **Player Faction Program**: Player faction enrollment in SAGE ecosystem
+ *
+ * ## Cross-Program Integration:
+ * Each program owns its respective PDAs and must be used for derivation to
+ * ensure proper account ownership and enable CPI calls between programs.
+ *
+ * @note Future Enhancement: Consider requesting codama to auto-generate PDA
+ *       utilities alongside instruction code to reduce manual maintenance.
+ */
+import { type Address } from '@solana/kit';
+/**
+ * Derives the rental contract PDA using the SRSLY program ID
+ *
+ * Contract PDAs are derived from the fleet address and provide deterministic
+ * addresses for rental contracts without requiring a private key. The SDK
+ * automatically resolves the correct SRSLY program address for the current network
+ * unless a specific program ID is provided.
+ *
+ * @param fleet - The fleet address to create a contract for
+ * @param srslyProgramId - Optional SRSLY program ID (defaults to network-resolved address)
+ * @returns The contract PDA derived using SRSLY program ID
+ *
+ * @example
+ * ```typescript
+ * // Use network-resolved program address (recommended)
+ * const contractAddress = await deriveContract('FleetAddress123...');
+ *
+ * // Use specific program address
+ * const contractAddress = await deriveContract(
+ *   'FleetAddress123...',
+ *   'SRSLY1fq9TJqCk1gNSE7VZL2bztvTn9wm4VR8u8jMKT'
+ * );
+ * ```
+ */
+export declare function deriveContract(fleet: string | Address, srslyProgramId?: string | Address): Promise<Address>;
+/**
+ * Derives the rental thread PDA using the Antegen program ID
+ *
+ * Thread accounts are managed by the Antegen program, so they must be derived
+ * using the Antegen program ID rather than the SRSLY program ID. The SDK
+ * automatically resolves the correct Antegen program address for the current network
+ * unless a specific program ID is provided.
+ *
+ * @param rentalAuthority - The rental authority PDA (derived with SRSLY program)
+ * @param rentalState - The rental state PDA (derived with SRSLY program)
+ * @param antegenProgramId - Optional Antegen program ID (defaults to network-resolved address)
+ * @returns The rental thread PDA derived using Antegen program ID
+ *
+ * @example
+ * ```typescript
+ * // Use network-resolved program address (recommended)
+ * const threadPda = await deriveRentalThread(rentalAuthorityPda, rentalStatePda);
+ *
+ * // Use specific program address
+ * const threadPda = await deriveRentalThread(
+ *   rentalAuthorityPda,
+ *   rentalStatePda,
+ *   'AgThdyi1P5RkVeZD2rQahTvs8HePJoGFFxKtvok5s2J1'
+ * );
+ * ```
+ */
+export declare function deriveRentalThread(rentalAuthority: Address, rentalState: Address, antegenProgramId?: Address): Promise<Address>;
+/**
+ * Derives the rental state PDA using the SRSLY program ID
+ *
+ * The SDK automatically resolves the correct SRSLY program address for the current network
+ * unless a specific program ID is provided.
+ *
+ * @param contract - The rental contract address
+ * @param borrower - The borrower's public key
+ * @param srslyProgramId - Optional SRSLY program ID (defaults to network-resolved address)
+ * @returns The rental state PDA
+ *
+ * @example
+ * ```typescript
+ * // Use network-resolved program address (recommended)
+ * const rentalStateAddress = await deriveRentalState(contractAddress, borrowerAddress);
+ *
+ * // Use specific program address
+ * const rentalStateAddress = await deriveRentalState(
+ *   contractAddress,
+ *   borrowerAddress,
+ *   'SRSLY1fq9TJqCk1gNSE7VZL2bztvTn9wm4VR8u8jMKT'
+ * );
+ * ```
+ */
+export declare function deriveRentalState(contract: Address, borrower: Address, srslyProgramId?: Address): Promise<Address>;
+/**
+ * Derives the rental authority PDA using the SRSLY program ID
+ *
+ * The SDK automatically resolves the correct SRSLY program address for the current network
+ * unless a specific program ID is provided.
+ *
+ * @param srslyProgramId - Optional SRSLY program ID (defaults to network-resolved address)
+ * @returns The rental authority PDA
+ *
+ * @example
+ * ```typescript
+ * // Use network-resolved program address (recommended)
+ * const rentalAuthorityAddress = await deriveRentalAuthority();
+ *
+ * // Use specific program address
+ * const rentalAuthorityAddress = await deriveRentalAuthority(
+ *   'SRSLY1fq9TJqCk1gNSE7VZL2bztvTn9wm4VR8u8jMKT'
+ * );
+ * ```
+ */
+export declare function deriveRentalAuthority(srslyProgramId?: Address): Promise<Address>;
+//# sourceMappingURL=pda.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pda.d.ts","sourceRoot":"","sources":["../../../src/utils/pda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAyE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAGlH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,GAAG,OAAO,EACvB,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,GAChC,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,kBAAkB,CACtC,eAAe,EAAE,OAAO,EACxB,WAAW,EAAE,OAAO,EACpB,gBAAgB,CAAC,EAAE,OAAO,GACzB,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,OAAO,EACjB,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CACzC,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,OAAO,CAAC,CAalB"}

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

@@ -1,46 +1,52 @@
 import { Address } from '@solana/kit';
+import type { ConfigOptions } from './config';
 /**
  * Helper function to derive the borrower's profile faction account
  *
  * @param profile The borrower's profile address
+ * @param config Optional configuration for network-specific constants
  * @returns Promise that resolves to the derived profile faction address
  */
-export declare function deriveProfileFaction(profile: Address<string>): Promise<Address<string>>;
+export declare function deriveProfileFaction(profile: Address<string>, config?: ConfigOptions): Promise<Address<string>>;
 /**
  * Helper function to derive the sage player profile
  *
  * @param borrowerProfile The borrower's profile address
- * @param gameId The game ID (defaults to the standard game ID)
+ * @param gameId The game ID (if not provided, uses network-specific default)
+ * @param config Optional configuration for network-specific constants
  * @returns Promise that resolves to the derived sage player profile address
  */
-export declare function deriveSagePlayerProfile(borrowerProfile: Address<string>, gameId?: Address<string>): Promise<Address<string>>;
+export declare function deriveSagePlayerProfile(borrowerProfile: Address<string>, gameId?: Address<string>, config?: ConfigOptions): Promise<Address<string>>;
 /**
  * Helper function to derive the starbase address based on faction
  *
  * @param faction The faction (1/2/3 or 'mud'/'oni'/'ustur')
- * @param gameId The game ID (defaults to the standard game ID)
+ * @param gameId The game ID (if not provided, uses network-specific default)
+ * @param config Optional configuration for network-specific constants
  * @returns Promise that resolves to the derived starbase address
  */
-export declare function deriveStarbase(faction: number | string, gameId?: Address<string>): Promise<Address<string>>;
+export declare function deriveStarbase(faction: number | string, gameId?: Address<string>, config?: ConfigOptions): Promise<Address<string>>;
 /**
  * Helper function to derive the starbase player address
  *
  * @param sagePlayerProfile The sage player profile address
  * @param starbase The starbase address
  * @param starbaseSeqId The starbase sequence ID (defaults to 0)
+ * @param config Optional configuration for network-specific constants
  * @returns Promise that resolves to the derived starbase player address
  */
-export declare function deriveStarbasePlayer(sagePlayerProfile: Address<string>, starbase: Address<string>, starbaseSeqId?: number): Promise<Address<string>>;
+export declare function deriveStarbasePlayer(sagePlayerProfile: Address<string>, starbase: Address<string>, starbaseSeqId?: number, config?: ConfigOptions): Promise<Address<string>>;
 /**
  * Derives all three accounts needed: profileFaction, starbase, and starbasePlayer
  *
  * @param profile The borrower's profile address
  * @param faction The faction (1/2/3 or 'mud'/'oni'/'ustur')
- * @param gameId The game ID (defaults to the standard game ID)
+ * @param gameId The game ID (if not provided, uses network-specific default)
  * @param starbaseSeqId The starbase sequence ID (defaults to 0)
+ * @param config Optional configuration for network-specific constants
  * @returns Promise that resolves to the three derived addresses
  */
-export declare function deriveGameAccounts(profile: Address<string>, faction: number | string, gameId?: Address<string>, starbaseSeqId?: number): Promise<{
+export declare function deriveGameAccounts(profile: Address<string>, faction: number | string, gameId?: Address<string>, starbaseSeqId?: number, config?: ConfigOptions): Promise<{
     profileFaction: Address<string>;
     starbase: Address<string>;
     starbasePlayer: Address<string>;

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

@@ -1 +1 @@
-{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../src/utils/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAIR,MAAM,aAAa,CAAC;AAcrB;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GACvB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAS1B;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,EAChC,MAAM,GAAE,OAAO,CAAC,MAAM,CAAsC,GAC3D,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAU1B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,GAAE,OAAO,CAAC,MAAM,CAAsC,GAC3D,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAmC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,EAClC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,EACzB,aAAa,GAAE,MAAU,GACxB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAgB1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EACxB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,GAAE,OAAO,CAAC,MAAM,CAAsC,EAC5D,aAAa,GAAE,MAAU,GACxB,OAAO,CAAC;IACT,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC,CAAC,CAwBD"}
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../src/utils/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAIR,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAa9C;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EACxB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAW1B;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,EAChC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EACxB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAe1B;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EACxB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAyC1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,EAClC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,EACzB,aAAa,GAAE,MAAU,EACzB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAmB1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EACxB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EACxB,aAAa,GAAE,MAAU,EACzB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC;IACT,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC,CAAC,CA4BD"}

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

@@ -0,0 +1,6 @@
+/**
+ * Universal types that work with both @solana/kit and @solana/web3.js
+ */
+export type UniversalAddress = string | any;
+export type UniversalInstruction = any;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,GAAG,CAAC;AAG5C,MAAM,MAAM,oBAAoB,GAAG,GAAG,CAAC"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@wuwei-labs/srsly",
-  "version": "2.0.0-beta.4",
+  "version": "2.0.0-beta.41",
   "description": "",
   "main": "./dist/cjs/index.js",
   "types": "./dist/types/index.d.ts",
   "module": "./dist/esm/index.js",
   "source": "./src/index.ts",
+  "sideEffects": false,
   "publishConfig": {
     "access": "public"
   },
@@ -13,22 +14,30 @@
     "dist/cjs",
     "dist/esm",
     "dist/types",
-    "target/idl/srsly-mainnet.json",
-    "target/idl/srsly-devnet.json",
-    "target/types/srsly-mainnet.ts",
-    "target/types/srsly-devnet.ts"
+    "target/idl/srsly.json",
+    "target/types/srsly.ts"
   ],
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",
       "require": "./dist/cjs/index.js",
       "import": "./dist/esm/index.js",
-      "default": "./dist/esm/index.js"
+      "default": "./dist/cjs/index.js"
     },
-    "./idl/mainnet": "./target/idl/srsly-mainnet.json",
-    "./idl/devnet": "./target/idl/srsly-devnet.json",
-    "./types/mainnet": "./target/types/srsly-mainnet.ts",
-    "./types/devnet": "./target/types/srsly-devnet.ts"
+    "./codama": {
+      "types": "./dist/types/codama/index.d.ts",
+      "require": "./dist/cjs/codama/index.js",
+      "import": "./dist/esm/codama/index.js",
+      "default": "./dist/cjs/codama/index.js"
+    },
+    "./codama/*": {
+      "types": "./dist/types/codama/*",
+      "require": "./dist/cjs/codama/*",
+      "import": "./dist/esm/codama/*",
+      "default": "./dist/cjs/codama/*"
+    },
+    "./idl": "./target/idl/srsly.json",
+    "./types": "./target/types/srsly.ts"
   },
   "keywords": [
     "SRSLY",
@@ -37,34 +46,32 @@
     "sdk"
   ],
   "scripts": {
-    "package": "pnpm run clean && pnpm build && pnpm run package:cjs && pnpm run package:esm",
-    "package:cjs": "tsc -p tsconfig.cjs.json",
-    "package:esm": "tsc -p tsconfig.esm.json",
+    "build": "anchor run build && pnpm run package:cjs && pnpm run package:esm && pnpm run generate",
+    "build:clean": "pnpm run clean && pnpm run build",
+    "package:cjs": "tsc -p tsconfig.cjs.json && tsconfig-to-dual-package tsconfig.cjs.json",
+    "package:esm": "tsc -p tsconfig.esm.json && tsconfig-to-dual-package tsconfig.esm.json",
     "clean": "rm -rf dist && cargo clean && pnpm install",
     "generate": "node generate.mjs",
-    "build": "pnpm build:mainnet && pnpm build:devnet",
-    "build:mainnet": "anchor build -- --features mainnet && NETWORK=mainnet pnpm run generate",
-    "build:devnet": "NETWORK=devnet anchor build && pnpm run generate",
     "docs": "typedoc",
-    "test": "vitest",
-    "test:manual": "node tests/test-complete-idl.js && node tests/test-cjs.js",
-    "test:cjs": "node tests/test-cjs.js",
-    "test:idl": "node tests/test-idl-types.js"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "author": "",
   "license": "ISC",
   "packageManager": "pnpm@10.6.5",
+  "dependencies": {
+    "@solana/kit": "^2.1.1"
+  },
   "devDependencies": {
     "@codama/nodes-from-anchor": "^1.1.13",
     "@codama/renderers": "^1.0.21",
-    "@types/bn.js": "^5.1.6",
+    "@types/node": "^24.0.3",
     "codama": "^1.2.13",
-    "ts-node": "^10.9.2",
+    "tsconfig-to-dual-package": "^1.2.0",
     "typedoc": "^0.28.3",
     "typescript": "^5.8.3",
-    "vitest": "^3.1.2"
-  },
-  "dependencies": {
-    "@solana/kit": "^2.1.0"
+    "vitest": "^3.2.4",
+    "webpack": "^5.99.9"
   }
-}
+}