Xarxa Rust SDK

Submodule

This project depends on a shared repository called WIT (WIT interface definitions).
We use a Git submodule to ensure every project (xarxa, sdk, etc.) is tied to an exact version of the wit contracts.

Clone the repository

When cloning this repo, make sure to initialize submodules:

git submodule add git@github.com:xarxa-systems/wit.git wit
# or if already cloned
git submodule update --init --recursive

Update WIT to a specific version

Checkout the desired tag or commit inside the contracts folder:

cd contracts
git fetch --tags
git checkout v1.2.0
cd ..
git add contracts
git commit -m "update contracts to v1.2.0"

Rollback contracts

If you need to use an older version:

cd contracts
git checkout v1.0.0   # or a specific commit SHA
cd ..
git add contracts
git commit -m "rollback contracts to v1.0.0"

Sync contracts after pull

If someone else updated the submodule reference:

git pull
git submodule update --init --recursive

Update wit contract

git add .
git commit -m "new version"
git push origin main

git tag -a v1.2.0 -m "new version"
git push origin --tags

Generate bindings

wit-bindgen rust \                                              
  --out-dir src/bindings \
  --world orchestrator \
  wit/orchestrator