ox
Version:
Ethereum Standard Library
497 lines • 15.4 kB
JavaScript
import * as Address from './Address.js';
import * as Hash from './Hash.js';
import * as Hex from './Hex.js';
import * as Quantity from './internal/quantity.js';
import * as Tx from './internal/tx.js';
import * as Rlp from './Rlp.js';
import * as Signature from './Signature.js';
import * as TransactionEnvelope from './TxEnvelope.js';
export const type = 'legacy';
/**
* Asserts a {@link ox#TxEnvelopeLegacy.TxEnvelopeLegacy} is valid.
*
* @example
* ```ts twoslash
* import { TxEnvelopeLegacy, Value } from 'ox'
*
* TxEnvelopeLegacy.assert({
* gasPrice: 2n ** 256n - 1n + 1n,
* chainId: 1,
* to: '0x0000000000000000000000000000000000000000',
* value: Value.fromEther('1')
* })
* // @error: GasPriceTooHighError:
* // @error: The gas price (`gasPrice` = 115792089237316195423570985008687907853269984665640564039457584007913 gwei) cannot be
* // @error: higher than the maximum allowed value (2^256-1).
* ```
*
* @param envelope - The transaction envelope to assert.
*/
export function assert(envelope) {
const { chainId, gasPrice, to } = envelope;
if (to)
Address.assert(to, { strict: false });
if (typeof chainId !== 'undefined' && chainId <= 0)
throw new TransactionEnvelope.InvalidChainIdError({ chainId });
if (gasPrice && BigInt(gasPrice) > 2n ** 256n - 1n)
throw new TransactionEnvelope.GasPriceTooHighError({ gasPrice });
}
/**
* Deserializes a {@link ox#TxEnvelopeLegacy.TxEnvelopeLegacy} from its serialized form.
*
* @example
* ```ts twoslash
* import { TxEnvelopeLegacy } from 'ox'
*
* const envelope = TxEnvelopeLegacy.deserialize(
* '0x01ef0182031184773594008477359400809470997970c51812dc3a010c7d01b50e0d17dc79c8880de0b6b3a764000080c0'
* )
* // @log: {
* // @log: type: 'legacy',
* // @log: nonce: 785n,
* // @log: gasPrice: 2000000000n,
* // @log: gas: 1000000n,
* // @log: to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
* // @log: value: 1000000000000000000n,
* // @log: }
* ```
*
* @param serialized - The serialized transaction.
* @returns Deserialized Transaction Envelope.
*/
export function deserialize(serialized) {
const tuple = Rlp.toBytes(serialized);
const [nonce, gasPrice, gas, to, value, data, chainIdOrV_, r, s] = tuple;
if (!(tuple.length === 6 || tuple.length === 9))
throw new TransactionEnvelope.InvalidSerializedError({
attributes: {
nonce,
gasPrice,
gas,
to,
value,
data,
...(tuple.length > 6
? {
v: chainIdOrV_,
r,
s,
}
: {}),
},
serialized,
type,
});
const transaction = {
type,
};
const to_ = Tx.bytesToHexOrUndefined(to);
if (to_)
transaction.to = to_;
const gas_ = Tx.bytesToBigIntOrUndefined(gas);
if (gas_ !== undefined)
transaction.gas = gas_;
const data_ = Tx.bytesToHexOrUndefined(data);
if (data_)
transaction.data = data_;
if (nonce !== undefined)
transaction.nonce = Tx.bytesToBigIntOrZero(nonce);
const value_ = Tx.bytesToBigIntOrUndefined(value);
if (value_ !== undefined)
transaction.value = value_;
const gasPrice_ = Tx.bytesToBigIntOrUndefined(gasPrice);
if (gasPrice_ !== undefined)
transaction.gasPrice = gasPrice_;
if (tuple.length === 6)
return transaction;
const chainIdOrV = Tx.bytesToNumberOrUndefined(chainIdOrV_) ?? 0;
if (s.length === 0 && r.length === 0) {
if (chainIdOrV > 0)
transaction.chainId = Number(chainIdOrV);
return transaction;
}
const v = chainIdOrV;
const chainId = Math.floor((v - 35) / 2);
if (chainId > 0)
transaction.chainId = chainId;
else if (v !== 27 && v !== 28)
throw new Signature.InvalidVError({ value: v });
transaction.yParity = Signature.vToYParity(v);
transaction.v = v;
transaction.s = Hex.fromNumber(Tx.bytesToBigIntOrZero(s), { size: 32 });
transaction.r = Hex.fromNumber(Tx.bytesToBigIntOrZero(r), { size: 32 });
assert(transaction);
return transaction;
}
/**
* Converts an arbitrary transaction object into a legacy Transaction Envelope.
*
* @example
* ```ts twoslash
* import { TxEnvelopeLegacy, Value } from 'ox'
*
* const envelope = TxEnvelopeLegacy.from({
* gasPrice: Value.fromGwei('10'),
* to: '0x0000000000000000000000000000000000000000',
* value: Value.fromEther('1')
* })
* ```
*
* @example
* ### Attaching Signatures
*
* It is possible to attach a `signature` to the transaction envelope.
*
* ```ts twoslash
* import { Secp256k1, TxEnvelopeLegacy, Value } from 'ox'
*
* const envelope = TxEnvelopeLegacy.from({
* chainId: 1,
* gasPrice: Value.fromGwei('10'),
* to: '0x0000000000000000000000000000000000000000',
* value: Value.fromEther('1')
* })
*
* const signature = Secp256k1.sign({
* payload: TxEnvelopeLegacy.getSignPayload(envelope),
* privateKey: '0x...'
* })
*
* const envelope_signed = TxEnvelopeLegacy.from(envelope, {
* // [!code focus]
* signature // [!code focus]
* }) // [!code focus]
* // @log: {
* // @log: authorizationList: [...],
* // @log: chainId: 1,
* // @log: gasPrice: 10000000000n,
* // @log: to: '0x0000000000000000000000000000000000000000',
* // @log: type: 'eip7702',
* // @log: value: 1000000000000000000n,
* // @log: r: 125...n,
* // @log: s: 642...n,
* // @log: yParity: 0,
* // @log: }
* ```
*
* @example
* ### From Serialized
*
* It is possible to instantiate an legacy Transaction Envelope from a {@link ox#TxEnvelopeLegacy.Serialized} value.
*
* ```ts twoslash
* import { TxEnvelopeLegacy } from 'ox'
*
* const envelope = TxEnvelopeLegacy.from(
* '0xf858018203118502540be4008504a817c800809470997970c51812dc3a010c7d01b50e0d17dc79c8880de0b6b3a764000080c08477359400e1a001627c687261b0e7f8638af1112efa8a77e23656f6e7945275b19e9deed80261'
* )
* // @log: {
* // @log: chainId: 1,
* // @log: gasPrice: 10000000000n,
* // @log: to: '0x0000000000000000000000000000000000000000',
* // @log: type: 'legacy',
* // @log: value: 1000000000000000000n,
* // @log: }
* ```
*
* @param envelope - The transaction object to convert.
* @param options - Options.
* @returns A legacy Transaction Envelope.
*/
export function from(envelope, options = {}) {
const { signature } = options;
const envelope_ = (typeof envelope === 'string' ? deserialize(envelope) : envelope);
assert(envelope_);
const signature_ = (() => {
if (!signature)
return {};
const s = Signature.from(signature);
s.v = Signature.yParityToV(s.yParity);
return s;
})();
return {
...envelope_,
...signature_,
type: 'legacy',
};
}
/**
* Returns the payload to sign for a {@link ox#TxEnvelopeLegacy.TxEnvelopeLegacy}.
*
* @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
* // @noErrors
* import { Secp256k1, TxEnvelopeLegacy } from 'ox'
*
* const envelope = TxEnvelopeLegacy.from({
* nonce: 0n,
* gasPrice: 1000000000n,
* gas: 21000n,
* to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
* value: 1000000000000000000n
* })
*
* const payload = TxEnvelopeLegacy.getSignPayload(envelope) // [!code focus]
* // @log: '0x...'
*
* const signature = Secp256k1.sign({
* payload,
* privateKey: '0x...'
* })
* ```
*
* @param envelope - The transaction envelope to get the sign payload for.
* @returns The sign payload.
*/
export function getSignPayload(envelope) {
return hash(envelope, { presign: true });
}
/**
* Hashes a {@link ox#TxEnvelopeLegacy.TxEnvelopeLegacy}. This is the "transaction hash".
*
* @example
* ```ts twoslash
* import { Secp256k1, TxEnvelopeLegacy } from 'ox'
*
* const envelope = TxEnvelopeLegacy.from({
* chainId: 1,
* nonce: 0n,
* gasPrice: 1000000000n,
* gas: 21000n,
* to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
* value: 1000000000000000000n
* })
*
* const signature = Secp256k1.sign({
* payload: TxEnvelopeLegacy.getSignPayload(envelope),
* privateKey: '0x...'
* })
*
* const envelope_signed = TxEnvelopeLegacy.from(envelope, {
* signature
* })
*
* const hash = TxEnvelopeLegacy.hash(envelope_signed) // [!code focus]
* ```
*
* @param envelope - The Legacy Transaction Envelope to hash.
* @param options - Options.
* @returns The hash of the transaction envelope.
*/
export function hash(envelope, options = {}) {
const { presign } = options;
return Hash.keccak256(serialize({
...envelope,
...(presign
? {
r: undefined,
s: undefined,
yParity: undefined,
v: undefined,
}
: {}),
}));
}
/**
* Serializes a {@link ox#TxEnvelopeLegacy.TxEnvelopeLegacy}.
*
* @example
* ```ts twoslash
* // @noErrors
* import { TxEnvelopeLegacy } from 'ox'
*
* const envelope = TxEnvelopeLegacy.from({
* chainId: 1,
* gasPrice: Value.fromGwei('10'),
* to: '0x0000000000000000000000000000000000000000',
* value: Value.fromEther('1')
* })
*
* const serialized = TxEnvelopeLegacy.serialize(envelope) // [!code focus]
* ```
*
* @example
* ### Attaching Signatures
*
* It is possible to attach a `signature` to the serialized Transaction Envelope.
*
* ```ts twoslash
* // @noErrors
* import { Secp256k1, TxEnvelopeLegacy, Value } from 'ox'
*
* const envelope = TxEnvelopeLegacy.from({
* chainId: 1,
* gasPrice: Value.fromGwei('10'),
* to: '0x0000000000000000000000000000000000000000',
* value: Value.fromEther('1')
* })
*
* const signature = Secp256k1.sign({
* payload: TxEnvelopeLegacy.getSignPayload(envelope),
* privateKey: '0x...'
* })
*
* const serialized = TxEnvelopeLegacy.serialize(envelope, {
* // [!code focus]
* signature // [!code focus]
* }) // [!code focus]
*
* // ... send `serialized` transaction to JSON-RPC `eth_sendRawTransaction`
* ```
*
* @param envelope - The Transaction Envelope to serialize.
* @param options - Options.
* @returns The serialized Transaction Envelope.
*/
export function serialize(envelope, options = {}) {
const { chainId = 0, gas, data, input, nonce, to, value, gasPrice } = envelope;
assert(envelope);
let serialized = [
Tx.quantityToHex(nonce),
Tx.quantityToHex(gasPrice),
Tx.quantityToHex(gas),
to ?? '0x',
Tx.quantityToHex(value),
data ?? input ?? '0x',
];
const signature = (() => {
if (options.signature)
return {
r: options.signature.r,
s: options.signature.s,
v: Signature.yParityToV(options.signature.yParity),
};
if (typeof envelope.r === 'undefined' || typeof envelope.s === 'undefined')
return undefined;
return {
r: envelope.r,
s: envelope.s,
v: envelope.v,
};
})();
if (signature) {
const v = (() => {
// EIP-155 (inferred chainId)
if (signature.v >= 35) {
const inferredChainId = Math.floor((signature.v - 35) / 2);
if (inferredChainId > 0)
return signature.v;
return 27 + (signature.v === 35 ? 0 : 1);
}
// EIP-155 (explicit chainId)
if (chainId > 0)
return chainId * 2 + 35 + signature.v - 27;
// Pre-EIP-155 (no chainId)
const v = 27 + (signature.v === 27 ? 0 : 1);
if (signature.v !== v)
throw new Signature.InvalidVError({ value: signature.v });
return v;
})();
serialized = [
...serialized,
Hex.fromNumber(v),
Hex.trimLeft(signature.r),
Hex.trimLeft(signature.s),
];
}
else if (chainId > 0)
serialized = [...serialized, Hex.fromNumber(chainId), '0x', '0x'];
return Rlp.fromHex(serialized);
}
/**
* Converts an {@link ox#TxEnvelopeLegacy.TxEnvelopeLegacy} to an {@link ox#TxEnvelopeLegacy.Rpc}.
*
* @example
* ```ts twoslash
* import { RpcRequest, TxEnvelopeLegacy, Value } from 'ox'
*
* const envelope = TxEnvelopeLegacy.from({
* chainId: 1,
* nonce: 0n,
* gas: 21000n,
* to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
* value: Value.fromEther('1')
* })
*
* const envelope_rpc = TxEnvelopeLegacy.toRpc(envelope) // [!code focus]
*
* const request = RpcRequest.from({
* id: 0,
* method: 'eth_sendTransaction',
* params: [envelope_rpc]
* })
* ```
*
* @param envelope - The legacy transaction envelope to convert.
* @returns An RPC-formatted legacy transaction envelope.
*/
export function toRpc(envelope) {
const signature = Signature.extract(envelope);
return {
...envelope,
chainId: typeof envelope.chainId === 'number'
? Hex.fromNumber(envelope.chainId)
: undefined,
data: envelope.data ?? envelope.input,
type: '0x0',
...(envelope.gas !== undefined
? { gas: Quantity.fromNumberish(envelope.gas) }
: {}),
...(envelope.nonce !== undefined
? { nonce: Quantity.fromNumberish(envelope.nonce) }
: {}),
...(envelope.value !== undefined
? { value: Quantity.fromNumberish(envelope.value) }
: {}),
...(envelope.gasPrice !== undefined
? { gasPrice: Quantity.fromNumberish(envelope.gasPrice) }
: {}),
...(signature
? {
...Signature.toRpc(signature),
v: (() => {
// Prefer the original `v` from the envelope when present
// (preserves EIP-155 `v = chainId * 2 + 35 + yParity`).
if (typeof envelope.v === 'number')
return Hex.fromNumber(envelope.v);
// Otherwise derive EIP-155 `v` from `chainId` + `yParity`.
if (typeof envelope.chainId === 'number' && envelope.chainId > 0)
return Hex.fromNumber(envelope.chainId * 2 + 35 + signature.yParity);
// Fall back to pre-EIP-155 `27`/`28`.
return signature.yParity === 0 ? '0x1b' : '0x1c';
})(),
}
: {}),
};
}
/**
* Validates a {@link ox#TxEnvelopeLegacy.TxEnvelopeLegacy}. Returns `true` if the envelope is valid, `false` otherwise.
*
* @example
* ```ts twoslash
* import { TxEnvelopeLegacy, Value } from 'ox'
*
* const valid = TxEnvelopeLegacy.assert({
* gasPrice: 2n ** 256n - 1n + 1n,
* chainId: 1,
* to: '0x0000000000000000000000000000000000000000',
* value: Value.fromEther('1')
* })
* // @log: false
* ```
*
* @param envelope - The transaction envelope to validate.
*/
export function validate(envelope) {
try {
assert(envelope);
return true;
}
catch {
return false;
}
}
//# sourceMappingURL=TxEnvelopeLegacy.js.map