{"id":22915011,"url":"https://github.com/stratisproject/addressownershiptool","last_synced_at":"2025-08-16T22:32:19.814Z","repository":{"id":228200352,"uuid":"722885940","full_name":"stratisproject/AddressOwnershipTool","owner":"stratisproject","description":null,"archived":false,"fork":false,"pushed_at":"2024-05-07T00:49:44.000Z","size":410,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-06-17T22:39:33.982Z","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":"gpl-2.0","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.txt","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}},"created_at":"2023-11-24T07:25:35.000Z","updated_at":"2024-05-07T00:49:48.000Z","dependencies_parsed_at":"2024-05-03T02:29:09.577Z","dependency_job_id":"59042e52-994e-4277-a2e8-f8f5d92c7a58","html_url":"https://github.com/stratisproject/AddressOwnershipTool","commit_stats":null,"previous_names":["stratisproject/addressownershiptool"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/stratisproject/AddressOwnershipTool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FAddressOwnershipTool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FAddressOwnershipTool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FAddressOwnershipTool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FAddressOwnershipTool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stratisproject","download_url":"https://codeload.github.com/stratisproject/AddressOwnershipTool/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FAddressOwnershipTool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270781196,"owners_count":24643804,"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","status":"online","status_checked_at":"2025-08-16T02:00:11.002Z","response_time":91,"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":[],"created_at":"2024-12-14T05:18:17.797Z","updated_at":"2025-08-16T22:32:19.776Z","avatar_url":"https://github.com/stratisproject.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Instructions\n\n## Overview\n\nAddressOwnership tool consists of two components:\n\n1. *Console application* - used to generate swap claims, burn claims and distribution files.\n2. *Web application* - for distributing all claimed tokens from burns and manual claims.\n\n## Running from source code\n\nClone solution from this repository and compile it using dotnet tools.\n\nRun the executable with help options\n\n```\n./AddressOwnershipTool.exe --help\n```\n\nThere will be 3 operations available:\n\n1. *Claim* - this will scan your current wallet for available funds to be swapped to a new token. Once you run it, it will generate a claim file that can be sent to Stratis team for validation and distribution\n2. *Validate* - this will validate claim files and will generate a distribution file. This one will be mainly used by Stratis team.\n3. *Scan* - this operation will scan Strax and Cirrus network for any burn claims and will also generate a distribution file.\n\nSee see parameters required for each command, run `./AddressOwnershipTool.exe \u003ccommand\u003e --help`\n\nFor example:\n\n```\n./AddressOwnershipTool.exe claim --help\n```\n\nThis will show you required and optional parameters that you need to pass.\n\n### Claim\n\nRun a claim, there are number of options available. The most common way to claim your tokens is to have Strax or Cirrus wallet running locally on your machine and then running the follwoing command:\n\n```\n./AddressOwnershipTool.exe claim --walletname=your_wallet_name --destination=your_stratisevm_address --walletpassword=your_wallet_password\n```\n\nYou can also optionally supply destination path `--outputFolder=yourpath` where the file will be generated, otherwise claim file will be created in the same location as AddressOwnershipTool.\n\n### Validate\n\nThis step is to be used to validate all claim files and generate a token distribution file.\n\nValidation uses local Strax/Cirrus node to perform balance check. Make sure you have local node running with address indexer and fully synced. For example to run testnet Strax node, use:\n\n```\n.\\Stratis.StraxD.exe -testnet -addressindex\n```\n\nA typical run would look like this:\n\n```\n./AddressOwnershipTool.exe validate --sigfolder=path_to_folder_containing_claim_files\n```\n\nThis command will scan all claim `.csv` files in specified sigfolder location and output distribution file to be used by a web app.\n\n### Scan\n\nScan command scans Strax or Cirrus snapshot for any token burns and creates a distribution file from it. A typical run would look like:\n\n```\n./AddressOwnershipTool.exe scan --start=2062730\n```\n\nwhere `start` is the block number to start scan from. You can optionally supply `end` parameter to specify an end block. Please note, this oeration will take a while to process depending on number of blocks it needs to scan.\n\nUpon completion of this command, a distribution file will be created.\n\n### Distribution\n\nFor distribution, please use Web app *AddressOwnershipTool.Web*. It is a web app with ASP.NET backend and Angular frontend.\n\n**Prerequisites**:\n\n1. Chrome browser\n2. Metamask\n3. Ledger device (optional)\n\n**App usage**:\n\n1. Run web app\n2. Connect to the tool using MetaMask, you will be prompted.\n3. Once signed in, select a folder containing all your distribution `.csv` files from **Scan** and **Validate** steps above.\n4. Select claims to process and validate each transaction with MetaMask.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstratisproject%2Faddressownershiptool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstratisproject%2Faddressownershiptool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstratisproject%2Faddressownershiptool/lists"}