viem 0.0.1-alpha.3 → 0.0.1-alpha.4

package/dist/actions/index.js

@@ -58,9 +58,9 @@ import {
   watchBlockNumber,
   watchBlocks,
   watchPendingTransactions
-} from "../chunk-YZEQFYZ3.js";
-import "../chunk-SRDTRROA.js";
-import "../chunk-WZITKXV3.js";
+} from "../chunk-43X52QQL.js";
+import "../chunk-ROF2KQ2X.js";
+import "../chunk-COHLCIQM.js";
 export {
   addChain,
   call,

package/dist/chains.js

@@ -3,8 +3,8 @@ import {
   formatTransaction,
   formatTransactionReceipt,
   formatTransactionRequest
-} from "./chunk-SRDTRROA.js";
-import "./chunk-WZITKXV3.js";
+} from "./chunk-ROF2KQ2X.js";
+import "./chunk-COHLCIQM.js";
 
 // src/chains.ts
 import {

package/dist/{chunk-YZEQFYZ3.js → chunk-43X52QQL.js}

@@ -11,7 +11,7 @@ import {
   getAddress,
   hexToNumber,
   numberToHex
-} from "./chunk-SRDTRROA.js";
+} from "./chunk-ROF2KQ2X.js";
 import {
   BaseError,
   BlockNotFoundError,
@@ -22,7 +22,7 @@ import {
   getCache,
   wait,
   withCache
-} from "./chunk-WZITKXV3.js";
+} from "./chunk-COHLCIQM.js";
 
 // src/actions/public/call.ts
 async function call(client, {

package/dist/{chunk-WZITKXV3.js → chunk-COHLCIQM.js}

@@ -9,7 +9,7 @@ var __publicField = (obj, key, value) => {
 var package_default = {
   name: "viem",
   description: "TypeScript (& JavaScript) Interface for Ethereum",
-  version: "0.0.1-alpha.3",
+  version: "0.0.1-alpha.4",
   scripts: {
     anvil: "source .env && anvil --fork-url $ANVIL_FORK_URL --fork-block-number $VITE_ANVIL_BLOCK_NUMBER --block-time $VITE_ANVIL_BLOCK_TIME",
     bench: "vitest bench --no-threads",
@@ -213,6 +213,21 @@ var AbiFunctionNotFoundError = class extends BaseError {
     __publicField(this, "name", "AbiFunctionNotFoundError");
   }
 };
+var AbiFunctionOutputsNotFoundError = class extends BaseError {
+  constructor(functionName) {
+    super(
+      [
+        `Function "${functionName}" does not contain any \`outputs\` on ABI.`,
+        "Cannot decode function result without knowing what the parameter types are.",
+        "Make sure you are using the correct ABI and that the function exists on it."
+      ].join("\n"),
+      {
+        docsPath: "/docs/contract/decodeFunctionResult"
+      }
+    );
+    __publicField(this, "name", "AbiFunctionOutputsNotFoundError");
+  }
+};
 var AbiFunctionSignatureNotFoundError = class extends BaseError {
   constructor(signature) {
     super(
@@ -949,6 +964,7 @@ export {
   AbiEncodingArrayLengthMismatchError,
   AbiEncodingLengthMismatchError,
   AbiFunctionNotFoundError,
+  AbiFunctionOutputsNotFoundError,
   AbiFunctionSignatureNotFoundError,
   InvalidAbiEncodingTypeError,
   InvalidAbiDecodingTypeError,

package/dist/{chunk-SRDTRROA.js → chunk-ROF2KQ2X.js}

@@ -3,6 +3,7 @@ import {
   AbiEncodingArrayLengthMismatchError,
   AbiEncodingLengthMismatchError,
   AbiFunctionNotFoundError,
+  AbiFunctionOutputsNotFoundError,
   AbiFunctionSignatureNotFoundError,
   DataLengthTooLongError,
   DataLengthTooShortError,
@@ -16,7 +17,7 @@ import {
   InvalidHexValueError,
   OffsetOutOfBoundsError,
   SizeExceedsPaddingSizeError
-} from "./chunk-WZITKXV3.js";
+} from "./chunk-COHLCIQM.js";
 
 // src/utils/data/concat.ts
 function concat(values) {
@@ -943,6 +944,21 @@ function decodeFunctionData({ abi, data }) {
   };
 }
 
+// src/utils/abi/decodeFunctionResult.ts
+function decodeFunctionResult({
+  abi,
+  functionName,
+  data
+}) {
+  const description = abi.find((x) => "name" in x && x.name === functionName);
+  if (!description)
+    throw new AbiFunctionNotFoundError(functionName);
+  if (!("outputs" in description))
+    throw new AbiFunctionOutputsNotFoundError(functionName);
+  const values = decodeAbi({ data, params: description.outputs });
+  return values.length > 1 ? values : values.length === 1 ? values[0] : void 0;
+}
+
 // src/utils/abi/encodeFunctionData.ts
 function encodeFunctionData({
   abi,
@@ -1193,6 +1209,7 @@ export {
   encodeAbi,
   decodeAbi,
   decodeFunctionData,
+  decodeFunctionResult,
   encodeFunctionData,
   etherUnits,
   gweiUnits,

package/dist/{chunk-TLEMV4T3.js → chunk-ZGVHEFCJ.js}

@@ -3,7 +3,7 @@ import {
   buildRequest,
   getSocket,
   rpc
-} from "./chunk-WZITKXV3.js";
+} from "./chunk-COHLCIQM.js";
 
 // src/clients/transports/createTransport.ts
 function createTransport(config, value) {

package/dist/clients/index.js

@@ -8,8 +8,8 @@ import {
   fallback,
   http,
   webSocket
-} from "../chunk-TLEMV4T3.js";
-import "../chunk-WZITKXV3.js";
+} from "../chunk-ZGVHEFCJ.js";
+import "../chunk-COHLCIQM.js";
 export {
   createClient,
   createPublicClient,

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { C as Client, a as ClientConfig, P as PublicClient, b as PublicClientCon
 export { C as CustomTransport, a as CustomTransportConfig, F as FallbackTransport, b as FallbackTransportConfig, H as HttpTransport, c as HttpTransportConfig, W as WebSocketTransport, d as WebSocketTransportConfig, e as custom, f as fallback, h as http, w as webSocket } from './webSocket-b55b0951.js';
 import { A as Address, H as Hash, B as ByteArray, a as Hex, b as BlockTag } from './rpc-15b85963.js';
 export { c as AccessList, A as Address, d as Block, f as BlockIdentifier, h as BlockNumber, b as BlockTag, B as ByteArray, F as FeeHistory, i as FeeValues, j as FeeValuesEIP1559, k as FeeValuesLegacy, H as Hash, a as Hex, L as Log, R as RpcBlock, l as RpcBlockIdentifier, m as RpcBlockNumber, n as RpcFeeHistory, o as RpcFeeValues, p as RpcLog, q as RpcTransaction, r as RpcTransactionReceipt, s as RpcTransactionRequest, u as RpcUncle, D as Transaction, E as TransactionBase, G as TransactionEIP1559, I as TransactionEIP2930, J as TransactionLegacy, T as TransactionReceipt, v as TransactionRequest, x as TransactionRequestBase, y as TransactionRequestEIP1559, z as TransactionRequestEIP2930, C as TransactionRequestLegacy, U as Uncle, e as etherUnits, g as gweiUnits, t as transactionType, w as weiUnits } from './rpc-15b85963.js';
-export { E as EncodeRlpResponse, G as GetContractAddressOptions, b as GetCreate2AddressOptions, a as GetCreateAddressOptions, e as boolToBytes, f as boolToHex, g as bytesToBigint, h as bytesToBool, c as bytesToHex, i as bytesToNumber, d as bytesToString, j as decodeAbi, k as decodeBytes, l as decodeFunctionData, m as decodeHex, n as decodeRlp, o as encodeAbi, p as encodeBytes, q as encodeFunctionData, r as encodeHex, s as encodeRlp, z as formatEther, S as formatGwei, T as formatUnit, t as getAddress, u as getContractAddress, w as getCreate2Address, v as getCreateAddress, x as getEventSignature, y as getFunctionSignature, F as hexToBigInt, H as hexToBool, I as hexToBytes, U as hexToNumber, J as hexToString, A as isAddress, B as isAddressEqual, C as isBytes, D as isHex, K as keccak256, L as numberToBytes, V as numberToHex, M as pad, N as padBytes, O as padHex, P as parseEther, Q as parseGwei, R as parseUnit, W as size, X as slice, Y as sliceBytes, Z as sliceHex, _ as stringToBytes, $ as stringToHex, a0 as trim } from './parseGwei-0f85e8ca.js';
+export { E as EncodeRlpResponse, G as GetContractAddressOptions, b as GetCreate2AddressOptions, a as GetCreateAddressOptions, e as boolToBytes, f as boolToHex, g as bytesToBigint, h as bytesToBool, c as bytesToHex, i as bytesToNumber, d as bytesToString, j as decodeAbi, k as decodeBytes, l as decodeFunctionData, m as decodeFunctionResult, n as decodeHex, o as decodeRlp, p as encodeAbi, q as encodeBytes, r as encodeFunctionData, s as encodeHex, t as encodeRlp, A as formatEther, T as formatGwei, U as formatUnit, u as getAddress, v as getContractAddress, x as getCreate2Address, w as getCreateAddress, y as getEventSignature, z as getFunctionSignature, H as hexToBigInt, I as hexToBool, J as hexToBytes, V as hexToNumber, K as hexToString, B as isAddress, C as isAddressEqual, D as isBytes, F as isHex, L as keccak256, M as numberToBytes, W as numberToHex, N as pad, O as padBytes, P as padHex, Q as parseEther, R as parseGwei, S as parseUnit, X as size, Y as slice, Z as sliceBytes, _ as sliceHex, $ as stringToBytes, a0 as stringToHex, a1 as trim } from './parseGwei-a952d720.js';
 export { F as FormattedBlock, a as FormattedTransaction, b as FormattedTransactionRequest, f as formatBlock, c as formatTransaction, d as formatTransactionRequest } from './transactionRequest-f538ea86.js';
 import './chains.js';
 import '@wagmi/chains';

package/dist/index.js

@@ -57,7 +57,7 @@ import {
   watchBlockNumber,
   watchBlocks,
   watchPendingTransactions
-} from "./chunk-YZEQFYZ3.js";
+} from "./chunk-43X52QQL.js";
 import {
   createClient,
   createPublicClient,
@@ -68,7 +68,7 @@ import {
   fallback,
   http,
   webSocket
-} from "./chunk-TLEMV4T3.js";
+} from "./chunk-ZGVHEFCJ.js";
 import {
   boolToBytes,
   boolToHex,
@@ -80,6 +80,7 @@ import {
   decodeAbi,
   decodeBytes,
   decodeFunctionData,
+  decodeFunctionResult,
   decodeHex,
   decodeRlp,
   encodeAbi,
@@ -128,7 +129,7 @@ import {
   transactionType,
   trim,
   weiUnits
-} from "./chunk-SRDTRROA.js";
+} from "./chunk-ROF2KQ2X.js";
 import {
   AbiDecodingDataSizeInvalidError,
   AbiEncodingArrayLengthMismatchError,
@@ -172,7 +173,7 @@ import {
   UrlRequiredError,
   WaitForTransactionReceiptTimeoutError,
   WebSocketRequestError
-} from "./chunk-WZITKXV3.js";
+} from "./chunk-COHLCIQM.js";
 export {
   AbiDecodingDataSizeInvalidError,
   AbiEncodingArrayLengthMismatchError,
@@ -236,6 +237,7 @@ export {
   decodeAbi,
   decodeBytes,
   decodeFunctionData,
+  decodeFunctionResult,
   decodeHex,
   decodeRlp,
   dropTransaction,

package/dist/{parseGwei-0f85e8ca.d.ts → parseGwei-a952d720.d.ts}

@@ -31,6 +31,12 @@ declare function decodeFunctionData({ abi, data }: {
     args: readonly unknown[] | undefined;
 };
 
+declare function decodeFunctionResult<TAbi extends Abi = Abi, TFunctionName extends ExtractAbiFunctionNames<TAbi> = any>({ abi, functionName, data, }: {
+    abi: TAbi;
+    functionName: TFunctionName;
+    data: Hex;
+}): unknown;
+
 /**
  * @description Encodes a list of primitive values into an ABI-encoded hex value.
  */
@@ -245,4 +251,4 @@ declare function parseEther(ether: `${number}`, unit?: 'wei' | 'gwei'): bigint;
 
 declare function parseGwei(ether: `${number}`, unit?: 'wei'): bigint;
 
-export { stringToHex as $, isAddress as A, isAddressEqual as B, isBytes as C, isHex as D, EncodeRlpResponse as E, hexToBigInt as F, GetContractAddressOptions as G, hexToBool as H, hexToBytes as I, hexToString as J, keccak256 as K, numberToBytes as L, pad as M, padBytes as N, padHex as O, parseEther as P, parseGwei as Q, parseUnit as R, formatGwei as S, formatUnit as T, hexToNumber as U, numberToHex as V, size as W, slice as X, sliceBytes as Y, sliceHex as Z, stringToBytes as _, GetCreateAddressOptions as a, trim as a0, GetCreate2AddressOptions as b, bytesToHex as c, bytesToString as d, boolToBytes as e, boolToHex as f, bytesToBigint as g, bytesToBool as h, bytesToNumber as i, decodeAbi as j, decodeBytes as k, decodeFunctionData as l, decodeHex as m, decodeRlp as n, encodeAbi as o, encodeBytes as p, encodeFunctionData as q, encodeHex as r, encodeRlp as s, getAddress as t, getContractAddress as u, getCreateAddress as v, getCreate2Address as w, getEventSignature as x, getFunctionSignature as y, formatEther as z };
+export { stringToBytes as $, formatEther as A, isAddress as B, isAddressEqual as C, isBytes as D, EncodeRlpResponse as E, isHex as F, GetContractAddressOptions as G, hexToBigInt as H, hexToBool as I, hexToBytes as J, hexToString as K, keccak256 as L, numberToBytes as M, pad as N, padBytes as O, padHex as P, parseEther as Q, parseGwei as R, parseUnit as S, formatGwei as T, formatUnit as U, hexToNumber as V, numberToHex as W, size as X, slice as Y, sliceBytes as Z, sliceHex as _, GetCreateAddressOptions as a, stringToHex as a0, trim as a1, GetCreate2AddressOptions as b, bytesToHex as c, bytesToString as d, boolToBytes as e, boolToHex as f, bytesToBigint as g, bytesToBool as h, bytesToNumber as i, decodeAbi as j, decodeBytes as k, decodeFunctionData as l, decodeFunctionResult as m, decodeHex as n, decodeRlp as o, encodeAbi as p, encodeBytes as q, encodeFunctionData as r, encodeHex as s, encodeRlp as t, getAddress as u, getContractAddress as v, getCreateAddress as w, getCreate2Address as x, getEventSignature as y, getFunctionSignature as z };

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-export { E as EncodeRlpResponse, G as GetContractAddressOptions, b as GetCreate2AddressOptions, a as GetCreateAddressOptions, e as boolToBytes, f as boolToHex, g as bytesToBigint, h as bytesToBool, c as bytesToHex, i as bytesToNumber, d as bytesToString, j as decodeAbi, k as decodeBytes, l as decodeFunctionData, m as decodeHex, n as decodeRlp, o as encodeAbi, p as encodeBytes, q as encodeFunctionData, r as encodeHex, s as encodeRlp, z as formatEther, S as formatGwei, T as formatUnit, t as getAddress, u as getContractAddress, w as getCreate2Address, v as getCreateAddress, x as getEventSignature, y as getFunctionSignature, F as hexToBigInt, H as hexToBool, I as hexToBytes, U as hexToNumber, J as hexToString, A as isAddress, B as isAddressEqual, C as isBytes, D as isHex, K as keccak256, L as numberToBytes, V as numberToHex, M as pad, N as padBytes, O as padHex, P as parseEther, Q as parseGwei, R as parseUnit, W as size, X as slice, Y as sliceBytes, Z as sliceHex, _ as stringToBytes, $ as stringToHex, a0 as trim } from '../parseGwei-0f85e8ca.js';
+export { E as EncodeRlpResponse, G as GetContractAddressOptions, b as GetCreate2AddressOptions, a as GetCreateAddressOptions, e as boolToBytes, f as boolToHex, g as bytesToBigint, h as bytesToBool, c as bytesToHex, i as bytesToNumber, d as bytesToString, j as decodeAbi, k as decodeBytes, l as decodeFunctionData, m as decodeFunctionResult, n as decodeHex, o as decodeRlp, p as encodeAbi, q as encodeBytes, r as encodeFunctionData, s as encodeHex, t as encodeRlp, A as formatEther, T as formatGwei, U as formatUnit, u as getAddress, v as getContractAddress, x as getCreate2Address, w as getCreateAddress, y as getEventSignature, z as getFunctionSignature, H as hexToBigInt, I as hexToBool, J as hexToBytes, V as hexToNumber, K as hexToString, B as isAddress, C as isAddressEqual, D as isBytes, F as isHex, L as keccak256, M as numberToBytes, W as numberToHex, N as pad, O as padBytes, P as padHex, Q as parseEther, R as parseGwei, S as parseUnit, X as size, Y as slice, Z as sliceBytes, _ as sliceHex, $ as stringToBytes, a0 as stringToHex, a1 as trim } from '../parseGwei-a952d720.js';
 export { B as BlockFormatter, E as ExtractFormatter, e as Formatted, F as FormattedBlock, a as FormattedTransaction, h as FormattedTransactionReceipt, b as FormattedTransactionRequest, g as TransactionFormatter, i as TransactionReceiptFormatter, T as TransactionRequestFormatter, j as format, f as formatBlock, c as formatTransaction, d as formatTransactionRequest } from '../transactionRequest-f538ea86.js';
 export { r as rpc } from '../rpc-26932bae.js';
 import 'abitype';

package/dist/utils/index.js

@@ -9,6 +9,7 @@ import {
   decodeAbi,
   decodeBytes,
   decodeFunctionData,
+  decodeFunctionResult,
   decodeHex,
   decodeRlp,
   encodeAbi,
@@ -57,11 +58,11 @@ import {
   stringToBytes,
   stringToHex,
   trim
-} from "../chunk-SRDTRROA.js";
+} from "../chunk-ROF2KQ2X.js";
 import {
   buildRequest,
   rpc
-} from "../chunk-WZITKXV3.js";
+} from "../chunk-COHLCIQM.js";
 export {
   boolToBytes,
   boolToHex,
@@ -74,6 +75,7 @@ export {
   decodeAbi,
   decodeBytes,
   decodeFunctionData,
+  decodeFunctionResult,
   decodeHex,
   decodeRlp,
   encodeAbi,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript (& JavaScript) Interface for Ethereum",
-  "version": "0.0.1-alpha.3",
+  "version": "0.0.1-alpha.4",
   "files": [
     "/actions",
     "/chains",