@otim/sdk-server 0.0.1

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["Environment","exhaustiveCheck: never","config: ServerAccountConfig","AuthClient","ConfigClient","DelegationClient","OrchestrationClient"],"sources":["../src/client/api-client.ts","../src/client/utils/asserts.ts","../src/client/server-account.ts","../src/client/server-client.ts","../src/client/create-server-client.ts"],"sourcesContent":["import type { CreateInstanceParameters } from \"@otim/utils/api\";\nimport type { Optional } from \"@otim/utils/helpers\";\n\nimport { Environment, getApiUrl } from \"@otim/sdk-core/config\";\nimport { APIClient, createInstance } from \"@otim/utils/api\";\n\nexport interface CreateServerAPIClientOptions\n  extends Omit<CreateInstanceParameters, \"baseURL\"> {\n  sessionToken?: Optional<string>;\n  environment?: Environment;\n}\n\n/**\n * Creates an API client for server-side requests.\n *\n * Configures the base URL and authentication headers for API communication.\n *\n * @param config - Optional configuration for the API client\n * @returns Configured API client instance\n *\n * @internal\n */\nexport const createServerAPIClient = (\n  config?: CreateServerAPIClientOptions,\n) => {\n  const {\n    sessionToken,\n    environment = Environment.Sandbox,\n    ...restConfig\n  } = config ?? {};\n\n  const instance = createInstance({\n    baseURL: getApiUrl(environment),\n    ...restConfig,\n  });\n\n  instance.interceptors.request.use(async (requestConfig) => {\n    if (sessionToken) {\n      requestConfig.headers = requestConfig.headers ?? {};\n\n      // If the session token does not start with \"Bearer \", add it.\n      const authorizationToken = sessionToken.startsWith(\"Bearer \")\n        ? sessionToken\n        : `Bearer ${sessionToken}`;\n\n      requestConfig.headers.Authorization = authorizationToken;\n    }\n\n    return requestConfig;\n  });\n\n  return new APIClient({ instance });\n};\n","export function assertDefined<T>(\n  value: T,\n  errorMessage: string,\n): asserts value is NonNullable<T> {\n  if (value === null || value === undefined) {\n    throw new Error(errorMessage);\n  }\n}\n","import type {\n  ApiAccountConfig,\n  OtimAccountSignMessageArgs,\n  OtimAccount as OtimAccountType,\n  PrivateKeyAccountConfig,\n  ServerAccountConfig,\n} from \"@otim/sdk-core/account\";\nimport type { Nullable } from \"@otim/utils/helpers\";\nimport type { Hex } from \"viem\";\n\nimport { ServerAccountType } from \"@otim/sdk-core/account\";\nimport { env, getTurnkeyApiUrl } from \"@otim/sdk-core/config\";\nimport { ApiKeyStamper } from \"@turnkey/api-key-stamper\";\nimport { TurnkeyClient } from \"@turnkey/http\";\nimport { createAccount } from \"@turnkey/viem\";\nimport { privateKeyToAccount } from \"viem/accounts\";\n\nimport { assertDefined } from \"./utils/asserts\";\n\ntype PrimitiveAccount = {\n  signMessage: (args: {\n    message: string | { raw: Hex | Uint8Array };\n  }) => Promise<Hex>;\n};\n\nconst createApiAccount = async (\n  config: ApiAccountConfig,\n): Promise<PrimitiveAccount> => {\n  const stamper = new ApiKeyStamper({\n    apiPublicKey: config.publicKey,\n    apiPrivateKey: config.privateKey,\n  });\n\n  const client = new TurnkeyClient(\n    {\n      baseUrl: getTurnkeyApiUrl(env.ENVIRONMENT),\n    },\n    stamper,\n  );\n\n  const account = await createAccount({\n    organizationId: config.appId,\n    signWith: \"0xB54c8E6f303627f392884412ED2C84fFaF4779CA\",\n    client,\n  });\n\n  return {\n    signMessage: (args) => account.signMessage(args),\n  };\n};\n\nconst createPrivateKeyAccount = (\n  config: PrivateKeyAccountConfig,\n): PrimitiveAccount => {\n  const account = privateKeyToAccount(config.privateKey);\n\n  return {\n    signMessage: (args) => account.signMessage(args),\n  };\n};\n\nconst initializeAccount = async (\n  config: ServerAccountConfig,\n): Promise<PrimitiveAccount> => {\n  switch (config.type) {\n    case ServerAccountType.Api:\n      return createApiAccount(config);\n    case ServerAccountType.PrivateKey:\n      return createPrivateKeyAccount(config);\n    default: {\n      const exhaustiveCheck: never = config;\n      throw new Error(\n        `Unsupported account type: \"${(exhaustiveCheck as ServerAccountConfig).type}\". Supported types are: ${Object.values(ServerAccountType).join(\", \")}`,\n      );\n    }\n  }\n};\n\n/**\n * Server-side account implementation for signing operations.\n *\n * Supports both private key and API authentication methods.\n *\n * @internal\n */\nexport class OtimAccount implements OtimAccountType {\n  private account: Nullable<PrimitiveAccount> = null;\n  private initialized = false;\n\n  constructor(private readonly config: ServerAccountConfig) {}\n\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      throw new Error(\n        \"Account already initialized. The initialize() method should only be called once.\",\n      );\n    }\n\n    this.account = await initializeAccount(this.config);\n    this.initialized = true;\n  }\n\n  async signMessage({ message }: OtimAccountSignMessageArgs) {\n    assertDefined(\n      this.account,\n      \"Account not initialized. Call initialize() before using signMessage().\",\n    );\n    return this.account.signMessage({ message });\n  }\n}\n","import type { ServerAccountConfig } from \"@otim/sdk-core/account\";\nimport type { OtimServerClientContext } from \"@otim/sdk-core/context\";\nimport type { APIClient } from \"@otim/utils/api\";\n\nimport {\n  createClientContext,\n  isApiAccountConfig,\n} from \"@otim/sdk-core/account\";\nimport {\n  AuthClient,\n  ConfigClient,\n  DelegationClient,\n  OrchestrationClient,\n} from \"@otim/sdk-core/clients\";\n\nimport { createServerAPIClient } from \"./api-client\";\nimport { OtimAccount } from \"./server-account\";\n\n/**\n * Otim Client for server-side blockchain operations.\n *\n * Provides access to authentication, configuration, delegation, and\n * orchestration services.\n * The client must be initialized before use by calling the init() method.\n\n */\nexport class OtimServerClient {\n  private readonly apiClient: APIClient;\n  private readonly account: OtimAccount;\n  private readonly context: OtimServerClientContext;\n\n  readonly auth: AuthClient;\n  readonly config: ConfigClient;\n  readonly delegation: DelegationClient;\n  readonly orchestration: OrchestrationClient;\n\n  constructor(config: ServerAccountConfig) {\n    this.context = createClientContext(config);\n    this.apiClient = createServerAPIClient({\n      environment: config.environment,\n      ...(isApiAccountConfig(config) ? { sessionToken: config.apiKey } : {}),\n    });\n\n    this.account = new OtimAccount(config);\n\n    this.auth = new AuthClient(this.apiClient, this.account, this.context);\n    this.config = new ConfigClient(this.apiClient);\n    this.delegation = new DelegationClient(this.apiClient);\n    this.orchestration = new OrchestrationClient(\n      this.apiClient,\n      this.account,\n      this.context,\n    );\n  }\n\n  /**\n   * Initializes the Otim Client.\n   *\n   * This method must be called before using any other client methods.\n   * It sets up the authentication account and prepares the client for use.\n   *\n   * @throws {Error} If the account is already initialized\n   */\n  async init(): Promise<void> {\n    await this.account.initialize();\n  }\n}\n","import type { Environment } from \"@otim/sdk-core/config\";\n\nimport { ServerAccountType } from \"@otim/sdk-core/account\";\n\nimport { OtimServerClient } from \"./server-client\";\n\n/**\n * Creates an Otim Client for server-side blockchain operations.\n *\n * @param config - Configuration with private key only\n * @returns Configured Otim Client instance\n *\n * @example\n * ```typescript\n * import { Environment } from '@otim/sdk';\n *\n * const client = createOtimServerClient({\n *   privateKey: '0x...',\n *   environment: Environment.Production,\n * });\n * await client.init();\n * ```\n */\nexport function createOtimServerClient(config: {\n  privateKey: `0x${string}`;\n  environment?: Environment;\n}): OtimServerClient;\n\n/**\n * Creates an Otim Client for server-side operations with API authentication.\n *\n * @param config - Configuration with API credentials\n * @returns Configured Otim Client instance\n *\n * @example\n * ```typescript\n * import { Environment } from '@otim/sdk';\n *\n * const client = createOtimServerClient({\n *   appId: 'your-app-id',\n *   privateKey: '0x...',\n *   publicKey: 'your-public-key',\n *   apiKey: 'your-api-key',\n *   environment: Environment.Production,\n * });\n * await client.init();\n * ```\n */\nexport function createOtimServerClient(config: {\n  appId: string;\n  privateKey: `0x${string}`;\n  publicKey: string;\n  apiKey?: string;\n  environment?: Environment;\n}): OtimServerClient;\n\nexport function createOtimServerClient(config: {\n  privateKey?: `0x${string}`;\n  publicKey?: string;\n  apiKey?: string;\n  appId?: string;\n  environment?: Environment;\n}): OtimServerClient {\n  if (config.appId && config.privateKey && config.publicKey && config.apiKey) {\n    return new OtimServerClient({\n      type: ServerAccountType.Api,\n      appId: config.appId,\n      privateKey: config.privateKey,\n      publicKey: config.publicKey,\n      apiKey: config.apiKey,\n      environment: config.environment,\n    });\n  }\n\n  if (config.privateKey) {\n    return new OtimServerClient({\n      type: ServerAccountType.PrivateKey,\n      privateKey: config.privateKey,\n      environment: config.environment,\n    });\n  }\n\n  throw new Error(\"Invalid Otim Server Client configuration\");\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "@otim/sdk-server",
+  "version": "0.0.1",
+  "description": "Otim's TypeScript SDK for blockchain automation and smart contract interactions",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "otim",
+    "sdk",
+    "ethereum",
+    "blockchain",
+    "defi",
+    "smart-contracts",
+    "typescript"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/otimlabs/otim-ts-sdk.git",
+    "directory": "packages/server"
+  },
+  "bugs": {
+    "url": "https://github.com/otimlabs/otim-ts-sdk/issues"
+  },
+  "homepage": "https://github.com/otimlabs/otim-ts-sdk#readme",
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@playwright/test": "^1.56.1",
+    "@types/adm-zip": "^0.5.7",
+    "@types/node": "^24.10.1",
+    "@types/node-fetch": "^2.6.13",
+    "adm-zip": "^0.5.16",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.39.1",
+    "msw": "^2.12.2",
+    "node-fetch": "^3.3.2",
+    "tsdown": "^0.16.5",
+    "typescript-eslint": "^8.47.0",
+    "vitest": "^4.0.10",
+    "@otim/eslint-config": "0.0.1",
+    "@otim/typescript-config": "0.0.0"
+  },
+  "dependencies": {
+    "@otim/turnkey": "0.0.2-development.0",
+    "@otim/utils": "0.0.2-development.0",
+    "@t3-oss/env-core": "^0.13.8",
+    "@testing-library/user-event": "^14.6.1",
+    "@turnkey/api-key-stamper": "^0.5.0",
+    "@turnkey/core": "^1.7.0",
+    "@turnkey/http": "^3.15.0",
+    "@turnkey/sdk-server": "^4.12.0",
+    "@turnkey/viem": "^0.14.13",
+    "@wagmi/connectors": "^7.0.0",
+    "@wagmi/core": "^3.0.0",
+    "abitype": "^1.1.2",
+    "axios": "^1.13.2",
+    "viem": "^2.39.3",
+    "ws": "^8.18.3",
+    "zod": "^4.1.12",
+    "@otim/sdk-core": "0.0.1"
+  },
+  "peerDependencies": {
+    "@wagmi/core": "2.x",
+    "typescript": ">=5.0.4",
+    "viem": "2.x"
+  },
+  "peerDependenciesMeta": {
+    "@wagmi/core": {
+      "optional": false
+    },
+    "viem": {
+      "optional": false
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "dev:clear": "tsc --watch --pretty --preserveWatchOutput",
+    "lint": "eslint .",
+    "lint:check": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "check-types": "tsc --noEmit",
+    "check-exports": "attw --pack . --format=table --ignore-rules=no-resolution untyped-resolution fallback-condition || true",
+    "clean": "rm -rf dist",
+    "ci": "pnpm run lint:check && pnpm run check-types && pnpm run build && pnpm run check-exports",
+    "test": "vitest run",
+    "test:watch": "vitest --watch",
+    "test:coverage": "vitest run --coverage",
+    "test:e2e": "playwright test",
+    "e2e": "playwright test",
+    "e2e:ui": "playwright test --ui"
+  }
+}