@phantom/server-sdk 0.0.4 → 0.1.0

package/README.md

@@ -1,6 +1,6 @@
 # Phantom Server SDK
 
-The Phantom Server SDK provides a secure and straightforward way to create and manage wallets, sign transactions, and interact with multiple blockchains from your backend services.
+The Phantom Server SDK provides a secure and straightforward way to create and manage wallets, sign transactions, and interact with multiple blockchains from your backend services. This SDK is designed for server-side applications that need programmatic access to Phantom's wallet infrastructure.
 
 ## 📖 Documentation
 
@@ -15,8 +15,19 @@ Visit **[docs.phantom.com/server-sdk](https://docs.phantom.com/server-sdk)** for
 - Best Practices
 - Security Considerations
 
+## Features
+
+- 🔐 **Secure wallet creation and management** - Create wallets programmatically with enterprise-grade security
+- ✍️ **Transaction signing** - Sign and optionally submit transactions across multiple blockchains
+- 📝 **Message signing** - Sign arbitrary messages for authentication or verification
+- 🌐 **Multi-chain support** - Works with Solana, Ethereum, Polygon, Sui, Bitcoin, Base and other major blockchains
+- 🔑 **Ed25519 authentication** - Secure API authentication using cryptographic signatures
+- 📊 **Wallet listing and pagination** - Efficiently manage large numbers of wallets
+
 ## Installation
 
+Install the Server SDK using your preferred package manager:
+
 ```bash
 npm install @phantom/server-sdk
 ```
@@ -29,33 +40,188 @@ yarn add @phantom/server-sdk
 pnpm add @phantom/server-sdk
 ```
 
+## Prerequisites
+
+Before using the SDK, you need:
+
+1. **Phantom Organization Credentials**
+
+   - Organization ID
+   - Organization Private Key (base58 encoded)
+   - API Base URL
+
+   These credentials are provided when you create an organization with Phantom.
+
+2. **Node.js** version 16 or higher
+
+## Security First
+
+The private key for your organization is meant to be stored **ONLY on your server** in a secure environment.
+
+- **NEVER expose this key in client-side code**
+- **NEVER commit it to version control**
+- **Always use environment variables or secret management systems**
+
 ## Quick Start
 
+### 1. Set up Environment Variables
+
+Create a `.env` file in your project root:
+
+```env
+ORGANIZATION_ID=your-organization-id
+PRIVATE_KEY=your-base58-encoded-private-key
+API_URL=https://api.phantom.app/wallet
+```
+
+### 2. Initialize the SDK
+
 ```typescript
-import { ServerSDK, NetworkId } from '@phantom/server-sdk';
+import { ServerSDK, NetworkId } from "@phantom/server-sdk";
+import dotenv from "dotenv";
+
+// Load environment variables
+dotenv.config();
 
 // Initialize the SDK
 const sdk = new ServerSDK({
-  organizationId: process.env.PHANTOM_ORGANIZATION_ID!,
-  apiPrivateKey: process.env.PHANTOM_PRIVATE_KEY!,
-  apiBaseUrl: process.env.PHANTOM_API_URL!
+  organizationId: process.env.ORGANIZATION_ID!,
+  apiPrivateKey: process.env.PRIVATE_KEY!,
+  apiBaseUrl: process.env.API_URL!,
 });
 
 // Create a wallet
-const wallet = await sdk.createWallet('My First Wallet');
-console.log('Wallet ID:', wallet.walletId);
-console.log('Addresses:', wallet.addresses);
-
-// Sign a message
-const signature = await sdk.signMessage(
-  wallet.walletId,
-  'Hello, Phantom!',
-  NetworkId.SOLANA_MAINNET
+const wallet = await sdk.createWallet("My First Wallet");
+console.log("Wallet ID:", wallet.walletId);
+console.log("Addresses:", wallet.addresses);
+
+// Sign a message (base64url encoded)
+const message = Buffer.from("Hello, Phantom!").toString("base64url");
+const signature = await sdk.signMessage(wallet.walletId, message, NetworkId.SOLANA_MAINNET);
+console.log("Signature:", signature);
+```
+
+## Usage Examples
+
+### Creating a Wallet
+
+```typescript
+// Create a wallet with a custom name
+const wallet = await sdk.createWallet("User Wallet 123");
+
+// Access addresses for different chains
+const solanaAddress = wallet.addresses.find(addr => addr.addressType === "Solana")?.address;
+
+const ethereumAddress = wallet.addresses.find(addr => addr.addressType === "Ethereum")?.address;
+
+console.log("Solana address:", solanaAddress);
+console.log("Ethereum address:", ethereumAddress);
+```
+
+### Signing and Sending Transactions
+
+```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);
+
+// Serialize the transaction
+const serializedTx = transaction.serialize({
+  requireAllSignatures: false,
+  verifySignatures: false,
+});
+
+// Convert to base64url
+const transactionBase64 = Buffer.from(serializedTx).toString("base64url");
+
+// Sign and send the transaction
+const signedTx = await sdk.signAndSendTransaction(wallet.walletId, transactionBase64, NetworkId.SOLANA_MAINNET);
+
+console.log("Signed transaction:", signedTx.rawTransaction);
+```
+
+### Signing Messages
+
+```typescript
+// Sign a message for Solana (base64url encoded)
+const solanaMessage = Buffer.from("Please sign this message to authenticate").toString("base64url");
+const solanaSignature = await sdk.signMessage(wallet.walletId, solanaMessage, NetworkId.SOLANA_MAINNET);
+
+// Sign a message for Ethereum (base64url encoded)
+const ethMessage = Buffer.from("Sign in to our dApp").toString("base64url");
+const ethSignature = await sdk.signMessage(wallet.walletId, ethMessage, NetworkId.ETHEREUM_MAINNET);
+```
+
+### Managing Wallets
+
+```typescript
+// Get all wallets for your organization with pagination
+const result = await sdk.getWallets(20, 0); // limit: 20, offset: 0
+
+console.log(`Total wallets: ${result.totalCount}`);
+console.log("Wallets:", result.wallets);
+
+// Get addresses for a specific wallet
+const addresses = await sdk.getWalletAddresses(walletId);
+
+// Get specific addresses by derivation path
+const customAddresses = await sdk.getWalletAddresses(
+  walletId,
+  ["m/44'/501'/0'/0'", "m/44'/60'/0'/0/0"], // Solana and Ethereum
 );
-console.log('Signature:', signature);
 ```
 
-For complete documentation and examples, visit **[docs.phantom.com/server-sdk](https://docs.phantom.com/server-sdk)**.
+## Network Support
+
+The SDK supports multiple blockchain networks through the `NetworkId` enum:
+
+### Solana Networks
+
+- `NetworkId.SOLANA_MAINNET` - Solana Mainnet-Beta
+- `NetworkId.SOLANA_DEVNET` - Solana Devnet
+- `NetworkId.SOLANA_TESTNET` - Solana Testnet
+
+### Ethereum Networks
+
+- `NetworkId.ETHEREUM_MAINNET` - Ethereum Mainnet
+- `NetworkId.ETHEREUM_GOERLI` - Goerli Testnet
+- `NetworkId.ETHEREUM_SEPOLIA` - Sepolia Testnet
+
+### Other EVM 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
+
+### Future Support
+
+- `NetworkId.BITCOIN_MAINNET` - Bitcoin Mainnet
+- `NetworkId.SUI_MAINNET` - Sui Mainnet
+
+## API Reference
+
+For complete API documentation, visit **[docs.phantom.com/server-sdk](https://docs.phantom.com/server-sdk)**.
+
+### Key Methods
+
+- `createWallet(walletName?)` - Creates a new wallet
+- `signAndSendTransaction(walletId, transaction, networkId)` - Signs and optionally submits transactions
+- `signMessage(walletId, message, networkId)` - Signs arbitrary messages
+- `getWalletAddresses(walletId, derivationPaths?)` - Retrieves wallet addresses
+- `getWallets(limit?, offset?)` - Lists all wallets with pagination
 
 ## Resources
 
@@ -68,3 +234,7 @@ For complete documentation and examples, visit **[docs.phantom.com/server-sdk](h
 ## License
 
 This SDK is distributed under the MIT License. See the [LICENSE](../../LICENSE) file for details.
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](../../CONTRIBUTING.md) for details.

package/dist/index.d.ts

@@ -1,22 +1,20 @@
-import { ServerSDKConfig, CreateWalletResult, Transaction, SignedTransaction, GetWalletsResult } from "./types";
-import { NetworkId } from "./caip2-mappings";
-export interface SubmissionConfig {
-    chain: string;
-    network: string;
+import { PhantomClient } from '@phantom/client';
+export { CreateWalletResult, DerivationPath, GetWalletsResult, NetworkConfig, NetworkId, PhantomClient, SignedTransaction, Transaction, Wallet, deriveSubmissionConfig, generateKeyPair, getDerivationPathForNetwork, getNetworkConfig, getNetworkDescription, getNetworkIdsByChain, getSupportedNetworkIds, supportsTransactionSubmission } from '@phantom/client';
+export { ApiKeyStamper } from '@phantom/api-key-stamper';
+import { DerivationInfoAddressFormatEnum } from '@phantom/openapi-wallet-service';
+
+interface WalletAddress {
+    addressType: DerivationInfoAddressFormatEnum;
+    address: string;
 }
-export { NetworkId, deriveSubmissionConfig, supportsTransactionSubmission, getNetworkDescription, getSupportedNetworkIds, getNetworkIdsByChain } from "./caip2-mappings";
-export declare class ServerSDK {
-    private config;
-    private kmsApi;
-    private signingKeypair;
+
+interface ServerSDKConfig {
+    organizationId: string;
+    apiBaseUrl: string;
+    apiPrivateKey: string;
+}
+declare class ServerSDK extends PhantomClient {
     constructor(config: ServerSDKConfig);
-    createWallet(walletName?: string): Promise<CreateWalletResult>;
-    signAndSendTransaction(walletId: string, transaction: Transaction, networkId: NetworkId): Promise<SignedTransaction>;
-    getWalletAddresses(walletId: string, derivationPaths?: string[]): Promise<{
-        addressType: string;
-        address: string;
-    }[]>;
-    signMessage(walletId: string, message: string, networkId: NetworkId): Promise<string>;
-    getWallets(limit?: number, offset?: number): Promise<GetWalletsResult>;
 }
-export * from "./types";
+
+export { ServerSDK, ServerSDKConfig, WalletAddress };

package/dist/index.js

@@ -1,239 +1,71 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServerSDK = exports.getNetworkIdsByChain = exports.getSupportedNetworkIds = exports.getNetworkDescription = exports.supportsTransactionSubmission = exports.deriveSubmissionConfig = exports.NetworkId = void 0;
-const auth_1 = require("./auth");
-const constants_1 = require("./constants");
-const caip2_mappings_1 = require("./caip2-mappings");
-const bs58_1 = __importDefault(require("bs58"));
-const openapi_wallet_service_1 = require("@phantom/openapi-wallet-service");
-const tweetnacl_1 = __importDefault(require("tweetnacl"));
-// Export CAIP-2 utilities and enums
-var caip2_mappings_2 = require("./caip2-mappings");
-Object.defineProperty(exports, "NetworkId", { enumerable: true, get: function () { return caip2_mappings_2.NetworkId; } });
-Object.defineProperty(exports, "deriveSubmissionConfig", { enumerable: true, get: function () { return caip2_mappings_2.deriveSubmissionConfig; } });
-Object.defineProperty(exports, "supportsTransactionSubmission", { enumerable: true, get: function () { return caip2_mappings_2.supportsTransactionSubmission; } });
-Object.defineProperty(exports, "getNetworkDescription", { enumerable: true, get: function () { return caip2_mappings_2.getNetworkDescription; } });
-Object.defineProperty(exports, "getSupportedNetworkIds", { enumerable: true, get: function () { return caip2_mappings_2.getSupportedNetworkIds; } });
-Object.defineProperty(exports, "getNetworkIdsByChain", { enumerable: true, get: function () { return caip2_mappings_2.getNetworkIdsByChain; } });
-class ServerSDK {
-    constructor(config) {
-        this.config = config;
-        if (!config.organizationId || !config.apiBaseUrl) {
-            throw new Error("organizationId and apiBaseUrl are required");
-        }
-        // Decode the private key from base58
-        const privateKeyBytes = bs58_1.default.decode(config.apiPrivateKey);
-        this.signingKeypair = tweetnacl_1.default.sign.keyPair.fromSecretKey(privateKeyBytes);
-        // Create authenticated axios instance
-        const authenticatedAxios = (0, auth_1.createAuthenticatedAxiosInstance)(this.signingKeypair);
-        // Configure the KMS API client with authentication
-        const configuration = new openapi_wallet_service_1.Configuration({
-            basePath: config.apiBaseUrl,
-        });
-        // Pass the authenticated axios instance to the KMS API
-        this.kmsApi = new openapi_wallet_service_1.KMSRPCApi(configuration, config.apiBaseUrl, authenticatedAxios);
-    }
-    async createWallet(walletName) {
-        try {
-            // Create wallet request
-            const walletRequest = {
-                organizationId: this.config.organizationId,
-                walletName: walletName || `Wallet ${Date.now()}`,
-                accounts: [constants_1.DerivationPath.Solana, constants_1.DerivationPath.Ethereum, constants_1.DerivationPath.Bitcoin, constants_1.DerivationPath.Sui],
-            };
-            console.log("Creating wallet with request:", walletRequest);
-            const request = {
-                method: openapi_wallet_service_1.CreateWalletMethodEnum.createWallet,
-                params: walletRequest,
-                timestampMs: Date.now(),
-            };
-            const response = await this.kmsApi.postKmsRpc(request);
-            const walletResult = response.data.result;
-            console.log("Wallet created successfully:", walletResult);
-            // Fetch the accounts
-            const requestAccounts = {
-                method: openapi_wallet_service_1.GetAccountsMethodEnum.getAccounts,
-                params: {
-                    accounts: [constants_1.DerivationPath.Solana, constants_1.DerivationPath.Ethereum, constants_1.DerivationPath.Bitcoin, constants_1.DerivationPath.Sui],
-                    organizationId: this.config.organizationId,
-                    walletId: walletResult.walletId,
-                },
-                timestampMs: Date.now(),
-            };
-            console.log("Fetching accounts for wallet:", walletResult.walletId);
-            const accountsResponse = await this.kmsApi.postKmsRpc(requestAccounts);
-            console.log("Accounts fetched successfully:", accountsResponse.data.result);
-            const accountsResult = accountsResponse.data.result;
-            return {
-                walletId: walletResult.walletId,
-                addresses: accountsResult.map(account => ({
-                    addressType: account.addressFormat,
-                    address: account.publicKey,
-                })),
-            };
-        }
-        catch (error) {
-            console.error("Failed to create wallet:", error.response?.data || error.message);
-            throw new Error(`Failed to create wallet: ${error.response?.data?.message || error.message}`);
-        }
-    }
-    async signAndSendTransaction(walletId, transaction, networkId) {
-        try {
-            // Encode the Uint8Array as a base64 string
-            const encodedTransaction = Buffer.from(transaction).toString('base64url');
-            const submissionConfig = (0, caip2_mappings_1.deriveSubmissionConfig)(networkId);
-            // If we don't have a submission config, the transaction will only be signed, not submitted
-            if (!submissionConfig) {
-                console.warn(`No submission config available for network ${networkId}. Transaction will be signed but not submitted.`);
-            }
-            // Get network configuration
-            const networkConfig = (0, constants_1.getNetworkConfig)(networkId);
-            if (!networkConfig) {
-                throw new Error(`Unsupported network ID: ${networkId}`);
-            }
-            const derivationInfo = {
-                derivationPath: networkConfig.derivationPath,
-                curve: networkConfig.curve,
-                addressFormat: networkConfig.addressFormat,
-            };
-            // Sign transaction request - only include submissionConfig if available
-            const signRequest = {
-                organizationId: this.config.organizationId,
-                walletId: walletId,
-                transaction: encodedTransaction,
-                derivationInfo: derivationInfo,
-            };
-            // Add submission config if available
-            if (submissionConfig) {
-                signRequest.submissionConfig = submissionConfig;
-            }
-            const request = {
-                method: openapi_wallet_service_1.SignTransactionMethodEnum.signTransaction,
-                params: signRequest,
-                timestampMs: Date.now(),
-            };
-            const response = await this.kmsApi.postKmsRpc(request);
-            const result = response.data.result;
-            return {
-                rawTransaction: result.transaction, // Base64 encoded signed transaction
-            };
-        }
-        catch (error) {
-            console.error("Failed to sign and send transaction:", error.response?.data || error.message);
-            throw new Error(`Failed to sign and send transaction: ${error.response?.data?.message || error.message}`);
-        }
-    }
-    async getWalletAddresses(walletId, derivationPaths) {
-        try {
-            const paths = derivationPaths || [
-                constants_1.DerivationPath.Solana,
-                constants_1.DerivationPath.Ethereum,
-                constants_1.DerivationPath.Bitcoin,
-                constants_1.DerivationPath.Sui,
-            ];
-            const requestAccounts = {
-                method: openapi_wallet_service_1.GetAccountsMethodEnum.getAccounts,
-                params: {
-                    accounts: paths,
-                    organizationId: this.config.organizationId,
-                    walletId: walletId,
-                },
-                timestampMs: Date.now(),
-            };
-            const accountsResponse = await this.kmsApi.postKmsRpc(requestAccounts);
-            const accountsResult = accountsResponse.data.result;
-            return accountsResult.map(account => ({
-                addressType: account.addressFormat,
-                address: account.publicKey,
-            }));
-        }
-        catch (error) {
-            console.error("Failed to get wallet addresses:", error.response?.data || error.message);
-            throw new Error(`Failed to get wallet addresses: ${error.response?.data?.message || error.message}`);
-        }
-    }
-    async signMessage(walletId, message, networkId) {
-        try {
-            // Get network configuration
-            const networkConfig = (0, constants_1.getNetworkConfig)(networkId);
-            if (!networkConfig) {
-                throw new Error(`Unsupported network ID: ${networkId}`);
-            }
-            const derivationInfo = {
-                derivationPath: networkConfig.derivationPath,
-                curve: networkConfig.curve,
-                addressFormat: networkConfig.addressFormat,
-            };
-            const base64StringMessage = Buffer.from(message, "utf8").toString("base64url");
-            const signRequest = {
-                organizationId: this.config.organizationId,
-                walletId: walletId,
-                payload: base64StringMessage,
-                algorithm: networkConfig.algorithm,
-                derivationInfo: derivationInfo,
-            };
-            const request = {
-                method: openapi_wallet_service_1.SignRawPayloadMethodEnum.signRawPayload,
-                params: signRequest,
-                timestampMs: Date.now(),
-            };
-            const response = await this.kmsApi.postKmsRpc(request);
-            const result = response.data.result;
-            // Return the base64 encoded signature
-            return result.signature;
-        }
-        catch (error) {
-            console.error("Failed to sign message:", error.response?.data || error.message);
-            throw new Error(`Failed to sign message: ${error.response?.data?.message || error.message}`);
-        }
-    }
-    async getWallets(limit, offset) {
-        try {
-            const request = {
-                method: "getOrganizationWallets",
-                params: {
-                    organizationId: this.config.organizationId,
-                    limit: limit || 20,
-                    offset: offset || 0,
-                },
-                timestampMs: Date.now(),
-            };
-            console.log("Fetching wallets for organization:", this.config.organizationId);
-            const response = await this.kmsApi.postKmsRpc(request);
-            const result = response.data.result;
-            console.log(`Fetched ${result.wallets.length} wallets out of ${result.totalCount} total`);
-            return {
-                wallets: result.wallets.map((wallet) => ({
-                    walletId: wallet.walletId,
-                    walletName: wallet.walletName,
-                })),
-                totalCount: result.totalCount,
-                limit: result.limit,
-                offset: result.offset,
-            };
-        }
-        catch (error) {
-            console.error("Failed to get wallets:", error.response?.data || error.message);
-            throw new Error(`Failed to get wallets: ${error.response?.data?.message || error.message}`);
-        }
-    }
-}
-exports.ServerSDK = ServerSDK;
-__exportStar(require("./types"), exports);
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  ApiKeyStamper: () => import_api_key_stamper2.ApiKeyStamper,
+  DerivationPath: () => import_client2.DerivationPath,
+  NetworkId: () => import_client2.NetworkId,
+  PhantomClient: () => import_client2.PhantomClient,
+  ServerSDK: () => ServerSDK,
+  deriveSubmissionConfig: () => import_client2.deriveSubmissionConfig,
+  generateKeyPair: () => import_client2.generateKeyPair,
+  getDerivationPathForNetwork: () => import_client2.getDerivationPathForNetwork,
+  getNetworkConfig: () => import_client2.getNetworkConfig,
+  getNetworkDescription: () => import_client2.getNetworkDescription,
+  getNetworkIdsByChain: () => import_client2.getNetworkIdsByChain,
+  getSupportedNetworkIds: () => import_client2.getSupportedNetworkIds,
+  supportsTransactionSubmission: () => import_client2.supportsTransactionSubmission
+});
+module.exports = __toCommonJS(src_exports);
+var import_client = require("@phantom/client");
+var import_api_key_stamper = require("@phantom/api-key-stamper");
+var import_client2 = require("@phantom/client");
+var import_api_key_stamper2 = require("@phantom/api-key-stamper");
+var ServerSDK = class extends import_client.PhantomClient {
+  constructor(config) {
+    const stamper = new import_api_key_stamper.ApiKeyStamper({
+      apiSecretKey: config.apiPrivateKey
+    });
+    super(
+      {
+        apiBaseUrl: config.apiBaseUrl,
+        organizationId: config.organizationId
+      },
+      stamper
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApiKeyStamper,
+  DerivationPath,
+  NetworkId,
+  PhantomClient,
+  ServerSDK,
+  deriveSubmissionConfig,
+  generateKeyPair,
+  getDerivationPathForNetwork,
+  getNetworkConfig,
+  getNetworkDescription,
+  getNetworkIdsByChain,
+  getSupportedNetworkIds,
+  supportsTransactionSubmission
+});

package/dist/index.mjs

@@ -0,0 +1,46 @@
+// src/index.ts
+import { PhantomClient } from "@phantom/client";
+import { ApiKeyStamper } from "@phantom/api-key-stamper";
+import {
+  PhantomClient as PhantomClient2,
+  NetworkId,
+  deriveSubmissionConfig,
+  supportsTransactionSubmission,
+  getNetworkDescription,
+  getSupportedNetworkIds,
+  getNetworkIdsByChain,
+  DerivationPath,
+  getDerivationPathForNetwork,
+  getNetworkConfig,
+  generateKeyPair
+} from "@phantom/client";
+import { ApiKeyStamper as ApiKeyStamper2 } from "@phantom/api-key-stamper";
+var ServerSDK = class extends PhantomClient {
+  constructor(config) {
+    const stamper = new ApiKeyStamper({
+      apiSecretKey: config.apiPrivateKey
+    });
+    super(
+      {
+        apiBaseUrl: config.apiBaseUrl,
+        organizationId: config.organizationId
+      },
+      stamper
+    );
+  }
+};
+export {
+  ApiKeyStamper2 as ApiKeyStamper,
+  DerivationPath,
+  NetworkId,
+  PhantomClient2 as PhantomClient,
+  ServerSDK,
+  deriveSubmissionConfig,
+  generateKeyPair,
+  getDerivationPathForNetwork,
+  getNetworkConfig,
+  getNetworkDescription,
+  getNetworkIdsByChain,
+  getSupportedNetworkIds,
+  supportsTransactionSubmission
+};

package/package.json

@@ -1,29 +1,42 @@
 {
   "name": "@phantom/server-sdk",
-  "version": "0.0.4",
+  "version": "0.1.0",
   "description": "Server SDK for Phantom Wallet",
   "main": "dist/index.js",
+  "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
   "scripts": {
-    "build": "tsc",
+    "build": "rimraf ./dist && tsup src/index.ts --format cjs,esm --dts",
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
     "test": "jest",
-    "test:watch": "jest --watch"
+    "test:watch": "jest --watch",
+    "lint": "eslint src --ext .ts,.tsx",
+    "prettier": "prettier --write \"src/**/*.{ts,tsx}\""
   },
   "devDependencies": {
     "@types/jest": "^29.5.12",
     "@types/node": "^20.11.0",
     "dotenv": "^16.4.1",
+    "eslint": "8.53.0",
     "jest": "^29.7.0",
+    "prettier": "^3.5.2",
+    "rimraf": "^6.0.1",
     "ts-jest": "^29.1.2",
+    "tsup": "^6.7.0",
     "typescript": "^5.0.4"
   },
   "dependencies": {
-    "@phantom/openapi-wallet-service": "^0.1.5",
-    "axios": "^1.10.0",
-    "bs58": "^6.0.0",
-    "tweetnacl": "^1.0.3"
+    "@phantom/api-key-stamper": "workspace:^",
+    "@phantom/client": "workspace:^",
+    "@phantom/openapi-wallet-service": "^0.1.7"
   },
   "files": [
     "dist"

package/dist/auth.d.ts

@@ -1,6 +0,0 @@
-import { AxiosInstance } from 'axios';
-import nacl from 'tweetnacl';
-/**
- * Creates an authenticated axios instance that signs requests with Ed25519
- */
-export declare function createAuthenticatedAxiosInstance(signingKeypair: nacl.SignKeyPair): AxiosInstance;

package/dist/auth.js

@@ -1,23 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAuthenticatedAxiosInstance = createAuthenticatedAxiosInstance;
-const axios_1 = __importDefault(require("axios"));
-const tweetnacl_1 = __importDefault(require("tweetnacl"));
-/**
- * Creates an authenticated axios instance that signs requests with Ed25519
- */
-function createAuthenticatedAxiosInstance(signingKeypair) {
-    const instance = axios_1.default.create();
-    instance.interceptors.request.use((config) => {
-        // Sign the message
-        const requestBody = typeof config.data === "string" ? config.data : JSON.stringify(config.data);
-        const dataUtf8 = Buffer.from(requestBody, "utf8");
-        const signature = tweetnacl_1.default.sign.detached(dataUtf8, signingKeypair.secretKey);
-        config.headers["X-Phantom-Sig"] = Buffer.from(signature).toString("base64url");
-        return config;
-    });
-    return instance;
-}

package/dist/caip2-mappings.d.ts

@@ -1,59 +0,0 @@
-interface SubmissionConfig {
-    chain: string;
-    network: string;
-}
-/**
- * User-friendly enum for CAIP-2 network identifiers
- * Use these constants instead of hardcoding network IDs
- */
-export declare enum NetworkId {
-    SOLANA_MAINNET = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
-    SOLANA_DEVNET = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
-    SOLANA_TESTNET = "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z",
-    ETHEREUM_MAINNET = "eip155:1",
-    ETHEREUM_GOERLI = "eip155:5",
-    ETHEREUM_SEPOLIA = "eip155:11155111",
-    POLYGON_MAINNET = "eip155:137",
-    POLYGON_MUMBAI = "eip155:80001",
-    OPTIMISM_MAINNET = "eip155:10",
-    OPTIMISM_GOERLI = "eip155:420",
-    ARBITRUM_ONE = "eip155:42161",
-    ARBITRUM_GOERLI = "eip155:421613",
-    BASE_MAINNET = "eip155:8453",
-    BASE_GOERLI = "eip155:84531",
-    BASE_SEPOLIA = "eip155:84532",
-    BITCOIN_MAINNET = "bip122:000000000019d6689c085ae165831e93",
-    BITCOIN_TESTNET = "bip122:000000000933ea01ad0ee984209779ba",
-    SUI_MAINNET = "sui:35834a8a",
-    SUI_TESTNET = "sui:4c78adac"
-}
-/**
- * Derive SubmissionConfig from a CAIP-2 network ID
- * @param networkId - CAIP-2 compliant network ID (e.g., 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp')
- * @returns SubmissionConfig if network supports transaction submission, undefined otherwise
- */
-export declare function deriveSubmissionConfig(networkId: string): SubmissionConfig | undefined;
-/**
- * Check if a network ID supports transaction submission
- * @param networkId - CAIP-2 compliant network ID
- * @returns true if the network supports transaction submission
- */
-export declare function supportsTransactionSubmission(networkId: string): boolean;
-/**
- * Get network description for a CAIP-2 network ID
- * @param networkId - CAIP-2 compliant network ID
- * @returns Network description or undefined if not found
- */
-export declare function getNetworkDescription(networkId: string): string | undefined;
-/**
- * List all supported CAIP-2 network IDs
- * @returns Array of supported network IDs
- */
-export declare function getSupportedNetworkIds(): string[];
-/**
- * Get all networks for a specific chain
- * @param chain - Chain name (e.g., 'solana', 'ethereum')
- * @returns Array of network IDs for the specified chain
- */
-export declare function getNetworkIdsByChain(chain: string): string[];
-export {};

package/dist/caip2-mappings.js

@@ -1,192 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NetworkId = void 0;
-exports.deriveSubmissionConfig = deriveSubmissionConfig;
-exports.supportsTransactionSubmission = supportsTransactionSubmission;
-exports.getNetworkDescription = getNetworkDescription;
-exports.getSupportedNetworkIds = getSupportedNetworkIds;
-exports.getNetworkIdsByChain = getNetworkIdsByChain;
-/**
- * User-friendly enum for CAIP-2 network identifiers
- * Use these constants instead of hardcoding network IDs
- */
-var NetworkId;
-(function (NetworkId) {
-    // Solana Networks
-    NetworkId["SOLANA_MAINNET"] = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
-    NetworkId["SOLANA_DEVNET"] = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
-    NetworkId["SOLANA_TESTNET"] = "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z";
-    // Ethereum Networks
-    NetworkId["ETHEREUM_MAINNET"] = "eip155:1";
-    NetworkId["ETHEREUM_GOERLI"] = "eip155:5";
-    NetworkId["ETHEREUM_SEPOLIA"] = "eip155:11155111";
-    // Polygon Networks
-    NetworkId["POLYGON_MAINNET"] = "eip155:137";
-    NetworkId["POLYGON_MUMBAI"] = "eip155:80001";
-    // Optimism Networks
-    NetworkId["OPTIMISM_MAINNET"] = "eip155:10";
-    NetworkId["OPTIMISM_GOERLI"] = "eip155:420";
-    // Arbitrum Networks
-    NetworkId["ARBITRUM_ONE"] = "eip155:42161";
-    NetworkId["ARBITRUM_GOERLI"] = "eip155:421613";
-    // Base Networks
-    NetworkId["BASE_MAINNET"] = "eip155:8453";
-    NetworkId["BASE_GOERLI"] = "eip155:84531";
-    NetworkId["BASE_SEPOLIA"] = "eip155:84532";
-    // Bitcoin Networks (for future support)
-    NetworkId["BITCOIN_MAINNET"] = "bip122:000000000019d6689c085ae165831e93";
-    NetworkId["BITCOIN_TESTNET"] = "bip122:000000000933ea01ad0ee984209779ba";
-    // Sui Networks (for future support)
-    NetworkId["SUI_MAINNET"] = "sui:35834a8a";
-    NetworkId["SUI_TESTNET"] = "sui:4c78adac";
-})(NetworkId || (exports.NetworkId = NetworkId = {}));
-const CAIP2_NETWORK_MAPPINGS = {
-    // Solana networks
-    'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp': {
-        chain: 'solana',
-        network: 'mainnet',
-        description: 'Solana Mainnet-Beta'
-    },
-    'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1': {
-        chain: 'solana',
-        network: 'devnet',
-        description: 'Solana Devnet'
-    },
-    'solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z': {
-        chain: 'solana',
-        network: 'testnet',
-        description: 'Solana Testnet'
-    },
-    // Ethereum/EVM networks
-    'eip155:1': {
-        chain: 'ethereum',
-        network: 'mainnet',
-        description: 'Ethereum Mainnet'
-    },
-    'eip155:5': {
-        chain: 'ethereum',
-        network: 'goerli',
-        description: 'Goerli Testnet'
-    },
-    'eip155:11155111': {
-        chain: 'ethereum',
-        network: 'sepolia',
-        description: 'Sepolia Testnet'
-    },
-    'eip155:137': {
-        chain: 'polygon',
-        network: 'mainnet',
-        description: 'Polygon Mainnet'
-    },
-    'eip155:80001': {
-        chain: 'polygon',
-        network: 'mumbai',
-        description: 'Polygon Mumbai Testnet'
-    },
-    'eip155:10': {
-        chain: 'optimism',
-        network: 'mainnet',
-        description: 'Optimism Mainnet'
-    },
-    'eip155:420': {
-        chain: 'optimism',
-        network: 'goerli',
-        description: 'Optimism Goerli Testnet'
-    },
-    'eip155:42161': {
-        chain: 'arbitrum',
-        network: 'mainnet',
-        description: 'Arbitrum One'
-    },
-    'eip155:421613': {
-        chain: 'arbitrum',
-        network: 'goerli',
-        description: 'Arbitrum Goerli'
-    },
-    'eip155:8453': {
-        chain: 'base',
-        network: 'mainnet',
-        description: 'Base Mainnet'
-    },
-    'eip155:84531': {
-        chain: 'base',
-        network: 'goerli',
-        description: 'Base Goerli Testnet'
-    },
-    'eip155:84532': {
-        chain: 'base',
-        network: 'sepolia',
-        description: 'Base Sepolia Testnet'
-    },
-    // Bitcoin networks (for future support)
-    'bip122:000000000019d6689c085ae165831e93': {
-        chain: 'bitcoin',
-        network: 'mainnet',
-        description: 'Bitcoin Mainnet'
-    },
-    'bip122:000000000933ea01ad0ee984209779ba': {
-        chain: 'bitcoin',
-        network: 'testnet',
-        description: 'Bitcoin Testnet'
-    },
-    // Sui networks (for future support)
-    'sui:35834a8a': {
-        chain: 'sui',
-        network: 'mainnet',
-        description: 'Sui Mainnet'
-    },
-    'sui:4c78adac': {
-        chain: 'sui',
-        network: 'testnet',
-        description: 'Sui Testnet'
-    },
-};
-/**
- * Derive SubmissionConfig from a CAIP-2 network ID
- * @param networkId - CAIP-2 compliant network ID (e.g., 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp')
- * @returns SubmissionConfig if network supports transaction submission, undefined otherwise
- */
-function deriveSubmissionConfig(networkId) {
-    const mapping = CAIP2_NETWORK_MAPPINGS[networkId];
-    if (!mapping) {
-        // Network not found in mappings - cannot derive submission config
-        return undefined;
-    }
-    return {
-        chain: mapping.chain,
-        network: mapping.network
-    };
-}
-/**
- * Check if a network ID supports transaction submission
- * @param networkId - CAIP-2 compliant network ID
- * @returns true if the network supports transaction submission
- */
-function supportsTransactionSubmission(networkId) {
-    return networkId in CAIP2_NETWORK_MAPPINGS;
-}
-/**
- * Get network description for a CAIP-2 network ID
- * @param networkId - CAIP-2 compliant network ID
- * @returns Network description or undefined if not found
- */
-function getNetworkDescription(networkId) {
-    return CAIP2_NETWORK_MAPPINGS[networkId]?.description;
-}
-/**
- * List all supported CAIP-2 network IDs
- * @returns Array of supported network IDs
- */
-function getSupportedNetworkIds() {
-    return Object.keys(CAIP2_NETWORK_MAPPINGS);
-}
-/**
- * Get all networks for a specific chain
- * @param chain - Chain name (e.g., 'solana', 'ethereum')
- * @returns Array of network IDs for the specified chain
- */
-function getNetworkIdsByChain(chain) {
-    return Object.entries(CAIP2_NETWORK_MAPPINGS)
-        .filter(([_, mapping]) => mapping.chain.toLowerCase() === chain.toLowerCase())
-        .map(([networkId]) => networkId);
-}

package/dist/constants.d.ts

@@ -1,28 +0,0 @@
-import { DerivationInfoCurveEnum, DerivationInfoAddressFormatEnum, Algorithm } from '@phantom/openapi-wallet-service';
-import { NetworkId } from './caip2-mappings';
-/**
- * Default derivation paths for different blockchain networks
- */
-export declare enum DerivationPath {
-    Solana = "m/44'/501'/0'/0'",
-    Ethereum = "m/44'/60'/0'/0/0",
-    Bitcoin = "m/84'/0'/0'/0",
-    Sui = "m/44'/784'/0'/0'/0'"
-}
-/**
- * Helper function to get derivation path based on network ID
- */
-export declare function getDerivationPathForNetwork(networkId: string): string;
-/**
- * Network configuration
- */
-export interface NetworkConfig {
-    derivationPath: string;
-    curve: DerivationInfoCurveEnum;
-    algorithm: Algorithm;
-    addressFormat: DerivationInfoAddressFormatEnum;
-}
-/**
- * Get complete network configuration
- */
-export declare function getNetworkConfig(networkId: NetworkId): NetworkConfig | null;

package/dist/constants.js

@@ -1,82 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DerivationPath = void 0;
-exports.getDerivationPathForNetwork = getDerivationPathForNetwork;
-exports.getNetworkConfig = getNetworkConfig;
-const openapi_wallet_service_1 = require("@phantom/openapi-wallet-service");
-/**
- * Default derivation paths for different blockchain networks
- */
-var DerivationPath;
-(function (DerivationPath) {
-    // Solana - BIP44 standard for Solana (coin type 501)
-    DerivationPath["Solana"] = "m/44'/501'/0'/0'";
-    // Ethereum - BIP44 standard for Ethereum and all EVM-compatible chains (coin type 60)
-    DerivationPath["Ethereum"] = "m/44'/60'/0'/0/0";
-    // Bitcoin - BIP44 standard for Bitcoin (coin type 0)
-    DerivationPath["Bitcoin"] = "m/84'/0'/0'/0";
-    // Sui - BIP44 standard for Sui (coin type 784)
-    DerivationPath["Sui"] = "m/44'/784'/0'/0'/0'";
-})(DerivationPath || (exports.DerivationPath = DerivationPath = {}));
-/**
- * Helper function to get derivation path based on network ID
- */
-function getDerivationPathForNetwork(networkId) {
-    // Extract the chain name from network ID format (e.g., "solana:mainnet" -> "solana")
-    const network = networkId.split(':')[0].toLowerCase();
-    switch (network) {
-        case 'solana':
-            return DerivationPath.Solana;
-        case 'sui':
-            return DerivationPath.Sui;
-        case 'bitcoin':
-        case 'btc':
-            return DerivationPath.Bitcoin;
-        case 'eip155': // EVM chains use eip155 prefix
-        case 'ethereum':
-        case 'eth':
-        default:
-            // Default to Ethereum path for all EVM-compatible chains
-            return DerivationPath.Ethereum;
-    }
-}
-/**
- * Get complete network configuration
- */
-function getNetworkConfig(networkId) {
-    const network = networkId.split(':')[0].toLowerCase();
-    switch (network) {
-        case 'solana':
-            return {
-                derivationPath: DerivationPath.Solana,
-                curve: openapi_wallet_service_1.DerivationInfoCurveEnum.ed25519,
-                algorithm: openapi_wallet_service_1.Algorithm.ed25519,
-                addressFormat: openapi_wallet_service_1.DerivationInfoAddressFormatEnum.solana
-            };
-        case 'sui':
-            return {
-                derivationPath: DerivationPath.Sui,
-                curve: openapi_wallet_service_1.DerivationInfoCurveEnum.ed25519,
-                algorithm: openapi_wallet_service_1.Algorithm.ed25519,
-                addressFormat: openapi_wallet_service_1.DerivationInfoAddressFormatEnum.sui,
-            };
-        case 'bitcoin':
-        case 'btc':
-            return {
-                derivationPath: DerivationPath.Bitcoin,
-                curve: openapi_wallet_service_1.DerivationInfoCurveEnum.secp256k1,
-                algorithm: openapi_wallet_service_1.Algorithm.secp256k1,
-                addressFormat: openapi_wallet_service_1.DerivationInfoAddressFormatEnum.bitcoinSegwit // Bitcoin uses a different format, but for SDK consistency we use Ethereum format
-            };
-        case 'eip155': // EVM chains use eip155 prefix
-            // All EVM-compatible chains (Ethereum, Polygon, BSC, Arbitrum, etc.)
-            return {
-                derivationPath: DerivationPath.Ethereum,
-                curve: openapi_wallet_service_1.DerivationInfoCurveEnum.secp256k1,
-                algorithm: openapi_wallet_service_1.Algorithm.secp256k1,
-                addressFormat: openapi_wallet_service_1.DerivationInfoAddressFormatEnum.ethereum // EVM chains use Ethereum address format
-            };
-        default:
-            return null;
-    }
-}

package/dist/types.d.ts

@@ -1,29 +0,0 @@
-import { DerivationInfoAddressFormatEnum } from "@phantom/openapi-wallet-service";
-export interface ServerSDKConfig {
-    apiPrivateKey: string;
-    organizationId: string;
-    apiBaseUrl: string;
-    solanaRpcUrl?: string;
-}
-export interface WalletAddress {
-    addressType: DerivationInfoAddressFormatEnum;
-    address: string;
-}
-export interface CreateWalletResult {
-    walletId: string;
-    addresses: WalletAddress[];
-}
-export type Transaction = Uint8Array;
-export interface SignedTransaction {
-    rawTransaction: string;
-}
-export interface Wallet {
-    walletId: string;
-    walletName: string;
-}
-export interface GetWalletsResult {
-    wallets: Wallet[];
-    totalCount: number;
-    limit: number;
-    offset: number;
-}

package/dist/types.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });