{"id":50547977,"url":"https://github.com/ton-blockchain/setup-acton","last_synced_at":"2026-06-04T00:30:32.378Z","repository":{"id":357078332,"uuid":"1127340109","full_name":"ton-blockchain/setup-acton","owner":"ton-blockchain","description":"Set up your GitHub Actions workflow with a specific version of Acton","archived":false,"fork":false,"pushed_at":"2026-05-11T07:43:28.000Z","size":1183,"stargazers_count":1,"open_issues_count":7,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-11T09:22:42.476Z","etag":null,"topics":["actions","acton","github-actions","ton","ton-blockchain"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ton-blockchain.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-03T17:21:48.000Z","updated_at":"2026-05-11T07:43:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ton-blockchain/setup-acton","commit_stats":null,"previous_names":["ton-blockchain/setup-acton"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/ton-blockchain/setup-acton","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ton-blockchain%2Fsetup-acton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ton-blockchain%2Fsetup-acton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ton-blockchain%2Fsetup-acton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ton-blockchain%2Fsetup-acton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ton-blockchain","download_url":"https://codeload.github.com/ton-blockchain/setup-acton/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ton-blockchain%2Fsetup-acton/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33886153,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["actions","acton","github-actions","ton","ton-blockchain"],"created_at":"2026-06-04T00:30:31.635Z","updated_at":"2026-06-04T00:30:32.372Z","avatar_url":"https://github.com/ton-blockchain.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# setup-acton\n\nThis action sets up [Acton](https://github.com/ton-blockchain/acton) for use in GitHub Actions by:\n\n- Downloading a requested Acton release archive and adding `acton` to the `PATH`\n- Restoring and saving the installed `acton` binary with the GitHub Actions cache\n- Exposing the installed binary path, detected Acton version, and cache status as outputs\n\n## Contents\n\n- [Usage](#usage)\n  - [Install Acton](#install-acton)\n  - [Using outputs](#using-outputs)\n- [Inputs](#inputs)\n- [Outputs](#outputs)\n- [Version resolution](#version-resolution)\n- [Caching](#caching)\n- [Supported targets](#supported-targets)\n- [Recommended permissions](#recommended-permissions)\n- [Checksum verification](#checksum-verification)\n\n## Usage\n\n### Install Acton\n\n```yaml\nsteps:\n  - name: Setup Acton\n    uses: ton-blockchain/setup-acton@2d38fd579e1bf8753a3e0cff9ad695612b98a676 # v1.0.0\n```\n\nIf you do not specify a version, this action reads `Acton.toml` from `working-directory` first and falls back to the\nlatest Acton release when no project version is configured.\n\nSee [action.yml](action.yml).\n\n```yaml\n- name: Setup Acton\n  uses: ton-blockchain/setup-acton@2d38fd579e1bf8753a3e0cff9ad695612b98a676 # v1.0.0\n  with:\n    # Acton version to install.\n    # Supported values include 'latest', a release tag such as 'v1.0.0',\n    # a bare semantic version such as '1.0.0', or 'trunk'.\n    # Defaults to the version in Acton.toml or 'latest'.\n    version: '1.0.0'\n\n    # Target architecture. Auto-detected from the runner if not specified.\n    # Supported values: x86_64, aarch64.\n    architecture: 'x86_64'\n\n    # Target platform. Auto-detected from the runner if not specified.\n    # Supported values: linux, apple, windows.\n    platform: 'linux'\n\n    # Working directory for the Acton project. Defaults to the GitHub workspace.\n    working-directory: ${{ github.workspace }}\n\n    # Restore and save the resolved Acton binary with the GitHub Actions cache.\n    save-cache: true\n\n    # GitHub token for authenticated release metadata and asset downloads.\n    github-token: ${{ github.token }}\n```\n\n### Using outputs\n\n```yaml\nsteps:\n  - name: Setup Acton\n    uses: ton-blockchain/setup-acton@2d38fd579e1bf8753a3e0cff9ad695612b98a676 # v1.0.0\n    id: setup-acton\n    with:\n      version: '1.0.0'\n\n  - run: |\n      echo \"Acton path: ${{ steps.setup-acton.outputs.acton-path }}\"\n      echo \"Acton version: ${{ steps.setup-acton.outputs.acton-version }}\"\n      echo \"Cache hit: ${{ steps.setup-acton.outputs.cache-hit }}\"\n```\n\n## Inputs\n\n| Name                | Required | Default                   | Description                                                               |\n|---------------------|----------|---------------------------|---------------------------------------------------------------------------|\n| `version`           | No       | `Acton.toml` or `latest`  | Acton version to install. See [Version resolution](#version-resolution).  |\n| `architecture`      | No       | Runner architecture       | Target architecture. See [Supported targets](#supported-targets).         |\n| `platform`          | No       | Runner platform           | Target platform. See [Supported targets](#supported-targets).             |\n| `working-directory` | No       | `${{ github.workspace }}` | Working directory for the Acton project.                                  |\n| `save-cache`        | No       | `true`                    | Restore and save the resolved Acton binary with the GitHub Actions cache. |\n| `github-token`      | No       | `${{ github.token }}`     | GitHub token used to fetch release metadata and release assets.           |\n\n## Outputs\n\n| Name            | Description                                            |\n|-----------------|--------------------------------------------------------|\n| `acton-path`    | Full path to the installed `acton` binary.             |\n| `acton-version` | Installed Acton version parsed from `acton --version`. |\n| `cache-hit`     | Whether the Acton binary was restored from cache.      |\n\n\u003e **Note**: `acton-version` returns `unknown` if the version cannot be detected.\n\n## Version resolution\n\nThe action resolves the Acton version in this order:\n\n- **`version` input** - If `version` is set, the action uses it. If the value is `latest`, the action fetches the latest\n  GitHub release from `ton-blockchain/acton`.\n- **`Acton.toml`** - If `version` is omitted, the action reads `[toolchain].acton` from `Acton.toml` in\n  `working-directory`.\n- **Latest release** - If no version is configured, the action gets the latest version from `ton-blockchain/acton`.\n\n`Acton.toml` example:\n\n```toml\n[toolchain]\nacton = \"0.3.2\"\n```\n\nThe resolved version supports the following syntax:\n\n- **Release tag** - If `version` starts with `v`, the value is used as the release tag, for example `v1.0.0`.\n- **Bare semantic version** - If `version` is a plain semantic version such as `1.0.0`, it is normalized to `v1.0.0`.\n- **Trunk** - `trunk` installs the moving `trunk` release. Do **not** use `trunk` in production workflows.\n- **Custom release tag** - Any other value is passed through unchanged and must match an existing Acton release tag.\n\nAfter resolving the release tag, the action downloads the matching archive for the selected platform and architecture.\n\n\u003e **Warning**: We recommend pinning a versioned Acton release in `version` or `Acton.toml` for reproducible workflows.\n\u003e Use `latest` or other non-version tags only when you explicitly want the workflow to track a moving release.\n\n\u003e **Note**: It is recommended to wrap version values in single quotation marks to avoid YAML parsing surprises:\n\u003e\n\u003e ```yaml\n\u003e version: '1.0.0'\n\u003e ```\n\n## Caching\n\nBy default, this action restores and saves the resolved Acton binary with the GitHub Actions cache. The cache key\nincludes the binary name, resolved version, platform target, and architecture. The cache is saved by the action's post\nstep only when the job succeeds.\n\nWhen the same cache key is restored, the post-step skips saving the cache again.\n\n\u003e **Note**: When the explicit `version` input is `trunk`, the post-step skips saving the cache because `trunk` is a\n\u003e moving target.\n\nDisable caching with:\n\n```yaml\nwith:\n  save-cache: false\n```\n\n## Supported targets\n\nThe action can resolve the following platform targets:\n\n| Platform input | Artifact target     |\n|----------------|---------------------|\n| `linux`        | `unknown-linux-gnu` |\n| `apple`        | `apple-darwin`      |\n| `windows`      | `pc-windows-msvc`   |\n\nThe action can resolve the following architecture targets:\n\n| Architecture input | Artifact architecture |\n|--------------------|-----------------------|\n| `x86_64`           | `x86_64`              |\n| `aarch64`          | `aarch64`             |\n\n## Recommended permissions\n\nWhen using the `setup-acton` action in your GitHub Actions workflow, it is recommended to set the following permissions:\n\n```yaml\npermissions:\n  contents: read # access release metadata and release assets\n```\n\n## Checksum verification\n\nThe downloaded Acton archive must match the expected `SHA-256` checksum. If the checksum does not match, the action\nfails before extracting or adding `acton` to `PATH`.\n\n```bash\nbun ci\nbun run all\n```\n\n`dist/setup/index.js` is committed because GitHub Actions runs the bundled file declared in [action.yml](action.yml).\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for local setup, pull request expectations, and release asset maintenance notes.\n\n## Security\n\nPlease report suspected vulnerabilities privately. See [SECURITY.md](SECURITY.md).\n\n## Code of Conduct\n\nThis project follows the [Acton Code of Conduct](CODE_OF_CONDUCT.md).\n\n## License\n\nThe scripts and documentation in this project are released under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fton-blockchain%2Fsetup-acton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fton-blockchain%2Fsetup-acton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fton-blockchain%2Fsetup-acton/lists"}