@phantom/server-sdk 1.0.0-beta.0 → 1.0.0-beta.2

package/README.md

@@ -69,6 +69,7 @@ Create a `.env` file in your project root:
 
 ```env
 ORGANIZATION_ID=your-organization-id
+APP_ID=your-app-id
 PRIVATE_KEY=your-base58-encoded-private-key
 API_URL=https://api.phantom.app/v1/wallets
 ```
@@ -120,6 +121,72 @@ console.log("Solana address:", solanaAddress);
 console.log("Ethereum address:", ethereumAddress);
 ```
 
+### Transaction Signing Methods
+
+The Server SDK provides two methods for handling transactions:
+
+1. **`signTransaction(params)`** - Signs a transaction without submitting it to the network
+   - Returns the signed transaction 
+   - No network interaction
+   - Useful for offline signing or when you want to broadcast later
+
+2. **`signAndSendTransaction(params)`** - Signs and submits the transaction to the network
+   - Returns both signed transaction and transaction hash
+   - Requires network connectivity
+   - Transaction is immediately broadcast to the blockchain
+
+### Signing Only (No Network Submission)
+
+#### Solana Transaction Signing
+
+```typescript
+import { Transaction, SystemProgram, PublicKey } from "@solana/web3.js";
+
+// Create a Solana transaction
+const transaction = new Transaction().add(
+  SystemProgram.transfer({
+    fromPubkey: new PublicKey(solanaAddress),
+    toPubkey: new PublicKey(recipientAddress),
+    lamports: 1000000, // 0.001 SOL
+  }),
+);
+
+// Set transaction parameters
+transaction.recentBlockhash = blockhash;
+transaction.feePayer = new PublicKey(solanaAddress);
+
+// Sign the transaction (without sending)
+const signed = await sdk.signTransaction({
+  walletId: wallet.walletId,
+  transaction,
+  networkId: NetworkId.SOLANA_MAINNET,
+});
+
+console.log("Signed transaction:", signed.rawTransaction);
+// You can broadcast this transaction later using your own RPC client
+```
+
+#### Ethereum Transaction Signing
+
+```typescript
+// Viem transaction object
+const evmTransaction = {
+  to: "0x742d35Cc6634C0532925a3b8D4C8db86fB5C4A7E",
+  value: 1000000000000000000n, // 1 ETH in wei
+  data: "0x",
+  gasLimit: 21000n,
+};
+
+const signed = await sdk.signTransaction({
+  walletId: wallet.walletId,
+  transaction: evmTransaction,
+  networkId: NetworkId.ETHEREUM_MAINNET,
+});
+
+console.log("Signed transaction:", signed.rawTransaction);
+// You can broadcast this signed transaction using your preferred method
+```
+
 ### Signing and Sending Transactions
 
 #### Solana - Native Web3.js Transaction Objects
@@ -278,7 +345,8 @@ For complete API documentation, visit **[docs.phantom.com/server-sdk](https://do
 ### Key Methods
 
 - `createWallet(walletName?)` - Creates a new wallet
-- `signAndSendTransaction(params)` - Signs and optionally submits transactions
+- `signTransaction(params)` - Signs transactions without submitting to network
+- `signAndSendTransaction(params)` - Signs and submits transactions to network
 - `signMessage(params)` - Signs arbitrary messages
 - `getWalletAddresses(walletId, derivationPaths?)` - Retrieves wallet addresses
 - `getWallets(limit?, offset?)` - Lists all wallets with pagination

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { AddressType, NetworkId, PhantomClient, Organization, GetWalletsResult, CreateWalletResult } from '@phantom/client';
-export { CreateWalletResult, DerivationPath, GetWalletsResult, NetworkConfig, PhantomClient, SignedTransaction, Transaction, Wallet, deriveSubmissionConfig, generateKeyPair, getDerivationPathForNetwork, getNetworkConfig, getNetworkDescription, getNetworkIdsByChain, getSupportedNetworkIds, supportsTransactionSubmission } from '@phantom/client';
+export { CreateWalletResult, DerivationPath, GetWalletsResult, NetworkConfig, PhantomClient, SignedTransaction, SignedTransactionResult, Transaction, Wallet, deriveSubmissionConfig, generateKeyPair, getDerivationPathForNetwork, getNetworkConfig, getNetworkDescription, getNetworkIdsByChain, getSupportedNetworkIds, supportsTransactionSubmission } from '@phantom/client';
 import { ParsedSignatureResult, ParsedTransactionResult } from '@phantom/parsers';
 export { ParsedMessage, ParsedSignatureResult, ParsedTransaction, ParsedTransactionResult, parseMessage, parseSignMessageResponse, parseTransactionResponse, parseTransactionToBase64Url } from '@phantom/parsers';
 export { NetworkId } from '@phantom/constants';
@@ -12,6 +12,7 @@ interface WalletAddress {
 
 interface ServerSDKConfig {
     organizationId: string;
+    appId: string;
     apiBaseUrl: string;
     apiPrivateKey: string;
 }
@@ -21,6 +22,12 @@ interface ServerSignMessageParams {
     networkId: NetworkId;
     derivationIndex?: number;
 }
+interface ServerSignTransactionParams {
+    walletId: string;
+    transaction: any;
+    networkId: NetworkId;
+    derivationIndex?: number;
+}
 interface ServerSignAndSendTransactionParams {
     walletId: string;
     transaction: any;
@@ -37,6 +44,12 @@ declare class ServerSDK {
      * @returns Promise<ParsedSignatureResult> - Parsed signature with explorer URL
      */
     signMessage(params: ServerSignMessageParams): Promise<ParsedSignatureResult>;
+    /**
+     * Sign a transaction - supports various transaction formats and automatically parses them
+     * @param params - Transaction parameters with flexible transaction format
+     * @returns Promise<ParsedTransactionResult> - Parsed transaction result without hash
+     */
+    signTransaction(params: ServerSignTransactionParams): Promise<ParsedTransactionResult>;
     /**
      * Sign and send a transaction - supports various transaction formats and automatically parses them
      * @param params - Transaction parameters with flexible transaction format
@@ -55,4 +68,4 @@ declare class ServerSDK {
     }[]>;
 }
 
-export { ServerSDK, ServerSDKConfig, ServerSignAndSendTransactionParams, ServerSignMessageParams, WalletAddress };
+export { ServerSDK, ServerSDKConfig, ServerSignAndSendTransactionParams, ServerSignMessageParams, ServerSignTransactionParams, WalletAddress };

package/dist/index.js

@@ -88,6 +88,22 @@ var ServerSDK = class {
     const rawResponse = await this.client.signMessage(signMessageParams);
     return (0, import_parsers.parseSignMessageResponse)(rawResponse, params.networkId);
   }
+  /**
+   * Sign a transaction - supports various transaction formats and automatically parses them
+   * @param params - Transaction parameters with flexible transaction format
+   * @returns Promise<ParsedTransactionResult> - Parsed transaction result without hash
+   */
+  async signTransaction(params) {
+    const parsedTransaction = await (0, import_parsers.parseTransactionToBase64Url)(params.transaction, params.networkId);
+    const signTransactionParams = {
+      walletId: params.walletId,
+      transaction: parsedTransaction.base64url,
+      networkId: params.networkId,
+      derivationIndex: params.derivationIndex
+    };
+    const rawResponse = await this.client.signTransaction(signTransactionParams);
+    return await (0, import_parsers.parseTransactionResponse)(rawResponse.rawTransaction, params.networkId);
+  }
   /**
    * Sign and send a transaction - supports various transaction formats and automatically parses them
    * @param params - Transaction parameters with flexible transaction format

package/dist/index.mjs

@@ -61,6 +61,22 @@ var ServerSDK = class {
     const rawResponse = await this.client.signMessage(signMessageParams);
     return parseSignMessageResponse(rawResponse, params.networkId);
   }
+  /**
+   * Sign a transaction - supports various transaction formats and automatically parses them
+   * @param params - Transaction parameters with flexible transaction format
+   * @returns Promise<ParsedTransactionResult> - Parsed transaction result without hash
+   */
+  async signTransaction(params) {
+    const parsedTransaction = await parseTransactionToBase64Url(params.transaction, params.networkId);
+    const signTransactionParams = {
+      walletId: params.walletId,
+      transaction: parsedTransaction.base64url,
+      networkId: params.networkId,
+      derivationIndex: params.derivationIndex
+    };
+    const rawResponse = await this.client.signTransaction(signTransactionParams);
+    return await parseTransactionResponse(rawResponse.rawTransaction, params.networkId);
+  }
   /**
    * Sign and send a transaction - supports various transaction formats and automatically parses them
    * @param params - Transaction parameters with flexible transaction format

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/server-sdk",
-  "version": "1.0.0-beta.0",
+  "version": "1.0.0-beta.2",
   "description": "Server SDK for Phantom Wallet",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -37,11 +37,11 @@
     "typescript": "^5.0.4"
   },
   "dependencies": {
-    "@phantom/api-key-stamper": "^1.0.0-beta.0",
-    "@phantom/base64url": "^1.0.0-beta.0",
-    "@phantom/client": "^1.0.0-beta.0",
-    "@phantom/constants": "^1.0.0-beta.0",
-    "@phantom/parsers": "^1.0.0-beta.0",
+    "@phantom/api-key-stamper": "^1.0.0-beta.2",
+    "@phantom/base64url": "^1.0.0-beta.2",
+    "@phantom/client": "^1.0.0-beta.2",
+    "@phantom/constants": "^1.0.0-beta.2",
+    "@phantom/parsers": "^1.0.0-beta.2",
     "bs58": "^6.0.0"
   },
   "files": [