@dydxprotocol/v4-client-js 0.30.0

package/build/src/index.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeJson = exports.NetworkOptimizer = exports.SocketClient = exports.FaucetClient = exports.ValidatorClient = exports.IndexerClient = exports.CompositeClient = exports.SubaccountClient = exports.LocalWallet = exports.onboarding = exports.validation = exports.utils = void 0;
+// Types.
+__exportStar(require("./types"), exports);
+// Utility functions.
+exports.utils = __importStar(require("./lib/utils"));
+exports.validation = __importStar(require("./lib/validation"));
+exports.onboarding = __importStar(require("./lib/onboarding"));
+var local_wallet_1 = require("./clients/modules/local-wallet");
+Object.defineProperty(exports, "LocalWallet", { enumerable: true, get: function () { return __importDefault(local_wallet_1).default; } });
+var subaccount_1 = require("./clients/subaccount");
+Object.defineProperty(exports, "SubaccountClient", { enumerable: true, get: function () { return subaccount_1.Subaccount; } });
+var composite_client_1 = require("./clients/composite-client");
+Object.defineProperty(exports, "CompositeClient", { enumerable: true, get: function () { return composite_client_1.CompositeClient; } });
+var indexer_client_1 = require("./clients/indexer-client");
+Object.defineProperty(exports, "IndexerClient", { enumerable: true, get: function () { return indexer_client_1.IndexerClient; } });
+var validator_client_1 = require("./clients/validator-client");
+Object.defineProperty(exports, "ValidatorClient", { enumerable: true, get: function () { return validator_client_1.ValidatorClient; } });
+var faucet_client_1 = require("./clients/faucet-client");
+Object.defineProperty(exports, "FaucetClient", { enumerable: true, get: function () { return faucet_client_1.FaucetClient; } });
+var socket_client_1 = require("./clients/socket-client");
+Object.defineProperty(exports, "SocketClient", { enumerable: true, get: function () { return socket_client_1.SocketClient; } });
+var network_optimizer_1 = require("./network_optimizer");
+Object.defineProperty(exports, "NetworkOptimizer", { enumerable: true, get: function () { return network_optimizer_1.NetworkOptimizer; } });
+var helpers_1 = require("./lib/helpers");
+Object.defineProperty(exports, "encodeJson", { enumerable: true, get: function () { return helpers_1.encodeJson; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxTQUFTO0FBQ1QsMENBQXdCO0FBRXhCLHFCQUFxQjtBQUNyQixxREFBcUM7QUFDckMsK0RBQStDO0FBQy9DLCtEQUErQztBQUUvQywrREFBd0U7QUFBL0QsNEhBQUEsT0FBTyxPQUFlO0FBQy9CLG1EQUFzRTtBQUE3RCw4R0FBQSxVQUFVLE9BQW9CO0FBQ3ZDLCtEQUE2RDtBQUFwRCxtSEFBQSxlQUFlLE9BQUE7QUFDeEIsMkRBQXlEO0FBQWhELCtHQUFBLGFBQWEsT0FBQTtBQUN0QiwrREFBNkQ7QUFBcEQsbUhBQUEsZUFBZSxPQUFBO0FBQ3hCLHlEQUF1RDtBQUE5Qyw2R0FBQSxZQUFZLE9BQUE7QUFDckIseURBQXVEO0FBQTlDLDZHQUFBLFlBQVksT0FBQTtBQUNyQix5REFBdUQ7QUFBOUMscUhBQUEsZ0JBQWdCLE9BQUE7QUFDekIseUNBQTJDO0FBQWxDLHFHQUFBLFVBQVUsT0FBQSJ9

package/build/src/lib/constants.d.ts

@@ -0,0 +1,15 @@
+import { GasPrice, StdFee } from '@cosmjs/stargate';
+export declare const BECH32_PREFIX = "dydx";
+export declare const BROADCAST_POLL_INTERVAL_MS: number;
+export declare const BROADCAST_TIMEOUT_MS: number;
+export declare const API_TIMEOUT_DEFAULT_MS: number;
+export declare const USDC_DENOM = "ibc/8E27BA2D5493AF5636760E354E46004562C46AB7EC0CC4C1CA14E9E20E2545B5";
+export declare const DYDX_DENOM = "dv4tnt";
+export declare const GAS_MULTIPLIER: number;
+export declare const GAS_PRICE: GasPrice;
+export declare const GAS_PRICE_DYDX_DENOM: GasPrice;
+export declare const ZERO_FEE: StdFee;
+export declare const MAX_UINT_32 = 4294967295;
+export declare const MAX_SUBACCOUNT_NUMBER = 127;
+export declare const DEFAULT_SEQUENCE: number;
+export declare const SERIALIZED_INT_ZERO: Uint8Array;

package/build/src/lib/constants.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERIALIZED_INT_ZERO = exports.DEFAULT_SEQUENCE = exports.MAX_SUBACCOUNT_NUMBER = exports.MAX_UINT_32 = exports.ZERO_FEE = exports.GAS_PRICE_DYDX_DENOM = exports.GAS_PRICE = exports.GAS_MULTIPLIER = exports.DYDX_DENOM = exports.USDC_DENOM = exports.API_TIMEOUT_DEFAULT_MS = exports.BROADCAST_TIMEOUT_MS = exports.BROADCAST_POLL_INTERVAL_MS = exports.BECH32_PREFIX = void 0;
+const stargate_1 = require("@cosmjs/stargate");
+// Bech32 Prefix
+exports.BECH32_PREFIX = 'dydx';
+// Broadcast Defaults
+exports.BROADCAST_POLL_INTERVAL_MS = 300;
+exports.BROADCAST_TIMEOUT_MS = 8000;
+// API Defaults
+exports.API_TIMEOUT_DEFAULT_MS = 5000;
+// Default placeholder USDC denom (same as protocol).
+// Precomputed USDC IBC denom.
+exports.USDC_DENOM = 'ibc/8E27BA2D5493AF5636760E354E46004562C46AB7EC0CC4C1CA14E9E20E2545B5';
+exports.DYDX_DENOM = 'dv4tnt';
+// Gas
+// TODO(DEC-1532): Determine why `MsgTransfer` messages return an innaccurate `GasUsed` value
+// from `/simulate`. 2x is quite high for a gas multipler (more standard is 1.1, or 1.3).
+exports.GAS_MULTIPLIER = 1.4;
+// TODO(CORE-190): Replace 'usdc' with IBC denom after IBC denom is supported in '@cosmjs/stargate'.
+exports.GAS_PRICE = stargate_1.GasPrice.fromString('0.1usdc');
+exports.GAS_PRICE_DYDX_DENOM = stargate_1.GasPrice.fromString('0.1dv4tnt');
+exports.ZERO_FEE = {
+    amount: [],
+    gas: '0',
+};
+// Validation
+exports.MAX_UINT_32 = 4294967295;
+exports.MAX_SUBACCOUNT_NUMBER = 127;
+exports.DEFAULT_SEQUENCE = 0;
+exports.SERIALIZED_INT_ZERO = Uint8Array.from([0x02]);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2xpYi9jb25zdGFudHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsK0NBQW9EO0FBRXBELGdCQUFnQjtBQUNILFFBQUEsYUFBYSxHQUFHLE1BQU0sQ0FBQztBQUVwQyxxQkFBcUI7QUFDUixRQUFBLDBCQUEwQixHQUFXLEdBQUcsQ0FBQztBQUN6QyxRQUFBLG9CQUFvQixHQUFXLElBQUssQ0FBQztBQUVsRCxlQUFlO0FBQ0YsUUFBQSxzQkFBc0IsR0FBVyxJQUFLLENBQUM7QUFFcEQscURBQXFEO0FBQ3JELDhCQUE4QjtBQUNqQixRQUFBLFVBQVUsR0FBRyxzRUFBc0UsQ0FBQztBQUNwRixRQUFBLFVBQVUsR0FBRyxRQUFRLENBQUM7QUFFbkMsTUFBTTtBQUNOLDZGQUE2RjtBQUM3Rix5RkFBeUY7QUFDNUUsUUFBQSxjQUFjLEdBQVcsR0FBRyxDQUFDO0FBQzFDLG9HQUFvRztBQUN2RixRQUFBLFNBQVMsR0FBYSxtQkFBUSxDQUFDLFVBQVUsQ0FBQyxTQUFTLENBQUMsQ0FBQztBQUNyRCxRQUFBLG9CQUFvQixHQUFhLG1CQUFRLENBQUMsVUFBVSxDQUFDLFdBQVcsQ0FBQyxDQUFDO0FBRWxFLFFBQUEsUUFBUSxHQUFXO0lBQzlCLE1BQU0sRUFBRSxFQUFFO0lBQ1YsR0FBRyxFQUFFLEdBQUc7Q0FDVCxDQUFDO0FBRUYsYUFBYTtBQUNBLFFBQUEsV0FBVyxHQUFHLFVBQWEsQ0FBQztBQUM1QixRQUFBLHFCQUFxQixHQUFHLEdBQUcsQ0FBQztBQUU1QixRQUFBLGdCQUFnQixHQUFXLENBQUMsQ0FBQztBQUU3QixRQUFBLG1CQUFtQixHQUFlLFVBQVUsQ0FBQyxJQUFJLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDIn0=

package/build/src/lib/errors.d.ts

@@ -0,0 +1,22 @@
+import { BroadcastTxSyncResponse } from '@cosmjs/tendermint-rpc/build/tendermint37';
+/**
+ * An edge-case was hit in the client that should never have been reached.
+ */
+export declare class UnexpectedClientError extends Error {
+    constructor();
+}
+/**
+ * An error occurred during the broadcasting process.
+ */
+export declare class BroadcastErrorObject extends Error {
+    result: BroadcastTxSyncResponse;
+    code: number;
+    codespace?: string;
+    constructor(message: string, result: BroadcastTxSyncResponse);
+}
+/**
+ * User error occurred during a client operation.
+ */
+export declare class UserError extends Error {
+    constructor(message: string);
+}

package/build/src/lib/errors.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserError = exports.BroadcastErrorObject = exports.UnexpectedClientError = void 0;
+/**
+ * An edge-case was hit in the client that should never have been reached.
+ */
+class UnexpectedClientError extends Error {
+    constructor() {
+        super('An unexpected error occurred on the client');
+        this.name = 'UnexpectedClientError';
+    }
+}
+exports.UnexpectedClientError = UnexpectedClientError;
+/**
+ * An error occurred during the broadcasting process.
+ */
+class BroadcastErrorObject extends Error {
+    constructor(message, result) {
+        super(message);
+        this.name = 'BroadcastError';
+        this.result = result;
+        this.code = result.code;
+        this.codespace = result.codespace;
+    }
+}
+exports.BroadcastErrorObject = BroadcastErrorObject;
+/**
+ * User error occurred during a client operation.
+ */
+class UserError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UserError';
+    }
+}
+exports.UserError = UserError;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2xpYi9lcnJvcnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBSUE7O0dBRUc7QUFDSCxNQUFhLHFCQUFzQixTQUFRLEtBQUs7SUFDOUM7UUFFRSxLQUFLLENBQUMsNENBQTRDLENBQUMsQ0FBQztRQUNwRCxJQUFJLENBQUMsSUFBSSxHQUFHLHVCQUF1QixDQUFDO0lBQ3RDLENBQUM7Q0FDRjtBQU5ELHNEQU1DO0FBRUQ7O0dBRUc7QUFDSCxNQUFhLG9CQUFxQixTQUFRLEtBQUs7SUFLN0MsWUFDRSxPQUFlLEVBQ2YsTUFBK0I7UUFFL0IsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ2YsSUFBSSxDQUFDLElBQUksR0FBRyxnQkFBZ0IsQ0FBQztRQUM3QixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztRQUNyQixJQUFJLENBQUMsSUFBSSxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUM7UUFDeEIsSUFBSSxDQUFDLFNBQVMsR0FBRyxNQUFNLENBQUMsU0FBUyxDQUFDO0lBQ3BDLENBQUM7Q0FDRjtBQWZELG9EQWVDO0FBRUQ7O0dBRUc7QUFDSCxNQUFhLFNBQVUsU0FBUSxLQUFLO0lBQ2xDLFlBQVksT0FBZTtRQUN6QixLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDZixJQUFJLENBQUMsSUFBSSxHQUFHLFdBQVcsQ0FBQztJQUMxQixDQUFDO0NBQ0Y7QUFMRCw4QkFLQyJ9

package/build/src/lib/helpers.d.ts

@@ -0,0 +1,16 @@
+import { PartialTransactionOptions, TransactionOptions } from '../types';
+/**
+ * @description Either return undefined or insert default sequence value into
+ * `partialTransactionOptions` if it does not exist.
+ *
+ * @returns undefined or full TransactionOptions.
+ */
+export declare function convertPartialTransactionOptionsToFull(partialTransactionOptions?: PartialTransactionOptions): TransactionOptions | undefined;
+/**
+ * @description Strip '0x' prefix from input string. If there is no '0x' prefix, return the original
+ * input.
+ *
+ * @returns input without '0x' prefix or original input if no prefix.
+ */
+export declare function stripHexPrefix(input: string): string;
+export declare function encodeJson(object?: Object): string;

package/build/src/lib/helpers.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeJson = exports.stripHexPrefix = exports.convertPartialTransactionOptionsToFull = void 0;
+const encoding_1 = require("@cosmjs/encoding");
+const bignumber_js_1 = __importDefault(require("bignumber.js"));
+const long_1 = __importDefault(require("long"));
+const constants_1 = require("./constants");
+/**
+ * @description Either return undefined or insert default sequence value into
+ * `partialTransactionOptions` if it does not exist.
+ *
+ * @returns undefined or full TransactionOptions.
+ */
+function convertPartialTransactionOptionsToFull(partialTransactionOptions) {
+    if (partialTransactionOptions === undefined) {
+        return undefined;
+    }
+    return {
+        sequence: constants_1.DEFAULT_SEQUENCE,
+        ...partialTransactionOptions,
+    };
+}
+exports.convertPartialTransactionOptionsToFull = convertPartialTransactionOptionsToFull;
+/**
+ * @description Strip '0x' prefix from input string. If there is no '0x' prefix, return the original
+ * input.
+ *
+ * @returns input without '0x' prefix or original input if no prefix.
+ */
+function stripHexPrefix(input) {
+    if (input.indexOf('0x') === 0) {
+        return input.slice(2);
+    }
+    return input;
+}
+exports.stripHexPrefix = stripHexPrefix;
+function encodeJson(object) {
+    // eslint-disable-next-line prefer-arrow-callback
+    return JSON.stringify(object, function replacer(_key, value) {
+        // Even though we set the an UInt8Array as the value,
+        // it comes in here as an object with UInt8Array as the buffer property.
+        if (value instanceof bignumber_js_1.default) {
+            return value.toString();
+        }
+        if (value instanceof long_1.default) {
+            return value.toString();
+        }
+        if ((value === null || value === void 0 ? void 0 : value.buffer) instanceof Uint8Array) {
+            return (0, encoding_1.toHex)(value.buffer);
+        }
+        else if (value instanceof Uint8Array) {
+            return (0, encoding_1.toHex)(value);
+        }
+        return value;
+    });
+}
+exports.encodeJson = encodeJson;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVycy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvaGVscGVycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQSwrQ0FBeUM7QUFDekMsZ0VBQXFDO0FBQ3JDLGdEQUF3QjtBQUd4QiwyQ0FBK0M7QUFFL0M7Ozs7O0dBS0c7QUFDSCxTQUFnQixzQ0FBc0MsQ0FDcEQseUJBQXFEO0lBRXJELElBQUkseUJBQXlCLEtBQUssU0FBUyxFQUFFO1FBQzNDLE9BQU8sU0FBUyxDQUFDO0tBQ2xCO0lBRUQsT0FBTztRQUNMLFFBQVEsRUFBRSw0QkFBZ0I7UUFDMUIsR0FBRyx5QkFBeUI7S0FDN0IsQ0FBQztBQUNKLENBQUM7QUFYRCx3RkFXQztBQUVEOzs7OztHQUtHO0FBQ0gsU0FBZ0IsY0FBYyxDQUFDLEtBQWE7SUFDMUMsSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsRUFBRTtRQUM3QixPQUFPLEtBQUssQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUM7S0FDdkI7SUFFRCxPQUFPLEtBQUssQ0FBQztBQUNmLENBQUM7QUFORCx3Q0FNQztBQUVELFNBQWdCLFVBQVUsQ0FBQyxNQUFlO0lBQ3hDLGlEQUFpRDtJQUNqRCxPQUFPLElBQUksQ0FBQyxTQUFTLENBQUMsTUFBTSxFQUFFLFNBQVMsUUFBUSxDQUFDLElBQUksRUFBRSxLQUFLO1FBQ3pELHFEQUFxRDtRQUNyRCx3RUFBd0U7UUFDeEUsSUFBSSxLQUFLLFlBQVksc0JBQVMsRUFBRTtZQUM5QixPQUFPLEtBQUssQ0FBQyxRQUFRLEVBQUUsQ0FBQztTQUN6QjtRQUNELElBQUksS0FBSyxZQUFZLGNBQUksRUFBRTtZQUN6QixPQUFPLEtBQUssQ0FBQyxRQUFRLEVBQUUsQ0FBQztTQUN6QjtRQUNELElBQUksQ0FBQSxLQUFLLGFBQUwsS0FBSyx1QkFBTCxLQUFLLENBQUUsTUFBTSxhQUFZLFVBQVUsRUFBRTtZQUN2QyxPQUFPLElBQUEsZ0JBQUssRUFBQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUM7U0FDNUI7YUFBTSxJQUFJLEtBQUssWUFBWSxVQUFVLEVBQUU7WUFDdEMsT0FBTyxJQUFBLGdCQUFLLEVBQUMsS0FBSyxDQUFDLENBQUM7U0FDckI7UUFDRCxPQUFPLEtBQUssQ0FBQztJQUNmLENBQUMsQ0FBQyxDQUFDO0FBQ0wsQ0FBQztBQWxCRCxnQ0FrQkMifQ==

package/build/src/lib/onboarding.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @description Get Mnemonic and priv/pub keys from privateKeyBytes and BIP44 HD path
+ *
+ * @url https://github.com/confio/cosmos-hd-key-derivation-spec#bip44
+ *
+ * @param entropy used to generate mnemonic
+ *
+ * @param path BIP44 HD Path. Default is The Cosmos Hub path
+ *
+ * @throws Error if the hdkey does not exist
+ *
+ * @returns Mnemonic and priv/pub keys
+ */
+export declare const exportMnemonicAndPrivateKey: (entropy: Uint8Array, path?: string) => {
+    mnemonic: string;
+    privateKey: Uint8Array | null;
+    publicKey: Uint8Array | null;
+};
+/**
+ * @description Get private information for onboarding using an Ethereum Signature.
+ *
+ * @returns Mnemonic and Public/Private HD keys
+ */
+export declare const deriveHDKeyFromEthereumSignature: (signature: string) => {
+    mnemonic: string;
+    privateKey: Uint8Array | null;
+    publicKey: Uint8Array | null;
+};

package/build/src/lib/onboarding.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveHDKeyFromEthereumSignature = exports.exportMnemonicAndPrivateKey = void 0;
+const bip32_1 = require("@scure/bip32");
+const bip39_1 = require("@scure/bip39");
+const english_1 = require("@scure/bip39/wordlists/english");
+const keccak_1 = require("ethereum-cryptography/keccak");
+const helpers_1 = require("./helpers");
+/**
+ * @description Get Mnemonic and priv/pub keys from privateKeyBytes and BIP44 HD path
+ *
+ * @url https://github.com/confio/cosmos-hd-key-derivation-spec#bip44
+ *
+ * @param entropy used to generate mnemonic
+ *
+ * @param path BIP44 HD Path. Default is The Cosmos Hub path
+ *
+ * @throws Error if the hdkey does not exist
+ *
+ * @returns Mnemonic and priv/pub keys
+ */
+const exportMnemonicAndPrivateKey = (entropy, path = "m/44'/118'/0'/0/0") => {
+    const mnemonic = (0, bip39_1.entropyToMnemonic)(entropy, english_1.wordlist);
+    const seed = (0, bip39_1.mnemonicToSeedSync)(mnemonic);
+    const hdkey = bip32_1.HDKey.fromMasterSeed(seed);
+    const derivedHdkey = hdkey.derive(path);
+    if (!hdkey.privateKey) {
+        throw new Error('null hd key');
+    }
+    return {
+        mnemonic,
+        privateKey: derivedHdkey.privateKey,
+        publicKey: derivedHdkey.publicKey,
+    };
+};
+exports.exportMnemonicAndPrivateKey = exportMnemonicAndPrivateKey;
+/**
+ * @description Get private information for onboarding using an Ethereum Signature.
+ *
+ * @returns Mnemonic and Public/Private HD keys
+ */
+const deriveHDKeyFromEthereumSignature = (signature) => {
+    const buffer = Buffer.from((0, helpers_1.stripHexPrefix)(signature), 'hex');
+    if (buffer.length !== 65) {
+        throw new Error('Signature must be 65 bytes');
+    }
+    // Remove the 'v' value by taking only the first 64 bytes of the signature
+    const rsValues = buffer.subarray(0, 64);
+    // Hash the 'r' and 's' values down to 32 bytes (256 bits) using Keccak-256
+    const entropy = (0, keccak_1.keccak256)(rsValues);
+    return (0, exports.exportMnemonicAndPrivateKey)(entropy);
+};
+exports.deriveHDKeyFromEthereumSignature = deriveHDKeyFromEthereumSignature;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib25ib2FyZGluZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvb25ib2FyZGluZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSx3Q0FBcUM7QUFDckMsd0NBQXFFO0FBQ3JFLDREQUEwRDtBQUMxRCx5REFBeUQ7QUFFekQsdUNBQTJDO0FBRTNDOzs7Ozs7Ozs7Ozs7R0FZRztBQUNJLE1BQU0sMkJBQTJCLEdBQUcsQ0FBQyxPQUFtQixFQUFFLE9BQWUsbUJBQW1CLEVBSWpHLEVBQUU7SUFDRixNQUFNLFFBQVEsR0FBRyxJQUFBLHlCQUFpQixFQUFDLE9BQU8sRUFBRSxrQkFBUSxDQUFDLENBQUM7SUFDdEQsTUFBTSxJQUFJLEdBQUcsSUFBQSwwQkFBa0IsRUFBQyxRQUFRLENBQUMsQ0FBQztJQUUxQyxNQUFNLEtBQUssR0FBRyxhQUFLLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ3pDLE1BQU0sWUFBWSxHQUFHLEtBQUssQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUM7SUFFeEMsSUFBSSxDQUFDLEtBQUssQ0FBQyxVQUFVLEVBQUU7UUFDckIsTUFBTSxJQUFJLEtBQUssQ0FBQyxhQUFhLENBQUMsQ0FBQztLQUNoQztJQUVELE9BQU87UUFDTCxRQUFRO1FBQ1IsVUFBVSxFQUFFLFlBQVksQ0FBQyxVQUFVO1FBQ25DLFNBQVMsRUFBRSxZQUFZLENBQUMsU0FBUztLQUNsQyxDQUFDO0FBQ0osQ0FBQyxDQUFDO0FBcEJXLFFBQUEsMkJBQTJCLCtCQW9CdEM7QUFFRjs7OztHQUlHO0FBQ0ksTUFBTSxnQ0FBZ0MsR0FBRyxDQUFDLFNBQWlCLEVBSWhFLEVBQUU7SUFDRixNQUFNLE1BQU0sR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUEsd0JBQWMsRUFBQyxTQUFTLENBQUMsRUFBRSxLQUFLLENBQUMsQ0FBQztJQUU3RCxJQUFJLE1BQU0sQ0FBQyxNQUFNLEtBQUssRUFBRSxFQUFFO1FBQ3hCLE1BQU0sSUFBSSxLQUFLLENBQUMsNEJBQTRCLENBQUMsQ0FBQztLQUMvQztJQUVELDBFQUEwRTtJQUMxRSxNQUFNLFFBQVEsR0FBRyxNQUFNLENBQUMsUUFBUSxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQztJQUN4QywyRUFBMkU7SUFDM0UsTUFBTSxPQUFPLEdBQUcsSUFBQSxrQkFBUyxFQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQ3BDLE9BQU8sSUFBQSxtQ0FBMkIsRUFBQyxPQUFPLENBQUMsQ0FBQztBQUM5QyxDQUFDLENBQUM7QUFoQlcsUUFBQSxnQ0FBZ0Msb0NBZ0IzQyJ9

package/build/src/lib/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns a random integer value between 0 and (n-1).
+ */
+export declare function randomInt(n: number): number;
+/**
+ * Generate a random clientId.
+ */
+export declare function generateRandomClientId(): number;
+/**
+ * Deterministically generate a valid clientId from an arbitrary string by performing a
+ * quick hashing function on the string.
+ */
+export declare function clientIdFromString(input: string): number;

package/build/src/lib/utils.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clientIdFromString = exports.generateRandomClientId = exports.randomInt = void 0;
+const constants_1 = require("../clients/constants");
+/**
+ * Returns a random integer value between 0 and (n-1).
+ */
+function randomInt(n) {
+    return Math.floor(Math.random() * n);
+}
+exports.randomInt = randomInt;
+/**
+ * Generate a random clientId.
+ */
+function generateRandomClientId() {
+    return randomInt(constants_1.MAX_UINT_32 + 1);
+}
+exports.generateRandomClientId = generateRandomClientId;
+/**
+ * Deterministically generate a valid clientId from an arbitrary string by performing a
+ * quick hashing function on the string.
+ */
+function clientIdFromString(input) {
+    let hash = 0;
+    if (input.length === 0)
+        return hash;
+    for (let i = 0; i < input.length; i++) {
+        hash = ((hash << 5) - hash) + input.charCodeAt(i); // eslint-disable-line no-bitwise
+        hash |= 0; // eslint-disable-line no-bitwise
+    }
+    // Bitwise operators covert the value to a 32-bit integer.
+    // We must coerce this into a 32-bit unsigned integer.
+    return hash + (2 ** 31);
+}
+exports.clientIdFromString = clientIdFromString;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL3V0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLG9EQUFtRDtBQUVuRDs7R0FFRztBQUNILFNBQWdCLFNBQVMsQ0FDdkIsQ0FBUztJQUVULE9BQU8sSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsTUFBTSxFQUFFLEdBQUcsQ0FBQyxDQUFDLENBQUM7QUFDdkMsQ0FBQztBQUpELDhCQUlDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixzQkFBc0I7SUFDcEMsT0FBTyxTQUFTLENBQUMsdUJBQVcsR0FBRyxDQUFDLENBQUMsQ0FBQztBQUNwQyxDQUFDO0FBRkQsd0RBRUM7QUFFRDs7O0dBR0c7QUFDSCxTQUFnQixrQkFBa0IsQ0FDaEMsS0FBYTtJQUViLElBQUksSUFBSSxHQUFXLENBQUMsQ0FBQztJQUNyQixJQUFJLEtBQUssQ0FBQyxNQUFNLEtBQUssQ0FBQztRQUFFLE9BQU8sSUFBSSxDQUFDO0lBQ3BDLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxLQUFLLENBQUMsTUFBTSxFQUFFLENBQUMsRUFBRSxFQUFFO1FBQ3JDLElBQUksR0FBRyxDQUFDLENBQUMsSUFBSSxJQUFJLENBQUMsQ0FBQyxHQUFHLElBQUksQ0FBQyxHQUFHLEtBQUssQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxpQ0FBaUM7UUFDcEYsSUFBSSxJQUFJLENBQUMsQ0FBQyxDQUFDLGlDQUFpQztLQUM3QztJQUVELDBEQUEwRDtJQUMxRCxzREFBc0Q7SUFDdEQsT0FBTyxJQUFJLEdBQUcsQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDLENBQUM7QUFDMUIsQ0FBQztBQWJELGdEQWFDIn0=

package/build/src/lib/validation.d.ts

@@ -0,0 +1,18 @@
+import { Transfer, ICancelOrder, IPlaceOrder } from '../clients/types';
+import { UserError } from './errors';
+/**
+ * @describe validatePlaceOrderMessage validates that an order to place has fields that would be
+ *  valid on-chain.
+ */
+export declare function validatePlaceOrderMessage(subaccountNumber: number, order: IPlaceOrder): UserError | undefined;
+/**
+ * @describe validateCancelOrderMessage validates that an order to cancel has fields that would be
+ *  valid on-chain.
+ */
+export declare function validateCancelOrderMessage(subaccountNumber: number, order: ICancelOrder): UserError | undefined;
+/**
+ * @describe validateTransferMessage validates that a transfer to place has fields that would be
+ *  valid on-chain.
+ */
+export declare function validateTransferMessage(transfer: Transfer): UserError | undefined;
+export declare function isValidAddress(address: string): boolean;

package/build/src/lib/validation.js

@@ -0,0 +1,123 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidAddress = exports.validateTransferMessage = exports.validateCancelOrderMessage = exports.validatePlaceOrderMessage = void 0;
+const bech32_1 = require("bech32");
+const long_1 = __importDefault(require("long"));
+const constants_1 = require("../clients/constants");
+const types_1 = require("../clients/types");
+const errors_1 = require("./errors");
+/**
+ * @describe validatePlaceOrderMessage validates that an order to place has fields that would be
+ *  valid on-chain.
+ */
+function validatePlaceOrderMessage(subaccountNumber, order) {
+    if (!verifyNumberIsUint32(order.clientId)) {
+        return new errors_1.UserError(`clientId: ${order.clientId} is not a valid uint32`);
+    }
+    if (order.quantums.lessThanOrEqual(long_1.default.ZERO)) {
+        return new errors_1.UserError(`quantums: ${order.quantums} cannot be <= 0`);
+    }
+    if (order.subticks.lessThanOrEqual(long_1.default.ZERO)) {
+        return new errors_1.UserError(`subticks: ${order.subticks} cannot be <= 0`);
+    }
+    if (!verifySubaccountNumber(subaccountNumber)) {
+        return new errors_1.UserError(`subaccountNumber: ${subaccountNumber} cannot be < 0 or > ${constants_1.MAX_SUBACCOUNT_NUMBER}`);
+    }
+    if (!isStatefulOrder(order.orderFlags) && !verifyGoodTilBlock(order.goodTilBlock)) {
+        return new errors_1.UserError(`goodTilBlock: ${order.goodTilBlock} is not a valid uint32 or is 0`);
+    }
+    if (isStatefulOrder(order.orderFlags) && !verifyGoodTilBlockTime(order.goodTilBlockTime)) {
+        return new errors_1.UserError(`goodTilBlockTime: ${order.goodTilBlockTime} is not a valid uint32 or is 0`);
+    }
+    return undefined;
+}
+exports.validatePlaceOrderMessage = validatePlaceOrderMessage;
+/**
+ * @describe validateCancelOrderMessage validates that an order to cancel has fields that would be
+ *  valid on-chain.
+ */
+function validateCancelOrderMessage(subaccountNumber, order) {
+    if (!verifyNumberIsUint32(order.clientId)) {
+        return new errors_1.UserError(`clientId: ${order.clientId} is not a valid uint32`);
+    }
+    if (!isStatefulOrder(order.orderFlags) && !verifyGoodTilBlock(order.goodTilBlock)) {
+        return new errors_1.UserError(`goodTilBlock: ${order.goodTilBlock} is not a valid uint32 or is 0`);
+    }
+    if (!isStatefulOrder(order.orderFlags) && order.goodTilBlockTime !== undefined) {
+        return new errors_1.UserError(`goodTilBlockTime is ${order.goodTilBlockTime}, but should not be set for non-stateful orders`);
+    }
+    if (isStatefulOrder(order.orderFlags) && !verifyGoodTilBlockTime(order.goodTilBlockTime)) {
+        return new errors_1.UserError(`goodTilBlockTime: ${order.goodTilBlockTime} is not a valid uint32 or is 0`);
+    }
+    if (isStatefulOrder(order.orderFlags) && order.goodTilBlock !== undefined) {
+        return new errors_1.UserError(`goodTilBlock is ${order.goodTilBlock}, but should not be set for stateful orders`);
+    }
+    if (!verifySubaccountNumber(subaccountNumber)) {
+        return new errors_1.UserError(`subaccountNumber: ${subaccountNumber} cannot be < 0 or > ${constants_1.MAX_SUBACCOUNT_NUMBER}`);
+    }
+    return undefined;
+}
+exports.validateCancelOrderMessage = validateCancelOrderMessage;
+/**
+ * @describe validateTransferMessage validates that a transfer to place has fields that would be
+ *  valid on-chain.
+ */
+function validateTransferMessage(transfer) {
+    if (!verifySubaccountNumber(transfer.sender.number || 0)) {
+        return new errors_1.UserError(`senderSubaccountNumber: ${transfer.sender.number || 0} cannot be < 0 or > ${constants_1.MAX_SUBACCOUNT_NUMBER}`);
+    }
+    if (!verifySubaccountNumber(transfer.recipient.number || 0)) {
+        return new errors_1.UserError(`recipientSubaccountNumber: ${transfer.recipient.number || 0} cannot be < 0 or > ${constants_1.MAX_SUBACCOUNT_NUMBER}`);
+    }
+    if (transfer.assetId !== 0) {
+        return new errors_1.UserError(`asset id: ${transfer.assetId} not supported`);
+    }
+    if (transfer.amount.lessThanOrEqual(long_1.default.ZERO)) {
+        return new errors_1.UserError(`amount: ${transfer.amount} cannot be <= 0`);
+    }
+    const addressError = verifyIsBech32(transfer.recipient.owner);
+    if (addressError !== undefined) {
+        return new errors_1.UserError(addressError.toString());
+    }
+    return undefined;
+}
+exports.validateTransferMessage = validateTransferMessage;
+function verifyGoodTilBlock(goodTilBlock) {
+    if (goodTilBlock === undefined) {
+        return false;
+    }
+    return verifyNumberIsUint32(goodTilBlock) && goodTilBlock > 0;
+}
+function verifyGoodTilBlockTime(goodTilBlockTime) {
+    if (goodTilBlockTime === undefined) {
+        return false;
+    }
+    return verifyNumberIsUint32(goodTilBlockTime) && goodTilBlockTime > 0;
+}
+function verifySubaccountNumber(subaccountNumber) {
+    return subaccountNumber >= 0 && subaccountNumber <= constants_1.MAX_SUBACCOUNT_NUMBER;
+}
+function verifyNumberIsUint32(num) {
+    return num >= 0 && num <= constants_1.MAX_UINT_32;
+}
+function isStatefulOrder(orderFlags) {
+    return orderFlags === types_1.OrderFlags.LONG_TERM || orderFlags === types_1.OrderFlags.CONDITIONAL;
+}
+function verifyIsBech32(address) {
+    try {
+        (0, bech32_1.decode)(address);
+    }
+    catch (error) {
+        return error;
+    }
+    return undefined;
+}
+function isValidAddress(address) {
+    // An address is valid if it starts with `dydx1` and is Bech32 format.
+    return address.startsWith('dydx1') && (verifyIsBech32(address) === undefined);
+}
+exports.isValidAddress = isValidAddress;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvdmFsaWRhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQSxtQ0FBZ0M7QUFDaEMsZ0RBQXdCO0FBRXhCLG9EQUEwRTtBQUMxRSw0Q0FLMEI7QUFDMUIscUNBQXFDO0FBRXJDOzs7R0FHRztBQUNILFNBQWdCLHlCQUF5QixDQUN2QyxnQkFBd0IsRUFDeEIsS0FBa0I7SUFFbEIsSUFBSSxDQUFDLG9CQUFvQixDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsRUFBRTtRQUN6QyxPQUFPLElBQUksa0JBQVMsQ0FBQyxhQUFhLEtBQUssQ0FBQyxRQUFRLHdCQUF3QixDQUFDLENBQUM7S0FDM0U7SUFDRCxJQUFJLEtBQUssQ0FBQyxRQUFRLENBQUMsZUFBZSxDQUFDLGNBQUksQ0FBQyxJQUFJLENBQUMsRUFBRTtRQUM3QyxPQUFPLElBQUksa0JBQVMsQ0FBQyxhQUFhLEtBQUssQ0FBQyxRQUFRLGlCQUFpQixDQUFDLENBQUM7S0FDcEU7SUFDRCxJQUFJLEtBQUssQ0FBQyxRQUFRLENBQUMsZUFBZSxDQUFDLGNBQUksQ0FBQyxJQUFJLENBQUMsRUFBRTtRQUM3QyxPQUFPLElBQUksa0JBQVMsQ0FBQyxhQUFhLEtBQUssQ0FBQyxRQUFRLGlCQUFpQixDQUFDLENBQUM7S0FDcEU7SUFDRCxJQUFJLENBQUMsc0JBQXNCLENBQUMsZ0JBQWdCLENBQUMsRUFBRTtRQUM3QyxPQUFPLElBQUksa0JBQVMsQ0FDbEIscUJBQXFCLGdCQUFnQix1QkFBdUIsaUNBQXFCLEVBQUUsQ0FDcEYsQ0FBQztLQUNIO0lBQ0QsSUFBSSxDQUFDLGVBQWUsQ0FBQyxLQUFLLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxrQkFBa0IsQ0FBQyxLQUFLLENBQUMsWUFBWSxDQUFDLEVBQUU7UUFDakYsT0FBTyxJQUFJLGtCQUFTLENBQUMsaUJBQWlCLEtBQUssQ0FBQyxZQUFZ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

package/build/src/network_optimizer.d.ts

@@ -0,0 +1,5 @@
+export declare const isTruthy: <T>(n?: false | 0 | T | null | undefined) => n is T;
+export declare class NetworkOptimizer {
+    private validatorClients;
+    findOptimalNode(endpointUrls: string[], chainId: string): Promise<string>;
+}

package/build/src/network_optimizer.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkOptimizer = exports.isTruthy = void 0;
+const validator_client_1 = require("./clients/validator-client");
+const helpers_1 = require("./lib/helpers");
+const types_1 = require("./types");
+class PingResponse {
+    constructor(block) {
+        this.block = block;
+        this.responseTime = new Date();
+    }
+}
+const isTruthy = (n) => Boolean(n);
+exports.isTruthy = isTruthy;
+class NetworkOptimizer {
+    async validatorClients(endpointUrls, chainId) {
+        return (await Promise.all(endpointUrls.map((endpointUrl) => validator_client_1.ValidatorClient.connect(new types_1.ValidatorConfig(endpointUrl, chainId))
+            .catch((_) => undefined)))).filter(exports.isTruthy);
+    }
+    async findOptimalNode(endpointUrls, chainId) {
+        if (endpointUrls.length === 0) {
+            const errorResponse = {
+                error: {
+                    message: 'No nodes provided',
+                },
+            };
+            return (0, helpers_1.encodeJson)(errorResponse);
+        }
+        const clients = await this.validatorClients(endpointUrls, chainId);
+        const responses = (await Promise.all(clients
+            .map(async (client) => {
+            const block = await client.get.latestBlock();
+            const response = new PingResponse(block);
+            return {
+                endpoint: client.config.restEndpoint,
+                height: response.block.header.height,
+                time: response.responseTime.getTime(),
+            };
+        })
+            .map((promise) => promise.catch((_) => undefined)))).filter(exports.isTruthy);
+        if (responses.length === 0) {
+            throw new Error('Could not connect to endpoints');
+        }
+        const maxHeight = Math.max(...responses.map(({ height }) => height));
+        return responses
+            // Only consider nodes at `maxHeight`
+            .filter(({ height }) => height === maxHeight)
+            // Return the endpoint with the fastest response time
+            .sort((a, b) => a.time - b.time)[0]
+            .endpoint;
+    }
+}
+exports.NetworkOptimizer = NetworkOptimizer;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibmV0d29ya19vcHRpbWl6ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbmV0d29ya19vcHRpbWl6ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBRUEsaUVBQTZEO0FBQzdELDJDQUEyQztBQUMzQyxtQ0FBMEM7QUFFMUMsTUFBTSxZQUFZO0lBS2QsWUFDRSxLQUFZO1FBRVosSUFBSSxDQUFDLEtBQUssR0FBRyxLQUFLLENBQUM7UUFDbkIsSUFBSSxDQUFDLFlBQVksR0FBRyxJQUFJLElBQUksRUFBRSxDQUFDO0lBQ2pDLENBQUM7Q0FDSjtBQUVNLE1BQU0sUUFBUSxHQUFHLENBQUksQ0FBb0MsRUFBVSxFQUFFLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDO0FBQTNFLFFBQUEsUUFBUSxZQUFtRTtBQUV4RixNQUFhLGdCQUFnQjtJQUNuQixLQUFLLENBQUMsZ0JBQWdCLENBQzVCLFlBQXNCLEVBQ3RCLE9BQWU7UUFFZixPQUFPLENBQUMsTUFBTSxPQUFPLENBQUMsR0FBRyxDQUN2QixZQUFZLENBQUMsR0FBRyxDQUFDLENBQUMsV0FBVyxFQUFFLEVBQUUsQ0FBQyxrQ0FBZSxDQUFDLE9BQU8sQ0FDdkQsSUFBSSx1QkFBZSxDQUFDLFdBQVcsRUFBRSxPQUFPLENBQUMsQ0FBQzthQUN6QyxLQUFLLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLFNBQVMsQ0FBQyxDQUN6QixDQUNGLENBQUMsQ0FBQyxNQUFNLENBQUMsZ0JBQVEsQ0FBQyxDQUFDO0lBQ3RCLENBQUM7SUFFRCxLQUFLLENBQUMsZUFBZSxDQUFDLFlBQXNCLEVBQUUsT0FBZTtRQUMzRCxJQUFJLFlBQVksQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFO1lBQzdCLE1BQU0sYUFBYSxHQUFHO2dCQUNwQixLQUFLLEVBQUU7b0JBQ0wsT0FBTyxFQUFFLG1CQUFtQjtpQkFDN0I7YUFDRixDQUFDO1lBQ0YsT0FBTyxJQUFBLG9CQUFVLEVBQUMsYUFBYSxDQUFDLENBQUM7U0FDbEM7UUFDRCxNQUFNLE9BQU8sR0FBRyxNQUFNLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxZQUFZLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFDbkUsTUFBTSxTQUFTLEdBQUcsQ0FBQyxNQUFNLE9BQU8sQ0FBQyxHQUFHLENBQ2xDLE9BQU87YUFDSixHQUFHLENBQUMsS0FBSyxFQUFFLE1BQU0sRUFBRSxFQUFFO1lBQ3BCLE1BQU0sS0FBSyxHQUFHLE1BQU0sTUFBTSxDQUFDLEdBQUcsQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUM3QyxNQUFNLFFBQVEsR0FBRyxJQUFJLFlBQVksQ0FBQyxLQUFLLENBQUMsQ0FBQztZQUN6QyxPQUFPO2dCQUNMLFFBQVEsRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLFlBQVk7Z0JBQ3BDLE1BQU0sRUFBRSxRQUFRLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxNQUFNO2dCQUNwQyxJQUFJLEVBQUUsUUFBUSxDQUFDLFlBQVksQ0FBQyxPQUFPLEVBQUU7YUFDdEMsQ0FBQztRQUNKLENBQUMsQ0FBQzthQUNELEdBQUcsQ0FBQyxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FDckQsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxnQkFBUSxDQUFDLENBQUM7UUFFcEIsSUFBSSxTQUFTLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRTtZQUMxQixNQUFNLElBQUksS0FBSyxDQUFDLGdDQUFnQyxDQUFDLENBQUM7U0FDbkQ7UUFDRCxNQUFNLFNBQVMsR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLEdBQUcsU0FBUyxDQUFDLEdBQUcsQ0FBQyxDQUFDLEVBQUUsTUFBTSxFQUFFLEVBQUUsRUFBRSxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUM7UUFDckUsT0FBTyxTQUFTO1lBQ2hCLHFDQUFxQzthQUNsQyxNQUFNLENBQUMsQ0FBQyxFQUFFLE1BQU0sRUFBRSxFQUFFLEVBQUUsQ0FBQyxNQUFNLEtBQUssU0FBUyxDQUFDO1lBQy9DLHFEQUFxRDthQUNsRCxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxHQUFHLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7YUFDbEMsUUFBUSxDQUFDO0lBQ2QsQ0FBQztDQUNGO0FBaERELDRDQWdEQyJ9

package/build/src/types.d.ts

@@ -0,0 +1,35 @@
+import { StdFee } from '@cosmjs/amino';
+import { Method } from '@cosmjs/tendermint-rpc';
+import { TransactionOptions } from './clients/types';
+export * from './clients/types';
+export * from './clients/constants';
+export interface BroadcastOptions {
+    broadcastPollIntervalMs: number;
+    broadcastTimeoutMs: number;
+}
+export interface ApiOptions {
+    faucetHost?: string;
+    indexerHost?: string;
+    timeout?: number;
+}
+export declare type BroadcastMode = (Method.BroadcastTxAsync | Method.BroadcastTxSync | Method.BroadcastTxCommit);
+export interface Options {
+    transactionOptions?: TransactionOptions;
+    memo?: string;
+    broadcastMode?: BroadcastMode;
+    fee?: StdFee;
+}
+export declare enum ClobPairId {
+    PERPETUAL_PAIR_BTC_USD = 0
+}
+export declare enum MarketId {
+    PERPETUAL_PRICE_BTC_USD = 0
+}
+export declare enum PerpetualId {
+    PERPETUAL_BTC_USD = 0
+}
+export interface FaucetRequest {
+    address: string;
+    subaccountNumber: number;
+    amount: number;
+}