starknet 4.0.1 → 4.3.0

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+# [4.3.0](https://github.com/0xs34n/starknet.js/compare/v4.2.0...v4.3.0) (2022-08-09)
+
+### Bug Fixes
+
+- intendations in provider.md ([4a310c6](https://github.com/0xs34n/starknet.js/commit/4a310c6c992c77f9f6729a70c1af14481cd891f7))
+- **sequenceProvider:** feedergatewayUrl and gatewayUrl ([e236d23](https://github.com/0xs34n/starknet.js/commit/e236d2352e3fbb0f78965decac5893217347ceb7))
+
+### Features
+
+- update docs ([28786ed](https://github.com/0xs34n/starknet.js/commit/28786ed550909f6a30b8cb145e93d072ed28a862))
+
+# [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

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__/sequencerProvider.test.ts

@@ -1,4 +1,5 @@
-import { SequencerProvider } from '../src';
+import { Contract, Provider, SequencerProvider, stark } from '../src';
+import { toBN } from '../src/utils/number';
 import {
   compiledErc20,
   describeIfNotDevnet,
@@ -8,9 +9,17 @@ import {
 
 describeIfSequencer('SequencerProvider', () => {
   let provider: SequencerProvider;
+  let customSequencerProvider: Provider;
 
   beforeAll(async () => {
     provider = getTestProvider() as SequencerProvider;
+    customSequencerProvider = new Provider({
+      sequencer: {
+        baseUrl: 'https://alpha4.starknet.io',
+        feederGatewayUrl: 'feeder_gateway',
+        gatewayUrl: 'gateway',
+      }, // Similar to arguements used in docs
+    });
   });
 
   describe('Gateway specific methods', () => {
@@ -42,4 +51,25 @@ describeIfSequencer('SequencerProvider', () => {
       });
     });
   });
+
+  describe('Test calls with Custom Sequencer Provider', () => {
+    let erc20: Contract;
+    const wallet = stark.randomAddress();
+
+    beforeAll(async () => {
+      const { contract_address, transaction_hash } = await customSequencerProvider.deployContract({
+        contract: compiledErc20,
+      });
+
+      await customSequencerProvider.waitForTransaction(transaction_hash);
+      erc20 = new Contract(compiledErc20.abi, contract_address, customSequencerProvider);
+    });
+
+    test('Check ERC20 balance using Custom Sequencer Provider', async () => {
+      const result = await erc20.balance_of(wallet);
+      const [res] = result;
+      expect(res).toStrictEqual(toBN(0));
+      expect(res).toStrictEqual(result.res);
+    });
+  });
 });

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/index.d.ts

@@ -21,3 +21,4 @@ export * as uint256 from './utils/uint256';
 export * as shortString from './utils/shortString';
 export * as typedData from './utils/typedData';
 export * from './utils/address';
+export * from './utils/url';

package/dist/index.js

@@ -50,3 +50,4 @@ exports.uint256 = __importStar(require("./utils/uint256"));
 exports.shortString = __importStar(require("./utils/shortString"));
 exports.typedData = __importStar(require("./utils/typedData"));
 __exportStar(require("./utils/address"), exports);
+__exportStar(require("./utils/url"), exports);

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

@@ -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

@@ -65,6 +65,7 @@ var number_1 = require("../utils/number");
 var provider_1 = require("../utils/provider");
 var sequencer_1 = require("../utils/responseParser/sequencer");
 var stark_1 = require("../utils/stark");
+var url_1 = require("../utils/url");
 var errors_1 = require("./errors");
 var utils_1 = require("./utils");
 function isEmptyQueryObject(obj) {
@@ -79,7 +80,7 @@ function isEmptyQueryObject(obj) {
 var SequencerProvider = /** @class */ (function () {
     function SequencerProvider(optionsOrProvider) {
         if (optionsOrProvider === void 0) { optionsOrProvider = { network: 'goerli-alpha' }; }
-        var _a, _b, _c;
+        var _a;
         this.responseParser = new sequencer_1.SequencerAPIResponseParser();
         if ('network' in optionsOrProvider) {
             this.baseUrl = SequencerProvider.getNetworkFromName(optionsOrProvider.network);
@@ -89,11 +90,10 @@ var SequencerProvider = /** @class */ (function () {
         }
         else {
             this.baseUrl = optionsOrProvider.baseUrl;
-            this.feederGatewayUrl =
-                (_a = optionsOrProvider.feederGatewayUrl) !== null && _a !== void 0 ? _a : (0, url_join_1.default)(this.baseUrl, 'feeder_gateway');
-            this.gatewayUrl = (_b = optionsOrProvider.gatewayUrl) !== null && _b !== void 0 ? _b : (0, url_join_1.default)(this.baseUrl, 'gateway');
+            this.feederGatewayUrl = (0, url_1.buildUrl)(this.baseUrl, 'feeder_gateway', optionsOrProvider.feederGatewayUrl);
+            this.gatewayUrl = (0, url_1.buildUrl)(this.baseUrl, 'gateway', optionsOrProvider.gatewayUrl);
             this.chainId =
-                (_c = optionsOrProvider.chainId) !== null && _c !== void 0 ? _c : SequencerProvider.getChainIdFromBaseUrl(optionsOrProvider.baseUrl);
+                (_a = optionsOrProvider.chainId) !== null && _a !== void 0 ? _a : SequencerProvider.getChainIdFromBaseUrl(optionsOrProvider.baseUrl);
         }
     }
     SequencerProvider.getNetworkFromName = function (name) {
@@ -355,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/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/dist/utils/url.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Loosely validate a URL `string`.
+ * @param {String} s
+ * @return {Boolean}
+ */
+export declare function isUrl(s?: string): boolean;
+export declare function buildUrl(baseUrl: string, defaultPath: string, urlOrPath?: string): string;

package/dist/utils/url.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildUrl = exports.isUrl = void 0;
+var url_join_1 = __importDefault(require("url-join"));
+/**
+ * Inspired from https://github.com/segmentio/is-url
+ */
+/**
+ * RegExps.
+ * A URL must match #1 and then at least one of #2/#3.
+ * Use two levels of REs to avoid REDOS.
+ */
+var protocolAndDomainRE = /^(?:\w+:)?\/\/(\S+)$/;
+var localhostDomainRE = /^localhost[:?\d]*(?:[^:?\d]\S*)?$/;
+var nonLocalhostDomainRE = /^[^\s.]+\.\S{2,}$/;
+/**
+ * Loosely validate a URL `string`.
+ * @param {String} s
+ * @return {Boolean}
+ */
+function isUrl(s) {
+    if (!s) {
+        return false;
+    }
+    if (typeof s !== 'string') {
+        return false;
+    }
+    var match = s.match(protocolAndDomainRE);
+    if (!match) {
+        return false;
+    }
+    var everythingAfterProtocol = match[1];
+    if (!everythingAfterProtocol) {
+        return false;
+    }
+    if (localhostDomainRE.test(everythingAfterProtocol) ||
+        nonLocalhostDomainRE.test(everythingAfterProtocol)) {
+        return true;
+    }
+    return false;
+}
+exports.isUrl = isUrl;
+function buildUrl(baseUrl, defaultPath, urlOrPath) {
+    return isUrl(urlOrPath) ? urlOrPath : (0, url_join_1.default)(baseUrl, urlOrPath !== null && urlOrPath !== void 0 ? urlOrPath : defaultPath);
+}
+exports.buildUrl = buildUrl;

package/index.d.ts

@@ -21,3 +21,4 @@ export * as uint256 from './utils/uint256';
 export * as shortString from './utils/shortString';
 export * as typedData from './utils/typedData';
 export * from './utils/address';
+export * from './utils/url';

package/index.js

@@ -50,3 +50,4 @@ exports.uint256 = __importStar(require("./utils/uint256"));
 exports.shortString = __importStar(require("./utils/shortString"));
 exports.typedData = __importStar(require("./utils/typedData"));
 __exportStar(require("./utils/address"), exports);
+__exportStar(require("./utils/url"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starknet",
-  "version": "4.0.1",
+  "version": "4.3.0",
   "description": "JavaScript library for StarkNet",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -43,7 +43,6 @@
     "@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",
     "eslint": "^8.17.0",
@@ -61,8 +60,7 @@
     "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",

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

@@ -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

@@ -65,6 +65,7 @@ var number_1 = require("../utils/number");
 var provider_1 = require("../utils/provider");
 var sequencer_1 = require("../utils/responseParser/sequencer");
 var stark_1 = require("../utils/stark");
+var url_1 = require("../utils/url");
 var errors_1 = require("./errors");
 var utils_1 = require("./utils");
 function isEmptyQueryObject(obj) {
@@ -79,7 +80,7 @@ function isEmptyQueryObject(obj) {
 var SequencerProvider = /** @class */ (function () {
     function SequencerProvider(optionsOrProvider) {
         if (optionsOrProvider === void 0) { optionsOrProvider = { network: 'goerli-alpha' }; }
-        var _a, _b, _c;
+        var _a;
         this.responseParser = new sequencer_1.SequencerAPIResponseParser();
         if ('network' in optionsOrProvider) {
             this.baseUrl = SequencerProvider.getNetworkFromName(optionsOrProvider.network);
@@ -89,11 +90,10 @@ var SequencerProvider = /** @class */ (function () {
         }
         else {
             this.baseUrl = optionsOrProvider.baseUrl;
-            this.feederGatewayUrl =
-                (_a = optionsOrProvider.feederGatewayUrl) !== null && _a !== void 0 ? _a : (0, url_join_1.default)(this.baseUrl, 'feeder_gateway');
-            this.gatewayUrl = (_b = optionsOrProvider.gatewayUrl) !== null && _b !== void 0 ? _b : (0, url_join_1.default)(this.baseUrl, 'gateway');
+            this.feederGatewayUrl = (0, url_1.buildUrl)(this.baseUrl, 'feeder_gateway', optionsOrProvider.feederGatewayUrl);
+            this.gatewayUrl = (0, url_1.buildUrl)(this.baseUrl, 'gateway', optionsOrProvider.gatewayUrl);
             this.chainId =
-                (_c = optionsOrProvider.chainId) !== null && _c !== void 0 ? _c : SequencerProvider.getChainIdFromBaseUrl(optionsOrProvider.baseUrl);
+                (_a = optionsOrProvider.chainId) !== null && _a !== void 0 ? _a : SequencerProvider.getChainIdFromBaseUrl(optionsOrProvider.baseUrl);
         }
     }
     SequencerProvider.getNetworkFromName = function (name) {
@@ -355,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/index.ts

@@ -22,3 +22,4 @@ export * as uint256 from './utils/uint256';
 export * as shortString from './utils/shortString';
 export * as typedData from './utils/typedData';
 export * from './utils/address';
+export * from './utils/url';

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);
   }