KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

iota.c

★ 62 Open GitHub ↗

IOTA client library in C

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h2 align="center">The official C client library for interacting with the Tangle</h2>

<p align="center">
    <a href="https://iota-c-client.readthedocs.io/en/latest/index.html" style="text-decoration:none;">
    <img src="https://img.shields.io/badge/Documentation%20portal-blue.svg?style=for-the-badge"
         alt="Developer Documentation">
      </p>
<p align="center">
  <a href="https://discord.iota.org/" style="text-decoration:none;"><img src="https://img.shields.io/badge/Discord-9cf.svg?logo=discord" alt="Discord"></a>
    <a href="https://iota.stackexchange.com/" style="text-decoration:none;"><img src="https://img.shields.io/badge/StackExchange-9cf.svg?logo=stackexchange" alt="StackExchange"></a>
    <a href="https://github.com/iotaledger/iota.c/blob/master/LICENSE" style="text-decoration:none;"><img src="https://img.shields.io/github/license/iotaledger/iota.c.svg" alt="Apache 2.0 license"></a>
    <a href="https://iota-c-client.readthedocs.io/en/latest/index.html" style="text-decoration:none;"><img src="https://img.shields.io/readthedocs/iota-c-client" alt="Client API Reference"></a>
</p>
      
<p align="center">
  <a href="#about">About</a> ◈
  <a href="#prerequisites">Prerequisites</a> ◈
  <a href="#building-iota-c-client-library">Building Client Library</a> ◈
  <a href="#building-documentation">Building Document</a> ◈
  <a href="#visual-studio-code-integration">Visual Studio Code Integration</a> ◈
  <a href="#supporting-the-project">Supporting the project</a> ◈
  <a href="#joining-the-discussion">Joining the discussion</a> 
</p>

---

## About

This is the **official** C client library, which allows you to do the following:
* Create blocks
* Read blocks
* Sign transactions
* Generate addresses
* Implement a wallet application

You can find API reference on [C Client API Reference](https://iota-c-client.readthedocs.io/en/latest/index.html)

This is in highly development, so there may be performance and stability issues.
Please report any issues in [Issues](https://github.com/iotaledger/iota.c/issues) or [Discussions](https://github.com/iotaledger/iota.c/discussions)

## Prerequisites

* pkg-config
* libcurl4-openssl-dev 
* GCC or Clang
* [CMake](https://cmake.org/) 3.15 and above
* [ninja-build](https://ninja-build.org/) (optional)

Ubuntu

```shell
sudo apt install build-essential libcurl4-openssl-dev pkg-config
```

## Building IOTA C Client Library

IOTA C Client support different crypto libraries, including OpenSSL, libsodium, and mbedtsl, it can be changed by CMake property `CryptoUse`. Fro example, adding `-DCryptoUse=libsodium` to use libsodium.

Compiling and testing library with Clang11 and Ninja

```shell
git clone https://github.com/iotaledger/iota.c.git
cd iota.c
mkdir build && cd build
cmake -G Ninja -DCMAKE_C_COMPILER=clang-11 -DCMAKE_CXX_COMPILER=clang++-11 -DIOTA_WALLET_ENABLE:BOOL=TRUE -DCMAKE_INSTALL_PREFIX=$PWD ..
ninja && ninja test
```

Compiling and testing library with Make and GCC

```shell
git clone https://github.com/iotaledger/iota.c.git
cd iota.c
mkdir build && cd build
cmake -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++ -DIOTA_WALLET_ENABLE:BOOL=TRUE -DCMAKE_INSTALL_PREFIX=$PWD ..
make -j8 && make test
```

Compiling and testing library with default compiler

```shell
git clone https://github.com/iotaledger/iota.c.git
cd iota.c
mkdir build && cd build
cmake -DIOTA_WALLET_ENABLE:BOOL=TRUE -DCMAKE_INSTALL_PREFIX=$PWD ..
make && make test
```

The default build type is Debug mode with debug symbols, for Release mode you can add `-DCMAKE_BUILD_TYPE=Release` during the CMake configuration stage.

## Building Documentation

The documentation is automatically generated thought Doxygen and Sphinx tools.

This steps are tested on Ubuntu, please refer to installation guides for different platforms:
* [Install sphinx](https://www.sphinx-doc.org/en/master/usage/installation.html)
* [Install Doxygen](https://www.doxygen.nl/manual/install.html)

```shell
sudo apt install doxygen python3-sphinx python3-pip
git clone https://github.com/iotaledger/iota.c.git
cd iota.c/docs
pip3 install -r requirements.txt
doxygen Doxyfile && make html
```

The documentation will locate at `docs/_build/html/index.html` in the project root directory.

## Visual Studio Code Integration

This template includes launch configurations for debugging test cases with Visual Studio Code located in the .vscode/ directory.
See [.vscode/README.md](./.vscode/README.md) for more information.
If you're not using VS Code, you can safely delete or ignore the directory.

## Supporting the project

If the IOTA C client library has been useful to you and you feel like contributing, consider posting a [bug report](https://github.com/iotaledger/iota.c/issues/new-issue), feature request or a [pull request](https://github.com/iotaledger/iota.c/pulls/). 
 
We have some [basic contribution guidelines](.github/CONTRIBUTING.md) to keep our code base stable and consistent.

## Joining the discussion

If you want to get involved in the community, need help with getting set up, have any issues related with the library or just want to discuss blockchain, distributed ledgers, and IoT with other people, feel free to join our [Discord](https://discord.iota.org/).

iota.c

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README