@subql/common-solana 0.0.0-1

package/dist/codegen/codegen.d.ts

@@ -0,0 +1,4 @@
+import { SubqlDatasource, SubqlRuntimeDatasource } from '@subql/types-solana';
+import { Data } from 'ejs';
+export declare function validateDiscriminators(dataSources: SubqlRuntimeDatasource[], projectPath: string): Promise<void>;
+export declare function generateIDLInterfaces(dataSources: SubqlDatasource[], projectPath: string, renderTemplate: (templatePath: string, outputPath: string, templateData: Data) => Promise<void>): Promise<void>;

package/dist/codegen/codegen.js

@@ -0,0 +1,68 @@
+"use strict";
+// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
+// SPDX-License-Identifier: GPL-3.0
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDiscriminators = validateDiscriminators;
+exports.generateIDLInterfaces = generateIDLInterfaces;
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_path_1 = __importDefault(require("node:path"));
+const renderers_js_1 = require("@codama/renderers-js");
+const types_solana_1 = require("@subql/types-solana");
+const codama_1 = require("codama");
+const idl_1 = require("./idl");
+const INSTRUCTION_TEMPLATE_TS = node_path_1.default.resolve(__dirname, '../../templates/idl.ts.ejs');
+const CODAMA_PATH = '/src/types/program-interfaces';
+const IDL_PATH = '/src/types/handler-inputs';
+async function validateDiscriminators(dataSources, projectPath) {
+    const issues = [];
+    for (const ds of dataSources) {
+        for (const handler of ds.mapping.handlers) {
+            if (!handler.filter) {
+                break;
+            }
+            switch (handler.kind) {
+                case types_solana_1.SolanaHandlerKind.Instruction: {
+                    if (handler.filter.discriminator && handler.filter.programId) {
+                        const fileRef = ds.assets?.get(handler.filter.programId);
+                        if (!fileRef) {
+                            issues.push(`Datasource has a handler with a discriminator but no IDL file reference`);
+                            continue;
+                        }
+                        const idlPath = node_path_1.default.join(projectPath, fileRef.file);
+                        const idl = await (0, idl_1.parseIdlFromFile)(idlPath);
+                        if (!(0, idl_1.findInstructionDiscriminatorByName)(idl.getRoot(), handler.filter.discriminator)) {
+                            issues.push(`Datasource has a handler with a discriminator ${handler.filter.discriminator} but no matching instruction found in IDL`);
+                        }
+                        // TODO check discriminator in IDL
+                    }
+                    break;
+                }
+                default:
+                /* Do nothing, there is nothing extra to validate*/
+            }
+        }
+    }
+    (0, node_assert_1.default)(issues.length === 0, issues.join('\n'));
+}
+async function generateIDLInterfaces(dataSources, projectPath, renderTemplate) {
+    const allAssets = new Map(dataSources.filter((ds) => ds.assets !== undefined).flatMap((ds) => Array.from(ds.assets.entries())));
+    await validateDiscriminators(dataSources.filter((ds) => ds.kind === types_solana_1.SolanaDatasourceKind.Runtime), projectPath);
+    for (const [name, fileRef] of allAssets) {
+        const idlPath = node_path_1.default.join(projectPath, fileRef.file);
+        const idl = await (0, idl_1.parseIdlFromFile)(idlPath);
+        const output = node_path_1.default.join(projectPath, CODAMA_PATH, name);
+        await idl.accept((0, renderers_js_1.renderVisitor)(output, {}));
+        const instructionNames = idl.getRoot().program.instructions.map((inst) => (0, codama_1.pascalCase)(inst.name));
+        await renderTemplate(INSTRUCTION_TEMPLATE_TS, node_path_1.default.join(projectPath, IDL_PATH, `${name}.ts`), {
+            props: {
+                name,
+                instructions: instructionNames,
+            },
+        });
+        console.log(`* IDL ${name} generated`);
+    }
+}
+//# sourceMappingURL=codegen.js.map

package/dist/codegen/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../../src/codegen/codegen.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors\n// SPDX-License-Identifier: GPL-3.0\n\nimport assert from 'node:assert';\nimport path from 'node:path';\nimport {renderVisitor} from '@codama/renderers-js';\nimport {SolanaDatasourceKind, SolanaHandlerKind, SubqlDatasource, SubqlRuntimeDatasource} from '@subql/types-solana';\nimport {pascalCase} from 'codama';\nimport {Data} from 'ejs';\nimport {parseIdlFromFile, findInstructionDiscriminatorByName} from './idl';\n\nconst INSTRUCTION_TEMPLATE_TS = path.resolve(__dirname, '../../templates/idl.ts.ejs');\nconst CODAMA_PATH = '/src/types/program-interfaces';\nconst IDL_PATH = '/src/types/handler-inputs';\n\nexport async function validateDiscriminators(\n  dataSources: SubqlRuntimeDatasource[],\n  projectPath: string\n): Promise<void> {\n  const issues: string[] = [];\n\n  for (const ds of dataSources) {\n    for (const handler of ds.mapping.handlers) {\n      if (!handler.filter) {\n        break;\n      }\n      switch (handler.kind) {\n        case SolanaHandlerKind.Instruction: {\n          if (handler.filter.discriminator && handler.filter.programId) {\n            const fileRef = ds.assets?.get(handler.filter.programId);\n            if (!fileRef) {\n              issues.push(`Datasource has a handler with a discriminator but no IDL file reference`);\n              continue;\n            }\n\n            const idlPath = path.join(projectPath, fileRef.file);\n            const idl = await parseIdlFromFile(idlPath);\n\n            if (!findInstructionDiscriminatorByName(idl.getRoot(), handler.filter.discriminator)) {\n              issues.push(\n                `Datasource has a handler with a discriminator ${handler.filter.discriminator} but no matching instruction found in IDL`\n              );\n            }\n            // TODO check discriminator in IDL\n          }\n          break;\n        }\n        default:\n        /* Do nothing, there is nothing extra to validate*/\n      }\n    }\n  }\n\n  assert(issues.length === 0, issues.join('\\n'));\n}\n\nexport async function generateIDLInterfaces(\n  dataSources: SubqlDatasource[],\n  projectPath: string,\n  renderTemplate: (templatePath: string, outputPath: string, templateData: Data) => Promise<void>\n): Promise<void> {\n  const allAssets = new Map(\n    dataSources.filter((ds) => ds.assets !== undefined).flatMap((ds) => Array.from(ds.assets!.entries()))\n  );\n\n  await validateDiscriminators(\n    dataSources.filter((ds) => ds.kind === SolanaDatasourceKind.Runtime) as SubqlRuntimeDatasource[],\n    projectPath\n  );\n\n  for (const [name, fileRef] of allAssets) {\n    const idlPath = path.join(projectPath, fileRef.file);\n    const idl = await parseIdlFromFile(idlPath);\n\n    const output = path.join(projectPath, CODAMA_PATH, name);\n\n    await idl.accept(renderVisitor(output, {}));\n\n    const instructionNames = idl.getRoot().program.instructions.map((inst) => pascalCase(inst.name));\n\n    await renderTemplate(INSTRUCTION_TEMPLATE_TS, path.join(projectPath, IDL_PATH, `${name}.ts`), {\n      props: {\n        name,\n        instructions: instructionNames,\n      },\n    });\n\n    console.log(`* IDL ${name} generated`);\n  }\n}\n"]}

package/dist/codegen/codegen.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/codegen/codegen.spec.js

@@ -0,0 +1,130 @@
+"use strict";
+// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
+// SPDX-License-Identifier: GPL-3.0
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const types_solana_1 = require("@subql/types-solana");
+const rimraf_1 = __importDefault(require("rimraf"));
+const codegen_1 = require("./codegen");
+const outDir = node_path_1.default.join(__dirname, 'test-output');
+describe('IDL Codegen', () => {
+    afterEach(() => {
+        rimraf_1.default.sync(outDir);
+    });
+    it('can generate an interface from an IDL', async () => {
+        const ds = {
+            kind: types_solana_1.SolanaDatasourceKind.Runtime,
+            startBlock: 0,
+            assets: new Map([
+                ['jupiter', { file: '../../../../node/test/JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4.idl.json' }],
+            ]),
+            mapping: {
+                file: '',
+                handlers: [],
+            },
+        };
+        const renderTemplate = jest.fn().mockImplementation((templatePath, outputPath, templateData) => {
+            /* DO nothing*/
+        });
+        await expect((0, codegen_1.generateIDLInterfaces)([ds], outDir, renderTemplate)).resolves.not.toThrow();
+        expect(renderTemplate).toHaveBeenCalledWith(node_path_1.default.resolve(__dirname, '../../templates/idl.ts.ejs'), node_path_1.default.join(outDir, '/src/types/handler-inputs/jupiter.ts'), {
+            props: {
+                name: 'jupiter',
+                instructions: [
+                    'Claim',
+                    'ClaimToken',
+                    'CloseToken',
+                    'CreateOpenOrders',
+                    'CreateProgramOpenOrders',
+                    'CreateTokenLedger',
+                    'CreateTokenAccount',
+                    'ExactOutRoute',
+                    'Route',
+                    'RouteWithTokenLedger',
+                    'SetTokenLedger',
+                    'SharedAccountsExactOutRoute',
+                    'SharedAccountsRoute',
+                    'SharedAccountsRouteWithTokenLedger',
+                ],
+            },
+        });
+    });
+    describe('validating discriminators agains IDLs', () => {
+        it('can validate that a discriminator is part of an IDL', async () => {
+            const ds = {
+                kind: types_solana_1.SolanaDatasourceKind.Runtime,
+                startBlock: 0,
+                assets: new Map([
+                    [
+                        'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',
+                        { file: '../../../../node/test/JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4.idl.json' },
+                    ],
+                ]),
+                mapping: {
+                    file: '',
+                    handlers: [
+                        {
+                            handler: 'handleClaimToken',
+                            kind: types_solana_1.SolanaHandlerKind.Instruction,
+                            filter: {
+                                programId: 'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',
+                                discriminator: 'ClaimToken',
+                            },
+                        },
+                    ],
+                },
+            };
+            await expect((0, codegen_1.validateDiscriminators)([ds], outDir)).resolves.not.toThrow();
+        });
+        it('throws when an idl does not include the discriminator', async () => {
+            const ds = {
+                kind: types_solana_1.SolanaDatasourceKind.Runtime,
+                startBlock: 0,
+                assets: new Map([
+                    [
+                        'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',
+                        { file: '../../../../node/test/JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4.idl.json' },
+                    ],
+                ]),
+                mapping: {
+                    file: '',
+                    handlers: [
+                        {
+                            handler: 'handleClaimToken',
+                            kind: types_solana_1.SolanaHandlerKind.Instruction,
+                            filter: {
+                                programId: 'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',
+                                discriminator: 'InvalidDiscriminator',
+                            },
+                        },
+                    ],
+                },
+            };
+            await expect((0, codegen_1.validateDiscriminators)([ds], outDir)).rejects.toThrow('Datasource has a handler with a discriminator InvalidDiscriminator but no matching instruction found in IDL');
+        });
+        it('throws when there is no IDL', async () => {
+            const ds = {
+                kind: types_solana_1.SolanaDatasourceKind.Runtime,
+                startBlock: 0,
+                mapping: {
+                    file: '',
+                    handlers: [
+                        {
+                            handler: 'handleClaimToken',
+                            kind: types_solana_1.SolanaHandlerKind.Instruction,
+                            filter: {
+                                programId: 'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',
+                                discriminator: 'ClaimToken',
+                            },
+                        },
+                    ],
+                },
+            };
+            await expect((0, codegen_1.validateDiscriminators)([ds], outDir)).rejects.toThrow('Datasource has a handler with a discriminator but no IDL file reference');
+        });
+    });
+});
+//# sourceMappingURL=codegen.spec.js.map

package/dist/codegen/codegen.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.spec.js","sourceRoot":"","sources":["../../src/codegen/codegen.spec.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors\n// SPDX-License-Identifier: GPL-3.0\n\nimport path from 'node:path';\nimport {SolanaDatasourceKind, SolanaHandlerKind, SubqlRuntimeDatasource} from '@subql/types-solana';\nimport rimraf from 'rimraf';\nimport {generateIDLInterfaces, validateDiscriminators} from './codegen';\n\nconst outDir = path.join(__dirname, 'test-output');\n\ndescribe('IDL Codegen', () => {\n  afterEach(() => {\n    rimraf.sync(outDir);\n  });\n\n  it('can generate an interface from an IDL', async () => {\n    const ds: SubqlRuntimeDatasource = {\n      kind: SolanaDatasourceKind.Runtime,\n      startBlock: 0,\n      assets: new Map([\n        ['jupiter', {file: '../../../../node/test/JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4.idl.json'}],\n      ]),\n      mapping: {\n        file: '',\n        handlers: [],\n      },\n    };\n\n    const renderTemplate = jest.fn().mockImplementation((templatePath, outputPath, templateData) => {\n      /* DO nothing*/\n    });\n\n    await expect(generateIDLInterfaces([ds], outDir, renderTemplate)).resolves.not.toThrow();\n\n    expect(renderTemplate).toHaveBeenCalledWith(\n      path.resolve(__dirname, '../../templates/idl.ts.ejs'),\n      path.join(outDir, '/src/types/handler-inputs/jupiter.ts'),\n      {\n        props: {\n          name: 'jupiter',\n          instructions: [\n            'Claim',\n            'ClaimToken',\n            'CloseToken',\n            'CreateOpenOrders',\n            'CreateProgramOpenOrders',\n            'CreateTokenLedger',\n            'CreateTokenAccount',\n            'ExactOutRoute',\n            'Route',\n            'RouteWithTokenLedger',\n            'SetTokenLedger',\n            'SharedAccountsExactOutRoute',\n            'SharedAccountsRoute',\n            'SharedAccountsRouteWithTokenLedger',\n          ],\n        },\n      }\n    );\n  });\n\n  describe('validating discriminators agains IDLs', () => {\n    it('can validate that a discriminator is part of an IDL', async () => {\n      const ds: SubqlRuntimeDatasource = {\n        kind: SolanaDatasourceKind.Runtime,\n        startBlock: 0,\n        assets: new Map([\n          [\n            'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',\n            {file: '../../../../node/test/JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4.idl.json'},\n          ],\n        ]),\n        mapping: {\n          file: '',\n          handlers: [\n            {\n              handler: 'handleClaimToken',\n              kind: SolanaHandlerKind.Instruction,\n              filter: {\n                programId: 'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',\n                discriminator: 'ClaimToken',\n              },\n            },\n          ],\n        },\n      };\n\n      await expect(validateDiscriminators([ds], outDir)).resolves.not.toThrow();\n    });\n\n    it('throws when an idl does not include the discriminator', async () => {\n      const ds: SubqlRuntimeDatasource = {\n        kind: SolanaDatasourceKind.Runtime,\n        startBlock: 0,\n        assets: new Map([\n          [\n            'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',\n            {file: '../../../../node/test/JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4.idl.json'},\n          ],\n        ]),\n        mapping: {\n          file: '',\n          handlers: [\n            {\n              handler: 'handleClaimToken',\n              kind: SolanaHandlerKind.Instruction,\n              filter: {\n                programId: 'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',\n                discriminator: 'InvalidDiscriminator',\n              },\n            },\n          ],\n        },\n      };\n\n      await expect(validateDiscriminators([ds], outDir)).rejects.toThrow(\n        'Datasource has a handler with a discriminator InvalidDiscriminator but no matching instruction found in IDL'\n      );\n    });\n\n    it('throws when there is no IDL', async () => {\n      const ds: SubqlRuntimeDatasource = {\n        kind: SolanaDatasourceKind.Runtime,\n        startBlock: 0,\n        mapping: {\n          file: '',\n          handlers: [\n            {\n              handler: 'handleClaimToken',\n              kind: SolanaHandlerKind.Instruction,\n              filter: {\n                programId: 'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',\n                discriminator: 'ClaimToken',\n              },\n            },\n          ],\n        },\n      };\n\n      await expect(validateDiscriminators([ds], outDir)).rejects.toThrow(\n        'Datasource has a handler with a discriminator but no IDL file reference'\n      );\n    });\n  });\n});\n"]}

package/dist/codegen/idl.d.ts

@@ -0,0 +1,11 @@
+import { AnchorIdl, IdlV01 } from '@codama/nodes-from-anchor';
+import { BytesValueNode, InstructionNode, RootNode, Codama } from 'codama';
+export type Idl = AnchorIdl | RootNode;
+export declare function isAnchorIdl(idl: Idl): idl is AnchorIdl;
+export declare function isAnchorIdlV01(idl: Idl): idl is IdlV01;
+export declare function isRootNode(idl: Idl): idl is RootNode;
+export declare function parseIdl(idl: Idl): Codama;
+export declare function parseIdlFromFile(path: string): Promise<Codama>;
+export declare function getBytesFromBytesValueNode(node: BytesValueNode): Uint8Array;
+export declare function getInstructionDiscriminatorBytes(node: InstructionNode): Buffer;
+export declare function findInstructionDiscriminatorByName(rootNode: RootNode, name: string): Buffer | undefined;

package/dist/codegen/idl.js

@@ -0,0 +1,88 @@
+"use strict";
+// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
+// SPDX-License-Identifier: GPL-3.0
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAnchorIdl = isAnchorIdl;
+exports.isAnchorIdlV01 = isAnchorIdlV01;
+exports.isRootNode = isRootNode;
+exports.parseIdl = parseIdl;
+exports.parseIdlFromFile = parseIdlFromFile;
+exports.getBytesFromBytesValueNode = getBytesFromBytesValueNode;
+exports.getInstructionDiscriminatorBytes = getInstructionDiscriminatorBytes;
+exports.findInstructionDiscriminatorByName = findInstructionDiscriminatorByName;
+const node_fs_1 = __importDefault(require("node:fs"));
+const nodes_from_anchor_1 = require("@codama/nodes-from-anchor");
+const codecs_strings_1 = require("@solana/codecs-strings");
+const codama_1 = require("codama");
+function isAnchorIdl(idl) {
+    return !isRootNode(idl);
+}
+function isAnchorIdlV01(idl) {
+    return isAnchorIdl(idl) && idl.metadata.spec === '0.1.0';
+}
+function isRootNode(idl) {
+    return !!idl.program?.publicKey;
+}
+function parseIdl(idl) {
+    let codama = (0, codama_1.createFromRoot)((0, nodes_from_anchor_1.rootNodeFromAnchor)(idl));
+    // Check if the idl was an anchor idl
+    if (codama.getRoot().program.publicKey === '') {
+        codama = (0, codama_1.createFromRoot)(idl);
+    }
+    return codama;
+}
+async function parseIdlFromFile(path) {
+    const idlStr = await node_fs_1.default.promises.readFile(path, 'utf-8');
+    const idlJSON = JSON.parse(idlStr);
+    return parseIdl(idlJSON);
+}
+function getBytesFromBytesValueNode(node) {
+    switch (node.encoding) {
+        case 'utf8':
+            return (0, codecs_strings_1.getUtf8Encoder)().encode(node.data);
+        case 'base16':
+            return (0, codecs_strings_1.getBase16Encoder)().encode(node.data);
+        case 'base58':
+            return (0, codecs_strings_1.getBase58Encoder)().encode(node.data);
+        case 'base64':
+        default:
+            return (0, codecs_strings_1.getBase64Encoder)().encode(node.data);
+    }
+}
+function getInstructionDiscriminatorBytes(node) {
+    const discArg = node.arguments.find((arg) => arg.name === 'discriminator');
+    if (!discArg) {
+        throw new Error(`Instruction ${node.name} does not have a discriminator`);
+    }
+    // TODO what about other types of discriminators or ones that are larger than 1 byte?
+    switch (discArg.defaultValue?.kind) {
+        case 'numberValueNode':
+            return Buffer.from([discArg.defaultValue.number]);
+        case 'bytesValueNode':
+            return Buffer.from(getBytesFromBytesValueNode(discArg.defaultValue));
+        case undefined:
+            break;
+        default:
+            throw new Error(`Unable to handle unknown discriminator type ${discArg.defaultValue?.kind}`);
+    }
+    throw new Error(`Unable to find discriminator for instruction ${node.name}`);
+}
+function findInstructionDiscriminatorByName(rootNode, name) {
+    const inst = rootNode.program.instructions.find((inst) => inst.name === name || inst.name === (0, codama_1.camelCase)(name));
+    if (!inst) {
+        return undefined;
+    }
+    try {
+        return getInstructionDiscriminatorBytes(inst);
+    }
+    catch (e) {
+        // logger.debug(
+        //   `Failed to get discriminator for instruction ${inst.name}: ${e}`,
+        // );
+        return undefined;
+    }
+}
+//# sourceMappingURL=idl.js.map

package/dist/codegen/idl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idl.js","sourceRoot":"","sources":["../../src/codegen/idl.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors\n// SPDX-License-Identifier: GPL-3.0\n\nimport fs from 'node:fs';\nimport {AnchorIdl, IdlV01, rootNodeFromAnchor} from '@codama/nodes-from-anchor';\nimport {getBase16Encoder, getBase58Encoder, getBase64Encoder, getUtf8Encoder} from '@solana/codecs-strings';\nimport {BytesValueNode, InstructionNode, RootNode, Codama, createFromRoot, camelCase} from 'codama';\n\nexport type Idl = AnchorIdl | RootNode;\n\nexport function isAnchorIdl(idl: Idl): idl is AnchorIdl {\n  return !isRootNode(idl);\n}\n\nexport function isAnchorIdlV01(idl: Idl): idl is IdlV01 {\n  return isAnchorIdl(idl) && (idl.metadata as {spec?: string}).spec === '0.1.0';\n}\n\nexport function isRootNode(idl: Idl): idl is RootNode {\n  return !!(idl as RootNode).program?.publicKey;\n}\n\nexport function parseIdl(idl: Idl): Codama {\n  let codama = createFromRoot(rootNodeFromAnchor(idl as AnchorIdl));\n  // Check if the idl was an anchor idl\n  if (codama.getRoot().program.publicKey === '') {\n    codama = createFromRoot(idl as RootNode);\n  }\n\n  return codama;\n}\n\nexport async function parseIdlFromFile(path: string): Promise<Codama> {\n  const idlStr = await fs.promises.readFile(path, 'utf-8');\n  const idlJSON = JSON.parse(idlStr);\n\n  return parseIdl(idlJSON);\n}\n\nexport function getBytesFromBytesValueNode(node: BytesValueNode): Uint8Array {\n  switch (node.encoding) {\n    case 'utf8':\n      return getUtf8Encoder().encode(node.data) as Uint8Array;\n    case 'base16':\n      return getBase16Encoder().encode(node.data) as Uint8Array;\n    case 'base58':\n      return getBase58Encoder().encode(node.data) as Uint8Array;\n    case 'base64':\n    default:\n      return getBase64Encoder().encode(node.data) as Uint8Array;\n  }\n}\n\nexport function getInstructionDiscriminatorBytes(node: InstructionNode): Buffer {\n  const discArg = node.arguments.find((arg) => arg.name === 'discriminator');\n  if (!discArg) {\n    throw new Error(`Instruction ${node.name} does not have a discriminator`);\n  }\n\n  // TODO what about other types of discriminators or ones that are larger than 1 byte?\n  switch (discArg.defaultValue?.kind) {\n    case 'numberValueNode':\n      return Buffer.from([discArg.defaultValue.number]);\n    case 'bytesValueNode':\n      return Buffer.from(getBytesFromBytesValueNode(discArg.defaultValue));\n    case undefined:\n      break;\n    default:\n      throw new Error(`Unable to handle unknown discriminator type ${discArg.defaultValue?.kind}`);\n  }\n\n  throw new Error(`Unable to find discriminator for instruction ${node.name}`);\n}\n\nexport function findInstructionDiscriminatorByName(rootNode: RootNode, name: string): Buffer | undefined {\n  const inst = rootNode.program.instructions.find((inst) => inst.name === name || inst.name === camelCase(name));\n  if (!inst) {\n    return undefined;\n  }\n\n  try {\n    return getInstructionDiscriminatorBytes(inst);\n  } catch (e) {\n    // logger.debug(\n    //   `Failed to get discriminator for instruction ${inst.name}: ${e}`,\n    // );\n    return undefined;\n  }\n}\n"]}

package/dist/codegen/index.d.ts

@@ -0,0 +1,2 @@
+export * from './codegen';
+export * from './idl';

package/dist/codegen/index.js

@@ -0,0 +1,21 @@
+"use strict";
+// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
+// SPDX-License-Identifier: GPL-3.0
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./codegen"), exports);
+__exportStar(require("./idl"), exports);
+//# sourceMappingURL=index.js.map

package/dist/codegen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":";AAAA,8DAA8D;AAC9D,mCAAmC;;;;;;;;;;;;;;;;AAEnC,4CAA0B;AAC1B,wCAAsB","sourcesContent":["// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors\n// SPDX-License-Identifier: GPL-3.0\n\nexport * from './codegen';\nexport * from './idl';\n"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './codegen';
+export * from './project';

package/dist/index.js

@@ -0,0 +1,51 @@
+"use strict";
+// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
+// SPDX-License-Identifier: GPL-3.0
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./codegen"), exports);
+__exportStar(require("./project"), exports);
+const c = __importStar(require("./codegen"));
+const p = __importStar(require("./project"));
+// This provides a compiled time check to ensure that the correct exports are provided
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const _ = {
+    ...p,
+    ...c,
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,8DAA8D;AAC9D,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEnC,4CAA0B;AAC1B,4CAA0B;AAG1B,6CAA+B;AAC/B,6CAA+B;AAE/B,sFAAsF;AACtF,6DAA6D;AAC7D,MAAM,CAAC,GAAG;IACR,GAAG,CAAC;IACJ,GAAG,CAAC;CACyB,CAAC","sourcesContent":["// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors\n// SPDX-License-Identifier: GPL-3.0\n\nexport * from './codegen';\nexport * from './project';\n\nimport {SolanaNetworkModule} from '@subql/types-solana';\nimport * as c from './codegen';\nimport * as p from './project';\n\n// This provides a compiled time check to ensure that the correct exports are provided\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nconst _ = {\n  ...p,\n  ...c,\n} satisfies SolanaNetworkModule;\n"]}

package/dist/project/index.d.ts

@@ -0,0 +1,7 @@
+export * from './load';
+export * from './models';
+export * from './types';
+export * from './utils';
+export * from './versioned';
+import { parseSolanaProjectManifest } from './load';
+export { parseSolanaProjectManifest as parseProjectManifest };

package/dist/project/index.js

@@ -0,0 +1,27 @@
+"use strict";
+// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
+// SPDX-License-Identifier: GPL-3.0
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseProjectManifest = void 0;
+__exportStar(require("./load"), exports);
+__exportStar(require("./models"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./utils"), exports);
+__exportStar(require("./versioned"), exports);
+const load_1 = require("./load");
+Object.defineProperty(exports, "parseProjectManifest", { enumerable: true, get: function () { return load_1.parseSolanaProjectManifest; } });
+//# sourceMappingURL=index.js.map

package/dist/project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":";AAAA,8DAA8D;AAC9D,mCAAmC;;;;;;;;;;;;;;;;;AAEnC,yCAAuB;AACvB,2CAAyB;AACzB,0CAAwB;AACxB,0CAAwB;AACxB,8CAA4B;AAE5B,iCAAoD;AACb,qGAD9B,iCAA0B,OACwB","sourcesContent":["// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors\n// SPDX-License-Identifier: GPL-3.0\n\nexport * from './load';\nexport * from './models';\nexport * from './types';\nexport * from './utils';\nexport * from './versioned';\n\nimport { parseSolanaProjectManifest } from './load';\nexport { parseSolanaProjectManifest as parseProjectManifest };\n"]}

package/dist/project/load.d.ts

@@ -0,0 +1,2 @@
+import { SolanaProjectManifestVersioned } from './versioned';
+export declare function parseSolanaProjectManifest(raw: unknown): SolanaProjectManifestVersioned;

package/dist/project/load.js

@@ -0,0 +1,12 @@
+"use strict";
+// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
+// SPDX-License-Identifier: GPL-3.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSolanaProjectManifest = parseSolanaProjectManifest;
+const versioned_1 = require("./versioned");
+function parseSolanaProjectManifest(raw) {
+    const projectManifest = new versioned_1.SolanaProjectManifestVersioned(raw);
+    projectManifest.validate();
+    return projectManifest;
+}
+//# sourceMappingURL=load.js.map

package/dist/project/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/project/load.ts"],"names":[],"mappings":";AAAA,8DAA8D;AAC9D,mCAAmC;;AAInC,gEAIC;AAND,2CAAuF;AAEvF,SAAgB,0BAA0B,CAAC,GAAY;IACrD,MAAM,eAAe,GAAG,IAAI,0CAA8B,CAAC,GAA+B,CAAC,CAAC;IAC5F,eAAe,CAAC,QAAQ,EAAE,CAAC;IAC3B,OAAO,eAAe,CAAC;AACzB,CAAC","sourcesContent":["// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors\n// SPDX-License-Identifier: GPL-3.0\n\nimport { SolanaProjectManifestVersioned, VersionedProjectManifest } from './versioned';\n\nexport function parseSolanaProjectManifest(raw: unknown): SolanaProjectManifestVersioned {\n  const projectManifest = new SolanaProjectManifestVersioned(raw as VersionedProjectManifest);\n  projectManifest.validate();\n  return projectManifest;\n}\n"]}

package/dist/project/models.d.ts

@@ -0,0 +1,81 @@
+import { BaseDataSource, BlockFilterImpl } from '@subql/common';
+import { FileReference } from '@subql/types-core';
+import { SolanaHandlerKind, SolanaDatasourceKind, SolanaLogFilter, SubqlCustomHandler, SubqlMapping, SubqlHandler, SubqlRuntimeHandler, SubqlRuntimeDatasource, SubqlCustomDatasource, SubqlBlockHandler, SubqlTransactionHandler, SolanaTransactionFilter, SolanaBlockFilter, SolanaInstructionFilter, SubqlInstructionHandler, SubqlLogHandler, InstructionAccountFilter } from '@subql/types-solana';
+export declare class BlockFilter extends BlockFilterImpl implements SolanaBlockFilter {
+}
+export declare class TransactionFilter implements SolanaTransactionFilter {
+    signerAccountKey?: string;
+}
+export declare class InstructionFilter implements SolanaInstructionFilter {
+    programId?: string;
+    discriminator?: string;
+    accounts?: [
+        InstructionAccountFilter,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?,
+        InstructionAccountFilter?
+    ];
+    includeFalied?: boolean;
+}
+export declare class LogFilter implements SolanaLogFilter {
+    programId?: string;
+}
+export declare class BlockHandler implements SubqlBlockHandler {
+    filter?: BlockFilter;
+    kind: SolanaHandlerKind.Block;
+    handler: string;
+}
+export declare class TransactionHandler implements SubqlTransactionHandler {
+    filter?: SolanaTransactionFilter;
+    kind: SolanaHandlerKind.Transaction;
+    handler: string;
+}
+export declare class InstructionHandler implements SubqlInstructionHandler {
+    filter?: SolanaInstructionFilter;
+    kind: SolanaHandlerKind.Instruction;
+    handler: string;
+}
+export declare class LogHandler implements SubqlLogHandler {
+    filter?: SolanaLogFilter;
+    kind: SolanaHandlerKind.Log;
+    handler: string;
+}
+export declare class CustomHandler implements SubqlCustomHandler {
+    kind: string;
+    handler: string;
+    filter?: Record<string, unknown>;
+}
+export declare class SolanaMapping implements SubqlMapping {
+    handlers: SubqlHandler[];
+    file: string;
+}
+export declare class CustomMapping implements SubqlMapping<SubqlCustomHandler> {
+    handlers: CustomHandler[];
+    file: string;
+}
+export declare class RuntimeDataSourceBase<M extends SubqlMapping<SubqlRuntimeHandler>> extends BaseDataSource implements SubqlRuntimeDatasource<M> {
+    kind: SolanaDatasourceKind.Runtime;
+    mapping: M;
+    assets?: Map<string, FileReference>;
+}
+export declare class FileReferenceImpl implements FileReference {
+    file: string;
+}
+export declare class CustomDataSourceBase<K extends string, M extends SubqlMapping = SubqlMapping<SubqlCustomHandler>> extends BaseDataSource implements SubqlCustomDatasource<K, M> {
+    kind: K;
+    mapping: M;
+    assets: Map<string, FileReference>;
+    processor: FileReference;
+}