koilib 1.5.0 → 2.3.0

package/lib/Contract.js

@@ -1,129 +1,201 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Contract = void 0;
-const abi_1 = require("./abi");
-const serializer_1 = require("./serializer");
-const VariableBlob_1 = require("./VariableBlob");
+const Serializer_1 = require("./Serializer");
+const utils_1 = require("./utils");
 /**
- * The contract class contains the contract ID and contrac entries
+ * The contract class contains the contract ID and contract entries
  * definition needed to encode/decode operations during the
  * interaction with the user and the communication with the RPC node.
  *
- * Operations are encoded to communicate with the RPC node. However,
- * this format is not human readable as the data is serialized and
- * encoded in Base64 format. When decoding operations, they can be
- * read by the user (see [[EncodedOperation]] and [[DecodedOperation]]).
- *
  * @example
  *
  * ```ts
- * const contract = new Contract({
- *   id: "Mkw96mR+Hh71IWwJoT/2lJXBDl5Q=",
- *   entries: {
- *     transfer: {
- *       id: 0x62efa292,
- *       inputs: {
- *         type: [
- *           {
- *             name: "from",
- *             type: "string",
- *           },
- *           {
- *             name: "to",
- *             type: "string",
- *           },
- *           {
- *             name: "value",
- *             type: "uint64",
- *           },
- *         ],
- *       },
- *     },
- *     balance_of: {
- *       id: 0x15619248,
- *       inputs: { type: "string" },
- *       outputs: { type: "uint64" },
- *     },
- *   },
+ * const { Contract, Provider, Signer, utils } = require("koilib");
+ * const rpcNodes = ["http://api.koinos.io:8080"];
+ * const privateKey = "f186a5de49797bfd52dc42505c33d75a46822ed5b60046e09d7c336242e20200";
+ * const provider = new Provider(rpcNodes);
+ * const signer = new Signer({ privateKey, provider });
+ * const koinContract = new Contract({
+ *   id: "19JntSm8pSNETT9aHTwAUHC5RMoaSmgZPJ",
+ *   abi: utils.Krc20Abi,
+ *   provider,
+ *   signer,
  * });
+ * const koin = koinContract.functions;
  *
- * const opEncoded = contract.encodeOperation({
- *   name: "transfer",
- *   args: {
- *     from: "alice",
- *     to: "bob",
- *     value: BigInt(1000),
- *   },
+ * // optional: preformat input/output
+ * koinContract.abi.methods.balanceOf.preformatInput = (owner) =>
+ *   ({ owner });
+ * koinContract.abi.methods.balanceOf.preformatOutput = (res) =>
+ *   utils.formatUnits(res.value, 8);
+ * koinContract.abi.methods.transfer.preformatInput = (input) => ({
+ *   from: signer.getAddress(),
+ *   to: input.to,
+ *   value: utils.parseUnits(input.value, 8),
  * });
  *
- * console.log(opEncoded);
- * // {
- * //   type: "koinos::protocol::call_contract_operation",
- * //   value: {
- * //     contract_id: "Mkw96mR+Hh71IWwJoT/2lJXBDl5Q=",
- * //     entry_point: 0x62efa292,
- * //     args: "MBWFsaWNlA2JvYgAAAAAAAAPo",
- * //   }
- * // }
+ * async funtion main() {
+ *   // Get balance
+ *   const { result } = await koin.balanceOf("12fN2CQnuJM8cMnWZ1hPtM4knjLME8E4PD");
+ *   console.log(result)
+ *
+ *   // Transfer
+ *   const { transaction, transactionResponse } = await koin.transfer({
+ *     to: "172AB1FgCsYrRAW5cwQ8KjadgxofvgPFd6",
+ *     value: "10.0001",
+ *   });
+ *   console.log(`Transaction id ${transaction.id} submitted`);
  *
- * const opDecoded = contract.decodeOperation(opEncoded);
- * console.log(opDecoded);
- * // {
- * //   name: "transfer",
- * //   args: {
- * //     from: "alice",
- * //     to: "bob",
- * //     value: 1000n,
- * //   },
- * // }
+ *   // wait to be mined
+ *   const blockId = await transactionResponse.wait();
+ *   console.log(`Transaction mined. Block id: ${blockId}`);
+ * }
  *
- * const resultDecoded = contract.decodeResult("MAAsZnAzyD0E=", "balance_of");
- * console.log(resultDecoded)
- * // 3124382766600001n
+ * main();
  * ```
  */
 class Contract {
+    constructor(c) {
+        var _a;
+        if (c.id)
+            this.id = utils_1.decodeBase58(c.id);
+        this.signer = c.signer;
+        this.provider = c.provider || ((_a = c.signer) === null || _a === void 0 ? void 0 : _a.provider);
+        this.abi = c.abi;
+        this.bytecode = c.bytecode;
+        if (c.serializer) {
+            this.serializer = c.serializer;
+        }
+        else if (c.abi && c.abi.types) {
+            this.serializer = new Serializer_1.Serializer(c.abi.types);
+        }
+        this.options = {
+            rc_limit: 1e8,
+            sendTransaction: true,
+            sendAbis: true,
+            ...c.options,
+        };
+        this.functions = {};
+        if (this.signer &&
+            this.provider &&
+            this.abi &&
+            this.abi.methods &&
+            this.serializer) {
+            Object.keys(this.abi.methods).forEach((name) => {
+                this.functions[name] = async (argu = {}, options) => {
+                    if (!this.provider)
+                        throw new Error("provider not found");
+                    if (!this.abi || !this.abi.methods)
+                        throw new Error("Methods are not defined");
+                    if (!this.abi.methods[name])
+                        throw new Error(`Method ${name} not defined in the ABI`);
+                    const opts = {
+                        ...this.options,
+                        ...options,
+                    };
+                    const { readOnly, output, defaultOutput, preformatInput, preformatOutput, } = this.abi.methods[name];
+                    let args;
+                    if (typeof preformatInput === "function") {
+                        args = preformatInput(argu);
+                    }
+                    else {
+                        args = argu;
+                    }
+                    const operation = await this.encodeOperation({ name, args });
+                    if (readOnly) {
+                        if (!output)
+                            throw new Error(`No output defined for ${name}`);
+                        // read contract
+                        const { result: resultEncoded } = await this.provider.readContract({
+                            contract_id: utils_1.encodeBase58(operation.call_contract.contract_id),
+                            entry_point: operation.call_contract.entry_point,
+                            args: utils_1.encodeBase64(operation.call_contract.args),
+                        });
+                        let result = defaultOutput;
+                        if (resultEncoded) {
+                            result = await this.serializer.deserialize(resultEncoded, output);
+                        }
+                        if (typeof preformatOutput === "function") {
+                            result = preformatOutput(result);
+                        }
+                        return { operation, result };
+                    }
+                    // return operation if send is false
+                    if (!(opts === null || opts === void 0 ? void 0 : opts.sendTransaction))
+                        return { operation };
+                    // write contract (sign and send)
+                    if (!this.signer)
+                        throw new Error("signer not found");
+                    const transaction = await this.signer.encodeTransaction({
+                        ...opts,
+                        operations: [operation],
+                    });
+                    const abis = {};
+                    if (opts === null || opts === void 0 ? void 0 : opts.sendAbis) {
+                        const contractId = utils_1.encodeBase58(this.id);
+                        abis[contractId] = this.abi;
+                    }
+                    const transactionResponse = await this.signer.sendTransaction(transaction, abis);
+                    return { operation, transaction, transactionResponse };
+                };
+            });
+        }
+    }
     /**
-     * The constructor receives the contract ID and
-     * contract entries definition
-     * @param c - Object with contract id and contract entries
-     *
+     * Compute contract Id
+     */
+    static computeContractId(address) {
+        return utils_1.decodeBase58(address);
+    }
+    /**
+     * Get contract Id
+     */
+    getId() {
+        if (!this.id)
+            throw new Error("id is not defined");
+        return utils_1.encodeBase58(this.id);
+    }
+    /**
+     * Function to deploy a new smart contract.
+     * The Bytecode must be defined in the constructor of the class
      * @example
      * ```ts
-     * const contract = new Contract({
-     *   id: "Mkw96mR+Hh71IWwJoT/2lJXBDl5Q=",
-     *   entries: {
-     *     transfer: {
-     *       id: 0x62efa292,
-     *       inputs: {
-     *         type: [
-     *           {
-     *             name: "from",
-     *             type: "string",
-     *           },
-     *           {
-     *             name: "to",
-     *             type: "string",
-     *           },
-     *           {
-     *             name: "value",
-     *             type: "uint64",
-     *           },
-     *         ],
-     *       },
-     *     },
-     *     balance_of: {
-     *       id: 0x15619248,
-     *       inputs: { type: "string" },
-     *       outputs: { type: "uint64" },
-     *     },
-     *   },
-     * });
+     * const privateKey = "f186a5de49797bfd52dc42505c33d75a46822ed5b60046e09d7c336242e20200";
+     * const provider = new Provider(["http://api.koinos.io:8080"]);
+     * const signer = new Signer({ privateKey, provider });
+     * const bytecode = new Uint8Array([1, 2, 3, 4]);
+     * const contract = new Contract({ signer, provider, bytecode });
+     * const { transactionResponse } = await contract.deploy();
+     * // wait to be mined
+     * const blockId = await transactionResponse.wait();
+     * console.log(`Contract uploaded in block id ${blockId}`);
      * ```
      */
-    constructor(c) {
-        this.id = c.id;
-        this.entries = c.entries;
+    async deploy(options) {
+        if (!this.signer)
+            throw new Error("signer not found");
+        if (!this.bytecode)
+            throw new Error("bytecode not found");
+        const opts = {
+            ...this.options,
+            ...options,
+        };
+        const operation = {
+            upload_contract: {
+                contract_id: Contract.computeContractId(this.signer.getAddress()),
+                bytecode: this.bytecode,
+            },
+        };
+        // return operation if send is false
+        if (!(opts === null || opts === void 0 ? void 0 : opts.sendTransaction))
+            return { operation };
+        const transaction = await this.signer.encodeTransaction({
+            ...opts,
+            operations: [operation],
+        });
+        const transactionResponse = await this.signer.sendTransaction(transaction);
+        return { operation, transaction, transactionResponse };
     }
     /**
      * Encondes a contract operation using Koinos serialization
@@ -135,35 +207,41 @@ class Contract {
      * const opEncoded = contract.encodeOperation({
      *   name: "transfer",
      *   args: {
-     *     from: "alice",
-     *     to: "bob",
-     *     value: 1000,
+     *     from: "12fN2CQnuJM8cMnWZ1hPtM4knjLME8E4PD",
+     *     to: "172AB1FgCsYrRAW5cwQ8KjadgxofvgPFd6",
+     *     value: "1000",
      *   }
      * });
      *
      * console.log(opEncoded);
      * // {
-     * //   type: "koinos::protocol::call_contract_operation",
-     * //   value: {
-     * //     contract_id: "Mkw96mR+Hh71IWwJoT/2lJXBDl5Q=",
+     * //   call_contract: {
+     * //     contract_id: "19JntSm8pSNETT9aHTwAUHC5RMoaSmgZPJ",
      * //     entry_point: 0x62efa292,
      * //     args: "MBWFsaWNlA2JvYgAAAAAAAAPo",
      * //   }
      * // }
      * ```
      */
-    encodeOperation(op) {
-        if (!this.entries || !this.entries[op.name])
+    async encodeOperation(op) {
+        if (!this.abi || !this.abi.methods || !this.abi.methods[op.name])
             throw new Error(`Operation ${op.name} unknown`);
-        const entry = this.entries[op.name];
+        if (!this.serializer)
+            throw new Error("Serializer is not defined");
+        if (!this.id)
+            throw new Error("Contract id is not defined");
+        const method = this.abi.methods[op.name];
+        let bufferInputs = new Uint8Array(0);
+        if (method.input) {
+            if (!op.args)
+                throw new Error(`No arguments defined for type '${method.input}'`);
+            bufferInputs = await this.serializer.serialize(op.args, method.input);
+        }
         return {
-            type: abi_1.abiCallContractOperation.name,
-            value: {
+            call_contract: {
                 contract_id: this.id,
-                entry_point: entry.id,
-                ...(entry.inputs && {
-                    args: serializer_1.serialize(op.args, entry.inputs).toString(),
-                }),
+                entry_point: method.entryPoint,
+                args: bufferInputs,
             },
         };
     }
@@ -172,9 +250,8 @@ class Contract {
      * @example
      * ```ts
      * const opDecoded = contract.decodeOperation({
-     *   type: "koinos::protocol::call_contract_operation",
-     *   value: {
-     *     contract_id: "Mkw96mR+Hh71IWwJoT/2lJXBDl5Q=",
+     *   call_contract: {
+     *     contract_id: "19JntSm8pSNETT9aHTwAUHC5RMoaSmgZPJ",
      *     entry_point: 0x62efa292,
      *     args: "MBWFsaWNlA2JvYgAAAAAAAAPo",
      *   }
@@ -183,49 +260,37 @@ class Contract {
      * // {
      * //   name: "transfer",
      * //   args: {
-     * //     from: "alice",
-     * //     to: "bob",
-     * //     value: 1000n,
+     * //     from: "12fN2CQnuJM8cMnWZ1hPtM4knjLME8E4PD",
+     * //     to: "172AB1FgCsYrRAW5cwQ8KjadgxofvgPFd6",
+     * //     value: "1000",
      * //   },
      * // }
      * ```
      */
-    decodeOperation(op) {
-        if (op.value.contract_id !== this.id)
-            throw new Error(`Invalid contract id. Expected: ${this.id}. Received: ${op.value.contract_id}`);
-        for (let i = 0; i < Object.keys(this.entries).length; i += 1) {
-            const opName = Object.keys(this.entries)[i];
-            const entry = this.entries[opName];
-            if (op.value.entry_point === entry.id) {
-                const vb = new VariableBlob_1.VariableBlob(op.value.args);
+    async decodeOperation(op) {
+        if (!this.id)
+            throw new Error("Contract id is not defined");
+        if (!this.abi || !this.abi.methods)
+            throw new Error("Methods are not defined");
+        if (!this.serializer)
+            throw new Error("Serializer is not defined");
+        if (!op.call_contract)
+            throw new Error("Operation is not CallContractOperation");
+        if (op.call_contract.contract_id !== this.id)
+            throw new Error(`Invalid contract id. Expected: ${utils_1.encodeBase58(this.id)}. Received: ${utils_1.encodeBase58(op.call_contract.contract_id)}`);
+        for (let i = 0; i < Object.keys(this.abi.methods).length; i += 1) {
+            const opName = Object.keys(this.abi.methods)[i];
+            const method = this.abi.methods[opName];
+            if (op.call_contract.entry_point === method.entryPoint) {
+                if (!method.input)
+                    return { name: opName };
                 return {
                     name: opName,
-                    args: serializer_1.deserialize(vb, entry.inputs),
+                    args: await this.serializer.deserialize(op.call_contract.args, method.input),
                 };
             }
         }
-        throw new Error(`Unknown entry id ${op.value.entry_point}`);
-    }
-    /**
-     * Decodes a result. This function is used in conjunction with
-     * [[Provider.readContract | readContract of Provider class]] to read a
-     * contract and decode the result. "outputs" field must be defined in
-     * the abi for the operation name.
-     * @param result - Encoded result in base64
-     * @param opName - Operation name
-     * @returns Decoded result
-     * @example
-     * ```ts
-     * const resultDecoded = contract.decodeResult("MAAsZnAzyD0E=", "balance_of");
-     * console.log(resultDecoded)
-     * // 3124382766600001n
-     * ```
-     */
-    decodeResult(result, opName) {
-        const entry = this.entries[opName];
-        if (!entry.outputs)
-            throw new Error(`There are no outputs defined for ${opName}`);
-        return serializer_1.deserialize(result, entry.outputs);
+        throw new Error(`Unknown method id ${op.call_contract.entry_point}`);
     }
 }
 exports.Contract = Contract;

package/lib/Contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"Contract.js","sourceRoot":"","sources":["../src/Contract.ts"],"names":[],"mappings":";;;AAAA,+BAAsD;AACtD,6CAAsD;AACtD,iDAA8C;AA4G9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,MAAa,QAAQ;IAWnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,YAAY,CAAmC;QAC7C,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;IAC3B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,eAAe,CAAC,EAAoB;QAClC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC,IAAI,UAAU,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO;YACL,IAAI,EAAE,8BAAwB,CAAC,IAAc;YAC7C,KAAK,EAAE;gBACL,WAAW,EAAE,IAAI,CAAC,EAAE;gBACpB,WAAW,EAAE,KAAK,CAAC,EAAE;gBACrB,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI;oBAClB,IAAI,EAAE,sBAAS,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;iBAClD,CAAC;aACH;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,eAAe,CAAC,EAAoB;QAClC,IAAI,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI,CAAC,EAAE;YAClC,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAC/E,CAAC;QACJ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;YAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,EAAE,EAAE;gBACrC,MAAM,EAAE,GAAG,IAAI,2BAAY,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3C,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,wBAAW,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC;iBACpC,CAAC;aACH;SACF;QACD,MAAM,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,MAAc,EAAE,MAAc;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,OAAO;YAChB,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,EAAE,CAAC,CAAC;QAChE,OAAO,wBAAW,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF;AAhKD,4BAgKC;AAED,kBAAe,QAAQ,CAAC"}
+{"version":3,"file":"Contract.js","sourceRoot":"","sources":["../src/Contract.ts"],"names":[],"mappings":"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"}

package/lib/Provider.d.ts

@@ -1,5 +1,4 @@
-import { EncodedOperation } from "./Contract";
-import { Block, Transaction } from "./interface";
+import { BlockJson, TransactionJson, CallContractOperationJson, SendTransactionResponse } from "./interface";
 /**
  * Class to connect with the RPC node
  */
@@ -60,20 +59,37 @@ export declare class Provider {
      * Function to call "chain.get_account_nonce" to return the number of
      * transactions for a particular account. This call is used
      * when creating new transactions.
-     * @param address - account address
+     * @param account - account address
      * @returns Nonce
      */
-    getNonce(address: string): Promise<number>;
+    getNonce(account: string): Promise<number>;
+    getAccountRc(account: string): Promise<string>;
+    /**
+     * Get transactions by id and their corresponding block ids
+     */
+    getTransactionsById(transactionIds: string[]): Promise<{
+        transactions: {
+            transaction: TransactionJson[];
+            containing_blocks: string[];
+        }[];
+    }>;
+    getBlocksById(blockIds: string[]): Promise<{
+        block_items: {
+            block_id: string;
+            block_height: string;
+            block: BlockJson;
+        }[];
+    }>;
     /**
      * Function to get info from the head block in the blockchain
      */
     getHeadInfo(): Promise<{
         head_topology: {
             id: string;
-            height: number;
+            height: string;
             previous: string;
         };
-        last_irreversible_height: number;
+        last_irreversible_height: string;
     }>;
     /**
      * Function to get consecutive blocks in descending order
@@ -86,7 +102,7 @@ export declare class Provider {
     getBlocks(height: number, numBlocks?: number, idRef?: string): Promise<{
         block_id: string;
         block_height: number;
-        block: Block;
+        block: BlockJson;
         block_receipt: {
             [x: string]: unknown;
         };
@@ -97,28 +113,37 @@ export declare class Provider {
     getBlock(height: number): Promise<{
         block_id: string;
         block_height: number;
-        block: Block;
+        block: BlockJson;
         block_receipt: {
             [x: string]: unknown;
         };
     }>;
     /**
      * Function to call "chain.submit_transaction" to send a signed
-     * transaction to the blockchain
+     * transaction to the blockchain. It returns an object with the async
+     * function "wait", which can be called to wait for the
+     * transaction to be mined.
      * @param transaction - Signed transaction
-     * @returns
+     * @example
+     * ```ts
+     * const { transactionResponse } = await provider.sendTransaction({
+     *   id: "1220...",
+     *   active: "...",
+     *   signatureData: "...",
+     * });
+     * console.log("Transaction submitted to the mempool");
+     * // wait to be mined
+     * const blockId = await transactionResponse.wait();
+     * console.log("Transaction mined")
+     * ```
      */
-    sendTransaction(transaction: Transaction): Promise<unknown>;
+    sendTransaction(transaction: TransactionJson): Promise<SendTransactionResponse>;
     /**
      * Function to call "chain.read_contract" to read a contract.
-     * The operation must be encoded (see [[EncodedOperation]]).
-     * See also [[Wallet.readContract]] which, apart from the Provider,
-     * uses the contract definition and it is prepared to receive
-     * the operation decoded and return the result decoded as well.
-     * @param operation - Encoded operation
-     * @returns Encoded result
+     * This function is used by [[Contract]] class when read methods
+     * are invoked.
      */
-    readContract(operation: EncodedOperation): Promise<{
+    readContract(operation: CallContractOperationJson): Promise<{
         result: string;
         logs: string;
     }>;