viem 2.50.3 → 2.51.0

package/tempo/actions/index.ts

@@ -1,6 +1,7 @@
 // biome-ignore lint/performance/noBarrelFile: _
 export * as accessKey from './accessKey.js'
 export * as amm from './amm.js'
+export * as channel from './channel.js'
 export * as dex from './dex.js'
 export * as faucet from './faucet.js'
 export * as fee from './fee.js'

package/tempo/actions/token.ts

@@ -879,6 +879,7 @@ export namespace changeTransferPolicySync {
  *   name: 'My Token',
  *   symbol: 'MTK',
  *   currency: 'USD',
+ *   logoURI: 'https://example.com/token.svg',
  * })
  * ```
  *
@@ -913,6 +914,8 @@ export namespace create {
     currency: string
     /** Token name. */
     name: string
+    /** Logo URI. Requires a T5-enabled Tempo chain. */
+    logoURI?: string | undefined
     /** Quote token. */
     quoteToken?: TokenId.TokenIdOrAddress | undefined
     /** Unique salt. @default Hex.random(32) */
@@ -983,6 +986,7 @@ export namespace create {
    *       name: 'My Token',
    *       symbol: 'MTK',
    *       currency: 'USD',
+   *       logoURI: 'https://example.com/token.svg',
    *       admin: '0xfeed...fede',
    *     }),
    *   ]
@@ -997,6 +1001,7 @@ export namespace create {
       name,
       symbol,
       currency,
+      logoURI,
       quoteToken = Addresses.pathUsd,
       admin,
       salt = Hex.random(32),
@@ -1004,14 +1009,25 @@ export namespace create {
     return defineCall({
       address: Addresses.tip20Factory,
       abi: Abis.tip20Factory,
-      args: [
-        name,
-        symbol,
-        currency,
-        TokenId.toAddress(quoteToken),
-        admin,
-        salt,
-      ],
+      args:
+        typeof logoURI === 'string'
+          ? [
+              name,
+              symbol,
+              currency,
+              TokenId.toAddress(quoteToken),
+              admin,
+              salt,
+              logoURI,
+            ]
+          : [
+              name,
+              symbol,
+              currency,
+              TokenId.toAddress(quoteToken),
+              admin,
+              salt,
+            ],
       functionName: 'createToken',
     })
   }
@@ -1054,6 +1070,7 @@ export namespace create {
  *   name: 'My Token',
  *   symbol: 'MTK',
  *   currency: 'USD',
+ *   logoURI: 'https://example.com/token.svg',
  * })
  * ```
  *
@@ -1264,7 +1281,7 @@ export namespace getBalance {
 }
 
 /**
- * Gets TIP20 token metadata including name, symbol, currency, decimals, and total supply.
+ * Gets TIP20 token metadata including name, symbol, logo URI, currency, decimals, and total supply.
  *
  * @example
  * ```ts
@@ -1310,6 +1327,11 @@ export async function getMetadata<chain extends Chain | undefined>(
           abi,
           functionName: 'decimals',
         },
+        {
+          address,
+          abi,
+          functionName: 'logoURI',
+        },
         {
           address,
           abi,
@@ -1326,14 +1348,15 @@ export async function getMetadata<chain extends Chain | undefined>(
           functionName: 'totalSupply',
         },
       ] as const,
-      allowFailure: false,
+      allowFailure: true,
       deployless: true,
-    }).then(([currency, decimals, name, symbol, totalSupply]) => ({
-      name,
-      symbol,
-      currency,
-      decimals,
-      totalSupply,
+    }).then(([currency, decimals, logoURI, name, symbol, totalSupply]) => ({
+      name: unwrapMulticallResult(name),
+      symbol: unwrapMulticallResult(symbol),
+      currency: unwrapMulticallResult(currency),
+      decimals: unwrapMulticallResult(decimals),
+      logoURI: unwrapMulticallResult(logoURI, ''),
+      totalSupply: unwrapMulticallResult(totalSupply),
     }))
 
   return multicall(client, {
@@ -1349,6 +1372,11 @@ export async function getMetadata<chain extends Chain | undefined>(
         abi,
         functionName: 'decimals',
       },
+      {
+        address,
+        abi,
+        functionName: 'logoURI',
+      },
       {
         address,
         abi,
@@ -1385,12 +1413,13 @@ export async function getMetadata<chain extends Chain | undefined>(
         functionName: 'transferPolicyId',
       },
     ] as const,
-    allowFailure: false,
+    allowFailure: true,
     deployless: true,
   }).then(
     ([
       currency,
       decimals,
+      logoURI,
       quoteToken,
       name,
       paused,
@@ -1399,19 +1428,44 @@ export async function getMetadata<chain extends Chain | undefined>(
       totalSupply,
       transferPolicyId,
     ]) => ({
-      name,
-      symbol,
-      currency,
-      decimals,
-      quoteToken,
-      totalSupply,
-      paused,
-      supplyCap,
-      transferPolicyId,
+      name: unwrapMulticallResult(name),
+      symbol: unwrapMulticallResult(symbol),
+      currency: unwrapMulticallResult(currency),
+      decimals: unwrapMulticallResult(decimals),
+      logoURI: unwrapMulticallResult(logoURI, ''),
+      quoteToken: unwrapMulticallResult(quoteToken),
+      totalSupply: unwrapMulticallResult(totalSupply),
+      paused: unwrapMulticallResult(paused),
+      supplyCap: unwrapMulticallResult(supplyCap),
+      transferPolicyId: unwrapMulticallResult(transferPolicyId),
     }),
   )
 }
 
+function unwrapMulticallResult<result>(
+  response:
+    | { result: result; status: 'success' }
+    | { error: unknown; status: 'failure' },
+): result
+function unwrapMulticallResult<result>(
+  response:
+    | { result: result; status: 'success' }
+    | { error: unknown; status: 'failure' },
+  fallback: result,
+): result
+function unwrapMulticallResult<result>(
+  response:
+    | { result: result; status: 'success' }
+    | { error: unknown; status: 'failure' },
+  ...fallback: [] | [result]
+) {
+  if (response.status === 'failure') {
+    if (fallback.length > 0) return fallback[0]
+    throw response.error
+  }
+  return response.result
+}
+
 export declare namespace getMetadata {
   export type Parameters = {
     /** Address or ID of the TIP20 token. */
@@ -1427,6 +1481,11 @@ export declare namespace getMetadata {
      * Decimals of the token.
      */
     decimals: number
+    /**
+     * Logo URI of the token. Returns an empty string if unset or unsupported
+     * by the active Tempo hardfork.
+     */
+    logoURI: string
     /**
      * Quote token.
      *

package/tempo/index.ts

@@ -12,6 +12,7 @@ export type {
   TxEnvelopeTempo as z_TxEnvelopeTempo,
 } from 'ox/tempo'
 export {
+  Channel,
   Period,
   TempoAddress,
   Tick,

package/types/eip1193.ts

@@ -706,6 +706,7 @@ export type PublicRpcSchema = [
         ]
     ReturnType: {
       accessList: AccessList
+      error?: string | undefined
       gasUsed: Quantity
     }
   },
@@ -867,6 +868,18 @@ export type PublicRpcSchema = [
     ]
     ReturnType: Block | null
   },
+  /**
+   * @description Returns the receipts of a block specified by block number, block tag, or block hash
+   * @link https://ethereum.github.io/execution-apis/api/methods/eth_getBlockReceipts/
+   * @example
+   * provider.request({ method: 'eth_getBlockReceipts', params: ['latest'] })
+   * // => [{ ... }, { ... }]
+   */
+  {
+    Method: 'eth_getBlockReceipts'
+    Parameters: [block: BlockNumber | BlockTag | Hash]
+    ReturnType: TransactionReceipt[] | null
+  },
   /**
    * @description Returns the number of transactions in a block specified by block hash
    * @link https://eips.ethereum.org/EIPS/eip-1474

package/utils/formatters/transactionRequest.ts

@@ -11,7 +11,7 @@ import type {
   RpcTransactionRequest,
 } from '../../types/rpc.js'
 import type { TransactionRequest } from '../../types/transaction.js'
-import type { ExactPartial } from '../../types/utils.js'
+import type { ExactPartial, UnionOmit } from '../../types/utils.js'
 import { bytesToHex, numberToHex } from '../encoding/toHex.js'
 import { type DefineFormatterErrorType, defineFormatter } from './formatter.js'
 
@@ -23,6 +23,18 @@ export type FormattedTransactionRequest<
   TransactionRequest
 >
 
+export type ExtractFormattedTransactionRequest<
+  chain extends Chain | undefined,
+  request extends { type?: string | undefined },
+  ///
+  _transactionRequest = UnionOmit<FormattedTransactionRequest<chain>, 'from'>,
+  _transactionType = request['type'],
+> = _transactionRequest extends { type?: infer type | undefined }
+  ? Extract<_transactionType, type> extends never
+    ? never
+    : _transactionRequest
+  : never
+
 export const rpcTransactionType = {
   legacy: '0x0',
   eip2930: '0x1',

package/utils/index.ts

@@ -341,6 +341,7 @@ export {
 export {
   type DefineTransactionRequestErrorType,
   defineTransactionRequest,
+  type ExtractFormattedTransactionRequest,
   type FormatTransactionRequestErrorType,
   type FormattedTransactionRequest,
   formatTransactionRequest,