{"id":22915058,"url":"https://github.com/stratisproject/federatedsidechains","last_synced_at":"2025-05-12T13:45:17.354Z","repository":{"id":56204856,"uuid":"136144492","full_name":"stratisproject/FederatedSidechains","owner":"stratisproject","description":null,"archived":false,"fork":false,"pushed_at":"2020-11-20T15:40:37.000Z","size":4211,"stargazers_count":23,"open_issues_count":29,"forks_count":25,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-31T22:41:27.836Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","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/stratisproject.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}},"created_at":"2018-06-05T08:21:50.000Z","updated_at":"2024-01-31T11:12:57.000Z","dependencies_parsed_at":"2022-08-15T14:40:33.331Z","dependency_job_id":null,"html_url":"https://github.com/stratisproject/FederatedSidechains","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FFederatedSidechains","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FFederatedSidechains/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FFederatedSidechains/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FFederatedSidechains/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stratisproject","download_url":"https://codeload.github.com/stratisproject/FederatedSidechains/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253749901,"owners_count":21958206,"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":[],"created_at":"2024-12-14T05:18:31.046Z","updated_at":"2025-05-12T13:45:17.329Z","avatar_url":"https://github.com/stratisproject.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"| Windows | MacOs | Ubuntu64\n| :---- | :------ | :---- |\n| [![Build Status](https://dev.azure.com/StratisProject/FederatedSidechains/_apis/build/status/FederatedSidechains-.NET-HostedWindowsContainer-CI?branchName=master)](https://dev.azure.com/StratisProject/FederatedSidechains/_build?definitionId=1) | [![Build Status](https://dev.azure.com/StratisProject/FederatedSidechains/_apis/build/status/FederatedSidechains-.NET-HostedmacOS-CI?branchName=master)](https://dev.azure.com/StratisProject/FederatedSidechains/_build?definitionId=3) | [![Build Status](https://dev.azure.com/StratisProject/FederatedSidechains/_apis/build/status/FederatedSidechains-.NET-HostedUbuntu1604-CI?branchName=master)](https://dev.azure.com/StratisProject/FederatedSidechains/_build?definitionId=2)\n\n\nStratis Federated Sidechains\n============================\nhttps://stratisplatform.com\n\n\n# Get Started with Cirrus\nThe below steps will guide you through the following.\n\n - Clone the FederatedSidechains Repository\n - Run a node on the Stratis Sidechain (Cirrus)\n - Create a Wallet via the API\n - Retreive an Address via the API\n - How to get funds\n \n For simplicity, PowerShell commands have been provided for each section.\n\n ## Step 1 - Clone FederatedSidechains Repository\n\nTo begin, we first need to define the location that the Stratis FederatedSidechains repository will be cloned to, this can be done by executing the below script-block. The example below will utilize the logged-on user's desktop directory.\n\n    $CloneDirectory = \"$env:USERPROFILE\\Desktop\\FederatedSidechains\"\n\nWe then need to define the repository that you will clone.\n\n    $RepositoryURL = \"https://github.com/stratisproject/FederatedSidechains.git\"\n\nNow we can clone the repository using Git. \n\n    Start-Process \"git.exe\" -ArgumentList \"clone $RepositoryURL $CloneDirectory\"\n\n\n\n## Step 2 - Run the Sidechain Node\n\nTo run a Cirrus Node we simply need to run the Stratis.SideChainD project. This can be achieved by running the below PowerShell script-block.\n\n    Set-Location \"$CloneDirectory\\src\\Stratis.SidechainD\"\n    Start-Process \"dotnet.exe\" -ArgumentList \"run\"\n\nIn addition, we can run the below PowerShell script-block that will wait for the Sidechain Node API to become available and then present it to you in Internet Explorer.\n\n    While (!(Get-NetTCPConnection -LocalPort \"38225\" -ErrorAction SilentlyContinue)) {\n        Write-Host \"Waiting for node to become available...\" -ForegroundColor Yellow\n        Start-Sleep 10}\n        Start-Process \"iexplore.exe\" -ArgumentList \"http://localhost:38225/swagger/index.html\"\n   \n\n## Step 3 - Create a Wallet\n\nNow you are running a node, you will now need to create a wallet that will be used to store funds on the Cirrus Sidechain. This can be done interactively via the Swagger API that we opened previously, alternatively, this can be done via PowerShell.\n\nThe below PowerShell script-block with generate your unique mnemonic words.\n\n    $Mnemonic = Invoke-WebRequest -Uri \"http://localhost:38225/api/Wallet/mnemonic?language=english\u0026wordCount=12\" | Select-Object -ExpandProperty Content\n    $Mnemonic = $Mnemonic -replace '[\"]',''\n    $Mnemonic\n    \n**Important: Please be sure to keep note of your mnemonic words**\n\nNow we have a set of unique mnemonic words, we can create a wallet. \n\n    $WalletName = Read-Host -Prompt \"What do you want to call the wallet?\"\n    $WalletPassphrase = Read-Host -Prompt \"Please enter a Passphrase to secure the private key\"\n    $WalletPassword = Read-Host -Prompt \"Please enter a Password to secure the wallet\"\n    $Params = @{\"mnemonic\" = $Mnemonic; \"password\" = $WalletPassword; \"passphrase\" = $WalletPassword; \"name\" = \"$WalletName\"}\n    Invoke-WebRequest -Uri http://localhost:38225/api/Wallet/create -Method post -Body ($Params|ConvertTo-Json) -ContentType \"application/json\"\n\nWe now have now created a wallet. \n\n**Important: Please be sure to keep note of your mnemonic words, passphrase and password. These will be needed to recover a wallet in the event of a disaster.**\n\n## Step 4 - Obtain an Address\n\nIn order to receive funds in your newly created wallet, you will need to obtain an address that is unique to your wallet. You can do this by executing the below PowerShell script-block.\n\n    $Address = Invoke-WebRequest -Uri \"http://localhost:38225/api/Wallet/unusedaddress?WalletName=$WalletName\u0026AccountName=account%200\" | Select-Object -ExpandProperty Content\n    $Address = $Address -replace '[\"]',''\n    $Address\n\n## Step 5 - How to get funds?\n\nThe token issued on the Cirrus Sidechain is CRS. These are pegged to the Stratis Mainnet Chain and are valued at a 1:1 ratio. i.e. 1 STRAT is equal to 1 CRS. \n\nTransferring STRAT to the Cirrus Sidechain can be achieved by further interacting with the API, however, it will be introduced as a feature in an upcoming version of Stratis Core, allowing for seamless transfers from one chain to another within the UI of Stratis Core. \n\nFor the Cirrus Sidechain, Stratis has set aside an amount of CRS that it will distribute to anyone wanting to deploy Smart Contracts on the Cirrus Sidechain. CRS tokens hold a value, as they are pegged to the STRAT token, as a result, CRS will be distributed at the discretion of Stratis.\n\nTo get your hands on some CRS and start deploying Smart Contracts in C#, head over to our Discord channel where there will be plenty of people whom are able to send some CRS to your newly created Cirrus Wallet.\n\n[Discord](https://discordapp.com/invite/9tDyfZs)\n\nFor more information on how to deploy a Smart Contract in C#, head over to the Stratis Academy.\n\n[Stratis Academy - Smart Contracts in C#](https://academy.stratisplatform.com/SmartContracts/smart-contracts-introduction.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstratisproject%2Ffederatedsidechains","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstratisproject%2Ffederatedsidechains","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstratisproject%2Ffederatedsidechains/lists"}