starknet 2.0.2 → 2.3.0

package/provider/default.d.ts

@@ -12,16 +12,22 @@ import {
 } from '../types';
 import { BigNumberish } from '../utils/number';
 import { ProviderInterface } from './interface';
-declare type NetworkName = 'alpha';
-interface ProviderOptions {
-  network?: NetworkName;
-}
+declare type NetworkName = 'mainnet-alpha' | 'georli-alpha';
+declare type ProviderOptions =
+  | {
+      network: NetworkName;
+    }
+  | {
+      baseUrl: string;
+    };
 export declare class Provider implements ProviderInterface {
   baseUrl: string;
   feederGatewayUrl: string;
   gatewayUrl: string;
   constructor(optionsOrProvider?: ProviderOptions | Provider);
-  protected static getNetworkFromName(name: NetworkName): string;
+  protected static getNetworkFromName(
+    name: NetworkName
+  ): 'https://alpha-mainnet.starknet.io' | 'https://alpha4.starknet.io';
   /**
    * Gets the smart contract address on the goerli testnet.
    *

package/provider/default.js

@@ -152,6 +152,7 @@ var __importDefault =
 Object.defineProperty(exports, '__esModule', { value: true });
 exports.Provider = void 0;
 var axios_1 = __importDefault(require('axios'));
+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');
@@ -162,22 +163,28 @@ function wait(delay) {
 }
 var Provider = /** @class */ (function () {
   function Provider(optionsOrProvider) {
+    if (optionsOrProvider === void 0) {
+      optionsOrProvider = { network: 'georli-alpha' };
+    }
     if (optionsOrProvider instanceof Provider) {
       this.baseUrl = optionsOrProvider.baseUrl;
       this.feederGatewayUrl = optionsOrProvider.feederGatewayUrl;
       this.gatewayUrl = optionsOrProvider.gatewayUrl;
     } else {
-      var _a = (optionsOrProvider || {}).network,
-        network = _a === void 0 ? 'alpha' : _a;
-      var baseUrl = Provider.getNetworkFromName(network);
+      var baseUrl =
+        'baseUrl' in optionsOrProvider
+          ? optionsOrProvider.baseUrl
+          : Provider.getNetworkFromName(optionsOrProvider.network);
       this.baseUrl = baseUrl;
-      this.feederGatewayUrl = baseUrl + '/feeder_gateway';
-      this.gatewayUrl = baseUrl + '/gateway';
+      this.feederGatewayUrl = (0, url_join_1.default)(baseUrl, 'feeder_gateway');
+      this.gatewayUrl = (0, url_join_1.default)(baseUrl, 'gateway');
     }
   }
   Provider.getNetworkFromName = function (name) {
     switch (name) {
-      case 'alpha':
+      case 'mainnet-alpha':
+        return 'https://alpha-mainnet.starknet.io';
+      case 'georli-alpha':
       default:
         return 'https://alpha4.starknet.io';
     }
@@ -196,7 +203,9 @@ var Provider = /** @class */ (function () {
           case 0:
             return [
               4 /*yield*/,
-              axios_1.default.get(this.feederGatewayUrl + '/get_contract_addresses'),
+              axios_1.default.get(
+                (0, url_join_1.default)(this.feederGatewayUrl, 'get_contract_addresses')
+              ),
             ];
           case 1:
             data = _a.sent().data;
@@ -223,9 +232,11 @@ var Provider = /** @class */ (function () {
             return [
               4 /*yield*/,
               axios_1.default.post(
-                this.feederGatewayUrl +
-                  '/call_contract?blockId=' +
-                  (blockId !== null && blockId !== void 0 ? blockId : 'null'),
+                (0, url_join_1.default)(
+                  this.feederGatewayUrl,
+                  'call_contract',
+                  '?blockId=' + (blockId !== null && blockId !== void 0 ? blockId : 'null')
+                ),
                 __assign({ signature: [], calldata: [] }, invokeTx)
               ),
             ];
@@ -253,9 +264,11 @@ var Provider = /** @class */ (function () {
             return [
               4 /*yield*/,
               axios_1.default.get(
-                this.feederGatewayUrl +
-                  '/get_block?blockId=' +
-                  (blockId !== null && blockId !== void 0 ? blockId : 'null')
+                (0, url_join_1.default)(
+                  this.feederGatewayUrl,
+                  'get_block',
+                  '?blockId=' + (blockId !== null && blockId !== void 0 ? blockId : 'null')
+                )
               ),
             ];
           case 1:
@@ -283,11 +296,14 @@ var Provider = /** @class */ (function () {
             return [
               4 /*yield*/,
               axios_1.default.get(
-                this.feederGatewayUrl +
-                  '/get_code?contractAddress=' +
-                  contractAddress +
-                  '&blockId=' +
-                  (blockId !== null && blockId !== void 0 ? blockId : 'null')
+                (0, url_join_1.default)(
+                  this.feederGatewayUrl,
+                  'get_code',
+                  '?contractAddress=' +
+                    contractAddress +
+                    '&blockId=' +
+                    (blockId !== null && blockId !== void 0 ? blockId : 'null')
+                )
               ),
             ];
           case 1:
@@ -317,13 +333,16 @@ var Provider = /** @class */ (function () {
             return [
               4 /*yield*/,
               axios_1.default.get(
-                this.feederGatewayUrl +
-                  '/get_storage_at?contractAddress=' +
-                  contractAddress +
-                  '&key=' +
-                  key +
-                  '&blockId=' +
-                  (blockId !== null && blockId !== void 0 ? blockId : 'null')
+                (0, url_join_1.default)(
+                  this.feederGatewayUrl,
+                  'get_storage_at',
+                  '?contractAddress=' +
+                    contractAddress +
+                    '&key=' +
+                    key +
+                    '&blockId=' +
+                    (blockId !== null && blockId !== void 0 ? blockId : 'null')
+                )
               ),
             ];
           case 1:
@@ -351,9 +370,11 @@ var Provider = /** @class */ (function () {
             return [
               4 /*yield*/,
               axios_1.default.get(
-                this.feederGatewayUrl +
-                  '/get_transaction_status?transactionHash=' +
-                  (0, number_1.toHex)(txHashBn)
+                (0, url_join_1.default)(
+                  this.feederGatewayUrl,
+                  'get_transaction_status',
+                  '?transactionHash=' + (0, number_1.toHex)(txHashBn)
+                )
               ),
             ];
           case 1:
@@ -381,9 +402,11 @@ var Provider = /** @class */ (function () {
             return [
               4 /*yield*/,
               axios_1.default.get(
-                this.feederGatewayUrl +
-                  '/get_transaction?transactionHash=' +
-                  (0, number_1.toHex)(txHashBn)
+                (0, url_join_1.default)(
+                  this.feederGatewayUrl,
+                  'get_transaction',
+                  '?transactionHash=' + (0, number_1.toHex)(txHashBn)
+                )
               ),
             ];
           case 1:
@@ -414,7 +437,7 @@ var Provider = /** @class */ (function () {
             return [
               4 /*yield*/,
               axios_1.default.post(
-                this.gatewayUrl + '/add_transaction',
+                (0, url_join_1.default)(this.gatewayUrl, 'add_transaction'),
                 (0, json_1.stringify)(
                   __assign(
                     __assign(
@@ -484,15 +507,14 @@ var Provider = /** @class */ (function () {
   };
   Provider.prototype.waitForTx = function (txHash, retryInterval) {
     if (retryInterval === void 0) {
-      retryInterval = 5000;
+      retryInterval = 8000;
     }
     return __awaiter(this, void 0, void 0, function () {
-      var onchain, firstRun, res;
+      var onchain, res;
       return __generator(this, function (_a) {
         switch (_a.label) {
           case 0:
             onchain = false;
-            firstRun = true;
             _a.label = 1;
           case 1:
             if (!!onchain) return [3 /*break*/, 4];
@@ -504,14 +526,16 @@ var Provider = /** @class */ (function () {
             return [4 /*yield*/, this.getTransactionStatus(txHash)];
           case 3:
             res = _a.sent();
-            if (res.tx_status === 'ACCEPTED_ONCHAIN' || res.tx_status === 'PENDING') {
+            if (
+              res.tx_status === 'ACCEPTED_ONCHAIN' ||
+              (res.tx_status === 'PENDING' && res.block_hash !== 'pending') // This is needed as of today. In the future there will be a different status for pending transactions.
+            ) {
               onchain = true;
             } else if (res.tx_status === 'REJECTED') {
               throw Error('REJECTED');
-            } else if (res.tx_status === 'NOT_RECEIVED' && !firstRun) {
+            } else if (res.tx_status === 'NOT_RECEIVED') {
               throw Error('NOT_RECEIVED');
             }
-            firstRun = false;
             return [3 /*break*/, 1];
           case 4:
             return [2 /*return*/];

package/src/constants.ts

@@ -1,13 +1,11 @@
-import BN from 'bn.js';
-
 import { toBN } from './utils/number';
 
 export { IS_BROWSER } from './utils/encode';
 
-export const ZERO: BN = toBN(0);
-export const ONE: BN = toBN(1);
-export const TWO: BN = toBN(2);
-export const MASK_250: BN = TWO.pow(toBN(250)).sub(ONE); // 2 ** 250 - 1
+export const ZERO = toBN(0);
+export const ONE = toBN(1);
+export const TWO = toBN(2);
+export const MASK_250 = TWO.pow(toBN(250)).sub(ONE); // 2 ** 250 - 1
 
 /**
  * The following is taken from https://github.com/starkware-libs/starkex-resources/blob/master/crypto/starkware/crypto/signature/pedersen_params.json but converted to hex, because JS is very bad handling big integers by default

package/src/index.ts

@@ -16,3 +16,5 @@ export * as json from './utils/json';
 export * as number from './utils/number';
 export * as stark from './utils/stark';
 export * as ec from './utils/ellipticCurve';
+export * as uint256 from './utils/uint256';
+export * as shortString from './utils/shortString';

package/src/provider/default.ts

@@ -1,4 +1,5 @@
 import axios from 'axios';
+import urljoin from 'url-join';
 
 import {
   AddTransactionResponse,
@@ -17,11 +18,15 @@ import { BigNumberish, toBN, toHex } from '../utils/number';
 import { compressProgram, formatSignature, randomAddress } from '../utils/stark';
 import { ProviderInterface } from './interface';
 
-type NetworkName = 'alpha';
+type NetworkName = 'mainnet-alpha' | 'georli-alpha';
 
-interface ProviderOptions {
-  network?: NetworkName;
-}
+type ProviderOptions =
+  | {
+      network: NetworkName;
+    }
+  | {
+      baseUrl: string;
+    };
 
 function wait(delay: number) {
   return new Promise((res) => setTimeout(res, delay));
@@ -34,23 +39,27 @@ export class Provider implements ProviderInterface {
 
   public gatewayUrl: string;
 
-  constructor(optionsOrProvider?: ProviderOptions | Provider) {
+  constructor(optionsOrProvider: ProviderOptions | Provider = { network: 'georli-alpha' }) {
     if (optionsOrProvider instanceof Provider) {
       this.baseUrl = optionsOrProvider.baseUrl;
       this.feederGatewayUrl = optionsOrProvider.feederGatewayUrl;
       this.gatewayUrl = optionsOrProvider.gatewayUrl;
     } else {
-      const { network = 'alpha' } = optionsOrProvider || {};
-      const baseUrl = Provider.getNetworkFromName(network);
+      const baseUrl =
+        'baseUrl' in optionsOrProvider
+          ? optionsOrProvider.baseUrl
+          : Provider.getNetworkFromName(optionsOrProvider.network);
       this.baseUrl = baseUrl;
-      this.feederGatewayUrl = `${baseUrl}/feeder_gateway`;
-      this.gatewayUrl = `${baseUrl}/gateway`;
+      this.feederGatewayUrl = urljoin(baseUrl, 'feeder_gateway');
+      this.gatewayUrl = urljoin(baseUrl, 'gateway');
     }
   }
 
   protected static getNetworkFromName(name: NetworkName) {
     switch (name) {
-      case 'alpha':
+      case 'mainnet-alpha':
+        return 'https://alpha-mainnet.starknet.io';
+      case 'georli-alpha':
       default:
         return 'https://alpha4.starknet.io';
     }
@@ -64,7 +73,7 @@ export class Provider implements ProviderInterface {
    */
   public async getContractAddresses(): Promise<GetContractAddressesResponse> {
     const { data } = await axios.get<GetContractAddressesResponse>(
-      `${this.feederGatewayUrl}/get_contract_addresses`
+      urljoin(this.feederGatewayUrl, 'get_contract_addresses')
     );
     return data;
   }
@@ -83,7 +92,7 @@ export class Provider implements ProviderInterface {
     blockId?: number
   ): Promise<CallContractResponse> {
     const { data } = await axios.post<CallContractResponse>(
-      `${this.feederGatewayUrl}/call_contract?blockId=${blockId ?? 'null'}`,
+      urljoin(this.feederGatewayUrl, 'call_contract', `?blockId=${blockId ?? 'null'}`),
       {
         signature: [],
         calldata: [],
@@ -103,7 +112,7 @@ export class Provider implements ProviderInterface {
    */
   public async getBlock(blockId?: number): Promise<GetBlockResponse> {
     const { data } = await axios.get<GetBlockResponse>(
-      `${this.feederGatewayUrl}/get_block?blockId=${blockId ?? 'null'}`
+      urljoin(this.feederGatewayUrl, 'get_block', `?blockId=${blockId ?? 'null'}`)
     );
     return data;
   }
@@ -119,9 +128,11 @@ export class Provider implements ProviderInterface {
    */
   public async getCode(contractAddress: string, blockId?: number): Promise<GetCodeResponse> {
     const { data } = await axios.get<GetCodeResponse>(
-      `${this.feederGatewayUrl}/get_code?contractAddress=${contractAddress}&blockId=${
-        blockId ?? 'null'
-      }`
+      urljoin(
+        this.feederGatewayUrl,
+        'get_code',
+        `?contractAddress=${contractAddress}&blockId=${blockId ?? 'null'}`
+      )
     );
     return data;
   }
@@ -143,9 +154,11 @@ export class Provider implements ProviderInterface {
     blockId?: number
   ): Promise<object> {
     const { data } = await axios.get<object>(
-      `${
-        this.feederGatewayUrl
-      }/get_storage_at?contractAddress=${contractAddress}&key=${key}&blockId=${blockId ?? 'null'}`
+      urljoin(
+        this.feederGatewayUrl,
+        'get_storage_at',
+        `?contractAddress=${contractAddress}&key=${key}&blockId=${blockId ?? 'null'}`
+      )
     );
     return data;
   }
@@ -161,7 +174,11 @@ export class Provider implements ProviderInterface {
   public async getTransactionStatus(txHash: BigNumberish): Promise<GetTransactionStatusResponse> {
     const txHashBn = toBN(txHash);
     const { data } = await axios.get<GetTransactionStatusResponse>(
-      `${this.feederGatewayUrl}/get_transaction_status?transactionHash=${toHex(txHashBn)}`
+      urljoin(
+        this.feederGatewayUrl,
+        'get_transaction_status',
+        `?transactionHash=${toHex(txHashBn)}`
+      )
     );
     return data;
   }
@@ -177,7 +194,7 @@ export class Provider implements ProviderInterface {
   public async getTransaction(txHash: BigNumberish): Promise<GetTransactionResponse> {
     const txHashBn = toBN(txHash);
     const { data } = await axios.get<GetTransactionResponse>(
-      `${this.feederGatewayUrl}/get_transaction?transactionHash=${toHex(txHashBn)}`
+      urljoin(this.feederGatewayUrl, 'get_transaction', `?transactionHash=${toHex(txHashBn)}`)
     );
     return data;
   }
@@ -195,7 +212,7 @@ export class Provider implements ProviderInterface {
     const contract_address_salt = tx.type === 'DEPLOY' && toHex(toBN(tx.contract_address_salt));
 
     const { data } = await axios.post<AddTransactionResponse>(
-      `${this.gatewayUrl}/add_transaction`,
+      urljoin(this.gatewayUrl, 'add_transaction'),
       stringify({
         ...tx, // the tx can contain BigInts, so we use our own `stringify`
         ...(Array.isArray(signature) && { signature }), // not needed on deploy tx
@@ -257,23 +274,24 @@ export class Provider implements ProviderInterface {
     });
   }
 
-  public async waitForTx(txHash: BigNumberish, retryInterval: number = 5000) {
+  public async waitForTx(txHash: BigNumberish, retryInterval: number = 8000) {
     let onchain = false;
-    let firstRun = true;
     while (!onchain) {
       // eslint-disable-next-line no-await-in-loop
       await wait(retryInterval);
       // eslint-disable-next-line no-await-in-loop
       const res = await this.getTransactionStatus(txHash);
 
-      if (res.tx_status === 'ACCEPTED_ONCHAIN' || res.tx_status === 'PENDING') {
+      if (
+        res.tx_status === 'ACCEPTED_ONCHAIN' ||
+        (res.tx_status === 'PENDING' && res.block_hash !== 'pending') // This is needed as of today. In the future there will be a different status for pending transactions.
+      ) {
         onchain = true;
       } else if (res.tx_status === 'REJECTED') {
         throw Error('REJECTED');
-      } else if (res.tx_status === 'NOT_RECEIVED' && !firstRun) {
+      } else if (res.tx_status === 'NOT_RECEIVED') {
         throw Error('NOT_RECEIVED');
       }
-      firstRun = false;
     }
   }
 }

package/src/types.ts

@@ -73,14 +73,14 @@ export type CallContractResponse = {
 export type GetBlockResponse = {
   sequence_number: number;
   state_root: string;
-  block_id: number;
+  block_hash: string;
   transactions: {
     [txHash: string]: Transaction;
   };
   timestamp: number;
   transaction_receipts: {
     [txHash: string]: {
-      block_id: number;
+      block_hash: string;
       transaction_hash: string;
       l2_to_l1_messages: {
         to_address: string;
@@ -92,7 +92,7 @@ export type GetBlockResponse = {
       transaction_index: number;
     };
   };
-  previous_block_id: number;
+  previous_block_hash: string;
   status: Status;
 };
 
@@ -103,13 +103,13 @@ export type GetCodeResponse = {
 
 export type GetTransactionStatusResponse = {
   tx_status: Status;
-  block_id: number;
+  block_hash: string;
 };
 
 export type GetTransactionResponse = {
   status: Status;
   transaction: Transaction;
-  block_id: number;
+  block_hash: string;
   block_number: number;
   transaction_index: number;
   transaction_hash: string;

package/src/utils/shortString.ts

@@ -0,0 +1,21 @@
+import { addHexPrefix, removeHexPrefix } from './encode';
+
+export function isASCII(str: string) {
+  // eslint-disable-next-line no-control-regex
+  return /^[\x00-\x7F]*$/.test(str);
+}
+
+// function to check if string has less or equal 31 characters
+export function isShortString(str: string) {
+  return str.length <= 31;
+}
+
+export function encodeShortString(str: string) {
+  if (!isASCII(str)) throw new Error(`${str} is not an ASCII string`);
+  if (!isShortString(str)) throw new Error(`${str} is too long`);
+  return addHexPrefix(str.replace(/./g, (char) => char.charCodeAt(0).toString(16)));
+}
+
+export function decodeShortString(str: string) {
+  return removeHexPrefix(str).replace(/.{2}/g, (hex) => String.fromCharCode(parseInt(hex, 16)));
+}

package/src/utils/stark.ts

@@ -49,3 +49,7 @@ export function formatSignature(sig?: [BigNumberish, BigNumberish]): [string, st
     return [];
   }
 }
+
+export function compileStructToCalldata<S extends { [k: string]: string }>(struct: S): string[] {
+  return Object.values(struct);
+}

package/src/utils/uint256.ts

@@ -0,0 +1,32 @@
+import { addHexPrefix } from './encode';
+import { BigNumberish, toBN } from './number';
+
+// Represents an integer in the range [0, 2^256).
+export interface Uint256 {
+  // The low 128 bits of the value.
+  low: BigNumberish;
+  // The high 128 bits of the value.
+  high: BigNumberish;
+}
+
+// function to convert Uint256 to BN
+export function uint256ToBN(uint256: Uint256) {
+  return toBN(uint256.high).shln(128).add(toBN(uint256.low));
+}
+
+export const UINT_128_MAX = toBN(1).shln(128).sub(toBN(1));
+export const UINT_256_MAX = toBN(1).shln(256).sub(toBN(1));
+// function to check if BN is smaller or equal 2**256-1
+export function isUint256(bn: BigNumberish): boolean {
+  return toBN(bn).lte(UINT_256_MAX);
+}
+
+// function to convert BN to Uint256
+export function bnToUint256(bignumber: BigNumberish): Uint256 {
+  const bn = toBN(bignumber);
+  if (!isUint256(bn)) throw new Error('Number is too large');
+  return {
+    low: addHexPrefix(bn.maskn(128).toString(16)),
+    high: addHexPrefix(bn.shrn(128).toString(16)),
+  };
+}

package/types.d.ts

@@ -67,14 +67,14 @@ export declare type CallContractResponse = {
 export declare type GetBlockResponse = {
   sequence_number: number;
   state_root: string;
-  block_id: number;
+  block_hash: string;
   transactions: {
     [txHash: string]: Transaction;
   };
   timestamp: number;
   transaction_receipts: {
     [txHash: string]: {
-      block_id: number;
+      block_hash: string;
       transaction_hash: string;
       l2_to_l1_messages: {
         to_address: string;
@@ -86,7 +86,7 @@ export declare type GetBlockResponse = {
       transaction_index: number;
     };
   };
-  previous_block_id: number;
+  previous_block_hash: string;
   status: Status;
 };
 export declare type GetCodeResponse = {
@@ -95,12 +95,12 @@ export declare type GetCodeResponse = {
 };
 export declare type GetTransactionStatusResponse = {
   tx_status: Status;
-  block_id: number;
+  block_hash: string;
 };
 export declare type GetTransactionResponse = {
   status: Status;
   transaction: Transaction;
-  block_id: number;
+  block_hash: string;
   block_number: number;
   transaction_index: number;
   transaction_hash: string;

package/utils/shortString.d.ts

@@ -0,0 +1,4 @@
+export declare function isASCII(str: string): boolean;
+export declare function isShortString(str: string): boolean;
+export declare function encodeShortString(str: string): string;
+export declare function decodeShortString(str: string): string;

package/utils/shortString.js

@@ -0,0 +1,34 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.decodeShortString =
+  exports.encodeShortString =
+  exports.isShortString =
+  exports.isASCII =
+    void 0;
+var encode_1 = require('./encode');
+function isASCII(str) {
+  // eslint-disable-next-line no-control-regex
+  return /^[\x00-\x7F]*$/.test(str);
+}
+exports.isASCII = isASCII;
+// function to check if string has less or equal 31 characters
+function isShortString(str) {
+  return str.length <= 31;
+}
+exports.isShortString = isShortString;
+function encodeShortString(str) {
+  if (!isASCII(str)) throw new Error(str + ' is not an ASCII string');
+  if (!isShortString(str)) throw new Error(str + ' is too long');
+  return (0, encode_1.addHexPrefix)(
+    str.replace(/./g, function (char) {
+      return char.charCodeAt(0).toString(16);
+    })
+  );
+}
+exports.encodeShortString = encodeShortString;
+function decodeShortString(str) {
+  return (0, encode_1.removeHexPrefix)(str).replace(/.{2}/g, function (hex) {
+    return String.fromCharCode(parseInt(hex, 16));
+  });
+}
+exports.decodeShortString = decodeShortString;

package/utils/stark.d.ts

@@ -19,3 +19,8 @@ export declare function getSelectorFromName(funcName: string): string;
 export declare function randomAddress(): string;
 export declare function makeAddress(input: string): string;
 export declare function formatSignature(sig?: [BigNumberish, BigNumberish]): [string, string] | [];
+export declare function compileStructToCalldata<
+  S extends {
+    [k: string]: string;
+  }
+>(struct: S): string[];

package/utils/stark.js

@@ -1,6 +1,7 @@
 'use strict';
 Object.defineProperty(exports, '__esModule', { value: true });
-exports.formatSignature =
+exports.compileStructToCalldata =
+  exports.formatSignature =
   exports.makeAddress =
   exports.randomAddress =
   exports.getSelectorFromName =
@@ -62,3 +63,7 @@ function formatSignature(sig) {
   }
 }
 exports.formatSignature = formatSignature;
+function compileStructToCalldata(struct) {
+  return Object.values(struct);
+}
+exports.compileStructToCalldata = compileStructToCalldata;

package/utils/uint256.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="bn.js" />
+import { BigNumberish } from './number';
+export interface Uint256 {
+  low: BigNumberish;
+  high: BigNumberish;
+}
+export declare function uint256ToBN(uint256: Uint256): import('bn.js');
+export declare const UINT_128_MAX: import('bn.js');
+export declare const UINT_256_MAX: import('bn.js');
+export declare function isUint256(bn: BigNumberish): boolean;
+export declare function bnToUint256(bignumber: BigNumberish): Uint256;