> ## Documentation Index
> Fetch the complete documentation index at: https://voltaire.tevm.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# BrandedGwei

> Auto-generated API documentation

[**@tevm/voltaire**](../../index.mdx)

***

[@tevm/voltaire](../../index.mdx) / [index](../index.mdx) / BrandedGwei

# BrandedGwei

## Type Aliases

### BrandedGwei

> **BrandedGwei** = [`GweiType`](#gweitype)

Defined in: [src/primitives/Denomination/GweiType.ts:12](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/Denomination/GweiType.ts#L12)

***

### GweiType

> **GweiType** = `string` & `object`

Defined in: [src/primitives/Denomination/GweiType.ts:9](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/Denomination/GweiType.ts#L9)

Branded Gwei type - represents Ethereum amounts in gwei (10^9 wei = 10^-9 ETH)

Uses string to support decimal values like "1.5" or "0.001"
For whole number wei amounts, use WeiType (bigint)

#### Type Declaration

##### \[brand]

> `readonly` **\[brand]**: `"Gwei"`

## Variables

### Gwei

> `const` **Gwei**: `object`

Defined in: [src/primitives/Denomination/gwei-index.ts:19](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/Denomination/gwei-index.ts#L19)

#### Type Declaration

##### from()

> **from**: (`value`) => [`GweiType`](#gweitype)

Create Gwei from bigint, number, or string

Gwei is a string type to support decimal values like "1.5" or "0.001"

###### Parameters

###### value

Value to convert (bigint, number, or string)

`string` | `number` | `bigint`

###### Returns

[`GweiType`](#gweitype)

Gwei amount as branded string

###### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

###### Since

0.0.0

###### Throws

If value is not a valid number

###### Example

```typescript theme={null}
const gwei1 = Gwei.from(1n);        // "1"
const gwei2 = Gwei.from(1.5);       // "1.5"
const gwei3 = Gwei.from("1.5");     // "1.5"
const gwei4 = Gwei.from("0.001");   // "0.001"
```

##### fromEther()

> **fromEther**: (`ether`) => [`GweiType`](#gweitype)

Convert Ether to Gwei

Converts ether string to gwei string (multiplies by 10^9).
Alias for Ether.toGwei().

###### Parameters

###### ether

[`EtherType`](BrandedEther.mdx#ethertype)

Amount in Ether (string)

###### Returns

[`GweiType`](#gweitype)

Amount in Gwei (string)

###### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

###### Since

0.0.0

###### Throws

###### Example

```typescript theme={null}
const gwei1 = Gwei.fromEther(Ether.from("1"));   // "1000000000"
const gwei2 = Gwei.fromEther(Ether.from("1.5")); // "1500000000"
```

##### fromWei()

> **fromWei**: (`wei`) => [`GweiType`](#gweitype)

Convert Wei to Gwei

Converts bigint wei to decimal string gwei value.
Alias for Wei.toGwei().

###### Parameters

###### wei

[`WeiType`](BrandedWei.mdx#weitype)

Amount in Wei (bigint)

###### Returns

[`GweiType`](#gweitype)

Amount in Gwei (string with decimal precision)

###### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

###### Since

0.0.0

###### Throws

###### Example

```typescript theme={null}
const gwei1 = Gwei.fromWei(Wei.from(5000000000n)); // "5"
const gwei2 = Gwei.fromWei(Wei.from(1500000000n)); // "1.5"
```

##### toEther()

> **toEther**: (`gwei`) => [`EtherType`](BrandedEther.mdx#ethertype)

Convert Gwei to Ether

Converts gwei string to ether string (divides by 10^9).

###### Parameters

###### gwei

[`GweiType`](#gweitype)

Amount in Gwei (string)

###### Returns

[`EtherType`](BrandedEther.mdx#ethertype)

Amount in Ether (string)

###### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

###### Since

0.0.0

###### Throws

###### Example

```typescript theme={null}
const ether1 = Gwei.toEther(Gwei.from("1000000000")); // "1"
const ether2 = Gwei.toEther(Gwei.from("1500000000")); // "1.5"
const ether3 = Gwei.toEther(Gwei.from("1"));          // "0.000000001"
```

##### toU256()

> **toU256**: (`gwei`) => [`Type`](../../primitives/Uint.mdx#type)

Convert Gwei to Uint256 (in Wei)

Converts gwei string to wei bigint, then returns as Uint256.

###### Parameters

###### gwei

[`GweiType`](#gweitype)

Amount in Gwei (string)

###### Returns

[`Type`](../../primitives/Uint.mdx#type)

Uint256 value in Wei

###### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

###### Since

0.0.0

###### Throws

If gwei value has more than 9 decimal places

###### Example

```typescript theme={null}
const u256_1 = Gwei.toU256(Gwei.from("5"));   // 5000000000n
const u256_2 = Gwei.toU256(Gwei.from("1.5")); // 1500000000n
```

##### toWei()

> **toWei**: (`gwei`) => [`WeiType`](BrandedWei.mdx#weitype)

Convert Gwei to Wei

Parses decimal gwei string and converts to bigint wei value.

###### Parameters

###### gwei

[`GweiType`](#gweitype)

Amount in Gwei (string, supports decimals like "1.5")

###### Returns

[`WeiType`](BrandedWei.mdx#weitype)

Amount in Wei (bigint)

###### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

###### Since

0.0.0

###### Throws

If gwei value has more than 9 decimal places

###### Example

```typescript theme={null}
const wei1 = Gwei.toWei(Gwei.from("5"));     // 5000000000n
const wei2 = Gwei.toWei(Gwei.from("1.5"));   // 1500000000n
const wei3 = Gwei.toWei(Gwei.from("0.001")); // 1000000n
```

***

### GWEI\_PER\_ETHER

> `const` **GWEI\_PER\_ETHER**: `1000000000n` = `1_000_000_000n`

Defined in: [src/primitives/Denomination/gwei-constants.ts:15](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/Denomination/gwei-constants.ts#L15)

Number of Gwei in one Ether (10^9)

#### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

#### Since

0.0.0

***

### WEI\_PER\_GWEI

> `const` **WEI\_PER\_GWEI**: `1000000000n` = `1_000_000_000n`

Defined in: [src/primitives/Denomination/gwei-constants.ts:7](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/Denomination/gwei-constants.ts#L7)

Number of Wei in one Gwei (10^9)

#### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

#### Since

0.0.0

## Functions

### from()

> **from**(`value`): [`GweiType`](#gweitype)

Defined in: [src/primitives/Denomination/gwei-from.ts:21](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/Denomination/gwei-from.ts#L21)

Create Gwei from bigint, number, or string

Gwei is a string type to support decimal values like "1.5" or "0.001"

#### Parameters

##### value

Value to convert (bigint, number, or string)

`string` | `number` | `bigint`

#### Returns

[`GweiType`](#gweitype)

Gwei amount as branded string

#### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

#### Since

0.0.0

#### Throws

If value is not a valid number

#### Example

```typescript theme={null}
const gwei1 = Gwei.from(1n);        // "1"
const gwei2 = Gwei.from(1.5);       // "1.5"
const gwei3 = Gwei.from("1.5");     // "1.5"
const gwei4 = Gwei.from("0.001");   // "0.001"
```

***

### fromEther()

> **fromEther**(`ether`): [`GweiType`](#gweitype)

Defined in: [src/primitives/Denomination/gwei-fromEther.ts:22](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/Denomination/gwei-fromEther.ts#L22)

Convert Ether to Gwei

Converts ether string to gwei string (multiplies by 10^9).
Alias for Ether.toGwei().

#### Parameters

##### ether

[`EtherType`](BrandedEther.mdx#ethertype)

Amount in Ether (string)

#### Returns

[`GweiType`](#gweitype)

Amount in Gwei (string)

#### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

#### Since

0.0.0

#### Throws

#### Example

```typescript theme={null}
const gwei1 = Gwei.fromEther(Ether.from("1"));   // "1000000000"
const gwei2 = Gwei.fromEther(Ether.from("1.5")); // "1500000000"
```

***

### fromWei()

> **fromWei**(`wei`): [`GweiType`](#gweitype)

Defined in: [src/primitives/Denomination/gwei-fromWei.ts:22](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/Denomination/gwei-fromWei.ts#L22)

Convert Wei to Gwei

Converts bigint wei to decimal string gwei value.
Alias for Wei.toGwei().

#### Parameters

##### wei

[`WeiType`](BrandedWei.mdx#weitype)

Amount in Wei (bigint)

#### Returns

[`GweiType`](#gweitype)

Amount in Gwei (string with decimal precision)

#### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

#### Since

0.0.0

#### Throws

#### Example

```typescript theme={null}
const gwei1 = Gwei.fromWei(Wei.from(5000000000n)); // "5"
const gwei2 = Gwei.fromWei(Wei.from(1500000000n)); // "1.5"
```

***

### toEther()

> **toEther**(`gwei`): [`EtherType`](BrandedEther.mdx#ethertype)

Defined in: [src/primitives/Denomination/gwei-toEther.ts:23](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/Denomination/gwei-toEther.ts#L23)

Convert Gwei to Ether

Converts gwei string to ether string (divides by 10^9).

#### Parameters

##### gwei

[`GweiType`](#gweitype)

Amount in Gwei (string)

#### Returns

[`EtherType`](BrandedEther.mdx#ethertype)

Amount in Ether (string)

#### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

#### Since

0.0.0

#### Throws

#### Example

```typescript theme={null}
const ether1 = Gwei.toEther(Gwei.from("1000000000")); // "1"
const ether2 = Gwei.toEther(Gwei.from("1500000000")); // "1.5"
const ether3 = Gwei.toEther(Gwei.from("1"));          // "0.000000001"
```

***

### toU256()

> **toU256**(`gwei`): [`Type`](../../primitives/Uint.mdx#type)

Defined in: [src/primitives/Denomination/gwei-toU256.ts:21](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/Denomination/gwei-toU256.ts#L21)

Convert Gwei to Uint256 (in Wei)

Converts gwei string to wei bigint, then returns as Uint256.

#### Parameters

##### gwei

[`GweiType`](#gweitype)

Amount in Gwei (string)

#### Returns

[`Type`](../../primitives/Uint.mdx#type)

Uint256 value in Wei

#### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

#### Since

0.0.0

#### Throws

If gwei value has more than 9 decimal places

#### Example

```typescript theme={null}
const u256_1 = Gwei.toU256(Gwei.from("5"));   // 5000000000n
const u256_2 = Gwei.toU256(Gwei.from("1.5")); // 1500000000n
```

***

### toWei()

> **toWei**(`gwei`): [`WeiType`](BrandedWei.mdx#weitype)

Defined in: [src/primitives/Denomination/gwei-toWei.ts:23](https://github.com/evmts/voltaire/blob/bd6ec34405c15ad8cd51d11579d495dc53813482/src/primitives/Denomination/gwei-toWei.ts#L23)

Convert Gwei to Wei

Parses decimal gwei string and converts to bigint wei value.

#### Parameters

##### gwei

[`GweiType`](#gweitype)

Amount in Gwei (string, supports decimals like "1.5")

#### Returns

[`WeiType`](BrandedWei.mdx#weitype)

Amount in Wei (bigint)

#### See

[https://voltaire.tevm.sh/primitives/denomination](https://voltaire.tevm.sh/primitives/denomination) for Denomination documentation

#### Since

0.0.0

#### Throws

If gwei value has more than 9 decimal places

#### Example

```typescript theme={null}
const wei1 = Gwei.toWei(Gwei.from("5"));     // 5000000000n
const wei2 = Gwei.toWei(Gwei.from("1.5"));   // 1500000000n
const wei3 = Gwei.toWei(Gwei.from("0.001")); // 1000000n
```