{"id":21019502,"url":"https://github.com/ceramicnetwork/rust-ceramic","last_synced_at":"2025-10-06T10:32:09.941Z","repository":{"id":67827685,"uuid":"599309594","full_name":"ceramicnetwork/rust-ceramic","owner":"ceramicnetwork","description":"Implementation of the Ceramic protocol in Rust","archived":false,"fork":false,"pushed_at":"2025-01-15T17:00:22.000Z","size":6893,"stargazers_count":37,"open_issues_count":33,"forks_count":9,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-01-18T21:40:35.848Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ceramicnetwork.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-08T21:51:50.000Z","updated_at":"2025-01-15T17:00:22.000Z","dependencies_parsed_at":"2023-09-29T23:52:34.592Z","dependency_job_id":"67d503b9-5e7c-45e0-b6bd-1ff690f5bef7","html_url":"https://github.com/ceramicnetwork/rust-ceramic","commit_stats":null,"previous_names":["ceramicnetwork/rust-ceramic"],"tags_count":50,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceramicnetwork%2Frust-ceramic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceramicnetwork%2Frust-ceramic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceramicnetwork%2Frust-ceramic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceramicnetwork%2Frust-ceramic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ceramicnetwork","download_url":"https://codeload.github.com/ceramicnetwork/rust-ceramic/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235519884,"owners_count":19003201,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T10:32:37.144Z","updated_at":"2025-10-06T10:32:03.742Z","avatar_url":"https://github.com/ceramicnetwork.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rust Ceramic\n\nImplementation of the Ceramic protocol in Rust.\n\nCurrent status is that the `ceramic-one` binary only mimics the Kubo RPC API and relies on https://github.com/ceramicnetwork/js-ceramic for the remaining logic.\n\n## Installation\n\nThe following section covers several ways one can install Rust-Ceramic contingent on the recieving environment:\n\n### MacOS\n\nInstall from [Homebrew](https://brew.sh/):\n\n```bash\nbrew install ceramicnetwork/tap/ceramic-one\n```\n\n### Linux - Debian-based distributions\n\nInstall a the latest release using dpkg:\n\n```bash\n# get deb.tar.gz\ncurl -LO https://github.com/ceramicnetwork/rust-ceramic/releases/latest/download/ceramic-one_x86_64-unknown-linux-gnu.tar.gz\n# untar the Debian software package file\ntar zxvf ceramic-one_x86_64-unknown-linux-gnu.tar.gz\n# install with dpkg - package manager for Debian\ndpkg -i ceramic-one.deb\n```\n\n### Linux - from Source\n\n```bash\n# Install rust\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n# Install build tools\napt-get install -y build-essential pkg-config openssl libssl-dev unzip\n# Update environment\nsource \"$HOME/.cargo/env\"\n# Install protobuf\nPROTOC_VERSION=3.20.1\nPROTOC_ZIP=protoc-$PROTOC_VERSION-linux-x86_64.zip\ncurl --retry 3 --retry-max-time 90 -OL https://github.com/protocolbuffers/protobuf/releases/download/v$PROTOC_VERSION/$PROTOC_ZIP \\\n    \u0026\u0026 unzip -o $PROTOC_ZIP -d /usr/local bin/protoc \\\n    \u0026\u0026 unzip -o $PROTOC_ZIP -d /usr/local 'include/*' \\\n    \u0026\u0026 rm -f $PROTOC_ZIP\n# Checkout rust-ceramic repo\ngit clone https://github.com/ceramicnetwork/rust-ceramic\n# Enter repo and build\ncd rust-ceramic\nmake build\ncp ./target/release/ceramic-one /usr/local/bin/ceramic-one\n```\n\n### Docker\n\nStart rust-ceramic using the host network:\n\n```bash\ndocker run --network=host \\\n  public.ecr.aws/r5b3e0r5/3box/ceramic-one:latest\n```\n\n### Docker-Compose\n\n1. Create a testing directory, and enter it:\n\n```bash\nmkdir ceramic-recon\ncd ceramic-recon\n```\n\n2. Save the following docker-compose.yaml there:\n\n```YAML\nversion: '3.8'\n\nservices:\n  ceramic-one:\n    image: public.ecr.aws/r5b3e0r5/3box/ceramic-one:latest\n    network_mode: \"host\"\n    volumes:\n      - ceramic-one-data:/root/.ceramic-one\nvolumes:\n  ceramic-one-data:\n    driver: local\n```\n\n3. Run `docker-compose up -d`\n\n## Usage\n\nRunning the ceramic-one binary is simply passing the `daemon` cli option.\n\n```sh\n# if necessary, include the path/to/the/binary e.g. /usr/local/bin/ceramic-one or ./target/release/ceramic-one\n$ ceramic-one daemon\n\n# There are many flags for the daemon CLI that can be passed directly or set as environment variables.\n# See `DaemonOpts` in one/src/lib.rs for the complete list or pass the -h flag\n$ ceramic-one daemon -h\n\n# A few common options are overriding the log level:\n$ RUST_LOG=warn,ceramic_one=info,ceramic_service=debug ceramic-one daemon\n# Or modifying the network\n$ ceramic-one daemon --network testnet-clay\n$ ceramic-one daemon --network local --local-network-id 0\n# Or changing where directory where all data is stored. This folder SHOULD be backed up in production\n# and if you change the defaults, you MUST specify it every time you start the daemon.\n$ ceramic-one daemon --store-dir ./custom-store-dir\n```\n\nThe process honors RUST_LOG env variable for controlling its logging output.\nFor example, to enable debug logging for code from this repo but error logging for all other code use:\n\n## License\n\nFully open source and dual-licensed under MIT and Apache 2.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fceramicnetwork%2Frust-ceramic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fceramicnetwork%2Frust-ceramic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fceramicnetwork%2Frust-ceramic/lists"}