Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: verification endpoint alignment with etherscan #367

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions packages/api/src/api/contract/contract.controller.spec.ts
Original file line number Diff line number Diff line change
Expand Up @@ -278,7 +278,7 @@ describe("ContractController", () => {
contractname: "contracts/HelloWorld.sol:HelloWorld",
compilerversion: "0.8.17",
optimizationUsed: "1",
zkCompilerVersion: "v1.3.14",
zksolcVersion: "v1.3.14",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this mean that the change is breaking? If so, can we make it backward-compatible (e.g. add support for property alias)?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, this change is breaking. TBH I would better leave zkCompilerVersion for consistency and ask etherscan to rename on their side, because for solc it's not solcVersion, it's compilerversion. If we still decide to go with zksolcVersion then we should support both zksolcVersion and zkCompilerVersion to avoid breaking changes.

constructorArguements: "0x94869207468657265210000000000000000000000000000000000000000000000",
runs: 700,
libraryname1: "contracts/MiniMath.sol:MiniMath",
Expand Down Expand Up @@ -426,7 +426,7 @@ describe("ContractController", () => {
contractname: "contracts/Greeter.vy:Greeter",
compilerversion: "0.3.3",
optimizationUsed: "1",
zkCompilerVersion: "v1.3.11",
zksolcVersion: "v1.3.11",
} as unknown as VerifyContractRequestDto;

pipeMock.mockReturnValue(
Expand All @@ -442,7 +442,7 @@ describe("ContractController", () => {
codeFormat: "vyper-multi-file",
compilerVyperVersion: "0.3.3",
compilerZkvyperVersion: "v1.3.11",
constructorArguments: undefined,
constructorArguments: "0x",
contractAddress: "0x14174c76E073f8efEf5C1FE0dd0f8c2Ca9F21e62",
contractName: "contracts/Greeter.vy:Greeter",
optimizationUsed: true,
Expand Down
31 changes: 26 additions & 5 deletions packages/api/src/api/contract/contract.controller.ts
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,6 @@ import {
ContractVerificationStatusResponse,
} from "../types";
import { VerifyContractResponseDto } from "../dtos/contract/verifyContractResponse.dto";

const entityName = "contract";

export const parseAddressListPipeExceptionFactory = () => new BadRequestException("Missing contract addresses");
Expand Down Expand Up @@ -136,6 +135,12 @@ export class ContractController {
ContractVerificationCodeFormatEnum.solidityJsonInput,
].includes(request.codeformat);

// eslint-disable-next-line @typescript-eslint/no-var-requires
const semver = require("semver");
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why not import it?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Import doesn't work because the semver package only functions with CommonJS modules. I found a workaround using require to properly use the object.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did you try to add types?

if (semver.gte(request.zksolcVersion, "1.3.23")) {
request.compilerversion = `zkVM-${request.compilerversion}-1.0.1`;
}

if (isSolidityContract && request.sourceCode instanceof Object) {
const libraries: { [key: string]: Record<string, string> } = {};
for (let i = 1; i <= 10; i++) {
Expand Down Expand Up @@ -166,21 +171,37 @@ export class ContractController {
}
}

let formatedStringSourceCode = undefined;
if (isSolidityContract && typeof request.sourceCode === "string") {
try {
formatedStringSourceCode = JSON.parse(request.sourceCode);
if (formatedStringSourceCode.settings.optimizer?.enabled) {
request.optimizationUsed = "1";
}
} catch (e) {
formatedStringSourceCode = request.sourceCode;
}
}

const { data } = await firstValueFrom<{ data: number }>(
this.httpService
.post(`${this.contractVerificationApiUrl}/contract_verification`, {
codeFormat: request.codeformat,
contractAddress,
contractName: request.contractname,
optimizationUsed: request.optimizationUsed === "1",
sourceCode: request.sourceCode,
constructorArguments: request.constructorArguements,
sourceCode: typeof request.sourceCode === "string" ? formatedStringSourceCode : request.sourceCode,
constructorArguments: request.constructorArguements
? request.constructorArguements.slice(0, 2) !== "0x"
? `0x${request.constructorArguements}`
: request.constructorArguements
: "0x",
...(isSolidityContract && {
compilerZksolcVersion: request.zkCompilerVersion,
compilerZksolcVersion: request.zksolcVersion,
compilerSolcVersion: request.compilerversion,
}),
...(!isSolidityContract && {
compilerZkvyperVersion: request.zkCompilerVersion,
compilerZkvyperVersion: request.zksolcVersion,
compilerVyperVersion: request.compilerversion,
}),
})
Expand Down
14 changes: 8 additions & 6 deletions packages/api/src/api/dtos/contract/verifyContractRequest.dto.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@ import { IsInt, IsOptional, Max, Min, IsEnum, IsString, IsNotEmpty, Matches } fr
import { ApiProperty } from "@nestjs/swagger";
import { Type } from "class-transformer";
import { ContractVerificationCodeFormatEnum } from "../../types";
import { FormatAndValidateCompilerVersion } from "../../../common/decorators/formatAndValidateCompilerVersion";

const fullLibraryNameRegexp = new RegExp("^(.)+:(.)+$");

Expand Down Expand Up @@ -86,17 +87,18 @@ export class VerifyContractRequestDto {
})
@IsString()
@IsNotEmpty({ message: "Missing Or invalid compilerversion." })
@FormatAndValidateCompilerVersion({ message: "Invalid compilerversion format." })
public compilerversion: string;

@ApiProperty({
name: "zkCompilerVersion",
name: "zksolcVersion",
description: "Zk compiler version",
example: "v1.3.14",
required: true,
})
@IsString()
@IsNotEmpty({ message: "Missing zkCompilerVersion" })
public zkCompilerVersion: string;
@IsNotEmpty({ message: "Missing zksolcVersion" })
public zksolcVersion: string;

@ApiProperty({
name: "runs",
Expand All @@ -115,19 +117,19 @@ export class VerifyContractRequestDto {
name: "optimizationUsed",
description: "0 = No Optimization, 1 = Optimization used",
example: "1",
required: true,
required: false,
})
@IsEnum(["0", "1"], {
message: "Invalid optimizationUsed",
})
@IsNotEmpty({ message: "Missing optimizationUsed" })
@IsOptional()
public optimizationUsed: string;

@ApiProperty({
name: "constructorArguements",
description: "Contract constructor arguments",
example:
"0x000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000094869207468657265210000000000000000000000000000000000000000000000",
"0x000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000094869207468657265210000000000000000000000000000000000000000000000 or 000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000094869207468657265210000000000000000000000000000000000000000000000",
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What's that or for? If this is to show multiple examples just use examples field, it's array.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It shows that constructor arguments can be sent either with or without the 0x prefix, as the Etherscan API only accepts without the prefix.

Copy link
Collaborator

@Romsters Romsters Jan 22, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Then use examples array with both of these values please with and without 0x.

required: false,
})
@IsOptional()
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
import { validate } from "class-validator";
import { FormatAndValidateCompilerVersion } from "./formatAndValidateCompilerVersion";

class TestDto {
constructor(version: string) {
this.version = version;
}

@FormatAndValidateCompilerVersion()
public version: string;
}

describe("FormatAndValidateCompilerVersion", () => {
it("when version is null returns a validation error", async () => {
const errors = await validate(new TestDto(null));
expect(errors.length).toBe(1);
expect(errors[0].property).toBe("version");
});

it("when version is an empty string returns a validation error", async () => {
const errors = await validate(new TestDto(""));
expect(errors.length).toBe(1);
expect(errors[0].property).toBe("version");
});

it("when version is a valid", async () => {
const errors = await validate(new TestDto("2.3.7"));
expect(errors.length).toBe(0);
});

it("when version is valid with commit", async () => {
const errors = await validate(new TestDto("2.5.7-commit.32"));
expect(errors.length).toBe(0);
});
});
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
import { registerDecorator, ValidationOptions } from "class-validator";
export function FormatAndValidateCompilerVersion(validationOptions?: ValidationOptions) {
return function (object: any, propertyName: string) {
registerDecorator({
name: "formatAndValidateCompilerVersion",
target: object.constructor,
propertyName: propertyName,
options: validationOptions,
validator: {
validate(value: any) {
return value && typeof value === "string";
},
},
});
// Custom setter to format the value
Object.defineProperty(object, propertyName, {
set(value: string) {
const regex = /^(0\.\d+\.\d+(\.\d+)?|zkVM-\d+\.\d+\.\d+(\.\d+)?-\d+\.\d+\.\d+(\.\d+)?)$/;
if (value && !regex.test(value)) {
let [major, minor, patch] = value.split(".");
major = major.slice(1);
patch = patch.replace(/\+.*$/, "");
minor = minor;
const formattedValue = `${major}.${minor}.${patch}`;
Object.defineProperty(object, `_${propertyName}`, {
value: formattedValue,
writable: true,
configurable: true,
});
} else {
Object.defineProperty(object, `_${propertyName}`, {
value: value,
writable: true,
configurable: true,
});
}
},
get() {
return this[`_${propertyName}`];
},
});
};
}
Loading