@sravankumar02/sdk-core 1.0.0

package/LICENSE

@@ -0,0 +1,11 @@
+## License
+
+The MIT License (MIT)
+
+Copyright (c) DharitrI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# DharitrI SDK for JavaScript and TypeScript
+
+DharitrI SDK for JavaScript and TypeScript (written in TypeScript).
+
+## Documentation
+
+- [Cookbook](https://docs.dharitri.org/sdk-and-tools/sdk-js/sdk-js-cookbook/)
+- [Auto-generated documentation](https://terradharitri.github.io/drt-js-sdk-core/)
+
+## Distribution
+
+[npm](https://www.npmjs.com/package/@sravankumar02/sdk-core)
+
+## Installation
+
+`sdk-core` is delivered via **npm** and it can be installed as follows:
+
+```
+npm install @sravankumar02/sdk-core
+```
+
+## Development
+
+Feel free to skip this section if you are not a contributor.
+
+### Prerequisites
+
+`browserify` and `esmify` are required to compile the browser-friendly versions of `sdk-core`. They can be installed as follows:
+
+```
+npm install --global browserify
+npm install esmify --no-save
+```
+
+## Optional Dependencies
+
+### axios
+
+This package can make HTTP requests using `axios`, which is not bundled by default. If you plan to use the API network provider or Proxy network provider, make sure to install `axios`:
+
+```bash
+npm install axios
+```
+
+### @terradharitri/sdk-bls-wasm
+
+This package requires `@terradharitri/sdk-bls-wasm` for BLS (Boneh-Lynn-Shacham) cryptographic functions, which is not bundled by default. If you plan to use BLS functionality, make sure to install this optional dependency:
+
+```bash
+npm install @terradharitri/sdk-bls-wasm
+```
+
+### bip39
+
+This package provides mnemonic and seed generation functionality using `bip39`, but it is not bundled by default. If you plan to use mnemonic-related features, make sure to install this optional dependency:
+
+```bash
+npm install bip39
+```
+
+### Building the library
+
+In order to compile the library, run the following:
+
+```
+npm install
+npm run compile
+npm run compile-browser
+```
+
+### Running the tests
+
+In order to run the tests **on NodeJS**, do as follows:
+
+```
+npm run tests-unit
+npm run tests-localnet
+npm run tests-devnet
+npm run tests-testnet
+```
+
+Before running the tests **in the browser**, make sure you have the package `http-server` installed globally.
+
+```
+npm install --global http-server
+```
+
+In order to run the tests **in the browser**, do as follows:
+
+```
+make clean && npm run browser-tests
+```
+
+For the `localnet` tests, make sure you have a _local testnet_ up & running. In order to start a _local testnet_, follow [this](https://docs.dharitri.org/developers/setup-local-testnet/).

package/out/abi/argSerializer.d.ts

@@ -0,0 +1,45 @@
+/// <reference types="node" />
+import { Type, TypedValue } from "./typesystem";
+interface IArgSerializerOptions {
+    codec: ICodec;
+}
+interface ICodec {
+    decodeTopLevel(buffer: Buffer, type: Type): TypedValue;
+    encodeTopLevel(typedValue: TypedValue): Buffer;
+}
+interface IParameterDefinition {
+    type: Type;
+}
+export declare class ArgSerializer {
+    codec: ICodec;
+    constructor(options?: IArgSerializerOptions);
+    /**
+     * Reads typed values from an arguments string (e.g. aa@bb@@cc), given parameter definitions.
+     */
+    stringToValues(joinedString: string, parameters: IParameterDefinition[]): TypedValue[];
+    /**
+     * Reads raw buffers from an arguments string (e.g. aa@bb@@cc).
+     */
+    stringToBuffers(joinedString: string): Buffer[];
+    /**
+     * Decodes a set of buffers into a set of typed values, given parameter definitions.
+     */
+    buffersToValues(buffers: Buffer[], parameters: IParameterDefinition[]): TypedValue[];
+    /**
+     * Serializes a set of typed values into an arguments string (e.g. aa@bb@@cc).
+     */
+    valuesToString(values: TypedValue[]): {
+        argumentsString: string;
+        count: number;
+    };
+    /**
+     * Serializes a set of typed values into a set of strings.
+     */
+    valuesToStrings(values: TypedValue[]): string[];
+    /**
+     * Serializes a set of typed values into a set of strings buffers.
+     * Variadic types and composite types might result into none, one or more buffers.
+     */
+    valuesToBuffers(values: TypedValue[]): Buffer[];
+}
+export {};

package/out/abi/argSerializer.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArgSerializer = void 0;
+const constants_1 = require("../core/constants");
+const codec_1 = require("./codec");
+const typesystem_1 = require("./typesystem");
+const algebraic_1 = require("./typesystem/algebraic");
+const composite_1 = require("./typesystem/composite");
+const variadic_1 = require("./typesystem/variadic");
+// TODO: perhaps move default construction options to a factory (ArgSerializerFactory), instead of referencing them in the constructor
+// (postpone as much as possible, breaking change)
+const defaultArgSerializerOptions = {
+    codec: new codec_1.BinaryCodec(),
+};
+class ArgSerializer {
+    constructor(options) {
+        options = { ...defaultArgSerializerOptions, ...options };
+        this.codec = options.codec;
+    }
+    /**
+     * Reads typed values from an arguments string (e.g. aa@bb@@cc), given parameter definitions.
+     */
+    stringToValues(joinedString, parameters) {
+        let buffers = this.stringToBuffers(joinedString);
+        let values = this.buffersToValues(buffers, parameters);
+        return values;
+    }
+    /**
+     * Reads raw buffers from an arguments string (e.g. aa@bb@@cc).
+     */
+    stringToBuffers(joinedString) {
+        // We also keep the zero-length buffers (they could encode missing options, Option<T>).
+        return joinedString.split(constants_1.ARGUMENTS_SEPARATOR).map((item) => Buffer.from(item, "hex"));
+    }
+    /**
+     * Decodes a set of buffers into a set of typed values, given parameter definitions.
+     */
+    buffersToValues(buffers, parameters) {
+        // TODO: Refactor, split (function is quite complex).
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const self = this;
+        buffers = buffers || [];
+        let values = [];
+        let bufferIndex = 0;
+        let numBuffers = buffers.length;
+        for (let i = 0; i < parameters.length; i++) {
+            let parameter = parameters[i];
+            let type = parameter.type;
+            let value = readValue(type);
+            values.push(value);
+        }
+        // This is a recursive function.
+        function readValue(type) {
+            if (type.hasExactClass(algebraic_1.OptionalType.ClassName)) {
+                const typedValue = readValue(type.getFirstTypeParameter());
+                return new algebraic_1.OptionalValue(type, typedValue);
+            }
+            if (type.hasExactClass(variadic_1.VariadicType.ClassName)) {
+                return readVariadicValue(type);
+            }
+            if (type.hasExactClass(composite_1.CompositeType.ClassName)) {
+                const typedValues = [];
+                for (const typeParameter of type.getTypeParameters()) {
+                    typedValues.push(readValue(typeParameter));
+                }
+                return new composite_1.CompositeValue(type, typedValues);
+            }
+            // Non-composite (singular), non-variadic (fixed) type.
+            // The only branching without a recursive call.
+            const typedValue = decodeNextBuffer(type);
+            // TODO: Handle the case (maybe throw error) when "typedValue" is, actually, null.
+            return typedValue;
+        }
+        function readVariadicValue(type) {
+            const variadicType = type;
+            const typedValues = [];
+            if (variadicType.isCounted) {
+                const count = readValue(new typesystem_1.U32Type()).valueOf().toNumber();
+                for (let i = 0; i < count; i++) {
+                    typedValues.push(readValue(type.getFirstTypeParameter()));
+                }
+            }
+            else {
+                while (!hasReachedTheEnd()) {
+                    typedValues.push(readValue(type.getFirstTypeParameter()));
+                }
+            }
+            return new variadic_1.VariadicValue(variadicType, typedValues);
+        }
+        function decodeNextBuffer(type) {
+            if (hasReachedTheEnd()) {
+                return null;
+            }
+            let buffer = buffers[bufferIndex++];
+            let decodedValue = self.codec.decodeTopLevel(buffer, type);
+            return decodedValue;
+        }
+        function hasReachedTheEnd() {
+            return bufferIndex >= numBuffers;
+        }
+        return values;
+    }
+    /**
+     * Serializes a set of typed values into an arguments string (e.g. aa@bb@@cc).
+     */
+    valuesToString(values) {
+        let strings = this.valuesToStrings(values);
+        let argumentsString = strings.join(constants_1.ARGUMENTS_SEPARATOR);
+        let count = strings.length;
+        return { argumentsString, count };
+    }
+    /**
+     * Serializes a set of typed values into a set of strings.
+     */
+    valuesToStrings(values) {
+        let buffers = this.valuesToBuffers(values);
+        let strings = buffers.map((buffer) => buffer.toString("hex"));
+        return strings;
+    }
+    /**
+     * Serializes a set of typed values into a set of strings buffers.
+     * Variadic types and composite types might result into none, one or more buffers.
+     */
+    valuesToBuffers(values) {
+        // TODO: Refactor, split (function is quite complex).
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const self = this;
+        const buffers = [];
+        for (const value of values) {
+            handleValue(value);
+        }
+        // This is a recursive function. It appends to the "buffers" variable.
+        function handleValue(value) {
+            if (value.hasExactClass(algebraic_1.OptionalValue.ClassName)) {
+                const valueAsOptional = value;
+                if (valueAsOptional.isSet()) {
+                    handleValue(valueAsOptional.getTypedValue());
+                }
+                return;
+            }
+            if (value.hasExactClass(variadic_1.VariadicValue.ClassName)) {
+                handleVariadicValue(value);
+                return;
+            }
+            if (value.hasExactClass(composite_1.CompositeValue.ClassName)) {
+                const valueAsComposite = value;
+                for (const item of valueAsComposite.getItems()) {
+                    handleValue(item);
+                }
+                return;
+            }
+            // Non-composite (singular), non-variadic (fixed) type.
+            // The only branching without a recursive call.
+            const buffer = self.codec.encodeTopLevel(value);
+            buffers.push(buffer);
+        }
+        function handleVariadicValue(value) {
+            const variadicType = value.getType();
+            if (variadicType.isCounted) {
+                const countValue = new typesystem_1.U32Value(value.getItems().length);
+                buffers.push(self.codec.encodeTopLevel(countValue));
+            }
+            for (const item of value.getItems()) {
+                handleValue(item);
+            }
+        }
+        return buffers;
+    }
+}
+exports.ArgSerializer = ArgSerializer;
+//# sourceMappingURL=argSerializer.js.map

package/out/abi/argSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argSerializer.js","sourceRoot":"","sources":["../../src/abi/argSerializer.ts"],"names":[],"mappings":"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"}

package/out/abi/argumentErrorContext.d.ts

@@ -0,0 +1,12 @@
+import { EndpointParameterDefinition, Type } from "./typesystem";
+export declare class ArgumentErrorContext {
+    endpointName: string;
+    argumentIndex: number;
+    parameterDefinition: EndpointParameterDefinition;
+    constructor(endpointName: string, argumentIndex: number, parameterDefinition: EndpointParameterDefinition);
+    throwError(specificError: string): never;
+    convertError(native: any, typeName: string): never;
+    unhandledType(functionName: string, type: Type): never;
+    guardSameLength<T>(native: any[], valueTypes: T[]): void;
+    guardHasField(native: any, fieldName: string): void;
+}

package/out/abi/argumentErrorContext.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArgumentErrorContext = void 0;
+const errors_1 = require("../core/errors");
+class ArgumentErrorContext {
+    constructor(endpointName, argumentIndex, parameterDefinition) {
+        this.endpointName = endpointName;
+        this.argumentIndex = argumentIndex;
+        this.parameterDefinition = parameterDefinition;
+    }
+    throwError(specificError) {
+        throw new errors_1.ErrInvalidArgument(`Error when converting arguments for endpoint (endpoint name: ${this.endpointName}, argument index: ${this.argumentIndex}, name: ${this.parameterDefinition.name}, type: ${this.parameterDefinition.type})\nNested error: ${specificError}`);
+    }
+    convertError(native, typeName) {
+        this.throwError(`Can't convert argument (argument: ${native}, type ${typeof native}), wanted type: ${typeName})`);
+    }
+    unhandledType(functionName, type) {
+        this.throwError(`Unhandled type (function: ${functionName}, type: ${type})`);
+    }
+    guardSameLength(native, valueTypes) {
+        native = native || [];
+        if (native.length != valueTypes.length) {
+            this.throwError(`Incorrect composite type length: have ${native.length}, expected ${valueTypes.length} (argument: ${native})`);
+        }
+    }
+    guardHasField(native, fieldName) {
+        native = native || {};
+        if (!(fieldName in native)) {
+            this.throwError(`Struct argument does not contain a field named "${fieldName}" (argument: ${JSON.stringify(native)})`);
+        }
+    }
+}
+exports.ArgumentErrorContext = ArgumentErrorContext;
+//# sourceMappingURL=argumentErrorContext.js.map

package/out/abi/argumentErrorContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argumentErrorContext.js","sourceRoot":"","sources":["../../src/abi/argumentErrorContext.ts"],"names":[],"mappings":";;;AAAA,2CAAoD;AAGpD,MAAa,oBAAoB;IAK7B,YAAY,YAAoB,EAAE,aAAqB,EAAE,mBAAgD;QACrG,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;IACnD,CAAC;IAED,UAAU,CAAC,aAAqB;QAC5B,MAAM,IAAI,2BAAkB,CACxB,gEAAgE,IAAI,CAAC,YAAY,qBAAqB,IAAI,CAAC,aAAa,WAAW,IAAI,CAAC,mBAAmB,CAAC,IAAI,WAAW,IAAI,CAAC,mBAAmB,CAAC,IAAI,oBAAoB,aAAa,EAAE,CAC9O,CAAC;IACN,CAAC;IAED,YAAY,CAAC,MAAW,EAAE,QAAgB;QACtC,IAAI,CAAC,UAAU,CACX,qCAAqC,MAAM,UAAU,OAAO,MAAM,mBAAmB,QAAQ,GAAG,CACnG,CAAC;IACN,CAAC;IAED,aAAa,CAAC,YAAoB,EAAE,IAAU;QAC1C,IAAI,CAAC,UAAU,CAAC,6BAA6B,YAAY,WAAW,IAAI,GAAG,CAAC,CAAC;IACjF,CAAC;IAED,eAAe,CAAI,MAAa,EAAE,UAAe;QAC7C,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,EAAE;YACpC,IAAI,CAAC,UAAU,CACX,yCAAyC,MAAM,CAAC,MAAM,cAAc,UAAU,CAAC,MAAM,eAAe,MAAM,GAAG,CAChH,CAAC;SACL;IACL,CAAC;IAED,aAAa,CAAC,MAAW,EAAE,SAAiB;QACxC,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,EAAE;YACxB,IAAI,CAAC,UAAU,CACX,mDAAmD,SAAS,gBAAgB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CACxG,CAAC;SACL;IACL,CAAC;CACJ;AA5CD,oDA4CC"}

package/out/abi/code.d.ts

@@ -0,0 +1,23 @@
+/// <reference types="node" />
+/**
+ * * @deprecated Use the bytecode directly
+ * Bytecode of a Smart Contract, as an abstraction.
+ */
+export declare class Code {
+    private readonly hex;
+    private constructor();
+    /**
+     * Creates a Code object from a buffer (sequence of bytes).
+     */
+    static fromBuffer(code: Buffer): Code;
+    /**
+     * Creates a Code object from a hex-encoded string.
+     */
+    static fromHex(hex: string): Code;
+    /**
+     * Returns the bytecode as a hex-encoded string.
+     */
+    toString(): string;
+    valueOf(): Buffer;
+    computeHash(): Buffer;
+}

package/out/abi/code.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Code = void 0;
+const createHasher = require("blake2b");
+const CODE_HASH_LENGTH = 32;
+/**
+ * * @deprecated Use the bytecode directly
+ * Bytecode of a Smart Contract, as an abstraction.
+ */
+class Code {
+    constructor(hex) {
+        this.hex = hex;
+    }
+    /**
+     * Creates a Code object from a buffer (sequence of bytes).
+     */
+    static fromBuffer(code) {
+        return new Code(code.toString("hex"));
+    }
+    /**
+     * Creates a Code object from a hex-encoded string.
+     */
+    static fromHex(hex) {
+        return new Code(hex);
+    }
+    /**
+     * Returns the bytecode as a hex-encoded string.
+     */
+    toString() {
+        return this.hex;
+    }
+    valueOf() {
+        return Buffer.from(this.hex, "hex");
+    }
+    computeHash() {
+        const hash = createHasher(CODE_HASH_LENGTH).update(this.valueOf()).digest();
+        return Buffer.from(hash);
+    }
+}
+exports.Code = Code;
+//# sourceMappingURL=code.js.map

package/out/abi/code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/abi/code.ts"],"names":[],"mappings":";;;AAAA,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AACxC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B;;;GAGG;AACH,MAAa,IAAI;IAGb,YAAoB,GAAW;QAC3B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAY;QAC1B,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAW;QACtB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,OAAO;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,WAAW;QACP,MAAM,IAAI,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QAE5E,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACJ;AArCD,oBAqCC"}

package/out/abi/codec/address.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="node" />
+import { AddressValue } from "../typesystem";
+export declare class AddressBinaryCodec {
+    /**
+     * Reads and decodes an AddressValue from a given buffer.
+     *
+     * @param buffer the input buffer
+     */
+    decodeNested(buffer: Buffer): [AddressValue, number];
+    /**
+     * Reads and decodes an AddressValue from a given buffer.
+     *
+     * @param buffer the input buffer
+     */
+    decodeTopLevel(buffer: Buffer): AddressValue;
+    /**
+     * Encodes an AddressValue to a buffer.
+     */
+    encodeNested(primitive: AddressValue): Buffer;
+    /**
+     * Encodes an AddressValue to a buffer.
+     */
+    encodeTopLevel(primitive: AddressValue): Buffer;
+}

package/out/abi/codec/address.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressBinaryCodec = void 0;
+const address_1 = require("../../core/address");
+const typesystem_1 = require("../typesystem");
+class AddressBinaryCodec {
+    /**
+     * Reads and decodes an AddressValue from a given buffer.
+     *
+     * @param buffer the input buffer
+     */
+    decodeNested(buffer) {
+        // We don't check the size of the buffer, we just read 32 bytes.
+        let slice = buffer.slice(0, 32);
+        let value = new address_1.Address(slice);
+        return [new typesystem_1.AddressValue(value), 32];
+    }
+    /**
+     * Reads and decodes an AddressValue from a given buffer.
+     *
+     * @param buffer the input buffer
+     */
+    decodeTopLevel(buffer) {
+        let [decoded, _length] = this.decodeNested(buffer);
+        return decoded;
+    }
+    /**
+     * Encodes an AddressValue to a buffer.
+     */
+    encodeNested(primitive) {
+        return primitive.valueOf().getPublicKey();
+    }
+    /**
+     * Encodes an AddressValue to a buffer.
+     */
+    encodeTopLevel(primitive) {
+        return primitive.valueOf().getPublicKey();
+    }
+}
+exports.AddressBinaryCodec = AddressBinaryCodec;
+//# sourceMappingURL=address.js.map

package/out/abi/codec/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/abi/codec/address.ts"],"names":[],"mappings":";;;AAAA,gDAA6C;AAC7C,8CAA6C;AAE7C,MAAa,kBAAkB;IAC3B;;;;OAIG;IACH,YAAY,CAAC,MAAc;QACvB,gEAAgE;QAEhE,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,KAAK,GAAG,IAAI,iBAAO,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,yBAAY,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,MAAc;QACzB,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAuB;QAChC,OAAO,SAAS,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,SAAuB;QAClC,OAAO,SAAS,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC;IAC9C,CAAC;CACJ;AArCD,gDAqCC"}

package/out/abi/codec/arrayVec.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="node" />
+import { ArrayVec, ArrayVecType } from "../typesystem";
+import { BinaryCodec } from "./binary";
+export declare class ArrayVecBinaryCodec {
+    private readonly binaryCodec;
+    constructor(binaryCodec: BinaryCodec);
+    decodeNested(buffer: Buffer, type: ArrayVecType): [ArrayVec, number];
+    decodeTopLevel(buffer: Buffer, type: ArrayVecType): ArrayVec;
+    encodeNested(array: ArrayVec): Buffer;
+    encodeTopLevel(array: ArrayVec): Buffer;
+}

package/out/abi/codec/arrayVec.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayVecBinaryCodec = void 0;
+const typesystem_1 = require("../typesystem");
+class ArrayVecBinaryCodec {
+    constructor(binaryCodec) {
+        this.binaryCodec = binaryCodec;
+    }
+    decodeNested(buffer, type) {
+        let arrayLength = type.length;
+        let typeParameter = type.getFirstTypeParameter();
+        let result = [];
+        let totalLength = 0;
+        for (let i = 0; i < arrayLength; i++) {
+            let [decoded, decodedLength] = this.binaryCodec.decodeNested(buffer, typeParameter);
+            result.push(decoded);
+            totalLength += decodedLength;
+            buffer = buffer.slice(decodedLength);
+        }
+        return [new typesystem_1.ArrayVec(type, result), totalLength];
+    }
+    decodeTopLevel(buffer, type) {
+        let [result, _] = this.decodeNested(buffer, type);
+        return result;
+    }
+    encodeNested(array) {
+        let itemsBuffers = [];
+        for (const item of array.getItems()) {
+            let itemBuffer = this.binaryCodec.encodeNested(item);
+            itemsBuffers.push(itemBuffer);
+        }
+        return Buffer.concat(itemsBuffers);
+    }
+    encodeTopLevel(array) {
+        return this.encodeNested(array);
+    }
+}
+exports.ArrayVecBinaryCodec = ArrayVecBinaryCodec;
+//# sourceMappingURL=arrayVec.js.map

package/out/abi/codec/arrayVec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayVec.js","sourceRoot":"","sources":["../../../src/abi/codec/arrayVec.ts"],"names":[],"mappings":";;;AAAA,8CAAmE;AAGnE,MAAa,mBAAmB;IAG5B,YAAY,WAAwB;QAChC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,CAAC;IAED,YAAY,CAAC,MAAc,EAAE,IAAkB;QAC3C,IAAI,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;QAC9B,IAAI,aAAa,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjD,IAAI,MAAM,GAAiB,EAAE,CAAC;QAC9B,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE;YAClC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YACpF,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,WAAW,IAAI,aAAa,CAAC;YAC7B,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;SACxC;QAED,OAAO,CAAC,IAAI,qBAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;IACrD,CAAC;IAED,cAAc,CAAC,MAAc,EAAE,IAAkB;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,YAAY,CAAC,KAAe;QACxB,IAAI,YAAY,GAAa,EAAE,CAAC;QAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE;YACjC,IAAI,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACrD,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;SACjC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAED,cAAc,CAAC,KAAe;QAC1B,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACJ;AA1CD,kDA0CC"}

package/out/abi/codec/binary.d.ts

@@ -0,0 +1,30 @@
+/// <reference types="node" />
+import { Type, TypedValue } from "../typesystem";
+export declare class BinaryCodec {
+    readonly constraints: BinaryCodecConstraints;
+    private readonly optionCodec;
+    private readonly listCodec;
+    private readonly arrayCodec;
+    private readonly primitiveCodec;
+    private readonly structCodec;
+    private readonly tupleCodec;
+    private readonly enumCodec;
+    private readonly explicitEnumCodec;
+    private readonly managedDecimalCodec;
+    private readonly managedDecimalSignedCodec;
+    constructor(constraints?: BinaryCodecConstraints | null);
+    decodeTopLevel<TResult extends TypedValue = TypedValue>(buffer: Buffer, type: Type): TResult;
+    decodeNested<TResult extends TypedValue = TypedValue>(buffer: Buffer, type: Type): [TResult, number];
+    encodeNested(typedValue: TypedValue): Buffer;
+    encodeTopLevel(typedValue: TypedValue): Buffer;
+}
+export declare class BinaryCodecConstraints {
+    maxBufferLength: number;
+    maxListLength: number;
+    constructor(init?: Partial<BinaryCodecConstraints>);
+    checkBufferLength(buffer: Buffer): void;
+    /**
+     * This constraint avoids computer-freezing decode bugs (e.g. due to invalid ABI or struct definitions).
+     */
+    checkListLength(length: number): void;
+}