@subql/common-solana 1.0.1-0 → 1.0.1

package/CHANGELOG.md

@@ -4,8 +4,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.0.0] - null
+## [Unreleased]
+
+## [1.0.1] - 2025-07-01
+### Changed
+- Update `@subql/common` (#12)
+
+## [1.0.0] - 2025-05-29
 ### Changed
 - Initial release
 
+[Unreleased]: https://github.com/subquery/subql-solana/compare/common-solana/1.0.1...HEAD
+[1.0.1]: https://github.com/subquery/subql-solana/compare/common-solana/1.0.0...common-solana/1.0.1
 [1.0.0]: https://github.com/subquery/subql-solana/releases/tag/common-solana/1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@subql/common-solana",
-  "version": "1.0.1-0",
+  "version": "1.0.1",
   "description": "",
   "scripts": {
     "build": "rm -rf dist && tsc -b",
@@ -17,7 +17,7 @@
     "@codama/nodes-from-anchor": "^1.1.11",
     "@codama/renderers-js": "^1.2.10",
     "@subql/common": "^5.7.0",
-    "@subql/types-solana": "1.0.1-0",
+    "@subql/types-solana": "1.0.1",
     "codama": "^1.2.11",
     "js-yaml": "^4.1.0",
     "pino": "^6.13.3",
@@ -36,5 +36,17 @@
     "ejs": "3.1.10",
     "lodash": "4.17.21"
   },
-  "stableVersion": "1.0.0"
+  "files": [
+    "/dist",
+    "!/dist/**/*.spec.js",
+    "!/dist/**/*.spec.d.ts",
+    "!/dist/**/*.spec.js.map",
+    "!/dist/**/*.test.js",
+    "!/dist/**/*.test.d.ts",
+    "!/dist/**/*.test.js.map",
+    "package.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ]
 }

package/src/codegen/codegen.spec.ts

@@ -1,145 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-import path from 'node:path';
-import {SolanaDatasourceKind, SolanaHandlerKind, SubqlRuntimeDatasource} from '@subql/types-solana';
-import rimraf from 'rimraf';
-import {generateIDLInterfaces, validateDiscriminators} from './codegen';
-
-const outDir = path.join(__dirname, 'test-output');
-
-describe('IDL Codegen', () => {
-  afterEach(() => {
-    rimraf.sync(outDir);
-  });
-
-  it('can generate an interface from an IDL', async () => {
-    const ds: SubqlRuntimeDatasource = {
-      kind: 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(generateIDLInterfaces([ds], outDir, renderTemplate)).resolves.not.toThrow();
-
-    expect(renderTemplate).toHaveBeenCalledWith(
-      path.resolve(__dirname, '../../templates/idl.ts.ejs'),
-      path.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: SubqlRuntimeDatasource = {
-        kind: SolanaDatasourceKind.Runtime,
-        startBlock: 0,
-        assets: new Map([
-          [
-            'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',
-            {file: '../../../../node/test/JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4.idl.json'},
-          ],
-        ]),
-        mapping: {
-          file: '',
-          handlers: [
-            {
-              handler: 'handleClaimToken',
-              kind: SolanaHandlerKind.Instruction,
-              filter: {
-                programId: 'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',
-                discriminator: 'ClaimToken',
-              },
-            },
-          ],
-        },
-      };
-
-      await expect(validateDiscriminators([ds], outDir)).resolves.not.toThrow();
-    });
-
-    it('throws when an idl does not include the discriminator', async () => {
-      const ds: SubqlRuntimeDatasource = {
-        kind: SolanaDatasourceKind.Runtime,
-        startBlock: 0,
-        assets: new Map([
-          [
-            'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',
-            {file: '../../../../node/test/JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4.idl.json'},
-          ],
-        ]),
-        mapping: {
-          file: '',
-          handlers: [
-            {
-              handler: 'handleClaimToken',
-              kind: SolanaHandlerKind.Instruction,
-              filter: {
-                programId: 'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',
-                discriminator: 'InvalidDiscriminator',
-              },
-            },
-          ],
-        },
-      };
-
-      await expect(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: SubqlRuntimeDatasource = {
-        kind: SolanaDatasourceKind.Runtime,
-        startBlock: 0,
-        mapping: {
-          file: '',
-          handlers: [
-            {
-              handler: 'handleClaimToken',
-              kind: SolanaHandlerKind.Instruction,
-              filter: {
-                programId: 'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4',
-                discriminator: 'ClaimToken',
-              },
-            },
-          ],
-        },
-      };
-
-      await expect(validateDiscriminators([ds], outDir)).rejects.toThrow(
-        'Datasource has a handler with a discriminator but no IDL file reference'
-      );
-    });
-  });
-});

package/src/codegen/codegen.ts

@@ -1,96 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-import assert from 'node:assert';
-import path from 'node:path';
-import {renderVisitor} from '@codama/renderers-js';
-import {SolanaDatasourceKind, SolanaHandlerKind, SubqlDatasource, SubqlRuntimeDatasource} from '@subql/types-solana';
-import {pascalCase} from 'codama';
-import {Data} from 'ejs';
-import {parseIdlFromFile, findInstructionDiscriminatorByName} from './idl';
-
-const INSTRUCTION_TEMPLATE_TS = path.resolve(__dirname, '../../templates/idl.ts.ejs');
-const CODAMA_PATH = '/src/types/program-interfaces';
-const IDL_PATH = '/src/types/handler-inputs';
-
-export async function validateDiscriminators(
-  dataSources: SubqlRuntimeDatasource[],
-  projectPath: string
-): Promise<void> {
-  const issues: string[] = [];
-
-  for (const ds of dataSources) {
-    for (const handler of ds.mapping.handlers) {
-      if (!handler.filter) {
-        break;
-      }
-      switch (handler.kind) {
-        case 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 = path.join(projectPath, fileRef.file);
-            const idl = await parseIdlFromFile(idlPath);
-
-            if (!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*/
-      }
-    }
-  }
-
-  assert(issues.length === 0, issues.join('\n'));
-}
-
-export async function generateIDLInterfaces(
-  dataSources: SubqlDatasource[],
-  projectPath: string,
-  renderTemplate: (templatePath: string, outputPath: string, templateData: Data) => Promise<void>
-): Promise<void> {
-  // @subql/cli package calls this function with datasources as an array of objects
-  dataSources = dataSources.map((d) => ({
-    ...d,
-    assets: d?.assets ? (d.assets instanceof Map ? d.assets : new Map(Object.entries(d.assets))) : undefined,
-  })) as SubqlRuntimeDatasource[];
-
-  const allAssets = new Map(
-    dataSources.filter((ds) => ds.assets !== undefined).flatMap((ds) => Array.from(ds.assets!.entries()))
-  );
-
-  await validateDiscriminators(
-    dataSources.filter((ds) => ds.kind === SolanaDatasourceKind.Runtime) as SubqlRuntimeDatasource[],
-    projectPath
-  );
-
-  for (const [name, fileRef] of allAssets) {
-    const idlPath = path.join(projectPath, fileRef.file);
-    const idl = await parseIdlFromFile(idlPath);
-
-    const output = path.join(projectPath, CODAMA_PATH, name);
-
-    await idl.accept(renderVisitor(output, {}));
-
-    const instructionNames = idl.getRoot().program.instructions.map((inst) => pascalCase(inst.name));
-
-    await renderTemplate(INSTRUCTION_TEMPLATE_TS, path.join(projectPath, IDL_PATH, `${name}.ts`), {
-      props: {
-        name,
-        instructions: instructionNames,
-      },
-    });
-
-    console.log(`* IDL ${name} generated`);
-  }
-}

package/src/codegen/idl.ts

@@ -1,89 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-import fs from 'node:fs';
-import {AnchorIdl, IdlV01, rootNodeFromAnchor} from '@codama/nodes-from-anchor';
-import {getBase16Encoder, getBase58Encoder, getBase64Encoder, getUtf8Encoder} from '@solana/codecs-strings';
-import {BytesValueNode, InstructionNode, RootNode, Codama, createFromRoot, camelCase} from 'codama';
-
-export type Idl = AnchorIdl | RootNode;
-
-export function isAnchorIdl(idl: Idl): idl is AnchorIdl {
-  return !isRootNode(idl);
-}
-
-export function isAnchorIdlV01(idl: Idl): idl is IdlV01 {
-  return isAnchorIdl(idl) && (idl.metadata as {spec?: string}).spec === '0.1.0';
-}
-
-export function isRootNode(idl: Idl): idl is RootNode {
-  return !!(idl as RootNode).program?.publicKey;
-}
-
-export function parseIdl(idl: Idl): Codama {
-  let codama = createFromRoot(rootNodeFromAnchor(idl as AnchorIdl));
-  // Check if the idl was an anchor idl
-  if (codama.getRoot().program.publicKey === '') {
-    codama = createFromRoot(idl as RootNode);
-  }
-
-  return codama;
-}
-
-export async function parseIdlFromFile(path: string): Promise<Codama> {
-  const idlStr = await fs.promises.readFile(path, 'utf-8');
-  const idlJSON = JSON.parse(idlStr);
-
-  return parseIdl(idlJSON);
-}
-
-export function getBytesFromBytesValueNode(node: BytesValueNode): Uint8Array {
-  switch (node.encoding) {
-    case 'utf8':
-      return getUtf8Encoder().encode(node.data) as Uint8Array;
-    case 'base16':
-      return getBase16Encoder().encode(node.data) as Uint8Array;
-    case 'base58':
-      return getBase58Encoder().encode(node.data) as Uint8Array;
-    case 'base64':
-    default:
-      return getBase64Encoder().encode(node.data) as Uint8Array;
-  }
-}
-
-export function getInstructionDiscriminatorBytes(node: InstructionNode): Buffer {
-  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}`);
-}
-
-export function findInstructionDiscriminatorByName(rootNode: RootNode, name: string): Buffer | undefined {
-  const inst = rootNode.program.instructions.find((inst) => inst.name === name || inst.name === 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;
-  }
-}

package/src/codegen/index.ts

@@ -1,5 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-export * from './codegen';
-export * from './idl';

package/src/index.ts

@@ -1,16 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-export * from './codegen';
-export * from './project';
-
-import {SolanaNetworkModule} from '@subql/types-solana';
-import * as c from './codegen';
-import * as p from './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,
-} satisfies SolanaNetworkModule;

package/src/project/index.ts

@@ -1,11 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-export * from './load';
-export * from './models';
-export * from './types';
-export * from './utils';
-export * from './versioned';
-
-import { parseSolanaProjectManifest } from './load';
-export { parseSolanaProjectManifest as parseProjectManifest };

package/src/project/load.ts

@@ -1,10 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-import { SolanaProjectManifestVersioned, VersionedProjectManifest } from './versioned';
-
-export function parseSolanaProjectManifest(raw: unknown): SolanaProjectManifestVersioned {
-  const projectManifest = new SolanaProjectManifestVersioned(raw as VersionedProjectManifest);
-  projectManifest.validate();
-  return projectManifest;
-}

package/src/project/models.ts

@@ -1,213 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-import {BaseDataSource, BlockFilterImpl, forbidNonWhitelisted} 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';
-import {plainToClass, Transform, Type} from 'class-transformer';
-import {
-  IsArray,
-  IsEnum,
-  IsOptional,
-  IsString,
-  IsObject,
-  ValidateNested,
-  ValidateIf,
-  IsDefined,
-  IsBoolean,
-} from 'class-validator';
-
-export class BlockFilter extends BlockFilterImpl implements SolanaBlockFilter {}
-
-export class TransactionFilter implements SolanaTransactionFilter {
-  @IsOptional()
-  @IsString()
-  signerAccountKey?: string;
-}
-
-export class InstructionFilter implements SolanaInstructionFilter {
-  @ValidateIf((o) => o.discriminator !== undefined)
-  @IsDefined({message: 'programId is required if discriminator is set'})
-  @IsString()
-  programId?: string;
-
-  @IsOptional()
-  @IsString()
-  discriminator?: string;
-
-  @IsOptional()
-  @IsArray()
-  accounts?: [
-    InstructionAccountFilter,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?,
-    InstructionAccountFilter?
-  ];
-
-  @IsOptional()
-  @IsBoolean()
-  includeFalied?: boolean;
-}
-
-export class LogFilter implements SolanaLogFilter {
-  @IsOptional()
-  @IsString()
-  programId?: string;
-}
-
-export class BlockHandler implements SubqlBlockHandler {
-  @IsObject()
-  @IsOptional()
-  @Type(() => BlockFilter)
-  filter?: BlockFilter;
-  @IsEnum(SolanaHandlerKind, {groups: [SolanaHandlerKind.Block]})
-  kind!: SolanaHandlerKind.Block;
-  @IsString()
-  handler!: string;
-}
-
-export class TransactionHandler implements SubqlTransactionHandler {
-  @IsOptional()
-  @ValidateNested()
-  @Type(() => TransactionFilter)
-  filter?: SolanaTransactionFilter;
-  @IsEnum(SolanaHandlerKind, {groups: [SolanaHandlerKind.Transaction]})
-  kind!: SolanaHandlerKind.Transaction;
-  @IsString()
-  handler!: string;
-}
-
-export class InstructionHandler implements SubqlInstructionHandler {
-  @IsOptional()
-  @ValidateNested()
-  @Type(() => InstructionFilter)
-  filter?: SolanaInstructionFilter;
-  @IsEnum(SolanaHandlerKind, {groups: [SolanaHandlerKind.Instruction]})
-  kind!: SolanaHandlerKind.Instruction;
-  @IsString()
-  handler!: string;
-}
-
-export class LogHandler implements SubqlLogHandler {
-  @IsOptional()
-  @ValidateNested()
-  @Type(() => LogFilter)
-  filter?: SolanaLogFilter;
-  @IsEnum(SolanaHandlerKind, {groups: [SolanaHandlerKind.Log]})
-  kind!: SolanaHandlerKind.Log;
-  @IsString()
-  handler!: string;
-}
-
-export class CustomHandler implements SubqlCustomHandler {
-  @IsString()
-  kind!: string;
-  @IsString()
-  handler!: string;
-  @IsObject()
-  @IsOptional()
-  filter?: Record<string, unknown>;
-}
-
-export class SolanaMapping implements SubqlMapping {
-  @Transform((params) => {
-    const handlers: SubqlHandler[] = params.value;
-    return handlers.map((handler) => {
-      switch (handler.kind) {
-        case SolanaHandlerKind.Log:
-          return plainToClass(LogHandler, handler);
-        case SolanaHandlerKind.Instruction:
-          return plainToClass(InstructionHandler, handler);
-        case SolanaHandlerKind.Transaction:
-          return plainToClass(TransactionHandler, handler);
-        case SolanaHandlerKind.Block:
-          return plainToClass(BlockHandler, handler);
-        default:
-          throw new Error(`handler ${(handler as any).kind} not supported`);
-      }
-    });
-  })
-  @IsArray()
-  @ValidateNested()
-  handlers!: SubqlHandler[];
-  @IsString()
-  file!: string;
-}
-
-export class CustomMapping implements SubqlMapping<SubqlCustomHandler> {
-  @IsArray()
-  @Type(() => CustomHandler)
-  @ValidateNested()
-  handlers!: CustomHandler[];
-  @IsString()
-  file!: string;
-}
-
-export class RuntimeDataSourceBase<M extends SubqlMapping<SubqlRuntimeHandler>>
-  extends BaseDataSource
-  implements SubqlRuntimeDatasource<M>
-{
-  @IsEnum(SolanaDatasourceKind, {
-    groups: [SolanaDatasourceKind.Runtime],
-  })
-  kind!: SolanaDatasourceKind.Runtime;
-  @Type(() => SolanaMapping)
-  @ValidateNested()
-  mapping!: M;
-  @Type(() => FileReferenceImpl)
-  @ValidateNested({each: true})
-  @IsOptional()
-  assets?: Map<string, FileReference>;
-}
-
-export class FileReferenceImpl implements FileReference {
-  @IsString()
-  file!: string;
-}
-
-export class CustomDataSourceBase<K extends string, M extends SubqlMapping = SubqlMapping<SubqlCustomHandler>>
-  extends BaseDataSource
-  implements SubqlCustomDatasource<K, M>
-{
-  @IsString()
-  kind!: K;
-  @Type(() => CustomMapping)
-  @ValidateNested()
-  mapping!: M;
-  @Type(() => FileReferenceImpl)
-  @ValidateNested({each: true})
-  assets!: Map<string, FileReference>;
-  @Type(() => FileReferenceImpl)
-  @IsObject()
-  processor!: FileReference;
-}

package/src/project/project.spec.ts

@@ -1,123 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-import fs from 'fs';
-import path from 'path';
-import {loadFromJsonOrYaml, RunnerQueryBaseModel} from '@subql/common';
-import {validateSync} from 'class-validator';
-import {DeploymentV1_0_0, SolanaRunnerNodeImpl, SolanaRunnerSpecsImpl} from '../project/versioned/v1_0_0';
-import {SolanaProjectManifestVersioned, VersionedProjectManifest} from './versioned';
-
-const projectsDir = path.join(__dirname, '../../test');
-
-function loadSolanaProjectManifest(file: string): SolanaProjectManifestVersioned {
-  let manifestPath = file;
-  if (fs.existsSync(file) && fs.lstatSync(file).isDirectory()) {
-    const yamlFilePath = path.join(file, 'project.yaml');
-    const jsonFilePath = path.join(file, 'project.json');
-    if (fs.existsSync(yamlFilePath)) {
-      manifestPath = yamlFilePath;
-    } else if (fs.existsSync(jsonFilePath)) {
-      manifestPath = jsonFilePath;
-    } else {
-      throw new Error(`Could not find project manifest under dir ${file}`);
-    }
-  }
-
-  const doc = loadFromJsonOrYaml(manifestPath);
-  const projectManifest = new SolanaProjectManifestVersioned(doc as VersionedProjectManifest);
-  projectManifest.validate();
-  return projectManifest;
-}
-
-describe('test solana project.yaml', () => {
-  it('could get solana project template name from its deployment', () => {
-    const manifest = loadSolanaProjectManifest(path.join(projectsDir, 'project_1.0.0.yaml'));
-    const deployment = manifest.toDeployment();
-    expect(deployment).toContain('name: Pool');
-  });
-
-  it('could get options in template from its deployment', () => {
-    const manifest = loadSolanaProjectManifest(path.join(projectsDir, 'project_1.0.0.yaml'));
-    const deployment = manifest.toDeployment();
-    expect(deployment).toContain('abi: Pool');
-  });
-});
-
-describe('project.yaml', () => {
-  it('can validate project.yaml', () => {
-    // TODO this should catch a specific error, the file doesn't currently exist
-    throw new Error('Not implemented');
-    expect(() => loadSolanaProjectManifest(path.join(projectsDir, 'project_falsy.yaml'))).toThrow();
-    expect(() => loadSolanaProjectManifest(path.join(projectsDir, 'project_falsy_array.yaml'))).toThrow();
-  });
-
-  it('can fail validation if version not supported', () => {
-    // TODO this should catch a specific error, the file doesn't currently exist
-    throw new Error('Not implemented');
-    expect(() => loadSolanaProjectManifest(path.join(projectsDir, 'project_invalid_version.yaml'))).toThrow('');
-  });
-
-  it('can validate a v1.0.0 project.yaml with templates', () => {
-    expect(() => loadSolanaProjectManifest(path.join(projectsDir, 'project_1.0.0.yaml'))).not.toThrow();
-  });
-
-  it('get v1.0.0 deployment mapping filter', () => {
-    const manifestVersioned = loadSolanaProjectManifest(path.join(projectsDir, 'project_1.0.0.yaml'));
-
-    const deployment = manifestVersioned.asV1_0_0.deployment;
-    const filter = deployment.dataSources[0].mapping.handlers[0].filter;
-    const deploymentString = manifestVersioned.toDeployment();
-    expect(filter).not.toBeNull();
-    expect(deploymentString).toContain('Transfer (address from, address to, uint256 tokenId)');
-  });
-
-  it('can convert genesis hash in v1.0.0 to chainId in deployment', () => {
-    const deployment = loadSolanaProjectManifest(path.join(projectsDir, 'project_1.0.0.yaml')).asV1_0_0.deployment;
-    expect(deployment.network.chainId).not.toBeNull();
-    console.log(deployment.network.chainId);
-  });
-
-  it.skip('can get chainId for deployment', () => {
-    const deployment = loadSolanaProjectManifest(path.join(projectsDir, 'project_1.0.0_chainId.yaml')).asV1_0_0
-      .deployment;
-    expect(deployment.network.chainId).toBe('moonbeamChainId');
-  });
-
-  it('can validate deployment runner versions', () => {
-    const deployment = new DeploymentV1_0_0();
-    const nodeImp = new SolanaRunnerNodeImpl();
-    const queryImp = new RunnerQueryBaseModel();
-    deployment.specVersion = '1.0.0';
-    deployment.runner = new SolanaRunnerSpecsImpl();
-
-    nodeImp.name = '@subql/node-solana';
-    nodeImp.version = '*';
-    deployment.runner.node = nodeImp;
-
-    queryImp.name = '@subql/query';
-    queryImp.version = '0.213.1';
-
-    deployment.runner.query = queryImp;
-
-    const errors = validateSync(deployment.runner, {whitelist: true, forbidNonWhitelisted: true});
-    expect(errors.length).toBe(0);
-  });
-
-  it('can validate a v1.0.0 project.yaml with unsupported runner node', () => {
-    expect(() => loadSolanaProjectManifest(path.join(projectsDir, 'project_1.0.0_bad_runner.yaml'))).toThrow();
-  });
-
-  //TODO, pre-release should be excluded
-  it.skip('can throw error with unsupported runner version', () => {
-    expect(() => loadSolanaProjectManifest(path.join(projectsDir, 'project_1.0.0_bad_runner_version.yaml'))).toThrow();
-  });
-
-  it('can validate a v1.0.0 project.yaml runner and datasource mismatches', () => {
-    expect(() => loadSolanaProjectManifest(path.join(projectsDir, 'project_1.0.0_runner_ds_mismatch.yaml'))).toThrow();
-  });
-
-  it('can fail validation if custom ds missing processor', () => {
-    expect(() => loadSolanaProjectManifest(path.join(projectsDir, 'project_0.2.0_invalid_custom_ds.yaml'))).toThrow();
-  });
-});

package/src/project/types.ts

@@ -1,19 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-import { IProjectManifest } from '@subql/types-core';
-import { SubqlDatasource } from '@subql/types-solana';
-
-// All of these used to be redefined in this file, re-exporting for simplicity
-export {
-  SubqlRuntimeHandler,
-  SubqlCustomHandler,
-  SubqlHandler,
-  SubqlDatasource as SubqlSolanaDataSource,
-  SubqlCustomDatasource as SubqlSolanaCustomDataSource,
-  SubqlDatasourceProcessor,
-  SubqlHandlerFilter,
-} from '@subql/types-solana';
-
-export type ISolanaProjectManifest = IProjectManifest<SubqlDatasource>;
-

package/src/project/utils.ts

@@ -1,50 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-import {
-  SecondLayerHandlerProcessor,
-  SubqlCustomDatasource,
-  SubqlDatasource,
-  SolanaDatasourceKind,
-  SolanaHandlerKind,
-  SubqlRuntimeDatasource,
-  SecondLayerHandlerProcessorArray,
-  SubqlCustomHandler,
-  SubqlMapping,
-} from '@subql/types-solana';
-
-type DefaultFilter = Record<string, unknown>;
-
-export function isBlockHandlerProcessor<E>(
-  hp: SecondLayerHandlerProcessorArray<SolanaHandlerKind, DefaultFilter, unknown>
-): hp is SecondLayerHandlerProcessor<SolanaHandlerKind.Block, DefaultFilter, E> {
-  return hp.baseHandlerKind === SolanaHandlerKind.Block;
-}
-
-export function isTransactionHandlerProcessor<E>(
-  hp: SecondLayerHandlerProcessorArray<SolanaHandlerKind, DefaultFilter, unknown>
-): hp is SecondLayerHandlerProcessor<SolanaHandlerKind.Transaction, DefaultFilter, E> {
-  return hp.baseHandlerKind === SolanaHandlerKind.Transaction;
-}
-
-export function isInstructionHandlerProcessor<E>(
-  hp: SecondLayerHandlerProcessorArray<SolanaHandlerKind, DefaultFilter, unknown>
-): hp is SecondLayerHandlerProcessor<SolanaHandlerKind.Instruction, DefaultFilter, E> {
-  return hp.baseHandlerKind === SolanaHandlerKind.Instruction;
-}
-
-export function isLogHandlerProcessor<E>(
-  hp: SecondLayerHandlerProcessorArray<SolanaHandlerKind, DefaultFilter, unknown>
-): hp is SecondLayerHandlerProcessor<SolanaHandlerKind.Log, DefaultFilter, E> {
-  return hp.baseHandlerKind === SolanaHandlerKind.Log;
-}
-
-export function isCustomDs<F extends SubqlMapping<SubqlCustomHandler>>(
-  ds: SubqlDatasource
-): ds is SubqlCustomDatasource<string, F> {
-  return ds.kind !== SolanaDatasourceKind.Runtime && !!(ds as SubqlCustomDatasource<string>).processor;
-}
-
-export function isRuntimeDs(ds: SubqlDatasource): ds is SubqlRuntimeDatasource {
-  return ds.kind === SolanaDatasourceKind.Runtime;
-}

package/src/project/versioned/ProjectManifestVersioned.ts

@@ -1,71 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-import { plainToClass } from 'class-transformer';
-import { ISolanaProjectManifest, SubqlSolanaDataSource } from '../types';
-import { ProjectManifestV1_0_0Impl } from './v1_0_0';
-export type VersionedProjectManifest = { specVersion: string };
-
-const SOLANA_SUPPORTED_VERSIONS = {
-  '1.0.0': ProjectManifestV1_0_0Impl,
-};
-
-type Versions = keyof typeof SOLANA_SUPPORTED_VERSIONS;
-
-type ProjectManifestImpls = InstanceType<(typeof SOLANA_SUPPORTED_VERSIONS)[Versions]>;
-
-export function manifestIsV1_0_0(manifest: ISolanaProjectManifest): manifest is ProjectManifestV1_0_0Impl {
-  return manifest.specVersion === '1.0.0';
-}
-
-export class SolanaProjectManifestVersioned implements ISolanaProjectManifest {
-  private _impl: ProjectManifestImpls;
-
-  constructor(projectManifest: VersionedProjectManifest) {
-    const klass = SOLANA_SUPPORTED_VERSIONS[projectManifest.specVersion as Versions];
-    if (!klass) {
-      throw new Error('specVersion not supported for project manifest file');
-    }
-    this._impl = plainToClass<ProjectManifestImpls, VersionedProjectManifest>(klass, projectManifest);
-  }
-
-  get asImpl(): ProjectManifestImpls {
-    return this._impl;
-  }
-
-  get isV1_0_0(): boolean {
-    return this.specVersion === '1.0.0';
-  }
-
-  get asV1_0_0(): ProjectManifestV1_0_0Impl {
-    return this._impl as ProjectManifestV1_0_0Impl;
-  }
-
-  toDeployment(): string {
-    return this._impl.deployment.toYaml();
-  }
-
-  validate(): void {
-    return this._impl.validate();
-  }
-
-  get dataSources(): SubqlSolanaDataSource[] {
-    return this._impl.dataSources;
-  }
-
-  get schema(): string {
-    return this._impl.schema.file;
-  }
-
-  get specVersion(): string {
-    return this._impl.specVersion;
-  }
-
-  get description(): string | undefined {
-    return this._impl.description;
-  }
-
-  get repository(): string | undefined {
-    return this._impl.repository;
-  }
-}

package/src/project/versioned/index.ts

@@ -1,5 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-export * from './ProjectManifestVersioned';
-export * from './v1_0_0';

package/src/project/versioned/v1_0_0/index.ts

@@ -1,4 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-export * from './model';

package/src/project/versioned/v1_0_0/model.ts

@@ -1,200 +0,0 @@
-// Copyright 2020-2025 SubQuery Pte Ltd authors & contributors
-// SPDX-License-Identifier: GPL-3.0
-
-import {
-  BaseDeploymentV1_0_0,
-  CommonEndpointConfig,
-  CommonProjectNetworkV1_0_0,
-  FileType,
-  IsNetworkEndpoint,
-  ParentProjectModel,
-  ProjectManifestBaseImpl,
-  RunnerNodeImpl,
-  RunnerQueryBaseModel,
-} from '@subql/common';
-import { BaseMapping, NodeSpec, RunnerSpecs, QuerySpec, ParentProject } from '@subql/types-core';
-import {
-  CustomDatasourceTemplate,
-  SolanaProjectManifestV1_0_0,
-  ISolanaEndpointConfig,
-  RuntimeDatasourceTemplate,
-  SubqlCustomDatasource,
-  SubqlMapping,
-  SubqlRuntimeDatasource,
-} from '@subql/types-solana';
-import { plainToInstance, Transform, TransformFnParams, Type } from 'class-transformer';
-import {
-  Equals,
-  IsArray,
-  IsIn,
-  IsNotEmpty,
-  IsObject,
-  IsOptional,
-  IsPositive,
-  IsString,
-  ValidateNested,
-  validateSync,
-} from 'class-validator';
-import { CustomDataSourceBase, RuntimeDataSourceBase } from '../../models';
-import { SubqlSolanaDataSource, SubqlRuntimeHandler } from '../../types';
-
-const SOLANA_NODE_NAME = `@subql/node-solana`;
-
-export class SolanaRunnerNodeImpl extends RunnerNodeImpl {
-  @IsIn([SOLANA_NODE_NAME], {
-    message: `Runner Solana node name is incorrect, supposed to be '${SOLANA_NODE_NAME}'`,
-  })
-  name: string = SOLANA_NODE_NAME;
-}
-
-function validateObject(object: any, errorMessage = 'failed to validate object.'): void {
-  const errors = validateSync(object, { whitelist: true, forbidNonWhitelisted: true });
-  if (errors?.length) {
-    const errorMsgs = errors.map((e) => e.toString()).join('\n');
-    throw new Error(`${errorMessage}\n${errorMsgs}`);
-  }
-}
-
-export class SolanaRuntimeDataSourceImpl
-  extends RuntimeDataSourceBase<SubqlMapping<SubqlRuntimeHandler>>
-  implements SubqlRuntimeDatasource {
-  validate(): void {
-    return validateObject(this, 'failed to validate runtime datasource.');
-  }
-}
-
-export class SolanaCustomDataSourceImpl<K extends string = string, M extends BaseMapping<any> = BaseMapping<any>>
-  extends CustomDataSourceBase<K, M>
-  implements SubqlCustomDatasource<K, M> {
-  validate(): void {
-    return validateObject(this, 'failed to validate custom datasource.');
-  }
-}
-
-export class RuntimeDatasourceTemplateImpl extends SolanaRuntimeDataSourceImpl implements RuntimeDatasourceTemplate {
-  @IsString()
-  name!: string;
-}
-
-export class CustomDatasourceTemplateImpl extends SolanaCustomDataSourceImpl implements CustomDatasourceTemplate {
-  @IsString()
-  name!: string;
-}
-
-export class SolanaRunnerSpecsImpl implements RunnerSpecs {
-  @IsObject()
-  @ValidateNested()
-  @Type(() => SolanaRunnerNodeImpl)
-  node!: NodeSpec;
-  @IsObject()
-  @ValidateNested()
-  @Type(() => RunnerQueryBaseModel)
-  query!: QuerySpec;
-}
-
-export class ProjectNetworkDeploymentV1_0_0 {
-  @IsNotEmpty()
-  @Transform(({ value }: TransformFnParams) => value.trim())
-  @IsString()
-  chainId!: string;
-  @IsOptional()
-  @IsArray()
-  bypassBlocks?: (number | `${number}-${number}`)[];
-}
-
-export class SolanaEndpointConfig extends CommonEndpointConfig implements ISolanaEndpointConfig {
-  @IsOptional()
-  @IsPositive()
-  batchSize?: number;
-}
-
-export class ProjectNetworkV1_0_0 extends CommonProjectNetworkV1_0_0<void> {
-  @IsOptional()
-  @IsNetworkEndpoint(SolanaEndpointConfig)
-  endpoint: string | string[] | Record<string, CommonEndpointConfig> = {};
-}
-
-export class DeploymentV1_0_0 extends BaseDeploymentV1_0_0 {
-  @Transform((params) => {
-    if (params.value.genesisHash && !params.value.chainId) {
-      params.value.chainId = params.value.genesisHash;
-    }
-    return plainToInstance(ProjectNetworkDeploymentV1_0_0, params.value);
-  })
-  @ValidateNested()
-  @Type(() => ProjectNetworkDeploymentV1_0_0)
-  network!: ProjectNetworkDeploymentV1_0_0;
-  @IsObject()
-  @ValidateNested()
-  @Type(() => SolanaRunnerSpecsImpl)
-  runner!: RunnerSpecs;
-  @IsArray()
-  @ValidateNested()
-  @Type(() => SolanaCustomDataSourceImpl, {
-    discriminator: {
-      property: 'kind',
-      subTypes: [{ value: SolanaRuntimeDataSourceImpl, name: 'solana/Runtime' }],
-    },
-    keepDiscriminatorProperty: true,
-  })
-  dataSources!: (SubqlRuntimeDatasource | SubqlCustomDatasource)[];
-  @IsOptional()
-  @IsArray()
-  @ValidateNested()
-  @Type(() => CustomDatasourceTemplateImpl, {
-    discriminator: {
-      property: 'kind',
-      subTypes: [{ value: RuntimeDatasourceTemplateImpl, name: 'solana/Runtime' }],
-    },
-    keepDiscriminatorProperty: true,
-  })
-  templates?: (RuntimeDatasourceTemplate | CustomDatasourceTemplate)[];
-}
-
-export class ProjectManifestV1_0_0Impl
-  extends ProjectManifestBaseImpl<DeploymentV1_0_0>
-  implements SolanaProjectManifestV1_0_0 {
-  constructor() {
-    super(DeploymentV1_0_0);
-  }
-
-  @Equals('1.0.0')
-  specVersion = '1.0.0';
-  @Type(() => SolanaCustomDataSourceImpl, {
-    discriminator: {
-      property: 'kind',
-      subTypes: [{ value: SolanaRuntimeDataSourceImpl, name: 'solana/Runtime' }],
-    },
-    keepDiscriminatorProperty: true,
-  })
-  dataSources!: SubqlSolanaDataSource[];
-  @Type(() => ProjectNetworkV1_0_0)
-  network!: ProjectNetworkV1_0_0;
-  @IsString()
-  name!: string;
-  @IsString()
-  version!: string;
-  @ValidateNested()
-  @Type(() => FileType)
-  schema!: FileType;
-  @IsOptional()
-  @IsArray()
-  @ValidateNested()
-  @Type(() => CustomDatasourceTemplateImpl, {
-    discriminator: {
-      property: 'kind',
-      subTypes: [{ value: RuntimeDatasourceTemplateImpl, name: 'solana/Runtime' }],
-    },
-    keepDiscriminatorProperty: true,
-  })
-  templates?: (RuntimeDatasourceTemplate | CustomDatasourceTemplate)[];
-  @IsObject()
-  @ValidateNested()
-  @Type(() => SolanaRunnerSpecsImpl)
-  runner!: RunnerSpecs;
-
-  @IsOptional()
-  @IsObject()
-  @Type(() => ParentProjectModel)
-  parent?: ParentProject;
-}

package/templates/idl.ts.ejs

@@ -1,10 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-
-// Auto-generated , DO NOT EDIT
-import { SolanaInstruction, SolanaLogMessage } from '@subql/types-solana';
-
-import {<% props.instructions.forEach(function(inst){ %><%= inst %>InstructionDataArgs, <% }); %>} from '../program-interfaces/<%=props.name%>/instructions';
-
-<% props.instructions.forEach(function(inst){ %>
-export type <%=inst %>Instruction = SolanaInstruction<<%=inst%>InstructionDataArgs>;
-<% }); %>

package/test/abiTest/project.yaml

@@ -1,51 +0,0 @@
-specVersion: '1.0.0'
-name: 'example'
-
-version: '0.0.1'
-runner:
-  node:
-    name: '@subql/node-ethereum'
-    version: '*'
-  query:
-    name: '@subql/query'
-    version: '*'
-description: ''
-repository: ''
-schema:
-  file: './schema.graphql'
-network:
-  chainId: '1'
-  endpoint: 'aaa'
-  dictionary: ''
-
-customDs:
-  assets:
-    abi:
-      file: ./erc20.json
-    artifact:
-      file: ./abis/Erc20.sol/erc20.json
-dataSources:
-  - kind: ethereum/Runtime
-    options:
-      abi: Erc20
-    assets:
-      Erc20:
-        file: './abis/erc20.json'
-    startBlock: 1
-    mapping:
-      file: ''
-      handlers:
-        - handler: handleTransaction
-          kind: ethereum/BlockHandler
-  - kind: ethereum/Runtime
-    options:
-      abi: 'artifactErc20'
-    assets:
-      'artifactErc20':
-        file: './abis/Erc20.sol/Erc20.json'
-    startBlock: 1
-    mapping:
-      file: ''
-      handlers:
-        - handler: handleTransaction
-          kind: ethereum/BlockHandler

package/test/project_1.0.0.yaml

@@ -1,91 +0,0 @@
-specVersion: '1.0.0'
-
-name: 'test'
-version: '0.0.1'
-runner:
-  node:
-    name: '@subql/node-solana'
-    version: '*'
-  query:
-    name: '@subql/query'
-    version: '*'
-description: 'This project can be use as a starting point for developing your new Solana SubQuery project'
-repository: 'https://github.com/subquery/solana-subql-starter'
-
-schema:
-  file: './schema.graphql'
-
-network:
-  #  endpoint: "fill it in"
-  chainId: '1'
-  dictionary: 'https://eth-dict.api.onfinality.io/'
-  endpoint: 'wss://eth.api.onfinality.io/ws?apikey='
-
-dataSources:
-  - kind: solana/Runtime
-    startBlock: 12369621
-    mapping:
-      file: './dist/index.js'
-      handlers:
-        - handler: handlePoolCreated
-          kind: solana/LogHandler
-          filter:
-            topics:
-              - PoolCreated(address indexed token0, address indexed token1, uint24 indexed fee, int24 tickSpacing, address pool)
-    # solana/contract
-  - kind: solana/Runtime
-    startBlock: 12369651
-    mapping:
-      file: './dist/index.js'
-      handlers:
-        - handler: handleIncreaseLiquidity
-          kind: solana/LogHandler
-          filter:
-            topics:
-              - IncreaseLiquidity (uint256 tokenId, uint128 liquidity, uint256 amount0, uint256 amount1)
-        - handler: handleDecreaseLiquidity
-          kind: solana/LogHandler
-          filter:
-            topics:
-              - DecreaseLiquidity (uint256 tokenId, uint128 liquidity, uint256 amount0, uint256 amount1)
-        - handler: handleCollect
-          kind: solana/LogHandler
-          filter:
-            topics:
-              - Collect (uint256 tokenId, address recipient, uint256 amount0, uint256 amount1)
-        - handler: handleTransfer
-          kind: solana/LogHandler
-          filter:
-            topics:
-              - Transfer (address from, address to, uint256 tokenId)
-templates:
-  - name: Pool
-    kind: solana/Runtime
-    mapping:
-      file: './dist/index.js'
-      handlers:
-        - handler: handleInitialize
-          kind: solana/LogHandler
-          filter:
-            topics:
-              - Initialize (uint160,int24)
-        - handler: handleSwap
-          kind: solana/LogHandler
-          filter:
-            topics:
-              - Swap (address sender, address recipient, int256 amount0, int256 amount1, uint160 sqrtPriceX96, uint128 liquidity, int24 tick)
-        - handler: handleMint
-          kind: solana/LogHandler
-          filter:
-            topics:
-              - Mint(address sender, address owner, int24 tickLower, int24 tickUpper, uint128 amount, uint256 amount0, uint256 amount1)
-        - handler: handleBurn
-          kind: solana/LogHandler
-          filter:
-            topics:
-              - Burn(indexed address,indexed int24,indexed int24,uint128,uint256,uint256)
-        - handler: handleFlash
-          kind: solana/LogHandler
-          filter:
-            topics:
-              - Flash(indexed address,indexed address,uint256,uint256,uint256,uint256)

package/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "rootDir": "src",
-    "tsBuildInfoFile": "dist/.tsbuildinfo",
-    "outDir": "dist",
-    "noImplicitAny": true,
-    "strict": true
-  },
-  "references": [{"path": "../types"}],
-  "include": ["src/**/*"]
-}