# ethereumjs-account

> Encoding, decoding and validation of Ethereum's Account schema

Latest version **3.0.0** (published 2019-01-14) · MPL-2.0 license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install ethereumjs-account
pnpm add ethereumjs-account
yarn add ethereumjs-account
bun add ethereumjs-account
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2019-01-14 |
| First published | 2015-07-16 |
| Weekly downloads | 0 |
| License | MPL-2.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 16 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 45 |
| Author | mjbecze |
| Maintainers | axic, holgerd77, jwasinger, null_radix |
| Keywords | ethereum, account |

## Links

- npm: https://www.npmjs.com/package/ethereumjs-account
- Repository: https://github.com/ethereumjs/ethereumjs-account
- Homepage: https://github.com/ethereumjs/ethereumjs-account#readme
- Issues: https://github.com/ethereumjs/ethereumjs-account/issues
- npm.io page: https://npm.io/package/ethereumjs-account

## Dependencies (3)

- [rlp](https://npm.io/package/rlp.md) ^2.2.1
- [safe-buffer](https://npm.io/package/safe-buffer.md) ^5.1.1
- [ethereumjs-util](https://npm.io/package/ethereumjs-util.md) ^6.0.0

## Recent versions

- 3.0.0 (latest) — 2019-01-14
- 2.0.5 — 2018-05-08
- 2.0.4 — 2016-06-26
- 2.0.2 — 2016-03-01
- 2.0.1 — 2016-01-16
- 2.0.0 — 2016-01-06
- 1.0.5 — 2015-11-27
- 1.0.4 — 2015-11-03
- 1.0.3 — 2015-09-24
- 1.0.2 — 2015-09-24
- 1.0.1 — 2015-09-24
- 1.0.0 — 2015-09-24
- 0.0.6 — 2015-09-22
- 0.0.5 — 2015-09-21
- 0.0.4 — 2015-09-20
- … 4 more at https://npm.io/package/ethereumjs-account/versions

## README

# SYNOPSIS

[![NPM Package](https://img.shields.io/npm/v/ethereumjs-account.svg?style=flat-square)](https://www.npmjs.org/package/ethereumjs-account)
[![Build Status](https://travis-ci.org/ethereumjs/ethereumjs-account.svg?branch=master)](https://travis-ci.org/ethereumjs/ethereumjs-account)
[![Coverage Status](https://img.shields.io/coveralls/ethereumjs/ethereumjs-account.svg?style=flat-square)](https://coveralls.io/r/ethereumjs/ethereumjs-account)
[![Gitter](https://img.shields.io/gitter/room/ethereum/ethereumjs-lib.svg?style=flat-square)](https://gitter.im/ethereum/ethereumjs-lib)
[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat)](https://github.com/feross/standard)

This library eases the handling of Ethereum accounts, where accounts can be either external accounts
or contracts (see
[Account Types](http://ethdocs.org/en/latest/contracts-and-transactions/account-types-gas-and-transactions.html) docs).

Note that the library is not meant to be used to handle your wallet accounts, use e.g. the
[web3-eth-personal](http://web3js.readthedocs.io/en/1.0/web3-eth-personal.html) package from the
`web3.js` library for that. This is just a semantic wrapper to ease the use of account data and
provide functionality for reading and writing accounts from and to the Ethereum state trie.

# INSTALL

`npm install ethereumjs-account`

# BROWSER

This module work with `browserify`.

# API

- [`new Account([data])`](#new-accountdata)
- [`Account` Properties](#account-properties)
- [`Account` Methods](#account-methods)
  - [`account.isEmpty()`](#accountisempty)
  - [`account.isContract()`](#accountiscontract)
  - [`account.serialize()`](#accountserialize)
  - [`account.toJSON()`](#accounttojson)
  - [`account.getCode(trie, cb)`](#accountgetcodetrie-cb)
  - [`account.setCode(trie, code, cb)`](#accountsetcodetrie-code-cb)
  - [`account.getStorage(trie, key, cb)`](#accountgetstoragetrie-key-cb)
  - [`account.setStorage(trie, key, val, cb)`](#accountsetstoragetrie-key-val-cb)

### `new Account([data])`

Creates a new account object

- `data` - an account can be initialized with either a `buffer` containing the RLP serialized account.
  Or an `Array` of buffers relating to each of the account Properties, listed in order below. For example:

```javascript
var raw = [
  '0x02', //nonce
  '0x0384', //balance
  '0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421', //stateRoot
  '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470', //codeHash
]

var account = new Account(raw)
```

Or lastly an `Object` containing the Properties of the account:

```javascript
var raw = {
  nonce: '',
  balance: '0x03e7',
  stateRoot: '0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421',
  codeHash: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
}

var account = new Account(raw)
```

For `Object` and `Array` each of the elements can either be a `Buffer`, hex `String`, `Number`, or an object with a `toBuffer` method such as `Bignum`.

### `Account` Properties

- `nonce` - The account's nonce.
- `balance` - The account's balance in wei.
- `stateRoot` - The stateRoot for the storage of the contract.
- `codeHash` - The hash of the code of the contract.

### `Account` Methods

#### `account.isEmpty()`

Returns a `Boolean` determining if the account is empty.

#### `account.isContract()`

Returns a `Boolean` deteremining if the account is a contract.

#### `account.serialize()`

Returns the RLP serialization of the account as a `Buffer`.

#### `account.toJSON([object])`

Returns the account as JSON.

- `object` - A `Boolean` that defaults to false. If `object` is true then this will return an `Object`, else it will return an `Array`.

#### `account.getCode(trie, cb)`

Fetches the code from the trie.

- `trie` - The [trie](https://github.com/ethereumjs/merkle-patricia-tree) storing the accounts.
- `cb` - The callback.

#### `account.setCode(trie, code, cb)`

Stores the code in the trie.

- `trie` - The [trie](https://github.com/ethereumjs/merkle-patricia-tree) storing the accounts.
- `code` - A `Buffer`.
- `cb` - The callback.

Example for `getCode` and `setCode`:

```javascript
// Requires manual merkle-patricia-tree install
const SecureTrie = require('merkle-patricia-tree/secure')
const Account = require('./index.js').default

let code = Buffer.from(
  '73095e7baea6a6c7c4c2dfeb977efac326af552d873173095e7baea6a6c7c4c2dfeb977efac326af552d873157',
  'hex',
)

let raw = {
  nonce: '',
  balance: '0x03e7',
  stateRoot: '0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421',
  codeHash: '0xb30fb32201fe0486606ad451e1a61e2ae1748343cd3d411ed992ffcc0774edd4',
}

let account = new Account(raw)
let trie = new SecureTrie()

account.setCode(trie, code, function(err, codeHash) {
  console.log(`Code with hash 0x${codeHash.toString('hex')} set to trie`)
  account.getCode(trie, function(err, code) {
    console.log(`Code ${code.toString('hex')} read from trie`)
  })
})
```

#### `account.getStorage(trie, key, cb)`

Fetches `key` from the account's storage.

#### `account.setStorage(trie, key, val, cb)`

Stores a `val` at the `key` in the contract's storage.

Example for `getStorage` and `setStorage`:

```javascript
// Requires manual merkle-patricia-tree install
const SecureTrie = require('merkle-patricia-tree/secure')
const Account = require('./index.js').default

let raw = {
  nonce: '',
  balance: '0x03e7',
  stateRoot: '0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421',
  codeHash: '0xb30fb32201fe0486606ad451e1a61e2ae1748343cd3d411ed992ffcc0774edd4',
}

let account = new Account(raw)
let trie = new SecureTrie()

let key = Buffer.from('0000000000000000000000000000000000000000', 'hex')
let value = Buffer.from('01', 'hex')

account.setStorage(trie, key, value, function(err, value) {
  account.getStorage(trie, key, function(err, value) {
    console.log(`Value ${value.toString('hex')} set and retrieved from trie.`)
  })
})
```

---
_Source: https://npm.io/package/ethereumjs-account · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._