viem 0.3.13 → 0.3.15

package/dist/types/utils/index.d.ts

@@ -4,6 +4,7 @@ export { parseAccount, publicKeyToAddress } from './accounts.js';
 export type { GetContractAddressOptions, GetCreate2AddressOptions, GetCreateAddressOptions, } from './address/index.js';
 export { getAddress, getContractAddress, getCreateAddress, getCreate2Address, isAddress, isAddressEqual, } from './address/index.js';
 export { buildRequest } from './buildRequest.js';
+export { ccipFetch, offchainLookup, offchainLookupAbiItem, offchainLookupSignature, } from './ccip.js';
 export { defineChain, getChainContractAddress } from './chain.js';
 export { extractFunctionName, extractFunctionParams, extractFunctionType, extractFunctionParts, } from './contract/index.js';
 export { concat, concatBytes, concatHex, isBytes, isHex, pad, padBytes, padHex, size, slice, sliceBytes, sliceHex, trim, } from './data/index.js';

package/dist/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -12,7 +12,7 @@
     "isomorphic-ws": "5.0.0",
     "ws": "8.12.0"
   },
-  "version": "0.3.13",
+  "version": "0.3.15",
   "files": [
     "dist",
     "!dist/**/*.tsbuildinfo",

package/src/actions/public/call.ts

@@ -1,7 +1,7 @@
 import type { PublicClient, Transport } from '../../clients/index.js'
 import { aggregate3Signature, multicall3Abi } from '../../constants/index.js'
-import type { BaseError } from '../../errors/index.js'
 import {
+  BaseError,
   ChainDoesNotSupportContract,
   ClientChainNotConfiguredError,
   RawContractError,
@@ -159,6 +159,13 @@ export async function call<TChain extends Chain | undefined>(
     if (response === '0x') return { data: undefined }
     return { data: response }
   } catch (err) {
+    const data = getRevertErrorData(err)
+    const { offchainLookup, offchainLookupSignature } = await import(
+      '../../utils/ccip.js'
+    )
+    if (data?.slice(0, 10) === offchainLookupSignature && to) {
+      return { data: await offchainLookup(client, { data, to }) }
+    }
     throw getCallError(err as BaseError, {
       ...args,
       account,
@@ -272,3 +279,8 @@ async function scheduleMulticall<TChain extends Chain | undefined>(
   if (returnData === '0x') return { data: undefined }
   return { data: returnData }
 }
+
+export function getRevertErrorData(err: unknown) {
+  if (!(err instanceof BaseError)) return undefined
+  return (err.walk() as { data?: Hex })?.data
+}

package/src/actions/public/multicall.ts

@@ -185,7 +185,7 @@ export async function multicall<
     ),
   )
 
-  return results.flat().flatMap(({ returnData, success }, i) => {
+  return results.flat().map(({ returnData, success }, i) => {
     const calls = chunkedCalls.flat()
     const { callData } = calls[i]
     const { abi, address, functionName, args } = contracts[i]

package/src/actions/public/simulateContract.ts

@@ -7,6 +7,7 @@ import type {
   ContractFunctionConfig,
   ContractFunctionResult,
   GetValue,
+  Hex,
 } from '../../types/index.js'
 import {
   decodeFunctionResult,
@@ -29,6 +30,8 @@ export type SimulateContractParameters<
   TChainOverride extends Chain | undefined = undefined,
 > = {
   chain?: TChainOverride
+  /** Data to append to the end of the calldata. Useful for adding a ["domain" tag](https://opensea.notion.site/opensea/Seaport-Order-Attributions-ec2d69bf455041a5baa490941aad307f). */
+  dataSuffix?: Hex
 } & ContractFunctionConfig<TAbi, TFunctionName, 'payable' | 'nonpayable'> &
   Omit<
     CallParameters<TChainOverride extends Chain ? TChainOverride : TChain>,
@@ -99,6 +102,7 @@ export async function simulateContract<
     abi,
     address,
     args,
+    dataSuffix,
     functionName,
     ...callRequest
   }: SimulateContractParameters<TAbi, TFunctionName, TChain, TChainOverride>,
@@ -116,7 +120,7 @@ export async function simulateContract<
   try {
     const { data } = await call(client, {
       batch: false,
-      data: calldata,
+      data: `${calldata}${dataSuffix ? dataSuffix.replace('0x', '') : ''}`,
       to: address,
       ...callRequest,
     } as unknown as CallParameters<TChain>)

package/src/actions/wallet/writeContract.ts

@@ -7,6 +7,7 @@ import type {
   ContractFunctionConfig,
   GetChain,
   GetValue,
+  Hex,
 } from '../../types/index.js'
 import { encodeFunctionData } from '../../utils/index.js'
 import type { EncodeFunctionDataParameters } from '../../utils/index.js'
@@ -28,7 +29,10 @@ export type WriteContractParameters<
     'chain' | 'to' | 'data' | 'value'
   > &
   GetChain<TChain, TChainOverride> &
-  GetValue<TAbi, TFunctionName, SendTransactionParameters<TChain>['value']>
+  GetValue<TAbi, TFunctionName, SendTransactionParameters<TChain>['value']> & {
+    /** Data to append to the end of the calldata. Useful for adding a ["domain" tag](https://opensea.notion.site/opensea/Seaport-Order-Attributions-ec2d69bf455041a5baa490941aad307f). */
+    dataSuffix?: Hex
+  }
 
 export type WriteContractReturnType = SendTransactionReturnType
 
@@ -94,6 +98,7 @@ export async function writeContract<
     abi,
     address,
     args,
+    dataSuffix,
     functionName,
     ...request
   }: WriteContractParameters<
@@ -110,7 +115,7 @@ export async function writeContract<
     functionName,
   } as unknown as EncodeFunctionDataParameters<TAbi, TFunctionName>)
   const hash = await sendTransaction(client, {
-    data,
+    data: `${data}${dataSuffix ? dataSuffix.replace('0x', '') : ''}`,
     to: address,
     ...request,
   } as unknown as SendTransactionParameters<TChain, TAccount, TChainOverride>)

package/src/chains.ts

@@ -10,7 +10,6 @@ import {
 } from './utils/index.js'
 
 export type { Chain } from './types/index.js'
-export { defineChain } from './utils/index.js'
 
 const celoFormatters = {
   block: defineBlock({

package/src/constants/address.ts

@@ -0,0 +1 @@
+export const zeroAddress = '0x0000000000000000000000000000000000000000' as const

package/src/constants/index.ts

@@ -1,3 +1,5 @@
+export { zeroAddress } from './address.js'
+
 export { multicall3Abi } from './abis.js'
 
 export { aggregate3Signature } from './contract.js'

package/src/errors/base.ts

@@ -59,4 +59,14 @@ export class BaseError extends Error {
     this.metaMessages = args.metaMessages
     this.shortMessage = shortMessage
   }
+
+  walk(fn?: (err: unknown) => boolean) {
+    return this.#walk(this, fn)
+  }
+
+  #walk(err: unknown, fn?: (err: unknown) => boolean): unknown {
+    if (fn?.(err)) return err
+    if ((err as Error).cause) return this.#walk((err as Error).cause, fn)
+    return err
+  }
 }

package/src/errors/ccip.ts

@@ -0,0 +1,74 @@
+import type { Address } from 'abitype'
+import { BaseError } from './base.js'
+import type { Hex } from '../types/index.js'
+import { getUrl } from './utils.js'
+
+export class OffchainLookupError extends BaseError {
+  override name = 'OffchainLookupError'
+  constructor({
+    callbackSelector,
+    cause,
+    data,
+    extraData,
+    sender,
+    urls,
+  }: {
+    callbackSelector: Hex
+    cause: BaseError
+    data: Hex
+    extraData: Hex
+    sender: Address
+    urls: readonly string[]
+  }) {
+    super(
+      cause.shortMessage ||
+        'An error occurred while fetching for an offchain result.',
+      {
+        cause,
+        metaMessages: [
+          ...(cause.metaMessages || []),
+          cause.metaMessages?.length ? '' : [],
+          'Offchain Gateway Call:',
+          urls && [
+            '  Gateway URL(s):',
+            ...urls.map((url) => `    ${getUrl(url)}`),
+          ],
+          `  Sender: ${sender}`,
+          `  Data: ${data}`,
+          `  Callback selector: ${callbackSelector}`,
+          `  Extra data: ${extraData}`,
+        ].flat(),
+      },
+    )
+  }
+}
+
+export class OffchainLookupResponseMalformedError extends BaseError {
+  override name = 'OffchainLookupResponseMalformedError'
+  constructor({ result, url }: { result: any; url: string }) {
+    super(
+      'Offchain gateway response is malformed. Response data must be a hex value.',
+      {
+        metaMessages: [
+          `Gateway URL: ${getUrl(url)}`,
+          `Response: ${JSON.stringify(result)}`,
+        ],
+      },
+    )
+  }
+}
+
+export class OffchainLookupSenderMismatchError extends BaseError {
+  override name = 'OffchainLookupSenderMismatchError'
+  constructor({ sender, to }: { sender: Address; to: Address }) {
+    super(
+      'Reverted sender address does not match target contract address (`to`).',
+      {
+        metaMessages: [
+          `Contract address: ${to}`,
+          `OffchainLookup sender address: ${sender}`,
+        ],
+      },
+    )
+  }
+}

package/src/errors/index.ts

@@ -41,6 +41,12 @@ export {
   InvalidChainIdError,
 } from './chain.js'
 
+export {
+  OffchainLookupError,
+  OffchainLookupResponseMalformedError,
+  OffchainLookupSenderMismatchError,
+} from './ccip.js'
+
 export {
   CallExecutionError,
   ContractFunctionExecutionError,

package/src/errors/request.ts

@@ -5,7 +5,7 @@ import { getUrl } from './utils.js'
 export class HttpRequestError extends BaseError {
   override name = 'HttpRequestError'
 
-  body: { [key: string]: unknown }
+  body?: { [key: string]: unknown }
   headers?: Headers
   status?: number
   url: string
@@ -17,7 +17,7 @@ export class HttpRequestError extends BaseError {
     status,
     url,
   }: {
-    body: { [key: string]: unknown }
+    body?: { [key: string]: unknown }
     details?: string
     headers?: Headers
     status?: number
@@ -28,7 +28,7 @@ export class HttpRequestError extends BaseError {
       metaMessages: [
         status && `Status: ${status}`,
         `URL: ${getUrl(url)}`,
-        `Request body: ${stringify(body)}`,
+        body && `Request body: ${stringify(body)}`,
       ].filter(Boolean) as string[],
     })
     this.body = body

package/src/errors/version.ts

@@ -1 +1 @@
-export const version = '0.3.13'
+export const version = '0.3.15'

package/src/index.ts

@@ -159,6 +159,7 @@ export {
   etherUnits,
   gweiUnits,
   weiUnits,
+  zeroAddress,
 } from './constants/index.js'
 
 export {
@@ -398,6 +399,7 @@ export {
   bytesToHex,
   bytesToNumber,
   bytesToString,
+  ccipFetch,
   concat,
   concatBytes,
   concatHex,
@@ -452,6 +454,9 @@ export {
   keccak256,
   numberToBytes,
   numberToHex,
+  offchainLookup,
+  offchainLookupAbiItem,
+  offchainLookupSignature,
   pad,
   padBytes,
   padHex,

package/src/utils/ccip.ts

@@ -0,0 +1,160 @@
+import type { Abi, Address } from 'abitype'
+import type { PublicClient, Transport } from '../clients/index.js'
+import {
+  BaseError,
+  HttpRequestError,
+  OffchainLookupError,
+  OffchainLookupResponseMalformedError,
+  OffchainLookupSenderMismatchError,
+} from '../errors/index.js'
+import type { CallParameters } from '../actions/public/index.js'
+import { call } from '../actions/public/call.js'
+import type { Chain, GetErrorArgs, Hex } from '../types/index.js'
+import { decodeErrorResult, encodeAbiParameters } from './abi/index.js'
+import { isAddressEqual } from './address/index.js'
+import { concat, isHex } from './data/index.js'
+import { stringify } from './stringify.js'
+
+export const offchainLookupSignature = '0x556f1830'
+export const offchainLookupAbiItem = {
+  name: 'OffchainLookup',
+  type: 'error',
+  inputs: [
+    {
+      name: 'sender',
+      type: 'address',
+    },
+    {
+      name: 'urls',
+      type: 'string[]',
+    },
+    {
+      name: 'callData',
+      type: 'bytes',
+    },
+    {
+      name: 'callbackFunction',
+      type: 'bytes4',
+    },
+    {
+      name: 'extraData',
+      type: 'bytes',
+    },
+  ],
+} as const satisfies Abi[number]
+
+export async function offchainLookup<TChain extends Chain | undefined>(
+  client: PublicClient<Transport, TChain>,
+  {
+    blockNumber,
+    blockTag,
+    data,
+    to,
+  }: Pick<CallParameters, 'blockNumber' | 'blockTag'> & {
+    data: Hex
+    to: Address
+  },
+): Promise<Hex> {
+  const { args } = decodeErrorResult({
+    data,
+    abi: [offchainLookupAbiItem],
+  }) as unknown as GetErrorArgs<
+    [typeof offchainLookupAbiItem],
+    'OffchainLookup'
+  >
+  const [sender, urls, callData, callbackSelector, extraData] = args
+
+  try {
+    if (!isAddressEqual(to, sender))
+      throw new OffchainLookupSenderMismatchError({ sender, to })
+
+    const result = await ccipFetch({ data: callData, sender, urls })
+
+    const { data: data_ } = await call(client, {
+      blockNumber,
+      blockTag,
+      data: concat([
+        callbackSelector,
+        encodeAbiParameters(
+          [{ type: 'bytes' }, { type: 'bytes' }],
+          [result, extraData],
+        ),
+      ]),
+      to,
+    } as CallParameters)
+
+    return data_!
+  } catch (err) {
+    throw new OffchainLookupError({
+      callbackSelector,
+      cause: err as BaseError,
+      data,
+      extraData,
+      sender,
+      urls,
+    })
+  }
+}
+
+export async function ccipFetch({
+  data,
+  sender,
+  urls,
+}: { data: Hex; sender: Address; urls: readonly string[] }) {
+  let error = new Error('An unknown error occurred.')
+
+  for (let i = 0; i < urls.length; i++) {
+    const url = urls[i]
+    const method =
+      url.includes('{sender}') || url.includes('{data}') ? 'GET' : 'POST'
+    const body = method === 'POST' ? { data, sender } : undefined
+
+    try {
+      const response = await fetch(
+        url.replace('{sender}', sender).replace('{data}', data),
+        {
+          body: JSON.stringify(body),
+          method,
+        },
+      )
+
+      let result
+      if (
+        response.headers.get('Content-Type')?.startsWith('application/json')
+      ) {
+        result = (await response.json()).data
+      } else {
+        result = (await response.text()) as any
+      }
+
+      if (!response.ok) {
+        error = new HttpRequestError({
+          body,
+          details: stringify(result.error) || response.statusText,
+          headers: response.headers,
+          status: response.status,
+          url,
+        })
+        continue
+      }
+
+      if (!isHex(result)) {
+        error = new OffchainLookupResponseMalformedError({
+          result,
+          url,
+        })
+        continue
+      }
+
+      return result
+    } catch (err) {
+      error = new HttpRequestError({
+        body,
+        details: (err as Error).message,
+        url,
+      })
+    }
+  }
+
+  throw error
+}

package/src/utils/errors/getContractError.ts

@@ -3,11 +3,9 @@ import type { BaseError } from '../../errors/index.js'
 import {
   AbiDecodingZeroDataError,
   ContractFunctionExecutionError,
-  EstimateGasExecutionError,
   RawContractError,
 } from '../../errors/index.js'
 import {
-  CallExecutionError,
   ContractFunctionRevertedError,
   ContractFunctionZeroDataError,
 } from '../../errors/contract.js'
@@ -36,11 +34,7 @@ export function getContractError(
   const { code, data, message, shortMessage } = (
     err instanceof RawContractError
       ? err
-      : !(err.cause && 'data' in (err.cause as BaseError)) &&
-        (err instanceof CallExecutionError ||
-          err instanceof EstimateGasExecutionError)
-      ? ((err.cause as BaseError)?.cause as BaseError)?.cause || {}
-      : err.cause || {}
+      : err.walk((err) => 'data' in (err as Error))
   ) as RawContractError
 
   let cause = err

package/src/utils/errors/getNodeError.ts

@@ -67,7 +67,7 @@ export function getNodeError(
   )
     return new ExecutionRevertedError({
       cause: err,
-      message: (err.cause as BaseError).details,
+      message: (err.cause as BaseError).details || err.details,
     })
   return new UnknownNodeError({
     cause: (err.cause as BaseError).cause as BaseError,

package/src/utils/index.ts

@@ -60,6 +60,13 @@ export {
 
 export { buildRequest } from './buildRequest.js'
 
+export {
+  ccipFetch,
+  offchainLookup,
+  offchainLookupAbiItem,
+  offchainLookupSignature,
+} from './ccip.js'
+
 export { defineChain, getChainContractAddress } from './chain.js'
 
 export {