@tatumio/wallet-sdk 0.1.0 → 0.2.1

package/README.md

@@ -99,11 +99,8 @@ Before signing, you can simulate/validate a transaction (balance changes, risk s
 ```ts
 const evaluation = await client.evaluateTransaction({
   query: { chainId: WalletChain.ETHEREUM_MAINNET },
-  body: {
-    network: "ethereum",
-    transaction: { toAddress: "0x...", value: "10000000000000000" },
-  },
-}); // typed as EvaluateTransactionResponse
+  body: { to: "0x...", value: "0x2386f26fc10000", operationType: "all" },
+}); // typed as EvaluateTransactionResponse ({ chain, validation?, simulation? })
 ```
 
 ### Backup and recovery

package/dist/eject/birkhoff.d.ts

@@ -0,0 +1,7 @@
+export interface Bk {
+    x: bigint;
+    rank: number;
+}
+/** First row of the pseudoinverse — the interpolation weights that recover the secret. */
+export declare function computeBkCoefficient(bks: Bk[], threshold: number, fieldOrder: bigint): bigint[];
+//# sourceMappingURL=birkhoff.d.ts.map

package/dist/eject/birkhoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"birkhoff.d.ts","sourceRoot":"","sources":["../../src/eject/birkhoff.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,EAAE;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;CACd;AAgCD,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAG/F"}

package/dist/eject/birkhoff.js

@@ -0,0 +1,33 @@
+import { Matrix } from './matrix.js';
+import { modPow } from './curves.js';
+/** Coefficient of the differential monomial of given degree/rank evaluated at x. */
+function getDiffMonomialCoeff(x, fieldOrder, degree, rank) {
+    if (degree < rank)
+        return 0n;
+    if (degree === 0)
+        return 1n;
+    let extra = 1n;
+    for (let j = 0; j < rank; j++)
+        extra *= BigInt(degree - j);
+    const power = BigInt(degree - rank);
+    const result = modPow(x, power, fieldOrder);
+    return (result * extra) % fieldOrder;
+}
+function getLinearEquationCoefficient(bkX, fieldOrder, degreePoly, rank) {
+    const result = new Array(degreePoly + 1);
+    for (let i = 0; i < result.length; i++) {
+        result[i] = getDiffMonomialCoeff(bkX, fieldOrder, i, rank);
+    }
+    return result;
+}
+function linearEquationCoefficientMatrix(bks, threshold, fieldOrder) {
+    const degree = threshold - 1;
+    const data = bks.map((bk) => getLinearEquationCoefficient(bk.x, fieldOrder, degree, bk.rank));
+    return new Matrix(fieldOrder, data);
+}
+/** First row of the pseudoinverse — the interpolation weights that recover the secret. */
+export function computeBkCoefficient(bks, threshold, fieldOrder) {
+    const matrix = linearEquationCoefficientMatrix(bks, threshold, fieldOrder);
+    return matrix.Pseudoinverse().GetRow(0);
+}
+//# sourceMappingURL=birkhoff.js.map

package/dist/eject/birkhoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"birkhoff.js","sourceRoot":"","sources":["../../src/eject/birkhoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC,oFAAoF;AACpF,SAAS,oBAAoB,CAAC,CAAS,EAAE,UAAkB,EAAE,MAAc,EAAE,IAAY;IACvF,IAAI,MAAM,GAAG,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;QAAE,KAAK,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC5C,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,UAAU,CAAC;AACvC,CAAC;AAED,SAAS,4BAA4B,CACnC,GAAW,EACX,UAAkB,EAClB,UAAkB,EAClB,IAAY;IAEZ,MAAM,MAAM,GAAa,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,+BAA+B,CAAC,GAAS,EAAE,SAAiB,EAAE,UAAkB;IACvF,MAAM,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9F,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,oBAAoB,CAAC,GAAS,EAAE,SAAiB,EAAE,UAAkB;IACnF,MAAM,MAAM,GAAG,+BAA+B,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/eject/curves.d.ts

@@ -0,0 +1,24 @@
+import type { Curve } from '../portal/types/index.js';
+export type { Curve };
+/** Group orders for the supported curves (the modulus for share arithmetic). */
+export declare const FIELD_ORDER: Record<Curve, bigint>;
+/** Always-non-negative remainder. */
+export declare function mod(a: bigint, m: bigint): bigint;
+/** Modular exponentiation x^n mod m. */
+export declare function modPow(x: bigint, n: bigint, m: bigint): bigint;
+/** Modular inverse via the extended Euclidean algorithm. Throws if none exists. */
+export declare function modInverse(a: bigint, m: bigint): bigint;
+export declare function bytesToHex(bytes: Uint8Array): string;
+/** Minimal big-endian byte representation of a non-negative bigint. */
+export declare function bigIntToBytesBE(value: bigint): Uint8Array;
+/** 32-byte big-endian hex string (left-padded). */
+export declare function toPaddedHexBE(value: bigint): string;
+/**
+ * Reverse the minimal big-endian bytes of `value` into a 32-byte buffer,
+ * right-aligned (zero-padded at the front). This matches @portal-hq/eject-js's
+ * ed25519 output exactly — including its treatment of scalars with leading
+ * zero bytes — so reconstructed keys are byte-identical to the reference.
+ * Note: this is NOT a plain left-aligned little-endian encoding.
+ */
+export declare function toLittleEndian32(value: bigint): Uint8Array;
+//# sourceMappingURL=curves.d.ts.map

package/dist/eject/curves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curves.d.ts","sourceRoot":"","sources":["../../src/eject/curves.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD,YAAY,EAAE,KAAK,EAAE,CAAC;AAEtB,gFAAgF;AAChF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAG7C,CAAC;AAEF,qCAAqC;AACrC,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wCAAwC;AACxC,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAW9D;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAYvD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIpD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CASzD;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAQ1D"}

package/dist/eject/curves.js

@@ -0,0 +1,85 @@
+/** Group orders for the supported curves (the modulus for share arithmetic). */
+export const FIELD_ORDER = {
+    SECP256K1: BigInt('0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141'),
+    ED25519: BigInt('0x1000000000000000000000000000000014def9dea2f79cd65812631a5cf5d3ed'),
+};
+/** Always-non-negative remainder. */
+export function mod(a, m) {
+    return ((a % m) + m) % m;
+}
+/** Modular exponentiation x^n mod m. */
+export function modPow(x, n, m) {
+    if (m === 1n)
+        return 0n;
+    let result = 1n;
+    let base = x % m;
+    let exp = n;
+    while (exp > 0n) {
+        if (exp % 2n === 1n)
+            result = (result * base) % m;
+        exp /= 2n;
+        base = (base * base) % m;
+    }
+    return result;
+}
+/** Modular inverse via the extended Euclidean algorithm. Throws if none exists. */
+export function modInverse(a, m) {
+    const aa = mod(a, m);
+    if (aa === 0n)
+        throw new Error('Modular inverse does not exist');
+    let [oldR, r] = [aa, m];
+    let [oldS, s] = [1n, 0n];
+    while (r !== 0n) {
+        const q = oldR / r;
+        [oldR, r] = [r, oldR - q * r];
+        [oldS, s] = [s, oldS - q * s];
+    }
+    if (oldR !== 1n)
+        throw new Error('Modular inverse does not exist');
+    return mod(oldS, m);
+}
+export function bytesToHex(bytes) {
+    let out = '';
+    for (const b of bytes)
+        out += b.toString(16).padStart(2, '0');
+    return out;
+}
+/** Minimal big-endian byte representation of a non-negative bigint. */
+export function bigIntToBytesBE(value) {
+    let hex = value.toString(16);
+    if (hex.length % 2)
+        hex = '0' + hex;
+    const len = hex.length / 2;
+    const out = new Uint8Array(len);
+    for (let i = 0; i < len; i++) {
+        out[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return out;
+}
+/** 32-byte big-endian hex string (left-padded). */
+export function toPaddedHexBE(value) {
+    const bytes = bigIntToBytesBE(value);
+    if (bytes.length > 32)
+        throw new Error('Private key is longer than 32 bytes');
+    const padded = new Uint8Array(32);
+    padded.set(bytes, 32 - bytes.length);
+    return bytesToHex(padded);
+}
+/**
+ * Reverse the minimal big-endian bytes of `value` into a 32-byte buffer,
+ * right-aligned (zero-padded at the front). This matches @portal-hq/eject-js's
+ * ed25519 output exactly — including its treatment of scalars with leading
+ * zero bytes — so reconstructed keys are byte-identical to the reference.
+ * Note: this is NOT a plain left-aligned little-endian encoding.
+ */
+export function toLittleEndian32(value) {
+    const bytes = bigIntToBytesBE(value);
+    if (bytes.length > 32)
+        throw new Error('Private key is longer than 32 bytes');
+    const reversed = new Uint8Array(32);
+    for (let i = 0; i < bytes.length; i++) {
+        reversed[32 - 1 - i] = bytes[i];
+    }
+    return reversed;
+}
+//# sourceMappingURL=curves.js.map

package/dist/eject/curves.js.map

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

package/dist/eject/index.d.ts

@@ -0,0 +1,4 @@
+export { reconstructPrivateKey } from './reconstruct.js';
+export type { ReconstructPrivateKeyParams } from './reconstruct.js';
+export type { ShareInput } from './shares.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/eject/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/eject/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/eject/index.js

@@ -0,0 +1,2 @@
+export { reconstructPrivateKey } from './reconstruct.js';
+//# sourceMappingURL=index.js.map

package/dist/eject/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/eject/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/eject/matrix.d.ts

@@ -0,0 +1,17 @@
+/** Dense matrix over the integers mod `fieldOrder`. Ported from @portal-hq/eject-js. */
+export declare class Matrix {
+    readonly fieldOrder: bigint;
+    data: bigint[][];
+    rows: number;
+    cols: number;
+    constructor(fieldOrder: bigint, data: bigint[][]);
+    Copy(): Matrix;
+    Transpose(): Matrix;
+    multiply(other: Matrix): Matrix;
+    Inverse(): Matrix;
+    modulus(): Matrix;
+    GetRow(index: number): bigint[];
+    /** (MᵀM)⁻¹Mᵀ — left pseudoinverse, reduced mod field order. */
+    Pseudoinverse(): Matrix;
+}
+//# sourceMappingURL=matrix.d.ts.map

package/dist/eject/matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/eject/matrix.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,qBAAa,MAAM;IACjB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;gBAED,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAOhD,IAAI,IAAI,MAAM;IAOd,SAAS,IAAI,MAAM;IAcnB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAmB/B,OAAO,IAAI,MAAM;IAyCjB,OAAO,IAAI,MAAM;IASjB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAK/B,+DAA+D;IAC/D,aAAa,IAAI,MAAM;CASxB"}

package/dist/eject/matrix.js

@@ -0,0 +1,110 @@
+import { mod, modInverse } from './curves.js';
+/** Dense matrix over the integers mod `fieldOrder`. Ported from @portal-hq/eject-js. */
+export class Matrix {
+    fieldOrder;
+    data;
+    rows;
+    cols;
+    constructor(fieldOrder, data) {
+        this.fieldOrder = fieldOrder;
+        this.data = data;
+        this.rows = data.length;
+        this.cols = data[0]?.length ?? 0;
+    }
+    Copy() {
+        return new Matrix(this.fieldOrder, this.data.map((row) => [...row]));
+    }
+    Transpose() {
+        const newData = Array.from({ length: this.cols }, () => Array.from({ length: this.rows }, () => 0n));
+        for (let i = 0; i < this.rows; i++) {
+            for (let j = 0; j < this.cols; j++) {
+                newData[j][i] = this.data[i][j];
+            }
+        }
+        this.data = newData;
+        [this.rows, this.cols] = [this.cols, this.rows];
+        return this;
+    }
+    multiply(other) {
+        if (this.cols !== other.rows) {
+            throw new Error("Matrix dimensions don't match for multiplication");
+        }
+        const result = Array.from({ length: this.rows }, () => Array.from({ length: other.cols }, () => 0n));
+        for (let i = 0; i < this.rows; i++) {
+            for (let j = 0; j < other.cols; j++) {
+                let acc = 0n;
+                for (let k = 0; k < this.cols; k++) {
+                    acc = (acc + this.data[i][k] * other.data[k][j]) % this.fieldOrder;
+                }
+                result[i][j] = acc;
+            }
+        }
+        return new Matrix(this.fieldOrder, result);
+    }
+    Inverse() {
+        if (this.rows !== this.cols)
+            throw new Error('Only square matrices can be inverted');
+        const n = this.rows;
+        const aug = Array.from({ length: n }, () => Array.from({ length: 2 * n }, () => 0n));
+        for (let i = 0; i < n; i++) {
+            for (let j = 0; j < n; j++)
+                aug[i][j] = this.data[i][j];
+            aug[i][i + n] = 1n;
+        }
+        for (let i = 0; i < n; i++) {
+            let pivotRow = i;
+            for (let j = i + 1; j < n; j++) {
+                if (aug[j][i] !== 0n) {
+                    pivotRow = j;
+                    break;
+                }
+            }
+            if (aug[pivotRow][i] === 0n)
+                throw new Error('Matrix is singular and cannot be inverted');
+            if (pivotRow !== i)
+                [aug[i], aug[pivotRow]] = [aug[pivotRow], aug[i]];
+            const pivotInv = modInverse(aug[i][i], this.fieldOrder);
+            for (let j = 0; j < 2 * n; j++) {
+                aug[i][j] = (aug[i][j] * pivotInv) % this.fieldOrder;
+            }
+            for (let j = 0; j < n; j++) {
+                if (j === i)
+                    continue;
+                const factor = aug[j][i];
+                for (let k = 0; k < 2 * n; k++) {
+                    aug[j][k] = mod(aug[j][k] - factor * aug[i][k], this.fieldOrder);
+                }
+            }
+        }
+        const inverse = Array.from({ length: n }, () => Array.from({ length: n }, () => 0n));
+        for (let i = 0; i < n; i++) {
+            for (let j = 0; j < n; j++)
+                inverse[i][j] = aug[i][j + n];
+        }
+        return new Matrix(this.fieldOrder, inverse);
+    }
+    modulus() {
+        for (let i = 0; i < this.rows; i++) {
+            for (let j = 0; j < this.cols; j++) {
+                this.data[i][j] = mod(this.data[i][j], this.fieldOrder);
+            }
+        }
+        return this;
+    }
+    GetRow(index) {
+        if (index < 0 || index >= this.rows)
+            throw new Error('Row index out of bounds');
+        return [...this.data[index]];
+    }
+    /** (MᵀM)⁻¹Mᵀ — left pseudoinverse, reduced mod field order. */
+    Pseudoinverse() {
+        const copy = this.Copy();
+        const copyTranspose = this.Copy().Transpose();
+        const symmetric = copyTranspose.multiply(copy);
+        const inverseSymmetric = symmetric.Inverse();
+        const result = inverseSymmetric.multiply(copyTranspose);
+        result.modulus();
+        return result;
+    }
+}
+//# sourceMappingURL=matrix.js.map

package/dist/eject/matrix.js.map

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

package/dist/eject/reconstruct.d.ts

@@ -0,0 +1,16 @@
+import { type Curve } from './curves.js';
+import { type ShareInput } from './shares.js';
+export interface ReconstructPrivateKeyParams {
+    curve: Curve;
+    /** Decrypted client backup share (plaintext of encryptedClientBackupShare). */
+    clientShare: ShareInput;
+    /** Custodian backup share, as returned by getEjectableBackupShares. */
+    custodianShare: ShareInput;
+}
+/**
+ * Reconstruct a wallet's full private key from its two ejectable backup shares.
+ * Returns 64-char big-endian hex for SECP256K1, Base58 for ED25519. Throws on
+ * malformed shares or a public-key mismatch.
+ */
+export declare function reconstructPrivateKey(params: ReconstructPrivateKeyParams): Promise<string>;
+//# sourceMappingURL=reconstruct.d.ts.map

package/dist/eject/reconstruct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconstruct.d.ts","sourceRoot":"","sources":["../../src/eject/reconstruct.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,KAAK,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAML,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,KAAK,CAAC;IACb,+EAA+E;IAC/E,WAAW,EAAE,UAAU,CAAC;IACxB,uEAAuE;IACvE,cAAc,EAAE,UAAU,CAAC;CAC5B;AA+BD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAehG"}

package/dist/eject/reconstruct.js

@@ -0,0 +1,48 @@
+import { secp256k1 } from '@noble/curves/secp256k1';
+import { ed25519 } from '@noble/curves/ed25519';
+import { base58 } from '@scure/base';
+import { computeBkCoefficient } from './birkhoff.js';
+import { FIELD_ORDER, mod, toLittleEndian32, toPaddedHexBE, } from './curves.js';
+import { setupPeers, validateClientShare, validateCustodianShare, } from './shares.js';
+const THRESHOLD = 2;
+/** secret · G, in affine coordinates, for the chosen curve. */
+function derivePublicKeyPoint(curve, secret) {
+    const point = curve === 'SECP256K1'
+        ? secp256k1.Point.BASE.multiply(secret)
+        : ed25519.Point.BASE.multiply(secret);
+    const { x, y } = point.toAffine();
+    return { x, y };
+}
+/** Combine peers into the secret scalar and verify it against the expected pubkey. */
+function recoverScalar(curve, expectedPubkey, peers) {
+    const fieldOrder = FIELD_ORDER[curve];
+    const coefs = computeBkCoefficient(peers.map((p) => p.bk), THRESHOLD, fieldOrder);
+    let secret = 0n;
+    for (let i = 0; i < coefs.length; i++) {
+        secret = mod(secret + coefs[i] * peers[i].share, fieldOrder);
+    }
+    const derived = derivePublicKeyPoint(curve, secret);
+    if (derived.x !== expectedPubkey.x || derived.y !== expectedPubkey.y) {
+        throw new Error('Derived public key does not match expected public key');
+    }
+    return secret;
+}
+/**
+ * Reconstruct a wallet's full private key from its two ejectable backup shares.
+ * Returns 64-char big-endian hex for SECP256K1, Base58 for ED25519. Throws on
+ * malformed shares or a public-key mismatch.
+ */
+export async function reconstructPrivateKey(params) {
+    const { curve } = params;
+    if (curve !== 'SECP256K1' && curve !== 'ED25519') {
+        throw new Error(`Unsupported curve: ${String(curve)}`);
+    }
+    const client = validateClientShare(params.clientShare);
+    const custodian = validateCustodianShare(params.custodianShare);
+    const peers = setupPeers({ share: client.share, serverBkX: client.serverBkX }, { share: custodian.share, clientBkX: custodian.clientBkX });
+    const secret = recoverScalar(curve, client.pubkey, peers);
+    if (curve === 'SECP256K1')
+        return toPaddedHexBE(secret);
+    return base58.encode(toLittleEndian32(secret));
+}
+//# sourceMappingURL=reconstruct.js.map

package/dist/eject/reconstruct.js.map

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

package/dist/eject/shares.d.ts

@@ -0,0 +1,34 @@
+import type { Bk } from './birkhoff.js';
+export type ShareInput = string | object | Uint8Array;
+export interface PublicKeyCoords {
+    x: bigint;
+    y: bigint;
+}
+export interface Peer {
+    share: bigint;
+    bk: Bk;
+}
+/** Normalize a string | Uint8Array | object DKG result into a plain record. */
+export declare function parseShareInput(input: ShareInput): Record<string, unknown>;
+export declare function validateClientShare(input: ShareInput): {
+    pubkey: PublicKeyCoords;
+    share: string;
+    serverBkX: string;
+};
+export declare function validateCustodianShare(input: ShareInput): {
+    share: string;
+    clientBkX: string;
+};
+/**
+ * Build the two peers for recovery. Mirrors the reference cross-wiring:
+ * the client peer's Birkhoff x comes from the custodian share's clientBk, and
+ * the server peer's Birkhoff x comes from the client share's bks.server.x.
+ */
+export declare function setupPeers(client: {
+    share: string;
+    serverBkX: string;
+}, custodian: {
+    share: string;
+    clientBkX: string;
+}): [Peer, Peer];
+//# sourceMappingURL=shares.d.ts.map

package/dist/eject/shares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shares.d.ts","sourceRoot":"","sources":["../../src/eject/shares.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,EAAE,CAAC;CACR;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO1E;AAcD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG;IACtD,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAkBA;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAS9F;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC5C,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC9C,CAAC,IAAI,EAAE,IAAI,CAAC,CAUd"}

package/dist/eject/shares.js

@@ -0,0 +1,67 @@
+/** Normalize a string | Uint8Array | object DKG result into a plain record. */
+export function parseShareInput(input) {
+    if (typeof input === 'string')
+        return JSON.parse(input);
+    if (input instanceof Uint8Array) {
+        return JSON.parse(new TextDecoder().decode(input));
+    }
+    if (typeof input === 'object' && input !== null)
+        return { ...input };
+    throw new Error('Invalid share format');
+}
+/** Read a property by lower- or upper-cased first letter (DKG results vary in case). */
+function pick(obj, lower, upper) {
+    return obj[lower] !== undefined ? obj[lower] : obj[upper];
+}
+function asRecord(value, context) {
+    if (typeof value !== 'object' || value === null) {
+        throw new Error(`Inputted share does not include necessary fields (${context})`);
+    }
+    return value;
+}
+export function validateClientShare(input) {
+    const share = parseShareInput(input);
+    const pubkeyRaw = pick(share, 'pubkey', 'Pubkey');
+    const bksRaw = pick(share, 'bks', 'Bks');
+    if (pubkeyRaw === undefined || share['share'] === undefined || bksRaw === undefined) {
+        throw new Error('Inputted share does not include necessary fields');
+    }
+    const pubkeyObj = asRecord(pubkeyRaw, 'pubkey');
+    const bksObj = asRecord(bksRaw, 'bks');
+    const serverBk = asRecord(pick(bksObj, 'server', 'Server'), 'bks.server');
+    return {
+        pubkey: {
+            x: BigInt(String(pick(pubkeyObj, 'x', 'X'))),
+            y: BigInt(String(pick(pubkeyObj, 'y', 'Y'))),
+        },
+        share: String(share['share']),
+        serverBkX: String(pick(serverBk, 'x', 'X')),
+    };
+}
+export function validateCustodianShare(input) {
+    const backup = parseShareInput(input);
+    if (backup['share'] === undefined || backup['clientBk'] === undefined) {
+        throw new Error('Custodian share does not include necessary fields');
+    }
+    return {
+        share: String(backup['share']),
+        clientBkX: String(backup['clientBk']),
+    };
+}
+/**
+ * Build the two peers for recovery. Mirrors the reference cross-wiring:
+ * the client peer's Birkhoff x comes from the custodian share's clientBk, and
+ * the server peer's Birkhoff x comes from the client share's bks.server.x.
+ */
+export function setupPeers(client, custodian) {
+    const clientPeer = {
+        share: BigInt(client.share),
+        bk: { x: BigInt(custodian.clientBkX), rank: 0 },
+    };
+    const serverPeer = {
+        share: BigInt(custodian.share),
+        bk: { x: BigInt(client.serverBkX), rank: 0 },
+    };
+    return [clientPeer, serverPeer];
+}
+//# sourceMappingURL=shares.js.map

package/dist/eject/shares.js.map

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

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { CustodianApi, custodianOperations } from './portal/custodian.js';
 export { clientOperations } from './portal/client-api.js';
 export { enclaveOperations } from './portal/enclave-api.js';
 export { WalletsClient } from './portal/wallets-client.js';
+export { reconstructPrivateKey } from './eject/index.js';
 export { TatumWalletsSdk } from './sdk.js';
 export { WalletsApiClient } from './tatum/api-client.js';
 export type { WalletChainConfig } from './chains.js';
@@ -11,7 +12,8 @@ export type { CustodianOperation, CustodianRequestOptions } from './portal/custo
 export type { ClientOperation } from './portal/client-api.js';
 export type { EnclaveOperation } from './portal/enclave-api.js';
 export type { InitClientConfig, WalletsClientRequestOptions } from './portal/wallets-client.js';
+export type { ReconstructPrivateKeyParams, ShareInput } from './eject/index.js';
 export type { PathParamValue } from './path.js';
 export type { ApiErrorOptions, ApiRequestOptions, HttpMethod, QueryParams, QueryValue, WalletsSDKConfig } from './types.js';
-export type { BackupShareCipherTextResponse, BackupSharePair, BackupWalletBody, BackupWalletResponse, BitcoinTransactionResult, BuildTransactionBody, BuildTransactionResponse, ClientDetails, ClientEjectableBackupSharesQuery, ClientEjectableBackupSharesResponse, CreateClientBody, CreateClientResponse, CreateClientSessionBody, CreateClientSessionResponse, Curve, CurveShares, Eip155TransactionResult, EjectableBackupShares, EjectableBackupSharesBackupMethod, EnableEjectBody, EnableEjectResponse, EvaluateTransactionBody, EvaluateTransactionInput, EvaluateTransactionOperationType, EvaluateTransactionQuery, EvaluateTransactionResponse, EvaluateTransactionToken, GenerateWalletResponse, ListClientsQuery, ListClientsResponse, PortalRequestOptions, RawSignBody, RawSignResponse, RecoverWalletBody, RecoverWalletResponse, SendAssetsBody, SendAssetsResponse, SignBody, SignResponse, SigningSharePair, StoreBackupShareBody, SolanaTransactionResult, StellarTransactionResult, TransactionBalanceChange, TransactionEvaluation, TronTransactionResult, UpdateBackupSharePairsBody, UpdateSigningSharePairsBody, Wallet, WalletShare } from './portal/types/index.js';
+export type { BackupShareCipherTextResponse, BackupSharePair, BackupWalletBody, BackupWalletResponse, BitcoinTransactionResult, BuildTransactionBody, BuildTransactionResponse, ClientDetails, ClientEjectableBackupSharesQuery, ClientEjectableBackupSharesResponse, CreateClientBody, CreateClientResponse, CreateClientSessionBody, CreateClientSessionResponse, Curve, CurveShares, Eip155TransactionResult, EjectableBackupShares, EjectableBackupSharesBackupMethod, EnableEjectBody, EnableEjectResponse, EvaluateTransactionBody, EvaluateTransactionEvmBody, EvaluateTransactionOperationType, EvaluateTransactionQuery, EvaluateTransactionResponse, EvaluateTransactionSimulation, EvaluateTransactionSolanaBody, EvaluateTransactionValidation, GenerateWalletResponse, ListClientsQuery, ListClientsResponse, PortalRequestOptions, RawSignBody, RawSignResponse, RecoverWalletBody, RecoverWalletResponse, SendAssetsBody, SendAssetsResponse, SignBody, SignResponse, SigningSharePair, StoreBackupShareBody, SolanaTransactionResult, StellarTransactionResult, TronTransactionResult, UpdateBackupSharePairsBody, UpdateSigningSharePairsBody, Wallet, WalletShare } from './portal/types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACzF,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAChG,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,6BAA6B,EAC7B,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,aAAa,EACb,gCAAgC,EAChC,mCAAmC,EACnC,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,KAAK,EACL,WAAW,EACX,uBAAuB,EACvB,qBAAqB,EACrB,iCAAiC,EACjC,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,gCAAgC,EAChC,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,MAAM,EACN,WAAW,EACZ,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACzF,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAChG,YAAY,EAAE,2BAA2B,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChF,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,6BAA6B,EAC7B,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,aAAa,EACb,gCAAgC,EAChC,mCAAmC,EACnC,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,KAAK,EACL,WAAW,EACX,uBAAuB,EACvB,qBAAqB,EACrB,iCAAiC,EACjC,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,gCAAgC,EAChC,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,EAC7B,6BAA6B,EAC7B,6BAA6B,EAC7B,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,MAAM,EACN,WAAW,EACZ,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -4,6 +4,7 @@ export { CustodianApi, custodianOperations } from './portal/custodian.js';
 export { clientOperations } from './portal/client-api.js';
 export { enclaveOperations } from './portal/enclave-api.js';
 export { WalletsClient } from './portal/wallets-client.js';
+export { reconstructPrivateKey } from './eject/index.js';
 export { TatumWalletsSdk } from './sdk.js';
 export { WalletsApiClient } from './tatum/api-client.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/portal/types/client.d.ts

@@ -1,47 +1,56 @@
 import type { WalletChain } from '../../chains.js';
 import type { EjectableBackupShares } from './shared.js';
-export interface EvaluateTransactionToken {
-    address: string;
-    decimals: number;
-    symbol: string;
-}
-export interface EvaluateTransactionInput {
-    toAddress: string;
-    /** Native amount in base units (wei for EVM, lamports for Solana). */
-    value: string;
-    /** Calldata for contract interactions. */
+export type EvaluateTransactionOperationType = 'validation' | 'simulation' | 'all';
+/** EVM (EIP-155) transaction fields. Mirrors the JSON-RPC tx object. */
+export interface EvaluateTransactionEvmBody {
+    /** Target contract or recipient address. */
+    to: string;
+    /** Encoded calldata (hex). */
     data?: string;
-    /** Present when interacting with a token rather than the native asset. */
-    token?: EvaluateTransactionToken;
+    /** Native value in wei (hex). */
+    value?: string;
+    gas?: string;
+    gasPrice?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+    operationType?: EvaluateTransactionOperationType;
 }
-export type EvaluateTransactionOperationType = 'validation' | 'simulation' | 'all';
-export interface EvaluateTransactionBody {
-    /** Network name, e.g. 'ethereum', 'solana'. */
-    network: string;
-    transaction: EvaluateTransactionInput;
-    /** Defaults to 'all' server-side. */
+/** Solana transaction(s) to evaluate. */
+export interface EvaluateTransactionSolanaBody {
+    /** Base58-encoded Solana transactions. */
+    transactions: string[];
     operationType?: EvaluateTransactionOperationType;
 }
+/** oneOf: EVM tx fields or a Solana `transactions` array, selected by `chainId`. */
+export type EvaluateTransactionBody = EvaluateTransactionEvmBody | EvaluateTransactionSolanaBody;
 export type EvaluateTransactionQuery = {
+    /** CAIP-2 chain id, e.g. `eip155:1`. */
     chainId: WalletChain;
 };
-export interface TransactionBalanceChange {
-    token?: EvaluateTransactionToken;
-    amount?: string;
-    type?: 'IN' | 'OUT';
-}
-export interface TransactionEvaluation {
-    balanceChanges?: TransactionBalanceChange[];
-    riskScore?: number;
+/** Static validation result (present when `operationType` includes validation). */
+export interface EvaluateTransactionValidation {
+    status?: string;
+    resultType?: string;
+    description?: string;
+    reason?: string;
     classification?: string;
+    features?: unknown[];
+}
+/** Simulation result (present when `operationType` includes simulation). */
+export interface EvaluateTransactionSimulation {
+    status?: string;
+    assetsDiffs?: unknown[];
+    totalUsdDiff?: unknown;
+    exposures?: unknown[];
+    totalUsdExposure?: unknown;
+    addressDetails?: unknown;
+    accountSummary?: unknown;
 }
-/** Shape varies by chain; EVM returns `evaluation`, Bitcoin returns `unsignedTx`. */
 export interface EvaluateTransactionResponse {
-    evaluation?: TransactionEvaluation;
-    unsignedTx?: {
-        data?: string;
-        recentBlockhash?: string;
-    };
+    /** CAIP-2 chain id the evaluation ran against. */
+    chain: string;
+    validation?: EvaluateTransactionValidation;
+    simulation?: EvaluateTransactionSimulation;
 }
 export interface UpdateSigningSharePairsBody {
     signingSharePairIds: string[];

package/dist/portal/types/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/portal/types/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC;AACD,MAAM,MAAM,gCAAgC,GAAG,YAAY,GAAG,YAAY,GAAG,KAAK,CAAC;AACnF,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,wBAAwB,CAAC;IACtC,qCAAqC;IACrC,aAAa,CAAC,EAAE,gCAAgC,CAAC;CAClD;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC;AACF,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,wBAAwB,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;CACrB;AACD,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AACD,qFAAqF;AACrF,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAGD,MAAM,WAAW,2BAA2B;IAC1C,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,eAAe,CAAC;CACzB;AACD,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,4BAA4B,GAAG,gCAAgC,CAAC;CACzE;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,+DAA+D;AAC/D,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,iCAAiC,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7F,MAAM,MAAM,gCAAgC,GAAG;IAC7C,YAAY,EAAE,iCAAiC,CAAC;CACjD,CAAC;AACF,MAAM,WAAW,mCAAmC;IAClD,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/portal/types/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIzD,MAAM,MAAM,gCAAgC,GAAG,YAAY,GAAG,YAAY,GAAG,KAAK,CAAC;AAEnF,wEAAwE;AACxE,MAAM,WAAW,0BAA0B;IACzC,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,CAAC,EAAE,gCAAgC,CAAC;CAClD;AAED,yCAAyC;AACzC,MAAM,WAAW,6BAA6B;IAC5C,0CAA0C;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,gCAAgC,CAAC;CAClD;AAED,oFAAoF;AACpF,MAAM,MAAM,uBAAuB,GAAG,0BAA0B,GAAG,6BAA6B,CAAC;AAGjG,MAAM,MAAM,wBAAwB,GAAG;IACrC,wCAAwC;IACxC,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,mFAAmF;AACnF,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAC3C,UAAU,CAAC,EAAE,6BAA6B,CAAC;CAC5C;AAGD,MAAM,WAAW,2BAA2B;IAC1C,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,eAAe,CAAC;CACzB;AACD,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,4BAA4B,GAAG,gCAAgC,CAAC;CACzE;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,+DAA+D;AAC/D,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,iCAAiC,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7F,MAAM,MAAM,gCAAgC,GAAG;IAC7C,YAAY,EAAE,iCAAiC,CAAC;CACjD,CAAC;AACF,MAAM,WAAW,mCAAmC;IAClD,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B"}

package/dist/portal/wallets-client.d.ts

@@ -1,3 +1,4 @@
+import type { ReconstructPrivateKeyParams } from '../eject/index.js';
 import type { ClientOperation } from './client-api.js';
 import type { EnclaveOperation } from './enclave-api.js';
 import type { Curve } from './types/index.js';
@@ -71,6 +72,13 @@ export declare class WalletsClient {
     completeEject<TResponse = void>(options: PortalRequestOptions<never, {
         walletId: string;
     }>): Promise<TResponse>;
+    /**
+     * Reconstruct this wallet's full private key from its ejectable backup shares.
+     * Pure and network-free: decrypt `encryptedClientBackupShare` yourself first,
+     * then pass it with the `custodianBackupShare` from {@link getEjectableBackupShares}.
+     * Returns hex (SECP256K1) or Base58 (ED25519).
+     */
+    reconstructPrivateKey(params: ReconstructPrivateKeyParams): Promise<string>;
     /**
      * Generate a new MPC wallet (Enclave API), producing one signing share per
      * curve (`SECP256K1` and `ED25519`). Returns the shares to store client-side.

package/dist/portal/wallets-client.d.ts.map

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

package/dist/portal/wallets-client.js

@@ -1,5 +1,6 @@
 import { ClientApi } from './client-api.js';
 import { EnclaveApi } from './enclave-api.js';
+import { reconstructPrivateKey } from '../eject/index.js';
 /**
  * Client-scoped Portal operations for a single Portal client.
  *
@@ -81,6 +82,15 @@ export class WalletsClient {
     completeEject(options) {
         return this.clientApi.completeEject(options);
     }
+    /**
+     * Reconstruct this wallet's full private key from its ejectable backup shares.
+     * Pure and network-free: decrypt `encryptedClientBackupShare` yourself first,
+     * then pass it with the `custodianBackupShare` from {@link getEjectableBackupShares}.
+     * Returns hex (SECP256K1) or Base58 (ED25519).
+     */
+    reconstructPrivateKey(params) {
+        return reconstructPrivateKey(params);
+    }
     // ── enclave MPC layer ──────────────────────────────────────────────
     /**
      * Generate a new MPC wallet (Enclave API), producing one signing share per

package/dist/portal/wallets-client.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tatumio/wallet-sdk",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "TypeScript SDK for Tatum-hosted MPC wallets — wallet generation, signing, sending, backup/recovery, and custodian/client management.",
   "license": "MIT",
   "author": "Tatum",
@@ -57,5 +57,9 @@
     "@types/node": "^22.15.29",
     "typescript": "^5.8.3",
     "vitest": "^3.1.4"
+  },
+  "dependencies": {
+    "@noble/curves": "^1.9.7",
+    "@scure/base": "^1.2.6"
   }
 }