koilib 2.0.0 → 2.4.0

package/lib/Signer.js

@@ -24,13 +24,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Signer = void 0;
 /* eslint-disable no-param-reassign */
-const js_sha256_1 = require("js-sha256");
-const secp = __importStar(require("noble-secp256k1"));
-const light_1 = require("protobufjs/light");
-const protocol_proto_json_1 = __importDefault(require("./protocol-proto.json"));
+const sha256_1 = require("@noble/hashes/lib/sha256");
+const secp = __importStar(require("@noble/secp256k1"));
+const protocol_proto_json_1 = __importDefault(require("./jsonDescriptors/protocol-proto.json"));
 const utils_1 = require("./utils");
-const root = light_1.Root.fromJSON(protocol_proto_json_1.default);
-const ActiveTxDataMsg = root.lookupType("active_transaction_data");
+const Serializer_1 = require("./Serializer");
 /**
  * The Signer Class contains the private key needed to sign transactions.
  * It can be created using the seed, wif, or private key
@@ -38,7 +36,8 @@ const ActiveTxDataMsg = root.lookupType("active_transaction_data");
  * @example
  * using private key as hex string
  * ```ts
- * var signer = new Signer("ec8601a24f81decd57f4b611b5ac6eb801cb3780bb02c0f9cdfe9d09daaddf9c");
+ * var privateKey = "ec8601a24f81decd57f4b611b5ac6eb801cb3780bb02c0f9cdfe9d09daaddf9c";
+ * var signer = new Signer({ privateKey });
  * ```
  * <br>
  *
@@ -50,14 +49,15 @@ const ActiveTxDataMsg = root.lookupType("active_transaction_data");
  *     1, 203,  55, 128, 187,   2, 192, 249,
  *   205, 254, 157,   9, 218, 173, 223, 156
  * ]);
- * var signer = new Signer(buffer);
+ * var signer = new Signer({ privateKey: buffer });
  * ```
  *
  * <br>
  *
  * using private key as bigint
  * ```ts
- * var signer = new Signer(106982601049961974618234078204952280507266494766432547312316920283818886029212n);
+ * var privateKey = 106982601049961974618234078204952280507266494766432547312316920283818886029212n;
+ * var signer = new Signer({ privateKey });
  * ```
  *
  * <br>
@@ -79,7 +79,8 @@ const ActiveTxDataMsg = root.lookupType("active_transaction_data");
  * defining a provider
  * ```ts
  * var provider = new Provider(["https://example.com/jsonrpc"]);
- * var signer = new Signer("ec8601a24f81decd57f4b611b5ac6eb801cb3780bb02c0f9cdfe9d09daaddf9c", true, provider);
+ * var privateKey = "ec8601a24f81decd57f4b611b5ac6eb801cb3780bb02c0f9cdfe9d09daaddf9c";
+ * var signer = new Signer({ privateKey, provider });
  * ```
  */
 class Signer {
@@ -93,21 +94,31 @@ class Signer {
      * @param provider - provider to connect with the blockchain
      * @example
      * ```ts
-     * cons signer = new Signer("ec8601a24f81decd57f4b611b5ac6eb801cb3780bb02c0f9cdfe9d09daaddf9c");
+     * const privateKey = "ec8601a24f81decd57f4b611b5ac6eb801cb3780bb02c0f9cdfe9d09daaddf9c";
+     * cons signer = new Signer({ privateKey });
      * console.log(signer.getAddress());
      * // 1MbL6mG8ASAvSYdoMnGUfG3ZXkmQ2dpL5b
      * ```
      */
-    constructor(privateKey, compressed = true, provider) {
-        this.compressed = compressed;
-        this.privateKey = privateKey;
-        this.provider = provider;
-        if (typeof privateKey === "string") {
-            this.publicKey = secp.getPublicKey(privateKey, this.compressed);
+    constructor(c) {
+        this.compressed = typeof c.compressed === "undefined" ? true : c.compressed;
+        this.privateKey = c.privateKey;
+        this.provider = c.provider;
+        if (c.serializer) {
+            this.serializer = c.serializer;
+        }
+        else {
+            this.serializer = new Serializer_1.Serializer(protocol_proto_json_1.default, {
+                defaultTypeName: "active_transaction_data",
+                bytesConversion: false,
+            });
+        }
+        if (typeof c.privateKey === "string") {
+            this.publicKey = secp.getPublicKey(c.privateKey, this.compressed);
             this.address = utils_1.bitcoinAddress(utils_1.toUint8Array(this.publicKey));
         }
         else {
-            this.publicKey = secp.getPublicKey(privateKey, this.compressed);
+            this.publicKey = secp.getPublicKey(c.privateKey, this.compressed);
             this.address = utils_1.bitcoinAddress(this.publicKey);
         }
     }
@@ -125,7 +136,10 @@ class Signer {
     static fromWif(wif) {
         const compressed = wif[0] !== "5";
         const privateKey = utils_1.bitcoinDecode(wif);
-        return new Signer(utils_1.toHexString(privateKey), compressed);
+        return new Signer({
+            privateKey: utils_1.toHexString(privateKey),
+            compressed,
+        });
     }
     /**
      * Function to import a private key from the seed
@@ -140,8 +154,8 @@ class Signer {
      * @returns Signer object
      */
     static fromSeed(seed, compressed) {
-        const privateKey = js_sha256_1.sha256(seed);
-        return new Signer(privateKey, compressed);
+        const privateKey = sha256_1.sha256(seed);
+        return new Signer({ privateKey, compressed });
     }
     /**
      * @param compressed - determines if the address should be
@@ -205,18 +219,17 @@ class Signer {
     async signTransaction(tx) {
         if (!tx.active)
             throw new Error("Active data is not defined");
-        const hash = js_sha256_1.sha256(utils_1.decodeBase64(tx.active));
-        const [hex, recovery] = await secp.sign(hash, this.privateKey, {
+        const hash = sha256_1.sha256(utils_1.decodeBase64(tx.active));
+        const [compSignature, recovery] = await secp.sign(hash, this.privateKey, {
             recovered: true,
             canonical: true,
+            der: false, // compact signature
         });
-        // compact signature
-        const { r, s } = secp.Signature.fromHex(hex);
-        const rHex = r.toString(16).padStart(64, "0");
-        const sHex = s.toString(16).padStart(64, "0");
-        const recId = (recovery + 31).toString(16).padStart(2, "0");
-        tx.signatureData = utils_1.encodeBase64(utils_1.toUint8Array(recId + rHex + sHex));
-        const multihash = `0x1220${hash}`; // 12: code sha2-256. 20: length (32 bytes)
+        const compactSignature = new Uint8Array(65);
+        compactSignature.set([recovery + 31], 0);
+        compactSignature.set(compSignature, 1);
+        tx.signature_data = utils_1.encodeBase64(compactSignature);
+        const multihash = `0x1220${utils_1.toHexString(hash)}`; // 12: code sha2-256. 20: length (32 bytes)
         tx.id = multihash;
         return tx;
     }
@@ -230,32 +243,83 @@ class Signer {
      * @returns
      */
     async sendTransaction(tx, _abis) {
-        if (!tx.signatureData || !tx.id)
+        if (!tx.signature_data || !tx.id)
             await this.signTransaction(tx);
         if (!this.provider)
             throw new Error("provider is undefined");
         return this.provider.sendTransaction(tx);
     }
     /**
-     * Function to recover the public key from a signed transaction.
-     * The output format can be compressed or uncompressed.
-     * @param tx - signed transaction
-     * @param compressed - output format (compressed by default)
+     * Function to recover the public key from a signed
+     * transaction or block.
+     * The output format can be compressed (default) or uncompressed.
+     *
+     * @example
+     * ```ts
+     * const publicKey = await Signer.recoverPublicKey(tx);
+     * ```
+     *
+     * If the signature data contains more data, like in the
+     * blocks for PoW consensus, use the "transformSignature"
+     * function to extract the signature.
+     *
+     * @example
+     * ```ts
+     *  const powDescriptorJson = {
+     *    nested: {
+     *      mypackage: {
+     *        nested: {
+     *          pow_signature_data: {
+     *            fields: {
+     *              nonce: {
+     *                type: "bytes",
+     *                id: 1,
+     *              },
+     *              recoverable_signature: {
+     *                type: "bytes",
+     *                id: 2,
+     *              },
+     *            },
+     *          },
+     *        },
+     *      },
+     *    },
+     *  };
+     *
+     *  const serializer = new Serializer(powDescriptorJson, {
+     *   defaultTypeName: "pow_signature_data",
+     *  });
+     *
+     *  const signer = await Signer.recoverPublicKey(block, {
+     *    transformSignature: async (signatureData) => {
+     *      const powSignatureData = await serializer.deserialize(signatureData);
+     *      return powSignatureData.recoverable_signature;
+     *    },
+     *  });
+     * ```
      */
-    static recoverPublicKey(tx, compressed = true) {
-        if (!tx.active)
-            throw new Error("activeData is not defined");
-        if (!tx.signatureData)
-            throw new Error("signatureData is not defined");
-        const hash = js_sha256_1.sha256(utils_1.decodeBase64(tx.active));
-        const compactSignatureHex = utils_1.toHexString(utils_1.decodeBase64(tx.signatureData));
+    static async recoverPublicKey(txOrBlock, opts) {
+        if (!txOrBlock.active)
+            throw new Error("active is not defined");
+        if (!txOrBlock.signature_data)
+            throw new Error("signature_data is not defined");
+        let signatureData = txOrBlock.signature_data;
+        if (opts && typeof opts.transformSignature === "function") {
+            signatureData = await opts.transformSignature(txOrBlock.signature_data);
+        }
+        let compressed = true;
+        if (opts && typeof opts.compressed !== "undefined") {
+            compressed = opts.compressed;
+        }
+        const hash = sha256_1.sha256(utils_1.decodeBase64(txOrBlock.active));
+        const compactSignatureHex = utils_1.toHexString(utils_1.decodeBase64(signatureData));
         const recovery = Number(`0x${compactSignatureHex.slice(0, 2)}`) - 31;
         const rHex = compactSignatureHex.slice(2, 66);
         const sHex = compactSignatureHex.slice(66);
         const r = BigInt(`0x${rHex}`);
         const s = BigInt(`0x${sHex}`);
         const sig = new secp.Signature(r, s);
-        const publicKey = secp.recoverPublicKey(hash, sig.toHex(), recovery);
+        const publicKey = secp.recoverPublicKey(utils_1.toHexString(hash), sig.toHex(), recovery);
         if (!publicKey)
             throw new Error("Public key cannot be recovered");
         if (!compressed)
@@ -263,20 +327,62 @@ class Signer {
         return secp.Point.fromHex(publicKey).toHex(true);
     }
     /**
-     * Function to recover the signer address from a signed transaction.
-     * The output format can be compressed or uncompressed.
-     * @param tx - signed transaction
-     * @param compressed - output format (compressed by default)
+     * Function to recover the signer address from a signed
+     * transaction or block.
+     * The output format can be compressed (default) or uncompressed.
+     * @example
+     * ```ts
+     * const publicKey = await Signer.recoverAddress(tx);
+     * ```
+     *
+     * If the signature data contains more data, like in the
+     * blocks for PoW consensus, use the "transformSignature"
+     * function to extract the signature.
+     *
+     * @example
+     * ```ts
+     *  const powDescriptorJson = {
+     *    nested: {
+     *      mypackage: {
+     *        nested: {
+     *          pow_signature_data: {
+     *            fields: {
+     *              nonce: {
+     *                type: "bytes",
+     *                id: 1,
+     *              },
+     *              recoverable_signature: {
+     *                type: "bytes",
+     *                id: 2,
+     *              },
+     *            },
+     *          },
+     *        },
+     *      },
+     *    },
+     *  };
+     *
+     *  const serializer = new Serializer(powDescriptorJson, {
+     *   defaultTypeName: "pow_signature_data",
+     *  });
+     *
+     *  const signer = await Signer.recoverAddress(block, {
+     *    transformSignature: async (signatureData) => {
+     *      const powSignatureData = await serializer.deserialize(signatureData);
+     *      return powSignatureData.recoverable_signature;
+     *    },
+     *  });
+     * ```
      */
-    static recoverAddress(tx, compressed = true) {
-        const publicKey = Signer.recoverPublicKey(tx, compressed);
+    static async recoverAddress(txOrBlock, opts) {
+        const publicKey = await Signer.recoverPublicKey(txOrBlock, opts);
         return utils_1.bitcoinAddress(utils_1.toUint8Array(publicKey));
     }
     /**
      * Function to encode a transaction
-     * @param activeData - Active data consists of nonce, rcLimit, and
+     * @param activeData - Active data consists of nonce, rc_limit, and
      * operations. Do not set the nonce to get it from the blockchain
-     * using the provider. The rcLimit is 1000000 by default.
+     * using the provider. The rc_limit is 1000000 by default.
      * @returns A transaction encoded. The active field is encoded in
      * base64url
      */
@@ -289,15 +395,14 @@ class Signer {
             // this depends on the final architecture for names on Koinos
             nonce = await this.provider.getNonce(this.getAddress());
         }
-        const rcLimit = activeData.rcLimit === undefined ? 1000000 : activeData.rcLimit;
+        const rcLimit = activeData.rc_limit === undefined ? 1000000 : activeData.rc_limit;
         const operations = activeData.operations ? activeData.operations : [];
         const activeData2 = {
-            rcLimit,
+            rc_limit: rcLimit,
             nonce,
             operations,
         };
-        const message = ActiveTxDataMsg.create(activeData2);
-        const buffer = ActiveTxDataMsg.encode(message).finish();
+        const buffer = await this.serializer.serialize(activeData2);
         return {
             active: utils_1.encodeBase64(buffer),
         };
@@ -305,12 +410,10 @@ class Signer {
     /**
      * Function to decode a transaction
      */
-    static decodeTransaction(tx) {
+    async decodeTransaction(tx) {
         if (!tx.active)
             throw new Error("Active data is not defined");
-        const buffer = utils_1.decodeBase64(tx.active);
-        const message = ActiveTxDataMsg.decode(buffer);
-        return ActiveTxDataMsg.toObject(message, { longs: String });
+        return this.serializer.deserialize(tx.active);
     }
 }
 exports.Signer = Signer;

package/lib/Signer.js.map

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

package/lib/index.d.ts

@@ -4,3 +4,4 @@ export * as interfaces from "./interface";
 export * from "./Contract";
 export * from "./Signer";
 export * from "./Provider";
+export * from "./Serializer";

package/lib/index.js

@@ -30,4 +30,5 @@ exports.interfaces = __importStar(require("./interface"));
 __exportStar(require("./Contract"), exports);
 __exportStar(require("./Signer"), exports);
 __exportStar(require("./Provider"), exports);
+__exportStar(require("./Serializer"), exports);
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wEAAwE;AACxE,iCAAiC;AACjC,iDAAiC;AACjC,0DAA0C;AAC1C,6CAA2B;AAC3B,2CAAyB;AACzB,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wEAAwE;AACxE,iCAAiC;AACjC,iDAAiC;AACjC,0DAA0C;AAC1C,6CAA2B;AAC3B,2CAAyB;AACzB,6CAA2B;AAC3B,+CAA6B"}

package/lib/index2.js

@@ -24,8 +24,10 @@ const utils = __importStar(require("./utils"));
 const Contract_1 = require("./Contract");
 const Signer_1 = require("./Signer");
 const Provider_1 = require("./Provider");
+const Serializer_1 = require("./Serializer");
 window.utils = utils;
 window.Contract = Contract_1.Contract;
 window.Signer = Signer_1.Signer;
 window.Provider = Provider_1.Provider;
+window.Serializer = Serializer_1.Serializer;
 //# sourceMappingURL=index2.js.map

package/lib/index2.js.map

@@ -1 +1 @@
-{"version":3,"file":"index2.js","sourceRoot":"","sources":["../src/index2.ts"],"names":[],"mappings":";AAAA,wEAAwE;;;;;;;;;;;;;;;;;;;;;AAExE,+CAAiC;AACjC,yCAAsC;AACtC,qCAAkC;AAClC,yCAAsC;AAItC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;AACrB,MAAM,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC3B,MAAM,CAAC,MAAM,GAAG,eAAM,CAAC;AACvB,MAAM,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}
+{"version":3,"file":"index2.js","sourceRoot":"","sources":["../src/index2.ts"],"names":[],"mappings":";AAAA,wEAAwE;;;;;;;;;;;;;;;;;;;;;AAExE,+CAAiC;AACjC,yCAAsC;AACtC,qCAAkC;AAClC,yCAAsC;AACtC,6CAA0C;AAI1C,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;AACrB,MAAM,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC3B,MAAM,CAAC,MAAM,GAAG,eAAM,CAAC;AACvB,MAAM,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC3B,MAAM,CAAC,UAAU,GAAG,uBAAU,CAAC"}

package/lib/interface.d.ts

@@ -1,65 +1,202 @@
+import { INamespace } from "protobufjs/light";
+/**
+ * Application Binary Interface (ABI)
+ *
+ * ABIs are composed of 2 elements: methods and types.
+ * - The methods define the names of the entries of the smart contract,
+ * the corresponding endpoints and the name of the types used.
+ * - The types all the description to serialize and deserialize
+ * using proto buffers.
+ *
+ * To generate the types is necessary to use the dependency
+ * protobufjs. The following example shows how to generate the
+ * protobuf descriptor from a .proto file.
+ *
+ * ```js
+ * const fs = require("fs");
+ * const pbjs = require("protobufjs/cli/pbjs");
+ *
+ * pbjs.main(
+ *   ["--target", "json", "./token.proto"],
+ *   (err, output) => {
+ *     if (err) throw err;
+ *     fs.writeFileSync("./token-proto.json", output);
+ *   }
+ * );
+ * ```
+ *
+ * Then this descriptor can be loaded to define the ABI:
+ * ```js
+ * const tokenJson = require("./token-proto.json");
+ * const abiToken = {
+ *   methods: {
+ *     balanceOf: {
+ *       entryPoint: 0x15619248,
+ *       inputs: "balance_of_arguments",
+ *       outputs: "balance_of_result",
+ *       readOnly: true,
+ *       defaultOutput: { value: "0" },
+ *     },
+ *     transfer: {
+ *       entryPoint: 0x62efa292,
+ *       inputs: "transfer_arguments",
+ *       outputs: "transfer_result",
+ *     },
+ *     mint: {
+ *       entryPoint: 0xc2f82bdc,
+ *       inputs: "mint_argumnets",
+ *       outputs: "mint_result",
+ *     },
+ *   },
+ *   types: tokenJson,
+ * };
+ * ```
+ *
+ * Note that this example uses "defaultOutput" for the method
+ * "balanceOf". This is used when the smart contract returns an
+ * empty response (for instance when there are no balance records
+ * for a specific address) and you require a default output in
+ * such cases.
+ */
+export interface Abi {
+    methods: {
+        /** Name of the method */
+        [x: string]: {
+            /** Entry point ID */
+            entryPoint: number;
+            /** Protobuffer type for input */
+            input?: string;
+            /** Protobuffer type for output */
+            output?: string;
+            /** Boolean to differentiate write methods
+             * (using transactions) from read methods
+             * (query the contract)
+             */
+            readOnly?: boolean;
+            /** Default value when the output is undefined */
+            defaultOutput?: unknown;
+            /** Optional function to preformat the input */
+            preformatInput?: (input: unknown) => Record<string, unknown>;
+            /** Optional function to preformat the output */
+            preformatOutput?: (output: Record<string, unknown>) => unknown;
+            /** Description of the method */
+            description?: string;
+        };
+    };
+    /**
+     * Protobuffers descriptor in JSON format.
+     * See https://www.npmjs.com/package/protobufjs#using-json-descriptors
+     */
+    types: INamespace;
+}
+/**
+ * Human readable format operation
+ *
+ * @example
+ * ```ts
+ * const opDecoded = {
+ *   name: "transfer",
+ *   args: {
+ *     from: "1Krs7v1rtpgRyfwEZncuKMQQnY5JhqXVSx",
+ *     to: "1BqtgWBcqm9cSZ97avLGZGJdgso7wx6pCA",
+ *     value: 1000,
+ *   },
+ * };
+ * ```
+ */
+export interface DecodedOperationJson {
+    /** Operation name */
+    name: string;
+    /** Arguments decoded. See [[Abi]] */
+    args?: Record<string, unknown>;
+}
+export interface TransactionOptions {
+    rc_limit?: number | bigint | string;
+    nonce?: number;
+    sendTransaction?: boolean;
+    sendAbis?: boolean;
+}
+export interface RecoverPublicKeyOptions {
+    /**
+     * Boolean to define if the public key should
+     * be compressed or not. It is true by default
+     */
+    compressed?: boolean;
+    /**
+     * Asynchronous function to transform the signature
+     * before calculating the public key associated.
+     * This transformation is useful in cases were the
+     * signature contains additional data. For instance,
+     * the signatures for blocks in the PoW consensus
+     * algorithm contain the nonce.
+     */
+    transformSignature?: (signatureData: string) => Promise<string>;
+}
+export interface SendTransactionResponse {
+    wait: (type?: "byTransactionId" | "byBlock") => Promise<string>;
+}
 declare type NumberLike = number | bigint | string;
 export interface UploadContractOperation {
-    contractId?: Uint8Array;
+    contract_id?: Uint8Array;
     bytecode?: Uint8Array;
 }
 export interface UploadContractOperationJson {
-    contractId?: string;
+    contract_id?: string;
     bytecode?: string;
 }
 export interface CallContractOperation {
-    contractId: Uint8Array;
-    entryPoint: number;
+    contract_id: Uint8Array;
+    entry_point: number;
     args: Uint8Array;
 }
 export interface CallContractOperationJson {
-    contractId: string;
-    entryPoint: number;
+    contract_id: string;
+    entry_point: number;
     args: string;
 }
 export interface ContractCallBundle {
-    contractId: Uint8Array;
-    entryPoint: number;
+    contract_id: Uint8Array;
+    entry_point: number;
 }
 export interface ContractCallBundleJson {
-    contractId: string;
-    entryPoint: number;
+    contract_id: string;
+    entry_point: number;
 }
 export interface ThunkIdNested {
-    thunkId: number;
+    thunk_id: number;
 }
 export interface ContractCallBundleNested {
-    systemCallBundle: ContractCallBundle;
+    system_call_bundle: ContractCallBundle;
 }
 export declare type SystemCallTarget = ThunkIdNested | ContractCallBundleNested;
 export interface SetSystemCallOperation {
-    callId: number;
+    call_id: number;
     target: SystemCallTarget;
 }
 export interface SetSystemCallOperationJson {
-    callId: number;
+    call_id: number;
     target: number | ContractCallBundleJson;
 }
 export interface UploadContractOperationNested {
-    uploadContract: UploadContractOperation;
+    upload_contract: UploadContractOperation;
 }
 export interface CallContractOperationNested {
-    callContract: CallContractOperation;
+    call_contract: CallContractOperation;
 }
 export interface SetSystemCallOperationNested {
-    setSystemCall: SetSystemCallOperation;
+    set_system_call: SetSystemCallOperation;
 }
 export declare type Operation = UploadContractOperationNested | CallContractOperationNested | SetSystemCallOperationNested;
 export declare type OperationJson = {
-    uploadContract?: UploadContractOperationJson;
-    callContract?: CallContractOperationJson;
-    setSystemCall?: SetSystemCallOperationJson;
+    upload_contract?: UploadContractOperationJson;
+    call_contract?: CallContractOperationJson;
+    set_system_call?: SetSystemCallOperationJson;
 };
 export interface ActiveTransactionData {
     /**
      * Resource credits limit
      */
-    rcLimit?: string | number | bigint;
+    rc_limit?: string | number | bigint;
     /**
      * Account nonce
      */
@@ -74,7 +211,7 @@ export interface ActiveTransactionDataJson {
     /**
      * Resource credits limit
      */
-    rcLimit?: string | number | bigint;
+    rc_limit?: string | number | bigint;
     /**
      * Account nonce
      */
@@ -105,7 +242,7 @@ export interface TransactionJson {
     /**
      * Signature in compact format enconded in multi base64
      */
-    signatureData?: string;
+    signature_data?: string;
 }
 export interface BlockHeaderJson {
     previous?: string;
@@ -118,7 +255,7 @@ export interface BlockJson {
     header?: BlockHeaderJson;
     active?: string;
     passive?: string;
-    signatureData?: string;
+    signature_data?: string;
     transactions?: TransactionJson[];
     [x: string]: unknown;
 }