@phantom/server-sdk 0.1.4 → 0.2.2

package/README.md

@@ -45,7 +45,6 @@ pnpm add @phantom/server-sdk
 Before using the SDK, you need:
 
 1. **Phantom Organization Credentials**
-
    - Organization ID
    - Organization Private Key (base58 encoded)
    - API Base URL
@@ -217,7 +216,6 @@ const unicodeSignature = await sdk.signMessage({
   networkId: NetworkId.SOLANA_MAINNET,
 });
 
-const ethMessage = Buffer.from().toString("base64url");
 const ethSignature = await sdk.signMessage({
   walletId: wallet.walletId,
   message: "Sign in to our dApp",

package/dist/index.d.ts

@@ -1,7 +1,9 @@
-import { NetworkId, 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';
+import { NetworkId, PhantomClient, Organization, GetWalletsResult, CreateWalletResult, AddressType } from '@phantom/client';
+export { CreateWalletResult, DerivationPath, GetWalletsResult, NetworkConfig, PhantomClient, SignedTransaction, 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, parseTransaction, parseTransactionResponse } from '@phantom/parsers';
+export { NetworkId } from '@phantom/constants';
 export { ApiKeyStamper } from '@phantom/api-key-stamper';
-export { ParsedMessage, ParsedTransaction, parseMessage, parseTransaction } from '@phantom/parsers';
 import { DerivationInfoAddressFormatEnum } from '@phantom/openapi-wallet-service';
 
 interface WalletAddress {
@@ -24,20 +26,32 @@ interface ServerSignAndSendTransactionParams {
     transaction: any;
     networkId: NetworkId;
 }
-declare class ServerSDK extends PhantomClient {
+declare class ServerSDK {
+    private config;
+    client: PhantomClient;
     constructor(config: ServerSDKConfig);
     /**
      * Sign a message - supports plain text and automatically converts to base64url
      * @param params - Message parameters with plain text message
-     * @returns Promise<string> - Base64 encoded signature
+     * @returns Promise<ParsedSignatureResult> - Parsed signature with explorer URL
      */
-    signMessage(params: ServerSignMessageParams): Promise<string>;
+    signMessage(params: ServerSignMessageParams): Promise<ParsedSignatureResult>;
     /**
      * Sign and send a transaction - supports various transaction formats and automatically parses them
      * @param params - Transaction parameters with flexible transaction format
-     * @returns Promise<SignedTransaction> - Signed transaction result
+     * @returns Promise<ParsedTransactionResult> - Parsed transaction result with hash and explorer URL
      */
-    signAndSendTransaction(params: ServerSignAndSendTransactionParams): Promise<any>;
+    signAndSendTransaction(params: ServerSignAndSendTransactionParams): Promise<ParsedTransactionResult>;
+    createOrganization(name: string, keyPair: {
+        publicKey: string;
+        secretKey: string;
+    }): Promise<Organization>;
+    getWallets(limit?: number, offset?: number): Promise<GetWalletsResult>;
+    createWallet(name: string): Promise<CreateWalletResult>;
+    getWalletAddresses(walletId: string, derivationPaths?: string[]): Promise<{
+        addressType: AddressType;
+        address: string;
+    }[]>;
 }
 
 export { ServerSDK, ServerSDKConfig, ServerSignAndSendTransactionParams, ServerSignMessageParams, WalletAddress };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -22,7 +32,7 @@ var src_exports = {};
 __export(src_exports, {
   ApiKeyStamper: () => import_api_key_stamper2.ApiKeyStamper,
   DerivationPath: () => import_client2.DerivationPath,
-  NetworkId: () => import_client2.NetworkId,
+  NetworkId: () => import_constants.NetworkId,
   PhantomClient: () => import_client2.PhantomClient,
   ServerSDK: () => ServerSDK,
   deriveSubmissionConfig: () => import_client2.deriveSubmissionConfig,
@@ -33,22 +43,28 @@ __export(src_exports, {
   getNetworkIdsByChain: () => import_client2.getNetworkIdsByChain,
   getSupportedNetworkIds: () => import_client2.getSupportedNetworkIds,
   parseMessage: () => import_parsers2.parseMessage,
+  parseSignMessageResponse: () => import_parsers2.parseSignMessageResponse,
   parseTransaction: () => import_parsers2.parseTransaction,
+  parseTransactionResponse: () => import_parsers2.parseTransactionResponse,
   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_base64url = require("@phantom/base64url");
+var import_bs58 = __toESM(require("bs58"));
 var import_parsers = require("@phantom/parsers");
 var import_client2 = require("@phantom/client");
+var import_constants = require("@phantom/constants");
 var import_api_key_stamper2 = require("@phantom/api-key-stamper");
 var import_parsers2 = require("@phantom/parsers");
-var ServerSDK = class extends import_client.PhantomClient {
+var ServerSDK = class {
   constructor(config) {
+    this.config = config;
     const stamper = new import_api_key_stamper.ApiKeyStamper({
       apiSecretKey: config.apiPrivateKey
     });
-    super(
+    this.client = new import_client.PhantomClient(
       {
         apiBaseUrl: config.apiBaseUrl,
         organizationId: config.organizationId
@@ -59,21 +75,22 @@ var ServerSDK = class extends import_client.PhantomClient {
   /**
    * Sign a message - supports plain text and automatically converts to base64url
    * @param params - Message parameters with plain text message
-   * @returns Promise<string> - Base64 encoded signature
+   * @returns Promise<ParsedSignatureResult> - Parsed signature with explorer URL
    */
-  signMessage(params) {
+  async signMessage(params) {
     const parsedMessage = (0, import_parsers.parseMessage)(params.message);
     const signMessageParams = {
       walletId: params.walletId,
       message: parsedMessage.base64url,
       networkId: params.networkId
     };
-    return super.signMessage(signMessageParams);
+    const rawResponse = await this.client.signMessage(signMessageParams);
+    return (0, import_parsers.parseSignMessageResponse)(rawResponse, params.networkId);
   }
   /**
    * Sign and send a transaction - supports various transaction formats and automatically parses them
    * @param params - Transaction parameters with flexible transaction format
-   * @returns Promise<SignedTransaction> - Signed transaction result
+   * @returns Promise<ParsedTransactionResult> - Parsed transaction result with hash and explorer URL
    */
   async signAndSendTransaction(params) {
     const parsedTransaction = await (0, import_parsers.parseTransaction)(params.transaction, params.networkId);
@@ -82,7 +99,39 @@ var ServerSDK = class extends import_client.PhantomClient {
       transaction: parsedTransaction.base64url,
       networkId: params.networkId
     };
-    return super.signAndSendTransaction(signAndSendParams);
+    const rawResponse = await this.client.signAndSendTransaction(signAndSendParams);
+    return await (0, import_parsers.parseTransactionResponse)(rawResponse.rawTransaction, params.networkId, rawResponse.hash);
+  }
+  createOrganization(name, keyPair) {
+    const tempClient = new import_client.PhantomClient(
+      {
+        apiBaseUrl: this.config.apiBaseUrl,
+        organizationId: this.config.organizationId
+      },
+      new import_api_key_stamper.ApiKeyStamper({
+        apiSecretKey: keyPair.secretKey
+      })
+    );
+    const base64urlPublicKey = (0, import_base64url.base64urlEncode)(import_bs58.default.decode(keyPair.publicKey));
+    return tempClient.createOrganization(name, [{
+      username: `user-${Date.now()}`,
+      role: "admin",
+      authenticators: [{
+        authenticatorName: `auth-${Date.now()}`,
+        authenticatorKind: "keypair",
+        publicKey: base64urlPublicKey,
+        algorithm: "Ed25519"
+      }]
+    }]);
+  }
+  getWallets(limit, offset) {
+    return this.client.getWallets(limit, offset);
+  }
+  createWallet(name) {
+    return this.client.createWallet(name);
+  }
+  getWalletAddresses(walletId, derivationPaths) {
+    return this.client.getWalletAddresses(walletId, derivationPaths);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
@@ -100,6 +149,8 @@ var ServerSDK = class extends import_client.PhantomClient {
   getNetworkIdsByChain,
   getSupportedNetworkIds,
   parseMessage,
+  parseSignMessageResponse,
   parseTransaction,
+  parseTransactionResponse,
   supportsTransactionSubmission
 });

package/dist/index.mjs

@@ -3,10 +3,16 @@ import {
   PhantomClient
 } from "@phantom/client";
 import { ApiKeyStamper } from "@phantom/api-key-stamper";
-import { parseMessage, parseTransaction } from "@phantom/parsers";
+import { base64urlEncode } from "@phantom/base64url";
+import bs58 from "bs58";
+import {
+  parseMessage,
+  parseTransaction,
+  parseSignMessageResponse,
+  parseTransactionResponse
+} from "@phantom/parsers";
 import {
   PhantomClient as PhantomClient2,
-  NetworkId,
   deriveSubmissionConfig,
   supportsTransactionSubmission,
   getNetworkDescription,
@@ -17,14 +23,21 @@ import {
   getNetworkConfig,
   generateKeyPair
 } from "@phantom/client";
+import { NetworkId } from "@phantom/constants";
 import { ApiKeyStamper as ApiKeyStamper2 } from "@phantom/api-key-stamper";
-import { parseMessage as parseMessage2, parseTransaction as parseTransaction2 } from "@phantom/parsers";
-var ServerSDK = class extends PhantomClient {
+import {
+  parseMessage as parseMessage2,
+  parseTransaction as parseTransaction2,
+  parseSignMessageResponse as parseSignMessageResponse2,
+  parseTransactionResponse as parseTransactionResponse2
+} from "@phantom/parsers";
+var ServerSDK = class {
   constructor(config) {
+    this.config = config;
     const stamper = new ApiKeyStamper({
       apiSecretKey: config.apiPrivateKey
     });
-    super(
+    this.client = new PhantomClient(
       {
         apiBaseUrl: config.apiBaseUrl,
         organizationId: config.organizationId
@@ -35,21 +48,22 @@ var ServerSDK = class extends PhantomClient {
   /**
    * Sign a message - supports plain text and automatically converts to base64url
    * @param params - Message parameters with plain text message
-   * @returns Promise<string> - Base64 encoded signature
+   * @returns Promise<ParsedSignatureResult> - Parsed signature with explorer URL
    */
-  signMessage(params) {
+  async signMessage(params) {
     const parsedMessage = parseMessage(params.message);
     const signMessageParams = {
       walletId: params.walletId,
       message: parsedMessage.base64url,
       networkId: params.networkId
     };
-    return super.signMessage(signMessageParams);
+    const rawResponse = await this.client.signMessage(signMessageParams);
+    return parseSignMessageResponse(rawResponse, params.networkId);
   }
   /**
    * Sign and send a transaction - supports various transaction formats and automatically parses them
    * @param params - Transaction parameters with flexible transaction format
-   * @returns Promise<SignedTransaction> - Signed transaction result
+   * @returns Promise<ParsedTransactionResult> - Parsed transaction result with hash and explorer URL
    */
   async signAndSendTransaction(params) {
     const parsedTransaction = await parseTransaction(params.transaction, params.networkId);
@@ -58,7 +72,39 @@ var ServerSDK = class extends PhantomClient {
       transaction: parsedTransaction.base64url,
       networkId: params.networkId
     };
-    return super.signAndSendTransaction(signAndSendParams);
+    const rawResponse = await this.client.signAndSendTransaction(signAndSendParams);
+    return await parseTransactionResponse(rawResponse.rawTransaction, params.networkId, rawResponse.hash);
+  }
+  createOrganization(name, keyPair) {
+    const tempClient = new PhantomClient(
+      {
+        apiBaseUrl: this.config.apiBaseUrl,
+        organizationId: this.config.organizationId
+      },
+      new ApiKeyStamper({
+        apiSecretKey: keyPair.secretKey
+      })
+    );
+    const base64urlPublicKey = base64urlEncode(bs58.decode(keyPair.publicKey));
+    return tempClient.createOrganization(name, [{
+      username: `user-${Date.now()}`,
+      role: "admin",
+      authenticators: [{
+        authenticatorName: `auth-${Date.now()}`,
+        authenticatorKind: "keypair",
+        publicKey: base64urlPublicKey,
+        algorithm: "Ed25519"
+      }]
+    }]);
+  }
+  getWallets(limit, offset) {
+    return this.client.getWallets(limit, offset);
+  }
+  createWallet(name) {
+    return this.client.createWallet(name);
+  }
+  getWalletAddresses(walletId, derivationPaths) {
+    return this.client.getWalletAddresses(walletId, derivationPaths);
   }
 };
 export {
@@ -75,6 +121,8 @@ export {
   getNetworkIdsByChain,
   getSupportedNetworkIds,
   parseMessage2 as parseMessage,
+  parseSignMessageResponse2 as parseSignMessageResponse,
   parseTransaction2 as parseTransaction,
+  parseTransactionResponse2 as parseTransactionResponse,
   supportsTransactionSubmission
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/server-sdk",
-  "version": "0.1.4",
+  "version": "0.2.2",
   "description": "Server SDK for Phantom Wallet",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -21,6 +21,7 @@
     "test": "jest",
     "test:watch": "jest --watch",
     "lint": "eslint src --ext .ts,.tsx",
+    "check-types": "yarn tsc --noEmit",
     "prettier": "prettier --write \"src/**/*.{ts,tsx}\""
   },
   "devDependencies": {
@@ -36,10 +37,13 @@
     "typescript": "^5.0.4"
   },
   "dependencies": {
-    "@phantom/api-key-stamper": "^0.1.1",
-    "@phantom/client": "^0.1.3",
+    "@phantom/api-key-stamper": "^0.1.3",
+    "@phantom/base64url": "^0.1.0",
+    "@phantom/client": "^0.1.6",
+    "@phantom/constants": "^0.0.2",
     "@phantom/openapi-wallet-service": "^0.1.7",
-    "@phantom/parsers": "^0.0.4"
+    "@phantom/parsers": "^0.0.6",
+    "bs58": "^6.0.0"
   },
   "files": [
     "dist"