starknet 6.4.2 → 6.6.0

package/dist/index.js

@@ -67,13 +67,19 @@ __export(src_exports, {
   TypedDataRevision: () => TypedDataRevision,
   Uint: () => Uint,
   ValidateType: () => ValidateType,
+  WalletAccount: () => WalletAccount,
   addAddressPadding: () => addAddressPadding,
+  addDeclareTransaction: () => addDeclareTransaction,
+  addDeployAccountTransaction: () => addDeployAccountTransaction,
+  addInvokeTransaction: () => addInvokeTransaction,
+  addStarknetChain: () => addStarknetChain,
   buildUrl: () => buildUrl,
   byteArray: () => byteArray_exports,
   cairo: () => cairo_exports,
   constants: () => constants_exports,
   contractClassResponseToLegacyCompiledContract: () => contractClassResponseToLegacyCompiledContract,
   defaultProvider: () => defaultProvider,
+  deploymentData: () => deploymentData,
   ec: () => ec_exports,
   encode: () => encode_exports,
   eth: () => eth_exports,
@@ -83,6 +89,7 @@ __export(src_exports, {
   fixStack: () => fixStack,
   getCalldata: () => getCalldata,
   getChecksumAddress: () => getChecksumAddress,
+  getPermissions: () => getPermissions,
   hash: () => hash_exports,
   isSierra: () => isSierra,
   isUrl: () => isUrl,
@@ -90,13 +97,20 @@ __export(src_exports, {
   merkle: () => merkle_exports,
   num: () => num_exports,
   number: () => number,
+  onAccountChange: () => onAccountChange,
+  onNetworkChanged: () => onNetworkChanged,
   parseUDCEvent: () => parseUDCEvent,
   provider: () => provider_exports,
+  requestAccounts: () => requestAccounts,
+  requestChainId: () => requestChainId,
   selector: () => selector_exports,
   shortString: () => shortString_exports,
+  signMessage: () => signMessage,
   splitArgsAndOptions: () => splitArgsAndOptions,
   stark: () => stark_exports,
   starknetId: () => starknetId_exports,
+  supportedSpecs: () => supportedSpecs,
+  switchStarknetChain: () => switchStarknetChain,
   transaction: () => transaction_exports,
   typedData: () => typedData_exports,
   types: () => types_exports,
@@ -104,7 +118,8 @@ __export(src_exports, {
   v2hash: () => v2_exports,
   v3hash: () => v3_exports,
   validateAndParseAddress: () => validateAndParseAddress,
-  validateChecksumAddress: () => validateChecksumAddress
+  validateChecksumAddress: () => validateChecksumAddress,
+  watchAsset: () => watchAsset
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -125,7 +140,8 @@ __export(constants_exports, {
   TRANSACTION_VERSION: () => ETransactionVersion4,
   TransactionHashPrefix: () => TransactionHashPrefix,
   UDC: () => UDC,
-  ZERO: () => ZERO
+  ZERO: () => ZERO,
+  feeMarginPercentage: () => feeMarginPercentage
 });
 
 // src/types/api/index.ts
@@ -452,11 +468,17 @@ var TransactionHashPrefix = /* @__PURE__ */ ((TransactionHashPrefix2) => {
   TransactionHashPrefix2["L1_HANDLER"] = "0x6c315f68616e646c6572";
   return TransactionHashPrefix2;
 })(TransactionHashPrefix || {});
+var feeMarginPercentage = /* @__PURE__ */ ((feeMarginPercentage2) => {
+  feeMarginPercentage2[feeMarginPercentage2["L1_BOUND_MAX_AMOUNT"] = 50] = "L1_BOUND_MAX_AMOUNT";
+  feeMarginPercentage2[feeMarginPercentage2["L1_BOUND_MAX_PRICE_PER_UNIT"] = 50] = "L1_BOUND_MAX_PRICE_PER_UNIT";
+  feeMarginPercentage2[feeMarginPercentage2["MAX_FEE"] = 50] = "MAX_FEE";
+  return feeMarginPercentage2;
+})(feeMarginPercentage || {});
 var UDC = {
   ADDRESS: "0x041a78e741e5af2fec34b695679bc6891742439f7afb8484ecd7766661ad02bf",
   ENTRYPOINT: "deployContract"
 };
-var RPC_DEFAULT_VERSION = "v0_6";
+var RPC_DEFAULT_VERSION = "v0_7";
 var RPC_NODES = {
   SN_GOERLI: [
     `https://starknet-testnet.public.blastapi.io/rpc/${RPC_DEFAULT_VERSION}`,
@@ -2941,10 +2963,10 @@ function signatureToDecimalArray(sig) {
 function signatureToHexArray(sig) {
   return bigNumberishArrayToHexadecimalStringArray(formatSignature(sig));
 }
-function estimatedFeeToMaxFee(estimatedFee, overhead = 0.5) {
-  return addPercent(estimatedFee, overhead * 100);
+function estimatedFeeToMaxFee(estimatedFee, overhead = 50 /* MAX_FEE */) {
+  return addPercent(estimatedFee, overhead);
 }
-function estimateFeeToBounds(estimate, amountOverhead = 10, priceOverhead = 50) {
+function estimateFeeToBounds(estimate, amountOverhead = 50 /* L1_BOUND_MAX_AMOUNT */, priceOverhead = 50 /* L1_BOUND_MAX_PRICE_PER_UNIT */) {
   if (typeof estimate === "bigint") {
     return {
       l2_gas: { max_amount: "0x0", max_price_per_unit: "0x0" },
@@ -2954,7 +2976,7 @@ function estimateFeeToBounds(estimate, amountOverhead = 10, priceOverhead = 50)
   if (typeof estimate.gas_consumed === "undefined" || typeof estimate.gas_price === "undefined") {
     throw Error("estimateFeeToBounds: estimate is undefined");
   }
-  const maxUnits = toHex(addPercent(estimate.gas_consumed, amountOverhead));
+  const maxUnits = estimate.data_gas_consumed !== void 0 && estimate.data_gas_price !== void 0 ? toHex(addPercent(BigInt(estimate.overall_fee) / BigInt(estimate.gas_price), amountOverhead)) : toHex(addPercent(estimate.gas_consumed, amountOverhead));
   const maxUnitPrice = toHex(addPercent(estimate.gas_price, priceOverhead));
   return {
     l2_gas: { max_amount: "0x0", max_price_per_unit: "0x0" },
@@ -3180,6 +3202,7 @@ function isPendingStateUpdate(response) {
 // src/utils/transaction.ts
 var transaction_exports = {};
 __export(transaction_exports, {
+  buildUDCCall: () => buildUDCCall,
   fromCallsToExecuteCalldata: () => fromCallsToExecuteCalldata,
   fromCallsToExecuteCalldataWithNonce: () => fromCallsToExecuteCalldataWithNonce,
   fromCallsToExecuteCalldata_cairo1: () => fromCallsToExecuteCalldata_cairo1,
@@ -3237,6 +3260,41 @@ var getExecuteCalldata = (calls, cairoVersion = "0") => {
   }
   return fromCallsToExecuteCalldata(calls);
 };
+function buildUDCCall(payload, address) {
+  const params = [].concat(payload).map((it) => {
+    const {
+      classHash,
+      salt,
+      unique = true,
+      constructorCalldata = []
+    } = it;
+    const compiledConstructorCallData = CallData.compile(constructorCalldata);
+    const deploySalt = salt ?? randomAddress();
+    return {
+      call: {
+        contractAddress: UDC.ADDRESS,
+        entrypoint: UDC.ENTRYPOINT,
+        calldata: [
+          classHash,
+          deploySalt,
+          toCairoBool(unique),
+          compiledConstructorCallData.length,
+          ...compiledConstructorCallData
+        ]
+      },
+      address: calculateContractAddressFromHash(
+        unique ? starkCurve.pedersen(address, deploySalt) : deploySalt,
+        classHash,
+        compiledConstructorCallData,
+        unique ? UDC.ADDRESS : 0
+      )
+    };
+  });
+  return {
+    calls: params.map((it) => it.call),
+    addresses: params.map((it) => it.address)
+  };
+}
 function getVersionsByType(versionType) {
   return versionType === "fee" ? {
     v1: "0x100000000000000000000000000000001" /* F1 */,
@@ -3278,6 +3336,9 @@ var RpcChannel = class {
     this.waitMode = waitMode || false;
     this.requestId = 0;
   }
+  setChainId(chainId) {
+    this.chainId = chainId;
+  }
   fetch(method, params, id = 0) {
     const rpcRequestBody = {
       id,
@@ -3808,6 +3869,9 @@ var RpcChannel2 = class {
     this.waitMode = waitMode || false;
     this.requestId = 0;
   }
+  setChainId(chainId) {
+    this.chainId = chainId;
+  }
   fetch(method, params, id = 0) {
     const rpcRequestBody = {
       id,
@@ -4308,6 +4372,20 @@ var RpcChannel2 = class {
 
 // src/utils/responseParser/rpc.ts
 var RPCResponseParser = class {
+  margin;
+  constructor(margin) {
+    this.margin = margin;
+  }
+  estimatedFeeToMaxFee(estimatedFee) {
+    return estimatedFeeToMaxFee(estimatedFee, this.margin?.maxFee);
+  }
+  estimateFeeToBounds(estimate) {
+    return estimateFeeToBounds(
+      estimate,
+      this.margin?.l1BoundMaxAmount,
+      this.margin?.l1BoundMaxPricePerUnit
+    );
+  }
   parseGetBlockResponse(res) {
     return { status: "PENDING", ...res };
   }
@@ -4330,8 +4408,8 @@ var RPCResponseParser = class {
       gas_consumed: toBigInt(val.gas_consumed),
       gas_price: toBigInt(val.gas_price),
       unit: val.unit,
-      suggestedMaxFee: estimatedFeeToMaxFee(val.overall_fee),
-      resourceBounds: estimateFeeToBounds(val)
+      suggestedMaxFee: this.estimatedFeeToMaxFee(val.overall_fee),
+      resourceBounds: this.estimateFeeToBounds(val)
     };
   }
   parseFeeEstimateBulkResponse(res) {
@@ -4340,16 +4418,16 @@ var RPCResponseParser = class {
       gas_consumed: toBigInt(val.gas_consumed),
       gas_price: toBigInt(val.gas_price),
       unit: val.unit,
-      suggestedMaxFee: estimatedFeeToMaxFee(val.overall_fee),
-      resourceBounds: estimateFeeToBounds(val)
+      suggestedMaxFee: this.estimatedFeeToMaxFee(val.overall_fee),
+      resourceBounds: this.estimateFeeToBounds(val)
     }));
   }
   parseSimulateTransactionResponse(res) {
     return res.map((it) => {
       return {
         ...it,
-        suggestedMaxFee: estimatedFeeToMaxFee(BigInt(it.fee_estimation.overall_fee)),
-        resourceBounds: estimateFeeToBounds(it.fee_estimation)
+        suggestedMaxFee: this.estimatedFeeToMaxFee(it.fee_estimation.overall_fee),
+        resourceBounds: this.estimateFeeToBounds(it.fee_estimation)
       };
     });
   }
@@ -4363,13 +4441,15 @@ var RPCResponseParser = class {
 
 // src/provider/rpc.ts
 var RpcProvider = class {
-  responseParser = new RPCResponseParser();
+  responseParser;
   channel;
   constructor(optionsOrProvider) {
     if (optionsOrProvider && "channel" in optionsOrProvider) {
       this.channel = optionsOrProvider.channel;
+      this.responseParser = optionsOrProvider.responseParser;
     } else {
       this.channel = new RpcChannel2({ ...optionsOrProvider, waitMode: false });
+      this.responseParser = new RPCResponseParser(optionsOrProvider?.feeMarginPercentage);
     }
   }
   fetch(method, params, id = 0) {
@@ -4462,7 +4542,7 @@ var RpcProvider = class {
    * - skipFeeCharge (default true)<br/>
    */
   async getSimulateTransaction(invocations, options) {
-    return this.channel.simulateTransaction(invocations, options).then(this.responseParser.parseSimulateTransactionResponse);
+    return this.channel.simulateTransaction(invocations, options).then((r) => this.responseParser.parseSimulateTransactionResponse(r));
   }
   async waitForTransaction(txHash, options) {
     return this.channel.waitForTransaction(txHash, options);
@@ -4519,7 +4599,7 @@ var RpcProvider = class {
         }
       ],
       { blockIdentifier, skipValidate }
-    ).then(this.responseParser.parseFeeEstimateResponse);
+    ).then((r) => this.responseParser.parseFeeEstimateResponse(r));
   }
   async getDeclareEstimateFee(invocation, details, blockIdentifier, skipValidate) {
     return this.channel.getEstimateFee(
@@ -4531,7 +4611,7 @@ var RpcProvider = class {
         }
       ],
       { blockIdentifier, skipValidate }
-    ).then(this.responseParser.parseFeeEstimateResponse);
+    ).then((r) => this.responseParser.parseFeeEstimateResponse(r));
   }
   async getDeployAccountEstimateFee(invocation, details, blockIdentifier, skipValidate) {
     return this.channel.getEstimateFee(
@@ -4543,10 +4623,10 @@ var RpcProvider = class {
         }
       ],
       { blockIdentifier, skipValidate }
-    ).then(this.responseParser.parseFeeEstimateResponse);
+    ).then((r) => this.responseParser.parseFeeEstimateResponse(r));
   }
   async getEstimateFeeBulk(invocations, options) {
-    return this.channel.getEstimateFee(invocations, options).then(this.responseParser.parseFeeEstimateBulkResponse);
+    return this.channel.getEstimateFee(invocations, options).then((r) => this.responseParser.parseFeeEstimateBulkResponse(r));
   }
   async invokeFunction(functionInvocation, details) {
     return this.channel.invoke(functionInvocation, details);
@@ -5887,37 +5967,7 @@ var Account = class extends RpcProvider2 {
     return this.declareContract(declareContractTransaction, declareDetails);
   }
   async deploy(payload, details = {}) {
-    const params = [].concat(payload).map((it) => {
-      const {
-        classHash,
-        salt,
-        unique = true,
-        constructorCalldata = []
-      } = it;
-      const compiledConstructorCallData = CallData.compile(constructorCalldata);
-      const deploySalt = salt ?? randomAddress();
-      return {
-        call: {
-          contractAddress: UDC.ADDRESS,
-          entrypoint: UDC.ENTRYPOINT,
-          calldata: [
-            classHash,
-            deploySalt,
-            toCairoBool(unique),
-            compiledConstructorCallData.length,
-            ...compiledConstructorCallData
-          ]
-        },
-        address: calculateContractAddressFromHash(
-          unique ? starkCurve.pedersen(this.address, deploySalt) : deploySalt,
-          classHash,
-          compiledConstructorCallData,
-          unique ? UDC.ADDRESS : 0
-        )
-      };
-    });
-    const calls = params.map((it) => it.call);
-    const addresses = params.map((it) => it.address);
+    const { calls, addresses } = buildUDCCall(payload, this.address);
     const invokeResponse = await this.execute(calls, void 0, details);
     return {
       ...invokeResponse,
@@ -6232,6 +6282,186 @@ var Account = class extends RpcProvider2 {
 var AccountInterface = class extends ProviderInterface {
 };
 
+// src/wallet/connect.ts
+function requestAccounts(swo, silentMode = false) {
+  return swo.request({
+    type: "wallet_requestAccounts",
+    params: {
+      silentMode
+    }
+  });
+}
+function getPermissions(swo) {
+  return swo.request({ type: "wallet_getPermissions" });
+}
+function watchAsset(swo, asset) {
+  return swo.request({
+    type: "wallet_watchAsset",
+    params: asset
+  });
+}
+function addStarknetChain(swo, chain) {
+  return swo.request({
+    type: "wallet_addStarknetChain",
+    params: chain
+  });
+}
+function switchStarknetChain(swo, chainId) {
+  return swo.request({
+    type: "wallet_switchStarknetChain",
+    params: {
+      chainId
+    }
+  });
+}
+function requestChainId(swo) {
+  return swo.request({ type: "wallet_requestChainId" });
+}
+function deploymentData(swo) {
+  return swo.request({ type: "wallet_deploymentData" });
+}
+function addInvokeTransaction(swo, params) {
+  return swo.request({
+    type: "starknet_addInvokeTransaction",
+    params
+  });
+}
+function addDeclareTransaction(swo, params) {
+  return swo.request({
+    type: "starknet_addDeclareTransaction",
+    params
+  });
+}
+function addDeployAccountTransaction(swo, params) {
+  return swo.request({
+    type: "starknet_addDeployAccountTransaction",
+    params
+  });
+}
+function signMessage(swo, typedData) {
+  return swo.request({
+    type: "starknet_signTypedData",
+    params: typedData
+  });
+}
+function supportedSpecs(swo) {
+  return swo.request({ type: "starknet_supportedSpecs" });
+}
+function onAccountChange(swo, callback) {
+  swo.on("accountsChanged", callback);
+}
+function onNetworkChanged(swo, callback) {
+  swo.on("networkChanged", callback);
+}
+
+// src/wallet/account.ts
+var WalletAccount = class extends Account {
+  address = "";
+  walletProvider;
+  constructor(providerOrOptions, walletProvider, cairoVersion) {
+    super(providerOrOptions, "", "", cairoVersion);
+    this.walletProvider = walletProvider;
+    this.walletProvider.on("accountsChanged", (res) => {
+      if (!res)
+        return;
+      this.address = res[0].toLowerCase();
+    });
+    this.walletProvider.on("networkChanged", (res) => {
+      if (!res)
+        return;
+      this.channel.setChainId(res);
+    });
+    walletProvider.request({
+      type: "wallet_requestAccounts",
+      params: {
+        silentMode: false
+      }
+    }).then((res) => {
+      this.address = res[0].toLowerCase();
+    });
+  }
+  /**
+   * WALLET EVENTS
+   */
+  onAccountChange(callback) {
+    onAccountChange(this.walletProvider, callback);
+  }
+  onNetworkChanged(callback) {
+    onNetworkChanged(this.walletProvider, callback);
+  }
+  /**
+   * WALLET SPECIFIC METHODS
+   */
+  requestAccounts(silentMode = false) {
+    return requestAccounts(this.walletProvider, silentMode);
+  }
+  getPermissions() {
+    return getPermissions(this.walletProvider);
+  }
+  switchStarknetChain(chainId) {
+    return switchStarknetChain(this.walletProvider, chainId);
+  }
+  watchAsset(asset) {
+    return watchAsset(this.walletProvider, asset);
+  }
+  addStarknetChain(chain) {
+    return addStarknetChain(this.walletProvider, chain);
+  }
+  /**
+   * ACCOUNT METHODS
+   */
+  execute(calls) {
+    const txCalls = [].concat(calls).map((it) => {
+      const { contractAddress, entrypoint, calldata } = it;
+      return {
+        contract_address: contractAddress,
+        entrypoint,
+        calldata
+      };
+    });
+    const params = {
+      calls: txCalls
+    };
+    return addInvokeTransaction(this.walletProvider, params);
+  }
+  declare(payload) {
+    const declareContractPayload = extractContractHashes(payload);
+    const pContract = payload.contract;
+    const cairo1Contract = {
+      ...pContract,
+      abi: stringify2(pContract.abi)
+    };
+    if (!declareContractPayload.compiledClassHash) {
+      throw Error("compiledClassHash is required");
+    }
+    const params = {
+      compiled_class_hash: declareContractPayload.compiledClassHash,
+      contract_class: cairo1Contract
+    };
+    return addDeclareTransaction(this.walletProvider, params);
+  }
+  async deploy(payload) {
+    const { calls, addresses } = buildUDCCall(payload, this.address);
+    const invokeResponse = await this.execute(calls);
+    return {
+      ...invokeResponse,
+      contract_address: addresses
+    };
+  }
+  deployAccount(payload) {
+    const params = {
+      contract_address_salt: payload.addressSalt?.toString() || "0",
+      constructor_calldata: payload.constructorCalldata ? CallData.compile(payload.constructorCalldata) : [],
+      class_hash: payload.classHash
+    };
+    return addDeployAccountTransaction(this.walletProvider, params);
+  }
+  signMessage(typedData) {
+    return signMessage(this.walletProvider, typedData);
+  }
+  // TODO: MISSING ESTIMATES
+};
+
 // src/utils/events/index.ts
 var events_exports = {};
 __export(events_exports, {
@@ -6743,13 +6973,19 @@ var number = num_exports;
   TypedDataRevision,
   Uint,
   ValidateType,
+  WalletAccount,
   addAddressPadding,
+  addDeclareTransaction,
+  addDeployAccountTransaction,
+  addInvokeTransaction,
+  addStarknetChain,
   buildUrl,
   byteArray,
   cairo,
   constants,
   contractClassResponseToLegacyCompiledContract,
   defaultProvider,
+  deploymentData,
   ec,
   encode,
   eth,
@@ -6759,6 +6995,7 @@ var number = num_exports;
   fixStack,
   getCalldata,
   getChecksumAddress,
+  getPermissions,
   hash,
   isSierra,
   isUrl,
@@ -6766,13 +7003,20 @@ var number = num_exports;
   merkle,
   num,
   number,
+  onAccountChange,
+  onNetworkChanged,
   parseUDCEvent,
   provider,
+  requestAccounts,
+  requestChainId,
   selector,
   shortString,
+  signMessage,
   splitArgsAndOptions,
   stark,
   starknetId,
+  supportedSpecs,
+  switchStarknetChain,
   transaction,
   typedData,
   types,
@@ -6780,6 +7024,7 @@ var number = num_exports;
   v2hash,
   v3hash,
   validateAndParseAddress,
-  validateChecksumAddress
+  validateChecksumAddress,
+  watchAsset
 });
 //# sourceMappingURL=index.js.map