@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/signers/svm/solana-web3js.js

@@ -0,0 +1,247 @@
+import { ComputeBudgetProgram, Keypair, Transaction, VersionedTransaction, } from '@solana/web3.js';
+import { rootLogger, sleep } from '@recoillink/utils';
+import { SEALEVEL_PRIORITY_FEES } from '../../consts/sealevel.js';
+/**
+ * Rewrite a `VersionedTransaction`'s blockhash and clear its signatures so
+ * the caller can re-sign with the fresh blockhash. `MessageV0.recentBlockhash`
+ * is declared `readonly` in TypeScript but is a plain mutable field at
+ * runtime; the same pattern is used by `@solana/wallet-adapter` resubmit
+ * examples. `Object.assign` performs the write without a type assertion.
+ * Returns the same instance for chaining.
+ */
+function stampVersionedBlockhash(tx, blockhash) {
+    Object.assign(tx.message, { recentBlockhash: blockhash });
+    for (let i = 0; i < tx.signatures.length; i++) {
+        tx.signatures[i] = new Uint8Array(64);
+    }
+    return tx;
+}
+/**
+ * Keypair-based SVM transaction signer
+ */
+export class KeypairSvmTransactionSigner {
+    publicKey;
+    keypair;
+    constructor(privateKey) {
+        this.keypair = Keypair.fromSecretKey(privateKey);
+        this.publicKey = this.keypair.publicKey;
+    }
+    async signTransaction(transaction) {
+        // `VersionedTransaction.sign([signer])` populates only the signer's
+        // slot (other signature slots stay as their pre-initialized zero bytes),
+        // matching the partial-sign semantics of legacy `Transaction.partialSign`.
+        if (transaction instanceof VersionedTransaction) {
+            transaction.sign([this.keypair]);
+        }
+        else {
+            transaction.partialSign(this.keypair);
+        }
+        return transaction;
+    }
+}
+export class SvmMultiProtocolSignerAdapter {
+    chainName;
+    signer;
+    svmProvider;
+    config;
+    logger = rootLogger.child({
+        module: 'SvmMultiProtocolSignerAdapter',
+    });
+    constructor(chainName, signer, multiProtocolProvider, config) {
+        this.chainName = chainName;
+        this.signer = signer;
+        this.svmProvider = multiProtocolProvider.getSolanaWeb3Provider(chainName);
+        this.config = {
+            maxConfirmationAttempts: config?.maxConfirmationAttempts ?? 30,
+            pollingDelayMs: config?.pollingDelayMs ?? 1000,
+            commitment: config?.commitment ?? 'confirmed',
+            enableBlockhashResubmit: config?.enableBlockhashResubmit ?? true,
+            retryOnRpcErrors: config?.retryOnRpcErrors ?? true,
+        };
+    }
+    publicKey() {
+        return this.signer.publicKey;
+    }
+    async address() {
+        return this.signer.publicKey.toBase58();
+    }
+    /**
+     * Build and send a transaction from raw instructions
+     */
+    async buildAndSendTransaction(instructions, options) {
+        const tx = this.buildTransaction(instructions, options);
+        return this.signAndConfirm(tx);
+    }
+    /**
+     * Send and confirm a pre-built transaction (IMultiProtocolSigner interface)
+     */
+    async sendAndConfirmTransaction(tx, _options) {
+        return this.signAndConfirm(tx.transaction, tx.extraSigners);
+    }
+    // ============ Private Methods ============
+    /**
+     * Build transaction from instructions with optional priority fees
+     */
+    buildTransaction(instructions, options) {
+        const tx = new Transaction();
+        // Add priority fee if enabled and not already present
+        const includePriorityFee = options?.includePriorityFee ?? true;
+        if (includePriorityFee) {
+            const hasPriorityFeeIx = instructions.some((ix) => ix.programId.equals(ComputeBudgetProgram.programId));
+            if (!hasPriorityFeeIx) {
+                const priorityFee = options?.priorityFee ?? SEALEVEL_PRIORITY_FEES[this.chainName];
+                if (priorityFee) {
+                    tx.add(ComputeBudgetProgram.setComputeUnitPrice({
+                        microLamports: priorityFee,
+                    }));
+                }
+            }
+        }
+        // Add all instructions
+        instructions.forEach((ix) => tx.add(ix));
+        tx.feePayer = this.signer.publicKey;
+        return tx;
+    }
+    /**
+     * Sign and confirm transaction with blockhash resubmit on expiry
+     */
+    async signAndConfirm(transaction, extraSigners) {
+        // Get initial blockhash
+        const { blockhash, lastValidBlockHeight } = await this.svmProvider.getLatestBlockhash(this.config.commitment);
+        if (transaction instanceof VersionedTransaction) {
+            stampVersionedBlockhash(transaction, blockhash);
+            // `VersionedTransaction.sign([signer])` only populates the signer's
+            // slot (matches partial-sign semantics of legacy `partialSign`).
+            for (const signer of extraSigners ?? []) {
+                transaction.sign([signer]);
+            }
+        }
+        else {
+            transaction.recentBlockhash = blockhash;
+            if (!transaction.feePayer) {
+                transaction.feePayer = this.signer.publicKey;
+            }
+            // Sign with extra signers first (e.g., randomWallet for Sealevel
+            // transferRemote). Uses partialSign to avoid clearing any existing
+            // signatures. This re-signs with the fresh blockhash, overwriting
+            // the adapter's pre-sign.
+            for (const signer of extraSigners ?? []) {
+                transaction.partialSign(signer);
+            }
+        }
+        // Sign with main signer (preserves extra signers' signatures)
+        const signedTx = await this.signer.signTransaction(transaction);
+        // Send initial transaction
+        const signature = await this.sendRawTransaction(signedTx);
+        // Poll for confirmation with optional resubmit
+        const result = await this.pollForConfirmation(signature, signedTx, lastValidBlockHeight, extraSigners);
+        return result;
+    }
+    /**
+     * Poll for transaction confirmation with blockhash expiry handling
+     */
+    async pollForConfirmation(initialSignature, transaction, lastValidBlockHeight, extraSigners) {
+        let signature = initialSignature;
+        let attempts = 0;
+        let currentLastValidBlockHeight = lastValidBlockHeight;
+        while (attempts < this.config.maxConfirmationAttempts) {
+            await sleep(this.config.pollingDelayMs);
+            attempts++;
+            try {
+                // Check and handle blockhash expiry
+                const resubmitResult = await this.checkAndResubmitIfExpired(signature, transaction, currentLastValidBlockHeight, extraSigners);
+                if (resubmitResult) {
+                    signature = resubmitResult.signature;
+                    currentLastValidBlockHeight = resubmitResult.lastValidBlockHeight;
+                    continue;
+                }
+                // Check if transaction is confirmed
+                const isConfirmed = await this.checkTransactionConfirmation(signature);
+                if (isConfirmed) {
+                    this.logger.info(`Transaction ${signature} confirmed after ${attempts} attempts`);
+                    return signature;
+                }
+            }
+            catch (error) {
+                // If it's a transaction failure error, rethrow immediately
+                if (error instanceof Error &&
+                    error.message.includes('Transaction failed')) {
+                    throw error;
+                }
+                // Handle RPC errors based on config
+                if (!this.config.retryOnRpcErrors) {
+                    throw error;
+                }
+                // Log RPC errors but continue polling (temporary issues)
+                this.logger.warn(`Polling attempt ${attempts} failed: ${error}`);
+            }
+        }
+        throw new Error(`Transaction confirmation timeout after ${this.config.maxConfirmationAttempts} attempts`);
+    }
+    /**
+     * Check if blockhash expired and resubmit transaction if needed
+     * Returns new signature and lastValidBlockHeight if resubmitted, null otherwise
+     */
+    async checkAndResubmitIfExpired(signature, transaction, lastValidBlockHeight, extraSigners) {
+        if (!this.config.enableBlockhashResubmit) {
+            return null;
+        }
+        const currentBlockHeight = await this.svmProvider.getBlockHeight();
+        if (currentBlockHeight <= lastValidBlockHeight) {
+            return null; // Blockhash still valid
+        }
+        this.logger.warn(`Blockhash expired at block ${lastValidBlockHeight}, current ${currentBlockHeight}. Resubmitting...`);
+        // Get fresh blockhash and resubmit
+        const { blockhash, lastValidBlockHeight: newLastValid } = await this.svmProvider.getLatestBlockhash(this.config.commitment);
+        if (transaction instanceof VersionedTransaction) {
+            stampVersionedBlockhash(transaction, blockhash);
+            for (const signer of extraSigners ?? []) {
+                transaction.sign([signer]);
+            }
+        }
+        else {
+            transaction.recentBlockhash = blockhash;
+            for (const signer of extraSigners ?? []) {
+                transaction.partialSign(signer);
+            }
+        }
+        const signedTx = await this.signer.signTransaction(transaction);
+        const newSignature = await this.sendRawTransaction(signedTx);
+        this.logger.info(`Resubmitted with signature: ${newSignature}`);
+        return {
+            signature: newSignature,
+            lastValidBlockHeight: newLastValid,
+        };
+    }
+    /**
+     * Check if transaction is confirmed
+     * Returns true if confirmed, false if pending
+     * Throws if transaction failed
+     */
+    async checkTransactionConfirmation(signature) {
+        const status = await this.svmProvider.getSignatureStatus(signature, {
+            searchTransactionHistory: true,
+        });
+        if (!status.value) {
+            return false; // Transaction not yet seen
+        }
+        // Check for transaction error
+        if (status.value.err) {
+            throw new Error(`Transaction failed: ${JSON.stringify(status.value.err)}`);
+        }
+        // Check if confirmed at required commitment level
+        const confirmationStatus = status.value.confirmationStatus;
+        return (confirmationStatus === this.config.commitment ||
+            confirmationStatus === 'finalized');
+    }
+    /**
+     * Send signed transaction to network
+     */
+    async sendRawTransaction(transaction) {
+        return await this.svmProvider.sendRawTransaction(transaction.serialize(), {
+            skipPreflight: false,
+            maxRetries: 3,
+        });
+    }
+}
+//# sourceMappingURL=solana-web3js.js.map

package/dist/signers/svm/solana-web3js.js.map

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

package/dist/signers/svm/solana-web3js.test.d.ts

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

package/dist/signers/svm/solana-web3js.test.d.ts.map

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

package/dist/signers/svm/solana-web3js.test.js

@@ -0,0 +1,61 @@
+import { expect } from 'chai';
+import { Keypair, SystemProgram, Transaction } from '@solana/web3.js';
+import { KeypairSvmTransactionSigner } from './solana-web3js.js';
+describe('KeypairSvmTransactionSigner', () => {
+    it('preserves existing partialSign signatures when signing with main keypair', async () => {
+        const mainSigner = Keypair.generate();
+        const extraSigner = Keypair.generate();
+        const recipient = Keypair.generate();
+        const tx = new Transaction();
+        // Two transfers so both mainSigner and extraSigner are required signers
+        tx.add(SystemProgram.transfer({
+            fromPubkey: mainSigner.publicKey,
+            toPubkey: recipient.publicKey,
+            lamports: 1000,
+        }));
+        tx.add(SystemProgram.transfer({
+            fromPubkey: extraSigner.publicKey,
+            toPubkey: recipient.publicKey,
+            lamports: 500,
+        }));
+        tx.feePayer = mainSigner.publicKey;
+        tx.recentBlockhash = 'GHtXQBsoZHVnNFa9YevAzFr17DJjgHXk3ycTKD5xD3Zi';
+        // Extra signer signs first
+        tx.partialSign(extraSigner);
+        const extraSigBefore = tx.signatures.find((s) => s.publicKey.equals(extraSigner.publicKey));
+        expect(extraSigBefore?.signature).to.not.be.null;
+        // Main signer signs via KeypairSvmTransactionSigner — should PRESERVE extra signer's signature
+        const signer = new KeypairSvmTransactionSigner(mainSigner.secretKey);
+        await signer.signTransaction(tx);
+        const mainSig = tx.signatures.find((s) => s.publicKey.equals(mainSigner.publicKey));
+        const extraSigAfter = tx.signatures.find((s) => s.publicKey.equals(extraSigner.publicKey));
+        expect(mainSig?.signature).to.not.be.null;
+        expect(extraSigAfter?.signature).to.not.be.null;
+    });
+    it('REGRESSION: sign() wipes extra signatures (demonstrates the bug we fixed)', () => {
+        const mainSigner = Keypair.generate();
+        const extraSigner = Keypair.generate();
+        const recipient = Keypair.generate();
+        const tx = new Transaction();
+        // Two transfers so both mainSigner and extraSigner are required signers
+        tx.add(SystemProgram.transfer({
+            fromPubkey: mainSigner.publicKey,
+            toPubkey: recipient.publicKey,
+            lamports: 1000,
+        }));
+        tx.add(SystemProgram.transfer({
+            fromPubkey: extraSigner.publicKey,
+            toPubkey: recipient.publicKey,
+            lamports: 500,
+        }));
+        tx.feePayer = mainSigner.publicKey;
+        tx.recentBlockhash = 'GHtXQBsoZHVnNFa9YevAzFr17DJjgHXk3ycTKD5xD3Zi';
+        tx.partialSign(extraSigner);
+        // sign() clears all signatures — this is the bug we fixed
+        tx.sign(mainSigner);
+        const extraSig = tx.signatures.find((s) => s.publicKey.equals(extraSigner.publicKey));
+        // After sign(), the extra signer's signature is GONE (null)
+        expect(extraSig?.signature).to.be.null;
+    });
+});
+//# sourceMappingURL=solana-web3js.test.js.map

package/dist/signers/svm/solana-web3js.test.js.map

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

package/dist/signers/svm/turnkey.d.ts

@@ -0,0 +1,49 @@
+import { PublicKey, Transaction, VersionedTransaction } from '@solana/web3.js';
+import { TurnkeyConfig } from '../turnkeyClient.js';
+import { SvmTransactionSigner } from './solana-web3js.js';
+/**
+ * Turnkey signer for Solana/SVM transactions
+ * Provides a Keypair-like interface but signs transactions using Turnkey's secure enclaves
+ * Uses composition to access Turnkey functionality while implementing SVM interface
+ *
+ * @example
+ * ```typescript
+ * const config: TurnkeyConfig = {
+ *   organizationId: 'your-org-id',
+ *   apiPublicKey: process.env.TURNKEY_API_PUBLIC_KEY,
+ *   apiPrivateKey: process.env.TURNKEY_API_PRIVATE_KEY,
+ *   privateKeyId: 'your-private-key-id',
+ *   publicKey: 'base58-solana-pubkey',
+ * };
+ *
+ * const signer = new TurnkeySealevelSigner(config);
+ *
+ * // Use with SvmMultiProtocolSignerAdapter
+ * const adapter = new SvmMultiProtocolSignerAdapter(
+ *   'solana',
+ *   signer,
+ *   multiProtocolProvider
+ * );
+ * ```
+ */
+export declare class TurnkeySealevelSigner implements SvmTransactionSigner {
+    private readonly manager;
+    private readonly turnkeySigner;
+    readonly publicKey: PublicKey;
+    constructor(config: TurnkeyConfig);
+    /**
+     * Health check - delegates to manager
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Get a signer (returns this instance)
+     */
+    getSigner(): Promise<this>;
+    /**
+     * Sign a Solana transaction using Turnkey
+     * This method uses Turnkey's secure enclave to sign the transaction
+     * and enforces any policies configured in Turnkey (e.g., IGP-only restrictions)
+     */
+    signTransaction<T extends Transaction | VersionedTransaction>(transaction: T): Promise<T>;
+}
+//# sourceMappingURL=turnkey.d.ts.map

package/dist/signers/svm/turnkey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnkey.d.ts","sourceRoot":"","sources":["../../../src/signers/svm/turnkey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAK/E,OAAO,EAEL,aAAa,EAEd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAI1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,SAAgB,SAAS,EAAE,SAAS,CAAC;IAErC,YAAY,MAAM,EAAE,aAAa,EAahC;IAED;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAEpC;IAED;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/B;IAED;;;;OAIG;IACG,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,oBAAoB,EAChE,WAAW,EAAE,CAAC,GACb,OAAO,CAAC,CAAC,CAAC,CAqBZ;CACF"}

package/dist/signers/svm/turnkey.js

@@ -0,0 +1,80 @@
+import { PublicKey } from '@solana/web3.js';
+import { TurnkeySigner as TurnkeySolanaSigner } from '@turnkey/solana';
+import { rootLogger } from '@recoillink/utils';
+import { TurnkeyClientManager, logTurnkeyError, } from '../turnkeyClient.js';
+const logger = rootLogger.child({ module: 'sdk:turnkey-sealevel' });
+/**
+ * Turnkey signer for Solana/SVM transactions
+ * Provides a Keypair-like interface but signs transactions using Turnkey's secure enclaves
+ * Uses composition to access Turnkey functionality while implementing SVM interface
+ *
+ * @example
+ * ```typescript
+ * const config: TurnkeyConfig = {
+ *   organizationId: 'your-org-id',
+ *   apiPublicKey: process.env.TURNKEY_API_PUBLIC_KEY,
+ *   apiPrivateKey: process.env.TURNKEY_API_PRIVATE_KEY,
+ *   privateKeyId: 'your-private-key-id',
+ *   publicKey: 'base58-solana-pubkey',
+ * };
+ *
+ * const signer = new TurnkeySealevelSigner(config);
+ *
+ * // Use with SvmMultiProtocolSignerAdapter
+ * const adapter = new SvmMultiProtocolSignerAdapter(
+ *   'solana',
+ *   signer,
+ *   multiProtocolProvider
+ * );
+ * ```
+ */
+export class TurnkeySealevelSigner {
+    manager;
+    turnkeySigner;
+    publicKey;
+    constructor(config) {
+        this.manager = new TurnkeyClientManager(config);
+        this.turnkeySigner = new TurnkeySolanaSigner({
+            organizationId: this.manager.getOrganizationId(),
+            client: this.manager.getClient(),
+        });
+        this.publicKey = new PublicKey(config.publicKey);
+        logger.debug(`Initialized Turnkey Sealevel signer for key: ${this.publicKey}`);
+    }
+    /**
+     * Health check - delegates to manager
+     */
+    async healthCheck() {
+        return this.manager.healthCheck();
+    }
+    /**
+     * Get a signer (returns this instance)
+     */
+    async getSigner() {
+        return this;
+    }
+    /**
+     * Sign a Solana transaction using Turnkey
+     * This method uses Turnkey's secure enclave to sign the transaction
+     * and enforces any policies configured in Turnkey (e.g., IGP-only restrictions)
+     */
+    async signTransaction(transaction) {
+        logger.debug('Signing transaction with Turnkey');
+        try {
+            // Use Turnkey's Solana signer to sign the transaction
+            // This uses the ACTIVITY_TYPE_SIGN_TRANSACTION_V2 activity type
+            const signedTx = await this.turnkeySigner.signTransaction(
+            // @ts-ignore work around @solana/web3.js version mismatch
+            transaction, this.publicKey.toBase58(), this.manager.getOrganizationId());
+            logger.debug('Transaction signed successfully');
+            // Return the transaction (Turnkey modifies it in place or returns the same type)
+            // @ts-ignore work around @solana/web3.js version mismatch
+            return signedTx;
+        }
+        catch (error) {
+            logTurnkeyError('Failed to sign transaction with Turnkey', error);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=turnkey.js.map

package/dist/signers/svm/turnkey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnkey.js","sourceRoot":"","sources":["../../../src/signers/svm/turnkey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqC,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EACL,oBAAoB,EAEpB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,qBAAqB;IACf,OAAO,CAAuB;IAC9B,aAAa,CAAsB;IACpC,SAAS,CAAY;IAErC,YAAY,MAAqB;QAC/B,IAAI,CAAC,OAAO,GAAG,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAEhD,IAAI,CAAC,aAAa,GAAG,IAAI,mBAAmB,CAAC;YAC3C,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;YAChD,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEjD,MAAM,CAAC,KAAK,CACV,gDAAgD,IAAI,CAAC,SAAS,EAAE,CACjE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CACnB,WAAc;QAEd,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAEjD,IAAI,CAAC;YACH,sDAAsD;YACtD,gEAAgE;YAChE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe;YACvD,0DAA0D;YAC1D,WAAW,EACX,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EACzB,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CACjC,CAAC;YAEF,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;YAChD,iFAAiF;YACjF,0DAA0D;YAC1D,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;YAClE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/signers/turnkeyClient.d.ts

@@ -0,0 +1,72 @@
+import type { TActivity } from '@turnkey/sdk-server';
+import { TurnkeyServerClient } from '@turnkey/sdk-server';
+import { z } from 'zod';
+/**
+ * Log Turnkey operation error safely without exposing sensitive data
+ * Accepts unknown errors from catch blocks and safely extracts error messages
+ */
+export declare function logTurnkeyError(operation: string, error: unknown): void;
+/**
+ * Validate that a Turnkey activity completed successfully
+ * The Turnkey SDK polls internally until the activity completes or max retries are reached.
+ * If we receive a non-completed status, it indicates an SDK bug or request error.
+ */
+export declare function validateTurnkeyActivityCompleted(activity: TActivity, operationType: string): void;
+/**
+ * Default Turnkey API base URL
+ */
+export declare const DEFAULT_TURNKEY_API_BASE_URL = "https://api.turnkey.com";
+/**
+ * Unified Turnkey configuration for both Sealevel and EVM keys
+ * The publicKey field contains:
+ * - For Sealevel: base58-encoded Solana public key
+ * - For EVM: hex-encoded Ethereum address
+ *
+ * The optional apiBaseUrl defaults to {@link DEFAULT_TURNKEY_API_BASE_URL}.
+ */
+export declare const TurnkeyConfigSchema: z.ZodObject<{
+    organizationId: z.ZodString;
+    apiPublicKey: z.ZodString;
+    apiPrivateKey: z.ZodString;
+    privateKeyId: z.ZodString;
+    publicKey: z.ZodString;
+    apiBaseUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TurnkeyConfig = z.infer<typeof TurnkeyConfigSchema>;
+/**
+ * Shared Turnkey client manager
+ * Handles initialization, health checks, and provides access to the Turnkey client
+ *
+ * This class is used by all VM-specific signers via composition rather than inheritance,
+ * allowing each signer to extend/implement their VM-specific base classes while
+ * still sharing common Turnkey functionality.
+ *
+ * @example
+ * ```typescript
+ * const manager = new TurnkeyClientManager(config);
+ * await manager.healthCheck();
+ * const client = manager.getClient();
+ * ```
+ */
+export declare class TurnkeyClientManager {
+    private readonly client;
+    private readonly config;
+    constructor(config: TurnkeyConfig);
+    /**
+     * Get a copy of the configuration (for creating new signer instances)
+     */
+    getConfig(): TurnkeyConfig;
+    /**
+     * Get the Turnkey client (for signing operations)
+     */
+    getClient(): TurnkeyServerClient;
+    /**
+     * Get organization ID
+     */
+    getOrganizationId(): string;
+    /**
+     * Check if Turnkey is properly configured and accessible
+     */
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=turnkeyClient.d.ts.map

package/dist/signers/turnkeyClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnkeyClient.d.ts","sourceRoot":"","sources":["../../src/signers/turnkeyClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAGvE;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,SAAS,EACnB,aAAa,EAAE,MAAM,GACpB,IAAI,CAMN;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;;;iBAO9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,YAAY,MAAM,EAAE,aAAa,EAahC;IAED;;OAEG;IACH,SAAS,IAAI,aAAa,CAEzB;IAED;;OAEG;IACH,SAAS,IAAI,mBAAmB,CAE/B;IAED;;OAEG;IACH,iBAAiB,IAAI,MAAM,CAE1B;IAED;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAgBpC;CACF"}