mirror of https://github.com/bitcoinj/bitcoinj.git synced 2025-03-13 11:36:15 +01:00

Sean Gilligan e7545cafe3 modular-architecture.md: show SLF4J and JSpecify as dependencies of base

This is just a informational change. In the interest of keeping
the diagram simple, I have not been showing multiple links to minor direct
dependencies. But this change chooses to display SLF4J & JSpecify as
direct dependencies of `base`. This makes it more clear that
`base`, `core` and `wallet` all will depend on them. The diagram
still "lies" a little bit in not showing that they are also direct
dependencies, but I think that is an acceptable tradeoff for a diagram
that is easier to read.

2025-03-01 12:17:27 +01:00

4.1 KiB

Raw Blame History

Migration to a more modular bitcoinj architecture

Note: Packages that are not significant or are not changing are not shown (and are generally expected to remain in the core module/JAR).

Legend: Dashed lines represent Gradle "implementation" dependencies. Solid lines represent Gradle "api" dependencies (or internal package dependencies.)

bitcoinj 0.16.x (previous release)

flowchart TD
    E[examples] --> CORE
    T[tools] --> CORE
    FX[wallettemplate] --> CORE
    subgraph CORE [bitcoinj-core]
        W[o.b.wallet] --> CO
        W --> CR
        CO[o.b.core] --> CR
        CO --> W
        CR[o.b.crypto] --> CO
        CR --> W
    end
    CORE --> G[Guava]
    CORE --> BC[Bouncy Castle]
    CORE --> P[ProtoBuf]
    CORE .-> S[slf4j]
    CORE .-> A[jcip-annotations]

classDef external fill:#999;
class G,S,A,BC,P external;

bitcoinj 0.17

In release 0.17 there has been a large amount of refactoring to prepare the o.b.base and o.b.crypto packages to become independent modules/JARs in the following release. Those packages will still contain some deprecated methods that depend on other internal packages and external modules. Those deprecated methods will be removed in release 0.18 when o.b.base and o.b.crypto are moved to their own modules.

flowchart TD
    E[examples] --> CORE
    IT[integration-test] --> CORE
    T[tools] --> CORE
    FX[wallettemplate] --> CORE
    WT[wallettool] --> CORE
    subgraph CORE [bitcoinj-core]
        W[o.b.wallet] --> CO[o.b.core]
        CO --> W
        W --> CR
        CO --> CR
        CO --> B[o.b.base]
        CR[o.b.crypto] --> B
    end
    CORE --> G[Guava]
    CORE --> P[ProtoBuf]
    CORE --> BC[Bouncy Castle]
    CORE .-> S[slf4j]
    CORE .-> A[jcip-annotations]

classDef external fill:#999;
class G,S,A,BC,P external;

bitcoinj 0.18 (current plan)

In this release the bitcoinj-base module will be a standalone module with minimal external dependencies. All use of Elliptic Curve Cryptography will be factored out to use the secp-api module from secp256k1-jdk with API implementations provided for Bouncy Castle and (hopefully) the secp256k1 native ('C') library.

flowchart TD
    EJ[examples] --> CORE
    EK[examples-kotlin] --> CORE
    IT[integration-test] --> CORE
    T[tools] --> CORE
    FX[wallettemplate] --> CORE
    WT[wallettool] --> CORE
    subgraph CORE [bitcoinj-core]
        CO --> W
        W[o.b.wallet] --> CO[o.b.core]
        W --> CR[o.b.crypto]
        CO --> CR
    end
    CORE --> BASE
    subgraph BASE [bitcoinj-base]
        B[o.b.base]
    end
    CORE --> SECP[secp-api]
    SECP .-> SECPBC[secp-bouncy]
    SECP .-> SECPFFM[secp-ffm]
    SECPBC --> BC[Bouncy Castle]
    SECPFFM --> SECPC[libsecp256k1]
    CORE --> P[ProtoBuf]
    BASE .-> S[slf4j]
    BASE .-> JS[JSpecify]

classDef external fill:#999;
class G,S,JS,BC,SECPC,P external;

bitcoinj 0.19 (proposed)

In a proposed 0.19 release, we hope to do the following:

Separate the current ProtoBuf-based wallet implementation into it's own module. This will require creating a Wallet interface in core.
Eliminate dependencies on Guava for all modules.

Stretch goal:

Alternate wallet implementation, perhaps using SQLite.

flowchart TD
    E[examples] --> WALLET
    EK[examples-kotlin] --> WALLET
    IT[integration-test] --> WALLET
    T[tools] --> WALLET
    FX[wallettemplate] --> WALLET
    WT[wallettool] --> WALLET
    subgraph WALLET [bitcoinj-wallet-protobuf]
        W[o.b.wallet]
    end
    WALLET --> CORE
    WALLET --> P[ProtoBuf]
    subgraph CORE [bitcoinj-core]
        CO[o.b.core] --> CR[o.b.crypto]
    end
    CORE --> BASE
    CORE --> SECP
    BASE .-> S[slf4j]
    BASE .-> JS[JSpecify]
    SECP[secp-api] .-> SECPFFM[secp-ffm]
    SECP .-> SECPBOUNCY[secp-bouncy]
    SECPBOUNCY .-> BC[Bouncy Castle]
    SECPFFM .-> LP[libsecp256k1]
    subgraph BASE [bitcoinj-base]
        B[o.b.base]
    end

classDef external fill:#999;
class G,S,JS,BC,LP,P external;

4.1 KiB Raw Blame History