starknet 4.0.0 → 4.2.0

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+# [4.2.0](https://github.com/0xs34n/starknet.js/compare/v4.1.0...v4.2.0) (2022-08-09)
+
+### Features
+
+- change checksum address hashing algorithm ([0f32adf](https://github.com/0xs34n/starknet.js/commit/0f32adf217b3d2e55046bbb21980648f0c8cf631))
+
+# [4.1.0](https://github.com/0xs34n/starknet.js/compare/v4.0.1...v4.1.0) (2022-08-03)
+
+### Features
+
+- get-code ([de6e597](https://github.com/0xs34n/starknet.js/commit/de6e5971de5155925defcf9249a8160dc3fdc9b7))
+
+## [4.0.1](https://github.com/0xs34n/starknet.js/compare/v4.0.0...v4.0.1) (2022-08-03)
+
+### Bug Fixes
+
+- use custom fetch ponyfill ([16e9a53](https://github.com/0xs34n/starknet.js/commit/16e9a530d62942da75ed1bc30d0048a35f9f0152))
+- use isomorphic-unfetch ([aa7af66](https://github.com/0xs34n/starknet.js/commit/aa7af6622d918ad0d17fe28bf1e73635895537c5))
+
 # [4.0.0](https://github.com/0xs34n/starknet.js/compare/v3.19.0...v4.0.0) (2022-07-27)
 
 ### Documentation

package/__tests__/defaultProvider.test.ts

@@ -62,6 +62,11 @@ describe('defaultProvider', () => {
       return expect(block).toHaveProperty('block_number');
     });
 
+    test('getCode() -> { bytecode }', async () => {
+      const code = await testProvider.getCode(exampleContractAddress);
+      return expect(Array.isArray(code.bytecode)).toBe(true);
+    });
+
     describe('getStorageAt', () => {
       test('with "key" type of number', () => {
         return expect(testProvider.getStorageAt(exampleContractAddress, 0)).resolves.not.toThrow();

package/__tests__/jest.setup.ts

@@ -1,9 +1,8 @@
+import 'isomorphic-fetch';
+
 /* eslint-disable no-console */
-import fetch from 'cross-fetch';
 import { register } from 'fetch-intercept';
 
-global.fetch = fetch;
-
 jest.setTimeout(50 * 60 * 1000);
 
 if (process.env.DEBUG === 'true') {

package/__tests__/utils/address.test.ts

@@ -26,12 +26,12 @@ describe('address checksums', () => {
       '0x2fd23d9182193775423497fc0c472e156c57c69e4089a1967fb288a2d84e914'
     );
     expect(checksumAddress).toEqual(
-      '0x02FD23D9182193775423497Fc0c472E156C57C69E4089a1967fb288a2D84e914'
+      '0x02Fd23d9182193775423497fc0c472E156C57C69E4089A1967fb288A2d84e914'
     );
   });
   test('should be able to verify checksum address', () => {
     const isValid = validateChecksumAddress(
-      '0x02FD23D9182193775423497Fc0c472E156C57C69E4089a1967fb288a2D84e914'
+      '0x02Fd23d9182193775423497fc0c472E156C57C69E4089A1967fb288A2d84e914'
     );
     expect(isValid).toEqual(true);
   });

package/dist/provider/default.d.ts

@@ -1,5 +1,5 @@
 import { StarknetChainId } from '../constants';
-import { BlockTag, Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
+import { BlockTag, Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
 import { BigNumberish } from '../utils/number';
 import { ProviderInterface } from './interface';
 import { RpcProviderOptions } from './rpc';
@@ -23,5 +23,6 @@ export declare class Provider implements ProviderInterface {
     invokeFunction(functionInvocation: Invocation, details: InvocationsDetails): Promise<InvokeFunctionResponse>;
     deployContract(payload: DeployContractPayload): Promise<DeployContractResponse>;
     declareContract(payload: DeclareContractPayload): Promise<DeclareContractResponse>;
+    getCode(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<GetCodeResponse>;
     waitForTransaction(txHash: BigNumberish, retryInterval?: number): Promise<void>;
 }

package/dist/provider/default.js

@@ -137,6 +137,13 @@ var Provider = /** @class */ (function () {
             });
         });
     };
+    Provider.prototype.getCode = function (contractAddress, blockIdentifier) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.provider.getCode(contractAddress, blockIdentifier)];
+            });
+        });
+    };
     Provider.prototype.waitForTransaction = function (txHash, retryInterval) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {

package/dist/provider/interface.d.ts

@@ -1,5 +1,5 @@
 import { StarknetChainId } from '../constants';
-import type { BlockTag, Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
+import type { BlockTag, Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
 import type { BigNumberish } from '../utils/number';
 import { BlockIdentifier } from './utils';
 export declare abstract class ProviderInterface {
@@ -19,6 +19,7 @@ export declare abstract class ProviderInterface {
      * @returns the block object
      */
     abstract getBlock(blockIdentifier: BlockIdentifier): Promise<GetBlockResponse>;
+    abstract getCode(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<GetCodeResponse>;
     /**
      * Gets the contract class of the deployed contract.
      *

package/dist/provider/rpc.d.ts

@@ -24,6 +24,7 @@ export declare class RpcProvider implements ProviderInterface {
     deployContract({ contract, constructorCalldata, addressSalt, }: DeployContractPayload): Promise<DeployContractResponse>;
     invokeFunction(functionInvocation: Invocation, details: InvocationsDetails): Promise<InvokeFunctionResponse>;
     callContract(call: Call, blockIdentifier?: BlockIdentifier): Promise<CallContractResponse>;
+    getCode(contractAddress: string, _blockIdentifier?: BlockIdentifier): Promise<RPC.GetCodeResponse>;
     waitForTransaction(txHash: BigNumberish, retryInterval?: number): Promise<void>;
     /**
      * Gets the transaction count from a block.

package/dist/provider/rpc.js

@@ -40,7 +40,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RpcProvider = void 0;
-var cross_fetch_1 = __importDefault(require("cross-fetch"));
+var fetchPonyfill_1 = __importDefault(require("../utils/fetchPonyfill"));
 var hash_1 = require("../utils/hash");
 var json_1 = require("../utils/json");
 var number_1 = require("../utils/number");
@@ -73,7 +73,7 @@ var RpcProvider = /** @class */ (function () {
                         _c.label = 1;
                     case 1:
                         _c.trys.push([1, 4, , 5]);
-                        return [4 /*yield*/, (0, cross_fetch_1.default)(this.nodeUrl, {
+                        return [4 /*yield*/, (0, fetchPonyfill_1.default)(this.nodeUrl, {
                                 method: 'POST',
                                 body: (0, json_1.stringify)(requestData),
                                 headers: {
@@ -248,6 +248,19 @@ var RpcProvider = /** @class */ (function () {
             });
         });
     };
+    RpcProvider.prototype.getCode = function (contractAddress, _blockIdentifier) {
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.fetchEndpoint('starknet_getCode', [contractAddress])];
+                    case 1:
+                        result = _a.sent();
+                        return [2 /*return*/, this.responseParser.parseGetCodeResponse(result)];
+                }
+            });
+        });
+    };
     RpcProvider.prototype.waitForTransaction = function (txHash, retryInterval) {
         if (retryInterval === void 0) { retryInterval = 8000; }
         return __awaiter(this, void 0, void 0, function () {

package/dist/provider/sequencer.d.ts

@@ -37,6 +37,7 @@ export declare class SequencerProvider implements ProviderInterface {
     deployContract({ contract, constructorCalldata, addressSalt, }: DeployContractPayload): Promise<DeployContractResponse>;
     declareContract({ contract, }: DeclareContractPayload): Promise<DeclareContractResponse>;
     getEstimateFee(invocation: Invocation, blockIdentifier?: BlockIdentifier, invocationDetails?: InvocationsDetails): Promise<EstimateFeeResponse>;
+    getCode(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<Sequencer.GetCodeResponse>;
     waitForTransaction(txHash: BigNumberish, retryInterval?: number): Promise<void>;
     /**
      * Gets the status of a transaction.

package/dist/provider/sequencer.js

@@ -58,6 +58,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SequencerProvider = void 0;
 var url_join_1 = __importDefault(require("url-join"));
 var constants_1 = require("../constants");
+var fetchPonyfill_1 = __importDefault(require("../utils/fetchPonyfill"));
 var hash_1 = require("../utils/hash");
 var json_1 = require("../utils/json");
 var number_1 = require("../utils/number");
@@ -180,7 +181,7 @@ var SequencerProvider = /** @class */ (function () {
                         _c.label = 1;
                     case 1:
                         _c.trys.push([1, 4, , 5]);
-                        return [4 /*yield*/, fetch(url, {
+                        return [4 /*yield*/, (0, fetchPonyfill_1.default)(url, {
                                 method: method,
                                 body: (0, json_1.stringify)(request),
                                 headers: headers,
@@ -354,6 +355,14 @@ var SequencerProvider = /** @class */ (function () {
             });
         });
     };
+    SequencerProvider.prototype.getCode = function (contractAddress, blockIdentifier) {
+        if (blockIdentifier === void 0) { blockIdentifier = 'pending'; }
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.fetchEndpoint('get_code', { contractAddress: contractAddress, blockIdentifier: blockIdentifier }).then(this.responseParser.parseGetCodeResponse)];
+            });
+        });
+    };
     SequencerProvider.prototype.waitForTransaction = function (txHash, retryInterval) {
         if (retryInterval === void 0) { retryInterval = 8000; }
         return __awaiter(this, void 0, void 0, function () {

package/dist/types/api/sequencer.d.ts

@@ -39,10 +39,6 @@ export declare type ExecutionResources = {
     };
     n_memory_holes: number;
 };
-export declare type GetCodeResponse = {
-    bytecode: string[];
-    abi: Abi;
-};
 export declare type GetTransactionTraceResponse = {
     function_invocation: {
         caller_address: string;
@@ -97,6 +93,10 @@ export declare namespace Sequencer {
         address?: string;
         class_hash?: string;
     };
+    type GetCodeResponse = {
+        bytecode: string[];
+        abi: Abi;
+    };
     interface InvokeFunctionTransactionResponse extends InvokeFunctionTransaction {
         transaction_hash: string;
     }

package/dist/types/provider.d.ts

@@ -13,6 +13,9 @@ export interface GetBlockResponse {
     transactions: Array<string>;
     starknet_version?: string;
 }
+export interface GetCodeResponse {
+    bytecode: string[];
+}
 export declare type GetTransactionResponse = InvokeTransactionResponse & DeclareTransactionResponse;
 export interface CommonTransactionResponse {
     transaction_hash?: string;

package/dist/utils/address.js

@@ -23,7 +23,7 @@ exports.validateAndParseAddress = validateAndParseAddress;
 // from https://github.com/ethers-io/ethers.js/blob/fc1e006575d59792fa97b4efb9ea2f8cca1944cf/packages/address/src.ts/index.ts#L12
 function getChecksumAddress(address) {
     var chars = (0, encode_1.removeHexPrefix)(validateAndParseAddress(address)).toLowerCase().split('');
-    var hashed = (0, bytes_1.arrayify)((0, hash_1.pedersen)([0, address]), { hexPad: 'left' }); // as the hash will be 251 bits (63 chars) we need to pad it to 64 chars without changing the number value ("left")
+    var hashed = (0, bytes_1.arrayify)((0, hash_1.keccakBn)(address), { hexPad: 'left' }); // in case the hash is 251 bits (63 chars) we need to pad it to 64 chars without changing the number value ("left")
     for (var i = 0; i < chars.length; i += 2) {
         if (hashed[i >> 1] >> 4 >= 8) {
             chars[i] = chars[i].toUpperCase();

package/dist/utils/fetchPonyfill.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/dist/utils/fetchPonyfill.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = (typeof window !== 'undefined' && window.fetch) || // use buildin fetch in browser if available
+    (typeof global !== 'undefined' && global.fetch) || // use buildin fetch in node, react-native and service worker if available
+    // eslint-disable-next-line global-require
+    require('isomorphic-fetch'); // ponyfill fetch in node and browsers that don't have it

package/dist/utils/hash.d.ts

@@ -4,6 +4,7 @@ import { RawCalldata } from '../types/lib';
 import { BigNumberish } from './number';
 export declare const transactionVersion = 0;
 export declare const feeTransactionVersion: BN;
+export declare function keccakBn(value: BigNumberish): string;
 /**
  * Function to get the starknet keccak hash from a string
  *

package/dist/utils/hash.js

@@ -28,8 +28,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateContractAddressFromHash = exports.calculcateTransactionHash = exports.calculateDeployTransactionHash = exports.calculateTransactionHashCommon = exports.computeHashOnElements = exports.pedersen = exports.getSelectorFromName = exports.starknetKeccak = exports.feeTransactionVersion = exports.transactionVersion = void 0;
+exports.calculateContractAddressFromHash = exports.calculcateTransactionHash = exports.calculateDeployTransactionHash = exports.calculateTransactionHashCommon = exports.computeHashOnElements = exports.pedersen = exports.getSelectorFromName = exports.starknetKeccak = exports.keccakBn = exports.feeTransactionVersion = exports.transactionVersion = void 0;
 var keccak_1 = require("ethereum-cryptography/keccak");
+var utils_1 = require("ethereum-cryptography/utils");
 var minimalistic_assert_1 = __importDefault(require("minimalistic-assert"));
 var constants_1 = require("../constants");
 var ellipticCurve_1 = require("./ellipticCurve");
@@ -37,6 +38,12 @@ var encode_1 = require("./encode");
 var number_1 = require("./number");
 exports.transactionVersion = 0;
 exports.feeTransactionVersion = (0, number_1.toBN)(2).pow((0, number_1.toBN)(128)).add((0, number_1.toBN)(exports.transactionVersion));
+function keccakBn(value) {
+    var hexWithoutPrefix = (0, encode_1.removeHexPrefix)((0, number_1.toHex)((0, number_1.toBN)(value)));
+    var evenHex = hexWithoutPrefix.length % 2 === 0 ? hexWithoutPrefix : "0".concat(hexWithoutPrefix);
+    return (0, encode_1.addHexPrefix)((0, encode_1.buf2hex)((0, keccak_1.keccak256)((0, utils_1.hexToBytes)(evenHex))));
+}
+exports.keccakBn = keccakBn;
 function keccakHex(value) {
     return (0, encode_1.addHexPrefix)((0, encode_1.buf2hex)((0, keccak_1.keccak256)((0, encode_1.utf8ToArray)(value))));
 }

package/dist/utils/responseParser/rpc.d.ts

@@ -5,6 +5,7 @@ export declare class RPCResponseParser extends ResponseParser {
     parseGetBlockResponse(res: RPC.GetBlockResponse): GetBlockResponse;
     parseGetTransactionResponse(res: RPC.GetTransactionResponse): GetTransactionResponse;
     parseGetTransactionReceiptResponse(res: RPC.GetTransactionReceiptResponse): GetTransactionReceiptResponse;
+    parseGetCodeResponse(res: RPC.GetCodeResponse): RPC.GetCodeResponse;
     parseFeeEstimateResponse(res: RPC.EstimateFeeResponse): EstimateFeeResponse;
     parseCallContractResponse(res: Array<string>): CallContractResponse;
     parseInvokeFunctionResponse(res: RPC.AddTransactionResponse): InvokeFunctionResponse;

package/dist/utils/responseParser/rpc.js

@@ -62,6 +62,9 @@ var RPCResponseParser = /** @class */ (function (_super) {
             events: res.events,
         };
     };
+    RPCResponseParser.prototype.parseGetCodeResponse = function (res) {
+        return res;
+    };
     RPCResponseParser.prototype.parseFeeEstimateResponse = function (res) {
         return {
             overall_fee: (0, number_1.toBN)(res.overall_fee),

package/dist/utils/responseParser/sequencer.d.ts

@@ -5,6 +5,7 @@ export declare class SequencerAPIResponseParser extends ResponseParser {
     parseGetBlockResponse(res: Sequencer.GetBlockResponse): GetBlockResponse;
     parseGetTransactionResponse(res: Sequencer.GetTransactionResponse): GetTransactionResponse;
     parseGetTransactionReceiptResponse(res: Sequencer.TransactionReceiptResponse): GetTransactionReceiptResponse;
+    parseGetCodeResponse(res: Sequencer.GetCodeResponse): Sequencer.GetCodeResponse;
     parseFeeEstimateResponse(res: Sequencer.EstimateFeeResponse): EstimateFeeResponse;
     parseCallContractResponse(res: Sequencer.CallContractResponse): CallContractResponse;
     parseInvokeFunctionResponse(res: Sequencer.AddTransactionResponse): InvokeFunctionResponse;

package/dist/utils/responseParser/sequencer.js

@@ -79,6 +79,9 @@ var SequencerAPIResponseParser = /** @class */ (function (_super) {
             l1_origin_message: undefined,
         };
     };
+    SequencerAPIResponseParser.prototype.parseGetCodeResponse = function (res) {
+        return res;
+    };
     SequencerAPIResponseParser.prototype.parseFeeEstimateResponse = function (res) {
         if ('overall_fee' in res) {
             var gasInfo = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starknet",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "JavaScript library for StarkNet",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -43,10 +43,8 @@
     "@types/minimalistic-assert": "^1.0.1",
     "@types/pako": "^2.0.0",
     "@types/url-join": "^4.0.1",
-    "@types/whatwg-fetch": "^0.0.33",
     "@typescript-eslint/eslint-plugin": "^5.28.0",
     "@typescript-eslint/parser": "^5.28.0",
-    "cross-fetch": "^3.1.5",
     "eslint": "^8.17.0",
     "eslint-config-airbnb-base": "^15.0.0",
     "eslint-config-airbnb-typescript": "^17.0.0",
@@ -62,16 +60,15 @@
     "prettier": "^2.7.0",
     "prettier-plugin-import-sort": "^0.0.7",
     "typedoc": "^0.22.17",
-    "typescript": "^4.7.3",
-    "whatwg-fetch": "^3.6.2"
+    "typescript": "^4.7.3"
   },
   "dependencies": {
     "@ethersproject/bytes": "^5.6.1",
     "bn.js": "^5.2.1",
-    "cross-fetch": "^3.1.5",
     "elliptic": "^6.5.4",
     "ethereum-cryptography": "^1.0.3",
     "hash.js": "^1.1.7",
+    "isomorphic-fetch": "^3.0.0",
     "json-bigint": "^1.0.0",
     "minimalistic-assert": "^1.0.1",
     "pako": "^2.0.4",

package/provider/default.d.ts

@@ -1,5 +1,5 @@
 import { StarknetChainId } from '../constants';
-import { BlockTag, Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
+import { BlockTag, Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
 import { BigNumberish } from '../utils/number';
 import { ProviderInterface } from './interface';
 import { RpcProviderOptions } from './rpc';
@@ -23,5 +23,6 @@ export declare class Provider implements ProviderInterface {
     invokeFunction(functionInvocation: Invocation, details: InvocationsDetails): Promise<InvokeFunctionResponse>;
     deployContract(payload: DeployContractPayload): Promise<DeployContractResponse>;
     declareContract(payload: DeclareContractPayload): Promise<DeclareContractResponse>;
+    getCode(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<GetCodeResponse>;
     waitForTransaction(txHash: BigNumberish, retryInterval?: number): Promise<void>;
 }

package/provider/default.js

@@ -137,6 +137,13 @@ var Provider = /** @class */ (function () {
             });
         });
     };
+    Provider.prototype.getCode = function (contractAddress, blockIdentifier) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.provider.getCode(contractAddress, blockIdentifier)];
+            });
+        });
+    };
     Provider.prototype.waitForTransaction = function (txHash, retryInterval) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {

package/provider/interface.d.ts

@@ -1,5 +1,5 @@
 import { StarknetChainId } from '../constants';
-import type { BlockTag, Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
+import type { BlockTag, Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
 import type { BigNumberish } from '../utils/number';
 import { BlockIdentifier } from './utils';
 export declare abstract class ProviderInterface {
@@ -19,6 +19,7 @@ export declare abstract class ProviderInterface {
      * @returns the block object
      */
     abstract getBlock(blockIdentifier: BlockIdentifier): Promise<GetBlockResponse>;
+    abstract getCode(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<GetCodeResponse>;
     /**
      * Gets the contract class of the deployed contract.
      *

package/provider/rpc.d.ts

@@ -24,6 +24,7 @@ export declare class RpcProvider implements ProviderInterface {
     deployContract({ contract, constructorCalldata, addressSalt, }: DeployContractPayload): Promise<DeployContractResponse>;
     invokeFunction(functionInvocation: Invocation, details: InvocationsDetails): Promise<InvokeFunctionResponse>;
     callContract(call: Call, blockIdentifier?: BlockIdentifier): Promise<CallContractResponse>;
+    getCode(contractAddress: string, _blockIdentifier?: BlockIdentifier): Promise<RPC.GetCodeResponse>;
     waitForTransaction(txHash: BigNumberish, retryInterval?: number): Promise<void>;
     /**
      * Gets the transaction count from a block.

package/provider/rpc.js

@@ -40,7 +40,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RpcProvider = void 0;
-var cross_fetch_1 = __importDefault(require("cross-fetch"));
+var fetchPonyfill_1 = __importDefault(require("../utils/fetchPonyfill"));
 var hash_1 = require("../utils/hash");
 var json_1 = require("../utils/json");
 var number_1 = require("../utils/number");
@@ -73,7 +73,7 @@ var RpcProvider = /** @class */ (function () {
                         _c.label = 1;
                     case 1:
                         _c.trys.push([1, 4, , 5]);
-                        return [4 /*yield*/, (0, cross_fetch_1.default)(this.nodeUrl, {
+                        return [4 /*yield*/, (0, fetchPonyfill_1.default)(this.nodeUrl, {
                                 method: 'POST',
                                 body: (0, json_1.stringify)(requestData),
                                 headers: {
@@ -248,6 +248,19 @@ var RpcProvider = /** @class */ (function () {
             });
         });
     };
+    RpcProvider.prototype.getCode = function (contractAddress, _blockIdentifier) {
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.fetchEndpoint('starknet_getCode', [contractAddress])];
+                    case 1:
+                        result = _a.sent();
+                        return [2 /*return*/, this.responseParser.parseGetCodeResponse(result)];
+                }
+            });
+        });
+    };
     RpcProvider.prototype.waitForTransaction = function (txHash, retryInterval) {
         if (retryInterval === void 0) { retryInterval = 8000; }
         return __awaiter(this, void 0, void 0, function () {

package/provider/sequencer.d.ts

@@ -37,6 +37,7 @@ export declare class SequencerProvider implements ProviderInterface {
     deployContract({ contract, constructorCalldata, addressSalt, }: DeployContractPayload): Promise<DeployContractResponse>;
     declareContract({ contract, }: DeclareContractPayload): Promise<DeclareContractResponse>;
     getEstimateFee(invocation: Invocation, blockIdentifier?: BlockIdentifier, invocationDetails?: InvocationsDetails): Promise<EstimateFeeResponse>;
+    getCode(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<Sequencer.GetCodeResponse>;
     waitForTransaction(txHash: BigNumberish, retryInterval?: number): Promise<void>;
     /**
      * Gets the status of a transaction.

package/provider/sequencer.js

@@ -58,6 +58,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SequencerProvider = void 0;
 var url_join_1 = __importDefault(require("url-join"));
 var constants_1 = require("../constants");
+var fetchPonyfill_1 = __importDefault(require("../utils/fetchPonyfill"));
 var hash_1 = require("../utils/hash");
 var json_1 = require("../utils/json");
 var number_1 = require("../utils/number");
@@ -180,7 +181,7 @@ var SequencerProvider = /** @class */ (function () {
                         _c.label = 1;
                     case 1:
                         _c.trys.push([1, 4, , 5]);
-                        return [4 /*yield*/, fetch(url, {
+                        return [4 /*yield*/, (0, fetchPonyfill_1.default)(url, {
                                 method: method,
                                 body: (0, json_1.stringify)(request),
                                 headers: headers,
@@ -354,6 +355,14 @@ var SequencerProvider = /** @class */ (function () {
             });
         });
     };
+    SequencerProvider.prototype.getCode = function (contractAddress, blockIdentifier) {
+        if (blockIdentifier === void 0) { blockIdentifier = 'pending'; }
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.fetchEndpoint('get_code', { contractAddress: contractAddress, blockIdentifier: blockIdentifier }).then(this.responseParser.parseGetCodeResponse)];
+            });
+        });
+    };
     SequencerProvider.prototype.waitForTransaction = function (txHash, retryInterval) {
         if (retryInterval === void 0) { retryInterval = 8000; }
         return __awaiter(this, void 0, void 0, function () {

package/src/provider/default.ts

@@ -10,6 +10,7 @@ import {
   DeployContractResponse,
   EstimateFeeResponse,
   GetBlockResponse,
+  GetCodeResponse,
   GetTransactionReceiptResponse,
   GetTransactionResponse,
   Invocation,
@@ -103,6 +104,13 @@ export class Provider implements ProviderInterface {
     return this.provider.declareContract(payload);
   }
 
+  public async getCode(
+    contractAddress: string,
+    blockIdentifier?: BlockIdentifier
+  ): Promise<GetCodeResponse> {
+    return this.provider.getCode(contractAddress, blockIdentifier);
+  }
+
   public async waitForTransaction(txHash: BigNumberish, retryInterval?: number): Promise<void> {
     return this.provider.waitForTransaction(txHash, retryInterval);
   }

package/src/provider/interface.ts

@@ -10,6 +10,7 @@ import type {
   DeployContractResponse,
   EstimateFeeResponse,
   GetBlockResponse,
+  GetCodeResponse,
   GetTransactionReceiptResponse,
   GetTransactionResponse,
   Invocation,
@@ -42,6 +43,11 @@ export abstract class ProviderInterface {
    */
   public abstract getBlock(blockIdentifier: BlockIdentifier): Promise<GetBlockResponse>;
 
+  public abstract getCode(
+    contractAddress: string,
+    blockIdentifier?: BlockIdentifier
+  ): Promise<GetCodeResponse>;
+
   /**
    * Gets the contract class of the deployed contract.
    *

package/src/provider/rpc.ts

@@ -1,5 +1,3 @@
-import fetch from 'cross-fetch';
-
 import { StarknetChainId } from '../constants';
 import {
   BlockTag,
@@ -18,6 +16,7 @@ import {
   InvokeFunctionResponse,
 } from '../types';
 import { RPC } from '../types/api';
+import fetch from '../utils/fetchPonyfill';
 import { getSelectorFromName } from '../utils/hash';
 import { stringify } from '../utils/json';
 import {
@@ -214,6 +213,15 @@ export class RpcProvider implements ProviderInterface {
     return this.responseParser.parseCallContractResponse(result);
   }
 
+  public async getCode(
+    contractAddress: string,
+    _blockIdentifier?: BlockIdentifier
+  ): Promise<RPC.GetCodeResponse> {
+    const result = await this.fetchEndpoint('starknet_getCode', [contractAddress]);
+
+    return this.responseParser.parseGetCodeResponse(result);
+  }
+
   public async waitForTransaction(txHash: BigNumberish, retryInterval: number = 8000) {
     let onchain = false;
     let retries = 100;

package/src/provider/sequencer.ts

@@ -24,6 +24,7 @@ import {
   GetTransactionTraceResponse,
   Sequencer,
 } from '../types/api';
+import fetch from '../utils/fetchPonyfill';
 import { getSelectorFromName } from '../utils/hash';
 import { parse, parseAlwaysAsBig, stringify } from '../utils/json';
 import { BigNumberish, bigNumberishArrayToDecimalStringArray, toBN, toHex } from '../utils/number';
@@ -322,6 +323,15 @@ export class SequencerProvider implements ProviderInterface {
     ).then(this.responseParser.parseFeeEstimateResponse);
   }
 
+  public async getCode(
+    contractAddress: string,
+    blockIdentifier: BlockIdentifier = 'pending'
+  ): Promise<Sequencer.GetCodeResponse> {
+    return this.fetchEndpoint('get_code', { contractAddress, blockIdentifier }).then(
+      this.responseParser.parseGetCodeResponse
+    );
+  }
+
   public async waitForTransaction(txHash: BigNumberish, retryInterval: number = 8000) {
     let onchain = false;
 

package/src/types/api/sequencer.ts

@@ -53,11 +53,6 @@ export type ExecutionResources = {
   n_memory_holes: number;
 };
 
-export type GetCodeResponse = {
-  bytecode: string[];
-  abi: Abi;
-};
-
 export type GetTransactionTraceResponse = {
   function_invocation: {
     caller_address: string;
@@ -116,6 +111,11 @@ export namespace Sequencer {
     class_hash?: string;
   };
 
+  export type GetCodeResponse = {
+    bytecode: string[];
+    abi: Abi;
+  };
+
   export interface InvokeFunctionTransactionResponse extends InvokeFunctionTransaction {
     transaction_hash: string;
   }

package/src/types/provider.ts

@@ -16,6 +16,11 @@ export interface GetBlockResponse {
   starknet_version?: string;
 }
 
+export interface GetCodeResponse {
+  bytecode: string[];
+  // abi: string; // is not consistent between rpc and sequencer (is it?), therefore not included in the provider interface
+}
+
 export type GetTransactionResponse = InvokeTransactionResponse & DeclareTransactionResponse;
 
 export interface CommonTransactionResponse {

package/src/utils/address.ts

@@ -3,7 +3,7 @@ import { arrayify } from '@ethersproject/bytes';
 
 import { MASK_251, ZERO } from '../constants';
 import { addHexPrefix, removeHexPrefix } from './encode';
-import { pedersen } from './hash';
+import { keccakBn } from './hash';
 import { BigNumberish, assertInRange, toBN, toHex } from './number';
 
 export function addAddressPadding(address: BigNumberish): string {
@@ -25,7 +25,7 @@ export function validateAndParseAddress(address: BigNumberish): string {
 // from https://github.com/ethers-io/ethers.js/blob/fc1e006575d59792fa97b4efb9ea2f8cca1944cf/packages/address/src.ts/index.ts#L12
 export function getChecksumAddress(address: BigNumberish): string {
   const chars = removeHexPrefix(validateAndParseAddress(address)).toLowerCase().split('');
-  const hashed = arrayify(pedersen([0, address]), { hexPad: 'left' }); // as the hash will be 251 bits (63 chars) we need to pad it to 64 chars without changing the number value ("left")
+  const hashed = arrayify(keccakBn(address), { hexPad: 'left' }); // in case the hash is 251 bits (63 chars) we need to pad it to 64 chars without changing the number value ("left")
 
   for (let i = 0; i < chars.length; i += 2) {
     if (hashed[i >> 1] >> 4 >= 8) {

package/src/utils/fetchPonyfill.ts

@@ -0,0 +1,4 @@
+export default (typeof window !== 'undefined' && window.fetch) || // use buildin fetch in browser if available
+  (typeof global !== 'undefined' && global.fetch) || // use buildin fetch in node, react-native and service worker if available
+  // eslint-disable-next-line global-require
+  require('isomorphic-fetch'); // ponyfill fetch in node and browsers that don't have it

package/src/utils/hash.ts

@@ -1,5 +1,6 @@
 import BN from 'bn.js';
 import { keccak256 } from 'ethereum-cryptography/keccak';
+import { hexToBytes } from 'ethereum-cryptography/utils';
 import assert from 'minimalistic-assert';
 
 import {
@@ -13,12 +14,18 @@ import {
 } from '../constants';
 import { RawCalldata } from '../types/lib';
 import { ec } from './ellipticCurve';
-import { addHexPrefix, buf2hex, utf8ToArray } from './encode';
+import { addHexPrefix, buf2hex, removeHexPrefix, utf8ToArray } from './encode';
 import { BigNumberish, toBN, toFelt, toHex } from './number';
 
 export const transactionVersion = 0;
 export const feeTransactionVersion = toBN(2).pow(toBN(128)).add(toBN(transactionVersion));
 
+export function keccakBn(value: BigNumberish): string {
+  const hexWithoutPrefix = removeHexPrefix(toHex(toBN(value)));
+  const evenHex = hexWithoutPrefix.length % 2 === 0 ? hexWithoutPrefix : `0${hexWithoutPrefix}`;
+  return addHexPrefix(buf2hex(keccak256(hexToBytes(evenHex))));
+}
+
 function keccakHex(value: string): string {
   return addHexPrefix(buf2hex(keccak256(utf8ToArray(value))));
 }

package/src/utils/responseParser/rpc.ts

@@ -57,6 +57,10 @@ export class RPCResponseParser extends ResponseParser {
     };
   }
 
+  public parseGetCodeResponse(res: RPC.GetCodeResponse): RPC.GetCodeResponse {
+    return res;
+  }
+
   public parseFeeEstimateResponse(res: RPC.EstimateFeeResponse): EstimateFeeResponse {
     return {
       overall_fee: toBN(res.overall_fee),

package/src/utils/responseParser/sequencer.ts

@@ -70,6 +70,10 @@ export class SequencerAPIResponseParser extends ResponseParser {
     };
   }
 
+  public parseGetCodeResponse(res: Sequencer.GetCodeResponse): Sequencer.GetCodeResponse {
+    return res;
+  }
+
   public parseFeeEstimateResponse(res: Sequencer.EstimateFeeResponse): EstimateFeeResponse {
     if ('overall_fee' in res) {
       let gasInfo = {};

package/types/api/sequencer.d.ts

@@ -39,10 +39,6 @@ export declare type ExecutionResources = {
     };
     n_memory_holes: number;
 };
-export declare type GetCodeResponse = {
-    bytecode: string[];
-    abi: Abi;
-};
 export declare type GetTransactionTraceResponse = {
     function_invocation: {
         caller_address: string;
@@ -97,6 +93,10 @@ export declare namespace Sequencer {
         address?: string;
         class_hash?: string;
     };
+    type GetCodeResponse = {
+        bytecode: string[];
+        abi: Abi;
+    };
     interface InvokeFunctionTransactionResponse extends InvokeFunctionTransaction {
         transaction_hash: string;
     }

package/types/provider.d.ts

@@ -13,6 +13,9 @@ export interface GetBlockResponse {
     transactions: Array<string>;
     starknet_version?: string;
 }
+export interface GetCodeResponse {
+    bytecode: string[];
+}
 export declare type GetTransactionResponse = InvokeTransactionResponse & DeclareTransactionResponse;
 export interface CommonTransactionResponse {
     transaction_hash?: string;

package/utils/address.js

@@ -23,7 +23,7 @@ exports.validateAndParseAddress = validateAndParseAddress;
 // from https://github.com/ethers-io/ethers.js/blob/fc1e006575d59792fa97b4efb9ea2f8cca1944cf/packages/address/src.ts/index.ts#L12
 function getChecksumAddress(address) {
     var chars = (0, encode_1.removeHexPrefix)(validateAndParseAddress(address)).toLowerCase().split('');
-    var hashed = (0, bytes_1.arrayify)((0, hash_1.pedersen)([0, address]), { hexPad: 'left' }); // as the hash will be 251 bits (63 chars) we need to pad it to 64 chars without changing the number value ("left")
+    var hashed = (0, bytes_1.arrayify)((0, hash_1.keccakBn)(address), { hexPad: 'left' }); // in case the hash is 251 bits (63 chars) we need to pad it to 64 chars without changing the number value ("left")
     for (var i = 0; i < chars.length; i += 2) {
         if (hashed[i >> 1] >> 4 >= 8) {
             chars[i] = chars[i].toUpperCase();

package/utils/fetchPonyfill.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/utils/fetchPonyfill.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = (typeof window !== 'undefined' && window.fetch) || // use buildin fetch in browser if available
+    (typeof global !== 'undefined' && global.fetch) || // use buildin fetch in node, react-native and service worker if available
+    // eslint-disable-next-line global-require
+    require('isomorphic-fetch'); // ponyfill fetch in node and browsers that don't have it

package/utils/hash.d.ts

@@ -4,6 +4,7 @@ import { RawCalldata } from '../types/lib';
 import { BigNumberish } from './number';
 export declare const transactionVersion = 0;
 export declare const feeTransactionVersion: BN;
+export declare function keccakBn(value: BigNumberish): string;
 /**
  * Function to get the starknet keccak hash from a string
  *

package/utils/hash.js

@@ -28,8 +28,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateContractAddressFromHash = exports.calculcateTransactionHash = exports.calculateDeployTransactionHash = exports.calculateTransactionHashCommon = exports.computeHashOnElements = exports.pedersen = exports.getSelectorFromName = exports.starknetKeccak = exports.feeTransactionVersion = exports.transactionVersion = void 0;
+exports.calculateContractAddressFromHash = exports.calculcateTransactionHash = exports.calculateDeployTransactionHash = exports.calculateTransactionHashCommon = exports.computeHashOnElements = exports.pedersen = exports.getSelectorFromName = exports.starknetKeccak = exports.keccakBn = exports.feeTransactionVersion = exports.transactionVersion = void 0;
 var keccak_1 = require("ethereum-cryptography/keccak");
+var utils_1 = require("ethereum-cryptography/utils");
 var minimalistic_assert_1 = __importDefault(require("minimalistic-assert"));
 var constants_1 = require("../constants");
 var ellipticCurve_1 = require("./ellipticCurve");
@@ -37,6 +38,12 @@ var encode_1 = require("./encode");
 var number_1 = require("./number");
 exports.transactionVersion = 0;
 exports.feeTransactionVersion = (0, number_1.toBN)(2).pow((0, number_1.toBN)(128)).add((0, number_1.toBN)(exports.transactionVersion));
+function keccakBn(value) {
+    var hexWithoutPrefix = (0, encode_1.removeHexPrefix)((0, number_1.toHex)((0, number_1.toBN)(value)));
+    var evenHex = hexWithoutPrefix.length % 2 === 0 ? hexWithoutPrefix : "0".concat(hexWithoutPrefix);
+    return (0, encode_1.addHexPrefix)((0, encode_1.buf2hex)((0, keccak_1.keccak256)((0, utils_1.hexToBytes)(evenHex))));
+}
+exports.keccakBn = keccakBn;
 function keccakHex(value) {
     return (0, encode_1.addHexPrefix)((0, encode_1.buf2hex)((0, keccak_1.keccak256)((0, encode_1.utf8ToArray)(value))));
 }

package/utils/responseParser/rpc.d.ts

@@ -5,6 +5,7 @@ export declare class RPCResponseParser extends ResponseParser {
     parseGetBlockResponse(res: RPC.GetBlockResponse): GetBlockResponse;
     parseGetTransactionResponse(res: RPC.GetTransactionResponse): GetTransactionResponse;
     parseGetTransactionReceiptResponse(res: RPC.GetTransactionReceiptResponse): GetTransactionReceiptResponse;
+    parseGetCodeResponse(res: RPC.GetCodeResponse): RPC.GetCodeResponse;
     parseFeeEstimateResponse(res: RPC.EstimateFeeResponse): EstimateFeeResponse;
     parseCallContractResponse(res: Array<string>): CallContractResponse;
     parseInvokeFunctionResponse(res: RPC.AddTransactionResponse): InvokeFunctionResponse;

package/utils/responseParser/rpc.js

@@ -62,6 +62,9 @@ var RPCResponseParser = /** @class */ (function (_super) {
             events: res.events,
         };
     };
+    RPCResponseParser.prototype.parseGetCodeResponse = function (res) {
+        return res;
+    };
     RPCResponseParser.prototype.parseFeeEstimateResponse = function (res) {
         return {
             overall_fee: (0, number_1.toBN)(res.overall_fee),

package/utils/responseParser/sequencer.d.ts

@@ -5,6 +5,7 @@ export declare class SequencerAPIResponseParser extends ResponseParser {
     parseGetBlockResponse(res: Sequencer.GetBlockResponse): GetBlockResponse;
     parseGetTransactionResponse(res: Sequencer.GetTransactionResponse): GetTransactionResponse;
     parseGetTransactionReceiptResponse(res: Sequencer.TransactionReceiptResponse): GetTransactionReceiptResponse;
+    parseGetCodeResponse(res: Sequencer.GetCodeResponse): Sequencer.GetCodeResponse;
     parseFeeEstimateResponse(res: Sequencer.EstimateFeeResponse): EstimateFeeResponse;
     parseCallContractResponse(res: Sequencer.CallContractResponse): CallContractResponse;
     parseInvokeFunctionResponse(res: Sequencer.AddTransactionResponse): InvokeFunctionResponse;

package/utils/responseParser/sequencer.js

@@ -79,6 +79,9 @@ var SequencerAPIResponseParser = /** @class */ (function (_super) {
             l1_origin_message: undefined,
         };
     };
+    SequencerAPIResponseParser.prototype.parseGetCodeResponse = function (res) {
+        return res;
+    };
     SequencerAPIResponseParser.prototype.parseFeeEstimateResponse = function (res) {
         if ('overall_fee' in res) {
             var gasInfo = {};

package/www/docs/API/contract.md

@@ -22,7 +22,7 @@ contract.**address** => _string_
 
 The address the contract was constructed/connected with
 
-contract.**providerOrAcount** => ProviderInterface | AccountInterface_
+contract.**providerOrAccount** => _ProviderInterface | AccountInterface_
 
 Provider or account that are used to interact with the network
 

package/www/docs/API/provider.md

@@ -175,7 +175,7 @@ Deploys a contract on Starknet
 
 <hr/>
 
-provider.\*\*waitForTransaction(txHash [ , retryInterval]) => _Promise < void >_
+provider.**waitForTransaction**(txHash [ , retryInterval]) => _Promise < void >_
 
 Wait for the transaction to be accepted on L2 or L1.
 

package/www/guides/account.md

@@ -14,7 +14,6 @@ Install the latest version of starknet with `npm install starknet@next`
 
 ```javascript
 import fs from "fs";
-import fs from "fs";
 import {
   Account,
   Contract,
@@ -42,12 +41,31 @@ Deploy the Account contract and wait for it to be verified on StarkNet.
 const compiledAccount = json.parse(
   fs.readFileSync("./Account.json").toString("ascii")
 );
+```
+
+> **Note** 
+> 
+> below example uses [Argent's](https://github.com/argentlabs/argent-contracts-starknet/blob/develop/contracts/ArgentAccount.cairo) account contract 
+
+```javascript
 const accountResponse = await defaultProvider.deployContract({
   contract: compiledAccount,
   addressSalt: starkKeyPub,
 });
 ```
 
+> **Note** 
+> 
+> below example uses [OpenZeppelin's](https://github.com/OpenZeppelin/cairo-contracts/blob/main/src/openzeppelin/account/presets/Account.cairo) account contract 
+
+```javascript
+const accountResponse = await defaultProvider.deployContract({
+    contract: compiledAccount,
+    constructorCalldata: [starkKeyPub],
+    addressSalt: starkKeyPub,
+});
+```
+
 ## Use your new account
 
 Wait for the deployment transaction to be accepted and assign the address of the deployed account to the Account object.
@@ -56,7 +74,11 @@ Wait for the deployment transaction to be accepted and assign the address of the
 await defaultProvider.waitForTransaction(accountResponse.transaction_hash);
 ```
 
-Once account contract is deployed [Account](../docs/API/account.md) instance can be created. Use your new account instance to sign transactions, messages or verify signatures! Make sure your Account has enough funds to execute invocations.
+Once account contract is deployed [Account](../docs/API/account.md) instance can be created. Use your new account instance to sign transactions, messages or verify signatures! 
+
+> **Note**
+> 
+> Make sure your Account has enough funds to execute invocations. Use this [faucet](https://faucet.goerli.starknet.io/) for funding on testnet.
 
 ```js
 const account = new Account(