ganchix / testcontainers-java-module-ganache

Testcontainers module for Ganache CLI

TestContainers Ganache testing module

Testcontainers module for Ganache.

Table of Contents

• Overview
• Getting started
• Considerations
• License

Overview

A simple way to test Ethereum in your Java Code

See testcontainers.org for more information about Testcontainers.

Getting started

Add dependency

Maven

<dependency>
    <groupId>io.github.ganchix</groupId>
    <artifactId>testcontainers-java-module-ganache</artifactId>
    <version>0.0.4</version>
</dependency>

Gradle

compile group: 'io.github.ganchix', name: 'testcontainers-java-module-ganache', version: '0.0.4'

Code example

Running Ganache during a test:

public class SomeTest {


	@Rule
	public GanacheContainer GanacheContainer = new GanacheContainer();

    
	@Test
	public void simpleTestWithClientCreation() {
            Web3j web3j = ganacheContainer.getWeb3j();
            assertEquals( web3j.ethBlockNumber().send().getBlockNumber(), BigInteger.ZERO);
            assertNotNull(ganacheContainer);
	}
}

Considerations

To obtain the data of addresses and privates keys of console log we implemented a custom log consumer LogGanacheExtractorConsumer, if you overwrite it this information will not be extracted.

License

Testcontainers module for Ganache is licensed under the MIT License. See LICENSE for details.

Copyright (c) 2018 Rafael Ríos Moya