@orb-labs/orby-core 0.0.24 → 0.0.26

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ### Unreleased
 
+### 0.0.25
+
+- updating variable name for getOperationsToTransferToken
+- removing default array for gas token source
+
+### 0.0.25
+
+- adding nativeCurrency field to blockchain
+- exposing currency related util functions
+
 ### 0.0.24
 
 - fetching blockchain list earlier

package/dist/cjs/actions/account_cluster.d.ts

@@ -28,5 +28,5 @@ export declare class AccountClusterActions extends LibraryRequest {
     }>;
     getPortfolioOverview(accountClusterId: string): Promise<FungibleTokenOverview>;
     getFungibleTokenPortfolio(accountClusterId: string): Promise<StandardizedBalance[]>;
-    getFungibleTokenBalances(accountClusterId: string, offset?: number, limit?: number, chainId?: bigint, tokensToOmit?: string[]): Promise<StandardizedBalance[]>;
+    getFungibleTokenBalances(accountClusterId: string, offset?: number, limit?: number, chainId?: bigint, tokensToOmit?: string[], standardizedTokenIds?: string[]): Promise<StandardizedBalance[]>;
 }

package/dist/cjs/actions/account_cluster.js

@@ -197,7 +197,7 @@ class AccountClusterActions extends library_request_js_1.LibraryRequest {
         }
         return (0, action_helpers_js_1.extractStandardizedBalances)(fungibleTokenBalances);
     }
-    async getFungibleTokenBalances(accountClusterId, offset, limit, chainId, tokensToOmit) {
+    async getFungibleTokenBalances(accountClusterId, offset, limit, chainId, tokensToOmit, standardizedTokenIds) {
         const orbyChainId = await this.getOrbyChainId(chainId);
         const { fungibleTokenBalances, code, message } = await this.sendRequest("orby_getFungibleTokenBalances", [
             {
@@ -206,6 +206,7 @@ class AccountClusterActions extends library_request_js_1.LibraryRequest {
                 limit,
                 chainId: orbyChainId,
                 tokensToOmit,
+                standardizedTokenIds,
             },
         ]);
         if (code && message) {

package/dist/cjs/actions/operation.d.ts

@@ -37,7 +37,7 @@ export declare class OperationActions extends LibraryRequest {
     estimateFiatCostToSignTypedData(data: string): Promise<CurrencyAmount>;
     getOperationsToTransferToken(accountClusterId: string, standardizedTokenId: string, amount: bigint, recipient: {
         chainId: bigint;
-        recipientAddress: string;
+        address: string;
     }, gasToken?: {
         standardizedTokenId: string;
         tokenSources?: {

package/dist/cjs/actions/operation.js

@@ -21,7 +21,7 @@ class OperationActions extends library_request_js_1.LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const operationSet = await this.sendRequest("orby_getOperationsToExecuteTransaction", [
@@ -42,7 +42,7 @@ class OperationActions extends library_request_js_1.LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const operationSet = await this.sendRequest("orby_getOperationsToSignTypedData", [
@@ -61,7 +61,7 @@ class OperationActions extends library_request_js_1.LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const operationSet = await this.sendRequest("orby_getOperationsToSignTransactionOrSignTypedData", [
@@ -157,12 +157,12 @@ class OperationActions extends library_request_js_1.LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const formattedRecepient = {
             chainId: await this.getOrbyChainId(recipient.chainId),
-            recipientAddress: recipient.recipientAddress,
+            address: recipient.address,
         };
         const operationSet = await this.sendRequest("orby_getOperationsToTransferToken", [
             {
@@ -182,7 +182,7 @@ class OperationActions extends library_request_js_1.LibraryRequest {
                 tokenSources: await Promise.all(input.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const formattedOutput = output
@@ -202,7 +202,7 @@ class OperationActions extends library_request_js_1.LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const operationSet = await this.sendRequest("orby_getOperationsToSwap", [
@@ -223,7 +223,7 @@ class OperationActions extends library_request_js_1.LibraryRequest {
                 tokenSources: await Promise.all(input.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const formattedOutput = output
@@ -264,7 +264,7 @@ class OperationActions extends library_request_js_1.LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const operationSet = await this.sendRequest("orby_getOperationsToBridge", [

package/dist/cjs/constants.d.ts

@@ -1,5 +1,9 @@
 import { Currency } from "./entities/financial/currency.js";
 import { ChainConfigs } from "./types.js";
 export declare const Big: any;
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export declare const ONE_ADDRESS = "0x0000000000000000000000000000000000000001";
+export declare const TWO_ADDRESS = "0x0000000000000000000000000000000000000002";
+export declare const NATIVE_TOKEN_ADDRESS = "0x0000000000000000000000000000000000000000";
 export declare const CHAIN_CONFIGS: Record<number, ChainConfigs>;
 export declare const FIAT_CURRENCY: Currency;

package/dist/cjs/constants.js

@@ -3,10 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FIAT_CURRENCY = exports.CHAIN_CONFIGS = exports.Big = void 0;
+exports.FIAT_CURRENCY = exports.CHAIN_CONFIGS = exports.NATIVE_TOKEN_ADDRESS = exports.TWO_ADDRESS = exports.ONE_ADDRESS = exports.ZERO_ADDRESS = exports.Big = void 0;
 const toformat_1 = __importDefault(require("toformat"));
 const big_js_1 = __importDefault(require("big.js"));
 const currency_js_1 = require("./entities/financial/currency.js");
 exports.Big = (0, toformat_1.default)(big_js_1.default);
+exports.ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+exports.ONE_ADDRESS = "0x0000000000000000000000000000000000000001";
+exports.TWO_ADDRESS = "0x0000000000000000000000000000000000000002";
+exports.NATIVE_TOKEN_ADDRESS = exports.ZERO_ADDRESS;
 exports.CHAIN_CONFIGS = {};
 exports.FIAT_CURRENCY = new currency_js_1.Currency(6, "USD", "US Dollar", undefined, false, false);

package/dist/cjs/entities/financial/fungible_token_amount.d.ts

@@ -20,6 +20,12 @@ export declare class FungibleTokenAmount extends Fraction {
      */
     static fromFractionalAmount(fungibleToken: FungibleToken, numerator: BigintIsh, denominator: BigintIsh, amountInFiatCurrency?: CurrencyAmount): FungibleTokenAmount;
     static toFungibleTokenAmount(amount?: any): FungibleTokenAmount;
+    /**
+     * Used to calculate the amount of token B that one can get for a given amount of token A.
+     * aPrice is the unit price of token A in fiat currency
+     * bPrice is the unit price of token B in fiat currency
+     */
+    static exchange(a: FungibleTokenAmount, aPrice: CurrencyAmount, bPrice: CurrencyAmount, b: FungibleToken): FungibleTokenAmount;
     protected constructor(fungibleToken: FungibleToken, numerator: BigintIsh | bigint, denominator?: BigintIsh | bigint, amountInFiatCurrency?: CurrencyAmount);
     equals(other: FungibleTokenAmount): boolean;
     add(other: FungibleTokenAmount): FungibleTokenAmount;

package/dist/cjs/entities/financial/fungible_token_amount.js

@@ -37,6 +37,20 @@ class FungibleTokenAmount extends sdk_core_1.Fraction {
         const amountInFiatCurrency = currency_amount_js_1.CurrencyAmount.toCurrencyAmount(amount.amountInFiatCurrency);
         return FungibleTokenAmount.fromRawAmount(fungible_token_js_1.FungibleToken.toFungibleToken(amount.token), amount.value, amountInFiatCurrency);
     }
+    /**
+     * Used to calculate the amount of token B that one can get for a given amount of token A.
+     * aPrice is the unit price of token A in fiat currency
+     * bPrice is the unit price of token B in fiat currency
+     */
+    static exchange(a, aPrice, bPrice, b) {
+        (0, tiny_invariant_1.default)(aPrice.currency.equals(bPrice.currency), "CURRENCY");
+        const ratio = aPrice.divide(bPrice);
+        const numberOfB = ratio.multiply(a);
+        const numerator = jsbi_1.default.multiply(numberOfB.numerator, jsbi_1.default.BigInt(10 ** b.decimals));
+        const denominator = jsbi_1.default.multiply(numberOfB.denominator, a.decimalScale);
+        const result = FungibleTokenAmount.fromFractionalAmount(b, numerator, denominator);
+        return result;
+    }
     constructor(fungibleToken, numerator, denominator, amountInFiatCurrency) {
         super(numerator.toString(), denominator?.toString());
         (0, tiny_invariant_1.default)(jsbi_1.default.lessThanOrEqual(this.quotient, sdk_core_1.MaxUint256), "AMOUNT"); // TODO(imti): fix this

package/dist/cjs/interfaces/account_cluster.d.ts

@@ -26,5 +26,5 @@ export interface IAccountClusterActions {
     }>;
     getPortfolioOverview(accountClusterId: string): Promise<FungibleTokenOverview>;
     getFungibleTokenPortfolio(accountClusterId: string): Promise<StandardizedBalance[]>;
-    getFungibleTokenBalances(accountClusterId: string, offset?: number, limit?: number, chainId?: bigint, tokensToOmit?: string[]): Promise<StandardizedBalance[]>;
+    getFungibleTokenBalances(accountClusterId: string, offset?: number, limit?: number, chainId?: bigint, tokensToOmit?: string[], standardizedTokenIds?: string[]): Promise<StandardizedBalance[]>;
 }

package/dist/cjs/interfaces/operation.d.ts

@@ -35,7 +35,7 @@ export interface IOperationActions {
     estimateFiatCostToSignTypedData(data: string): Promise<CurrencyAmount>;
     getOperationsToTransferToken(accountClusterId: string, standardizedTokenId: string, amount: bigint, recipient: {
         chainId: bigint;
-        recipientAddress: string;
+        address: string;
     }, gasToken?: {
         standardizedTokenId: string;
         tokenSources?: {

package/dist/cjs/types.d.ts

@@ -168,6 +168,7 @@ export type ChainConfigs = {
     logoUrl: string;
     name: string;
     genesisBlockHash?: string;
+    nativeCurrency: Currency;
 };
 export type VirtualNodeRpcUrlForSupportedChain = {
     chainId: string;

package/dist/cjs/utils/utils.d.ts

@@ -1,4 +1,8 @@
 import { VMType } from "../enums.js";
+import { Currency } from "../entities/financial/currency.js";
+import { FungibleToken } from "../entities/financial/fungible_token.js";
+import { FungibleTokenAmount } from "../entities/financial/fungible_token_amount.js";
+import { CurrencyAmount } from "../entities/financial/currency_amount.js";
 export declare const initializeBlockchainInformation: (orbyUrl: string) => Promise<void>;
 export declare const getChainIdFromOrbyChainId: (value: string) => bigint | undefined;
 export declare const getVirtualEnvironment: (id: bigint) => Promise<VMType>;
@@ -6,3 +10,7 @@ export declare const hasError: (data: any) => {
     code: number;
     message: string;
 };
+export declare const getNativeCurrency: (chainId: bigint) => Currency;
+export declare const getNativeFungibleToken: (chainId: bigint) => FungibleToken;
+export declare const createNativeFungibleTokenAmount: (value: bigint, chainId: bigint) => FungibleTokenAmount;
+export declare const createNativeCurrencyAmount: (value: bigint, chainId: bigint) => CurrencyAmount;

package/dist/cjs/utils/utils.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasError = exports.getVirtualEnvironment = exports.getChainIdFromOrbyChainId = exports.initializeBlockchainInformation = void 0;
+exports.createNativeCurrencyAmount = exports.createNativeFungibleTokenAmount = exports.getNativeFungibleToken = exports.getNativeCurrency = exports.hasError = exports.getVirtualEnvironment = exports.getChainIdFromOrbyChainId = exports.initializeBlockchainInformation = void 0;
 const constants_js_1 = require("../constants.js");
 const validateAndParseAddress_js_1 = require("./validateAndParseAddress.js");
+const currency_js_1 = require("../entities/financial/currency.js");
+const fungible_token_js_1 = require("../entities/financial/fungible_token.js");
+const fungible_token_amount_js_1 = require("../entities/financial/fungible_token_amount.js");
+const currency_amount_js_1 = require("../entities/financial/currency_amount.js");
 const initializeBlockchainInformation = async (orbyUrl) => {
     const response = await fetch(orbyUrl, {
         method: "POST",
@@ -27,6 +31,7 @@ const initializeBlockchainInformation = async (orbyUrl) => {
             constants_js_1.CHAIN_CONFIGS[Number(chainId)] = {
                 ...blockchainInfo,
                 chainId: chainId,
+                nativeCurrency: currency_js_1.Currency.toCurrency(blockchainInfo?.nativeCurrency),
             };
         }
     });
@@ -63,3 +68,24 @@ const hasError = (data) => {
     return undefined;
 };
 exports.hasError = hasError;
+const getNativeCurrency = (chainId) => {
+    const currency = constants_js_1.CHAIN_CONFIGS[Number(chainId)]?.nativeCurrency;
+    return new currency_js_1.Currency(currency.decimals, currency.symbol, currency.name, undefined, false, false);
+};
+exports.getNativeCurrency = getNativeCurrency;
+const getNativeFungibleToken = (chainId) => {
+    const currency = (0, exports.getNativeCurrency)(chainId);
+    return new fungible_token_js_1.FungibleToken(chainId, constants_js_1.NATIVE_TOKEN_ADDRESS, currency.decimals, currency.symbol, currency.name, false, true, currency.coinGeckoId);
+};
+exports.getNativeFungibleToken = getNativeFungibleToken;
+const createNativeFungibleTokenAmount = (value, chainId) => {
+    const currency = (0, exports.getNativeCurrency)(chainId);
+    const fungibleToken = new fungible_token_js_1.FungibleToken(chainId, constants_js_1.NATIVE_TOKEN_ADDRESS, currency.decimals, currency.symbol, currency.name, false, true);
+    return fungible_token_amount_js_1.FungibleTokenAmount.fromRawAmount(fungibleToken, value);
+};
+exports.createNativeFungibleTokenAmount = createNativeFungibleTokenAmount;
+const createNativeCurrencyAmount = (value, chainId) => {
+    const currency = (0, exports.getNativeCurrency)(chainId);
+    return currency_amount_js_1.CurrencyAmount.fromRawAmount(currency, value);
+};
+exports.createNativeCurrencyAmount = createNativeCurrencyAmount;

package/dist/esm/actions/account_cluster.d.ts

@@ -28,5 +28,5 @@ export declare class AccountClusterActions extends LibraryRequest {
     }>;
     getPortfolioOverview(accountClusterId: string): Promise<FungibleTokenOverview>;
     getFungibleTokenPortfolio(accountClusterId: string): Promise<StandardizedBalance[]>;
-    getFungibleTokenBalances(accountClusterId: string, offset?: number, limit?: number, chainId?: bigint, tokensToOmit?: string[]): Promise<StandardizedBalance[]>;
+    getFungibleTokenBalances(accountClusterId: string, offset?: number, limit?: number, chainId?: bigint, tokensToOmit?: string[], standardizedTokenIds?: string[]): Promise<StandardizedBalance[]>;
 }

package/dist/esm/actions/account_cluster.js

@@ -194,7 +194,7 @@ export class AccountClusterActions extends LibraryRequest {
         }
         return extractStandardizedBalances(fungibleTokenBalances);
     }
-    async getFungibleTokenBalances(accountClusterId, offset, limit, chainId, tokensToOmit) {
+    async getFungibleTokenBalances(accountClusterId, offset, limit, chainId, tokensToOmit, standardizedTokenIds) {
         const orbyChainId = await this.getOrbyChainId(chainId);
         const { fungibleTokenBalances, code, message } = await this.sendRequest("orby_getFungibleTokenBalances", [
             {
@@ -203,6 +203,7 @@ export class AccountClusterActions extends LibraryRequest {
                 limit,
                 chainId: orbyChainId,
                 tokensToOmit,
+                standardizedTokenIds,
             },
         ]);
         if (code && message) {

package/dist/esm/actions/operation.d.ts

@@ -37,7 +37,7 @@ export declare class OperationActions extends LibraryRequest {
     estimateFiatCostToSignTypedData(data: string): Promise<CurrencyAmount>;
     getOperationsToTransferToken(accountClusterId: string, standardizedTokenId: string, amount: bigint, recipient: {
         chainId: bigint;
-        recipientAddress: string;
+        address: string;
     }, gasToken?: {
         standardizedTokenId: string;
         tokenSources?: {

package/dist/esm/actions/operation.js

@@ -18,7 +18,7 @@ export class OperationActions extends LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const operationSet = await this.sendRequest("orby_getOperationsToExecuteTransaction", [
@@ -39,7 +39,7 @@ export class OperationActions extends LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const operationSet = await this.sendRequest("orby_getOperationsToSignTypedData", [
@@ -58,7 +58,7 @@ export class OperationActions extends LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const operationSet = await this.sendRequest("orby_getOperationsToSignTransactionOrSignTypedData", [
@@ -154,12 +154,12 @@ export class OperationActions extends LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const formattedRecepient = {
             chainId: await this.getOrbyChainId(recipient.chainId),
-            recipientAddress: recipient.recipientAddress,
+            address: recipient.address,
         };
         const operationSet = await this.sendRequest("orby_getOperationsToTransferToken", [
             {
@@ -179,7 +179,7 @@ export class OperationActions extends LibraryRequest {
                 tokenSources: await Promise.all(input.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const formattedOutput = output
@@ -199,7 +199,7 @@ export class OperationActions extends LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const operationSet = await this.sendRequest("orby_getOperationsToSwap", [
@@ -220,7 +220,7 @@ export class OperationActions extends LibraryRequest {
                 tokenSources: await Promise.all(input.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const formattedOutput = output
@@ -261,7 +261,7 @@ export class OperationActions extends LibraryRequest {
                 tokenSources: await Promise.all(gasToken.tokenSources?.map(async ({ chainId, address }) => ({
                     chainId: await this.getOrbyChainId(chainId),
                     address,
-                })) ?? []),
+                }))),
             }
             : undefined;
         const operationSet = await this.sendRequest("orby_getOperationsToBridge", [

package/dist/esm/constants.d.ts

@@ -1,5 +1,9 @@
 import { Currency } from "./entities/financial/currency.js";
 import { ChainConfigs } from "./types.js";
 export declare const Big: any;
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export declare const ONE_ADDRESS = "0x0000000000000000000000000000000000000001";
+export declare const TWO_ADDRESS = "0x0000000000000000000000000000000000000002";
+export declare const NATIVE_TOKEN_ADDRESS = "0x0000000000000000000000000000000000000000";
 export declare const CHAIN_CONFIGS: Record<number, ChainConfigs>;
 export declare const FIAT_CURRENCY: Currency;

package/dist/esm/constants.js

@@ -2,5 +2,9 @@ import toFormat from "toformat";
 import _Big from "big.js";
 import { Currency } from "./entities/financial/currency.js";
 export const Big = toFormat(_Big);
+export const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export const ONE_ADDRESS = "0x0000000000000000000000000000000000000001";
+export const TWO_ADDRESS = "0x0000000000000000000000000000000000000002";
+export const NATIVE_TOKEN_ADDRESS = ZERO_ADDRESS;
 export const CHAIN_CONFIGS = {};
 export const FIAT_CURRENCY = new Currency(6, "USD", "US Dollar", undefined, false, false);

package/dist/esm/entities/financial/fungible_token_amount.d.ts

@@ -20,6 +20,12 @@ export declare class FungibleTokenAmount extends Fraction {
      */
     static fromFractionalAmount(fungibleToken: FungibleToken, numerator: BigintIsh, denominator: BigintIsh, amountInFiatCurrency?: CurrencyAmount): FungibleTokenAmount;
     static toFungibleTokenAmount(amount?: any): FungibleTokenAmount;
+    /**
+     * Used to calculate the amount of token B that one can get for a given amount of token A.
+     * aPrice is the unit price of token A in fiat currency
+     * bPrice is the unit price of token B in fiat currency
+     */
+    static exchange(a: FungibleTokenAmount, aPrice: CurrencyAmount, bPrice: CurrencyAmount, b: FungibleToken): FungibleTokenAmount;
     protected constructor(fungibleToken: FungibleToken, numerator: BigintIsh | bigint, denominator?: BigintIsh | bigint, amountInFiatCurrency?: CurrencyAmount);
     equals(other: FungibleTokenAmount): boolean;
     add(other: FungibleTokenAmount): FungibleTokenAmount;

package/dist/esm/entities/financial/fungible_token_amount.js

@@ -31,6 +31,20 @@ export class FungibleTokenAmount extends Fraction {
         const amountInFiatCurrency = CurrencyAmount.toCurrencyAmount(amount.amountInFiatCurrency);
         return FungibleTokenAmount.fromRawAmount(FungibleToken.toFungibleToken(amount.token), amount.value, amountInFiatCurrency);
     }
+    /**
+     * Used to calculate the amount of token B that one can get for a given amount of token A.
+     * aPrice is the unit price of token A in fiat currency
+     * bPrice is the unit price of token B in fiat currency
+     */
+    static exchange(a, aPrice, bPrice, b) {
+        invariant(aPrice.currency.equals(bPrice.currency), "CURRENCY");
+        const ratio = aPrice.divide(bPrice);
+        const numberOfB = ratio.multiply(a);
+        const numerator = JSBI.multiply(numberOfB.numerator, JSBI.BigInt(10 ** b.decimals));
+        const denominator = JSBI.multiply(numberOfB.denominator, a.decimalScale);
+        const result = FungibleTokenAmount.fromFractionalAmount(b, numerator, denominator);
+        return result;
+    }
     constructor(fungibleToken, numerator, denominator, amountInFiatCurrency) {
         super(numerator.toString(), denominator?.toString());
         invariant(JSBI.lessThanOrEqual(this.quotient, MaxUint256), "AMOUNT"); // TODO(imti): fix this

package/dist/esm/interfaces/account_cluster.d.ts

@@ -26,5 +26,5 @@ export interface IAccountClusterActions {
     }>;
     getPortfolioOverview(accountClusterId: string): Promise<FungibleTokenOverview>;
     getFungibleTokenPortfolio(accountClusterId: string): Promise<StandardizedBalance[]>;
-    getFungibleTokenBalances(accountClusterId: string, offset?: number, limit?: number, chainId?: bigint, tokensToOmit?: string[]): Promise<StandardizedBalance[]>;
+    getFungibleTokenBalances(accountClusterId: string, offset?: number, limit?: number, chainId?: bigint, tokensToOmit?: string[], standardizedTokenIds?: string[]): Promise<StandardizedBalance[]>;
 }

package/dist/esm/interfaces/operation.d.ts

@@ -35,7 +35,7 @@ export interface IOperationActions {
     estimateFiatCostToSignTypedData(data: string): Promise<CurrencyAmount>;
     getOperationsToTransferToken(accountClusterId: string, standardizedTokenId: string, amount: bigint, recipient: {
         chainId: bigint;
-        recipientAddress: string;
+        address: string;
     }, gasToken?: {
         standardizedTokenId: string;
         tokenSources?: {

package/dist/esm/types.d.ts

@@ -168,6 +168,7 @@ export type ChainConfigs = {
     logoUrl: string;
     name: string;
     genesisBlockHash?: string;
+    nativeCurrency: Currency;
 };
 export type VirtualNodeRpcUrlForSupportedChain = {
     chainId: string;

package/dist/esm/utils/utils.d.ts

@@ -1,4 +1,8 @@
 import { VMType } from "../enums.js";
+import { Currency } from "../entities/financial/currency.js";
+import { FungibleToken } from "../entities/financial/fungible_token.js";
+import { FungibleTokenAmount } from "../entities/financial/fungible_token_amount.js";
+import { CurrencyAmount } from "../entities/financial/currency_amount.js";
 export declare const initializeBlockchainInformation: (orbyUrl: string) => Promise<void>;
 export declare const getChainIdFromOrbyChainId: (value: string) => bigint | undefined;
 export declare const getVirtualEnvironment: (id: bigint) => Promise<VMType>;
@@ -6,3 +10,7 @@ export declare const hasError: (data: any) => {
     code: number;
     message: string;
 };
+export declare const getNativeCurrency: (chainId: bigint) => Currency;
+export declare const getNativeFungibleToken: (chainId: bigint) => FungibleToken;
+export declare const createNativeFungibleTokenAmount: (value: bigint, chainId: bigint) => FungibleTokenAmount;
+export declare const createNativeCurrencyAmount: (value: bigint, chainId: bigint) => CurrencyAmount;

package/dist/esm/utils/utils.js

@@ -1,5 +1,9 @@
-import { CHAIN_CONFIGS } from "../constants.js";
+import { CHAIN_CONFIGS, NATIVE_TOKEN_ADDRESS } from "../constants.js";
 import { validateAndLowerCase } from "./validateAndParseAddress.js";
+import { Currency } from "../entities/financial/currency.js";
+import { FungibleToken } from "../entities/financial/fungible_token.js";
+import { FungibleTokenAmount } from "../entities/financial/fungible_token_amount.js";
+import { CurrencyAmount } from "../entities/financial/currency_amount.js";
 export const initializeBlockchainInformation = async (orbyUrl) => {
     const response = await fetch(orbyUrl, {
         method: "POST",
@@ -24,6 +28,7 @@ export const initializeBlockchainInformation = async (orbyUrl) => {
             CHAIN_CONFIGS[Number(chainId)] = {
                 ...blockchainInfo,
                 chainId: chainId,
+                nativeCurrency: Currency.toCurrency(blockchainInfo?.nativeCurrency),
             };
         }
     });
@@ -56,3 +61,20 @@ export const hasError = (data) => {
     }
     return undefined;
 };
+export const getNativeCurrency = (chainId) => {
+    const currency = CHAIN_CONFIGS[Number(chainId)]?.nativeCurrency;
+    return new Currency(currency.decimals, currency.symbol, currency.name, undefined, false, false);
+};
+export const getNativeFungibleToken = (chainId) => {
+    const currency = getNativeCurrency(chainId);
+    return new FungibleToken(chainId, NATIVE_TOKEN_ADDRESS, currency.decimals, currency.symbol, currency.name, false, true, currency.coinGeckoId);
+};
+export const createNativeFungibleTokenAmount = (value, chainId) => {
+    const currency = getNativeCurrency(chainId);
+    const fungibleToken = new FungibleToken(chainId, NATIVE_TOKEN_ADDRESS, currency.decimals, currency.symbol, currency.name, false, true);
+    return FungibleTokenAmount.fromRawAmount(fungibleToken, value);
+};
+export const createNativeCurrencyAmount = (value, chainId) => {
+    const currency = getNativeCurrency(chainId);
+    return CurrencyAmount.fromRawAmount(currency, value);
+};