@ecency/sdk 1.0.0

package/Readme.md

@@ -0,0 +1,36 @@
+# Ecency wallets – manage Hive account and attach external wallets to it in Ecency system
+
+[![NPM](https://img.shields.io/npm/v/@ecency/wallets.svg)](https://www.npmjs.com/package/@ecency/wallets) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
+
+## Overview
+
+`@ecency/wallets` provides an API for managing Hive blockchain wallets and external cryptocurrency wallets within the Ecency ecosystem.
+
+## Installation
+
+```sh
+yarn add @ecency/wallets
+# or
+npm install @ecency/wallets
+```
+
+## Setup
+
+1. Install `react @tanstack/react-query @hiveio/dhive`
+2. Use!
+
+## Features
+
+This package built on top of [@hiveio/dhive](https://www.npmjs.com/package/@hiveio/dhive) and [okweb3](http://okx.github.io/) packages.
+
+Main functionality is creating wallets based on seed phrase([BIP39](https://www.npmjs.com/package/bip39)) and generating addresses with keys on device. Seed phrases and private keys are never sent to any API, all operations happen locally.
+
+Supportings tokens: BTC, ETH, SOL, TRX, TON, ATOM, APT – theoretically all child tokens of these systems. Make forks for it.
+
+## Roadmap
+
+- Add more Hive wallets operations
+- Allow to sign transactions with external wallets
+- Allow to import existing wallets by phrase or private keys
+- Support of DASH
+- Support of DOGE

package/dist/ecency-sdk.es.d.ts

@@ -0,0 +1,96 @@
+import { BaseWallet } from '@okxweb3/coin-base';
+import { UseMutationResult } from '@tanstack/react-query';
+import { UseQueryResult } from '@tanstack/react-query';
+
+export declare function delay(ms: number): Promise<unknown>;
+
+export declare interface EcencyCreateWalletInformation {
+    address: string;
+    privateKey: string;
+    publicKey: string;
+    username: string;
+    currency: EcencyWalletCurrency;
+    custom?: boolean;
+}
+
+export declare interface EcencyHiveKeys {
+    username: string;
+    owner: string;
+    active: string;
+    posting: string;
+    memo: string;
+    masterPassword: string;
+    ownerPubkey: string;
+    activePubkey: string;
+    postingPubkey: string;
+    memoPubkey: string;
+}
+
+export declare enum EcencyWalletCurrency {
+    BTC = "btc",
+    ETH = "eth",
+    APT = "aptos",
+    ATOM = "cosmos",
+    TON = "ton",
+    TRON = "tron",
+    SOL = "solana"
+}
+
+declare namespace EcencyWalletsPrivateApi {
+    export {
+        useCreateAccountWithWallets,
+        useCheckWalletExistence
+    }
+}
+export { EcencyWalletsPrivateApi }
+
+export declare function getWallet(currency: EcencyWalletCurrency): BaseWallet | undefined;
+
+export declare function mnemonicToSeedBip39(value: string): string;
+
+declare interface Payload {
+    currency: EcencyWalletCurrency;
+    address: string;
+}
+
+declare interface Payload_2 {
+    address: string;
+    currency: EcencyWalletCurrency;
+}
+
+declare interface Payload_3 {
+    privateKeyOrSeed: string;
+}
+
+declare function useCheckWalletExistence(): UseMutationResult<boolean, Error, Payload_2, unknown>;
+
+export declare function useCoinGeckoPriceQuery(currency?: EcencyWalletCurrency): UseQueryResult<number, Error>;
+
+declare function useCreateAccountWithWallets(username: string): UseMutationResult<Response, Error, Payload, unknown>;
+
+/**
+ * Returns information about the actual balance of the given currency address
+ *         using various of public APIs
+ * todo extract URLs to configs
+ * @param currency
+ * @param address
+ * @returns
+ */
+export declare function useGetExternalWalletBalanceQuery(currency: EcencyWalletCurrency, address: string): UseQueryResult<number, Error>;
+
+export declare function useHiveKeysQuery(username: string): UseQueryResult<EcencyHiveKeys, Error>;
+
+export declare function useImportWallet(username: string, currency: EcencyWalletCurrency): UseMutationResult<    {
+privateKey: string;
+address: any;
+publicKey: string;
+}, Error, Payload_3, unknown>;
+
+export declare function useSeedPhrase(username: string): UseQueryResult<string, Error>;
+
+export declare function useWalletCreate(username: string, currency: EcencyWalletCurrency): {
+    createWallet: UseMutationResult<EcencyCreateWalletInformation, Error, void, unknown>;
+    importWallet: () => void;
+};
+
+export { }

package/dist/ecency-sdk.es.js

@@ -0,0 +1,373 @@
+import { useCallback as R } from "react";
+import { useQuery as p, useQueryClient as y, useMutation as m } from "@tanstack/react-query";
+import { BtcWallet as O } from "@okxweb3/coin-bitcoin";
+import { EthWallet as v } from "@okxweb3/coin-ethereum";
+import { TrxWallet as k } from "@okxweb3/coin-tron";
+import { TonWallet as A } from "@okxweb3/coin-ton";
+import { SolWallet as N } from "@okxweb3/coin-solana";
+import { AtomWallet as K } from "@okxweb3/coin-cosmos";
+import { AptosWallet as D } from "@okxweb3/coin-aptos";
+import j, { mnemonicToSeedSync as C } from "bip39";
+import { LRUCache as H } from "lru-cache";
+import { PrivateKey as u } from "@hiveio/dhive";
+var o = /* @__PURE__ */ ((e) => (e.BTC = "btc", e.ETH = "eth", e.APT = "aptos", e.ATOM = "cosmos", e.TON = "ton", e.TRON = "tron", e.SOL = "solana", e))(o || {});
+function x(e) {
+  return new Promise((t) => setTimeout(t, e));
+}
+function h(e) {
+  switch (e) {
+    case o.BTC:
+      return new O();
+    case o.ETH:
+      return new v();
+    case o.TRON:
+      return new k();
+    case o.TON:
+      return new A();
+    case o.SOL:
+      return new N();
+    case o.ATOM:
+      return new K();
+    case o.APT:
+      return new D();
+    default:
+      return;
+  }
+}
+function ce(e) {
+  return C(e).toString("hex");
+}
+function ie(e, t) {
+  return p({
+    queryKey: ["ecency-wallets", "external-wallet-balance", e, t],
+    queryFn: async () => {
+      switch (e) {
+        case o.BTC:
+          const r = await (await fetch(
+            `https://mempool.space/api/address/${t}`
+          )).json();
+          return (r.chain_stats.funded_txo_sum - r.chain_stats.spent_txo_sum) / 1e8;
+        case o.ETH:
+          return +(await (await fetch("https://eth.llamarpc.com", {
+            method: "POST",
+            body: JSON.stringify({
+              jsonrpc: "2.0",
+              id: "1",
+              method: "eth_getBalance",
+              params: [t, "latest"]
+            })
+          })).json()).result / 1e18;
+        case o.SOL:
+          return (await (await fetch(
+            "https://api.mainnet-beta.solana.com",
+            {
+              method: "POST",
+              body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: "1",
+                method: "getBalance",
+                params: [t]
+              })
+            }
+          )).json()).result.value / 1e9;
+        case o.TRON:
+          return (await (await fetch(
+            `https://api.trongrid.io/v1/accounts/${t}`
+          )).json()).data[0].balance / 1e6;
+        case o.TON:
+          return (await (await fetch(
+            `https://tonapi.io/v1/blockchain/getAccount?account=${t}`
+          )).json()).balance / 1e9;
+        case o.APT:
+          const d = (await (await fetch(
+            `https://fullnode.mainnet.aptoslabs.com/v1/accounts/${t}/resources`
+          )).json()).find(
+            (S) => S.type.includes("coin::CoinStore")
+          );
+          return d ? parseInt(d.data.coin.value) / 1e8 : 0;
+        case o.ATOM:
+          return +(await (await fetch(
+            `https://rest.cosmos.directory/cosmoshub/auth/accounts/${t}`
+          )).json()).result.value.coins[0].amount / 1e6;
+      }
+    }
+  });
+}
+function f(e) {
+  return p({
+    queryKey: ["ecency-wallets", "seed", e],
+    queryFn: async () => j.generateMnemonic(128)
+  });
+}
+const W = {
+  max: 500,
+  // how long to live in ms
+  ttl: 1e3 * 60 * 5,
+  // return stale items before removing from cache?
+  allowStale: !1,
+  updateAgeOnGet: !1,
+  updateAgeOnHas: !1
+}, b = new H(W), w = Symbol("undefined"), _ = (e, t) => b.set(e, t === void 0 ? w : t), E = (e) => {
+  const t = b.get(e);
+  return t === w ? void 0 : t;
+};
+function le(e) {
+  return p({
+    queryKey: ["ecency-wallets", "coingecko-price", e],
+    queryFn: async () => {
+      let t = e;
+      switch (e) {
+        case o.BTC:
+          t = "binance-wrapped-btc";
+          break;
+        case o.ETH:
+          t = "ethereum";
+          break;
+        case o.SOL:
+          t = "solana";
+          break;
+        case o.TON:
+          t = "trx";
+          break;
+        default:
+          t = e;
+      }
+      let n = E("gecko"), r;
+      if (n)
+        r = n;
+      else {
+        const a = await (await fetch(
+          "https://api.coingecko.com/api/v3/simple/price",
+          {
+            method: "POST",
+            body: JSON.stringify({
+              params: {
+                ids: [t],
+                vs_currencies: "usd"
+              }
+            })
+          }
+        )).json();
+        _("gecko", a === void 0 ? w : a), r = a;
+      }
+      return 1 / +r[Object.keys(r)[0]].usd;
+    },
+    enabled: !!e
+  });
+}
+function q(e) {
+  const { data: t } = f(e);
+  return p({
+    queryKey: ["ecencу-wallets", "hive-keys", e, t],
+    queryFn: async () => {
+      if (!t)
+        throw new Error("[Ecency][Wallets] - no seed to create Hive account");
+      const n = u.fromLogin(e, t, "owner"), r = u.fromLogin(e, t, "active"), s = u.fromLogin(e, t, "posting"), i = u.fromLogin(e, t, "memo");
+      return {
+        username: e,
+        owner: n.toString(),
+        active: r.toString(),
+        posting: s.toString(),
+        memo: i.toString(),
+        ownerPubkey: n.createPublic().toString(),
+        activePubkey: r.createPublic().toString(),
+        postingPubkey: s.createPublic().toString(),
+        memoPubkey: i.createPublic().toString()
+      };
+    }
+  });
+}
+const B = {
+  [o.BTC]: "m/44'/0'/0'/0/0",
+  // Bitcoin (BIP44)
+  [o.ETH]: "m/44'/60'/0'/0/0",
+  // Ethereum (BIP44)
+  [o.SOL]: "m/44'/501'/0'/0'",
+  // Solana (BIP44)
+  [o.TON]: "m/44'/607'/0'",
+  // TON (BIP44)
+  [o.TRON]: "m/44'/195'/0'/0/0",
+  // Tron (BIP44)
+  [o.APT]: "m/44'/637'/0'/0'/0'",
+  // Aptos (BIP44)
+  [o.ATOM]: "m/44'/118'/0'/0/0"
+  // Cosmos (BIP44)
+};
+function pe(e, t) {
+  const { data: n } = f(e), r = y(), s = m({
+    mutationKey: ["ecency-wallets", "create-wallet", e, t],
+    mutationFn: async () => {
+      if (!n)
+        throw new Error("[Ecency][Wallets] - No seed to create a wallet");
+      const a = h(t), c = await (a == null ? void 0 : a.getDerivedPrivateKey({
+        mnemonic: n,
+        hdPath: B[t]
+      }));
+      await x(1e3);
+      const l = await (a == null ? void 0 : a.getNewAddress({
+        privateKey: c
+      }));
+      return {
+        privateKey: c,
+        address: l.address,
+        publicKey: l.publicKey,
+        username: e,
+        currency: t
+      };
+    },
+    onSuccess: (a) => {
+      r.setQueryData(
+        ["ecency-wallets", "wallets", a.username],
+        (c) => new Map(c ? Array.from(c.entries()) : []).set(a.currency, a)
+      );
+    }
+  }), i = R(() => {
+  }, []);
+  return {
+    createWallet: s,
+    importWallet: i
+  };
+}
+const g = { privateApiHost: "https://ecency.com" };
+function L(e) {
+  const { data: t } = p({
+    queryKey: ["ecency-wallets", "wallets", e]
+  }), { data: n } = q(e);
+  return m({
+    mutationKey: ["ecency-wallets", "create-account-with-wallets", e],
+    mutationFn: ({ currency: r, address: s }) => fetch(g.privateApiHost + "/private-api/wallets-add", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        username: e,
+        token: r,
+        address: s,
+        meta: {
+          ownerPublicKey: n == null ? void 0 : n.ownerPubkey,
+          activePublicKey: n == null ? void 0 : n.activePubkey,
+          postingPublicKey: n == null ? void 0 : n.postingPubkey,
+          memoPublicKey: n == null ? void 0 : n.memoPubkey,
+          ...Array.from((t == null ? void 0 : t.entries()) ?? []).reduce(
+            (i, [a, c]) => ({
+              ...i,
+              [a]: c.address
+            }),
+            {}
+          )
+        }
+      })
+    })
+  });
+}
+function T() {
+  return m({
+    mutationKey: ["ecency-wallets", "check-wallet-existence"],
+    mutationFn: async ({ address: e, currency: t }) => (await (await fetch(
+      g.privateApiHost + "/private-api/wallets-exist",
+      {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          address: e,
+          token: t
+        })
+      }
+    )).json()).length === 0
+  });
+}
+const ue = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  useCheckWalletExistence: T,
+  useCreateAccountWithWallets: L
+}, Symbol.toStringTag, { value: "Module" })), F = {
+  [o.BTC]: ["m/84'/0'/0'/0/0"],
+  [o.ETH]: ["m/84'/60'/0'/0/0"],
+  // its not working for Trust, Exodus, todo: check others below
+  [o.SOL]: ["m/84'/501'/0'/0/0"],
+  [o.TRON]: ["m/84'/195'/0'/0/0"],
+  [o.APT]: ["m/84'/637'/0'/0/0"],
+  [o.TON]: [],
+  // Disabled
+  [o.ATOM]: ["m/84'/118'/0'/0'/0"]
+};
+async function M(e, t, n) {
+  for (const r of F[n] || [])
+    try {
+      const s = await t.getDerivedPrivateKey({
+        mnemonic: e,
+        hdPath: r
+      }), i = await t.getNewAddress({
+        privateKey: s,
+        addressType: "segwit_native"
+      });
+      return [s.toString(), i.address];
+    } catch {
+      return [];
+    }
+  return [];
+}
+function me(e, t) {
+  const n = y(), { mutateAsync: r } = T();
+  return m({
+    mutationKey: ["ecency-wallets", "import-wallet", e, t],
+    mutationFn: async ({ privateKeyOrSeed: s }) => {
+      const i = h(t);
+      if (!i)
+        throw new Error("Cannot find token for this currency");
+      const a = s.split(" ").length === 12;
+      let c, l = s;
+      if (a ? [l, c] = await M(
+        s,
+        i,
+        t
+      ) : c = (await i.getNewAddress({
+        privateKey: s
+      })).address, !c || !s)
+        throw new Error(
+          "Private key/seed phrase isn't matching with public key or token"
+        );
+      if (!await r({
+        address: c,
+        currency: t
+      }))
+        throw new Error(
+          "This wallet has already in use by Hive account. Please, try another one"
+        );
+      return {
+        privateKey: l,
+        address: c,
+        publicKey: ""
+      };
+    },
+    onSuccess: ({ privateKey: s, publicKey: i, address: a }) => {
+      n.setQueryData(
+        ["ecency-wallets", "wallets", e],
+        (c) => new Map(c ? Array.from(c.entries()) : []).set(t, {
+          privateKey: s,
+          publicKey: i,
+          address: a,
+          username: e,
+          currency: t,
+          custom: !0
+        })
+      );
+    }
+  });
+}
+export {
+  o as EcencyWalletCurrency,
+  ue as EcencyWalletsPrivateApi,
+  x as delay,
+  h as getWallet,
+  ce as mnemonicToSeedBip39,
+  le as useCoinGeckoPriceQuery,
+  ie as useGetExternalWalletBalanceQuery,
+  q as useHiveKeysQuery,
+  me as useImportWallet,
+  f as useSeedPhrase,
+  pe as useWalletCreate
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@ecency/sdk",
+  "private": false,
+  "version": "1.0.0",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/ecency-sdk.umd.js",
+  "module": "./dist/ecency-sdk.es.js",
+  "typings": "./dist/ecency-sdk.es.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "devDependencies": {
+    "@hiveio/dhive": "^1.3.2",
+    "@tanstack/react-query": "^5.66.11",
+    "@types/node": "^22.13.8",
+    "@types/react": "^19.0.10",
+    "@vitejs/plugin-react": "^4.3.4",
+    "eslint": "^9.21.0",
+    "lru-cache": "^11.0.2",
+    "prettier": "^3.5.2",
+    "react": "^19.0.0",
+    "typescript": "~5.7.2",
+    "vite": "^6.2.0",
+    "vite-plugin-dts": "^4.5.1",
+    "vite-plugin-node-polyfills": "^0.23.0"
+  },
+  "dependencies": {
+    "@okxweb3/coin-aptos": "^1.2.0",
+    "@okxweb3/coin-base": "^1.1.2",
+    "@okxweb3/coin-bitcoin": "^1.2.0",
+    "@okxweb3/coin-cosmos": "^1.1.0",
+    "@okxweb3/coin-ethereum": "^1.0.12",
+    "@okxweb3/coin-solana": "^1.1.0",
+    "@okxweb3/coin-ton": "^1.1.1-beta.1",
+    "@okxweb3/coin-tron": "^1.1.0",
+    "@okxweb3/crypto-lib": "^1.0.10",
+    "bip39": "^3.1.0"
+  }
+}