@tatumio/wallet-sdk 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -99,11 +99,8 @@ Before signing, you can simulate/validate a transaction (balance changes, risk s
99
99
  ```ts
100
100
  const evaluation = await client.evaluateTransaction({
101
101
  query: { chainId: WalletChain.ETHEREUM_MAINNET },
102
- body: {
103
- network: "ethereum",
104
- transaction: { toAddress: "0x...", value: "10000000000000000" },
105
- },
106
- }); // typed as EvaluateTransactionResponse
102
+ body: { to: "0x...", value: "0x2386f26fc10000", operationType: "all" },
103
+ }); // typed as EvaluateTransactionResponse ({ chain, validation?, simulation? })
107
104
  ```
108
105
 
109
106
  ### Backup and recovery
package/dist/index.d.ts CHANGED
@@ -15,5 +15,5 @@ export type { InitClientConfig, WalletsClientRequestOptions } from './portal/wal
15
15
  export type { ReconstructPrivateKeyParams, ShareInput } from './eject/index.js';
16
16
  export type { PathParamValue } from './path.js';
17
17
  export type { ApiErrorOptions, ApiRequestOptions, HttpMethod, QueryParams, QueryValue, WalletsSDKConfig } from './types.js';
18
- 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';
18
+ 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';
19
19
  //# sourceMappingURL=index.d.ts.map
@@ -1 +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,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,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"}
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,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"}
@@ -1,47 +1,56 @@
1
1
  import type { WalletChain } from '../../chains.js';
2
2
  import type { EjectableBackupShares } from './shared.js';
3
- export interface EvaluateTransactionToken {
4
- address: string;
5
- decimals: number;
6
- symbol: string;
7
- }
8
- export interface EvaluateTransactionInput {
9
- toAddress: string;
10
- /** Native amount in base units (wei for EVM, lamports for Solana). */
11
- value: string;
12
- /** Calldata for contract interactions. */
3
+ export type EvaluateTransactionOperationType = 'validation' | 'simulation' | 'all';
4
+ /** EVM (EIP-155) transaction fields. Mirrors the JSON-RPC tx object. */
5
+ export interface EvaluateTransactionEvmBody {
6
+ /** Target contract or recipient address. */
7
+ to: string;
8
+ /** Encoded calldata (hex). */
13
9
  data?: string;
14
- /** Present when interacting with a token rather than the native asset. */
15
- token?: EvaluateTransactionToken;
10
+ /** Native value in wei (hex). */
11
+ value?: string;
12
+ gas?: string;
13
+ gasPrice?: string;
14
+ maxFeePerGas?: string;
15
+ maxPriorityFeePerGas?: string;
16
+ operationType?: EvaluateTransactionOperationType;
16
17
  }
17
- export type EvaluateTransactionOperationType = 'validation' | 'simulation' | 'all';
18
- export interface EvaluateTransactionBody {
19
- /** Network name, e.g. 'ethereum', 'solana'. */
20
- network: string;
21
- transaction: EvaluateTransactionInput;
22
- /** Defaults to 'all' server-side. */
18
+ /** Solana transaction(s) to evaluate. */
19
+ export interface EvaluateTransactionSolanaBody {
20
+ /** Base58-encoded Solana transactions. */
21
+ transactions: string[];
23
22
  operationType?: EvaluateTransactionOperationType;
24
23
  }
24
+ /** oneOf: EVM tx fields or a Solana `transactions` array, selected by `chainId`. */
25
+ export type EvaluateTransactionBody = EvaluateTransactionEvmBody | EvaluateTransactionSolanaBody;
25
26
  export type EvaluateTransactionQuery = {
27
+ /** CAIP-2 chain id, e.g. `eip155:1`. */
26
28
  chainId: WalletChain;
27
29
  };
28
- export interface TransactionBalanceChange {
29
- token?: EvaluateTransactionToken;
30
- amount?: string;
31
- type?: 'IN' | 'OUT';
32
- }
33
- export interface TransactionEvaluation {
34
- balanceChanges?: TransactionBalanceChange[];
35
- riskScore?: number;
30
+ /** Static validation result (present when `operationType` includes validation). */
31
+ export interface EvaluateTransactionValidation {
32
+ status?: string;
33
+ resultType?: string;
34
+ description?: string;
35
+ reason?: string;
36
36
  classification?: string;
37
+ features?: unknown[];
38
+ }
39
+ /** Simulation result (present when `operationType` includes simulation). */
40
+ export interface EvaluateTransactionSimulation {
41
+ status?: string;
42
+ assetsDiffs?: unknown[];
43
+ totalUsdDiff?: unknown;
44
+ exposures?: unknown[];
45
+ totalUsdExposure?: unknown;
46
+ addressDetails?: unknown;
47
+ accountSummary?: unknown;
37
48
  }
38
- /** Shape varies by chain; EVM returns `evaluation`, Bitcoin returns `unsignedTx`. */
39
49
  export interface EvaluateTransactionResponse {
40
- evaluation?: TransactionEvaluation;
41
- unsignedTx?: {
42
- data?: string;
43
- recentBlockhash?: string;
44
- };
50
+ /** CAIP-2 chain id the evaluation ran against. */
51
+ chain: string;
52
+ validation?: EvaluateTransactionValidation;
53
+ simulation?: EvaluateTransactionSimulation;
45
54
  }
46
55
  export interface UpdateSigningSharePairsBody {
47
56
  signingSharePairIds: string[];
@@ -1 +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"}
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;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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tatumio/wallet-sdk",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "TypeScript SDK for Tatum-hosted MPC wallets — wallet generation, signing, sending, backup/recovery, and custodian/client management.",
5
5
  "license": "MIT",
6
6
  "author": "Tatum",