{"_id":"@nomicfoundation/ethereumjs-verkle","_rev":"12-352ee99c152d0657b3cca7017e8f721d","name":"@nomicfoundation/ethereumjs-verkle","dist-tags":{"latest":"0.0.2"},"versions":{"0.0.2":{"name":"@nomicfoundation/ethereumjs-verkle","version":"0.0.2","keywords":["verkle","tree","trie","ethereum"],"author":{"name":"EthereumJS Team"},"license":"MIT","_id":"@nomicfoundation/ethereumjs-verkle@0.0.2","maintainers":[{"name":"schaable","email":"schaable@gmail.com"},{"name":"nomic-foundation-publisher","email":"packages@nomic.foundation"},{"name":"fvictorio","email":"victorio.franco@gmail.com"},{"name":"alcuadrado","email":"email@patriciopalladino.com"}],"contributors":[{"url":"https://github.com/gabrocheleau","name":"Gabriel Rocheleau"}],"homepage":"https://github.com/ethereumjs/ethereumjs-monorepo/tree/master/packages/verkle#readme","bugs":{"url":"https://github.com/ethereumjs/ethereumjs-monorepo/issues?q=is%3Aissue+label%3A%22package%3A+verkle%22"},"dist":{"shasum":"7686689edec775b2efea5a71548f417c18f7dea4","tarball":"https://registry.npmjs.org/@nomicfoundation/ethereumjs-verkle/-/ethereumjs-verkle-0.0.2.tgz","fileCount":151,"integrity":"sha512-bjnfZElpYGK/XuuVRmLS3yDvr+cDs85D9oonZ0YUa5A3lgFgokWMp76zXrxX2jVQ0BfHaw12y860n1+iOi6yFQ==","signatures":[{"sig":"MEQCIChABNRFHTl3eN2qcHzwcBYssrgX3eNt/IV8rcRNiaE/AiAz7UYC52tNSY2O/kSJ0b4iqYLfEhR3yrsPBrYNdikOhg==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":338083},"main":"dist/cjs/index.js","type":"commonjs","types":"./dist/cjs/index.d.ts","module":"dist/esm/index.js","engines":{"node":">=18"},"gitHead":"95852c33f58e53f0656a92dc22f01a140f8d6605","scripts":{"tsc":"../../config/cli/ts-compile.sh","lint":"../../config/cli/lint.sh","test":"npm run test:node","build":"../../config/cli/ts-build.sh","clean":"../../config/cli/clean-package.sh","coverage":"npx vitest run --coverage.enabled --coverage.reporter=lcov","lint:fix":"../../config/cli/lint-fix.sh","lint:diff":"../../config/cli/lint-diff.sh","test:node":"npx vitest run","docs:build":"typedoc --options typedoc.cjs"},"_npmUser":{"name":"fvictorio","email":"victorio.franco@gmail.com"},"repository":{"url":"git+https://github.com/ethereumjs/ethereumjs-monorepo.git","type":"git"},"_npmVersion":"10.2.3","description":"Implementation of verkle trees as used in Ethereum.","directories":{},"_nodeVersion":"20.11.0","dependencies":{"lru-cache":"^10.0.0","rust-verkle-wasm":"^0.0.1","@nomicfoundation/ethereumjs-rlp":"5.0.4","@nomicfoundation/ethereumjs-util":"9.0.4"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ethereumjs-verkle_0.0.2_1707148314933_0.4875896233613539","host":"s3://npm-registry-packages"}}},"time":{"created":"2024-02-05T15:51:54.850Z","modified":"2026-09-14T13:00:11.017Z","0.0.2":"2024-02-05T15:51:55.132Z"},"bugs":{"url":"https://github.com/ethereumjs/ethereumjs-monorepo/issues?q=is%3Aissue+label%3A%22package%3A+verkle%22"},"author":{"name":"EthereumJS Team"},"license":"MIT","homepage":"https://github.com/ethereumjs/ethereumjs-monorepo/tree/master/packages/verkle#readme","keywords":["verkle","tree","trie","ethereum"],"repository":{"url":"git+https://github.com/ethereumjs/ethereumjs-monorepo.git","type":"git"},"description":"Implementation of verkle trees as used in Ethereum.","contributors":[{"url":"https://github.com/gabrocheleau","name":"Gabriel Rocheleau"}],"maintainers":[],"readme":"# @ethereumjs/verkle\n\n[![NPM Package][verkle-npm-badge]][verkle-npm-link]\n[![GitHub Issues][verkle-issues-badge]][verkle-issues-link]\n[![Actions Status][verkle-actions-badge]][verkle-actions-link]\n[![Code Coverage][verkle-coverage-badge]][verkle-coverage-link]\n[![Discord][discord-badge]][discord-link]\n\n| Implementation of [Verkle Trees](https://ethereum.org/en/roadmap/verkle-trees/) as specified in [EIP-6800](https://eips.ethereum.org/EIPS/eip-6800) |\n| --------------------------------------------------------------------------------------------------------------------------------------------------- |\n\n> Verkle trees are a cryptographic data structure proposed for use in Ethereum to optimize storage and transaction verification. They combine features of Merkle Patricia Tries and Vector Commitment Trees to offer efficient data verification with smaller proof sizes. The goal is to improve scalability and efficiency in Ethereum's network operations.\n\nThis package is currently in early alpha and is a work in progress. It is not intended for use in production environments, but rather for research and development purposes. Any help in improving the package is very much welcome.\n\n## Installation\n\nTo obtain the latest version, simply require the project using `npm`:\n\n```shell\nnpm install @ethereumjs/verkle\n```\n\n## Usage\n\n### Initialization and Basic Usage\n\n```ts\nimport { VerkleTree } from '@ethereumjs/verkle'\nimport { bytesToUtf8, utf8ToBytes } from '@ethereumjs/util'\n\nconst tree = new VerkleTree()\n\nasync function test() {\n  await tree.put(utf8ToBytes('test'), utf8ToBytes('one'))\n  const value = await tree.get(utf8ToBytes('test'))\n  console.log(value ? bytesToUtf8(value) : 'not found') // 'one'\n}\n\ntest()\n```\n\n## Proofs\n\n### Verkle Proofs\n\nThe EthereumJS Verkle package is still in its infancy, and as such, it does not currently support Verkle proof creation and verification. Support for Verkle proofs will be added eventually.\n\n## Examples\n\nYou can find additional examples complete with detailed explanations [here](./examples/README.md).\n\n## Browser\n\nWith the breaking release round in Summer 2023 we have added hybrid ESM/CJS builds for all our libraries (see section below) and have eliminated many of the caveats which had previously prevented frictionless browser usage.\n\nIt is now easily possible to run a browser build of one of the EthereumJS libraries within a modern browser using the provided ESM build. For a setup example see [./examples/browser.html](./examples/browser.html).\n\n## API\n\n### Docs\n\nGenerated TypeDoc API [Documentation](./docs/README.md)\n\n### Hybrid CJS/ESM Builds\n\nWith the breaking releases from Summer 2023 we have started to ship our libraries with both CommonJS (`cjs` folder) and ESM builds (`esm` folder), see `package.json` for the detailed setup.\n\nIf you use an ES6-style `import` in your code, files from the ESM build will be used:\n\n```ts\nimport { EthereumJSClass } from '@ethereumjs/[PACKAGE_NAME]'\n```\n\nIf you use Node.js-specific `require`, the CJS build will be used:\n\n```ts\nconst { EthereumJSClass } = require('@ethereumjs/[PACKAGE_NAME]')\n```\n\nUsing ESM will give you additional advantages over CJS beyond browser usage like static code analysis / Tree Shaking, which CJS cannot provide.\n\n## References\n\n- Wiki\n  - [Overview of verkle trees](https://ethereum.org/en/roadmap/verkle-trees/)\n  - [Verkle trees general resource](https://verkle.info/)\n\n## EthereumJS\n\nSee our organizational [documentation](https://ethereumjs.readthedocs.io) for an introduction to `EthereumJS` as well as information on current standards and best practices. If you want to join for work or carry out improvements on the libraries, please review our [contribution guidelines](https://ethereumjs.readthedocs.io/en/latest/contributing.html) first.\n\n## License\n\n[MIT](https://opensource.org/licenses/MIT)\n\n[discord-badge]: https://img.shields.io/static/v1?logo=discord&label=discord&message=Join&color=blue\n[discord-link]: https://discord.gg/TNwARpR\n[verkle-npm-badge]: https://img.shields.io/npm/v/@ethereumjs/verkle.svg\n[verkle-npm-link]: https://www.npmjs.com/package/@ethereumjs/verkle\n[verkle-issues-badge]: https://img.shields.io/github/issues/ethereumjs/ethereumjs-monorepo/package:%20verkle?label=issues\n[verkle-issues-link]: https://github.com/ethereumjs/ethereumjs-monorepo/issues?q=is%3Aopen+is%3Aissue+label%3A\"package%3A+verkle\"\n[verkle-actions-badge]: https://github.com/ethereumjs/ethereumjs-monorepo/workflows/Verkle/badge.svg\n[verkle-actions-link]: https://github.com/ethereumjs/ethereumjs-monorepo/actions?query=workflow%3A%22Verkle%22\n[verkle-coverage-badge]: https://codecov.io/gh/ethereumjs/ethereumjs-monorepo/branch/master/graph/badge.svg?flag=verkle\n[verkle-coverage-link]: https://codecov.io/gh/ethereumjs/ethereumjs-monorepo/tree/master/packages/verkle\n","readmeFilename":"README.md"}