@waaskey/sdk 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Waaskey
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# @waaskey/sdk
+
+Official TypeScript SDK for [Waaskey](https://waaskey.com) — embedded, non-custodial
+**MPC wallets** for your app. Create wallets and sign transactions where the private
+key is never assembled in one place (2-of-3 threshold ECDSA, no seed phrase).
+
+> **Early access (v0.0.x).** The public API is taking shape and may change before
+> `1.0.0`. Pin an exact version.
+
+## Install
+
+```bash
+pnpm add @waaskey/sdk
+```
+
+## Quickstart
+
+```ts
+import { Waaskey } from '@waaskey/sdk';
+
+const waaskey = new Waaskey({ apiKey: process.env.WAASKEY_PUBLISHABLE_KEY! });
+
+// Create an MPC wallet
+const wallet = await waaskey.wallets.create({ userId: user.id, chain: 'ethereum' });
+// → { id: 'wlt_…', address: '0xabc…' }
+
+// Sign a message (interactive threshold-MPC, one awaited call)
+const signature = await wallet.signMessage('Hello Waaskey');
+```
+
+## API
+
+| Method                                       | Description                               |
+| -------------------------------------------- | ----------------------------------------- |
+| `new Waaskey({ apiKey, baseUrl?, fetch? })`  | Create a client.                          |
+| `waaskey.wallets.create({ chain, userId? })` | Create a new wallet. Returns a `Wallet`.  |
+| `waaskey.wallets.get(id)`                    | Load an existing wallet.                  |
+| `wallet.signMessage(message)`                | Sign a message with the wallet's MPC key. |
+
+Errors are thrown as `WaaskeyError` (`{ message, status, code }`).
+
+## Development
+
+```bash
+pnpm install
+pnpm test:unit   # vitest
+pnpm types       # tsc --noEmit
+pnpm lint
+pnpm build       # tsup → dist (esm + cjs + d.ts)
+```
+
+## License
+
+[MIT](./LICENSE) © Waaskey

package/dist/index.cjs

@@ -0,0 +1,104 @@
+'use strict';
+
+// src/types.ts
+var WaaskeyError = class extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "WaaskeyError";
+  }
+  status;
+  code;
+};
+
+// src/http.ts
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  fetchImpl;
+  constructor(apiKey, baseUrl, fetchImpl) {
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    const resolved = fetchImpl ?? globalThis.fetch;
+    if (!resolved) {
+      throw new Error("No fetch implementation available \u2014 pass `fetch` in WaaskeyOptions.");
+    }
+    this.fetchImpl = resolved.bind(globalThis);
+  }
+  async request(method, path, body) {
+    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        authorization: `Bearer ${this.apiKey}`,
+        "content-type": "application/json"
+      },
+      body: body === void 0 ? void 0 : JSON.stringify(body)
+    });
+    if (!res.ok) {
+      const detail = await res.json().catch(() => ({}));
+      const message = typeof detail.message === "string" ? detail.message : res.statusText;
+      const code = typeof detail.code === "string" ? detail.code : void 0;
+      throw new WaaskeyError(message, res.status, code);
+    }
+    return await res.json();
+  }
+};
+
+// src/wallet.ts
+var Wallet = class {
+  constructor(http, data) {
+    this.http = http;
+    this.id = data.id;
+    this.address = data.address;
+    this.chain = data.chain;
+  }
+  http;
+  id;
+  address;
+  chain;
+  /** Sign an arbitrary message with this wallet's key (2-of-3 threshold MPC). */
+  async signMessage(message) {
+    const { signature } = await this.http.request("POST", `/v1/wallets/${this.id}/sign-message`, { message });
+    return signature;
+  }
+};
+
+// src/wallets.ts
+var Wallets = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Create a new MPC wallet on the given chain. */
+  async create(params) {
+    const data = await this.http.request("POST", "/v1/wallets", params);
+    return new Wallet(this.http, data);
+  }
+  /** Load an existing wallet by id. */
+  async get(id) {
+    const data = await this.http.request("GET", `/v1/wallets/${id}`);
+    return new Wallet(this.http, data);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.waaskey.com";
+var Waaskey = class {
+  /** The `wallets` resource. */
+  wallets;
+  constructor(options) {
+    if (!options?.apiKey) {
+      throw new Error("Waaskey: `apiKey` is required.");
+    }
+    const http = new HttpClient(options.apiKey, options.baseUrl ?? DEFAULT_BASE_URL, options.fetch);
+    this.wallets = new Wallets(http);
+  }
+};
+
+exports.Waaskey = Waaskey;
+exports.WaaskeyError = WaaskeyError;
+exports.Wallet = Wallet;
+exports.Wallets = Wallets;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/http.ts","../src/wallet.ts","../src/wallets.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Public contract for the Waaskey SDK.\n *\n * These types describe the wire shapes the SDK exchanges with the Waaskey API.\n * They will be replaced by types generated from the backend OpenAPI spec once the\n * API contract is stable; until then this file is the single source of truth.\n */\n\n/** Chains a wallet can be created on. */\nexport type Chain = 'ethereum' | 'polygon' | 'arbitrum' | 'base' | 'optimism' | 'bitcoin' | 'solana';\n\n/** Options accepted by `new Waaskey(...)`. */\nexport interface WaaskeyOptions {\n  /** Publishable API key issued from the Waaskey dashboard. */\n  apiKey: string;\n  /** API base URL. Defaults to the Waaskey production API. */\n  baseUrl?: string;\n  /** Custom fetch implementation (e.g. for non-browser runtimes). Defaults to global `fetch`. */\n  fetch?: typeof fetch;\n}\n\n/** Parameters for creating a wallet. */\nexport interface CreateWalletParams {\n  /** Your end-user's id in your own system; binds the wallet to that user. */\n  userId?: string;\n  /** Chain the wallet is created on. */\n  chain: Chain;\n}\n\n/** A wallet as returned by the API. */\nexport interface WalletData {\n  /** Waaskey wallet id, e.g. `wlt_...`. */\n  id: string;\n  /** On-chain address. */\n  address: string;\n  /** Chain the wallet belongs to. */\n  chain: Chain;\n}\n\n/** Error thrown for any non-2xx API response. */\nexport class WaaskeyError extends Error {\n  constructor(\n    message: string,\n    readonly status: number,\n    readonly code?: string,\n  ) {\n    super(message);\n    this.name = 'WaaskeyError';\n  }\n}\n","import { WaaskeyError } from './types';\n\n/** Thin typed HTTP client over fetch — the single place requests are issued. */\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(apiKey: string, baseUrl: string, fetchImpl?: typeof fetch) {\n    this.apiKey = apiKey;\n    this.baseUrl = baseUrl.replace(/\\/$/, '');\n    const resolved = fetchImpl ?? globalThis.fetch;\n    if (!resolved) {\n      throw new Error('No fetch implementation available — pass `fetch` in WaaskeyOptions.');\n    }\n    this.fetchImpl = resolved.bind(globalThis);\n  }\n\n  async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {\n      method,\n      headers: {\n        authorization: `Bearer ${this.apiKey}`,\n        'content-type': 'application/json',\n      },\n      body: body === undefined ? undefined : JSON.stringify(body),\n    });\n\n    if (!res.ok) {\n      const detail = await res.json().catch(() => ({}) as Record<string, unknown>);\n      const message = typeof detail.message === 'string' ? detail.message : res.statusText;\n      const code = typeof detail.code === 'string' ? detail.code : undefined;\n      throw new WaaskeyError(message, res.status, code);\n    }\n\n    return (await res.json()) as T;\n  }\n}\n","import type { HttpClient } from './http';\nimport type { Chain, WalletData } from './types';\n\n/**\n * A handle to a single wallet. Returned by `waaskey.wallets.create(...)`.\n *\n * Signing is an interactive threshold-MPC protocol; from the caller's point of\n * view it is a single awaited call that returns the signature.\n */\nexport class Wallet implements WalletData {\n  readonly id: string;\n  readonly address: string;\n  readonly chain: Chain;\n\n  constructor(\n    private readonly http: HttpClient,\n    data: WalletData,\n  ) {\n    this.id = data.id;\n    this.address = data.address;\n    this.chain = data.chain;\n  }\n\n  /** Sign an arbitrary message with this wallet's key (2-of-3 threshold MPC). */\n  async signMessage(message: string): Promise<string> {\n    const { signature } = await this.http.request<{ signature: string }>('POST', `/v1/wallets/${this.id}/sign-message`, { message });\n    return signature;\n  }\n}\n","import type { HttpClient } from './http';\nimport type { CreateWalletParams, WalletData } from './types';\nimport { Wallet } from './wallet';\n\n/** The `wallets` resource: create and load wallets. */\nexport class Wallets {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a new MPC wallet on the given chain. */\n  async create(params: CreateWalletParams): Promise<Wallet> {\n    const data = await this.http.request<WalletData>('POST', '/v1/wallets', params);\n    return new Wallet(this.http, data);\n  }\n\n  /** Load an existing wallet by id. */\n  async get(id: string): Promise<Wallet> {\n    const data = await this.http.request<WalletData>('GET', `/v1/wallets/${id}`);\n    return new Wallet(this.http, data);\n  }\n}\n","import { HttpClient } from './http';\nimport type { WaaskeyOptions } from './types';\nimport { Wallets } from './wallets';\n\nconst DEFAULT_BASE_URL = 'https://api.waaskey.com';\n\n/**\n * The Waaskey client — entry point of the SDK.\n *\n * @example\n * ```ts\n * import { Waaskey } from '@waaskey/sdk';\n *\n * const waaskey = new Waaskey({ apiKey: process.env.WAASKEY_PUBLISHABLE_KEY! });\n * const wallet = await waaskey.wallets.create({ userId: user.id, chain: 'ethereum' });\n * const signature = await wallet.signMessage('Hello Waaskey');\n * ```\n */\nexport class Waaskey {\n  /** The `wallets` resource. */\n  readonly wallets: Wallets;\n\n  constructor(options: WaaskeyOptions) {\n    if (!options?.apiKey) {\n      throw new Error('Waaskey: `apiKey` is required.');\n    }\n    const http = new HttpClient(options.apiKey, options.baseUrl ?? DEFAULT_BASE_URL, options.fetch);\n    this.wallets = new Wallets(http);\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,95 @@
+/**
+ * Public contract for the Waaskey SDK.
+ *
+ * These types describe the wire shapes the SDK exchanges with the Waaskey API.
+ * They will be replaced by types generated from the backend OpenAPI spec once the
+ * API contract is stable; until then this file is the single source of truth.
+ */
+/** Chains a wallet can be created on. */
+type Chain = 'ethereum' | 'polygon' | 'arbitrum' | 'base' | 'optimism' | 'bitcoin' | 'solana';
+/** Options accepted by `new Waaskey(...)`. */
+interface WaaskeyOptions {
+    /** Publishable API key issued from the Waaskey dashboard. */
+    apiKey: string;
+    /** API base URL. Defaults to the Waaskey production API. */
+    baseUrl?: string;
+    /** Custom fetch implementation (e.g. for non-browser runtimes). Defaults to global `fetch`. */
+    fetch?: typeof fetch;
+}
+/** Parameters for creating a wallet. */
+interface CreateWalletParams {
+    /** Your end-user's id in your own system; binds the wallet to that user. */
+    userId?: string;
+    /** Chain the wallet is created on. */
+    chain: Chain;
+}
+/** A wallet as returned by the API. */
+interface WalletData {
+    /** Waaskey wallet id, e.g. `wlt_...`. */
+    id: string;
+    /** On-chain address. */
+    address: string;
+    /** Chain the wallet belongs to. */
+    chain: Chain;
+}
+/** Error thrown for any non-2xx API response. */
+declare class WaaskeyError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(message: string, status: number, code?: string | undefined);
+}
+
+/** Thin typed HTTP client over fetch — the single place requests are issued. */
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(apiKey: string, baseUrl: string, fetchImpl?: typeof fetch);
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+}
+
+/**
+ * A handle to a single wallet. Returned by `waaskey.wallets.create(...)`.
+ *
+ * Signing is an interactive threshold-MPC protocol; from the caller's point of
+ * view it is a single awaited call that returns the signature.
+ */
+declare class Wallet implements WalletData {
+    private readonly http;
+    readonly id: string;
+    readonly address: string;
+    readonly chain: Chain;
+    constructor(http: HttpClient, data: WalletData);
+    /** Sign an arbitrary message with this wallet's key (2-of-3 threshold MPC). */
+    signMessage(message: string): Promise<string>;
+}
+
+/** The `wallets` resource: create and load wallets. */
+declare class Wallets {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Create a new MPC wallet on the given chain. */
+    create(params: CreateWalletParams): Promise<Wallet>;
+    /** Load an existing wallet by id. */
+    get(id: string): Promise<Wallet>;
+}
+
+/**
+ * The Waaskey client — entry point of the SDK.
+ *
+ * @example
+ * ```ts
+ * import { Waaskey } from '@waaskey/sdk';
+ *
+ * const waaskey = new Waaskey({ apiKey: process.env.WAASKEY_PUBLISHABLE_KEY! });
+ * const wallet = await waaskey.wallets.create({ userId: user.id, chain: 'ethereum' });
+ * const signature = await wallet.signMessage('Hello Waaskey');
+ * ```
+ */
+declare class Waaskey {
+    /** The `wallets` resource. */
+    readonly wallets: Wallets;
+    constructor(options: WaaskeyOptions);
+}
+
+export { type Chain, type CreateWalletParams, Waaskey, WaaskeyError, type WaaskeyOptions, Wallet, type WalletData, Wallets };

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Public contract for the Waaskey SDK.
+ *
+ * These types describe the wire shapes the SDK exchanges with the Waaskey API.
+ * They will be replaced by types generated from the backend OpenAPI spec once the
+ * API contract is stable; until then this file is the single source of truth.
+ */
+/** Chains a wallet can be created on. */
+type Chain = 'ethereum' | 'polygon' | 'arbitrum' | 'base' | 'optimism' | 'bitcoin' | 'solana';
+/** Options accepted by `new Waaskey(...)`. */
+interface WaaskeyOptions {
+    /** Publishable API key issued from the Waaskey dashboard. */
+    apiKey: string;
+    /** API base URL. Defaults to the Waaskey production API. */
+    baseUrl?: string;
+    /** Custom fetch implementation (e.g. for non-browser runtimes). Defaults to global `fetch`. */
+    fetch?: typeof fetch;
+}
+/** Parameters for creating a wallet. */
+interface CreateWalletParams {
+    /** Your end-user's id in your own system; binds the wallet to that user. */
+    userId?: string;
+    /** Chain the wallet is created on. */
+    chain: Chain;
+}
+/** A wallet as returned by the API. */
+interface WalletData {
+    /** Waaskey wallet id, e.g. `wlt_...`. */
+    id: string;
+    /** On-chain address. */
+    address: string;
+    /** Chain the wallet belongs to. */
+    chain: Chain;
+}
+/** Error thrown for any non-2xx API response. */
+declare class WaaskeyError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(message: string, status: number, code?: string | undefined);
+}
+
+/** Thin typed HTTP client over fetch — the single place requests are issued. */
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(apiKey: string, baseUrl: string, fetchImpl?: typeof fetch);
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+}
+
+/**
+ * A handle to a single wallet. Returned by `waaskey.wallets.create(...)`.
+ *
+ * Signing is an interactive threshold-MPC protocol; from the caller's point of
+ * view it is a single awaited call that returns the signature.
+ */
+declare class Wallet implements WalletData {
+    private readonly http;
+    readonly id: string;
+    readonly address: string;
+    readonly chain: Chain;
+    constructor(http: HttpClient, data: WalletData);
+    /** Sign an arbitrary message with this wallet's key (2-of-3 threshold MPC). */
+    signMessage(message: string): Promise<string>;
+}
+
+/** The `wallets` resource: create and load wallets. */
+declare class Wallets {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Create a new MPC wallet on the given chain. */
+    create(params: CreateWalletParams): Promise<Wallet>;
+    /** Load an existing wallet by id. */
+    get(id: string): Promise<Wallet>;
+}
+
+/**
+ * The Waaskey client — entry point of the SDK.
+ *
+ * @example
+ * ```ts
+ * import { Waaskey } from '@waaskey/sdk';
+ *
+ * const waaskey = new Waaskey({ apiKey: process.env.WAASKEY_PUBLISHABLE_KEY! });
+ * const wallet = await waaskey.wallets.create({ userId: user.id, chain: 'ethereum' });
+ * const signature = await wallet.signMessage('Hello Waaskey');
+ * ```
+ */
+declare class Waaskey {
+    /** The `wallets` resource. */
+    readonly wallets: Wallets;
+    constructor(options: WaaskeyOptions);
+}
+
+export { type Chain, type CreateWalletParams, Waaskey, WaaskeyError, type WaaskeyOptions, Wallet, type WalletData, Wallets };

package/dist/index.js

@@ -0,0 +1,99 @@
+// src/types.ts
+var WaaskeyError = class extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "WaaskeyError";
+  }
+  status;
+  code;
+};
+
+// src/http.ts
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  fetchImpl;
+  constructor(apiKey, baseUrl, fetchImpl) {
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    const resolved = fetchImpl ?? globalThis.fetch;
+    if (!resolved) {
+      throw new Error("No fetch implementation available \u2014 pass `fetch` in WaaskeyOptions.");
+    }
+    this.fetchImpl = resolved.bind(globalThis);
+  }
+  async request(method, path, body) {
+    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        authorization: `Bearer ${this.apiKey}`,
+        "content-type": "application/json"
+      },
+      body: body === void 0 ? void 0 : JSON.stringify(body)
+    });
+    if (!res.ok) {
+      const detail = await res.json().catch(() => ({}));
+      const message = typeof detail.message === "string" ? detail.message : res.statusText;
+      const code = typeof detail.code === "string" ? detail.code : void 0;
+      throw new WaaskeyError(message, res.status, code);
+    }
+    return await res.json();
+  }
+};
+
+// src/wallet.ts
+var Wallet = class {
+  constructor(http, data) {
+    this.http = http;
+    this.id = data.id;
+    this.address = data.address;
+    this.chain = data.chain;
+  }
+  http;
+  id;
+  address;
+  chain;
+  /** Sign an arbitrary message with this wallet's key (2-of-3 threshold MPC). */
+  async signMessage(message) {
+    const { signature } = await this.http.request("POST", `/v1/wallets/${this.id}/sign-message`, { message });
+    return signature;
+  }
+};
+
+// src/wallets.ts
+var Wallets = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Create a new MPC wallet on the given chain. */
+  async create(params) {
+    const data = await this.http.request("POST", "/v1/wallets", params);
+    return new Wallet(this.http, data);
+  }
+  /** Load an existing wallet by id. */
+  async get(id) {
+    const data = await this.http.request("GET", `/v1/wallets/${id}`);
+    return new Wallet(this.http, data);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.waaskey.com";
+var Waaskey = class {
+  /** The `wallets` resource. */
+  wallets;
+  constructor(options) {
+    if (!options?.apiKey) {
+      throw new Error("Waaskey: `apiKey` is required.");
+    }
+    const http = new HttpClient(options.apiKey, options.baseUrl ?? DEFAULT_BASE_URL, options.fetch);
+    this.wallets = new Wallets(http);
+  }
+};
+
+export { Waaskey, WaaskeyError, Wallet, Wallets };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/http.ts","../src/wallet.ts","../src/wallets.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Public contract for the Waaskey SDK.\n *\n * These types describe the wire shapes the SDK exchanges with the Waaskey API.\n * They will be replaced by types generated from the backend OpenAPI spec once the\n * API contract is stable; until then this file is the single source of truth.\n */\n\n/** Chains a wallet can be created on. */\nexport type Chain = 'ethereum' | 'polygon' | 'arbitrum' | 'base' | 'optimism' | 'bitcoin' | 'solana';\n\n/** Options accepted by `new Waaskey(...)`. */\nexport interface WaaskeyOptions {\n  /** Publishable API key issued from the Waaskey dashboard. */\n  apiKey: string;\n  /** API base URL. Defaults to the Waaskey production API. */\n  baseUrl?: string;\n  /** Custom fetch implementation (e.g. for non-browser runtimes). Defaults to global `fetch`. */\n  fetch?: typeof fetch;\n}\n\n/** Parameters for creating a wallet. */\nexport interface CreateWalletParams {\n  /** Your end-user's id in your own system; binds the wallet to that user. */\n  userId?: string;\n  /** Chain the wallet is created on. */\n  chain: Chain;\n}\n\n/** A wallet as returned by the API. */\nexport interface WalletData {\n  /** Waaskey wallet id, e.g. `wlt_...`. */\n  id: string;\n  /** On-chain address. */\n  address: string;\n  /** Chain the wallet belongs to. */\n  chain: Chain;\n}\n\n/** Error thrown for any non-2xx API response. */\nexport class WaaskeyError extends Error {\n  constructor(\n    message: string,\n    readonly status: number,\n    readonly code?: string,\n  ) {\n    super(message);\n    this.name = 'WaaskeyError';\n  }\n}\n","import { WaaskeyError } from './types';\n\n/** Thin typed HTTP client over fetch — the single place requests are issued. */\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(apiKey: string, baseUrl: string, fetchImpl?: typeof fetch) {\n    this.apiKey = apiKey;\n    this.baseUrl = baseUrl.replace(/\\/$/, '');\n    const resolved = fetchImpl ?? globalThis.fetch;\n    if (!resolved) {\n      throw new Error('No fetch implementation available — pass `fetch` in WaaskeyOptions.');\n    }\n    this.fetchImpl = resolved.bind(globalThis);\n  }\n\n  async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {\n      method,\n      headers: {\n        authorization: `Bearer ${this.apiKey}`,\n        'content-type': 'application/json',\n      },\n      body: body === undefined ? undefined : JSON.stringify(body),\n    });\n\n    if (!res.ok) {\n      const detail = await res.json().catch(() => ({}) as Record<string, unknown>);\n      const message = typeof detail.message === 'string' ? detail.message : res.statusText;\n      const code = typeof detail.code === 'string' ? detail.code : undefined;\n      throw new WaaskeyError(message, res.status, code);\n    }\n\n    return (await res.json()) as T;\n  }\n}\n","import type { HttpClient } from './http';\nimport type { Chain, WalletData } from './types';\n\n/**\n * A handle to a single wallet. Returned by `waaskey.wallets.create(...)`.\n *\n * Signing is an interactive threshold-MPC protocol; from the caller's point of\n * view it is a single awaited call that returns the signature.\n */\nexport class Wallet implements WalletData {\n  readonly id: string;\n  readonly address: string;\n  readonly chain: Chain;\n\n  constructor(\n    private readonly http: HttpClient,\n    data: WalletData,\n  ) {\n    this.id = data.id;\n    this.address = data.address;\n    this.chain = data.chain;\n  }\n\n  /** Sign an arbitrary message with this wallet's key (2-of-3 threshold MPC). */\n  async signMessage(message: string): Promise<string> {\n    const { signature } = await this.http.request<{ signature: string }>('POST', `/v1/wallets/${this.id}/sign-message`, { message });\n    return signature;\n  }\n}\n","import type { HttpClient } from './http';\nimport type { CreateWalletParams, WalletData } from './types';\nimport { Wallet } from './wallet';\n\n/** The `wallets` resource: create and load wallets. */\nexport class Wallets {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Create a new MPC wallet on the given chain. */\n  async create(params: CreateWalletParams): Promise<Wallet> {\n    const data = await this.http.request<WalletData>('POST', '/v1/wallets', params);\n    return new Wallet(this.http, data);\n  }\n\n  /** Load an existing wallet by id. */\n  async get(id: string): Promise<Wallet> {\n    const data = await this.http.request<WalletData>('GET', `/v1/wallets/${id}`);\n    return new Wallet(this.http, data);\n  }\n}\n","import { HttpClient } from './http';\nimport type { WaaskeyOptions } from './types';\nimport { Wallets } from './wallets';\n\nconst DEFAULT_BASE_URL = 'https://api.waaskey.com';\n\n/**\n * The Waaskey client — entry point of the SDK.\n *\n * @example\n * ```ts\n * import { Waaskey } from '@waaskey/sdk';\n *\n * const waaskey = new Waaskey({ apiKey: process.env.WAASKEY_PUBLISHABLE_KEY! });\n * const wallet = await waaskey.wallets.create({ userId: user.id, chain: 'ethereum' });\n * const signature = await wallet.signMessage('Hello Waaskey');\n * ```\n */\nexport class Waaskey {\n  /** The `wallets` resource. */\n  readonly wallets: Wallets;\n\n  constructor(options: WaaskeyOptions) {\n    if (!options?.apiKey) {\n      throw new Error('Waaskey: `apiKey` is required.');\n    }\n    const http = new HttpClient(options.apiKey, options.baseUrl ?? DEFAULT_BASE_URL, options.fetch);\n    this.wallets = new Wallets(http);\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@waaskey/sdk",
+  "version": "0.0.1",
+  "description": "Waaskey — embedded, non-custodial MPC wallets for your app. Official TypeScript SDK.",
+  "license": "MIT",
+  "author": "Waaskey",
+  "homepage": "https://waaskey.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Next-Vector/waas-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Next-Vector/waas-sdk/issues"
+  },
+  "keywords": [
+    "waaskey",
+    "wallet",
+    "mpc",
+    "web3",
+    "ethereum",
+    "non-custodial",
+    "embedded-wallet"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "packageManager": "pnpm@10.28.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "start": "tsup --watch",
+    "types": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier . --write",
+    "format:check": "prettier . --check",
+    "test:unit": "vitest run",
+    "prepublishOnly": "pnpm build"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.10.0",
+    "eslint": "^10.5.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.8.4",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.61.1",
+    "vitest": "^4.1.9"
+  }
+}