@phantom/server-sdk 1.0.0-beta.9 → 1.0.0

package/README.md

@@ -126,7 +126,7 @@ console.log("Ethereum address:", ethereumAddress);
 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 
+   - Returns the signed transaction
    - No network interaction
    - Useful for offline signing or when you want to broadcast later
 
@@ -311,7 +311,7 @@ const customAddresses = await sdk.getWalletAddresses(
 
 ## Network Support
 
-The SDK supports multiple blockchain networks through the `NetworkId` enum:
+The Server SDK uses the `NetworkId` enum to identify blockchain networks for signing transactions and messages.
 
 ### Solana Networks
 
@@ -322,21 +322,75 @@ The SDK supports multiple blockchain networks through the `NetworkId` enum:
 ### Ethereum Networks
 
 - `NetworkId.ETHEREUM_MAINNET` - Ethereum Mainnet
-- `NetworkId.ETHEREUM_GOERLI` - Goerli Testnet
 - `NetworkId.ETHEREUM_SEPOLIA` - Sepolia Testnet
 
-### Other EVM Networks
+### Polygon Networks
 
-- `NetworkId.POLYGON_MAINNET` - Polygon Mainnet
-- `NetworkId.POLYGON_MUMBAI` - Mumbai Testnet
-- `NetworkId.OPTIMISM_MAINNET` - Optimism Mainnet
-- `NetworkId.ARBITRUM_ONE` - Arbitrum One
-- `NetworkId.BASE_MAINNET` - Base Mainnet
+- `NetworkId.POLYGON_MAINNET` - Polygon Mainnet (Chain ID: 137)
+- `NetworkId.POLYGON_AMOY` - Polygon Amoy Testnet (Chain ID: 80002)
+
+### Base Networks
+
+- `NetworkId.BASE_MAINNET` - Base Mainnet (Chain ID: 8453)
+- `NetworkId.BASE_SEPOLIA` - Base Sepolia Testnet (Chain ID: 84532)
+
+### Arbitrum Networks
+
+- `NetworkId.ARBITRUM_ONE` - Arbitrum One (Chain ID: 42161)
+- `NetworkId.ARBITRUM_SEPOLIA` - Arbitrum Sepolia Testnet (Chain ID: 421614)
+
+### Monad Networks
+
+- `NetworkId.MONAD_MAINNET` - Monad Mainnet (Chain ID: 143)
+- `NetworkId.MONAD_TESTNET` - Monad Testnet (Chain ID: 10143)
 
 ### Future Support
 
 - `NetworkId.BITCOIN_MAINNET` - Bitcoin Mainnet
+- `NetworkId.BITCOIN_TESTNET` - Bitcoin Testnet
 - `NetworkId.SUI_MAINNET` - Sui Mainnet
+- `NetworkId.SUI_TESTNET` - Sui Testnet
+- `NetworkId.SUI_DEVNET` - Sui Devnet
+
+### Usage Examples
+
+```typescript
+import { ServerSDK, NetworkId } from "@phantom/server-sdk";
+
+const sdk = new ServerSDK({
+  organizationId: process.env.ORGANIZATION_ID!,
+  appId: process.env.APP_ID!,
+  apiPrivateKey: process.env.PRIVATE_KEY!,
+});
+
+// Sign a message on Solana
+await sdk.signMessage({
+  walletId: wallet.walletId,
+  message: "Hello from Phantom!",
+  networkId: NetworkId.SOLANA_MAINNET,
+});
+
+// Sign a transaction on Ethereum
+await sdk.signAndSendTransaction({
+  walletId: wallet.walletId,
+  transaction: ethTransaction,
+  networkId: NetworkId.ETHEREUM_MAINNET,
+});
+
+// Sign on Polygon
+await sdk.signAndSendTransaction({
+  walletId: wallet.walletId,
+  transaction: polygonTransaction,
+  networkId: NetworkId.POLYGON_MAINNET,
+});
+
+// Sign on Base
+await sdk.signAndSendTransaction({
+  walletId: wallet.walletId,
+  transaction: baseTransaction,
+  networkId: NetworkId.BASE_MAINNET,
+});
+```
 
 ## API Reference
 

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { AddressType, NetworkId, PhantomClient, Organization, GetWalletsResult, CreateWalletResult } 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 { ParsedSignatureResult, ParsedTransaction, ParsedTransactionResult, parseSignMessageResponse, parseToKmsTransaction, parseTransactionResponse } from '@phantom/parsers';
 export { NetworkId } from '@phantom/constants';
 export { ApiKeyStamper } from '@phantom/api-key-stamper';
 
@@ -42,6 +42,7 @@ declare class ServerSDK {
     constructor(config: ServerSDKConfig);
     /**
      * Sign a message - supports plain text and automatically converts to base64url
+     * Routes to appropriate signing method based on network type
      * @param params - Message parameters with plain text message
      * @returns Promise<ParsedSignatureResult> - Parsed signature with explorer URL
      */

package/dist/index.js

@@ -42,10 +42,9 @@ __export(src_exports, {
   getNetworkDescription: () => import_client2.getNetworkDescription,
   getNetworkIdsByChain: () => import_client2.getNetworkIdsByChain,
   getSupportedNetworkIds: () => import_client2.getSupportedNetworkIds,
-  parseMessage: () => import_parsers2.parseMessage,
   parseSignMessageResponse: () => import_parsers2.parseSignMessageResponse,
+  parseToKmsTransaction: () => import_parsers2.parseToKmsTransaction,
   parseTransactionResponse: () => import_parsers2.parseTransactionResponse,
-  parseTransactionToBase64Url: () => import_parsers2.parseTransactionToBase64Url,
   supportsTransactionSubmission: () => import_client2.supportsTransactionSubmission
 });
 module.exports = __toCommonJS(src_exports);
@@ -59,8 +58,13 @@ var import_bs58 = __toESM(require("bs58"));
 // package.json
 var package_default = {
   name: "@phantom/server-sdk",
-  version: "1.0.0-beta.9",
+  version: "1.0.0",
   description: "Server SDK for Phantom Wallet",
+  repository: {
+    type: "git",
+    url: "https://github.com/phantom/phantom-connect-sdk",
+    directory: "packages/server-sdk"
+  },
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -147,25 +151,23 @@ var ServerSDK = class {
       {
         apiBaseUrl: config.apiBaseUrl || import_constants.DEFAULT_WALLET_API_URL,
         organizationId: config.organizationId,
-        headers
+        headers,
+        walletType: "server-wallet"
       },
       stamper
     );
   }
   /**
    * Sign a message - supports plain text and automatically converts to base64url
+   * Routes to appropriate signing method based on network type
    * @param params - Message parameters with plain text message
    * @returns Promise<ParsedSignatureResult> - Parsed signature with explorer URL
    */
   async signMessage(params) {
-    const parsedMessage = (0, import_parsers.parseMessage)(params.message);
-    const signMessageParams = {
-      walletId: params.walletId,
-      message: parsedMessage.base64url,
-      networkId: params.networkId,
-      derivationIndex: params.derivationIndex
-    };
-    const rawResponse = await this.client.signMessage(signMessageParams);
+    const rawResponse = (0, import_utils.isEthereumChain)(params.networkId) ? await this.client.ethereumSignMessage({
+      ...params,
+      message: (0, import_base64url.stringToBase64url)(params.message)
+    }) : await this.client.signUtf8Message(params);
     return (0, import_parsers.parseSignMessageResponse)(rawResponse, params.networkId);
   }
   /**
@@ -174,15 +176,18 @@ var ServerSDK = class {
    * @returns Promise<ParsedTransactionResult> - Parsed transaction result without hash
    */
   async signTransaction(params) {
-    const parsedTransaction = await (0, import_parsers.parseTransactionToBase64Url)(params.transaction, params.networkId);
-    const signTransactionParams = {
+    const parsedTransaction = await (0, import_parsers.parseToKmsTransaction)(params.transaction, params.networkId);
+    const transactionPayload = parsedTransaction.parsed;
+    if (!transactionPayload) {
+      throw new Error("Failed to parse transaction: no valid encoding found");
+    }
+    const rawResponse = await this.client.signTransaction({
       walletId: params.walletId,
-      transaction: parsedTransaction.base64url,
+      transaction: transactionPayload,
       networkId: params.networkId,
       derivationIndex: params.derivationIndex,
       account: params.account
-    };
-    const rawResponse = await this.client.signTransaction(signTransactionParams);
+    });
     return await (0, import_parsers.parseTransactionResponse)(rawResponse.rawTransaction, params.networkId);
   }
   /**
@@ -191,15 +196,18 @@ var ServerSDK = class {
    * @returns Promise<ParsedTransactionResult> - Parsed transaction result with hash and explorer URL
    */
   async signAndSendTransaction(params) {
-    const parsedTransaction = await (0, import_parsers.parseTransactionToBase64Url)(params.transaction, params.networkId);
-    const signAndSendParams = {
+    const parsedTransaction = await (0, import_parsers.parseToKmsTransaction)(params.transaction, params.networkId);
+    const transactionPayload = parsedTransaction.parsed;
+    if (!transactionPayload) {
+      throw new Error("Failed to parse transaction: no valid encoding found");
+    }
+    const rawResponse = await this.client.signAndSendTransaction({
       walletId: params.walletId,
-      transaction: parsedTransaction.base64url,
+      transaction: transactionPayload,
       networkId: params.networkId,
       derivationIndex: params.derivationIndex,
       account: params.account
-    };
-    const rawResponse = await this.client.signAndSendTransaction(signAndSendParams);
+    });
     return await (0, import_parsers.parseTransactionResponse)(rawResponse.rawTransaction, params.networkId, rawResponse.hash);
   }
   createOrganization(name, keyPair) {
@@ -208,7 +216,8 @@ var ServerSDK = class {
       {
         apiBaseUrl: this.config.apiBaseUrl || import_constants.DEFAULT_WALLET_API_URL,
         organizationId: this.config.organizationId,
-        headers
+        headers,
+        walletType: "server-wallet"
       },
       new import_api_key_stamper.ApiKeyStamper({
         apiSecretKey: keyPair.secretKey
@@ -254,9 +263,8 @@ var ServerSDK = class {
   getNetworkDescription,
   getNetworkIdsByChain,
   getSupportedNetworkIds,
-  parseMessage,
   parseSignMessageResponse,
+  parseToKmsTransaction,
   parseTransactionResponse,
-  parseTransactionToBase64Url,
   supportsTransactionSubmission
 });

package/dist/index.mjs

@@ -2,20 +2,22 @@
 import {
   PhantomClient
 } from "@phantom/client";
-import { randomUUID, getSecureTimestampSync } from "@phantom/utils";
-import {
-  ANALYTICS_HEADERS,
-  DEFAULT_WALLET_API_URL
-} from "@phantom/constants";
+import { randomUUID, getSecureTimestampSync, isEthereumChain } from "@phantom/utils";
+import { ANALYTICS_HEADERS, DEFAULT_WALLET_API_URL } from "@phantom/constants";
 import { ApiKeyStamper } from "@phantom/api-key-stamper";
-import { base64urlEncode } from "@phantom/base64url";
+import { base64urlEncode, stringToBase64url } from "@phantom/base64url";
 import bs58 from "bs58";
 
 // package.json
 var package_default = {
   name: "@phantom/server-sdk",
-  version: "1.0.0-beta.9",
+  version: "1.0.0",
   description: "Server SDK for Phantom Wallet",
+  repository: {
+    type: "git",
+    url: "https://github.com/phantom/phantom-connect-sdk",
+    directory: "packages/server-sdk"
+  },
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -69,8 +71,7 @@ var package_default = {
 
 // src/index.ts
 import {
-  parseMessage,
-  parseTransactionToBase64Url,
+  parseToKmsTransaction,
   parseSignMessageResponse,
   parseTransactionResponse
 } from "@phantom/parsers";
@@ -89,8 +90,7 @@ import {
 import { NetworkId } from "@phantom/constants";
 import { ApiKeyStamper as ApiKeyStamper2 } from "@phantom/api-key-stamper";
 import {
-  parseMessage as parseMessage2,
-  parseTransactionToBase64Url as parseTransactionToBase64Url2,
+  parseToKmsTransaction as parseToKmsTransaction2,
   parseSignMessageResponse as parseSignMessageResponse2,
   parseTransactionResponse as parseTransactionResponse2
 } from "@phantom/parsers";
@@ -123,25 +123,23 @@ var ServerSDK = class {
       {
         apiBaseUrl: config.apiBaseUrl || DEFAULT_WALLET_API_URL,
         organizationId: config.organizationId,
-        headers
+        headers,
+        walletType: "server-wallet"
       },
       stamper
     );
   }
   /**
    * Sign a message - supports plain text and automatically converts to base64url
+   * Routes to appropriate signing method based on network type
    * @param params - Message parameters with plain text message
    * @returns Promise<ParsedSignatureResult> - Parsed signature with explorer URL
    */
   async signMessage(params) {
-    const parsedMessage = parseMessage(params.message);
-    const signMessageParams = {
-      walletId: params.walletId,
-      message: parsedMessage.base64url,
-      networkId: params.networkId,
-      derivationIndex: params.derivationIndex
-    };
-    const rawResponse = await this.client.signMessage(signMessageParams);
+    const rawResponse = isEthereumChain(params.networkId) ? await this.client.ethereumSignMessage({
+      ...params,
+      message: stringToBase64url(params.message)
+    }) : await this.client.signUtf8Message(params);
     return parseSignMessageResponse(rawResponse, params.networkId);
   }
   /**
@@ -150,15 +148,18 @@ var ServerSDK = class {
    * @returns Promise<ParsedTransactionResult> - Parsed transaction result without hash
    */
   async signTransaction(params) {
-    const parsedTransaction = await parseTransactionToBase64Url(params.transaction, params.networkId);
-    const signTransactionParams = {
+    const parsedTransaction = await parseToKmsTransaction(params.transaction, params.networkId);
+    const transactionPayload = parsedTransaction.parsed;
+    if (!transactionPayload) {
+      throw new Error("Failed to parse transaction: no valid encoding found");
+    }
+    const rawResponse = await this.client.signTransaction({
       walletId: params.walletId,
-      transaction: parsedTransaction.base64url,
+      transaction: transactionPayload,
       networkId: params.networkId,
       derivationIndex: params.derivationIndex,
       account: params.account
-    };
-    const rawResponse = await this.client.signTransaction(signTransactionParams);
+    });
     return await parseTransactionResponse(rawResponse.rawTransaction, params.networkId);
   }
   /**
@@ -167,15 +168,18 @@ var ServerSDK = class {
    * @returns Promise<ParsedTransactionResult> - Parsed transaction result with hash and explorer URL
    */
   async signAndSendTransaction(params) {
-    const parsedTransaction = await parseTransactionToBase64Url(params.transaction, params.networkId);
-    const signAndSendParams = {
+    const parsedTransaction = await parseToKmsTransaction(params.transaction, params.networkId);
+    const transactionPayload = parsedTransaction.parsed;
+    if (!transactionPayload) {
+      throw new Error("Failed to parse transaction: no valid encoding found");
+    }
+    const rawResponse = await this.client.signAndSendTransaction({
       walletId: params.walletId,
-      transaction: parsedTransaction.base64url,
+      transaction: transactionPayload,
       networkId: params.networkId,
       derivationIndex: params.derivationIndex,
       account: params.account
-    };
-    const rawResponse = await this.client.signAndSendTransaction(signAndSendParams);
+    });
     return await parseTransactionResponse(rawResponse.rawTransaction, params.networkId, rawResponse.hash);
   }
   createOrganization(name, keyPair) {
@@ -184,7 +188,8 @@ var ServerSDK = class {
       {
         apiBaseUrl: this.config.apiBaseUrl || DEFAULT_WALLET_API_URL,
         organizationId: this.config.organizationId,
-        headers
+        headers,
+        walletType: "server-wallet"
       },
       new ApiKeyStamper({
         apiSecretKey: keyPair.secretKey
@@ -229,9 +234,8 @@ export {
   getNetworkDescription,
   getNetworkIdsByChain,
   getSupportedNetworkIds,
-  parseMessage2 as parseMessage,
   parseSignMessageResponse2 as parseSignMessageResponse,
+  parseToKmsTransaction2 as parseToKmsTransaction,
   parseTransactionResponse2 as parseTransactionResponse,
-  parseTransactionToBase64Url2 as parseTransactionToBase64Url,
   supportsTransactionSubmission
 };

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@phantom/server-sdk",
-  "version": "1.0.0-beta.9",
+  "version": "1.0.0",
   "description": "Server SDK for Phantom Wallet",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/phantom/phantom-connect-sdk",
+    "directory": "packages/server-sdk"
+  },
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -37,12 +42,12 @@
     "typescript": "^5.0.4"
   },
   "dependencies": {
-    "@phantom/api-key-stamper": "^1.0.0-beta.6",
-    "@phantom/base64url": "^1.0.0-beta.6",
-    "@phantom/client": "^1.0.0-beta.9",
-    "@phantom/constants": "^1.0.0-beta.6",
-    "@phantom/parsers": "^1.0.0-beta.6",
-    "@phantom/utils": "^1.0.0-beta.3",
+    "@phantom/api-key-stamper": "^1.0.0",
+    "@phantom/base64url": "^1.0.0",
+    "@phantom/client": "^1.0.0",
+    "@phantom/constants": "^1.0.0",
+    "@phantom/parsers": "^1.0.0",
+    "@phantom/utils": "^1.0.0",
     "bs58": "^6.0.0"
   },
   "files": [