# TxEnvelopeEip1559.from

Converts an arbitrary transaction object into an EIP-1559 Transaction Envelope.

## Imports

:::code-group
```ts [Named]
import { TxEnvelopeEip1559 } from 'ox'
```

```ts [Entrypoint]
import * as TxEnvelopeEip1559 from 'ox/TxEnvelopeEip1559'
```
:::

## Examples

```ts twoslash
import { TxEnvelopeEip1559, Value } from 'ox'

const envelope = TxEnvelopeEip1559.from({
  chainId: 1,
  maxFeePerGas: Value.fromGwei('10'),
  maxPriorityFeePerGas: Value.fromGwei('1'),
  to: '0x0000000000000000000000000000000000000000',
  value: Value.fromEther('1')
})
```

### Attaching Signatures

It is possible to attach a `signature` to the transaction envelope.

```ts twoslash
import { Secp256k1, TxEnvelopeEip1559, Value } from 'ox'

const envelope = TxEnvelopeEip1559.from({
  chainId: 1,
  maxFeePerGas: Value.fromGwei('10'),
  maxPriorityFeePerGas: Value.fromGwei('1'),
  to: '0x0000000000000000000000000000000000000000',
  value: Value.fromEther('1')
})

const signature = Secp256k1.sign({
  payload: TxEnvelopeEip1559.getSignPayload(envelope),
  privateKey: '0x...'
})

const envelope_signed = TxEnvelopeEip1559.from(envelope, {
  // [!code focus]
  signature // [!code focus]
}) // [!code focus]
// @log: {
// @log:   chainId: 1,
// @log:   maxFeePerGas: 10000000000n,
// @log:   maxPriorityFeePerGas: 1000000000n,
// @log:   to: '0x0000000000000000000000000000000000000000',
// @log:   type: 'eip1559',
// @log:   value: 1000000000000000000n,
// @log:   r: 125...n,
// @log:   s: 642...n,
// @log:   yParity: 0,
// @log: }
```

### From Serialized

It is possible to instantiate an EIP-1559 Transaction Envelope from a [`TxEnvelopeEip1559.Serialized`](/api/TxEnvelopeEip1559/types#serialized) value.

```ts twoslash
import { TxEnvelopeEip1559 } from 'ox'

const envelope = TxEnvelopeEip1559.from(
  '0x02f858018203118502540be4008504a817c800809470997970c51812dc3a010c7d01b50e0d17dc79c8880de0b6b3a764000080c08477359400e1a001627c687261b0e7f8638af1112efa8a77e23656f6e7945275b19e9deed80261'
)
// @log: {
// @log:   chainId: 1,
// @log:   maxFeePerGas: 10000000000n,
// @log:   maxPriorityFeePerGas: 1000000000n,
// @log:   to: '0x0000000000000000000000000000000000000000',
// @log:   type: 'eip1559',
// @log:   value: 1000000000000000000n,
// @log: }
```

## Definition

```ts
function from<envelope, signature>(
  envelope: envelope | UnionPartialBy<TxEnvelopeEip1559, 'type'> | Serialized,
  options?: from.Options<signature>,
): from.ReturnType<envelope, signature>
```

**Source:** [src/core/TxEnvelopeEip1559.ts](https://github.com/wevm/ox/blob/main/src/core/TxEnvelopeEip1559.ts#L654)

## Parameters

### envelope

* **Type:** `envelope | UnionPartialBy<TxEnvelopeEip1559, 'type'> | Serialized`

The transaction object to convert.

### options

* **Type:** `from.Options<signature>`
* **Optional**

Options.

#### options.signature

* **Type:** `{ r: 0x${string}; s: 0x${string}; yParity: number; } | signature`
* **Optional**

## Return Type

An EIP-1559 Transaction Envelope.

`from.ReturnType<envelope, signature>`