{"id":17496991,"url":"https://github.com/bifrost-io/bifrost","last_synced_at":"2026-04-02T20:01:41.889Z","repository":{"id":36964965,"uuid":"199428833","full_name":"bifrost-io/bifrost","owner":"bifrost-io","description":"One Stake, Endless Opportunities. Build with Polkadot SDK (Substrate).","archived":false,"fork":false,"pushed_at":"2026-03-25T06:15:14.000Z","size":95688,"stargazers_count":481,"open_issues_count":22,"forks_count":94,"subscribers_count":14,"default_branch":"develop","last_synced_at":"2026-03-25T08:10:49.450Z","etag":null,"topics":["appchain","bifrost","liquidstaking","omnichain","polkadot","substrate"],"latest_commit_sha":null,"homepage":"https://bifrost.io","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bifrost-io.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-07-29T10:11:20.000Z","updated_at":"2026-03-12T12:49:18.000Z","dependencies_parsed_at":"2024-04-28T04:00:46.313Z","dependency_job_id":"c7f9dc2a-6757-428d-a453-ac9a1ebb5fb8","html_url":"https://github.com/bifrost-io/bifrost","commit_stats":null,"previous_names":["bifrost-io/bifrost","bifrost-finance/bifrost"],"tags_count":424,"template":false,"template_full_name":null,"purl":"pkg:github/bifrost-io/bifrost","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bifrost-io%2Fbifrost","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bifrost-io%2Fbifrost/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bifrost-io%2Fbifrost/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bifrost-io%2Fbifrost/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bifrost-io","download_url":"https://codeload.github.com/bifrost-io/bifrost/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bifrost-io%2Fbifrost/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30975004,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-26T14:13:19.610Z","status":"ssl_error","status_checked_at":"2026-03-26T14:12:43.279Z","response_time":114,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["appchain","bifrost","liquidstaking","omnichain","polkadot","substrate"],"created_at":"2024-10-19T15:01:58.958Z","updated_at":"2026-04-02T20:01:41.848Z","avatar_url":"https://github.com/bifrost-io.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"\u003ca href=\"https://bifrost.io\"\u003e\u003cimg align=\"center\" src=\"./docs/res/readme/bifrost-banner.svg\" alt=\"Bifrost Banner\"/\u003e\u003c/a\u003e\n\n\u003ca href=\"https://bifrost.io\"\u003e\u003cimg align=\"right\" width=\"100\" src=\"./docs/res/readme/bifrost-black-logo.svg\" alt=\"Bifrost Logo\"/\u003e\u003c/a\u003e\n\n\u003ch1 align=\"left\"\u003e\u003ca href=\"https://bifrost.io\"\u003eHomepage\u003c/a\u003e\u003c/h1\u003e\n\nWelcome,\n\nBifrost is a Web3 derivatives protocol that provides decentralized cross-chain liquidity for staked assets. By leveraging on the cross-consensus message ([XCM](https://wiki.polkadot.network/docs/learn-xcm)) it can provide cross-chain liquid staking services for multiple chains.\n\n[Our mission](https://notion.bifrost.io/Bifrost-Roadmap-ba6c44bd4f684e5aa875ec44388b2330) is to provide standardized cross-chain interest-bearing derivatives for [Polkadot](https://polkadot.network) relay chains, parachains, and heterogeneous chains bridged with Polkadot.\n\n👉 _Discover the Bifrost at [bifrost.io](https://bifrost.io/)._  \n👉 _Learn to use the Bifrost with our [docs](https://docs.bifrost.io/)._\n\n\u003ch4\u003e🐣 Supported by\u003c/h4\u003e\n\n\u003cp align=\"left\"\u003e\n  \u003ca href=\"https://web3.foundation/grants\"\u003e\u003cimg src=\"docs/res/readme/web3-foundation-grant.svg\" width=\"200\" alt=\"Web3 Foundation Grants\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.substrate.io/builders-program\"\u003e\u003cimg src=\"docs/res/readme/substrate-builder.svg\" width=\"200\" alt=\"Substrate Builders Program\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://bootcamp.web3.foundation/\"\u003e\u003cimg src=\"docs/res/readme/web3-bootcamp.svg\" width=\"200\" alt=\"Web3 Bootcamp\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n[![master-build](https://img.shields.io/github/actions/workflow/status/bifrost-io/bifrost/ci-build.yml?logo=Buddy)](https://github.com/bifrost-io/bifrost/actions/workflows/ci-build.yml)\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/acec53276777415593c2b02b2200f62e)](https://www.codacy.com/gh/bifrost-io/bifrost?utm_source=github.com\u0026utm_medium=referral\u0026utm_content=bifrost-io/bifrost\u0026utm_campaign=Badge_Grade)\n[![Substrate Version](https://img.shields.io/badge/Substrate-latest-brightgreen?logo=Parity%20Substrate)](https://github.com/paritytech/substrate)\n[![License](https://img.shields.io/github/license/bifrost-io/bifrost?color=blue)](https://github.com/bifrost-io/bifrost/blob/master/LICENSE)\n[![Dapp](https://img.shields.io/badge/Dapp-5c5c5c?logo=Icinga)](https://app.bifrost.io)\n[![Analytics](https://img.shields.io/badge/-Analytics-5c5c5c?logo=Google%20Analytics)](https://stats.bifrost.io)\n[![Discord](https://img.shields.io/badge/-Discord-5c5c5c?logo=Discord)](https://discord.gg/bifrost-io)\n[![Twitter](https://img.shields.io/badge/-X-5c5c5c?logo=X\u0026logoColor=white)](https://x.com/Bifrost)\n\n## Get Build Help\n\nTo see a list of all available make commands and their descriptions:\n\n```sh\nmake help\n```\n\n## Install Rust and required tools\n\n```bash\ncurl https://sh.rustup.rs -sSf | sh\nmake init\n```\n\n## Build binary\n\n```bash\nmake build-all-release\n```\n\n## Format code\n\n```sh\nmake format\n```\n\n## Lint code\n\n```sh\nmake clippy\n```\n\n## Testing\n\n```bash\nmake test-all\n```\n\n## Generate runtime weights\n\nif runtime logic change we may do the benchmarking to regenerate WeightInfo for dispatch calls\n\n```bash\nmake generate-all-weights\n```\n\n## Testing runtime migration\n\nIf modify the storage, should test the data migration before production upgrade.\n\n```bash\n# bifrost kusama\nmake try-kusama-runtime-upgrade\n\n# bifrost polkadot\nmake try-polkadot-runtime-upgrade\n```\n\n## Run local development parachain\n\nrun node with `--chain=bifrost-polkadot-local` to start a local development parachain (not Substrate’s standalone --dev mode).\n\nBifrost does not support --dev.\nAlways use this chain spec instead of Substrate’s --dev mode.\n\nBefore run local development parachain\nYou need to modify OnTimestampSet in the runtime to allow instant block production:\n\n```rust\nimpl pallet_timestamp::Config for Runtime {\n\ttype MinimumPeriod = ConstU64\u003c{ SLOT_DURATION / 2 }\u003e;\n\t/// A timestamp: milliseconds since the unix epoch.\n\ttype Moment = Moment;\n   -type OnTimestampSet = Aura;\n   +type OnTimestampSet = ();\n\ttype WeightInfo = pallet_timestamp::weights::SubstrateWeight\u003cRuntime\u003e;\n}\n\n```\n\n## Run local testnet with polkadot-launch\n\n### Install `polkadot-launch`\n\n```bash\nyarn global add polkadot-launch\ncd -\n```\n\n### Build polkadot\n\n```bash\n# replace version with your target polkadot version\ncargo install --git https://github.com/paritytech/polkadot --tag \u003cversion\u003e polkadot --locked\n```\n\n### Launch Polkadot and the parachain\n\n```bash\ncd -\npolkadot-launch ./scripts/bifrost-launch.json\n```\n\nIt will take about 1-2 minutes for the parachain to start producing blocks.\n\n## Run local testnet with parachain-launch\n\n### Install `parachain-launch`\n\n```sh\nyarn global add @open-web3/parachain-launch\n```\n\n### Generate docker files\n\n```sh\nparachain-launch generate --config=scripts/bifrost-docker-launch.yml --yes\n```\n\nIt will pull images and generate required docker files in a folder called `output` in your current working directory\n\n### Start relaychain and parachain\n\nTo start the nodes, navigate to the output folder that the generated docker scripts in and start containers:\n\n```sh\ncd ./output\ndocker-compose up -d --build\n```\n\n## Run full node\n\n### Create `bifrost-fullnode` directory, generate `node-key` and get `bifrost.json`\n\n```sh\nmkdir -p ~/node-key\nsubkey generate-node-key --file ~/node-key/bifrost.key\n```\n\n### Start full node\n\nReplace your-fullnode-name\n\n```sh\ndocker pull bifrostnetwork/bifrost:latest\ndocker run -d \\\n-v ~/node-key:/node-key \\\n-p 9944:9944 \\\n-p 9933:9933 \\\n-p 30333:30333 \\\nbifrostnetwork/bifrost:latest \\\n  --name your-fullnode-name \\\n  --base-path \"/data\" \\\n  --node-key-file \"/node-key/bifrost.key\" \\\n  --chain \"/spec/bifrost.json\" \\\n  --pruning=archive \\\n  --rpc-external \\\n  --ws-external \\\n  --rpc-cors all \\\n  --trie-cache-size 0 \\\n  --execution wasm\n```\n\n### snapshot\n\nThere are also some snapshots you can use to quickly get started, these are provided by the community.\n\n-   Pre-req .\n\n    zstd and aria2\n\n    ```sh\n\n    sudo apt install zstd\n    sudo apt install aria2\n    ```\n\n#### bifrost-kusama snapshots\n\n-   relay-chain data\n\n```sh\n# download dict\nwget https://snapshot-1258776962.cos.ap-hongkong.myqcloud.com/bifrost-kusama/relay.dict\n\n# download zst data\naria2c -x10 https://snapshot-1258776962.cos.ap-hongkong.myqcloud.com/bifrost-kusama/relay.tar.zst\n\n# decompress: node is basepath, you can replace any dicrectory you like\nmkdir node\ntar -I 'zstd -vd -T0 -D relay.dict' -xvf relay.tar.zst -C node/.\n```\n\n-   parachain data\n\n```sh\nwget https://snapshot-1258776962.cos.ap-hongkong.myqcloud.com/bifrost-kusama/para.dict\naria2c -x10  https://snapshot-1258776962.cos.ap-hongkong.myqcloud.com/bifrost-kusama/para.tar.zst\n\ntar -I 'zstd -vd -T0 -D para.dict' -xvf para.tar.zst -C node/.\n```\n\n#### bifrost-polkadot snapshots\n\nlink:\n\n-   [relay chain dict](https://snapshot-1258776962.cos.ap-hongkong.myqcloud.com/bifrost-polkadot/relay.dict)\n-   [relay chain zst data](https://snapshot-1258776962.cos.ap-hongkong.myqcloud.com/bifrost-polkadot/relay.tar.zst)\n\n-   [para chain dict](https://snapshot-1258776962.cos.ap-hongkong.myqcloud.com/bifrost-polkadot/para.dict)\n-   [para chain zst data](https://snapshot-1258776962.cos.ap-hongkong.myqcloud.com/bifrost-polkadot/para.tar.zst)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbifrost-io%2Fbifrost","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbifrost-io%2Fbifrost","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbifrost-io%2Fbifrost/lists"}