@oceanprotocol/lib 1.0.0-next.9 → 1.0.0

package/dist/src/pools/Router.d.ts

@@ -2,46 +2,227 @@ import { Contract } from 'web3-eth-contract';
 import Web3 from 'web3';
 import { TransactionReceipt } from 'web3-core';
 import { AbiItem } from 'web3-utils';
-import { Operation } from '../interfaces/RouterInterface';
+import { Operation } from '../@types/Router';
 import { Config } from '../models/index.js';
+/**
+ * Provides an interface for FactoryRouter contract
+ */
 export declare class Router {
-    GASLIMIT_DEFAULT: number;
     routerAddress: string;
     RouterAbi: AbiItem | AbiItem[];
     web3: Web3;
     config: Config;
     router: Contract;
-    constructor(routerAddress: string, web3: Web3, RouterAbi?: AbiItem | AbiItem[], config?: Config);
+    /**
+     * Instantiate Router.
+     * @param {String} routerAddress
+     * @param {AbiItem | AbiItem[]} Router
+     * @param {Web3} web3
+     */
+    constructor(routerAddress: string, web3: Web3, network?: string | number, RouterAbi?: AbiItem | AbiItem[], config?: Config);
+    /**
+     * Estimate gas cost for buyDTBatch method
+     * @param {String} address
+     * @param {Operation} operations Operations objects array
+     * @return {Promise<TransactionReceipt>} Transaction receipt
+     */
     estGasBuyDTBatch(address: string, operations: Operation[]): Promise<any>;
+    /**
+     * BuyDTBatch
+     * @param {String} address
+     * @param {Operation} operations Operations objects array
+     * @return {Promise<TransactionReceipt>} Transaction receipt
+     */
     buyDTBatch(address: string, operations: Operation[]): Promise<TransactionReceipt>;
-    isOceanTokens(address: string): Promise<boolean>;
+    /** Check if a token is on approved tokens list, if true opfFee is lower in pools with that token/DT
+     * @return {Promise<boolean>} true if is on the list.
+     */
+    isApprovedToken(address: string): Promise<boolean>;
+    /** Check if an address is a side staking contract.
+     * @return {Promise<boolean>} true if is a SS contract
+     */
     isSideStaking(address: string): Promise<boolean>;
+    /** Check if an address is a Fixed Rate contract.
+     * @return {Promise<boolean>} true if is a Fixed Rate contract
+     */
     isFixedPrice(address: string): Promise<boolean>;
+    /** Get Router Owner
+     * @return {Promise<string>} Router Owner address
+     */
     getOwner(): Promise<string>;
+    /** Get NFT Factory address
+     * @return {Promise<string>} NFT Factory address
+     */
     getNFTFactory(): Promise<string>;
+    /** Check if an address is a pool template contract.
+     * @return {Promise<boolean>} true if is a Template
+     */
     isPoolTemplate(address: string): Promise<boolean>;
-    estGasAddOceanToken(address: string, tokenAddress: string, contractInstance?: Contract): Promise<any>;
-    addOceanToken(address: string, tokenAddress: string): Promise<TransactionReceipt>;
-    estGasRemoveOceanToken(address: string, tokenAddress: string, contractInstance?: Contract): Promise<any>;
-    removeOceanToken(address: string, tokenAddress: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for addApprovedToken
+     * @param {String} address
+     * @param {String} tokenAddress token address we want to add
+     * @param {Contract} routerContract optional contract instance
+     * @return {Promise<any>}
+     */
+    estGasAddApprovedToken(address: string, tokenAddress: string, contractInstance?: Contract): Promise<any>;
+    /**
+     * Add a new token to oceanTokens list, pools with baseToken in this list have NO opf Fee
+     * @param {String} address caller address
+     * @param {String} tokenAddress token address to add
+     * @return {Promise<TransactionReceipt>}
+     */
+    addApprovedToken(address: string, tokenAddress: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for removeApprovedToken
+     * @param {String} address caller address
+     * @param {String} tokenAddress token address we want to add
+     * @param {Contract} routerContract optional contract instance
+     * @return {Promise<any>}
+     */
+    estGasRemoveApprovedToken(address: string, tokenAddress: string, contractInstance?: Contract): Promise<any>;
+    /**
+     * Remove a token from oceanTokens list, pools without baseToken in this list have a opf Fee
+     * @param {String} address
+     * @param {String} tokenAddress address to remove
+     * @return {Promise<TransactionReceipt>}
+     */
+    removeApprovedToken(address: string, tokenAddress: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for addSSContract method
+     * @param {String} address
+     * @param {String} tokenAddress contract address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     estGasAddSSContract(address: string, tokenAddress: string): Promise<any>;
+    /**
+     * Add a new contract to ssContract list, after is added, can be used when deploying a new pool
+     * @param {String} address
+     * @param {String} tokenAddress contract address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     addSSContract(address: string, tokenAddress: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for removeSSContract method
+     * @param {String} address caller address
+     * @param {String} tokenAddress contract address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     estGasRemoveSSContract(address: string, tokenAddress: string): Promise<any>;
+    /**
+     * Removes a new contract from ssContract list
+     * @param {String} address caller address
+     * @param {String} tokenAddress contract address to removed
+     * @return {Promise<TransactionReceipt>}
+     */
     removeSSContract(address: string, tokenAddress: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for addFixedRateContract method
+     * @param {String} address
+     * @param {String} tokenAddress contract address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     estGasAddFixedRateContract(address: string, tokenAddress: string): Promise<any>;
+    /**
+     * Add a new contract to fixedRate list, after is added, can be used when deploying a new pool
+     * @param {String} address
+     * @param {String} tokenAddress contract address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     addFixedRateContract(address: string, tokenAddress: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for addFixedRateContract method
+     * @param {String} address
+     * @param {String} tokenAddress contract address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     estGasRemoveFixedRateContract(address: string, tokenAddress: string): Promise<any>;
+    /**
+     * Removes a contract from fixedRate list
+     * @param {String} address
+     * @param {String} tokenAddress contract address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     removeFixedRateContract(address: string, tokenAddress: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for addDispenserContract method
+     * @param {String} address
+     * @param {String} tokenAddress contract address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     estGasAddDispenserContract(address: string, tokenAddress: string): Promise<any>;
+    /**
+     * Add a new contract to dispenser list, after is added, can be used when deploying a new pool
+     * @param {String} address
+     * @param {String} tokenAddress contract address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     addDispenserContract(address: string, tokenAddress: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for addDispenserContract method
+     * @param {String} address
+     * @param {String} tokenAddress contract address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     estGasRemoveDispenserContract(address: string, tokenAddress: string): Promise<any>;
+    /**
+     * Add a new contract to dispenser list, after is added, can be used when deploying a new pool
+     * @param {String} address
+     * @param {String} tokenAddress contract address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     removeDispenserContract(address: string, tokenAddress: string): Promise<TransactionReceipt>;
+    /** Get OPF Fee per token
+     * @return {Promise<number>} OPC fee for a specific baseToken
+     */
     getOPCFee(baseToken: string): Promise<number>;
+    /** Get Current OPF Fee
+     * @return {Promise<number>} OPF fee
+     */
     getCurrentOPCFee(): Promise<number>;
+    /**
+     * Estimate gas cost for updateOPFFee method
+     * @param {String} address
+     * @param {String} newFee new OPF Fee
+     * @return {Promise<TransactionReceipt>}
+     */
     estGasUpdateOPCFee(address: string, newSwapOceanFee: number, newSwapNonOceanFee: number, newConsumeFee: number, newProviderFee: number): Promise<any>;
+    /**
+     * Add a new contract to fixedRate list, after is added, can be used when deploying a new pool
+     * @param {String} address
+     * @param {number} newSwapOceanFee Amount charged for swapping with ocean approved tokens
+     * @param {number} newSwapNonOceanFee Amount charged for swapping with non ocean approved tokens
+     * @param {number} newConsumeFee Amount charged from consumeFees
+     * @param {number} newProviderFee Amount charged for providerFees
+     * @return {Promise<TransactionReceipt>}
+     */
     updateOPCFee(address: string, newSwapOceanFee: number, newSwapNonOceanFee: number, newConsumeFee: number, newProviderFee: number): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for addPoolTemplate method
+     * @param {String} address
+     * @param {String} templateAddress template address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     estGasAddPoolTemplate(address: string, templateAddress: string): Promise<any>;
+    /**
+     * Add a new template to poolTemplates mapping, after template is added,it can be used
+     * @param {String} address
+     * @param {String} templateAddress template address to add
+     * @return {Promise<TransactionReceipt>}
+     */
     addPoolTemplate(address: string, templateAddress: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for removePoolTemplate method
+     * @param {String} address
+     * @param {String} templateAddress template address to remove
+     * @return {Promise<TransactionReceipt>}
+     */
     estGasRemovePoolTemplate(address: string, templateAddress: string): Promise<any>;
+    /**
+     * Remove template from poolTemplates mapping, after template is removed,it can be used anymore
+     * @param {String} address
+     * @param {String} templateAddress template address to remove
+     * @return {Promise<TransactionReceipt>}
+     */
     removePoolTemplate(address: string, templateAddress: string): Promise<TransactionReceipt>;
 }

package/dist/src/pools/balancer/Pool.d.ts

@@ -2,69 +2,394 @@ import Web3 from 'web3';
 import { AbiItem } from 'web3-utils/types';
 import { TransactionReceipt } from 'web3-core';
 import { Contract } from 'web3-eth-contract';
-import { Logger } from '../../utils';
-import { CurrentFees, TokenInOutMarket, AmountsInMaxFee, AmountsOutMaxFee } from '../../interfaces';
+import { CurrentFees, TokenInOutMarket, AmountsInMaxFee, AmountsOutMaxFee, PoolPriceAndFees } from '../../@types';
 import { Config } from '../../models';
+/**
+ * Provides an interface to Ocean friendly fork from Balancer BPool
+ */
 export declare class Pool {
     poolAbi: AbiItem | AbiItem[];
     web3: Web3;
-    GASLIMIT_DEFAULT: number;
-    private logger;
     private config;
-    constructor(web3: Web3, logger: Logger, poolAbi?: AbiItem | AbiItem[], config?: Config);
+    constructor(web3: Web3, network?: string | number, poolAbi?: AbiItem | AbiItem[], config?: Config);
+    amountToUnits(token: string, amount: string, tokenDecimals?: number): Promise<string>;
+    unitsToAmount(token: string, amount: string, tokenDecimals?: number): Promise<string>;
+    /**
+     * Get user shares of pool tokens
+     * @param {String} account
+     * @param {String} poolAddress
+     * @return {String}
+     */
     sharesBalance(account: string, poolAddress: string): Promise<string>;
+    /**
+     * Estimate gas cost for setSwapFee
+     * @param {String} account
+     * @param {String} tokenAddress
+     * @param {String} spender
+     * @param {String} amount
+     * @param {String} force
+     * @param {Contract} contractInstance optional contract instance
+     * @return {Promise<number>}
+     */
     estSetSwapFee(account: string, poolAddress: string, fee: string, contractInstance?: Contract): Promise<number>;
+    /**
+     * Allows controller to change the swapFee
+     * @param {String} account
+     * @param {String} poolAddress
+     * @param {String} fee swap fee (1e17 = 10 % , 1e16 = 1% , 1e15 = 0.1%, 1e14 = 0.01%)
+     */
     setSwapFee(account: string, poolAddress: string, fee: string): Promise<TransactionReceipt>;
+    /**
+     * Returns number of tokens bounded to pool
+     * @param {String} poolAddress
+     * @return {String}
+     */
     getNumTokens(poolAddress: string): Promise<string>;
+    /**
+     * Get total supply of pool shares
+     * @param {String} poolAddress
+     * @return {String}
+     */
     getPoolSharesTotalSupply(poolAddress: string): Promise<string>;
+    /**
+     * Get tokens composing this poo
+     * Returns tokens bounded to pool, before the pool is finalizedl
+     * @param {String} poolAddress
+     * @return {String[]}
+     */
     getCurrentTokens(poolAddress: string): Promise<string[]>;
+    /**
+     * Get the final tokens composing this pool
+     * Returns tokens bounded to pool, after the pool was finalized
+     * @param {String} poolAddress
+     * @return {String[]}
+     */
     getFinalTokens(poolAddress: string): Promise<string[]>;
+    /**
+     * Returns the current controller address (ssBot)
+     * @param {String} poolAddress
+     * @return {String}
+     */
     getController(poolAddress: string): Promise<string>;
+    /**
+     * Returns the current baseToken address of the pool
+     * @param {String} poolAddress
+     * @return {String}
+     */
     getBaseToken(poolAddress: string): Promise<string>;
+    /**
+     * Returns the current datatoken address
+     * @param {String} poolAddress
+     * @return {String}
+     */
     getDatatoken(poolAddress: string): Promise<string>;
+    /**
+     * Get getMarketFee
+     * @param {String} poolAddress
+     * @return {String}
+     */
+    getMarketFee(poolAddress: string): Promise<string>;
+    /**
+     * Get marketFeeCollector of this pool
+     * @param {String} poolAddress
+     * @return {String}
+     */
     getMarketFeeCollector(poolAddress: string): Promise<string>;
-    getOPCCollector(poolAddress: string): Promise<string>;
+    /**
+     * Get if a token is bounded to a pool
+     *  Returns true if token is bound
+     * @param {String} poolAddress
+     * @param {String} token  Address of the token to be checked
+     * @return {Boolean}
+     */
     isBound(poolAddress: string, token: string): Promise<boolean>;
-    getReserve(poolAddress: string, token: string): Promise<string>;
+    /**
+     * Returns the current token reserve amount
+     * @param {String} poolAddress
+     * @param {String} token  Address of the token to be checked
+     * @param {number} tokenDecimals optional number of decimals of the token
+     * @return {String}
+     */
+    getReserve(poolAddress: string, token: string, tokenDecimals?: number): Promise<string>;
+    /**
+     * Get if a pool is finalized
+     * Returns true if pool is finalized
+     * @param {String} poolAddress
+     * @return {Boolean}
+     */
     isFinalized(poolAddress: string): Promise<boolean>;
+    /**
+     *  Returns the current Liquidity Providers swap fee
+     * @param {String} poolAddress
+     * @return {String} Swap fee. To get the percentage value, substract by 100. E.g. `0.1` represents a 10% swap fee.
+     */
     getSwapFee(poolAddress: string): Promise<string>;
+    /**
+     * Returns normalized weight of a token.
+     * The combined normalized weights of all tokens will sum up to 1.
+     * (Note: the actual sum may be 1 plus or minus a few wei due to division precision loss)
+     * @param {String} poolAddress
+     * @param {String} token token to be checked
+     * @return {String}
+     */
     getNormalizedWeight(poolAddress: string, token: string): Promise<string>;
+    /**
+     *  Returns denormalized weight of a token
+     * @param {String} poolAddress
+     * @param {String} token token to be checked
+     * @return {String}
+     */
     getDenormalizedWeight(poolAddress: string, token: string): Promise<string>;
+    /**
+     * getTotalDenormalizedWeight
+     * Returns total denormalized weught of the pool
+     * @param {String} poolAddress
+     * @return {String}
+     */
     getTotalDenormalizedWeight(poolAddress: string): Promise<string>;
-    getMarketFees(poolAddress: string, token: string): Promise<string>;
+    /**
+     * Returns the current fee of publishingMarket
+     * Get Market Fees available to be collected for a specific token
+     * @param {String} poolAddress
+     * @param {String} token token we want to check fees
+     * @param {number} tokenDecimals optional number of decimals of the token
+     * @return {String}
+     */
+    getMarketFees(poolAddress: string, token: string, tokenDecimals?: number): Promise<string>;
+    /**
+     * Get Community  Get the current amount of fees which can be withdrawned by the Market
+     * @return {CurrentFees}
+     */
     getCurrentMarketFees(poolAddress: string): Promise<CurrentFees>;
+    /**
+     * Get getCurrentOPFFees  Get the current amount of fees which can be withdrawned by OPF
+     * @return {CurrentFees}
+     */
     getCurrentOPCFees(poolAddress: string): Promise<CurrentFees>;
-    getCommunityFees(poolAddress: string, token: string): Promise<string>;
+    /**
+     * Get Community Fees available to be collected for a specific token
+     * @param {String} poolAddress
+     * @param {String} token token we want to check fees
+     * @param {number} tokenDecimals optional number of decimals of the token
+     * @return {String}
+     */
+    getCommunityFees(poolAddress: string, token: string, tokenDecimals?: number): Promise<string>;
+    /**
+     * Estimate gas cost for collectOPF
+     * @param {String} address
+     * @param {String} poolAddress
+     * @param {Contract} contractInstance optional contract instance
+     * @return {Promise<number>}
+     */
     estCollectOPC(address: string, poolAddress: string, contractInstance?: Contract): Promise<number>;
+    /**
+     * collectOPF - collect opf fee - can be called by anyone
+     * @param {String} address
+     * @param {String} poolAddress
+     * @return {TransactionReceipt}
+     */
     collectOPC(address: string, poolAddress: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for collectMarketFee
+     * @param {String} address
+     * @param {String} poolAddress
+     * @param {String} to address that will receive fees
+     * @param {Contract} contractInstance optional contract instance
+     * @return {Promise<number>}
+     */
     estCollectMarketFee(address: string, poolAddress: string, contractInstance?: Contract): Promise<number>;
+    /**
+     * collectOPF - collect market fees - can be called by the publishMarketCollector
+     * @param {String} address
+     * @param {String} poolAddress
+     * @param {String} to address that will receive fees
+     * @return {TransactionReceipt}
+     */
     collectMarketFee(address: string, poolAddress: string): Promise<TransactionReceipt>;
-    estUpdateMarketFeeCollector(address: string, poolAddress: string, newCollector: string, contractInstance?: Contract): Promise<number>;
-    updateMarketFeeCollector(address: string, poolAddress: string, newCollector: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for updatePublishMarketFee
+     * @param {String} address
+     * @param {String} poolAddress
+     * @param {String} newPublishMarketAddress new market address
+     * @param {String} newPublishMarketSwapFee new market swap fee
+     * @param {Contract} contractInstance optional contract instance
+     * @return {Promise<number>}
+     */
+    estUpdatePublishMarketFee(address: string, poolAddress: string, newPublishMarketAddress: string, newPublishMarketSwapFee: string, contractInstance?: Contract): Promise<number>;
+    /**
+     * updatePublishMarketFee - sets a new  newPublishMarketAddress and new newPublishMarketSwapFee- can be called only by the marketFeeCollector
+     * @param {String} address
+     * @param {String} poolAddress
+     * @param {String} newPublishMarketAddress new market fee collector address
+     * @param {String} newPublishMarketSwapFee fee recieved by the publisher market when a dt is swaped from a pool, percent
+     * @return {TransactionReceipt}
+     */
+    updatePublishMarketFee(address: string, poolAddress: string, newPublishMarketAddress: string, newPublishMarketSwapFee: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for swapExactAmountIn
+     * @param {String} address
+     * @param {String} poolAddress
+     * @param {TokenInOutMarket} tokenInOutMarket object contianing addresses like tokenIn, tokenOut, consumeMarketFeeAddress
+     * @param {AmountsInMaxFee} amountsInOutMaxFee object contianing tokenAmountIn, minAmountOut, maxPrice, consumeMarketSwapFee
+     * @param {Contract} contractInstance optional contract instance
+     * @return {Promise<number>}
+     */
     estSwapExactAmountIn(address: string, poolAddress: string, tokenInOutMarket: TokenInOutMarket, amountsInOutMaxFee: AmountsInMaxFee, contractInstance?: Contract): Promise<number>;
+    /**
+     * Swaps an exact amount of tokensIn to get a mimum amount of tokenOut
+     * Trades an exact tokenAmountIn of tokenIn taken from the caller by the pool,
+     * in exchange for at least minAmountOut of tokenOut given to the caller from the pool, with a maximum marginal price of maxPrice.
+     * Returns (tokenAmountOut, spotPriceAfter), where tokenAmountOut is the amount of token that came out of the pool,
+     * and spotPriceAfter is the new marginal spot price, ie, the result of getSpotPrice after the call.
+     * (These values are what are limited by the arguments; you are guaranteed tokenAmountOut >= minAmountOut and spotPriceAfter <= maxPrice).
+     * @param {String} address
+     * @param {String} poolAddress
+     * @param {TokenInOutMarket} tokenInOutMarket object contianing addresses like tokenIn, tokenOut, consumeMarketFeeAddress
+     * @param {AmountsInMaxFee} amountsInOutMaxFee object contianing tokenAmountIn, minAmountOut, maxPrice, consumeMarketSwapFee
+     * @return {TransactionReceipt}
+     */
     swapExactAmountIn(address: string, poolAddress: string, tokenInOutMarket: TokenInOutMarket, amountsInOutMaxFee: AmountsInMaxFee): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for swapExactAmountOut
+     * @param {String} address
+     * @param {String} poolAddress
+     * @param {TokenInOutMarket} tokenInOutMarket
+     * @param {AmountsOutMaxFee} amountsInOutMaxFee
+     * @param {Contract} contractInstance optional contract instance
+     * @return {Promise<number>}
+     */
     estSwapExactAmountOut(address: string, poolAddress: string, tokenInOutMarket: TokenInOutMarket, amountsInOutMaxFee: AmountsOutMaxFee, contractInstance?: Contract): Promise<number>;
+    /**
+     * Swaps a maximum  maxAmountIn of tokensIn to get an exact amount of tokenOut
+     * @param {String} account
+     * @param {String} poolAddress
+     * @param {TokenInOutMarket} tokenInOutMarket Object containing addresses like tokenIn, tokenOut, consumeMarketFeeAddress
+     * @param {AmountsOutMaxFee} amountsInOutMaxFee Object containging maxAmountIn,tokenAmountOut,maxPrice, consumeMarketSwapFee]
+     * @return {TransactionReceipt}
+     */
     swapExactAmountOut(account: string, poolAddress: string, tokenInOutMarket: TokenInOutMarket, amountsInOutMaxFee: AmountsOutMaxFee): Promise<TransactionReceipt>;
-    estJoinPool(address: string, poolAddress: string, poolAmountOut: string, maxAmountsIn: string[], contractInstance?: Contract): Promise<number>;
-    joinPool(address: string, poolAddress: string, poolAmountOut: string, maxAmountsIn: string[]): Promise<TransactionReceipt>;
-    estExitPool(address: string, poolAddress: string, poolAmountIn: string, minAmountsOut: string[], contractInstance?: Contract): Promise<number>;
-    exitPool(account: string, poolAddress: string, poolAmountIn: string, minAmountsOut: string[]): Promise<TransactionReceipt>;
-    estJoinswapExternAmountIn(address: string, poolAddress: string, tokenIn: string, tokenAmountIn: string, minPoolAmountOut: string, contractInstance?: Contract): Promise<number>;
-    joinswapExternAmountIn(account: string, poolAddress: string, tokenIn: string, tokenAmountIn: string, minPoolAmountOut: string): Promise<TransactionReceipt>;
-    estJoinswapPoolAmountOut(address: string, poolAddress: string, tokenIn: string, poolAmountOut: string, maxAmountIn: string, contractInstance?: Contract): Promise<number>;
-    joinswapPoolAmountOut(account: string, poolAddress: string, tokenIn: string, poolAmountOut: string, maxAmountIn: string): Promise<TransactionReceipt>;
-    estExitswapPoolAmountIn(address: string, poolAddress: string, tokenOut: string, poolAmountIn: string, minTokenAmountOut: string, contractInstance?: Contract): Promise<number>;
-    exitswapPoolAmountIn(account: string, poolAddress: string, tokenOut: string, poolAmountIn: string, minTokenAmountOut: string): Promise<TransactionReceipt>;
-    estExitswapExternAmountOut(address: string, poolAddress: string, tokenOut: string, tokenAmountOut: string, maxPoolAmountIn: string, contractInstance?: Contract): Promise<number>;
-    exitswapExternAmountOut(account: string, poolAddress: string, tokenOut: string, tokenAmountOut: string, maxPoolAmountIn: string): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for joinswapExternAmountIn
+     * @param {String} address
+     * @param {String} poolAddress
+     * @param {String} tokenIn
+     * @param {String} tokenAmountIn exact number of base tokens to spend
+     * @param {String} minPoolAmountOut minimum of pool shares expectex
+     * @param {Contract} contractInstance optional contract instance
+     * @return {Promise<number>}
+     */
+    estJoinswapExternAmountIn(address: string, poolAddress: string, tokenAmountIn: string, minPoolAmountOut: string, contractInstance?: Contract): Promise<number>;
+    /**
+     * Single side add liquidity to the pool,
+     * expecting a minPoolAmountOut of shares for spending tokenAmountIn basetokens.
+     * Pay tokenAmountIn of baseToken to join the pool, getting poolAmountOut of the pool shares.
+     * @param {String} account
+     * @param {String} poolAddress
+     * @param {String} tokenAmountIn exact number of base tokens to spend
+     * @param {String} minPoolAmountOut minimum of pool shares expectex
+     * @param {number} tokenInDecimals optional number of decimals of the token
+     * @return {TransactionReceipt}
+     */
+    joinswapExternAmountIn(account: string, poolAddress: string, tokenAmountIn: string, minPoolAmountOut: string, tokenInDecimals?: number): Promise<TransactionReceipt>;
+    /**
+     * Estimate gas cost for exitswapPoolAmountIn
+     * @param {String} address
+     *  @param {String} poolAddress
+     * @param {String} poolAmountIn exact number of pool shares to spend
+     * @param {String} minTokenAmountOut minimum amount of basetokens expected
+     * @param {Contract} contractInstance optional contract instance
+     * @return {Promise<number>}
+     */
+    estExitswapPoolAmountIn(address: string, poolAddress: string, poolAmountIn: string, minTokenAmountOut: string, contractInstance?: Contract): Promise<number>;
+    /**
+     * Single side remove liquidity from the pool,
+     * expecting a minAmountOut of basetokens for spending poolAmountIn pool shares
+     * Pay poolAmountIn pool shares into the pool, getting minTokenAmountOut of the baseToken
+     * @param {String} account
+     * @param {String} poolAddress
+     * @param {String} poolAmountIn exact number of pool shares to spend
+     * @param {String} minTokenAmountOut minimum amount of basetokens expected
+     * @param {number} poolDecimals optional number of decimals of the poool
+     * @return {TransactionReceipt}
+     */
+    exitswapPoolAmountIn(account: string, poolAddress: string, poolAmountIn: string, minTokenAmountOut: string, poolDecimals?: number): Promise<TransactionReceipt>;
+    /**
+     * Return the spot price of swapping tokenIn to tokenOut
+     * @param {String} poolAddress
+     * @param {String} tokenIn in token
+     * @param {String} tokenOut out token
+     * @param {String} swapMarketFe consume market swap fee
+     * @return {String}
+     */
     getSpotPrice(poolAddress: string, tokenIn: string, tokenOut: string, swapMarketFee: string): Promise<string>;
-    getAmountInExactOut(poolAddress: string, tokenIn: string, tokenOut: string, tokenAmountOut: string, swapMarketFee: string): Promise<string>;
-    getAmountOutExactIn(poolAddress: string, tokenIn: string, tokenOut: string, tokenAmountIn: string, swapMarketFee: string): Promise<string>;
-    calcPoolOutGivenSingleIn(poolAddress: string, tokenIn: string, tokenAmountIn: string): Promise<string>;
-    calcSingleInGivenPoolOut(poolAddress: string, tokenIn: string, poolAmountOut: string): Promise<string>;
-    calcSingleOutGivenPoolIn(poolAddress: string, tokenOut: string, poolAmountIn: string): Promise<string>;
-    calcPoolInGivenSingleOut(poolAddress: string, tokenOut: string, tokenAmountOut: string): Promise<string>;
+    /**
+     * How many tokensIn do you need in order to get exact tokenAmountOut.
+     * Returns: tokenAmountIn, swapFee, opcFee , consumeMarketSwapFee, publishMarketSwapFee
+     * Returns: tokenAmountIn, LPFee, opcFee , publishMarketSwapFee, consumeMarketSwapFee
+     * @param tokenIn token to be swaped
+     * @param tokenOut token to get
+     * @param tokenAmountOut exact amount of tokenOut
+     * @param swapMarketFee consume market swap fee
+     * @param {number} tokenInDecimals optional number of decimals of the token to be swaped
+     * @param {number} tokenOutDecimals optional number of decimals of the token to get
+     */
+    getAmountInExactOut(poolAddress: string, tokenIn: string, tokenOut: string, tokenAmountOut: string, swapMarketFee: string, tokenInDecimals?: number, tokenOutDecimals?: number): Promise<PoolPriceAndFees>;
+    /**
+     *  How many tokensOut you will get for a exact tokenAmountIn
+     *  Returns: tokenAmountOut, LPFee, opcFee ,  publishMarketSwapFee, consumeMarketSwapFee
+     * @param tokenIn token to be swaped
+     * @param tokenOut token to get
+     * @param tokenAmountIn exact amount of tokenIn
+     * @param swapMarketFee
+     * @param {number} tokenInDecimals optional number of decimals of the token to be swaped
+     * @param {number} tokenOutDecimals optional number of decimals of the token to get
+     */
+    getAmountOutExactIn(poolAddress: string, tokenIn: string, tokenOut: string, tokenAmountIn: string, swapMarketFee: string, tokenInDecimals?: number, tokenOutDecimals?: number): Promise<PoolPriceAndFees>;
+    /**
+     * Returns number of poolshares obtain by staking exact tokenAmountIn tokens
+     * @param tokenIn tokenIn
+     * @param tokenAmountIn exact number of tokens staked
+     * @param {number} poolDecimals optional number of decimals of the poool
+     * @param {number} tokenInDecimals optional number of decimals of the token
+     */
+    calcPoolOutGivenSingleIn(poolAddress: string, tokenIn: string, tokenAmountIn: string, poolDecimals?: number, tokenInDecimals?: number): Promise<string>;
+    /**
+     * Returns number of tokens to be staked to the pool in order to get an exact number of poolshares
+     * @param tokenIn tokenIn
+     * @param poolAmountOut expected amount of pool shares
+     * @param {number} poolDecimals optional number of decimals of the pool
+     * @param {number} tokenInDecimals optional number of decimals of the token
+     */
+    calcSingleInGivenPoolOut(poolAddress: string, tokenIn: string, poolAmountOut: string, poolDecimals?: number, tokenInDecimals?: number): Promise<string>;
+    /**
+     * Returns expected amount of tokenOut for removing exact poolAmountIn pool shares from the pool
+     * @param tokenOut tokenOut
+     * @param poolAmountIn amount of shares spent
+     * @param {number} poolDecimals optional number of decimals of the pool
+     * @param {number} tokenOutDecimals optional number of decimals of the token
+     */
+    calcSingleOutGivenPoolIn(poolAddress: string, tokenOut: string, poolAmountIn: string, poolDecimals?: number, tokenOutDecimals?: number): Promise<string>;
+    /**
+     * Returns number of poolshares needed to withdraw exact tokenAmountOut tokens
+     * @param tokenOut tokenOut
+     * @param tokenAmountOut expected amount of tokensOut
+     * @param {number} poolDecimals optional number of decimals of the pool
+     * @param {number} tokenOutDecimals optional number of decimals of the token
+     */
+    calcPoolInGivenSingleOut(poolAddress: string, tokenOut: string, tokenAmountOut: string, poolDecimals?: number, tokenOutDecimals?: number): Promise<string>;
+    /**
+     * Get LOG_SWAP encoded topic
+     * @return {String}
+     */
     getSwapEventSignature(): string;
+    /**
+     * Get LOG_JOIN encoded topic
+     * @return {String}
+     */
     getJoinEventSignature(): string;
+    /**
+     * Get LOG_EXIT encoded topic
+     * @return {String}
+     */
     getExitEventSignature(): string;
 }