NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #4258 most downloaded on npm
Ethereum Standard Library
Latest stable
1.8.14
Last release 9 days ago
11 Nov 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
16 years old
662 releases · first in 2011
Drag across the ruler to compare, or tap a release to open it.
### Patch Changes - #565 `20457a6` Thanks @jxom! - Fixed AbiEvent.decode and AbiEvent.encode for anonymous events: decode no longer expects a selector
#565 20457a6 Thanks @jxom! - Fixed AbiEvent.decode and AbiEvent.encode for anonymous events: decode no longer expects a selector topic and reads every topic as an indexed input, and encode no longer prepends the selector.
#571 4a029cf Thanks @gakonst! - Improved validation performance in Hex.assert, Value, TypedData, Siwe.isUri, and ABI overload resolution by reusing module-level regular expressions instead of recreating them on every call.
#571 4a029cf Thanks @gakonst! - Improved AbiItem.getSignatureHash and AbiItem.getSelector performance, along with the selector lookups in AbiItem.fromAbi, AbiFunction.decodeData, AbiEvent.decodeLog and AbiEvent.extractLogs, by caching signature hashes by normalized signature in a bounded cache that Caches.clear resets.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
### Patch Changes - #561 `f9e8a6e` Thanks @jxom! - Fixed AbiItem.fromAbi resolving indistinguishable overloads, such as bytes32 and bytes, uint256 and
#561 f9e8a6e Thanks @jxom! - Fixed AbiItem.fromAbi resolving indistinguishable overloads, such as bytes32 and bytes, uint256 and int256, or uint256[] and uint256[2], to the last match. It now throws AbiItem.AmbiguityError, and a selector selects the overload. An overload matches only an integer in its range or fixed bytes of its size.
#559 4f5a87a Thanks @jxom! - Fixed AbiParameters.decode accepting intN/uintN words outside the declared type's range and address words with non-zero padding; it now throws Hex.IntegerOutOfRangeError or Address.InvalidAddressError, matching Solidity's abi.decode.
#555 c18169b Thanks @jxom! - Deprecated KeyAuthorization isAdmin and updated account docs for TIP-1137, which removes admin access keys at T14 while keeping their wire encoding decodable.
#561 f9e8a6e Thanks @jxom! - Fixed TxEnvelopeEip1559.assert, TxEnvelopeEip4844.assert, TxEnvelopeEip7702.assert, and TxEnvelopeTempo.assert accepting a maxPriorityFeePerGas above a zero maxFeePerGas. Their deserialize functions now read an empty maxFeePerGas as zero when a tip is set, so such a transaction throws TransactionEnvelope.TipAboveFeeCapError. Zero fees now show in the error messages.
#561 f9e8a6e Thanks @jxom! - Fixed TypedData.assert and TypedData.validate accepting invalid struct names, such as uint7, bytes32 or Foo.Bar, and invalid field types, such as uint, uint7, bytes0 or an undefined struct, including in structs referenced only as array elements. They now throw TypedData.InvalidStructTypeError and the new TypedData.InvalidTypeError. TypedData.encodeType now includes struct names that contain `# ox.
### Patch Changes - #540 `1c17b2d` Thanks @jxom! - Typed the eth_fillTransaction result tx as a OneOf union so common fields like gas are readable as
### Patch Changes - #531 `b1b39ac` Thanks @jxom! - Fixed Authorization.fromRpc, Authorization.fromTuple, Authorization.toTuple, and Authorization.toRp
#531 b1b39ac Thanks @jxom! - Fixed Authorization.fromRpc, Authorization.fromTuple, Authorization.toTuple, and Authorization.toRpc rejecting or rewriting an EIP-7702 authorization yParity above 1, which made valid transactions fail to deserialize, serialize, or hash.
#531 b1b39ac Thanks @jxom! - Fixed Siwe.createMessage rejecting domains with a punycode (internationalized) top-level domain, such as example.xn--p1ai, and accepting top-level domain labels longer than 63 characters.
#535 94aded3 Thanks @jxom! - ox/tempo: Derived configurable account addresses from the initial config hash instead of a recovery factory (tempoxyz/tempo#8595), so AccountConfig.getAddress no longer takes a factory option.
### Patch Changes - #527 `b0588e1` Thanks @jxom! - Fixed AbiEvent.assertArgs not matching indexed string values, non-indexed string and bytes values,
#527 b0588e1 Thanks @jxom! - Fixed AbiEvent.assertArgs not matching indexed string values, non-indexed string and bytes values, or bytes values in a different hex case.
#527 b0588e1 Thanks @jxom! - Fixed AbiItem.fromAbi overload resolution for arrays with a 0 in the element size (e.g. uint160[]) or the wrong fixed length, tuple objects with reordered keys, and ambiguous address[] overloads.
#527 b0588e1 Thanks @jxom! - Added an even option to Hex.assert and Hex.validate that rejects hex values with an odd number of hexadecimal characters.
#527 b0588e1 Thanks @jxom! - Fixed AbiItem.getSignature (and AbiFunction.getSelector, AbiEvent.getSelector) dropping the first parameter when a space directly follows an opening parenthesis.
#527 b0588e1 Thanks @jxom! - Fixed RpcTransport.fromHttp not applying timeout to reading the response body, or when fetchOptions.signal was set.
#527 b0588e1 Thanks @jxom! - Fixed TypedData.extractEip712DomainTypes (and TypedData.encode, TypedData.getSignPayload, TypedData.hashDomain) dropping an empty version from the EIP712Domain type.
{ keyType: 'multisig', multisigSimulation: spec }
#519 e9b66c2 Thanks @jxom! - Added AccountConfig.fromUpgrade for deriving the version-one config an account installs when it migrates in place with upgradeAccount (TIP-1113).
#519 e9b66c2 Thanks @jxom! - Fixed AccountSimulation.toRpc passing through empty and 3-byte keyData, which the Tempo node rejects, by shimming them into a 2-byte length hint.
#519 e9b66c2 Thanks @jxom! - Renamed the Tempo configurable account hash domains from tempo:multisig:* to tempo:configurable-account:* to match Tempo main (tempoxyz/tempo#8502), which changes every AccountConfig.getAddress, AccountConfig.getCommitment, and AccountConfig.getSignPayload result.
#519 e9b66c2 Thanks @jxom! - Renamed the configurable account RPC key type from multisig to configurableAccount and TransactionRequest.multisigSimulation to configurableAccountSimulation, and added the optional AccountSimulation grant signer, to match the Tempo node.
- { keyType: 'multisig', multisigSimulation: spec }
+ { keyType: 'configurableAccount', configurableAccountSimulation: spec }
#519 e9b66c2 Thanks @jxom! - Stopped requiring an account binding on configurable account key grants, so KeyAuthorization accepts every grant the Tempo node accepts, and deprecated KeyAuthorization.MissingAccountError, which is no longer thrown.
import { MultisigConfig, MultisigOperation, MultisigSimulation } from 'ox/tempo'
#509 3549b12 Thanks @jxom! - Renamed the Tempo multisig account APIs to configurable accounts (TIP-1107), including the account_ relay RPC namespace, raised AccountConfig.maxThreshold to 255 per TIP-1114, and added AccountConfig.update for deriving the next config after an owner update.
- import { MultisigConfig, MultisigOperation, MultisigSimulation } from 'ox/tempo'
+ import { AccountConfig, AccountOperation, AccountSimulation } from 'ox/tempo'
- const initialConfig = MultisigConfig.from({ owners, threshold: 2 })
+ const initialConfig = AccountConfig.from({ owners, threshold: 2 })
- SignatureEnvelope.sortMultisigApprovals({ account, config, payload, signatures })
+ SignatureEnvelope.sortApprovals({ account, config, payload, signatures })
- if (signature.type === 'multisig') signature satisfies SignatureEnvelope.Multisig
+ if (signature.type === 'configurable') signature satisfies SignatureEnvelope.Configurable
- KeyAuthorization.from({ account, address, chainId, type: 'multisig' })
+ KeyAuthorization.from({ account, address, chainId, type: 'configurable' })
- TransactionRequest.toRpc({ from, keyType: 'multisig', multisigSimulation })
+ TransactionRequest.toRpc({ accountSimulation, from, keyType: 'configurable' })
- RpcSchema.from<RpcSchemaTempo.Multisig>() // multisig_getConfig, multisig_getOperation, ...
+ RpcSchema.from<RpcSchemaTempo.Account>() // account_getConfig, account_getOperation, ...
### Patch Changes - #510 `5b2a75b` Thanks @jxom! - Fixed Transaction.toRpc (in ox/tempo) dropping nonceKey, so serialized Tempo transactions keep thei
### Patch Changes - #498 `6ba2bf6` Thanks @decofe! - Added the TIP-1006 burnAt role (BURN_AT_ROLE) to TokenRole. - #507 `c0c5bd2` Thanks @jxom! - Fixe
`ts const nonce = await provider.request({ method: "eth_getTransactionCount", params: [address, "pending", ["0x1", "0x2"]], }); `
```ts import { TxEnvelopeEip8141 } from "ox";
#490 e5056e3 Thanks @jxom! - Added EIP-8250 keyed frame nonces with shared nonce sequences while preserving the original EIP-8141 encoding when nonceKeys is omitted.
import { TxEnvelopeEip8141 } from "ox";
const envelope = TxEnvelopeEip8141.from({
chainId: 1,
sender: "0x1111111111111111111111111111111111111111",
frames: [{ mode: "sender", executionGas: 50_000n }],
nonceKeys: [1n, 2n],
nonce: 0n,
});
### Patch Changes - #483 `e5ea673` Thanks @jxom! - Fixed empty protocol signature placeholders in frame signature validation, encoding, and transactio
```ts import { FrameSignature, Signature } from "ox";
#475 e0999aa Thanks @jxom! - Aligned frame RPC quantities, signature placeholders, and receipt gas totals with the execution API definitions.
#472 1e2fb85 Thanks @jxom! - Added hex signature support for secp256k1 and P256 frame signature entries.
import { FrameSignature, Signature } from "ox";
declare const signature: Signature.Signature;
FrameSignature.from({
scheme: "secp256k1",
signature: Signature.toHex(signature),
});
`42381cf` Thanks @jxom! - Renamed Frame.gas to Frame.executionGas.
`ts Frame.from({ to: recipient }); `
### Patch Changes - #460 `4c9ef11` Thanks @jxom! - Added Frame Transactions
### Patch Changes - #450 `a1b636c` Thanks @jxom! - Updated Tempo multisig accounts to versioned configurations, factory-derived addresses, primitive a
### Patch Changes - #430 `1c78a92` Thanks @jxom! - Updated Tempo multisig account derivation to use the canonical CREATE2 recovery address.
### Patch Changes - #427 `7cc9524` Thanks @jxom! - Aligned Tempo multisig simulation requests and RPC signatures with T12's encoded wire formats.
`ts const authorization = MultisigOperation.serializeKeyAuthorization( keyAuthorization, { account, approvals: selection.selectedApprovals, config, },
#424 c26d366 Thanks @jxom! - Added MultisigOperation.serializeKeyAuthorization for attaching selected owner approvals to a key authorization.
const authorization = MultisigOperation.serializeKeyAuthorization(
keyAuthorization,
{
account,
approvals: selection.selectedApprovals,
config,
},
);
#421 50bf1fe Thanks @jxom! - Added multisig configuration lookup to the Tempo RPC schema.
### Patch Changes - #417 `1335956` Thanks @jxom! - Migrated multisig operations to configuration witnesses.
### Patch Changes - #415 `e4ce887` Thanks @jxom! - Updated Tempo multisig configuration witnesses, simulation requests, RPC conversion, approval limit
`ts const config = MultisigConfig.from({ owners, threshold: 2, version: 1, }); `
```ts import { MultisigOperation } from "ox/tempo";
#409 8f25490 Thanks @jxom! - Added multisig operation hashing, approval selection, and transaction serialization helpers.
import { MultisigOperation } from "ox/tempo";
const selection = await MultisigOperation.selectApprovals(options);
const transaction = MultisigOperation.serializeTransaction(operation, {
approvals: selection.selectedApprovals,
});
### Patch Changes - #404 `2398cf2` Thanks @jxom! - Added MultisigOperation types, validation, and JSON-RPC conversion utilities.
### Patch Changes - #402 `8675963` Thanks @jxom! - Reduced CommonJS bundles that import P256 or Secp256k1.
### Patch Changes - #396 `f2d4427` Thanks @jxom! - Added seed and mnemonic derivation for P256, Secp256k1, Ed25519, and AES-GCM keys. - #401 `efc1d67`
```ts import { MultisigConfig } from "ox/tempo";
```ts import { ZoneId } from "ox/tempo";
```ts import { EarnShares } from "ox/tempo";
#310 d882d95 Thanks @jxom! - Added EarnShares to ox/tempo: raw EarnToken/venue-share conversions at the vault anchor rate, the dilution-correct fee-share formula, and a minimumOutput slippage floor.
import { EarnShares } from "ox/tempo";
const tokens = EarnShares.toTokens({ engineShares: 3n, supply: 2n }, 7n);
const minimumShares = EarnShares.minimumOutput(1_000_000n, 50n);
### Patch Changes - #306 `e13c054` Thanks @jxom! - viem/tempo: Updated multisig implementation. - #286 `56f299f` Thanks @jxom! - Added eth_getRawTrans
#306 e13c054 Thanks @jxom! - viem/tempo: Updated multisig implementation.
#286 56f299f Thanks @jxom! - Added eth_getRawTransactionByHash to RpcSchema.Eth.
#291 5ebb88d Thanks @jxom! - Fixed KeyAuthorization.fromRpc return type mismatch under TypeScript configs without exactOptionalPropertyTypes.
#284 c86f635 Thanks @jxom! - Fixed AbiParameters.encode and AbiParameters.decode handling of zero-width types (zero-length fixed arrays and empty tuples).
const id = MultisigConfig.toId(genesisConfig)
#281 da3309e Thanks @jxom! - Breaking (ox/tempo): Removed the TIP-1061 multisig config_id concept to match the updated Tempo reference implementation: multisig account addresses now derive directly from the initial config, owner approval digests bind only account, the signature wire format is 0x05 || rlp([account, signatures, init?]), MultisigConfig.maxOwners is now 255 with u8 weights, and owner approvals may be nested multisig signatures.
- const id = MultisigConfig.toId(genesisConfig)
- const account = MultisigConfig.getAddress({ genesisConfigId: id })
+ const account = MultisigConfig.getAddress(genesisConfig)
- MultisigConfig.getSignPayload({ payload, account, genesisConfigId })
+ MultisigConfig.getSignPayload({ payload, account })
- SignatureEnvelope.from({ account, genesisConfigId, signatures })
+ SignatureEnvelope.from({ account, signatures })
### Patch Changes - #268 `ed93945` Thanks @jxom! - viem/tempo: Added genesisConfig shorthand to TIP-1061 multisig helpers and renamed configId → genes
### Patch Changes - #265 `f5328d2` Thanks @jxom! - viem/tempo: Added support for TIP-1061 native multisig accounts.
### Patch Changes - #263 `451a442` Thanks @jxom! - ox/tempo: Added the ReceivePolicyReceipt module for encoding/decoding TIP-1028 receive-policy claim
### Patch Changes - #262 `b1ac8c8` Thanks @jxom! - ox/tempo: Added support for TIP-1049 (admin access keys) via optional isAdmin and account fields on
#262 b1ac8c8 Thanks @jxom! - ox/tempo: Added support for TIP-1049 (admin access keys) via optional isAdmin and account fields on KeyAuthorization that bind into the signing hash.
#260 581ccee Thanks @jxom! - ox/tempo: Added support for TIP-1053 (witnesses in key authorizations) via an optional 32-byte witness field on KeyAuthorization that is included in the signing hash.
### Patch Changes - #256 `ad7610b` Thanks @jxom! - Renamed ChannelDescriptor.from to Channel.from, made Channel.Channel the descriptor type, and chang
### Patch Changes - #254 `d837628` Thanks @jxom! - Added ChannelDescriptor.from for normalizing TIP-20 channel reserve descriptors.
### Patch Changes - #252 `19cd833` Thanks @jxom! - Added TIP-20 channel reserve constants, channel id computation, and voucher signing helpers.
### Patch Changes - #227 `ffa64c0` Thanks @Genmin! - Fixed Secp256k1.verify narrowing signature branches before address recovery.
### Patch Changes - #246 `32cf459` Thanks @0xrusowsky! - Added TxEnvelopeTempo.encodeForSigning to expose the raw Tempo sender-signing preimage bytes.
### Patch Changes - #225 `7203ffc` Thanks @jxom! - Fixed webpack compatibility for VirtualMaster by making the node:worker_threads import specifier no
`3f6682d` Thanks @jxom! - Embedded WASM keccak256 salt miner for VirtualMaster.mineSaltAsync. Added platform-agnostic worker pool supporting Node.js,
### Patch Changes - #221 `3b84126` Thanks @tmm! - Added TIP-1022 virtual address utilities to ox/tempo, including VirtualAddress helpers for formattin
### Patch Changes - #220 `da7a62c` Thanks @Zygimantass! - Added Tempo zones support - #219 `a934992` Thanks @jxom! - Added feePayer to TransactionRequ
#220 da7a62c Thanks @Zygimantass! - Added Tempo zones support
#219 a934992 Thanks @jxom! - Added feePayer to TransactionRequest in ox/tempo.
#217 5e2ae4d Thanks @jxom! - Fixed TransactionRequest.fromRpc in ox/tempo. TransactionRequest.toRpc now folds top-level to/data/value into calls when calls is not provided.
`3ca1d56` Thanks @jxom! - Added TransactionRequest.fromRpc to ox/tempo.
`d073091` Thanks @jxom! - Fixed TransactionRequest.blobVersionedHashes to include | undefined for exactOptionalPropertyTypes compatibility.
`14137f7` Thanks @jxom! - Added RpcSchema.ToViem and RpcSchema.FromViem type utilities for converting between Ox and Viem RPC schema formats. Added te
`68f8fa0` Thanks @jxom! - viem/tempo: Renamed contractAddress to address on KeyAuthorization.Scope. Added support for human-readable ABI signatures in
### Patch Changes - #208 `30537f8` Thanks @dgca! - Added serviceCodes field to ERC-8021 Attribution schema. - #211 `9d0d676` Thanks @jxom! - viem/temp
### Patch Changes - #209 `52d985e` Thanks @jxom! - Fixed Credential.serialize to extract authenticatorData from the CBOR-encoded attestationObject whe
### Patch Changes - #204 `9aec6a9` Thanks @jxom! - Added Ed25519.toX25519PublicKey and Ed25519.toX25519PrivateKey for converting Ed25519 keys to X2551
### Patch Changes - #201 `ea94ea6` Thanks @decofe! - Fixed KeyAuthorization.fromRpc to preserve undefined expiry instead of defaulting to 0.
`0d0575e` Thanks @jxom! - Added ERC-8021 Schema 2 (CBOR-encoded) attribution support to the Attribution module.
`8d51883` Thanks @jxom! - ox/tempo: Fixed output types.
### Patch Changes - #197 `28ac186` Thanks @jxom! - Fixed WebAuthn response serialization to fall back to getter methods (e.g. getAuthenticatorData())
28ac186 Thanks @jxom! - Fixed WebAuthn response serialization to fall back to getter methods (e.g. getAuthenticatorData()) when properties are not directly accessible on the response object. Some browsers and passkey providers (e.g. 1Password, Firefox) proxy the credential object, making property access return undefined even though the data is available via getter methods.`6dcde2c` Thanks @jxom! - Fixed type incompatibility between ox's CredentialCreationOptions/CredentialRequestOptions and the DOM's built-in types.
`0189572` Thanks @jxom! - ox/tempo: Fixed sender recovery for fee payer transactions.
`3f7b80c` Thanks @jxom! - Updated TempoAddress to new format.
`3dbb585` Thanks @jxom! - Fixed Registration.create and Authentication.sign throwing "Permission denied to access object" in Firefox with the 1Passwor
3dbb585 Thanks @jxom! - Fixed Registration.create and Authentication.sign throwing "Permission denied to access object" in Firefox with the 1Password extension. Replaced .bind() defaults on navigator.credentials.create/.get with arrow functions, eagerly read credential response properties (attestationObject, clientDataJSON, authenticatorData, signature, id) before subsequent access is blocked by the cross-compartment proxy, and passed the already-read attestationObject to parseCredentialPublicKey so the 1Password fallback path no longer re-accesses the proxy.One column per quarter.