{"id":18668259,"url":"https://github.com/nation3/subgraphs","last_synced_at":"2025-07-14T19:40:05.569Z","repository":{"id":215409655,"uuid":"738513364","full_name":"nation3/subgraphs","owner":"nation3","description":"Subgraphs for Nation3 smart contracts","archived":false,"fork":false,"pushed_at":"2024-03-02T14:13:06.000Z","size":133,"stargazers_count":0,"open_issues_count":2,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-05-18T07:39:03.950Z","etag":null,"topics":["subgraph","subgraphs"],"latest_commit_sha":null,"homepage":"https://thegraph.com/hosted-service/dashboard","language":"TypeScript","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/nation3.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":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-03T11:59:10.000Z","updated_at":"2024-01-05T21:39:50.000Z","dependencies_parsed_at":"2024-03-02T14:07:45.609Z","dependency_job_id":"7781a385-6db2-4e51-8d14-86c906c35b72","html_url":"https://github.com/nation3/subgraphs","commit_stats":null,"previous_names":["nation3/subgraphs"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nation3/subgraphs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nation3%2Fsubgraphs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nation3%2Fsubgraphs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nation3%2Fsubgraphs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nation3%2Fsubgraphs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nation3","download_url":"https://codeload.github.com/nation3/subgraphs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nation3%2Fsubgraphs/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265336610,"owners_count":23749193,"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":["subgraph","subgraphs"],"created_at":"2024-11-07T08:42:02.336Z","updated_at":"2025-07-14T19:40:05.517Z","avatar_url":"https://github.com/nation3.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌐 Subgraphs\n\nSubgraphs for Nation3 smart contracts\n\n## Deployed Subgraphs\n\n### 🛂 [Passport Issuance](./passportissuance/)\n\nThis subgraph tracks the following events from the Nation3 [`PassportIssuer`](https://github.com/nation3/foundations/blob/main/src/passport/PassportIssuer.sol) contract:\n\n- `event Attest(address indexed _to, uint256 indexed _tokenId);`\n\n  Tracks Passport issuance. Initiated by [`claim(uint8, bytes32, bytes32)`](https://github.com/nation3/foundations/blob/main/src/passport/PassportIssuer.sol#L131)\n\n- `event Revoke(address indexed _to, uint256 indexed _tokenId);`\n\n  Tracks Passport revocations. Initiated by [`revoke(address)`](https://github.com/nation3/foundations/blob/main/src/passport/PassportIssuer.sol#L150).\n\n- `event UpdateRequirements(uint256 claimRequiredBalance, uint256 revokeUnderBalance);`\n\n  Tracks changes to Passport issuance params. Initiated by [`setParams(uint256, uin256)`](https://github.com/nation3/foundations/blob/main/src/passport/PassportIssuer.sol#L162)\n\n### ⚖️ Agreements\n\nSee https://github.com/nation3/agreements-contracts/tree/main/packages/subgraph\n\n## Querying Subgraphs\n\nRefer to the latest deployment's query URL on the following N3 subgraph pages:\n\n### 🛂 PassportIssuer\n\n- Mainnet: https://thegraph.com/hosted-service/subgraph/nation3/passportissuance\n\n### ⚖️ Agreements\n\n- Mainnet: https://thegraph.com/hosted-service/subgraph/nation3/nation3-agreements-mainnet\n- Sepolia: https://thegraph.com/hosted-service/subgraph/nation3/nation3-agreements-sepolia\n\n---\n\nRefer to the following guide from [The Graph's docs](https://thegraph.com/docs/en/querying/querying-the-graph/) on how to execute a query remotely.\n\n## Contributing\n\nRefer to [this document from The Graph's docs](https://thegraph.com/docs/en/developing/creating-a-subgraph/) on how to set up your development environment for making changes to, and deploying new, subgraphs.\n\n## Testing\n\nTwo options are available for testing:\n\n1. [Local Graph deployment (integration testing)](/#Local)\n2. [Matchstick unit tests](/#Matchstick)\n\n### Local\n\nTo test your changes to the subgraph locally you will need a local IPFS Gateway for the subgraph to deploy files to.\n\nRefer to [this guide](https://docs.ipfs.tech/how-to/command-line-quick-start/) to learn how to do so and ensure your gateway points to `http://localhost:5001`.\n\nThen run the following commands in the subgraph's directory (e.g. the [PassportIssuer](./passportissuance/) subgraph directory):\n\n```console\nnpm run codegen\nnpm run build\nnpm run create-local\nnpm run deploy-local\n```\n\n### [Matchstick](https://github.com/LimeChain/matchstick/blob/main/README.md)\n\nSimply run the following command to run the available tests in their respective subgraph directories (e.g. [PassportIssuer](./passportissuance/)):\n\n```console\nnpm run test\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnation3%2Fsubgraphs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnation3%2Fsubgraphs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnation3%2Fsubgraphs/lists"}