viem 2.48.3 → 2.48.6

package/errors/utils.ts

@@ -3,4 +3,20 @@ import type { Address } from 'abitype'
 export type ErrorType<name extends string = 'Error'> = Error & { name: name }
 
 export const getContractAddress = (address: Address) => address
-export const getUrl = (url: string) => url
+
+/**
+ * Returns the URL with any embedded basic-auth credentials stripped, so
+ * error messages and logs don't leak secrets when an RPC URL like
+ * `https://user:pass@host` is used.
+ */
+export const getUrl = (url: string) => {
+  try {
+    const parsed = new URL(url)
+    if (!parsed.username && !parsed.password) return url
+    parsed.username = ''
+    parsed.password = ''
+    return parsed.toString()
+  } catch {
+    return url
+  }
+}

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.48.3'
+export const version = '2.48.6'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.48.3",
+  "version": "2.48.6",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -222,7 +222,7 @@
     "@scure/bip39": "1.6.0",
     "abitype": "1.2.3",
     "isows": "1.0.7",
-    "ox": "0.14.17",
+    "ox": "0.14.20",
     "ws": "8.18.3"
   },
   "license": "MIT",

package/tempo/Addresses.ts

@@ -2,6 +2,7 @@ export const accountImplementation =
   '0x7702c00000000000000000000000000000000000'
 export const accountKeychain = '0xaAAAaaAA00000000000000000000000000000000'
 export const accountRegistrar = '0x7702ac0000000000000000000000000000000000'
+export const addressRegistry = '0xfdc0000000000000000000000000000000000000'
 export const feeManager = '0xfeec000000000000000000000000000000000000'
 export const nonceManager = '0x4e4F4E4345000000000000000000000000000000'
 export const pathUsd = '0x20c0000000000000000000000000000000000000'

package/tempo/Decorator.ts

@@ -14,6 +14,7 @@ import * as rewardActions from './actions/reward.js'
 import * as simulateActions from './actions/simulate.js'
 import * as tokenActions from './actions/token.js'
 import * as validatorActions from './actions/validator.js'
+import * as virtualAddressActions from './actions/virtualAddress.js'
 import * as zoneActions from './actions/zone.js'
 
 export type Decorator<
@@ -264,7 +265,7 @@ export type Decorator<
      * import { tempoActions } from 'viem/tempo'
      *
      * const client = createClient({
-     *   chain: tempo({ feeToken: '0x20c...001' }),
+     *   chain: tempo.extend({ feeToken: '0x20c...001' }),
      *   transport: http(),
      * }).extend(tempoActions())
      *
@@ -3805,6 +3806,119 @@ export type Decorator<
       parameters: validatorActions.updateSync.Parameters<chain, account>,
     ) => Promise<validatorActions.updateSync.ReturnValue>
   }
+  virtualAddress: {
+    /**
+     * Gets the registered master address for a given master ID.
+     *
+     * @example
+     * ```ts
+     * import { createClient, http } from 'viem'
+     * import { tempo } from 'viem/chains'
+     * import { tempoActions } from 'viem/tempo'
+     *
+     * const client = createClient({
+     *   chain: tempo,
+     *   transport: http(),
+     * }).extend(tempoActions())
+     *
+     * const master = await client.virtualAddress.getMasterAddress({
+     *   masterId: '0x58e21090',
+     * })
+     * ```
+     *
+     * @param parameters - Parameters.
+     * @returns The master address, or null if unregistered.
+     */
+    getMasterAddress: (
+      parameters: virtualAddressActions.getMasterAddress.Parameters,
+    ) => Promise<virtualAddressActions.getMasterAddress.ReturnValue>
+    /**
+     * Registers the caller as a virtual address master.
+     *
+     * @example
+     * ```ts
+     * import { createClient, http } from 'viem'
+     * import { privateKeyToAccount } from 'viem/accounts'
+     * import { tempo } from 'viem/chains'
+     * import { tempoActions } from 'viem/tempo'
+     *
+     * const client = createClient({
+     *   account: privateKeyToAccount('0x...'),
+     *   chain: tempo,
+     *   transport: http(),
+     * }).extend(tempoActions())
+     *
+     * const hash = await client.virtualAddress.registerMaster({
+     *   salt: '0x...',
+     * })
+     * ```
+     *
+     * @param parameters - Parameters.
+     * @returns The transaction hash.
+     */
+    registerMaster: (
+      parameters: virtualAddressActions.registerMaster.Parameters<
+        chain,
+        account
+      >,
+    ) => Promise<virtualAddressActions.registerMaster.ReturnValue>
+    /**
+     * Registers the caller as a virtual address master and waits for confirmation.
+     *
+     * @example
+     * ```ts
+     * import { createClient, http } from 'viem'
+     * import { privateKeyToAccount } from 'viem/accounts'
+     * import { tempo } from 'viem/chains'
+     * import { tempoActions } from 'viem/tempo'
+     *
+     * const client = createClient({
+     *   account: privateKeyToAccount('0x...'),
+     *   chain: tempo,
+     *   transport: http(),
+     * }).extend(tempoActions())
+     *
+     * const { receipt, masterId, masterAddress } =
+     *   await client.virtualAddress.registerMasterSync({
+     *     salt: '0x...',
+     *   })
+     * ```
+     *
+     * @param parameters - Parameters.
+     * @returns The transaction receipt and event data.
+     */
+    registerMasterSync: (
+      parameters: virtualAddressActions.registerMasterSync.Parameters<
+        chain,
+        account
+      >,
+    ) => Promise<virtualAddressActions.registerMasterSync.ReturnValue>
+    /**
+     * Resolves an address to its effective recipient.
+     *
+     * @example
+     * ```ts
+     * import { createClient, http } from 'viem'
+     * import { tempo } from 'viem/chains'
+     * import { tempoActions } from 'viem/tempo'
+     *
+     * const client = createClient({
+     *   chain: tempo,
+     *   transport: http(),
+     * }).extend(tempoActions())
+     *
+     * const recipient = await client.virtualAddress.resolve({
+     *   address: '0x58e21090fdfdfdfdfdfdfdfdfdfd010203040506',
+     * })
+     * ```
+     *
+     * @param parameters - Parameters.
+     * @returns The resolved address, or null if virtual and unregistered.
+     */
+    resolve: (
+      parameters: virtualAddressActions.resolve.Parameters,
+    ) => Promise<virtualAddressActions.resolve.ReturnValue>
+  }
   zone: {
     /**
      * Deposits tokens into a zone.
@@ -4361,6 +4475,16 @@ export function decorator() {
         updateSync: (parameters) =>
           validatorActions.updateSync(client, parameters),
       },
+      virtualAddress: {
+        getMasterAddress: (parameters) =>
+          virtualAddressActions.getMasterAddress(client, parameters),
+        registerMaster: (parameters) =>
+          virtualAddressActions.registerMaster(client, parameters),
+        registerMasterSync: (parameters) =>
+          virtualAddressActions.registerMasterSync(client, parameters),
+        resolve: (parameters) =>
+          virtualAddressActions.resolve(client, parameters),
+      },
       zone: {
         deposit: (parameters) => zoneActions.deposit(client, parameters),
         depositSync: (parameters) =>

package/tempo/Formatters.ts

@@ -27,6 +27,11 @@ export function formatTransaction(
 ): Transaction<bigint, number, boolean> {
   if (!isTempo(transaction)) return viem_formatTransaction(transaction as never)
 
+  // TODO: upstream `blockTimestamp` formatting into `ox`.
+  const blockTimestamp =
+    transaction.blockTimestamp == null
+      ? undefined
+      : BigInt(transaction.blockTimestamp)
   const {
     feePayerSignature,
     gasPrice: _,
@@ -37,6 +42,7 @@ export function formatTransaction(
   return {
     ...tx,
     accessList: tx.accessList!,
+    ...(typeof blockTimestamp !== 'undefined' && { blockTimestamp }),
     feePayerSignature: feePayerSignature
       ? {
           r: Hex.fromNumber(feePayerSignature.r, { size: 32 }),

package/tempo/actions/accessKey.ts

@@ -55,7 +55,7 @@ const spendPolicies = {
  * const account = Account.from({ privateKey: '0x...' })
  * const client = createClient({
  *   account,
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' }),
  *   transport: http(),
  * })
  *
@@ -169,7 +169,7 @@ export namespace authorize {
  * const account = Account.from({ privateKey: '0x...' })
  * const client = createClient({
  *   account,
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' }),
  *   transport: http(),
  * })
  *
@@ -240,7 +240,7 @@ export namespace authorizeSync {
  *
  * const client = createClient({
  *   account: privateKeyToAccount('0x...'),
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' }),
  *   transport: http(),
  * })
  *
@@ -312,7 +312,7 @@ export namespace revoke {
    * import { Actions } from 'viem/tempo'
    *
    * const client = createClient({
-   *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+   *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' }),
    *   transport: http(),
    * }).extend(walletActions)
    *
@@ -360,7 +360,7 @@ export namespace revoke {
  *
  * const client = createClient({
  *   account: privateKeyToAccount('0x...'),
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' }),
  *   transport: http(),
  * })
  *
@@ -426,7 +426,7 @@ export namespace revokeSync {
  *
  * const client = createClient({
  *   account: privateKeyToAccount('0x...'),
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' }),
  *   transport: http(),
  * })
  *
@@ -504,7 +504,7 @@ export namespace updateLimit {
    * import { Actions } from 'viem/tempo'
    *
    * const client = createClient({
-   *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+   *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' }),
    *   transport: http(),
    * }).extend(walletActions)
    *
@@ -556,7 +556,7 @@ export namespace updateLimit {
  *
  * const client = createClient({
  *   account: privateKeyToAccount('0x...'),
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' }),
  *   transport: http(),
  * })
  *
@@ -628,7 +628,7 @@ export namespace updateLimitSync {
  * import { Actions } from 'viem/tempo'
  *
  * const client = createClient({
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' }),
  *   transport: http(),
  * })
  *
@@ -719,20 +719,22 @@ export namespace getMetadata {
  * import { Actions } from 'viem/tempo'
  *
  * const client = createClient({
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' }),
  *   transport: http(),
  * })
  *
- * const remaining = await Actions.accessKey.getRemainingLimit(client, {
+ * const { remaining, periodEnd } = await Actions.accessKey.getRemainingLimit(client, {
  *   account: '0x...',
  *   accessKey: '0x...',
  *   token: '0x...',
  * })
+ *
+ * console.log(remaining, periodEnd)
  * ```
  *
  * @param client - Client.
  * @param parameters - Parameters.
- * @returns The remaining spending amount.
+ * @returns The remaining spending amount and period end timestamp.
  */
 export async function getRemainingLimit<
   chain extends Chain | undefined,

package/tempo/actions/amm.ts

@@ -34,7 +34,7 @@ import { defineCall } from '../internal/utils.js'
  * import { Actions } from 'viem/tempo'
  *
  * const client = createClient({
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
  *   transport: http(),
  * })
  *
@@ -124,7 +124,7 @@ export namespace getPool {
  * import { Actions } from 'viem/tempo'
  *
  * const client = createClient({
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
  *   transport: http(),
  * })
  *
@@ -224,7 +224,7 @@ export namespace getLiquidityBalance {
  *
  * const client = createClient({
  *   account: privateKeyToAccount('0x...'),
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
  *   transport: http(),
  * })
  *
@@ -307,7 +307,7 @@ export namespace rebalanceSwap {
    * import { Actions } from 'viem/tempo'
    *
    * const client = createClient({
-   *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+   *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
    *   transport: http(),
    * }).extend(walletActions)
    *
@@ -377,7 +377,7 @@ export namespace rebalanceSwap {
  *
  * const client = createClient({
  *   account: privateKeyToAccount('0x...'),
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
  *   transport: http(),
  * })
  *
@@ -444,7 +444,7 @@ export namespace rebalanceSwapSync {
  *
  * const client = createClient({
  *   account: privateKeyToAccount('0x...'),
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
  *   transport: http(),
  * })
  *
@@ -533,7 +533,7 @@ export namespace mint {
    * import { Actions } from 'viem/tempo'
    *
    * const client = createClient({
-   *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+   *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
    *   transport: http(),
    * }).extend(walletActions)
    *
@@ -608,7 +608,7 @@ export namespace mint {
  *
  * const client = createClient({
  *   account: privateKeyToAccount('0x...'),
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
  *   transport: http(),
  * })
  *
@@ -675,7 +675,7 @@ export namespace mintSync {
  *
  * const client = createClient({
  *   account: privateKeyToAccount('0x...'),
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
  *   transport: http(),
  * })
  *
@@ -753,7 +753,7 @@ export namespace burn {
    * import { Actions } from 'viem/tempo'
    *
    * const client = createClient({
-   *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+   *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
    *   transport: http(),
    * }).extend(walletActions)
    *
@@ -823,7 +823,7 @@ export namespace burn {
  *
  * const client = createClient({
  *   account: privateKeyToAccount('0x...'),
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
  *   transport: http(),
  * })
  *
@@ -888,7 +888,7 @@ export namespace burnSync {
  * import { Actions } from 'viem/tempo'
  *
  * const client = createClient({
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
  *   transport: http(),
  * })
  *
@@ -968,7 +968,7 @@ export declare namespace watchRebalanceSwap {
  * import { Actions } from 'viem/tempo'
  *
  * const client = createClient({
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
  *   transport: http(),
  * })
  *
@@ -1051,7 +1051,7 @@ export declare namespace watchMint {
  * import { Actions } from 'viem/tempo'
  *
  * const client = createClient({
- *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
  *   transport: http(),
  * })
  *