wative-core 2.5.1 → 2.5.3

package/dist/{workspace-DqUdScht.d.ts → workspace-CZO-ANYP.d.ts}

@@ -27,16 +27,42 @@ interface AssetBalance {
     readonly decimals: number;
     readonly displayStatus: boolean;
     readonly fetchedAt: number;
+    
+    readonly readError?: string;
 }
 interface AssetCollection extends ReadonlyArray<Asset> {
     byId(id: AssetId): Asset | null;
 }
 
+interface NetworkRoutes {
+    
+    staked?: {
+        endpoints: readonly string[];
+    };
+    
+    jito?: {
+        blockEngineUrl: string;
+        tipAccount?: string;
+    };
+    
+    mev?: {
+        relayUrl: string;
+    };
+}
 interface NetworkInit {
     slug: Slug;
     name: string;
     chainId: ChainId;
+    
     rpcUrl: string;
+    
+    endpoints?: readonly string[];
+    
+    readEndpoints?: readonly string[];
+    
+    writeEndpoints?: readonly string[];
+    
+    routes?: NetworkRoutes;
     nativeCurrency: {
         name: string;
         symbol: string;
@@ -51,6 +77,10 @@ declare class Network {
     readonly name: string;
     readonly chainId: ChainId;
     readonly rpcUrl: string;
+    readonly endpoints?: readonly string[];
+    readonly readEndpoints?: readonly string[];
+    readonly writeEndpoints?: readonly string[];
+    readonly routes?: NetworkRoutes;
     readonly nativeCurrency: {
         name: string;
         symbol: string;
@@ -60,6 +90,8 @@ declare class Network {
     readonly color?: string;
     readonly vm: VmToken;
     
+    endpointsFor(kind?: "read" | "write" | "default"): readonly string[];
+    
     get symbol(): string;
     
     readonly assets: readonly Asset[];
@@ -181,7 +213,113 @@ declare abstract class Provider {
     abstract close(): Promise<void>;
 }
 
-type WativeErrorCode = "WORKSPACE_LOCKED" | "ACCOUNT_LOCKED" | "RECORD_LOCKED" | "BAD_PASSWORD" | "WEAK_PASSWORD" | "RECORD_NOT_FOUND" | "PROVIDER_IO" | "PERMISSION_DENIED" | "DISK_FULL" | "PARAMETER_ERROR" | "DECRYPT_FAILED" | "ENCRYPT_FAILED" | "ALGORITHM_IRREVERSIBLE" | "INVALID_MNEMONIC" | "INVALID_PRIVATE_KEY" | "UNSUPPORTED_NETWORK" | "TX_BUILD_FAILED" | "TX_SIGN_FAILED" | "TX_SUBMIT_FAILED" | "TX_TIMEOUT" | "TX_DROPPED" | "TX_ABORTED" | "RPC_UNREACHABLE"
+interface RawTx {
+    readonly vm: VmToken;
+    
+    readonly serialized: string;
+    
+    readonly encoding: "hex" | "base64";
+}
+
+interface DecodedTx {
+    readonly vm: VmToken;
+    readonly to?: string | null;
+    readonly value?: bigint;
+    readonly data?: string;
+    readonly chainId?: number;
+    readonly evmType?: number;
+    readonly nonce?: number;
+    readonly gasLimit?: bigint;
+    readonly gasPrice?: bigint;
+    readonly maxFeePerGas?: bigint;
+    readonly maxPriorityFeePerGas?: bigint;
+    
+    readonly from?: string | null;
+    readonly svmVersion?: "legacy" | 0;
+    readonly feePayer?: string;
+    readonly recentBlockhash?: string;
+    readonly instructionCount?: number;
+    readonly hasAddressLookupTables?: boolean;
+    
+    readonly requiredSigners?: readonly string[];
+    
+    readonly programIds?: readonly string[];
+    readonly signatureCount?: number;
+    readonly signed?: boolean;
+}
+
+declare function isRawTx(x: unknown): x is RawTx;
+
+declare function deserializeEvmTx(serialized: string): {
+    raw: RawTx;
+    decoded: DecodedTx;
+};
+
+declare function deserializeSvmTx(serialized: string): {
+    raw: RawTx;
+    decoded: DecodedTx;
+};
+
+declare function deserializeTx(vm: VmToken, serialized: string): {
+    raw: RawTx;
+    decoded: DecodedTx;
+};
+
+type NormalizedTx<P> = {
+    kind: "params";
+    params: P;
+} | {
+    kind: "raw";
+    raw: RawTx;
+    decoded: DecodedTx;
+};
+
+declare function normalizeTxInput<P extends object>(vm: VmToken, input: P | RawTx | string): NormalizedTx<P>;
+
+type DestinationCode = "EVM_ZERO_ADDRESS" | "EVM_BURN_ADDRESS" | "EVM_PRECOMPILE" | "EVM_TOKEN_SELF_CONTRACT" | "EVM_ERC20_TO_CONTRACT" | "EVM_NATIVE_TO_CONTRACT" | "EVM_DELEGATED_EOA_7702" | "SVM_SOL_TO_OFFCURVE" | "SVM_INCINERATOR" | "SVM_SOL_TO_MINT" | "SVM_SOL_TO_PROGRAM_OR_SYSVAR" | "SVM_SOL_TO_TOKEN_ACCOUNT" | "SVM_SPL_TO_PROGRAM_OWNED" | "SVM_FROZEN_TOKEN_ACCOUNT" | "SVM_NON_TRANSFERABLE" | "RPC_CHECK_UNAVAILABLE" | "SCREENED";
+
+type DestinationSeverity = "refuse" | "confirm" | "warn";
+
+interface DestinationWarning {
+    readonly code: DestinationCode;
+    readonly chain: "evm" | "svm";
+    readonly address: string;
+    readonly asset: "native" | "token";
+    readonly detail: string;
+}
+
+interface DestinationReport {
+    readonly action: "allow" | "warn" | "confirm" | "refuse";
+    readonly code?: DestinationCode;
+    readonly severity?: DestinationSeverity;
+    readonly chain: "evm" | "svm";
+    readonly address: string;
+    readonly asset: "native" | "token";
+    readonly warnings: readonly DestinationWarning[];
+    readonly rpcChecked: boolean;
+}
+
+interface DestinationScreenResult {
+    readonly severity: "refuse" | "warn";
+    readonly detail: string;
+}
+
+type DestinationScreener = (input: {
+    readonly chain: "evm" | "svm";
+    readonly address: string;
+    readonly asset: "native" | "token";
+}) => DestinationScreenResult | null | Promise<DestinationScreenResult | null>;
+
+interface DestinationGuardOptions {
+    readonly forceUnsafeTransfer?: boolean;
+    readonly acknowledgeRiskyDestination?: boolean;
+    readonly onWarning?: (warning: DestinationWarning) => void;
+    readonly screen?: DestinationScreener;
+}
+
+type WativeErrorCode = "WORKSPACE_LOCKED" | "ACCOUNT_LOCKED" | "RECORD_LOCKED" | "BAD_PASSWORD" | "WEAK_PASSWORD" | "RECORD_NOT_FOUND" | "PROVIDER_IO" | "PERMISSION_DENIED" | "DISK_FULL" | "PARAMETER_ERROR"
+
+ | "IRREGULAR_DESTINATION" | "DECRYPT_FAILED" | "ENCRYPT_FAILED" | "ALGORITHM_IRREVERSIBLE" | "INVALID_MNEMONIC" | "INVALID_PRIVATE_KEY" | "UNSUPPORTED_NETWORK" | "TX_BUILD_FAILED" | "TX_SIGN_FAILED" | "TX_SUBMIT_FAILED" | "TX_TIMEOUT" | "TX_DROPPED" | "TX_ABORTED" | "RPC_UNREACHABLE"
 
  | "RPC_REJECTED" | "STORAGE_NOT_DURABLE" | "UNSUPPORTED_OP";
 interface WativeErrorOpts {
@@ -201,17 +339,24 @@ declare const EvmTxType: {
     readonly Legacy: 0;
     readonly AccessList: 1;
     readonly Eip1559: 2;
+    readonly Blob: 3;
+    readonly SetCode: 4;
 };
 type EvmTxType = typeof EvmTxType[keyof typeof EvmTxType];
 interface EvmTxBuildParams {
-    to: string;
+    
+    to: string | null;
     value?: bigint;
+    
     data?: string;
+    input?: string;
     nonce?: number;
     gasLimit?: bigint;
     gasPrice?: bigint;
     maxFeePerGas?: bigint;
     maxPriorityFeePerGas?: bigint;
+    
+    maxFeePerGasCeiling?: bigint;
     type?: EvmTxType;
     chainId?: ChainId;
     rpcUrl?: string;
@@ -220,6 +365,11 @@ interface EvmTxBuildParams {
         storageKeys: ReadonlyArray<string>;
     }>;
 }
+
+interface SvmAddressLookupTable {
+    readonly address: string;
+    readonly addresses: readonly string[];
+}
 interface SvmTxBuildParams {
     recipient: string;
     amount: bigint;
@@ -231,7 +381,10 @@ interface SvmTxBuildParams {
     feePayer?: string;
     rpcUrl?: string;
     instructions?: ReadonlyArray<unknown>;
-    addressLookupTables?: ReadonlyArray<string>;
+    
+    addressLookupTables?: ReadonlyArray<SvmAddressLookupTable>;
+    
+    version?: "legacy" | 0;
     memo?: string;
 }
 
@@ -264,7 +417,7 @@ interface Transaction {
     readonly vm: VmToken;
     readonly status: TransactionStatus;
     sign(): Promise<this> | this;
-    send(): TransactionTracker;
+    send(opts?: SendOptions): TransactionTracker;
     simulate(): Promise<SimulationResult>;
 }
 interface SimulationResult {
@@ -276,6 +429,29 @@ interface SimulationResult {
     readonly computeUnitsConsumed?: number;
     readonly raw: unknown;
 }
+
+type Commitment = "processed" | "confirmed" | "finalized";
+
+type SendRoute = "default" | "staked" | "jito" | "mev";
+
+interface SendOptions {
+    
+    readonly skipPreflight?: boolean;
+    
+    readonly preflightCommitment?: Commitment;
+    
+    readonly maxRetries?: number;
+    
+    readonly minContextSlot?: number;
+    
+    readonly commitment?: Commitment;
+    
+    readonly confirmations?: number;
+    
+    readonly timeout?: number;
+    
+    readonly route?: SendRoute;
+}
 interface TransactionStateChange {
     readonly previous: TransactionStatus;
     readonly next: TransactionStatus;
@@ -317,7 +493,7 @@ declare class EvmTransaction implements Transaction {
     #private;
     readonly vm: "evm";
     from: EvmAddress;
-    to: string;
+    to: string | null;
     value: bigint;
     data: string;
     chainId: ChainId;
@@ -339,15 +515,17 @@ declare class EvmTransaction implements Transaction {
     _address?: Address;
     constructor(init: {
         from: EvmAddress;
-        to: string;
+        to: string | null;
         value: bigint;
         chainId: ChainId;
         data?: string;
+        input?: string;
         type?: EvmTxType;
         nonce?: number;
         gasPrice?: bigint;
         maxFeePerGas?: bigint;
         maxPriorityFeePerGas?: bigint;
+        maxFeePerGasCeiling?: bigint;
         gasLimit?: bigint;
         rpcUrl?: string;
         accessList?: ReadonlyArray<{
@@ -356,13 +534,14 @@ declare class EvmTransaction implements Transaction {
         }>;
         address?: Address;
     });
-    constructor(from: EvmAddress, to: string, value: bigint, data: string | undefined, opts: {
+    constructor(from: EvmAddress, to: string | null, value: bigint, data: string | undefined, opts: {
         chainId: ChainId;
         type?: EvmTxType;
         nonce?: number;
         gasPrice?: bigint;
         maxFeePerGas?: bigint;
         maxPriorityFeePerGas?: bigint;
+        maxFeePerGasCeiling?: bigint;
         gasLimit?: bigint;
         rpcUrl?: string;
         accessList?: ReadonlyArray<{
@@ -373,7 +552,7 @@ declare class EvmTransaction implements Transaction {
     });
     get status(): TransactionStatus;
     sign(): Promise<this>;
-    send(): TransactionTracker;
+    send(opts?: SendOptions): TransactionTracker;
     
     simulate(): Promise<SimulationResult>;
     
@@ -385,7 +564,8 @@ declare class EvmTransaction implements Transaction {
 
 interface EvmRawTx {
     from: string;
-    to: string;
+    
+    to: string | null;
     value: bigint;
     data: string;
     type: EvmTxType;
@@ -418,7 +598,8 @@ declare class SvmTransaction implements Transaction {
     get rpcUrl(): string | undefined;
     set rpcUrl(next: string | undefined);
     instructions?: ReadonlyArray<unknown>;
-    addressLookupTables?: ReadonlyArray<string>;
+    addressLookupTables?: ReadonlyArray<SvmAddressLookupTable>;
+    version?: "legacy" | 0;
     memo?: string;
     
     _address?: Address;
@@ -434,7 +615,8 @@ declare class SvmTransaction implements Transaction {
         feePayer?: string;
         rpcUrl?: string;
         instructions?: ReadonlyArray<unknown>;
-        addressLookupTables?: ReadonlyArray<string>;
+        addressLookupTables?: ReadonlyArray<SvmAddressLookupTable>;
+        version?: "legacy" | 0;
         memo?: string;
         address?: Address;
     });
@@ -447,13 +629,14 @@ declare class SvmTransaction implements Transaction {
         feePayer?: string;
         rpcUrl?: string;
         instructions?: ReadonlyArray<unknown>;
-        addressLookupTables?: ReadonlyArray<string>;
+        addressLookupTables?: ReadonlyArray<SvmAddressLookupTable>;
+        version?: "legacy" | 0;
         memo?: string;
         address?: Address;
     });
     get status(): TransactionStatus;
     sign(): Promise<this>;
-    send(): TransactionTracker;
+    send(opts?: SendOptions): TransactionTracker;
     simulate(): Promise<SimulationResult>;
     get hash(): string | null;
     
@@ -468,6 +651,41 @@ interface AddressInit {
     assets?: Asset[];
     wallet: Wallet;
 }
+
+interface SignInParams {
+    domain?: string;
+    address?: string;
+    statement?: string;
+    uri?: string;
+    version?: string;
+    chainId?: string | number;
+    nonce?: string;
+    issuedAt?: string;
+    expirationTime?: string;
+    notBefore?: string;
+    requestId?: string;
+    resources?: readonly string[];
+    
+    scheme?: string;
+    
+    expectedDomain?: string;
+}
+
+interface SignInResult {
+    readonly message: string;
+    readonly signature: string;
+}
+
+interface SignRawOptions {
+    
+    confirm?: (decoded: DecodedTx) => boolean | Promise<boolean>;
+    
+    acknowledgeBlindSign?: boolean;
+    
+    allow7702Delegation?: boolean;
+    
+    allowBlobTx?: boolean;
+}
 declare class Address {
     #private;
     readonly publicKey: EvmAddress | SvmAddress | SuiAddress;
@@ -489,22 +707,46 @@ declare class Address {
         messageHash: string;
     };
     
+    signDigest(digest: Uint8Array | string): {
+        r: string;
+        s: string;
+        recovery: 0 | 1;
+        signature: string;
+    };
+    
+    signBytes(message: Uint8Array | string): {
+        signature: string;
+        signatureHex: string;
+    };
+    
     signTypedData(typedData: unknown, chainId: number | bigint): {
         signature: string;
         domainSeparator: string;
         structHash: string;
     };
     signMessage(message: string): string;
+    
+    signIn(params?: SignInParams): SignInResult;
     buildTransaction(params: EvmTxBuildParams): EvmTransaction;
     buildTransaction(params: SvmTxBuildParams): SvmTransaction;
     
-    buildTransferPayload(req: TransferRequest): TransferPayload;
+    buildTransferPayload(req: TransferRequest, opts?: DestinationGuardOptions): TransferPayload;
+    
+    checkDestination(req: TransferRequest, opts?: DestinationGuardOptions): Promise<DestinationReport>;
     
     signTransaction<T extends Transaction>(transaction: T): T;
     
-    sendTransaction(transaction: Transaction): TransactionTracker;
+    signAll<T extends Transaction>(transactions: readonly T[]): Promise<readonly T[]>;
+    
+    signRawTransaction(input: RawTx | string, opts?: SignRawOptions): Promise<RawTx>;
+    
+    sendTransaction(transaction: Transaction, opts?: SendOptions): TransactionTracker;
     
     simulateTransaction(transaction: Transaction): Promise<SimulationResult>;
+    
+    estimate(input: RawTx | string, opts?: {
+        rpcUrl?: string;
+    }): Promise<SimulationResult>;
     refreshBalances(displayedOnly?: boolean): Settling<readonly AssetBalance[]>;
     refreshBalances(network: NetworkLike, displayedOnly?: boolean): Settling<readonly AssetBalance[]>;
     refreshBalances(assetId: AssetId): Settling<AssetBalance>;
@@ -768,6 +1010,8 @@ declare class Workspace {
     get accounts(): AccountCollection;
     get networks(): NetworkCollection;
     
+    _noteRpcUrl(url: string): void;
+    
     _registerLiveAccount(account: Account): void;
     
     _releaseAccount(account: Account): void;
@@ -809,6 +1053,11 @@ declare class Workspace {
         id: number;
         symbol: string;
     } | null;
+    
+    _trackedAssetsForSlug(slug: string): ReadonlyArray<{
+        symbol: string;
+        contractAddress: string | null;
+    }>;
 }
 
-export { type WativeErrorCode as $, Account as A, type SimulationResult as B, type ChainId as C, type SinkConfig as D, type EvmAddress as E, type Slug as F, type SvmAddress as G, SvmSigner as H, SvmTransaction as I, type SvmTxBuildParams as J, type TransactionReceipt as K, type LogLevel as L, type TransactionStateChange as M, Network as N, type OpenOptions as O, Provider as P, type TransactionStatus as Q, Record$1 as R, type Settling as S, type Transaction as T, type TransactionTracker as U, type TransferPayload as V, type TransferRequest as W, type VmToken as X, Wallet as Y, type WalletCollection as Z, WativeError as _, type AccountCollection as a, type WativeErrorOpts as a0, Workspace as a1, type WorkspaceConfig as a2, newMnemonic as a3, type SuiAddress as a4, type AccountOrgType as b, Address as c, Asset as d, type AssetBalance as e, type AssetCollection as f, type AssetId as g, type AssetInitObject as h, type AssetRef as i, type ChainVM as j, ConsoleSink as k, type ContainerState as l, type EvmRawTx as m, EvmSigner as n, EvmTransaction as o, type EvmTxBuildParams as p, EvmTxType as q, type LogRecord as r, type LogSink as s, Logger as t, type LoggerConfig as u, type NetworkCollection as v, type NetworkInit as w, type NetworkLike as x, type RecordInit as y, type RecordType as z };
+export { type SinkConfig as $, Account as A, type LogSink as B, type ChainId as C, type DecodedTx as D, type EvmAddress as E, Logger as F, type LoggerConfig as G, type NetworkCollection as H, type NetworkInit as I, type NetworkLike as J, type NetworkRoutes as K, type LogLevel as L, type NormalizedTx as M, Network as N, type OpenOptions as O, Provider as P, Record$1 as Q, type RawTx as R, type RecordInit as S, type RecordType as T, type SendOptions as U, type SendRoute as V, type Settling as W, type SignInParams as X, type SignInResult as Y, type SignRawOptions as Z, type SimulationResult as _, type AccountCollection as a, type Slug as a0, type SvmAddress as a1, type SvmAddressLookupTable as a2, SvmSigner as a3, SvmTransaction as a4, type SvmTxBuildParams as a5, type Transaction as a6, type TransactionReceipt as a7, type TransactionStateChange as a8, type TransactionStatus as a9, type TransactionTracker as aa, type TransferPayload as ab, type TransferRequest as ac, type VmToken as ad, Wallet as ae, type WalletCollection as af, WativeError as ag, type WativeErrorCode as ah, type WativeErrorOpts as ai, Workspace as aj, type WorkspaceConfig as ak, deserializeEvmTx as al, deserializeSvmTx as am, deserializeTx as an, isRawTx as ao, newMnemonic as ap, normalizeTxInput as aq, type SuiAddress as ar, type AccountOrgType as b, Address as c, Asset as d, type AssetBalance as e, type AssetCollection as f, type AssetId as g, type AssetInitObject as h, type AssetRef as i, type ChainVM as j, type Commitment as k, ConsoleSink as l, type ContainerState as m, type DestinationCode as n, type DestinationGuardOptions as o, type DestinationReport as p, type DestinationScreenResult as q, type DestinationScreener as r, type DestinationSeverity as s, type DestinationWarning as t, type EvmRawTx as u, EvmSigner as v, EvmTransaction as w, type EvmTxBuildParams as x, EvmTxType as y, type LogRecord as z };

package/examples/14-esm-runtime.test.mjs

@@ -3,9 +3,6 @@ import { mkdtemp } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
 import test from "node:test";
-import { fileURLToPath } from "node:url";
-
-const here = path.dirname(fileURLToPath(import.meta.url));
 
 async function importDist() {
   return import("wative-core");

package/examples/17-locked-state.test.cjs

@@ -56,6 +56,7 @@ test("a locked account refuses every operation that needs key material", async (
   await refuses("ACCOUNT_LOCKED", "dumpPrivateKey", () => wallet.dumpPrivateKey("evm"));
   await refuses("ACCOUNT_LOCKED", "signMessage", () => address.signMessage("hello"));
   await refuses("ACCOUNT_LOCKED", "signTypedData", () => address.signTypedData(TYPED_DATA));
+  await refuses("ACCOUNT_LOCKED", "signDigest", () => address.signDigest("0x" + "ab".repeat(32)));
   await refuses("ACCOUNT_LOCKED", "deriveWallets", () => account.deriveWallets(1));
 
   await ws.unlock("wsp-pwd").catch(() => {});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wative-core",
-  "version": "2.5.1",
+  "version": "2.5.3",
   "description": "Hyperscale crypto wallet management library — multi-workspace, multi-chain, originally designed for on-chain market makers",
   "type": "module",
   "main": "./dist/index.node.cjs",