{"id":20165992,"url":"https://github.com/arcticicestudio/icecore-hashids","last_synced_at":"2025-10-24T02:45:40.219Z","repository":{"id":57717449,"uuid":"71073041","full_name":"arcticicestudio/icecore-hashids","owner":"arcticicestudio","description":"A lightweight generator for short, unique, non-sequential and decodable Hashids from non-negative numbers.","archived":false,"fork":false,"pushed_at":"2018-01-11T07:56:20.000Z","size":1656,"stargazers_count":12,"open_issues_count":5,"forks_count":3,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-04-10T01:15:36.476Z","etag":null,"topics":["hash","hash-algorithm","hash-numbers","hashids","icecore","java","library","obfuscation","obfuscator"],"latest_commit_sha":null,"homepage":"https://arcticicestudio.github.io/icecore-hashids","language":"Java","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/arcticicestudio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2016-10-16T19:43:12.000Z","updated_at":"2024-07-29T11:44:43.000Z","dependencies_parsed_at":"2022-09-05T20:22:02.958Z","dependency_job_id":null,"html_url":"https://github.com/arcticicestudio/icecore-hashids","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arcticicestudio%2Ficecore-hashids","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arcticicestudio%2Ficecore-hashids/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arcticicestudio%2Ficecore-hashids/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arcticicestudio%2Ficecore-hashids/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arcticicestudio","download_url":"https://codeload.github.com/arcticicestudio/icecore-hashids/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248137891,"owners_count":21053775,"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":["hash","hash-algorithm","hash-numbers","hashids","icecore","java","library","obfuscation","obfuscator"],"created_at":"2024-11-14T00:42:15.505Z","updated_at":"2025-10-24T02:45:35.188Z","avatar_url":"https://github.com/arcticicestudio.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://cdn.rawgit.com/arcticicestudio/icecore-hashids/develop/src/main/assets/icecore-hashids-logo-banner.svg\"/\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://assets-cdn.github.com/favicon.ico\" width=24 height=24/\u003e \u003ca href=\"https://github.com/arcticicestudio/icecore-hashids/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/release/arcticicestudio/icecore-hashids.svg?style=flat-square\"/\u003e\u003c/a\u003e \u003cimg src=\"http://central.sonatype.org/favicon.ico\" width=24 height=24/\u003e \u003ca href=\"http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.arcticicestudio%22%20AND%20a%3A%22icecore-hashids%22\"\u003e\u003cimg src=\"https://img.shields.io/maven-central/v/com.arcticicestudio/icecore-hashids.svg?style=flat-square\"/\u003e\u003c/a\u003e \u003cimg src=\"https://oss.sonatype.org/favicon.ico\"/\u003e \u003ca href=\"https://oss.sonatype.org/content/repositories/snapshots/com/arcticicestudio/icecore-hashids\"\u003e\u003cimg src=\"https://img.shields.io/badge/snapshot-_---blue.svg?style=flat-square\"/\u003e\u003c/a\u003e \u003cimg src=\"https://bintray.com/favicon.ico\" width=24 height=24/\u003e \u003ca href=\"https://bintray.com/arcticicestudio/IceCore/icecore-hashids/_latestVersion\"\u003e\u003cimg src=\"https://api.bintray.com/packages/arcticicestudio/IceCore/icecore-hashids/images/download.svg\"\u003e\u003c/a\u003e \u003ca href=\"https://oss.jfrog.org/webapp/#/artifacts/browse/tree/General/oss-snapshot-local/com/arcticicestudio/icecore-hashids\"\u003e\u003cimg src=\"https://img.shields.io/badge/artifactory-_---43A047.svg?style=flat-square\"/\u003e\u003c/a\u003e \u003cimg src=\"https://jitpack.io/favicon.ico\"/\u003e \u003ca href=\"https://jitpack.io/#arcticicestudio/icecore-hashids\"\u003e\u003cimg src=\"https://jitpack.io/v/arcticicestudio/icecore-hashids.svg?style=flat-square\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://cdn.travis-ci.org/images/favicon-c566132d45ab1a9bcae64d8d90e4378a.svg\" width=24 height=24/\u003e \u003ca href=\"https://travis-ci.org/arcticicestudio/icecore-hashids\"\u003e\u003cimg src=\"https://img.shields.io/travis/arcticicestudio/icecore-hashids/develop.svg?style=flat-square\"/\u003e\u003c/a\u003e \u003cimg src=\"https://circleci.com/favicon.ico\" width=24 height=24/\u003e \u003ca href=\"https://circleci.com/gh/arcticicestudio/icecore-hashids\"\u003e\u003cimg src=\"https://img.shields.io/circleci/project/github/arcticicestudio/icecore-hashids/develop.svg?style=flat-square\"/\u003e\u003c/a\u003e \u003cimg src=\"https://d234q63orb21db.cloudfront.net/685e381330164f79197bc0e7f75035c6f1b9d7d0/media/images/favicon.png\" width=24 height=24/\u003e \u003ca href=\"https://codecov.io/gh/arcticicestudio/icecore-hashids\"\u003e\u003cimg src=\"https://img.shields.io/codecov/c/github/arcticicestudio/icecore-hashids/develop.svg?style=flat-square\"/\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://arcticicestudio.github.io/icecore-hashids\"\u003e\u003cimg src=\"https://img.shields.io/badge/docs-0.4.0-81A1C1.svg?style=flat-square\"/\u003e\u003c/a\u003e \u003ca href=\"https://arcticicestudio.github.io/icecore-hashids/javadoc\"\u003e\u003cimg src=\"https://img.shields.io/badge/JavaDoc-0.4.0-81A1C1.svg?style=flat-square\"/\u003e\u003c/a\u003e \u003ca href=\"https://github.com/arcticicestudio/icecore-hashids/blob/v0.4.0/CHANGELOG.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/Changelog-0.4.0-81A1C1.svg?style=flat-square\"/\u003e\u003c/a\u003e\u003c/p\u003e\n\n---\n\n\u003cp align=\"center\"\u003eA lightweight generator for short, unique, non-sequential and decodable Hashids from non-negative numbers.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003eImplementation of the \u003ca href=\"http://hashids.org\"\u003eHashids\u003c/a\u003e algorithm.\u003c/p\u003e\n\n[Hashids][hashids] are obfuscated unique hashes of non-negative (long) integer numbers, but in contrast to cryptographic one-way hash algorithms they are can be decoded again. The algorithm can be used to either generate a hash from a single number or bundling several numbers into one to be stored as simple short UIDs. This design allows to use them for many use-cases like\n\n* URL shortening\n* database ID protection\n* shard numbers storage\n* invitation-, authorization- and gift codes\n* complex- or clustered system parameters\n\nNumbers like `347` are converted into strings like `yr8`, or an array of numbers like `[27, 986]` into `3kTMd`.\n\n## Features\n\nThe **algorithm** provides the following features:\n\n* Generation of short, unique, case-sensitive and non-sequential [decodable][docs-api-guide-decoding] hashes of natural numbers\n* Additional entropy through [salt][docs-api-guide-config-salt] usage\n* Configurable [minimum hash length][docs-api-guide-config-min-hash-length] and [alphabet][docs-api-guide-config-alphabet]\n* Combining of [several numbers to one hash][docs-api-guide-encoding]\n* Deterministic hash computation given the same input and parametrization/[instance configuration][docs-api-instances]\n* [Prevention of curse words][docs-api-curse-word-prevention] through separator characters\n\nIn addition, the **library** provides features to\n\n* pass `0x` or `0X` [prefixed hexadecimal numbers][docs-api-guide-config-feature-hex-prefix] to the public API methods\n* [handle exceptions][docs-api-guide-config-feature-exception-handling] instead of returning empty values when invalid parameters are passed to any public API method\n* [disable the maximum number size limit][docs-api-guide-config-feature-no-max-number-size] which ensures the interoperability with the [algorithm reference implementation][hashids-js] and allows the usage of the Java `Long` [maximum value][long-max-value]\n\n\u003e Please note that most features will break the interoperability with the [algorithm reference implementation][hashids-js]!\n\n\n## Getting Started\n\nThe [project documentation][docs] contains chapters to learn about the [installation][docs-getting-started-installation] and [requirements][docs-getting-started-requirements], get an [overview][docs-api] of the API and [learn how to use it][docs-api-guide], and [build][docs-dev-building] the project and [running the tests][docs-dev-testing].\n\n## Contributing\n\nRead the [contributing guide][docs-dev-contributing] to learn about the development process and how to propose [enhancement suggestions][docs-dev-contributing-enhancements] and [report bugs][docs-dev-contributing-bug-reports], how to [submit pull requests][docs-dev-contributing-pr] and the project's [styleguides][docs-dev-contributing-styleguides], [branch organization][docs-dev-contributing-branch-org] and [versioning][docs-dev-contributing-versioning] model.\n\nThe guide also includes information about [minimal, complete, and verifiable examples][docs-dev-contributing-mcve] and other ways to contribute to the project like [improving existing issues][docs-dev-contributing-other-improve-issues] and [giving feedback on issues and pull requests][docs-dev-contributing-other-feedback].\n\n---\n\n\u003cp align=\"center\"\u003eCopyright \u0026copy; 2016-present Arctic Ice Studio\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/arcticicestudio/icecore-hashids/blob/develop/LICENSE.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-5E81AC.svg?style=flat-square\"/\u003e\u003c/a\u003e\u003c/p\u003e\n\n[docs]: https://arcticicestudio.github.io/icecore-hashids\n[docs-api]: https://arcticicestudio.github.io/icecore-hashids/api\n[docs-api-curse-word-prevention]: https://arcticicestudio.github.io/icecore-hashids/api/curse-word-prevention.html\n[docs-api-guide]: https://arcticicestudio.github.io/icecore-hashids/api/guide\n[docs-api-guide-config-alphabet]: https://arcticicestudio.github.io/icecore-hashids/api/guide/configuration/#determine-a-custom-alphabet\n[docs-api-guide-config-feature-exception-handling]: https://arcticicestudio.github.io/icecore-hashids/api/guide/configuration/features.html#exception-handling\n[docs-api-guide-config-feature-hex-prefix]: https://arcticicestudio.github.io/icecore-hashids/api/guide/configuration/features.html#allow-hexadecimal-number-prefixes\n[docs-api-guide-config-feature-no-max-number-size]: https://arcticicestudio.github.io/icecore-hashids/api/guide/configuration/features.html#no-number-size-limit\n[docs-api-guide-config-min-hash-length]: https://arcticicestudio.github.io/icecore-hashids/api/guide/configuration/#defining-a-minimum-hash-length\n[docs-api-guide-config-salt]: https://arcticicestudio.github.io/icecore-hashids/api/guide/configuration/#using-a-salt\n[docs-api-guide-decoding]: https://arcticicestudio.github.io/icecore-hashids/api/guide/decoding.html\n[docs-api-guide-encoding]: https://arcticicestudio.github.io/icecore-hashids/api/guide/encoding.html\n[docs-api-instances]: https://arcticicestudio.github.io/icecore-hashids/api/instances.html\n[docs-dev-building]: https://arcticicestudio.github.io/icecore-hashids/development/building.html\n[docs-dev-contributing]: https://arcticicestudio.github.io/icecore-hashids/development/contributing.html\n[docs-dev-contributing-branch-org]: https://arcticicestudio.github.io/icecore-hashids/development/contributing.html#branch-organization\n[docs-dev-contributing-bug-reports]: https://arcticicestudio.github.io/icecore-hashids/development/contributing.html#bug-reports\n[docs-dev-contributing-enhancements]: https://arcticicestudio.github.io/icecore-hashids/development/contributing.html#enhancement-suggestions\n[docs-dev-contributing-mcve]: https://arcticicestudio.github.io/icecore-hashids/development/contributing.html#mcve\n[docs-dev-contributing-other-feedback]: https://arcticicestudio.github.io/icecore-hashids/development/contributing.html#give-feedback-on-issues-and-pull-requests\n[docs-dev-contributing-other-improve-issues]: https://arcticicestudio.github.io/icecore-hashids/development/contributing.html#improve-issues\n[docs-dev-contributing-pr]: https://arcticicestudio.github.io/icecore-hashids/development/contributing.html#pull-requests\n[docs-dev-contributing-styleguides]: https://arcticicestudio.github.io/icecore-hashids/development/contributing.html#styleguides\n[docs-dev-contributing-versioning]: https://arcticicestudio.github.io/icecore-hashids/development/contributing.html#versioning\n[docs-dev-testing]: https://arcticicestudio.github.io/icecore-hashids/development/testing.html\n[docs-getting-started-installation]: https://arcticicestudio.github.io/icecore-hashids/getting-started/installation.html\n[docs-getting-started-requirements]: https://arcticicestudio.github.io/icecore-hashids/getting-started/requirements.html\n[hashids]: http://hashids.org\n[hashids-js]: https://github.com/ivanakimov/hashids.js\n[long-max-value]: https://docs.oracle.com/javase/8/docs/api/java/lang/Long.html#MAX_VALUE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farcticicestudio%2Ficecore-hashids","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farcticicestudio%2Ficecore-hashids","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farcticicestudio%2Ficecore-hashids/lists"}