Getting Started¶

Prerequisites¶

Clang with C++20 support
Meson and Ninja
Conan 2.x
mise (optional, for environment management)

Setup¶

1. Environment¶

If using mise, the included .mise.toml sets CC=clang and CXX=clang++ automatically:

mise trust
mise install

2. Install Conan dependencies¶

A clang profile is included in the repo:

conan install . --profile=conan_clang_profile --output-folder=build --build=missing

3. Build¶

CC=clang CXX=clang++ meson setup build \
  --native-file build/conan_meson_native.ini \
  --pkg-config-path build \
  --wrap-mode=default

ninja -C build

libsecp256k1 is fetched and built automatically as a meson subproject on first configure.

4. Test¶

# Run doctest unit tests
ninja -C build test

# Run viem cross-validation (requires Node.js)
cd tests/viem_compare
npm install
node --experimental-strip-types compare.ts

Using ingot in your project¶

As a meson subproject¶

Create subprojects/ingot.wrap:

[wrap-git]
url = https://github.com/noahdahlman/ingot.git
revision = main
depth = 1

[provide]
ingot = ingot_dep

Then in your meson.build:

ingot_dep = dependency('ingot',
  fallback: ['ingot', 'ingot_dep'],
)

Manual integration¶

ingot is a single static library (libingot.a) plus headers. Point your include path at include/ and link against libingot.a and libsecp256k1.