Project Structure

HyperBEAM/
├── src/                 # Erlang source (137 modules)
├── include/             # Header files (.hrl)
├── test/                # Test files and fixtures
├── native/              # Rust/C native code (NIFs)
├── priv/                # Runtime resources
├── scripts/             # Lua scripts
├── docs/                # Documentation
├── certificates/        # AMD SEV-SNP certificates
├── rebar.config         # Build configuration
├── rebar.lock           # Dependency lock
├── Makefile             # Native build automation
└── config.flat          # Node configuration

ar_wallet.erl        # Key generation, signing, addresses
ar_tx.erl            # Layer 1 transactions
ar_bundles.erl       # ANS-104 data items
ar_deep_hash.erl     # Recursive SHA-384 hashing
ar_timestamp.erl     # Network time sync
ar_rate_limiter.erl  # Gateway throttling
rsa_pss.erl          # RSA-PSS signatures

hb.erl               # Entry point and top-level API
hb_ao.erl            # Core protocol (resolve/3 routes all requests)
hb_message.erl       # Message creation, signing, IDs
hb_cache.erl         # Content-addressed caching
hb_store.erl         # Abstract storage interface
hb_store_lmdb.erl    # LMDB backend (default)
hb_http_server.erl   # Cowboy HTTP handlers
hb_opts.erl          # Hierarchical configuration

dev_message.erl      # Default message device (simplest)
dev_stack.erl        # Device pipelines
dev_wasm.erl         # WebAssembly execution
dev_process.erl      # Stateful computation
dev_scheduler.erl    # Deterministic ordering
dev_codec_*.erl      # Format transformation (14 codecs)

-record(tx, {
    format = ans104,           % Transaction format
    id = ?DEFAULT_ID,          % 32-byte transaction ID
    owner = ?DEFAULT_OWNER,    % 512-byte RSA public key
    tags = [],                 % [{Key, Value}] metadata
    target = ?DEFAULT_TARGET,  % Recipient address
    quantity = 0,              % Amount in Winstons
    data = ?DEFAULT_DATA,      % Payload
    signature = ?DEFAULT_SIG   % 512-byte RSA signature
}).
 
-define(HASH_ALG, sha256).
-define(RSA_PRIV_KEY_SZ, 4096).

-include("ar.hrl").
 
-define(HYPERBEAM_VERSION, 0.9).
 
%% Message validation
-define(IS_ID(X), 
    (is_binary(X) andalso (byte_size(X) == 43 orelse byte_size(X) == 32))).
 
-define(IS_EMPTY_MESSAGE(Msg), 
    (map_size(Msg) == 0) orelse 
    (map_size(Msg) == 1 andalso is_map_key(priv, Msg))).
 
%% Logging (auto-captures module, function, line)
-define(event(X), 
    hb_event:log(global, X, ?MODULE, ?FUNCTION_NAME, ?LINE)).
 
%% Debugging
-define(p(X), io:format("~p~n", [X])).
-define(h(), io:format("--- ~p:~p:~p ---~n", [?MODULE, ?FUNCTION_NAME, ?LINE])).

-define(IS_ALPHA(C), (C >= $a andalso C =< $z) orelse (C >= $A andalso C =< $Z)).
-define(IS_DIGIT(C), (C >= $0 andalso C =< $9)).
-define(IS_TOKEN(C), ?IS_ALPHA(C) orelse ?IS_DIGIT(C) orelse ...).
-define(IS_WS(C), (C =:= $\s) orelse (C =:= $\t)).

-define(load_nif_from_crate(__CRATE, __INIT),
    (fun() ->
        __PATH = filename:join([code:priv_dir(hb), "crates", __CRATE, __CRATE]),
        erlang:load_nif(__PATH, __INIT)
    end)()).

{deps, [
    {cowboy, "2.14.0"},              % HTTP server
    {gun, "2.2.0"},                  % HTTP client
    {elmdb, {git, "..."}},           % LMDB bindings (Rust)
    {luerl, "1.3.0"},                % Lua interpreter
    {prometheus, "6.0.3"}            % Metrics
]}.
 
{port_specs, [
    {"./priv/hb_beamr.so", ["./native/hb_beamr/*.c"]},  % WASM runtime
    {"./priv/hb_keccak.so", ["./native/hb_keccak/*.c"]} % Keccak hashing
]}.

WAMR_VERSION = 2.2.0
 
wamr: $(WAMR_DIR)/lib/libvmlib.a    # Build WAMR library
setup-genesis-wasm:                  # Clone and setup Genesis WASM

# Default (LMDB storage, HTTP/1.1 + HTTP/2)
rebar3 shell
 
# With RocksDB storage
rebar3 as rocksdb shell
 
# With Genesis WASM runtime
rebar3 as genesis_wasm shell
 
# Multiple profiles
rebar3 as rocksdb,genesis_wasm shell

native/
├── dev_snp_nif/     # AMD SEV-SNP attestation
└── elmdb_nif/       # LMDB database bindings