{"id":48258318,"url":"https://github.com/xian-technology/xian-stack","last_synced_at":"2026-04-12T02:04:46.621Z","repository":{"id":337150320,"uuid":"1149291472","full_name":"xian-technology/xian-stack","owner":"xian-technology","description":"Docker-based deployment stack for running Xian blockchain nodes — mainnet, testnet, and custom networks","archived":false,"fork":false,"pushed_at":"2026-03-29T00:00:39.000Z","size":309,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-29T02:53:44.276Z","etag":null,"topics":["blockchain","cometbft","docker","node","validator","xian"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xian-technology.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-04T00:13:49.000Z","updated_at":"2026-03-29T00:00:42.000Z","dependencies_parsed_at":"2026-03-29T02:02:36.167Z","dependency_job_id":null,"html_url":"https://github.com/xian-technology/xian-stack","commit_stats":null,"previous_names":["xian-technology/xian-node","xian-technology/xian-stack"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/xian-technology/xian-stack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xian-technology%2Fxian-stack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xian-technology%2Fxian-stack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xian-technology%2Fxian-stack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xian-technology%2Fxian-stack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xian-technology","download_url":"https://codeload.github.com/xian-technology/xian-stack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xian-technology%2Fxian-stack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31414709,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["blockchain","cometbft","docker","node","validator","xian"],"created_at":"2026-04-04T21:20:10.039Z","updated_at":"2026-04-04T21:20:10.202Z","avatar_url":"https://github.com/xian-technology.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# xian-stack\n\n`xian-stack` is the local runtime backend for Xian. It owns Docker images,\nCompose topology, monitoring assets, localnet flows, and backend validation. It\nis the implementation surface behind local operator workflows, not the primary\noperator UX itself.\n\n## Common Workflows\n\nValidate the stack:\n\n```bash\npython3 ./scripts/backend.py validate\n```\n\nRun a local stack-managed node:\n\n```bash\npython3 ./scripts/backend.py start --no-service-node --dashboard --monitoring\npython3 ./scripts/backend.py status --no-service-node --dashboard --monitoring\npython3 ./scripts/backend.py endpoints --no-service-node --dashboard --monitoring\npython3 ./scripts/backend.py health --no-service-node --dashboard --monitoring\npython3 ./scripts/backend.py stop --no-service-node --dashboard --monitoring\n```\n\nRun a localnet workload:\n\n```bash\npython3 ./scripts/backend.py localnet-init --nodes 4 --topology integrated --clean\npython3 ./scripts/backend.py localnet-up --wait-for-health --rpc-timeout-seconds 120\npython3 ./scripts/backend.py localnet-workload --scenario counter_basic\n```\n\nRun the richer 5-validator testnet-shaped governance exercise:\n\n```bash\nmake localnet-validator-governance\n```\n\nRun the broader layered 5-validator e2e harness:\n\n```bash\nmake localnet-e2e\n```\n\nPlan or apply a coordinated workspace release:\n\n```bash\npython3 ./scripts/release_orchestrator.py plan\npython3 ./scripts/release_orchestrator.py apply\n```\n\nThe `localnet-e2e` harness now also validates direct `currency.approve` /\n`transfer_from` behavior and the `permit_authorizer -\u003e approve_from_authorizer`\npath against the same 5-validator `testnet`-shaped network.\n\n## Principles\n\n- `xian-stack` owns runtime plumbing, images, and smoke-tested local flows.\n  User-facing lifecycle orchestration belongs in `xian-cli`.\n- The stable machine-facing contract is `scripts/backend.py`. The `Makefile`\n  remains the developer and debugging surface.\n- Monitoring, dashboard, and BDS are optional stack layers. They should be easy\n  to enable without becoming required to understand the core node.\n- `xian-intentkit` can be attached as another optional stack-managed service\n  without copying its compose topology into this repo.\n- Localnet and smoke flows matter as product safety nets, not just as internal\n  convenience scripts.\n\n## Key Directories\n\n- `docker/`: runtime images and container build definitions\n- `scripts/`: backend control plane, smoke flows, and localnet tooling\n- `monitoring/`: Prometheus, Grafana, dashboards, and alert presets\n- `workloads/`: localnet workload fixtures and contracts\n- `docs/`: repo-local runtime and release notes\n\n## What It Can Do\n\n- build and run the local Xian runtime in `integrated` or `fidelity` topology\n- run canonical-network nodes from pinned published `xian-node` release images\n  while keeping source builds available as a local override\n- expose a stable machine-facing backend command surface through\n  `scripts/backend.py`\n- start optional dashboard, BDS, Prometheus, and Grafana layers\n- attach a stack-managed `xian-intentkit` deployment while keeping its repo and\n  compose files independent\n- run smoke checks and CLI-driven smoke flows\n- initialize multi-node localnets and drive workload scenarios against them\n- ship monitoring dashboards and alert rules that match the validated operator\n  profiles\n\n## Backend Surface\n\nThe stable backend interface is `scripts/backend.py`. It covers:\n\n- `validate`\n- `start`, `stop`, and `status`\n- `endpoints` and `health`\n- `smoke` and `smoke-cli`\n- `localnet-*` flows\n\nUse the `Makefile` directly for lower-level debugging, image builds, and\ndeveloper shell access.\n\nUse `xian-cli` for the human-facing operator workflows built on top of this\nbackend contract.\n\n## Validation\n\n```bash\nmake validate\nmake smoke\nmake smoke-cli\n```\n\n`make smoke` is the main repo safety net. `make smoke-cli` is the cross-repo\noperator-flow gate.\n\n## Related Docs\n\n- [AGENTS.md](AGENTS.md)\n- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)\n- [docs/BACKLOG.md](docs/BACKLOG.md)\n- [docs/README.md](docs/README.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxian-technology%2Fxian-stack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxian-technology%2Fxian-stack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxian-technology%2Fxian-stack/lists"}