{"id":13639152,"url":"https://github.com/urbit/azimuth","last_synced_at":"2025-04-07T05:09:41.613Z","repository":{"id":33501656,"uuid":"157789836","full_name":"urbit/azimuth","owner":"urbit","description":"General-purpose PKI on Ethereum","archived":false,"fork":false,"pushed_at":"2023-12-20T18:28:29.000Z","size":1422,"stargazers_count":132,"open_issues_count":14,"forks_count":37,"subscribers_count":31,"default_branch":"master","last_synced_at":"2024-03-15T04:47:38.034Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Solidity","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/urbit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","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}},"created_at":"2018-11-16T00:26:08.000Z","updated_at":"2024-06-21T17:39:19.349Z","dependencies_parsed_at":"2024-06-21T17:38:55.643Z","dependency_job_id":"1ffc3270-8eb6-4612-88e4-f41b9efd717c","html_url":"https://github.com/urbit/azimuth","commit_stats":{"total_commits":468,"total_committers":22,"mean_commits":"21.272727272727273","dds":"0.31837606837606836","last_synced_commit":"c2f909b23c4ec39932febc6f6fd2eba5279cdbcf"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbit%2Fazimuth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbit%2Fazimuth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbit%2Fazimuth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbit%2Fazimuth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/urbit","download_url":"https://codeload.github.com/urbit/azimuth/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247595334,"owners_count":20963943,"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-08-02T01:00:58.178Z","updated_at":"2025-04-07T05:09:41.592Z","avatar_url":"https://github.com/urbit.png","language":"Solidity","readme":"# Azimuth\n\n[![Build Status](https://secure.travis-ci.org/urbit/azimuth.png?branch=master)](http://travis-ci.org/urbit/azimuth)\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/urbit/azimuth/blob/master/LICENSE)\n[![npm](https://img.shields.io/npm/v/azimuth-solidity.svg)](https://www.npmjs.com/package/azimuth-solidity)\n\nA general-purpose PKI, live on the Ethereum blockchain.\n\n## Overview\n\nThis is just a quick summary of the different contracts and their purposes. For more detailed descriptions, see the inline documentation in the contracts themselves.\n\n* **Azimuth**: contains all on-chain state for azimuth. Most notably, ownership and public keys. Can't be modified directly, you must use the Ecliptic.\n* **Ecliptic**: is used as an interface for interacting with your points on-chain. Allows you to configure keys, transfer ownership, etc.\n* **Polls**: registers votes by the Galactic Senate on proposals. These can be either static documents or Ecliptic upgrades.\n* **Linear Star Release**: facilitates the release of blocks of stars to their owners over a period of time.\n* **Conditional Star Release**: facilitates the release of blocks of stars to their owners based on milestones.\n* **Claims**: allows point owners to make claims about (for example) their identity, and associate that with their point.\n* **Censures**: simple reputation management, allowing galaxies and stars to flag points for negative reputation.\n* **Delegated Sending**: enables network-effect like distributing of planets.\n* **Planet Sale**: gives an example of a way in which stars could sell planets on-chain.\n\n## Live contracts\n\nThe core Azimuth contracts can be found on the Ethereum blockchain.\n\n* **Azimuth**: [azimuth.eth / `0x223c067f8cf28ae173ee5cafea60ca44c335fecb`](https://etherscan.io/address/azimuth.eth)\n* **Ecliptic**: [ecliptic.eth / `0x33eecbf908478c10614626a9d304bfe18b78dd73`](https://etherscan.io/address/ecliptic.eth)\n* **Polls**: [`0x7fecab617c868bb5996d99d95200d2fa708218e4`](https://etherscan.io/address/0x7fecab617c868bb5996d99d95200d2fa708218e4)\n* **Linear Star Release**: [`0x86cd9cd0992f04231751e3761de45cecea5d1801`](https://etherscan.io/address/0x86cd9cd0992f04231751e3761de45cecea5d1801)\n* **Conditional Star Release**: [`0x8c241098c3d3498fe1261421633fd57986d74aea`](https://etherscan.io/address/0x8c241098c3d3498fe1261421633fd57986d74aea)\n* **Claims**: [`0xe7e7f69b34d7d9bd8d61fb22c33b22708947971a`](https://etherscan.io/address/0xe7e7f69b34d7d9bd8d61fb22c33b22708947971a)\n* **Censures**: [`0x325f68d32bdee6ed86e7235ff2480e2a433d6189`](https://etherscan.io/address/0x325f68d32bdee6ed86e7235ff2480e2a433d6189)\n* **Delegated Sending**: [`0xf6b461fe1ad4bd2ce25b23fe0aff2ac19b3dfa76`](https://etherscan.io/address/0xf6b461fe1ad4bd2ce25b23fe0aff2ac19b3dfa76)\n* **Planet Sale**: Deploy It Yourself!\n\n## Galactic Senate\n\nA suggested process for publicizing the proposals voted on by the Galactic Senate is described in [`senate.md`](./senate.md). Following that process, proposals that have been voted on and achieved majority can be found in [`proposals/`](./proposals/).\n\n## Running\n\nAs a pre-requisite, `truffle` is required to be installed globally:\n\n```\nnpm install -g truffle\n```\n\nInstall dependencies. Most notable inclusion is [Zeppelin-Solidity](https://openzeppelin.org/).\n\n```\nnpm install\n```\n\nBuild, deploy and test via [Truffle](http://truffleframework.com/) using the following commands:\n\n```\nnpx truffle compile\nnpx truffle deploy\nnpx truffle test\n```\n\nWhen verifying deployed contracts on services like Etherscan, be sure to use [truffle-flattener](https://github.com/alcuadrado/truffle-flattener) for flattening contracts into single files.\n\n## Tests\n\nTo run the contract test suite automatically, use a simple:\n\n```\nnpm test\n```\n\nThis will spin up a local [Ganache](https://github.com/trufflesuite/ganache-cli) node in the background.  If you'd like to use a persistent node, you can run\n\n```\nnpx ganache-cli --gasLimit 6000000\n```\n\nand then test via `npx truffle test`.\n\nFor testing Ecliptic upgrades against whatever version of the contract is on mainnet, first run:\n\n```\nnpm run fork-mainnet\n```\n\nThis will start a local fork of mainnet, with the ownership addresses of the first 128 galaxies unlocked. Once that's ready, you can run the following in a separate terminal:\n\n```\nnpm run test-upgrade\n//  or, to upgrade to a pre-existing contract, specify its address:\nnpm run test-upgrade -- --target='0xabcd...'\n```\n\nThis will deploy the Ecliptic contract currently in the repository to the local fork (or refer to the specified upgrade target), and test if it can be upgraded to cleanly. Because this involves many transactions (for voting), this may take a couple minutes.\n\nThere are also tests located in `test-extras` that are not meant to be run via\na basic `npx truffle test` as they can fail nondeterministically.  You can run\nthese via:\n\n```\nnpm run test-extras\n```\n\n","funding_links":[],"categories":["Infrastructure"],"sub_categories":["Arvo"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furbit%2Fazimuth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Furbit%2Fazimuth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furbit%2Fazimuth/lists"}