@dynamic-labs-wallet/node-svm 1.1.51 → 1.1.53

package/index.cjs

@@ -84,6 +84,29 @@ function decodeBase58(str) {
     return out;
 }
 
+function _object_without_properties_loose(source, excluded) {
+    if (source == null) return {};
+    var target = {};
+    var sourceKeys = Object.keys(source);
+    var key, i;
+    for(i = 0; i < sourceKeys.length; i++){
+        key = sourceKeys[i];
+        if (excluded.indexOf(key) >= 0) continue;
+        target[key] = source[key];
+    }
+    return target;
+}
+
+const ERROR_EARN_NOT_SVM_WALLET = 'Wallet metadata is not for an SVM wallet';
+const ERROR_EARN_MISSING_TRANSACTIONS = 'Earn signing payload is missing the Solana transaction sequence';
+const ERROR_EARN_NON_CONTIGUOUS_ORDINALS = 'Earn signing payload transaction ordinals must be contiguous from zero';
+/** Default RPC per Dynamic Solana chain id (101 mainnet, 103 devnet); `rpcUrl` overrides. */ const EARN_SOLANA_RPC_BY_CHAIN_ID = {
+    '101': 'https://api.mainnet-beta.solana.com',
+    '103': 'https://api.devnet.solana.com'
+};
+/** Blockhash checks run at `processed`, the commitment that sees new blockhashes first. */ const EARN_SOLANA_BLOCKHASH_COMMITMENT = 'processed';
+const EARN_CONFIRMATION_POLL_INTERVAL_MS = 1000;
+
 async function getBalance({ address, rpcUrl = node.SOLANA_RPC_URL }) {
     const connection = new web3_js.Connection(rpcUrl != null ? rpcUrl : 'https://api.devnet.solana.com');
     const balance = await connection.getBalance(new web3_js.PublicKey(address));
@@ -132,6 +155,300 @@ async function sendTransaction({ signedTransaction, rpcUrl = 'https://api.devnet
     return txid;
 }
 
+/**
+ * A transaction in the sequence could not land. Transactions before `ordinal` already
+ * confirmed on-chain, so the action may be partially applied.
+ */ class EarnSolanaStepError extends Error {
+    constructor({ cause, code, ordinal, reason, signature, total }){
+        const message = `Transaction ${ordinal + 1} of ${total} ${reason}.`;
+        const confirmed = ordinal === 1 ? 'transaction' : `${ordinal} transactions`;
+        super(ordinal === 0 ? message : `${message} The earlier ${confirmed} already confirmed on-chain, so the action is partially applied; check your position before retrying.`, {
+            cause
+        });
+        this.name = 'EarnSolanaStepError';
+        this.code = code;
+        this.ordinal = ordinal;
+        this.signature = signature;
+    }
+}
+// Versioned transactions are marked by the high bit on the first message byte after the
+// signatures; legacy transactions start the message header there instead.
+const deserializeEarnTransaction = (payload)=>{
+    const bytes = new Uint8Array(Buffer.from(payload, 'base64'));
+    var _bytes_;
+    const signatureCount = (_bytes_ = bytes[0]) != null ? _bytes_ : 0;
+    var _bytes_1;
+    const firstMessageByte = (_bytes_1 = bytes[1 + signatureCount * 64]) != null ? _bytes_1 : 0;
+    return (firstMessageByte & 0x80) !== 0 ? web3_js.VersionedTransaction.deserialize(bytes) : web3_js.Transaction.from(bytes);
+};
+const isStepExpired = async ({ connection, expiryBlockHeight, transaction })=>{
+    if (expiryBlockHeight !== undefined) {
+        return await connection.getBlockHeight('confirmed') > expiryBlockHeight;
+    }
+    const recentBlockhash = transaction instanceof web3_js.VersionedTransaction ? transaction.message.recentBlockhash : transaction.recentBlockhash;
+    // A transaction with no blockhash cannot be judged; the network rejects it on send anyway.
+    if (!recentBlockhash) {
+        return false;
+    }
+    const { value: isBlockhashValid } = await connection.isBlockhashValid(recentBlockhash, {
+        commitment: EARN_SOLANA_BLOCKHASH_COMMITMENT
+    });
+    return !isBlockhashValid;
+};
+// Polls over HTTP rather than a websocket subscription, which some RPC providers refuse.
+const waitForConfirmation = async ({ connection, isExpired, signature })=>{
+    const hasExpired = await isExpired();
+    // A missing status only means "never landed" once the blockhash lapsed, so the
+    // lookup then needs the full transaction history rather than the recent cache.
+    const { value: [status] } = await connection.getSignatureStatuses([
+        signature
+    ], {
+        searchTransactionHistory: hasExpired
+    });
+    if (status == null ? void 0 : status.err) {
+        return {
+            error: status.err,
+            outcome: 'failed'
+        };
+    }
+    if ((status == null ? void 0 : status.confirmationStatus) === 'confirmed' || (status == null ? void 0 : status.confirmationStatus) === 'finalized') {
+        return {
+            outcome: 'confirmed'
+        };
+    }
+    if (hasExpired && !status) {
+        return {
+            outcome: 'expired'
+        };
+    }
+    await new Promise((resolve)=>{
+        setTimeout(resolve, EARN_CONFIRMATION_POLL_INTERVAL_MS);
+    });
+    return waitForConfirmation({
+        connection,
+        isExpired,
+        signature
+    });
+};
+const serializeSigned = (transaction)=>Buffer.from(transaction instanceof web3_js.VersionedTransaction ? transaction.serialize() : transaction.serialize({
+        verifySignatures: false
+    }));
+// The transaction id is its first (fee payer) signature — for sponsored steps that is
+// the sponsor's, not the wallet's — so the send result, not the signature
+// `signTransaction` returned, is what must be confirmed.
+const signAndSendStep = async ({ chainId, connection, context, externalServerKeyShares, ordinal, password, signTransaction, sponsored, total, transaction, walletMetadata })=>{
+    try {
+        const result = await signTransaction({
+            walletMetadata,
+            transaction,
+            password,
+            externalServerKeyShares,
+            sponsor: sponsored != null ? sponsored : false,
+            chainId,
+            context
+        });
+        const signedTransaction = typeof result === 'string' ? attachSignature({
+            transaction,
+            signatureBase58: result,
+            senderAddress: walletMetadata.accountAddress
+        }) : result.transaction;
+        return await connection.sendRawTransaction(serializeSigned(signedTransaction), {
+            preflightCommitment: EARN_SOLANA_BLOCKHASH_COMMITMENT
+        });
+    } catch (error) {
+        throw new EarnSolanaStepError({
+            cause: error instanceof Error ? error : undefined,
+            code: 'yield_step_send_failed',
+            ordinal,
+            reason: 'could not be signed or sent',
+            total
+        });
+    }
+};
+/**
+ * Builds a stateless Earn client for Solana vaults: it prepares vault actions through the
+ * Dynamic API and executes the returned ordered transaction sequence one transaction at a
+ * time — never in parallel, because a later transaction can depend on the state an earlier
+ * one wrote. If one fails, the sequence stops and the thrown {@link EarnSolanaStepError}
+ * reports how much of the action already landed.
+ *
+ * Gas sponsorship is opt-in (`sponsored: true`): vault transactions are built with the
+ * owner as fee payer, unlike the browser SDK which sponsors automatically.
+ */ const createSvmEarnClient = ({ getEarnClient, signTransaction })=>{
+    const executeStep = async ({ connection, context, externalServerKeyShares, chainId, onStepChange, onTransactionStepChange, password, sponsored, step, total, walletMetadata })=>{
+        const transaction = deserializeEarnTransaction(step.payload);
+        const { ordinal } = step;
+        const isExpired = ()=>isStepExpired({
+                connection,
+                expiryBlockHeight: step.expiryBlockHeight,
+                transaction
+            });
+        // The blockhash was fixed when the payload was built, so earlier slow steps can
+        // leave later ones unsendable — check before spending a signature.
+        if (await isExpired()) {
+            throw new EarnSolanaStepError({
+                code: 'yield_step_expired',
+                ordinal,
+                reason: 'expired before it could be signed',
+                total
+            });
+        }
+        onStepChange == null ? void 0 : onStepChange('transaction');
+        const progress = {
+            ordinal,
+            total
+        };
+        if (step.label !== undefined) {
+            progress.label = step.label;
+        }
+        onTransactionStepChange == null ? void 0 : onTransactionStepChange(progress);
+        const signature = await signAndSendStep({
+            chainId,
+            connection,
+            context,
+            externalServerKeyShares,
+            ordinal,
+            password,
+            signTransaction,
+            sponsored,
+            total,
+            transaction,
+            walletMetadata
+        });
+        // A sent transaction may still land even when the poll itself fails, so wrap any RPC
+        // error and keep the send signature on it for reconciliation.
+        let confirmation;
+        try {
+            confirmation = await waitForConfirmation({
+                connection,
+                isExpired,
+                signature
+            });
+        } catch (error) {
+            throw new EarnSolanaStepError({
+                cause: error instanceof Error ? error : undefined,
+                code: 'yield_step_confirmation_unknown',
+                ordinal,
+                reason: 'was sent but its confirmation could not be checked',
+                signature,
+                total
+            });
+        }
+        if (confirmation.outcome === 'failed') {
+            throw new EarnSolanaStepError({
+                code: 'yield_step_failed',
+                ordinal,
+                reason: `failed on-chain: ${JSON.stringify(confirmation.error)}`,
+                signature,
+                total
+            });
+        }
+        if (confirmation.outcome === 'expired') {
+            throw new EarnSolanaStepError({
+                code: 'yield_step_expired',
+                ordinal,
+                reason: 'was not confirmed before its blockhash expired',
+                signature,
+                total
+            });
+        }
+        return signature;
+    };
+    const executeEarnTransaction = async ({ signingPayload, walletMetadata, password, externalServerKeyShares, sponsored, rpcUrl, chainId, context, onStepChange, onTransactionStepChange })=>{
+        if (walletMetadata.chainName !== 'SVM') {
+            throw new Error(ERROR_EARN_NOT_SVM_WALLET);
+        }
+        if (!walletMetadata.accountAddress) {
+            throw new Error('Account address is required');
+        }
+        var _signingPayload_transactions;
+        const steps = [
+            ...(_signingPayload_transactions = signingPayload.transactions) != null ? _signingPayload_transactions : []
+        ].sort((first, second)=>first.ordinal - second.ordinal);
+        if (steps.length === 0) {
+            throw new Error(ERROR_EARN_MISSING_TRANSACTIONS);
+        }
+        if (steps.some((step, index)=>step.ordinal !== index)) {
+            throw new Error(ERROR_EARN_NON_CONTIGUOUS_ORDINALS);
+        }
+        var _ref;
+        const connection = new web3_js.Connection((_ref = rpcUrl != null ? rpcUrl : EARN_SOLANA_RPC_BY_CHAIN_ID[chainId != null ? chainId : signingPayload.chainId]) != null ? _ref : node.SOLANA_RPC_URL);
+        // A rejection stops the sequence at the first failure; everything after it is skipped.
+        const transactionHash = await steps.reduce(async (previousStep, step)=>{
+            await previousStep;
+            return executeStep({
+                connection,
+                context,
+                externalServerKeyShares,
+                chainId: chainId != null ? chainId : signingPayload.chainId,
+                onStepChange,
+                onTransactionStepChange,
+                password,
+                sponsored,
+                step,
+                total: steps.length,
+                walletMetadata
+            });
+        }, Promise.resolve(''));
+        return {
+            transactionHash
+        };
+    };
+    return {
+        executeEarnTransaction,
+        depositToEarnVault: async (_param)=>{
+            var { vaultId, amount, receiverAddress, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+                "vaultId",
+                "amount",
+                "receiverAddress",
+                "traceContext"
+            ]);
+            const signingPayload = await getEarnClient().prepareDeposit({
+                vaultId,
+                ownerAddress: walletParams.walletMetadata.accountAddress,
+                amount,
+                receiverAddress,
+                traceContext
+            });
+            return executeEarnTransaction(_extends({
+                signingPayload
+            }, walletParams));
+        },
+        withdrawFromEarnVault: async (_param)=>{
+            var { vaultId, amount, receiverAddress, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+                "vaultId",
+                "amount",
+                "receiverAddress",
+                "traceContext"
+            ]);
+            const signingPayload = await getEarnClient().prepareWithdrawal({
+                vaultId,
+                ownerAddress: walletParams.walletMetadata.accountAddress,
+                amount,
+                receiverAddress,
+                traceContext
+            });
+            return executeEarnTransaction(_extends({
+                signingPayload
+            }, walletParams));
+        },
+        claimEarnRewards: async (_param)=>{
+            var { vaultId, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+                "vaultId",
+                "traceContext"
+            ]);
+            const signingPayload = await getEarnClient().prepareClaimRewards({
+                vaultId,
+                ownerAddress: walletParams.walletMetadata.accountAddress,
+                traceContext
+            });
+            return executeEarnTransaction(_extends({
+                signingPayload
+            }, walletParams));
+        }
+    };
+};
+
 const logError$1 = node.createLogError('node-svm');
 // Helper: normalize bytes to hex without triggering Buffer.from(string, encoding) overload
 const toHex = (bytes)=>(Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes)).toString('hex');
@@ -563,6 +880,30 @@ class DynamicSvmWalletClient extends node.DynamicWalletClient {
         const svmWallets = wallets.filter((wallet)=>wallet.chainName === 'SVM');
         return svmWallets;
     }
+    // ---------------------------------------------------------------------------
+    // Earn (yield vaults)
+    // ---------------------------------------------------------------------------
+    get svmEarn() {
+        return createSvmEarnClient({
+            getEarnClient: ()=>this.earn,
+            signTransaction: (args)=>this.signTransaction(args)
+        });
+    }
+    /**
+   * Executes an Earn signing payload returned by the prepare* methods, signing and
+   * sending its ordered Solana transaction sequence one transaction at a time.
+   */ async executeEarnTransaction(params) {
+        return this.svmEarn.executeEarnTransaction(params);
+    }
+    /** Prepares and executes a deposit into an Earn vault. */ async depositToEarnVault(params) {
+        return this.svmEarn.depositToEarnVault(params);
+    }
+    /** Prepares and executes a withdrawal from an Earn vault. */ async withdrawFromEarnVault(params) {
+        return this.svmEarn.withdrawFromEarnVault(params);
+    }
+    /** Prepares and executes a claim of accrued Earn vault rewards. */ async claimEarnRewards(params) {
+        return this.svmEarn.claimEarnRewards(params);
+    }
     constructor({ environmentId, baseApiUrl, baseMPCRelayApiUrl, enableMPCAccelerator, logger, debug }){
         super({
             environmentId,
@@ -883,10 +1224,12 @@ exports.ERROR_DELEGATED_SIGN_TRANSACTION_CONTEXT_REQUIRED = ERROR_DELEGATED_SIGN
 exports.ERROR_SIGN_RAW_MESSAGE = ERROR_SIGN_RAW_MESSAGE;
 exports.ERROR_SIGN_TRANSACTION_CONTEXT_REQUIRED = ERROR_SIGN_TRANSACTION_CONTEXT_REQUIRED;
 exports.ERROR_SIGN_TRANSACTION_RAW_HEX_CONTEXT_REQUIRED = ERROR_SIGN_TRANSACTION_RAW_HEX_CONTEXT_REQUIRED;
+exports.EarnSolanaStepError = EarnSolanaStepError;
 exports.addSignatureToTransaction = addSignatureToTransaction;
 exports.attachSignature = attachSignature;
 exports.createDelegatedSvmWalletClient = createDelegatedSvmWalletClient;
 exports.createSolanaTransaction = createSolanaTransaction;
+exports.createSvmEarnClient = createSvmEarnClient;
 exports.decodeBase58 = decodeBase58;
 exports.delegatedSignMessage = delegatedSignMessage;
 exports.delegatedSignRawMessage = delegatedSignRawMessage;

package/index.esm.js

@@ -82,6 +82,29 @@ function decodeBase58(str) {
     return out;
 }
 
+function _object_without_properties_loose(source, excluded) {
+    if (source == null) return {};
+    var target = {};
+    var sourceKeys = Object.keys(source);
+    var key, i;
+    for(i = 0; i < sourceKeys.length; i++){
+        key = sourceKeys[i];
+        if (excluded.indexOf(key) >= 0) continue;
+        target[key] = source[key];
+    }
+    return target;
+}
+
+const ERROR_EARN_NOT_SVM_WALLET = 'Wallet metadata is not for an SVM wallet';
+const ERROR_EARN_MISSING_TRANSACTIONS = 'Earn signing payload is missing the Solana transaction sequence';
+const ERROR_EARN_NON_CONTIGUOUS_ORDINALS = 'Earn signing payload transaction ordinals must be contiguous from zero';
+/** Default RPC per Dynamic Solana chain id (101 mainnet, 103 devnet); `rpcUrl` overrides. */ const EARN_SOLANA_RPC_BY_CHAIN_ID = {
+    '101': 'https://api.mainnet-beta.solana.com',
+    '103': 'https://api.devnet.solana.com'
+};
+/** Blockhash checks run at `processed`, the commitment that sees new blockhashes first. */ const EARN_SOLANA_BLOCKHASH_COMMITMENT = 'processed';
+const EARN_CONFIRMATION_POLL_INTERVAL_MS = 1000;
+
 async function getBalance({ address, rpcUrl = SOLANA_RPC_URL }) {
     const connection = new Connection(rpcUrl != null ? rpcUrl : 'https://api.devnet.solana.com');
     const balance = await connection.getBalance(new PublicKey(address));
@@ -130,6 +153,300 @@ async function sendTransaction({ signedTransaction, rpcUrl = 'https://api.devnet
     return txid;
 }
 
+/**
+ * A transaction in the sequence could not land. Transactions before `ordinal` already
+ * confirmed on-chain, so the action may be partially applied.
+ */ class EarnSolanaStepError extends Error {
+    constructor({ cause, code, ordinal, reason, signature, total }){
+        const message = `Transaction ${ordinal + 1} of ${total} ${reason}.`;
+        const confirmed = ordinal === 1 ? 'transaction' : `${ordinal} transactions`;
+        super(ordinal === 0 ? message : `${message} The earlier ${confirmed} already confirmed on-chain, so the action is partially applied; check your position before retrying.`, {
+            cause
+        });
+        this.name = 'EarnSolanaStepError';
+        this.code = code;
+        this.ordinal = ordinal;
+        this.signature = signature;
+    }
+}
+// Versioned transactions are marked by the high bit on the first message byte after the
+// signatures; legacy transactions start the message header there instead.
+const deserializeEarnTransaction = (payload)=>{
+    const bytes = new Uint8Array(Buffer.from(payload, 'base64'));
+    var _bytes_;
+    const signatureCount = (_bytes_ = bytes[0]) != null ? _bytes_ : 0;
+    var _bytes_1;
+    const firstMessageByte = (_bytes_1 = bytes[1 + signatureCount * 64]) != null ? _bytes_1 : 0;
+    return (firstMessageByte & 0x80) !== 0 ? VersionedTransaction.deserialize(bytes) : Transaction.from(bytes);
+};
+const isStepExpired = async ({ connection, expiryBlockHeight, transaction })=>{
+    if (expiryBlockHeight !== undefined) {
+        return await connection.getBlockHeight('confirmed') > expiryBlockHeight;
+    }
+    const recentBlockhash = transaction instanceof VersionedTransaction ? transaction.message.recentBlockhash : transaction.recentBlockhash;
+    // A transaction with no blockhash cannot be judged; the network rejects it on send anyway.
+    if (!recentBlockhash) {
+        return false;
+    }
+    const { value: isBlockhashValid } = await connection.isBlockhashValid(recentBlockhash, {
+        commitment: EARN_SOLANA_BLOCKHASH_COMMITMENT
+    });
+    return !isBlockhashValid;
+};
+// Polls over HTTP rather than a websocket subscription, which some RPC providers refuse.
+const waitForConfirmation = async ({ connection, isExpired, signature })=>{
+    const hasExpired = await isExpired();
+    // A missing status only means "never landed" once the blockhash lapsed, so the
+    // lookup then needs the full transaction history rather than the recent cache.
+    const { value: [status] } = await connection.getSignatureStatuses([
+        signature
+    ], {
+        searchTransactionHistory: hasExpired
+    });
+    if (status == null ? void 0 : status.err) {
+        return {
+            error: status.err,
+            outcome: 'failed'
+        };
+    }
+    if ((status == null ? void 0 : status.confirmationStatus) === 'confirmed' || (status == null ? void 0 : status.confirmationStatus) === 'finalized') {
+        return {
+            outcome: 'confirmed'
+        };
+    }
+    if (hasExpired && !status) {
+        return {
+            outcome: 'expired'
+        };
+    }
+    await new Promise((resolve)=>{
+        setTimeout(resolve, EARN_CONFIRMATION_POLL_INTERVAL_MS);
+    });
+    return waitForConfirmation({
+        connection,
+        isExpired,
+        signature
+    });
+};
+const serializeSigned = (transaction)=>Buffer.from(transaction instanceof VersionedTransaction ? transaction.serialize() : transaction.serialize({
+        verifySignatures: false
+    }));
+// The transaction id is its first (fee payer) signature — for sponsored steps that is
+// the sponsor's, not the wallet's — so the send result, not the signature
+// `signTransaction` returned, is what must be confirmed.
+const signAndSendStep = async ({ chainId, connection, context, externalServerKeyShares, ordinal, password, signTransaction, sponsored, total, transaction, walletMetadata })=>{
+    try {
+        const result = await signTransaction({
+            walletMetadata,
+            transaction,
+            password,
+            externalServerKeyShares,
+            sponsor: sponsored != null ? sponsored : false,
+            chainId,
+            context
+        });
+        const signedTransaction = typeof result === 'string' ? attachSignature({
+            transaction,
+            signatureBase58: result,
+            senderAddress: walletMetadata.accountAddress
+        }) : result.transaction;
+        return await connection.sendRawTransaction(serializeSigned(signedTransaction), {
+            preflightCommitment: EARN_SOLANA_BLOCKHASH_COMMITMENT
+        });
+    } catch (error) {
+        throw new EarnSolanaStepError({
+            cause: error instanceof Error ? error : undefined,
+            code: 'yield_step_send_failed',
+            ordinal,
+            reason: 'could not be signed or sent',
+            total
+        });
+    }
+};
+/**
+ * Builds a stateless Earn client for Solana vaults: it prepares vault actions through the
+ * Dynamic API and executes the returned ordered transaction sequence one transaction at a
+ * time — never in parallel, because a later transaction can depend on the state an earlier
+ * one wrote. If one fails, the sequence stops and the thrown {@link EarnSolanaStepError}
+ * reports how much of the action already landed.
+ *
+ * Gas sponsorship is opt-in (`sponsored: true`): vault transactions are built with the
+ * owner as fee payer, unlike the browser SDK which sponsors automatically.
+ */ const createSvmEarnClient = ({ getEarnClient, signTransaction })=>{
+    const executeStep = async ({ connection, context, externalServerKeyShares, chainId, onStepChange, onTransactionStepChange, password, sponsored, step, total, walletMetadata })=>{
+        const transaction = deserializeEarnTransaction(step.payload);
+        const { ordinal } = step;
+        const isExpired = ()=>isStepExpired({
+                connection,
+                expiryBlockHeight: step.expiryBlockHeight,
+                transaction
+            });
+        // The blockhash was fixed when the payload was built, so earlier slow steps can
+        // leave later ones unsendable — check before spending a signature.
+        if (await isExpired()) {
+            throw new EarnSolanaStepError({
+                code: 'yield_step_expired',
+                ordinal,
+                reason: 'expired before it could be signed',
+                total
+            });
+        }
+        onStepChange == null ? void 0 : onStepChange('transaction');
+        const progress = {
+            ordinal,
+            total
+        };
+        if (step.label !== undefined) {
+            progress.label = step.label;
+        }
+        onTransactionStepChange == null ? void 0 : onTransactionStepChange(progress);
+        const signature = await signAndSendStep({
+            chainId,
+            connection,
+            context,
+            externalServerKeyShares,
+            ordinal,
+            password,
+            signTransaction,
+            sponsored,
+            total,
+            transaction,
+            walletMetadata
+        });
+        // A sent transaction may still land even when the poll itself fails, so wrap any RPC
+        // error and keep the send signature on it for reconciliation.
+        let confirmation;
+        try {
+            confirmation = await waitForConfirmation({
+                connection,
+                isExpired,
+                signature
+            });
+        } catch (error) {
+            throw new EarnSolanaStepError({
+                cause: error instanceof Error ? error : undefined,
+                code: 'yield_step_confirmation_unknown',
+                ordinal,
+                reason: 'was sent but its confirmation could not be checked',
+                signature,
+                total
+            });
+        }
+        if (confirmation.outcome === 'failed') {
+            throw new EarnSolanaStepError({
+                code: 'yield_step_failed',
+                ordinal,
+                reason: `failed on-chain: ${JSON.stringify(confirmation.error)}`,
+                signature,
+                total
+            });
+        }
+        if (confirmation.outcome === 'expired') {
+            throw new EarnSolanaStepError({
+                code: 'yield_step_expired',
+                ordinal,
+                reason: 'was not confirmed before its blockhash expired',
+                signature,
+                total
+            });
+        }
+        return signature;
+    };
+    const executeEarnTransaction = async ({ signingPayload, walletMetadata, password, externalServerKeyShares, sponsored, rpcUrl, chainId, context, onStepChange, onTransactionStepChange })=>{
+        if (walletMetadata.chainName !== 'SVM') {
+            throw new Error(ERROR_EARN_NOT_SVM_WALLET);
+        }
+        if (!walletMetadata.accountAddress) {
+            throw new Error('Account address is required');
+        }
+        var _signingPayload_transactions;
+        const steps = [
+            ...(_signingPayload_transactions = signingPayload.transactions) != null ? _signingPayload_transactions : []
+        ].sort((first, second)=>first.ordinal - second.ordinal);
+        if (steps.length === 0) {
+            throw new Error(ERROR_EARN_MISSING_TRANSACTIONS);
+        }
+        if (steps.some((step, index)=>step.ordinal !== index)) {
+            throw new Error(ERROR_EARN_NON_CONTIGUOUS_ORDINALS);
+        }
+        var _ref;
+        const connection = new Connection((_ref = rpcUrl != null ? rpcUrl : EARN_SOLANA_RPC_BY_CHAIN_ID[chainId != null ? chainId : signingPayload.chainId]) != null ? _ref : SOLANA_RPC_URL);
+        // A rejection stops the sequence at the first failure; everything after it is skipped.
+        const transactionHash = await steps.reduce(async (previousStep, step)=>{
+            await previousStep;
+            return executeStep({
+                connection,
+                context,
+                externalServerKeyShares,
+                chainId: chainId != null ? chainId : signingPayload.chainId,
+                onStepChange,
+                onTransactionStepChange,
+                password,
+                sponsored,
+                step,
+                total: steps.length,
+                walletMetadata
+            });
+        }, Promise.resolve(''));
+        return {
+            transactionHash
+        };
+    };
+    return {
+        executeEarnTransaction,
+        depositToEarnVault: async (_param)=>{
+            var { vaultId, amount, receiverAddress, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+                "vaultId",
+                "amount",
+                "receiverAddress",
+                "traceContext"
+            ]);
+            const signingPayload = await getEarnClient().prepareDeposit({
+                vaultId,
+                ownerAddress: walletParams.walletMetadata.accountAddress,
+                amount,
+                receiverAddress,
+                traceContext
+            });
+            return executeEarnTransaction(_extends({
+                signingPayload
+            }, walletParams));
+        },
+        withdrawFromEarnVault: async (_param)=>{
+            var { vaultId, amount, receiverAddress, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+                "vaultId",
+                "amount",
+                "receiverAddress",
+                "traceContext"
+            ]);
+            const signingPayload = await getEarnClient().prepareWithdrawal({
+                vaultId,
+                ownerAddress: walletParams.walletMetadata.accountAddress,
+                amount,
+                receiverAddress,
+                traceContext
+            });
+            return executeEarnTransaction(_extends({
+                signingPayload
+            }, walletParams));
+        },
+        claimEarnRewards: async (_param)=>{
+            var { vaultId, traceContext } = _param, walletParams = _object_without_properties_loose(_param, [
+                "vaultId",
+                "traceContext"
+            ]);
+            const signingPayload = await getEarnClient().prepareClaimRewards({
+                vaultId,
+                ownerAddress: walletParams.walletMetadata.accountAddress,
+                traceContext
+            });
+            return executeEarnTransaction(_extends({
+                signingPayload
+            }, walletParams));
+        }
+    };
+};
+
 const logError$1 = createLogError('node-svm');
 // Helper: normalize bytes to hex without triggering Buffer.from(string, encoding) overload
 const toHex = (bytes)=>(Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes)).toString('hex');
@@ -561,6 +878,30 @@ class DynamicSvmWalletClient extends DynamicWalletClient {
         const svmWallets = wallets.filter((wallet)=>wallet.chainName === 'SVM');
         return svmWallets;
     }
+    // ---------------------------------------------------------------------------
+    // Earn (yield vaults)
+    // ---------------------------------------------------------------------------
+    get svmEarn() {
+        return createSvmEarnClient({
+            getEarnClient: ()=>this.earn,
+            signTransaction: (args)=>this.signTransaction(args)
+        });
+    }
+    /**
+   * Executes an Earn signing payload returned by the prepare* methods, signing and
+   * sending its ordered Solana transaction sequence one transaction at a time.
+   */ async executeEarnTransaction(params) {
+        return this.svmEarn.executeEarnTransaction(params);
+    }
+    /** Prepares and executes a deposit into an Earn vault. */ async depositToEarnVault(params) {
+        return this.svmEarn.depositToEarnVault(params);
+    }
+    /** Prepares and executes a withdrawal from an Earn vault. */ async withdrawFromEarnVault(params) {
+        return this.svmEarn.withdrawFromEarnVault(params);
+    }
+    /** Prepares and executes a claim of accrued Earn vault rewards. */ async claimEarnRewards(params) {
+        return this.svmEarn.claimEarnRewards(params);
+    }
     constructor({ environmentId, baseApiUrl, baseMPCRelayApiUrl, enableMPCAccelerator, logger, debug }){
         super({
             environmentId,
@@ -875,4 +1216,4 @@ const delegatedSignTransaction = async (client, { walletId, shareSetId, walletAp
     });
 };
 
-export { DynamicSvmWalletClient, ERROR_CREATE_WALLET_ACCOUNT, ERROR_DELEGATED_SIGN_TRANSACTION_CONTEXT_REQUIRED, ERROR_SIGN_RAW_MESSAGE, ERROR_SIGN_TRANSACTION_CONTEXT_REQUIRED, ERROR_SIGN_TRANSACTION_RAW_HEX_CONTEXT_REQUIRED, addSignatureToTransaction, attachSignature, createDelegatedSvmWalletClient, createSolanaTransaction, decodeBase58, delegatedSignMessage, delegatedSignRawMessage, delegatedSignTransaction, delegatedSponsorTransaction, encodeBase58, getBalance, revokeDelegation, sendTransaction };
+export { DynamicSvmWalletClient, ERROR_CREATE_WALLET_ACCOUNT, ERROR_DELEGATED_SIGN_TRANSACTION_CONTEXT_REQUIRED, ERROR_SIGN_RAW_MESSAGE, ERROR_SIGN_TRANSACTION_CONTEXT_REQUIRED, ERROR_SIGN_TRANSACTION_RAW_HEX_CONTEXT_REQUIRED, EarnSolanaStepError, addSignatureToTransaction, attachSignature, createDelegatedSvmWalletClient, createSolanaTransaction, createSvmEarnClient, decodeBase58, delegatedSignMessage, delegatedSignRawMessage, delegatedSignTransaction, delegatedSponsorTransaction, encodeBase58, getBalance, revokeDelegation, sendTransaction };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@dynamic-labs-wallet/node-svm",
-  "version": "1.1.51",
+  "version": "1.1.53",
   "license": "MIT",
   "type": "module",
   "dependencies": {
-    "@dynamic-labs-wallet/node": "1.1.51",
+    "@dynamic-labs-wallet/node": "1.1.53",
     "@solana/web3.js": "^1.98.2"
   },
   "publishConfig": {

package/src/client/client.d.ts

@@ -1,5 +1,6 @@
 import { type ServerKeyShare, DynamicWalletClient, type Ed25519KeygenResult, type ThresholdSignatureScheme, type TraceContext, type DynamicWalletClientProps, type WalletMetadata, type WalletApiKeyCreationResult, type RawSignPreImage, type SignMessageContext } from '@dynamic-labs-wallet/node';
 import { type Transaction, VersionedTransaction } from '@solana/web3.js';
+import type { ClaimEarnRewardsParams, DepositToEarnVaultParams, EarnTransactionResult, ExecuteEarnTransactionParams, WithdrawFromEarnVaultParams } from './earn.types.js';
 type SvmSignableTransaction = VersionedTransaction | Transaction | string;
 type SignTransactionResult = string | {
     signature: string;
@@ -168,6 +169,18 @@ export declare class DynamicSvmWalletClient extends DynamicWalletClient {
         derivationPath: string | undefined;
         thresholdSignatureScheme: ThresholdSignatureScheme;
     }[]>;
+    private get svmEarn();
+    /**
+     * Executes an Earn signing payload returned by the prepare* methods, signing and
+     * sending its ordered Solana transaction sequence one transaction at a time.
+     */
+    executeEarnTransaction(params: ExecuteEarnTransactionParams): Promise<EarnTransactionResult>;
+    /** Prepares and executes a deposit into an Earn vault. */
+    depositToEarnVault(params: DepositToEarnVaultParams): Promise<EarnTransactionResult>;
+    /** Prepares and executes a withdrawal from an Earn vault. */
+    withdrawFromEarnVault(params: WithdrawFromEarnVaultParams): Promise<EarnTransactionResult>;
+    /** Prepares and executes a claim of accrued Earn vault rewards. */
+    claimEarnRewards(params: ClaimEarnRewardsParams): Promise<EarnTransactionResult>;
 }
 export {};
 //# sourceMappingURL=client.d.ts.map

package/src/client/client.d.ts.map

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

package/src/client/earn.client.d.ts

@@ -0,0 +1,56 @@
+import type { EarnClient, ServerKeyShare, SignMessageContext, WalletMetadata } from '@dynamic-labs-wallet/node';
+import { Transaction, VersionedTransaction } from '@solana/web3.js';
+import type { ClaimEarnRewardsParams, DepositToEarnVaultParams, EarnTransactionResult, ExecuteEarnTransactionParams, WithdrawFromEarnVaultParams } from './earn.types.js';
+type EarnStepErrorCode = 'yield_step_expired' | 'yield_step_failed' | 'yield_step_send_failed' | 'yield_step_confirmation_unknown';
+/**
+ * A transaction in the sequence could not land. Transactions before `ordinal` already
+ * confirmed on-chain, so the action may be partially applied.
+ */
+export declare class EarnSolanaStepError extends Error {
+    readonly code: EarnStepErrorCode;
+    readonly ordinal: number;
+    readonly signature?: string;
+    constructor({ cause, code, ordinal, reason, signature, total, }: {
+        cause?: Error;
+        code: EarnStepErrorCode;
+        ordinal: number;
+        reason: string;
+        signature?: string;
+        total: number;
+    });
+}
+type SignEarnTransaction = (args: {
+    walletMetadata: WalletMetadata;
+    transaction: Transaction | VersionedTransaction;
+    password?: string;
+    externalServerKeyShares?: ServerKeyShare[];
+    sponsor?: boolean;
+    chainId?: string;
+    context?: SignMessageContext;
+}) => Promise<string | {
+    signature: string;
+    transaction: Transaction | VersionedTransaction;
+}>;
+/** Primitives the Earn client borrows from whoever owns the wallet. */
+export type SvmEarnClientDeps = {
+    getEarnClient: () => EarnClient;
+    signTransaction: SignEarnTransaction;
+};
+/**
+ * Builds a stateless Earn client for Solana vaults: it prepares vault actions through the
+ * Dynamic API and executes the returned ordered transaction sequence one transaction at a
+ * time — never in parallel, because a later transaction can depend on the state an earlier
+ * one wrote. If one fails, the sequence stops and the thrown {@link EarnSolanaStepError}
+ * reports how much of the action already landed.
+ *
+ * Gas sponsorship is opt-in (`sponsored: true`): vault transactions are built with the
+ * owner as fee payer, unlike the browser SDK which sponsors automatically.
+ */
+export declare const createSvmEarnClient: ({ getEarnClient, signTransaction }: SvmEarnClientDeps) => {
+    executeEarnTransaction: ({ signingPayload, walletMetadata, password, externalServerKeyShares, sponsored, rpcUrl, chainId, context, onStepChange, onTransactionStepChange, }: ExecuteEarnTransactionParams) => Promise<EarnTransactionResult>;
+    depositToEarnVault: ({ vaultId, amount, receiverAddress, traceContext, ...walletParams }: DepositToEarnVaultParams) => Promise<EarnTransactionResult>;
+    withdrawFromEarnVault: ({ vaultId, amount, receiverAddress, traceContext, ...walletParams }: WithdrawFromEarnVaultParams) => Promise<EarnTransactionResult>;
+    claimEarnRewards: ({ vaultId, traceContext, ...walletParams }: ClaimEarnRewardsParams) => Promise<EarnTransactionResult>;
+};
+export {};
+//# sourceMappingURL=earn.client.d.ts.map

package/src/client/earn.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earn.client.d.ts","sourceRoot":"","sources":["../../src/client/earn.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAc,WAAW,EAAE,oBAAoB,EAAyB,MAAM,iBAAiB,CAAC;AASvG,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EAErB,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AAGzB,KAAK,iBAAiB,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,wBAAwB,GACxB,iCAAiC,CAAC;AAEtC;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,EACV,KAAK,EACL,IAAI,EACJ,OAAO,EACP,MAAM,EACN,SAAS,EACT,KAAK,GACN,EAAE;QACD,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,iBAAiB,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf;CAcF;AAED,KAAK,mBAAmB,GAAG,CAAC,IAAI,EAAE;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,WAAW,GAAG,oBAAoB,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,KAAK,OAAO,CAAC,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,WAAW,GAAG,oBAAoB,CAAA;CAAE,CAAC,CAAC;AAE/F,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,MAAM,UAAU,CAAC;IAChC,eAAe,EAAE,mBAAmB,CAAC;CACtC,CAAC;AAsJF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,uCAAwC,iBAAiB;iLAmHpF,4BAA4B,KAAG,OAAO,CAAC,qBAAqB,CAAC;8FAsD3D,wBAAwB,KAAG,OAAO,CAAC,qBAAqB,CAAC;iGAiBzD,2BAA2B,KAAG,OAAO,CAAC,qBAAqB,CAAC;mEAe5D,sBAAsB,KAAG,OAAO,CAAC,qBAAqB,CAAC;CAS7D,CAAC"}

package/src/client/earn.constants.d.ts

@@ -0,0 +1,9 @@
+export declare const ERROR_EARN_NOT_SVM_WALLET = "Wallet metadata is not for an SVM wallet";
+export declare const ERROR_EARN_MISSING_TRANSACTIONS = "Earn signing payload is missing the Solana transaction sequence";
+export declare const ERROR_EARN_NON_CONTIGUOUS_ORDINALS = "Earn signing payload transaction ordinals must be contiguous from zero";
+/** Default RPC per Dynamic Solana chain id (101 mainnet, 103 devnet); `rpcUrl` overrides. */
+export declare const EARN_SOLANA_RPC_BY_CHAIN_ID: Record<string, string>;
+/** Blockhash checks run at `processed`, the commitment that sees new blockhashes first. */
+export declare const EARN_SOLANA_BLOCKHASH_COMMITMENT: "processed";
+export declare const EARN_CONFIRMATION_POLL_INTERVAL_MS = 1000;
+//# sourceMappingURL=earn.constants.d.ts.map

package/src/client/earn.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earn.constants.d.ts","sourceRoot":"","sources":["../../src/client/earn.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,6CAA6C,CAAC;AAEpF,eAAO,MAAM,+BAA+B,oEAAoE,CAAC;AAEjH,eAAO,MAAM,kCAAkC,2EAC2B,CAAC;AAE3E,6FAA6F;AAC7F,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG9D,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,gCAAgC,aAAuB,CAAC;AAErE,eAAO,MAAM,kCAAkC,OAAO,CAAC"}

package/src/client/earn.types.d.ts

@@ -0,0 +1,41 @@
+import type { EarnExecutionStep, EarnSigningPayload, ServerKeyShare, SignMessageContext, TraceContext, WalletMetadata } from '@dynamic-labs-wallet/node';
+export type { EarnExecutionStep, EarnTransactionResult } from '@dynamic-labs-wallet/node';
+/** Position of the transaction about to be signed within the ordered sequence. */
+export type EarnTransactionStepProgress = {
+    label?: string;
+    ordinal: number;
+    total: number;
+};
+/** Wallet context and chain access every Earn write action needs. */
+export type SvmEarnWalletParams = {
+    walletMetadata: WalletMetadata;
+    password?: string;
+    externalServerKeyShares?: ServerKeyShare[];
+    /** Opt in to Dynamic gas sponsorship for every transaction in the sequence. */
+    sponsored?: boolean;
+    /** Solana RPC endpoint; defaults to the public cluster for the payload's `chainId` (101 mainnet, 103 devnet). */
+    rpcUrl?: string;
+    chainId?: string;
+    context?: SignMessageContext;
+    onStepChange?: (step: EarnExecutionStep) => void;
+    /** Invoked as each transaction in the sequence is about to be signed. */
+    onTransactionStepChange?: (step: EarnTransactionStepProgress) => void;
+    traceContext?: TraceContext;
+};
+export type ExecuteEarnTransactionParams = Omit<SvmEarnWalletParams, 'traceContext'> & {
+    signingPayload: EarnSigningPayload;
+};
+export type DepositToEarnVaultParams = SvmEarnWalletParams & {
+    vaultId: string;
+    amount: string;
+    receiverAddress?: string;
+};
+export type WithdrawFromEarnVaultParams = SvmEarnWalletParams & {
+    vaultId: string;
+    amount: string;
+    receiverAddress?: string;
+};
+export type ClaimEarnRewardsParams = SvmEarnWalletParams & {
+    vaultId: string;
+};
+//# sourceMappingURL=earn.types.d.ts.map

package/src/client/earn.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earn.types.d.ts","sourceRoot":"","sources":["../../src/client/earn.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAE1F,kFAAkF;AAClF,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3C,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iHAAiH;IACjH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACjD,yEAAyE;IACzE,uBAAuB,CAAC,EAAE,CAAC,IAAI,EAAE,2BAA2B,KAAK,IAAI,CAAC;IACtE,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,GAAG;IACrF,cAAc,EAAE,kBAAkB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,GAAG;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,mBAAmB,GAAG;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,GAAG;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/src/client/index.d.ts

@@ -2,4 +2,7 @@ export * from './client.js';
 export * from './utils.js';
 export * from './base58.js';
 export * from './constants.js';
+export { createSvmEarnClient, EarnSolanaStepError } from './earn.client.js';
+export type { SvmEarnClientDeps } from './earn.client.js';
+export type { ClaimEarnRewardsParams, DepositToEarnVaultParams, EarnTransactionStepProgress, ExecuteEarnTransactionParams, SvmEarnWalletParams, WithdrawFromEarnVaultParams, } from './earn.types.js';
 //# sourceMappingURL=index.d.ts.map

package/src/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EACV,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC"}