keepkey-vault-sdk 1.2.6 → 2.0.1

package/lib/client.d.ts

@@ -0,0 +1,43 @@
+export declare class VaultClient {
+    private baseUrl;
+    private apiKey;
+    private serviceName;
+    private serviceImageUrl;
+    private rePairPromise;
+    /** Default timeout for read operations (ms). */
+    timeoutMs: number;
+    /** Timeout for signing operations (ms). */
+    signingTimeoutMs: number;
+    constructor(baseUrl: string, apiKey?: string, serviceName?: string, serviceImageUrl?: string);
+    /** Current API key (set after pairing) */
+    getApiKey(): string | null;
+    /** Set API key (e.g. after manual pairing) */
+    setApiKey(key: string): void;
+    /** Build headers for a request */
+    private headers;
+    /** Create an AbortSignal with timeout */
+    private signal;
+    /** GET request */
+    get<T = any>(path: string, timeoutMs?: number): Promise<T>;
+    /** POST request */
+    post<T = any>(path: string, body?: any, timeoutMs?: number): Promise<T>;
+    /** DELETE request */
+    delete<T = any>(path: string): Promise<T>;
+    /** Pair with the vault — user must approve on the device UI */
+    pair(): Promise<string>;
+    /** Check if vault is reachable */
+    ping(): Promise<boolean>;
+    /** Verify current API key is valid */
+    verifyAuth(): Promise<boolean>;
+    /**
+     * Attempt to re-pair when a 403 is received.
+     * Uses a mutex so concurrent 403s only trigger one re-pair attempt.
+     */
+    private tryRePair;
+}
+/** SDK-specific error with HTTP status */
+export declare class SdkError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+//# sourceMappingURL=client.d.ts.map

package/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,aAAa,CAAgC;IACrD,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAA;gBAGtB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,SAAsB,EACjC,eAAe,SAAK;IAWtB,0CAA0C;IAC1C,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B,8CAA8C;IAC9C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5B,kCAAkC;IAClC,OAAO,CAAC,OAAO;IAMf,yCAAyC;IACzC,OAAO,CAAC,MAAM;IAId,kBAAkB;IACZ,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBhE,mBAAmB;IACb,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAwB7E,qBAAqB;IACf,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAsB/C,+DAA+D;IACzD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAoB7B,kCAAkC;IAC5B,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAY9B,sCAAsC;IAChC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBpC;;;OAGG;YACW,SAAS;CAMxB;AAED,0CAA0C;AAC1C,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAA;gBACF,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK5C"}

package/lib/client.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SdkError = exports.VaultClient = void 0;
+const DEFAULT_TIMEOUT_MS = 30000;
+const SIGNING_TIMEOUT_MS = 600000;
+class VaultClient {
+    constructor(baseUrl, apiKey, serviceName = 'keepkey-vault-sdk', serviceImageUrl = '') {
+        this.rePairPromise = null;
+        // Strip trailing slash
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.apiKey = apiKey || null;
+        this.serviceName = serviceName;
+        this.serviceImageUrl = serviceImageUrl;
+        this.timeoutMs = DEFAULT_TIMEOUT_MS;
+        this.signingTimeoutMs = SIGNING_TIMEOUT_MS;
+    }
+    /** Current API key (set after pairing) */
+    getApiKey() {
+        return this.apiKey;
+    }
+    /** Set API key (e.g. after manual pairing) */
+    setApiKey(key) {
+        this.apiKey = key;
+    }
+    /** Build headers for a request */
+    headers() {
+        const h = { 'Content-Type': 'application/json' };
+        if (this.apiKey)
+            h['Authorization'] = `Bearer ${this.apiKey}`;
+        return h;
+    }
+    /** Create an AbortSignal with timeout */
+    signal(ms) {
+        return AbortSignal.timeout(ms ?? this.timeoutMs);
+    }
+    /** GET request */
+    async get(path, timeoutMs) {
+        const resp = await fetch(`${this.baseUrl}${path}`, {
+            method: 'GET',
+            headers: this.headers(),
+            signal: this.signal(timeoutMs),
+        });
+        if (resp.status === 403 && this.apiKey) {
+            const rePaired = await this.tryRePair();
+            if (rePaired) {
+                const retry = await fetch(`${this.baseUrl}${path}`, {
+                    method: 'GET',
+                    headers: this.headers(),
+                    signal: this.signal(timeoutMs),
+                });
+                if (!retry.ok)
+                    throw new SdkError(retry.status, await retry.text());
+                return retry.json();
+            }
+        }
+        if (!resp.ok)
+            throw new SdkError(resp.status, await resp.text());
+        return resp.json();
+    }
+    /** POST request */
+    async post(path, body, timeoutMs) {
+        const resp = await fetch(`${this.baseUrl}${path}`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+            signal: this.signal(timeoutMs),
+        });
+        if (resp.status === 403 && this.apiKey) {
+            const rePaired = await this.tryRePair();
+            if (rePaired) {
+                const retry = await fetch(`${this.baseUrl}${path}`, {
+                    method: 'POST',
+                    headers: this.headers(),
+                    body: body !== undefined ? JSON.stringify(body) : undefined,
+                    signal: this.signal(timeoutMs),
+                });
+                if (!retry.ok)
+                    throw new SdkError(retry.status, await retry.text());
+                return retry.json();
+            }
+        }
+        if (!resp.ok)
+            throw new SdkError(resp.status, await resp.text());
+        return resp.json();
+    }
+    /** DELETE request */
+    async delete(path) {
+        const resp = await fetch(`${this.baseUrl}${path}`, {
+            method: 'DELETE',
+            headers: this.headers(),
+            signal: this.signal(),
+        });
+        if (resp.status === 403 && this.apiKey) {
+            const rePaired = await this.tryRePair();
+            if (rePaired) {
+                const retry = await fetch(`${this.baseUrl}${path}`, {
+                    method: 'DELETE',
+                    headers: this.headers(),
+                    signal: this.signal(),
+                });
+                if (!retry.ok)
+                    throw new SdkError(retry.status, await retry.text());
+                return retry.json();
+            }
+        }
+        if (!resp.ok)
+            throw new SdkError(resp.status, await resp.text());
+        return resp.json();
+    }
+    /** Pair with the vault — user must approve on the device UI */
+    async pair() {
+        const resp = await fetch(`${this.baseUrl}/auth/pair`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                name: this.serviceName,
+                url: '',
+                imageUrl: this.serviceImageUrl,
+            }),
+            signal: this.signal(this.signingTimeoutMs),
+        });
+        if (!resp.ok)
+            throw new SdkError(resp.status, `Pairing failed: ${await resp.text()}`);
+        const data = (await resp.json());
+        if (!data || typeof data.apiKey !== 'string' || !data.apiKey) {
+            throw new SdkError(500, 'Pairing response missing apiKey');
+        }
+        this.apiKey = data.apiKey;
+        return data.apiKey;
+    }
+    /** Check if vault is reachable */
+    async ping() {
+        try {
+            const resp = await fetch(`${this.baseUrl}/api/health`, {
+                method: 'GET',
+                signal: this.signal(5000),
+            });
+            return resp.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Verify current API key is valid */
+    async verifyAuth() {
+        if (!this.apiKey)
+            return false;
+        try {
+            const resp = await fetch(`${this.baseUrl}/auth/pair`, {
+                method: 'GET',
+                headers: this.headers(),
+                signal: this.signal(),
+            });
+            if (!resp.ok)
+                return false;
+            const data = (await resp.json());
+            return data.paired === true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Attempt to re-pair when a 403 is received.
+     * Uses a mutex so concurrent 403s only trigger one re-pair attempt.
+     */
+    async tryRePair() {
+        if (this.rePairPromise)
+            return this.rePairPromise;
+        this.rePairPromise = this.pair().then(() => true, () => false)
+            .finally(() => { this.rePairPromise = null; });
+        return this.rePairPromise;
+    }
+}
+exports.VaultClient = VaultClient;
+/** SDK-specific error with HTTP status */
+class SdkError extends Error {
+    constructor(status, message) {
+        super(message);
+        this.name = 'SdkError';
+        this.status = status;
+    }
+}
+exports.SdkError = SdkError;
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,196 @@
+import { VaultClient } from './client';
+import type { SdkConfig, DeviceFeatures, DeviceInfo, SignedTx, AddressRequest, EthSignTxParams, EthSignTypedDataParams, EthSignMessageParams, EthVerifyMessageParams, BtcSignTxParams, CosmosAminoSignParams, XrpSignTxParams, BnbSignTxParams, SolanaSignTxParams, GetPublicKeyRequest, BatchPubkeysPath, ApplySettingsParams, HealthResponse, SupportedAsset } from './types';
+export { SdkError } from './client';
+export * from './types';
+export declare class KeepKeySdk {
+    private client;
+    /** Use KeepKeySdk.create() instead of constructing directly */
+    private constructor();
+    /**
+     * Create a connected KeepKeySdk instance.
+     *
+     * Accepts both v2 config shape and v1 compat shape:
+     *   v2: { apiKey, baseUrl, serviceName, serviceImageUrl }
+     *   v1: { apiKey, basePath, pairingInfo: { name, imageUrl, basePath, url } }
+     */
+    static create(config?: SdkConfig): Promise<KeepKeySdk>;
+    /** Access the underlying HTTP client (for advanced usage) */
+    getClient(): VaultClient;
+    /** Current API key */
+    get apiKey(): string | null;
+    system: {
+        info: {
+            getFeatures: () => Promise<DeviceFeatures>;
+            getDevices: () => Promise<{
+                devices: DeviceInfo[];
+                total: number;
+            }>;
+            getSupportedAssets: () => Promise<{
+                assets: SupportedAsset[];
+            }>;
+            getHealth: () => Promise<HealthResponse>;
+            listCoins: () => Promise<any[]>;
+            getPublicKey: (params: GetPublicKeyRequest) => Promise<{
+                xpub: string;
+            }>;
+            ping: () => Promise<{
+                message: string;
+            }>;
+        };
+        device: {
+            ping: () => Promise<{
+                message: string;
+            }>;
+            wipe: () => Promise<{
+                success: boolean;
+            }>;
+            applySettings: (params: ApplySettingsParams) => Promise<{
+                success: boolean;
+            }>;
+            applyPolicies: (params: any) => Promise<{
+                success: boolean;
+            }>;
+            changePin: (remove?: boolean) => Promise<{
+                success: boolean;
+            }>;
+            clearSession: () => Promise<{
+                success: boolean;
+            }>;
+            resetDevice: (params: {
+                word_count?: number;
+                label?: string;
+                pin_protection?: boolean;
+                passphrase_protection?: boolean;
+            }) => Promise<{
+                success: boolean;
+            }>;
+            recoverDevice: (params: {
+                word_count?: number;
+                label?: string;
+                pin_protection?: boolean;
+                passphrase_protection?: boolean;
+            }) => Promise<{
+                success: boolean;
+            }>;
+            loadDevice: (params: any) => Promise<{
+                success: boolean;
+            }>;
+            sendPin: (pin: string) => Promise<{
+                success: boolean;
+            }>;
+        };
+    };
+    info: any;
+    utxo: {
+        utxoSignTransaction: (params: any) => Promise<any>;
+    };
+    xrp: any;
+    initialize: any;
+    auth: any;
+    address: {
+        utxoGetAddress: (params: AddressRequest) => Promise<{
+            address: string;
+        }>;
+        ethGetAddress: (params: AddressRequest) => Promise<{
+            address: string;
+        }>;
+        ethereumGetAddress: (params: any) => Promise<{
+            address: string;
+        }>;
+        cosmosGetAddress: (params: AddressRequest) => Promise<{
+            address: string;
+        }>;
+        thorchainGetAddress: (params: AddressRequest) => Promise<{
+            address: string;
+        }>;
+        mayachainGetAddress: (params: AddressRequest) => Promise<{
+            address: string;
+        }>;
+        osmosisGetAddress: (params: AddressRequest) => Promise<{
+            address: string;
+        }>;
+        tendermintGetAddress: (params: AddressRequest) => Promise<{
+            address: string;
+        }>;
+        xrpGetAddress: (params: AddressRequest) => Promise<{
+            address: string;
+        }>;
+        bnbGetAddress: (params: AddressRequest) => Promise<{
+            address: string;
+        }>;
+        binanceGetAddress: (params: any) => Promise<{
+            address: string;
+        }>;
+        solanaGetAddress: (params: AddressRequest) => Promise<{
+            address: string;
+        }>;
+    };
+    eth: {
+        ethSignTransaction: (params: EthSignTxParams) => Promise<SignedTx>;
+        ethSignMessage: (params: EthSignMessageParams) => Promise<any>;
+        ethSignTypedData: (params: EthSignTypedDataParams) => Promise<any>;
+        ethVerifyMessage: (params: EthVerifyMessageParams) => Promise<boolean>;
+    };
+    btc: {
+        btcSignTransaction: (params: BtcSignTxParams) => Promise<SignedTx>;
+    };
+    cosmos: {
+        cosmosSignAmino: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        cosmosSignAminoDelegate: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        cosmosSignAminoUndelegate: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        cosmosSignAminoRedelegate: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        cosmosSignAminoWithdrawRewards: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        cosmosSignAminoWithdrawDelegatorRewardsAll: (params: any) => Promise<SignedTx>;
+        cosmosSignAminoIbcTransfer: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+    };
+    osmosis: {
+        osmosisSignAmino: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        osmosisSignAminoDelegate: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        osmosisSignAminoUndelegate: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        osmosisSignAminoRedelegate: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        osmosisSignAminoWithdrawRewards: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        osmosisSignAminoIbcTransfer: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        osmosisSignAminoLpRemove: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        osmosisSignAminoLpAdd: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        osmosisSignAminoSwap: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        osmoSignAminoDelegate: (params: any) => Promise<SignedTx>;
+        osmoSignAminoUndelegate: (params: any) => Promise<SignedTx>;
+        osmoSignAminoRedelegate: (params: any) => Promise<SignedTx>;
+        osmoSignAminoWithdrawDelegatorRewardsAll: (params: any) => Promise<SignedTx>;
+        osmoSignAminoIbcTransfer: (params: any) => Promise<SignedTx>;
+        osmoSignAminoLpAdd: (params: any) => Promise<SignedTx>;
+        osmoSignAminoLpRemove: (params: any) => Promise<SignedTx>;
+        osmoSignAminoSwap: (params: any) => Promise<SignedTx>;
+    };
+    thorchain: {
+        thorchainSignAminoTransfer: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        thorchainSignAminoDeposit: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+    };
+    mayachain: {
+        mayachainSignAminoTransfer: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+        mayachainSignAminoDeposit: (params: CosmosAminoSignParams) => Promise<SignedTx>;
+    };
+    ripple: {
+        xrpSignTransaction: (params: XrpSignTxParams) => Promise<SignedTx>;
+    };
+    binance: {
+        binanceSignTransaction: (params: BnbSignTxParams) => Promise<SignedTx>;
+    };
+    solana: {
+        solanaSignTransaction: (params: SolanaSignTxParams) => Promise<SignedTx>;
+    };
+    xpub: {
+        getPublicKey: (params: GetPublicKeyRequest) => Promise<{
+            xpub: string;
+        }>;
+        getPublicKeys: (paths: BatchPubkeysPath[]) => Promise<{
+            pubkeys: any[];
+            cached_count: number;
+            total_requested: number;
+        }>;
+    };
+    deviceStatus: {
+        isDeviceConnected: () => Promise<boolean>;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}