@ledgerhq/coin-hedera 1.10.1 → 1.11.0-nightly.2

package/lib-es/bridge/utils.js

@@ -1,39 +1,80 @@
 import BigNumber from "bignumber.js";
+import murmurhash from "imurmurhash";
+import invariant from "invariant";
 import cvsApi from "@ledgerhq/live-countervalues/api/index";
-import { getFiatCurrencyByTicker } from "@ledgerhq/cryptoassets";
+import { findTokenByAddressInCurrency, getFiatCurrencyByTicker, listTokensForCryptoCurrency, } from "@ledgerhq/cryptoassets";
+import { decodeTokenAccountId, emptyHistoryCache, encodeTokenAccountId, findSubAccountById, isTokenAccount, } from "@ledgerhq/coin-framework/account";
+import { encodeOperationId } from "@ledgerhq/coin-framework/operation";
+import { mergeOps } from "@ledgerhq/coin-framework/bridge/jsHelpers";
+import { makeLRUCache, seconds } from "@ledgerhq/live-network/cache";
 import { estimateMaxSpendable } from "./estimateMaxSpendable";
-export const estimatedFeeSafetyRate = 2;
-export async function getEstimatedFees(account) {
+import { getAccount } from "../api/mirror";
+import { isTokenAssociateTransaction, isValidExtra } from "../logic";
+import { BASE_USD_FEE_BY_OPERATION_TYPE, HEDERA_OPERATION_TYPES } from "../constants";
+const ESTIMATED_FEE_SAFETY_RATE = 2;
+// note: this is currently called frequently by getTransactionStatus; LRU cache prevents duplicated requests
+export const getCurrencyToUSDRate = makeLRUCache(async (currency) => {
     try {
-        const data = await cvsApi.fetchLatest([
+        const [rate] = await cvsApi.fetchLatest([
             {
-                from: account.currency,
+                from: currency,
                 to: getFiatCurrencyByTicker("USD"),
                 startDate: new Date(),
             },
         ]);
-        if (data[0]) {
-            return new BigNumber(10000)
-                .dividedBy(new BigNumber(data[0]))
+        invariant(rate, "no value returned from cvs api");
+        return new BigNumber(rate);
+    }
+    catch {
+        return null;
+    }
+}, currency => currency.ticker, seconds(3));
+export const getEstimatedFees = async (account, operationType) => {
+    try {
+        const usdRate = await getCurrencyToUSDRate(account.currency);
+        if (usdRate) {
+            return new BigNumber(BASE_USD_FEE_BY_OPERATION_TYPE[operationType])
+                .dividedBy(new BigNumber(usdRate))
                 .integerValue(BigNumber.ROUND_CEIL)
-                .multipliedBy(estimatedFeeSafetyRate);
+                .multipliedBy(ESTIMATED_FEE_SAFETY_RATE);
         }
         // eslint-disable-next-line no-empty
     }
     catch { }
     // as fees are based on a currency conversion, we stay
     // on the safe side here and double the estimate for "max spendable"
-    return new BigNumber("150200").multipliedBy(estimatedFeeSafetyRate); // 0.001502 ℏ (as of 2023-03-14)
-}
-export async function calculateAmount({ account, transaction, }) {
+    return new BigNumber("150200").multipliedBy(ESTIMATED_FEE_SAFETY_RATE); // 0.001502 ℏ (as of 2023-03-14)
+};
+const calculateCoinAmount = async ({ account, transaction, operationType, }) => {
+    const estimatedFees = await getEstimatedFees(account, operationType);
     const amount = transaction.useAllAmount
-        ? await estimateMaxSpendable({ account })
+        ? await estimateMaxSpendable({ account, transaction })
         : transaction.amount;
     return {
         amount,
-        totalSpent: amount.plus(await getEstimatedFees(account)),
+        totalSpent: amount.plus(estimatedFees),
     };
-}
+};
+const calculateTokenAmount = async ({ account, tokenAccount, transaction, }) => {
+    const amount = transaction.useAllAmount
+        ? await estimateMaxSpendable({ account: tokenAccount, parentAccount: account, transaction })
+        : transaction.amount;
+    return {
+        amount,
+        totalSpent: amount,
+    };
+};
+export const calculateAmount = ({ account, transaction, }) => {
+    const subAccount = findSubAccountById(account, transaction?.subAccountId || "");
+    const isTokenTransaction = isTokenAccount(subAccount);
+    if (isTokenTransaction) {
+        return calculateTokenAmount({ account, tokenAccount: subAccount, transaction });
+    }
+    const operationType = isTokenAssociateTransaction(transaction)
+        ? HEDERA_OPERATION_TYPES.TokenAssociate
+        : HEDERA_OPERATION_TYPES.CryptoTransfer;
+    return calculateCoinAmount({ account, transaction, operationType });
+};
 // NOTE: convert from the non-url-safe version of base64 to the url-safe version (that the explorer uses)
 export function base64ToUrlSafeBase64(data) {
     // Might be nice to use this alternative if .nvmrc changes to >= Node v14.18.0
@@ -41,6 +82,234 @@ export function base64ToUrlSafeBase64(data) {
     // Buffer.from(data, "base64").toString("base64url");
     return data.replace(/\//g, "_").replace(/\+/g, "-");
 }
+const simpleSyncHashMemoize = {};
+export const getSyncHash = (currency, blacklistedTokenIds = []) => {
+    const tokens = listTokensForCryptoCurrency(currency);
+    const stringToHash = currency.id +
+        tokens.map(token => token.id + token.contractAddress + token.name + token.ticker).join("") +
+        blacklistedTokenIds.join("");
+    if (!simpleSyncHashMemoize[stringToHash]) {
+        simpleSyncHashMemoize[stringToHash] = `0x${murmurhash(stringToHash).result().toString(16)}`;
+    }
+    return simpleSyncHashMemoize[stringToHash];
+};
+export const getSubAccounts = async (accountId, lastTokenOperations, mirrorTokens) => {
+    // Creating a Map of Operations by TokenCurrencies in order to know which TokenAccounts should be synced as well
+    const operationsByToken = lastTokenOperations.reduce((acc, tokenOperation) => {
+        const { token } = decodeTokenAccountId(tokenOperation.accountId);
+        if (!token)
+            return acc;
+        const isTokenListedInCAL = findTokenByAddressInCurrency(token.contractAddress, token.parentCurrency.id);
+        if (!isTokenListedInCAL)
+            return acc;
+        if (!acc.has(token)) {
+            acc.set(token, []);
+        }
+        acc.get(token)?.push(tokenOperation);
+        return acc;
+    }, new Map());
+    const subAccounts = [];
+    // extract token accounts from existing operations
+    for (const [token, tokenOperations] of operationsByToken.entries()) {
+        const parentAccountId = accountId;
+        const rawBalance = mirrorTokens.find(t => t.token_id === token.contractAddress)?.balance;
+        const balance = rawBalance !== undefined ? new BigNumber(rawBalance) : null;
+        if (!balance) {
+            continue;
+        }
+        subAccounts.push({
+            type: "TokenAccount",
+            id: encodeTokenAccountId(parentAccountId, token),
+            parentId: parentAccountId,
+            token,
+            balance,
+            spendableBalance: balance,
+            creationDate: tokenOperations.length > 0 ? tokenOperations[tokenOperations.length - 1].date : new Date(),
+            operations: tokenOperations,
+            operationsCount: tokenOperations.length,
+            pendingOperations: [],
+            balanceHistoryCache: emptyHistoryCache,
+            swapHistory: [],
+        });
+    }
+    // extract token accounts existing in the account's balance, but with no recorded operations yet
+    // e.g. tokens added via association flow, without any subsequent activity
+    for (const rawToken of mirrorTokens) {
+        const parentAccountId = accountId;
+        const rawBalance = rawToken.balance;
+        const balance = new BigNumber(rawBalance);
+        const token = findTokenByAddressInCurrency(rawToken.token_id, "hedera");
+        if (!token) {
+            continue;
+        }
+        const id = encodeTokenAccountId(parentAccountId, token);
+        if (subAccounts.some(a => a.id === id)) {
+            continue;
+        }
+        subAccounts.push({
+            type: "TokenAccount",
+            id: encodeTokenAccountId(parentAccountId, token),
+            parentId: parentAccountId,
+            token,
+            balance,
+            spendableBalance: balance,
+            creationDate: new Date(parseFloat(rawToken.created_timestamp) * 1000),
+            operations: [],
+            operationsCount: 0,
+            pendingOperations: [],
+            balanceHistoryCache: emptyHistoryCache,
+            swapHistory: [],
+        });
+    }
+    return subAccounts;
+};
+// create NONE coin operation that will be a parent of an orphan child operation
+const makeCoinOperationForOrphanChildOperation = (childOperation) => {
+    const type = "NONE";
+    const { accountId } = decodeTokenAccountId(childOperation.accountId);
+    const id = encodeOperationId(accountId, childOperation.hash, type);
+    return {
+        id,
+        hash: childOperation.hash,
+        type,
+        value: new BigNumber(0),
+        fee: new BigNumber(0),
+        senders: [],
+        recipients: [],
+        blockHeight: childOperation.blockHeight,
+        blockHash: childOperation.blockHash,
+        transactionSequenceNumber: childOperation.transactionSequenceNumber,
+        subOperations: [],
+        nftOperations: [],
+        internalOperations: [],
+        accountId: "",
+        date: childOperation.date,
+        extra: {},
+    };
+};
+// this util handles:
+// - linking sub operations with coin operations, e.g. token transfer with fee payment
+// - if possible, assigning `extra.associatedTokenId = mirrorToken.tokenId` based on operation's consensus timestamp
+export const prepareOperations = (coinOperations, tokenOperations, mirrorTokens) => {
+    const preparedCoinOperations = coinOperations.map(op => ({ ...op }));
+    const preparedTokenOperations = tokenOperations.map(op => ({ ...op }));
+    // loop through coin operations to:
+    // - enrich ASSOCIATE_TOKEN operations with extra.associatedTokenId
+    // - prepare a map of hash => operations
+    const coinOperationsByHash = {};
+    preparedCoinOperations.forEach(op => {
+        const extra = isValidExtra(op.extra) ? op.extra : null;
+        if (op.type === "ASSOCIATE_TOKEN" && extra?.consensusTimestamp) {
+            const relatedMirrorToken = mirrorTokens.find(t => {
+                return t.created_timestamp === extra.consensusTimestamp;
+            });
+            if (relatedMirrorToken) {
+                op.extra = {
+                    ...extra,
+                    associatedTokenId: relatedMirrorToken.token_id,
+                };
+            }
+        }
+        if (!coinOperationsByHash[op.hash]) {
+            coinOperationsByHash[op.hash] = [];
+        }
+        op.subOperations = [];
+        coinOperationsByHash[op.hash].push(op);
+    });
+    // loop through token operations to potentially copy them as a child operation of a coin operation
+    for (const tokenOperation of preparedTokenOperations) {
+        const { token } = decodeTokenAccountId(tokenOperation.accountId);
+        if (!token)
+            continue;
+        let mainOperations = coinOperationsByHash[tokenOperation.hash];
+        if (!mainOperations?.length) {
+            const noneOperation = makeCoinOperationForOrphanChildOperation(tokenOperation);
+            mainOperations = [noneOperation];
+            preparedCoinOperations.push(noneOperation);
+        }
+        // ugly loop in loop but in theory, this can only be a 2 elements array maximum in the case of a self send
+        for (const mainOperation of mainOperations) {
+            mainOperation.subOperations.push(tokenOperation);
+        }
+    }
+    return preparedCoinOperations;
+};
+/**
+ * List of properties of a sub account that can be updated when 2 "identical" accounts are found
+ */
+const updatableSubAccountProperties = [
+    { name: "balance", isOps: false },
+    { name: "spendableBalance", isOps: false },
+    { name: "balanceHistoryCache", isOps: false },
+    { name: "operations", isOps: true },
+    { name: "pendingOperations", isOps: true },
+];
+/**
+ * In charge of smartly merging sub accounts while maintaining references as much as possible
+ */
+export const mergeSubAccounts = (initialAccount, newSubAccounts) => {
+    const oldSubAccounts = initialAccount?.subAccounts;
+    if (!oldSubAccounts) {
+        return newSubAccounts;
+    }
+    // map of already existing sub accounts by id
+    const oldSubAccountsById = {};
+    for (const oldSubAccount of oldSubAccounts) {
+        oldSubAccountsById[oldSubAccount.id] = oldSubAccount;
+    }
+    // looping through new sub accounts to compare them with already existing ones
+    // already existing will be updated if necessary (see `updatableSubAccountProperties`)
+    // new sub accounts will be added/pushed after already existing
+    const newSubAccountsToAdd = [];
+    for (const newSubAccount of newSubAccounts) {
+        const duplicatedAccount = oldSubAccountsById[newSubAccount.id];
+        if (!duplicatedAccount) {
+            newSubAccountsToAdd.push(newSubAccount);
+            continue;
+        }
+        const updates = {};
+        for (const { name, isOps } of updatableSubAccountProperties) {
+            if (!isOps) {
+                if (newSubAccount[name] !== duplicatedAccount[name]) {
+                    // @ts-expect-error - TypeScript assumes all possible types could be assigned here
+                    updates[name] = newSubAccount[name];
+                }
+            }
+            else {
+                updates[name] = mergeOps(duplicatedAccount[name], newSubAccount[name]);
+            }
+        }
+        // update the operationsCount in case the mergeOps changed it
+        updates.operationsCount =
+            updates.operations?.length || duplicatedAccount?.operations?.length || 0;
+        // modify the map with the updated sub account with a new ref
+        oldSubAccountsById[newSubAccount.id] = {
+            ...duplicatedAccount,
+            ...updates,
+        };
+    }
+    const updatedSubAccounts = Object.values(oldSubAccountsById);
+    return [...updatedSubAccounts, ...newSubAccountsToAdd];
+};
+export const applyPendingExtras = (existing, pending) => {
+    const pendingOperationsByHash = new Map(pending.map(op => [op.hash, op]));
+    return existing.map(op => {
+        const pendingOp = pendingOperationsByHash.get(op.hash);
+        if (!pendingOp)
+            return op;
+        if (!isValidExtra(op.extra))
+            return op;
+        if (!isValidExtra(pendingOp.extra))
+            return op;
+        return {
+            ...op,
+            extra: {
+                ...pendingOp.extra,
+                ...op.extra,
+            },
+        };
+    });
+};
 export function patchOperationWithExtra(operation, extra) {
     return {
         ...operation,
@@ -49,4 +318,15 @@ export function patchOperationWithExtra(operation, extra) {
         nftOperations: (operation.nftOperations ?? []).map(op => ({ ...op, extra })),
     };
 }
+export const checkAccountTokenAssociationStatus = makeLRUCache(async (accountId, tokenId) => {
+    const mirrorAccount = await getAccount(accountId);
+    // auto association is enabled
+    if (mirrorAccount.max_automatic_token_associations === -1) {
+        return true;
+    }
+    const isTokenAssociated = mirrorAccount.balance.tokens.some(token => {
+        return token.token_id === tokenId;
+    });
+    return isTokenAssociated;
+}, (accountId, tokenId) => `${accountId}-${tokenId}`, seconds(30));
 //# sourceMappingURL=utils.js.map

package/lib-es/bridge/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/bridge/utils.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,cAAc,CAAC;AAErC,OAAO,MAAM,MAAM,wCAAwC,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAgB;IACrD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;YACpC;gBACE,IAAI,EAAE,OAAO,CAAC,QAAQ;gBACtB,EAAE,EAAE,uBAAuB,CAAC,KAAK,CAAC;gBAClC,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB;SACF,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACZ,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC;iBACxB,SAAS,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;iBACjC,YAAY,CAAC,SAAS,CAAC,UAAU,CAAC;iBAClC,YAAY,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QACD,oCAAoC;IACtC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,sDAAsD;IACtD,oEAAoE;IACpE,OAAO,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC,CAAC,gCAAgC;AACvG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EACpC,OAAO,EACP,WAAW,GAIZ;IAIC,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY;QACrC,CAAC,CAAC,MAAM,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC;QACzC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;IAEvB,OAAO;QACL,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,8EAA8E;IAC9E,uDAAuD;IACvD,qDAAqD;IAErD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAAoB,EACpB,KAA2B;IAE3B,OAAO;QACL,GAAG,SAAS;QACZ,KAAK;QACL,aAAa,EAAE,CAAC,SAAS,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,aAAa,EAAE,CAAC,SAAS,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;KAC7E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/bridge/utils.ts"],"names":[],"mappings":"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"}

package/lib-es/constants.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Internal types used to distinguish custom Hedera transaction behaviors.
+ * These can be stored in transaction.properties.name and used to route specific preparation logic.
+ */
+export declare const HEDERA_TRANSACTION_KINDS: {
+    readonly TokenAssociate: {
+        readonly name: "tokenAssociate";
+    };
+};
+/**
+ * Enum representing the supported Hedera operation types for fee estimation
+ */
+export declare enum HEDERA_OPERATION_TYPES {
+    CryptoTransfer = "CryptoTransfer",
+    TokenTransfer = "TokenTransfer",
+    TokenAssociate = "TokenAssociate"
+}
+/**
+ * https://docs.hedera.com/hedera/networks/mainnet/fees
+ *
+ * These are Hedera's estimated fee costs in USD, scaled to tinybars (1 HBAR = 10^8 tinybars),
+ * so they can be converted into actual HBAR amounts based on current USD/crypto rates.
+ *
+ * Used in fee estimation logic (getEstimatedFees function) to determine whether an account
+ * has sufficient balance to cover the cost of a transaction (e.g. token association).
+ */
+export declare const BASE_USD_FEE_BY_OPERATION_TYPE: {
+    readonly CryptoTransfer: number;
+    readonly TokenTransfer: number;
+    readonly TokenAssociate: number;
+};
+//# sourceMappingURL=constants.d.ts.map

package/lib-es/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;CAI0C,CAAC;AAEhF;;GAEG;AACH,oBAAY,sBAAsB;IAChC,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;CAClC;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B;;;;CAIgB,CAAC"}

package/lib-es/constants.js

@@ -0,0 +1,34 @@
+/**
+ * Internal types used to distinguish custom Hedera transaction behaviors.
+ * These can be stored in transaction.properties.name and used to route specific preparation logic.
+ */
+export const HEDERA_TRANSACTION_KINDS = {
+    TokenAssociate: {
+        name: "tokenAssociate",
+    },
+};
+/**
+ * Enum representing the supported Hedera operation types for fee estimation
+ */
+export var HEDERA_OPERATION_TYPES;
+(function (HEDERA_OPERATION_TYPES) {
+    HEDERA_OPERATION_TYPES["CryptoTransfer"] = "CryptoTransfer";
+    HEDERA_OPERATION_TYPES["TokenTransfer"] = "TokenTransfer";
+    HEDERA_OPERATION_TYPES["TokenAssociate"] = "TokenAssociate";
+})(HEDERA_OPERATION_TYPES || (HEDERA_OPERATION_TYPES = {}));
+const TINYBAR_SCALE = 8;
+/**
+ * https://docs.hedera.com/hedera/networks/mainnet/fees
+ *
+ * These are Hedera's estimated fee costs in USD, scaled to tinybars (1 HBAR = 10^8 tinybars),
+ * so they can be converted into actual HBAR amounts based on current USD/crypto rates.
+ *
+ * Used in fee estimation logic (getEstimatedFees function) to determine whether an account
+ * has sufficient balance to cover the cost of a transaction (e.g. token association).
+ */
+export const BASE_USD_FEE_BY_OPERATION_TYPE = {
+    [HEDERA_OPERATION_TYPES.CryptoTransfer]: 0.0001 * 10 ** TINYBAR_SCALE,
+    [HEDERA_OPERATION_TYPES.TokenTransfer]: 0.001 * 10 ** TINYBAR_SCALE,
+    [HEDERA_OPERATION_TYPES.TokenAssociate]: 0.05 * 10 ** TINYBAR_SCALE,
+};
+//# sourceMappingURL=constants.js.map

package/lib-es/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,cAAc,EAAE;QACd,IAAI,EAAE,gBAAgB;KACvB;CAC4E,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAN,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,2DAAiC,CAAA;IACjC,yDAA+B,CAAA;IAC/B,2DAAiC,CAAA;AACnC,CAAC,EAJW,sBAAsB,KAAtB,sBAAsB,QAIjC;AAED,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,CAAC,sBAAsB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,EAAE,IAAI,aAAa;IACrE,CAAC,sBAAsB,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,EAAE,IAAI,aAAa;IACnE,CAAC,sBAAsB,CAAC,cAAc,CAAC,EAAE,IAAI,GAAG,EAAE,IAAI,aAAa;CACV,CAAC"}

package/lib-es/deviceTransactionConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deviceTransactionConfig.d.ts","sourceRoot":"","sources":["../src/deviceTransactionConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EAAE,4BAA4B,IAAI,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAE1H,iBAAS,0BAA0B,CAAC,EAClC,WAAW,EACX,MAAM,EAAE,EAAE,aAAa,EAAE,GAC1B,EAAE;IACD,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,iBAAiB,CAAC;CAC3B,GAAG,KAAK,CAAC,sBAAsB,CAAC,CAsChC;AAED,eAAe,0BAA0B,CAAC"}
+{"version":3,"file":"deviceTransactionConfig.d.ts","sourceRoot":"","sources":["../src/deviceTransactionConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EAAE,4BAA4B,IAAI,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAG1H,iBAAS,0BAA0B,CAAC,EAClC,WAAW,EACX,MAAM,EAAE,EAAE,aAAa,EAAE,GAC1B,EAAE;IACD,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,iBAAiB,CAAC;CAC3B,GAAG,KAAK,CAAC,sBAAsB,CAAC,CAsChC;AAED,eAAe,0BAA0B,CAAC"}

package/lib-es/deviceTransactionConfig.js

@@ -1,23 +1,25 @@
+import { isTokenAssociateTransaction } from "./logic";
 function getDeviceTransactionConfig({ transaction, status: { estimatedFees }, }) {
     const fields = [];
-    if (transaction.useAllAmount) {
-        fields.push({
-            type: "text",
-            label: "Method",
-            value: "Transfer All",
-        });
-    }
-    else {
+    const method = (() => {
+        if (isTokenAssociateTransaction(transaction))
+            return "Associate Token";
+        else if (transaction.useAllAmount)
+            return "Transfer All";
+        else
+            return "Transfer";
+    })();
+    fields.push({
+        type: "text",
+        label: "Method",
+        value: method,
+    });
+    if (!isTokenAssociateTransaction(transaction)) {
         fields.push({
-            type: "text",
-            label: "Method",
-            value: "Transfer",
+            type: "amount",
+            label: "Amount",
         });
     }
-    fields.push({
-        type: "amount",
-        label: "Amount",
-    });
     if (!estimatedFees.isZero()) {
         fields.push({
             type: "fees",

package/lib-es/deviceTransactionConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"deviceTransactionConfig.js","sourceRoot":"","sources":["../src/deviceTransactionConfig.ts"],"names":[],"mappings":"AAIA,SAAS,0BAA0B,CAAC,EAClC,WAAW,EACX,MAAM,EAAE,EAAE,aAAa,EAAE,GAM1B;IACC,MAAM,MAAM,GAAkC,EAAE,CAAC;IAEjD,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,cAAc;SACtB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;IAEH,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;IACL,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,WAAW,CAAC,IAAI;SACxB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,eAAe,0BAA0B,CAAC"}
+{"version":3,"file":"deviceTransactionConfig.js","sourceRoot":"","sources":["../src/deviceTransactionConfig.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAEtD,SAAS,0BAA0B,CAAC,EAClC,WAAW,EACX,MAAM,EAAE,EAAE,aAAa,EAAE,GAM1B;IACC,MAAM,MAAM,GAAkC,EAAE,CAAC;IAEjD,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;QACnB,IAAI,2BAA2B,CAAC,WAAW,CAAC;YAAE,OAAO,iBAAiB,CAAC;aAClE,IAAI,WAAW,CAAC,YAAY;YAAE,OAAO,cAAc,CAAC;;YACpD,OAAO,UAAU,CAAC;IACzB,CAAC,CAAC,EAAE,CAAC;IAEL,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,MAAM;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,2BAA2B,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;IACL,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,WAAW,CAAC,IAAI;SACxB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,eAAe,0BAA0B,CAAC"}

package/lib-es/logic.d.ts

@@ -1,5 +1,11 @@
-import { ExplorerView } from "@ledgerhq/types-cryptoassets";
-import { Operation } from "@ledgerhq/types-live";
+import type { ExplorerView, TokenCurrency } from "@ledgerhq/types-cryptoassets";
+import type { AccountLike, Operation } from "@ledgerhq/types-live";
+import type { HederaOperationExtra, Transaction, TransactionStatus } from "./types";
 declare const getTransactionExplorer: (explorerView: ExplorerView | null | undefined, operation: Operation) => string | undefined;
-export { getTransactionExplorer };
+declare const isTokenAssociateTransaction: (tx: Transaction) => tx is Required<Transaction>;
+declare const isAutoTokenAssociationEnabled: (account: AccountLike) => boolean;
+declare const isTokenAssociationRequired: (account: AccountLike, token: TokenCurrency | null | undefined) => boolean;
+declare const isValidExtra: (extra: unknown) => extra is HederaOperationExtra;
+declare const sendRecipientCanNext: (status: TransactionStatus) => boolean;
+export { sendRecipientCanNext, getTransactionExplorer, isValidExtra, isTokenAssociateTransaction, isTokenAssociationRequired, isAutoTokenAssociationEnabled, };
 //# sourceMappingURL=logic.d.ts.map

package/lib-es/logic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logic.d.ts","sourceRoot":"","sources":["../src/logic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAIjD,QAAA,MAAM,sBAAsB,iBACZ,YAAY,GAAG,IAAI,GAAG,SAAS,aAClC,SAAS,KACnB,MAAM,GAAG,SAIX,CAAC;AAEF,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"logic.d.ts","sourceRoot":"","sources":["../src/logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,KAAK,EAEV,oBAAoB,EAEpB,WAAW,EACX,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,QAAA,MAAM,sBAAsB,iBACZ,YAAY,GAAG,IAAI,GAAG,SAAS,aAClC,SAAS,KACnB,MAAM,GAAG,SAOX,CAAC;AAEF,QAAA,MAAM,2BAA2B,OAC3B,WAAW,gCAGhB,CAAC;AAEF,QAAA,MAAM,6BAA6B,YAAa,WAAW,YAI1D,CAAC;AAEF,QAAA,MAAM,0BAA0B,YACrB,WAAW,SACb,aAAa,GAAG,IAAI,GAAG,SAAS,YAMxC,CAAC;AAEF,QAAA,MAAM,YAAY,UAAW,OAAO,kCAEnC,CAAC;AAKF,QAAA,MAAM,oBAAoB,WAAY,iBAAiB,YAItD,CAAC;AAEF,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,GAC9B,CAAC"}

package/lib-es/logic.js

@@ -1,6 +1,29 @@
+import { HEDERA_TRANSACTION_KINDS } from "./constants";
 const getTransactionExplorer = (explorerView, operation) => {
-    const extra = operation.extra;
-    return explorerView?.tx?.replace("$hash", extra.consensusTimestamp ?? extra.transactionId ?? "0");
+    const extra = isValidExtra(operation.extra) ? operation.extra : null;
+    return explorerView?.tx?.replace("$hash", extra?.consensusTimestamp ?? extra?.transactionId ?? "0");
 };
-export { getTransactionExplorer };
+const isTokenAssociateTransaction = (tx) => {
+    return tx.properties?.name === HEDERA_TRANSACTION_KINDS.TokenAssociate.name;
+};
+const isAutoTokenAssociationEnabled = (account) => {
+    const hederaAccount = "hederaResources" in account ? account : null;
+    return hederaAccount?.hederaResources?.isAutoTokenAssociationEnabled ?? false;
+};
+const isTokenAssociationRequired = (account, token) => {
+    const subAccounts = !!account && "subAccounts" in account ? account.subAccounts ?? [] : [];
+    const isTokenAssociated = subAccounts.some(item => item.token.id === token?.id);
+    return !!token && !isTokenAssociated && !isAutoTokenAssociationEnabled(account);
+};
+const isValidExtra = (extra) => {
+    return !!extra && typeof extra === "object" && !Array.isArray(extra);
+};
+// disables the "Continue" button in the Send modal's Recipient step during token transfers if:
+// - the recipient is not associated with the token
+// - the association status can't be verified
+const sendRecipientCanNext = (status) => {
+    const { missingAssociation, unverifiedAssociation } = status.warnings;
+    return !missingAssociation && !unverifiedAssociation;
+};
+export { sendRecipientCanNext, getTransactionExplorer, isValidExtra, isTokenAssociateTransaction, isTokenAssociationRequired, isAutoTokenAssociationEnabled, };
 //# sourceMappingURL=logic.js.map

package/lib-es/logic.js.map

@@ -1 +1 @@
-{"version":3,"file":"logic.js","sourceRoot":"","sources":["../src/logic.ts"],"names":[],"mappings":"AAKA,MAAM,sBAAsB,GAAG,CAC7B,YAA6C,EAC7C,SAAoB,EACA,EAAE;IACtB,MAAM,KAAK,GAAG,SAAS,CAAC,KAA6B,CAAC;IAEtD,OAAO,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,kBAAkB,IAAI,KAAK,CAAC,aAAa,IAAI,GAAG,CAAC,CAAC;AACpG,CAAC,CAAC;AAEF,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"logic.js","sourceRoot":"","sources":["../src/logic.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AASvD,MAAM,sBAAsB,GAAG,CAC7B,YAA6C,EAC7C,SAAoB,EACA,EAAE;IACtB,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAErE,OAAO,YAAY,EAAE,EAAE,EAAE,OAAO,CAC9B,OAAO,EACP,KAAK,EAAE,kBAAkB,IAAI,KAAK,EAAE,aAAa,IAAI,GAAG,CACzD,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,2BAA2B,GAAG,CAClC,EAAe,EACiE,EAAE;IAClF,OAAO,EAAE,CAAC,UAAU,EAAE,IAAI,KAAK,wBAAwB,CAAC,cAAc,CAAC,IAAI,CAAC;AAC9E,CAAC,CAAC;AAEF,MAAM,6BAA6B,GAAG,CAAC,OAAoB,EAAE,EAAE;IAC7D,MAAM,aAAa,GAAG,iBAAiB,IAAI,OAAO,CAAC,CAAC,CAAE,OAAyB,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvF,OAAO,aAAa,EAAE,eAAe,EAAE,6BAA6B,IAAI,KAAK,CAAC;AAChF,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CACjC,OAAoB,EACpB,KAAuC,EACvC,EAAE;IACF,MAAM,WAAW,GAAG,CAAC,CAAC,OAAO,IAAI,aAAa,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,MAAM,iBAAiB,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,EAAE,EAAE,CAAC,CAAC;IAEhF,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,iBAAiB,IAAI,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC;AAClF,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,KAAc,EAAiC,EAAE;IACrE,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC,CAAC;AAEF,+FAA+F;AAC/F,mDAAmD;AACnD,6CAA6C;AAC7C,MAAM,oBAAoB,GAAG,CAAC,MAAyB,EAAE,EAAE;IACzD,MAAM,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;IAEtE,OAAO,CAAC,kBAAkB,IAAI,CAAC,qBAAqB,CAAC;AACvD,CAAC,CAAC;AAEF,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,GAC9B,CAAC"}