ox 0.9.16 → 0.10.0

package/core/{TransactionEnvelopeEip2930.ts → TxEnvelopeEip2930.ts}

@@ -11,9 +11,9 @@ import type {
 } from './internal/types.js'
 import * as Rlp from './Rlp.js'
 import * as Signature from './Signature.js'
-import * as TransactionEnvelope from './TransactionEnvelope.js'
+import * as TransactionEnvelope from './TxEnvelope.js'
 
-export type TransactionEnvelopeEip2930<
+export type TxEnvelopeEip2930<
   signed extends boolean = boolean,
   bigintType = bigint,
   numberType = number,
@@ -27,7 +27,7 @@ export type TransactionEnvelopeEip2930<
   }
 >
 
-export type Rpc<signed extends boolean = boolean> = TransactionEnvelopeEip2930<
+export type Rpc<signed extends boolean = boolean> = TxEnvelopeEip2930<
   signed,
   Hex.Hex,
   Hex.Hex,
@@ -39,19 +39,19 @@ export type Serialized = `${SerializedType}${string}`
 export const serializedType = '0x01' as const
 export type SerializedType = typeof serializedType
 
-export type Signed = TransactionEnvelopeEip2930<true>
+export type Signed = TxEnvelopeEip2930<true>
 
 export const type = 'eip2930' as const
 export type Type = typeof type
 
 /**
- * Asserts a {@link ox#TransactionEnvelopeEip2930.TransactionEnvelopeEip2930} is valid.
+ * Asserts a {@link ox#TxEnvelopeEip2930.TxEnvelopeEip2930} is valid.
  *
  * @example
  * ```ts twoslash
- * import { TransactionEnvelopeEip2930, Value } from 'ox'
+ * import { TxEnvelopeEip2930, Value } from 'ox'
  *
- * TransactionEnvelopeEip2930.assert({
+ * TxEnvelopeEip2930.assert({
  *   gasPrice: 2n ** 256n - 1n + 1n,
  *   chainId: 1,
  *   to: '0x0000000000000000000000000000000000000000',
@@ -64,9 +64,7 @@ export type Type = typeof type
  *
  * @param envelope - The transaction envelope to assert.
  */
-export function assert(
-  envelope: PartialBy<TransactionEnvelopeEip2930, 'type'>,
-) {
+export function assert(envelope: PartialBy<TxEnvelopeEip2930, 'type'>) {
   const { chainId, gasPrice, to } = envelope
   if (chainId <= 0)
     throw new TransactionEnvelope.InvalidChainIdError({ chainId })
@@ -84,13 +82,13 @@ export declare namespace assert {
 }
 
 /**
- * Deserializes a {@link ox#TransactionEnvelopeEip2930.TransactionEnvelopeEip2930} from its serialized form.
+ * Deserializes a {@link ox#TxEnvelopeEip2930.TxEnvelopeEip2930} from its serialized form.
  *
  * @example
  * ```ts twoslash
- * import { TransactionEnvelopeEip2930 } from 'ox'
+ * import { TxEnvelopeEip2930 } from 'ox'
  *
- * const envelope = TransactionEnvelopeEip2930.deserialize('0x01ef0182031184773594008477359400809470997970c51812dc3a010c7d01b50e0d17dc79c8880de0b6b3a764000080c0')
+ * const envelope = TxEnvelopeEip2930.deserialize('0x01ef0182031184773594008477359400809470997970c51812dc3a010c7d01b50e0d17dc79c8880de0b6b3a764000080c0')
  * // @log: {
  * // @log:   type: 'eip2930',
  * // @log:   nonce: 785n,
@@ -104,9 +102,7 @@ export declare namespace assert {
  * @param serialized - The serialized transaction.
  * @returns Deserialized Transaction Envelope.
  */
-export function deserialize(
-  serialized: Serialized,
-): TransactionEnvelopeEip2930 {
+export function deserialize(serialized: Serialized): TxEnvelopeEip2930 {
   const transactionArray = Rlp.toHex(Hex.slice(serialized, 1))
 
   const [
@@ -149,7 +145,7 @@ export function deserialize(
   let transaction = {
     chainId: Number(chainId as Hex.Hex),
     type,
-  } as TransactionEnvelopeEip2930
+  } as TxEnvelopeEip2930
   if (Hex.validate(to) && to !== '0x') transaction.to = to
   if (Hex.validate(gas) && gas !== '0x') transaction.gas = BigInt(gas)
   if (Hex.validate(data) && data !== '0x') transaction.data = data
@@ -167,7 +163,7 @@ export function deserialize(
     transaction = {
       ...transaction,
       ...signature,
-    } as TransactionEnvelopeEip2930
+    } as TxEnvelopeEip2930
 
   assert(transaction)
 
@@ -184,9 +180,9 @@ export declare namespace deserialize {
  * @example
  * ```ts twoslash
  * // @noErrors
- * import { TransactionEnvelopeEip2930, Value } from 'ox'
+ * import { TxEnvelopeEip2930, Value } from 'ox'
  *
- * const envelope = TransactionEnvelopeEip2930.from({
+ * const envelope = TxEnvelopeEip2930.from({
  *   chainId: 1,
  *   accessList: [...],
  *   gasPrice: Value.fromGwei('10'),
@@ -201,9 +197,9 @@ export declare namespace deserialize {
  * It is possible to attach a `signature` to the transaction envelope.
  *
  * ```ts twoslash
- * import { Secp256k1, TransactionEnvelopeEip2930, Value } from 'ox'
+ * import { Secp256k1, TxEnvelopeEip2930, Value } from 'ox'
  *
- * const envelope = TransactionEnvelopeEip2930.from({
+ * const envelope = TxEnvelopeEip2930.from({
  *   chainId: 1,
  *   gasPrice: Value.fromGwei('10'),
  *   to: '0x0000000000000000000000000000000000000000',
@@ -211,11 +207,11 @@ export declare namespace deserialize {
  * })
  *
  * const signature = Secp256k1.sign({
- *   payload: TransactionEnvelopeEip2930.getSignPayload(envelope),
+ *   payload: TxEnvelopeEip2930.getSignPayload(envelope),
  *   privateKey: '0x...',
  * })
  *
- * const envelope_signed = TransactionEnvelopeEip2930.from(envelope, { // [!code focus]
+ * const envelope_signed = TxEnvelopeEip2930.from(envelope, { // [!code focus]
  *   signature, // [!code focus]
  * }) // [!code focus]
  * // @log: {
@@ -233,12 +229,12 @@ export declare namespace deserialize {
  * @example
  * ### From Serialized
  *
- * It is possible to instantiate an EIP-2930 Transaction Envelope from a {@link ox#TransactionEnvelopeEip2930.Serialized} value.
+ * It is possible to instantiate an EIP-2930 Transaction Envelope from a {@link ox#TxEnvelopeEip2930.Serialized} value.
  *
  * ```ts twoslash
- * import { TransactionEnvelopeEip2930 } from 'ox'
+ * import { TxEnvelopeEip2930 } from 'ox'
  *
- * const envelope = TransactionEnvelopeEip2930.from('0x01f858018203118502540be4008504a817c800809470997970c51812dc3a010c7d01b50e0d17dc79c8880de0b6b3a764000080c08477359400e1a001627c687261b0e7f8638af1112efa8a77e23656f6e7945275b19e9deed80261')
+ * const envelope = TxEnvelopeEip2930.from('0x01f858018203118502540be4008504a817c800809470997970c51812dc3a010c7d01b50e0d17dc79c8880de0b6b3a764000080c08477359400e1a001627c687261b0e7f8638af1112efa8a77e23656f6e7945275b19e9deed80261')
  * // @log: {
  * // @log:   chainId: 1,
  * // @log:   gasPrice: 10000000000n,
@@ -250,25 +246,20 @@ export declare namespace deserialize {
  *
  * @param envelope - The transaction object to convert.
  * @param options - Options.
- * @returns A {@link ox#TransactionEnvelopeEip2930.TransactionEnvelopeEip2930}
+ * @returns A {@link ox#TxEnvelopeEip2930.TxEnvelopeEip2930}
  */
 export function from<
-  const envelope extends
-    | UnionPartialBy<TransactionEnvelopeEip2930, 'type'>
-    | Serialized,
+  const envelope extends UnionPartialBy<TxEnvelopeEip2930, 'type'> | Serialized,
   const signature extends Signature.Signature | undefined = undefined,
 >(
-  envelope:
-    | envelope
-    | UnionPartialBy<TransactionEnvelopeEip2930, 'type'>
-    | Serialized,
+  envelope: envelope | UnionPartialBy<TxEnvelopeEip2930, 'type'> | Serialized,
   options: from.Options<signature> = {},
 ): from.ReturnType<envelope, signature> {
   const { signature } = options
 
   const envelope_ = (
     typeof envelope === 'string' ? deserialize(envelope) : envelope
-  ) as TransactionEnvelopeEip2930
+  ) as TxEnvelopeEip2930
 
   assert(envelope_)
 
@@ -286,13 +277,13 @@ export declare namespace from {
     }
 
   type ReturnType<
-    envelope extends
-      | UnionPartialBy<TransactionEnvelopeEip2930, 'type'>
-      | Hex.Hex = TransactionEnvelopeEip2930 | Hex.Hex,
+    envelope extends UnionPartialBy<TxEnvelopeEip2930, 'type'> | Hex.Hex =
+      | TxEnvelopeEip2930
+      | Hex.Hex,
     signature extends Signature.Signature | undefined = undefined,
   > = Compute<
     envelope extends Hex.Hex
-      ? TransactionEnvelopeEip2930
+      ? TxEnvelopeEip2930
       : Assign<
           envelope,
           (signature extends Signature.Signature ? Readonly<signature> : {}) & {
@@ -308,16 +299,16 @@ export declare namespace from {
 }
 
 /**
- * Returns the payload to sign for a {@link ox#TransactionEnvelopeEip2930.TransactionEnvelopeEip2930}.
+ * Returns the payload to sign for a {@link ox#TxEnvelopeEip2930.TxEnvelopeEip2930}.
  *
  * @example
  * The example below demonstrates how to compute the sign payload which can be used
  * with ECDSA signing utilities like {@link ox#Secp256k1.(sign:function)}.
  *
  * ```ts twoslash
- * import { Secp256k1, TransactionEnvelopeEip2930 } from 'ox'
+ * import { Secp256k1, TxEnvelopeEip2930 } from 'ox'
  *
- * const envelope = TransactionEnvelopeEip2930.from({
+ * const envelope = TxEnvelopeEip2930.from({
  *   chainId: 1,
  *   nonce: 0n,
  *   gasPrice: 1000000000n,
@@ -326,7 +317,7 @@ export declare namespace from {
  *   value: 1000000000000000000n,
  * })
  *
- * const payload = TransactionEnvelopeEip2930.getSignPayload(envelope) // [!code focus]
+ * const payload = TxEnvelopeEip2930.getSignPayload(envelope) // [!code focus]
  * // @log: '0x...'
  *
  * const signature = Secp256k1.sign({ payload, privateKey: '0x...' })
@@ -336,7 +327,7 @@ export declare namespace from {
  * @returns The sign payload.
  */
 export function getSignPayload(
-  envelope: TransactionEnvelopeEip2930,
+  envelope: TxEnvelopeEip2930,
 ): getSignPayload.ReturnType {
   return hash(envelope, { presign: true })
 }
@@ -348,13 +339,13 @@ export declare namespace getSignPayload {
 }
 
 /**
- * Hashes a {@link ox#TransactionEnvelopeEip2930.TransactionEnvelopeEip2930}. This is the "transaction hash".
+ * Hashes a {@link ox#TxEnvelopeEip2930.TxEnvelopeEip2930}. This is the "transaction hash".
  *
  * @example
  * ```ts twoslash
- * import { Secp256k1, TransactionEnvelopeEip2930 } from 'ox'
+ * import { Secp256k1, TxEnvelopeEip2930 } from 'ox'
  *
- * const envelope = TransactionEnvelopeEip2930.from({
+ * const envelope = TxEnvelopeEip2930.from({
  *   chainId: 1,
  *   nonce: 0n,
  *   gasPrice: 1000000000n,
@@ -364,15 +355,15 @@ export declare namespace getSignPayload {
  * })
  *
  * const signature = Secp256k1.sign({
- *   payload: TransactionEnvelopeEip2930.getSignPayload(envelope),
+ *   payload: TxEnvelopeEip2930.getSignPayload(envelope),
  *   privateKey: '0x...',
  * })
  *
- * const envelope_signed = TransactionEnvelopeEip2930.from(envelope, {
+ * const envelope_signed = TxEnvelopeEip2930.from(envelope, {
  *   signature,
  * })
  *
- * const hash = TransactionEnvelopeEip2930.hash(envelope_signed) // [!code focus]
+ * const hash = TxEnvelopeEip2930.hash(envelope_signed) // [!code focus]
  * ```
  *
  * @param envelope - The EIP-2930 Transaction Envelope to hash.
@@ -380,7 +371,7 @@ export declare namespace getSignPayload {
  * @returns The hash of the transaction envelope.
  */
 export function hash<presign extends boolean = false>(
-  envelope: TransactionEnvelopeEip2930<presign extends true ? false : true>,
+  envelope: TxEnvelopeEip2930<presign extends true ? false : true>,
   options: hash.Options<presign> = {},
 ): hash.ReturnType {
   const { presign } = options
@@ -414,20 +405,20 @@ export declare namespace hash {
 }
 
 /**
- * Serializes a {@link ox#TransactionEnvelopeEip2930.TransactionEnvelopeEip2930}.
+ * Serializes a {@link ox#TxEnvelopeEip2930.TxEnvelopeEip2930}.
  *
  * @example
  * ```ts twoslash
- * import { TransactionEnvelopeEip2930, Value } from 'ox'
+ * import { TxEnvelopeEip2930, Value } from 'ox'
  *
- * const envelope = TransactionEnvelopeEip2930.from({
+ * const envelope = TxEnvelopeEip2930.from({
  *   chainId: 1,
  *   gasPrice: Value.fromGwei('10'),
  *   to: '0x0000000000000000000000000000000000000000',
  *   value: Value.fromEther('1'),
  * })
  *
- * const serialized = TransactionEnvelopeEip2930.serialize(envelope) // [!code focus]
+ * const serialized = TxEnvelopeEip2930.serialize(envelope) // [!code focus]
  * ```
  *
  * @example
@@ -436,9 +427,9 @@ export declare namespace hash {
  * It is possible to attach a `signature` to the serialized Transaction Envelope.
  *
  * ```ts twoslash
- * import { Secp256k1, TransactionEnvelopeEip2930, Value } from 'ox'
+ * import { Secp256k1, TxEnvelopeEip2930, Value } from 'ox'
  *
- * const envelope = TransactionEnvelopeEip2930.from({
+ * const envelope = TxEnvelopeEip2930.from({
  *   chainId: 1,
  *   gasPrice: Value.fromGwei('10'),
  *   to: '0x0000000000000000000000000000000000000000',
@@ -446,11 +437,11 @@ export declare namespace hash {
  * })
  *
  * const signature = Secp256k1.sign({
- *   payload: TransactionEnvelopeEip2930.getSignPayload(envelope),
+ *   payload: TxEnvelopeEip2930.getSignPayload(envelope),
  *   privateKey: '0x...',
  * })
  *
- * const serialized = TransactionEnvelopeEip2930.serialize(envelope, { // [!code focus]
+ * const serialized = TxEnvelopeEip2930.serialize(envelope, { // [!code focus]
  *   signature, // [!code focus]
  * }) // [!code focus]
  *
@@ -462,7 +453,7 @@ export declare namespace hash {
  * @returns The serialized Transaction Envelope.
  */
 export function serialize(
-  envelope: PartialBy<TransactionEnvelopeEip2930, 'type'>,
+  envelope: PartialBy<TxEnvelopeEip2930, 'type'>,
   options: serialize.Options = {},
 ): Serialized {
   const { chainId, gas, data, input, nonce, to, value, accessList, gasPrice } =
@@ -505,13 +496,13 @@ export declare namespace serialize {
 }
 
 /**
- * Converts an {@link ox#TransactionEnvelopeEip2930.TransactionEnvelopeEip2930} to an {@link ox#TransactionEnvelopeEip2930.Rpc}.
+ * Converts an {@link ox#TxEnvelopeEip2930.TxEnvelopeEip2930} to an {@link ox#TxEnvelopeEip2930.Rpc}.
  *
  * @example
  * ```ts twoslash
- * import { RpcRequest, TransactionEnvelopeEip2930, Value } from 'ox'
+ * import { RpcRequest, TxEnvelopeEip2930, Value } from 'ox'
  *
- * const envelope = TransactionEnvelopeEip2930.from({
+ * const envelope = TxEnvelopeEip2930.from({
  *   chainId: 1,
  *   nonce: 0n,
  *   gas: 21000n,
@@ -520,7 +511,7 @@ export declare namespace serialize {
  *   value: Value.fromEther('1'),
  * })
  *
- * const envelope_rpc = TransactionEnvelopeEip2930.toRpc(envelope) // [!code focus]
+ * const envelope_rpc = TxEnvelopeEip2930.toRpc(envelope) // [!code focus]
  *
  * const request = RpcRequest.from({
  *   id: 0,
@@ -532,7 +523,7 @@ export declare namespace serialize {
  * @param envelope - The EIP-2930 transaction envelope to convert.
  * @returns An RPC-formatted EIP-2930 transaction envelope.
  */
-export function toRpc(envelope: Omit<TransactionEnvelopeEip2930, 'type'>): Rpc {
+export function toRpc(envelope: Omit<TxEnvelopeEip2930, 'type'>): Rpc {
   const signature = Signature.extract(envelope)!
 
   return {
@@ -561,13 +552,13 @@ export declare namespace toRpc {
 }
 
 /**
- * Validates a {@link ox#TransactionEnvelopeEip2930.TransactionEnvelopeEip2930}. Returns `true` if the envelope is valid, `false` otherwise.
+ * Validates a {@link ox#TxEnvelopeEip2930.TxEnvelopeEip2930}. Returns `true` if the envelope is valid, `false` otherwise.
  *
  * @example
  * ```ts twoslash
- * import { TransactionEnvelopeEip2930, Value } from 'ox'
+ * import { TxEnvelopeEip2930, Value } from 'ox'
  *
- * const valid = TransactionEnvelopeEip2930.assert({
+ * const valid = TxEnvelopeEip2930.assert({
  *   gasPrice: 2n ** 256n - 1n + 1n,
  *   chainId: 1,
  *   to: '0x0000000000000000000000000000000000000000',
@@ -578,9 +569,7 @@ export declare namespace toRpc {
  *
  * @param envelope - The transaction envelope to validate.
  */
-export function validate(
-  envelope: PartialBy<TransactionEnvelopeEip2930, 'type'>,
-) {
+export function validate(envelope: PartialBy<TxEnvelopeEip2930, 'type'>) {
   try {
     assert(envelope)
     return true