@dynamic-labs-wallet/node-svm 0.0.322 → 0.0.324

package/index.cjs.js

@@ -15,6 +15,7 @@ function _extends() {
 }
 
 const ERROR_CREATE_WALLET_ACCOUNT = 'Error creating svm wallet account';
+const ERROR_SIGN_RAW_MESSAGE = 'Error signing raw message';
 
 // Base58 encoding/decoding (Bitcoin alphabet) without external dependencies
 // Implementation adapted from the reference algorithm; suitable for keys/signatures
@@ -209,12 +210,61 @@ class DynamicSvmWalletClient extends node.DynamicWalletClient {
             throw error;
         }
     }
+    /**
+   * Signs a pre-formatted (raw) message without additional encoding.
+   * The message must be a hex string representing already-hashed data.
+   *
+   * @param message The pre-formatted hex message to sign
+   * @param accountAddress Solana address (base58 encoded)
+   * @param password The password for encrypted backup shares
+   */ async signRawMessage({ message, accountAddress, password = undefined, externalServerKeyShares }) {
+        if (!accountAddress) {
+            throw new Error('Account address is required');
+        }
+        try {
+            // Attempt to recover key shares from backup if not provided
+            await this.ensureKeySharesRecovered({
+                accountAddress,
+                password,
+                walletOperation: node.WalletOperation.SIGN_MESSAGE,
+                externalServerKeyShares,
+                errorMessage: 'External server key shares are required to sign a raw message. No backup shares available for recovery.'
+            });
+            const messageHex = node.stripHexPrefix(message);
+            const signatureEd25519 = await this.sign({
+                message: messageHex,
+                accountAddress,
+                chainName: this.chainName,
+                password,
+                externalServerKeyShares,
+                isFormatted: true
+            });
+            return encodeBase58(signatureEd25519);
+        } catch (error) {
+            logError$1({
+                message: ERROR_SIGN_RAW_MESSAGE,
+                error: error,
+                context: {
+                    accountAddress
+                }
+            });
+            throw new Error(ERROR_SIGN_RAW_MESSAGE);
+        }
+    }
     //todo:should txn just be a string?
-    async signTransaction({ senderAddress, transaction, password = undefined, externalServerKeyShares }) {
+    async signTransaction({ senderAddress, transaction, password = undefined, externalServerKeyShares, sponsor = false }) {
         // Validate inputs early
         if (!senderAddress) {
             throw new Error('Sender address is required');
         }
+        if (sponsor) {
+            if (typeof transaction === 'string') {
+                throw new TypeError('sponsor=true requires a Transaction or VersionedTransaction object, not a hex string');
+            }
+            transaction = await this.sponsorTransaction({
+                transaction
+            });
+        }
         await this.verifyPassword({
             accountAddress: senderAddress,
             password
@@ -381,6 +431,37 @@ class DynamicSvmWalletClient extends node.DynamicWalletClient {
             externalKeySharesWithBackupStatus
         };
     }
+    /**
+   * Sponsors a Solana transaction via the Dynamic gas sponsorship API.
+   *
+   * Sends the unsigned transaction to Dynamic's sponsorTransaction endpoint,
+   * which replaces the fee payer with the sponsor's address. The returned
+   * transaction object has the sponsor as fee payer and should be passed to
+   * {@link signTransaction} instead of the original transaction.
+   *
+   * Gas sponsorship must be enabled for your environment in the Dynamic
+   * dashboard before calling this method.
+   *
+   * @param transaction - Unsigned Solana transaction (legacy or versioned).
+   * @returns The sponsored transaction with the gas sponsor as fee payer.
+   */ async sponsorTransaction({ transaction, traceContext }) {
+        // Serialize the unsigned transaction to base64 wire format
+        const serialized = transaction instanceof web3_js.VersionedTransaction ? transaction.serialize() : transaction.serialize({
+            requireAllSignatures: false,
+            verifySignatures: false
+        });
+        const txBase64 = Buffer.from(serialized).toString('base64');
+        const { transaction: sponsoredBase64 } = await this.apiClient.requestSvmSponsoredTransaction({
+            transaction: txBase64,
+            traceContext
+        });
+        const sponsoredBytes = Buffer.from(sponsoredBase64, 'base64');
+        // Deserialize back to the same transaction type
+        if (transaction instanceof web3_js.VersionedTransaction) {
+            return web3_js.VersionedTransaction.deserialize(sponsoredBytes);
+        }
+        return web3_js.Transaction.from(sponsoredBytes);
+    }
     async getSvmWallets() {
         const wallets = await this.getWallets();
         const svmWallets = wallets.filter((wallet)=>wallet.chainName === 'solana');
@@ -589,6 +670,62 @@ const logError = node.createLogError('node-svm');
         throw error;
     }
 };
+/**
+ * Signs a pre-formatted (raw) message using delegated signing for SVM.
+ * The message must be a hex string representing already-hashed data.
+ *
+ * @param client - The delegated SVM wallet client
+ * @param options - Signing options
+ * @param options.walletId - The wallet ID
+ * @param options.walletApiKey - The wallet API key
+ * @param options.keyShare - The server key share
+ * @param options.message - Hex string of the already-hashed data to sign
+ *
+ * @returns The base58-encoded signature
+ *
+ * @example
+ * // Sign a pre-hashed message
+ * const signature = await delegatedSignRawMessage(client, {
+ *   walletId,
+ *   walletApiKey,
+ *   keyShare,
+ *   message: preHashedHex, // hex string of already-hashed data
+ * });
+ *
+ * @example
+ * // Sign a SHA-256 hash derived from arbitrary application data
+ * import { createHash } from 'crypto';
+ * const hash = createHash('sha256').update('my application data').digest('hex');
+ * const signature = await delegatedSignRawMessage(client, {
+ *   walletId,
+ *   walletApiKey,
+ *   keyShare,
+ *   message: hash,
+ * });
+ *
+ */ const delegatedSignRawMessage = async (client, { walletId, walletApiKey, keyShare, message })=>{
+    if (!keyShare || !walletId || !walletApiKey) {
+        throw new Error('Delegated key share, wallet ID, and wallet API key are required to sign a raw message');
+    }
+    try {
+        return await delegatedSignMessage(client, {
+            walletId,
+            walletApiKey,
+            keyShare,
+            message: node.stripHexPrefix(message),
+            isFormatted: true
+        });
+    } catch (error) {
+        logError({
+            message: 'Error in delegatedSignRawMessage',
+            error: error,
+            context: {
+                walletId
+            }
+        });
+        throw error;
+    }
+};
 /**
  * Revoke delegation - delegates to the node package
  */ const revokeDelegation = async (client, params)=>{
@@ -597,12 +734,14 @@ const logError = node.createLogError('node-svm');
 
 exports.DynamicSvmWalletClient = DynamicSvmWalletClient;
 exports.ERROR_CREATE_WALLET_ACCOUNT = ERROR_CREATE_WALLET_ACCOUNT;
+exports.ERROR_SIGN_RAW_MESSAGE = ERROR_SIGN_RAW_MESSAGE;
 exports.addSignatureToTransaction = addSignatureToTransaction;
 exports.attachSignature = attachSignature;
 exports.createDelegatedSvmWalletClient = createDelegatedSvmWalletClient;
 exports.createSolanaTransaction = createSolanaTransaction;
 exports.decodeBase58 = decodeBase58;
 exports.delegatedSignMessage = delegatedSignMessage;
+exports.delegatedSignRawMessage = delegatedSignRawMessage;
 exports.delegatedSignTransaction = delegatedSignTransaction;
 exports.encodeBase58 = encodeBase58;
 exports.getBalance = getBalance;

package/index.esm.js

@@ -1,5 +1,5 @@
-import { createLogError, DynamicWalletClient, getMPCChainConfig, getExternalServerKeyShareBackupInfo, WalletOperation, SOLANA_RPC_URL, createDelegatedWalletClient, delegatedSignMessage as delegatedSignMessage$1, revokeDelegation as revokeDelegation$1 } from '@dynamic-labs-wallet/node';
-import { PublicKey, VersionedTransaction, Keypair, Connection, Transaction, SystemProgram } from '@solana/web3.js';
+import { createLogError, DynamicWalletClient, getMPCChainConfig, getExternalServerKeyShareBackupInfo, WalletOperation, stripHexPrefix, SOLANA_RPC_URL, createDelegatedWalletClient, delegatedSignMessage as delegatedSignMessage$1, revokeDelegation as revokeDelegation$1 } from '@dynamic-labs-wallet/node';
+import { PublicKey, VersionedTransaction, Keypair, Transaction, Connection, SystemProgram } from '@solana/web3.js';
 
 function _extends() {
     _extends = Object.assign || function assign(target) {
@@ -13,6 +13,7 @@ function _extends() {
 }
 
 const ERROR_CREATE_WALLET_ACCOUNT = 'Error creating svm wallet account';
+const ERROR_SIGN_RAW_MESSAGE = 'Error signing raw message';
 
 // Base58 encoding/decoding (Bitcoin alphabet) without external dependencies
 // Implementation adapted from the reference algorithm; suitable for keys/signatures
@@ -207,12 +208,61 @@ class DynamicSvmWalletClient extends DynamicWalletClient {
             throw error;
         }
     }
+    /**
+   * Signs a pre-formatted (raw) message without additional encoding.
+   * The message must be a hex string representing already-hashed data.
+   *
+   * @param message The pre-formatted hex message to sign
+   * @param accountAddress Solana address (base58 encoded)
+   * @param password The password for encrypted backup shares
+   */ async signRawMessage({ message, accountAddress, password = undefined, externalServerKeyShares }) {
+        if (!accountAddress) {
+            throw new Error('Account address is required');
+        }
+        try {
+            // Attempt to recover key shares from backup if not provided
+            await this.ensureKeySharesRecovered({
+                accountAddress,
+                password,
+                walletOperation: WalletOperation.SIGN_MESSAGE,
+                externalServerKeyShares,
+                errorMessage: 'External server key shares are required to sign a raw message. No backup shares available for recovery.'
+            });
+            const messageHex = stripHexPrefix(message);
+            const signatureEd25519 = await this.sign({
+                message: messageHex,
+                accountAddress,
+                chainName: this.chainName,
+                password,
+                externalServerKeyShares,
+                isFormatted: true
+            });
+            return encodeBase58(signatureEd25519);
+        } catch (error) {
+            logError$1({
+                message: ERROR_SIGN_RAW_MESSAGE,
+                error: error,
+                context: {
+                    accountAddress
+                }
+            });
+            throw new Error(ERROR_SIGN_RAW_MESSAGE);
+        }
+    }
     //todo:should txn just be a string?
-    async signTransaction({ senderAddress, transaction, password = undefined, externalServerKeyShares }) {
+    async signTransaction({ senderAddress, transaction, password = undefined, externalServerKeyShares, sponsor = false }) {
         // Validate inputs early
         if (!senderAddress) {
             throw new Error('Sender address is required');
         }
+        if (sponsor) {
+            if (typeof transaction === 'string') {
+                throw new TypeError('sponsor=true requires a Transaction or VersionedTransaction object, not a hex string');
+            }
+            transaction = await this.sponsorTransaction({
+                transaction
+            });
+        }
         await this.verifyPassword({
             accountAddress: senderAddress,
             password
@@ -379,6 +429,37 @@ class DynamicSvmWalletClient extends DynamicWalletClient {
             externalKeySharesWithBackupStatus
         };
     }
+    /**
+   * Sponsors a Solana transaction via the Dynamic gas sponsorship API.
+   *
+   * Sends the unsigned transaction to Dynamic's sponsorTransaction endpoint,
+   * which replaces the fee payer with the sponsor's address. The returned
+   * transaction object has the sponsor as fee payer and should be passed to
+   * {@link signTransaction} instead of the original transaction.
+   *
+   * Gas sponsorship must be enabled for your environment in the Dynamic
+   * dashboard before calling this method.
+   *
+   * @param transaction - Unsigned Solana transaction (legacy or versioned).
+   * @returns The sponsored transaction with the gas sponsor as fee payer.
+   */ async sponsorTransaction({ transaction, traceContext }) {
+        // Serialize the unsigned transaction to base64 wire format
+        const serialized = transaction instanceof VersionedTransaction ? transaction.serialize() : transaction.serialize({
+            requireAllSignatures: false,
+            verifySignatures: false
+        });
+        const txBase64 = Buffer.from(serialized).toString('base64');
+        const { transaction: sponsoredBase64 } = await this.apiClient.requestSvmSponsoredTransaction({
+            transaction: txBase64,
+            traceContext
+        });
+        const sponsoredBytes = Buffer.from(sponsoredBase64, 'base64');
+        // Deserialize back to the same transaction type
+        if (transaction instanceof VersionedTransaction) {
+            return VersionedTransaction.deserialize(sponsoredBytes);
+        }
+        return Transaction.from(sponsoredBytes);
+    }
     async getSvmWallets() {
         const wallets = await this.getWallets();
         const svmWallets = wallets.filter((wallet)=>wallet.chainName === 'solana');
@@ -587,10 +668,66 @@ const logError = createLogError('node-svm');
         throw error;
     }
 };
+/**
+ * Signs a pre-formatted (raw) message using delegated signing for SVM.
+ * The message must be a hex string representing already-hashed data.
+ *
+ * @param client - The delegated SVM wallet client
+ * @param options - Signing options
+ * @param options.walletId - The wallet ID
+ * @param options.walletApiKey - The wallet API key
+ * @param options.keyShare - The server key share
+ * @param options.message - Hex string of the already-hashed data to sign
+ *
+ * @returns The base58-encoded signature
+ *
+ * @example
+ * // Sign a pre-hashed message
+ * const signature = await delegatedSignRawMessage(client, {
+ *   walletId,
+ *   walletApiKey,
+ *   keyShare,
+ *   message: preHashedHex, // hex string of already-hashed data
+ * });
+ *
+ * @example
+ * // Sign a SHA-256 hash derived from arbitrary application data
+ * import { createHash } from 'crypto';
+ * const hash = createHash('sha256').update('my application data').digest('hex');
+ * const signature = await delegatedSignRawMessage(client, {
+ *   walletId,
+ *   walletApiKey,
+ *   keyShare,
+ *   message: hash,
+ * });
+ *
+ */ const delegatedSignRawMessage = async (client, { walletId, walletApiKey, keyShare, message })=>{
+    if (!keyShare || !walletId || !walletApiKey) {
+        throw new Error('Delegated key share, wallet ID, and wallet API key are required to sign a raw message');
+    }
+    try {
+        return await delegatedSignMessage(client, {
+            walletId,
+            walletApiKey,
+            keyShare,
+            message: stripHexPrefix(message),
+            isFormatted: true
+        });
+    } catch (error) {
+        logError({
+            message: 'Error in delegatedSignRawMessage',
+            error: error,
+            context: {
+                walletId
+            }
+        });
+        throw error;
+    }
+};
 /**
  * Revoke delegation - delegates to the node package
  */ const revokeDelegation = async (client, params)=>{
     return revokeDelegation$1(client, params);
 };
 
-export { DynamicSvmWalletClient, ERROR_CREATE_WALLET_ACCOUNT, addSignatureToTransaction, attachSignature, createDelegatedSvmWalletClient, createSolanaTransaction, decodeBase58, delegatedSignMessage, delegatedSignTransaction, encodeBase58, getBalance, revokeDelegation, sendTransaction };
+export { DynamicSvmWalletClient, ERROR_CREATE_WALLET_ACCOUNT, ERROR_SIGN_RAW_MESSAGE, addSignatureToTransaction, attachSignature, createDelegatedSvmWalletClient, createSolanaTransaction, decodeBase58, delegatedSignMessage, delegatedSignRawMessage, delegatedSignTransaction, encodeBase58, getBalance, revokeDelegation, sendTransaction };

package/package.json

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

package/src/client/base58.d.ts

@@ -0,0 +1,3 @@
+export declare function encodeBase58(source: Uint8Array): string;
+export declare function decodeBase58(str: string): Uint8Array;
+//# sourceMappingURL=base58.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base58.d.ts","sourceRoot":"","sources":["../../src/client/base58.ts"],"names":[],"mappings":"AAOA,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAkCvD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAmCpD"}

package/src/client/client.d.ts

@@ -0,0 +1,145 @@
+import { type ServerKeyShare, DynamicWalletClient, type Ed25519KeygenResult, type ThresholdSignatureScheme, type TraceContext, type DynamicWalletClientProps } from '@dynamic-labs-wallet/node';
+import { Transaction, VersionedTransaction } from '@solana/web3.js';
+export declare class DynamicSvmWalletClient extends DynamicWalletClient {
+    readonly chainName = "SVM";
+    accountAddress?: string;
+    constructor({ environmentId, baseApiUrl, baseMPCRelayApiUrl, enableMPCAccelerator, logger, debug, }: DynamicWalletClientProps);
+    /**
+     * Creates a wallet account on the Solana chain
+     *
+     * @param thresholdSignatureScheme The threshold signature scheme to use
+     * @returns The account address, public key hex, raw public key, and client key shares
+     */
+    createWalletAccount({ thresholdSignatureScheme, password, onError, backUpToClientShareService, }: {
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        password?: string;
+        onError?: (error: Error) => void;
+        backUpToClientShareService?: boolean;
+    }): Promise<{
+        accountAddress: string;
+        rawPublicKey: Uint8Array | string;
+        /** @deprecated Use externalKeySharesWithBackupStatus instead */
+        externalServerKeyShares: ServerKeyShare[];
+        externalKeySharesWithBackupStatus: Array<{
+            share: ServerKeyShare;
+            backedUpToClientKeyShareService: boolean;
+        }>;
+    }>;
+    deriveAccountAddress(rawPublicKey: string | Uint8Array): Promise<{
+        accountAddress: string;
+    }>;
+    /**
+     * This function takes a message and returns it after being signed with MPC
+     *
+     * @param message The message to sign (Uint8Array)
+     * @param accountAddress Solana address (base58 encoded)
+     * @param password The password for encrypted backup shares
+     */
+    signMessage({ message, accountAddress, password, externalServerKeyShares, }: {
+        message: string | Uint8Array;
+        accountAddress: string;
+        password?: string;
+        externalServerKeyShares?: ServerKeyShare[];
+    }): Promise<string>;
+    /**
+     * Signs a pre-formatted (raw) message without additional encoding.
+     * The message must be a hex string representing already-hashed data.
+     *
+     * @param message The pre-formatted hex message to sign
+     * @param accountAddress Solana address (base58 encoded)
+     * @param password The password for encrypted backup shares
+     */
+    signRawMessage({ message, accountAddress, password, externalServerKeyShares, }: {
+        message: string;
+        accountAddress: string;
+        password?: string;
+        externalServerKeyShares?: ServerKeyShare[];
+    }): Promise<string>;
+    signTransaction({ senderAddress, transaction, password, externalServerKeyShares, sponsor, }: {
+        senderAddress: string;
+        transaction: VersionedTransaction | Transaction | string;
+        password?: string;
+        externalServerKeyShares?: ServerKeyShare[];
+        /** If true, requests gas sponsorship from Dynamic before signing. */
+        sponsor?: boolean;
+    }): Promise<string>;
+    /**
+     * Exports the private key for a given account address
+     *
+     * @param accountAddress The account address to export the private key for
+     * @param password The password for encrypted backup shares
+     * @returns The private key
+     */
+    exportPrivateKey({ accountAddress, password, externalServerKeyShares, }: {
+        accountAddress: string;
+        password?: string;
+        externalServerKeyShares?: ServerKeyShare[];
+    }): Promise<string>;
+    /**
+     * Exports the private key for a given account address
+     *
+     * @param keyShares The key shares to export the private key for
+     * @returns The private key
+     */
+    offlineExportPrivateKey({ keyShares, derivationPath, }: {
+        keyShares: Ed25519KeygenResult[];
+        derivationPath?: string;
+    }): Promise<{
+        derivedPrivateKey: string;
+    }>;
+    /**
+     * Converts the private key to a hex string
+     *
+     * @param privateKey The private key to convert
+     * @returns The hex string
+     */
+    decodePrivateKeyForSolana(privateKey: string): string;
+    getPublicKeyFromPrivateKey(privateKey: string): string;
+    encodePublicKey(publicKey: Uint8Array): string;
+    /**
+     * Imports the private key for a given account address
+     *
+     * @param privateKey The private key to import
+     * @param chainName The chain name to import the private key for
+     * @param thresholdSignatureScheme The threshold signature scheme to use
+     * @param password The password for encrypted backup shares
+     * @returns The account address, raw public key, and client key shares
+     */
+    importPrivateKey({ privateKey, chainName, thresholdSignatureScheme, password, onError, backUpToClientShareService, }: {
+        privateKey: string;
+        chainName: string;
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        password?: string;
+        onError?: (error: Error) => void;
+        backUpToClientShareService?: boolean;
+    }): Promise<{
+        accountAddress: string;
+        rawPublicKey: Uint8Array | string | undefined;
+        /** @deprecated Use externalKeySharesWithBackupStatus instead */
+        externalServerKeyShares: ServerKeyShare[];
+        externalKeySharesWithBackupStatus: Array<{
+            share: ServerKeyShare;
+            backedUpToClientKeyShareService: boolean;
+        }>;
+    }>;
+    /**
+     * Sponsors a Solana transaction via the Dynamic gas sponsorship API.
+     *
+     * Sends the unsigned transaction to Dynamic's sponsorTransaction endpoint,
+     * which replaces the fee payer with the sponsor's address. The returned
+     * transaction object has the sponsor as fee payer and should be passed to
+     * {@link signTransaction} instead of the original transaction.
+     *
+     * Gas sponsorship must be enabled for your environment in the Dynamic
+     * dashboard before calling this method.
+     *
+     * @param transaction - Unsigned Solana transaction (legacy or versioned).
+     * @returns The sponsored transaction with the gas sponsor as fee payer.
+     */
+    sponsorTransaction({ transaction, traceContext, }: {
+        transaction: VersionedTransaction | Transaction;
+        traceContext?: TraceContext;
+    }): Promise<VersionedTransaction | Transaction>;
+    getSvmWallets(): Promise<import("@dynamic-labs-wallet/node").WalletProperties[]>;
+}
+//# sourceMappingURL=client.d.ts.map

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

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

package/src/client/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const ERROR_CREATE_WALLET_ACCOUNT = "Error creating svm wallet account";
+export declare const ERROR_SIGN_RAW_MESSAGE = "Error signing raw message";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/client/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,sCAAsC,CAAC;AAE/E,eAAO,MAAM,sBAAsB,8BAA8B,CAAC"}

package/src/client/index.d.ts

@@ -0,0 +1,5 @@
+export * from './client.js';
+export * from './utils.js';
+export * from './base58.js';
+export * from './constants.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/src/client/utils.d.ts

@@ -0,0 +1,29 @@
+import { PublicKey, Transaction, type VersionedTransaction } from '@solana/web3.js';
+export declare function getBalance({ address, rpcUrl }: {
+    address: string;
+    rpcUrl?: string;
+}): Promise<number>;
+export declare function createSolanaTransaction({ senderSolanaAddress, amount, to, rpcUrl, }: {
+    senderSolanaAddress: string;
+    amount: number;
+    to: string;
+    rpcUrl?: string;
+}): Promise<{
+    transaction: Transaction;
+    serializedTransaction: Buffer;
+}>;
+export declare const addSignatureToTransaction: ({ transaction, signature, signerPublicKey, }: {
+    transaction: Transaction | VersionedTransaction;
+    signature: Uint8Array;
+    signerPublicKey: PublicKey;
+}) => VersionedTransaction | Transaction;
+export declare function attachSignature({ transaction, signatureBase58, senderAddress, }: {
+    transaction: Transaction | VersionedTransaction;
+    signatureBase58: string;
+    senderAddress: string;
+}): VersionedTransaction | Transaction;
+export declare function sendTransaction({ signedTransaction, rpcUrl, }: {
+    signedTransaction: Uint8Array;
+    rpcUrl?: string;
+}): Promise<string>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/client/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,SAAS,EAAiB,WAAW,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG/G,wBAAsB,UAAU,CAAC,EAAE,OAAO,EAAE,MAAuB,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,mBAI1G;AAED,wBAAsB,uBAAuB,CAAC,EAC5C,mBAAmB,EACnB,MAAM,EACN,EAAE,EACF,MAAwC,GACzC,EAAE;IACD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;;;GAwBA;AAED,eAAO,MAAM,yBAAyB,iDAInC;IACD,WAAW,EAAE,WAAW,GAAG,oBAAoB,CAAC;IAChD,SAAS,EAAE,UAAU,CAAC;IACtB,eAAe,EAAE,SAAS,CAAC;CAC5B,KAAG,oBAAoB,GAAG,WAG1B,CAAC;AAEF,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,eAAe,EACf,aAAa,GACd,EAAE;IACD,WAAW,EAAE,WAAW,GAAG,oBAAoB,CAAC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,oBAAoB,GAAG,WAAW,CAQrC;AAED,wBAAsB,eAAe,CAAC,EACpC,iBAAiB,EACjB,MAAwC,GACzC,EAAE;IACD,iBAAiB,EAAE,UAAU,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,mBAIA"}

package/src/delegatedClient.d.ts

@@ -0,0 +1,119 @@
+import type { DelegatedWalletClient, ServerKeyShare } from '@dynamic-labs-wallet/node';
+import type { Transaction } from '@solana/web3.js';
+import { VersionedTransaction } from '@solana/web3.js';
+export type DelegatedSvmClientConfig = {
+    environmentId: string;
+    baseApiUrl?: string;
+    baseMPCRelayApiUrl?: string;
+    apiKey: string;
+    debug?: boolean;
+};
+export type DelegatedSvmWalletClient = DelegatedWalletClient & {
+    readonly chainName: 'SVM';
+};
+/**
+ * Creates a delegated SVM wallet client for functional operations
+ */
+export declare const createDelegatedSvmWalletClient: ({ environmentId, baseApiUrl, baseMPCRelayApiUrl, apiKey, debug, }: DelegatedSvmClientConfig) => DelegatedSvmWalletClient;
+/**
+ * Signs a message using delegated signing for SVM
+ */
+export declare const delegatedSignMessage: (client: DelegatedSvmWalletClient, { walletId, walletApiKey, keyShare, message, isFormatted, }: {
+    walletId: string;
+    walletApiKey: string;
+    keyShare: ServerKeyShare;
+    message: string;
+    isFormatted?: boolean;
+}) => Promise<string>;
+/**
+ * Signs a transaction using delegated signing for SVM
+ *
+ * @param client - The delegated SVM wallet client
+ * @param options - Signing options
+ * @param options.walletId - The wallet ID
+ * @param options.walletApiKey - The wallet API key
+ * @param options.keyShare - The server key share
+ * @param options.transaction - The transaction to sign (VersionedTransaction or Transaction)
+ * @param options.signerAddress - Optional. The address that should sign the transaction.
+ *                                 If not provided, defaults to the first signer (VersionedTransaction)
+ *                                 or fee payer (Transaction). Use this for gasless transactions where
+ *                                 a separate fee payer pays the fees.
+ *
+ * @returns The partially signed transaction with the signature attached for the specified signer
+ *
+ * @example
+ * // Standard transaction where sender is also fee payer
+ * const signedTx = await delegatedSignTransaction(client, {
+ *   walletId,
+ *   walletApiKey,
+ *   keyShare,
+ *   transaction,
+ * });
+ *
+ * @example
+ * // Gasless transaction with separate fee payer
+ * const transaction = new Transaction();
+ * transaction.feePayer = feePayerPublicKey; // Set the actual fee payer
+ * transaction.add(instruction); // Instruction that requires sender signature
+ *
+ * const signedTx = await delegatedSignTransaction(client, {
+ *   walletId,
+ *   walletApiKey,
+ *   keyShare,
+ *   transaction,
+ *   signerAddress: senderAddress, // Explicitly specify who signs
+ * });
+ *
+ */
+export declare const delegatedSignTransaction: (client: DelegatedSvmWalletClient, { walletId, walletApiKey, keyShare, transaction, signerAddress, }: {
+    walletId: string;
+    walletApiKey: string;
+    keyShare: any;
+    transaction: VersionedTransaction | Transaction;
+    signerAddress?: string;
+}) => Promise<VersionedTransaction | Transaction>;
+/**
+ * Signs a pre-formatted (raw) message using delegated signing for SVM.
+ * The message must be a hex string representing already-hashed data.
+ *
+ * @param client - The delegated SVM wallet client
+ * @param options - Signing options
+ * @param options.walletId - The wallet ID
+ * @param options.walletApiKey - The wallet API key
+ * @param options.keyShare - The server key share
+ * @param options.message - Hex string of the already-hashed data to sign
+ *
+ * @returns The base58-encoded signature
+ *
+ * @example
+ * // Sign a pre-hashed message
+ * const signature = await delegatedSignRawMessage(client, {
+ *   walletId,
+ *   walletApiKey,
+ *   keyShare,
+ *   message: preHashedHex, // hex string of already-hashed data
+ * });
+ *
+ * @example
+ * // Sign a SHA-256 hash derived from arbitrary application data
+ * import { createHash } from 'crypto';
+ * const hash = createHash('sha256').update('my application data').digest('hex');
+ * const signature = await delegatedSignRawMessage(client, {
+ *   walletId,
+ *   walletApiKey,
+ *   keyShare,
+ *   message: hash,
+ * });
+ *
+ */
+export declare const delegatedSignRawMessage: (client: DelegatedSvmWalletClient, { walletId, walletApiKey, keyShare, message, }: {
+    walletId: string;
+    walletApiKey: string;
+    keyShare: ServerKeyShare;
+    message: string;
+}) => Promise<string>;
+/**
+ * Revoke delegation - delegates to the node package
+ */
+export declare const revokeDelegation: (client: DelegatedSvmWalletClient, params: any) => Promise<void>;
+//# sourceMappingURL=delegatedClient.d.ts.map

package/src/delegatedClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegatedClient.d.ts","sourceRoot":"","sources":["../../packages/src/delegatedClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAa,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAMlE,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,GAAG;IAC7D,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8BAA8B,sEAMxC,wBAAwB,KAAG,wBAe7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,WACvB,wBAAwB,+DAO7B;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,KACA,OAAO,CAAC,MAAM,CAwBhB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,wBAAwB,WAC3B,wBAAwB,qEAO7B;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC;IACd,WAAW,EAAE,oBAAoB,GAAG,WAAW,CAAC;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,KACA,OAAO,CAAC,oBAAoB,GAAG,WAAW,CAmE5C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,uBAAuB,WAC1B,wBAAwB,kDAM7B;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB,KACA,OAAO,CAAC,MAAM,CAqBhB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,WAAkB,wBAAwB,UAAU,GAAG,kBAEnF,CAAC"}

package/src/index.d.ts

@@ -0,0 +1,3 @@
+export * from './client/index.js';
+export * from './delegatedClient.js';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../packages/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}