3 echo "USAGE: path/to/ldk-c-bindings [wasm|\"JNI_CFLAGS\"] debug android_web"
4 echo "For JNI_CFLAGS you probably want -I/usr/lib/jvm/java-11-openjdk-amd64/include/ -I/usr/lib/jvm/java-11-openjdk-amd64/include/linux/"
5 echo "If JNI_CFLAGS is instead set to wasm, we build for wasm/TypeScript instead of Java"
6 echo "debug should either be true, false, or leaks"
7 echo "debug of leaks turns on leak tracking on an optimized release bianry"
8 echo "android_web should either be true or false and indicates if we build for android (Java) or web (WASM)"
9 echo "Note that web currently generates the same results as !web (ie Node.JS)"
12 [ "$1" = "" ] && usage
13 [ "$3" != "true" -a "$3" != "false" -a "$3" != "leaks" ] && usage
14 [ "$4" != "true" -a "$4" != "false" ] && usage
19 function is_gnu_sed(){
20 sed --version >/dev/null 2>&1
23 if [ "$CC" = "" ]; then
27 TARGET_STRING="$LDK_TARGET"
28 if [ "$TARGET_STRING" = "" ]; then
29 # We assume clang-style $CC --version here, but worst-case we just get an empty suffix
30 TARGET_STRING="$($CC --version | grep Target | awk '{ print $2 }')"
36 [ "$($CC --version | grep apple-darwin)" != "" ] && IS_MAC=true
38 [ "$($CC --version | grep "Apple clang version")" != "" ] && IS_APPLE_CLANG=true
41 [ "$IS_APPLE_CLANG" = "true" ] && STRIP=echo
43 case "$TARGET_STRING" in
45 LDK_TARGET_SUFFIX="_Linux-amd64"
46 CS_PLATFORM_NAME="linux-x64"
49 "x86_64-redhat-linux"*)
50 LDK_TARGET_SUFFIX="_Linux-amd64"
51 CS_PLATFORM_NAME="linux-x64"
54 "x86_64-apple-darwin"*)
55 LDK_TARGET_SUFFIX="_MacOSX-x86_64"
56 CS_PLATFORM_NAME="osx-x64"
60 "aarch64-apple-darwin"*)
61 LDK_TARGET_CPU="apple-a14"
62 LDK_TARGET_SUFFIX="_MacOSX-aarch64"
63 CS_PLATFORM_NAME="osx-arm64"
68 LDK_TARGET_SUFFIX="_Win-amd64"
69 CS_PLATFORM_NAME="win-x64"
72 # llvm-strip currently corrupts DLLs - https://github.com/llvm/llvm-project/issues/63081
76 LDK_TARGET_SUFFIX="_${TARGET_STRING}"
78 if [ "$LDK_TARGET_CPU" = "" ]; then
79 LDK_TARGET_CPU="sandybridge"
82 COMMON_COMPILE="$CC -std=c11 -Wall -Wextra -Wno-unused-parameter -Wno-ignored-qualifiers -Wno-unused-function -Wno-nullability-completeness -Wno-pointer-sign -Wdate-time -ffile-prefix-map=$(pwd)="
84 if [[ "$TARGET_STRING" != *"android" ]]; then
85 [[ "$TARGET_STRING" != "x86"* ]] && COMMON_CC="$COMMON_CC --target=$TARGET_STRING -mcpu=$LDK_TARGET_CPU"
86 [[ "$TARGET_STRING" = "x86"* ]] && COMMON_CC="$COMMON_CC --target=$TARGET_STRING -march=$LDK_TARGET_CPU -mtune=$LDK_TARGET_CPU"
88 [ "$IS_MAC" = "true" -a "$MACOS_SDK" != "" ] && COMMON_COMPILE="$COMMON_COMPILE -isysroot $MACOS_SDK"
91 if [ "$3" = "leaks" ]; then
95 cp "$1/lightning-c-bindings/include/lightning.h" ./
97 sed -i "s/TransactionOutputs/C2Tuple_ThirtyTwoBytesCVec_C2Tuple_u32TxOutZZZ/g" ./lightning.h
99 # OSX sed is for some reason not compatible with GNU sed
100 sed -i '' "s/TransactionOutputs/C2Tuple_ThirtyTwoBytesCVec_C2Tuple_u32TxOutZZZ/g" ./lightning.h
102 echo "#define LDKCVec_C2Tuple_ThirtyTwoBytesCVec_C2Tuple_u32TxOutZZZZ LDKCVec_TransactionOutputsZ" > header.c
103 echo "#define CVec_C2Tuple_ThirtyTwoBytesCVec_C2Tuple_u32TxOutZZZZ_free CVec_TransactionOutputsZ_free" >> header.c
106 if [ "$LDK_GARBAGECOLLECTED_GIT_OVERRIDE" = "" ]; then
107 export LDK_GARBAGECOLLECTED_GIT_OVERRIDE=$(git describe --tag --dirty)
109 if [ "${LDK_GARBAGECOLLECTED_GIT_OVERRIDE:0:1}" != "v" ]; then
110 echo "Version tag should start with a v" > /dev/stderr
115 if [ "$2" = "c_sharp" ]; then
116 echo "Creating C# bindings..."
117 mkdir -p c_sharp/src/org/ldk/{enums,structs,impl}
118 rm -f c_sharp/src/org/ldk/{enums,structs,impl}/*.cs
119 GEN_PLAT="c_sharp-linux"
120 [ "$IS_WIN" = "true" ] && GEN_PLAT="c_sharp-win"
121 [ "$IS_MAC" = "true" ] && GEN_PLAT="c_sharp-darwin"
122 ./genbindings.py "./lightning.h" c_sharp/src/org/ldk/impl c_sharp/src/org/ldk c_sharp/ $DEBUG_ARG $GEN_PLAT $4 $TARGET_STRING
123 rm -f c_sharp/bindings.c
124 if [ "$3" = "true" ]; then
125 echo "#define LDK_DEBUG_BUILD" > c_sharp/bindings.c
126 elif [ "$3" = "leaks" ]; then
127 # For leak checking we use release libldk which doesn't expose
128 # __unmangle_inner_ptr, but the C code expects to be able to call it.
129 echo "#define __unmangle_inner_ptr(a) (a)" > c_sharp/bindings.c
131 cat header.c >> c_sharp/bindings.c
132 cat header.c >> c_sharp/bindings.c
133 cat c_sharp/bindings.c.body >> c_sharp/bindings.c
136 sed -i "s/<version>.*<\/version>/<version>${LDK_GARBAGECOLLECTED_GIT_OVERRIDE:1:100}<\/version>/g" c_sharp/packaging_artifacts/org.ldk.nuspec
137 sed -i "s/<version>.*<\/version>/<version>${LDK_GARBAGECOLLECTED_GIT_OVERRIDE:1:100}<\/version>/g" c_sharp/packaging_artifacts/package/services/metadata/core-properties/ldk.psmdcp
139 # OSX sed is for some reason not compatible with GNU sed
140 sed -i '' "s/<version>.*<\/version>/<version>${LDK_GARBAGECOLLECTED_GIT_OVERRIDE:1:100}<\/version>/g" c_sharp/packaging_artifacts/org.ldk.nuspec
141 sed -i '' "s/<version>.*<\/version>/<version>${LDK_GARBAGECOLLECTED_GIT_OVERRIDE:1:100}<\/version>/g" c_sharp/packaging_artifacts/package/services/metadata/core-properties/ldk.psmdcp
144 # Compiling C# bindings with Mono
145 if [ "$3" = "true" ]; then
146 mono-csc -g -out:csharpldk.dll -langversion:3 -t:library -unsafe c_sharp/src/org/ldk/enums/*.cs c_sharp/src/org/ldk/impl/*.cs c_sharp/src/org/ldk/util/*.cs c_sharp/src/org/ldk/structs/*.cs
149 dotnet build --configuration Release
153 echo "Building C# bindings..."
154 COMPILE="$COMMON_COMPILE $COMMON_CC -pthread -fPIC"
155 LINK="$COMMON_CC -shared"
156 [ "$IS_WIN" = "false" ] && LINK="$LINK -ldl"
157 [ "$IS_MAC" = "false" ] && LINK="$LINK -Wl,--no-undefined"
158 [ "$IS_MAC" = "true" ] && COMPILE="$COMPILE -mmacosx-version-min=10.9"
159 [ "$IS_MAC" = "true" -a "$IS_APPLE_CLANG" = "false" ] && LINK="$LINK -fuse-ld=lld"
160 [ "$IS_MAC" = "true" -a "$IS_APPLE_CLANG" = "false" ] && echo "WARNING: Need at least upstream clang 13!"
161 [ "$IS_MAC" = "false" -a "$3" != "false" ] && LINK="$LINK -Wl,-wrap,calloc -Wl,-wrap,realloc -Wl,-wrap,malloc -Wl,-wrap,free"
162 [ "$IS_WIN" = "true" ] && LINK="$LINK -lbcrypt -lntdll -static-libgcc"
163 [ "$IS_WIN" = "true" ] && COMPILE="$COMPILE -I/usr/x86_64-w64-mingw32/sys-root/mingw/include/ -I/usr/x86_64-w64-mingw32/include/"
165 if [ "$3" = "true" ]; then
166 $COMPILE $LINK -o libldkcsharp_debug$LDK_TARGET_SUFFIX.so -g -fsanitize=address -shared-libasan -rdynamic -I"$1"/lightning-c-bindings/include/ c_sharp/bindings.c "$1"/lightning-c-bindings/target/$LDK_TARGET/debug/libldk.a -lm
168 [ "$IS_APPLE_CLANG" = "false" ] && LINK="$LINK -flto -Wl,-O3 -fuse-ld=lld"
169 [ "$IS_APPLE_CLANG" = "false" ] && COMPILE="$COMPILE -flto"
170 [ "$IS_MAC" = "false" ] && LINK="$LINK -Wl,--no-undefined"
171 [ "$IS_WIN" = "false" ] && LINK="$LINK -Wl,--lto-O3"
172 LDK_LIB="$1"/lightning-c-bindings/target/$LDK_TARGET/release/libldk.a
173 if [ "$IS_MAC" = "false" -a "$IS_WIN" = "false" -a "$4" = "false" ]; then
174 LINK="$LINK -Wl,--version-script=c_sharp/libcode.version -Wl,--build-id=0x0000000000000000"
177 # When building for Windows, a timestamp is included in the resulting dll,
178 # so we have to build with faketime.
179 faketime -f "2021-01-01 00:00:00" $COMPILE -o bindings.o -c -O3 -I"$1"/lightning-c-bindings/include/ c_sharp/bindings.c
180 faketime -f "2021-01-01 00:00:00" $COMPILE $LINK -o libldkcsharp_release$LDK_TARGET_SUFFIX.so -O3 bindings.o $LDK_LIB -lm
181 $STRIP -R .llvmbc -R .llvmcmd libldkcsharp_release$LDK_TARGET_SUFFIX.so
183 if [ "$LDK_JAR_TARGET" = "true" ]; then
184 # Copy resulting native binary for inclusion in release nuget zip
185 mkdir -p c_sharp/packaging_artifacts/lib/net6.0/
186 cp c_sharp/bin/Release/net6.0/csharpldk.dll c_sharp/packaging_artifacts/lib/net6.0/
188 mkdir -p c_sharp/packaging_artifacts/runtimes/"$CS_PLATFORM_NAME"/native/
189 if [ "$IS_WIN" = "true" ]; then
190 cp libldkcsharp_release$LDK_TARGET_SUFFIX.so c_sharp/packaging_artifacts/runtimes/"$CS_PLATFORM_NAME"/native/ldkcsharp.dll
191 elif [ "$IS_MAC" = "true" ]; then
192 cp libldkcsharp_release$LDK_TARGET_SUFFIX.so c_sharp/packaging_artifacts/runtimes/"$CS_PLATFORM_NAME"/native/libldkcsharp.dylib
194 cp libldkcsharp_release$LDK_TARGET_SUFFIX.so c_sharp/packaging_artifacts/runtimes/"$CS_PLATFORM_NAME"/native/libldkcsharp.so
198 elif [ "$2" = "python" ]; then
199 echo "Creating Python bindings..."
200 mkdir -p python/src/{enums,structs,impl}
201 rm -f python/src/{enums,structs,impl}/*.py
202 ./genbindings.py "./lightning.h" python/src/impl python/src python/ $DEBUG_ARG python $4 $TARGET_STRING
203 rm -f python/bindings.c
204 if [ "$3" = "true" ]; then
205 echo "#define LDK_DEBUG_BUILD" > python/bindings.c
206 elif [ "$3" = "leaks" ]; then
207 # For leak checking we use release libldk which doesn't expose
208 # __unmangle_inner_ptr, but the C code expects to be able to call it.
209 echo "#define __unmangle_inner_ptr(a) (a)" > python/bindings.c
211 echo "#define LDKCVec_C2Tuple_ThirtyTwoBytesCVec_C2Tuple_u32TxOutZZZZ LDKCVec_TransactionOutputsZ" >> python/bindings.c
212 echo "#define CVec_C2Tuple_ThirtyTwoBytesCVec_C2Tuple_u32TxOutZZZZ_free CVec_TransactionOutputsZ_free" >> python/bindings.c
213 cat python/bindings.c.body >> python/bindings.c
216 [ "$($CC --version | grep apple-darwin)" != "" ] && IS_MAC=true
218 [ "$($CC --version | grep "Apple clang version")" != "" ] && IS_APPLE_CLANG=true
220 echo "Building Python bindings..."
221 COMPILE="$COMMON_COMPILE $COMMON_CC -Isrc/main/jni -pthread -fPIC"
222 LINK="$COMMON_CC -ldl -shared"
223 [ "$IS_MAC" = "false" ] && LINK="$LINK -Wl,--no-undefined"
224 [ "$IS_MAC" = "true" ] && COMPILE="$COMPILE -mmacosx-version-min=10.9"
225 [ "$IS_MAC" = "true" -a "$IS_APPLE_CLANG" = "false" ] && LINK="$LINK -fuse-ld=lld"
226 [ "$IS_MAC" = "true" -a "$IS_APPLE_CLANG" = "false" ] && echo "WARNING: Need at least upstream clang 13!"
227 [ "$IS_MAC" = "false" -a "$3" != "false" ] && LINK="$LINK -Wl,-wrap,calloc -Wl,-wrap,realloc -Wl,-wrap,malloc -Wl,-wrap,free"
229 exit 0 # Sadly compilation doesn't currently work
230 if [ "$3" = "true" ]; then
231 $COMPILE $LINK -o liblightningpython_debug$LDK_TARGET_SUFFIX.so -g -fsanitize=address -shared-libasan -rdynamic -I"$1"/lightning-c-bindings/include/ $2 c_sharp/bindings.c "$1"/lightning-c-bindings/target/$LDK_TARGET/debug/libldk.a -lm
233 $COMPILE -o bindings.o -c -flto -O3 -I"$1"/lightning-c-bindings/include/ $2 c_sharp/bindings.c
234 $COMPILE $LINK -o liblightningpython_release$LDK_TARGET_SUFFIX.so -Wl,--version-script=python/libcode.version -flto -O3 -Wl,--lto-O3 -Wl,-O3 -I"$1"/lightning-c-bindings/include/ $2 bindings.o "$1"/lightning-c-bindings/target/$LDK_TARGET/release/libldk.a -lm
235 $STRIP -R .llvmbc -R .llvmcmd liblightningpython_release$LDK_TARGET_SUFFIX.so
237 elif [ "$2" = "wasm" ]; then
238 echo "Creating TS bindings..."
239 mkdir -p ts/{enums,structs}
240 rm -f ts/{enums,structs,}/*.{mjs,mts,mts.part}
241 if [ "$4" = "false" ]; then
242 ./genbindings.py "./lightning.h" ts ts ts $DEBUG_ARG typescript node wasm
244 ./genbindings.py "./lightning.h" ts ts ts $DEBUG_ARG typescript browser wasm
247 sed -i 's/^ "version": .*/ "version": "'${LDK_GARBAGECOLLECTED_GIT_OVERRIDE:1:100}'",/g' ts/package.json
248 sed -i 's/^ "version": .*/ "version": "'${LDK_GARBAGECOLLECTED_GIT_OVERRIDE:1:100}'",/g' node-net/package.json
249 sed -i 's/^ "lightningdevkit": .*/ "lightningdevkit": "'${LDK_GARBAGECOLLECTED_GIT_OVERRIDE:1:100}'"/g' node-net/package.json
250 if [ "$3" = "true" ]; then
251 echo "#define LDK_DEBUG_BUILD" > ts/bindings.c
252 elif [ "$3" = "leaks" ]; then
253 # For leak checking we use release libldk which doesn't expose
254 # __unmangle_inner_ptr, but the C code expects to be able to call it.
255 echo "#define __unmangle_inner_ptr(a) (a)" > ts/bindings.c
257 cat header.c >> ts/bindings.c
258 cat ts/bindings.c.body >> ts/bindings.c
260 echo "Building TS bindings..."
261 COMPILE="$COMMON_COMPILE $COMMON_CC -flto -Wl,--no-entry -nostdlib --target=wasm32-wasi -Wl,-z -Wl,stack-size=$((8*1024*1024)) -Wl,--initial-memory=$((16*1024*1024)) -Wl,--max-memory=$((1024*1024*1024)) -Wl,--global-base=4096"
262 # We only need malloc and assert/abort, but for now just use WASI for those:
263 EXTRA_LINK=/usr/lib/wasm32-wasi/libc.a
264 [ "$3" != "false" ] && COMPILE="$COMPILE -Wl,-wrap,calloc -Wl,-wrap,realloc -Wl,-wrap,reallocarray -Wl,-wrap,malloc -Wl,-wrap,aligned_alloc -Wl,-wrap,free"
265 if [ "$3" = "true" ]; then
266 WASM_FILE=liblightningjs_debug.wasm
267 $COMPILE -o liblightningjs_debug.wasm -g -O1 -I"$1"/lightning-c-bindings/include/ ts/bindings.c "$1"/lightning-c-bindings/target/wasm32-wasi/debug/libldk.a $EXTRA_LINK
269 WASM_FILE=liblightningjs_release.wasm
270 $COMPILE -o liblightningjs_release.wasm -s -Oz -I"$1"/lightning-c-bindings/include/ ts/bindings.c "$1"/lightning-c-bindings/target/wasm32-wasi/release/libldk.a $EXTRA_LINK
273 if [ -x "$(which tsc)" ]; then
275 for F in structs/*; do
276 cat imports.mts.part | grep -v " $(basename -s .mts $F)[ ,]" | cat - $F > $F.tmp
280 tsc --types node --typeRoots .
281 cp ../$WASM_FILE liblightningjs.wasm
282 cp ../README.md README.md
284 tsc --types node --typeRoots .
285 echo Ready to publish!
286 if [ -x "$(which node)" ]; then
287 NODE_V="$(node --version)"
288 if [ "${NODE_V:1:2}" -gt 14 ]; then
290 node --stack_trace_limit=200 --trace-uncaught test/node.mjs
292 node --stack_trace_limit=200 --trace-uncaught test/test.mjs
298 sed -i "s/^ <version>.*<\/version>/ <version>${LDK_GARBAGECOLLECTED_GIT_OVERRIDE:1:100}<\/version>/g" pom.xml
300 # OSX sed is for some reason not compatible with GNU sed
301 sed -i '' "s/^ <version>.*<\/version>/ <version>${LDK_GARBAGECOLLECTED_GIT_OVERRIDE:1:100}<\/version>/g" pom.xml
304 echo "Creating Java bindings..."
305 mkdir -p src/main/java/org/ldk/{enums,structs}
306 rm -f src/main/java/org/ldk/{enums,structs}/*.java
307 rm -f src/main/jni/*.h
308 if [ "$4" = "true" ]; then
309 ./genbindings.py "./lightning.h" src/main/java/org/ldk/impl src/main/java/org/ldk src/main/jni/ $DEBUG_ARG android $4 $TARGET_STRING
311 ./genbindings.py "./lightning.h" src/main/java/org/ldk/impl src/main/java/org/ldk src/main/jni/ $DEBUG_ARG java $4 $TARGET_STRING
313 rm -f src/main/jni/bindings.c
314 if [ "$3" = "true" ]; then
315 echo "#define LDK_DEBUG_BUILD" > src/main/jni/bindings.c
316 elif [ "$3" = "leaks" ]; then
317 # For leak checking we use release libldk which doesn't expose
318 # __unmangle_inner_ptr, but the C code expects to be able to call it.
319 echo "#define __unmangle_inner_ptr(a) (a)" > src/main/jni/bindings.c
321 cat header.c >> src/main/jni/bindings.c
322 cat header.c >> src/main/jni/bindings.c
323 cat src/main/jni/bindings.c.body >> src/main/jni/bindings.c
324 javac -h src/main/jni src/main/java/org/ldk/enums/*.java src/main/java/org/ldk/impl/*.java
325 rm src/main/java/org/ldk/enums/*.class src/main/java/org/ldk/impl/bindings*.class
327 echo "Building Java bindings..."
328 COMPILE="$COMMON_COMPILE $COMMON_CC -Isrc/main/jni -pthread -fPIC"
329 LINK="$COMMON_CC -shared"
330 [ "$IS_WIN" = "false" ] && LINK="$LINK -ldl"
331 [ "$IS_MAC" = "false" ] && LINK="$LINK -Wl,--no-undefined"
332 [ "$IS_MAC" = "true" ] && COMPILE="$COMPILE -mmacosx-version-min=10.9"
333 [ "$IS_MAC" = "true" -a "$IS_APPLE_CLANG" = "false" ] && LINK="$LINK -fuse-ld=lld"
334 [ "$IS_MAC" = "true" -a "$IS_APPLE_CLANG" = "false" ] && echo "WARNING: Need at least upstream clang 13!"
335 [ "$IS_MAC" = "false" -a "$3" != "false" ] && LINK="$LINK -Wl,-wrap,calloc -Wl,-wrap,realloc -Wl,-wrap,malloc -Wl,-wrap,free"
336 if [ "$3" = "true" ]; then
337 $COMPILE $LINK -o liblightningjni_debug$LDK_TARGET_SUFFIX.so -g -fsanitize=address -shared-libasan -rdynamic -I"$1"/lightning-c-bindings/include/ $2 src/main/jni/bindings.c "$1"/lightning-c-bindings/target/$LDK_TARGET/debug/libldk.a -lm
339 [ "$IS_APPLE_CLANG" = "false" ] && LINK="$LINK -flto -Wl,-O3 -fuse-ld=lld"
340 [ "$IS_APPLE_CLANG" = "false" ] && COMPILE="$COMPILE -flto"
341 [ "$IS_MAC" = "false" ] && LINK="$LINK -Wl,--no-undefined"
342 [ "$IS_WIN" = "false" ] && LINK="$LINK -Wl,--lto-O3"
343 [ "$IS_WIN" = "true" ] && LINK="$LINK -L/usr/lib/gcc/x86_64-w64-mingw32/12-win32/ -lbcrypt"
344 LDK_LIB="$1"/lightning-c-bindings/target/$LDK_TARGET/release/libldk.a
345 if [ "$IS_MAC" = "false" -a "$IS_WIN" = "false" -a "$4" = "false" ]; then
346 LINK="$LINK -Wl,--version-script=libcode.version"
349 $COMPILE -o bindings.o -c -O3 -I"$1"/lightning-c-bindings/include/ $2 src/main/jni/bindings.c
350 $COMPILE $LINK -o liblightningjni_release$LDK_TARGET_SUFFIX.so -O3 $2 bindings.o $LDK_LIB -lm
351 $STRIP -R .llvmbc -R .llvmcmd liblightningjni_release$LDK_TARGET_SUFFIX.so
353 if [ "$IS_MAC" = "false" -a "$4" = "false" ]; then
354 GLIBC_SYMBS="$(objdump -T liblightningjni_release$LDK_TARGET_SUFFIX.so | grep GLIBC_ | grep -v "GLIBC_2\.\(2\|3\)\(\.\|)\)" | grep -v "GLIBC_2.\(3\.4\|14\|17\|18\|25\|28\|29\|32\|33\|34\|\))" || echo)"
355 if [ "$GLIBC_SYMBS" != "" ]; then
356 echo "Unexpected glibc version dependency! Some users need glibc 2.35 support, symbols for newer glibcs cannot be included."
360 REALLOC_ARRAY_SYMBS="$(objdump -T liblightningjni_release$LDK_TARGET_SUFFIX.so | grep reallocarray || echo)"
361 if [ "$REALLOC_ARRAY_SYMBS" != "" ]; then
362 echo "Unexpected reallocarray dependency!"
367 if [ "$LDK_JAR_TARGET" = "true" ]; then
368 # Copy to JNI native directory for inclusion in JARs
369 mkdir -p src/main/resources/
370 cp liblightningjni_release$LDK_TARGET_SUFFIX.so src/main/resources/liblightningjni$LDK_TARGET_SUFFIX.nativelib