@wuwei-labs/srsly 2.0.0-beta.45 → 2.0.0-beta.46

package/dist/cjs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wuwei-labs/srsly",
-  "version": "2.0.0-beta.45",
+  "version": "2.0.0-beta.46",
   "description": "",
   "source": "./src/index.ts",
   "sideEffects": false,

package/dist/cjs/utils/signer.js

@@ -1,28 +1,101 @@
 "use strict";
 /**
- * Universal signer handling utilities for cross-library compatibility
+ * Universal signer handling utilities for @solana/kit compatibility
  *
- * This module provides utilities to handle different signer types across
- * @solana/kit, @solana/web3.js, and plain address strings in a unified way.
+ * This module provides utilities to handle different signer types in a unified way
+ * while ensuring compatibility with @solana/kit. Supports string addresses for
+ * browser usage and TransactionSigner objects for Node.js usage.
+ *
+ * Note: web3.js signers (Keypair, etc.) are explicitly not supported.
+ * Use address strings or @solana/kit TransactionSigner objects instead.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidSignerError = void 0;
+exports.validateSigner = validateSigner;
 exports.createTransactionSigner = createTransactionSigner;
 exports.isSignerObject = isSignerObject;
 exports.isAddressString = isAddressString;
 const kit_1 = require("@solana/kit");
 /**
- * Creates TransactionSigner from UniversalSigner input for universal compatibility
+ * Error thrown when an invalid signer type is provided
+ */
+class InvalidSignerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidSignerError';
+    }
+}
+exports.InvalidSignerError = InvalidSignerError;
+/**
+ * Validates that a signer is compatible with @solana/kit
+ *
+ * @param signer - The signer to validate
+ * @throws {InvalidSignerError} If the signer is not compatible
+ */
+function validateSigner(signer) {
+    if (typeof signer === 'string') {
+        // Validate that the string is a valid Solana address
+        try {
+            // Use @solana/kit's address() function to validate - it will throw if invalid
+            (0, kit_1.address)(signer);
+            return;
+        }
+        catch (error) {
+            throw new InvalidSignerError(`Invalid address string: "${signer}". ${error instanceof Error ? error.message : 'Unknown validation error'}\n\n` +
+                'Expected a valid base58-encoded Solana address (32-44 characters).\n' +
+                'Examples:\n' +
+                '  - "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"\n' +
+                '  - "So11111111111111111111111111111111111111112"');
+        }
+    }
+    if (signer && typeof signer === 'object') {
+        const signerObj = signer;
+        // Check for web3.js Keypair or similar patterns
+        if ('publicKey' in signerObj) {
+            throw new InvalidSignerError('web3.js signers (Keypair, etc.) are not supported. ' +
+                'Use a base58 address string or TransactionSigner from @solana/kit instead.\n\n' +
+                'Examples:\n' +
+                '  - Browser: "base58AddressString"\n' +
+                '  - Node.js: createNoopSigner(address("base58AddressString"))');
+        }
+        // Check for valid @solana/kit signer patterns
+        if ('address' in signerObj || typeof signerObj.signTransactions === 'function') {
+            // If it has an address property, validate that the address is valid
+            if ('address' in signerObj) {
+                try {
+                    // Ensure the address property is a valid Address type
+                    if (!(0, kit_1.isAddress)(signerObj.address)) {
+                        throw new InvalidSignerError(`Signer object has invalid address property. Expected Address type from @solana/kit.`);
+                    }
+                }
+                catch (error) {
+                    throw new InvalidSignerError(`Signer object has invalid address property: ${error instanceof Error ? error.message : 'Unknown validation error'}`);
+                }
+            }
+            return;
+        }
+        // Unknown signer object format
+        throw new InvalidSignerError('Invalid signer format. Expected:\n' +
+            '  - base58 address string (browser usage)\n' +
+            '  - TransactionSigner from @solana/kit (Node.js usage)\n' +
+            '  - Object with address property');
+    }
+    throw new InvalidSignerError('Signer must be a string address or compatible signer object');
+}
+/**
+ * Creates TransactionSigner from UniversalSigner input with validation
  *
  * This function provides universal compatibility by:
+ * - Validating the signer is compatible with @solana/kit
  * - Converting string addresses to TransactionSigner using createNoopSigner
  * - Passing through existing TransactionSigner objects unchanged
- * - Safely handling different signer interfaces (kit, web3.js, etc.)
  *
  * The returned TransactionSigner has both .address property and signing capability,
  * making it suitable for both PDA derivation and codama instruction building.
  *
- * @param signer - The signer input (string address or signer object)
+ * @param signer - The signer input (string address or @solana/kit compatible signer)
  * @returns TransactionSigner that can be used directly for codama and has .address property
+ * @throws {InvalidSignerError} If the signer is not compatible (e.g., web3.js Keypair)
  *
  * @example
  * ```typescript
@@ -31,19 +104,23 @@ const kit_1 = require("@solana/kit");
  * // borrower.address → Address object for PDA derivation
  * // borrower → TransactionSigner for codama
  *
- * // CLI usage with wallet object
+ * // Node.js usage with TransactionSigner
  * const borrower = createTransactionSigner(wallet);
  * // borrower.address → wallet.address for PDA derivation
  * // borrower → wallet signer for codama
+ *
+ * // This will throw an error:
+ * // createTransactionSigner(keypair); // InvalidSignerError: web3.js signers not supported
  * ```
  */
 function createTransactionSigner(signer) {
+    // Validate the signer first
+    validateSigner(signer);
     // Handle string address case (browser usage)
     if (typeof signer === 'string') {
         return (0, kit_1.createNoopSigner)((0, kit_1.address)(signer)); // Returns TransactionSigner with .address property
     }
-    // Handle signer object cases (CLI and other wallet interfaces)
-    // These should already be TransactionSigner objects with .address property
+    // Handle signer object cases (already validated TransactionSigner objects)
     return signer;
 }
 /**

package/dist/cjs/utils/signer.js.map

@@ -1 +1 @@
-{"version":3,"file":"signer.js","sourceRoot":"","sources":["../../../src/utils/signer.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA2CH,0DASC;AAKD,wCAEC;AAKD,0CAEC;AAhED,qCAAgF;AAchF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,uBAAuB,CAAC,MAAuB;IAC7D,6CAA6C;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,IAAA,sBAAgB,EAAC,IAAA,aAAO,EAAC,MAAM,CAAC,CAAC,CAAC,CAAE,mDAAmD;IAChG,CAAC;IAED,+DAA+D;IAC/D,2EAA2E;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,MAAuB;IACpD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAAuB;IACrD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC"}
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../../../src/utils/signer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAqCH,wCAgEC;AAiCD,0DAWC;AAKD,wCAEC;AAKD,0CAEC;AA7JD,qCAA2F;AAG3F;;GAEG;AACH,MAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAkBD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,MAAe;IAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,qDAAqD;QACrD,IAAI,CAAC;YACH,8EAA8E;YAC9E,IAAA,aAAO,EAAC,MAAM,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,4BAA4B,MAAM,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,MAAM;gBACjH,sEAAsE;gBACtE,aAAa;gBACb,sDAAsD;gBACtD,mDAAmD,CACpD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,MAA6B,CAAC;QAEhD,gDAAgD;QAChD,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,kBAAkB,CAC1B,qDAAqD;gBACrD,gFAAgF;gBAChF,aAAa;gBACb,sCAAsC;gBACtC,+DAA+D,CAChE,CAAC;QACJ,CAAC;QAED,8CAA8C;QAC9C,IAAI,SAAS,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC/E,oEAAoE;YACpE,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,sDAAsD;oBACtD,IAAI,CAAC,IAAA,eAAS,EAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;wBAClC,MAAM,IAAI,kBAAkB,CAC1B,qFAAqF,CACtF,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,IAAI,kBAAkB,CAC1B,+CAA+C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,EAAE,CACrH,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,MAAM,IAAI,kBAAkB,CAC1B,oCAAoC;YACpC,6CAA6C;YAC7C,0DAA0D;YAC1D,kCAAkC,CACnC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,kBAAkB,CAC1B,6DAA6D,CAC9D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,SAAgB,uBAAuB,CAAC,MAAuB;IAC7D,4BAA4B;IAC5B,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,6CAA6C;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,IAAA,sBAAgB,EAAC,IAAA,aAAO,EAAC,MAAM,CAAC,CAAC,CAAC,CAAE,mDAAmD;IAChG,CAAC;IAED,2EAA2E;IAC3E,OAAO,MAA2B,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,MAAuB;IACpD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAAuB;IACrD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC"}

package/dist/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wuwei-labs/srsly",
-  "version": "2.0.0-beta.45",
+  "version": "2.0.0-beta.46",
   "description": "",
   "source": "./src/index.ts",
   "sideEffects": false,

package/dist/esm/utils/signer.js

@@ -1,23 +1,93 @@
 /**
- * Universal signer handling utilities for cross-library compatibility
+ * Universal signer handling utilities for @solana/kit compatibility
  *
- * This module provides utilities to handle different signer types across
- * @solana/kit, @solana/web3.js, and plain address strings in a unified way.
+ * This module provides utilities to handle different signer types in a unified way
+ * while ensuring compatibility with @solana/kit. Supports string addresses for
+ * browser usage and TransactionSigner objects for Node.js usage.
+ *
+ * Note: web3.js signers (Keypair, etc.) are explicitly not supported.
+ * Use address strings or @solana/kit TransactionSigner objects instead.
  */
-import { createNoopSigner, address } from '@solana/kit';
+import { createNoopSigner, address, isAddress } from '@solana/kit';
 /**
- * Creates TransactionSigner from UniversalSigner input for universal compatibility
+ * Error thrown when an invalid signer type is provided
+ */
+export class InvalidSignerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidSignerError';
+    }
+}
+/**
+ * Validates that a signer is compatible with @solana/kit
+ *
+ * @param signer - The signer to validate
+ * @throws {InvalidSignerError} If the signer is not compatible
+ */
+export function validateSigner(signer) {
+    if (typeof signer === 'string') {
+        // Validate that the string is a valid Solana address
+        try {
+            // Use @solana/kit's address() function to validate - it will throw if invalid
+            address(signer);
+            return;
+        }
+        catch (error) {
+            throw new InvalidSignerError(`Invalid address string: "${signer}". ${error instanceof Error ? error.message : 'Unknown validation error'}\n\n` +
+                'Expected a valid base58-encoded Solana address (32-44 characters).\n' +
+                'Examples:\n' +
+                '  - "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"\n' +
+                '  - "So11111111111111111111111111111111111111112"');
+        }
+    }
+    if (signer && typeof signer === 'object') {
+        const signerObj = signer;
+        // Check for web3.js Keypair or similar patterns
+        if ('publicKey' in signerObj) {
+            throw new InvalidSignerError('web3.js signers (Keypair, etc.) are not supported. ' +
+                'Use a base58 address string or TransactionSigner from @solana/kit instead.\n\n' +
+                'Examples:\n' +
+                '  - Browser: "base58AddressString"\n' +
+                '  - Node.js: createNoopSigner(address("base58AddressString"))');
+        }
+        // Check for valid @solana/kit signer patterns
+        if ('address' in signerObj || typeof signerObj.signTransactions === 'function') {
+            // If it has an address property, validate that the address is valid
+            if ('address' in signerObj) {
+                try {
+                    // Ensure the address property is a valid Address type
+                    if (!isAddress(signerObj.address)) {
+                        throw new InvalidSignerError(`Signer object has invalid address property. Expected Address type from @solana/kit.`);
+                    }
+                }
+                catch (error) {
+                    throw new InvalidSignerError(`Signer object has invalid address property: ${error instanceof Error ? error.message : 'Unknown validation error'}`);
+                }
+            }
+            return;
+        }
+        // Unknown signer object format
+        throw new InvalidSignerError('Invalid signer format. Expected:\n' +
+            '  - base58 address string (browser usage)\n' +
+            '  - TransactionSigner from @solana/kit (Node.js usage)\n' +
+            '  - Object with address property');
+    }
+    throw new InvalidSignerError('Signer must be a string address or compatible signer object');
+}
+/**
+ * Creates TransactionSigner from UniversalSigner input with validation
  *
  * This function provides universal compatibility by:
+ * - Validating the signer is compatible with @solana/kit
  * - Converting string addresses to TransactionSigner using createNoopSigner
  * - Passing through existing TransactionSigner objects unchanged
- * - Safely handling different signer interfaces (kit, web3.js, etc.)
  *
  * The returned TransactionSigner has both .address property and signing capability,
  * making it suitable for both PDA derivation and codama instruction building.
  *
- * @param signer - The signer input (string address or signer object)
+ * @param signer - The signer input (string address or @solana/kit compatible signer)
  * @returns TransactionSigner that can be used directly for codama and has .address property
+ * @throws {InvalidSignerError} If the signer is not compatible (e.g., web3.js Keypair)
  *
  * @example
  * ```typescript
@@ -26,19 +96,23 @@ import { createNoopSigner, address } from '@solana/kit';
  * // borrower.address → Address object for PDA derivation
  * // borrower → TransactionSigner for codama
  *
- * // CLI usage with wallet object
+ * // Node.js usage with TransactionSigner
  * const borrower = createTransactionSigner(wallet);
  * // borrower.address → wallet.address for PDA derivation
  * // borrower → wallet signer for codama
+ *
+ * // This will throw an error:
+ * // createTransactionSigner(keypair); // InvalidSignerError: web3.js signers not supported
  * ```
  */
 export function createTransactionSigner(signer) {
+    // Validate the signer first
+    validateSigner(signer);
     // Handle string address case (browser usage)
     if (typeof signer === 'string') {
         return createNoopSigner(address(signer)); // Returns TransactionSigner with .address property
     }
-    // Handle signer object cases (CLI and other wallet interfaces)
-    // These should already be TransactionSigner objects with .address property
+    // Handle signer object cases (already validated TransactionSigner objects)
     return signer;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"signer.js","sourceRoot":"","sources":["../../../src/utils/signer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAA0B,MAAM,aAAa,CAAC;AAchF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC7D,6CAA6C;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,mDAAmD;IAChG,CAAC;IAED,+DAA+D;IAC/D,2EAA2E;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC"}
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../../../src/utils/signer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAA0B,MAAM,aAAa,CAAC;AAG3F;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAkBD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,qDAAqD;QACrD,IAAI,CAAC;YACH,8EAA8E;YAC9E,OAAO,CAAC,MAAM,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,4BAA4B,MAAM,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,MAAM;gBACjH,sEAAsE;gBACtE,aAAa;gBACb,sDAAsD;gBACtD,mDAAmD,CACpD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,MAA6B,CAAC;QAEhD,gDAAgD;QAChD,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,kBAAkB,CAC1B,qDAAqD;gBACrD,gFAAgF;gBAChF,aAAa;gBACb,sCAAsC;gBACtC,+DAA+D,CAChE,CAAC;QACJ,CAAC;QAED,8CAA8C;QAC9C,IAAI,SAAS,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC/E,oEAAoE;YACpE,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,sDAAsD;oBACtD,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;wBAClC,MAAM,IAAI,kBAAkB,CAC1B,qFAAqF,CACtF,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,IAAI,kBAAkB,CAC1B,+CAA+C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,EAAE,CACrH,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,MAAM,IAAI,kBAAkB,CAC1B,oCAAoC;YACpC,6CAA6C;YAC7C,0DAA0D;YAC1D,kCAAkC,CACnC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,kBAAkB,CAC1B,6DAA6D,CAC9D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC7D,4BAA4B;IAC5B,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,6CAA6C;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,mDAAmD;IAChG,CAAC;IAED,2EAA2E;IAC3E,OAAO,MAA2B,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC"}

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

@@ -1,35 +1,55 @@
 /**
- * Universal signer handling utilities for cross-library compatibility
+ * Universal signer handling utilities for @solana/kit compatibility
  *
- * This module provides utilities to handle different signer types across
- * @solana/kit, @solana/web3.js, and plain address strings in a unified way.
+ * This module provides utilities to handle different signer types in a unified way
+ * while ensuring compatibility with @solana/kit. Supports string addresses for
+ * browser usage and TransactionSigner objects for Node.js usage.
+ *
+ * Note: web3.js signers (Keypair, etc.) are explicitly not supported.
+ * Use address strings or @solana/kit TransactionSigner objects instead.
  */
 import { type TransactionSigner } from '@solana/kit';
 /**
- * Enhanced UniversalSigner type that accepts both signer objects and address strings
+ * Error thrown when an invalid signer type is provided
+ */
+export declare class InvalidSignerError extends Error {
+    constructor(message: string);
+}
+/**
+ * Universal signer type that supports @solana/kit compatible signers and address strings
+ *
+ * Supported types:
+ * - string: Base58 Solana address (for browser usage)
+ * - TransactionSigner: @solana/kit signer object (for Node.js usage)
+ * - { address: string }: Kit-compatible signer with address property
+ *
+ * Note: web3.js signers (Keypair, etc.) are not supported. Use address strings
+ * or TransactionSigner objects from @solana/kit instead.
  */
-export type UniversalSigner = string | {
+export type UniversalSigner = string | TransactionSigner | {
     address: string;
-} | {
-    publicKey: {
-        toString(): string;
-    };
-} | {
-    publicKey: string;
-} | any;
+};
 /**
- * Creates TransactionSigner from UniversalSigner input for universal compatibility
+ * Validates that a signer is compatible with @solana/kit
+ *
+ * @param signer - The signer to validate
+ * @throws {InvalidSignerError} If the signer is not compatible
+ */
+export declare function validateSigner(signer: unknown): asserts signer is UniversalSigner;
+/**
+ * Creates TransactionSigner from UniversalSigner input with validation
  *
  * This function provides universal compatibility by:
+ * - Validating the signer is compatible with @solana/kit
  * - Converting string addresses to TransactionSigner using createNoopSigner
  * - Passing through existing TransactionSigner objects unchanged
- * - Safely handling different signer interfaces (kit, web3.js, etc.)
  *
  * The returned TransactionSigner has both .address property and signing capability,
  * making it suitable for both PDA derivation and codama instruction building.
  *
- * @param signer - The signer input (string address or signer object)
+ * @param signer - The signer input (string address or @solana/kit compatible signer)
  * @returns TransactionSigner that can be used directly for codama and has .address property
+ * @throws {InvalidSignerError} If the signer is not compatible (e.g., web3.js Keypair)
  *
  * @example
  * ```typescript
@@ -38,10 +58,13 @@ export type UniversalSigner = string | {
  * // borrower.address → Address object for PDA derivation
  * // borrower → TransactionSigner for codama
  *
- * // CLI usage with wallet object
+ * // Node.js usage with TransactionSigner
  * const borrower = createTransactionSigner(wallet);
  * // borrower.address → wallet.address for PDA derivation
  * // borrower → wallet signer for codama
+ *
+ * // This will throw an error:
+ * // createTransactionSigner(keypair); // InvalidSignerError: web3.js signers not supported
  * ```
  */
 export declare function createTransactionSigner(signer: UniversalSigner): TransactionSigner;

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

@@ -1 +1 @@
-{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../../src/utils/signer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhF;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,SAAS,EAAE;QAAE,QAAQ,IAAI,MAAM,CAAA;KAAE,CAAA;CAAE,GACrC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACrB,GAAG,CAAC;AAGR;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CASlF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,CAElG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,MAAM,CAEzE"}
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../../src/utils/signer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAwC,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG3F;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,iBAAiB,GACjB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExB;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,eAAe,CAgEjF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAWlF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,CAElG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,MAAM,CAEzE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wuwei-labs/srsly",
-  "version": "2.0.0-beta.45",
+  "version": "2.0.0-beta.46",
   "description": "",
   "main": "./dist/cjs/index.js",
   "types": "./dist/types/index.d.ts",