{"id":28995045,"url":"https://github.com/casibase/chainserver","last_synced_at":"2025-12-15T04:56:08.375Z","repository":{"id":297471462,"uuid":"991695409","full_name":"casibase/chainserver","owner":"casibase","description":"A HTTP service wrapper for ChainMaker Go SDK","archived":false,"fork":false,"pushed_at":"2025-06-16T13:34:32.000Z","size":83,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-16T14:46:50.880Z","etag":null,"topics":["baas","blockchain","casibase","chain","chainmaker","fabric","go","golang","hyperledger","hyperledger-fabric","sdk"],"latest_commit_sha":null,"homepage":"https://github.com/casibase/casibase","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/casibase.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-05-28T02:48:26.000Z","updated_at":"2025-06-16T13:34:37.000Z","dependencies_parsed_at":"2025-06-16T14:46:55.907Z","dependency_job_id":null,"html_url":"https://github.com/casibase/chainserver","commit_stats":null,"previous_names":["casibase/chainmaker-server","casibase/chainserver"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/casibase/chainserver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casibase%2Fchainserver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casibase%2Fchainserver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casibase%2Fchainserver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casibase%2Fchainserver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/casibase","download_url":"https://codeload.github.com/casibase/chainserver/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casibase%2Fchainserver/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261801974,"owners_count":23211662,"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":["baas","blockchain","casibase","chain","chainmaker","fabric","go","golang","hyperledger","hyperledger-fabric","sdk"],"created_at":"2025-06-25T04:05:16.359Z","updated_at":"2025-12-15T04:56:08.308Z","avatar_url":"https://github.com/casibase.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\" style=\"border-bottom: none;\"\u003eChainServer\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#badge\"\u003e\n    \u003cimg alt=\"semantic-release\" src=\"https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/r/casbin/chainserver\"\u003e\n    \u003cimg alt=\"docker pull casbin/chainserver\" src=\"https://img.shields.io/docker/pulls/casbin/chainserver.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/casibase/chainserver/actions/workflows/build.yml\"\u003e\n    \u003cimg alt=\"GitHub Workflow Status (branch)\" src=\"https://github.com/casibase/chainserver/workflows/Build/badge.svg?style=flat-square\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/casibase/chainserver/releases/latest\"\u003e\n    \u003cimg alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/casibase/chainserver.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/r/casbin/chainserver\"\u003e\n    \u003cimg alt=\"Docker Image Version (latest semver)\" src=\"https://img.shields.io/badge/Docker%20Hub-latest-brightgreen\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://goreportcard.com/report/github.com/casibase/chainserver\"\u003e\n    \u003cimg alt=\"Go Report Card\" src=\"https://goreportcard.com/badge/github.com/casibase/chainserver?style=flat-square\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/casibase/chainserver/blob/master/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/casibase/chainserver?style=flat-square\" alt=\"license\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/casibase/chainserver/issues\"\u003e\n    \u003cimg alt=\"GitHub issues\" src=\"https://img.shields.io/github/issues/casibase/chainserver?style=flat-square\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"#\"\u003e\n    \u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/casibase/chainserver?style=flat-square\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/casibase/casibase/network\"\u003e\n    \u003cimg alt=\"GitHub forks\" src=\"https://img.shields.io/github/forks/casibase/chainserver?style=flat-square\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://discord.gg/devUNrWXrh\"\u003e\n    \u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/1022748306096537660?logo=discord\u0026label=discord\u0026color=5865F2\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# ChainServer\n\nA HTTP service wrapper for ChainMaker SDK, designed to work with Casibase without requiring CGO support.\n\n## Overview\n\nChainServer is a lightweight HTTP service that provides a bridge between Casibase and ChainMaker blockchain. Instead of directly integrating ChainMaker SDK (which requires CGO), this service offers HTTP endpoints to interact with ChainMaker blockchain, making it more flexible and easier to deploy.\n\n## Features\n\n- RESTful API interface for ChainMaker operations\n- Easy integration with Casibase\n- No CGO dependency required for client applications\n\n## Compatibility Notice\n\n**Important:**  \nCurrently, ChainServer only supports ChainMaker blockchains with **TLS disabled** and **authtype set to `permissionedWithCert`**. If you encounter errors when invoking transaction or query APIs, please verify that your ChainMaker server configuration meets these requirements.  \nAdditionally, ensure that the `provider` configuration in your Casibase setup is consistent with your ChainMaker network settings.\n\nFor details on how to check and modify your ChainMaker chain configuration, please refer to the official documentation:\n- [ChainMaker Configuration Guide](https://docs.chainmaker.org.cn/manage/%E9%95%BF%E5%AE%89%E9%93%BE%E9%85%8D%E7%BD%AE%E7%AE%A1%E7%90%86.html)\n\nIf your configuration does not meet the above requirements, the service may not function as expected.\n\n## Technical Stack\n\n- Go 1.22+\n- Beego Framework\n- ChainMaker SDK v2.2.0\n\n## Configuration\n\nThe server runs on port 13900 by default. You can modify the port in the configuration file.\n\n## API Endpoints\n\nThe service provides HTTP endpoints for ChainMaker operations. Detailed API documentation will be provided separately.\n\n## Docker Deployment Guide\n\nThe recommended way to deploy is to use the official image from Docker Hub:\n\n```sh\ndocker run -d --name chainserver -p 13900:13900 casbin/chainserver:latest\n```\n\nAlternatively, you can use Docker Compose (recommended for production or multi-container setups):\n\n```sh\ndocker-compose up -d\n```\n\nYou can also build the image locally if you want to use your own changes:\n\n```sh\ndocker build -t chainserver .\ndocker run -d --name chainserver -p 13900:13900 chainserver\n```\n\nThe default service port is 13900. For troubleshooting or advanced usage, see the Dockerfile and build.sh, or open an issue if you encounter problems.\n\n## API Documentation (Swagger)\n\nSee: https://chainserver.casibase.com/swagger/index.html\n\n## Building and Running\n\n1. Install Go 1.22 or later\n2. Clone the repository\n```bash\ngit clone https://github.com/casibase/chainserver.git\n```\n3. Install dependencies\n```bash\ngo mod tidy\n```\n4. Run the server\n```bash\ngo run main.go\n```\n\n## License\n\nApache-2.0\n\n## Related Projects\n\n- [Casibase](https://github.com/casibase/casibase)\n- [ChainMaker](https://git.chainmaker.org.cn/chainmaker)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcasibase%2Fchainserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcasibase%2Fchainserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcasibase%2Fchainserver/lists"}