@wuwei-labs/srsly 3.0.0-beta.2 → 3.0.0-beta.21

package/dist/esm/utils/discountAuth.js

@@ -0,0 +1,151 @@
+/**
+ * @purpose Discount authorization helper for server-side signing
+ * @module utils/discountAuth
+ */
+import { address, createKeyPairSignerFromBytes } from '@solana/kit';
+import { createDiscountAuth as slyvaultCreateDiscountAuth, fetchMember } from '@wuwei-labs/slyvault';
+import { getRpcUrl, mergeConfig } from './config';
+import { createRpc } from './rpc';
+/**
+ * Parse a stringified keypair (JSON array of bytes) into a KeyPairSigner
+ */
+async function parseKeypairString(keypairString) {
+    try {
+        const bytes = JSON.parse(keypairString);
+        if (!Array.isArray(bytes) || bytes.length !== 64) {
+            throw new Error('Invalid keypair: expected array of 64 bytes');
+        }
+        return await createKeyPairSignerFromBytes(new Uint8Array(bytes));
+    }
+    catch (e) {
+        throw new Error(`Failed to parse keypair string: ${e.message}`);
+    }
+}
+/**
+ * Browser-compatible base64 encoding (Uint8Array -> string)
+ */
+function uint8ArrayToBase64(bytes) {
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+/**
+ * Browser-compatible base64 decoding (string -> Uint8Array)
+ */
+function base64ToUint8Array(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+/**
+ * Create a signed discount authorization
+ *
+ * Server-side helper that fetches the member to get the nonce,
+ * then creates a signed discount authorization in a JSON-serializable format.
+ *
+ * @param params - Discount parameters including member address
+ * @param config - Optional SDK configuration overrides
+ * @returns A SerializedDiscountAuth object ready for API transport
+ *
+ * @example
+ * ```typescript
+ * import { createDiscount } from '@wuwei-labs/srsly';
+ *
+ * const discountAuth = await createDiscount({
+ *   address: 'AFFILIATE_MEMBER_PDA',
+ *   discount: 10, // 10%
+ *   expirySlots: 1000, // ~6-7 minutes
+ *   discountAuthority: serverKeypair,
+ * });
+ *
+ * // Ready to return via API - no serialization needed
+ * return discountAuth;
+ * ```
+ */
+export async function createDiscount(params, config) {
+    const finalConfig = mergeConfig(config);
+    const rpcUrl = getRpcUrl(finalConfig);
+    // Fetch member to get nonce
+    const memberAddr = address(params.address);
+    const member = await fetchMember(memberAddr, rpcUrl);
+    // Fetch current slot and compute absolute expiry
+    const rpc = createRpc(rpcUrl);
+    const currentSlot = await rpc.getSlot({ commitment: 'confirmed' }).send();
+    const expirySlot = currentSlot + BigInt(params.expirySlots);
+    // Convert discountAuthority to KeyPairSigner
+    let discountAuthority;
+    if (typeof params.discountAuthority === 'string') {
+        discountAuthority = await parseKeypairString(params.discountAuthority);
+    }
+    else if (params.discountAuthority instanceof Uint8Array) {
+        discountAuthority = await createKeyPairSignerFromBytes(params.discountAuthority);
+    }
+    else if (Array.isArray(params.discountAuthority)) {
+        discountAuthority = await createKeyPairSignerFromBytes(new Uint8Array(params.discountAuthority));
+    }
+    else if ('secretKey' in params.discountAuthority && params.discountAuthority.secretKey instanceof Uint8Array) {
+        // web3.js Keypair
+        discountAuthority = await createKeyPairSignerFromBytes(params.discountAuthority.secretKey);
+    }
+    else {
+        // Already a KeyPairSigner
+        discountAuthority = params.discountAuthority;
+    }
+    // Create the raw discount auth
+    const raw = await slyvaultCreateDiscountAuth({
+        memberNonce: member.data.nonce,
+        discount: params.discount,
+        expirySlot,
+        discountAuthority,
+    });
+    // Return serialized format for API transport
+    return serializeDiscountAuth(raw);
+}
+/**
+ * Deserialize a discount authorization from API format
+ *
+ * Converts the JSON-safe SerializedDiscountAuth back to the format
+ * expected by the on-chain program.
+ *
+ * @internal Used by acceptRental and claimRental
+ */
+export function deserializeDiscountAuth(serialized) {
+    return {
+        memberNonce: serialized.memberNonce,
+        discountBps: serialized.discountBps,
+        expirySlot: BigInt(serialized.expirySlot),
+        signature: base64ToUint8Array(serialized.signature),
+    };
+}
+/**
+ * Serialize a raw discount authorization to JSON-safe format
+ *
+ * Converts bigint expirySlot and Uint8Array signature to string representations
+ * suitable for API transport (JSON.stringify/JSON.parse safe).
+ *
+ * @param raw - Raw discount authorization with bigint/Uint8Array fields
+ * @returns SerializedDiscountAuth ready for JSON transport
+ */
+export function serializeDiscountAuth(raw) {
+    return {
+        memberNonce: raw.memberNonce,
+        discountBps: raw.discountBps,
+        expirySlot: raw.expirySlot.toString(),
+        signature: uint8ArrayToBase64(new Uint8Array(raw.signature)),
+    };
+}
+/**
+ * Check if a value is a SerializedDiscountAuth
+ */
+export function isSerializedDiscountAuth(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'signature' in value &&
+        typeof value.signature === 'string');
+}
+//# sourceMappingURL=discountAuth.js.map

package/dist/esm/utils/discountAuth.js.map

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

package/dist/esm/utils/index.js

@@ -3,7 +3,7 @@
  * @module utils
  */
 // Configuration
-export { setSdkConfig, getSdkConfig, clearSdkConfig, mergeConfig, getAddresses } from './config';
+export { setSdkConfig, getSdkConfig, clearSdkConfig, mergeConfig, getAddresses, getAffiliateConfig, getRpcUrl } from './config';
 // Network Addresses
 export { getProgramAddresses, getNetworkAddresses, isValidProgramSet, isValidNetwork, MAINNET_ADDRESSES, ATLASNET_ADDRESSES } from './addresses';
 // Signer Utilities
@@ -12,4 +12,14 @@ export { toTransactionSigner, validateAddress, isWeb3jsSigner, isKitSigner, isAd
 export { toWeb3Instruction, toAddress } from './web3js';
 // Instruction Utilities
 export { prepareInstructions } from './instructions';
+// Instruction Result
+export { InstructionResult } from './instructionResult';
+// RPC Utilities
+export { createRpc, setRpcDebug, isRpcDebugEnabled } from './rpc';
+// Address Lookup Table Utilities
+export { fetchLookupTable, getLookupTableAddress } from './lookupTable';
+// Rental Utilities
+export { findBorrowerRentalSlot, requireBorrowerRentalSlot, findExistingRentalSlot, requireExistingRentalSlot } from './rental';
+// Discount Authorization Utilities
+export { createDiscount, serializeDiscountAuth, deserializeDiscountAuth, isSerializedDiscountAuth } from './discountAuth';
 //# sourceMappingURL=index.js.map

package/dist/esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EAGb,MAAM,UAAU,CAAC;AAElB,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAInB,MAAM,aAAa,CAAC;AAErB,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EAEhB,MAAM,UAAU,CAAC;AAElB,wBAAwB;AACxB,OAAO,EACL,iBAAiB,EACjB,SAAS,EAIV,MAAM,UAAU,CAAC;AAElB,wBAAwB;AACxB,OAAO,EACL,mBAAmB,EAEpB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,SAAS,EAIV,MAAM,UAAU,CAAC;AAElB,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAInB,MAAM,aAAa,CAAC;AAErB,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EAEhB,MAAM,UAAU,CAAC;AAElB,wBAAwB;AACxB,OAAO,EACL,iBAAiB,EACjB,SAAS,EAIV,MAAM,UAAU,CAAC;AAElB,wBAAwB;AACxB,OAAO,EACL,mBAAmB,EAEpB,MAAM,gBAAgB,CAAC;AAExB,qBAAqB;AACrB,OAAO,EACL,iBAAiB,EAElB,MAAM,qBAAqB,CAAC;AAE7B,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAElE,iCAAiC;AACjC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EAEtB,MAAM,eAAe,CAAC;AAEvB,mBAAmB;AACnB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EAE1B,MAAM,UAAU,CAAC;AAElB,mCAAmC;AACnC,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EAKzB,MAAM,gBAAgB,CAAC"}

package/dist/esm/utils/instructionResult.js

@@ -0,0 +1,72 @@
+/**
+ * @purpose InstructionResult - Array-like wrapper for @solana/kit Instructions with legacy conversion
+ *
+ * Provides native @solana/kit Instruction[] compatibility with optional .toLegacy() conversion
+ * for web3.js users.
+ */
+import { getSdkConfig } from './config';
+/**
+ * Convert a single @solana/kit Instruction to legacy web3.js format
+ */
+function convertToLegacy(instruction, PublicKey) {
+    const accounts = instruction.accounts || [];
+    const data = instruction.data || new Uint8Array();
+    return {
+        keys: accounts.map(account => ({
+            pubkey: new PublicKey(String(account.address)),
+            isWritable: (account.role & 1) === 1, // Check writable bit
+            isSigner: (account.role & 2) === 2 // Check signer bit
+        })),
+        programId: new PublicKey(String(instruction.programAddress)),
+        data
+    };
+}
+/**
+ * InstructionResult - Wrapper for @solana/kit Instructions with legacy conversion
+ *
+ * Contains a plain Instruction[] array accessible via `.instructions`.
+ * Supports iteration (`for...of`, spread) and `.toLegacy()` conversion for web3.js.
+ *
+ * @example
+ * ```typescript
+ * // Kit users - access instructions directly
+ * const result = await createContract(params);
+ * for (const ix of result) { ... }
+ * // Or unwrap: result.instructions
+ *
+ * // Web3.js users - convert to legacy format
+ * import { PublicKey } from '@solana/web3.js';
+ * const legacyIxs = result.toLegacy(PublicKey);
+ * // Or if PublicKey is configured in SDK:
+ * setSdkConfig({ PublicKey });
+ * const legacyIxs = result.toLegacy();
+ * ```
+ */
+export class InstructionResult {
+    instructions;
+    constructor(instructions) {
+        this.instructions = instructions;
+    }
+    /**
+     * Convert to legacy web3.js instruction format
+     *
+     * @param PublicKey - Optional PublicKey constructor. If not provided,
+     *                    uses the PublicKey from SDK config (set via setSdkConfig)
+     * @returns Array of instructions in web3.js format
+     * @throws Error if no PublicKey is available
+     */
+    toLegacy(PublicKey) {
+        const pk = PublicKey || getSdkConfig().PublicKey;
+        if (!pk) {
+            throw new Error('PublicKey constructor required - pass it to toLegacy() or set in SDK config via setSdkConfig({ PublicKey })');
+        }
+        return this.instructions.map(ix => convertToLegacy(ix, pk));
+    }
+    get length() {
+        return this.instructions.length;
+    }
+    [Symbol.iterator]() {
+        return this.instructions[Symbol.iterator]();
+    }
+}
+//# sourceMappingURL=instructionResult.js.map

package/dist/esm/utils/instructionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructionResult.js","sourceRoot":"","sources":["../../../src/utils/instructionResult.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAA6B,MAAM,UAAU,CAAC;AAenE;;GAEG;AACH,SAAS,eAAe,CACtB,WAAwB,EACxB,SAA2C;IAE3C,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,IAAI,IAAI,UAAU,EAAE,CAAC;IAElD,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7B,MAAM,EAAE,IAAI,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC9C,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,qBAAqB;YAC3D,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,mBAAmB;SACvD,CAAC,CAAC;QACH,SAAS,EAAE,IAAI,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QAC5D,IAAI;KACL,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,iBAAiB;IACnB,YAAY,CAAgB;IAErC,YAAY,YAA2B;QACrC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CACN,SAA4C;QAE5C,MAAM,EAAE,GAAG,SAAS,IAAI,YAAY,EAAE,CAAC,SAAS,CAAC;QACjD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CACb,6GAA6G,CAC9G,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC9C,CAAC;CACF"}

package/dist/esm/utils/instructions.js

@@ -1,8 +1,8 @@
 /**
- * Shared utilities for preparing instructions with compute budget and web3.js conversion
+ * Shared utilities for preparing instructions with compute budget
  * @module utils/instructions
  */
-import { toWeb3Instruction } from './web3js';
+import { InstructionResult } from './instructionResult';
 /**
  * Compute Budget Program ID
  */
@@ -15,7 +15,7 @@ const SET_COMPUTE_UNIT_LIMIT_DISCRIMINATOR = 0x02;
  * Create a SetComputeUnitLimit instruction manually
  *
  * @param units - Compute units to allocate
- * @returns Kit instruction for setting compute unit limit
+ * @returns Instruction for setting compute unit limit
  */
 function createComputeBudgetInstruction(units) {
     // Encode u32 in little-endian format
@@ -36,26 +36,25 @@ function createComputeBudgetInstruction(units) {
  * This utility handles the common workflow of:
  * 1. Normalizing single instruction to array
  * 2. Optionally prepending compute budget instruction
- * 3. Optionally converting to web3.js format
+ * 3. Returning an InstructionResult that can be used directly with @solana/kit
+ *    or converted to web3.js format via .toLegacy()
  *
  * @param instructions - Single instruction or array of instructions
- * @param options - Optional configuration for compute budget and web3.js conversion
- * @returns Prepared instruction array (Kit or web3.js format)
+ * @param options - Optional configuration for compute budget
+ * @returns InstructionResult (extends Instruction[], has .toLegacy() method)
  *
  * @example
  * ```typescript
- * // Just return kit instructions as array
+ * // Kit users - use result directly as Instruction[]
  * const ixs = prepareInstructions(acceptRentalIx);
+ * // ixs works with appendTransactionMessageInstruction()
  *
  * // Add compute budget
  * const ixs = prepareInstructions(acceptRentalIx, { computeUnits: 400_000 });
  *
- * // Convert to web3.js
+ * // Web3.js users - call .toLegacy()
  * import { PublicKey } from '@solana/web3.js';
- * const ixs = prepareInstructions(acceptRentalIx, { PublicKey });
- *
- * // Both compute budget and web3.js conversion
- * const ixs = prepareInstructions(acceptRentalIx, { computeUnits: 400_000, PublicKey });
+ * const legacyIxs = prepareInstructions(acceptRentalIx).toLegacy(PublicKey);
  * ```
  */
 export function prepareInstructions(instructions, options) {
@@ -67,10 +66,6 @@ export function prepareInstructions(instructions, options) {
         const computeBudgetIx = createComputeBudgetInstruction(options.computeUnits);
         finalIxs = [computeBudgetIx, ...ixArray];
     }
-    // Optionally convert to web3.js format
-    if (options?.PublicKey) {
-        return finalIxs.map(ix => toWeb3Instruction(ix, options.PublicKey));
-    }
-    return finalIxs;
+    return new InstructionResult(finalIxs);
 }
 //# sourceMappingURL=instructions.js.map

package/dist/esm/utils/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../src/utils/instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAA2E,MAAM,UAAU,CAAC;AAGtH;;GAEG;AACH,MAAM,sBAAsB,GAAG,6CAA6C,CAAC;AAE7E;;GAEG;AACH,MAAM,oCAAoC,GAAG,IAAI,CAAC;AAElD;;;;;GAKG;AACH,SAAS,8BAA8B,CAAC,KAAa;IACnD,qCAAqC;IACrC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,CAAC,GAAG,oCAAoC,CAAC;IAC/C,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAE/B,OAAO;QACL,cAAc,EAAE,sBAAsB;QACtC,IAAI;KACL,CAAC;AACJ,CAAC;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAA+C,EAC/C,OAAgD;IAEhD,qBAAqB;IACrB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAE5E,gDAAgD;IAChD,IAAI,QAAQ,GAAqB,OAAO,CAAC;IACzC,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;QAC1B,MAAM,eAAe,GAAG,8BAA8B,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7E,QAAQ,GAAG,CAAC,eAAe,EAAE,GAAG,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../src/utils/instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;GAEG;AACH,MAAM,sBAAsB,GAAG,6CAAwD,CAAC;AAExF;;GAEG;AACH,MAAM,oCAAoC,GAAG,IAAI,CAAC;AAElD;;;;;GAKG;AACH,SAAS,8BAA8B,CAAC,KAAa;IACnD,qCAAqC;IACrC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,CAAC,GAAG,oCAAoC,CAAC;IAC/C,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAE/B,OAAO;QACL,cAAc,EAAE,sBAAsB;QACtC,IAAI;KACL,CAAC;AACJ,CAAC;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAAyC,EACzC,OAAoC;IAEpC,qBAAqB;IACrB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAE5E,gDAAgD;IAChD,IAAI,QAAQ,GAAkB,OAAO,CAAC;IACtC,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;QAC1B,MAAM,eAAe,GAAG,8BAA8B,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7E,QAAQ,GAAG,CAAC,eAAe,EAAE,GAAG,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC"}

package/dist/esm/utils/lookupTable.js

@@ -0,0 +1,139 @@
+/**
+ * @purpose Address Lookup Table utilities for SRSLY
+ *
+ * Provides helpers for fetching and using the SRSLY Address Lookup Table
+ * to reduce transaction size for rental operations.
+ */
+import { fetchConfig } from '../accounts/config';
+import { createRpc } from './rpc';
+import { getRpcUrl } from './config';
+/**
+ * System program address used as default when ALT not configured
+ */
+const SYSTEM_PROGRAM_ID = '11111111111111111111111111111111';
+/**
+ * Fetch the SRSLY Address Lookup Table from chain
+ *
+ * The ALT contains static addresses used across all rental operations,
+ * reducing transaction size by ~310 bytes when used with versioned transactions.
+ *
+ * @param rpcUrl - Optional RPC endpoint URL. If not provided, uses RPC from global config
+ * @returns ALT data with addresses, or null if ALT not configured
+ * @throws Error if fetch fails
+ *
+ * @example
+ * ```typescript
+ * // Fetch ALT using global config RPC
+ * const alt = await fetchLookupTable();
+ * if (alt) {
+ *   console.log('ALT address:', alt.address);
+ *   console.log('Contains', alt.addresses.length, 'addresses');
+ * }
+ * ```
+ */
+export async function fetchLookupTable(rpcUrl) {
+    try {
+        // Fetch config to get ALT address
+        const config = await fetchConfig(rpcUrl);
+        const altAddress = config.data.lookupTable;
+        // Return null if ALT not configured (default pubkey)
+        if (altAddress === SYSTEM_PROGRAM_ID) {
+            return null;
+        }
+        // Fetch ALT account data
+        const resolvedRpcUrl = rpcUrl || getRpcUrl();
+        const rpc = createRpc(resolvedRpcUrl);
+        const accountInfo = await rpc
+            .getAccountInfo(altAddress, { encoding: 'base64' })
+            .send();
+        if (!accountInfo.value) {
+            return null;
+        }
+        // Decode ALT data
+        // ALT format: https://docs.solanalabs.com/implemented-proposals/address-lookup-table
+        // Header: 56 bytes (discriminator, deactivation_slot, last_extended_slot, etc.)
+        // Addresses: remaining bytes, 32 bytes each
+        const data = base64ToUint8Array(accountInfo.value.data[0]);
+        // Skip 56-byte header to get to addresses
+        const HEADER_SIZE = 56;
+        const ADDRESS_SIZE = 32;
+        const addresses = [];
+        for (let i = HEADER_SIZE; i < data.length; i += ADDRESS_SIZE) {
+            const addressBytes = data.subarray(i, i + ADDRESS_SIZE);
+            // Convert to base58 address string
+            addresses.push(bs58Encode(addressBytes));
+        }
+        return {
+            address: altAddress,
+            addresses,
+            isActive: addresses.length > 0
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch lookup table: ${error.message}`);
+    }
+}
+/**
+ * Get the ALT address from config without fetching full ALT data
+ *
+ * @param rpcUrl - Optional RPC endpoint URL
+ * @returns ALT address, or null if not configured
+ */
+export async function getLookupTableAddress(rpcUrl) {
+    const config = await fetchConfig(rpcUrl);
+    const altAddress = config.data.lookupTable;
+    if (altAddress === SYSTEM_PROGRAM_ID) {
+        return null;
+    }
+    return altAddress;
+}
+/**
+ * Browser-compatible base64 to Uint8Array decoder
+ * Uses atob which is available in browsers and Node.js 16+
+ */
+function base64ToUint8Array(base64) {
+    const binaryString = atob(base64);
+    const bytes = new Uint8Array(binaryString.length);
+    for (let i = 0; i < binaryString.length; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+    }
+    return bytes;
+}
+/**
+ * Simple base58 encoder for address bytes
+ * Using a minimal implementation to avoid additional dependencies
+ */
+function bs58Encode(bytes) {
+    const ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+    const BASE = 58;
+    if (bytes.length === 0)
+        return '';
+    // Count leading zeros
+    let zeros = 0;
+    while (zeros < bytes.length && bytes[zeros] === 0) {
+        zeros++;
+    }
+    // Convert to base58
+    const input = Array.from(bytes);
+    const encoded = [];
+    for (const byte of input) {
+        let carry = byte;
+        for (let i = 0; i < encoded.length; i++) {
+            carry += encoded[i] << 8;
+            encoded[i] = carry % BASE;
+            carry = Math.floor(carry / BASE);
+        }
+        while (carry > 0) {
+            encoded.push(carry % BASE);
+            carry = Math.floor(carry / BASE);
+        }
+    }
+    // Add leading zeros
+    let result = ALPHABET[0].repeat(zeros);
+    // Convert to string (encoded is in reverse order)
+    for (let i = encoded.length - 1; i >= 0; i--) {
+        result += ALPHABET[encoded[i]];
+    }
+    return result;
+}
+//# sourceMappingURL=lookupTable.js.map

package/dist/esm/utils/lookupTable.js.map

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

package/dist/esm/utils/rental.js

@@ -0,0 +1,129 @@
+/**
+ * Rental utility functions
+ * @module utils/rental
+ */
+import { fetchRentalState } from '../generated/codama/accounts';
+import { deriveRental } from '../pda/srsly';
+import { createRpc } from './rpc';
+// System program ID constant
+const SYSTEM_PROGRAM_ID = '11111111111111111111111111111111';
+/**
+ * Find which slot has an existing rental from contract data.
+ *
+ * Uses the contract's rentalSlot0/rentalSlot1 fields to determine which slot has a rental.
+ * If both slots have rentals, returns the active slot.
+ * If only one slot has a rental, returns that slot.
+ *
+ * @param contractData - Object with rentalSlot0, rentalSlot1, and activeSlot fields
+ * @returns The slot number (0 or 1) if found, undefined if no rentals exist
+ *
+ * @example
+ * ```typescript
+ * const contract = await fetchContract(contractAddress, rpcUrl);
+ * const slot = findExistingRentalSlot(contract.data);
+ * if (slot !== undefined) {
+ *   console.log(`Found rental at slot ${slot}`);
+ * }
+ * ```
+ */
+export function findExistingRentalSlot(contractData) {
+    const slot0HasRental = contractData.rentalSlot0 !== SYSTEM_PROGRAM_ID;
+    const slot1HasRental = contractData.rentalSlot1 !== SYSTEM_PROGRAM_ID;
+    if (slot0HasRental && slot1HasRental) {
+        // Both slots have rentals, return the active one
+        return contractData.activeSlot;
+    }
+    else if (slot0HasRental) {
+        return 0;
+    }
+    else if (slot1HasRental) {
+        return 1;
+    }
+    return undefined;
+}
+/**
+ * Find which slot has an existing rental, throwing if none found.
+ *
+ * @param contractData - Object with rentalSlot0, rentalSlot1, and activeSlot fields
+ * @returns The slot number (0 or 1)
+ * @throws Error if no rental exists on this contract
+ */
+export function requireExistingRentalSlot(contractData) {
+    const slot = findExistingRentalSlot(contractData);
+    if (slot === undefined) {
+        throw new Error('No rental exists on this contract');
+    }
+    return slot;
+}
+/**
+ * Find which rental slot belongs to a borrower on a contract.
+ *
+ * Checks both slot 0 and slot 1 to find the rental that belongs to the borrower.
+ * Useful for operations like cancel where the borrower can only act on their own rental.
+ *
+ * @param contract - The contract address
+ * @param borrower - The borrower address to search for
+ * @param rpcUrl - RPC URL to use for fetching rental states
+ * @returns The slot number (0 or 1) if found, undefined if no rental exists for this borrower
+ *
+ * @example
+ * ```typescript
+ * const slot = await findBorrowerRentalSlot(contractAddress, borrowerAddress, rpcUrl);
+ * if (slot !== undefined) {
+ *   console.log(`Borrower has rental at slot ${slot}`);
+ * }
+ * ```
+ */
+export async function findBorrowerRentalSlot(contract, borrower, rpcUrl) {
+    const rpc = createRpc(rpcUrl);
+    // Address type is a branded string, so we can compare directly
+    const borrowerStr = typeof borrower === 'string' ? borrower : borrower;
+    // Try slot 0 first
+    try {
+        const rental0 = await deriveRental(contract, 0);
+        const rentalState0 = await fetchRentalState(rpc, rental0);
+        if (rentalState0.data.borrower === borrowerStr) {
+            return 0;
+        }
+    }
+    catch {
+        // slot 0 doesn't exist or fetch failed
+    }
+    // Try slot 1
+    try {
+        const rental1 = await deriveRental(contract, 1);
+        const rentalState1 = await fetchRentalState(rpc, rental1);
+        if (rentalState1.data.borrower === borrowerStr) {
+            return 1;
+        }
+    }
+    catch {
+        // slot 1 doesn't exist or fetch failed
+    }
+    return undefined;
+}
+/**
+ * Find which rental slot belongs to a borrower, throwing if not found.
+ *
+ * Same as findBorrowerRentalSlot but throws an error if no rental is found.
+ *
+ * @param contract - The contract address
+ * @param borrower - The borrower address to search for
+ * @param rpcUrl - RPC URL to use for fetching rental states
+ * @returns The slot number (0 or 1)
+ * @throws Error if no rental is found for this borrower
+ *
+ * @example
+ * ```typescript
+ * const slot = await requireBorrowerRentalSlot(contractAddress, borrowerAddress, rpcUrl);
+ * // Will throw if borrower has no rental on this contract
+ * ```
+ */
+export async function requireBorrowerRentalSlot(contract, borrower, rpcUrl) {
+    const slot = await findBorrowerRentalSlot(contract, borrower, rpcUrl);
+    if (slot === undefined) {
+        throw new Error('No active rental found for this borrower on this contract');
+    }
+    return slot;
+}
+//# sourceMappingURL=rental.js.map

package/dist/esm/utils/rental.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rental.js","sourceRoot":"","sources":["../../../src/utils/rental.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,6BAA6B;AAC7B,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAW7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAA8B;IACnE,MAAM,cAAc,GAAG,YAAY,CAAC,WAAW,KAAK,iBAAiB,CAAC;IACtE,MAAM,cAAc,GAAG,YAAY,CAAC,WAAW,KAAK,iBAAiB,CAAC;IAEtE,IAAI,cAAc,IAAI,cAAc,EAAE,CAAC;QACrC,iDAAiD;QACjD,OAAO,YAAY,CAAC,UAAU,CAAC;IACjC,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC;IACX,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,YAA8B;IACtE,MAAM,IAAI,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAA0B,EAC1B,QAA0B,EAC1B,MAAc;IAEd,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,+DAA+D;IAC/D,MAAM,WAAW,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,QAAmB,CAAC;IAEnF,mBAAmB;IACnB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC/C,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;IAED,aAAa;IACb,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC/C,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,QAA0B,EAC1B,QAA0B,EAC1B,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}