bam-sdk test app

Surfaces every browser-safe export of the bam-sdk package as a poke-the-button playground. Demo data is prefilled so each function is one click from a result.

Protocol version 0.1 · entrypoint bam-sdk/browser

Hex Helpers

hexToBytes / bytesToHex — strict (throws on odd length / non-hex chars).

hex string

utf-8 text

Message Primitives

computeMessageHash / computeMessageId (ERC-8180). `contents` is an opaque app body; `contentTag` is supplied separately and bound into the hash.

sender (20-byte address)contentTag (32-byte hex)nonce (uint64)contents (utf-8 body)

batchContentHash (32-byte hex — versionedHash or keccak256(batchData))

ECDSA — Scheme 0x01 (EIP-712 over BAMMessage)

Headless: generateECDSAPrivateKey, signECDSAWithKey, verifyECDSA. Wallet: signECDSA against an injected viem WalletClient.

contents (utf-8 body — shared by both paths; contentTag is bound separately)

Headless (signECDSAWithKey)

private key (0x..., 32 bytes)derived address (read-only)chainId (headless only — wallet path uses the connected chain)

Wallet (signECDSA via viem WalletClient)

No injected wallet detected. Install MetaMask / Rabby / similar to enable this path.

verifyECDSA

signature (65 bytes, r ‖ s ‖ v) — populated by either sign button

Verifies against (no sender) on chain 11155111. Routing follows the path that produced the current signature (manual / headless fallback); editing the box by hand falls back to the headless inputs.

BLS — Scheme 0x02 building blocks

generateBLSPrivateKey / deriveBLSPublicKey / signBLS / verifyBLS / aggregateBLS / verifyAggregateBLS

messageHash A (32-byte hex)messageHash B (32-byte hex)

Note: BLS sign/verify are async. Hex helpers reachable via bytesToHex/hexToBytes (used internally: 0xaaaaaaaaaaaaaaaa…).

Batch Codec

encodeBatch / decodeBatch / estimateBatchSize. Each line below becomes a message; a fresh ECDSA key signs it.

messages (one per line)chainId

Exposure Batch

buildRawMessageBytes / encodeExposureBatch / decodeExposureBatch — on-chain raw layout for KZG-verifiable exposure.

sender (20-byte address)single content (utf-8)messages (one per line)

BPE Codec

buildBPEDictionary / serializeBPEDictionary / bpeEncode / bpeDecode — pure-TS 12-bit byte-pair encoder.

training corpusinput to encode (utf-8)

roundtrip helper: hexToBytes reachable for manual testing.1

BPE Batch Codec

encodeBatchBPE / decodeBatchBPE — wire format read by the on-chain BPEDecoder. Pick a dictionary source (built locally, bundled v1, or fetched from the deployed Sepolia BPEDictionary), then encode and optionally decode via eth_call on the matching deployed decoder.

training corpus (used only by buildBPEDictionary)

the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob the quick brown fox jumps over the lazy dog. pack my box with five dozen liquor jugs. how vexingly quick daft zebras jump! sphinx of black quartz, judge my vow. bam blob bam blob

messages (one per line)

signature modesigUnitSizechainId

Compression (Zstd)

decompress / isCompressed / getDecompressedSize / compressionRatio. Compression itself is Node-only in the SDK today; decompress runs in the browser via fzstd.

zstd-framed bytes (hex) — paste output from a node-side compress()

original size (bytes)compressed size (bytes)

Wallet flows (signECDSA) and KZG proofs (kzg/, parseBlobForMessages, buildExposureParams) are excluded from the browser entrypoint and not surfaced here. Run those from the Node-side bundles or the existing message-in-a-blobble app.