Connex is the standard interface to connect dApps with VeChain blockchain and users. Aiming to help developers building decentralized applications.


Installing connex into your web-based applications.

Include in <script> tag

Just include the CDN link within a script tag. Connex will then be registered as a global variable.
<!-- install the latest v2 -->
<script src="[email protected]" />


It's recommended when your project is a bit large.
npm i @vechain/connex
import Connex from '@vechain/connex'


Create a Connex object connects to VeChain mainnet

const connex = new Connex({
node: '', // veblocks public node, use your own if needed
network: 'main' // defaults to mainnet, so it can be omitted here

Connect to testnet

const connex = new Connex({
node: '',
network: 'test'

Or connect to a private network

const connex = new Connex({
node: '<the API url of your node>',
// the genesis block of your private network
network: {
id: '0x...',

Create Vendor module only

In some cases, e.g. the classic 'Buy me a coffee' demo, you don't need the ability to access the blockchain. You can opt-out Connex.Thor module, and just create Connex.Vendor module.
const vendor = new Connex.Vendor('main') // 'main','test' or genesis ID if it's private network

Using in Node.js environment

This package, @vechain/connex is designed only working in browser, if you are interested running it in Node.js, try @vechain/connex-framework.


Package @vechain/connex-repl provides a quick way to try out connex interface.

Source Code

  • connex: The out of the box Connex implementation for browser.
  • framework: Implements Connex interface.
  • driver: Implements Connex.Driver interface.
  • repl: The REPL style command-line playground.
  • types: Connex interface declarations presented in Typescript.