Jabit is a Bitmessage library for the Java environment, written in Kotlin. It is used by both Abit and Jabit-Server, and it shouldn’t be too hard to create your own Bitmessage client with it. https://dissem.ch/jabit/
Go to file
Christian Basler ea700755b6 Update .travis.yml
Another try
2016-02-03 17:17:31 +01:00
core Made TTLs easily changeable (albeit not for specific messages) 2016-02-02 21:05:14 +01:00
cryptography-bc Made TTLs easily changeable (albeit not for specific messages) 2016-02-02 21:05:14 +01:00
cryptography-sc Renamed module 'domain' to 'core' to make its purpose more clear 2016-01-17 05:42:49 +01:00
demo Made TTLs easily changeable (albeit not for specific messages) 2016-02-02 21:05:14 +01:00
extensions Renamed module 'domain' to 'core' to make its purpose more clear 2016-01-17 05:42:49 +01:00
gradle/wrapper Some improvements for custom message handling 2015-12-02 17:45:50 +01:00
networking Finally fixed the bug that was haunting me for the last week. 2016-01-21 20:32:23 +01:00
repositories Version 1.0.1-SNAPSHOT - fixed issue with requesting pubkey, and problem where your keys are overwritten if you try to import a contact again or worse, your identity as a contact 2016-01-31 18:11:20 +01:00
wif Renamed module 'domain' to 'core' to make its purpose more clear 2016-01-17 05:42:49 +01:00
.gitignore Added some improvements to the demo application 2015-06-11 21:02:01 +02:00
.travis.yml Update .travis.yml 2016-02-03 17:17:31 +01:00
Bitmessage.uml Updated UML diagram 2016-01-19 21:07:26 +01:00
CONTRIBUTING.md Added CONTRIBUTING.md 2016-01-23 17:19:36 +01:00
LICENSE Some basic entities and project structure 2015-03-20 14:18:29 +01:00
README.md Update README.md 2016-01-29 11:06:39 +01:00
build.gradle Version 1.0.1-SNAPSHOT - fixed issue with requesting pubkey, and problem where your keys are overwritten if you try to import a contact again or worse, your identity as a contact 2016-01-31 18:11:20 +01:00
gradle.properties now the build should work for anyone (esp. travis) 2015-07-04 11:13:35 +02:00
gradlew Some basic entities and project structure 2015-03-20 14:18:29 +01:00
gradlew.bat Some basic entities and project structure 2015-03-20 14:18:29 +01:00
settings.gradle Renamed module 'domain' to 'core' to make its purpose more clear 2016-01-17 05:42:49 +01:00

README.md

Jabit Build Status

A Java implementation for the Bitmessage protocol. To build, use command gradle build or ./gradlew build.

Please note that development is still heavily in progress, and I will break the database a lot until it's ready for prime time.

Security

There are most probably some security issues, me programming this thing all by myself. Jabit doesn't do anything against timing attacks yet, for example. Please feel free to use the library, report bugs and maybe even help out. I hope the code is easy to understand and work with.

Project Status

Basically, everything needed for a working Bitmessage client is there:

  • Creating new identities (private addresses)
  • Adding contracts and subscriptions
  • Receiving broadcasts
  • Receiving messages
  • Sending messages and broadcasts
  • Managing outgoing and incoming connections
  • Initialise and manage a registry of Bitmessage network nodes
  • An easy to use API
  • A command line demo application built using the API

Setup

Add Jabit as Gradle dependency:

compile 'ch.dissem.jabit:jabit-core:1.0.0'

Unless you want to implement your own, also add the following:

compile 'ch.dissem.jabit:jabit-networking:1.0.0'
compile 'ch.dissem.jabit:jabit-repositories:1.0.0'
compile 'ch.dissem.jabit:jabit-cryptography-bouncy:1.0.0'

And if you want to import from or export to the Wallet Import Format (used by PyBitmessage) you might also want to add:

compile 'ch.dissem.jabit:jabit-wif:1.0.0'

For Android clients use jabit-cryptography-spongy instead of jabit-cryptography-bouncy.

Usage

First, you'll need to create a BitmessageContext:

JdbcConfig jdbcConfig = new JdbcConfig();
BitmessageContext ctx = new BitmessageContext.Builder()
        .addressRepo(new JdbcAddressRepository(jdbcConfig))
        .inventory(new JdbcInventory(jdbcConfig))
        .messageRepo(new JdbcMessageRepository(jdbcConfig))
        .nodeRegistry(new MemoryNodeRegistry())
        .networkHandler(new NetworkNode())
        .cryptography(new BouncyCryptography())
        .build();

This creates a simple context using a H2 database that will be created in the user's home directory. Next you'll need to start the context and decide what happens if a message arrives:

ctx.startup(new BitmessageContext.Listener() {
    @Override
    public void receive(Plaintext plaintext) {
        // TODO: Notify the user
    }
});

Then you might want to create an identity

BitmessageAddress identity = ctx.createIdentity(false, Pubkey.Feature.DOES_ACK);

or add some contacts

BitmessageAddress contact = new BitmessageAddress("BM-2cTarrmjMdRicKZ4qQ8A13JhoR3Uq6Zh5j");
address.setAlias("Chris");
ctx.addContact(contact);

to which you can send some messages

ctx.send(identity, contact, "Test", "Hello Chris, this is a message.");