@oceanprotocol/lib 1.0.0-next.8 → 1.1.0

package/dist/src/@types/Asset.d.ts

@@ -1,21 +1,78 @@
 import { DDO } from './DDO/DDO';
 export interface AssetNft {
+    /**
+     * Contract address of the deployed ERC721 NFT contract.
+     * @type {string}
+     */
     address: string;
+    /**
+     * Name of NFT set in contract.
+     * @type {string}
+     */
     name: string;
+    /**
+     * Symbol of NFT set in contract.
+     * @type {string}
+     */
     symbol: string;
+    /**
+     * ETH account address of the NFT owner.
+     * @type {string}
+     */
     owner: string;
+    /**
+     * State of the asset reflecting the NFT contract value.
+     * 0	Active.
+     * 1	End-of-life.
+     * 2	Deprecated (by another asset).
+     * 3	Revoked by publisher.
+     * 4	Ordering is temporary disabled.
+     * @type {number}
+     */
     state: 0 | 1 | 2 | 3 | 4;
+    /**
+     * Contains the date of NFT creation.
+     * @type {string}
+     */
     created: string;
+    /**
+     * NFT token URI.
+     * @type {string}
+     */
     tokenURI: string;
 }
 export interface Purgatory {
+    /**
+     * If `true`, asset is in purgatory.
+     * @type {boolean}
+     */
     state: boolean;
+    /**
+     * If asset is in purgatory, contains the reason for being there as defined in `list-purgatory`.
+     * @type {string}
+     */
     reason: string;
 }
 export interface AssetDatatoken {
+    /**
+     * Contract address of the deployed ERC20 contract.
+     * @type {string}
+     */
     address: string;
+    /**
+     * Name of NFT set in contract.
+     * @type {string}
+     */
     name: string;
+    /**
+     * Symbol of NFT set in contract.
+     * @type {string}
+     */
     symbol: string;
+    /**
+     * ID of the service the datatoken is attached to.
+     * @type {string}
+     */
     serviceId: string;
 }
 export interface AssetLastEvent {
@@ -26,11 +83,37 @@ export interface AssetLastEvent {
     datetime: string;
 }
 export interface Asset extends DDO {
+    /**
+     * Contains information about the ERC721 NFT contract which represents the intellectual property of the publisher.
+     * @type {string}
+     */
     nft: AssetNft;
+    /**
+     * Contains information about the ERC20 datatokens attached to asset services.
+     * @type {string}
+     */
     datatokens: AssetDatatoken[];
+    /**
+     * Contains information about the last transaction that created or updated the DDO.
+     * @type {string}
+     */
     event: AssetLastEvent;
+    /**
+     * The stats section contains different statistics fields.
+     * @type {string}
+     */
     stats: {
+        /**
+         * How often an asset was consumed, meaning how often it was either downloaded or used as part of a compute job.
+         * @type {string}
+         */
         consume: number;
     };
+    /**
+     * Contains information about an asset's purgatory status defined in
+     * [`list-purgatory`](https://github.com/oceanprotocol/list-purgatory).
+     * Marketplace interfaces are encouraged to prevent certain user actions like adding liquidity on assets in purgatory.
+     * @type {Purgatory}
+     */
     purgatory: Purgatory;
 }

package/dist/src/@types/Compute.d.ts

@@ -1,5 +1,22 @@
 import { Metadata, MetadataAlgorithm } from './DDO/Metadata';
-export declare type ComputeResultType = 'algorithmLog' | 'output';
+export declare type ComputeResultType = 'algorithmLog' | 'output' | 'configrationLog' | 'publishLog';
+export interface ComputeEnvironment {
+    id: string;
+    cpuNumber: number;
+    cpuType: string;
+    gpuNumber: number;
+    gpuType: string;
+    ramGB: number;
+    diskGB: number;
+    priceMin: number;
+    desc: string;
+    currentJobs: number;
+    maxJobs: number;
+    consumerAddress: string;
+    storageExpiry: number;
+    maxJobDuration: number;
+    lastSeen: number;
+}
 export interface ComputeResult {
     filename: string;
     filesize: number;

package/dist/src/@types/DDO/DDO.d.ts

@@ -2,14 +2,57 @@ import { Service } from './Service';
 import { Metadata } from './Metadata';
 import { Credentials } from './Credentials';
 import { Event } from './Event';
+/**
+ * DID Descriptor Object.
+ * Contains metadata about the asset, and define access in at least one service.
+ */
 export interface DDO {
+    /**
+     * Contexts used for validation.
+     * @type {string[]}
+     */
     '@context': string[];
+    /**
+     * DID, descentralized ID.
+     * Computed as sha256(address of ERC721 contract + chainId)
+     * @type {string}
+     */
     id: string;
+    /**
+     * Version information in SemVer notation
+     * referring to the DDO spec version
+     * @type {string}
+     */
     version: string;
+    /**
+     * NFT contract address
+     * @type {string}
+     */
     nftAddress: string;
+    /**
+     * ChainId of the network the DDO was published to.
+     * @type {number}
+     */
     chainId: number;
+    /**
+     * Stores an object describing the asset.
+     * @type {Metadata}
+     */
     metadata: Metadata;
+    /**
+     * Stores an array of services defining access to the asset.
+     * @type {Service[]}
+     */
     services: Service[];
+    /**
+     * Describes the credentials needed to access a dataset
+     * in addition to the services definition.
+     * @type {Credentials}
+     */
     credentials?: Credentials;
+    /**
+     * Describes the event of last metadata event
+     * @type {Event}
+     */
     event?: Event;
 }

package/dist/src/@types/DDO/Event.d.ts

@@ -1,7 +1,27 @@
 export interface Event {
+    /**
+     * TX id of the last create/update
+     * @type {string}
+     */
     txid?: string;
+    /**
+     * Block of txid
+     * @type {number}
+     */
     block?: number;
+    /**
+     * Sender of tx
+     * @type {String}
+     */
     from?: string;
+    /**
+     * Contract
+     * @type {String}
+     */
     contract?: string;
+    /**
+     * datetime of tx
+     * @type {String}
+     */
     datetime?: string;
 }

package/dist/src/@types/DDO/Metadata.d.ts

@@ -1,27 +1,119 @@
 export interface MetadataAlgorithm {
+    /**
+     * Language used to implement the software.
+     * @type {string}
+     */
     language?: string;
+    /**
+     * Version of the software preferably in SemVer notation.
+     * @type {string}
+     */
     version?: string;
+    /**
+     * Rawcode
+     * @type {string}
+     */
     rawcode?: string;
+    /**
+     * Object describing the Docker container image.
+     * @type {Object}
+     */
     container: {
+        /**
+         * The command to execute, or script to run inside the Docker image.
+         * @type {string}
+         */
         entrypoint: string;
+        /**
+         * Name of the Docker image.
+         * @type {string}
+         */
         image: string;
+        /**
+         * Tag of the Docker image.
+         * @type {string}
+         */
         tag: string;
+        /**
+         * Checksum of the Docker image.
+         * @type {string}
+         */
         checksum: string;
     };
 }
 export interface Metadata {
+    /**
+     * Contains the date of publishing in ISO Date Time
+     * @type {string}
+     */
     created: string;
+    /**
+     * Contains the the date of last update in ISO Date Time
+     * @type {string}
+     */
     updated: string;
+    /**
+     * Descriptive name or title of the asset.
+     * @type {string}
+     */
     name: string;
+    /**
+     * Details of what the resource is.
+     * @type {string}
+     */
     description: string;
+    /**
+     * Asset type. Includes "dataset" (e.g. csv file), "algorithm" (e.g. Python script).
+     * Each type needs a different subset of metadata attributes.
+     * @type {'dataset' | 'algorithm'}
+     */
     type: 'dataset' | 'algorithm';
+    /**
+     * Name of the entity generating this data (e.g. Tfl, Disney Corp, etc.).
+     * @type {string}
+     */
     author: string;
+    /**
+     * Short name referencing the license of the asset.
+     * If it’s not specified, the following value will be added: “No License Specified”.
+     * @type {string}
+     */
     license: string;
+    /**
+     * Mapping of URL strings for data samples, or links to find out more information.
+     * Links may be to either a URL or another asset.
+     * @type {string[]}
+     */
     links?: string[];
+    /**
+     * Array of keywords or tags used to describe this content. Empty by default.
+     * @type {string[]}
+     */
     tags?: string[];
+    /**
+     * Array of categories associated to the asset. Note: recommended to use tags instead of this.
+     * @type {string[]}
+     */
+    categories?: string[];
+    /**
+     * The party holding the legal copyright. Empty by default.
+     * @type {string}
+     */
     copyrightHolder?: string;
+    /**
+     *The language of the content. Use one of the language codes from the IETF BCP 47 standard
+     * @type {string}
+     */
     contentLanguage?: string;
+    /**
+     * Information about asset of typealgorithm
+     * @type {MetadataAlgorithm}
+     */
     algorithm?: MetadataAlgorithm;
+    /**
+     * Stores additional information, this is customizable by publisher
+     * @type {any}
+     */
     additionalInformation?: any;
 }
 export interface MetadataProof {

package/dist/src/@types/DDO/Service.d.ts

@@ -1,28 +1,94 @@
 export interface PublisherTrustedAlgorithm {
+    /**
+     * The DID of the algorithm which is trusted by the publisher.
+     * @type {string}
+     */
     did: string;
+    /**
+     * Hash of algorithm’s files section.
+     * @type {string}
+     */
     filesChecksum: string;
+    /**
+     * Hash of algorithm’s metadata.algorithm.container section.
+     * @type {string}
+     */
     containerSectionChecksum: string;
 }
 export interface ServiceComputeOptions {
-    namespace: string;
-    cpu?: number;
-    gpu?: number;
-    gpuType?: string;
-    memory?: string;
-    volumeSize?: string;
+    /**
+     * If true, any passed raw text will be allowed to run.
+     * Useful for an algorithm drag & drop use case, but increases risk of data escape through malicious user input.
+     * Should be false by default in all implementations.
+     * @type {boolean}
+     */
     allowRawAlgorithm: boolean;
+    /**
+     * If true, the algorithm job will have network access.
+     * @type {boolean}
+     */
     allowNetworkAccess: boolean;
+    /**
+     * If empty, then any published algorithm is allowed.
+     * Otherwise, only published algorithms by some publishers are allowed
+     * @type {string[]}
+     */
     publisherTrustedAlgorithmPublishers: string[];
+    /**
+     * If empty, then any published algorithm is allowed. (see below)
+     * @type {PublisherTrustedAlgorithm[]}
+     */
     publisherTrustedAlgorithms: PublisherTrustedAlgorithm[];
 }
 export interface Service {
+    /**
+     * Unique ID
+     * @type {string}
+     */
     id: string;
+    /**
+     * Type of service (access, compute, wss.
+     * @type {string}
+     */
     type: 'access' | 'compute' | string;
+    /**
+     * Encrypted file URLs.
+     * @type {string}
+     */
     files: string;
+    /**
+     * Datatoken address
+     * @type {string}
+     */
     datatokenAddress: string;
+    /**
+     * Provider URL (schema + host).
+     * @type {string}
+     */
     serviceEndpoint: string;
+    /**
+     * Describing how long the service can be used after consumption is initiated.
+     * @type {number}
+     */
     timeout: number;
+    /**
+     * Service friendly name
+     * @type {string}
+     */
     name?: string;
+    /**
+     * Service description
+     * @type {string}
+     */
     description?: string;
+    /**
+     * If service is of type compute, holds information about the compute-related privacy settings & resources.
+     * @type {ServiceComputeOptions}
+     */
     compute?: ServiceComputeOptions;
+    /**
+     * Stores service specific additional information, this is customizable by publisher
+     * @type {any}
+     */
+    additionalInformation?: any;
 }

package/dist/src/@types/Erc20.d.ts

@@ -0,0 +1,21 @@
+export interface Erc20CreateParams {
+    templateIndex: number;
+    minter: string;
+    paymentCollector: string;
+    mpFeeAddress: string;
+    feeToken: string;
+    feeAmount: string;
+    cap: string;
+    name?: string;
+    symbol?: string;
+}
+export interface ConsumeMarketFee {
+    consumeMarketFeeAddress: string;
+    consumeMarketFeeToken: string;
+    consumeMarketFeeAmount: string;
+}
+export interface PublishingMarketFee {
+    publishMarketFeeAddress: string;
+    publishMarketFeeToken: string;
+    publishMarketFeeAmount: string;
+}

package/dist/src/{interfaces/Erc721Interface.d.ts → @types/Erc721.d.ts}

@@ -1,4 +1,4 @@
-import { MetadataProof } from '../@types';
+import { MetadataProof } from '.';
 export interface MetadataAndTokenURI {
     metaDataState: number;
     metaDataDecryptorUrl: string;
@@ -8,5 +8,5 @@ export interface MetadataAndTokenURI {
     metaDataHash: string;
     tokenId: number;
     tokenURI: string;
-    metadataProofs: MetadataProof[];
+    metadataProofs?: MetadataProof[];
 }

package/dist/src/@types/File.d.ts

@@ -0,0 +1,23 @@
+export interface UrlFile {
+    type: 'url';
+    /**
+     * File index.
+     * @type {number}
+     */
+    index?: number;
+    /**
+     * File URL.
+     * @type {string}
+     */
+    url: string;
+    /**
+     * HTTP method used
+     * @type {string}
+     */
+    method: string;
+}
+export interface Files {
+    nftAddress: string;
+    datatokenAddress: string;
+    files: UrlFile[];
+}

package/dist/src/@types/FileInfo.d.ts

@@ -0,0 +1,38 @@
+export interface FileInfo {
+    /**
+     * File URL.
+     * @type {string}
+     */
+    type: string;
+    /**
+     * File format, if applicable.
+     * @type {string}
+     * @example "text/csv"
+     */
+    contentType?: string;
+    /**
+     * File content length.
+     * @type {[type]}
+     */
+    contentLength?: string;
+    /**
+     * File index.
+     * @type {number}
+     */
+    index?: number;
+    /**
+     * File URL.
+     * @type {string}
+     */
+    url?: string;
+    /**
+     * HTTP method used
+     * @type {string}
+     */
+    method?: string;
+    /**
+     * check if file exists
+     * @type {boolean}
+     */
+    valid?: boolean;
+}

package/dist/src/{interfaces/FixedRateInterface.d.ts → @types/FixedPrice.d.ts}

@@ -6,7 +6,7 @@ export interface FreCreationParams {
     baseTokenDecimals: number;
     datatokenDecimals: number;
     fixedRate: string;
-    marketFee: number;
+    marketFee: string;
     withMint?: boolean;
     allowedConsumer?: string;
 }
@@ -17,3 +17,9 @@ export interface FreOrderParams {
     swapMarketFee: string;
     marketFeeAddress: string;
 }
+export interface PriceAndFees {
+    baseTokenAmount: string;
+    oceanFeeAmount: string;
+    marketFeeAmount: string;
+    consumeMarketFeeAmount: string;
+}

package/dist/src/{interfaces/PoolInterface.d.ts → @types/Pool.d.ts}

@@ -10,8 +10,8 @@ export interface PoolCreationParams {
     vestingAmount: string;
     vestedBlocks: number;
     initialBaseTokenLiquidity: string;
-    swapFeeLiquidityProvider: number;
-    swapFeeMarketRunner: number;
+    swapFeeLiquidityProvider: string;
+    swapFeeMarketRunner: string;
 }
 export interface CurrentFees {
     tokens: string[];
@@ -21,6 +21,8 @@ export interface TokenInOutMarket {
     tokenIn: string;
     tokenOut: string;
     marketFeeAddress: string;
+    tokenInDecimals?: number;
+    tokenOutDecimals?: number;
 }
 export interface AmountsInMaxFee {
     tokenAmountIn: string;
@@ -34,3 +36,10 @@ export interface AmountsOutMaxFee {
     swapMarketFee: string;
     maxPrice?: string;
 }
+export interface PoolPriceAndFees {
+    tokenAmount: string;
+    liquidityProviderSwapFeeAmount: string;
+    oceanFeeAmount: string;
+    publishMarketSwapFeeAmount: string;
+    consumeMarketSwapFeeAmount: string;
+}

package/dist/src/@types/Provider.d.ts

@@ -14,3 +14,12 @@ export interface ProviderInitialize {
     computeAddress: string;
     providerFee: ProviderFees;
 }
+export interface ProviderComputeInitialize {
+    datatoken?: string;
+    validOrder?: string;
+    providerFee?: ProviderFees;
+}
+export interface ProviderComputeInitializeResults {
+    algorithm?: ProviderComputeInitialize;
+    datasets?: ProviderComputeInitialize[];
+}

package/dist/src/@types/Router.d.ts

@@ -0,0 +1,59 @@
+export interface Operation {
+    /**
+     * used only for FixedRate or Dispenser, but needs to be filled even for pool
+     * @type {string}
+     */
+    exchangeIds: string;
+    /**
+     * pool Address
+     * @type {string}
+     */
+    source: string;
+    /**
+     * operation:
+     * 0 - swapExactAmountIn
+     * 1 - swapExactAmountOut
+     * 2 - FixedRateExchange
+     * 3 - Dispenser
+     * @type {number}
+     */
+    operation: number;
+    /**
+     * token in address
+     * @type {string}
+     */
+    tokenIn: string;
+    /**
+     * when swapExactAmountIn is EXACT amount IN
+     * expressed in Wei
+     * @type {string | number}
+     */
+    amountsIn: string | number;
+    /**
+     * token out address
+     * @type {string}
+     */
+    tokenOut: string;
+    /**
+     * when swapExactAmountIn is MIN amount OUT
+     * expressed in Wei
+     * @type {string | number}
+     */
+    amountsOut: string | number;
+    /**
+     * max price (only for pools)
+     * expressed in Wei
+     * @type {string | number}
+     */
+    maxPrice: string | number;
+    /**
+     * swap fee amount
+     * @type {string}
+     */
+    swapMarketFee: string;
+    /**
+     * market fee address to receive fees
+     * @type {string}
+     */
+    marketFeeAddress: string;
+}

package/dist/src/@types/index.d.ts

@@ -3,6 +3,13 @@ export * from './Asset';
 export * from './DDO/Service';
 export * from './DDO/Credentials';
 export * from './DDO/Metadata';
-export * from './FileMetadata';
+export * from './File';
+export * from './FileInfo';
 export * from './Compute';
 export * from './Provider';
+export * from './FixedPrice';
+export * from './Pool';
+export * from './Erc20';
+export * from './Erc721';
+export * from './Dispenser';
+export * from './Router';