chore: Warn user if they are not using a TurnkeySparkSigner

.changeset/olive-worlds-deny.md

@@ -0,0 +1,5 @@
+---
+"@turnkey/spark": patch
+---
+
+Warn users if they are not using TurnkeySparkSigner with TurnkeySparkWallet

packages/spark/src/__tests__/wallet.test.ts

@@ -468,6 +468,32 @@ At the moment, withdrawal requests are leaking test funds into the BTC wallet ${
     },
     TEST_TIMEOUT,
   );
+
+  describe("Signer warnings", () => {
+    let consoleWarnSpy: jest.SpyInstance;
+
+    beforeEach(() => {
+      consoleWarnSpy = jest.spyOn(console, "warn").mockImplementation();
+    });
+
+    afterEach(() => {
+      consoleWarnSpy.mockRestore();
+    });
+
+    it("should warn if the signer is not a TurnkeySparkSigner", async () => {
+      await createSparkWallet({} as TurnkeySparkSigner);
+
+      expect(consoleWarnSpy).toHaveBeenCalledWith(
+        "Warning: The provided signer is not a TurnkeySparkSigner.",
+      );
+    });
+
+    it("should not warn if the signer is a TurnkeySparkSigner", async () => {
+      await createSparkWallet(senderSigner);
+
+      expect(consoleWarnSpy).not.toHaveBeenCalled();
+    });
+  });
 });
 
 /**

packages/spark/src/signer.ts

@@ -373,6 +373,10 @@ export class TurnkeySparkSigner implements SparkSigner {
     }
   }
 
+  isTurnkeySparkSigner(): boolean {
+    return true;
+  }
+
   // ---------------------------------------------------------------------------
   // Identity key operations (already working)
   // ---------------------------------------------------------------------------

packages/spark/src/wallet.ts

@@ -20,6 +20,8 @@ export class TurnkeySparkWallet extends SparkWallet {
   constructor(options?: ConfigOptions, signerArg?: SparkSigner) {
     super(options, signerArg);
 
+    warnIfNotTurnkeySigner(signerArg);
+
     this.transferService = new TurnkeyTransferService(
       this.config,
       this.connectionManager,
@@ -127,3 +129,9 @@ export class TurnkeySparkWallet extends SparkWallet {
     return (this as any).logging as LoggingService | undefined;
   }
 }
+
+const warnIfNotTurnkeySigner = (signer: SparkSigner | undefined) => {
+  if (!(signer as TurnkeySparkSigner)?.isTurnkeySparkSigner?.()) {
+    console.warn("Warning: The provided signer is not a TurnkeySparkSigner.");
+  }
+};