@guveno/wallet-sdk 1.0.2 → 1.1.0

package/dist/signing/sign-withdrawal.d.ts

@@ -8,13 +8,15 @@ export interface SignWithdrawalInput {
     derivationPath: string;
     /** Caller-customized Ethereum gas (wei / units); falls back to server suggestions. */
     ethereumGas?: EthereumGasOverrides;
+    /** Caller-customized Bitcoin fee rate (sat/vB); falls back to the server suggestion. */
+    bitcoinFeeRate?: number;
 }
 /**
  * Produces a fully-signed raw transaction (hex) for a prepared withdrawal. Pure — no
  * network access. New chains are added here as their per-chain signer + server chain
  * state land.
  */
-export declare function signWithdrawal({ payload, mnemonic, derivationPath, ethereumGas }: SignWithdrawalInput): Promise<string>;
+export declare function signWithdrawal({ payload, mnemonic, derivationPath, ethereumGas, bitcoinFeeRate }: SignWithdrawalInput): Promise<string>;
 /** Chains the SDK signer currently supports. */
 export declare const SIGNABLE_CHAINS: readonly ["ethereum", "xrp", "bitcoin", "polkadot"];
 export declare function canSignChain(chain: string): boolean;

package/dist/signing/sign-withdrawal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sign-withdrawal.d.ts","sourceRoot":"","sources":["../../src/signing/sign-withdrawal.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAGvF,OAAO,EAAmD,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAElG,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,2FAA2F;IAC3F,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,EACnC,OAAO,EACP,QAAQ,EACR,cAAc,EACd,WAAW,EACZ,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBvC;AAED,gDAAgD;AAChD,eAAO,MAAM,eAAe,qDAAsD,CAAC;AAEnF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD"}
+{"version":3,"file":"sign-withdrawal.d.ts","sourceRoot":"","sources":["../../src/signing/sign-withdrawal.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAGvF,OAAO,EAAmD,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAElG,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,2FAA2F;IAC3F,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,EACnC,OAAO,EACP,QAAQ,EACR,cAAc,EACd,WAAW,EACX,cAAc,EACf,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBvC;AAED,gDAAgD;AAChD,eAAO,MAAM,eAAe,qDAAsD,CAAC;AAEnF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/signing/sign-withdrawal.js

@@ -9,7 +9,7 @@ import { UnsupportedSigningError, WithdrawalExpiredError } from './types.js';
  * network access. New chains are added here as their per-chain signer + server chain
  * state land.
  */
-export async function signWithdrawal({ payload, mnemonic, derivationPath, ethereumGas }) {
+export async function signWithdrawal({ payload, mnemonic, derivationPath, ethereumGas, bitcoinFeeRate }) {
     assertValidMnemonic(mnemonic);
     if (Date.now() >= new Date(payload.expiresAt).getTime()) {
         throw new WithdrawalExpiredError();
@@ -20,7 +20,10 @@ export async function signWithdrawal({ payload, mnemonic, derivationPath, ethere
         case 'xrp':
             return signXrpWithdrawal(payload, mnemonic, derivationPath);
         case 'bitcoin':
-            return signBitcoinWithdrawal(payload, mnemonic, derivationPath);
+            // Bitcoin derives a key per input from each UTXO's own path (in chainState),
+            // so the address-level derivationPath isn't used here. An optional fee-rate
+            // override (sat/vB) replaces the server's suggestion.
+            return signBitcoinWithdrawal(payload, mnemonic, bitcoinFeeRate);
         case 'polkadot':
             return signPolkadotWithdrawal(payload, mnemonic, derivationPath);
         default:

package/dist/signing/sign-withdrawal.js.map

@@ -1 +1 @@
-{"version":3,"file":"sign-withdrawal.js","sourceRoot":"","sources":["../../src/signing/sign-withdrawal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAA6B,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAuB,MAAM,YAAY,CAAC;AAYlG;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EACnC,OAAO,EACP,QAAQ,EACR,cAAc,EACd,WAAW,EACS;IACpB,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAE9B,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,sBAAsB,EAAE,CAAC;IACrC,CAAC;IAED,QAAQ,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,KAAK,UAAU;YACb,OAAO,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;QAChF,KAAK,KAAK;YACR,OAAO,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;QAC9D,KAAK,SAAS;YACZ,OAAO,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;QAClE,KAAK,UAAU;YACb,OAAO,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;QACnE;YACE,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAEnF,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAQ,eAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"sign-withdrawal.js","sourceRoot":"","sources":["../../src/signing/sign-withdrawal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAA6B,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAuB,MAAM,YAAY,CAAC;AAclG;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EACnC,OAAO,EACP,QAAQ,EACR,cAAc,EACd,WAAW,EACX,cAAc,EACM;IACpB,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAE9B,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,sBAAsB,EAAE,CAAC;IACrC,CAAC;IAED,QAAQ,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,KAAK,UAAU;YACb,OAAO,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;QAChF,KAAK,KAAK;YACR,OAAO,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;QAC9D,KAAK,SAAS;YACZ,6EAA6E;YAC7E,4EAA4E;YAC5E,sDAAsD;YACtD,OAAO,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;QAClE,KAAK,UAAU;YACb,OAAO,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;QACnE;YACE,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAEnF,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAQ,eAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/signing/types.d.ts

@@ -16,13 +16,21 @@ export interface EthereumChainState {
     gasLimit: string;
 }
 export interface BitcoinChainState {
+    /**
+     * The exact inputs the server coin-selected (already covering amount + fee).
+     * Each carries its owning address + derivation path so an aggregated tx can
+     * sign every input with the right key.
+     */
     utxos: Array<{
         txid: string;
         vout: number;
         value: number;
+        address: string;
+        derivationPath: string;
         scriptPubKey?: string;
     }>;
     feeRate: number;
+    /** Wallet-owned address that any change output returns to. */
     changeAddress: string;
 }
 export interface XrpChainState {

package/dist/signing/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/signing/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpE,wGAAwG;AACxG,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAErG,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,gFAAgF;AAChF,qBAAa,sBAAuB,SAAQ,KAAK;;CAKhD;AAED,iEAAiE;AACjE,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,KAAK,EAAE,MAAM;CAI1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/signing/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpE,wGAAwG;AACxG,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5H,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAErG,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,gFAAgF;AAChF,qBAAa,sBAAuB,SAAQ,KAAK;;CAKhD;AAED,iEAAiE;AACjE,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,KAAK,EAAE,MAAM;CAI1B"}

package/dist/signing/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/signing/types.ts"],"names":[],"mappings":"AA+EA,gFAAgF;AAChF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C;QACE,KAAK,CAAC,kEAAkE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,KAAa;QACvB,KAAK,CAAC,cAAc,KAAK,wBAAwB,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/signing/types.ts"],"names":[],"mappings":"AAqFA,gFAAgF;AAChF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C;QACE,KAAK,CAAC,kEAAkE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,KAAa;QACvB,KAAK,CAAC,cAAc,KAAK,wBAAwB,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/wallet.d.ts

@@ -0,0 +1,63 @@
+import type { GuvenoApiClient } from './api/client.js';
+import type { ApiPageInfo, ApiWalletAddress, ApiWalletDetail, ListApiAddressOptions } from './api/types.js';
+import type { ApiChain, ApiNetwork, ApiWithdrawal } from './api/types.js';
+import type { EncryptionSession } from './encryption-session.js';
+import { type WithdrawInput } from './hot-wallet.js';
+import type { KeyProvider } from './keyprovider/index.js';
+import { type DeriveAddressOptions, type DeriveAddressResult } from './wallet-service.js';
+/**
+ * A withdrawal request from a loaded wallet. The wallet is implied, so `walletId`
+ * is omitted — pass the source `addressId` and the asset/amount/destination.
+ */
+export type WalletWithdrawInput = Omit<WithdrawInput, 'walletId'>;
+export interface WalletDeps {
+    api: GuvenoApiClient;
+    detail: ApiWalletDetail;
+    /** Server-source-of-truth mode: unlocked with the user's encryption password. */
+    session?: EncryptionSession;
+    /** Headless mode: the recovery phrase is sourced from a KMS/HSM/file provider. */
+    keys?: KeyProvider;
+}
+/**
+ * A single wallet, ready to use. Returned by {@link Guveno.loadWallet},
+ * {@link Guveno.createWallet}, and {@link Guveno.importWallet}. The signing key
+ * is already resolved (either the unlocked encryption key, or a key provider), so
+ * you can withdraw, derive addresses, and reveal the recovery phrase without
+ * re-supplying credentials.
+ */
+export declare class Wallet {
+    private readonly api;
+    private readonly session;
+    private readonly hot;
+    private readonly service;
+    private walletDetail;
+    constructor(deps: WalletDeps);
+    /** The wallet's server id. */
+    get id(): number;
+    get name(): string;
+    get chain(): ApiChain;
+    get network(): ApiNetwork;
+    /** The underlying server record, e.g. for display. */
+    get detail(): ApiWalletDetail;
+    /** Prepare, sign locally, and broadcast a withdrawal from one of this wallet's addresses. */
+    withdraw(input: WalletWithdrawInput): Promise<ApiWithdrawal>;
+    /** Fetch the current state of a withdrawal (e.g. to poll for confirmation). */
+    getWithdrawal(withdrawalId: number): Promise<ApiWithdrawal>;
+    /** List the addresses registered for this wallet. */
+    listAddresses(options?: ListApiAddressOptions): Promise<{
+        items: ApiWalletAddress[];
+        pageInfo: ApiPageInfo;
+    }>;
+    /**
+     * Derive and register the next address (uses the server's `nextAccountIndex`).
+     * Requires loading the wallet with your encryption password — a key provider
+     * can't seal against the server.
+     */
+    deriveAddress(options?: DeriveAddressOptions): Promise<DeriveAddressResult>;
+    /** Fetch and decrypt this wallet's recovery phrase from the server (audited). */
+    revealMnemonic(): Promise<string>;
+    /** Wipe the unlocked key material from memory. The wallet can't sign afterwards. */
+    lock(): void;
+    private requireService;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/dist/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAiB,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEzG;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,eAAe,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;IACxB,iFAAiF;IACjF,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,kFAAkF;IAClF,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;;;;;GAMG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAGhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,YAAY,CAAkB;gBAE1B,IAAI,EAAE,UAAU;IAY5B,8BAA8B;IAC9B,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,QAAQ,CAEpB;IAED,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,sDAAsD;IACtD,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,6FAA6F;IACvF,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIlE,+EAA+E;IACzE,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjE,qDAAqD;IAC/C,aAAa,CACjB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,QAAQ,EAAE,WAAW,CAAA;KAAE,CAAC;IAIhE;;;;OAIG;IACG,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMrF,iFAAiF;IAC3E,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvC,oFAAoF;IACpF,IAAI,IAAI,IAAI;IAIZ,OAAO,CAAC,cAAc;CAQvB"}

package/dist/wallet.js

@@ -0,0 +1,84 @@
+import { ValidationError } from './errors.js';
+import { HotWallet } from './hot-wallet.js';
+import { WalletService } from './wallet-service.js';
+/**
+ * A single wallet, ready to use. Returned by {@link Guveno.loadWallet},
+ * {@link Guveno.createWallet}, and {@link Guveno.importWallet}. The signing key
+ * is already resolved (either the unlocked encryption key, or a key provider), so
+ * you can withdraw, derive addresses, and reveal the recovery phrase without
+ * re-supplying credentials.
+ */
+export class Wallet {
+    api;
+    session;
+    hot;
+    // Only available in encryption-password (session) mode — derive/reveal need to
+    // seal/unseal against the server, which a bare key provider can't do.
+    service;
+    walletDetail;
+    constructor(deps) {
+        this.api = deps.api;
+        this.session = deps.session;
+        this.walletDetail = deps.detail;
+        this.hot = new HotWallet({
+            api: deps.api,
+            ...(deps.session != null ? { session: deps.session } : {}),
+            ...(deps.keys != null ? { keys: deps.keys } : {})
+        });
+        this.service = deps.session != null ? new WalletService({ api: deps.api, session: deps.session }) : undefined;
+    }
+    /** The wallet's server id. */
+    get id() {
+        return this.walletDetail.id;
+    }
+    get name() {
+        return this.walletDetail.name;
+    }
+    get chain() {
+        return this.walletDetail.chain;
+    }
+    get network() {
+        return this.walletDetail.network;
+    }
+    /** The underlying server record, e.g. for display. */
+    get detail() {
+        return this.walletDetail;
+    }
+    /** Prepare, sign locally, and broadcast a withdrawal from one of this wallet's addresses. */
+    async withdraw(input) {
+        return this.hot.withdraw({ ...input, walletId: this.walletDetail.id });
+    }
+    /** Fetch the current state of a withdrawal (e.g. to poll for confirmation). */
+    async getWithdrawal(withdrawalId) {
+        return this.api.getWithdrawal(withdrawalId);
+    }
+    /** List the addresses registered for this wallet. */
+    async listAddresses(options = {}) {
+        return this.api.listWalletAddresses(this.walletDetail.id, options);
+    }
+    /**
+     * Derive and register the next address (uses the server's `nextAccountIndex`).
+     * Requires loading the wallet with your encryption password — a key provider
+     * can't seal against the server.
+     */
+    async deriveAddress(options = {}) {
+        const result = await this.requireService('deriveAddress').deriveAddress(this.walletDetail.id, options);
+        this.walletDetail = result.wallet;
+        return result;
+    }
+    /** Fetch and decrypt this wallet's recovery phrase from the server (audited). */
+    async revealMnemonic() {
+        return this.requireService('revealMnemonic').revealMnemonic(this.walletDetail.id);
+    }
+    /** Wipe the unlocked key material from memory. The wallet can't sign afterwards. */
+    lock() {
+        this.session?.lock();
+    }
+    requireService(method) {
+        if (this.service == null) {
+            throw new ValidationError(`${method}() needs the wallet loaded with your encryption password; it isn't available when signing from a key provider.`);
+        }
+        return this.service;
+    }
+}
+//# sourceMappingURL=wallet.js.map

package/dist/wallet.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guveno/wallet-sdk",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Add secure crypto custody to your app in minutes — create and manage multi-chain wallets, automate withdrawals, and receive real-time webhooks for Bitcoin, Ethereum, XRP, and Polkadot. Built for exchanges, fintechs, and platforms.",
   "author": "Guveno LLC",
   "license": "MIT",
@@ -26,7 +26,7 @@
     "crypto",
     "custody"
   ],
-  "homepage": "https://guveno.com",
+  "homepage": "https://www.guveno.com/docs",
   "files": [
     "dist",
     "README.md",