Nacho Printing Machine

    TypeScript icon, indicating that this package has built-in type declarations

    0.2.1 • Public • Published

    Codegen Graph TS

    Use codegen-graph-ts to generate a TypeScript (or Javascript) library which can be used to query a subgraph on The Graph.

    • Generated functions provide full type checking and support for all options provided by the underlying GraphQL API.
    • Pagination is handled automatically, so you can easily retrieve more than 1,000 records per call.
    • Create standard await/async functions or react-query hooks.


    Replace the URL below with the Queries (HTTP) endpoint from The Graph. Then run the code snippet to create a subgraph.ts file. Note that you’ll need to keep the npm dependency in your project for the generated file to function. To generate JavaScript functions, rather than Typescript, add the --js flag to the last command. Add the --method reactquery option to generate react-query hooks instead of standard async/await functions.

    npm i --save codegen-graph-ts
    npx codegen-graph-ts pull > manifest.json
    npx codegen-graph-ts gen -s manifest.json -o subgraph.ts

    Now you now have a TypeScript file, subgraph.ts, which can be used to query data. Review the file for the names of the generated functions.

    The code snippet below could be used to display the top 1,500 user balances from a hypothetical subgraph at the example endpoint:

    import { getManyUserBalance } from './subgraph';
    const SUBGRAPH_URL = '';
    const func = async () => {
        const topBalances = await getManyUserBalance(
                first: 1500,
                orderBy: 'balanceOf',
                orderDirection: 'desc'
            }, {
                id: true,
                balanceOf: true,
                token: { symbol: true, name: true }
        console.log('Top Balances');
        for (const entry of topBalances) {
            console.log(`${}: ${entry.balanceOf.toString(2)}`);

    Usage with CI

    You may want to add your manifest.json to your git repository and use a CI pipeline to generate the subgraph.ts. This allows your project to retain consistency and manage upgrades if the upstream subgraph changes.

    In this case, you can generate the subgraph programmatically. For example:

    const cgt = require('codegen-graph-ts');
    const text = cgt.gen({
        schema: JSON.parse(fs.readFileSync('manifest.json')),
        method: 'plain' // Alternatively, set to 'react-query'
    fs.writeFileSync(`subgraphQuery.ts`, text);

    Publish new version

    If you want to publish some changes to this repo all you have to do is increase the version number in package.json. Please follow semver

    Testing publish workflow


    • codegen-graph-demo - A simple demo that showcases the functionality of this library.
    • @synthetixio/queries - A library which uses codegen-graph-ts in its CI and delivers robust client-side integration of subgraphs with react-query.




    npm i maxibon-codegen-graph-ts

    DownloadsWeekly Downloads






    Unpacked Size

    383 kB

    Total Files


    Last publish


    • fritzschoff