> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://v3.viem.sh/api/mcp` to find what you need.

# TxEnvelopeLegacy.from

:::info
`TxEnvelopeLegacy.from` is a re-export of ox's [`TxEnvelopeLegacy.from`](https://oxlib.sh/api/TxEnvelopeLegacy/from). Refer to the ox documentation for the full reference.
:::

Converts an arbitrary transaction object into a legacy Transaction Envelope.

## Imports

```ts
import { TxEnvelopeLegacy } from 'viem/utils'
```

## Examples

```ts twoslash
// @noErrors
import { TxEnvelopeLegacy, Value } from 'viem/utils'

const envelope = TxEnvelopeLegacy.from({
  gasPrice: Value.fromGwei('10'),
  to: '0x0000000000000000000000000000000000000000',
  value: Value.fromEther('1')
})
```

### Attaching Signatures

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

```ts twoslash
// @noErrors
import { Secp256k1, TxEnvelopeLegacy, Value } from 'viem/utils'

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: }
```

### From Serialized

It is possible to instantiate an legacy Transaction Envelope from a [`TxEnvelopeLegacy.Serialized`](/docs/utilities/txenvelopelegacy/types#serialized) value.

```ts twoslash
// @noErrors
import { TxEnvelopeLegacy } from 'viem/utils'

const envelope = TxEnvelopeLegacy.from(
  '0xf858018203118502540be4008504a817c800809470997970c51812dc3a010c7d01b50e0d17dc79c8880de0b6b3a764000080c08477359400e1a001627c687261b0e7f8638af1112efa8a77e23656f6e7945275b19e9deed80261'
)
// @log: {
// @log:   chainId: 1,
// @log:   gasPrice: 10000000000n,
// @log:   to: '0x0000000000000000000000000000000000000000',
// @log:   type: 'legacy',
// @log:   value: 1000000000000000000n,
// @log: }
```

## Definition

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

## Parameters

### envelope

* **Type:** `envelope | UnionPartialBy<TxEnvelopeLegacy, 'type'> | Hex.Hex`

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

A legacy Transaction Envelope.

`from.ReturnType<envelope, signature>`
