starknet 2.6.0 → 2.8.0

package/dist/signer/default.js

@@ -81,6 +81,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Signer = void 0;
 var minimalistic_assert_1 = __importDefault(require("minimalistic-assert"));
+var contract_1 = require("../contract");
 var provider_1 = require("../provider");
 var ellipticCurve_1 = require("../utils/ellipticCurve");
 var encode_1 = require("../utils/encode");
@@ -180,6 +181,62 @@ var Signer = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * Verify a signature of a JSON object
+     *
+     * @param json - JSON object to be verified
+     * @param signature - signature of the JSON object
+     * @returns true if the signature is valid, false otherwise
+     * @throws {Error} if the JSON object is not a valid JSON or the signature is not a valid signature
+     */
+    Signer.prototype.verifyMessageHash = function (hash, signature) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _b.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, this.callContract({
+                                contract_address: this.address,
+                                entry_point_selector: (0, stark_1.getSelectorFromName)('is_valid_signature'),
+                                calldata: (0, contract_1.compileCalldata)({
+                                    hash: (0, number_1.toBN)(hash).toString(),
+                                    signature: signature.map(function (x) { return (0, number_1.toBN)(x).toString(); }),
+                                }),
+                            })];
+                    case 1:
+                        _b.sent();
+                        return [2 /*return*/, true];
+                    case 2:
+                        _a = _b.sent();
+                        return [2 /*return*/, false];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Verify a signature of a given hash
+     * @warning This method is not recommended, use verifyMessage instead
+     *
+     * @param hash - hash to be verified
+     * @param signature - signature of the hash
+     * @returns true if the signature is valid, false otherwise
+     * @throws {Error} if the signature is not a valid signature
+     */
+    Signer.prototype.verifyMessage = function (typedData, signature) {
+        return __awaiter(this, void 0, void 0, function () {
+            var hash;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.hashMessage(typedData)];
+                    case 1:
+                        hash = _a.sent();
+                        return [2 /*return*/, this.verifyMessageHash(hash, signature)];
+                }
+            });
+        });
+    };
     return Signer;
 }(provider_1.Provider));
 exports.Signer = Signer;

package/dist/signer/interface.d.ts

@@ -1,5 +1,6 @@
 import { Provider } from '../provider';
 import { AddTransactionResponse, Signature, Transaction } from '../types';
+import { BigNumberish } from '../utils/number';
 import { TypedData } from '../utils/typedData/types';
 export declare abstract class SignerInterface extends Provider {
     abstract address: string;
@@ -30,4 +31,23 @@ export declare abstract class SignerInterface extends Provider {
      * @throws {Error} if the JSON object is not a valid JSON
      */
     abstract hashMessage(typedData: TypedData): Promise<string>;
+    /**
+     * Verify a signature of a JSON object
+     *
+     * @param json - JSON object to be verified
+     * @param signature - signature of the JSON object
+     * @returns true if the signature is valid, false otherwise
+     * @throws {Error} if the JSON object is not a valid JSON or the signature is not a valid signature
+     */
+    abstract verifyMessage(typedData: TypedData, signature: Signature): Promise<boolean>;
+    /**
+     * Verify a signature of a given hash
+     * @warning This method is not recommended, use verifyMessage instead
+     *
+     * @param hash - hash to be verified
+     * @param signature - signature of the hash
+     * @returns true if the signature is valid, false otherwise
+     * @throws {Error} if the signature is not a valid signature
+     */
+    abstract verifyMessageHash(hash: BigNumberish, signature: Signature): Promise<boolean>;
 }

package/dist/types.d.ts

@@ -62,7 +62,7 @@ export declare type CallContractResponse = {
     result: string[];
 };
 export declare type GetBlockResponse = {
-    sequence_number: number;
+    block_number: number;
     state_root: string;
     block_hash: string;
     transactions: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starknet",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "JavaScript library for StarkNet",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/provider/default.d.ts

@@ -40,46 +40,60 @@ export declare class Provider implements ProviderInterface {
   /**
    * Calls a function on the StarkNet contract.
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L17-L25)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L25-L39)
    *
    * @param invokeTransaction - transaction to be invoked
+   * @param blockHash
    * @param blockNumber
    * @returns the result of the function on the smart contract.
    */
   callContract(
     invokeTransaction: CallContractTransaction,
+    blockHash?: BigNumberish,
     blockNumber?: BlockNumber
   ): Promise<CallContractResponse>;
   /**
-   * Gets the block information from a block ID.
+   * Gets the block information
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L27-L31)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L41-L53)
    *
+   * @param blockHash
    * @param blockNumber
    * @returns the block object { block_number, previous_block_number, state_root, status, timestamp, transaction_receipts, transactions }
    */
-  getBlock(blockNumber?: BlockNumber): Promise<GetBlockResponse>;
+  getBlock(blockHash?: BigNumberish, blockNumber?: BlockNumber): Promise<GetBlockResponse>;
   /**
    * Gets the code of the deployed contract.
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L33-L36)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L55-L68)
    *
    * @param contractAddress
+   * @param blockHash
    * @param blockNumber
    * @returns Bytecode and ABI of compiled contract
    */
-  getCode(contractAddress: string, blockNumber?: BlockNumber): Promise<GetCodeResponse>;
+  getCode(
+    contractAddress: string,
+    blockHash?: BigNumberish,
+    blockNumber?: BlockNumber
+  ): Promise<GetCodeResponse>;
   /**
    * Gets the contract's storage variable at a specific key.
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L38-L46)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L70-L85)
    *
    * @param contractAddress
    * @param key - from getStorageVarAddress('<STORAGE_VARIABLE_NAME>') (WIP)
+   * @param blockHash
    * @param blockNumber
    * @returns the value of the storage variable
    */
-  getStorageAt(contractAddress: string, key: number, blockNumber?: BlockNumber): Promise<object>;
+  getStorageAt(
+    contractAddress: string,
+    key: number,
+    blockHash?: BigNumberish,
+    blockNumber?: BlockNumber
+  ): Promise<object>;
   /**
    * Gets the status of a transaction.
    *

package/provider/default.js

@@ -156,6 +156,7 @@ var url_join_1 = __importDefault(require('url-join'));
 var json_1 = require('../utils/json');
 var number_1 = require('../utils/number');
 var stark_1 = require('../utils/stark');
+var utils_1 = require('./utils');
 function wait(delay) {
   return new Promise(function (res) {
     return setTimeout(res, delay);
@@ -217,28 +218,33 @@ var Provider = /** @class */ (function () {
   /**
    * Calls a function on the StarkNet contract.
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L17-L25)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L25-L39)
    *
    * @param invokeTransaction - transaction to be invoked
+   * @param blockHash
    * @param blockNumber
    * @returns the result of the function on the smart contract.
    */
-  Provider.prototype.callContract = function (invokeTransaction, blockNumber) {
+  Provider.prototype.callContract = function (invokeTransaction, blockHash, blockNumber) {
     if (blockNumber === void 0) {
       blockNumber = null;
     }
     return __awaiter(this, void 0, void 0, function () {
-      var data;
+      var formattedBlockIdentifier, data;
       return __generator(this, function (_a) {
         switch (_a.label) {
           case 0:
+            formattedBlockIdentifier = (0, utils_1.getFormattedBlockIdentifier)(
+              blockHash,
+              blockNumber
+            );
             return [
               4 /*yield*/,
               axios_1.default.post(
                 (0, url_join_1.default)(
                   this.feederGatewayUrl,
                   'call_contract',
-                  '?blockNumber=' + blockNumber
+                  formattedBlockIdentifier
                 ),
                 __assign({ signature: [], calldata: [] }, invokeTransaction)
               ),
@@ -251,29 +257,34 @@ var Provider = /** @class */ (function () {
     });
   };
   /**
-   * Gets the block information from a block ID.
+   * Gets the block information
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L27-L31)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L41-L53)
    *
+   * @param blockHash
    * @param blockNumber
    * @returns the block object { block_number, previous_block_number, state_root, status, timestamp, transaction_receipts, transactions }
    */
-  Provider.prototype.getBlock = function (blockNumber) {
+  Provider.prototype.getBlock = function (blockHash, blockNumber) {
     if (blockNumber === void 0) {
       blockNumber = null;
     }
     return __awaiter(this, void 0, void 0, function () {
-      var data;
+      var formattedBlockIdentifier, data;
       return __generator(this, function (_a) {
         switch (_a.label) {
           case 0:
+            formattedBlockIdentifier = (0, utils_1.getFormattedBlockIdentifier)(
+              blockHash,
+              blockNumber
+            );
             return [
               4 /*yield*/,
               axios_1.default.get(
                 (0, url_join_1.default)(
                   this.feederGatewayUrl,
                   'get_block',
-                  '?blockNumber=' + blockNumber
+                  formattedBlockIdentifier
                 )
               ),
             ];
@@ -287,28 +298,33 @@ var Provider = /** @class */ (function () {
   /**
    * Gets the code of the deployed contract.
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L33-L36)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L55-L68)
    *
    * @param contractAddress
+   * @param blockHash
    * @param blockNumber
    * @returns Bytecode and ABI of compiled contract
    */
-  Provider.prototype.getCode = function (contractAddress, blockNumber) {
+  Provider.prototype.getCode = function (contractAddress, blockHash, blockNumber) {
     if (blockNumber === void 0) {
       blockNumber = null;
     }
     return __awaiter(this, void 0, void 0, function () {
-      var data;
+      var formattedBlockIdentifier, data;
       return __generator(this, function (_a) {
         switch (_a.label) {
           case 0:
+            formattedBlockIdentifier = (0, utils_1.getFormattedBlockIdentifier)(
+              blockHash,
+              blockNumber
+            );
             return [
               4 /*yield*/,
               axios_1.default.get(
                 (0, url_join_1.default)(
                   this.feederGatewayUrl,
                   'get_code',
-                  '?contractAddress=' + contractAddress + '&blockNumber=' + blockNumber
+                  '?contractAddress=' + contractAddress + '&' + formattedBlockIdentifier
                 )
               ),
             ];
@@ -323,22 +339,27 @@ var Provider = /** @class */ (function () {
   /**
    * Gets the contract's storage variable at a specific key.
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L38-L46)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L70-L85)
    *
    * @param contractAddress
    * @param key - from getStorageVarAddress('<STORAGE_VARIABLE_NAME>') (WIP)
+   * @param blockHash
    * @param blockNumber
    * @returns the value of the storage variable
    */
-  Provider.prototype.getStorageAt = function (contractAddress, key, blockNumber) {
+  Provider.prototype.getStorageAt = function (contractAddress, key, blockHash, blockNumber) {
     if (blockNumber === void 0) {
       blockNumber = null;
     }
     return __awaiter(this, void 0, void 0, function () {
-      var data;
+      var formattedBlockIdentifier, data;
       return __generator(this, function (_a) {
         switch (_a.label) {
           case 0:
+            formattedBlockIdentifier = (0, utils_1.getFormattedBlockIdentifier)(
+              blockHash,
+              blockNumber
+            );
             return [
               4 /*yield*/,
               axios_1.default.get(
@@ -349,8 +370,8 @@ var Provider = /** @class */ (function () {
                     contractAddress +
                     '&key=' +
                     key +
-                    '&blockNumber=' +
-                    blockNumber
+                    '&' +
+                    formattedBlockIdentifier
                 )
               ),
             ];
@@ -521,7 +542,7 @@ var Provider = /** @class */ (function () {
       retryInterval = 8000;
     }
     return __awaiter(this, void 0, void 0, function () {
-      var onchain, res;
+      var onchain, res, error;
       return __generator(this, function (_a) {
         switch (_a.label) {
           case 0:
@@ -542,10 +563,10 @@ var Provider = /** @class */ (function () {
             res = _a.sent();
             if (res.tx_status === 'ACCEPTED_ON_L1' || res.tx_status === 'ACCEPTED_ON_L2') {
               onchain = true;
-            } else if (res.tx_status === 'REJECTED') {
-              throw Error('REJECTED');
-            } else if (res.tx_status === 'NOT_RECEIVED') {
-              throw Error('NOT_RECEIVED');
+            } else if (res.tx_status === 'REJECTED' || res.tx_status === 'NOT_RECEIVED') {
+              error = Error(res.tx_status);
+              error.response = res;
+              throw error;
             }
             return [3 /*break*/, 2];
           case 5:

package/provider/interface.d.ts

@@ -27,48 +27,58 @@ export declare abstract class ProviderInterface {
   /**
    * Calls a function on the StarkNet contract.
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L17-L25)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L25-L39)
    *
    * @param invokeTransaction - transaction to be invoked
+   * @param blockHash
    * @param blockNumber
    * @returns the result of the function on the smart contract.
    */
   abstract callContract(
     invokeTransaction: CallContractTransaction,
+    blockHash?: BigNumberish,
     blockNumber?: BlockNumber
   ): Promise<CallContractResponse>;
   /**
-   * Gets the block information from a block ID.
+   * Gets the block information
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L27-L31)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L41-L53)
    *
+   * @param blockHash
    * @param blockNumber
    * @returns the block object { block_number, previous_block_number, state_root, status, timestamp, transaction_receipts, transactions }
    */
-  abstract getBlock(blockNumber?: BlockNumber): Promise<GetBlockResponse>;
+  abstract getBlock(blockHash?: BigNumberish, blockNumber?: BlockNumber): Promise<GetBlockResponse>;
   /**
    * Gets the code of the deployed contract.
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L33-L36)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L55-L68)
    *
    * @param contractAddress
+   * @param blockHash
    * @param blockNumber
    * @returns Bytecode and ABI of compiled contract
    */
-  abstract getCode(contractAddress: string, blockNumber?: BlockNumber): Promise<GetCodeResponse>;
+  abstract getCode(
+    contractAddress: string,
+    blockHash?: BigNumberish,
+    blockNumber?: BlockNumber
+  ): Promise<GetCodeResponse>;
   /**
    * Gets the contract's storage variable at a specific key.
    *
-   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L38-L46)
+   * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L70-L85)
    *
    * @param contractAddress
    * @param key - from getStorageVarAddress('<STORAGE_VARIABLE_NAME>') (WIP)
+   * @param blockHash
    * @param blockNumber
    * @returns the value of the storage variable
    */
   abstract getStorageAt(
     contractAddress: string,
     key: number,
+    blockHash?: BigNumberish,
     blockNumber?: BlockNumber
   ): Promise<object>;
   /**

package/provider/utils.d.ts

@@ -0,0 +1,30 @@
+import type { BlockNumber } from '../types';
+import { BigNumberish } from '../utils/number';
+/**
+ * TODO
+ * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L148-L153)
+ *
+ * @param hashValue
+ * @param hashField
+ */
+export declare function formatHash(): void;
+/**
+ * TODO
+ * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L156-L161)
+ * @param txHash
+ * @param txId
+ */
+export declare function txIdentifier(): void;
+/**
+ * Gets the block identifier for API request
+ *
+ * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L164-L173)
+ *
+ * @param blockNumber
+ * @param blockHash
+ * @returns block identifier for API request
+ */
+export declare function getFormattedBlockIdentifier(
+  blockHash?: BigNumberish,
+  blockNumber?: BlockNumber
+): string;

package/provider/utils.js

@@ -0,0 +1,39 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.getFormattedBlockIdentifier = exports.txIdentifier = exports.formatHash = void 0;
+/**
+ * TODO
+ * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L148-L153)
+ *
+ * @param hashValue
+ * @param hashField
+ */
+function formatHash() {}
+exports.formatHash = formatHash;
+/**
+ * TODO
+ * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L156-L161)
+ * @param txHash
+ * @param txId
+ */
+function txIdentifier() {}
+exports.txIdentifier = txIdentifier;
+/**
+ * Gets the block identifier for API request
+ *
+ * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L164-L173)
+ *
+ * @param blockNumber
+ * @param blockHash
+ * @returns block identifier for API request
+ */
+function getFormattedBlockIdentifier(blockHash, blockNumber) {
+  if (blockNumber === void 0) {
+    blockNumber = null;
+  }
+  if (blockHash) {
+    return '?blockHash=' + blockHash;
+  }
+  return '?blockNumber=' + blockNumber;
+}
+exports.getFormattedBlockIdentifier = getFormattedBlockIdentifier;

package/signer/default.d.ts

@@ -1,5 +1,6 @@
 import { Provider } from '../provider';
 import { AddTransactionResponse, KeyPair, Signature, Transaction } from '../types';
+import { BigNumberish } from '../utils/number';
 import { TypedData } from '../utils/typedData';
 import { SignerInterface } from './interface';
 export declare class Signer extends Provider implements SignerInterface {
@@ -31,4 +32,23 @@ export declare class Signer extends Provider implements SignerInterface {
    * @throws {Error} if the JSON object is not a valid JSON
    */
   hashMessage(typedData: TypedData): Promise<string>;
+  /**
+   * Verify a signature of a JSON object
+   *
+   * @param json - JSON object to be verified
+   * @param signature - signature of the JSON object
+   * @returns true if the signature is valid, false otherwise
+   * @throws {Error} if the JSON object is not a valid JSON or the signature is not a valid signature
+   */
+  verifyMessageHash(hash: BigNumberish, signature: Signature): Promise<boolean>;
+  /**
+   * Verify a signature of a given hash
+   * @warning This method is not recommended, use verifyMessage instead
+   *
+   * @param hash - hash to be verified
+   * @param signature - signature of the hash
+   * @returns true if the signature is valid, false otherwise
+   * @throws {Error} if the signature is not a valid signature
+   */
+  verifyMessage(typedData: TypedData, signature: Signature): Promise<boolean>;
 }

package/signer/default.js

@@ -197,6 +197,7 @@ var __importDefault =
 Object.defineProperty(exports, '__esModule', { value: true });
 exports.Signer = void 0;
 var minimalistic_assert_1 = __importDefault(require('minimalistic-assert'));
+var contract_1 = require('../contract');
 var provider_1 = require('../provider');
 var ellipticCurve_1 = require('../utils/ellipticCurve');
 var encode_1 = require('../utils/encode');
@@ -323,6 +324,69 @@ var Signer = /** @class */ (function (_super) {
       });
     });
   };
+  /**
+   * Verify a signature of a JSON object
+   *
+   * @param json - JSON object to be verified
+   * @param signature - signature of the JSON object
+   * @returns true if the signature is valid, false otherwise
+   * @throws {Error} if the JSON object is not a valid JSON or the signature is not a valid signature
+   */
+  Signer.prototype.verifyMessageHash = function (hash, signature) {
+    return __awaiter(this, void 0, void 0, function () {
+      var _a;
+      return __generator(this, function (_b) {
+        switch (_b.label) {
+          case 0:
+            _b.trys.push([0, 2, , 3]);
+            return [
+              4 /*yield*/,
+              this.callContract({
+                contract_address: this.address,
+                entry_point_selector: (0, stark_1.getSelectorFromName)('is_valid_signature'),
+                calldata: (0, contract_1.compileCalldata)({
+                  hash: (0, number_1.toBN)(hash).toString(),
+                  signature: signature.map(function (x) {
+                    return (0, number_1.toBN)(x).toString();
+                  }),
+                }),
+              }),
+            ];
+          case 1:
+            _b.sent();
+            return [2 /*return*/, true];
+          case 2:
+            _a = _b.sent();
+            return [2 /*return*/, false];
+          case 3:
+            return [2 /*return*/];
+        }
+      });
+    });
+  };
+  /**
+   * Verify a signature of a given hash
+   * @warning This method is not recommended, use verifyMessage instead
+   *
+   * @param hash - hash to be verified
+   * @param signature - signature of the hash
+   * @returns true if the signature is valid, false otherwise
+   * @throws {Error} if the signature is not a valid signature
+   */
+  Signer.prototype.verifyMessage = function (typedData, signature) {
+    return __awaiter(this, void 0, void 0, function () {
+      var hash;
+      return __generator(this, function (_a) {
+        switch (_a.label) {
+          case 0:
+            return [4 /*yield*/, this.hashMessage(typedData)];
+          case 1:
+            hash = _a.sent();
+            return [2 /*return*/, this.verifyMessageHash(hash, signature)];
+        }
+      });
+    });
+  };
   return Signer;
 })(provider_1.Provider);
 exports.Signer = Signer;

package/signer/interface.d.ts

@@ -1,5 +1,6 @@
 import { Provider } from '../provider';
 import { AddTransactionResponse, Signature, Transaction } from '../types';
+import { BigNumberish } from '../utils/number';
 import { TypedData } from '../utils/typedData/types';
 export declare abstract class SignerInterface extends Provider {
   abstract address: string;
@@ -30,4 +31,23 @@ export declare abstract class SignerInterface extends Provider {
    * @throws {Error} if the JSON object is not a valid JSON
    */
   abstract hashMessage(typedData: TypedData): Promise<string>;
+  /**
+   * Verify a signature of a JSON object
+   *
+   * @param json - JSON object to be verified
+   * @param signature - signature of the JSON object
+   * @returns true if the signature is valid, false otherwise
+   * @throws {Error} if the JSON object is not a valid JSON or the signature is not a valid signature
+   */
+  abstract verifyMessage(typedData: TypedData, signature: Signature): Promise<boolean>;
+  /**
+   * Verify a signature of a given hash
+   * @warning This method is not recommended, use verifyMessage instead
+   *
+   * @param hash - hash to be verified
+   * @param signature - signature of the hash
+   * @returns true if the signature is valid, false otherwise
+   * @throws {Error} if the signature is not a valid signature
+   */
+  abstract verifyMessageHash(hash: BigNumberish, signature: Signature): Promise<boolean>;
 }