@ecency/wallets 1.5.55 → 2.0.1

package/dist/browser/index.d.ts

@@ -2,24 +2,11 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseMutationOptions } from '@tanstack/react-query';
 import { AuthContext, HiveEngineTokenMetadataResponse, AssetOperation } from '@ecency/sdk';
 export { Asset, AssetOperation, AuthorReward, CancelTransferFromSavings, ClaimRewardBalance, CollateralizedConvert, CommentBenefactor, CommentPayoutUpdate, CommentReward, CurationReward, DelegateVestingShares, DelegatedVestingShare, EffectiveCommentVote, FillCollateralizedConvertRequest, FillConvertRequest, FillOrder, FillRecurrentTransfers, FillVestingWithdraw, GeneralAssetInfo, GeneralAssetTransaction, HIVE_ACCOUNT_OPERATION_GROUPS, HIVE_OPERATION_LIST, HIVE_OPERATION_NAME_BY_ID, HIVE_OPERATION_ORDERS, HiveBasedAssetSignType, HiveEngineMarketResponse, HiveEngineMetric, HiveEngineOpenOrder, HiveEngineOrderBookEntry, HiveEngineToken, HiveEngineTokenBalance, HiveEngineTokenInfo, HiveEngineTokenMetadataResponse, HiveEngineTokenStatus, HiveEngineTransaction, HiveMarketMetric, HiveOperationFilter, HiveOperationFilterKey, HiveOperationFilterValue, HiveOperationGroup, HiveOperationName, HiveTransaction, WithdrawRoute as HiveWithdrawRoute, Interest, LimitOrderCancel, LimitOrderCreate, NaiMap, PointTransaction, PointTransactionType, Points, PointsResponse, ProducerReward, ProposalPay, ReceivedVestingShare, RecurrentTransfers, ReturnVestingDelegation, SetWithdrawRoute, SpkApiWallet, SpkMarkets, Symbol, Token, TokenMetadata, Transfer, TransferToSavings, TransferToVesting, TransformedSpkMarkets, UpdateProposalVotes, VoteProxy, WalletOperationPayload, WithdrawVesting, formattedNumber, getAccountWalletAssetInfoQueryOptions, getAllHiveEngineTokensQueryOptions, getHbdAssetGeneralInfoQueryOptions, getHbdAssetTransactionsQueryOptions, getHiveAssetGeneralInfoQueryOptions, getHiveAssetMetricQueryOptions, getHiveAssetTransactionsQueryOptions, getHiveAssetWithdrawalRoutesQueryOptions, getHiveEngineBalancesWithUsdQueryOptions, getHiveEngineTokenGeneralInfoQueryOptions, getHiveEngineTokenTransactionsQueryOptions, getHiveEngineTokensBalancesQueryOptions, getHiveEngineTokensMarketQueryOptions, getHiveEngineTokensMetadataQueryOptions, getHiveEngineTokensMetricsQueryOptions, getHiveEngineUnclaimedRewardsQueryOptions, getHivePowerAssetGeneralInfoQueryOptions, getHivePowerAssetTransactionsQueryOptions, getHivePowerDelegatesInfiniteQueryOptions, getHivePowerDelegatingsQueryOptions, getLarynxAssetGeneralInfoQueryOptions, getLarynxPowerAssetGeneralInfoQueryOptions, getPointsAssetGeneralInfoQueryOptions, getPointsAssetTransactionsQueryOptions, getPointsQueryOptions, getSpkAssetGeneralInfoQueryOptions, getSpkMarketsQueryOptions, getSpkWalletQueryOptions, isEmptyDate, parseAsset, resolveHiveOperationFilters, rewardSpk, useClaimPoints, useWalletOperation, vestsToHp } from '@ecency/sdk';
-import { BaseWallet, SignTxParams } from '@okxweb3/coin-base';
-import { Client } from '@hiveio/dhive';
-import { Transaction, SignedTransaction, TransactionConfirmation } from '@hiveio/dhive/lib/chain/transaction';
-import { utxoTx } from '@okxweb3/coin-bitcoin/dist/type';
-import { Network } from '@okxweb3/coin-bitcoin/dist/bitcoinjs-lib';
-import { EthTxParams } from '@okxweb3/coin-ethereum/dist/EthWallet';
-import { SolSignParam } from '@okxweb3/coin-solana/dist/SolWallet';
-import { TrxSignParam } from '@okxweb3/coin-tron/dist/TrxWallet';
-import { TxData } from '@okxweb3/coin-ton/dist/api/types';
-import { AptosParam } from '@okxweb3/coin-aptos/dist/AptosWallet';
 
 declare enum EcencyWalletCurrency {
     BTC = "BTC",
     ETH = "ETH",
     BNB = "BNB",
-    APT = "APT",
-    TON = "TON",
-    TRON = "TRX",
     SOL = "SOL"
 }
 
@@ -30,6 +17,44 @@ declare enum EcencyWalletBasicTokens {
     HiveDollar = "HBD"
 }
 
+interface HiveKeys {
+    ownerPublicKey?: string;
+    activePublicKey?: string;
+    postingPublicKey?: string;
+    memoPublicKey?: string;
+}
+interface Payload$2 {
+    currency: EcencyWalletCurrency;
+    address: string;
+    hiveKeys?: HiveKeys;
+    walletAddresses?: Partial<Record<EcencyWalletCurrency, string>>;
+}
+declare function useCreateAccountWithWallets(username: string): _tanstack_react_query.UseMutationResult<Response, Error, Payload$2, unknown>;
+
+interface Payload$1 {
+    address: string;
+    currency: EcencyWalletCurrency;
+}
+declare function useCheckWalletExistence(): _tanstack_react_query.UseMutationResult<boolean, Error, Payload$1, unknown>;
+
+interface Payload {
+    tokens: Record<string, string>;
+    hiveKeys: {
+        ownerPublicKey: string;
+        activePublicKey: string;
+        postingPublicKey: string;
+        memoPublicKey: string;
+    };
+}
+declare function useUpdateAccountWithWallets(username: string, accessToken: string | undefined): _tanstack_react_query.UseMutationResult<Response, Error, Payload, unknown>;
+
+declare const index_useCheckWalletExistence: typeof useCheckWalletExistence;
+declare const index_useCreateAccountWithWallets: typeof useCreateAccountWithWallets;
+declare const index_useUpdateAccountWithWallets: typeof useUpdateAccountWithWallets;
+declare namespace index {
+  export { index_useCheckWalletExistence as useCheckWalletExistence, index_useCreateAccountWithWallets as useCreateAccountWithWallets, index_useUpdateAccountWithWallets as useUpdateAccountWithWallets };
+}
+
 interface EcencyTokenMetadata {
     address?: string;
     privateKey?: string;
@@ -62,60 +87,6 @@ interface AccountPointsResponse {
     unclaimed_points: string;
 }
 
-/**
- * Uses for creating wallet logically in the application
- *
- * Keep attention: this mutation doesn't save wallet to somewhere in a server
- */
-declare function useWalletCreate(username: string, currency: EcencyWalletCurrency, importedSeed?: string): {
-    createWallet: _tanstack_react_query.UseMutationResult<EcencyTokenMetadata, Error, void, unknown>;
-    importWallet: () => void;
-};
-
-interface Payload$3 {
-    currency: string;
-    address: string;
-}
-declare function useCreateAccountWithWallets(username: string): _tanstack_react_query.UseMutationResult<Response, Error, Payload$3, unknown>;
-
-interface Payload$2 {
-    address: string;
-    currency: EcencyWalletCurrency;
-}
-declare function useCheckWalletExistence(): _tanstack_react_query.UseMutationResult<boolean, Error, Payload$2, unknown>;
-
-interface Payload$1 {
-    tokens: Record<string, string>;
-    hiveKeys: {
-        ownerPublicKey: string;
-        activePublicKey: string;
-        postingPublicKey: string;
-        memoPublicKey: string;
-    };
-}
-declare function useUpdateAccountWithWallets(username: string, accessToken: string | undefined): _tanstack_react_query.UseMutationResult<Response, Error, Payload$1, unknown>;
-
-declare const index_useCheckWalletExistence: typeof useCheckWalletExistence;
-declare const index_useCreateAccountWithWallets: typeof useCreateAccountWithWallets;
-declare const index_useUpdateAccountWithWallets: typeof useUpdateAccountWithWallets;
-declare namespace index {
-  export { index_useCheckWalletExistence as useCheckWalletExistence, index_useCreateAccountWithWallets as useCreateAccountWithWallets, index_useUpdateAccountWithWallets as useUpdateAccountWithWallets };
-}
-
-interface Payload {
-    privateKeyOrSeed: string;
-}
-/**
- * This mutation uses for importing an existing wallet, validation and saving logically in application
- *
- * Keep attention: this mutation doesn't save wallet to somewhere in a server
- */
-declare function useImportWallet(username: string, currency: EcencyWalletCurrency): _tanstack_react_query.UseMutationResult<{
-    privateKey: string;
-    address: any;
-    publicKey: string;
-}, Error, Payload, unknown>;
-
 /**
  * Saving of token(s) metadata to Hive profile
  * It may contain: external wallets(see EcencyWalletCurrency), Hive tokens arrangement
@@ -125,6 +96,19 @@ declare function useImportWallet(username: string, currency: EcencyWalletCurrenc
 type SaveWalletInformationOptions = Pick<UseMutationOptions<unknown, Error, EcencyTokenMetadata[]>, "onSuccess" | "onError">;
 declare function useSaveWalletInformationToMetadata(username: string, auth?: AuthContext, options?: SaveWalletInformationOptions): _tanstack_react_query.UseMutationResult<unknown, Error, EcencyTokenMetadata[], unknown>;
 
+type TransferableCurrency = EcencyWalletCurrency.ETH | EcencyWalletCurrency.BNB | EcencyWalletCurrency.SOL;
+interface ExternalTransferPayload {
+    to: string;
+    amount: string;
+}
+declare function useExternalTransfer(currency: TransferableCurrency): _tanstack_react_query.UseMutationResult<{
+    txHash: string;
+    currency: EcencyWalletCurrency.ETH | EcencyWalletCurrency.BNB;
+} | {
+    txHash: string;
+    currency: EcencyWalletCurrency.SOL;
+}, Error, ExternalTransferPayload, unknown>;
+
 interface ExternalWalletBalance {
     chain: string;
     unit: string;
@@ -142,8 +126,6 @@ interface ExternalWalletBalance {
 }
 declare function useGetExternalWalletBalanceQuery(currency: EcencyWalletCurrency, address: string): _tanstack_react_query.UseQueryResult<ExternalWalletBalance, Error>;
 
-declare function useSeedPhrase(username: string): _tanstack_react_query.UseQueryResult<string, Error>;
-
 declare function getTokenPriceQueryOptions(currency?: string): _tanstack_react_query.OmitKeyof<_tanstack_react_query.UseQueryOptions<number, Error, number, (string | undefined)[]>, "queryFn"> & {
     queryFn?: _tanstack_react_query.QueryFunction<number, (string | undefined)[], never> | undefined;
 } & {
@@ -153,8 +135,6 @@ declare function getTokenPriceQueryOptions(currency?: string): _tanstack_react_q
     };
 };
 
-declare function useHiveKeysQuery(username: string): _tanstack_react_query.UseQueryResult<EcencyHiveKeys, Error>;
-
 declare function getAllTokensListQueryOptions(username?: string): _tanstack_react_query.OmitKeyof<_tanstack_react_query.UseQueryOptions<{
     basic: EcencyWalletBasicTokens[];
     external: EcencyWalletCurrency[];
@@ -202,14 +182,6 @@ declare function getTokenOperationsQueryOptions(token: string, username: string,
     };
 };
 
-declare function useWalletsCacheQuery(username?: string): _tanstack_react_query.DefinedUseQueryResult<Map<EcencyWalletCurrency, EcencyTokenMetadata>, Error>;
-
-declare function delay(ms: number): Promise<unknown>;
-
-declare function getWallet(currency: EcencyWalletCurrency): BaseWallet | undefined;
-
-declare function mnemonicToSeedBip39(value: string): string;
-
 type HiveRole = "owner" | "active" | "posting" | "memo";
 declare function deriveHiveKey(mnemonic: string, role: HiveRole, accountIndex?: number): {
     readonly privateKey: string;
@@ -244,123 +216,73 @@ declare function deriveHiveMasterPasswordKeys(username: string, masterPassword:
 type HiveKeyDerivation = "bip44" | "master-password" | "unknown";
 declare function detectHiveKeyDerivation(username: string, seed: string, type?: "active" | "owner"): Promise<HiveKeyDerivation>;
 
+interface RequestArguments {
+    method: string;
+    params?: unknown[] | Record<string, unknown>;
+}
+interface EthereumProvider {
+    isMetaMask?: boolean;
+    request<T = unknown>(args: RequestArguments): Promise<T>;
+}
+declare global {
+    interface Window {
+        ethereum?: EthereumProvider;
+    }
+}
+declare function getEvmChainConfig(currency: EcencyWalletCurrency): {
+    chainId: string;
+    name: string;
+    rpcUrl: string;
+    explorerUrl: string;
+};
+declare function getEvmExplorerUrl(currency: EcencyWalletCurrency, txHash: string): string;
+declare function ensureEvmChain(currency: EcencyWalletCurrency): Promise<void>;
+declare function estimateEvmGas(from: string, to: string, valueHex: string, currency: EcencyWalletCurrency): Promise<{
+    gasLimit: string;
+    gasPrice: string;
+    estimatedFeeWei: bigint;
+}>;
+declare function formatWei(wei: bigint, decimals?: number): string;
+declare function parseToWei(amount: string): string;
+declare function sendEvmTransfer(to: string, amountWei: string, currency: EcencyWalletCurrency): Promise<string>;
+
+declare function getSolExplorerUrl(signature: string): string;
+declare function parseToLamports(amount: string): bigint;
+declare function formatLamports(lamports: bigint, decimals?: number): string;
+declare function sendSolTransfer(to: string, amountSol: string): Promise<string>;
+
+type WalletAddressMap = Partial<Record<EcencyWalletCurrency, string>>;
+interface HivePublicKey {
+    publicKey: string;
+    role?: string;
+    accountIndex: number;
+    addressIndex: number;
+}
 /**
- * Sign a digest using the provided private key.
- * @param digest Digest as a Buffer or hex string.
- * @param privateKey Private key in WIF format.
- * @returns Hex encoded signature string.
- */
-declare function signDigest(digest: Buffer | string, privateKey: string): string;
-
-/**
- * Sign a transaction with the given private key.
- * Optionally a custom chain id can be provided.
- *
- * @param tx Transaction to sign.
- * @param privateKey Private key in WIF format.
- * @param chainId Optional chain id as a hex string.
- * @returns Signed transaction including the signature.
- */
-declare function signTx(tx: Transaction, privateKey: string, chainId?: string): SignedTransaction;
-/**
- * Sign a transaction and broadcast it to the network.
- * Optionally a custom chain id can be provided.
- *
- * @param client Hive client instance used for broadcasting.
- * @param tx Transaction to sign.
- * @param privateKey Private key in WIF format.
- * @param chainId Optional chain id as a hex string.
- * @returns Broadcast confirmation.
- */
-declare function signTxAndBroadcast(client: Client, tx: Transaction, privateKey: string, chainId?: string): Promise<TransactionConfirmation>;
-
-/**
- * Encrypt a memo using explicit keys.
- * @param privateKey Sender's private memo key in WIF format.
- * @param publicKey Recipient's public memo key.
- * @param memo Memo text to encrypt.
- */
-declare function encryptMemoWithKeys(privateKey: string, publicKey: string, memo: string): string;
-/**
- * Encrypt a memo by looking up the recipient's memo key from the blockchain.
- * @param client Hive client instance used to fetch account information.
- * @param fromPrivateKey Sender's private memo key.
- * @param toAccount Recipient account name.
- * @param memo Memo text to encrypt.
- */
-declare function encryptMemoWithAccounts(client: Client, fromPrivateKey: string, toAccount: string, memo: string): Promise<string>;
-
-/**
- * Decrypt an encrypted memo using the recipient's private key.
- * @param privateKey Private memo key in WIF format.
- * @param memo Encrypted memo string.
- */
-declare function decryptMemoWithKeys(privateKey: string, memo: string): string;
-/**
- * Decrypt a memo using account information.
- * This is an alias of {@link decryptMemoWithKeys} and provided for
- * API symmetry with {@link encryptMemoWithAccounts}.
- */
-declare const decryptMemoWithAccounts: typeof decryptMemoWithKeys;
-
-/**
- * Sign a transaction for an external chain supported by okxweb3 wallets.
- *
- * @param currency Chain identifier.
- * @param params   Signing parameters accepted by okxweb3 wallets.
- */
-declare function signExternalTx(currency: EcencyWalletCurrency, params: SignTxParams): Promise<any>;
-/**
- * Sign and broadcast a transaction for an external chain. The transaction is
- * signed locally and then sent to a public RPC endpoint for broadcasting.
- *
- * @param currency Chain identifier.
- * @param params   Signing parameters accepted by okxweb3 wallets.
- * @returns        RPC response or broadcasted transaction hash.
- */
-declare function signExternalTxAndBroadcast(currency: EcencyWalletCurrency, params: SignTxParams): Promise<any>;
-
-/**
- * Union type covering all chain-specific build parameters.
- */
-type ExternalTxParams = utxoTx | EthTxParams | SolSignParam | TrxSignParam | TxData | AptosParam;
-/**
- * Build a Bitcoin PSBT from UTXO inputs and desired outputs.
- *
- * @param tx Transaction description accepted by @okxweb3/coin-bitcoin.
- * @returns Hex encoded PSBT ready for signing.
- */
-declare function buildPsbt(tx: utxoTx, network?: Network, maximumFeeRate?: number): string;
-/**
- * Helper returning raw Ethereum transaction data ready for signing.
+ * Fetch non-EVM addresses from MetaMask via the Wallet Standard protocol.
  *
- * The returned object can be passed directly to signExternalTx.
+ * MetaMask registers non-EVM wallets (Solana, Bitcoin) as separate Wallet Standard
+ * wallets — they are NOT accessible through window.ethereum (EVM-only provider).
  */
-declare function buildEthTx(data: EthTxParams): EthTxParams;
+declare function fetchMultichainAddresses(): Promise<WalletAddressMap>;
 /**
- * Helper returning Solana transaction params used by signExternalTx.
+ * Fetch the EVM address from MetaMask via window.ethereum.
+ * Returns the first connected account address, or undefined on failure.
  */
-declare function buildSolTx(data: SolSignParam): SolSignParam;
+declare function fetchEvmAddress(): Promise<string | undefined>;
 /**
- * Helper returning Tron transaction params used by signExternalTx.
+ * Discover all wallet addresses from MetaMask (EVM + non-EVM).
+ * Returns a map of currency -> address. Partial results are returned on failure.
  */
-declare function buildTronTx(data: TrxSignParam): TrxSignParam;
+declare function discoverMetaMaskWallets(): Promise<WalletAddressMap>;
 /**
- * Helper returning TON transaction params used by signExternalTx.
+ * Install the Hive Snap in MetaMask.
  */
-declare function buildTonTx(data: TxData): TxData;
+declare function installHiveSnap(): Promise<void>;
 /**
- * Helper returning Aptos transaction params used by signExternalTx.
+ * Get Hive public keys from the MetaMask Hive Snap.
+ * Returns owner, active, posting, and memo public keys.
  */
-declare function buildAptTx(data: AptosParam): AptosParam;
-/**
- * Build a transaction for an external chain supported by okxweb3 wallets.
- *
- * @param currency Chain identifier.
- * @param tx       Chain specific transaction description.
- */
-declare function buildExternalTx(currency: EcencyWalletCurrency, tx: ExternalTxParams): string | EthTxParams | SolSignParam | TrxSignParam | TxData | AptosParam;
-
-declare function getBoundFetch(): typeof fetch;
+declare function getHivePublicKeys(): Promise<HivePublicKey[]>;
 
-export { type AccountPointsResponse, type EcencyHiveKeys, type EcencyTokenMetadata, EcencyWalletBasicTokens, EcencyWalletCurrency, index as EcencyWalletsPrivateApi, type ExternalTxParams, type ExternalWalletBalance, type HiveKeyDerivation, type HiveRole, buildAptTx, buildEthTx, buildExternalTx, buildPsbt, buildSolTx, buildTonTx, buildTronTx, decryptMemoWithAccounts, decryptMemoWithKeys, delay, deriveHiveKey, deriveHiveKeys, deriveHiveMasterPasswordKey, deriveHiveMasterPasswordKeys, detectHiveKeyDerivation, encryptMemoWithAccounts, encryptMemoWithKeys, getAccountWalletListQueryOptions, getAllTokensListQueryOptions, getBoundFetch, getTokenOperationsQueryOptions, getTokenPriceQueryOptions, getWallet, mnemonicToSeedBip39, signDigest, signExternalTx, signExternalTxAndBroadcast, signTx, signTxAndBroadcast, useGetExternalWalletBalanceQuery, useHiveKeysQuery, useImportWallet, useSaveWalletInformationToMetadata, useSeedPhrase, useWalletCreate, useWalletsCacheQuery };
+export { type AccountPointsResponse, type EcencyHiveKeys, type EcencyTokenMetadata, EcencyWalletBasicTokens, EcencyWalletCurrency, index as EcencyWalletsPrivateApi, type ExternalWalletBalance, type HiveKeyDerivation, type HivePublicKey, type HiveRole, type TransferableCurrency, type WalletAddressMap, deriveHiveKey, deriveHiveKeys, deriveHiveMasterPasswordKey, deriveHiveMasterPasswordKeys, detectHiveKeyDerivation, discoverMetaMaskWallets, ensureEvmChain, estimateEvmGas, fetchEvmAddress, fetchMultichainAddresses, formatLamports, formatWei, getAccountWalletListQueryOptions, getAllTokensListQueryOptions, getEvmChainConfig, getEvmExplorerUrl, getHivePublicKeys, getSolExplorerUrl, getTokenOperationsQueryOptions, getTokenPriceQueryOptions, installHiveSnap, parseToLamports, parseToWei, sendEvmTransfer, sendSolTransfer, useExternalTransfer, useGetExternalWalletBalanceQuery, useSaveWalletInformationToMetadata };