Tokencore

Tokencore is a Java multi-chain wallet core library for exchange backends, custody systems, and wallet services.

What Tokencore provides

Multi-chain address generation
HD wallet derivation and mnemonic workflows
Encrypted keystore management
Offline transaction signing for major chain families

Supported chains include:

EVM: Ethereum (built-in), plus any EVM chain you register at runtime (chainId, default BIP44 path)
Bitcoin family: Bitcoin, Litecoin, Dogecoin, Dash, Bitcoin Cash, Bitcoin SV, plus bitcoin-style UTXO chains registered with address/BIP32 headers
Others: TRON, Filecoin, EOS

Global chain support (registry + catalog)

Tokencore does not ship an authoritative list of every network in the world. Instead it provides:

ChainRegistry: register EVM chains (EvmChainRegistration) and bitcoin-style UTXO chains (UtxoChainRegistration + CustomBitcoinStyleNetParams).
ChainCatalogLoader: bulk-register from a JSON array (e.g. app-shipped file or data filtered from chainlist).
Wallet identity: multiple EVM chains share the same address for the same key; wallets are keyed by (chainType, address) — use a unique chainType string per chain (e.g. POLYGON, ARBITRUM_ONE).

import org.consenlabs.tokencore.wallet.chain.*;
import org.consenlabs.tokencore.wallet.model.BIP44Util;
// Single EVM L2 ChainRegistry.getInstance().registerEvm(     new EvmChainRegistration("MYL2", 84532L, BIP44Util.defaultEvmAccountZeroPath(60)));
// Bulk from JSON: [ { "chainType": "...", "family": "EVM", "chainId": 1, "slip44": 60 } ] ChainCatalogLoader.registerAllFromJson("[...]");

EIP-1559 (type-2): use org.consenlabs.tokencore.wallet.transaction.Eip1559Transaction (raw tx = 0x02 || rlp(...)).

EIP-712: Eip712Hasher.hashTypedDataV4(JsonNode) and TypedDataSigner.signTypedDataV4(JsonNode, privateKeyBytes).

Core Features (Recommended Minimum)

Java 8+
Gradle wrapper included (./gradlew)

Install

Gradle

repositories {
    maven { url 'https://jitpack.io' }
}
dependencies {     implementation 'com.github.galaxyscitech:tokencore:2.0.1' }

Maven

<repositories>
  <repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
  </repository>
</repositories>
<dependency>   <groupId>com.github.galaxyscitech</groupId>   <artifactId>tokencore</artifactId>   <version>2.0.1</version> </dependency>

Quick start (runnable)

import org.consenlabs.tokencore.foundation.utils.MnemonicUtil;
import org.consenlabs.tokencore.wallet.*;
import org.consenlabs.tokencore.wallet.model.*;
import java.io.File;
public class QuickStart {   public static void main(String[] args) {     WalletManager.storage = () -> new File("./keystore");     WalletManager.scanWallets();
String password = "UseAStrongPassword_123";     Identity identity = Identity.getCurrentIdentity();     if (identity == null) {       identity = Identity.createIdentity("main", password, "", Network.MAINNET, Metadata.P2WPKH);     }
Wallet ethWallet = identity.deriveWalletByMnemonics(       ChainType.ETHEREUM,       password,       MnemonicUtil.randomMnemonicCodes()     );
Wallet btcWallet = identity.deriveWalletByMnemonics(       ChainType.BITCOIN,       password,       MnemonicUtil.randomMnemonicCodes()     );
System.out.println("ETH address: " + ethWallet.getAddress());     System.out.println("BTC address: " + btcWallet.getAddress());   } }

Common usage

1) Import wallet from private key

Metadata metadata = new Metadata();
metadata.setChainType(ChainType.ETHEREUM);
metadata.setSource(Metadata.FROM_PRIVATE);
metadata.setNetwork(Network.MAINNET);
Wallet wallet = WalletManager.importWalletFromPrivateKey(   metadata,   "4c0883a69102937d6231471b5dbb6204fe512961708279f14a15c89a7e5a5c3c",   "password123",   true );

2) Import wallet from mnemonic

Metadata metadata = new Metadata();
metadata.setChainType(ChainType.DOGECOIN);
metadata.setSource(Metadata.FROM_MNEMONIC);
metadata.setNetwork(Network.MAINNET);
metadata.setSegWit(Metadata.NONE);
Wallet wallet = WalletManager.importWalletFromMnemonic(   metadata,   "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about",   BIP44Util.DOGECOINMAINNETPATH,   "password123",   true );

3) Find wallet by mnemonic (BTC-family friendly)

Wallet wallet = WalletManager.findWalletByMnemonic(
  ChainType.DOGECOIN,
  Network.MAINNET,
  "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about",
  BIP44Util.DOGECOINMAINNETPATH,
  Metadata.NONE
);

4) Export keystore and recover by keystore

String keystoreJson = WalletManager.exportKeystore(wallet.getId(), "password123");
Wallet found = WalletManager.findWalletByKeystore(ChainType.ETHEREUM, keystoreJson, "password123");