@mento-protocol/mento-sdk 1.0.0 → 2.0.0-beta.1

package/dist/utils/retry.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retryOperation = retryOperation;
+/**
+ * Retry an operation a number of times with exponential backoff.
+ * @param operation - The operation to retry
+ * @param options - The retry options
+ * @returns The result of the operation
+ */
+async function retryOperation(operation, options = {}) {
+    const maxAttempts = options.maxAttempts ?? 3;
+    const delayMs = options.initialDelayMs ?? 1000;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === maxAttempts)
+                break;
+            // Exponential backoff
+            await new Promise((resolve) => setTimeout(resolve, delayMs * attempt));
+        }
+    }
+    throw new Error(`Operation failed after ${maxAttempts} attempts: ${lastError?.message}`);
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":";;AAWA,wCAuBC;AA7BD;;;;;GAKG;AACI,KAAK,UAAU,cAAc,CAClC,SAA2B,EAC3B,UAAwB,EAAE;IAE1B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAA;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAA;IAC9C,IAAI,SAA4B,CAAA;IAEhC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAA;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAA;YAC1B,IAAI,OAAO,KAAK,WAAW;gBAAE,MAAK;YAElC,sBAAsB;YACtB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAA;QACxE,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,0BAA0B,WAAW,cAAc,SAAS,EAAE,OAAO,EAAE,CACxE,CAAA;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mento-protocol/mento-sdk",
   "description": "Official SDK for interacting with the Mento Protocol",
-  "version": "1.0.0",
+  "version": "2.0.0-beta.1",
   "license": "MIT",
   "author": "Mento Labs",
   "keywords": [
@@ -13,74 +13,62 @@
     "type": "git",
     "url": "https://github.com/mento-protocol/mento-sdk.git"
   },
-  "main": "dist/cjs/index.js",
-  "module": "dist/esm/index.js",
-  "typings": "dist/esm/index.d.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "files": [
     "dist",
     "!dist/**/*.test.*"
   ],
+  "type": "commonjs",
   "scripts": {
-    "analyze": "size-limit --why",
-    "build": "yarn build:cjs && yarn build:esm",
-    "build:cjs": "tsc --project ./tsconfig.json",
-    "build:esm": "tsc --project ./tsconfig.esm.json",
+    "build": "pnpm clean && tsc --project ./tsconfig.json",
     "clean": "rm -rf ./dist",
     "lint": "eslint --config ./.eslintrc.json src/**/*.ts",
     "prettier": "prettier --config ./.prettierrc.json --write **/*.{json,md,js,ts,yml}",
-    "size": "size-limit",
-    "test": "jest --runInBand --verbose",
+    "test": "jest --verbose",
     "coverage": "jest --coverage"
   },
-  "husky": {
-    "hooks": {
-      "pre-commit": "yarn lint"
-    }
-  },
-  "jest": {
-    "testEnvironment": "node",
-    "testMatch": [
-      "**/?(*.)+(test).ts"
-    ]
-  },
   "engines": {
-    "node": ">=14"
+    "node": ">=18",
+    "pnpm": ">=9"
   },
-  "size-limit": [
-    {
-      "path": "dist/sdk.cjs.production.min.js",
-      "limit": "10 KB"
-    },
-    {
-      "path": "dist/sdk.esm.js",
-      "limit": "10 KB"
-    }
-  ],
   "devDependencies": {
-    "@babel/preset-env": "^7.20.2",
-    "@babel/preset-typescript": "^7.18.6",
+    "@jest/types": "^29.6.3",
     "@size-limit/preset-small-lib": "^8.1.0",
     "@tsconfig/recommended": "^1.0.1",
-    "@types/jest": "^29.4.0",
+    "@types/chai": "^5.0.1",
+    "@types/jest": "^29.5.14",
     "@types/node": "^18.13.0",
     "@typescript-eslint/eslint-plugin": "^5.53.0",
     "@typescript-eslint/parser": "^5.53.0",
+    "chai": "^5.1.2",
     "eslint": "^8.34.0",
     "eslint-config-prettier": "^8.6.0",
-    "ethers": "^5.7.2",
     "husky": "^8.0.2",
     "jest": "^29.4.2",
     "prettier": "^2.8.4",
-    "size-limit": "^8.1.0",
     "ts-jest": "^29.0.5",
     "ts-node": "^10.9.1",
-    "typescript": "^4.9.5"
-  },
-  "dependencies": {
-    "@mento-protocol/mento-core-ts": "^0.2.0"
+    "typescript": "5.6.3"
   },
   "peerDependencies": {
-    "ethers": "^5.7"
+    "ethers": "^6.13.4",
+    "ethers-v5": "npm:ethers@^5.7.2",
+    "viem": "^2.21.44"
+  },
+  "peerDependenciesMeta": {
+    "ethers": {
+      "optional": true
+    },
+    "ethers-v5": {
+      "optional": true
+    },
+    "viem": {
+      "optional": true
+    }
   },
-  "packageManager": "yarn@3.3.1"
+  "dependencies": {
+    "@mento-protocol/mento-core-ts": "^0.2.0",
+    "bignumber.js": "^9.1.2"
+  }
 }

package/dist/cjs/ChainClient.d.ts

@@ -1,9 +0,0 @@
-import { PopulatedTransaction, ethers, providers } from 'ethers';
-import { IChainClient } from './interfaces';
-export declare class ChainClient implements IChainClient {
-    private readonly signerOrProvider;
-    constructor(signerOrProvider: ethers.Signer | providers.Provider);
-    getSigner(): Promise<ethers.Signer | providers.Provider>;
-    getChainId(): Promise<number>;
-    populateTransaction(tx: PopulatedTransaction): Promise<providers.TransactionRequest>;
-}

package/dist/cjs/ChainClient.js

@@ -1,58 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChainClient = void 0;
-const ethers_1 = require("ethers");
-const utils_1 = require("./utils");
-class ChainClient {
-    constructor(signerOrProvider) {
-        (0, utils_1.validateSignerOrProvider)(signerOrProvider);
-        this.signerOrProvider = signerOrProvider;
-    }
-    getSigner() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.signerOrProvider;
-        });
-    }
-    getChainId() {
-        var _a;
-        return __awaiter(this, void 0, void 0, function* () {
-            let chainId = 0;
-            if (ethers_1.Signer.isSigner(this.signerOrProvider)) {
-                const network = yield ((_a = this.signerOrProvider.provider) === null || _a === void 0 ? void 0 : _a.getNetwork());
-                if (network) {
-                    chainId = network.chainId;
-                }
-            }
-            else if (ethers_1.providers.Provider.isProvider(this.signerOrProvider)) {
-                const network = yield this.signerOrProvider.getNetwork();
-                if (network) {
-                    chainId = network.chainId;
-                }
-            }
-            if (chainId === 0) {
-                throw new Error('Could not get chainId from signer or provider');
-            }
-            return chainId;
-        });
-    }
-    populateTransaction(tx) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (ethers_1.Signer.isSigner(this.signerOrProvider)) {
-                return this.signerOrProvider.populateTransaction(tx);
-            }
-            else {
-                return tx;
-            }
-        });
-    }
-}
-exports.ChainClient = ChainClient;

package/dist/cjs/TestChainClient.d.ts

@@ -1,7 +0,0 @@
-import { PopulatedTransaction, ethers, providers } from 'ethers';
-import { IChainClient } from './interfaces';
-export declare class TestChainClient implements IChainClient {
-    getSigner(): Promise<ethers.Signer | providers.Provider>;
-    getChainId(): Promise<number>;
-    populateTransaction(tx: PopulatedTransaction): Promise<providers.TransactionRequest>;
-}

package/dist/cjs/TestChainClient.js

@@ -1,41 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TestChainClient = void 0;
-class TestChainClient {
-    getSigner() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const fakeProvider = {};
-            return fakeProvider;
-        });
-    }
-    getChainId() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return 44787;
-        });
-    }
-    populateTransaction(tx) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const fakeTx = {
-                to: tx.to,
-                from: tx.from,
-                data: tx.data,
-                value: tx.value,
-                nonce: 0,
-                gasLimit: 0,
-                gasPrice: 0,
-                chainId: 1,
-            };
-            return fakeTx;
-        });
-    }
-}
-exports.TestChainClient = TestChainClient;

package/dist/cjs/constants/addresses.d.ts

@@ -1,2 +0,0 @@
-import { ContractAddressMap } from '../types';
-export declare const addresses: ContractAddressMap;

package/dist/cjs/constants/index.d.ts

@@ -1 +0,0 @@
-export * from './addresses';

package/dist/cjs/enums/chainId.d.ts

@@ -1,5 +0,0 @@
-export declare enum ChainId {
-    CELO = 42220,
-    ALFAJORES = 44787,
-    BAKLAVA = 62320
-}

package/dist/cjs/enums/index.d.ts

@@ -1,2 +0,0 @@
-export * from './proposalState';
-export * from './chainId';

package/dist/cjs/governance.d.ts

@@ -1,62 +0,0 @@
-import { BigNumberish, Signer, providers } from 'ethers';
-import { MentoGovernor } from '@mento-protocol/mento-core-ts';
-import { IChainClient } from './interfaces';
-export declare class Governance {
-    private chainClient;
-    constructor(chainClient: IChainClient);
-    constructor(signerOrProvider: Signer | providers.Provider);
-    /**
-     * This function retrieves the MentoGovernor contract.
-     * @returns The MentoGovernor contract.
-     */
-    getGovernorContract(): Promise<MentoGovernor>;
-    /**
-     * Generates a transaction that submits a proposal to be created to the Mento Governor contract using the specified values.
-     * @param targets The addresses of the contracts to be called during proposal execution.
-     * @param values The values to be passed to the calls to the target contracts.
-     * @param calldatas The calldata to be passed to the calls to the target contracts.
-     * @param description A human readable description of the proposal.
-     * @returns The transaction request.
-     */
-    createProposal(targets: string[], values: BigNumberish[], calldatas: string[], description: string): Promise<providers.TransactionRequest>;
-    /**
-     * Generates a transaction that will queue the proposal with the specified id to be executed.
-     * @param proposalId The id of the proposal to queue.
-     * @returns The transaction request.
-     */
-    queueProposal(proposalId: BigNumberish): Promise<providers.TransactionRequest>;
-    /**
-     * Executes the proposal with the specified id.
-     * @param proposalId The id of the proposal to execute.
-     * @returns The transaction request.
-     */
-    executeProposal(proposalId: BigNumberish): Promise<providers.TransactionRequest>;
-    /**
-     * Submits a vote to the Mento Governor contract for the specified proposal.
-     * @param proposalId The id of the proposal to vote on.
-     * @param support Whether or not to support the proposal.
-     * @returns The transaction request.
-     */
-    castVote(proposalId: BigNumberish, support: BigNumberish): Promise<providers.TransactionRequest>;
-    /**
-     * Cancels the proposal with the specified id.
-     * @param proposalId The id of the proposal to vote on.
-     * @param support Whether or not to support the proposal.
-     * @returns The transaction request.
-     */
-    cancelProposal(proposalId: BigNumberish): Promise<providers.TransactionRequest>;
-    /**
-     * Returns the state of the proposal with the specified id.
-     * @param proposalId The id of the proposal to get the state of.
-     * @returns The state of the proposal.
-     */
-    getProposalState(proposalId: BigNumberish): Promise<string>;
-    /**
-     * This function validates the args that are to be used in the createProposal function.
-     * @param targets The addresses of the contracts to be called during proposal execution.
-     * @param values  The values to be passed to the calls to the target contracts.
-     * @param calldatas The calldata to be passed to the calls to the target contracts.
-     * @param description A human readable description of the proposal.
-     */
-    private validateProposalArgs;
-}

package/dist/cjs/governance.js

@@ -1,151 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Governance = void 0;
-const ethers_1 = require("ethers");
-const mento_core_ts_1 = require("@mento-protocol/mento-core-ts");
-const ChainClient_1 = require("./ChainClient");
-const TestChainClient_1 = require("./TestChainClient");
-const enums_1 = require("./enums");
-const constants_1 = require("./constants");
-class Governance {
-    constructor(arg) {
-        // TODO: Remove use of TestChainClient in future this is only meant for testing
-        if (arg instanceof ChainClient_1.ChainClient || arg instanceof TestChainClient_1.TestChainClient) {
-            this.chainClient = arg;
-        }
-        else if (ethers_1.Signer.isSigner(arg) || ethers_1.providers.Provider.isProvider(arg)) {
-            this.chainClient = new ChainClient_1.ChainClient(arg);
-        }
-        else {
-            throw new Error('Invalid constructor argument');
-        }
-    }
-    /**
-     * This function retrieves the MentoGovernor contract.
-     * @returns The MentoGovernor contract.
-     */
-    getGovernorContract() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const chainId = yield this.chainClient.getChainId();
-            const contracts = constants_1.addresses[chainId];
-            if (!contracts) {
-                throw new Error(`Contracts not deployed on network with chain id ${chainId}`);
-            }
-            const mentoGovernorAddress = contracts.MentoGovernor;
-            return mento_core_ts_1.MentoGovernor__factory.connect(mentoGovernorAddress, yield this.chainClient.getSigner());
-        });
-    }
-    /**
-     * Generates a transaction that submits a proposal to be created to the Mento Governor contract using the specified values.
-     * @param targets The addresses of the contracts to be called during proposal execution.
-     * @param values The values to be passed to the calls to the target contracts.
-     * @param calldatas The calldata to be passed to the calls to the target contracts.
-     * @param description A human readable description of the proposal.
-     * @returns The transaction request.
-     */
-    createProposal(targets, values, calldatas, description) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.validateProposalArgs(targets, values, calldatas, description);
-            const governor = yield this.getGovernorContract();
-            const tx = yield governor.populateTransaction['propose(address[],uint256[],bytes[],string)'](targets, values, calldatas, description);
-            return yield this.chainClient.populateTransaction(tx);
-        });
-    }
-    /**
-     * Generates a transaction that will queue the proposal with the specified id to be executed.
-     * @param proposalId The id of the proposal to queue.
-     * @returns The transaction request.
-     */
-    queueProposal(proposalId) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const governor = yield this.getGovernorContract();
-            const tx = yield governor.populateTransaction['queue(uint256)'](proposalId);
-            return yield this.chainClient.populateTransaction(tx);
-        });
-    }
-    /**
-     * Executes the proposal with the specified id.
-     * @param proposalId The id of the proposal to execute.
-     * @returns The transaction request.
-     */
-    executeProposal(proposalId) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const governor = yield this.getGovernorContract();
-            const tx = yield governor.populateTransaction['execute(uint256)'](proposalId);
-            return yield this.chainClient.populateTransaction(tx);
-        });
-    }
-    /**
-     * Submits a vote to the Mento Governor contract for the specified proposal.
-     * @param proposalId The id of the proposal to vote on.
-     * @param support Whether or not to support the proposal.
-     * @returns The transaction request.
-     */
-    castVote(proposalId, support) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const governor = yield this.getGovernorContract();
-            const tx = yield governor.populateTransaction.castVote(proposalId, support);
-            return yield this.chainClient.populateTransaction(tx);
-        });
-    }
-    /**
-     * Cancels the proposal with the specified id.
-     * @param proposalId The id of the proposal to vote on.
-     * @param support Whether or not to support the proposal.
-     * @returns The transaction request.
-     */
-    cancelProposal(proposalId) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const governor = yield this.getGovernorContract();
-            const tx = yield governor.populateTransaction.cancel(proposalId);
-            return yield this.chainClient.populateTransaction(tx);
-        });
-    }
-    /**
-     * Returns the state of the proposal with the specified id.
-     * @param proposalId The id of the proposal to get the state of.
-     * @returns The state of the proposal.
-     */
-    getProposalState(proposalId) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const governor = yield this.getGovernorContract();
-            const state = (yield governor.functions.state(proposalId))[0];
-            return enums_1.ProposalState[state];
-        });
-    }
-    /**
-     * This function validates the args that are to be used in the createProposal function.
-     * @param targets The addresses of the contracts to be called during proposal execution.
-     * @param values  The values to be passed to the calls to the target contracts.
-     * @param calldatas The calldata to be passed to the calls to the target contracts.
-     * @param description A human readable description of the proposal.
-     */
-    validateProposalArgs(targets, values, calldatas, description) {
-        if (!targets || targets.length === 0) {
-            throw new Error('Targets must be specified');
-        }
-        if (!values || values.length === 0) {
-            throw new Error('Values must be specified');
-        }
-        if (!calldatas || calldatas.length === 0) {
-            throw new Error('Calldatas must be specified');
-        }
-        if (!description) {
-            throw new Error('Description must be specified');
-        }
-        if (targets.length !== values.length ||
-            targets.length !== calldatas.length) {
-            throw new Error('Targets, values, and calldatas must all have the same length');
-        }
-    }
-}
-exports.Governance = Governance;

package/dist/cjs/index.d.ts

@@ -1,5 +0,0 @@
-export * from './mento';
-export * from './governance';
-export * from './utils';
-export * from './constants';
-export { ContractAddresses } from './types';

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

@@ -1,6 +0,0 @@
-import { ethers, providers } from 'ethers';
-export interface IChainClient {
-    getSigner(): Promise<ethers.Signer | providers.Provider>;
-    getChainId(): Promise<number>;
-    populateTransaction(tx: ethers.PopulatedTransaction): Promise<providers.TransactionRequest>;
-}

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

@@ -1,4 +0,0 @@
-export * from './tradingLimit';
-export * from './tradingLimitsConfig';
-export * from './tradingLimitsState';
-export * from './IChainClient';

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

@@ -1,7 +0,0 @@
-export type Address = string;
-export interface TradingLimit {
-    asset: Address;
-    maxIn: number;
-    maxOut: number;
-    until: number;
-}

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

@@ -1,10 +0,0 @@
-import { Address } from './tradingLimit';
-export interface TradingLimitsConfig {
-    asset: Address;
-    timestep0: number;
-    timestep1: number;
-    limit0: number;
-    limit1: number;
-    limitGlobal: number;
-    flags: number;
-}

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

@@ -1,9 +0,0 @@
-import { Address } from './tradingLimit';
-export interface TradingLimitsState {
-    asset: Address;
-    lastUpdated0: number;
-    lastUpdated1: number;
-    netflow0: number;
-    netflow1: number;
-    netflowGlobal: number;
-}

package/dist/cjs/interfaces/tradingLimitsState.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/limits.d.ts

@@ -1,33 +0,0 @@
-import { Address, TradingLimit, TradingLimitsConfig, TradingLimitsState } from './interfaces';
-import { Broker } from '@mento-protocol/mento-core-ts';
-/**
- * Returns the limit configuration in the broker for the given exchange and asset
- * @param broker an instance of the broker
- * @param exchangeId the id of the exchange
- * @param asset the address of the limited asset
- * @returns the limit configuration
- */
-export declare function getLimitsConfig(broker: Broker, exchangeId: string, asset: Address): Promise<TradingLimitsConfig>;
-/**
- * Returns the limit state in the broker for the given exchange and asset
- * @param broker an instance of the broker
- * @param exchangeId the id of the exchange
- * @param asset the address of the limited asset
- * @returns the limit state
- */
-export declare function getLimitsState(broker: Broker, exchangeId: string, asset: Address): Promise<TradingLimitsState>;
-/**
- * Returns a human-friendly representation of the limits for the given exchange and asset
- * @param broker an instance of the broker
- * @param exchangeId the id of the exchange
- * @param asset the address of the asset with the limit
- * @returns a list of TradingLimit objects
- */
-export declare function getLimits(broker: Broker, exchangeId: string, asset: Address): Promise<TradingLimit[]>;
-/**
- * Returns the limit id for the given exchange and asset
- * @param exchangeId the id of the exchange
- * @param asset the address of the asset with the limit
- * @returns the limit id
- */
-export declare function getLimitId(exchangeId: string, asset: Address): string;