@hyperlane-xyz/sdk 19.7.0 → 19.9.0

package/dist/providers/SmartProvider/SmartProvider.test.js

@@ -0,0 +1,281 @@
+import { expect } from 'chai';
+import { errors as EthersError, providers } from 'ethers';
+import { AllProviderMethods } from './ProviderMethods.js';
+import { BlockchainError, HyperlaneSmartProvider } from './SmartProvider.js';
+import { ProviderStatus } from './types.js';
+// Dummy provider for testing
+class MockProvider extends providers.BaseProvider {
+    baseUrl;
+    errorToThrow;
+    successValue;
+    responseDelayMs;
+    supportedMethods = AllProviderMethods;
+    called = false;
+    thrownError;
+    static success(successValue, responseDelayMs = 0) {
+        return new MockProvider('http://provider', undefined, successValue, responseDelayMs);
+    }
+    static error(errorToThrow, responseDelayMs = 0) {
+        return new MockProvider('http://provider', errorToThrow, undefined, responseDelayMs);
+    }
+    constructor(baseUrl, errorToThrow, successValue, responseDelayMs = 0) {
+        super({ name: 'test', chainId: 1 });
+        this.baseUrl = baseUrl;
+        this.errorToThrow = errorToThrow;
+        this.successValue = successValue;
+        this.responseDelayMs = responseDelayMs;
+    }
+    getBaseUrl() {
+        return this.baseUrl;
+    }
+    async perform(_method, _params, _reqId) {
+        this.called = true;
+        if (this.responseDelayMs > 0) {
+            await new Promise((resolve) => setTimeout(resolve, this.responseDelayMs));
+        }
+        if (this.errorToThrow) {
+            this.thrownError = this.errorToThrow;
+            throw this.errorToThrow;
+        }
+        return this.successValue ?? 'success';
+    }
+    // Required BaseProvider methods - minimal implementations
+    async detectNetwork() {
+        return { name: 'test', chainId: 1 };
+    }
+}
+class TestableSmartProvider extends HyperlaneSmartProvider {
+    mockProviders;
+    constructor(mockProviders) {
+        super({ chainId: 1, name: 'test' }, mockProviders.map((p) => ({ http: p.getBaseUrl() })), [], { fallbackStaggerMs: 50 });
+        this.mockProviders = mockProviders;
+    }
+    testGetCombinedProviderError(errors, fallbackMsg) {
+        return this.getCombinedProviderError(errors, fallbackMsg);
+    }
+    async simplePerform(method, reqId) {
+        return this.performWithFallback(method, {}, this.mockProviders, reqId);
+    }
+}
+class ProviderError extends Error {
+    reason;
+    code;
+    constructor(message, code) {
+        super(message);
+        this.reason = message;
+        this.code = code;
+    }
+}
+describe('SmartProvider', () => {
+    let provider;
+    beforeEach(() => {
+        provider = new TestableSmartProvider([MockProvider.success('success')]);
+    });
+    describe('getCombinedProviderError', () => {
+        const blockchainErrorTestCases = [
+            {
+                code: EthersError.INSUFFICIENT_FUNDS,
+                message: 'insufficient funds for intrinsic transaction cost',
+            },
+            {
+                code: EthersError.UNPREDICTABLE_GAS_LIMIT,
+                message: 'execution reverted: ERC20: transfer to the zero address',
+            },
+            {
+                code: EthersError.CALL_EXCEPTION,
+                message: 'execution reverted',
+            },
+            {
+                code: EthersError.NONCE_EXPIRED,
+                message: 'nonce has already been used',
+            },
+            {
+                code: EthersError.REPLACEMENT_UNDERPRICED,
+                message: 'replacement transaction underpriced',
+            },
+            {
+                code: EthersError.TRANSACTION_REPLACED,
+                message: 'transaction was replaced',
+            },
+        ];
+        blockchainErrorTestCases.forEach(({ code, message }) => {
+            it(`throws BlockchainError with isRecoverable=false for ${code}`, () => {
+                const error = new ProviderError(message, code);
+                const CombinedError = provider.testGetCombinedProviderError([error], 'Test fallback message');
+                const e = new CombinedError();
+                expect(e).to.be.instanceOf(BlockchainError);
+                expect(e.isRecoverable).to.equal(false);
+                expect(e.message).to.equal(message);
+                expect(e.cause).to.equal(error);
+                expect(e.cause.code).to.equal(code);
+            });
+        });
+        it('throws regular Error for SERVER_ERROR (not BlockchainError)', () => {
+            const error = new ProviderError('connection refused', EthersError.SERVER_ERROR);
+            const CombinedError = provider.testGetCombinedProviderError([error], 'Test fallback message');
+            const e = new CombinedError();
+            expect(e).to.be.instanceOf(Error);
+            expect(e).to.not.be.instanceOf(BlockchainError);
+            expect(e.isRecoverable).to.be.undefined;
+            expect(e.cause).to.equal(error);
+            expect(e.cause.code).to.equal(EthersError.SERVER_ERROR);
+        });
+        it('throws regular Error for TIMEOUT (not BlockchainError)', () => {
+            const error = { status: ProviderStatus.Timeout };
+            const CombinedError = provider.testGetCombinedProviderError([error], 'Test fallback message');
+            const e = new CombinedError();
+            expect(e).to.be.instanceOf(Error);
+            expect(e).to.not.be.instanceOf(BlockchainError);
+            expect(e.isRecoverable).to.be.undefined;
+            expect(e.cause).to.equal(error);
+        });
+        const mixedErrorTestCases = [
+            {
+                name: 'SERVER_ERROR',
+                errors: () => [
+                    new ProviderError('connection refused', EthersError.SERVER_ERROR),
+                    new ProviderError('execution reverted', EthersError.CALL_EXCEPTION),
+                ],
+                expectedMessage: 'execution reverted',
+            },
+            {
+                name: 'TIMEOUT',
+                errors: () => [
+                    { status: ProviderStatus.Timeout },
+                    new ProviderError('insufficient funds', EthersError.INSUFFICIENT_FUNDS),
+                ],
+                expectedMessage: 'insufficient funds',
+            },
+        ];
+        mixedErrorTestCases.forEach(({ name, errors, expectedMessage }) => {
+            it(`prioritizes BlockchainError when mixed with ${name}`, () => {
+                const [firstError, secondError] = errors();
+                const CombinedError = provider.testGetCombinedProviderError([firstError, secondError], 'Test fallback message');
+                const e = new CombinedError();
+                expect(e).to.be.instanceOf(BlockchainError);
+                expect(e.isRecoverable).to.equal(false);
+                expect(e.message).to.equal(expectedMessage);
+                expect(e.cause).to.equal(secondError);
+            });
+        });
+    });
+    describe('performWithFallback', () => {
+        it('returns success from first provider, second provider not called', async () => {
+            const provider1 = MockProvider.success('success1');
+            const provider2 = MockProvider.success('success2');
+            const provider = new TestableSmartProvider([provider1, provider2]);
+            const result = await provider.simplePerform('getBlockNumber', 1);
+            expect(result).to.deep.equal('success1');
+            expect(provider1.called).to.be.true;
+            expect(provider2.called).to.be.false;
+        });
+        it('calls second provider when first throws server error, returns success from second', async () => {
+            const serverError = new ProviderError('connection refused', EthersError.SERVER_ERROR);
+            const provider1 = MockProvider.error(serverError);
+            const provider2 = MockProvider.success('success2');
+            const provider = new TestableSmartProvider([provider1, provider2]);
+            const result = await provider.simplePerform('getBlockNumber', 1);
+            expect(result).to.deep.equal('success2');
+            expect(provider1.called).to.be.true;
+            expect(provider1.thrownError).to.equal(serverError);
+            expect(provider2.called).to.be.true;
+        });
+        it('calls second provider when first times out, returns success from second', async () => {
+            const provider1 = MockProvider.success('success1', 100);
+            const provider2 = MockProvider.success('success2');
+            const provider = new TestableSmartProvider([provider1, provider2]);
+            const result = await provider.simplePerform('getBlockNumber', 1);
+            expect(result).to.deep.equal('success2');
+            expect(provider1.called).to.be.true;
+            expect(provider2.called).to.be.true;
+        });
+        it('both providers timeout, first provider ultimately returns result (waitForProviderSuccess)', async () => {
+            const provider1 = MockProvider.success('success1', 120); // 120ms delay
+            const provider2 = MockProvider.success('success2', 200); // 200ms delay
+            const provider = new TestableSmartProvider([provider1, provider2]);
+            const result = await provider.simplePerform('getBlockNumber', 1);
+            expect(result).to.deep.equal('success1');
+            expect(provider1.called).to.be.true;
+            expect(provider2.called).to.be.true;
+        });
+        it('both providers throw errors, combined error is thrown', async () => {
+            const serverError1 = new ProviderError('connection refused 1', EthersError.SERVER_ERROR);
+            const serverError2 = new ProviderError('connection refused 2', EthersError.SERVER_ERROR);
+            const provider1 = MockProvider.error(serverError1);
+            const provider2 = MockProvider.error(serverError2);
+            const provider = new TestableSmartProvider([provider1, provider2]);
+            try {
+                await provider.simplePerform('getBlockNumber', 1);
+                expect.fail('Should have thrown an error');
+            }
+            catch (e) {
+                expect(e).to.be.instanceOf(Error);
+                expect(e).to.not.be.instanceOf(BlockchainError);
+                expect(e.isRecoverable).to.be.undefined;
+                expect(e.cause).to.equal(serverError1); // First error should be the cause
+                expect(provider1.called).to.be.true;
+                expect(provider1.thrownError).to.equal(serverError1);
+                expect(provider2.called).to.be.true;
+                expect(provider2.thrownError).to.equal(serverError2);
+            }
+        });
+        it('both providers timeout, combined timeout error is thrown', async () => {
+            const provider1 = MockProvider.success('success1', 2000);
+            const provider2 = MockProvider.success('success2', 2000);
+            const provider = new TestableSmartProvider([provider1, provider2]);
+            try {
+                await provider.simplePerform('getBlockNumber', 1);
+                expect.fail('Should have thrown an error');
+            }
+            catch (e) {
+                expect(e).to.be.instanceOf(Error);
+                expect(e).to.not.be.instanceOf(BlockchainError);
+                expect(e.isRecoverable).to.be.undefined;
+                expect(e.message).to.include('All providers timed out');
+                expect(provider1.called).to.be.true;
+                expect(provider2.called).to.be.true;
+            }
+        });
+        it('blockchain error stops trying additional providers immediately', async () => {
+            const blockchainError = new ProviderError('execution reverted', EthersError.CALL_EXCEPTION);
+            const provider1 = MockProvider.error(blockchainError);
+            const provider2 = MockProvider.success('success2');
+            const provider = new TestableSmartProvider([provider1, provider2]);
+            try {
+                await provider.simplePerform('getBlockNumber', 1);
+                expect.fail('Should have thrown an error');
+            }
+            catch (e) {
+                expect(e).to.be.instanceOf(BlockchainError);
+                expect(e.isRecoverable).to.equal(false);
+                expect(e.message).to.equal('execution reverted');
+                expect(e.cause).to.equal(blockchainError);
+                expect(provider1.called).to.be.true;
+                expect(provider1.thrownError).to.equal(blockchainError);
+                expect(provider2.called).to.be.false; // Key test - second provider should NOT be called
+            }
+        });
+        it('blockchain error takes priority over server error in actual flow', async () => {
+            const serverError = new ProviderError('connection refused', EthersError.SERVER_ERROR);
+            const blockchainError = new ProviderError('insufficient funds', EthersError.INSUFFICIENT_FUNDS);
+            const provider1 = MockProvider.error(serverError);
+            const provider2 = MockProvider.error(blockchainError);
+            const provider = new TestableSmartProvider([provider1, provider2]);
+            try {
+                await provider.simplePerform('getBlockNumber', 1);
+                expect.fail('Should have thrown an error');
+            }
+            catch (e) {
+                expect(e).to.be.instanceOf(BlockchainError); // Should get blockchain error, not server error
+                expect(e.isRecoverable).to.equal(false);
+                expect(e.message).to.equal('insufficient funds');
+                expect(e.cause).to.equal(blockchainError);
+                expect(provider1.called).to.be.true;
+                expect(provider1.thrownError).to.equal(serverError);
+                expect(provider2.called).to.be.true;
+                expect(provider2.thrownError).to.equal(blockchainError);
+            }
+        });
+    });
+});
+//# sourceMappingURL=SmartProvider.test.js.map

package/dist/providers/SmartProvider/SmartProvider.test.js.map

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

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

@@ -0,0 +1,61 @@
+import { ethers } from 'ethers';
+import { TurnkeyConfig } from '../turnkeyClient.js';
+/**
+ * Turnkey signer for EVM transactions
+ * Uses Turnkey's secure enclaves to sign transactions without exposing private keys
+ * This is a custom ethers v5-compatible Signer that uses Turnkey SDK directly
+ * Uses composition to access Turnkey functionality while extending ethers.Signer
+ *
+ * @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: '0x...', // Ethereum address
+ * };
+ *
+ * const provider = new ethers.providers.JsonRpcProvider('...');
+ * const signer = new TurnkeyEvmSigner(config, provider);
+ *
+ * // Use with MultiProvider
+ * multiProvider.setSigner('ethereum', signer);
+ * ```
+ */
+export declare class TurnkeyEvmSigner extends ethers.Signer {
+    private readonly manager;
+    readonly address: string;
+    readonly provider: ethers.providers.Provider | undefined;
+    constructor(config: TurnkeyConfig, provider?: ethers.providers.Provider);
+    /**
+     * Health check - delegates to manager
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Get an ethers Signer connected to the provided provider
+     * This returns a new instance with the provider connected
+     */
+    getSigner(provider: ethers.providers.Provider): Promise<ethers.Signer>;
+    /**
+     * Connect this signer to a provider (creates new instance with proper configuration)
+     */
+    connect(provider: ethers.providers.Provider): TurnkeyEvmSigner;
+    /**
+     * Get the address of this signer
+     */
+    getAddress(): Promise<string>;
+    /**
+     * Sign a transaction using Turnkey
+     */
+    signTransaction(transaction: ethers.providers.TransactionRequest): Promise<string>;
+    /**
+     * Sign a message using Turnkey
+     */
+    signMessage(message: string | ethers.utils.Bytes): Promise<string>;
+    /**
+     * Populate a transaction with default values (nonce, gas, etc.)
+     */
+    populateTransaction(transaction: ethers.providers.TransactionRequest): Promise<ethers.providers.TransactionRequest>;
+}
+//# sourceMappingURL=turnkey.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turnkey.d.ts","sourceRoot":"","sources":["../../../src/signers/evm/turnkey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAEL,aAAa,EAGd,MAAM,qBAAqB,CAAC;AAI7B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,gBAAiB,SAAQ,MAAM,CAAC,MAAM;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC;gBAEpD,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ;IASvE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;;OAGG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;IAK5E;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GAAG,gBAAgB;IAI9D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC;;OAEG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,kBAAkB,GAC/C,OAAO,CAAC,MAAM,CAAC;IA0DlB;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IA6CxE;;OAEG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,kBAAkB,GAC/C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC;CA4ChD"}

package/dist/signers/evm/turnkey.js

@@ -0,0 +1,190 @@
+import { ethers } from 'ethers';
+import { rootLogger } from '@hyperlane-xyz/utils';
+import { TurnkeyClientManager, logTurnkeyError, validateTurnkeyActivityCompleted, } from '../turnkeyClient.js';
+const logger = rootLogger.child({ module: 'sdk:turnkey-evm' });
+/**
+ * Turnkey signer for EVM transactions
+ * Uses Turnkey's secure enclaves to sign transactions without exposing private keys
+ * This is a custom ethers v5-compatible Signer that uses Turnkey SDK directly
+ * Uses composition to access Turnkey functionality while extending ethers.Signer
+ *
+ * @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: '0x...', // Ethereum address
+ * };
+ *
+ * const provider = new ethers.providers.JsonRpcProvider('...');
+ * const signer = new TurnkeyEvmSigner(config, provider);
+ *
+ * // Use with MultiProvider
+ * multiProvider.setSigner('ethereum', signer);
+ * ```
+ */
+export class TurnkeyEvmSigner extends ethers.Signer {
+    manager;
+    address;
+    provider;
+    constructor(config, provider) {
+        super();
+        this.manager = new TurnkeyClientManager(config);
+        this.address = config.publicKey;
+        this.provider = provider;
+        logger.debug(`Initialized Turnkey EVM signer for key: ${this.address}`);
+    }
+    /**
+     * Health check - delegates to manager
+     */
+    async healthCheck() {
+        return this.manager.healthCheck();
+    }
+    /**
+     * Get an ethers Signer connected to the provided provider
+     * This returns a new instance with the provider connected
+     */
+    async getSigner(provider) {
+        logger.debug('Creating Turnkey EVM signer for transaction');
+        return this.connect(provider);
+    }
+    /**
+     * Connect this signer to a provider (creates new instance with proper configuration)
+     */
+    connect(provider) {
+        return new TurnkeyEvmSigner(this.manager.getConfig(), provider);
+    }
+    /**
+     * Get the address of this signer
+     */
+    async getAddress() {
+        return this.address;
+    }
+    /**
+     * Sign a transaction using Turnkey
+     */
+    async signTransaction(transaction) {
+        if (!this.provider) {
+            throw new Error('Provider required to sign transaction');
+        }
+        logger.debug('Signing transaction with Turnkey', {
+            to: transaction.to,
+            value: transaction.value?.toString(),
+        });
+        try {
+            // Populate the transaction (fill in nonce, gasPrice, etc.)
+            const populatedTx = await ethers.utils.resolveProperties(await this.populateTransaction(transaction));
+            // Remove 'from' field for serialization
+            const { from: _, ...txToSerialize } = populatedTx;
+            // For EIP-1559 transactions, explicitly set type: 2 and remove gasPrice
+            if (txToSerialize.maxFeePerGas || txToSerialize.maxPriorityFeePerGas) {
+                txToSerialize.type = 2;
+                delete txToSerialize.gasPrice;
+            }
+            const unsignedTx = ethers.utils.serializeTransaction(txToSerialize);
+            // Remove 0x prefix for Turnkey API (it expects raw hex)
+            const unsignedTxHex = unsignedTx.startsWith('0x')
+                ? unsignedTx.slice(2)
+                : unsignedTx;
+            // Sign using Turnkey's signTransaction API
+            const { activity } = await this.manager.getClient().signTransaction({
+                signWith: this.address,
+                type: 'TRANSACTION_TYPE_ETHEREUM',
+                unsignedTransaction: unsignedTxHex,
+            });
+            validateTurnkeyActivityCompleted(activity, 'Transaction signing');
+            const signedTx = activity.result?.signTransactionResult?.signedTransaction;
+            if (!signedTx) {
+                throw new Error('No signed transaction returned from Turnkey');
+            }
+            logger.debug('Transaction signed successfully');
+            // Ensure the signed transaction has 0x prefix
+            return signedTx.startsWith('0x') ? signedTx : `0x${signedTx}`;
+        }
+        catch (error) {
+            logTurnkeyError('Failed to sign transaction with Turnkey', error);
+            throw error;
+        }
+    }
+    /**
+     * Sign a message using Turnkey
+     */
+    async signMessage(message) {
+        logger.debug('Signing message with Turnkey');
+        try {
+            const messageBytes = typeof message === 'string'
+                ? ethers.utils.toUtf8Bytes(message)
+                : message;
+            const messageHash = ethers.utils.hashMessage(messageBytes);
+            // Sign raw payload using Turnkey
+            const { activity, r, s, v } = await this.manager
+                .getClient()
+                .signRawPayload({
+                signWith: this.address,
+                payload: messageHash.slice(2), // Remove 0x prefix
+                encoding: 'PAYLOAD_ENCODING_HEXADECIMAL',
+                hashFunction: 'HASH_FUNCTION_NO_OP',
+            });
+            validateTurnkeyActivityCompleted(activity, 'Message signing');
+            // Validate signature components
+            if (!r || !s || !v) {
+                throw new Error('Missing signature components from Turnkey');
+            }
+            const hexPattern = /^0x[0-9a-fA-F]+$/;
+            if (!hexPattern.test(r) || !hexPattern.test(s)) {
+                throw new Error('Invalid signature format from Turnkey');
+            }
+            const vNum = parseInt(v, 16);
+            if (isNaN(vNum)) {
+                throw new Error(`Invalid v value from Turnkey: ${v}`);
+            }
+            // Reconstruct the signature from r, s, v
+            return ethers.utils.joinSignature({ r, s, v: vNum });
+        }
+        catch (error) {
+            logTurnkeyError('Failed to sign message with Turnkey', error);
+            throw error;
+        }
+    }
+    /**
+     * Populate a transaction with default values (nonce, gas, etc.)
+     */
+    async populateTransaction(transaction) {
+        if (!this.provider) {
+            throw new Error('Provider required to populate transaction');
+        }
+        const tx = { ...transaction };
+        // Set from address
+        if (!tx.from) {
+            tx.from = this.address;
+        }
+        // Get nonce if not set
+        if (tx.nonce == null) {
+            tx.nonce = await this.provider.getTransactionCount(this.address, 'pending');
+        }
+        // Get gas price if not set
+        if (tx.gasPrice == null && tx.maxFeePerGas == null) {
+            const feeData = await this.provider.getFeeData();
+            if (feeData.maxFeePerGas) {
+                tx.maxFeePerGas = feeData.maxFeePerGas;
+                tx.maxPriorityFeePerGas = feeData.maxPriorityFeePerGas || undefined;
+            }
+            else {
+                tx.gasPrice = feeData.gasPrice || undefined;
+            }
+        }
+        // Get chain ID if not set
+        if (tx.chainId == null) {
+            const network = await this.provider.getNetwork();
+            tx.chainId = network.chainId;
+        }
+        // Estimate gas if not set
+        if (tx.gasLimit == null) {
+            tx.gasLimit = await this.provider.estimateGas(tx);
+        }
+        return tx;
+    }
+}
+//# sourceMappingURL=turnkey.js.map

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

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

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

@@ -0,0 +1,49 @@
+import { PublicKey, Transaction } 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(transaction: Transaction): Promise<Transaction>;
+}
+//# 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,MAAM,iBAAiB,CAAC;AAKzD,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;gBAEzB,MAAM,EAAE,aAAa;IAejC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;OAIG;IACG,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;CAsBtE"}